Many updates, new functions, flow control, simplified examples

examples/espatcontrol_cheerlights.py

@@ -0,0 +1,107 @@
+"""
+This example will query ThingSpeak channel 1417 "CheerLights" and display the
+color on a NeoPixel ring or strip
+"""
+import gc
+import time
+import board
+import busio
+from digitalio import DigitalInOut
+from Adafruit_CircuitPython_ESP_ATcontrol import adafruit_espatcontrol
+import neopixel
+import ujson
+import adafruit_fancyled.adafruit_fancyled as fancy
+
+
+
+# Get wifi details and more from a settings.py file
+try:
+    from settings import settings
+except ImportError:
+    print("WiFi settings are kept in settings.py, please add them there!")
+    raise
+
+#              CONFIGURATION
+TIME_BETWEEN_QUERY = 10  # in seconds
+
+# Cheerlights!
+DATA_SOURCE = "http://api.thingspeak.com/channels/1417/feeds.json?results=1"
+DATA_LOCATION = ["feeds", 0, "field2"]
+
+uart = busio.UART(board.TX, board.RX, timeout=0.1)
+resetpin = DigitalInOut(board.D5)
+rtspin = DigitalInOut(board.D9)
+
+# Create the connection to the co-processor and reset
+esp = adafruit_espatcontrol.ESP_ATcontrol(uart, 115200, run_baudrate=460800,
+                                          reset_pin=resetpin,
+                                          rts_pin=rtspin, debug=True)
+esp.hard_reset()
+
+# neopixels
+pixels = neopixel.NeoPixel(board.A1, 16, brightness=0.3)
+pixels.fill(0)
+builtin = neopixel.NeoPixel(board.NEOPIXEL, 1, brightness=0.1)
+builtin[0] = 0
+
+# we'll save the value in question
+last_value = value = None
+the_time = None
+times = 0
+
+def get_value(response, location):
+    """Extract a value from a json object, based on the path in 'location'"""
+    try:
+        print("Parsing JSON response...", end='')
+        json = ujson.loads(response)
+        print("parsed OK!")
+        for x in location:
+            json = json[x]
+        return json
+    except ValueError:
+        print("Failed to parse json, retrying")
+        return None
+
+while True:
+    try:
+        while not esp.is_connected:
+            builtin[0] = (100, 0, 0)
+            # settings dictionary must contain 'ssid' and 'password' at a minimum
+            esp.connect(settings)
+        builtin[0] = (0, 100, 0)
+        # great, lets get the data
+        print("Retrieving data source...", end='')
+        builtin[0] = (100, 100, 0)
+        header, body = esp.request_url(DATA_SOURCE)
+        builtin[0] = (0, 0, 100)
+        print("Reply is OK!")
+    except (RuntimeError, adafruit_espatcontrol.OKError) as e:
+        print("Failed to get data, retrying\n", e)
+        continue
+    print('-'*40, "Size: ", len(body))
+    print(str(body, 'utf-8'))
+    print('-'*40)
+    # For mystery reasons, there's two numbers before and after the json data
+    lines = body.split(b'\r\n')  # so split into lines
+    value = get_value(lines[1], DATA_LOCATION) # an get the middle chunk
+    builtin[0] = (100, 100, 100)
+    if not value:
+        continue
+    print(times, the_time, "value:", value)
+
+    if last_value != value:
+        color = int(value[1:],16)
+        red = color >> 16 & 0xFF
+        green = color >> 8 & 0xFF
+        blue = color& 0xFF
+        gamma_corrected = fancy.gamma_adjust(fancy.CRGB(red, green, blue)).pack()
+
+        pixels.fill(gamma_corrected)
+        last_value = value
+    times += 1
+
+    # normally we wouldn't have to do this, but we get bad fragments
+    header = body = None
+    gc.collect()
+    print(gc.mem_free())  # pylint: disable=no-member
+    time.sleep(TIME_BETWEEN_QUERY)

examples/espatcontrol_countviewer.py

