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.pyauto-detects the Arduino's USB serial port on startup.- Every line received from the Arduino is written to
arduino.logwith 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
pias the username and/home/pi/as the path. Adjust these to match your actual username (e.g.pion Raspberry Pi OS,piorbananapion Armbian for Banana Pi — runwhoamito 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:
- Any port whose description contains "Arduino" (official boards)
- Any port whose description contains "CH340" or "CH341" (common clones)
- 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