========================================================
  M1730 ANALOG PANEL METER CONTROLLER — INSTRUCTION CARD
========================================================
(Meters and current-limiting resistors are already installed.)

FIRST-TIME WI-FI SETUP
  - Power on the device (USB or 5V supply).
  - On your phone/laptop, join the Wi-Fi network named "M1730".
  - A setup page opens automatically (captive portal).
  - Pick your Wi-Fi network, enter its password.
  - Optionally set a Device hostname (default: m1730).
  - Tap Save. The device joins your network and restarts.

OPENING THE CONFIG PAGE
  - Browse to  http://m1730.local  (or your chosen hostname).
  - If .local doesn't resolve, use the IP address shown on the
    serial monitor at boot: http://<IP>
  - The Info panel at the top shows the current hostname and IP.

CONFIGURING A METER
  - Use the "Meters" dropdown to set how many meters (1-10).
  - For each meter (shown as tabs when more than one):
      * Pin      - GPIO pin the meter is wired to (already set)
      * Name     - label shown in the UI and Home Assistant
      * Unit     - optional (e.g. W, A, °C)
      * Min/Max  - the meter's real-world range (e.g. 0-50 A)
      * Max Duty - calibration for full-scale deflection (%)
      * Output   - live slider, moves the needle right away
  - Tap Save to store all settings (survives reboots).

CALIBRATING FULL SCALE (Max Duty)
  - Drag the Output slider to 100%.
  - Slowly raise "Max Duty" until the needle just reaches the
    end of the scale. Don't overshoot. Tap Save.

MOVING THE NEEDLE
  - Web UI: drag a meter's Output slider (0-100%).
  - Values sent over MQTT/Home Assistant use the real Min-Max
    range (e.g. send 25 to a 0-50 meter = half scale).

HTTP CONTROL (DIRECT URL)
  - Move a needle from a browser or script with a GET request:
        http://m1730.local/set?i=<meter>&v=<value>
      * i = meter index, starting at 0 (first meter = 0)
      * v = value 0-100 (percent of full scale)
  - Example: http://m1730.local/set?i=0&v=75  -> meter 0 to 75%.
  - Applies instantly, saves it, and publishes to MQTT.
  - Returns 200 OK on success, 400 on bad input.

HOME ASSISTANT (MQTT)
  - Open the MQTT section on the config page.
  - Enable, then enter Broker host, Port (1883), User, Pass,
    and Prefix (default: m1730). Tap Save.
  - Each meter shows up automatically in Home Assistant as a
    Number entity, grouped under one device (the hostname).

SECURITY (OPTIONAL PASSWORD)
  - In the Security section, turn on "Require password" and set
    a password. Username is always: admin
  - Leave the password field blank to keep the existing one.

RESTART
  - "Reset Device" button = simple reboot (keeps all settings).

FACTORY RESET (if locked out or misconfigured)
  - Power-cycle (or press EN) 5 times quickly, within a few
    seconds each, before boot completes.
      * 5x  = clears settings BUT keeps meter pins + calibration
      * 10x = clears everything, including saved Wi-Fi
  - All meters sweep 0 -> full -> 0 to confirm the reset.
  - After a 10x reset, redo "First-time Wi-Fi setup" above.

TIPS
  - Settings are saved on the device and survive power loss.
  - If the meter reads zero unexpectedly, check the Pin number
    and that Max Duty is greater than 0.
========================================================