Cassia X1000 User manual

platform: Ubuntu 16.04.3 LTS device: X1000_TKR03FL language: Python
Connect X1000_TKR03FL device to your
Azure IoT services
Table of Contents
•Introduction
•Prerequisites
•Prepare the Device
•Connect to Azure IoT Central
•Integration with Azure IoT Explorer
•Additional Links
Introduction
About this document
This document describes how to connect X1000_TKR03FL to Azure IoT Hub using the Azure IoT Explorer with
certified device application and device models.
IoT Plug and Play certified device simplifies the process of building devices without custom device code. Using
Solution builders can be integrated quickly using the certified IoT Plug and Play enabled device based on Azure
IoT Central as well as third-party solutions.
This getting started guide provides step by step instruction on getting the device provisioned to Azure IoT Hub using
Device Provisioning Service (DPS) and using Azure IoT Explorer to interact with device's capabilities.
X1000_TKR03FL is device combined with Cassia Networks™X1000 Enterprise Bluetooth Gateway and TKR03FL (IP67
compliant) BLE liquid temperature data logger measurable wirelessly from -40 to 125 degrees C and floatable on liquid
inside a tank. The Cassia Networks X1000 is the most reliable long-range Bluetooth gateway for demanding and outdoor
enterprise Bluetooth IoT applications. It extends Bluetooth’s range up to 1000 feet and enables remote control of 22
Bluetooth low power devices (and 100’s in broadcast mode) without requiring changes to end devices. X1000
enterprise Bluetooth gateway delivers cost-effective connectivity to demanding indoor/outdoor enterprise Bluetooth IoT
environments. It supports Power over Ethernet (PoE) with power received from the uplink Ethernet port. It attaches to a
pole or wall with an included mounting kit, or it can be placed on a flat space. The weather-proof, IP65-rated X1000 is
ideal for manufacturing facilities, school and corporate campuses, shipyards and outdoor plant facilities.
By combining the X1000 Cassia Gateway with high signal reception sensitivity and the TKR03FL liquid temperature data
logger with a long battery life (2 years or more), we can provide solutions such as a liquid temperature monitoring for the
brewery. You can use it without worrying about battery replacement even in long-distance usage scenes or in
environments where radio waves are difficult to reach.

Figure 1: Liquid temperature monitoring system
Prerequisites
You should have the following items ready before beginning the process:
For Azure IoT Central
• Azure Account
• Azure IoT Central application
For Azure IoT Hub
• Azure IoT Hub Instance
• Azure IoT Hub Device Provisioning Service
• Azure IoT Public Model Repository
Prepare the Device
Development Environmental setup
IoT Plug and Play Certification is certifying specific device code implementation against specific device model. Device
builders should either pre-install device code or make the binary download-able. This section describes how to install
application and setup the config file. The CassiaGatewayhas web console to manage the application and ssh login
capability to edit the configuration file for connecting DPS and register sensor devices mac address. The following
diagram shows set up flow.

Figure 2: Set up flow
1. Hardware
The Cassia X1000 enterprise Bluetooth router has an IP65-rated enclosure and may be deployed in indoor and outdoor
environments. The X1000 can be attached to a pole or wall (a mounting kit is included) or placed on a surface like a
desk or counter space. It receives power from Power-over-Ethernet (PoE) via the uplink Ethernet port.
Figure 3: Cassia X1000 Bluetooth Router
The X1000 has a built-in smart antenna array designed specifically for Bluetooth. It also supports Ethernet, 2.4 GHz Wi-
Fi or USB cellular modem as IP uplink. The X1000 is capable of extending Bluetooth’s range up to 1000 feet (300
Meters). The X1000 increases the number of devices that can be simultaneously paired and connected to 22 Bluetooth
low energy devices. It can also listen to potentially hundreds of devices at the same time when operating in broadcast
mode.
Bluetooth
•BLE chip: 2x CSR8811
Connect Ether
and Power on
Check Gateway
MAC
Connect Wifi
Hotspot
Login Gateway
console
Configure uplink
network
Install
Application
Set up DPS
Edit
configuration file
Run application

