slmm/archive/README.md

SLMM Archive

This directory contains legacy scripts that are no longer needed for normal operation but are preserved for reference.

Legacy Migrations (legacy_migrations/)

These migration scripts were used during SLMM development (v0.1.x) to incrementally add database fields. They are no longer needed because:

1. Fresh databases get the complete schema automatically from app/models.py
2. Existing databases should already have these fields from previous runs
3. Current migration is migrate_add_polling_fields.py (v0.2.0) in the parent directory

Archived Migration Files

• migrate_add_counter.py - Added counter field to NL43Status
• migrate_add_measurement_start_time.py - Added measurement_start_time field
• migrate_add_ftp_port.py - Added ftp_port field to NL43Config
• migrate_field_names.py - Renamed fields for consistency (one-time fix)
• migrate_revert_field_names.py - Rollback for the rename migration

Do not delete - These provide historical context for database schema evolution.

---

Legacy Tools

nl43_dod_poll.py

Manual polling script that queries a single NL-43 device for DOD (Device On-Demand) data.

Status: Replaced by background polling system in v0.2.0

Why archived:

• Background poller (app/background_poller.py) now handles continuous polling automatically
• No need for manual polling scripts
• Kept for reference in case manual querying is needed for debugging

How to use (if needed):

cd /home/serversdown/tmi/slmm/archive
python3 nl43_dod_poll.py <host> <port> <unit_id>

---

Active Scripts (Still in Parent Directory)

These scripts are actively used and documented in the main README:

Migrations

• migrate_add_polling_fields.py - v0.2.0 migration - Adds background polling fields
• migrate_add_ftp_credentials.py - Legacy FTP migration - Adds FTP auth fields

Testing

• test_polling.sh - Comprehensive test suite for background polling features
• test_settings_endpoint.py - Tests device settings API
• test_sleep_mode_auto_disable.py - Tests automatic sleep mode handling

Utilities

• set_ftp_credentials.py - Command-line tool to set FTP credentials for a device

---

Version History

• v0.2.0 (2026-01-15) - Background polling system added, manual polling scripts archived
• v0.1.0 (2025-12-XX) - Initial release with incremental migrations