Temp Logger

Real-time temperature logger and instrument control suite for NEnG TMP117 PID instruments.

Tools included

All connection-based tools support USB serial and WiFi/TCP connections. WiFi lets you log data and control the instrument simultaneously from two terminals. See WIFI_SUPPORT.md for details.

Note: Tools marked neng-scpi-tools and neng-wifi-tools are installed automatically as dependencies. See the neng-scpi-tools README and neng-wifi-tools README for details.

This directory is a standalone, pip-installable Python package.

Install

Recommended: Install from PyPI

pip install neng-temp-logger

Development install from source (editable mode)

Clone the repository and install in editable mode:

git clone git@gitlab.flavio.be:flavio/temp-logger.git
cd temp-logger
python3 -m venv .venv
source .venv/bin/activate        # macOS / Linux
python -m pip install -U pip
python -m pip install -e .

Tkinter on macOS

The GUI tools require Tkinter. On macOS it may be missing depending on how Python was installed. See TKINTER_INSTALLATION.md.

brew install tcl-tk
brew install python-tk@3.xx      # replace xx with your Python minor version

Run

Temperature logger (GUI)

temp-logger-gui

Temperature logger (CLI)

temp-logger                      # auto-detect port, live plot
temp-logger --no-plot            # headless (data-only)
temp-logger --output exp1.csv    # custom output file
temp-logger --wifi 192.168.1.100 # force WiFi connection

PID controller GUI

pid-controller-gui               # auto-connects USB or WiFi

Other tools (provided by companion packages)

The following tools are installed automatically as dependencies:

# WiFi configuration GUI (neng-wifi-tools)
wifi-config-gui                  # manage WiFi networks and settings

# Interactive SCPI terminal (neng-scpi-tools)
scpi-client                     # USB auto-detect, interactive
scpi-client -w                  # WiFi auto-detect (scans all networks)
scpi-client -w 192.168.1.100    # WiFi with explicit IP

# Network device scanner (neng-wifi-tools)
neng-device-scan                # scan ALL network interfaces

# OTA firmware update (neng-wifi-tools)
update-firmware --git-deploy --yes --reboot   # auto-detect & deploy
update-firmware 192.168.1.100 --git-deploy    # explicit IP

See the neng-wifi-tools README and neng-scpi-tools README for full documentation.

Documentation index

Notes

• USB serial communicates via CDC at 115 200 baud.
• WiFi/TCP uses port 5025 (standard SCPI-over-TCP).
• Only one application can use USB serial at a time; WiFi allows a second simultaneous connection.

(c) 2024-26 Prof. Flavio ABREU ARAUJO. All rights reserved.