@@ -0,0 +1,153 @@
+"""
+This example will access an API, grab a number like hackaday skulls, github
+stars, price of bitcoin, twitter followers... if you can find something that
+spits out JSON data, we can display it!
+"""
+import gc
+import time
+import board
+import busio
+from digitalio import DigitalInOut
+import audioio
+from Adafruit_CircuitPython_ESP_ATcontrol import adafruit_espatcontrol
+from adafruit_ht16k33 import segments
+import neopixel
+import ujson
+
+# Get wifi details and more from a settings.py file
+try:
+    from settings import settings
+except ImportError:
+    print("WiFi settings are kept in settings.py, please add them there!")
+    raise
+
+#              CONFIGURATION
+PLAY_SOUND_ON_CHANGE = False
+NEOPIXELS_ON_CHANGE = False
+TIME_BETWEEN_QUERY = 60  # in seconds
+
+# Some data sources and JSON locations to try out
+
+# Bitcoin value in USD
+DATA_SOURCE = "http://api.coindesk.com/v1/bpi/currentprice.json"
+DATA_LOCATION = ["bpi", "USD", "rate_float"]
+
+# Github stars! You can query 1ce a minute without an API key token
+#DATA_SOURCE = "https://api.github.com/repos/adafruit/circuitpython"
+#if 'github_token' in settings:
+#    DATA_SOURCE += "?access_token="+settings['github_token']
+#DATA_LOCATION = ["stargazers_count"]
+
+# Youtube stats
+#CHANNEL_ID = "UCpOlOeQjj7EsVnDh3zuCgsA" # this isn't a secret but you have to look it up
+#DATA_SOURCE = "https://www.googleapis.com/youtube/v3/channels/?part=statistics&id=" \
+#              + CHANNEL_ID +"&key="+settings['youtube_token']
+# try also 'viewCount' or 'videoCount
+#DATA_LOCATION = ["items", 0, "statistics", "subscriberCount"]
+
+
+# Subreddit subscribers
+#DATA_SOURCE = "https://www.reddit.com/r/circuitpython/about.json"
+#DATA_LOCATION = ["data", "subscribers"]
+
+# Hackaday Skulls (likes), requires an API key
+#DATA_SOURCE = "https://api.hackaday.io/v1/projects/1340?api_key="+settings['hackaday_token']
+#DATA_LOCATION = ["skulls"]
+
+# Twitter followers
+#DATA_SOURCE = "https://cdn.syndication.twimg.com/widgets/followbutton/info.json?" + \
+#"screen_names=adafruit"
+#DATA_LOCATION = [0, "followers_count"]
+
+uart = busio.UART(board.TX, board.RX, timeout=0.1)
+resetpin = DigitalInOut(board.D5)
+rtspin = DigitalInOut(board.D9)
+
+# Create the connection to the co-processor and reset
+esp = adafruit_espatcontrol.ESP_ATcontrol(uart, 115200, run_baudrate=921600,
+                                          reset_pin=resetpin,
+                                          rts_pin=rtspin, debug=True)
+esp.hard_reset()
+
+# Create the I2C interface.
+i2c = busio.I2C(board.SCL, board.SDA)
+# Attach a 7 segment display and display -'s so we know its not live yet
+display = segments.Seg7x4(i2c)
+display.print('----')
+
+# neopixels
+if NEOPIXELS_ON_CHANGE:
+    pixels = neopixel.NeoPixel(board.A1, 16, brightness=0.4, pixel_order=(1, 0, 2, 3))
+    pixels.fill(0)
+
+# music!
+if PLAY_SOUND_ON_CHANGE:
+    wave_file = open("coin.wav", "rb")
+    wave = audioio.WaveFile(wave_file)
+
+# we'll save the value in question
+last_value = value = None
+the_time = None
+times = 0
+
+def chime_light():
+    """Light up LEDs and play a tune"""
+    if NEOPIXELS_ON_CHANGE:
+        for i in range(0, 100, 10):
+            pixels.fill((i, i, i))
+    if PLAY_SOUND_ON_CHANGE:
+        with audioio.AudioOut(board.A0) as audio:
+            audio.play(wave)
+            while audio.playing:
+                pass
+    if NEOPIXELS_ON_CHANGE:
+        for i in range(100, 0, -10):
+            pixels.fill((i, i, i))
+        pixels.fill(0)
+
+def get_value(response, location):
+    """Extract a value from a json object, based on the path in 'location'"""
+    try:
+        print("Parsing JSON response...", end='')
+        json = ujson.loads(response)
+        print("parsed OK!")
+        for x in location:
+            json = json[x]
+        return json
+    except ValueError:
+        print("Failed to parse json, retrying")
+        return None
+
+while True:
+    try:
+        while not esp.is_connected:
+            # settings dictionary must contain 'ssid' and 'password' at a minimum
+            esp.connect(settings)
+        # great, lets get the data
+        # get the time
+        the_time = esp.sntp_time
+
+        print("Retrieving data source...", end='')
+        header, body = esp.request_url(DATA_SOURCE)
+        print("Reply is OK!")
+    except (RuntimeError, adafruit_espatcontrol.OKError) as e:
+        print("Failed to get data, retrying\n", e)
+        continue
+    #print('-'*40, "Size: ", len(body))
+    #print(str(body, 'utf-8'))
+    #print('-'*40)
+    value = get_value(body, DATA_LOCATION)
+    if not value:
+        continue
+    print(times, the_time, "value:", value)
+    display.print(int(value))
+
+    if last_value != value:
+        chime_light() # animate the neopixels
+        last_value = value
+    times += 1
+    # normally we wouldn't have to do this, but we get bad fragments
+    header = body = None
+    gc.collect()
+    print(gc.mem_free())  # pylint: disable=no-member
+    time.sleep(TIME_BETWEEN_QUERY)

