Commissioning
Before installing a device with Elvaco Play, you need an Elvaco Play account and access to an organisation. To perform the installation, you also need the Elvaco Play app.
-
Download Elvaco Play App Google Play or App Store
-
Open Elvaco Play App or Elvaco Play Portal
-
Log in to your account (or create an account if you aren’t already an Elvaco Play user)
-
Ask your admin to invite you to an existing organization (or create an organization if there is none)
For additional information, go to Account & Profile.
Elvaco Play CMe2100 LTE G2 have the Elvaco Play token sticker integrated on the product label. This QR code token is used to claim the ownership of that device in Elvaco Play. Encryption keys are managed internally by Elvaco Play, so no key handling is required by the customer.
Before the CMe2100 LTE G2 can be installed using Elvaco Play app, the gateway must be mounted and connected to mains power. Once powered, open the Elvaco Play app, make sure that you are working in the correct organization, and follow the automated flow described below.
|
1. Press install |
2. Scan the QR code located on the gateway to claim it to your Elvaco Play organisation |
3. Press continue |
||
|
4. Manually enter the phone number and, if required, the APN. Alternatively, confirm the pre-filled information. Then press Continue |
5. [Recommended] Assign a location (i.e facility name) to your device to know where it is located |
6. Your device is now claimed |
||
|
7. Press Configure via SMS to setup the gateway |
Warning
Unencrypted SMS commands sent from a phone's SMS app will be rejected by the gateway. The configuration is done using Elvaco Play app.
Note
Meters connected to a CMe2100 LTE G2 are installed from the Configuration tab of the selected gateway in Elvaco Play app. They are not installed using Add meters from Devices in Elvaco Play Portal or Elvaco Play app.
You can quickly get the product started using default settings by running the install command and setting an e-mail Push Report recipient. After doing so, the CMe2100 LTE G2 will:
-
Read all installed meters once every hour, using a baud rate of 2400 bit/s.
-
Deliver an e-mail Push Report at 00:00 each day.
To get the product started, use these default settings:
-
To set the e-mail recipient of the daily Push report, send the following command in Elvaco Play app. The product will send a response confirming that the recipient has been set.
qset email [recipient]
-
To start the installation of the meters send the following command to the CMe2100 LTE G2. The product will respond with an SMS confirming that the installation has started, and an additional SMS when it has been completed.
install [expected number of meters]
or
install [expected number of meters][CAD file]
|
Variable |
Explanation |
Settings |
|---|---|---|
|
Recipient |
The e-mail address of the intended recipient of the daily Push Report. |
Valid e-mail address |
|
Expected number of meters |
The number of meters expected to find in the installation process. |
Arbitrary integer |
Communication with the device must be encrypted to fulfill regulatory requirements. The encryption protocol (v1) uses AES-CTR for payload encryption, HKDF-derived per-message keys, and an 8-byte truncated HMAC-SHA256 for authentication. The encrypted frame is Base64URL encoded without padding. For more information, contact support@elvaco.com.
When delivered, the CMe2100 LTE G2 is in factory state. In this state, a factory communication key has been set. Before normal encrypted commands can be used, a new 16-character communication password must be set. The new password must be different from the factory communication key stored in the product, and is set using below command:
common.security.product.communication.password=<new 16 character key>
After this has been done, the default communication key is no longer accepted for normal commands.
Note
The product’s default communication key can be read from the NFC status record. This key is only intended for initial secure setup. For Elvaco Play installations, key handling is managed by Elvaco Play completely.
After the communication password has been set, commands must be encrypted with the new communication password. The default communication key is no longer accepted for normal communication.
Note
Encrypted communication protects commands and responses against unauthorized access and tampering.
Note
Encryption protocol v1 uses AES-CTR for payload encryption, HKDF-derived per-message keys, and an 8-byte truncated HMAC-SHA256 for authentication. The encrypted frame is Base64URL encoded without padding. For more information, contact support@elvaco.com.
Once the CMe2100 LTE G2 has been mounted, powered up, and connected to the meters, it can be quickly commissioned using the install command and by adding an e-mail recipient for Push Reports. When completed, the CMe2100 LTE G2 will automatically:
-
Read all installed meters once every hour, using a baud rate of 2400 bit/s.
-
Deliver an e-mail Push Report at 00:00 each day.
To get the product started, use these default settings:
-
To set the e-mail recipient of the daily Push report, send the following command in Elvaco Play app. The product will send a response confirming that the recipient has been set.
qset email [recipient]
-
To start the installation of the meters send the following command to the CMe2100 LTE G2. The product will respond with an SMS confirming that the installation has started, and an additional SMS when it has been completed.
install [expected number of meters]
or
install [expected number of meters][CAD file]
|
Variable |
Explanation |
Settings |
|---|---|---|
|
Recipient |
The e-mail address of the intended recipient of the daily Push Report. |
Valid e-mail address |
|
Expected number of meters |
The number of meters expected to find in the installation process. |
Arbitrary integer |
Note
In the example above, the SMS messages are shown unencrypted. In a real installation, the communication is encrypted. Therefore, a separate system is required to encrypt outgoing SMS commands and decrypt incoming SMS responses.
Comments (0 comments)