qtpy-datalogger 1.0.4

Data acquisition application using Adafruit QT Py S3

QT Py Datalogger

qtpy-datalogger -- A data acquisition application using the Adafruit QT Py S3 and CircuitPython.

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

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

• Visit the wiki for MQTT setup and commissioning 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 wiki home page for guidance.

Contributing

This project manages its Python programs with uv.

The environment setup instructions are in the wiki on the Contributing 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.