User guide

BB2-7040 User Guide – Rev. 1.2 Page 12
4 Creating a Data Parse Mask
The data parse mask may have been provided for you in a related document pertaining to a specific endpoint, or in an
appendix of this document. If you need to create a new data parse mask for a new device, start by getting the device
online and sending its data packets to the BB2-7040. Correlate the packets observed with the manufacturers
documentation to begin to recognize its data.
The screen shot below shows several packets observed in the Message Log. The line marked “a” was received with no
rule recognizing that packet. The packets marked “b” were received and recognized by rules with data parse masks. The
packets at “c” show the gateway sending a command to a device and receiving its reply.
Let us copy the unrecognized packet and paste into a program like Notepad.
We now begin to construct the data parse mask based on documentation provided by the manufacturer. This example
happens to be a Digi XBee sensor. We know that the first byte of the API packet should always be (hex) 92. We will not
check the address here since the device handling should do that for us. We can therefore treat the address bytes as “don’t
care” at this level, making device substitution easier at a later time. We know that the channel mask should always be
hex) 0E. We know that the next to last pair of bytes is a data point of interest, in this case raw temperature reading.