Cassia X2000 User manual

1
Copyright © 2021 Cassia Networks, Inc.
Version: EN-20210624-YJ
Cassia Networks, Inc.
97 East Brokaw Road, Suite 130
San Jose, CA 95112
[email protected]
Cassia Gateway Installation Guide
Release date: June 24, 2021
Contents
1. Version Notice..................................................................................................................2
2. Network Requirement......................................................................................................2
3. Find Gateway’s MAC Address.........................................................................................3
4. Setup using WiFi Hotspot................................................................................................3
5. Setup using Ethernet Connection...................................................................................5
6. Configure AC Server Address.........................................................................................6
7. Setup Gateway Name.......................................................................................................6
8. Configure Uplink Network ...............................................................................................7
9. CAPWAP and MQTT Setting............................................................................................7
10. Enable Local RESTful API and OAuth2 Token ...............................................................8
11. Add Gateway to AC........................................................................................................11
11.1. Login AC..............................................................................................................................11
11.2. Discover the Gateways.......................................................................................................11
11.3. Add the Gateways...............................................................................................................12
12. Upgrade the Gateway ....................................................................................................12
13. Gateway Configurations and Sign out..........................................................................14
14. Trouble Shooting Tips ...................................................................................................15
14.1. Gateway does not generate a WIFI hotspot.......................................................................15
14.2. Forget local web password or make a mistake while configuring the WIFI .......................15
14.3. Wi-Fi or USB cellular uplink is not stable............................................................................15
14.4. Gateway can’t connect to AC..............................................................................................16
14.5. Check if a Bluetooth device can be scan or connect..........................................................17
14.6. Check Bluetooth scan and connect performance in planning and deploy phase ..............18
14.7. Check the multiple connection performance and the throughput....................................... 19
15. Contact Cassia Support ................................................................................................20

2
Copyright © 2021 Cassia Networks, Inc.
Version: EN-20210624-YJ
1. Version Notice
This document describes the steps of installing a Cassia gateway with firmware v1.3 or
above. If the user is using firmware 1.2, please follow
https://www.cassianetworks.com/download/docs/Cassia_Quick_Start_Guide-v1.2.pdf
In this guideline, the Cassia gateway is running in AC Managed mode. If the gateway is
running in standalone mode (no AC), please skip chapters 6/9/11.
2. Network Requirement
From v2.1.1, for the gateways that uses MQTT to communicate with AC (default setting),
the following ports are used and required for firewall configuration. TCP ports 80, 443 and
9999 are not required anymore.
Please make sure the following ports are opened outbound on the gateway side firewall.
Type
Port
M/O
Description
TCP
8883
Mandatory
Gateway-AC communication
UDP
53
Mandatory*
DNS lookup for AC address. *Optional if internal DNS
is specified in gateway network configuration
TCP
1883
Optional
For MQTT bypass function only
For the gateways that use CAPWAP to communicate with AC or the gateways using
firmware below v2.1.1, the following ports may be used and required for firewall
configuration.

