58
1 Copyright © 2019 Cassia Networks, Inc. Version: EN-12102019-YJ Cassia Networks, Inc. 97 East Brokaw Road, Suite 130 San Jose, CA 95112 [email protected] Cassia Bluetooth Router User Manual Release date: December 10 th , 2019 Contents 1. What is a Cassia Router?.................................................................................................. 2 1.1. Cassia X1000 ........................................................................................................................ 2 1.2. Cassia E1000 ........................................................................................................................ 3 1.3. Cassia S2000 ........................................................................................................................ 4 1.4. Certified Country List............................................................................................................. 5 2. Installation ........................................................................................................................ 6 2.1. X1000 .................................................................................................................................... 6 2.2. E1000 .................................................................................................................................... 8 2.3. S2000 .................................................................................................................................... 9 3. Deployment .................................................................................................................... 12 3.1. X1000 .................................................................................................................................. 12 3.2. X1000 Antenna Radiation Graphs ...................................................................................... 13 3.3. E1000 and S2000 ............................................................................................................... 15 3.4. E1000 and S2000 Antenna Radiation Graphs ................................................................... 16 4. Getting Started ............................................................................................................... 17 4.1. Understanding the Cassia Access Controller ....................................................................... 17 4.2. Apply Licenses Key and Developer Key/Secret ................................................................. 18 4.3. Network Environment Requirement .................................................................................... 19 4.4. Connecting the Router to AC .............................................................................................. 19 5. Cassia Bluetooth Router Configurations....................................................................... 22 5.1. Status Tab ........................................................................................................................... 22 5.2. Basic Tab ............................................................................................................................ 23 5.2.1. Wired Settings ..................................................................................................................... 24 5.2.2. Wireless Settings ................................................................................................................ 25 5.2.3. USB Cellular Modem........................................................................................................... 26 5.3. Container Tab ..................................................................................................................... 28 5.4. Logs Tab ............................................................................................................................. 32 5.5. Other Tab ............................................................................................................................ 32 5.6. Service Tab ......................................................................................................................... 38 5. More information on Access Controller ....................................................................... 41 6.1. Deployment Options............................................................................................................ 41 6.2. AC License .......................................................................................................................... 42 6.3. Interface Protocol ................................................................................................................ 42 6.4. Bluetooth Debug Tool .......................................................................................................... 43 6.5. Enhanced Locationing......................................................................................................... 44 7. Cassia RESTful APIs...................................................................................................... 46 7.1. Room-based Location Tracking .......................................................................................... 46 7.2. Secure Pairing ..................................................................................................................... 46 Appendix A: Cassia’s TI Sensor Tag Demo......................................................................... 47 Appendix B: Supported USB Cellular Modem ..................................................................... 52 Appendix C: EU WEEE Directive .......................................................................................... 58

Cassia User Manual · Figure 3: Cassia S2000 Bluetooth Router The S2000 extends luetooth’s range up to 1000 feet and expands the number of luetooth low energy devices that can be

  • Upload
    others

  • View
    66

  • Download
    1

Embed Size (px)

Citation preview

Page 1: Cassia User Manual · Figure 3: Cassia S2000 Bluetooth Router The S2000 extends luetooth’s range up to 1000 feet and expands the number of luetooth low energy devices that can be

1

Copyright © 2019 Cassia Networks, Inc.

Version: EN-12102019-YJ

Cassia Networks, Inc. 97 East Brokaw Road, Suite 130 San Jose, CA 95112 [email protected]

Cassia Bluetooth Router User Manual

Release date: December 10th, 2019

Contents 1. What is a Cassia Router? .................................................................................................. 2

1.1. Cassia X1000 ........................................................................................................................ 2

1.2. Cassia E1000 ........................................................................................................................ 3

1.3. Cassia S2000 ........................................................................................................................ 4

1.4. Certified Country List ............................................................................................................. 5

2. Installation ........................................................................................................................ 6

2.1. X1000 .................................................................................................................................... 6

2.2. E1000 .................................................................................................................................... 8

2.3. S2000 .................................................................................................................................... 9

3. Deployment .................................................................................................................... 12

3.1. X1000 .................................................................................................................................. 12

3.2. X1000 Antenna Radiation Graphs ...................................................................................... 13

3.3. E1000 and S2000 ............................................................................................................... 15

3.4. E1000 and S2000 Antenna Radiation Graphs ................................................................... 16

4. Getting Started ............................................................................................................... 17

4.1. Understanding the Cassia Access Controller ....................................................................... 17

4.2. Apply Licenses Key and Developer Key/Secret ................................................................. 18

4.3. Network Environment Requirement .................................................................................... 19

4.4. Connecting the Router to AC .............................................................................................. 19

5. Cassia Bluetooth Router Configurations ....................................................................... 22

5.1. Status Tab ........................................................................................................................... 22

5.2. Basic Tab ............................................................................................................................ 23

5.2.1. Wired Settings ..................................................................................................................... 24

5.2.2. Wireless Settings ................................................................................................................ 25

5.2.3. USB Cellular Modem ........................................................................................................... 26

5.3. Container Tab ..................................................................................................................... 28

5.4. Logs Tab ............................................................................................................................. 32

5.5. Other Tab ............................................................................................................................ 32

5.6. Service Tab ......................................................................................................................... 38

5. More information on Access Controller ....................................................................... 41

6.1. Deployment Options ............................................................................................................ 41

6.2. AC License .......................................................................................................................... 42

6.3. Interface Protocol ................................................................................................................ 42

6.4. Bluetooth Debug Tool .......................................................................................................... 43

6.5. Enhanced Locationing......................................................................................................... 44

7. Cassia RESTful APIs...................................................................................................... 46

7.1. Room-based Location Tracking .......................................................................................... 46

7.2. Secure Pairing ..................................................................................................................... 46

Appendix A: Cassia’s TI Sensor Tag Demo ......................................................................... 47

Appendix B: Supported USB Cellular Modem ..................................................................... 52

Appendix C: EU WEEE Directive .......................................................................................... 58

Page 2: Cassia User Manual · Figure 3: Cassia S2000 Bluetooth Router The S2000 extends luetooth’s range up to 1000 feet and expands the number of luetooth low energy devices that can be

2

Copyright © 2019 Cassia Networks, Inc.

Version: EN-12102019-YJ

1. What is a Cassia Router?

The Cassia Router is a long-range enterprise Bluetooth router that can be used for indoor

and outdoor environments. It extends the range of Bluetooth connectivity up to 1000 feet

(300 Meters) and enables remote control of up to 40 Bluetooth low energy devices without

requiring any changes to Bluetooth end devices. The Cassia Bluetooth router acts as a

protocol gateway, which translates between the Bluetooth protocol and the Internet

Protocol (IP) protocol. This enables your Bluetooth low energy devices to be remotely

accessible and controllable via an Internet application.

From firmware 1.3 onwards, Cassia provides container support for the Cassia Router E1000

and X1000 where users can run third-party applications. Please check third party

Application Deployment Instructions in https://www.cassianetworks.com/knowledge-

base/general-documents/.

1.1. Cassia X1000

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 1: Cassia X1000 Bluetooth Router

The X1000 has a built-in smart antenna array designed specifically for Bluetooth. It also

supports Ethernet, 2.4 GHz WiFi 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.

Page 3: Cassia User Manual · Figure 3: Cassia S2000 Bluetooth Router The S2000 extends luetooth’s range up to 1000 feet and expands the number of luetooth low energy devices that can be

3

Copyright © 2019 Cassia Networks, Inc.

Version: EN-12102019-YJ

Processor & Memory

• CPU: 4 core ARM Cortex-A5, up to 1.5GHz

• 256MB RAM DDR3, 4GB eMMC storage

Bluetooth

• BLE chip: 2x CSR8811

• 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

WiFi (802.11 b/g/n)

• Frequency: 2.4 GHz

• Working Mode: WiFi client or hotspot (for setup only)

• Tx power: 12.5 to 17.5dBm

• Rx sensitivity: -96 to -71dBm

• Antenna: Omnidirectional

For full features and specifications, please see the X1000 datasheet here: https://www.cassianetworks.com/knowledge-base/product-data-sheet/.

1.2. Cassia E1000

The Cassia E1000 is an enterprise Bluetooth router with edge computing capabilities

specifically designed for deployments in industrial, hospitals, senior centers, schools, gyms,

and other indoor locations. The Cassia E1000 can be attached to the ceiling or wall (a

mounting kit is included) or may be placed on a desktop or counter space. The E1000 is

powered via a Micro-USB adapter or from a switch using Power over Ethernet via the uplink

Ethernet port.

Figure 2: Cassia E1000 Bluetooth Router

The E1000 increases the number of devices that can be paired and controlled for up to 40

Bluetooth low energy devices. In broadcast mode, the E1000 can listen to several hundred

