YOSensi YO Meter Pulse, User Manual

Page 1: ...YO Meter Pulse User guide v1 2 ...

Page 2: ...vice configuration and firmware update options via Yosensi Configuration Web Tool CLI is outdated for new devices applies to firmware up to 3 4 0 21 07 2023 1 2 Updated configuration instructions using Yosensi Management Platform for firmware 3 4 2 and newer Changed description of connecting nodes with Yosensi Management Platform www yosensi io ...

Page 3: ...ity 8 Battery condition 9 Installation 10 Package contents 10 Safety precautions 10 Installation guide 11 Operation 14 IoT system components 14 Device configuration 15 Configurable parameters 15 Parameters description 17 Configuration node with Yosensi Management Platform 19 Connecting node with network 20 Yosensi Management Platform configuration 20 Adding node manually 20 Adding node via bluetoo...

Page 4: ...res temperature and humidity Figure 1 Device top view Device sticker placed on the right side of the device enclosure contains information about model version LoRaWAN region and 3 parameters important in case of device identification and configuration DEV EUI 64 bit unique device identifier in a LoRaWAN network DEV ADDR address required to connect via ABP activation type to LoRaWAN BLE MAC bluetoo...

Page 5: ... device is working incorrectly power and memory LoRaWAN communication failed to receive an acknowledgement from LoRaWAN Server within specified timeout Single flash White LoRaWAN communication LoRaWAN frame sent confirmation from LoRaWAN Server after receiving the frame Slow flashing Blue BLE communication connection to the device via BLE configuration Rapid flashing Blue LoRaWAN communication con...

Page 6: ...l Figure 3 Dimensions of the device PHYSICAL SPECIFICATION Dimensions Height 42 mm Width 88 mm Depth 64 mm Colour Light grey Mounting method Horizontal Vertical can be screwed to the wall Enclosure material ABS Level of protection IP67 Weight 126 5 g www yosensi io ...

Page 7: ...00 2 20 to 80 Periodic counter 0 2147483647 int32 Persistent counter 0 2147483647 int32 Pulse counter The YO Meter Pulse input accepts connection to potential free contacts The device will not count pulses if the input is connected to contacts with any potential Device input can detect pulses with different contact debounce times This parameter is configurable and by default is 47 ms up to max 10 ...

Page 8: ...ure 4 Periodic pulse counter exemplary chart Persistent counter accumulates pulses and stores them in non volatile memory this counter can be reset cleared using one of the parameters via BLE Figure 5 Persistent pulse counter exemplary chart Temperature and relative humidity Temperature and relative humidity are measured by sensors placed inside the device enclosure These measurements can be used ...

Page 9: ...y condition Battery voltage is used to monitor its condition to spot anomalies like sudden drop or its current condition based on voltage drop over time in comparison to initial voltage rating Figure 7 Battery voltage exemplary chart www yosensi io ...

Page 10: ...er operations near inside electronics Be careful while handling the device dropping it may cause damage that will affect the sensors and other electronics inside When installing the device on the wall remember to wear adequate protective equipment To maintain the level of protection device cover screws must be properly tightened Device shouldn t be used without cover Any actions inside the device ...

Page 11: ...1 27 Installation guide 1 Unscrew the device remove 4 screws from the enclosure Figure 8 Device opening instructions 2 Unscrew the cable gland nut and remove the cap Figure 9 Device with removed top cover and PG7 cap marked www yosensi io ...

Page 12: ...and Figure 10 Input cable passing through the cable gland instructions 4 Press the spring contact in the DI connector and insert the pulse counting cable Tighten the cable gland nut to immobilize the sensor cable and maintain tightness Figure 11 Connecting input cable instructions www yosensi io ...

Page 13: ...e v1 2 page 13 27 5 Place three LR6 AA batteries in the device according to the polarity indicated on the battery holder Figure 12 Battery placement instructions 6 Assemble the device and screw it back together www yosensi io ...

Page 14: ...teway 2 Gateway device similar to routers equipped with a LoRa concentrator that receives LoRa packets and send them to the Internet connected server 3 Server in most cases a cloud based service where data is processed stored analysed and presented in user friendly ways via a user interface Yosensi default and recommended tools are Yosensi Management Platform for IoT structure management and Grafa...

