Sensor That

Help

Welcome to ST Help




Overview Overview

This system is designed around the idea that each Wireless Sensor Module should only have one function either as a Input, Output or supplying a Reading using an Analogue-to-Digital Converter (ADC). Not only does this simplify the whole system, it also does not make any sense to put all kinds of sensors into a single sensor block. This does not allow for a related sensor to be strategically placed in a location where it is going to be the most effective. It makes more sense to place a water or gas leak detection sensor down low on the ground or on the floor, however measuring temperature at the location would not be effective. Also other devices that require control are not always in close proximity to each other. Normally to use the Wireless Sensor Network Internet Application Sensor That, you need to purchase a STx Gateway available at the link below.

To Purchase a STx Gateway on-line

However you can try out the ST Internet Application using a virtual sensor without having to purchasing any hardware. This can be done with the Android Application Packet XB92 available on Google Play and by following the instructions available on this page.

To Install the Android Application Packet XB92



Security Security

Recent studies have shown that 70 percent of the most commonly used Internet of Things (IoT) devices contain vulnerabilities, including password security, encryption and general lack of granular user access permissions.

The ST Internet Application uses a secure connection or HTTPS. Hypertext Transfer Protocol Secure (HTTPS) is a communications protocol used over a computer network with especially wide deployment on the internet. Technically, it is not a protocol in and of itself; rather, it is the result of simply layering the Hypertext Protocol (HTTP) on top of the SSL/TLS protocol, thus adding the security capabilities of SSL/TLS to standard HTTP communications. The main motivation for HTTPS is to prevent wire-tapping and man-in-the-middle attacks.

Recent testing done by SSL Labs awarded the ST Internet Application an “A” Rating and is not vulnerable to the Heart Bleed Open SSL security issue. To put that into simple layman terms it has the same level of security as any on-line banking site.

Data sent over the internet by STx Gateway is encrypted using the AES256 Encryption standard. Also AES128 is used by any and all wireless sensors when transmitting data over the wireless sensor network. Other filtering mechanism are used, however they will not be discussed here since that would not support security through obscurity.

AES has been adopted by the U.S. government and is now used worldwide. It supersedes the Data Encryption Standard (DES),  which was published in 1977. The algorithm described by AES is a symmetric-key algorithm meaning the same key is used for both encrypting and decrypting the data.



Registration Registration

1. Enter your First Name into the input text box labelled First Name.

2. Enter your Last Name into the input text box labelled Last Name.

3. Enter a new Username into the input text box labelled Username.

4. Enter a Password, it must be 8 characters long, one upper case letter, one lower case letter, one digit.

5. Enter your Email address into the input text box labelled Your Email, this will be used later for account verification and also sensor alerts.

6. In the text input box labelled Cell Number enter your 10 digit cell phone number, your cell number will also be used for sensor alerts.

7. From the drop down list labelled Cell Carrier select your Cell Carrier.

8. Enter the Captcha code below into the text input box labelled Captcha.

9. Click the button labelled Join Now.

Notes:

After you register, you will receive a ST Welcome email and also a text message on your cell phone. The text message will have a 6 digit verification code. It is important you keep this message, it is needed latter for verification so you can receive text message alerts. Within the ST Welcome email you received, click the account verification link. This will verify your email address and activate your account. If activation is successful you will then be redirected to an account activation successful page, now you can proceed to login.



Login Login

1. Enter your Username into the input text box labelled Username.

2. Enter your Password into the input text box labelled Password.

3. Enter the Captcha code below into the text input box labelled Captcha.

4. Next click the button labelled Login.

Notes:

Once you are logged in you will see the menu system and a map of North America.



Adding a Project Adding a Project

1. At this point you will have no projects associated with your account.

2. From the available menus select the Administration menu, then select the menu item Projects.

3. Now on the Projects Administration panel click the Add icon.

4. In the input text box labelled Project Name enter the name of your project, this can be a short description your project.

