summaryrefslogtreecommitdiffstatshomepage
path: root/drivers/esp-hosted/README.md
blob: f4ecfd23d555262c08bc9d2c35f6cc42a6fa0804 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
# esp-hosted driver

This is a MicroPython driver for the Espressif
[esp_hosted](https://github.com/espressif/esp-hosted/#readme) communications
coprocessor, which allows creating a Wi-Fi and/or Bluetooth interface from
MicroPython to a separate connected ESP32 compatible device running the
`esp_hosted` firmware.

## Building

Enable this driver by setting `MICROPY_PY_NETWORK_ESP_HOSTED` to 1 in your
Makefile. If `MICROPY_PY_BLUETOOTH` is set then the Bluetooth host driver will
also be built.

In addition to normal MicroPython build requirements, building this driver
requires the [protocol buffer
compiler](https://github.com/protocolbuffers/protobuf#protobuf-compiler-installation)
(protoc) to be installed.

On Debian/Ubuntu, it can be installed by running:

```
sudo apt-get install protobuf-compiler
```