Gateway registration


User guide for setting up basic hardware synchronization and user credentials.

  1. Service Administrator
  2. Users
  3. Gateway Registration

Service Manager


Signing in and Usage

  • Currently requires purchasing compatible hardware and an installation using the Thing+ portal. Please, contact iot@daliworks.net for details.
  • Hardware for IoT service
    • Hardware refers to the sensors/devices/etc.. used in your IoT service installation
    • Currently supported Hardware List enabling Thing+ access off the shelf
  • Are you a hardware maker or planning to create new IoT hardware?
    • Please mail us at hw@daliworks.net if you would like to enable Thing+ synchronization with your hardware.
  • Open / Open-Source Hardware that can be used with Thing+ IoT services



For Users


Signing into the Thing+ portal

  • Put your service address in your internet browser address bar.

  • Push on top to get to the Sign In page.
  • Input your ID, e-mail(2 times for confirmation), passwords (2 times as well), and agree to the access terms. You should see a “registration success” message.
  • You should promptly receive an e-mail on your registered e-mail address for confirmation.
  • Click on the e-mail confirmation and the registration process is complete.

Sign up and Authorization progress for service administrators

  • Similarly to users, go to iot.thingplus.net and register using your email.
  • After confirmation of your e-mail, follow the included sign up instructions.
  • You should get a confirmation e-mail after authorization from your service manager.
  • It will take a few seconds to minutes for authorization as the data populates through our system. If you did not receive any e-mail, please:
    • Check that your entered email address is correct.
    • Check your spam mail box and trash.
  • After receiving confirmation, enter your ID and Password to log in.



Gateway Registration

If you DO NOT have any devices, you can register a virtual gateway at the Thing+ Portal by using Sensor Simulator.


This Guide is written for BeagleBone Green & Raspberry Pi 2, but most devices should follow a similar procedure.

If you DID NOT install the Thing+ Embedded Package on your Raspberry Pi/BeagleBone Green, please refer to the following:

In the case of raspberry pi & Arduino, the Raspberry Pi is a “Gateway” and Arduino is a “Device”.



1) Go to the scriptsdirectory of the directory where your Thing+ Embedded package was installed.

For BeagleBon Black/Raspberry Pi 2 / Edison어 / Beaglebone Air

  • Connect to your device over SSH and go to the scripts directory

    @shell:$ cd /opt/thingplus/gateway/scripts
    

For Arduino

  • Go to the scripts directory on your PC

    @shell:$ cd $HOME/thingplus/gateway/scripts
    


2) Get the Gateway ID of the device and copy it to the clipboard.

@shell:$ ./getGatewayID.sh
Your Gateway ID is as below
xx:xx:xx:xx:xx:xx


3) Open the web browser on YOUR PC and sign into the “Service Website”.

  • We recommend you use Chrome(Link)


4) Click the Settings button and then the Gateway Management button. gateway_management


5) Click the (+) button. register_gateway


6) Click the Request for Gateway Certificates or API Key button. register_with_apikey


7) Choose the Gateway Model you are using

For Raspberry Pi: Raspberry Pi - Developer

select_gateway_model_pi

For Raspberry Pi + Camera: Open Source Gateway

select_gateway_model_open

For BeagleBone Green어/Beaglebone Air: BeagleBone Green - Developer

select_gateway_model_bbg

For Arduino: Arduino, PC - Developer

select_gateway_model_Arduino

For Edison: Edison Kit for Arduino

select_gateway_model_Edison


8) Input the MAC address you copied to the Gateway ID form and click the Get API Key button. macaddress


9) Copy the generated API Key into the below green box. get_apikey


10) Run Thing+ Gateway S/W with the following commands on the terminal connected to your device.

Notice: In case of the ‘Copied API Key’, it should be in-between Single Quotation Marks(‘), eg. 'copied_api_key'.

For Raspberry Pi

@shell:$ sudo su
@shell:$ cd /opt/thingplus/openhardware/raspberrypi/grovePi-starter-kit
@shell:$ ./thingplus_device.sh start
@shell:$ cd /opt/thingplus/gateway
@shell:$ APIKEY='copied_api_key' ./thingplus.sh start

For Raspberry Pi with Camera module

@shell:$ sudo su
@shell:$ cd /opt/thingplus/openhardware/raspberrypi/camera
@shell:$ ./thingplus_device.sh start
@shell:$ cd /opt/thingplus/gateway
@shell:$ APIKEY='copied_api_key' ./thingplus.sh start

For Raspberry Pi + Arduino

@shell:$ sudo su
@shell:$ cd /opt/thingplus/openhardware/arduino/grovePi-starter-kit
@shell:$ ./thingplus_device.sh start
@shell:$ cd /opt/thingplus/gateway
@shell:$ APIKEY='copied_api_key' ./thingplus.sh start

For BeagleBone Green

@shell:$ cd /opt/thingplus/openhardware/beaglebonegreen/grove-starter-kit
@shell:$ ./thingplus_device.sh start
@shell:$ cd /opt/thingplus/gateway
@shell:$ APIKEY='copied_api_key' ./thingplus.sh start