5. In the input text box labelled Description enter a longer more detailed description of your project.

6. On the bottom of the form You will see a Map of North America, use the map controls to set a Zoom level and centre of your project.

7. Dragging the Project icon on the Map will fill in the Longitude and Latitude of your Projects centre point.

8. Next select the Time Zone based on your projects location of your project from the drop down Time Zone token.

9. Next click the Add icon, this will create your new project.



Adding a Site Adding a Site

1. At this point you will have no sites within your project.

2. From the available menus select the Administration menu, then select the menu item Sites.

3. Now on the Sites Administration panel click the Add icon.

4. In the input text box labelled Site Name enter the name of your site, this can be a short description your site.

5. In the input text box labelled Description enter a longer more detailed description of your site.

6. In the input text box labelled Keep Days enter the number of days to keep sensor data.

7. On the bottom of the form You will see a Map of North America, use the map controls to set the Zoom level and centre for the location of your site.

8. Dragging the Site Map Marker on the Map will fill in the Longitude and Latitude of your sites centre point.

9. Enter the Source IP Address, this IP Address is used by Input and Analogue-to-Digital Converter (ADC) Devices.

10. Enter the Destination IP Address, this IP address is used by Output Devices.

11. Next click the Add icon, this will create your new site.



Call Verification Cell Verification

1. From the available menus select the Account menu, then select the menu item Verify Cell.

2. Enter the verification code you received on your cell phone into the text input box labelled Verification Code.

3. Next click the Check icon, if you entered the correct code your cell phone is now verified.

Notes:

Cell Phone notifications will not be sent until your cell phone has been verified.



Adding a Device Adding a Device

1. From the available menus select then Administration menu, then select the menu item Devices.

2. Now on the Devices Administration panel click the Add icon.

3. If the device function is a Input or Output device, then select the corresponding type.

4. Select the device function, either input, output or ADC (Analogue-to-Digital Converter).

5. If the device function is ADC enter the type e.g. Temperature.

6. If the device function is ADC enter the Units used e.g. Celsius.

7. In the Decimals input text box enter the number of decimals places you need to display an accurate reading.

8. Next enter the Equation needed to convert your raw 10 bit Analogue to Digital sample to a reading e.g. $reading=(((($raw*1200)/1023)-500)/10)

9. If you only want to view the raw Analogue to Digital then enter $reading=$raw

10. Next click the Add icon, this will save your newly created device.

Notes:

You can create as many devices as needed for your sensor project.

Allowed Equation Functions: abs(), atan(), ceil(), cos(), exp(), log(10), rand(), round(), sin(), sqrt(), tan()

Allowed Equation Math operators: / * ^ + -


Adding a Sensor Adding a Sensor

1. At this point there are no Sensors created, all Sensors are derived from Devices.

2. From the available menus select the Administration menu, then select the menu item Sensors.

3. On the Sensor Administration panel click the Add icon.

4. In the text box labelled Sensor, enter the Sensor name for your sensor e.g. Living Room.

5. From the drop down box labelled Sensor select the Device Type, this will have a list Devices previously created.

6. In the input text box labelled Long Address enter the Long Address of your sensor module e.g 12:34:56:78:9A:BC:DE:F0

7. In the input text box labelled Short Address enter a short address using the following format and hex digits only e.g. FF:FE

8. Next from the Node Type drop down list select the sensor node type of the sensor module joined to the co-coordinator.

9. Dragging the Sensor Map Marker on the Map will fill in the Longitude and Latitude of your new sensor location.

10. Next Click the Add icon, this will add your new sensor module to your current project.

11. Next we need to configure our newly created Sensor.

12. From the Sensor Administration panel select the Sensor you want to configure and click the Edit icon.

13. High Alarm, If your Sensor function is ADC (Analogue-to-Digital Converter) then enter a High reading.

14. Low Alarm, If your Sensor function is ADC (Analogue-to-Digital Converter) then enter a Low reading.

