qtpy-datalogger 1.0.8

A remote control and data acquisition system using Adafruit QT Py S3

QT Py Datalogger

qtpy-datalogger -- A remote control and data acquisition system using the Adafruit QT Py S3 and CircuitPython

Documentation

Available at downtothewire.io/qtpy-datalogger/welcome

Status

Structure

graph LR
    AP(🛜 Access Point)
    App(🐍 App)
    MQTT(📨 MQTT)
    QTPy(🐍 QT Py S3)

    subgraph "🌐 Network"
        AP
    end

    subgraph "💻 PC Host"
        App<-.->MQTT
        MQTT<-.->AP
    end

    subgraph "🧪 Test Zone"
        AP<-.->|🛜 WiFi|QTPy
    end

The PC host controls and communicates with any number of sensor nodes on the wireless network.

Supported Python versions

• Host
  • Python 3.11
  • Python 3.12
  • Python 3.13
• Node
  • CircuitPython 9.0

Supported host platforms

• Windows

Supported connection types

• Serial / UART
• Network / MQTT

Entry points

• Host program: qtpy_datalogger/console.py
• QT Py program: qtpy_datalogger/sensor_node/code.py

Preview in 90 seconds

1. Connect your QT Py device with USB
   • (Optional) Back up its code.py file
2. Preview the program in a deletable Python virtual environment

# Create and enter a new Python virtual environment
mkdir qtpy-preview
cd qtpy-preview
python -m venv --upgrade-deps .venv
.\.venv\Scripts\activate.ps1

# Install
pip install qtpy-datalogger

# Show the package help
qtpy-datalogger --help

# Search for devices
qtpy-datalogger connect --discover-only

# Install the node runtime on a device
qtpy-datalogger equip

# Open a serial connection, use Ctrl-] to quit
qtpy-datalogger connect

qtpycmd get_apps

qtpycmd stats

qtpycmd read A0 A1 A2 A3

This preview does not demonstrate MQTT communication over WiFi

In order to communicate on the WiFi network, the QT Py sensor node must also have

• an MQTT broker
• WiFi credentials

Visit the MQTT setup page for more details

Gallery

Scanner

qtpy-datalogger run scanner

Scan for nodes by group. Select a node to send it messages.

Data Viewer

qtpy-datalogger run data-viewer

Open a CSV file for time series data.

CSV format

• Series data are in columns
• Series names are in the first row
• The time axis is in the first column
  • ISO timestamps and floating point values both accepted

Time,Sensor 1,Sensor 2
0.0,1.284,2.713
0.22,1.302,5.536
...

Questions and help

Please go to the Welcome page for questions and help.

Contributing

This project manages its Python programs with uv.

The environment setup instructions are on the Develop page.

The design documentation is in the wiki under the Design Doc pages.

Legacy system

This project replaces a legacy system that uses Python and JeeNodes.

See the summary and source code in the docs/legacy folder for details.