Page 15: ...tion ble generic bluetooth settings device dynamic individual configuration for a specific device this section s structure differs for each device Sample configuration file for the YO Meter Pulse device info devmodel LNMP fwver 3 5 0 loraradio SX1261 lorawanver 1 0 2 loraregion EU868 blemacaddr 0123456789ab lorawan subband 1 nwktype public acttype otaa otaa deveui 0123456789abcdef appeui fedcba987...

Page 16: ...ice EUI Extended Unique Identifier 8 B HEX predefined R W appeui Application EUI 8 B HEX predefined R W appkey Application Key 16 B HEX predefined R W trials Join request trials 1 9 3 R W lorawan abp devaddr Device Address 4 B HEX predefined R W nwkskey Network Session Key 16 B HEX predefined R W appskey Application Session Key 16 B HEX predefined R W ble power Bluetooth LE transmit power dBm 04 0...

Page 17: ... and keys these parameters are generated using multiple IDs specific to the particular MCU and are unique for each device they can be changed if needed interval determines the interval of sending broadcast packets used to connect to every BLE receiver around the device subband used for setting the communication frequency sub band in LoRaWAN measinterval measurement interval s between sending LoRa ...

Page 18: ... 6 910 3 911 7 MHz channels 40 47 6 Sub band 7 911 9 913 3 MHz channels 48 55 7 Sub band 8 915 5 914 9 MHz channels 56 63 8 AU915 Sub band 1 915 2 916 6 MHz channels 0 7 1 2 R W Sub band 2 916 8 918 2 MHz channels 8 15 2 Sub band 3 918 4 919 8 MHz channels 16 23 3 Sub band 4 920 0 921 4 MHz channels 24 31 4 Sub band 5 921 6 923 0 MHz channels 32 39 5 Sub band 6 923 2 924 6MHz channels 40 47 6 Sub ...

Page 19: ...fferent buttons Configure here you can change and upload the device parameters Update firmware here you can update the firmware to version 3 4 0 and newer Recover device this section restores the firmware of the device This button helps if you lose the connection while uploading firmware 5 After selecting the configure button and connecting node the next step is to configure parameters Now you can...

Page 20: ...osensi io The application is a representation of each system and together with the node definitions is created by customers The basic integration of a node into the Yosensi Management Platform is described below Nodes can be added manually or via Bluetooth NOTE A subscription is needed to use Yosensi Management Platform Contact us on contact yosensi io for more information and pricing Adding a nod...

Page 21: ... section appkey All device identifiers are provided by Yosensi Support when you order the nodes Select a model that is compatible with your device this choice affects the number of charts and data source YO Meter Pulse You can also set the node s Location if locations have been pre defined If you haven t defined a suitable location leave this field set at None Figure 17 Adding node to the Yosensi ...

Page 22: ...e Node configuration Click on the link in the Node Name column Go to the KEYS tab and switch LoRa Type from OTAA to ABP and fill in the blank spaces then press update The identifiers Device Address devaddr Application Session Key appskey and Network Session Key nwkskey are provided by Support or can be found in the device s configuration pane while connected to the node in the firmware section www...

Page 23: ...n application click the bottom right button Fill in the Name and Description fields and select the Application Profile which is the region definition 4 Proceed to the application by clicking its name on the list and press the button to add a node Click Add via Ble Select the device to add Then the list with devices available to connect to the application will appear The name of the node will be ge...

Page 24: ...mple of YO Meter Pulse payload with description 02 00 00 00 08 00 01 11 a2 0d 00 01 00 f8 10 00 00 37 5c 00 07 00 00 00 00 00 00 f7 a9 Payload header First measurement battery voltage 0x02 0x00 0x00 0x00 0x08 0x00 0x01 0x11 0xA2 ver 2 cnt 0 pct s 0 type 2 prec 0 md s 0 addr_len 0 meas_len 2 val 4514 4514 mV Second measurement temperature 0x0D 0x00 0x01 0x00 0xF8 type 3 prec 1 md s 0 addr_len 0 mea...

Page 25: ...YO Meter Pulse User guide v1 2 page 25 27 Compliance statements www yosensi io ...

Page 26: ...YO Meter Pulse User guide v1 2 page 26 27 www yosensi io ...

Page 27: ...YO Meter Pulse User guide v1 2 page 27 27 www yosensi io ...