15. If your Sensor's function is an Input or Output the High and Low Alarms levels are set accordingly.

16. High Alerts, Enable or Disable this option.

17. Low Alerts, Enable or Disable this option.

18. Voice Alerts, Enable this to receive Voice Alerts.

19. Email Alerts, Enable this to receive Email Alerts.

20. Text Alerts, Enable this to receive Text Alerts.

21. Heartbeat, Enable this option to have your sensor module monitor by our Heartbeat application.

22. When you are done you can click the Add icon to save any changes you may have made to the selected Sensor.

Notes:

The short address is used strictly at this point for reference, if you do not know the short address just enter an arbitrary one. When the sensor daemon receives a packet the short address will be updated to the short address contain within the packet. When Heartbeat is enable, if a sensor module fails to report within a 5 minute period a notification is sent.



Adding Rules Adding Rules

1. From the available menus select the Administration menu, then select the menu item Rules.

2. On the Rules Administration panel click the Add icon.

3. On the add Rules page you can configure your new rule.

4. From the drop-down list labelled Master Sensor, select the Master Sensor you will be creating the new rule for.

5. From the drop-down list labelled Slave Sensor, Select the Output Sensor your will be creating an action for.

6. Events control what triggers a action for the Slave Sensor.

7. Select the Master Sensor Event that will trigger the Slave Sensor.

8. Select the Action you want for the Slave Sensor, either turn on or turn off.

9. When you are done, click the Add icon to save your new rule.



Adding Users Adding Users

1. From the available menus select the Administration menu, then select the menu item Users.

2. From the Users Administration panel click the Add icon.

3. Enter a the new users First Name in the text input box labelled First Name.

4. Enter a the new users Last Name in the text input box labelled Last Name.

5. Enter a new Username in the text input box labelled Username.

6. Enter a new Password in the text input box labelled Password.

7. Enter the same Password into the text input box labelled Confirm.

8. Enter the new users Email Address, this will be used later for account verification and also sensor alerts.

9. In the text input box labelled Phone Number enter their 10 digit cell phone number.

10. Select their cell Phone Carrier, their cell phone number will be used later for account verification and also sensor alerts.

Notes:

When you first register as a new user you are granted the role of an administrator. Your only one restriction is you can only create a single project. However you can do almost anything else including adding new users. When creating a new user they will need to validate their information in the same process you did when you registered. New users created in this manner as opposed to registering will only be granted the User roles or permissions. Using this method to create new users allows others to view data within a project, receive text message or email alerts.



Sensor Graph Sensor Graph

1. Form the available menus select the Reports menu, then select the menu item Sensor Graph.

2. Select the Start Date and Time from the available controls.

3. Select the End Date and Time from the available controls.

4. Select the Sensor Device.

5. Next Click the Graph Icon.

This will generated a Graph of the sensor reading for the period you have selected.

Notes:

Red Graph areas show High Alarm that correspond to the High Alarm value entered in the sensor settings.

Blue Graph areas show Low Alarm that correspond to the Low Alarm value entered in the sensor settings.



Overlay Graph Overlay Graph

1. Form the available menus select the Reports menu, then select the menu item Overlay Graph.

2. Select the Start Date and Time from the available controls.

3. Select the End Date and Time from the available controls.

4. Next Click the Graph Icon.

Notes:

This will generated an overlay graph, you can click the corresponding check box to turn on or off individual Sensor series.



Math Graph Math Graph

1. Form the available menus select the Reports menu, then select the menu item Math Graph.

2. Select your Function from the available controls.

3. Select your Device from the available controls.

4. Select the Start Date and Time from the available controls.

5. Select the End Date and Time from the available controls.

6. Next Click the Math Graph Icon.

Notes:

This will generated a graph with the applied function that shows all sensors derived from this device.

This allows for the possible viewing of hundreds of sensors in a single view.



Summary Summary

1. Form the available menus select the Reports menu, then select the menu item Summary.

