The purpose of this document is to show how to use and configure “RootMeBaby”. It will guide the user from accessing the device, to configuring the information storage endpoints, scanning format and message formatting. ● Changing router name and password ● Changing BLE to cloud configurations ● Configuring network ● Changing Deserializers ● Starting scanning process 1.1 Assembly Please mount the antenas on the side of the device. Insert the provided BLE adapter into the USB port and power the device by connecting the white cable to micro USB port in the device. 2. Device Connection To connect to the router: A. Please click on your wireless connection icon. B. After clicking the icon you will see a list of wireless devices. C. Select the router with the name “RootMeBaby”. D. After selecting the router a small window prompting will be shown prompting for the password. In this window insert “!aconno!” E. Press the OK(depending on the OS it might be Join, OK or else) button. F. Now you are successfully connected to the device. ...
3. Access Configurations To access the configuration window: A. Open a browser of your choice (Firefox or Chrome are suggested, do not use IE). B. In the address bar insert the following “192.168.8.1” and press enter. C. You will be soon shown a page requesting a password. D. In the password field insert the password “!aconno!” and click the Login button. E. After this you are inside the router configuration page. ...
4. Change router’s name and password 4.1 Change router’s name or password ● After accessing the main configuration page, you will see a horizontal menu with icons and descriptions. ● In the horizontal menu click on Settings. ● You will be shown a vertical menu with six icons and descriptions. ● Click on the second icon from the top, which looks like the image below ● In the right of “Wireless Status” you will see two buttons “Settings” and “LAN IP” ● Click on button “Settings”. ● To Change the name, change the SSID field on the small window and then click on Submit button. ● To Change the name, change the SSID field on the small window and then click on Submit button. ● To Change the password, change the password field on the small window and then click on Submit button. ● Now the name of your wifi has changed. ...
5. Change device IP address 5.1 DHCP ● After accessing the main configuration page, you will see a horizontal menu with icons and descriptions. ● In the horizontal menu click on Settings. ● You will be shown a vertical menu with six icons and descriptions. ● Click on the first icon from the top, which looks like the image below ● In the right of “Internet Status” you will see two buttons “New Connection”, “Clone MAC” and “Custom DNS” ● Click on button “New Connection”. ● On Protocol field select DHCP and click Submit. ● Now your IP will be set via DHCP. ...
5.2 Static IP ● After accessing the main configuration page, you will see a horizontal menu with icons and descriptions. ● In the horizontal menu click on Settings. ● You will be shown a vertical menu with six icons and descriptions. ● Click on the first icon from the top (The same as in 5.1). ● In the right of “Internet Status” you will see two buttons “New Connection”, “Clone MAC” and “Custom DNS” ● Click on button “New Connection”. ● On Protocol field select Static and fill the other fields shown. ● Click on Submit ● Now your new IP is set. ...
6. Configuring MQTT 6.1 Configure MQTT Fields ● In the horizontal menu click on BLE2Cloud. ● In the protocol section select MQTT, you will be shown the mqtt configuration fields. ❏ Broker Stands for the url or the ip of your mqtt broker ❏ Port Stands for the port in which your broker can be accessed. ❏ Topic Stands for the topic in which you want the deserialized advertisement to be published. ❏ ClientID Your identification when publishing to the broker. ❏ Username The username needed from the MQTT broker. ...
Page 12
❏ Password The password needed from the MQTT broker. ❏ Quality Mqtt publishing quality. ❏ Body The format in which your advertisement will be sent. Check section 6.2 After changing the fields press button Save located in the top of the page. In the configuration we use variables in form $name which we replace by its belonging value. In the fields above you can use the variable $mac which will be replaced by the devices mac address. In this way you can distinguish different sensors by having them write to different topics e.g. /acme/sensors/AA:BB:CC:DD:EE:FF/Temperature=12 ...
6.2 Configure MQTT Body Field The text in the mqtt body will ultimately be sent to the mqtt broker. So if for example the text in the mqtt body is “SENSOR FOUND”, every time the router recognizes a known advertisement (by comparing it to the deserializers), the text “SENSOR FOUND” will be sent to the mqtt broker. Following this there are two ways to send the sensor data. 6.2.1 Simple Configuration In the configuration we use variables in form $fieldname which we replace by its belonging value. That means that writing a text inside the body all $fieldname occurences will be replaced similar to search and replace in a word processor by its belonging value. e.g. $Temperature will be replaced by 12 if at that moment the sensor measures 12 degrees celsius and sends it to the gateway. ...
Page 14
You can find all the variables of the beacons in section 6.3. The following examples will have: Temperature = 6 Humidity = 0.7 Light = 0.5 Ex .1 Datastring: Temperature$Temperature,OtherVal=$Light $Humidity Result: Temperature6,OtherVal=0.5 0.7 Ex. 2 Datastring: {“Temperature”:”$Temperature”,”Light”:”$Light”,”Humidity”:$Humidity} Result: {“Temeperature”:”6”,”Light”:”0.5”,”Humidity”:0.7} Important! If checkbox “ ” is checked, and there are D o not send if contains unsubstituted $ unsubstituted “$variables” found in the body, then the message will not be delivered to the mqtt broker. ...
6.2.2 NameValue Configuration If you insert “$name” or “$value” in the mqtt body textfield then “$name” will be replaced with the name of each sensor that will be matching the deserializers. Meanwhile $value will be replaced with the value of each sensor matched by the deserializers. Also 3 new fields will be shown: Data Type Specifies whether the data will be sent as Json or Text Send As Specifies whether the data will be sent as an Array or Concatenated Divider Works only “Concatenated” is selected for “Send As”. When concatenating the rows the text found in this field will be in between each concatenation. If the divider is \n then it will be replaced with a new line during concatenation. ...
Page 18
If the divider is \t then it will be replaced with a tab space during concatenation. Important! When data type is JSON, Send As is automatically set to array and divider is empty. Important! When send as is Array, divider is not used The following examples will have: Temperature = 6 Humidity = 0.7 Light = 0.5 Ex 1 Data Type: JSON Data String: {"$name":"$value"} Result: [ {" T emperature " :"6"}, {" H umidity " :"0.7"}, {" L ight " :"0.5"} ] ...
Page 19
Result: [" 200,Temperature,result,6,"," 200,Humidity,result,0.7,"," 200,Light,result,0.5,"] Ex 4) Data type: Text Send As: Concatenated Divider = % Body: 200,$name,result,$value, Result: 200,Temperature,result,6,%200,Humidity,result,0.7,%200,Light,result,0.5, Ex 5) Data type: Text Send As: Concatenated Divider: \n Body: 200,$name,result,$value, Result: 200,Temperature,result,6, 200,Humidity,result,0.7, 200,Light,result,0.5, Important! If checkbox “ ” is checked, and there are D o not send if contains unsubstituted $ unsubstituted $variables found in the body, then the message will not be delivered to the mqtt broker. Important! If $name/$value is present in the body, except for $mac, no other $variable can be inserted. In the case that both $name/$value and $variable is found then the user will not receive any advertisement. ...
6.3 Variables 6.3.2 Acn Sensa Temperature: $Temperature Humidity: $Humidity Pressure: $Pressure Light: $Light Battery Level: $Battery_Level Gyroscope X: $Gyroscope_X Gyroscope Y: $Gyroscope_Y Gyroscope Z: $Gyroscope_Z Accelerometer X: $Accelerometer_X Accelerometer Y: $Accelerometer_Y Accelerometer Z: $Accelerometer_Z Magnetometer X: $Magnetometer_X Magnetometer X: $Magnetometer_Y Magnetometer X: $Magnetometer_Z Accelerometer Scale Factor: $Accelerometer_Scale_Factor 7. Deserializers A deserializer is a collection of settings that tells the gateway how to read and interpret binary data and assign them to names which later can be used as variables. The BLE2Cloud page contains a section for adding, deleting or modifying deserializers. To add a deserializer go to the deserializer section in the BLE2Cloud page. Under “Add” there is a textarea where you can insert the deserializer. On the right you can find the field name, which will represent the name of the deserializer. After filling both deserializer ...
Page 34
textarea and name textfield press the button Add. The deserializer now is stored temporarily. The deserializer should be showing on the list below, under the “Add” section. To store the deserializer permanently press the button Save which is located in the top of the page. To modify a deserializer go to the deserializer list under the “Add” section. Press button edit on which is located the same row of the deserializer you want to edit. A popup will be shown with your current deserializer. After making changes now deserializer is temporarily changed. To change the deserializer permanently, click on Save button, which located on the top of the page. To modify a deserializer go to the deserializer list under the “Add” section. Press button delete located on the same row of the deserializer you want to delete. Now your deserializer is temporarily deleted and not showing on the list. To delete the deserializer permanently click on save button located on the top of the page. ...
8. Scanning The first section of the BLE2Cloud page contains scanning. The “status” label indicates whether the “RootMeBaby” is currently scanning or not scanning. When the router is Scanning you will see below this status a button which allows you to stop scanning. After pressing the button “Stop” the device will stop scanning and will change the status. Contrary to this when the device is not scanning the you will see a “Start” button. After pressing the button, wait 12 seconds. The status will change to “Scanning” while the button will change to “Stop”. After the deserializers or the mqtt fields are changed you need to stop and start service for this changes to be effective. The Start on boot indicates whether the scanning service will start on boot. If you see this label as Enabled it means that the scanning service will start after the device has been booted. Also button “Disable” will be shown. After pressing the Disable, the scanning service will not be run after device boot, the label will change to disable and the you will see an Enable button. After you click on Enable, the start of the scanning service on boot will be enabled, the label will change to Enabled and the you will see a Disable button. ...
Need help?
Do you have a question about the RootMeBaby and is the answer not in the manual?
Questions and answers