Adafruit Industries Airlift Bitsy Add-On Manual de usuario
Adafruit Airlift Bitsy Add-On - ESP32 WiFi
Co-Processor
Created by Bryan Siepert
https://learn.adafruit.com/adafruit-airlift-bitsy-add-on-esp32-wifi-co-processor
Last updated on 2021-11-15 07:47:52 PM EST
©Adafruit Industries Page 1 of 54
5
7
8
8
10
11
12
12
13
13
14
15
16
20
22
23
23
25
27
27
28
28
30
30
30
31
31
31
33
35
35
36
38
40
43
44
44
44
45
47
50
50
51
Table of Contents
Overview
Pinouts
• Power Pins
• SPI and Control Pins
• RGB LED
Assembly
CircuitPython WiFi
• CircuitPython Microcontroller Pinout
• CircuitPython Installation of ESP32SPI Library
• CircuitPython Usage
Internet Connect!
• What's a secrets file?
• Connect to WiFi
• Requests
• HTTP GET with Requests
• HTTP POST with Requests
• Advanced Requests Usage
• WiFi Manager
OLD - CircuitPython WiFi
• CircuitPython Microcontroller Pinout
• CircuitPython Installation of ESP32SPI Library
• CircuitPython Usage
CircuitPython BLE
• CircuitPython BLE UART Example
• Update the AirLift Firmware
• Install CircuitPython Libraries
• Install the Adafruit Bluefruit LE Connect App
• Copy and Adjust the Example Program
• Talk to the AirLift via the Bluefruit LE Connect App
Arduino WiFi
• Library Install
• First Test
• WiFi Connection Test
• Secure Connection Example
• JSON Parsing Demo
• Adapting Other Examples
Upgrade External ESP32 Airlift Firmware
• External AirLift FeatherWing, Shield, or ItsyWing
• Upload Serial Passthrough code for Feather or ItsyBitsy
• External AirLift Breakout
• Code Usage
• Install esptool.py
• Burning nina-fw with esptool
©Adafruit Industries Page 2 of 54
©Adafruit Industries Page 4 of 54
Overview
Give your ItsyBitsy project a lift with the Adafruit AirLift Bitsy Add-On! This sweet add-
on for the ItsyBitsy lets you use the powerful ESP32 as a WiFi or BLE co-processor.
You probably have your favorite ItsyBitsy (like the ItsyBitsy M4(https://adafru.it/BQC))
that comes with its own set of awesome peripherals and lots of libraries. But it doesn't
have WiFi built in! So let's give that chip a best friend, the ESP32. This chip can handle
all the heavy lifting of connecting to a WiFi network and transferring data from a site,
even if its using the latest TLS/SSL encryption (it has root certificates pre-burned in).
©Adafruit Industries Page 5 of 54
Having WiFi managed by a separate chip means your code is simpler, you don't have
to cache socket data, or compile in & debug an SSL library. Instead the Airlift Add-On
allows you to send basic but powerful socket-based commands over 8MHz SPI for
high speed data transfer. You can use the 3V 32u4, M0, or M4 ItsyBitsy in Arduino
although the '32u4 will not be able to do very complex tasks or buffer a lot of databe
causethey do not have a lot of RAM. The add-on also works great with CircuitPython,
though a SAMD51/Cortex M4 minimum required since we need a bunch of RAM. All
you need is an SPI bus and 2 control pins plus a power supply that can provide up to
250mA during WiFi usage.
The ESP32 also supports BLE (Bluetooth Low Energy), though not simultaneously with
WiFi. Many of our CircuitPython builds include native support for ESP32 BLE. Right
now, we only support the ESP32 acting as a BLE peripheral, but that's sufficient to
communicate with the ESP32 from a phone, tablet, host computer, or another BLE-
capable board. You use a few control pins and the RX and TX pins to talk to the
ESP32 when it's in BLE mode.
We placed an ESP32 module on a BitsyWing with a tri-state chip for MOSI so you can
share the SPI bus. The add on comes fully assembled and tested, pre-programmed
with ESP32 SPI WiFi co-processor firmware thatyou can use in CircuitPython to use
this into WiFi co-processsor over SPI + 2 pins(https://adafru.it/Evl). We also toss in
some header so you can solder it in thoughyou'll need stacking headers for your
ItsyBitsy to put the add-on on top.
The firmware on board is a slight variant of the Arduino WiFiNINA core, which works
great!(https://adafru.it/E7O)
©Adafruit Industries Page 6 of 54
Pinouts
©Adafruit Industries Page 7 of 54
Power Pins
GND- Common power/logic ground.
3.3V - Power supply for the ublox WiFi module. You'll need up to 250mA to
power the module. ItsyBitsy's tend to have a 500mA regulator so they should be
OK, just make sure you're aware of your power budget
SPI and Control Pins
To keep transfers speedy, we use SPInot UART Serial.UART is too slow and hard to
synchronize. This uses more pins but the experience is much better!
Classic SPI Pins:
SCK- SPI Clock from your microcontroller,logic level is 3.3V only
MISO- SPI Datafromthe AirLifttothe microcontroller,logic level is 3.3V only.Th
is is tri-stated when not selected, so you can share the SPI bus with other
devices.
•
•
•
•
©Adafruit Industries Page 8 of 54
MOSI- SPI Datatothe AirLiftfromthe microcontroller,logic level is 3.3V only.
ESPCS- SPI Chip Select from the microcontroller to start sending commands to
the AirLift, and to choose BLE mode on reset, logic level is 3.3V only
Required Control Pins:
ESPBUSY- this pin is an input from the AirLift, it will let us know when its ready
for more commands to be sent. This is 3.3V logic out.This pinmustbe
connected.
ESPRST- this pin is an output to the AirLift. Set low to put the AirLift into reset.
You should use this pin, even though you might be able to run for a short while
without it, it's essential to 'kick' the chip if it ever gets into a locked up state.Lo
gic level is 3.3V
Optional Control Pins:
ESPGPIO0- this is the ESP32GPIO0pin, which is used to put the WiFi module it
into bootloading mode if you want to update the firmware. It is also used if you
like when the ESP32 is acting as a server, to let you know data is ready for
reading. It's not required in WiFi mode, but you'll need to connect it for BLE
mode. You'll need to solder the pad on the bottom of the Bitsy Add-on to
connect it.
ESPRX&ESPTX - Serial data in and Serial data out, used for bootloading new
firmware, and for communication when in BLE mode. Leave disconnected if not
using BLE or when not uploading new WiFi firmware to the AirLift (which is a
rare occurrence). You'll need to solder the two pads on the bottom of the Bitsy
Add-on to use these pins. Soldering the pads connects ESPTX to RX and ESPTX
to RX, respectively.
•
•
•
•
Warning! The initial batch has the silk screen labels for ESPBUSY and ESPRST
swapped! The order should be ECS/RST/BSY not ECS/BSY/RST. The schematic,
code, and fritzing object have been fixed. The silk will be corrected for the next
run
•
•
©Adafruit Industries Page 9 of 54
RGB LED
There is a small RGB LED to the left of the ESP32. These RGB LEDs are available in
the Arduino and CircuitPython libraries if you'd like to PWM them for a visual alert.
They're connected to the ESP32's pins 26 (Red), 25 (Green), and 27 (Blue).
©Adafruit Industries Page 10 of 54
Este manual sirve para los siguientes modelos
2
Tabla de contenidos
Manuales populares de Hardware de computadora de otras marcas
EMC2
EMC2 VNX Series Manual del propietario
Panasonic
Panasonic DV0PM20105 Manual de usuario
Mitsubishi Electric
Mitsubishi Electric Q81BD-J61BT11 Manual de usuario
Gigabyte
Gigabyte B660M DS3H AX DDR4 Manual de usuario
Raidon
Raidon iT2300 Manual de usuario
National Instruments
National Instruments PXI-8186 Manual de usuario
