Merge pull request #15 from brentru/add-espatcontrol-support

ESP_AT Support

Author: brentru

README.rst

@@ -21,7 +21,12 @@ Dependencies
 This driver depends on:
 
 * `Adafruit CircuitPython <https://github.com/adafruit/circuitpython>`_
-* `Adafruit CircuitPython ESP32SPI <https://github.com/adafruit/Adafruit_CircuitPython_ESP32SPI>`_
+
+You'll also need a library to communicate with an ESP32 as a coprocessor using a WiFiManager object. This library supports connecting an ESP32 using either SPI or UART.
+
+* SPI: `Adafruit CircuitPython ESP32SPI <https://github.com/adafruit/Adafruit_CircuitPython_ESP32SPI>`_
+
+* UART: `Adafruit CircuitPython ESP_ATcontrol <https://github.com/adafruit/Adafruit_CircuitPython_ESP_ATcontrol>`_
 
 Please ensure all dependencies are available on the CircuitPython filesystem.
 This is easily achieved by downloading
@@ -115,4 +120,4 @@ Now, once you have the virtual environment activated:
 
 This will output the documentation to ``docs/_build/html``. Open the index.html in your browser to
 view them. It will also (due to -W) error out on any warning like Travis will. This is a good way to
-locally verify it will pass.
+locally verify it will pass.

examples/adafruit_io_simpletest_esp_at.py

@@ -0,0 +1,84 @@
+"""
+Usage example of the ESP32 over UART
+using the CircuitPython ESP_ATControl library.
+
+Dependencies:
+    * https://github.com/adafruit/Adafruit_CircuitPython_ESP_ATcontrol
+"""
+from random import randint
+import board
+import busio
+from digitalio import DigitalInOut
+
+# Import Adafruit IO REST Client
+from adafruit_io.adafruit_io import RESTClient, AdafruitIO_RequestError
+
+# ESP32 AT
+from adafruit_espatcontrol import adafruit_espatcontrol, adafruit_espatcontrol_wifimanager
+
+#Use below for Most Boards
+import neopixel
+status_light = neopixel.NeoPixel(board.NEOPIXEL, 1, brightness=0.2) # Uncomment for Most Boards
+
+#Uncomment below for ItsyBitsy M4#
+#import adafruit_dotstar as dotstar
+#status_light = dotstar.DotStar(board.APA102_SCK, board.APA102_MOSI, 1, brightness=0.2)
+
+#Uncomment below for Particle Argon#
+#status_light = None
+
+# Get wifi details and more from a secrets.py file
+try:
+    from secrets import secrets
+except ImportError:
+    print("WiFi secrets are kept in secrets.py, please add them there!")
+    raise
+
+# With a Metro or Feather M4
+uart = busio.UART(board.TX, board.RX, timeout=0.1)
+resetpin = DigitalInOut(board.D5)
+rtspin = DigitalInOut(board.D6)
+
+# With a Particle Argon
+"""
+RX = board.ESP_TX
+TX = board.ESP_RX
+resetpin = DigitalInOut(board.ESP_WIFI_EN)
+rtspin = DigitalInOut(board.ESP_CTS)
+uart = busio.UART(TX, RX, timeout=0.1)
+esp_boot = DigitalInOut(board.ESP_BOOT_MODE)
+from digitalio import Direction
+esp_boot.direction = Direction.OUTPUT
+esp_boot.value = True
+"""
+
+esp = adafruit_espatcontrol.ESP_ATcontrol(uart, 115200,
+                                          reset_pin=resetpin, rts_pin=rtspin, debug=False)
+wifi = adafruit_espatcontrol_wifimanager.ESPAT_WiFiManager(esp, secrets, status_light)
+
+# Set your Adafruit IO Username and Key in secrets.py
+# (visit io.adafruit.com if you need to create an account,
+# or if you need your Adafruit IO key.)
+ADAFRUIT_IO_USER = secrets['adafruit_io_user']
+ADAFRUIT_IO_KEY = secrets['adafruit_io_key']
+
+# Create an instance of the Adafruit IO REST client
+io = RESTClient(ADAFRUIT_IO_USER, ADAFRUIT_IO_KEY, wifi)
+
+try:
+    # Get the 'temperature' feed from Adafruit IO
+    temperature_feed = io.get_feed('temperature')
+except AdafruitIO_RequestError:
+    # If no 'temperature' feed exists, create one
+    temperature_feed = io.create_new_feed('temperature')
+
+# Send random integer values to the feed
+random_value = randint(0, 50)
+print('Sending {0} to temperature feed...'.format(random_value))
+io.send_data(temperature_feed['key'], random_value)
+print('Data sent!')
+
+# Retrieve data value from the feed
+print('Retrieving data from temperature feed...')
+received_data = io.receive_data(temperature_feed['key'])
+print('Data from temperature feed: ', received_data['value'])