iOKE868 - Package - Wireless Solutions
User Guide for IMST models including: iOKE868, Smart Metering Kit, Metering Kit, Smart Metering, Metering
iOKE868 - - Wireless Solutions
File Info : application/pdf, 10 Pages, 519.63KB
DocumentDocumentIMST GmbH Carl-Friedrich-Gauß-Str. 2-4, D-47475 Kamp-Lintfort iOKE868 LoRaWAN® AN031 - QuickStartGuide Version 1.2 Document State final Date October 2021 Document ID 4000/40140/0161 © 2021 IMST GmbH - All rights reserved Revision history Date 15.10.2020 19.10.2020 29.03.2021 14.10.2021 Version 0.1 1.0 1.1 1.2 Content General Information Configuration of iOKE868 LoRaWAN Copy of Copyright Chapter all all General information all Description created reviewed FTDI Chip will be disabled a few seconds after powering reviewed and updated iOKE868 LoRaWAN® / AN031 - QuickStartGuide / Version: 1.2 Page 2 of 10 General Information Aim of this Document The kit iOKE868 LoRaWAN consist of an optical reader head unit iO881A, an antenna with cable and an USB cable. The iO881A is partly compliant with IEC62056-21 (Mode A/B/C/D) and SML and can be magnetically attached to meters to read out the corresponding meter data. It uses LoRaWAN technology to transmit those meter data into the cloud. iO881A can filter certain OBIS (Object Identification System) figures from the data stream of the meter. It provides an integrated calendar function for configuration various events. Therefore iO881A needs a time base so that the calendar events are scheduled correctly. If the iO881A is connected with a LoRaWAN network, it tries to synchronize itself over this network after each start-up. In the normal use case it is assumed that the LoRaWAN network operator provides the network time and iO881A therefore can synchronize itself regularly. If LoRaWAN networks are used that do not support the "Get Network Time" command, a corresponding work-around must be configured. The configuration for both scenarios are describe within this document. Disclaimer IMST GmbH points out that all information in this document are given on an "as is" basis. No guarantee, neither explicit nor implicit is given for the correctness at the time of publication. IMST GmbH reserves all rights to make corrections, modifications, enhancements, and other changes to its products and services at any time and to discontinue any product or service without prior notice. It is recommended for customers to refer to the latest relevant information before placing orders and to verify that such information is current and complete. All products are sold and delivered subject to "General Terms and Conditions" of IMST GmbH, supplied at the time of order acknowledgment. IMST GmbH assumes no liability for the use of its products and does not grant any licenses for its patent rights or for any other of its intellectual property rights or third-party rights. It is the customer's duty to bear responsibility for compliance of systems or units in which products from IMST GmbH are integrated with applicable legal regulations. Customers should provide adequate design and operating safeguards to minimize the risks associated with customer products and applications. The product is not approved for use in life supporting systems or other systems whose malfunction could result in personal injury to the user. Customers using the product within such applications do so at their own risk. Any resale of IMST GmbH products or services with statements different from or beyond the parameters stated by IMST GmbH for that product/solution or service is not allowed and voids all express and any implied warranties. The limitations on liability in favor of IMST GmbH shall also affect its employees, executive personnel and bodies in the same way. IMST GmbH is not responsible or liable for any such wrong statements. iOKE868 LoRaWAN® / AN031 - QuickStartGuide / Version: 1.2 Page 3 of 10 Configuration of iOKE868 LoRaWAN The iO881A requires an initial configuration before usage. This configuration can be done by means of a PC-Tool called WS-Configurator which is connected via serial interface (USB) to the device. In any case, the first step should be to connect the antenna cable to the corresponding u.fl connector of iO881A. Then use the USB cable to connect the iO881A with your laptop/PC. The USB interface is activated when devie is started for the first time. For further infomration please refer to the chapter Automatic Power Saving of the User Manual. Place the optical reader head iO881A on the infrared interface of your meter. The iO881A usually clings magnetically in the right place. Nevertheless, make sure that the reading head is correctly attached. Choose a good position for the antenna, e.g. outside the cabinet if possible. Open the configuration tool "WS Configurator" on your laptop/PC. Within the configuration tool you have the three sections in the upper left corner: 1. "Device Information", 2. "Configuration" and 3. "Meter Values". For further information on the "WS Configurator" please refer to the corresponding WS Configurator User Manual. OBIS Values of the Meter The first step should be to read out the infrared interface of your meter and analyse the provided OBIS values. Under "Device Information->Detect OBIS IDs" (see last picture above) you can read out the OBIS value send by your meter. When iOKE868 LoRaWAN® / AN031 - QuickStartGuide / Version: 1.2 Page 4 of 10 you configure possible read out events within the calendar later on you can choose between those OBIS IDs for filtering purpose. For more information on the meter's infrared interface, please contact your meter-operator or your grid-operator. How to Start with Get Network Time supported by the LoRaWAN Network Operator Configure Calendar Events In this use case we assume that the iO881A gets the time from the LoRaWAN network on request. Therefore it makes sense to configure the "Get Network Time Event" regularly (e.g. repetition once a week). This event is used to keep the iO881A synchronized in time (UTC time) to allow the correct executing of possible calendar events. Furthermore it is recommended to configure the "Send Status Event" regularly. The iO881A is a ClassA LoRaWAN device. This means it can only be reached by the application server when it initiates a transmission by itself. The first specified event is the "Get Network Time" event (marked with green color), see picture above. It is repeated once per week starting from 12:00:00 at 1st of May 2020. The second specified event is the "Send Status" event (marked with green color), see picture above. It is repeated once per hour starting from 00:00:00 at 1st of May 2020. iOKE868 LoRaWAN® / AN031 - QuickStartGuide / Version: 1.2 Page 5 of 10 The third event is the "Read out a single block of value" event (marked with red color), see picture above. It is scheduled starting from the 30th of September 2020 12:24:44 a clock and is repeated one per hour. From this start time, the iO881A wakes up every hour, opens the infrared interface to the meter device, reads the corresponding meter parameter and filters out the two configured OBIS key figures (within thsi example the "Time integral 1 Sum active power" and the "instantaneous value Sum active power"). The OBIS key figures can be selected from a drop down list of posssible OBIS key figures by clicking on the "lense" symbole. The selected OBIS figures are then filtered out of the meter data and sent via the LoRaWAN network. For configuration of further calendar events please refer to the "WS-Configurator Manual". Configure the LoRaWAN Credentials Both, ABP and OTAA are supported by iO881A. We recommend using the OTAA process for joining the LoRaWAN network. Therefore configure the corresponding "Application EUI" and "Application Key" and write both into the iO881A. The keys are normally generated when creating a device on your LoRaWAN network account. Within the "WS Configurator" keys can only be written into the device. A read out of keys is not possible due to security reasons. So, it is recommend to document the keys separately. iOKE868 LoRaWAN® / AN031 - QuickStartGuide / Version: 1.2 Page 6 of 10 Now a first test if the network can be reached by iO881A can be started. Therefore start the activation of the LoRaWAN stack by moving the slide switch to the right side. iO881A than starts the joining procedure. You can check either on the network server side if the corresponding "Join Requests" are received by the network server or observe the LED signalling of iO881A. Now you can close the "WS Configurator", unplug the USB cable from your laptop. Connect the USB cable of the iOKE868 to your preferred iOKE868 LoRaWAN® / AN031 - QuickStartGuide / Version: 1.2 Page 7 of 10 power supply (USB battery pack or USB power plug). Observe the LED signalling of the iO881A during start up, refer to the table above. iOKE868 LoRaWAN® / AN031 - QuickStartGuide / Version: 1.2 Page 8 of 10 How to Start with Get Network Time not supported by the LoRaWAN Network Operator If your network operator does not support the "Get Network Time" command the synchronization of the iOKE868 can be done as follow. Configure Calendar Events It is still recommended to configure the "Send Status Event" regularly due to the ClassA nature of the device. For configuration of further calendar events please refer to the "WS-Configurator Manual". If your network operator really does not support the "Get Network Time Event" it makes still sense to use this calendar event regularly. The firmware has implemented a fall back mechanism. In case of no response from the network operator the firmware transmits an "Get Time Request" application command via LoRaWANon application level, thus to the connected Application Server which might be able to answer this request. This is in the responsibility of the Application Server operator. If you are really sure that neither you Network Operator nor your Application Server answers the "Time Request Commands" the configuration of those events does not make sense. Then the device must use the time base from last the synchronization with the laptop/PC. This is done at the end of the configuration session. Configure the LoRaWAN Credentials Both, ABP and OTAA are supported by iO881A. We recommend using the OTAA process for joining the LoRaWAN network. Therefore configure the corresponding "Application EUI" and "Application Key" and write both into the iO881A.The keys are normally generated when creating a device on your LoRaWAN network account. Within the "WS Configurator" Keys can only be written into the device. A read out of keys is not possible due to security reasons. So, it is recommend to document the keys separately. Now you can test if the network can be reached by iO881A. Therefore start the activation of the LoRaWAN Stack. iO881A than starts the joining procedure. You can check on the network server side if the corresponding Join Requests are received by the network server or observe the LED signalling of iO881A. You can expect that the synchronization due to the Get Network Time Events on Network and Application level will fail and therefore after a successful activation (2 x green) the red LED will be blinking for a longer period (e.g. few minutes). Before you now just close the "WS Configurator", the missing time synchronization must be compensated. To do this, under the "Configuration-> System" menu, the laptop/PC time can be converted into UTC time and can be written in the non volatile memory of iO881A. Now you can close the "WS Configurator", unplug the USB cable from your laptop/PC. Please connect the USB cable of iOKE868 immediately to your preferred power supply (USB battery pack or USB power plug). The UTC time from the non volatile memory is used during start up of iO881A to set the time. Observe the LED signalling of the iO881A. You can expect that the time synchronization will fail and therefore after a successful activation (2 x green) the red LED will be blinking for a longer period (e.g. few minutes). iOKE868 LoRaWAN® / AN031 - QuickStartGuide / Version: 1.2 Page 9 of 10 Copy of Copyright Copyright© 2020 IMST GmbH. The LoRa® Mark and LoRa Logo are trademarks of Semtech Corporation. Use of the LoRaWAN certified® mark is pursuant to license from the LoRa Alliance®. All rights reserved. Subject to technical changes without notice. iOKE868 LoRaWAN® / AN031 - QuickStartGuide / Version: 1.2 Page 10 of 10