3
Copyright © 2021 Cassia Networks, Inc.
Version: EN-20210624-YJ
Please make sure the following ports are opened outbound on the gateway side firewall.
The user can check if a TCP port is opened by using Netcat in gateway’s local console.
Type
Port
M/O
Description
UDP
5246, 5247*
Mandatory
Gateway-AC communication based on CAPWAP. *Port
5246 and 5246 can be disabled after migrating gateway-
AC communication to MQTT
TCP
8883
Gateway-AC communication based on MQTT
(recommended from firmware v2.0.2)
HTTP
80*
Mandatory
Container and APP download from AC based on HTTP.
*HTTP port 80 can be disabled if HTTPS is enabled
HTTPS
443
Container and APP download from AC based on HTTPS
UDP
53
Mandatory*
DNS lookup for AC address. *Optional if internal DNS
is specified in gateway network configuration
TCP
9999
Mandatory
Remote SSH to container (laptop->8001->AC<-9999<-
container)
TCP
1883
Optional
For MQTT bypass function only
3. Find Gateway’s MAC Address
Please find Cassia gateway’s MAC address on the bottom of the gateway.
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 the below table for the details.
Model
Label MAC
Ethernet MAC
WIFI MAC
X2000/X1000/E1000/S2000
MAC
MAC
MAC+1
S1000/S1100
MAC
MAC
MAC-1
4. Setup using WiFi Hotspot
From firmware 1.2, the Cassia Bluetooth gateway provides a WIFI hotspot (2.4GHz only) for
initial setup. Its SSID is cassia-xxxxxx (the xxxxxx corresponds to the last 6 digits of the

4
Copyright © 2021 Cassia Networks, Inc.
Version: EN-20210624-YJ
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”.
Gateway’s WIFI hotspot (2.4GHz only)
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, and you are sure that your firmware is 1.2 or above,
please press and hold the reset button at the bottom of Cassia gateway for 10 to 15
seconds while the gateway is powered on.
Cassia Gateway Reset Button
Please open Google Chrome on your laptop and enter the gateway’s default IP address
192.168.40.1. The default web username and password is admin/admin.
The first time you log in, the system will ask you to change the default password. The
password should include numbers, characters, and special characters. The password length
should be between 8-20. Please note down your new password for future use.

5
Copyright © 2021 Cassia Networks, Inc.
Version: EN-20210624-YJ
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 the 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
Enable Local SSH Login
OFF
AC-Gateway Protocol Priority
MQTT (this configuration is available from firmware 2.0.2)
Now, please log in to the gateway’s web page with the new password.
Cassia gateway’s web login page
5. Setup using Ethernet Connection
If you don’t have a laptop that 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.

6
Copyright © 2021 Cassia Networks, Inc.
Version: EN-20210624-YJ
6. Configure AC Server Address
Configure AC address in Cassia gateway’s web
The user can skip this step in the below scenarios.
•If the gateway and the AC are in the same network and DHCP is configured in the
network, AC can discover the gateways automatically.
•If the user needs to configure more Cassia gateways at the same time, it is better to
use DHCP server option 43 to help the gateways to find the AC. IP gateway will serve
as a DHCP relay.
•If the gateway is configured as standalone mode, there will be no AC.
7. Setup Gateway Name
From firmware v2.1.1, the user can setup gateway name from the gateway’s local webpage.
The user can still setup gateway’s name from AC as before.
This is very useful for the user who doesn’t share AC account to the engineers that install
the Bluetooth gateway. When a new Bluetooth gateway is installed, the user will identiy this
gateway on AC by the gateway name easily, for example “Gateway 1 in factory A”.

7
Copyright © 2021 Cassia Networks, Inc.
Version: EN-20210624-YJ
8. Configure Uplink Network
The Cassia Bluetooth Gateway supports Ethernet (Wired), WIFI, and USB cellular modems
as networking uplinks.
Please check Cassia User Manual for more information. In this guideline, we use Ethernet as
an example.
Below is the configuration with wired and DHCP.
Setup network configuration for your gateway
9. CAPWAP and MQTT Setting
Before firmware 2.0.2, Cassia Bluetooth gateway communicates with AC using CAPWAP
protocol. CAPWAP is based on UDP port 5246 and 5247 and uses DTLS 1.2 to ensure
security.
From firmware 2.0.2, the user can also select MQTT for the communication between
gateways and AC. MQTT uses TCP port 8883 and TLS 1.2. MQTT improves the robustness of
gateway and AC communication.
The user can set the preferred gateway-AC protocol by setting parameter “AC-Gateway
Protocol Priority” on AC or gateway’s console. First, the gateway will use the preferred
protocol to connect AC. If it failed, e.g. port is blocked by the firewall, the gateway will try
the other protocol automatically.
NOTE: From firmware 2.0.3, the default “AC-Gateway Protocol Priority” on the gateway is
MQTT. If the gateway was upgraded from lower versions, the default value will be CAPWAP.

8
Copyright © 2021 Cassia Networks, Inc.
Version: EN-20210624-YJ
After the gateway is online, the user can find the actually used protocol by checking “AC-
Gateway Protocol” on AC or gateway’s console.
For more information about MQTT and CAPWAP, please check Cassia User Manual.
10. Enable Local RESTful API and OAuth2 Token
This step is only valid for the users who want to use RESTful APIs on the local gateways (not
through AC or in a container). From firmware 2.0.3, the user can enable the OAuth2 token
for Cassia local RESTful API to improve the security. The default value is off.

9
Copyright © 2021 Cassia Networks, Inc.
Version: EN-20210624-YJ
From firmware 1.3, if the gateway is configured as standalone mode, local RESTful API will
be automatically turned on. If the gateway is configured as AC managed mode, the local
RESTful API will be automatically turned off.
(v1.3) Configuration of Gateway Mode on Gateway Console
From firmware 1.3, the user can still enable the local RESTful API from the AC console like
below, even if the gateway is configured as AC managed mode.

10
Copyright © 2021 Cassia Networks, Inc.
Version: EN-20210624-YJ
(v1.3) Turn on Local RESTful API in AC Console
Before firmware 1.3, the user needs to turn on Local RESTful API in the AC console or
gateway console manually. By default, it is OFF. Please see the below figures.
(v1.2) Turn on Local RESTful API in AC Console