[en] Reference information
[en] The CMe/CMi Series gives a wide range of implementation possibilities. This chapter covers good implementation practice and method selection depending on customer needs.
[en] Without any development needed, the product may be configured using SMS and Telnet. This may not be the most effective way when handling a high volume of products. Using Elvaco hosted configuration profiles or implementing a product configuration server, the product can be configured using HTTP web server requests.
[en] Please see the user manuals of the CMe/CMi Series, for all the commands, configuration keys, syntax and reference information.
[en] Elvaco has divided product implementation into four levels. These levels are defined to illustrate the time for implementation and give the developer a good understanding where to start the implementation process and select the correct level of functionality.
Tabell 188. [en] Implementation levels
|
[en] Implementation level |
[en] Level of functionality |
[en] Typical time for implementation |
|---|---|---|
|
[en] Level 1 |
[en] Transparent M-Bus communication using GSM CSD or TCP/IP on GPRS network. [en] Configuration of the product is done by predefined configuration profile from Elvaco web server or by using SMS or Telnet. |
[en] 0 hours [en] Using standard M-Bus master software |
|
[en] Level 2 |
[en] Handle automatic scheduled pushed (E-Mail, FTP, HTTP) reports to retrieve meter values. [en] Configuration of the product is done by predefined configuration profile from Elvaco web server or by using SMS or Telnet. |
[en] 8-16 hours |
|
[en] Level 3 |
[en] Two way communication for configuration and starting commands using SMS. [en] Configuration can also be done by predefined configuration profile from Elvaco web server. |
[en] 8-16 hours |
|
[en] Level 4 |
[en] Configuration of the product using HTTP web server from customer implemented configuration server. |
[en] 8-16 hours |
[en] When using transparent M-Bus communication, there are numerous software applications available on the market. The product handles transparent M-Bus communication according to the M-Bus standard, but the request/response time delays must be adjusted to handle GSM/GPRS network response times. Depending on network provider, the response time can differ. A good recommendation for a maximum response time between request/response is approximately 4 seconds.
[en] From factory the product is listening and will answer all incoming GSM CSD calls and open for transparent M-Bus communication. The TCP/IP transparent M-Bus communication must be manually started using command qset tmbus1/tmbus2 on.
[en] Depending on IT structure of implementation platform, reports can be received from the product using Email, FTP and HTTP. In some cases, implementation using E-Mail and FTP may be the preferable. If the goal is to reach implementation level 4, HTTP should be used as the transfer protocol from start.
[en] When installing the product, the default setting is to send hourly value reports. The report format can be configured using command cfg, see CMe/CMi Series user manuals. When receiving E-mail reports with meter data, rules can be set up, e.g. in MS Outlook to organize E-mails as needed. There are also software applications available on the market, which takes attached files and stores these files in a folder on a disk. WatchDirectory, https://www.watchdirectory.net, is one of the applications, which can handle these kinds of operations.
[en] For the product to be able to send E-mail reports, a SIM card with GPRS or LTE, depending on the product, must be used. The product also needs an SMTP server to send the reports. The SMTP server is normally automatically detected, but in some rare cases the server must be set manually using command qset email, see the user manuals of the CMe Series.. The command is also used to set E-mail recipients.
[en] There is a wide range of E-mail reports available. The major difference between different E-mail reports are:
-
[en] if the meter data should be attached as a file instead of printed in the body
-
[en] if the meter data should be sent in one file or separated in one file per device (meter)
-
[en] if the meter data should be decoded and readable or in raw M-Bus data format
[en] Report template 1104 is a recommended choice if the report should be in machine friendly decoded format.
[en] Report template 1103 can be used if the receiving system handles raw M-Bus data format.
[en] FTP (File Transfer Protocol) is widely used all over the world. This may be the choice when the integration platform has an external FTP server available. The product is using passive mode FTP, which resolves the problem of NATed TCP/IP traffic from a GPRS network to the internet.
[en] For the product to be able to send FTP reports, a SIM card with GPRS enabled must be used. The product must be configured where to send FTP reports, which can be set using command qset ftp, see the user manuals of the CMe Series. Username, password, port and default upload directory can also be set using the command qset ftp. The receiving FTP server must handle passive FTP. This may be disabled by firewall options. Verify firewall settings for passive FTP and FTP server application for a proper configuration.
[en] There is a wide range of FTP reports available. The major difference between FTP reports are:
-
[en] if the meter data should be sent in one file or separated in one file per device (meter)
-
[en] if the meter data should be decoded and readable or in raw M-Bus data format
[en] Report template 2104 is a recommended choice if the report should be in machine friendly decoded format.
[en] Report template 2103 can be used if the receiving system handles raw M-Bus data format.
[en] HTTP (Hypertext Transfer Protocol) is widely used all over the world. This may be the choice when the integration platform has an external web server available. The product is using HTTP POST to send data to the server.
[en] For the product to be able to send HTTP reports, a SIM card with GPRS enabled must be used. The product must be configured where to send the HTTP reports. This can be set using command qset http, see the user manuals of the CMe series. Username, password, port and URL can also be set using the command qset http. HTTPS can be used for securing the connection, which is accomplished by entering the https instead of http in the URL on the web server.
[en] The reports sent from the product to the web server are generated on runtime, which implies that the content length of the post is unknown when the HTTP headers are sent. Therefore the receiving web server must be able to handle chunked transfer encoding. This is usually not an issue when using Microsoft IIS or Apache web server, where chunked transfer encoding i handled automatically.
[en] There is a wide range of HTTP reports available. The major difference between HTTP reports are:
-
[en] if the meter data should be sent in one post or separated in one post per device (meter)
-
[en] if the meter data should be decoded and readable or in raw M-Bus data format
[en] Report template 3104 is a good choice if the report should be in machine friendly decoded format.
[en] Report template 3103 can be used if the receiving system handles raw M-Bus data format.
[en] When the product is operational and sends reports automatically, there may still be situations when the server application needs to request or send data to the product. This can be accomplished by sending SMS to the product. The SMS can be a command to start a report manually, to start a configuration process with a web server or to change configuration.
[en] SMS may not be the most reliable communication protocol, but to use SMS as a source to add extra information can be an efficient method for integration.
[en] In the CMe/CMi Series User's Manual, all commands which can be sent using SMS is tagged with access “SMS”. When the product receives an SMS, following process is started:
-
[en] If phone number security is enabled, is the sending phone number accepted?
-
[en] Is the first line of the SMS a password for security level 1,2 or 3? If true, set proper security level.
-
[en] If 1) and 2) is parsed successfully, start parsing SMS command lines which can divided with CRLF or semi-colon “;”
-
[en] If the configuration key common.sms.response.mode is not set to disable responses, respond with the executed command response information. The default value for common.sms.response.mode is “all”.
[en] In some cases, the SMS response from the product may not be of interest for the sending part. An example would be if the command is to start sending an HTTP POST report to a web server. This is automatically acknowledged when the report is received by the web server, therefore the SMS response will not contribute with any extra information. Override the sms.response.mode configuration by setting the value to none.
[en] An example for starting command report1 and disable SMS responses would look like:
[en] report1 sms.response.mode=none
[en] This example describes how to start a report and send meter data within two dates.
[en] To resend meter data between 2010-09-01 and 2010-09-03 with report template 1104, send the following SMS command:
[en] Report 1104 filter.mode=interval filter.param=20100901,20100903
[en] This example describes how to change the report retries and the time between the retries.
[en] To set number of retries to ten (9) and time between retries to five (5) minutes, send the following SMS command:
[en] set report1.schedule.retrymax=9 report1.schedule.retryoffset=300
[en] The CMe/CMi Series User’s Manuals covers all this information in more detail. There is also numerous examples for every command which can be sent to the product.
[en] Implementation level 4 is a combination of implementation level 3 and adding a product configuration server, which handles the distribution/product requests for a new or updated configuration. The product connects to the products configuration server when using command sync and using command install with suffix.
[en] Following SMS command will force the product to execute command install and connect to Elvaco distribution server, by default, and download configuratin elvaco.
[en] Install 1 elvaco
[en] Following SMS command will force the product to execute sync and connect to Elvaco configuration server (by default), and download configuration “elvaco”.
[en] Sync elvaco
[en] Command install is used when installing the product for the first time or when meter configuration has changed. Command sync is used only when new configuration should be downloaded to the product.
[en] The configuration “elvaco” is concatenated with the common.system.cota.urlbase to download the actual file from the configuration server. The actual url for configuration “elvaco” would be:
[en] http://dist.elvaco.se/sync/cota/elvaco.cad.
[en] From factory default, the product will connect to http://dist.elvaco.se/ for synchronizing configuration. This server setting can be changed using one of following configuration keys; common.system.cota.urlbase, common.system.cota.url, common.system.cota.user, common.system.cota.password, common.system.cota.authmode. The configuration key, urlbase, is used to set the base url when using short names in command install and sync. The configuration key, url, can be used to point out a specific location of a configuration file.
[en] Example of executing sync and download a configuration file called myconfig.cad at http://myserver.com:
[en] Sync system.cota.url=http://myserver.com/myconfig.cad.
[en] The CMe/CMi Series starts with requesting a synchronization file. The synchronization file contains parameters to synchronize files and configuration keys to set in the product. When the synchronization of files and configuration are complete (or incomplete), the product will send a result to a specified result server. The result server can be specified in the cad file.
[en] To identify the product, the HTTP header User-Agent is filled with the following information:
[en] User-Agent= TC65i/<imei> Profile/IMP-NG Configuration/CLDC-1.1 Model/<model> Hardware/<hw> Firmware/<fw> Application/<sw> Serial/<serial>
Tabell 189. [en] Parameter description
|
[en] Parameter |
[en] Description |
|---|---|
|
[en] |
[en] 15 digit product module IMEI number |
|
[en] |
[en] Product model, i.e. CMe1000, CMe1100, CMe2000, CMe2100 |
|
[en] |
[en] Product hardware version, i.e R4A |
|
[en] |
[en] Product module firmware version, i.e. 01.100 |
|
[en] |
[en] Product software version, i.e. 1.1.0 |
|
[en] |
[en] 10 digit product serial number, i.e. 0006000000 |
[en] Cad file
[en] The cad file contains the actual information to synchronize. All cad files must have the extension .cad.
[en] See the following tables for synchronization parameters.
Tabell 190. [en] Synchronization file (cad file)
|
[en] Parameter |
[en] Description |
|---|---|
|
[en] Sync-Mode |
[en] Synchronization mode, must be set to “server” [en] Syntax: [en] Sync-Mode: server |
|
[en] Sync-Notify-URL |
[en] Result server URL. Notifications will be sent to this server address. Can be left out. [en] Syntax: [en] Sync-Notify-URL: |
|
[en] Sync-File-[0..n]-URL |
[en] Files to synchronize. The index must start at 0 and be continuous. Can be left out. [en] Syntax: [en] Sync-File-[0..n]-URL: |
|
[en] Sync-Config-[0..n] |
[en] Configuration keys and values to synchronize. The index must start at 0 and be continuous. Can be left out. [en] Syntax: [en] Sync- Config-[0..n]: |
|
[en] Sync-Id |
[en] Identification which will be parsed into the result notification. Can be left out. [en] Syntax: [en] Sync-Id: |
Tabell 191. [en] Parameter descriptions for cad-files
|
[en] |
[en] URL where to post notifications |
|
[en] |
[en] URL where to get remote file |
|
[en] |
[en] Local path and filename where to put downloaded file |
|
[en] |
[en] Configuration key to set |
|
[en] |
[en] Configuration key value |
|
[en] |
[en] User specific identification for this synchronization |
[en] If the parameter Sync-Notify-Url is set in the cad file, the product will post result information to given URL. The post is a standard HTTP post with a body containing the result information.
[en] See the following table for possible results.
Tabell 192. [en] Result notification post
|
[en] Result |
[en] Description |
|---|---|
|
[en] 900 Success |
[en] Synchronization completed successfully |
|
[en] 920 Incompatible synchronizing mode |
[en] The Sync-Mode was not set to “server” |
|
[en] 921 Error synchronizing files. |
[en] Generic synchronization error. |
[en] The configuration keys and values set in the configuration file must be valid. If any key or value is invalid, the configuration process will quit and an error message will be sent to initiator and to the result server.
Exempel 3. [en] Example of starting synchronization using SMS with customer specified configuration server
[en] Following configuration keys will be set:
-
[en] report1.schedule.retrymax
-
[en] report1.schedule.retryoffset
[en] The Sync-Id is set to 1234 and will be posted back to the result server for identifying the configuration.
[en] The configuration file url is set to http://myserver.com/config/myconfig.cad.
[en] The result server url is set to http://myserver.com/result/result.html
[en] SMS to the product to start synchronization:
[en] Sync system.cota.url=http://myserver.com/config/myconfig.cad
[en] SMS from the product indicating synchronization started
[en] Sync started. OK
[en] The product will download the configuration file using HTTP GET and set the configuration keys as specified.
[en] The file myconfig.cad contents which will be downloaded to the product :
[en] Sync-Mode: server
[en] Sync-Id: 1234
[en] Sync-Notify-URL: http://myserver.com/result/result.html
[en] Sync-Config-0: report1.schedule.retrymax=10
[en] Sync-Config-1: report1.schedule.retryoffset=600
[en] After the configuration file is processed, the product will send a HTTP POST with the result information.
[en] The HTTP POST body contents sent to the result server:
[en] 900 Success
[en] Sync-Id: 1234
[en] Report templates are description files on how to format and send data from CMe/CMi Series products to an external source. Templates are available for SMS, FTP, HTTP and E-mail.
[en] The report engine in CMe/CMi Series is powerful and can format almost any output data. Example of data format is csv formatted files, xml based data and human readable html reports. The report data can be events, meter data, system log reports etc.
[en] CMe/CMi Series products are released with a standard set of reports, but can be enhanced by Elvaco provided add-ons and customer specific add-ons. Customer specific add-ons are not listed in this document.
|
[en] Range |
[en] Name |
|---|---|
|
0001-0999 |
[en] Standard SMS reports |
|
1000-1099 |
[en] Standard E-Mail system reports |
|
1100-1199 |
[en] Standard E-Mail value reports |
|
1500-1599 |
[en] Add-on E-Mail reports |
|
2000-2099 |
[en] Standard FTP system reports |
|
2100-2199 |
[en] Standard FTP value reports |
|
2500-2599 |
[en] Add-on FTP reports |
|
3000-3099 |
[en] Standard HTTP system reports |
|
3100-3199 |
[en] Standard HTTP value reports |
|
3500-3599 |
[en] Add-on HTTP reports |
|
4000-4099 |
[en] Standard MQTT system reports |
|
4100-4199 |
[en] Standard MQTT value reports CSV format |
|
4200-4299 |
[en] Standard MQTT value reports in JSON format |
|
9000-9999 |
[en] Plugin reports |
|
[en] xx0001-xx0999 |
[en] Customer specific SMS reports |
|
[en] xx1000-xx1099 |
[en] Customer specific E-Mail system reports |
|
[en] xx1100-xx1199 |
[en] Customer specific E-Mail value reports |
|
[en] xx2000-xx2099 |
[en] Customer specific FTP system reports |
|
[en] xx2100-xx2199 |
[en] Customer specific FTP value reports |
|
[en] xx3000-xx3099 |
[en] Customer specific HTTP system reports |
|
[en] xx3100-xx3199 |
[en] Customer specific HTTP value reports |
[en] Where xx is an Elvaco assigned customer number, two digits 00-99.
Följande tabell innehåller alla tillgängliga rapportmallar för varje protokoll. För mer information, se specifikationen för varje rapportmall.
Tabell 193. Rapporter via SMS
|
Mallnummer |
Förklaring |
Produkt(er) |
|---|---|---|
|
1 |
SMS-installationsrapport |
CMe2100, CMe2100 LTE |
|
2 |
Händelserapport via SMS |
CMe2100, CMe2100 LTE |
|
101 |
Värderapport via SMS |
CMe2100, CMe2100 LTE |
Tabell 194. Rapporter via e-post
|
Mallnummer |
Förklaring |
Produkt(er) |
|---|---|---|
|
1001 |
Installationsrapport via e-post, HTML-format |
CMe2100, CMe2100 LTE, CMe3100 |
|
1002 |
Installationsrapport via e-post, oformaterad text |
CMe2100, CMe2100 LTE, CMe3100 |
|
1003 |
Systemrapport via e-post, HTML-format |
CMe2100, CMe2100 LTE, CMe3100 |
|
1004 |
Systemloggrapport via e-post, HTML-format |
CMe2100, CMe2100 LTE, CMe3100 |
|
1005 |
Händelserapport via e-post, HTML-format |
CMe2100, CMe2100 LTE, CMe3100 |
|
1006 |
Loggrapport via e-post, HTML-format |
CMe2100, CMe2100 LTE, CMe3100 |
|
1007 |
Övervakning av händelserapporten via e-post, HTML-format |
CMe2100, CMe2100 LTE, CMe3100 |
|
1101 |
Värderapport via e-post, HTML-format (läsbart dataformat) |
CMe2100, CMe2100 LTE, CMe3100 |
|
1102 |
Värderapport via e-post, HTML-format (rådataformat) |
CMe2100, CMe2100 LTE, CMe3100 |
|
1103 |
Värderapport via e-post, HTML-format (bifogad CSV-fil per mätare i rådataformat) |
CMe2100, CMe2100 LTE, CMe3100 |
|
1104 |
Värderapport via e-post, HTML-format (bifogad CSV-fil per mätare i läsbart dataformat) |
CMe2100, CMe2100 LTE, CMe3100 |
|
1105 |
Värderapport via e-post, HTML-format (bifogad CSV-fil per mätare i läsbart dataformat med extra rubrikinformation) |
CMe2100, CMe2100 LTE, CMe3100 |
|
1106 |
Värderapport via e-post, HTML-format (bifogad zip-fil per mätare i läsbart dataformat med extra rubrikinformation) |
CMe2100, CMe2100 LTE, CMe3100 |
|
1107 |
Värderapport om energiförbrukning via e-post, HTML-format (bifogad CSV-fil per mätare i läsbart dataformat med extra rubrikinformation) |
CMe2100, CMe2100 LTE, CMe3100 |
|
1108 |
Utökad värderapport via e-post, HTML-format (bifogad enstaka CSV-fil i läsbart dataformat med extra rubrikinformation) |
CMe2100, CMe2100 LTE, CMe3100 |
|
1109 |
Utökad+ värderapport via e-post, HTML-format (bifogad CSV-fil per mätare i läsbart dataformat med extra rubrikinformation och M-Bushuvudinformation) |
CMe2100, CMe2100 LTE, CMe3100 |
|
1110 |
Utökad+ värderapport via e-post, HTML-format (bifogad enstaka CSV-fil i läsbart dataformat med extra rubrikinformation och M-Bus huvudinformation) |
CMe2100, CMe2100 LTE, CMe3100 |
|
1111 |
Värderapport via e-post i läsbart format i en bifogad fil. Denna rapport innehåller även information från M-Busheadern. Till exempel status, tillverkare etc. Rapportkolumnrubriken har ett prefix # och även utskriven DIF/VIF-information. Brödtext i html-format. |
CMe2100, CMe2100 LTE, CMe3100 |
|
1112 |
Värderapport via e-post utökad plus med position (bifogad enstaka CSV-fil i läsbart format med extra rubrikinformation och M-Bus rubrik-information) |
CMe2100, CMe2100 LTE, CMe3100 |
|
1113 |
Värderapport via e-post i läsbart format i en bifogad fil. Denna rapport innehåller även information från M-Busheadern. Till exempel status, tillverkare etc. Rapportkolumnrubriken har ett prefix # och DIF/VIF-information tryckt med DLMS-namn. |
CMe2100 G3, CMe2100 LTE, CMe3100 |
|
1114 |
Värderapport via e-post utökad plus med position och DLMS-namngivning (bifogad enstaka CSV-fil i läsbart dataformat). |
CMe2100 G3, CMe2100 LTE, CMe3100 |
|
1115 |
Värderapport via e-post utökad plus med position och primäradress (bifogad enskild CSV-fil i läsbart dataformat). |
CMe2100 G3, CMe2100 LTE, CMe3100 |
|
1116 |
Värderapport via e-post utökad plus med position och primäradress (bifogad CSV-fil per mätare i läsbart dataformat). |
CMe2100 G3, CMe2100 LTE, CMe3100 |
Tabell 195. FTP-rapporter
|
Mallnummer |
Förklaring |
Produkt(er) |
|---|---|---|
|
2001 |
FTP-installationsrapport, rå M-Busformat |
CMe2100, CMe2100 LTE, CMe3100 |
|
2002 |
FTP-installationsrapport, oformaterad text |
CMe2100, CMe2100 LTE, CMe3100 |
|
2005 |
FTP-händelserapport, vanlig textformat |
CMe2100, CMe2100 LTE, CMe3100 |
|
2006 |
FTP-loggrapport (bifogad CSV-fil i vanligt textformat) |
CMe2100, CMe2100 LTE, CMe3100 |
|
2007 |
FTP-statusrapport, oformaterad text |
CMe2100, CMe2100 LTE, CMe3100 |
|
2101 |
FTP-värderapport (värden strukturerade i en enda CSV-fil i läsbart dataformat) |
CMe2100, CMe2100 LTE, CMe3100 |
|
2102 |
FTP-värderapport (värden strukturerade i en enda CSV-fil i rådataformat) |
CMe2100, CMe2100 LTE, CMe3100 |
|
2103 |
FTP-värderapport (värden strukturerade i en CSV-fil per mätare i rådataformat) |
CMe2100, CMe2100 LTE, CMe3100 |
|
2104 |
FTP-värderapport (värden strukturerade i en CSV-fil per mätare i läsbart dataformat) |
CMe2100, CMe2100 LTE, CMe3100 |
|
2105 |
FTP-värderapport utökad (värden strukturerade i en CSV-fil per mätare i läsbart dataformat med extra rubrikinformation) |
CMe2100, CMe2100 LTE, CMe3100 |
|
2108 |
FTP-värderapport utökad, vanligt textformat (värden strukturerade i en enda CSV-fil i läsbart dataformat med extra rubrikinformation) |
CMe2100, CMe2100 LTE, CMe3100 |
|
2109 |
FTP-värdesrapport utökad plus, vanlig textformat (värden strukturerade i en CSV-fil per mätare i läsbart dataformat med extra rubrikinformation och M-Bushuvudinformation) |
CMe2100, CMe2100 LTE, CMe3100 |
|
2110 |
FTP-värdesrapport utökad plus, vanlig textformat (värden strukturerade i en enda CSV-fil i läsbart dataformat med extra rubrikinformation och M-Bushuvudinformation) |
CMe2100, CMe2100 LTE, CMe3100 |
|
2111 |
FTP-värderapport i läsbart format i en bifogad fil. Denna rapport innehåller även information från M-Busheadern, exempelvis Status, Tillverkare etc. Rapportkolumnrubriken har ett prefix # och även DIF/VIF-information. |
CMe2100, CMe2100 LTE, CMe3100 |
|
2112 |
FTP-värdesrapport som liknar rapportmall 2110, men introducerar en kolumn för mätarens positionsinformation (MOID) |
CMe2100, CMe2100 LTE, CMe3100 |
|
2113 |
FTP-värderapport i läsbart format i en bifogad fil. Denna rapport innehåller även information från M-Busheadern. Till exempel status, tillverkare etc. Rapportkolumnrubriken har ett prefix # och DIF/VIF-information tryckt med DLMS-namn. |
CMe2100 G3, CMe2100 LTE, CMe3100 |
|
2114 |
FTP-värdesrapport utökad plus med position (MOID) och DLMS-namngivning (bifogad enskild CSV-fil i läsbart dataformat). |
CMe2100 G3, CMe2100 LTE, CMe3100 |
|
2115 |
FTP-värderapport utökad plus med position (MOID) och primäradress (bifogad enskild CSV-fil i läsbart dataformat). |
CMe2100 G3, CMe2100 LTE, CMe3100 |
|
2116 |
FTP-värdesrapport utökad plus med position (MOID) och primäradress (bifogad CSV-fil per mätare i läsbart dataformat). |
CMe2100 G3, CMe2100 LTE, CMe3100 |
Tabell 196. HTTP-rapporter
|
Mallnummer |
Förklaring |
Produkt(er) |
|---|---|---|
|
3001 |
HTTP-installationsrapport (värden strukturerade som ett inlägg i rådataformat) |
CMe2100, CMe2100 LTE, CMe3100 |
|
3002 |
HTTP-installationsrapport (värden strukturerade som ett inlägg i läsbart dataformat) |
CMe2100, CMe2100 LTE, CMe3100 |
|
3005 |
HTTP-händelserapport (värden strukturerade som ett inlägg i läsbart dataformat) |
CMe2100, CMe2100 LTE, CMe3100 |
|
3006 |
HTTP-loggrapport (värden strukturerade som ett inlägg i läsbart dataformat) |
CMe2100, CMe2100 LTE, CMe3100 |
|
3007 |
HTTP-statusrapport (värden strukturerade som ett inlägg i läsbart dataformat) |
CMe2100, CMe2100 LTE, CMe3100 |
|
3101 |
HTTP-värderapport (värden strukturerade som ett inlägg i läsbart dataformat) |
CMe2100, CMe2100 LTE, CMe3100 |
|
3102 |
HTTP-värderapport (värden strukturerade som ett inlägg i rådataformat) |
CMe2100, CMe2100 LTE, CMe3100 |
|
3103 |
HTTP-värderapport (värden strukturerade som ett inlägg per mätare i rådataformat) |
CMe2100, CMe2100 LTE, CMe3100 |
|
3104 |
HTTP-värderapport (värden strukturerade som ett inlägg per mätare i läsbart dataformat) |
CMe2100, CMe2100 LTE, CMe3100 |
|
3105 |
HTTP-värderapport utökad (värden strukturerade som ett inlägg per mätare i läsbart dataformat med extra rubrikinformation) |
CMe2100, CMe2100 LTE, CMe3100 |
|
3106 |
HTTP-värderapport utökad (värden strukturerade som ett inlägg per mätare i rådataformat) |
CMe2100, CMe2100 LTE, CMe3100 |
|
3108 |
HTTP-värderapport utökad (värden strukturerade som ett inlägg i läsbart dataformat med extra rubrikinformation) |
CMe2100, CMe2100 LTE, CMe3100 |
|
3109 |
HTTP-värderapport utökad plus (värden strukturerade som ett inlägg per mätare i läsbart dataformat med extra huvudinformation och M-Bushuvudinformation) |
CMe2100, CMe2100 LTE, CMe3100 |
|
3110 |
HTTP-värderapport utökad plus (värden strukturerade som ett inlägg i läsbart dataformat med extra huvudinformation och M-Bushuvudinformation) |
CMe2100, CMe2100 LTE, CMe3100 |
|
3111 |
HTTP-värderapport i läsbart format i en bifogad fil. Denna rapport innehåller även information från M-Busheadern, exempelvis Status, Tillverkare etc. Rapportkolumnrubriken har ett prefix # och även DIF/VIF-information. |
CMe2100, CMe2100 LTE, CMe3100 |
|
3112 |
HTTP-värderapport som liknar rapportmallen 3110 men introducerar en kolumn för mätarens positionsinformation (MOID). |
CMe2100, CMe2100 LTE, CMe3100 |
|
3113 |
HTTP-värderapport som innehåller information från M-Busheadern. Till exempel status, tillverkare etc. Rapportkolumnrubriken har ett prefix # och DIF/VIF-information tryckt med DLMS-namn (värden strukturerade i ett läsbart dataformat). |
CMe2100 G3, CMe2100 LTE, CMe3100 |
|
3114 |
HTTP-värderapport utökad plus med position (MOID) och DLMS-namn (värden strukturerade i läsbart dataformat). |
CMe2100 G3, CMe2100 LTE, CMe3100 |
|
3115 |
HTTP-värderapport utökad plus med position (MOID) och primäradress (värden strukturerade i läsbart dataformat). |
CMe2100 G3, CMe2100 LTE, CMe3100 |
|
3116 |
HTTP-värderapport utökad plus med position (MOID) och primäradress (värden strukturerade som en post per mätare i läsbart dataformat). |
CMe2100 G3, CMe2100 LTE, CMe3100 |
[en] Value reports contain meter report data. The CMe/CMi Series products can handle any standard M-Bus meter, which forces the product to dynamically assign properties for each available meter value. The properties are build up upon the internal M-Bus decoder. The properties are taken from the standard M-Bus EN13757. Within one telegram shall a combination of all properties for a value of a specific meter be unique, but sometimes M-Bus slave implementations don’t follow these recommendations. In those cases one or more values can have the exact same properties, but the position of the value is not unique which must be used to distinguish the values. The property names are globally used in all CMe/CMi Series documentation to describe i.e. report formats.
Tabell 197. [en] Properties describing the origin of a value
|
[en] Name |
[en] Description |
|---|---|
|
[en] Serial-number |
[en] The product serial number which has read and stored the value of a meter. |
|
[en] Device-identification |
[en] The M-Bus slave secondary identification which a value belongs to. |
|
[en] Date |
[en] The create date of a value. |
|
[en] Value-data-count |
[en] The M-Bus telegram in which a value was found. |
Tabell 198. [en] Properties describing the definition of a value
|
[en] Name |
[en] Description |
|---|---|
|
[en] Description |
[en] Description of the value. This property is usually defining the type of the value, i.e. energy, flow temperature etc. |
|
[en] Unit |
[en] Unit of the value. This property defines the unit, i.e kWh, °C etc. |
|
[en] Function |
[en] Function of the value describing i.e min value, max value etc. |
|
[en] Tariff |
[en] The tariff of the value. |
|
[en] Sub unit |
[en] The sub unit of the value, i.e. a numeric value for extended information of a value. |
|
[en] Storage number |
[en] The storage number of the value. Normally describing historic values. |
[en] The serial number is an 10-digit long numeric value. The first 4-digits identifies the product type. An example of a serial-number from a CMe2100 product would look like: 0006xxxxxx, where xxxxxx is the actual serial number of the product.
Tabell 199. [en] Product type numbers
|
[en] Product |
[en] 4-digit type number |
|---|---|
|
[en] CMe2100 |
0006 |
|
[en] CMe2100 LTE |
0148 |
|
[en] CMi2110 |
0012 |
|
[en] CMi2120 [en] Internal antenna |
0029 |
|
[en] CMi2120 [en] External antenna |
0027 |
|
[en] CMe2130 |
0030 |
|
[en] CMe3100 |
0016 |
[en] Device-identification is the unique meter id (M-Bus secondary address) which the meter value was read from. The device-identification is an 8-digit number. This number can normally be changed by the customer on demand. The device-identification for a meter is internally used in CMe/CMi Series to bind information for one meter connected to a CMe/CMi Series product. Thus all meters connected to CMe/CMi Series product must have unique device-identification (secondary address).
[en] Date is the timestamp of the meter value readout. Date/Time used in the CMe/CMi Series products can be configured with UTC offset to set any time zone.
[en] The value-data-count property is used to distinguish value data read from one telegram to another. The CMe/CMi Series products implement automatic FCB-bit toggling, which means that the product will automatically read all available data telegrams from a meter. A value of 0 means the value was found in telegram 0, a value of 1 means that the value was found in telegram 1.
[en] This property describes the type of a value. A type can be i.e. energy, power, flow temperature etc. Description can be one or a combination of names. The description can also be a custom specified string describing the value, which can contain any character string.
[en] All spaces in description names are replaced with character – (hyphen). Combination of description names are separated with space character. This helps finding the primary description of the value, i.e. the first word in the description name.
[en] Descriptions listed in the following table are taken from the M-Bus standard EN13757.
Tabell 200. [en] Standard description property values
|
[en] Name |
|---|
|
[en] energy |
|
[en] volume |
|
[en] mass |
|
[en] on-time |
|
[en] op-time |
|
[en] power |
|
[en] volume-flow |
|
[en] volume-flow-ext |
|
[en] mass-flow |
|
[en] flow-temp |
|
[en] return-temp |
|
[en] diff-temp |
|
[en] ext-temp |
|
[en] pressure |
|
[en] date |
|
[en] datetime |
|
[en] units-for-HCA |
|
[en] avg-duration |
|
[en] act-duration |
|
[en] fabrication-no |
|
[en] enhanced-id |
|
[en] address |
|
[en] reactive-energy |
|
[en] cold/warm-temp-limit |
|
[en] cum-cnt-max-power |
|
[en] credit |
|
[en] debit |
|
[en] access-number |
|
[en] device-type |
|
[en] manufacturer |
|
[en] parameter-set-id |
|
[en] model/version |
|
[en] hw-version |
|
[en] fw-version |
|
[en] other-sw-version |
|
[en] customer-location |
|
[en] Customer |
|
[en] access-code-user |
|
[en] access-code-operator |
|
[en] access-code-system-operator |
|
[en] access-code-developer |
|
[en] password |
|
[en] error-flags-dev-spec |
|
[en] error-mask |
|
[en] digital-output |
|
[en] digital-input |
|
[en] baudrate |
|
[en] response-delay-time |
|
[en] retry |
|
[en] remote-control-dev-spec |
|
[en] first-storage-for-cyclic-storage |
|
[en] last-storage-for-cyclic-storage |
|
[en] size-of-storage-block |
|
[en] storage-interval |
|
[en] time-point |
|
[en] duration-since-last-readout |
|
[en] start-of-tariff |
|
[en] duration-of-tariff |
|
[en] period-of-tariff |
|
[en] dimensionless |
|
[en] Voltage |
|
[en] Current |
|
[en] reset-counter |
|
[en] cum-counter |
|
[en] control-signal |
|
[en] day-of-week |
|
[en] week-number |
|
[en] time-point-of-day-change |
|
[en] state-of-param-activation |
|
[en] special-supplier-information |
|
[en] duration-since-last-cum |
|
[en] operation-time-battery |
|
[en] datetime-of-battery-change |
|
[en] day-light-saving |
|
[en] listening-window-management |
|
[en] cold/warm-temp-limit |
|
[en] remaining-battery-lifetime |
|
[en] count-meter-stop |
|
[en] Reserved |
|
[en] manufacturer-specific |
|
[en] no-error |
|
[en] too-many-DIFE |
|
[en] storage-number-not-impl |
|
[en] unit-number-not-impl |
|
[en] tariff-number-not-impl |
|
[en] function-not-impl |
|
[en] data-class-not-impl |
|
[en] data-size-not-impl |
|
[en] too-many-VIFE |
|
[en] illegal-VIF-group |
|
[en] illegal-VIF-exponent |
|
[en] VIF/DIF-mismatch |
|
[en] unimpl-action |
|
[en] no-data-available |
|
[en] data-overflow |
|
[en] data-underflow |
|
[en] data-error |
|
[en] premature-end-of-record |
|
[en] inc-per-input-pulse-on-input-channel-0 |
|
[en] inc-per-input-pulse-on-input-channel-1 |
|
[en] inc-per-output-pulse-on-input-channel-0 |
|
[en] inc-per-output-pulse-on-input-channel-1 |
|
[en] start-date/time-of |
|
[en] uncorrected-unit |
|
[en] acc-only-if-pos-contr |
|
[en] acc-of-abs-value-only-if-neg-contr |
|
[en] lower-limit-value |
|
[en] exceeds-lower-limit-value |
|
[en] datetime-of-begin-of-first-lower-limit-exceeded |
|
[en] datetime-of-end-of-first-lower-limit-exceeded |
|
[en] datetime-of-begin-of-last-lower-limit-exceeded |
|
[en] datetime-of-end-of-last-lower-limit-exceeded |
|
[en] upper-limit-value |
|
[en] exceeds-of-upper-limit-value |
|
[en] datetime-of-begin-of-first-upper-limit-exceeded |
|
[en] datetime-of-end-of-first-upper-limit-exceeded |
|
[en] datetime-of-begin-of-last-upper-limit-exceeded |
|
[en] datetime-of-end-of-last-upper-limit-exceeded |
|
[en] duration-of-first-lower-limit-exceeded |
|
[en] duration-of-last-lower-limit-exceeded |
|
[en] duration-of-first-upper-limit-exceeded |
|
[en] duration-of-last-upper-limit-exceeded |
|
[en] duration-of-lower-limit-exceeded |
|
[en] duration-of-upper-limit-exceeded |
|
[en] value-during-lower-limit-exceeded |
|
[en] leak-values |
|
[en] datetime-of-first-begin |
|
[en] datetime-of-first-end |
|
[en] value-during-upper-limit-exceeded |
|
[en] overflow-values |
|
[en] datetime-of-last-begin |
|
[en] datetime-of-last-end |
|
[en] future-value |
[en] This property describes the unit of a value. A unit can be i.e. Wh, kWh, °C etc. Units can be one or a combination of the names as listed in the following table. The unit can also be a custom specified string describing the value, which can contain any character string.
[en] All spaces in description names are replaced with character – (hyphen). Combination of units names are separated with space or slash (/) character. This helps finding the primary unit of the value, i.e. the first word in the unit name.
[en] Units listed in the following table are taken from the M-Bus standard EN13757.
Tabell 201. [en] Standard unit property values
|
[en] Unit |
|---|
|
[en] Wh |
|
J |
|
[en] m3 |
|
[en] Kg |
|
[en] second(s) |
|
[en] minute(s) |
|
[en] hour(s) |
|
[en] day(s) |
|
W |
|
[en] m3/h |
|
[en] m3/m |
|
[en] m3/sec |
|
[en] kg/h |
|
[en] °C |
|
K |
|
[en] Bar |
|
[en] MWh |
|
[en] kVARh |
|
[en] GJ |
|
[en] Ton |
|
[en] feet^3 |
|
[en] USgallon |
|
[en] USgallon/min |
|
[en] USgallon/h |
|
[en] MW |
|
[en] GJ/h |
|
[en] °F |
|
[en] local-curreny-unit(s) |
|
[en] Baud |
|
[en] Bittimes |
|
[en] month(s) |
|
[en] year(s) |
|
V |
|
A |
|
[en] reserved |
|
[en] /s |
|
[en] /min |
|
[en] /h |
|
[en] /day |
|
[en] /week |
|
[en] /month |
|
[en] /year |
|
[en] /revol/measurem |
|
[en] /liter |
|
[en] /m3 |
|
[en] /kg |
|
[en] /K |
|
[en] /kWh |
|
[en] /GJ |
|
[en] /kW |
|
[en] /k*liter |
|
[en] /V |
|
[en] /A |
|
[en] *s |
|
[en] *s/V |
|
[en] *s/A |
|
[en] *s/A |
[en] This property describes the function of a value. A function can be i.e. minimum value, maximum value etc.
[en] Functions listed in the following table are taken from the M-Bus standard EN13757.
Tabell 202. [en] Standard function property values
|
[en] Name |
[en] Description |
|---|---|
|
[en] inst-value |
[en] The value is an instantaneous value (Current value) |
|
[en] max-value |
[en] The value is a maximum value at a specific date/time |
|
[en] min-value |
[en] The value is a minimum value at a specific date/time |
|
[en] err-value |
[en] The value contains error and should not be treated as qualified value. |
[en] Sub-unit property is a numeric value describing the sub-unit of a value. Sub-unit is often used to distinguish almost identical values, for example a software version from a meter can be of sub-unit 0 and software version of the M-Bus module used to communicate with the meter can be of sub-unit 1.
[en] Depending on meter used, a wide range of data can be available. A standard electricity meter normally provides numerous of extra information besides e.g. energy and power.
[en] This section describes how to find and identify commonly used information from standard M-Bus meters. Please note that depending on meter, this information may vary.
Tabell 203. [en] Commonly used properties for electricity meters
|
[en] Value of interest |
[en] Description |
[en] Unit |
[en] Function |
[en] Tariff |
[en] Sub-unit |
[en] Storage number |
|---|---|---|---|---|---|---|
|
[en] Current energy meter stand |
[en] energy |
[en] Wh |
[en] inst-value |
0 |
0 |
0 |
|
[en] Current power |
[en] power |
W |
[en] inst-value |
0 |
0 |
0 |
|
[en] Current energy meter stand – Tariff 1 |
[en] energy |
[en] Wh |
[en] inst-value |
1 |
0 |
0 |
|
[en] Maximum power |
[en] power |
W |
[en] max-value |
0 |
0 |
0 |
Tabell 204. [en] Commonly used properties for water meters
|
[en] Value of interest |
[en] Description |
[en] Unit |
[en] Function |
[en] Tariff |
[en] Sub-unit |
[en] Storage number |
|---|---|---|---|---|---|---|
|
[en] Current volume meter stand |
[en] volume |
[en] m3 |
[en] inst-value |
0 |
0 |
0 |
Tabell 205. [en] Commonly used properties for district heat and cold meters
|
[en] Value of interest |
[en] Description |
[en] Unit |
[en] Function |
[en] Tariff |
[en] Sub-unit |
[en] Storage number |
|---|---|---|---|---|---|---|
|
[en] Current volume meter stand |
[en] energy |
[en] Wh |
[en] inst-value |
0 |
0 |
0 |
|
[en] Current volume meter stand |
[en] volume |
[en] m3 |
[en] inst-value |
0 |
0 |
0 |
|
[en] Current power |
[en] power |
W |
[en] inst-value |
0 |
0 |
0 |
|
[en] Current forward temperature |
[en] flow-temp |
[en] °C |
[en] inst-value |
0 |
0 |
0 |
|
[en] Current backward temperature |
[en] return-temp |
[en] °C |
[en] inst-value |
0 |
0 |
0 |
|
[en] Current temperature difference |
[en] diff-temp |
K |
[en] inst-value |
0 |
0 |
0 |
|
[en] Current volume flow |
[en] volume-flow |
[en] m3/h |
[en] inst-value |
0 |
0 |
0 |
Tabell 206. [en] Commonly used properties for gas meters
|
[en] Value of interest |
[en] Description |
[en] Unit |
[en] Function |
[en] Tariff |
[en] Sub-unit |
[en] Storage number |
|---|---|---|---|---|---|---|
|
[en] Current volume meter stand |
[en] volume |
[en] m3 |
[en] inst-value |
0 |
0 |
0 |
|
[en] Current volume flow |
[en] volume-flow |
[en] m3/h |
[en] inst-value |
0 |
0 |
0 |
Kommentarer (0 kommentarer)