Page 4: Cassia User Manual · Figure 3: Cassia S2000 Bluetooth Router The S2000 extends luetooth’s range up to 1000 feet and expands the number of luetooth low energy devices that can be

4

Copyright © 2019 Cassia Networks, Inc.

Version: EN-12102019-YJ

Bluetooth low energy end devices. Its patented smart antenna is optimized for horizontal

use. The E1000 supports Ethernet, 2.4Ghz and 5Ghz WiFi or USB cellular modem as an IP

uplink. This enables your Bluetooth low energy devices to be remotely accessible and

controllable remotely via an Internet application.

Processor & Memory

• CPU: 4 core ARM Cortex-A5, up to 1.5GHz

• 256MB RAM DDR3, 4GB eMMC storage

Bluetooth

• BLE chip: 2x Nordic nRF52832

• Bluetooth version: 4.0/4.1/4.2, 5 compliant

• LE Connections: Up to 40 connections

• Frequency: 2.400 to 2.483 GHz

• Data rates: up to 2x1Mbps

• Tx power: 0 to 8dBm

• Rx sensitivity: -105dBm

• Antenna Gain: 5dbi PEAK

• Increased broadcast capacity (x8) with Bluetooth 5

For full features and specifications, please see the E1000 datasheet here: https://www.cassianetworks.com/knowledge-base/product-data-sheet/.

1.3. Cassia S2000

The Cassia S2000 enterprise Bluetooth router is designed for deployments in industrial

automation, health monitoring, senior safety and other enterprise IoT applications. The

Cassia S2000 can be attached to a ceiling or wall with the included mounting kit, or it can be

placed on a desktop or counter space. The S2000 receives power from either a Micro-USB

adapter or a switch using PoE via the uplink Ethernet port.

Figure 3: Cassia S2000 Bluetooth Router

The S2000 extends Bluetooth’s range up to 1000 feet and expands the number of Bluetooth

low energy devices that can be paired and controlled up to 20 devices. In broadcast mode,

the S2000 can listen to several hundred Bluetooth low energy end devices. The patented

smart antenna of the S2000 is optimized for horizontal use.

Page 5: Cassia User Manual · Figure 3: Cassia S2000 Bluetooth Router The S2000 extends luetooth’s range up to 1000 feet and expands the number of luetooth low energy devices that can be

5

Copyright © 2019 Cassia Networks, Inc.

Version: EN-12102019-YJ

The S2000 is used as a protocol gateway, translating between the Bluetooth protocol and

the IP protocol. It supports Ethernet, 2.4Ghz WiFi and USB cellular modem for IP uplink. You

can easily access and control your Bluetooth low energy devices remotely via an Internet

application or a mobile app.

Processor & Memory

• CPU: MIPS processor, up to 535MHz

• 64MB RAM DDR2, 16MB flash

Bluetooth

• BLE chip: Nordic nRF52832

• Bluetooth version: 4.0/4.1/4.2, 5 compliant

• LE Connections: Up to 20 connections

• Frequency: 2.400 to 2.483 GHz

• Data rates: up to 1Mbps

• Tx power: 0 to 8dBm

• Rx sensitivity: -105dBm

• Antenna Gain: 5dbi PEAK

• Increased broadcast capacity (x8) with Bluetooth 5

For full features and specifications, please see the S2000 datasheet here: https://www.cassianetworks.com/knowledge-base/product-data-sheet/.

1.4. Certified Country List

Country/Region Certificate X1000 E1000 S2000

China SRRC x x x

China China RoHS x x x

US FCC x x x

Canada IC x x x

Europe CE x x x

Europe REACH x x x

Europe RoHS x x x

Japan TELEC x x

Australia RCM x x

New Zealand RCM x x

Singapore IMDA x

Malaysia SIRIM x

Thailand NBTC x

Brazil ANATEL x

South Africa ICASA & NRCS x

Chile SUBTEL x

Colombia CRC x

Mexico IFT & NOM x

Global CB x x x

Global BQB x x x

Global Ethernet Alliance Compliant

x

Page 6: Cassia User Manual · Figure 3: Cassia S2000 Bluetooth Router The S2000 extends luetooth’s range up to 1000 feet and expands the number of luetooth low energy devices that can be

6

Copyright © 2019 Cassia Networks, Inc.

Version: EN-12102019-YJ

2. Installation

2.1. X1000

Hardware

• 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.

• Internet connection

• Computer System (Desktop/Laptop/Tablet/Smart Phone) with WiFi connectivity

• USB cellular modem: Required only if set up over a SIM-based Internet connection Included in Package

Page 7: Cassia User Manual · Figure 3: Cassia S2000 Bluetooth Router The S2000 extends luetooth’s range up to 1000 feet and expands the number of luetooth low energy devices that can be

7

Copyright © 2019 Cassia Networks, Inc.

Version: EN-12102019-YJ

Mounting

1. Mount the X1000 mounting bracket in a vertical orientation onto a wall or pole with the supplied mounting kit;

2. Connect the X1000 to Network cable (power) and Ground cable;

3. Upon reinstalling bottom Cap, slide the X1000 down on wall or pole mount;

4. Connect the X1000 Router to the PoE injector or a PoE switch.

Page 8: Cassia User Manual · Figure 3: Cassia S2000 Bluetooth Router The S2000 extends luetooth’s range up to 1000 feet and expands the number of luetooth low energy devices that can be

8

Copyright © 2019 Cassia Networks, Inc.

Version: EN-12102019-YJ

2.2. E1000

Hardware

• Cassia E1000 Router

• Power-over-Ethernet (PoE) 802.3af/at compliant source

• PoE injector, if PoE network is not available

• Micro USB power cable and universal plugs; if not using PoE

• CAT5 or CAT6 Ethernet cable (Patch cord): 1 unit if PoE available, or 2 units if used with PoE injector

• Computer System (Desktop / Laptop/ Android Phone/Tablet) with WiFi connectivity

• USB cellular modem: required only if set up over a SIM-based Internet connection is required

Included in Package

Mounting

1. Place the E1000 on a flat, unobstructed surface or mount if using the supplied mounting kit in a vertical or horizontal orientation;

2. If mounting, first screw the mounting plate onto wall or ceiling;

Page 9: Cassia User Manual · Figure 3: Cassia S2000 Bluetooth Router The S2000 extends luetooth’s range up to 1000 feet and expands the number of luetooth low energy devices that can be

9

Copyright © 2019 Cassia Networks, Inc.

Version: EN-12102019-YJ

3. Connect the E1000 to power with the supplied Micro USB cable and power adapter and to a WiFi Access Point via Ethernet or WiFi (2.4GHz or 5GHz); NOTE: The E1000 can also connect to a power-over-ethernet (PoE) connection;

4. Place the E1000 router at a slight angle against the mounting plate and twist into place (turn clockwise);

2.3. S2000

Hardware

• Cassia S2000 Router

• Power-over-Ethernet (PoE) 802.3af/at compliant source

• PoE injector, if PoE network is not available

• Micro USB power cable and universal plugs; if not using PoE

• CAT5 or CAT6 Ethernet cable (Patch cord): 1 unit if PoE available, or 2 units if used with PoE injector

• Computer System (Desktop / Laptop/ Android Phone/Tablet) with WiFi connectivity

• USB cellular modem. This is only required if set up is over a SIM-based Internet connection

Page 10: Cassia User Manual · Figure 3: Cassia S2000 Bluetooth Router The S2000 extends luetooth’s range up to 1000 feet and expands the number of luetooth low energy devices that can be

10

Copyright © 2019 Cassia Networks, Inc.

Version: EN-12102019-YJ

Included in Package

Mounting

1. Place the S2000 on a flat, unobstructed surface or mount it using the supplied mounting kit in a vertical or horizontal orientation;

2. If mounting, first screw mounting plate into wall or ceiling;

3. Connect the S2000 to power with the supplied Micro USB cable and power adapter and to a WiFi Access Point via Ethernet or WiFi (2.4GHz only); NOTE: S2000 can also connect to a power-over-ethernet (PoE) connection;

Page 11: Cassia User Manual · Figure 3: Cassia S2000 Bluetooth Router The S2000 extends luetooth’s range up to 1000 feet and expands the number of luetooth low energy devices that can be

11

Copyright © 2019 Cassia Networks, Inc.

Version: EN-12102019-YJ

4. Place the S2000 router at a slight angle against the mounting plate and twist into place (turn clockwise);

Page 12: Cassia User Manual · Figure 3: Cassia S2000 Bluetooth Router The S2000 extends luetooth’s range up to 1000 feet and expands the number of luetooth low energy devices that can be

12

Copyright © 2019 Cassia Networks, Inc.

Version: EN-12102019-YJ

3. Deployment

3.1. X1000

Cassia’s Bluetooth router coverage varies based on conditions. In outdoor “open air”

locations with no obstructions, the coverage radius of Cassia’s Bluetooth routers is greater

than indoor locations with walls and obstructions.

