diff --git a/card.txt b/card.txt new file mode 100644 index 0000000..04a9f07 --- /dev/null +++ b/card.txt @@ -0,0 +1,77 @@ +======================================================== + 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:// + - 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=&v= + * 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. +======================================================== diff --git a/card_de.txt b/card_de.txt new file mode 100644 index 0000000..8a6e7b8 --- /dev/null +++ b/card_de.txt @@ -0,0 +1,84 @@ +======================================================== + M1730 ANALOG-ZEIGERINSTRUMENT-STEUERUNG — KURZANLEITUNG +======================================================== +(Messwerke und Vorwiderstände sind bereits eingebaut.) + +ERSTE WLAN-EINRICHTUNG + - Gerät einschalten (USB oder 5-V-Netzteil). + - Am Handy/Laptop das WLAN mit dem Namen "M1730" auswählen. + - Die Einrichtungsseite öffnet sich automatisch (Captive Portal). + - Eigenes WLAN auswählen und dessen Passwort eingeben. + - Optional einen Gerätenamen (Hostname) festlegen (Standard: m1730). + - Auf Speichern tippen. Das Gerät verbindet sich und startet neu. + +KONFIGURATIONSSEITE ÖFFNEN + - Im Browser aufrufen: http://m1730.local (oder den gewählten + Hostnamen). + - Falls .local nicht auflöst, die beim Start im seriellen Monitor + angezeigte IP-Adresse verwenden: http:// + - Das Info-Feld oben zeigt aktuellen Hostnamen und IP-Adresse. + +MESSWERK KONFIGURIEREN + - Über das Auswahlfeld "Meters" die Anzahl der Messwerke + festlegen (1-10). + - Für jedes Messwerk (als Reiter dargestellt, wenn mehr als eins): + * Pin - GPIO-Pin, an dem das Messwerk hängt (bereits gesetzt) + * Name - Bezeichnung in der Oberfläche und in Home Assistant + * Unit - optional (z. B. W, A, °C) + * Min/Max - realer Messbereich (z. B. 0-50 A) + * Max Duty - Kalibrierung für den Vollausschlag (%) + * Output - Live-Schieberegler, bewegt den Zeiger sofort + - Auf Speichern tippen, um alle Einstellungen zu sichern + (bleiben nach Neustart erhalten). + +VOLLAUSSCHLAG KALIBRIEREN (Max Duty) + - Den Output-Schieberegler auf 100 % ziehen. + - "Max Duty" langsam erhöhen, bis der Zeiger gerade das Ende + der Skala erreicht. Nicht überschreiten. Speichern. + +ZEIGER BEWEGEN + - Weboberfläche: den Output-Schieberegler ziehen (0-100 %). + - Über MQTT/Home Assistant gesendete Werte verwenden den realen + Min-Max-Bereich (z. B. 25 an ein 0-50-Messwerk = halber + Ausschlag). + +HTTP-STEUERUNG (DIREKTE URL) + - Einen Zeiger per GET-Anfrage aus Browser oder Skript bewegen: + http://m1730.local/set?i=&v= + * i = Index des Messwerks, beginnend bei 0 (erstes = 0) + * v = Wert 0-100 (Prozent des Vollausschlags) + - Beispiel: http://m1730.local/set?i=0&v=75 -> Messwerk 0 auf 75 %. + - Wirkt sofort, wird gespeichert und an MQTT veröffentlicht. + - Antwort: 200 OK bei Erfolg, 400 bei ungültiger Eingabe. + +HOME ASSISTANT (MQTT) + - Auf der Konfigurationsseite den Abschnitt MQTT öffnen. + - Aktivieren, dann Broker-Host, Port (1883), Benutzer, Passwort + und Präfix (Standard: m1730) eingeben. Speichern. + - Jedes Messwerk erscheint automatisch in Home Assistant als + Number-Entität, gruppiert unter einem Gerät (dem Hostnamen). + +SICHERHEIT (OPTIONALES PASSWORT) + - Im Abschnitt Security "Require password" aktivieren und ein + Passwort setzen. Der Benutzername ist immer: admin + - Das Passwortfeld leer lassen, um das bestehende beizubehalten. + +NEUSTART + - Schaltfläche "Reset Device" = einfacher Neustart (alle + Einstellungen bleiben erhalten). + +WERKSRESET (bei Aussperrung oder Fehlkonfiguration) + - Gerät 5-mal schnell aus- und einschalten (oder EN drücken), + jeweils innerhalb weniger Sekunden, bevor der Start abgeschlossen ist. + * 5x = löscht Einstellungen, BEHÄLT aber Pins + Kalibrierung + * 10x = löscht alles, einschließlich gespeichertem WLAN + - Alle Messwerke fahren 0 -> Voll -> 0 zur Bestätigung des Resets. + - Nach einem 10x-Reset die "ERSTE WLAN-EINRICHTUNG" oben + erneut durchführen. + +HINWEISE + - Einstellungen werden im Gerät gespeichert und überstehen + einen Stromausfall. + - Zeigt ein Messwerk unerwartet null an, den Pin prüfen und + sicherstellen, dass Max Duty größer als 0 ist. +======================================================== diff --git a/card_fr.txt b/card_fr.txt new file mode 100644 index 0000000..a4bb0f2 --- /dev/null +++ b/card_fr.txt @@ -0,0 +1,90 @@ +======================================================== + CONTRÔLEUR DE GALVANOMÈTRE ANALOGIQUE M1730 — GUIDE RAPIDE +======================================================== +(Les galvanomètres et résistances série sont déjà installés.) + +PREMIÈRE CONFIGURATION WI-FI + - Mettre l'appareil sous tension (USB ou alimentation 5 V). + - Sur votre téléphone/ordinateur, rejoindre le réseau Wi-Fi + nommé « M1730 ». + - La page de configuration s'ouvre automatiquement (portail captif). + - Choisir votre réseau Wi-Fi et saisir son mot de passe. + - Éventuellement définir un nom d'hôte (Hostname) (défaut : m1730). + - Appuyer sur Save. L'appareil rejoint le réseau et redémarre. + +OUVRIR LA PAGE DE CONFIGURATION + - Dans le navigateur, aller à : http://m1730.local + (ou le nom d'hôte choisi). + - Si .local ne fonctionne pas, utiliser l'adresse IP affichée + au démarrage dans le moniteur série : http:// + - Le panneau Info en haut indique le nom d'hôte et l'adresse IP. + +CONFIGURER UN GALVANOMÈTRE + - Utiliser le menu déroulant « Meters » pour définir le nombre + de galvanomètres (1-10). + - Pour chaque galvanomètre (affiché en onglets s'il y en a + plusieurs) : + * Pin - broche GPIO câblée au galvanomètre (déjà définie) + * Name - libellé affiché dans l'interface et Home Assistant + * Unit - facultatif (p. ex. W, A, °C) + * Min/Max - plage réelle de mesure (p. ex. 0-50 A) + * Max Duty - calibrage pour la déviation pleine échelle (%) + * Output - curseur en direct, déplace l'aiguille aussitôt + - Appuyer sur Save pour enregistrer tous les réglages + (conservés après redémarrage). + +CALIBRER LA PLEINE ÉCHELLE (Max Duty) + - Amener le curseur Output à 100 %. + - Augmenter lentement « Max Duty » jusqu'à ce que l'aiguille + atteigne juste le bout de l'échelle. Ne pas dépasser. Save. + +DÉPLACER L'AIGUILLE + - Interface web : faire glisser le curseur Output (0-100 %). + - Les valeurs envoyées via MQTT/Home Assistant utilisent la + plage réelle Min-Max (p. ex. envoyer 25 à un galvanomètre + 0-50 = mi-échelle). + +CONTRÔLE HTTP (URL DIRECTE) + - Déplacer une aiguille via une requête GET depuis un + navigateur ou un script : + http://m1730.local/set?i=&v= + * i = index du galvanomètre, à partir de 0 (le premier = 0) + * v = valeur 0-100 (pourcentage de la pleine échelle) + - Exemple : http://m1730.local/set?i=0&v=75 -> galvanomètre 0 à 75 %. + - Effet immédiat, enregistré et publié sur MQTT. + - Réponse : 200 OK en cas de succès, 400 si l'entrée est invalide. + +HOME ASSISTANT (MQTT) + - Ouvrir la section MQTT sur la page de configuration. + - Activer, puis saisir l'hôte du Broker, le Port (1883), + l'utilisateur, le mot de passe et le préfixe (défaut : m1730). + Save. + - Chaque galvanomètre apparaît automatiquement dans Home + Assistant comme entité Number, regroupée sous un seul + appareil (le nom d'hôte). + +SÉCURITÉ (MOT DE PASSE FACULTATIF) + - Dans la section Security, activer « Require password » et + définir un mot de passe. Le nom d'utilisateur est toujours : admin + - Laisser le champ mot de passe vide pour conserver l'actuel. + +REDÉMARRAGE + - Bouton « Reset Device » = simple redémarrage (tous les + réglages sont conservés). + +RÉINITIALISATION D'USINE (si verrouillé ou mal configuré) + - Éteindre/rallumer (ou appuyer sur EN) 5 fois rapidement, + à quelques secondes d'intervalle, avant la fin du démarrage. + * 5x = efface les réglages MAIS conserve broches + calibrage + * 10x = efface tout, y compris le Wi-Fi enregistré + - Tous les galvanomètres balaient 0 -> plein -> 0 pour + confirmer la réinitialisation. + - Après une réinitialisation 10x, refaire la « PREMIÈRE + CONFIGURATION WI-FI » ci-dessus. + +CONSEILS + - Les réglages sont enregistrés dans l'appareil et survivent + à une coupure de courant. + - Si un galvanomètre indique zéro de façon inattendue, vérifier + le numéro de Pin et que Max Duty est supérieur à 0. +========================================================