adafruit · dhalbert · Feb 25, 2025 · Feb 24, 2025 · Feb 25, 2025 · Feb 25, 2025
diff --git a/README.rst b/README.rst
@@ -106,7 +106,7 @@ To interact with Azure IoT Hub, you will need to create a hub, and a register a
 
 - Open the `Azure Portal <https://aka.ms/AzurePortalHome>`_.
 - Follow the instructions in `Microsoft Docs <https://aka.ms/CreateIoTHub>`_ to create an Azure IoT Hub and register a device.
-- Copy the devices Primary or secondary connection string, and add this to your ``secrets.py`` file.
+- Copy the devices Primary or secondary connection string, and add this to your ``settings.toml`` file.
 
 You can find the device connection string by selecting the IoT Hub in the `Azure Portal <https://aka.ms/AzurePortalHome>`_, *selecting Explorer -> IoT devices*, then selecting your device.
 
@@ -128,7 +128,7 @@ Then copy either the primary or secondary connection string using the copy butto
 
     from adafruit_azureiot import IoTHubDevice
 
-    device = IoTHubDevice(wifi, secrets["device_connection_string"])
+    device = IoTHubDevice(wifi, device_connection_string)
     device.connect()
 
 Once the device is connected, you will regularly need to run a ``loop`` to poll for messages from the cloud.
@@ -197,7 +197,7 @@ To use Azure IoT Central, you will need to create an Azure IoT Central app, crea
 - Head to `Azure IoT Central <https://apps.azureiotcentral.com/?WT.mc_id=academic-3168-jabenn>`__
 - Follow the instructions in the `Microsoft Docs <https://docs.microsoft.com/azure/iot-central/core/quick-deploy-iot-central?WT.mc_id=academic-3168-jabenn>`__ to create an application. Every tier is free for up to 2 devices.
 - Follow the instructions in the `Microsoft Docs <https://docs.microsoft.com/azure/iot-central/core/quick-create-simulated-device?WT.mc_id=academic-3168-jabenn>`__ to create a device template.
-- Create a device based off the template, and select **Connect** to get the device connection details. Store the ID Scope, Device ID and either the primary or secondary device SAS key in your ``secrets.py`` file.
+- Create a device based off the template, and select **Connect** to get the device connection details. Store the ID Scope, Device ID and either the primary or secondary device SAS key in your ``settings.toml`` file.
 
 .. image:: iot-central-connect-button.png
    :alt: The IoT Central connect button
@@ -209,26 +209,40 @@ To use Azure IoT Central, you will need to create an Azure IoT Central app, crea
 
 *The connection details dialog*
 
+
+settings.toml:
+
 .. code-block:: python
 
-    secrets = {
-        # WiFi settings
-        "ssid": "",
-        "password": "",
+    # WiFi settings
+    CIRCUITPY_WIFI_SSID="Your WiFi ssid"
+    CIRCUITPY_WIFI_PASSWORD="Your WiFi password"
 
-        # Azure IoT Central settings
-        "id_scope": "",
-        "device_id": "",
-        "device_sas_key": ""
-    }
+    # Azure IoT Central settings
+    id_scope="Your ID Scope"
+    device_id="Your Device ID"
+    device_sas_key="Your Primary Key"
 
 **Connect your device to your Azure IoT Central app**
 
 .. code-block:: python
 
+    import wifi
+    from os import getenv
     from adafruit_azureiot import IoTCentralDevice
+    import adafruit_connection_manager
+
+    ssid = getenv("CIRCUITPY_WIFI_SSID")
+    password = getenv("CIRCUITPY_WIFI_PASSWORD")
+    id_scope = getenv("id_scope")
+    device_id = getenv("device_id")
+    device_sas_key = getenv("device_sas_key")
+
+    wifi.radio.connect(ssid, password)
+
+    pool = adafruit_connection_manager.get_radio_socketpool(wifi.radio)
 
-    device = IoTCentralDevice(wifi, secrets["id_scope"], secrets["device_id"], secrets["device_sas_key"])
+    device = IoTCentralDevice(pool, id_scope, device_id, device_sas_key)
     device.connect()
 
 Once the device is connected, you will regularly need to run a ``loop`` to poll for messages from the cloud.