In general, the radius of outdoor coverage may vary from 300-1000 feet (100-300 meters)

depending on the wireless interference, obstructions, and line of sight. A rule of thumb for

deployment is to ensure that the Bluetooth device has a consistent connection and that the

Bluetooth signal strength is strong.

Deployment principles:

• Avoid installations near radio transmitters such as radio towers, cellular base stations and WiFi access points (APs)

• Pole or wall mounting is required

• Power-over-Ethernet (PoE) is required

• Installation height is recommended between 10 and 100 feet (3 and 30 meters) • Grounding cable and lightning protection is required

Figure 4: Cassia X1000 outdoor deployment

Page 13: Cassia User Manual · Figure 3: Cassia S2000 Bluetooth Router The S2000 extends luetooth’s range up to 1000 feet and expands the number of luetooth low energy devices that can be

13

Copyright © 2019 Cassia Networks, Inc.

Version: EN-12102019-YJ

3.2. X1000 Antenna Radiation Graphs

If you place your router as depicted in the image above, the images below show the Antenna Gain in 3-D.

Page 14: Cassia User Manual · Figure 3: Cassia S2000 Bluetooth Router The S2000 extends luetooth’s range up to 1000 feet and expands the number of luetooth low energy devices that can be

14

Copyright © 2019 Cassia Networks, Inc.

Version: EN-12102019-YJ

Down-tilt Angle When installation height is more than 30 feet (10 meters), an antenna down-tilt angle is required.

According to the above formula, the following tilt angles are highly recommended:

Page 15: Cassia User Manual · Figure 3: Cassia S2000 Bluetooth Router The S2000 extends luetooth’s range up to 1000 feet and expands the number of luetooth low energy devices that can be

15

Copyright © 2019 Cassia Networks, Inc.

Version: EN-12102019-YJ

• At a height of 15-30 feet (5-10 meters), no tilting is needed

• At a height of 30-60 feet (10-20 meters), 5°-10° tilt is required to cover distances further than 30 feet (10 meters)

• At a height of more than 60 feet (20 meters), please calculate the inclination angle

according to the formula provided above

3.3. E1000 and S2000

The optimal placement for the Cassia E1000 and S2000 should be located above ground

at a height of 10 to 15 feet (3-5 meters), in direct line of sight of the BLE device, and

within 180 to 600 feet (60-200 meters) range of the BLE device. Ceiling installations

should be 6 feet (2 meters) away from nearby walls or columns. Obstacles, like walls, as

well as WiFi interference will reduce the range of Cassia’s Bluetooth routers.

NOTE: Deployment principles:

• Keep at least 3 feet (1 meter) away from cellular antennas and WiFi access points. • Installation should be far from microwaves, wireless keyboard/mouse and other

devices that also use the 2.4 GHz band.

• Avoid installations near air conditioners, heating pipes, water supply pipes,

transformer boxes, an elevator operation room, etc.

Figure 5: E1000 and S2000 Indoor Deployment

Page 16: Cassia User Manual · Figure 3: Cassia S2000 Bluetooth Router The S2000 extends luetooth’s range up to 1000 feet and expands the number of luetooth low energy devices that can be

16

Copyright © 2019 Cassia Networks, Inc.

Version: EN-12102019-YJ

3.4. E1000 and S2000 Antenna Radiation Graphs

If you place the E1000 and S2000 on a tabletop (shown above), the radiation pattern

graph results are shown below.

Page 17: Cassia User Manual · Figure 3: Cassia S2000 Bluetooth Router The S2000 extends luetooth’s range up to 1000 feet and expands the number of luetooth low energy devices that can be

17

Copyright © 2019 Cassia Networks, Inc.

Version: EN-12102019-YJ

4. Getting Started

4.1. Understanding the Cassia Access Controller

The Cassia IoT Access Controller (AC) is a powerful IoT network management solution.

Using the Cassia AC, organizations have access, control, and monitoring over IoT

environments. The Cassia AC solution enables the deployment and management of

hundreds of Bluetooth routers, as well as the monitoring of thousands of

detected/connected devices in an enterprise environment from one centralized interface.

Figure 6: Cassia IoT Access Controller

Why use the AC?

▪ Provisioning and managing Bluetooth routers individually is time-consuming and

error-prone

▪ Version management for hundreds of routers individually is a manual and inefficient

process

▪ Router alone cannot support BLE device roaming

▪ Router alone cannot track a BLE device’s location

For more details, please see the Cassia IoT Access Controller Server Data Sheets here:

https://www.cassianetworks.com/knowledge-base/product-data-sheet/.

A user may use a Cassia-hosted AC or install their own AC server. It is strongly

recommended that new users use a Cassia-hosted AC to expedite the evaluation process.

The evaluation process of a Cassia Bluetooth Router with a Cassia-hosted AC is available

Page 18: Cassia User Manual · Figure 3: Cassia S2000 Bluetooth Router The S2000 extends luetooth’s range up to 1000 feet and expands the number of luetooth low energy devices that can be

18

Copyright © 2019 Cassia Networks, Inc.

Version: EN-12102019-YJ

for purchase with Cassia Starter Kits. Please contact the Cassia sales team for more

information.

4.2. Apply Licenses Key and Developer Key/Secret

If you want to manage more than three routers, please apply the License Key which

governs the number of managed routers. Before using Cassia’s RESTful API through the AC,

you will need a Developer Key and Developer Secret.

Please send the required information below to [email protected] to apply the License Key, Developer Key and Developer Secret.

• Customer name

• Number of routers

• Length of subscription (in months)

• Device ID (copy from AC setting page)

a) Server license key

To use the Cassia Bluetooth Router with the AC, you will also need a server license key.

The license key governs the number of Bluetooth routers that can be managed by the AC,

as well as the length of time and the types of features available. Below is an example of a

server license key:

Please see the screenshot below for inputting the Developer Key, Developer Secret and a

server license key via the AC.

Figure 7: Input your developer key, developer secret, and license key via the AC

b) Developer account credentials

Developer Key and Developer Secret credentials are required. These developer credentials

authorize the remote control of your Cassia Bluetooth router.

v002-0128-20180427052110-0012-p52y-zunk-rqbe-pqlw

Page 19: Cassia User Manual · Figure 3: Cassia S2000 Bluetooth Router The S2000 extends luetooth’s range up to 1000 feet and expands the number of luetooth low energy devices that can be

19

Copyright © 2019 Cassia Networks, Inc.

Version: EN-12102019-YJ

Below is a sample credential:

4.3. Network Environment Requirement

Please make sure the following ports listed in Table 1 below are opened in the firewall.

The user can check if a TCP port is opened by using Netcat in chapter 5.5.

Type Port M/O Description UDP 5246, 5247 Mandatory Default CAPWAP communication between AC and router

UDP 6246, 6247 Optional Backup CAPWAP communication between AC and router

UDP 53 Mandatory DNS lookup for AC address

TCP 8883 Optional Optional MQTT communication between AC and router

TCP 80 Mandatory Container/APP download from AC

TCP 443 Optional Container/APP download from AC

TCP 9999 Mandatory Remote SSH to container (laptop->8001->AC->9999->container)

TCP 1883 Optional MQTT bypass function (see chapter 5.6)

Table 1: Outbound Ports

The image below shows the ports which may be used in the system.

4.4. Connecting the Router to AC

You will find your Cassia Bluetooth router’s MAC address located at the bottom of the

router.

Figure 8: Cassia Bluetooth router’s MAC address

client_id:tester, secret:198c776539c41234

Page 20: Cassia User Manual · Figure 3: Cassia S2000 Bluetooth Router The S2000 extends luetooth’s range up to 1000 feet and expands the number of luetooth low energy devices that can be

20

Copyright © 2019 Cassia Networks, Inc.

Version: EN-12102019-YJ

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, your

active MAC will be Label_ MAC+1. See table below for further details.

Model Label MAC Ethernet MAC

WiFi MAC

X1000 MAC MAC MAC+1

E1000 MAC MAC MAC+1

S2000 MAC MAC MAC+1

S1000/S1100 MAC MAC MAC-1

For firmware 1.2 or above, a Cassia Bluetooth router comes with a WiFi hotspot function.

The SSID is cassia-xxxxxx (the “x’s” corresponds to the last 6 digits of the router’s MAC

address). The default password of the WiFi hotspot is the same as the SSID.

For example, if the Cassia Bluetooth router MAC address is “CC:1B:E0:E0:96:DC”, the SSID

and its default password will be “cassia-E096DC”. The router’s default IP address is

192.168.40.1. The router’s console default login is admin/admin.

Please follow the Router Quick Start Guide to connect your laptop to the WiFi hotspot and

to configure the router and connect it to the AC. For detailed instructions, please click

here: https://www.cassianetworks.com/knowledge-base/general-documents/.

If you are running a firmware version lower than 1.2, then a setup requires a few

additional steps. For detailed instructions please follow the document link here:

