pxt-common-packages/libs/esp32/README.md

# ESP32

Communication layer to a accessory ESP32 chip.

> Ported from Adafruit Circuit Python 
https://github.com/adafruit/Adafruit_CircuitPython_ESP32SPI.

## Configuration

### Nina-FW over SPI

The companion firmware is https://github.com/adafruit/nina-fw over SPI.
The pins of the main board need to be configured either in the bootloader or using `namespace userconfig { ... }`.
The ESP32 pins are listed next to each key below (the number in parenthesis is the pin number on WROOM-32 module).

* ``PIN_WIFI_CS``, ESP32 CS pin mapping, IO5 (29)
* ``PIN_WIFI_BUSY``, ESP32 BUSY pin mapping, IO33 (9)
* ``PIN_WIFI_RESET``, ESP32 RESET pin mapping, EN (3)
* ``PIN_WIFI_GPIO0`` (optional), ESP32 GPIO0 pin mapping, IO0 (25)

The driver uses the default SPI pins. You can override this behavior by specifying these 3 keys.

* ``PIN_WIFI_MOSI`` (optional), dedicated SPI MOSI pin, IO14 (13)
* ``PIN_WIFI_MISO`` (optional), dedicated SPI MISO pin, IO23 (37)
* ``PIN_WIFI_SCK`` (optional), dedicated SPI SCK pin, IO18 (30)

### Expressif AT commands over serial

Not supported yet.

* ``PIN_WIFI_AT_RX``, ESP32 RX pin mapping
* ``PIN_WIFI_AT_TX``, ESP32 TX pin mapping

## Access Points and passwords

The module uses access points and password information stored in the device secrets. These secrets can be set programmatically using ``net.updateAccessPoint`` or via the menu items in Arcade (added via the ``net-game`` extension).

> *Friendly reminder:* Do not share .uf2 files or programs with secrets!!

## Example

See net package readme.