Troubleshooting & Operational Runbook

This operational runbook provides field diagnostic playbooks for electricians, installers, and remote support engineers troubleshooting the Aslandi Edge Converter.

---

1. Quick Incident Diagnostic Matrix

Symptom	Probable Cause	Diagnostic Check	Remediation Action
Status LED blinks rapid RED	Power supply voltage drop below $4.75\text{ V}$	Measure 5V rail with DMM	Verify power supply capacity ($5\text{V} / 2\text{A}$ minimum required).
No meters discovered in scan	Inverted A/B RS-485 polarity or wrong baud	Check voltage difference ($V_A - V_B \approx 200\text{ mV}$)	Swap $A$ and $B$ differential wires; ensure $120\ \Omega$ termination jumper is set.
Status LED blinks YELLOW	MicroSD card unseated or corrupted block	Check /api/status SD alarm flag	Re-seat card or format with FAT32/exFAT; firmware will initialize fresh mirrors.
Cloud connection fails (DISCONNECTED)	mTLS handshake rejection or clock drift	Check RTC time in /api/time	Ensure converter date/time is valid; expired or wrong clock will fail TLS handshake.
Cannot access 192.168.4.1	SoftAP timed out (15-min limit)	Search for Wi-Fi SSID	Press the service button on converter to re-enable SoftAP mode for 15 minutes.
LOGIN_LOCKOUT on web panel	5 consecutive invalid PIN attempts	Observe status screen	Wait 15 minutes for security lockout timer to expire, then enter PIN from label.

---

2. Deep-Dive Field Diagnostics

A. RS-485 Communication Loss

1. Check Bus Voltage: When idle, the non-inverting terminal ($A$) should measure approximately $+2.5\text{ V}$ to $+3.3\text{ V}$, and inverting terminal ($B$) should measure $+1.5\text{ V}$ to $+2.5\text{ V}$.
2. Termination Resistors: A long RS-485 daisy chain requires exactly two $120\ \Omega$ termination resistors — one at the converter and one at the final physical meter on the bus. Unpowered resistance between $A$ and $B$ across the bus should measure approximately $60\ \Omega$.
3. Meter Slave Address Conflict: Ensure each meter on Channel 0 has a unique slave ID in the range 1 to 50.

B. MicroSD Card Recovery Procedure

If the converter flags ALARM_SD_CORRUPTED:

1. Power down the converter.
2. Remove the microSD card and insert it into a diagnostic PC.
3. If partition is unreadable, reformat the card using the official SD Card Formatter tool.
4. Re-insert the card and power on the converter. The firmware automatically detects the clean card, generates fresh encryption sectors, and resumes mirroring.

---

3. Hardware Factory Reset

To restore the converter to factory default settings (clearing Wi-Fi credentials and resetting to SoftAP mode):

flowchart LR
    Step1["1. Power off converter"] --> Step2["2. Hold down service button"]
    Step2 --> Step3["3. Apply power while holding button"]
    Step3 --> Step4["4. Keep button pressed for 10 seconds until LED blinks WHITE"]
    Step4 --> Step5["5. Release button; configuration wiped & device reboots into SoftAP mode"]