CMe3100 Stream Plugin
Inom mätning finns det många applikationer för både trådad M-Bus och trådlös M-Bus. Stream Plugin är speciellt utformad för att ge en effektiv lösning för mätning i stora trådlösa M-Bussystem där mottagningspunkten inte är intresserad av mätarens ursprung utan målet är att skapa en övergripande tillräcklig täckning av ett område.
Stream Plugin är ett av tilläggen som finns tillgänglig för CMe3100 och är förinstallerad från fabrik. Stream Plugin utökar kärntjänsterna hos CMe3100 med stöd för streaming över TCP/IP, vilket ger en kraftfull och mångsidig svit av verktyg för integration med Head-end System (HES) samt möjlighet att läsa och övervaka valfri WM-Busmätare.
I ett mätsystem som använder streamingläge placeras flera streaminglägesprodukter (mottagare) på lämpliga platser för att skapa täckning för det angivna geografiska området. Alla mottagare kan användas för att samla in valfri mätare inom räckvidden. De viktigaste fördelarna med detta tillvägagångssätt är:
-
Minskad arbetsbelastning vid projektplanering. Det behövs ingen planering vad gäller vilka mätare som ska hämtas av vilken mottagare.
-
Minskat underhållsbehov. Ingen omkonfigurering av mottagande enheter behövs för tillägg, borttagning eller utbyte av mätare.
-
Ökad robusthet. Ett system kan designas med redundans, så vilken mätare som helst tas emot av flera mottagare. Detta gör systemet robust mot varierande radioförhållanden över tid, då till exempel nya byggnader eller andra förändringar i området kan påverka radioprestandan för specifika mätare.
För att begränsa uppströmsdata från mottagna mätare som inte är av intresse (exempelvis inte en del av systemet), använder Stream Plugin filterinställningar.
För att kunna läsa det senast skickade telegrammet från en trådlös M-Busmätare CMeX50vidarebefordrar telegrammet till CMe3100 via USB-gränssnittet. CMe3100 gör all logik, filtrerar och skickar mätardata till HES, i ett schemalagt intervall. Efter varje tryckning av mätardata rensas minnet, så att CMe3100 endast skickar de senaste värdena som samlats in mellan varje push-rapportintervall. Om en mätare sänder oftare än det schemalagda push-intervallet trycker CMe3100 endast på det senast mottagna mätartelegrammet.
Stream Plugin - Lösningsöversikt
När du planerar för täckning och redundans rekommenderas det att man ser till att varje mätare har en redundansfaktor på minst 2. Detta innebär att varje mätare är inom det effektiva området för minst två mottagare. Det effektiva området ska tolkas som att det uppfyller kraven på >>X% mottagning av mätvärden för den valda upplösningen. Att designa systemet på detta sätt gör det robust för förändringar i radioförhållanden och lättar på kravet på mottagning för en enskild mätare.
Det är viktigt att förstå att mottagningsområdets effektiva räckvidd också är en funktion av upplösningen. I praktiken innebär detta att om det krävs >98 % mottagande av mätvärden var 15:e minut blir den effektiva räckvidden mindre än om kravet är >98 % mottagning av mätvärden var 24:e timme. Detta är inte en egenskap hos lösningen utan beror på hur den trådlösa M-Busradion fungerar. Det betyder att sannolikheten för ett korrekt mottagande av data från en distansmätare ökar med tiden och därmed gör den lägre erforderliga upplösningen att den effektiva räckvidden ökar.
Installationen av plugin görs genom att ladda upp en licensfil och aktivera licensen.
-
Logga in på webbgränssnittet.
-
Gå till System>Licenser.
-
Klicka på Välj fil i avsnittet Ladda upp nya licenser.
-
Leta upp den licensfil du vill ladda upp.
-
Välj Ladda upp.
-
Välj Spara.
Licensen är nu synlig i fönstret Aktuell(a) licens(er).
-
Välj System> Starta om enheten för att slutföra installationen av plugin-programmet.
Notera
Viktig! Starta om CMe3100 för att börja använda BACnet-plugin.
Tabell 116.
Parameter |
Beskrivning |
Exempel |
|
---|---|---|---|
filter.device.type |
Filtera på enhetstyp (HEX) från M-Bus standard. |
1B (rumsgivare) |
|
filter.manufacturer |
Filtrera på tillverkarens DLMS-beskrivning (tillverkarregistrerad akronym) |
ELV (Elvaco) |
|
radio.mode |
Filtrera vilka radiolägen mätaren använder. |
T1_C1A_C1B |
S1 T1 T1_C1A T1_C1B T1_C1A_C1B C1A C1B C1A_C1B C1A_WIDE C1B_WIDE C1A_C1B_WIDE |
usb.baud.rate |
Baud rate mellan trådlös mottagare och CMe3100 USB-gränssnitt |
115200 |
3600 4800 7200 9600 14400 19200 28800 38400 57600 76800 115200 |
receiving.server.url |
URI att skicka data till |
http://evo.elvaco.se |
|
receiving.server.push.cron |
Tidsintervall mellan varje push-rapport |
*/15 * * * * (Push rapport var 15:e min) |
*/15 * * * * |
service.enabled |
Aktivera eller inaktivera plugin |
true |
true/false |
sync.enabled |
Aktivera automatisk konfiguration |
true |
true/false |
show.only.filtered |
Visa endast filtrerade mätare i användargränssnittet |
true |
true/false |
configuration.server.cron |
Tidsintervall mellan varje autokonfigurationsförsök |
30 0 * * * (synkronisera varje natt 00:30) |
|
configuration.server.url |
URI att hämta konfiguration från |
http://middleware.elvaco.se |
Sync-Mode: server Sync-Id: sm_elv Sync-Config-0: receiving.server.url=http://evo.elvaco.se/sp/| /currentpluginconfig/stream.cfg Sync-Config-1: receiving.server.push.cron=*/5 * * * *| /currentpluginconfig/stream.cfg Sync-Config-2: configuration.server.cron=15 0 * * *| /currentpluginconfig/stream.cfg Sync-Config-3: filter.manufacturer=ELV,ABB|/currentpluginconfig/stream.cfg Sync-Config-4: filter.device.type=1B,02|/currentpluginconfig/stream.cfg
Standardfliken i inställningarna för Stream Plugin är Översikt som visar allmän information om Stream Plugin.
Tillgängliga sidor är:
-
Inställningar
Allmän streaming-konfiguration för plugin.
-
Mottagande serveradress
Adress till servern som tar emot push-rapporter från Stream-plugin.
-
Pushschema
Schema för push-rapporten till mottagande server.
-
Filtrera på tillverkare
Filtrera på tillverkarens DLMS kortnamn, exempelvis ELV.
-
Filtrera på enhetstyp
Filtrera på enhetstyp. Detta filter använder M-Bus standardmediumbeskrivning (13757-3 2004), där exempelvis 07 är vatten.
-
Tillåt lista
Filtrera på enhetsidentiteter, lista enhetsidentiteter som ska accepteras. Enhetsidentiteter som inte är listade kommer inte att accepteras.
-
-
Analysator
Analys av inkommande data från CMeX50 med programvaran för streaming-läge.
Analysverktyget visar vilka enheter som har tagits emot baserat på inställda filter, vilket kan förbättra analysen av var man ska placera mottagare geografiskt beroende på från vilken enhet man vill ta emot data. Mätar-ID, antal mottagna telegram, signalstyrka, tillverkare och mätartyp visas.
Det finns ett alternativ att endast visa enheter som finns i listan i analysverktyget. Om det här alternativet är valt men inga enheter är vitlistade på fliken Inställningar, tillämpas inte detta filter och alla mottagna enheter listas. Det finns också alternativ för att exportera analysatorstatistiken till CSV-format och återställa analysatorstatistiken.
Analysatorn återställs var 24:e timme eller om användaren manuellt återställer funktionen i användargränssnittet.
-
Hjälp
Beskrivningar av Stream Plugin, länkar till detta dokument.
-
Slutanvändarlicensavtal (EULA)
Produktens funktion för att hantera konfigurationer och säkerhetskopior inkluderar även inställningar för Stream Plugin (se avsnittet Hantera konfigurationer i produktens användargränssnitt).
Konfigurationen innehåller alla egenskaper som kan redigeras i produkten. Dessa kan användas för att duplicera konfigurationer till flera enheter eftersom de inte innehåller några enhetsspecifika inställningar.
Säkerhetskopieringen innehåller konfiguration samt en kopia av produktdatabaserna och inställningarna för operativsystemet.
Denna säkerhetskopia innehåller enhetsspecifika inställningar och är därför inte lämplig för att replikera konfigurationen till en annan enhet, den bör endast användas för att återställa en enhets inställningar efter en fysisk ersättning.
Det här avsnittet beskriver hur du ansluter till en produktkonfigurationsserver (http-protokoll). Synkroniseringen startar med att CMe-produkten begär en synkroniseringsfil. Synkroniseringsfilen innehåller parametrar för att synkronisera filer och konfigurationsnycklar att ställa in i produkten. När synkroniseringen av filer och konfiguration är klar (eller ofullständig) skickar produkten ett resultat till en specificerad resultatserver. Resultatservern kan anges i cad-filen.
Om du använder en webbtjänst som genererar cad-filen eller om en resultatserver används måste servern svara med HTTP Response Code = 200 ochOK i http-bodyn (bodyn får inte vara tom).
För att identifiera produkten fylls HTTP-rubriken User-Agent med följande information:
User-Agenet=TC65i/<imei> Profile/IMP-NG Configuration/CLDC-1.1 Model/<model> Hardware/<hw> Firmware/<fw> Application/<sw> Serial/<serial>
Parameter |
Beskrivning |
---|---|
<imei> |
15-siffrig produktmodul IMEI-nummer |
<model> |
Produktmodell, det vill säga CMe1000, CMe1100, CMe2000, CMe2100 |
<hw> |
Produktens hårdvaruversion, det vill säga R4A |
<fw> |
Produktmodulens mjukvaruversion, det vill säga 01.100 |
<sw> |
Produktens programvaruversion, det vill säga 1.1.0 |
<serial> |
10-siffrigt produktserienummer, det vill säga 0006000000 |
CAD-filen innehåller den faktiska informationen som ska synkroniseras. Se följande tabell för synkroniseringsparametrar. Alla cad-filer måste ha filtillägget .cad.
Parameter |
Beskrivning |
---|---|
Sync-Mode |
Synkroniseringsläge, måste ställas in på servern Syntax: Sync-Mode: server |
Sync-Notify-URL |
Resultatserverns URL. Aviseringar kommer att skickas till denna serveradress. Kan utelämnas. Syntax: Sync-Notify-URL: <notify url> |
Sync-File-[0..n]-URL |
Filer att synkronisera. Indexet måste börja på 0 och vara kontinuerligt. Kan utelämnas. Syntax: Sync-File-[0..n]-URL: <remoteur>,<local file> |
Sync-Config-[0..n] |
Konfigurationsnycklar och värden att synkronisera. Indexet måste börja på 0 och vara kontinuerligt. Kan utelämnas. Syntax: Sync- Config-[0..n]:<key>=<value> |
Sync-Id |
Identifiering som kommer att tolkas i resultataviseringen. Kan utelämnas. Syntax: Sync-Id: <id> |
<notify url> |
URL där aviseringar ska läggas upp |
<remote file> |
URL där man kan hämta fjärrfilen |
<local file> |
Lokal sökväg och filnamn där den nedladdade filen ska placeras |
<key> |
Konfigurationsnyckel att ställa in |
<value> |
Konfigurationsnyckelsvärde |
<id> |
Användarspecifik identifiering för denna synkronisering |
Om parameternSync-Notify-Url ställs in i cad-filen kommer produkten att lägga upp resultatinformation till given URL. Inlägget är ett standard HTTP-post med en body som innehåller resultatinformationen. Se möjliga resultat i följande tabell.
Resultat |
Beskrivning |
---|---|
900 |
Synkroniseringen har slutförts. |
920 |
Inkompatibelt synkroniseringsläge Synkroniseringsläget var inte inställt på servern. |
921 |
Fel vid synkronisering av filer. <error> Generiskt synkroniseringsfel. |
Strömlägesenheter tillhandahåller en effektiv insamlingstjänst och det mottagande systemet måste ta hand om följande:
-
Hantera redundans
Eftersom flera mätare kan tas emot av flera mottagare behöver HES hantera dubbletter och det faktum att mätvärden från samma mätare kan tas emot av flera mottagare.
-
Avkodning, nyckelhantering och dekryptering (om krypterade mätare används)
Mätdata från Stream-läge skickas som rå M-Bus. Detta innebär att om mätare sänder krypterad data måste den dekrypteras med tillhörande korrekt nyckelhantering innan M-Bus mätardata kan avkodas.
HTTP (Hypertext Transfer Protocol) används över hela världen. Det kan vara ett bra protokoll att använda om integrationsplattformen har en extern webbserver. Produkten använder HTTP POST för att skicka data till servern.
Produkten följer standarden för en HTTP-server. Det är viktigt att ha matchande autentiseringsinställningar i produkten och mottagningsservern.
Produkten måste konfigureras med vart HTTP-rapporterna ska skickas, vilket kan ställas in med kommandot qset http, se CMe-seriens användarmanual. Användarnamn, lösenord, port och URL kan också ställas in med kommandot qset http. HTTPS kan användas för att säkra anslutningen, vilket görs genom att ange https istället för http i webbserverns URL.
Rapporterna som skickas från produkten till webbservern skapas allteftersom, därigenom är innehållslängden på inlägget okänd när HTTP-huvudena skickas. Därför måste den mottagande webbservern hantera chunkad överföringskodning (detta är normalt inte ett problem när du använder Microsoft IIS eller Apache webbserver, där chunkad överföringskodning hanteras automatiskt).
Rapportformatet för streamingläget är hämtat från standarden M-Bus EN13757. Följande tabell beskriver rapportformatets egenskaper:
Tabell 117. Egenskaper för rapportformatet för streamingläget
Namn |
Beskrivning |
---|---|
Produktens serienummer |
Produktens serienummer som har läst och lagrat värdet på en mätare. |
Enhetsidentifiering |
Sekundär identifiering av M-Busslaven som ett värde tillhör. |
Datum |
Datum då ett värde har skapats |
Value data count (index vid multipla telegram) |
M-Bustelegrammet där ett värde hittades. |
Telegram |
Mätarvärden (M-Bus rådata) |
Tabell 118. Exempel på strömningslägesrapportformat
(produktens serienummer; enhetsidentifiering; datum; value data count; telegram) |
|||
---|---|---|---|
|
Detta avsnitt beskriver hur data mappas från det mottagna trådlösa M-Bustelegrammet till det trådbundna M-Bustelegrammet. Den trådbundna sekundäradressen tas från M-fältet och A-fältet från det trådlösa M-Bustelegrammet. Det trådbundna A-fältet tilldelas automatiskt vid installationen. Den korta huvudinformationen som tas emot i det trådlösa M-Bustelegrammet används inte på det trådbundna M-Busgränssnittet.
DIF/VIF-containerns beskrivning identifieras av följande DIF/VIF-data:
0x0D 0xFD 0x3B 0xnn |
Där 0xnn är längden på det kompletta trådlösa M-Bustelegrammet (containerns längd). |
Det trådlösa M-Bustelegrammet bör placeras i en M-Buscontainer om ett eller flera av följande kriterier är uppfyllda:
C- och CI-fält är okända för produkten
Tabell 119. Trådlöst M-Bustelegram
|
Tabell 120. Trådat M-Bustelegram
C-fält 0x08 |
A-fält 0xnn |
CI-fält 0x72 |
Long rubrik Id, Tillv, Version, Enhet 0x00000000000000000000 |
DIF/VIF RSSI 0xFD7178NN |
DIF/VIF-container 0x0DFD3BNN |
Payload trådlöst M-Bustelegram |
Exempel 1. Exempel
Filename=0016002896_valuereport_20190924185507_9102.csv Content encoding: System.Text.UTF8Encoding Content type: application/octet-stream Content length: 27741 Body: 0016002896;18400910;2019-09-24 18:52:42;00;0800721009401897A60016190000A004130E000000066D2C385278290044130E000000426C5F2C047F0700060C027F852A0E79100940180000 0016002896;61000134;2019-09-24 18:51:35;00;080072340100619615011B8B0400202F2F0265EE084265DD08820165F1082265D6081265EE086265B20852656A0902FB1AC30142FB1AC3018201FB1A8D0122FB1AC30112FB1AC30162FB1A660152FB1AC30102FD1B60430DFD0F05302E302E310F
Exempel 2. Exempel i CSV
00000161;05047168;2009-12-17 00:00:00;00; 080072640100619615011B000000000C787217006201FD711C0DFD3B61604496156401006 1011B7A970400202F2F02653607426534078201652C072265320712653607626516075265 560702FB1A0E0242FB1A0E028201FB1A0E0222FB1A0E0212FB1A0E0262FB1A090252FB1A0 F0202FD1B20C30DFD0F05322E302E310F
Kommentarer (0 kommentarer)