# Quick Start
# 1 Add a new device
For getting started on DeviceBit platform, the first step is to add a new device.
Log into the IOT platform (If you don’t have the account you need to sign up first).
Sign up a DeviceBit Account ([www.devicebit.com](/www.devicebit.com))
![](https://leweidoc.oss-cn-hangzhou.aliyuncs.com/lewei50/img/devicebitmanual-xj-20180930-1.jpg)
Pic.1 Sign Up
As shown in Pic2, go to ***My Devices -> Devices -> Add A device***, fill in the information and then save.
![](https://leweidoc.oss-cn-hangzhou.aliyuncs.com/lewei50/img/devicebitmanual-xj-20180930-2.jpg)
Pic.2 Create a new device
# 2 Add sensors & controllers
The next step is to add a new sensor or controller connected to your device.
## 2.1 Add a new sensor
As shown in Pic3, go to ***My Devices -> Sensors&Controllers ->Sensors, ***and then click on ***Add*** button to create a new sensor.
![](https://leweidoc.oss-cn-hangzhou.aliyuncs.com/lewei50/img/devicebitmanual-xj-20180930-3.jpg)
Pic.1 Add a new sensor
![](https://leweidoc.oss-cn-hangzhou.aliyuncs.com/lewei50/img/devicebitmanual-xj-20180930-4.jpg)
# 3 Data Upload Simulation
This tutorial mainly introduces how to simulate data upload by using API testing tool.
**Hardware**
No hardware is required. Only simulate data upload by API testing tool provided by Devicebit platform.
**Procedure:**
1 Sign up a DeviceBit Account ([www.devicebit.com](/www.devicebit.com))
![](https://leweidoc.oss-cn-hangzhou.aliyuncs.com/lewei50/img/devicebitmanual-xj-20180930-1.jpg)
Pic.2 Sign Up
## 3.1 Add My Device, Sensors: Humidity and Temperature
(The steps are as follows. Note: note down the ID, for it will be used in Api calling.)
## 3.2 Add A Device
After login, go to My Devices -> Devices->Add a Device
First, click on Devices -> Add A Device , as the picture1 below. After entering the related information, click on Save.
![](https://leweidoc.oss-cn-hangzhou.aliyuncs.com/lewei50/img/devicebitmanual-xj-20180930-2.jpg)
## 3.3 Add Humidity
The next step is to add the humidity sensor. Go to**My Devices-> Sensors&Controllers->Sensor**, click on **Add**.
![](https://leweidoc.oss-cn-hangzhou.aliyuncs.com/lewei50/img/devicebitmanual-xj-20180930-3.jpg)
Pic.3 Sensors
Then there will be the ***Add A Sensor*** page.
![](https://leweidoc.oss-cn-hangzhou.aliyuncs.com/lewei50/img/devicebitmanual-xj-20180930-7.jpg)
Pic.4 Add Humidity
## 3.3 Add Temperature
Add the ***Temperature*** sensor in the same way. Please see the following picture.
![](https://leweidoc.oss-cn-hangzhou.aliyuncs.com/lewei50/img/devicebitmanual-xj-20180930-8.jpg)
Pic.5 Add Temperature
After setting up, as picture 5 shows, note down the ***ID*** because it will be used in Api calling.
![](https://leweidoc.oss-cn-hangzhou.aliyuncs.com/lewei50/img/devicebitmanual-xj-20180930-9.jpg)
Pic.6 Sensor ID
## 3.4 Data Simulation
Now, let's move on to simulate data upload by using Api testing tool.
At the home page (the website is www.devicebit.com) click on ***Documentation***
![](https://leweidoc.oss-cn-hangzhou.aliyuncs.com/lewei50/img/devicebitmanual-xj-20180930-1.jpg)
Pic.7 Home Page
and then go to **API Directory-> Sensor ->Upload Sensor Data**
![](https://leweidoc.oss-cn-hangzhou.aliyuncs.com/lewei50/img/devicebitmanual-xj-20180930-10.jpg)
Pic.8 API Directory
Website
https://www.devicebit.com/dev/apitest/203
![](https://leweidoc.oss-cn-hangzhou.aliyuncs.com/lewei50/img/devicebitmanual-xj-20180930-11.jpg)
Pic.9 On-line test
Click on ***on-line test***
![](https://leweidoc.oss-cn-hangzhou.aliyuncs.com/lewei50/img/devicebitmanual-xj-20180930-12.jpg)
Pic.10 API Testing Tool
Enter your **Userkey**
Enter ***Device ID*** at API URL
http://www.devicebit.com/api/V1/gateway/UpdateSensors/{device ID}
[(01 for exampe)](http://www.lewei50.com/api/V1/gateway/UpdateSensors/%E4%BD%A0%E7%9A%84%E7%BD%91%E5%85%B3%E5%8F%B7)
After entering the device ID, the APIURL is: http://www.devicebit.com/api/V1/gateway/UpdateSensors/01
![](https://leweidoc.oss-cn-hangzhou.aliyuncs.com/lewei50/img/devicebitmanual-xj-20180930-13.jpg)
Pic.11 Userkey & Device No.
Change ***T1*** to ***Temperature*** for ***Name***; change ***1*** to ***32*** for **Value***;
Change ***01H1*** to ***Humidity*** for ***Name***; change ***96.2*** to ***75*** for ***Value***.
![](https://leweidoc.oss-cn-hangzhou.aliyuncs.com/lewei50/img/devicebitmanual-xj-20180930-14.jpg)
Pic.12 Post Data
Click on ***Run***, and then the request detail will be displayed.
![](https://leweidoc.oss-cn-hangzhou.aliyuncs.com/lewei50/img/devicebitmanual-xj-20180930-15.jpg)
Pic.13 Request Detail
At last, Go to ***My IOT -> Sensors&Controllers->Sensor List***, you will see the following value.
![](https://leweidoc.oss-cn-hangzhou.aliyuncs.com/lewei50/img/devicebitmanual-xj-20180930-16.jpg)
Pic.14 The Value
Well Done! Your data upload is successfully simulated by using API testing tool!
The following part will introduce how to set Notice Groups, and receive email alerts
# 4 Alert
The following part will introduce how to set Notice Groups, and receive email alerts.
# 4.1 Add A New Contact
Click on Notice Groups -> Contacts -> New Contact
![](https://leweidoc.oss-cn-hangzhou.aliyuncs.com/lewei50/img/devicebitmanual-xj-20180930-17.jpg)
Enter the name, Email etc. of this contact and then click on Save.
![](https://leweidoc.oss-cn-hangzhou.aliyuncs.com/lewei50/img/devicebitmanual-xj-20180930-18.jpg)
Add more contacts in the same way.
![](https://leweidoc.oss-cn-hangzhou.aliyuncs.com/lewei50/img/devicebitmanual-xj-20180930-19.jpg)
# 4.2 Add A New Group
Go to Notice Groups -> Add Group
![](https://leweidoc.oss-cn-hangzhou.aliyuncs.com/lewei50/img/devicebitmanual-xj-20180930-20.jpg)
Enter the group name, tick the contacts, and save.
![](https://leweidoc.oss-cn-hangzhou.aliyuncs.com/lewei50/img/devicebitmanual-xj-20180930-21.jpg)
![](https://leweidoc.oss-cn-hangzhou.aliyuncs.com/lewei50/img/devicebitmanual-xj-20180930-22.jpg)
# 4.3 Alarm Settings
Go to List, and click on Edit.
![](https://leweidoc.oss-cn-hangzhou.aliyuncs.com/lewei50/img/devicebitmanual-xj-20180930-23.jpg)
![](https://leweidoc.oss-cn-hangzhou.aliyuncs.com/lewei50/img/devicebitmanual-xj-20180930-24.jpg)
Set the normal temperature range for your device and select the notice group, e.g. the Temperature group which is just set.
Then, set the normal humidity range in the same way.
Then, click on Save and the settings are successfully saved. Please remember the ID of the sensors (H1, T1), for they will be used in the following calling step.
![](https://leweidoc.oss-cn-hangzhou.aliyuncs.com/lewei50/img/devicebitmanual-xj-20180930-25.jpg)
After settings, simulate data upload as the last chapter mentioned.
![](https://leweidoc.oss-cn-hangzhou.aliyuncs.com/lewei50/img/devicebitmanual-xj-20180930-26.jpg)
Meanwhile, you will receive the following alarms by Email.
![](https://leweidoc.oss-cn-hangzhou.aliyuncs.com/lewei50/img/devicebitmanual-xj-20180930-27.jpg)
- QuickStart
- 1 Upload Data
- 2 DIY WiFi Temperature Sensor
- 3 Modbus
- User Manual
- 1 Add A Device
- 2 Add a new sensor or controller
- 3 Data Upload Simulation
- 4 Email Alert
- 5 Data Reports
- 6 Account Settings
- 7 Email Auto-sending
- 8 Email Report
- 9 Control Scheme
- 10 Trigger
- 11 MQTT
- 12 Agent
- 13 Credits
- 14 Access Tools
- Software Access Tools
- 1 Serial to TCP Software (@Windows)
- 2 Serial to TCP Software Chrome APP