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

8.9 KiB

Raw Permalink Blame History

Zigbee

Methods

Zigbee.AddNetwork

ADMIN

Create a new ZigBee network for the given 'serialPort', 'baudRate' and 'backend'. The serial ports can be fetched from the available adapters. See 'GetAdapters' for more information. The available backends can be fetched using the 'GetAvailableBackends' method.

Parameters:

Field	Type	Notes
`backend`	`String`
`baudRate`	`Uint`
`channelMask`	`Uint`	optional
`serialPort`	`String`

Returns:

Field	Type	Notes
`networkUuid`	`Uuid`	optional
`zigbeeError`	ZigbeeError

Zigbee.CreateBinding

ADMIN

Create a binding. Use destinationAddress and destinationEndpointId to create a node to node binding, or use destinationGroupAddress to create a group binding.

Parameters:

Field	Type	Notes
`clusterId`	`Uint`
`networkUuid`	`Uuid`
`destinationAddress`	`String`	optional
`destinationEndpointId`	`Uint`	optional
`destinationGroupAddress`	`Uint`	optional
`sourceAddress`	`String`
`sourceEndpointId`	`Uint`

Returns:

Field	Type	Notes
`zigbeeError`	ZigbeeError

Zigbee.FactoryResetNetwork

ADMIN

Factory reset the network with the given 'networkUuid'. The network does not have to be online for this procedure, and all associated nodes and things will be removed permanently.

Parameters:

Field	Type	Notes
`networkUuid`	`Uuid`

Returns:

Field	Type	Notes
`zigbeeError`	ZigbeeError

Zigbee.GetAdapters

ADMIN

Get the list of available ZigBee adapters and serial ports in order to set up the ZigBee network on the desired interface. The 'serialPort' property can be used as unique identifier for an adapter. If an adapter hardware has been recognized as a well known ZigBee adapter, the 'hardwareRecognized' property will be true and the 'baudRate' and 'backend' configurations can be used as they where given, otherwise the user might set the backend and baud rate manually. The available backends can be fetched using the GetAvailableBackends method.

Parameters:

No parameters.

Returns:

Field	Type	Notes
`adapters`	ZigbeeAdapters

Zigbee.GetAvailableBackends

ADMIN

Get the list of available ZigBee backends.

Parameters:

No parameters.

Returns:

Field	Type	Notes
`backends`	`String`[]

Zigbee.GetNetworks

ADMIN

Returns the list of configured ZigBee networks in the system.

Parameters:

No parameters.

Returns:

Field	Type	Notes
`zigbeeNetworks`	ZigbeeNetwork[]

Zigbee.GetNodes

ADMIN

Returns the list of ZigBee nodes from the network the given 'networkUuid' in the system.

Parameters:

Field	Type	Notes
`networkUuid`	`Uuid`

Returns:

Field	Type	Notes
`zigbeeNodes`	ZigbeeNode[]	optional
`zigbeeError`	ZigbeeError

Zigbee.RefreshBindings

ADMIN

Refresh the binding table for the given node.

Parameters:

Field	Type	Notes
`ieeeAddress`	`String`
`networkUuid`	`Uuid`

Returns:

Field	Type	Notes
`zigbeeError`	ZigbeeError

Zigbee.RefreshNeighborTables

ADMIN

Refresh the neighbor table for all nodes. Note that calling this may cause a lot of traffic in the ZigBee network.

Parameters:

Field	Type	Notes
`networkUuid`	`Uuid`

Returns:

Field	Type	Notes
`zigbeeError`	ZigbeeError

Zigbee.RemoveBinding

ADMIN

Remove a binding.

Parameters:

Field	Type	Notes
`clusterId`	`Uint`
`networkUuid`	`Uuid`
`destinationAddress`	`String`	optional
`destinationEndpointId`	`Uint`	optional
`destinationGroupAddress`	`Uint`	optional
`sourceAddress`	`String`
`sourceEndpointId`	`Uint`

Returns:

Field	Type	Notes
`zigbeeError`	ZigbeeError

Zigbee.RemoveNetwork

ADMIN

Remove the ZigBee network with the given network uuid.