https://www.cassianetworks.com/download/docs/Cassia_Quick_Start_Guide-

v1.2.pdf

If you can’t find the WiFi hotspot or forget the username and password, and your

firmware is 1.2 or above, please press and hold the reset button located at the bottom of

the router for 10 to 15 seconds. Once reset, the WiFi hotspot will be enabled, and the

username/password will be restored to admin/admin.

Figure 9: Cassia Router Reset Button

Page 21: Cassia User Manual · Figure 3: Cassia S2000 Bluetooth Router The S2000 extends luetooth’s range up to 1000 feet and expands the number of luetooth low energy devices that can be

21

Copyright © 2019 Cassia Networks, Inc.

Version: EN-12102019-YJ

NOTE: After reset, the router’s configuration will be set to the default profile settings. The

settings are shown in the table below.

Parameter Manufacturing Default Value Router Console Username admin Router Console Password (set new password) AC Server Address Empty Local RESTful API OFF Remote Assistance OFF Connection Priority Wired Wireless / Operation Mode Hotspot Wireless / SSID cassia-xxxxxx Wireless / Password cassia-xxxxxx

Page 22: Cassia User Manual · Figure 3: Cassia S2000 Bluetooth Router The S2000 extends luetooth’s range up to 1000 feet and expands the number of luetooth low energy devices that can be

22

Copyright © 2019 Cassia Networks, Inc.

Version: EN-12102019-YJ

5. Cassia Bluetooth Router Configurations

To configure the router, first open the Cassia Bluetooth router configuration page by

entering its local IP address.

NOTE: The Google Chrome browser is preferred as results may vary with other browsers.

5.1. Status Tab

The Status tab displays the router’s current configuration:

Figure 10: Cassia router configuration page – Status

Page 23: Cassia User Manual · Figure 3: Cassia S2000 Bluetooth Router The S2000 extends luetooth’s range up to 1000 feet and expands the number of luetooth low energy devices that can be

23

Copyright © 2019 Cassia Networks, Inc.

Version: EN-12102019-YJ

Parameter Description Model X1000, E1000 or S2000. MAC This is the MAC address printed on the bottom of the Cassia Bluetooth

router, which is equal to the router’s Ethernet interface MAC. Working Mode AC Managed mode means the Cassia Bluetooth Router is connected to the

Cassia IoT Access Controller and managed by the AC. Standalone mode means the Cassia Bluetooth Router is not connected to the AC and operating locally.

ETH IP Ethernet IP address of the router WLAN IP WLAN IP address Cellular IP The IP address of the router when using a USB cellular modem Country/Region Deployment location Firmware Version Firmware version on the router Up Time The router up time in hours since the last reboot AC Online Time The time of the router connected with the AC. If not connected, it shows

offline. CPU Usage Current status of CPU Memory Usage Current memory used

5.2. Basic Tab

The user can configure the most common settings for the router, such as Router Mode,

Tx Power, AC Server Address, AC-Router Comm. Ports, Remote Assistance, Connection

Priority, and Wired/Wireless/Cellular configurations.

The Cassia Bluetooth Router supports the following networking uplinks: wired, wireless

and USB cellular modem.

NOTE: In general, WiFi and cellular networks are less stable and have more interference

compared to Ethernet. In order to guarantee good uplink performance, we suggest that

user to use Ethernet (wired) for the uplink.

Page 24: Cassia User Manual · Figure 3: Cassia S2000 Bluetooth Router The S2000 extends luetooth’s range up to 1000 feet and expands the number of luetooth low energy devices that can be

24

Copyright © 2019 Cassia Networks, Inc.

Version: EN-12102019-YJ

Figure 11: Cassia router configuration page -- Basic

Parameter Description Router Mode AC Managed Router or Standalone Router Tx Power Bluetooth Tx power is adjustable by country Statistics Report Interval Cassia router reports statistic information to AC regularly. The

default statistic report interval is 30 seconds. This interval setting can be increased to 1, 2, or 5 minutes. NOTE: if user selects cellular modem in router’s console, “Statistic Report Interval” will be changed to 5 minutes automatically.

AC Server Address Enter the domain name or IP address of the Access Controller that manages this router

AC-Router Comm. Ports The communication UDP ports used by your AC and router. This setting must be identical to the one set on your AC. Otherwise, your router can’t talk to your AC.

Remote Assistance Turn this on will enable Cassia engineers to remotely access to the router for troubleshooting purpose. By default, this function is off.

Connection Priority When two or more network connections are activated, you can set

priority levels for the networks. By default, the priority is Wired >

Wireless > Cellular. For example, if you set priority to Wireless, the

new order will be: Wireless > Wired > Cellular

The network uplink traffic between the router and the AC includes BLE traffic and

management traffic. There are two ways to reduce the uplink management traffic.

1. The user can change the Statistic Report Interval to 1, 2, or 5 minutes

2. The user can select MQTT as the Data Path in AC Settings page

Below are examples of network uplink management traffic with different configurations

(not including BLE traffic).

Firmware & Configuration CAPWAP

(MB per month)

MQTT

(MB per month)

v1.3 (without container) 255 (DL 58, UL 197) N/A in v1.3

v1.3 (with container) 390 (DL 58, UL 332) N/A in v1.3

v1.4 (30s, without container) 195 (DL 43, UL 152) 165 (DL 50, UL 115)

v1.4 (30s, with container) 215 (DL 43, UL 172) 175 (DL 53, UL 122)

v1.4 (5min, without container) 170 (DL 43, UL 127) 117 (DL 45, UL 72)

v1.4 (5min, with container) 175 (DL 43, UL 132) 123 (DL 48, UL 75)

The network uplink traffic in production environment depends on the configuration, BLE

device, etc, and should be evaluated on a case by case basis.

5.2.1. Wired Settings

For a wired connection, please select DHCP (default) or Static IP.

Page 25: Cassia User Manual · Figure 3: Cassia S2000 Bluetooth Router The S2000 extends luetooth’s range up to 1000 feet and expands the number of luetooth low energy devices that can be

25

Copyright © 2019 Cassia Networks, Inc.

Version: EN-12102019-YJ

Figure 12: Cassia router configuration page – Wired Connection

In Static IP allocation, please enter your network information, including IP, net mask, gateway and DNS. NOTE: For your network setting information, please contact your IT administrator.

5.2.2. Wireless Settings Cassia’s Bluetooth routers’ WiFi supports Client or Hotspot mode. For the initial deployment, the router operates in Hotspot mode by default. This allows the user to connect to the router via WiFi using a laptop or mobile device for configuration purposes. The Cassia Bluetooth router will advertise an SSID: cassia-xxxxxx (the “x’s” correspond to the last 6-digit of the router’s MAC address). For additional details, see section 4.3. To use the WiFi as your uplink, please switch the Operating Mode to the Client mode. Please complete the rest of the configuration fields. For details on your WiFi settings, please contact your IT administrator.

Figure 13: Cassia router configuration page – Wireless Connection

From firmware 1.4 and above, Cassia’s router supports additional WiFi security modes. The user can choose the WiFi Security Mode, provide the required inputs, and then connect to the WiFi router with enterprise-level security.

Page 26: Cassia User Manual · Figure 3: Cassia S2000 Bluetooth Router The S2000 extends luetooth’s range up to 1000 feet and expands the number of luetooth low energy devices that can be

26

Copyright © 2019 Cassia Networks, Inc.

Version: EN-12102019-YJ

Security Mode Required Inputs None N/A

WPA2-PSK Password WPA[TKIP]+WPA2[AES] Password [Enterprise]WPA2 • If EAP Type is PEAP-MSCHAPV2, please provide

Identify and Password. • If EAP Type is TTLS, please provide Identify,

Password and CA Certificate. • If EAP Type is TLS, please provide Identify,

Password, CA Certificate, Client Certificate, Private Key and Private Key Password.

[Enterprise]WPA[TKIP]+WPA2[AES]

Figure 14: Cassia router configuration page – Wireless Security Mode

5.2.3. USB Cellular Modem

Cassia’s router supports USB cellular modem as the network uplink. You will have to purchase a supported USB cellular modem and a SIM card with an active data plan that works with the USB cellular modem. Before using any USB cellular modem, please connect it to your laptop/desktop to ensure the internet can be accessed with the USB cellular modem. After testing the connection to the internet, please connect the USB cellular modem to the USB port on the Cassia Bluetooth router, select the right modem type and configure the parameters, if needed.

Page 27: Cassia User Manual · Figure 3: Cassia S2000 Bluetooth Router The S2000 extends luetooth’s range up to 1000 feet and expands the number of luetooth low energy devices that can be

27

Copyright © 2019 Cassia Networks, Inc.

Version: EN-12102019-YJ

Figure 15: Cassia router configuration page – USB cellular modem connection

The USB cellular modem with RNDIS Driver Ethernet Type 1 & Type 2 is supported.

