Proforio Palīdzības centrs

wmbusmeters savienotājs

Pievienojiet wmbusmeters vārteju, lai nosūtītu skaitītāju rādījumus uz Proforio.

Jūsu esošā wmbusmeters instalācija jau veic sarežģītāko darbu. Proforio savienotājs tikai jāinstalē un jāsasaista ar integrācijas tokenu.

Pēc tam Proforio saņem jaunus rādījumus, atrod skaitītājus pēc sērijas numura un saglabā to sākotnējos wmbusmeters datus.

Pirms sākat

  • wmbusmeters jau darbojas un nolasa jūsu skaitītājus.
  • wmbusmeters raksta vienas rindas JSON ierakstus meterfiles arhīvā pievienošanas režīmā.
  • Ierīce izmanto Debian 13 vai saderīgu Raspberry Pi OS vidi un var sasniegt Proforio internetā.

Reālā instalācija ir pārbaudīta ar Debian 13 (trixie), aarch64 Raspberry Pi un wmbusmeters 3.0.0.

1. solis

Izveidojiet integrāciju Proforio

  1. Atveriet Iestatījumi → Skaitītāju rādījumu iestatījumi → Ienākošie rādījumi.
  2. Sadaļā Rādījumi tiek iesūtīti Proforio izvēlieties Pievienot ienākošo integrāciju, ievadiet nosaukumu un izvēlieties wmbusmeters.
  3. Izveidojiet integrāciju un nokopējiet ģenerēto tokenu.

Tokens tiek parādīts tikai vienu reizi. Saglabājiet to droši līdz ierīces iestatīšanai.

Atvērt integrācijas

2. solis

Instalējiet savienotāju

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

3. solis

Savienojiet ierīci ar Proforio

sudo proforio-wmbusmeters setup

Ielīmējiet integrācijas tokenu, kad programma to pieprasa. Ievade ir paslēpta un nenonāk čaulas vēsturē.

Iestatīšana pārbauda savienojumu un arhīva piekļuvi, droši saglabā tokenu, sāk darbu no esošo failu beigām un automātiski iespējo un palaiž servisu.

Pirms instalēšanas saglabātie vēsturiskie ieraksti netiek augšupielādēti.

Kad iestatīšana ir pabeigta, komanda apstiprina, ka serviss jau darbojas, un parāda statusa pārbaudes komandu:

Setup complete. Connector is running.
Readings are sent hourly by default, so the first reading may take up to about one hour to appear in Proforio.

Check status with:
  sudo proforio-wmbusmeters status

4. solis

Pārbaudiet savienojumu

sudo proforio-wmbusmeters status
Proforio wmbusmeters connector

Service:        active
Connection:     OK
Last upload:    2026-09-19 16:02:05 UTC
Pending:        0
Meters tracked: 3
Version:        1.0.0

Ja vēl nav nosūtīts neviens rādījums, Connection laukā redzēsiet “Waiting for first reading”. Autentifikācijas, konfigurācijas vai servisa problēma tiek parādīta turpat saprotamā tekstā.

Rādījumi pēc noklusējuma tiek nosūtīti reizi stundā, tādēļ pirmais rādījums Proforio var parādīties aptuveni stundas laikā.

Gatavs

Integrācijas skatā Proforio redzēsiet pēdējo savienojumu, pēdējo saņemto rādījumu un savienotāja versiju. Jauni skaitītāju ID un to rādījumu notikumi parādās automātiski.

Problēmu novēršana

Savienojums darbojas, bet rādījumu vēl nav

Tas var būt normāli: noklusējuma piegāde ir reizi stundā, tādēļ iestatīšana var būt veiksmīga pirms pirmā rādījuma saņemšanas.

sudo proforio-wmbusmeters status

Ja pēc pilna intervāla rādījumu nav, pārbaudiet, vai wmbusmeters turpina pievienot jaunus JSON ierakstus arhīva failiem.

Autentifikācijas vai autorizācijas kļūda

Vēlreiz palaidiet setup un izlasiet Proforio atgriezto īso kļūdas ziņojumu. 401 parasti nozīmē nederīgu, nomainītu vai atsauktu tokenu. 403 var nozīmēt atspējotu vai nepieejamu integrāciju vai īslaicīgi nepieejamu datu saņemšanu.

