325409dd3f
82 pages .de.md et 82 .en.md. La volumétrie explique la forme : 95 % du volume est GÉNÉRÉ (74 013 mots contre 3 506 rédigés, mesuré sur 107 pages). On ne traduisait donc pas 77 500 mots — on traduit la prose, et le vocabulaire des générateurs fait le reste. Prose traduite à la main : accueil, installation (4), fonctionnalités (4), tarifs, référence, dépannage, FAQ, intégrations (2), api/index, et les 6 fiches appareils qui portent une vraie prose + compatibilite.md. Les blocs générés ne sont JAMAIS recopiés dans une traduction : le script de pose les reprend verbatim du fichier français via des placeholders, pour qu'une traduction ne puisse pas désynchroniser un bloc généré. Les 49 fiches légères n'ont rien à traduire : leur tagline vient d'amont et est DÉJÀ en anglais (« Connects nymea to powerfox. »). Constat, pas renoncement. Localisation ≠ traduction, et tarifs.md en est l'exemple à connaître : la version FR parle de Tempo et du signal RTE, la DE de §14a EnWG et de SMARD, l'EN des deux. Ce ne sont pas des traductions l'une de l'autre, et c'est volontaire — les signaux tarifaires sont nationaux. Aucune des deux n'est annoncée comme livrée : les deux sont Roadmap, et les pages le disent. Référence régénérée : en-têtes et libellés en anglais (Field/Type/Notes, Supported models, Settings, Read-only, Brand / Model…). Conséquence assumée et signalée : les pages FR en ligne changent aussi. README.md (il était VIDE) : la règle du 95 % généré en tête, la frontière de décision du multi-langue avec sa mesure, pourquoi SCAFFOLD existe, et le piège --strict/navigation.instant. TODO : multi-langue clos, et trois points ouverts qui en restent — les tagline vivent dans les meta.json de 5 autres dépôts (forme à ajouter : tagline_de / tagline_en), les stubs traduits restent des stubs (la dette éditoriale a triplé en surface, pas en fond), api/types.md n'a pas besoin de variante. Le P1 openmeteo est corrigé sur constat : il EST dans PORTING_STATUS depuis, et une ligne commentée contradictoire y traîne encore. Vérifié : mkdocs build --strict vert sur les trois langues, 322 pages HTML, contenu traduit relu dans le HTML produit, et les deux générateurs rendent « Doc à jour » en --check. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
11 KiB
System
Methods
System.CheckForUpdates
ADMIN
Instruct the system to poll the server for updates. Normally the system should automatically do this in regular intervals, however, if the client wants to allow the user to manually check for new updates now, this can be called. Returns true if the operation has been started successfully and the update manager will become busy. In order to know whether there are updates available, clients should walk through the list of packages retrieved from GetPackages and check whether there are packages with the updateAvailable flag set to true.
Parameters:
No parameters.
Returns:
| Field | Type | Notes |
|---|---|---|
success |
Bool |
System.EnableRepository
ADMIN
Enable or disable a repository.
Parameters:
| Field | Type | Notes |
|---|---|---|
enabled |
Bool |
|
repositoryId |
String |
Returns:
| Field | Type | Notes |
|---|---|---|
success |
Bool |
System.FactoryReset
ADMIN
Reset nymea to factory defaults. Clients should warn the user before calling this method because all current configuration data will be lost, the server will restart immediately afterwards and it will come back up using the factory defaults if any are available.
Parameters:
No parameters.
Returns:
| Field | Type | Notes |
|---|---|---|
success |
Bool |
System.GetCapabilities
ADMIN
Get the list of capabilites on this system. The property "powerManagement" indicates whether restarting nymea and rebooting or shutting down is supported on this system. The property "updateManagement" indicates whether system update features are available in this system. The "updateManagementType" indicates which kind of update is supported on this platform. The property "timeManagement" indicates whether the system time can be configured on this system. Note that GetTime will be available in any case.
Parameters:
No parameters.
Returns:
| Field | Type | Notes |
|---|---|---|
powerManagement |
Bool |
|
timeManagement |
Bool |
|
updateManagement |
Bool |
|
updateManagementType |
UpdateType |
System.GetPackages
ADMIN
Get the list of packages currently available to the system. This might include installed available but not installed packages. Installed packages will have the installedVersion set to a non-empty value.
Parameters:
No parameters.
Returns:
| Field | Type | Notes |
|---|---|---|
packages |
Packages |
System.GetRepositories
ADMIN
Get the list of repositories currently available to the system.
Parameters:
No parameters.
Returns:
| Field | Type | Notes |
|---|---|---|
repositories |
Repositories |
System.GetSystemInfo
ADMIN
Returns information about the system nymea is running on.
Parameters:
No parameters.
Returns:
| Field | Type | Notes |
|---|---|---|
deviceSerialNumber |
String |
System.GetTime
ADMIN
Get the system time and configuraton. The "time" and "timeZone" properties give the current server time and time zone. "automaticTimeAvailable" indicates whether this system supports automatically setting the clock (e.g. using NTP). "automaticTime" will be true if the system is configured to automatically update the clock.
Parameters:
No parameters.
Returns:
| Field | Type | Notes |
|---|---|---|
automaticTime |
Bool |
|
automaticTimeAvailable |
Bool |
|
time |
Uint |
|
timeZone |
String |
System.GetTimeZones
ADMIN
Returns the list of IANA specified time zone IDs which can be used to select a time zone. It is not required to use this method if the client toolkit already provides means to obtain a list of IANA time zone ids.
Parameters:
No parameters.
Returns:
| Field | Type | Notes |
|---|---|---|
timeZones |
StringList |
System.GetUpdateStatus
ADMIN
Get the current status of the update system. "busy" indicates that the system is current busy with an operation regarding updates. This does not necessarily mean an actual update is running. When this is true, update related functions on the client should be marked as busy and no interaction with update components shall be allowed. An example for such a state is when the system queries the server if there are updates available, typically after a call to CheckForUpdates. "updateRunning" on the other hand indicates an actual update process is ongoing. The user should be informed about it, the system also might restart at any point while an update is running. The "updateProgress" property is optional, if the backend supports it, a progress >= 0 indicated the update progress in percentage.
Parameters:
No parameters.
Returns:
| Field | Type | Notes |
|---|---|---|
busy |
Bool |
|
updateProgress |
Int |
optional |
updateRunning |
Bool |
System.Reboot
ADMIN
Initiate a reboot of the system. The return value will indicate whether the procedure has been initiated successfully.
Parameters:
No parameters.
Returns:
| Field | Type | Notes |
|---|---|---|
success |
Bool |
System.RemovePackages
ADMIN
Starts removing a package. Returns true if the removal has been started successfully. Before calling this method, clients should check whether the package can be removed (canRemove set to true).
Parameters:
| Field | Type | Notes |
|---|---|---|
packageIds |
String[] |
Returns:
| Field | Type | Notes |
|---|---|---|
success |
Bool |
System.Restart
ADMIN
Initiate a restart of the nymea service. The return value will indicate whether the procedure has been initiated successfully.
Parameters:
No parameters.
Returns:
| Field | Type | Notes |
|---|---|---|
success |
Bool |
System.RollbackPackages
ADMIN
Starts a rollback. Returns true if the rollback has been started successfully. Before calling this method, clients should check whether the package can be rolled back (canRollback set to true).
Parameters:
| Field | Type | Notes |
|---|---|---|
packageIds |
String[] |
Returns:
| Field | Type | Notes |
|---|---|---|
success |
Bool |
System.SetTime
ADMIN
Set the system time configuraton. The system can be configured to update the time automatically by setting "automaticTime" to true. This will only work if the "timeManagement" capability is available on this system and "GetTime" indicates the availability of automatic time settings. If any of those requirements are not met, this method will return "false" in the "success" property. In order to manually configure the time, "automaticTime" should be set to false and "time" should be set. Note that if "automaticTime" is set to true and a manual "time" is still passed, the system will attempt to configure automatic time updates and only set the manual time if automatic mode fails. A time zone can always be passed optionally to change the system time zone and should be a IANA time zone id.
Parameters:
| Field | Type | Notes |
|---|---|---|
automaticTime |
Bool |
optional |
time |
Uint |
optional |
timeZone |
String |
optional |
Returns:
| Field | Type | Notes |
|---|---|---|
success |
Bool |
System.Shutdown
ADMIN
Initiate a shutdown of the system. The return value will indicate whether the procedure has been initiated successfully.
Parameters:
No parameters.
Returns:
| Field | Type | Notes |
|---|---|---|
success |
Bool |
System.UpdatePackages
ADMIN
Starts updating/installing packages with the given ids. Returns true if the upgrade has been started successfully. Note that it might still fail later. Before calling this method, clients should check the packages whether they are in a state where they can either be installed (no installedVersion set) or upgraded (updateAvailable set to true).
Parameters:
| Field | Type | Notes |
|---|---|---|
packageIds |
String[] |
optional |
Returns:
| Field | Type | Notes |
|---|---|---|
success |
Bool |
Notifications
System.CapabilitiesChanged
Emitted whenever the system capabilities change.
Parameters:
| Field | Type | Notes |
|---|---|---|
powerManagement |
Bool |
|
updateManagement |
Bool |
|
updateManagementType |
UpdateType |
System.PackageAdded
Emitted whenever a package is added to the list of packages.
Parameters:
| Field | Type | Notes |
|---|---|---|
package |
Package |
System.PackageChanged
Emitted whenever a package in the list of packages changes.
Parameters:
| Field | Type | Notes |
|---|---|---|
package |
Package |
System.PackageRemoved
Emitted whenever a package is removed from the list of packages.
Parameters:
| Field | Type | Notes |
|---|---|---|
packageId |
String |
System.RepositoryAdded
Emitted whenever a repository is added to the list of repositories.
Parameters:
| Field | Type | Notes |
|---|---|---|
repository |
Repository |
System.RepositoryChanged
Emitted whenever a repository in the list of repositories changes.
Parameters:
| Field | Type | Notes |
|---|---|---|
repository |
Repository |
System.RepositoryRemoved
Emitted whenever a repository is removed from the list of repositories.
Parameters:
| Field | Type | Notes |
|---|---|---|
repositoryId |
String |
System.TimeConfigurationChanged
Emitted whenever the time configuration is changed
Parameters:
| Field | Type | Notes |
|---|---|---|
automaticTime |
Bool |
|
automaticTimeAvailable |
Bool |
|
time |
Uint |
|
timeZone |
String |
System.UpdateStatusChanged
Emitted whenever the update status changes.
Parameters:
| Field | Type | Notes |
|---|---|---|
busy |
Bool |
|
updateProgress |
Int |
optional |
updateRunning |
Bool |