Advertisement

Quick Links

 
 
RootMeBaby User Guide 
 
 
 
 
 
 
 
aconno GmbH 
 
 
 
 
 
 
 
 
 
 
 

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the RootMeBaby and is the answer not in the manual?

Questions and answers

Summary of Contents for aconno RootMeBaby

  • Page 1 GmbH      RootMeBaby User Guide                                     ...
  • Page 2: Table Of Contents

    1. Introduction 3  1.1 Assembly 3  2. Device Connection 3  3. Access Configurations 4  4. Change router’s name and password 5  4.1 Change router’s name or password 5  5. Change device IP address 7  5.1 DHCP 7  5.2 Static IP 9  6. Configuring MQTT 11  6.1 Configure MQTT Fields 11  6.2 Configure MQTT Body Field 13  6.2.1 Simple Configuration 13  6.2.2 Name­Value Configuration 17  6.3 Variables 33  6.3.2 Acn Sensa 33  7. Deserializers 33  8. Scanning 36           ...
  • Page 3: Introduction

        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.         ...
  • Page 4: Access Configurations

        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.               ...
  • Page 5: Change Router's Name And Password

    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.       ...
  • Page 6          ...
  • Page 7: Change Device Ip Address

    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.       ...
  • Page 8        ...
  • Page 9: Static Ip

    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.                   ...
  • Page 10      ...
  • Page 11: Configuring Mqtt

        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               ...
  • Page 13: Configure Mqtt Body Field

                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:  Temperature­6,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.           ...
  • Page 15                ...
  • Page 16      ...
  • Page 17: Name­value Configuration

                6.2.2 Name­Value 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.     ...
  • Page 20                ...
  • Page 21    ...
  • Page 22                ...
  • Page 23        ...
  • Page 24        ...
  • Page 25                  ...
  • Page 26        ...
  • Page 27          ...
  • Page 28        ...
  • Page 29        ...
  • Page 30            ...
  • Page 31      ...
  • Page 32              ...
  • Page 33: Variables

    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.           ...
  • Page 35              ...
  • Page 36: Scanning

    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 1­2 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.           ...
  • Page 37          ...
  • Page 38      ...

Table of Contents