Add TA652FH-W to ThingsBoard

Tip

  • This section applies to the situation where you add TA652FH-W to ThingsBoard Server.
  • If you are adding the first Avantec HVAC device to ThingsBoard Server, please refer to Get Started.

Step 1. Tenant Login

../../_images/tenant-login-11.png

Tenant default username and password, refer to Some important parameters.

Step 2. Import Detail Dashboard of TA652FH-W

See Import TA652FH-W Detail Dashboard.

Step 3. Import List Dashboard of TA652FH-W

See Import TA652FH-W List Dashboard.

Step 4. Provision TA652FH-W device

Step 4.1 Add device

  • Devices –> + –> Add new device –> Popup Dialog –> Input Name, Label & Description, select device profile –> Add.
../../_images/add-device-11.png
Field Value
Name* My device name, e.g. TA652FH-W-TB, A8:48:FA:57:D5:20
Device profile* TA652FH-W Thermostat
Label My device label, e.g. Avantec Manufacturing Plant
Description My device description, e.g. A Thermostat for floor-heating

Note

The field with * must be filled in.

  • Now my device should be listed first, since the table sort devices using the time of the creation by default.
../../_images/add-device-21.png

Step 4.2 Add shared attributes of new device

  • Devices –> Click my device –> Attributes –> Shared attributes –> + –> Popup Dialog –> Input Key, Value type & value –> Add
../../_images/add-shared-attributes-11.png

Please add the following Shared attributes of TA652FH-W:

Add shared attributes of TA652FH-W
Key* Value Type* Value* Memo
uploadFreq Integer 300 5*60. Telemetry per uploadFreq seconds
uploadThreshold Double 1.5 1.5°C. If the temprature (Telemetry data)
change exceeds it, upload immediately!
syncTimeFreq Integer 86400 24*3600. Sync time per syncTimeFreq seconds
timezone Integer 480 Please replace with your value.
The time offset from UTC, minutes.
For example Hongkong is UTC+8:00 time
zone, this offset is 480 minutes (8*60)
timeNTPServer String pool.ntp.org SNTP Server URL, e.g. pool.ntp.org,
0.pool.ntp.org, 1.pool.ntp.org,
uk.pool.ntp.org, hk.pool.ntp.org,
time.nist.gov, …

Note

The field with * must be filled in.

  • Now the shared attributes of my device is like:
../../_images/add-shared-attributes-21.png
You may also use:
  • Bulk provisioning to provision multiple devices from a CSV file using UI.
  • Device provisioning to allow device firmware to automatically provision the device, so you don’t need to configure each device manually.
  • REST API to provision devices and other entities programmatically.

Step 5. Connect TA652FH-W device

Step 5.1 Copy credentials of new device

To connect the device you need to get the device credentials first. ThingsBoard supports various device credentials. We recommend using default auto-generated credentials which is access token for this guide.

  • Devices –> Manage credentials (icon) –> Popup Dialog –> Select Access Token, Ctrl + C.
../../_images/copy-credentials1.png

Tip

The Credentials (Access Token), which you need to use when you’re configuring your hardware, for example, j9JiCkID9E7uE1WhKxnc, lMTQLZ7VSRQSD7ls.

Step 5.2 Connect device to ThingsBoard

See Connect TA652FH-W to ThingsBoard.

Step 5.3 Publish data to ThingsBoard

Now your device has already published telemetry data to ThingsBoard. You should immediately see them in the Device Telemetry Tab:

../../_images/publish-data-to-thingsboard-11.png

Step 6. Assign Device and Dashboards to Customer

One of the most important ThingsBoard features is the ability to assign Dashboards to Customers. You may assign different devices to different customers. Then, you may create a Dashboard(s) and assign it to multiple customers. Each customer user will see his own devices and will not be able to see devices or any other data that belongs to a different customer.

Refer to Step 7.1 Create customers, Step 7.4 Create customer user & Step 7.5 Activate customer user.

Step 6.1 Assign dashboards of TA652FH-W to Customer

  • Assign Detail dashboard to Customer: Dashboards –> Click Manage assigned customers (icon) in Detail dashboard line –> Popup Dialog –> Select My New Customer –> Update.
../../_images/assign-dashboards-to-customer-11.png
  • Assign List dashboard to Customer: Dashboards –> Click Manage assigned customers (icon) in List dashboard line –> Popup Dialog –> Select My New Customer –> Update.
../../_images/assign-dashboards-to-customer-21.png
  • It’s like this now.
../../_images/assign-dashboards-to-customer-31.png

Step 6.2 Assign TA652FH-W device to Customer

  • Devices –> Click Assign to customers (icon) in My New Device line –> Popup Dialog –> Select My New Customer –> Assign.
../../_images/assign-device-to-customer-11.png
  • It’s like this now.
../../_images/assign-device-to-customer-21.png

Step 7. Open Dashboards of TA652FH-W

  • You are logged in as a Customer User or a Tenant user.
  • Dashboards –> click my list dashboard
../../_images/open-dashboard-11.png
  • Select my device –> Settings (icon)
../../_images/open-dashboard-21.png
  • Switch page –> Operation
../../_images/open-dashboard-31.png

See TA652FH-W Demo Dashboards Usage.

Your feedback

Don’t hesitate to star Avantec on github to help us spread the word.