For BeagleBone Air

@shell:$ cd /opt/thingplus/openhardware/bba/grove-starter-kit
@shell:$ ./thingplus_device.sh start
@shell:$ cd /opt/thingplus/gateway
@shell:$ APIKEY='copied_api_key' ./thingplus.sh start

For Arduino (Mac PC)

@shell:$ cd $HOME/thingplus/openhardware/arduino/grove-starter-kit
@shell:$ ./thingplus_device.sh start
@shell:$ cd $HOME/thingplus/gateway
@shell:$ APIKEY='copied_api_key' ./thingplus.sh start

For Arduino (Windows PC)

@shell:$ cd $HOME/thingplus/openhardware/arduino/grove-starter-kit
@shell:$ ./thingplus_device.sh start
@shell:$ cd $HOME/thingplus/gateway
@shell:$ APIKEY='copied_api_key' ./thingplus.bat start

For Edison

@shell:$ cd /opt/thingplus/openhardware/edison/grove-starter-kit
@shell:$ ./thingplus_device.sh start
@shell:$ cd /opt/thingplus/gateway
@shell:$ APIKEY='copied_api_key' ./thingplus.sh start

remark : When rebooting the device, automatically launch/run is not available now. After rebooting, you must type the below commands.

@shell:$ cd /opt/thingplus/openhardware/edison/grove-starter-kit
@shell:$ ./thingplus_device.sh start
@shell:$ cd /opt/thingplus/gateway
@shell:$ ./thingplus.sh start


11) Open the /ect/rc.local file and add the below 2 lines right ahead of the exit 0 line.

  • If you are an Arduino user, you can SKIP THIS SECTION. Please Move to next.

Notice: You MUST use arrow buttons on your keyboard, when you want to move the cursor

For Raspberry Pi

@shell:$ sudo nano /etc/rc.local
...
(cd /opt/thingplus/openhardware/raspberrypi/grovePi-starter-kit; ./thingplus_device.sh restart)
(cd /opt/thingplus/gateway; ./thingplus.sh restart)


exit 0
  • Press CTRL-O and Enter to overwrite the changes and press CTRL-X to close the file you’ve modified.

For Raspberry Pi (with camera module)

@shell:$ sudo nano /etc/rc.local
...
(cd /opt/thingplus/openhardware/raspberrypi/camera; ./thingplus_device.sh restart)
(cd /opt/thingplus/gateway; ./thingplus.sh restart)


exit 0
  • Press CTRL-O and Enter to overwrite the changes and press CTRL-X to close the file you’ve modified.

For BeagleBone Green

@shell:$ nano /etc/rc.local
...
(cd /opt/thingplus/openhardware/beaglebonegreen/grove-starter-kit; ./thingplus_device.sh restart)
(cd /opt/thingplus/gateway; ./thingplus.sh restart)    

exit 0
  • Press CTRL-O and Enter to overwrite the changes and press CTRL-X to close the file you’ve modified.

For BeagleBone Air

@shell:$ nano /etc/rc.local
...
(cd /opt/thingplus/openhardware/bba/grove-starter-kit; ./thingplus_device.sh restart)
(cd /opt/thingplus/gateway; ./thingplus.sh restart)    

exit 0
  • Press CTRL-O and Enter to overwrite the changes and press CTRL-X to close the file you’ve modified.

For Raspberry Pi + Arduino

@shell:$ nano /etc/rc.local
...
(cd /opt/thingplus/openhardware/arduino/grove-starter-kit; ./thingplus_device.sh restart)
(cd /opt/thingplus/gateway; ./thingplus.sh restart)    

exit 0
  • Press CTRL-O and Enter to overwrite the changes and press CTRL-X to close the file you’ve modified.


12) Click the Register Gatewaybutton. copy_apikey


13) Input your gateway name to Gateway Name form. input_gateway_name


14) Choose a Device Model.

For Raspberry Pi 2: GrovePi+ Starter Kit

select_devicemodel

For Raspberry Pi 2: Grove Starter Kit forArduino

select_devicemodel

For Raspberry Pi 2: With Camera module

select_devicemodel

For BeagleBone Green/Beaglebone Air: Grove Starter Kit for BeagleBone Green

select_devicemodel

For Arduino: Grove Kit

select_devicemodel

For Edison: Grove Starter Kit for arduino

select_devicemodel


15) Choose a Site for this gateway to be added to, and then, click the Register a Gateway, Devices and Sensors button. register


16) You can see the Success popup message when the registration is completed


17) You can see the registred Gateway from the Sensor List Menu

  • Sensor(s) are registered automatically by the Gateway(BeagleBone Black / Raspberry Pi 2) within 1 minute after you complete registering your gateway
  • Values from your Sensor are periodically aggregated and delivered to the Thing+ Cloud by the Thing+ Gateway Software. You can see the values from Thing+ Portal after several minutes usually.