• Type 1: An APN needs to be specified. For example, wyleslte.gw7.vzwentp and 10569.mcs is KORE Wireless APN. NOTE: If you are using a SIM card from another cellular operator, please contact the cellular operator for the right APN.

• Type 2: It applies the settings automatically and shows the LAN connection. e.g. Huawei E3372s-153 modem.

Below are the USB cellular modems that can be selected by default:

• HUAWEI MS2131i-8 • HUAWEI E3372s-153 • HUAWEI E8372h-153 • Novatel USB730L (for Verizon) • MultiTech MTD-MVW1 (for Verizon) • MultiTech MTD-MNA1 (for Verizon, AT&T, and other Cellular operators) • MultiTech MTCM-LAT3-B03 (for AT&T, T-Mobile, and other Cellular operators) • MultiTech MTCM-LNA3-B03 (for Verizon and AT&T) • Zoom 4615 (for Verizon) • Zoom 4630 (for AT&T, T-Mobile, and other Cellular operators)

• ConnectedIO EM1000T-VZ-CAT1 (for Verizon) NOTE 1: MultiTech MTD-MVW1 and MTD-MNA1 are LTE CAT M1 only modems. They can only access the LTE network where LTE CAT M1 is enabled, e.g. Verizon and AT&T.

Page 28: Cassia User Manual · Figure 3: Cassia S2000 Bluetooth Router The S2000 extends luetooth’s range up to 1000 feet and expands the number of luetooth low energy devices that can be

28

Copyright © 2019 Cassia Networks, Inc.

Version: EN-12102019-YJ

NOTE 2: The coverage of LTE CAT M1 is 5db-15db better than LTE, but its peak throughput is 300kbps/375kbps. In a poor network environment, the throughput may be only 50kbps-100kbps. In this case, it may become a bottleneck for BLE data transmission which may cause the router upgrade to take more than one hour (25MB/50kbps=1 hour). The antenna of ConnectedIO EM1000T-VZ-CAT1 is too big, so it can’t fit into X1000’s bottom compartment. The user can connect the ConnectedIO modem and X1000 with USB extension cable. New USB cellular modems can be added by using the Custom option. Below is an example. For USB cellular modem and SIM card related information, please contact the carrier. Interface Name 'ppp0' Protocol '3g' APN 'iot.aer.net' Service 'umts' Dial Number '*99#' Device '/dev/ttyUSB_modem'

5.3. Container Tab

From firmware 1.3 and above, Cassia’s Bluetooth router E1000 and X1000 supports third party applications in container (OS is Ubuntu 16.04.3). The container shares CPU, RAM and storage with the host router. It can use up to 2 CPU cores, up to 128MB RAM and up to 2.3GB storage. Below is the list of utilities and packages pre-loaded in Cassia container version 1.1.1.

Name Version

BlueZ 5.31

Bluetoothd

Dbus

Python 2 2.7

Python 3 3.5.2

Python Pip 8.1.1

gobject

dbus-python

Nodejs 6.11.5 *

NPM 3.10.10

node-gyp

Page 29: Cassia User Manual · Figure 3: Cassia S2000 Bluetooth Router The S2000 extends luetooth’s range up to 1000 feet and expands the number of luetooth low energy devices that can be

29

Copyright © 2019 Cassia Networks, Inc.

Version: EN-12102019-YJ

Name Version

noble

GCC 5.4.0

G++

Additional technical info about the Cassia container can be found here: https://github.com/CassiaNetworks/iot-platform/wiki Please follow the steps below on the router console to install the container. The detailed installation and deployment guide can be found in third Party App Deployment instructions in: https://www.cassianetworks.com/knowledge-base/general-documents/. From firmware 1.4.2, the user can install container from an Android smart phone locally. Please save the container firmware on your smart phone in advance and login router’s local console from WiFi hotspot or router’s private IP. Select and install container firmware:

The container will be uploaded and installed on the router.

Please refresh the web browser. You will see the information of the container and the third-party application.

Page 30: Cassia User Manual · Figure 3: Cassia S2000 Bluetooth Router The S2000 extends luetooth’s range up to 1000 feet and expands the number of luetooth low energy devices that can be

30

Copyright © 2019 Cassia Networks, Inc.

Version: EN-12102019-YJ

Figure 16: Cassia router configuration page -- Container

The Container tab page displays Operating System, Container Status, Container Version, Storage Usage, Transmit Rate, Transmit Bytes, Receive Rate, Receive Bytes, CPU Usage and Memory Usage of the container. The user can also Run, Stop, Reset or Delete the container by clicking the buttons.

Parameter Description Operating System The core of the container, e.g. Ubuntu 16.04.3 in release 1.3

Container Status Working status of the container

Container Version Firmware version of the container

Storage Usage Storage usage and reserved by the container (out of 2.3GB storage)

Transmit Rate Transmit Rate by the container

Transmit Bytes Transmit Bytes by the container

Receive Rate Receive Rate by the container

Receive Bytes Receive Bytes by the container

CPU Usage CPU used by the container (out of 2 CPU cores)

Memory Usage Memory used by the container (out of 128MB RAM)

Page 31: Cassia User Manual · Figure 3: Cassia S2000 Bluetooth Router The S2000 extends luetooth’s range up to 1000 feet and expands the number of luetooth low energy devices that can be

31

Copyright © 2019 Cassia Networks, Inc.

Version: EN-12102019-YJ

Figure 17: Cassia router configuration page – Container cont.

The Container tab page also displays the installed APP on the container and the programs in operation. The user can update the APP by clicking button Select File and Upgrade. From firmware 1.4.2, the user can update the APP from Android smart phone locally. Please save the APP on your smart phone in advance and login router’s local console from WiFi hotspot or router’s private IP.

Figure 18: Cassia router configuration page – container continued

From firmware 1.4.1, the user can configure a maximum of four TCP or UDP ports for container port forwarding. By using this functionality, the user can set up a server (e.g. a web server) in the container and access it via the router’s private IP address and the configured port. The port range is [60000, 65525]. N/A means the port is closed. From firmware 1.4.1, the user can add their own APP configuration console in Cassia router’s local console and AC’s console.

Page 32: Cassia User Manual · Figure 3: Cassia S2000 Bluetooth Router The S2000 extends luetooth’s range up to 1000 feet and expands the number of luetooth low energy devices that can be

32

Copyright © 2019 Cassia Networks, Inc.

Version: EN-12102019-YJ

First, please add meta.json (defines the configuration items) in APP package. On the router’s local console and AC’s console, the user can find their own APP configuration console seen below. After the configuration, the router will generate file config.json under folder /root/config/<app_name>/.

For more information, please check third Party App Deployment instructions here: https://www.cassianetworks.com/knowledge-base/general-documents/.

5.4. Logs Tab

The Logs tab page displays logs of different Level (error, warning, information, debug, etc.) and different Module (WTP, RESTful or Bluetooth). The user can click the Export button to export the logs for further analysis.

Figure 19: Cassia router configuration page – Log

5.5. Other Tab

The Status tab page displays the Portal Password. The default password is admin. When logging in for the first time, the router’s console will require user to change from the default password. A strong password is recommended. The user can update the router’s firmware by clicking the Select File and Upgrade button. If the firmware image is encrypted with *.GPG, please switch on “Verify the validity of the file?”. Turn this feature off if the firmware image is *.gz file format. The latest firmware download is available here:

Page 33: Cassia User Manual · Figure 3: Cassia S2000 Bluetooth Router The S2000 extends luetooth’s range up to 1000 feet and expands the number of luetooth low energy devices that can be

33

Copyright © 2019 Cassia Networks, Inc.

Version: EN-12102019-YJ

https://www.cassianetworks.com/knowledge-base/router-gateway-firmware/. Please note, this download site is password protected for Cassia’s authorized partners. From firmware 1.4.2 and above, the user can update the router’s firmware from an Android smart phone locally. Please download the router firmware on to your smart phone in advance and log into the router’s local console from WiFi hotspot or router’s private IP.

Figure 20: Cassia router configuration page – Other

Time Configuration is used to set the date of the router.

If you want to use HTTPS to access the router web or call local RESTful API, please switch on “Enable HTTPs” and provide the SSL Private Key and SSL Certificate files. Below is an example for generating a self-signed certificate. It is suggested to use CA-signed certificates to secure the security.

openssl genrsa -des3 -out ca.key 2048

openssl req -new -x509 -key ca.key -out ca.crt -days 3650

openssl genrsa -out server.key 2048

openssl req -new -key server.key -out server.csr

openssl x509 -req -days 3650 -in server.csr -CA ca.crt -CAkey ca.key -CAcreateserial -out

Page 34: Cassia User Manual · Figure 3: Cassia S2000 Bluetooth Router The S2000 extends luetooth’s range up to 1000 feet and expands the number of luetooth low energy devices that can be

34

Copyright © 2019 Cassia Networks, Inc.

Version: EN-12102019-YJ