•Bluetooth version: 4.0/4.1
•LE Connections: Up to 22 connections
•Frequency: 2.400 to 2.483 GHz
•Data rates: up to 2x1Mbps
•Tx power: 0 to 10dBm
•Rx sensitivity: -105dBm
•Antenna Gain: 5.7dbi vertical polarized
Wi-Fi (802.11 b/g/n)
•Frequency: 2.4 GHz
•Working Mode: Wi-Fi client or hotspot (for setup only)
•Tx power: 12.5 to 17.5dBm
•Rx sensitivity: -96 to -71dBm
•Antenna: Omnidirectional
Please refer to the detail information below.
• Device detail information
2. External software (application)
Please access the following link and submit request form to get external application.
• Application request
3. Prepare X1000 gateway and connect with Power and Ethernet.
•Cassia X1000 Router
•Power-over-Ethernet (POE) 802.3af/at compliant source
NOTE: The Cassia X1000 is only powered via Power-over-Ethernet (PoE)
•PoE injector, if PoE network is not available
•CAT5 or CAT6 Ethernet cable (Patch cord): 1 unit if PoE available, or 2 units if used with PoE injector
NOTE: the user can choose Ethernet cable with L connector on one side to avoid the stress when installing the
bottom cap.
Figure 4: How to connect Power
4. Set up the X1000 Bluetooth Gateway
4.1. Find Gateway’s MAC Address
Please find Cassia Gateway’s MAC address on the bottom of the Gateway.

Figure 5: Cassia Gateway’s MAC address
NOTE: If you are filtering MAC addresses in your security policy, please make sure to input the active MAC
addresses. For example, if you are using WIFI for uplink connection, the active MAC will be label MAC + 1. Please
see below table for the details.
Model
Label MAC
Ethernet MAC
WIFI MAC
X1000
MAC
MAC
MAC+1
4.2. Setup using WiFi Hotspot
Cassia Gateway provides a WIFI hotspot for initial setup. Its SSID is cassia-xxxxxx (the xxxxxx corresponds to the
last 6 digits of the Gateway’s MAC address). The default password of the WIFI hotspot is the same as the SSID.
For example, if the Gateway’s MAC address is “CC:1B:E0:E0:96:DC”, the WIFI hotspot SSID and its default
password will be “cassia-E096DC”.
Figure 6: Gateway’s WIFI hotspot
Then, power up your Cassia Gateway, search its WIFI hotspot from your laptop and connect your laptop to the
WIFI hotspot.
If you can’t find the WIFI hotspot, please press and hold the reset button at the bottom of Cassia Gateway for 10 to
15 seconds while the Gateway is powered on.
Please open Google Chrome in your laptop and enter the Gateway’s default IP address 192.168.40.1. The default
web username and password is admin/admin.
At the first time you log in, the system will ask you to change the default password. The password should include
number, characters and special characters. The password length should be between 8-20. Please note down your
new password for future use.
If you forget the username and password, please reset the Cassia Bluetooth Gateway. Once reset, the username
and password will be restored to admin/admin. What is more, the Gateway configurations in below table will be set
to the default profile settings. The country code, container and customer APP will not be impacted. You need to

configure the Cassia Gateway again.
Parameter
Manufacturing Default Value
Gateway Console Username
admin
Gateway Console Password
(set new password)
AC Server Address
Empty
Local RESTful API
OFF
Remote Assistance
OFF
Connection Priority
Wired
WIFI / Operating Mode
Hotspot
WIFI / SSID
cassia-xxxxxx
WIFI / Password
cassia-xxxxxx
WiFI / Hotspot IP
192.168.40.1
Figure 7: Default profile setting
Figure 8: Cassia Gateway’s web login page
Now, please log in to the Gateway’s web page with the new password.
Figure 9: Cassia Gateway’s web login page
4.3. Setup using Ethernet Connection
If you don’t have a laptop which supports WiFi, please connect the Cassia Bluetooth Gateway to a managed Ethernet
switch and access the DHCP table or scan using a port scanning tool to locate the IP address assigned to the
Gateway’s MAC ID.
After that, please open Google Chrome on a computer that is connected to the same network and enter the IP
address discovered above.
4.4. Configure Uplink Network

The Cassia Bluetooth Gateway supports Ethernet (Wired), WIFI and Cellular dongles as networking uplink.
In this guideline, we use Ethernet as the uplink connection.
Below is the configuration with wired and DHCP.
Figure 10: Setup network configuration for your Gateway
Below is the configuration with wired and static IP.
Figure 11: Setup network configuration for your Gateway
Please make a note the ip address. You need to use for ssh login later.
4.5. Enable Local RESTful API
Please configure the Gateway as Standalone Mode, local RESTful API will be automatically turned on.

