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 $SNAPCOMMON 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 $SNAPCOMMON.

• 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 ($SNAPCOMMON):

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.AFUNIX, 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...`