server.crt

The user can also import a dedicated SSL Private Key and SSL Certificate for the secure communication between router and AC.

From firmware 1.4, the user can run network connectivity tools such as Ping, Traceroute, TCP dump and NetCat on the router’s local console. It will help the user to identify the network issues from the router. Below are two examples.

Page 35: Cassia User Manual · Figure 3: Cassia S2000 Bluetooth Router The S2000 extends luetooth’s range up to 1000 feet and expands the number of luetooth low energy devices that can be

35

Copyright © 2019 Cassia Networks, Inc.

Version: EN-12102019-YJ

Example 1: Check if the AC is reachable.

Example 2: Check if the MQTT TCP port 8883 is opened.

The user can click the Reboot button to perform a restart of the router. The user can also click the Reset button to reset the router’s configuration to the default profile settings.

Page 36: Cassia User Manual · Figure 3: Cassia S2000 Bluetooth Router The S2000 extends luetooth’s range up to 1000 feet and expands the number of luetooth low energy devices that can be

36

Copyright © 2019 Cassia Networks, Inc.

Version: EN-12102019-YJ

When the user clicks Export Log File button, the router’s log can be downloaded for troubleshooting. This log is not readable to end users. Please email it to Cassia Support [email protected] for further analysis.

Figure 21: Cassia router configuration page – other continued

If the router is configured as standalone mode (in the Basic tab), the user can configure Bluetooth parameters on the router’s local console. If the router is configured as AC managed mode, the user can only set these parameters on the AC server console. If Default is selected, the router will use a set of pre-defined parameters. If Custom is selected, the user can define the Cassia router’s BLE parameters, e.g. connection interval. The table below shows the default, maximum and minimum value of each parameter.

Parameter Default (ms) Min (ms) Max (ms) Scan Interval 15 2.5 10240 Scan Window 10 2.5 10240 LE Page Scan Interval 60 2.5 10240 LE Page Scan Window 30 2.5 10240 Connection Min Interval 7.5 7.5 4000 Connection Max Interval 30 7.5 4000 Latency 0 0 499 Supervisor Timeout 1000 100 32000

Page 37: Cassia User Manual · Figure 3: Cassia S2000 Bluetooth Router The S2000 extends luetooth’s range up to 1000 feet and expands the number of luetooth low energy devices that can be

37

Copyright © 2019 Cassia Networks, Inc.

Version: EN-12102019-YJ

Figure 22: Cassia router configuration page – Other continued

From firmware 1.4 and above, Cassia supports Azure IoT SDK on X1000 and E1000. The Cassia router must be operated in standalone mode and connected to Azure IoT Hub by MQTT protocol. NOTE: Azure IoT SDK support is a Beta version in firmware 1.4. Please contact [email protected] for Azure beta program details. The user can control the Cassia router by calling the “Direct Method” or “Message to Device” interface. The JSON format is based on local RESTful API (please check Cassia SDK Guide chapter 2). The feedback and data from Cassia router are reported to Azure IoT Hub with JSON format. In addition, the user can POST JSON string from Cassia router container to Azure IoT Hub. First, please set the router to “Standalone Router”, copy Connection String from Azure IoT Hub, and paste it in the Cassia router (see below figures). These are the only configurations needed on the Cassia router.

Page 38: Cassia User Manual · Figure 3: Cassia S2000 Bluetooth Router The S2000 extends luetooth’s range up to 1000 feet and expands the number of luetooth low energy devices that can be

38

Copyright © 2019 Cassia Networks, Inc.

Version: EN-12102019-YJ

5.6. Service Tab

The Cassia router has the capability to send scanned data directly from the router to a third-party server, while keeping the control path to the AC. We call this function “bypass” mode. MQTT (MQ Telemetry Transport) is described on the mqtt.org site as a machine-to-machine (M2M) / IoT connectivity protocol. It is a publish/subscribe messaging transport protocol, designed for constrained devices and low-bandwidth, high-latency or unreliable networks. Since release 1.2, Cassia router supports MQTT protocol on the bypass traffic which means that the Cassia router can publish advertisement messages it receives from the BLE sensors to an MQTT server/broker. Other clients, such as web applications on your laptop and smart phone device can subscribe to the topics from the MQTT-Broker.

Page 39: Cassia User Manual · Figure 3: Cassia S2000 Bluetooth Router The S2000 extends luetooth’s range up to 1000 feet and expands the number of luetooth low energy devices that can be

39

Copyright © 2019 Cassia Networks, Inc.

Version: EN-12102019-YJ

Figure 23: Cassia MQTT Bypass Architecture

When the router is running in AC Managed mode (configured by Router Mode in Basic tab), the user can only configure the router’s MQTT in the AC console. When the router is running in Standalone mode, the user can configure MQTT function in the router console Service tab. The user can setup Scan Mode, filters and MQTT related configurations on this tab.

Figure 24: Cassia router configuration page – Service

Page 40: Cassia User Manual · Figure 3: Cassia S2000 Bluetooth Router The S2000 extends luetooth’s range up to 1000 feet and expands the number of luetooth low energy devices that can be

40

Copyright © 2019 Cassia Networks, Inc.

Version: EN-12102019-YJ

Parameter Description Scan Mode Passive or active scan

• The difference between active and passive scan is that active scan requests a SCAN_RESPONSE packet from the advertiser.

• A passive scan generally takes more time since the router must listen and wait for an advertisement versus actively probing to find an advertiser. However, with the passive scan, devices consume less battery power.

Filter Users can configure filtering by device name, MAC or UUID. NOTE: The keywords used for filtering need to be in the advertisement packets.

Figure 25: Cassia router configuration page – Service continued

For detailed configuration on MQTT, please check MQTT Configuration Guide

here: https://www.cassianetworks.com/knowledge-base/general-documents/.

Page 41: Cassia User Manual · Figure 3: Cassia S2000 Bluetooth Router The S2000 extends luetooth’s range up to 1000 feet and expands the number of luetooth low energy devices that can be

41

Copyright © 2019 Cassia Networks, Inc.

Version: EN-12102019-YJ

5. More information on Access Controller

6.1. Deployment Options

The Cassia AC can be deployed on an on-premise server, in a private cloud or in Cassia’s

public cloud. Administrators can access the Cassia AC from a web-browser, through a PC or

a tablet without any special training.

• On-premise or private cloud

▪ Cassia’s AC1000 appliance or user-provided server

▪ Deployed next to the core network switch

Figure 26: Cassia AC deployment – on premise or private cloud

• Self-managed or Cassia-managed public cloud

▪ Deployed on public clouds like Azure, AWS, Google Cloud, or AliCloud

▪ Setup and maintenance are required

Application

Server

Internet

Exit

Core Switch Cassia AC

Access Access

BT

Routers

Wired Uplink WiFi Uplink 3G/LTE Uplink

Page 42: Cassia User Manual · Figure 3: Cassia S2000 Bluetooth Router The S2000 extends luetooth’s range up to 1000 feet and expands the number of luetooth low energy devices that can be

42

Copyright © 2019 Cassia Networks, Inc.

Version: EN-12102019-YJ

Figure 27: Cassia AC deployment – public cloud

Cassia’s Bluetooth router will auto-discover AC by:

• Specifying the AC’s IP address/domain name in the router’s settings

• Cassia’s distribution system (routers need to have Internet access)

• Broadcasting on the same subnet (routers and the AC need to be in the same subnet)

• DHCP option43 or DNS setting

6.2. AC License

For privately hosted AC server, please contact the Cassia sales team to request your annual AC server license.

• Based on the length of subscription: monthly (for Starter Kit only) or annually

• Number of managed routers: 8, 16, 32, 64, 128, 256, 512, 1024, 2048

6.3. Interface Protocol

Please see the figure below for the interfaces compatible with the Cassia AC server

• By default, the communication between the Cassia routers and the AC is over

CAPWAP. It is a UDP based protocol. The default ports are 5246 and 5247. It uses

DTLS 1.0 before firmware 1.4 and uses DTLS 1.2 from firmware 1.4.

Application

Server

Cassia

AC

Internet

Exit

Core

Switch

Access

Switch

Access

Switch

Cassia Routers

Wired Uplink WiFi Uplink 3G/4G

Page 43: Cassia User Manual · Figure 3: Cassia S2000 Bluetooth Router The S2000 extends luetooth’s range up to 1000 feet and expands the number of luetooth low energy devices that can be

43

Copyright © 2019 Cassia Networks, Inc.

Version: EN-12102019-YJ

From firmware 1.4, the user can select MQTT for the data path protocol between the

Cassia routers and the AC. MQTT is based on TCP, so it improves the robustness of

the router and AC communication. Furthermore, the MQTT protocol has less uplink

management traffic.

When the user selects MQTT in AC Settings page, the AC will use MQTT towards the

routers with firmware 1.4 and keep using CAPWAP towards the routers with

