Référence API JsonRPC
ETM PowerSync expose l'API JSON-RPC de nymea en local, y compris les extensions ETM
(Energy, AirConditioning, EvDash).
Connexion
| Mode |
Adresse |
Notes |
| TCP brut |
<ip>:2222 |
nymea parle en premier (welcome JSON \n-delimited) |
| WebSocket |
ws://<ip>:4444 |
le client envoie JSONRPC.Hello en premier |
Authentification
- Appeler
JSONRPC.Authenticate avec
username, password et deviceName → reçoit un token.
- Inclure le
token dans chaque requête suivante.
- Activer les push :
JSONRPC.SetNotificationStatus { "enabled": true }.
Conventions énergie
| Grandeur |
Convention |
| Production PV |
valeur négative (convention producteur) |
currentPowerAcquisition |
réseau — positif = import, 0 si export |
currentPowerStorage |
batterie — positif = charge, négatif = décharge |
| Totaux d'énergie |
en kWh |
| Timestamps |
en secondes (Unix epoch) |
Badges de permission
| Badge |
Scope |
Description |
| PUBLIC |
PermissionScopeNone |
Lecture publique, aucun token requis |
| CONTROL |
PermissionScopeControlThings / ExecuteRules |
Contrôle des appareils et règles |
| CONFIGURE |
PermissionScopeConfigureThings / ConfigureRules |
Configuration |
| ADMIN |
PermissionScopeAdmin |
Administration système |