| name | fixture-discovery |
| description | Run KiNet fixture discovery scans on Spireworks installations (sven, hlp20, hlp30). Use when the user asks to scan fixtures, check PDS health, run discovery, or generate fixture status reports. |
Fixture Discovery
Overview
Scan Spireworks LED fixture installations via KiNet protocol to verify all PDS (Power Data Supply) units and fixtures are responding correctly. Supports both Python network discovery and Clojure simulator EDN commands.
Workflow
1. PDS Health Check (no flicker)
Ping all PDS units to verify reachability before running discovery:
cd ../spire-ansible && ssh -F .ssh/config <host> "echo '{:cmds [{:name :ping-all-pds}]}' | nc -w 60 localhost 8090"
For a single PDS:
cd ../spire-ansible && ssh -F .ssh/config <host> "echo '{:cmds [{:name :ping-pds :ip \"<ip>\"}]}' | nc -w 30 localhost 8090"
2. Run Python Discovery
SSH into the server and run the Python discovery script:
cd ../spire-ansible && ssh -F .ssh/config <host>
cd ~/spireworks-nix/discover-network
python3 Discover_Network.py <input-file>
Input files per installation:
- sven:
sven-input.csv
- hlp20:
hlp20
- hlp30:
hlp30
The script outputs a CSV file named output<MM-DD-YY-HHMMSS>.csv.
3. Run Clojure Discovery (causes flicker)
Trigger full installation discovery via the simulator:
cd ../spire-ansible && ssh -F .ssh/config <host> "echo '{:cmds [{:name :discover-installation :force true}]}' | nc -w 300 localhost 8090"
For a single PDS:
cd ../spire-ansible && ssh -F .ssh/config <host> "echo '{:cmds [{:name :discover-pds :ip \"<ip>\" :force true}]}' | nc -w 120 localhost 8090"
4. Copy CSV and Generate Report
Copy the discovery CSV locally:
cd ../spire-ansible && scp -F .ssh/config <host>:~/spireworks-nix/discover-network/<csv-file> /Users/sadjow/spire/spireworks-docs/reports/infrastructure/
Generate a report using the analysis script:
python3 scripts/analyze_discovery.py <csv_file> <installation> [--previous <prev_csv>]
Save the report to reports/infrastructure/<installation>_fixture_status_<date>.md.
5. Verify with Datadog
After Clojure discovery, check simulator.kinet.discovery.fixtures gauge in Datadog to cross-reference counts.
SSH Hosts
| Installation | SSH Host | Server IP |
|---|
| Sven | sven | 172.31.166.44 |
| HLP20/HLP30 | hlp | 172.31.155.3 |
All SSH access goes through ../spire-ansible with ssh -F .ssh/config <host>.
Resources
scripts/
analyze_discovery.py — Parses discovery CSV files and generates markdown status reports with declared vs discovered comparison
references/
installations.md — Network topology, IP addresses, and declared fixture counts per PDSedn-commands.md — EDN command reference with timeout guidelines
