examples: Update examples.

Signed-off-by: iabdalkader <[email protected]>

Author: iabdalkader

examples/example.py

@@ -57,18 +57,24 @@ def user_task(client):
         level=logging.DEBUG if args.debug else logging.INFO,
     )
 
+
     # Create a client object to connect to the Arduino IoT cloud.
-    # To use a secure element, set the token's "pin" and URI in "keyfile" and "certfile", and
-    # the CA certificate (if any) in "ssl_params". Alternatively, a username and password can
-    # be used to authenticate, for example:
-    #   client = ArduinoCloudClient(device_id=DEVICE_ID, username=DEVICE_ID, password=SECRET_KEY)
-    client = ArduinoCloudClient(
-        device_id=DEVICE_ID,
-        ssl_params={
-            "pin": "1234",
-            "keyfile": KEY_PATH, "certfile": CERT_PATH, "ca_certs": CA_PATH, "cert_reqs": ssl.CERT_REQUIRED
-        },
-    )
+    # The most basic authentication method uses a username and password. The username is the device
+    # ID, and the password is the secret key obtained from the IoT cloud when provisioning a device.
+    client = ArduinoCloudClient(device_id=DEVICE_ID, username=DEVICE_ID, password=SECRET_KEY)
+
+    # Alternatively, the client also supports key and certificate-based authentication. To use this
+    # mode, set "keyfile" and "certfile", and the CA certificate (if any) in "ssl_params".
+    # Furthermore, secure elements, which can be used to store the key and cert, are also supported.
+    # To secure elements, set "use_hsm" to True in "ssl_params" and set the token's "pin" if any.
+    #client = ArduinoCloudClient(
+    #    device_id=DEVICE_ID,
+    #    ssl_params={
+    #        "use_hsm": True, "pin": "1234",
+    #        "keyfile": KEY_PATH, "certfile": CERT_PATH, "cafile": CA_PATH,
+    #        "verify_mode": ssl.CERT_REQUIRED, "server_hostname" : "iot.arduino.cc"
+    #    },
+    #)
 
     # Register cloud objects.
     # Note: The following objects must be created first in the dashboard and linked to the device.

examples/micropython_basic.py

@@ -73,15 +73,20 @@ def wifi_connect():
     wifi_connect()
 
     # Create a client object to connect to the Arduino IoT cloud.
-    # For MicroPython, the key and cert files must be stored in DER format on the filesystem.
-    # Alternatively, a username and password can be used to authenticate:
+    # The most basic authentication method uses a username and password. The username is the device
+    # ID, and the password is the secret key obtained from the IoT cloud when provisioning a device.
     client = ArduinoCloudClient(device_id=DEVICE_ID, username=DEVICE_ID, password=SECRET_KEY)
-    # client = ArduinoCloudClient(
-    #     device_id=DEVICE_ID,
-    #     ssl_params={
-    #         "keyfile": KEY_PATH, "certfile": CERT_PATH, "cadata": CADATA, "cert_reqs": ssl.CERT_REQUIRED
-    #     }
-    # )
+
+    # Alternatively, the client also supports key and certificate-based authentication. To use this
+    # mode, set "keyfile" and "certfile", and the CA certificate (if any) in "ssl_params".
+    # Note that for MicroPython, the key and cert files must be stored in DER format on the filesystem.
+    #client = ArduinoCloudClient(
+    #    device_id=DEVICE_ID,
+    #    ssl_params={
+    #        "keyfile": KEY_PATH, "certfile": CERT_PATH, "cadata": CADATA,
+    #        "verify_mode": ssl.CERT_REQUIRED, "server_hostname" : "iot.arduino.cc"
+    #    },
+    #)
 
     # Register cloud objects.
     # Note: The following objects must be created first in the dashboard and linked to the device.