Figure 12: Configuration of Router Mode on Gateway Console
4.6. How to install Application on Gateway
Please prepare for the application and put on your PC directory. Then follow the steps on Gateway
console: Container->Install APP “Select File” -> Open -> “Install”.
Figure 13: Install application on Gateway
At the time of initial installation, it will take time due to environment construction executed.
(Depending on network speed Time will increase or decrease)
If Gateway "Programs in "operation" includes the following line, the startup is complete.
python3.7 / usr / local / cassia_multi_sensor/bin/app_starter.py
4

Figure 14: Application start up complete
5. Set up DPS
5.1. Provisioning devices with Azure IoT Hub Device Provisioning Service
5.2. Set up the IoT Hub Device Provisioning Service with the Azure portal
5.3. Provision a device with symmetric keys
5.4. Login SSH
Login to Gateway with SSH.
example:
ssh -g [email protected]8.0.8 -p 20022
Figure 15: Login ssh
5.5. How to run the application on the gateway
The configuration file is in the following location.
/usr/local/cassia_multi_sensor/etc/settings.ini
Edit configuration file with vi command with root privileges.
sudo vi /usr/local/cassia_multi_sensor/etc/settings.ini
1. Specify the sensor mac address to use.
In the configuration file [sensor] area, change temporary BD address (12:34:56:78: 9A: BC) to the target BD address.
[sensor]
devices = [{"bdAddr":"12:34:56:78:9A:BC","devType":"TKR03FL"}]
2. Specify the connection information
Configure Connection information of IoT Hub.
It corresponds to Connection string and connection with DPS.
The settings are different depending on the connection method.
Ex) “Connection string”

[cloud]
type = ConnectionString
connection_string=HostName=XXXXXXXXX.azuredevices.net;DeviceId=YYYYYY;SharedAccessKey=gIeo5XzHUGjz
O/5tdi7fLyomTKuBYWAxXgevf4PaDKo=
Ex) “DPS”
[cloud]
type = DPS
dps_scope_id = 0ne000FF000
dps_device_id = 40694de1
dps_device_key = sKVikkodse+gNgbkzdH/q9z6AgbSTyB8=
dps_endpoint = global.azure-devices-provisioning.net
After the setting is completed, restart the BLE Gateway. After a reboot X1000, the application is automatically
launched and starts sending the data collected from sensor to the Azure IoT Hub.
To reboot X1000 please login Gateway’s web page and select “Other” tab then “Reboot” button at the bottom of
window.
Figure 16: Reboot gateway

Connect to Azure IoT Central
This section is mandatory section. Describe how to connect to Azure IoT Central. To configure a device to connect to
Azure IoT Central you need the following.
1. Login to Azure IoT Central and Navigate to the Build page. Please choose Custom apps.
Figure 17: choose Custom apps
2. Azure IoT Central automatically suggests an application name based on the application template you’ve selected.
You can enter your own application name. Please input the required information and click create button.
Figure 18: New application

Figure 19: Billing info
3. The application will be created after few seconds.
Figure 20: Provisioning your application
4. To add a new device template to your application, select the Device Templates tab in the left pane. On the Select
type page, scroll down until you find the X1000_TKR03FL tile from Featured device templates.
5. To add a real device, select +New. Please input the device name and Device ID. Then click Create button.

Figure 21: Create a new device
6. Select the device from All devices.
Figure 22: All devices
7. Click the Connect button and device connection page will be pupped.
Figure 23: device connection
8. Please copy the information the use to connect. Please flash the generated device key and ID scope on the
application that run on your device.

Figure 24: device connection information

Integration with Azure IoT Explorer
1. Set the pre-prepared IoT Hub Connection String in Azure IoT Explorer.
Figure 25: Add connection string
2. Add a device.
Figure 26: Add a device
3. Set it up as shown in the image below. You can choose any device name.
Figure 27: Create new device
4. Note the Connection String.

Figure 28: Note connection string
5. Set the Connection String to X1000 BLE Gateway
Please refer to the section 3.5 Edit configuration file and specify the “Connection string” information in the
configuration file. After the setting is completed, restart the BLE Gateway. After a reboot, the application is
automatically launched and starts sending the data collected from each sensor to the Azure IoT Hub.
6. Check the telemetry
Press the device name and choose the Telemetry Page. Press Start and wait a moment. You will see the telemetry
data on the screen.
Figure 29: Start to receive telemetry data

Figure 30: Monitor telemetry data
Additional information
Product Page
Additional Links
Please refer to the below link for additional information for Plug and Play
Manage cloud device messaging with Azure-IoT-Explorer
Import the Plug and Play model
Configure to connect to IoT Hub
How to use IoT Explorer to interact with the device