sudo proforio-wmbusmeters setup

Nemainiet tokenu automātiski katras 403 kļūdas gadījumā; vispirms pārbaudiet kļūdas tekstu un integrācijas statusu Proforio.

Arhīva faili netiek atrasti

Pārbaudiet, vai konfigurētajā direktorijā tiešām rodas JSON faili:

ls -lah /var/lib/wmbusmeters/meter_readings/

Nepieciešams JSON formāts, iespējoti meterfiles un pievienošanas režīms. Failu nosaukumu shēma nav noteikta: gan name-id, gan id un citas parastās wmbusmeters shēmas darbojas.

Servisa diagnostika

Šīs komandas parasti nepieciešamas tikai problēmu novēršanai:

sudo systemctl status proforio-wmbusmeters.service --no-pager
sudo journalctl -u proforio-wmbusmeters.service -n 50 --no-pager
Papildu konfigurācija

Vairumam instalāciju noklusējumi nav jāmaina. Pilnais skaidrojums, noklusējuma vērtības, mērvienības un diapazoni ir komentēti instalētajā failā /etc/proforio-wmbusmeters.conf.

Detalizētai diagnostikai un automatizācijai strukturēto statusu var iegūt ar šo komandu:

sudo proforio-wmbusmeters status --json
  • archive_directory - wmbusmeters meterfiles direktorijs.
  • upload_interval_seconds / interval_grace_seconds - rādījumu atlases intervāls un īsais noslēgšanas gaidīšanas laiks.
  • poll_interval_seconds, connect_timeout_seconds, read_timeout_seconds - failu pārbaudes un tīkla gaidīšanas laiki.
  • retry_initial_seconds, retry_max_seconds, max_requests_per_minute - atkārtotu mēģinājumu un pieprasījumu ātruma robežas.
  • state_retention_days, live_max_record_age_days - operatīvā stāvokļa tīrīšana un vecu datu aizsardzības robeža.

Atvērt pilno komentēto konfigurāciju

wmbusmeters arhīva iestatījumi

Nepieciešamās īpašības ir JSON, meterfiles direktorijs un pievienošanas režīms. Šis ir piemērs, nevis obligāta failu nosaukumu shēma:

format=json
meterfiles=/var/lib/wmbusmeters/meter_readings
meterfilesaction=append

# Optional examples; existing working naming schemes can remain unchanged.
meterfilesnaming=name-id
meterfilestimestamp=day

Ikdienas failu rotācija ir ieteicama pārskatāmākam arhīvam, bet savienotājs no tās nav atkarīgs.

Kā savienotājs darbojas

Pēc noklusējuma Proforio saņem pēdējo rādījumu no katra skaitītāja reizi stundā. Savienotājs nepārtraukti lasa jaunās lokālās telegrammas un pēc stundas intervāla beigām nosūta katra skaitītāja jaunāko paraugu.

Kumulatīvie skaitītāja lauki netiek summēti. Pilnais sākotnējais wmbusmeters JSON tiek nosūtīts Proforio, kur notiek skaitītāja atrašana, normalizācija un norēķinu atbilstības noteikšana.

Savienotājs glabā nelielu lokālu operatīvo stāvokli, lai droši atsāktu darbu pēc pārstartēšanas vai tīkla pārtraukuma. wmbusmeters arhīva faili paliek neskarti, vecā pirms instalēšanas esošā vēsture netiek nosūtīta, un pārāk veci dzīvie ieraksti netiek augšupielādēti automātiski.

Pieņemšanas tests apstiprināja darbu ar vairākiem esošiem name-id arhīva failiem: tie tika inicializēti failu beigās, jaunie ieraksti tika atrasti, un visi noslēgtā intervāla rādījumi tika apstiprināti Proforio.

Atjaunināšana un tokena nomaiņa

Lejupielādējiet jaunās versijas .deb un kontrolsummu, pārbaudiet to un instalējiet ar apt. Atjauninājums saglabā lietotāja konfigurāciju, tokenu un savienotāja stāvokli.

Lai nomainītu tokenu, Proforio integrācijas skatā izveidojiet jaunu tokenu un vēlreiz palaidiet sudo proforio-wmbusmeters setup. Atkārtota iestatīšana saglabā failu pozīcijas un gaidošās piegādes.