ETM-Schurig/powersync-docs
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
powersync-docs/docs/api/systeme/zwave.md
Patrick Schurig 325409dd3f feat(i18n): prose traduite DE/EN et référence régénérée en anglais 
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>
2026-10-13 06:39:20 +02:00

5.0 KiB
Raw Permalink Blame History

ZWave

Methods

ZWave.AddNetwork

ADMIN

Add a new Z-Wave network with the given serial port.

Parameters:

Field Type Notes
serialPort String

Returns:

Field Type Notes
networkUuid Uuid optional
zwaveError ZWaveError

ZWave.AddNode

ADMIN

Start the node inclusion procedure for the given Z-Wave network.

Parameters:

Field Type Notes
networkUuid Uuid

Returns:

Field Type Notes
zwaveError ZWaveError

ZWave.CancelPendingOperation

ADMIN

Cancel any running node inclusion or removal procedure for the given Z-Wave network.

Parameters:

Field Type Notes
networkUuid Uuid

Returns:

Field Type Notes
zwaveError ZWaveError

ZWave.FactoryResetNetwork

ADMIN

Factory reset the controller for the given Z-Wave network.

Parameters:

Field Type Notes
networkUuid Uuid

Returns:

Field Type Notes
zwaveError ZWaveError

ZWave.GetNetworks

ADMIN

Get all the Z-Wave networks in the system.

Parameters:

No parameters.

Returns:

Field Type Notes
networks ZWaveNetwork[]

ZWave.GetNodes

ADMIN

Get the list of nodes in a network

Parameters:

Field Type Notes
networkUuid Uuid

Returns:

Field Type Notes
nodes ZWaveNode[] optional
zwaveError ZWaveError

ZWave.GetSerialPorts

ADMIN

Get the list of available serial ports from the host system.

Parameters:

No parameters.

Returns:

Field Type Notes
serialPorts SerialPorts

ZWave.IsZWaveAvailable

ADMIN

Query if the Z-Wave subsystem is available at all.

Parameters:

No parameters.

Returns:

Field Type Notes
available Bool

ZWave.RemoveFailedNode

ADMIN

Remove the given failed node from the given Z-Wave network. This will not work if node is not marked as failed.

Parameters:

Field Type Notes
networkUuid Uuid
nodeId Uint

Returns:

Field Type Notes
zwaveError ZWaveError

ZWave.RemoveNetwork

ADMIN

Remove the given Z-Wave network from the system.

Parameters:

Field Type Notes
networkUuid Uuid

Returns:

Field Type Notes
zwaveError ZWaveError

ZWave.RemoveNode

ADMIN

Start the node removal procedure for the given Z-Wave network.

Parameters:

Field Type Notes
networkUuid Uuid

Returns:

Field Type Notes
zwaveError ZWaveError

Notifications

ZWave.NetworkAdded

Emitted whenever a new Z-Wave network has been added to the system.

Parameters:

Field Type Notes
network ZWaveNetwork

ZWave.NetworkChanged

Emitted whenever a Z-Wave network changes.

Parameters:

Field Type Notes
network ZWaveNetwork

ZWave.NetworkRemoved

Emitted whenever a Z-Wave network has been removed from the system.

Parameters:

Field Type Notes
networkUuid Uuid

ZWave.NodeAdded

Emitted whenever a Z-Wave node is added.

Parameters:

Field Type Notes
networkUuid Uuid
node ZWaveNode

ZWave.NodeChanged

Emitted whenever a Z-Wave node has changed.

Parameters:

Field Type Notes
networkUuid Uuid
node ZWaveNode

ZWave.NodeRemoved

Emitted whenever a Z-Wave node is removed.

Parameters:

Field Type Notes
networkUuid Uuid
nodeId Uint