examples/espatcontrol_settings.py

@@ -0,0 +1,9 @@
+# This file is where you keep secret settings, passwords, and tokens!
+# If you put them in the code you risk committing that info or sharing it
+
+settings = {
+    'ssid' : 'my access point',
+    'password' : 'hunter2',
+    'timezone' : -5, # this is offset from UTC
+    'github_token' : 'abcdefghij0123456789',
+}

examples/espatcontrol_simpletest.py

@@ -1,27 +1,40 @@
+import time
 import board
 import busio
 from digitalio import DigitalInOut
 import adafruit_espatcontrol
 
-MY_SSID = "my ssid"
-MY_PASSWORD = "the password"
+# Get wifi details and more from a settings.py file
+try:
+    from settings import settings
+except ImportError:
+    print("WiFi settings are kept in settings.py, please add them there!")
+    raise
 
-uart = busio.UART(board.TX, board.RX, baudrate=115200, timeout=1)
+uart = busio.UART(board.TX, board.RX, timeout=0.1)
 resetpin = DigitalInOut(board.D5)
 
 print("ESP AT commands")
-esp = adafruit_espatcontrol.ESP_ATcontrol(uart, 115200, reset_pin=resetpin, debug=False)
+esp = adafruit_espatcontrol.ESP_ATcontrol(uart, 115200, run_baudrate=9600,
+                                          reset_pin=resetpin, debug=False)
+print("Resetting ESP module")
+esp.hard_reset()
 
-if not esp.soft_reset():
-    esp.hard_reset()
-    esp.soft_reset()
-
-esp.echo(False)
-print("Connected to AT software version ", esp.get_version())
-if esp.mode != esp.MODE_STATION:
-    esp.mode = esp.MODE_STATION
-print("Mode is now", esp.mode)
-for ap in esp.scan_APs():
-    print(ap)
-esp.join_AP(MY_SSID, MY_PASSWORD)
-print("My IP Address:", esp.local_ip)
+while True:
+    try:
+        print("Checking connection...")
+        while not esp.is_connected:
+            print("Initializing ESP module")
+            #print("Scanning for AP's")
+            #for ap in esp.scan_APs():
+            #    print(ap)
+            # settings dictionary must contain 'ssid' and 'password' at a minimum
+            print("Connecting...")
+            esp.connect(settings)
+            print("Connected to AT software version ", esp.version)
+        print("Pinging 8.8.8.8...", end="")
+        print(esp.ping("8.8.8.8"))
+        time.sleep(10)
+    except (RuntimeError, adafruit_espatcontrol.OKError) as e:
+        print("Failed to get data, retrying\n", e)
+        continue