Files
2026-04-17 05:27:49 +02:00

6.1 KiB

Data Logging

Captures all serial debug output from the Arduino and writes it to a timestamped log file. Designed to run automatically on a Raspberry Pi with no user interaction.


Files

File Purpose
log_serial.py Python logger script
arduino-logger.service systemd unit file — runs the script on boot
arduino.log Log output (created automatically on first run)

How it works

  • log_serial.py auto-detects the Arduino's USB serial port on startup.
  • Every line received from the Arduino is written to arduino.log with a full timestamp (YYYY-MM-DD HH:MM:SS.mmm).
  • The log file is always appended, never overwritten — all sessions are preserved in one file.
  • If the Arduino is restarted or unplugged, the script reconnects automatically within a few seconds.
  • If the Pi is restarted, systemd brings the script back up on boot.

Log file format

────────────────────────────────────────────────────────────
Logger started  2026-04-14 19:30:00
────────────────────────────────────────────────────────────
[2026-04-14 19:30:01.042] [CONNECT] Opening /dev/ttyACM0 at 9600 baud …
[2026-04-14 19:30:01.108] [CONNECT] Connected to /dev/ttyACM0
[2026-04-14 19:30:05.210] ----------------------------
[2026-04-14 19:30:05.212] [BUTTON] Q2 / Button 3  (pin D7)
[2026-04-14 19:30:05.213] [RESULT] HALF-CORRECT
[2026-04-14 19:30:05.215] [TEMP]   4 → 5 sections
[2026-04-14 19:30:05.217] [STATE]  Q1:-  Q2:HALF  Q3:OK  Q4:WRONG
[2026-04-14 19:30:12.001] [DISCONNECT] Lost connection to /dev/ttyACM0: …
[2026-04-14 19:30:12.002] [RECONNECT] Retrying in 3s …
[2026-04-14 19:30:15.110] [CONNECT] Connected to /dev/ttyACM0

Network / SSH access

The Banana Pi has a static IP configured for direct laptop connection over ethernet (no router):

Device IP
Banana Pi 192.168.55.2
Laptop 192.168.55.1

Connect with:

ssh pi@192.168.55.2

The static IP is configured via systemd-networkd. The config file lives at /etc/systemd/network/50-static.network on the Banana Pi:

[Match]
Name=eth0

[Network]
Address=192.168.55.2/24

No gateway or DNS needed for a direct laptop-to-Pi connection.

To apply changes to the network config:

sudo systemctl restart systemd-networkd

Setup

Note: The instructions below use pi as the username and /home/pi/ as the path. Adjust these to match your actual username (e.g. pi on Raspberry Pi OS, pi or bananapi on Armbian for Banana Pi — run whoami to check).

1. Install Python dependency

pip install pyserial

2. Add your user to the dialout group

This allows the script to access serial ports without root.

sudo usermod -aG dialout pi

Log out and back in (or reboot) for the group change to take effect.

3. Copy the repo to the Pi

# On the Pi, clone the repo or copy the folder.
# The path used in the service file is /home/pi/ExploringUncertanties — adjust if needed.
git clone <your-repo-url> /home/pi/ExploringUncertanties

4. Edit the service file

Open arduino-logger.service and update the two lines that reference paths/username:

User=pi                       # ← change if your Pi username is different
ExecStart=/usr/bin/python3 /home/pi/ExploringUncertanties/dataLogging/log_serial.py

Check where Python 3 lives on your Pi:

which python3    # typically /usr/bin/python3

5. Install and enable the service

# Copy the unit file to systemd
sudo cp /home/pi/ExploringUncertanties/dataLogging/arduino-logger.service \
        /etc/systemd/system/arduino-logger.service

# Reload systemd so it sees the new file
sudo systemctl daemon-reload

# Enable the service (auto-start on every boot)
sudo systemctl enable arduino-logger

# Start it now without rebooting
sudo systemctl start arduino-logger

6. Verify it is running

sudo systemctl status arduino-logger

You should see Active: active (running).


Useful commands

# Check current status
sudo systemctl status arduino-logger

# See the last 50 lines of systemd output (useful for debugging startup)
journalctl -u arduino-logger -n 50

# Follow live output in the terminal
journalctl -u arduino-logger -f

# Or tail the log file directly
tail -f /home/pi/ExploringUncertanties/dataLogging/arduino.log

# Stop the service
sudo systemctl stop arduino-logger

# Disable auto-start (won't start on next boot)
sudo systemctl disable arduino-logger

Port auto-detection

The script finds the Arduino port automatically in this order:

  1. Any port whose description contains "Arduino" (official boards)
  2. Any port whose description contains "CH340" or "CH341" (common clones)
  3. Any ttyACM* or ttyUSB* device (fallback for any USB-serial adapter)

If no port is found, it retries every 5 seconds and logs a [WAIT] message. Once the Arduino is plugged in it connects without any user action.

To force a specific port (e.g. if you have two USB serial devices):

# Edit the ExecStart line in the service file:
ExecStart=/usr/bin/python3 /home/pi/ExploringUncertanties/dataLogging/log_serial.py --port /dev/ttyACM1

Reconnection behaviour

Event What happens
Arduino restarted (button or power cycle) Script detects disconnect, waits 3 s, reconnects
Arduino unplugged and replugged Script scans for the port again, reconnects
Pi restarted / powered on systemd starts the script automatically after boot
Script crashes systemd restarts it after 5 s (Restart=always)

Manual usage (without systemd)

# Auto-detect port, log to default file
python3 log_serial.py

# Specific port
python3 log_serial.py --port /dev/ttyACM1

# Different log file
python3 log_serial.py --out /home/pi/logs/session.log

# List available ports
python3 log_serial.py --list-ports