Avnet IOTCONNECT Python SDK

The Avnet /IOTCONNECT Snap packages the /IOTCONNECT Python Lite SDK and REST CLI into a single, secure, and portable container. It provides everything you need to:

• Onboard devices to the /IOTCONNECT cloud platform
• Send and receive telemetry/commands
• Stream custom telemetry from external applications via a UNIX socket
• Receive OTA-delivered models or scripts into a persistent data area

All core binaries run from a read-only Snap bundle, while certificates, configurations, and OTA assets live in the writable $SNAP_COMMON area—surviving Snap refreshes.

Key Features

• Guided Device Onboarding:
  Run iotconnect.setup to generate certificates, register a device (manual or automated), and store configuration in $SNAP_COMMON.

• Built-in Quickstart Demo:
  Use iotconnect.run to launch a sample telemetry sender that demonstrates SDK usage without requiring a separate application.

• Socket Service for External Apps:
  Start iotconnect.socket to expose /var/snap/iotconnect/common/iotc.sock. Any external app can connect to this UNIX socket, send JSON telemetry, and receive commands or OTA payloads.

• REST-API CLI:
  The iotconnect.cli tool lets you create templates, register devices, and manage configurations via the /IOTCONNECT REST API—ideal for automation or scripting.

• Persistent Storage ($SNAP_COMMON):
  Device certificates, configuration JSON, and OTA-delivered models/scripts are stored in a writable location that is retained across Snap upgrades.

Ideal for

• IoT developers, integrators, and system architects building secure device solutions on /IOTCONNECT
• Rapid prototyping or demoing new IoT/Edge-AI workflows
• Deployments where external applications (e.g., custom Python/Node.js scripts) must stream telemetry or receive commands over a UNIX socket

Getting Started

1. Create an account at [https://www.iotconnect.io](https://www.iotconnect.io).

2. Install this Snap on your device:
   sudo snap install iotconnect

3. Run the setup wizard:
   Choose Manual Setup (paste certificates and config) or Automated Setup (requires a REST API key).
   sudo snap run iotconnect.setup

4. Verify connectivity with the Quickstart demo:
   sudo snap run iotconnect.run

5. If you have your own application, start the socket service:
   `sudo snap start iotconnect.socket

   Then connect to the UNIX socket from your code:
   import socket

   sock = socket.socket(socket.AF_UNIX, socket.SOCK_STREAM) sock.connect("/var/snap/iotconnect/common/iotc.sock") sock.sendall(json.dumps({"temperature": 22.5, "status": "running"}).encode()) # Listen for JSON commands or OTA packages...