Parameters:

Field	Type	Notes
`networkUuid`	`Uuid`

Returns:

Field	Type	Notes
`zigbeeError`	ZigbeeError

Zigbee.RemoveNode

ADMIN

Remove a ZigBee node with the given 'ieeeAddress' from the network with the given 'networkUuid'. If there is a thing configured for this node, also the thing will be removed from the system. The coordinator node cannot be removed.

Parameters:

Field	Type	Notes
`ieeeAddress`	`String`
`networkUuid`	`Uuid`

Returns:

Field	Type	Notes
`zigbeeError`	ZigbeeError

Zigbee.SetPermitJoin

ADMIN

Allow or deny nodes to join the network with the given 'networkUuid' for a specific 'duration' in seconds. The duration value has to be between 0 and 255 seconds. The 'permitJoinDuration' property of ZigBee network object indicates how long permit has been enabled and the 'permitJoiningRemaining' indicates the rest of the time. Those values can be used to show a countdown or progressbar. This method can be recalled for resetting the timeout. If the duration is set to 0 seconds, joining will be disabled immediatly for the entire network. The 'shortAddress' is optional and defaults to the broadcast address 0xfffc for all routers in the network. If the short address matches the address of a router node in the network, only that specific router will be able to allow new nodes to join the network. A new node will join to the router with the best link quality index (LQI).

Parameters:

Field	Type	Notes
`duration`	`Uint`
`networkUuid`	`Uuid`
`shortAddress`	`Uint`	optional

Returns:

Field	Type	Notes
`zigbeeError`	ZigbeeError

Notifications

Zigbee.AdapterAdded

Emitted whenever a new ZigBee adapter or serial port has been detected in the system.

Parameters:

Field	Type	Notes
`adapter`	ZigbeeAdapter

Zigbee.AdapterRemoved

Emitted whenever a ZigBee adapter or serial port has been removed from the system (i.e. unplugged).

Parameters:

Field	Type	Notes
`adapter`	ZigbeeAdapter

Zigbee.NetworkAdded

Emitted whenever a new ZigBee network has been added.

Parameters:

Field	Type	Notes
`zigbeeNetwork`	ZigbeeNetwork

Zigbee.NetworkChanged

Emitted whenever a new ZigBee network has changed.

Parameters:

Field	Type	Notes
`zigbeeNetwork`	ZigbeeNetwork

Zigbee.NetworkRemoved

Emitted whenever a new ZigBee network has been removed.

Parameters:

Field	Type	Notes
`networkUuid`	`Uuid`

Zigbee.NodeAdded

Emitted whenever a new ZigBee node has joined the network with the given 'networkUuid'.

Parameters:

Field	Type	Notes
`networkUuid`	`Uuid`
`zigbeeNode`	ZigbeeNode

Zigbee.NodeChanged

Emitted whenever a ZigBee node has changed.

Parameters:

Field	Type	Notes
`networkUuid`	`Uuid`
`zigbeeNode`	ZigbeeNode

Zigbee.NodeRemoved

Emitted whenever a ZigBee node has removed from the network with the given 'networkUuid'.

Parameters:

Field	Type	Notes
`networkUuid`	`Uuid`
`zigbeeNode`	ZigbeeNode

8.9 KiB Raw Permalink Blame History

Zigbee

Methods

Zigbee.AddNetwork

Zigbee.CreateBinding

Zigbee.FactoryResetNetwork

Zigbee.GetAdapters

Zigbee.GetAvailableBackends

Zigbee.GetNetworks

Zigbee.GetNodes

Zigbee.RefreshBindings

Zigbee.RefreshNeighborTables

Zigbee.RemoveBinding

Zigbee.RemoveNetwork

Zigbee.RemoveNode

Zigbee.SetPermitJoin

Notifications

Zigbee.AdapterAdded

Zigbee.AdapterRemoved

Zigbee.NetworkAdded

Zigbee.NetworkChanged

Zigbee.NetworkRemoved

Zigbee.NodeAdded

Zigbee.NodeChanged

Zigbee.NodeRemoved

8.9 KiB

Raw Permalink Blame History