firmware 1.3. The control path protocol (on-line, upgrade, etc.) between the Cassia

routers and the AC is still based on CAPWAP.

NOTE 1: The user needs to open TCP port 8883 on the AC and router side before

enabling MQTT communication.

NOTE 2: This MQTT communication is between the Cassia AC and the router. It is

different than the MQTT bypass function described in section 5.6.

• The interface between the AC and the application server is using RESTful APIs, on

HTTP or HTTPS. For details on Cassia’s RESTful APIs please see the next section. For

more information about how to generate SSL private key and certificate, please see

section 5.5.

Figure 28: Compatible Interfaces with Cassia AC

6.4. Bluetooth Debug Tool

From firmware 1.4, Cassia AC provides a Bluetooth debug tool with UI. This debug tool simplifies the integration of the BLE devices and the user application with the Cassia AC and Bluetooth router.

The user can use the Bluetooth debug tool to select a chip, start and stop the scan, connect and disconnect, pair and unpair, get services, write by the handle, and receive

Page 44: Cassia User Manual · Figure 3: Cassia S2000 Bluetooth Router The S2000 extends luetooth’s range up to 1000 feet and expands the number of luetooth low energy devices that can be

44

Copyright © 2019 Cassia Networks, Inc.

Version: EN-12102019-YJ

notifications and indications. The user can also check the RESTful API, API response messages and the BLE data on the debug tool.

Please connect a Cassia router to the Cassia AC, power on the Bluetooth devices and place them near the Cassia router. Please click the router from the Router list, and click the Tools tab. See the screenshot of the Bluetooth debug tool below.

Figure 29: Bluetooth Debug Tool in Cassia AC

For more information, please check the Cassia AC Bluetooth Debug Tool User Guide here: https://www.cassianetworks.com/knowledge-base/general-documents/.

6.5. Enhanced Locationing

From firmware 1.4, the Cassia Access Controller (AC) provides Enhanced Locationing functionality. The Cassia AC in conjunction with multiple Cassia Bluetooth routers, can triangulate the position of the BLE devices within its coverage.

The Enhanced Locationing function makes full use of RSSI detection by several nearby routers. It can support location tracking of people and assets in real-time.

NOTE: Enhanced Locationing is a Beta version feature in firmware 1.4. Currently, there is no API available.

Page 45: Cassia User Manual · Figure 3: Cassia S2000 Bluetooth Router The S2000 extends luetooth’s range up to 1000 feet and expands the number of luetooth low energy devices that can be

45

Copyright © 2019 Cassia Networks, Inc.

Version: EN-12102019-YJ

Figure 30: Enhanced Locationing in Cassia AC

Page 46: Cassia User Manual · Figure 3: Cassia S2000 Bluetooth Router The S2000 extends luetooth’s range up to 1000 feet and expands the number of luetooth low energy devices that can be

46

Copyright © 2019 Cassia Networks, Inc.

Version: EN-12102019-YJ

7. Cassia RESTful APIs

The Cassia RESTful APIs were developed to enable third-party developers and device

manufacturers to utilize Cassia’s router Bluetooth routing and extended range capabilities

while using their Cloud services to connect and control multiple BLE devices per router

simultaneously. Furthermore, the Cassia RESTful APIs are designed to integrate directly into

the application/server using an HTTP/HTTPS-based communication protocol, which provides

programming language flexibility. Cassia supports C#, Node.js, and Java, but the user can

choose other languages as needed.

The Cassia RESTful APIs are built into the Cassia IoT Access Controller (AC) and Bluetooth

routers and provide the following functions:

a. Connect and control your BLE devices

b. Support three modes: Scanning, Connecting, Broadcasting

c. Write/read data to/from the BLE device via the Cloud server

d. Read data as notification/indication events from the BLE device via the Cloud server

For details on implementation, please read the SDK Implementation Guide here:

https://www.cassianetworks.com/knowledge-base/general-documents/ and Github wiki

site URL here: https://github.com/CassiaNetworks/CassiaSDKGuide/wiki.

7.1. Room-based Location Tracking

The Cassia AC also provides a room-based location tracking API based on the advertising packets from the individual Bluetooth routers.

Below are the major APIs. Please refer to the Cassia SDK Implementation Guide for a detailed description and examples.

• Identify the closest router a BLE device is located

• Obtain the closest router list for all the BLE devices that the AC can detect

• Get the list of BLE devices around a Cassia router

• Get the list of BLE devices for all the routers within the AC

7.2. Secure Pairing

Cassia supports the following Bluetooth 4.1 Secure Simple Pairing on Cassia Bluetooth

routers: Just Works, Passkey Entry, and Legacy OOB. Please refer to the above, SDK

Implementation Guide, Section 5, for Secure Pairing APIs.

Page 47: Cassia User Manual · Figure 3: Cassia S2000 Bluetooth Router The S2000 extends luetooth’s range up to 1000 feet and expands the number of luetooth low energy devices that can be

47

Copyright © 2019 Cassia Networks, Inc.

Version: EN-12102019-YJ

Appendix A: Cassia’s TI Sensor Tag Demo

Cassia’s demonstrations showcase the Cassia Bluetooth routers and AC in use with off-the-shelf BLE devices. Please see the full list at http://www.bluetooth.tech. The following section demonstrates a Cassia Bluetooth router and AC in use with a Texas Instruments (TI) Sensor Tag CC2650STK.

Figure 31: TI Sensor Tag

Page 48: Cassia User Manual · Figure 3: Cassia S2000 Bluetooth Router The S2000 extends luetooth’s range up to 1000 feet and expands the number of luetooth low energy devices that can be

48

Copyright © 2019 Cassia Networks, Inc.

Version: EN-12102019-YJ

To test using a local connection:

a) Select Local Connection on Control and enter the private IP address of your Cassia

Bluetooth router

b) Power on your TI sensor tag. The flashing green light indicates it is working

c) Click the Connect button on the demo page. The TI sensor tag should stop flashing

d) Wait a few seconds and you will see incoming data

Page 49: Cassia User Manual · Figure 3: Cassia S2000 Bluetooth Router The S2000 extends luetooth’s range up to 1000 feet and expands the number of luetooth low energy devices that can be

49

Copyright © 2019 Cassia Networks, Inc.

Version: EN-12102019-YJ

Figure 32: TI SensorTag Demo Page – Local Connection

Figure 33: TI SensorTag Demo Page with Incoming Data

To test using a remote connection:

a) Select Remote Connection on the demo page

b) Enter the AC address, developer key, developer secret and router MAC address

c) Click the red Disconnect All button if you have previously connected the sensor

using local mode. You should see the TI sensor tag flashing in the green light

d) Click the green Connect button on the demo page. The TI sensor tag light should

stop flashing now

e) Wait a few seconds and you will see incoming data

Page 50: Cassia User Manual · Figure 3: Cassia S2000 Bluetooth Router The S2000 extends luetooth’s range up to 1000 feet and expands the number of luetooth low energy devices that can be

50

Copyright © 2019 Cassia Networks, Inc.

Version: EN-12102019-YJ

Figure 34: TI SensorTag Demo Page – Remote Connection

In your AC server console, you will see the sensor tag is connected under Device page.

Figure 35: Cassia AC Device Page

If you power on additional TI sensor tags, they will be connected to the same router one-by-

one.

Page 51: Cassia User Manual · Figure 3: Cassia S2000 Bluetooth Router The S2000 extends luetooth’s range up to 1000 feet and expands the number of luetooth low energy devices that can be

51

Copyright © 2019 Cassia Networks, Inc.

Version: EN-12102019-YJ

Figure 36: TI Sensor Demo Page – With Multiple Sensors

Page 52: Cassia User Manual · Figure 3: Cassia S2000 Bluetooth Router The S2000 extends luetooth’s range up to 1000 feet and expands the number of luetooth low energy devices that can be

52

Copyright © 2019 Cassia Networks, Inc.

Version: EN-12102019-YJ

Appendix B: Supported USB Cellular Modem

a. HUAWEI MS2131i-8

• Cellular Operators: Vodaphone, AT&T, T-Mobile, etc. • Technology & Bands

o 3G (UMTS): B1 (2100MHz) / B2 (1900MHz) / B5 (850 MHz) / B8 (900MHz) o 2G (GSM): B2 (1900MHz) / B3 (1800MHz) / B8 (900MHz) / B5 (850MHz)

• Data rate

o UMTS HSPA+: 21.6Mbps, HSPA: 14.4Mbps, HSDPA: 7.2Mbps, HSUPA: 5.76 Mbps

o GSM EDGE: 236.8kbps, GPRS: 85.6kbps • Size: 84.9 mm x 27 mm x 12.3 mm • Global certifications

b. HUAWEI E3372s-153

• Technology & Bands

o 4G (LTE): B1/3/7/8/20 (800/900/1800/2100/2600 MHz)

o 3G (UMTS): 900/2100 MHz

