wmbusmeters savienotājs

Priekšnosacījumi

Jums nepieciešama Linux/Debian ierīce ar jau strādājošu wmbusmeters un piekļuve Proforio kontam, kurā varat izveidot skaitītāju rādījumu integrāciju. Savienotājs lasa wmbusmeters pievienoto JSON arhīvu - tas nemaina jūsu esošo skaitītāju konfigurāciju.

Sagatavojiet wmbusmeters arhīvu

Saglabājiet šos iestatījumus savā wmbusmeters konfigurācijā. Katram ierakstam jābūt vienā JSON rindā; neizmantojiet pārrakstīšanas režīmu vai daudzrindu JSON.

format=json
meterfiles=/var/lib/wmbusmeters/meter_readings
meterfilesaction=append
meterfilesnaming=id
meterfilestimestamp=day

Pārliecinieties, ka arhīva direktorijs pastāv un ir rakstāms wmbusmeters servisam, pēc tam restartējiet servisu.

sudo systemctl restart wmbusmeters
sudo systemctl status wmbusmeters --no-pager
sudo ls -l /var/lib/wmbusmeters/meter_readings

Izveidojiet integrāciju Proforio

1. Atveriet Iestatījumi → Skaitītāju rādījumu integrācijas.
2. Izvēlieties Pievienot integrāciju, ievadiet nosaukumu un izvēlieties wmbusmeters.
3. Izveidojiet integrāciju un nokopējiet ģenerēto tokenu. Tas tiek parādīts tikai šajā skatā.

Izmantojiet vienu integrāciju katrai neatkarīgai ierīcei. Proforio sasaista wmbusmeters.id ar konta skaitītāja sērijas numuru, saglabājot sākuma nulles.

Instalējiet un savienojiet

Lejupielādēt proforio-wmbusmeters 1.0.0 (.deb)

curl --fail --location --remote-name https://proforio.com/downloads/wmbusmeters/1.0.0/proforio-wmbusmeters_1.0.0_all.deb
curl --fail --location --remote-name https://proforio.com/downloads/wmbusmeters/1.0.0/SHA256SUMS
sha256sum --check SHA256SUMS
sudo apt install ./proforio-wmbusmeters_1.0.0_all.deb
sudo proforio-wmbusmeters setup

Ievadiet tokenu, kad programma to pieprasa. Ievade ir paslēpta un netiek saglabāta čaulas vēsturē. Iestatīšana pārbauda API autorizāciju un arhīva piekļuvi, izveido stāvokli un sāk servisu.

Pārbaudiet savienojumu un rādījumus

sudo systemctl enable --now proforio-wmbusmeters.service
sudo systemctl status proforio-wmbusmeters.service --no-pager
sudo proforio-wmbusmeters status
sudo journalctl -u proforio-wmbusmeters.service -n 50 --no-pager

Proforio izvēlieties Atsvaidzināt statusu. Pirmais rādījums parādās pēc intervāla beigām un tā labvēlības perioda. Piemēram, 10:48 UTC ieraksts tiek izvēlēts 10:00-11:00 intervālam un kļūst pieejams 11:02 UTC.

Atlase, pārtraukumi un glabāšana

• Noklusējums ir latest_per_interval ar 3600 sekunžu UTC intervālu un 120 sekunžu labvēlības periodu. Tiek nosūtīts pēdējais derīgais JSON objekts katram skaitītājam; kumulatīvās vērtības netiek summētas.
• Rindā esošie ieraksti saglabājas pēc pārstartēšanas un pārtraukumiem. Pārejošas kļūdas tiek mēģinātas atkārtoti ar to pašu identitāti; autentifikācijas kļūda aptur sūtīšanu līdz veiksmīgai iestatīšanai.
• Vēli saņemts ieraksts neaizstāj jau noslēgtu intervālu. live_max_record_age_days pēc noklusējuma ir 90 dienas un bloķē vecus ierakstus gan atlasē, gan pirms sūtīšanas.
• SQLite ir operatīvs stāvoklis, nevis otrs vēsturiskais arhīvs. Savienotājs nekad nedzēš vai nemaina avota arhīvu. V1 nepiedāvā vēsturisku atpakaļielādi, pakešu sūtīšanu vai automātiskus atjauninājumus.

Konfigurācijas atsauce

Rediģējiet /etc/proforio-wmbusmeters.conf tikai tad, ja noklusējumi nav piemēroti, pēc tam restartējiet servisu. Pilna komentētā konfigurācija ir pieejama kopā ar lejupielādi.

API un failu ceļi

api_base_url norāda uz Proforio HTTPS galapunktu; archive_directory pēc noklusējuma ir /var/lib/wmbusmeters/meter_readings, state_db ir /var/lib/proforio-wmbusmeters/state.db un token_file ir /etc/proforio-wmbusmeters.token.

Atlase un laiki

upload_mode=latest_per_interval; upload_interval_seconds pieņem 60-86 400, interval_grace_seconds - 0-86 400, poll_interval_seconds - 0,1-3 600 sekundes.

Atkārtojumi un glabāšana

retry_initial_seconds pieņem 0,1-3 600, retry_max_seconds līdz 86 400; state_retention_days un live_max_record_age_days pieņem 1-3 650 dienas.

Lejupielādēt komentēto konfigurāciju

Problēmu novēršana

Atjauninājumi un tokenu maiņa

Lejupielādējiet jaunākās versijas pakotni un kontrolsummu, pārbaudiet to un instalējiet ar apt. Atjauninājums saglabā konfigurāciju, tokenu un SQLite stāvokli. Lai nomainītu tokenu, Proforio integrācijas pārvaldībā ģenerējiet jaunu tokenu un vēlreiz palaidiet setup.