neng-temp-logger 0.2.8

Real-time temperature logger with CLI + Tkinter GUI for NEnG TMP117 instruments.

Temp Logger

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

Tools included

Command	Description
temp-logger	CLI real-time logger with live matplotlib plots and CSV export
temp-logger-gui	Tkinter GUI logger with embedded plots, dark theme, WiFi/USB support
pid-controller-gui	PID temperature controller GUI — ramp control, tuning, TEC, live graphs
wifi-config-gui	WiFi configuration GUI — network management, status monitoring, SCPI console
scpi-client	Interactive SCPI terminal with tab-completion, history, pretty-printed output

All five 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.

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 [e-mail]: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 [e-mail]      # 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

WiFi configuration GUI

wifi-config-gui                  # manage WiFi networks and settings

IMPORTANT: CIRCUITPY must be unmounted for WiFi configuration changes to persist!

diskutil unmount /Volumes/CIRCUITPY   # macOS
umount /media/$USER/CIRCUITPY         # Linux

Interactive SCPI terminal

scpi-client                     # USB auto-detect, interactive
scpi-client -w 192.168.1.100    # WiFi interactive
scpi-client "*IDN?"             # single command, then exit

Documentation index

File	Description
GUI_QUICKSTART.md	60-second getting started for temp-logger-gui
GUI_README.md	Detailed temp-logger-gui reference
REALTIME_LOGGER_README.md	CLI temp-logger documentation
WIFI_SUPPORT.md	WiFi/TCP connection guide
WIFI_QUICKSTART.md	Quick WiFi setup
TKINTER_INSTALLATION.md	Tkinter setup for macOS

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.