o 2G (GSM): 850/900/1800/1900 MHz

• Data rate

o LTE FDD: DL: 150Mbps / UL: 50Mbps @20 M BW

o UMTS DCHSPA+: 42Mbps / 5.76Mbps; 21Mbps / 5.76 Mbps; 14Mbps / 5.76Mbps; 7.2Mbps / 5.76Mbps

o GSM EDGE: up to 236.8kbps

• Size: 88 mm x 28 mm x 11.5 mm

• Global certifications

Page 53: Cassia User Manual · Figure 3: Cassia S2000 Bluetooth Router The S2000 extends luetooth’s range up to 1000 feet and expands the number of luetooth low energy devices that can be

53

Copyright © 2019 Cassia Networks, Inc.

Version: EN-12102019-YJ

c. HUAWEI E8372h-153

• Cellular Operators: Verified with T-Mobile network. It should work with AT&T and other LTE networks too.

• Technology & Bands

o 4G (LTE): Band1 (2100 MHz) / Band3 (1800 MHz) / Band7 (2600 MHz)

/ Band8 (900 MHz) / Band20 (800 MHz)

o 3G (UMTS): Band1 (2100 MHz) / Band8 (900 MHz)

o 2G (GSM): 850 MHz / 900 MHz / 1800 MHz / 1900 MHz

• Data rate

o LTE FDD: up to DL 150 Mbps and UL 50 Mbps @20 M BW

o UMTS DC-HSPA+: downlink up to 43.2 Mbps

o UMTS HSUPA: uplink up to 5.76 Mbps

o GSM EDGE: up to DL 296 kbps and UL 236.8 kbps • WiFi hotspot

o WLAN 2.4 GHz o 802.11b, 802.11g, 802.11n o Supports up to 10 WiFi users

• Size: 94 mm x 30 mm x 14 mm

• Global certifications

NOTE: E8372h-153 is for North America, E8372h-608 is for Europe and E8372h-155 is for APAC.

Page 54: Cassia User Manual · Figure 3: Cassia S2000 Bluetooth Router The S2000 extends luetooth’s range up to 1000 feet and expands the number of luetooth low energy devices that can be

54

Copyright © 2019 Cassia Networks, Inc.

Version: EN-12102019-YJ

d. Novatel USB730L

• Cellular Operators: Verizon

• Technology & Bands

o 4G (LTE): USA Bands: B2/B4/B5/B13, Global Bands: B3/B4 o 3G (UMTS): B1 / B2 / B5 / B8 o 2G (GSM): B2 / B3 / B5 / B8 o CDMA EV-DO: BC0 (800Mhz) / BC1 (1900Mhz PCS)

• Size: 83 mm x 35 mm x 11.4 mm (not include USB connector)

• Certifications: FCC (North America), ISED (Canada), GCF, UL2853

NOTE: After the USB cellular modem configuration is completed on the AC or router console, please make sure to power-cycle the router or unplug and re-plug in the USB cellular modem.

In order to fit USB730L into the bottom enclosure of the X1000, the USB connector of U730L should be turned over. Please follow the steps below.

Step 1: Remove the two screws of the USB connector Step 2: Remove the cover with the USB logo

Step 3: Turn over the USB connector Step 4: Put the cover and the two screws back

e. MultiTech MTD-MVW1

• Cellular Operators: Verizon

• Technology & Bands

o 4G (LTE CAT M1): Band4 (AWS 1700Mhz) / Band13 (700Mhz)

Page 55: Cassia User Manual · Figure 3: Cassia S2000 Bluetooth Router The S2000 extends luetooth’s range up to 1000 feet and expands the number of luetooth low energy devices that can be

55

Copyright © 2019 Cassia Networks, Inc.

Version: EN-12102019-YJ

• Data rate: up to downlink 300 Kbps and uplink 375 Kbps

• Size: 78.7 mm x 40.1 mm x 18.8 mm (not include USB cable)

• Environmental o Operating temperature: -40° to +122° F (-40° to +50° C) o Storage temperature: -40° to +185° F (-40° to +85° C) o Humidity: Relative humidity 15% to 93% noncondensing

• Certifications: FCC Class B (US), UL 60950-1

f. MultiTech MTD-MNA1

• Cellular Operators: Verizon, AT&T and other Cellular operators

• Technology & Bands

o 4G (LTE CAT M1)

o Verizon: Band4 (AWS 1700Mhz) / Band13 (700Mhz)

o AT&T: Band2 (1900Mhz) / Band4 (AWS 1700Mhz) / Band12 (700Mhz)

• Data rate, Size and Environmental: same as MultiTech MTD-MVW1

• Certifications: FCC Class B (US), IC (Canada), UL 60950-1

g. MultiTech MTCM-LAT3-B03

• Cellular Operators: AT&T, T-Mobile, and other Cellular operators

• Technology & Bands

o 4G (LTE CAT 1): B2 (1900) / B4 (AWS1700) / B5 (850) / B12 / B13

(700)

o 3G: B2 (1900) / B5 (850)

• Data rate: up to downlink 10 Mbps and uplink 5 Mbps

• Size: 45.5 mm x 53.5 mm x 19.8 mm without antenna (please use flexible ribbon antennas if you want to put MTCM-LAT3-B03 inside X1000 enclosure)

• Environmental o Operating temperature: -40° to +140° F (-40° to +60° C) o Storage temperature: -40° to +185° F (-40° to +85° C) o Humidity: Relative humidity 15% to 85% noncondensing

• Certifications: FCC Class B (US), IC (Canada)

Page 56: Cassia User Manual · Figure 3: Cassia S2000 Bluetooth Router The S2000 extends luetooth’s range up to 1000 feet and expands the number of luetooth low energy devices that can be

56

Copyright © 2019 Cassia Networks, Inc.

Version: EN-12102019-YJ

h. MultiTech MTCM-LNA3-B03

• Cellular Operators: Verizon, AT&T, T-Mobile

• Other specifications are same as MTCM-LAT3-B03

i. Zoom 4615

• Cellular Operators: Verizon

• Technology & Bands

o 4G (LTE CAT 1): Band4 (AWS 1700Mhz) / Band13 (700Mhz)

• Data rate: up to downlink 10 Mbps and uplink 5 Mbps

• Size: 80.9 mm x 50.4 mm x 15 mm (without antenna)

• Environmental o Operating temperature: -22° to +140° F (-30° to +60° C) o Storage temperature: -40° to +185° F (-40° to +85° C) o Humidity: 5% to 95%

• Certifications: FCC Part 15B, ITE Safety

j. Zoom 4630

• Cellular Operators: AT&T, T-Mobile, and other Cellular operators

• Technology & Bands

o 4G (LTE CAT 1): B2/4/5/12

o 3G (UMTS): 850/1700/2100(AWS)/1900 MHz

Page 57: Cassia User Manual · Figure 3: Cassia S2000 Bluetooth Router The S2000 extends luetooth’s range up to 1000 feet and expands the number of luetooth low energy devices that can be

57

Copyright © 2019 Cassia Networks, Inc.

Version: EN-12102019-YJ

• Data rate o LTE CAT 1: up to downlink 10 Mbps and uplink 5 Mbps o HSPA: up to DL 7.2Mbps and UL 5.76 Mbps

• Size and Environmental: same as Zoom 4615

• Certifications: FCC Part 15B, ITE Safety, ISED Canada

k. ConnectedIO EM1000T-VZ-CAT1

• Cellular Operators: Verizon

• Technology & Bands

o 4G (LTE CAT 1): Band2 (1900 MHz) / Band4 (1700 MHz) / Band13

(700 MHz)

• Data rate: up to downlink 10 Mbps and uplink 5 Mbps

• Size: 84 mm x 57 mm x 17.79 mm without antenna (please put EM1000T-VZ-CAT1 outside of X1000 enclosure)

• Power input: 5V DC 0.5A

• Operating temperature: -22° to +185° F (-30°C to +85°C)

• Certifications: FCC Part 15 Class B, RoHS, Verizon Open Development, Verizon Private Network

Page 58: Cassia User Manual · Figure 3: Cassia S2000 Bluetooth Router The S2000 extends luetooth’s range up to 1000 feet and expands the number of luetooth low energy devices that can be

58

Copyright © 2019 Cassia Networks, Inc.

Version: EN-12102019-YJ

Appendix C: EU WEEE Directive

Waste Electrical and Electronic Equipment (WEEE) symbol on the Cassia Bluetooth router

and/or accompanying documents means that used electrical and electronic equipment

(WEEE) should not be mixed with general household waste. Disposing of this product

correctly will help save valuable resources and prevent any potential negative effects on

human health and the environment, which could otherwise arise from inappropriate waste

handling.

If you wish to discard electrical and electronic equipment (EEE) in the European Union,

please contact your dealer or supplier for further information. Penalties may be applicable

for incorrect disposal of this waste, in accordance with your national legislation.

For more questions, please contact [email protected].