Vendor the sunspec plugin into this repo so the Fronius work and the upstream storage fixes can live here. Sources only: build artefacts and generated plugininfo headers are excluded. libnymea-sunspec is deliberately NOT vendored - the plugin must stay rebasable on upstream nymea, so it links against libnymea-sunspec-dev. sunspec.pri resolves it via pkg-config, with a NYMEA_SUNSPEC_PATH override for a local sysroot, mirroring modbus.pri. See sunspec/VENDORED.md.
46 lines
1.8 KiB
Markdown
46 lines
1.8 KiB
Markdown
# Vendoring — sunspec
|
|
|
|
Copié depuis : ETM/nymea-plugins-modbus (fork de nymea/nymea-plugins-modbus)
|
|
Commit source (HEAD au moment de la copie) : 2b18e84
|
|
Dernier commit touchant les sources copiées : bf53a74
|
|
("Update license text and add SPDX identifier", 2025-11-18)
|
|
Base upstream : nymea-plugins-modbus 1.15.2
|
|
Date copie : 2026-07-31
|
|
Nom paquet cible : powersync-plugin-sunspec
|
|
|
|
Raison : le chantier Fronius (voir `specs/fronius-sunspec.md`) ajoute un vendor
|
|
`fronius` et corrige des anomalies du vendor `sunspec` générique. Ces
|
|
changements vivent dans ce dépôt ETM, pas dans le mirror nymea.
|
|
|
|
## Ce qui a été copié
|
|
|
|
Sources uniquement. Exclus de la copie : `*.o`, `moc_*`, `*.so`, `Makefile`,
|
|
`plugininfo.h`, `extern-plugininfo.h`, `moc_predefs.h`, `*.qm` — tous des
|
|
artefacts de build régénérés par `qmake6` / `nymea-plugininfocompiler`.
|
|
|
|
## Dépendance de build
|
|
|
|
`libnymea-sunspec-dev` (paquet `repos.nymea.io`, 1.15.2). `sunspec.pri` le
|
|
résout par `pkg-config nymea-sunspec`.
|
|
|
|
## Règle absolue
|
|
|
|
**`libnymea-sunspec` n'est PAS vendorée et ne doit pas l'être.** Le plugin doit
|
|
rester rebasable sur l'upstream nymea : toute modification vit dans `sunspec/`.
|
|
Si un changement de la bibliothèque paraît inévitable, s'arrêter et remonter la
|
|
question plutôt que de la modifier.
|
|
|
|
## Hygiène de commits
|
|
|
|
Deux natures de changements, à ne jamais mélanger dans un même commit :
|
|
|
|
- **correctifs upstream** (bugs présents dans nymea 1.15.2 — AC-1 à AC-4 de la
|
|
spec) : message en anglais, aucune référence à ETM / Fronius / PowerSync, pour
|
|
rester proposables en amont ;
|
|
- **spécifique ETM** (vendor `fronius`, réglages produit) : commits séparés.
|
|
|
|
## SORTIE
|
|
|
|
Si nymea intègre en amont les correctifs AC-1..AC-4 et un vendor Fronius
|
|
équivalent : rebaser sur la version amont et réduire ce dossier au delta ETM.
|