Notes:

This will display the following for each sensor in the current site, most recent Date, Time, Sensor, Device, Reading, Units and Battery Level.



Sensor Log Sensor Log

1. Form the available menus select the Reports menu, then select the menu item Sensor Log.

2. Select the Start Date and Time from the available controls.

3. Select the End Date and Time from the available controls.

4. Now Select the Sensor Device or leave the Sensor drop-down list set to All.

5. Next Click the Sensor Log Icon.

Notes:

This will display the sensor logs, the log can be exported in comma separated format (CSV) for latter use.



Event Log Event Log

1. Form the available menus select the Reports menu, then select the menu item Event Log.

2. Select the Start Date and Time from the available controls.

3. Select the End Date and Time from the available controls.

4. Now Select a Event from the drop-down or leave the Event drop-down list set to All.

5. Next Click the Log Event Icon.

Notes:

This will display the event logs, the log can be exported in comma separated format (CSV) for latter use.



Forgot Password Forgot Password

1. On the Sensor That Login page, click the Forgot Password link.

2. Enter your Username in the text box labelled Username.

3. Enter the generated Captcha code in the text box labelled Captcha.

4. Click the button labelled Submit.

5. You then should receive an email with a new Password.



Map Markers Map Markers

Project` Marker Project Marker

 • Project Map Marker.

Site Marker Site Map Marker

 • Site Map Marker.

Red Sensor Red Sensor

 • Indicates the sensor is in a High Alarm state or ON.

Green Sensor Green Sensor

 • Indicates the sensor reading is Normal.

Blue Sensor Blue Sensor

 • Indicates the sensor is in a Low Alarm state or OFF.



Packet XB92 Packet XB92

1. Under the label Destination IP enter the Destination IP Address 108.161.128.34.

2. Under the label Port enter the Port Number 10001.

3. Under the label Long Address enter the Long Address 0013A200404AB9E1.

4. Under the label Short enter the Short Address AF45.

5. Under the label Rec Opt enter the Receive Options 01.

6. Under the label Dig Mask enter the Digital Mask 04.

7. Under the label Dig Samp enter the Digital Sample 0004.

8. Under the label Analog Mask enter Analogue Mask 02.

9. Under the label Analog Samples enter the Analogue Sample 02990A00.

10. Touch the Send Packet button, you should then see the packet that was transmitted.

Notes:

The Android application Packet XB92 is for testing the Wireless Sensor Network Application Sensor That. This application employs Encryption and uses the Advanced Encryption Standard (AES) 256 Bit Encryption. Since the packets it sends are encrypted it will only function with the Wireless Internet Application Sensor That and related hardware.

The Android Application Packet XB92 simulates a sensor connected to the sensor network. Using the above settings will create a packet and send it to the Internet Application Sensor That this will update the sensor with the same Long Address in the demonstration project.

If your want to test further, you can register for an account and follow the instructions to create your own project and sensor. You will need to change the sensor's Long Address to one other then the one used above. This does not have to be an actual long address from a radio module, you can make one up at the time you add a new sensor to your project. With the only exception there cannot be a sensor with the same Long Address in any project in the system.

• ADC Function

If the sensor function is an ADC (Analogue-to-Digital Converter), the sensor reading can be affected by changing the first 4 hex digits of the Analogue Sample with a value between 0 and 03FF hexadecimal.

• Output Function

If the sensor function is an Output device, in the field labelled Digital Sample enter 0000 to turn Off the sensor or enter 0004 to turn On the sensor.

• Input Function

If the sensor function is an Input device, in the field labelled Digital Sample enter 0000 to get an Off reading or enter 0008 to get an On reading.

• Battery Voltage

The sensor's Battery Voltage reading can be affected by changing the last 4 hex digits of the Analogue Sample a value between 0 and 03FF hexadecimal. When entering a value at or below 2.8 Volts or 0956 hexadecimal, a low battery notification will be generated.