Add complete French (fr) and Chinese (zh) translations for all documentation: - Root files: README, CHANGELOG, SECURITY, BETA-RELEASE - docs/: All 16 core documentation files - DOCS/: All 19 deep-dive documents including embedded/ and archive/ - package/secubox/: All 123+ package READMEs - Misc: secubox-tools/, scripts/, EXAMPLES/, config-backups/, streamlit-apps/ Total: 346 translation files created Each file includes language switcher links for easy navigation between English, French, and Chinese versions. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
62 lines
2.5 KiB
Markdown
62 lines
2.5 KiB
Markdown
# LuCI App - Zigbee2MQTT
|
|
|
|
[English](README.md) | Francais | [中文](README.zh.md)
|
|
|
|
**Version :** 1.0.0
|
|
**Derniere mise a jour :** 2025-12-28
|
|
**Statut :** Actif
|
|
|
|
Interface LuCI pour la gestion du service Zigbee2MQTT base sur Docker, fourni par `secubox-app-zigbee2mqtt`.
|
|
|
|
## Fonctionnalites
|
|
|
|
- Affiche le statut du service/conteneur, l'activation et les actions rapides (demarrer/arreter/redemarrer/mettre a jour).
|
|
- Execute les verifications de prerequis et l'installation complete de Docker (dockerd/containerd/pull d'image) via les boutons LuCI.
|
|
- Fournit un formulaire pour editer `/etc/config/zigbee2mqtt` (port serie, hote MQTT, identifiants, topic de base, port frontend, canal, chemin des donnees, image docker, fuseau horaire).
|
|
- Diffuse les logs Docker directement dans LuCI.
|
|
- Utilise le systeme de design SecuBox et le backend RPCD (`luci.zigbee2mqtt`).
|
|
|
|
## Prerequis
|
|
|
|
- Package `secubox-app-zigbee2mqtt` installe (fournit le CLI + service procd).
|
|
- Runtime Docker (`dockerd`, `docker`, `containerd`) disponible sur le routeur.
|
|
- Coordinateur Zigbee connecte (ex. `/dev/ttyACM0`).
|
|
|
|
## Installation
|
|
|
|
```sh
|
|
opkg update
|
|
opkg install secubox-app-zigbee2mqtt luci-app-zigbee2mqtt
|
|
```
|
|
|
|
Acces via LuCI : **Services -> SecuBox -> Zigbee2MQTT**.
|
|
|
|
## Fichiers
|
|
|
|
| Chemin | Fonction |
|
|
|--------|----------|
|
|
| `htdocs/luci-static/resources/view/zigbee2mqtt/overview.js` | Vue LuCI principale. |
|
|
| `htdocs/luci-static/resources/zigbee2mqtt/api.js` | Liaisons RPC. |
|
|
| `root/usr/libexec/rpcd/luci.zigbee2mqtt` | Backend RPC interagissant avec UCI et `zigbee2mqttctl`. |
|
|
| `root/usr/share/luci/menu.d/luci-app-zigbee2mqtt.json` | Entree de menu. |
|
|
| `root/usr/share/rpcd/acl.d/luci-app-zigbee2mqtt.json` | ACL par defaut. |
|
|
|
|
## Methodes RPC
|
|
|
|
- `status` - Retourne la configuration UCI, l'etat d'activation/fonctionnement du service, la liste des conteneurs Docker.
|
|
- `apply` - Met a jour les champs UCI, valide et redemarre le service.
|
|
- `logs` - Affiche les logs du conteneur.
|
|
- `control` - Demarrer/arreter/redemarrer le service via le script init.
|
|
- `update` - Telecharger la derniere image et redemarrer.
|
|
|
|
## Notes de developpement
|
|
|
|
- Suivre les tokens de design SecuBox (voir `DOCS/DEVELOPMENT-GUIDELINES.md`).
|
|
- Garder les noms de fichiers RPC alignes avec le nom d'objet ubus (`luci.zigbee2mqtt`).
|
|
- Valider avec `./secubox-tools/validate-modules.sh`.
|
|
|
|
## Documentation
|
|
|
|
- Guide de deploiement : [`docs/embedded/zigbee2mqtt-docker.md`](../docs/embedded/zigbee2mqtt-docker.md)
|
|
- L'assistant CLI (`zigbee2mqttctl`) est fourni par `secubox-app-zigbee2mqtt`.
|