Files

78 lines
3.3 KiB
Plaintext

========================================================
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.
========================================================