diff --git a/examples/azureiot_esp32spi/azureiot_central_commands.py b/examples/azureiot_esp32spi/azureiot_central_commands.py
@@ -1,6 +1,7 @@
 # SPDX-FileCopyrightText: 2021 ladyada for Adafruit Industries
 # SPDX-License-Identifier: MIT
 
+from os import getenv
 import time
 import board
 import busio
@@ -10,12 +11,12 @@
 from adafruit_esp32spi import adafruit_esp32spi, adafruit_esp32spi_wifimanager
 import adafruit_connection_manager
 
-# 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
+# Get WiFi details and AWS Keys, ensure these are setup in settings.toml
+ssid = getenv("CIRCUITPY_WIFI_SSID")
+password = getenv("CIRCUITPY_WIFI_PASSWORD")
+id_scope = getenv("id_scope")
+device_id = getenv("device_id")
+device_sas_key = getenv("device_sas_key")
 
 # ESP32 Setup
 try:
@@ -31,19 +32,21 @@
 esp = adafruit_esp32spi.ESP_SPIcontrol(spi, esp32_cs, esp32_ready, esp32_reset)
 
 """Use below for Most Boards"""
-status_light = neopixel.NeoPixel(
+status_pixel = neopixel.NeoPixel(
     board.NEOPIXEL, 1, brightness=0.2
 )  # Uncomment for Most Boards
 """Uncomment below for ItsyBitsy M4"""
-# status_light = dotstar.DotStar(board.APA102_SCK, board.APA102_MOSI, 1, brightness=0.2)
+# status_pixel = dotstar.DotStar(board.APA102_SCK, board.APA102_MOSI, 1, brightness=0.2)
 # Uncomment below for an externally defined RGB LED
 # import adafruit_rgbled
 # from adafruit_esp32spi import PWMOut
 # RED_LED = PWMOut.PWMOut(esp, 26)
 # GREEN_LED = PWMOut.PWMOut(esp, 27)
 # BLUE_LED = PWMOut.PWMOut(esp, 25)
-# status_light = adafruit_rgbled.RGBLED(RED_LED, BLUE_LED, GREEN_LED)
-wifi = adafruit_esp32spi_wifimanager.ESPSPI_WiFiManager(esp, secrets, status_light)
+# status_pixel = adafruit_rgbled.RGBLED(RED_LED, BLUE_LED, GREEN_LED)
+wifi = adafruit_esp32spi_wifimanager.WiFiManager(
+    esp, ssid, password, status_pixel=status_pixel
+)
 
 print("Connecting to WiFi...")
 
@@ -86,7 +89,7 @@
 #
 # Next create a device using the device template, and select Connect to get the device connection
 # details.
-# Add the connection details to your secrets.py file, using the following values:
+# Add the connection details to your settings.toml file, using the following values:
 #
 # 'id_scope' - the devices ID scope
 # 'device_id' - the devices device id
@@ -108,9 +111,9 @@
 device = IoTCentralDevice(
     pool,
     ssl_context,
-    secrets["id_scope"],
-    secrets["device_id"],
-    secrets["device_sas_key"],
+    id_scope,
+    device_id,
+    device_sas_key,
 )
 
 

diff --git a/examples/azureiot_esp32spi/azureiot_central_notconnected.py b/examples/azureiot_esp32spi/azureiot_central_notconnected.py
@@ -1,6 +1,7 @@
 # SPDX-FileCopyrightText: 2021 ladyada for Adafruit Industries
 # SPDX-License-Identifier: MIT
 
+from os import getenv
 import json
 import random
 import time
@@ -12,12 +13,12 @@
 from adafruit_esp32spi import adafruit_esp32spi, adafruit_esp32spi_wifimanager
 import adafruit_connection_manager
 
-# 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
+# Get WiFi details and AWS Keys, ensure these are setup in settings.toml
+ssid = getenv("CIRCUITPY_WIFI_SSID")
+password = getenv("CIRCUITPY_WIFI_PASSWORD")
+id_scope = getenv("id_scope")
+device_id = getenv("device_id")
+device_sas_key = getenv("device_sas_key")
 
 # ESP32 Setup
 try:
@@ -33,19 +34,21 @@
 esp = adafruit_esp32spi.ESP_SPIcontrol(spi, esp32_cs, esp32_ready, esp32_reset)
 
 """Use below for Most Boards"""
-status_light = neopixel.NeoPixel(
+status_pixel = neopixel.NeoPixel(
     board.NEOPIXEL, 1, brightness=0.2
 )  # Uncomment for Most Boards
 """Uncomment below for ItsyBitsy M4"""
-# status_light = dotstar.DotStar(board.APA102_SCK, board.APA102_MOSI, 1, brightness=0.2)
+# status_pixel = dotstar.DotStar(board.APA102_SCK, board.APA102_MOSI, 1, brightness=0.2)
 # Uncomment below for an externally defined RGB LED
 # import adafruit_rgbled
 # from adafruit_esp32spi import PWMOut
 # RED_LED = PWMOut.PWMOut(esp, 26)
 # GREEN_LED = PWMOut.PWMOut(esp, 27)
 # BLUE_LED = PWMOut.PWMOut(esp, 25)
-# status_light = adafruit_rgbled.RGBLED(RED_LED, BLUE_LED, GREEN_LED)
-wifi = adafruit_esp32spi_wifimanager.ESPSPI_WiFiManager(esp, secrets, status_light)
+# status_pixel = adafruit_rgbled.RGBLED(RED_LED, BLUE_LED, GREEN_LED)
+wifi = adafruit_esp32spi_wifimanager.WiFiManager(
+    esp, ssid, password, status_pixel=status_pixel
+)
 
 print("Connecting to WiFi...")
 
@@ -80,7 +83,7 @@
 #
 # Next create a device using the device template, and select Connect to get the device connection
 # details.
-# Add the connection details to your secrets.py file, using the following values:
+# Add the connection details to your settings.toml file, using the following values:
 #
 # 'id_scope' - the devices ID scope
 # 'device_id' - the devices device id
@@ -104,9 +107,9 @@
 device = IoTCentralDevice(
     pool,
     ssl_context,
-    secrets["id_scope"],
-    secrets["device_id"],
-    secrets["device_sas_key"],
+    id_scope,
+    device_id,
+    device_sas_key,
 )
 
 # don't connect

diff --git a/examples/azureiot_esp32spi/azureiot_central_properties.py b/examples/azureiot_esp32spi/azureiot_central_properties.py
@@ -1,6 +1,7 @@
 # SPDX-FileCopyrightText: 2021 ladyada for Adafruit Industries
 # SPDX-License-Identifier: MIT
 
+from os import getenv
 import random
 import time
 import board
@@ -11,12 +12,12 @@
 from adafruit_esp32spi import adafruit_esp32spi, adafruit_esp32spi_wifimanager
 import adafruit_connection_manager
 
-# 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
+# Get WiFi details and AWS Keys, ensure these are setup in settings.toml
+ssid = getenv("CIRCUITPY_WIFI_SSID")
+password = getenv("CIRCUITPY_WIFI_PASSWORD")
+id_scope = getenv("id_scope")
+device_id = getenv("device_id")
+device_sas_key = getenv("device_sas_key")
 
 # ESP32 Setup
 try:
@@ -32,19 +33,21 @@
 esp = adafruit_esp32spi.ESP_SPIcontrol(spi, esp32_cs, esp32_ready, esp32_reset)
 
 """Use below for Most Boards"""
-status_light = neopixel.NeoPixel(
+status_pixel = neopixel.NeoPixel(
     board.NEOPIXEL, 1, brightness=0.2
 )  # Uncomment for Most Boards
 """Uncomment below for ItsyBitsy M4"""
-# status_light = dotstar.DotStar(board.APA102_SCK, board.APA102_MOSI, 1, brightness=0.2)
+# status_pixel = dotstar.DotStar(board.APA102_SCK, board.APA102_MOSI, 1, brightness=0.2)
 # Uncomment below for an externally defined RGB LED
 # import adafruit_rgbled
 # from adafruit_esp32spi import PWMOut
 # RED_LED = PWMOut.PWMOut(esp, 26)
 # GREEN_LED = PWMOut.PWMOut(esp, 27)
 # BLUE_LED = PWMOut.PWMOut(esp, 25)
-# status_light = adafruit_rgbled.RGBLED(RED_LED, BLUE_LED, GREEN_LED)
-wifi = adafruit_esp32spi_wifimanager.ESPSPI_WiFiManager(esp, secrets, status_light)
+# status_pixel = adafruit_rgbled.RGBLED(RED_LED, BLUE_LED, GREEN_LED)
+wifi = adafruit_esp32spi_wifimanager.WiFiManager(
+    esp, ssid, password, status_pixel=status_pixel
+)
 
 print("Connecting to WiFi...")
 
@@ -87,7 +90,7 @@
 #
 # Next create a device using the device template, and select Connect to get the device connection
 # details.
-# Add the connection details to your secrets.py file, using the following values:
+# Add the connection details to your settings.toml file, using the following values:
 #
 # 'id_scope' - the devices ID scope
 # 'device_id' - the devices device id
@@ -105,9 +108,9 @@
 device = IoTCentralDevice(
     pool,
     ssl_context,
-    secrets["id_scope"],
-    secrets["device_id"],
-    secrets["device_sas_key"],
+    id_scope,
+    device_id,
+    device_sas_key,
 )
 
 

diff --git a/examples/azureiot_esp32spi/azureiot_central_simpletest.py b/examples/azureiot_esp32spi/azureiot_central_simpletest.py
@@ -1,6 +1,7 @@
 # SPDX-FileCopyrightText: 2021 ladyada for Adafruit Industries
 # SPDX-License-Identifier: MIT
 
+from os import getenv
 import json
 import random
 import time
@@ -12,12 +13,12 @@
 from adafruit_esp32spi import adafruit_esp32spi, adafruit_esp32spi_wifimanager
 import adafruit_connection_manager
 
-# 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
+# Get WiFi details and AWS Keys, ensure these are setup in settings.toml
+ssid = getenv("CIRCUITPY_WIFI_SSID")
+password = getenv("CIRCUITPY_WIFI_PASSWORD")
+id_scope = getenv("id_scope")
+device_id = getenv("device_id")
+device_sas_key = getenv("device_sas_key")
 
 # ESP32 Setup
 try:
@@ -33,19 +34,21 @@
 esp = adafruit_esp32spi.ESP_SPIcontrol(spi, esp32_cs, esp32_ready, esp32_reset)
 
 """Use below for Most Boards"""
-status_light = neopixel.NeoPixel(
+status_pixel = neopixel.NeoPixel(
     board.NEOPIXEL, 1, brightness=0.2
 )  # Uncomment for Most Boards
 """Uncomment below for ItsyBitsy M4"""
-# status_light = dotstar.DotStar(board.APA102_SCK, board.APA102_MOSI, 1, brightness=0.2)
+# status_pixel = dotstar.DotStar(board.APA102_SCK, board.APA102_MOSI, 1, brightness=0.2)
 # Uncomment below for an externally defined RGB LED
 # import adafruit_rgbled
 # from adafruit_esp32spi import PWMOut
 # RED_LED = PWMOut.PWMOut(esp, 26)
 # GREEN_LED = PWMOut.PWMOut(esp, 27)
 # BLUE_LED = PWMOut.PWMOut(esp, 25)
-# status_light = adafruit_rgbled.RGBLED(RED_LED, BLUE_LED, GREEN_LED)
-wifi = adafruit_esp32spi_wifimanager.ESPSPI_WiFiManager(esp, secrets, status_light)
+# status_pixel = adafruit_rgbled.RGBLED(RED_LED, BLUE_LED, GREEN_LED)
+wifi = adafruit_esp32spi_wifimanager.WiFiManager(
+    esp, ssid, password, status_pixel=status_pixel
+)
 
 print("Connecting to WiFi...")
 
@@ -88,7 +91,7 @@
 #
 # Next create a device using the device template, and select Connect to get the device connection
 # details.
-# Add the connection details to your secrets.py file, using the following values:
+# Add the connection details to your settings.toml file, using the following values:
 #
 # 'id_scope' - the devices ID scope
 # 'device_id' - the devices device id
@@ -106,9 +109,9 @@
 device = IoTCentralDevice(
     pool,
     ssl_context,
-    secrets["id_scope"],
-    secrets["device_id"],
-    secrets["device_sas_key"],
+    id_scope,
+    device_id,
+    device_sas_key,
 )
 
 print("Connecting to Azure IoT Central...")