Cassia X2000 User Manual
  1. Manuals
  2. Brands
  3. Cassia Manuals
  4. Gateway
  5. X2000
  6. User manual

Cassia X2000 User Manual

Hide thumbs Also See for X2000:
Table of Contents

Advertisement

Quick Links

Contents
1.
What is a Cassia Gateway? .............................................................................................. 3
1.1.
Cassia X2000 ........................................................................................................................ 3
1.2.
Cassia X1000 ........................................................................................................................ 5
1.3.
Cassia E1000 ........................................................................................................................ 6
1.4.
Cassia S2000 ........................................................................................................................ 7
1.5.
Certified Country List ............................................................................................................. 8
2.
Installation ...................................................................................................................... 10
2.1.
X2000 .................................................................................................................................. 10
2.2.
X1000 .................................................................................................................................. 15
2.3.
E1000 .................................................................................................................................. 17
2.4.
S2000 .................................................................................................................................. 19
3.
Deployment .................................................................................................................... 22
3.1.
X1000 and X2000 ............................................................................................................... 22
3.2.
E1000 and S2000 ............................................................................................................... 23
4.
Getting Started ............................................................................................................... 25
4.1.
Understanding the Cassia Access Controller ....................................................................... 25
4.2.
AC Server Resource Requirements ................................................................................... 25
4.3.
Licenses Key and Developer Key/Secret ........................................................................... 26
4.4.
Network Requirement ......................................................................................................... 27
4.5.
CAPWAP and MQTT Setting .............................................................................................. 28
4.6.
Connecting the Gateway to AC........................................................................................... 30
5.
Cassia Bluetooth Gateway Configurations .................................................................. 33
5.1.
Status Tab ........................................................................................................................... 33
5.2.
Basic Tab ............................................................................................................................ 34
5.2.1.
Wired Settings ..................................................................................................................... 37
5.2.2.
Wi-Fi Settings ...................................................................................................................... 37
5.2.3.
USB Cellular Modem ........................................................................................................... 40
5.3.
Container Tab ..................................................................................................................... 43
5.4.
Events Tab .......................................................................................................................... 51
5.5.
Other Tab ............................................................................................................................ 52
5.6.
Service Tab ......................................................................................................................... 63
6.
More information on Access Controller ....................................................................... 66
6.1.
Deployment Options ............................................................................................................ 66
6.2.
AC Statistics ........................................................................................................................ 67
6.3.
Interface & Protocol ............................................................................................................. 68
6.4.
Bluetooth Roaming .............................................................................................................. 68
6.5.
Add Gateways in AC ........................................................................................................... 70
Cassia User Manual
Release date: March 9, 2023
Copyright 2023 Cassia Networks, Inc.
1
Version: EN-2023039-YJ
Cassia Networks, Inc.
97 East Brokaw Road, Suite 130
San Jose, CA 95112
support@cassianetworks.com

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the X2000 and is the answer not in the manual?

Questions and answers

Related Manuals for Cassia X2000

Summary of Contents for Cassia X2000

  • Page 1: Table Of Contents

    97 East Brokaw Road, Suite 130 San Jose, CA 95112 support@cassianetworks.com Cassia User Manual Release date: March 9, 2023 Contents What is a Cassia Gateway? ....................3 1.1. Cassia X2000 ........................3 1.2. Cassia X1000 ........................5 1.3. Cassia E1000 ........................6 1.4.
  • Page 2 6.12. Backup AC Configuration ....................82 Cassia RESTful APIs...................... 84 Appendix A: Cassia’s TI Sensor Tag Demo ................. 86 Appendix B: Supported USB Cellular Modems ..............91 Appendix C: WPA2 Enterprise Security ................93 Appendix D: EU WEEE Directive ..................99 Appendix E: Configurable MQTT TLS Certificates for Gateway-AC Communication ..

  • Page 3: What Is A Cassia Gateway

    Furthermore, the range extension does not require replacing existing Bluetooth Low Energy end devices, nor is it dependent on Bluetooth Mesh. In bi-directional mode, the X2000 can pair and connect up to 40 end devices. In broadcast/advertising mode, it can listen to hundreds of end devices.
  • Page 4 Appendix F for more information. X2000 supports Power over Ethernet (PoE) and a 12V DC power source. It can easily attach to a pole or wall with an included mounting kit or can be placed on a flat space with an optional desktop stand kit.

  • Page 5: Cassia X1000

    1.2. Cassia X1000 The Cassia X1000 enterprise Bluetooth gateway 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.

  • Page 6: Cassia E1000

    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.

  • Page 7: Cassia S2000

    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.

  • Page 8: Certified Country List

    One certification for one customer Thailand NBTC 2023/2024 Brazil ANATEL Cassia provides local rep South Africa ICASA & NRCS One certification for one customer Chile SUBTEL Colombia Mexico IFT & NYCE 2023/2024 One certification for one customer Copyright 2023 Cassia Networks, Inc. Version: EN-2023039-YJ...
  • Page 9 India 2023/2024 Cassia provides local rep Indonesia SDPPI 2023/2024 One certification for one customer Philippines Pakistan 2023/2024 Cassia provides local rep Global Global Copyright 2023 Cassia Networks, Inc. Version: EN-2023039-YJ...

  • Page 10: Installation

    12 W. Please don't use PoE and 12V DC at the same time.  Optional external Bluetooth antennas. The connector on X2000 is a 50 Ohm N type female connector. The antenna and cable should have N type male connector.
  • Page 11 Included in Package The screws in the X2000 package are ST4.2×25. The user can use longer ST4.2 screws or ST5 screws too. If the user uses bigger screws, e.g. ST6, it will be difficult to install X2000’s mounting bracket. Head and base Copyright 2023 Cassia Networks, Inc.
  • Page 12 Mounting and installation Please select the corresponding steps according to your gateway configurations. Install USB Cellular modem inside X2000 Install USB Cellular modem outside X2000 Copyright 2023 Cassia Networks, Inc. Version: EN-2023039-YJ...
  • Page 13 Ethernet cable through the cable gland, insert the RJ-45 connector into the Ethernet port of X2000, and tighten the cable gland in the order of a, b, c. The torque of step c should be less than the torque of step a.
  • Page 14 X2000 box or a small pointed tool of your choosing to depress the plastic release tab on the cable. See the image below. Connect 12V DC power cable and cable gland to X2000 in the same way as step 5 For outdoor X2000 installations, please connect the ground cable to ensure X2000’s safety Copyright 2023 Cassia Networks, Inc.

  • Page 15: X1000

     Cassia X1000 Gateway  Power-over-Ethernet (POE) 802.3af/at compliant source, or PoE injector if PoE network is not available. The Cassia X1000 is only powered via Power-over-Ethernet (PoE)  CAT5 Ethernet cable with standard RJ45 connector (Patch cord): 1 unit if PoE available, or 2 units if used with PoE injector.
  • Page 16 Connect the X1000 to Ethernet cable and ground cable; Grounding is suggested, especially when X1000 is installed outdoors. Install silicon plugs (please skip this step if the ground cable is installed); Copyright 2023 Cassia Networks, Inc. Version: EN-2023039-YJ...

  • Page 17: E1000

    Connect the X1000 Gateway to the PoE injector or a PoE switch. 2.3. E1000 Hardware  Cassia E1000 Gateway  Power-over-Ethernet (PoE) 802.3af/at compliant source, or PoE injector if PoE network is not available Copyright 2023 Cassia Networks, Inc. Version: EN-2023039-YJ...
  • Page 18 Place the E1000 on a flat, unobstructed surface or mount it using the supplied mounting kit in a vertical or horizontal orientation; If mounting, first screw the mounting plate onto wall or ceiling; Copyright 2023 Cassia Networks, Inc. Version: EN-2023039-YJ...

  • Page 19: S2000

     Power-over-Ethernet (PoE) 802.3af/at compliant source, or PoE injector if PoE network is not available  CAT5 Ethernet cable with standard RJ45 connector (Patch cord): 1 unit if PoE available, or 2 units if used with PoE injector Copyright 2023 Cassia Networks, Inc. Version: EN-2023039-YJ...
  • Page 20 3. Connect the S2000 to power with the supplied Micro USB cable and power adapter and to a Wi-Fi Access Point via Ethernet or Wi-Fi (2.4GHz only). For your network setting information, please contact your IT administrator. Copyright 2023 Cassia Networks, Inc. Version: EN-2023039-YJ...
  • Page 21 4. Place the S2000 gateway at a slight angle against the mounting plate and twist it into place (turn clockwise). Copyright 2023 Cassia Networks, Inc. Version: EN-2023039-YJ...

  • Page 22: Deployment

    3.1. X1000 and X2000 Cassia’s Bluetooth gateway coverage varies based on conditions. In outdoor “open-air” locations with no obstructions, the coverage radius of Cassia’s Bluetooth gateways is greater than indoor locations with walls and obstructions. In general, the radius of outdoor coverage may vary from 100 meters to 400 meters with Bluetooth 4.x or even to 1 kilometer with Bluetooth 5.0, depending on the wireless...

  • Page 23: E1000 And S2000

    3.2. 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 Bluetooth Low Energy device, and within 180 to 1000 feet (60-300 meters) range of the device.
  • Page 24 E1000 and S2000 Indoor Deployment Copyright 2023 Cassia Networks, Inc. Version: EN-2023039-YJ...

  • Page 25: Getting Started

    For more details, please see the Cassia IoT Access Controller Server Data Sheets here: https://www.cassianetworks.com/resources/cassia-iot-access-controller/ The 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.

  • Page 26: Licenses Key And Developer Key/Secret

    If you plan to use AWS EC2 to host your Cassia IoT AC, please select instance type T2 or M4, which uses intel CPU. For example, you can use t2.medium for an AC that manages less than 50 gateways.

  • Page 27: Network Requirement

    For MQTT bypass function only (see chapter 5.6) 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. Copyright 2023 Cassia Networks, Inc. Version: EN-2023039-YJ...

  • Page 28: Capwap And Mqtt Setting

    TCP based MQTT protocol is more reliable on internet than UDP based CAPWAP protocol. If the AC and gateways are connected through the internet, and the Cassia RESTful API through the AC is used to collect Bluetooth device data, it is highly recommended to disable CAPWAP ports in AC Settings page, which will force all the gateways to connect to the AC through MQTT.
  • Page 29 “AC-Gateway Protocol” on the AC console gateway Details tab or gateway console Status tab. 6) When all the gateways managed by one AC have been migrated to MQTT, the user can disable CAPWAP ports on the AC setting page. Copyright 2023 Cassia Networks, Inc. Version: EN-2023039-YJ...

  • Page 30: Connecting The Gateway To Ac

    4.6. Connecting the Gateway to AC You will find your Cassia Bluetooth gateway’s MAC address located at the bottom of the gateway. Cassia Bluetooth gateway’s MAC address If you are filtering MAC addresses in your security policy, please make sure to input the active MAC addresses.
  • Page 31 Wi-Fi hotspot will be enabled, and the gateway login password will be reset. You can also reset gateway’s login password through the AC. X2000 Reset Button X1000 Reset Button E1000 Reset Button Copyright 2023 Cassia Networks, Inc. Version: EN-2023039-YJ...
  • Page 32 Hotspot Wi-Fi / SSID cassia-xxxxxx Wi-Fi / Password cassia-xxxxxx UTC +08:00 Local Time Zone Local Time 1970-01-02, 00:00:00 Enable Local SSH Login MQTT (this configuration is available from firmware 2.0.2) AC-Gateway Protocol Priority Copyright 2023 Cassia Networks, Inc. Version: EN-2023039-YJ...

  • Page 33: Cassia Bluetooth Gateway Configurations

    NOTE: The Google Chrome browser is preferred as results may vary with other browsers. To configure the gateway, please open the Cassia Bluetooth gateway’s local console by entering its local IP address or access it from the gateway’s Wi-Fi hotspot. The user can also configure the gateways by gateway auto configuration feature (chapter 6.6), or configure the...

  • Page 34: Basic Tab

    Description Model X2000, X1000, E1000 or S2000. This is the MAC address printed on the bottom of the Cassia Bluetooth gateway, which is equal to the gateway’s Ethernet interface MAC. Working Mode AC Managed mode means the Cassia Bluetooth Gateway is connected to the Cassia IoT Access Controller and managed by the AC.
  • Page 35 3/8/11/15/19 dBm. The default Tx power of X1000 is 20dBm and is configurable in 5/10/13/20 dBm. The Tx power of Japan E1000, S2000, and X2000 is fixed in 8dBm. The Tx power of Japan X1000 is fixed in 10dBm.
  • Page 36 OAuth on each gateway. For the user using Cassia RESTful API in the container, it is not necessary to do OAuth authentication. Remote Assistance Turn this on will enable Cassia engineers to remotely access the gateway for troubleshooting purposes. By default, this function is off.

  • Page 37: Wired Settings

    This allows the user to connect to the gateway via Wi-Fi using a laptop or mobile device for configuration purposes. The Cassia Bluetooth gateway will advertise an SSID: cassia-xxxxxx (the “x’s” correspond to the last 6-digit of the gateway’s MAC address). For additional details, see section 4.6.
  • Page 38 DNS. NOTE: 1. X1000 and S2000 only support 2.4GHz Wi-Fi. E1000 and X2000 support both 2.4GHz and 5GHz Wi-Fi. Wi-Fi hotspot mode only supports 2.4GHz. 2. The country code should be set correctly when using 5G Wi-Fi. Otherwise, 5G Wi-Fi may not work correctly.
  • Page 39 Password, CA Certificate, Client Certificate, Private Key, and Private Key Password. Cassia gateway configuration page – Wi-Fi Security Mode From firmware 2.0, the user can set two Wi-Fi SSID as uplinks for redundancy. Gateway will switch to the secondary Wi-Fi SSID automatically if the first SSID can’t be detected or can’t be connected.

  • Page 40: Usb Cellular Modem

    < -65 5.2.3. USB Cellular Modem Cassia’s gateway 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.
  • Page 41 Cassia gateway configuration page – USB cellular modem 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 are KORE Wireless APN. If you are using a SIM card from another cellular operator, please contact the cellular operator for the right APN.
  • Page 42 Peer NDS IPV6 With a USB cellular modem, the Cassia Bluetooth gateway needs to be in a place where there is good cellular network coverage. From firmware 2.0, the user can check the cellular signal strength on AC (AC->Gateway->Details->Uplink) or gateway console Copyright 2023 Cassia Networks, Inc.

  • Page 43: Container Tab

    “Recover Action” to ON, Cassia gateway will power reset the USB cellular modem (X2000) or reset the USB interface (other gateways) if it can’t reconnect to the cellular network in 10 minutes. For an AC managed gateway, if the cellular connection can’t be recovered in one hour, the gateway will soft reboot automatically.
  • Page 44 NOTES for v2.0.3 firmware  Before firmware 2.0.3, when HTTPS is enabled on the gateway, the Cassia API URL used in the container APP should be updated to use port 443. From firmware 2.0.3, port 80 between container and gateway firmware is always enabled, so APP doesn’t need to be updated regardless of the gateway’s HTTPS settings.
  • Page 45  If you want to upgrade an existing APP, please make sure that the name and/or version is different.  Cassia gateway container uses a compact version of Ubuntu. Certain packages may not be pre-installed and/or available.  Please consider compiling your application code in a full development environment before loading and attempting to run in the container.
  • Page 46 7.68.0 ASP.NET Core 3.1.16 Please follow the steps below on the gateway console to install the container. The detailed installation and deployment guide can be found in Cassia Custom Application Deployment Instructions in https://www.cassianetworks.com/support/knowledge-base/general- documents/. From firmware 1.4.2, the user can install a container from a smartphone locally. Please save the container firmware on your smartphone in advance and login gateway’s local console...
  • Page 47 The container will be uploaded and installed on the gateway. Please refresh the web browser. You will see the information of the container and the custom application. Cassia gateway configuration page -- Container Copyright 2023 Cassia Networks, Inc. Version: EN-2023039-YJ...
  • Page 48 Memory Usage Memory used by the container (out of 128MB RAM for E1000 and X1000, and out of 700MB RAM for X2000) Cassia gateway configuration page – Container cont. The Container tab page also displays the installed APP on the container and the programs in operation.
  • Page 49 IP address of the gateway is 10.10.10.254/24. The IP address of the container is 10.10.10.253/24. APP in the container can call local RESTful API like below (Turn on scanning as an example). $curl –v 10.10.10.254/gap/nodes/?event=1&active=1 Copyright 2023 Cassia Networks, Inc. Version: EN-2023039-YJ...
  • Page 50 The port range is [60000, 65525]. N/A means the port is closed. Cassia gateway configuration page – container continued From firmware 1.4.1, the user can add their own APP configuration console in Cassia gateway’s local console and AC’s console.

  • Page 51: Events Tab

    After the configuration, the gateway will generate file config.json under folder /root/config/<app_name>/. The user can also Run, Stop, Reset or Delete the container by clicking the buttons. For more information, please check Cassia Custom Application Deployment Instructions here: https://www.cassianetworks.com/support/knowledge-base/general-documents/. 5.4. Events Tab The Events tab page displays events of different Level (Info, Major, etc.) and different...

  • Page 52: Other Tab

    If the firmware image is encrypted with *.gpg, please switch on “Verify GPG File Encryption?”. Please turn it off, if the firmware image is *.gz file format. From 2022 May 1 Cassia will only deliver gpg format firmware for Cassia Bluetooth gateway types, except for S2000.
  • Page 53 For example, when using the Bluetooth debug tool, please set “Access Control Allow Origin” and “Allow Origin” to * or the URL of the requesting page http://www.bluetooth.tech. Please refer to http://www.bluetooth.tech/debugger2/dist/Debugger2- Troubleshooting.pdf for detailed instruction. Copyright 2023 Cassia Networks, Inc. Version: EN-2023039-YJ...
  • Page 54 The user can import a dedicated SSL Private Key and SSL Certificate for the secure communication between gateway and AC. Cassia gateway always uses secured CAPWAP and MQTT to communicate with AC, no matter if default or custom certificates are used.
  • Page 55 The user can enable TPM (Trusted Platform Module) on X2000 to further enhance the safety level. Please note, the startup time of X2000 will increase from 40 seconds to about 80 seconds. By default, the TPM will be disabled. This configuration is only available on the gateway website.
  • Page 56 From firmware 2.1.1, the user can run the Network Diagnostic tool on the gateway’s local console. Network Diagnostic tool can help you to assess the gateway’s network status during the deploying and troubleshooting phase. Copyright 2023 Cassia Networks, Inc. Version: EN-2023039-YJ...
  • Page 57 Wi-Fi interface is up and has got the IP, the DNS works well, ping to AC success, and the TCP and TLS connection to the AC also works fine. The www.cassianetwork.com sandbox.cassia.pro is used as a reference for the diagnostics. Copyright 2023 Cassia Networks, Inc. Version: EN-2023039-YJ...
  • Page 58 Below are examples for Ping, NetCat, and SpeedTest. Example 1: Check if the AC is reachable. Example 2: Check if the MQTT TCP port 8883 is opened. Copyright 2023 Cassia Networks, Inc. Version: EN-2023039-YJ...
  • Page 59 To minimize cybersecurity risks, please remember to click the Sign Out button after the gateway configuration. Cassia gateway configuration page – other continued From firmware 2.0.3, the user can download the gateway debug log from AC too (see below screenshot). Only one gateway’s debug log can be downloaded from AC at the same time. It may take 2-5 minutes (time out in 10 min) to download one gateway debug log.
  • Page 60 If Custom is selected, the user can define the Cassia gateway’s Bluetooth Low Energy parameters, e.g. connection interval. The table below shows the default, maximum and minimum values of each parameter.
  • Page 61 Gateway -> Config-> Bluetooth Setting, or gateway console -> Other -> Bluetooth Setting). Otherwise, Bluetooth operations in the APP may return failure. Cassia Bluetooth stack and Cassia RESTful API offer the state of the art Bluetooth scan and connection performance. It is highly recommended to keep the Cassia Bluetooth stack open and use Cassia RESTful API to achieve the best performance Bluetooth IoT system.
  • Page 62 Device” interface. The JSON format is based on local RESTful API. The feedback and data from Cassia gateway are reported to Azure IoT Hub in JSON format. Also, the user can POST JSON string from Cassia gateway container to Azure IoT Hub.

  • Page 63: Service Tab

    5.6. Service Tab The Cassia gateway can send scanned data directly from the gateway 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.
  • Page 64 Cassia gateway configuration page – Service To reduce MQTT packets and MQTT overheads, the gateway can cache a maximum of 100 advertisement packets or a maximum of 60 seconds, and send them to the MQTT broker together. Copyright 2023 Cassia Networks, Inc.
  • Page 65 However, with the passive scan, devices consume less battery power. Filter Scan filters for advertisement packets • Name: supports full name, prefix (for example Cassia*) and suffix (for example *Cassia) name filters • MAC: supports full MAC and prefix MAC filters (for example CC:DD:EE*) •...

  • Page 66: More Information On Access Controller

    6. 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 Cassia’s public cloud. Administrators can access the Cassia AC from a web-browser, through a PC, or a tablet without any special training.

  • Page 67: Ac Statistics

    Cassia’s Bluetooth gateway will auto-discover AC by:  Specifying the AC’s IP address/domain name in the gateway’s settings  Cassia’s distribution system (gateways need to have Internet access)  Broadcasting on the same subnet (gateways and the AC need to be in the same subnet) ...

  • Page 68: Interface & Protocol

    AC. 6.3. Interface & Protocol Please see the figure below for the interfaces compatible with the Cassia AC server  Before firmware 2.0.2, the communication between the Cassia Bluetooth gateways and the AC is over CAPWAP.
  • Page 69 Bluetooth gateway with a stronger RF signal when moving from the coverage area of one Bluetooth gateway to the next. Cassia invented fast and secure Bluetooth roaming technology to solve this problem without requiring any changes to the Bluetooth protocol and/or end devices.

  • Page 70: Add Gateways In Ac

    Cassia’s IoT AC and Cassia’s Bluetooth gateways.  All Bluetooth gateways under the Cassia IoT Access Controller (AC) function as a single gateway from the mobile device perspective  No security renegotiation (e.g. re-pairing etc.) is needed, and the user data connection remains continuous during roaming handoff ...

  • Page 71: Gateways Auto Configuration

    AC address in gateway’s local console. When AC address is empty, the gateway will search and connect to AC in the LAN automatically. In this case, the gateways can be configured automatically by AC without touching the gateway’s local console. Copyright 2023 Cassia Networks, Inc. Version: EN-2023039-YJ...

  • Page 72: Gateway Batch Configuration

    (first time online or each time online), and then save the configuration. The current configuration can be exported into a file. The format of the configuration complies with JSON format of Cassia RESTful API “Obtain Cassia Router’s Configuration”. Please check below link for more information about this API (https://github.com/CassiaNetworks/CassiaSDKGuide/wiki/RESTful-API#obtain-cassia-...
  • Page 73 Only the same type (S2000, E1000, X1000, or X2000) of gateways can be configured in batches. TIPS: You can select a specific type of gateway through the filter on the top left. If you want to configure more gateways at once, please select showing 100 gateways per page in the lower-left corner.
  • Page 74  CAPWAP port  Local RESTful API  Remote assistance The following Bluetooth parameters can be configured in batches  Cassia Bluetooth stack switch  Avoid 2.4G Interference: Reduce interference between 2.4GHz Wi-Fi and Bluetooth  Scan mode parameters  Connection mode parameters Copyright 2023 Cassia Networks, Inc.
  • Page 75  Add secondary WIFI: it will work as the backup WIFI SSID if the gateway failed to connect to the first WIFI SSID The cellular modem configuration needs to be configured on the local console of the gateway. They can’t be configured in batches from AC. Copyright 2023 Cassia Networks, Inc. Version: EN-2023039-YJ...
  • Page 76 The parameters of the bypass function can be configured in batches too. Copyright 2023 Cassia Networks, Inc. Version: EN-2023039-YJ...
  • Page 77 Now, you can save the configuration. After clicking the corresponding save button, the batch configuration will start. You can check the progress and results (success or failure) of the configuration on AC. Copyright 2023 Cassia Networks, Inc. Version: EN-2023039-YJ...
  • Page 78 (see the red part in the below figure), and try to configure these gateways again later. Similarly, you can also perform batch upgrades, restarts, and resets for the Bluetooth gateways. You can also perform batch operations for the containers and APPs. Copyright 2023 Cassia Networks, Inc. Version: EN-2023039-YJ...

  • Page 79: Bluetooth Debug Tool

    Bluetooth Low Energy data on the debug tool. Please connect a Cassia gateway to the Cassia AC, power on the Bluetooth devices, and place them near the Cassia gateway. Please click the gateway from the Gateway list, and click the Tools tab.

  • Page 80: Enhanced Locationing

    From firmware 2.0, the Cassia IoT Access Controller (AC) provides Enhanced Locationing functionality and the corresponding RESTful API (is a Beta version now). The Cassia IoT AC in conjunction with multiple Cassia Bluetooth gateways can triangulate the position of the Bluetooth Low Energy devices within its coverage.

  • Page 81: System Notification

    Enhanced Locationing in Cassia AC 6.10. System Notification From firmware 2.0, the Cassia Access Controller (AC) provides system notification function. AC will send email alerts to you in the below conditions.  AC CPU/RAM/storage usage is higher than 80%: maximum one email every day ...

  • Page 82: Multiple Ac Viewer

    ACs. To add a new AC to the monitoring list, please provide the AC Address, Developer Key & Secret (in AC setting page) of the AC. 6.12. Backup AC Configuration Copyright 2023 Cassia Networks, Inc. Version: EN-2023039-YJ...
  • Page 83 For security reasons, the Developer Key and Developer Secret is not exported to the backup file. Please input your Developer Key and Developer Secret in AC setting page after importing the backup file. You can find them in your IoT application. Copyright 2023 Cassia Networks, Inc. Version: EN-2023039-YJ...

  • Page 84: Cassia Restful Apis

    Room based and triangle-based location tracking Cassia RESTful API supports HTTP (port 80) and HTTPS (port 443). We strongly suggest you to use HTTPS. Please switch on “Enable HTTPS” in AC setting page and fill in your SSL server certificate and private key.
  • Page 85 ‘evt_type’ to ‘evtType’. This is to keep consistent with local API in which ‘evtType’ is used. For example, {"bdaddrs":[{"bdaddr":"E1:D2:F8:F9:82:E0","bdaddrType":"random"}],"adData":"020100000 00000000000000000","name":"(unknown)","rssi":-29,"evtType":0} For details on Cassia RESTful API guidelines, please check the Github wiki site: https://github.com/CassiaNetworks/CassiaSDKGuide/wiki. Copyright 2023 Cassia Networks, Inc. Version: EN-2023039-YJ...

  • Page 86: Appendix A: Cassia's Ti Sensor Tag Demo

    Cassia’s demonstrations showcase the Cassia Bluetooth gateways and AC in use with off-the- shelf Bluetooth Low Energy devices. Please see the full list at http://www.bluetooth.tech. The following section demonstrates a Cassia Bluetooth gateway and AC in use with a Texas Instruments (TI) Sensor Tag CC2650STK.
  • Page 87 To test using a local connection: a) Select Local Connection on Control and enter the private IP address of your Cassia Bluetooth gateway 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 Copyright 2023 Cassia Networks, Inc.
  • Page 88 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 Copyright 2023 Cassia Networks, Inc. Version: EN-2023039-YJ...
  • Page 89 In your AC server console, you will see the sensor tag is connected under the Device page. Cassia AC Device Page If you power on additional TI sensor tags, they will be connected to the same gateway one- by-one. Copyright 2023 Cassia Networks, Inc. Version: EN-2023039-YJ...
  • Page 90 TI Sensor Demo Page – With Multiple Sensors Copyright 2023 Cassia Networks, Inc. Version: EN-2023039-YJ...

  • Page 91: Appendix B: Supported Usb Cellular Modems

    Appendix B: Supported USB Cellular Modems Please check the excel table on the next page. Copyright 2023 Cassia Networks, Inc. Version: EN-2023039-YJ...
  • Page 92 E8372h- Huawei E8372h-820 (China, added 802.11g, 802.11n); Supports up to 10 Wi-Fi 2G (GSM EDGE): up to DL 296 Kbps and UL 236.8 320/820 Cassia router can connect to this modem in firmware v2.1.1) users. Kbps Multiple Carriers Mini SIM (2FF)

  • Page 93: Appendix C: Wpa2 Enterprise Security

     Only the PEM certificate file format is supported.  For private keys, Cassia has tested des, des3, seed, and aes. Camellia is not supported. The user needs to set the Wi-Fi operation mode to “Client”, set the “Safe Mode” and “EAP Type”...
  • Page 94  EPA Type: TTLS-MSCHAPV2 or TTLS-PAP The user should provide Identify, Password, and CA Certificate, besides SSID, IP, and DNS options. Below is an example. Copyright 2023 Cassia Networks, Inc. ...
  • Page 95 Private Key Password, besides SSID, IP, and DNS options. Below is an example.  Safe Mode: WPA2-PSK or WPA[TKIP]+WPA2[AES] When setting “Safe Mode” to WPA2-PSK or WPA[TKIP]+WPA2[AES], the Cassia gateway behavior is the same as firmware v1.3. The user should configure SSID, Password, IP, and DNS options.
  • Page 96  Safe Mode: None If a password is not needed, the user should set “Safe Mode” to None. In this case, only SSID and IP should be configured. Below is an example. Copyright 2023 Cassia Networks, Inc. ...
  • Page 97 -----BEGIN CERTIFICATE----- MIIDdTCCAl2gAwIBAgIJANeiouNsNcHlMA0GCSqGSIb3DQEBCwUAMFExCzAJBgNV BAYTAlhYMRUwEwYDVQQHDAxEZWZhdWx0IENpdHkxHDAaBgNVBAoME0RlZmF1bHQg Q29tcGFueSBMdGQxDTALBgNVBAMMBHRlc3QwHhcNMTgxMDMwMTA0NjQ5WhcNMjgx MDI3MTA0NjQ5WjBRMQswCQYDVQQGEwJYWDEVMBMGA1UEBwwMRGVmYXVsdCBDaXR5 MRwwGgYDVQQKDBNEZWZhdWx0IENvbXBhbnkgTHRkMQ0wCwYDVQQDDAR0ZXN0MIIB IjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAymWBDuwiacayEuFG1BtvJF3Z qu0OzyOExNh2cyuNx+rxgcy0CECkvDqXAvOOIpV5+C7SO39j5i3y6lIv6q8HbtQd J04Fxjb//RJsPDG9GtK+RnC/p81Xi2o3AUJ6K8eLPhwsikt1nQaXCetT03JZKMQm 3cSqu2nyjJWowpHTr7cVTk8S6mZJBiLMPX6YOCTae1cR98JBlWfquRe9e/XJQAOw /iq/51LAtHmee+x8eaai8/516bHsuVppYYIhqg4YNATeqsGT0BlQNrwjXekPx4KY X3YmAP9EXBqApKts4ACIGcPLig81vKgd6hChTc6eK2yXW0dTuOMtkwTP+KOGiwID AQABo1AwTjAdBgNVHQ4EFgQUXHdieYTw3ZOWAGLJDRRF6S0FIpswHwYDVR0jBBgw FoAUXHdieYTw3ZOWAGLJDRRF6S0FIpswDAYDVR0TBAUwAwEB/zANBgkqhkiG9w0B AQsFAAOCAQEAs3r/C51AJcpUxPvUT4XSVycMNH79gSYwbLsoBRC0r7YK04enIZ7r fi6I0Dl3R6Qbp0ergt80QrBmGLI1nCPyqft0pUfCPaZEGrQhCo58r8NSQyCnSm67 mqzBrs3JIlvZixi/0rU1vaq5lFaJq6HaKiN0gJDuJPC1XX5Fern+/cGsBpFCzfG9 c/ouim3PB03M6UG+FBSX9UDpf/pTRfWnRzgmbITH5nMv/tXHKoNCQcCRYqkSgQ6L kmncU8ajvWVOkJdztrtdsxHatcxlLaD79jd7hpETMjoOdpYuBRz7zs2K5SELw9QU 1g1YyMALL8wZCU2CBNbSCyzBL4DJrMug3g== -----END CERTIFICATE----- client.key example: -----BEGIN RSA PRIVATE KEY----- Proc-Type: 4,ENCRYPTED DEK-Info: DES-CBC,5F85A1BB8701F03D Copyright 2023 Cassia Networks, Inc. ...
  • Page 98 SU0CBRYQG05DXaTHic/724cLWjoDeJ/u+KUuPfaJkaU3bEZq+5+Gso8UVt8hSlnx ppy4FvSSB8Tsg095P8lmZBSp2qt9+sy0sBxiHW/7XayP66gQAUFuBESkioCamlEz VdAOiC1KrDQunR3z3/nNFtHMehFurQkyYgICq5EuqUhF3i6ILDyTSLHiEtf19JeG ZxtRb/Vk2JU0HZ/UmGNWVI5Z9i953ltTfRrnH7+fGQVpIMhIZug+OGmyJi3flLQe Q/vpUpMtPFdFSaz+eIb0OtI8XJoMuWwKDMhJdNHfqkOls3BZZUvoQUC1umwAq9ov CmeYXxJT3HXBRzGFL9UjJ47jM8JDEtOOqDpkXJLGhiAh8Ty8bHQKEfWgsYdkvxsY RJ2igsijvXMJu63etx/zTCJq4fcK/Ev5XOoPQdx5mLM/PWdJYtyj0A== -----END RSA PRIVATE KEY----- client.crt example: -----BEGIN CERTIFICATE----- MIIDHDCCAgQCCQCMtSyQfdk92zANBgkqhkiG9w0BAQsFADBRMQswCQYDVQQGEwJY WDEVMBMGA1UEBwwMRGVmYXVsdCBDaXR5MRwwGgYDVQQKDBNEZWZhdWx0IENvbXBh bnkgTHRkMQ0wCwYDVQQDDAR0ZXN0MB4XDTE4MTEwMTAyMTMyOVoXDTI4MTAyOTAy MTMyOVowTzELMAkGA1UEBhMCWFgxFTATBgNVBAcMDERlZmF1bHQgQ2l0eTEcMBoG A1UECgwTRGVmYXVsdCBDb21wYW55IEx0ZDELMAkGA1UEAwwCdHQwggEiMA0GCSqG SIb3DQEBAQUAA4IBDwAwggEKAoIBAQDDPrVoQCFUXBgA807fkgrkYdF+ozeO3CGI GJRxa3YsGVZ9TIcRe9L/oOkiOyomQbqRRGFcbULqmPyBAymtZoAkNOGGXP7nrco4 NOQA7dVPC6ueZi+gYWCuMOkKO8D8JVZnMZfctbymYLWNvIN8+TqAGV49+rSPU1wd 56eh26YJ4Wnq5gY1jPG9I233Tyq05Br6hFv79ZIOFSsqwK3rGd2447bh3yMb4ah2 qm+He78hK2XwV6X2M7UyUUTYwIo40hcc4k7edTK/thxqyUK3aCHQEUKK8ruF/BI7 dufVtH0k0srSLNJ3svsRh6VK5Rwi1CezABkknBQjcpWChcJcG8lVAgMBAAEwDQYJ KoZIhvcNAQELBQADggEBAAfAnL6vIYh/IjlbdUMMSsdvWiAYIiSyWrLyz3ZeGs4u lUaagR4evVNPTq7ToAbvtaDd0PTPoJkfVxVN65Rc/TtlwnkGh+GmQhk5twjEMUrs 7vDBkdYDOv3ZqHSpeFCDTwn1rO6HpV2h+it7EqhVlpyYow2QA1VMVgNJr7fBWMsY AJsIepors/nGjBm57cQKMcmU8T6O5mYFGpaVlpM/q+1rm/zl7pmo4ghit1fiVlRi HS0YB9ZbjVdwMbazf4m07h8x5vE8CzId9bD6ByWebANcOoy8z6fTSLUaifLU11D6 s92moajRMu6Dl5rnPvHFSwsofCjd4b7bZ2AUpGJeqTo= -----END CERTIFICATE----- Copyright 2023 Cassia Networks, Inc. ...

  • Page 99: Appendix D: Eu Weee Directive

    Appendix D: EU WEEE Directive Waste Electrical and Electronic Equipment (WEEE) symbol on the Cassia Bluetooth gateway and/or accompanying documents means that used electrical and electronic equipment (WEEE) should not be mixed with general household waste. Disposing of this product...

  • Page 100: Appendix E: Configurable Mqtt Tls Certificates For Gateway-Ac Communication

    AC. The certificate can be a CA certificate or a self-signed certificate. Cassia gateway always uses the secured MQTT to communicate with AC, no matter if the default or custom certificate is used.
  • Page 101 NTP time servers on the AC setting page. The AC time will be used for certificate validation. If the AC time is not configured correctly, the gateway can’t connect to the AC. Copyright 2023 Cassia Networks, Inc. ...
  • Page 102 On the AC Settings page, please change MQTT Certificate Configuration from Default to User Config. Then, please fill in the CA Certificate, Server Certificate, and Server Private Key. Default means using the default certificate provided by Cassia. The gateway and AC communication is still protected.
  • Page 103 The user can set the Certificate Configuration back to Default to exclude any other issues, e.g. transport issue. The user can find TLS error logs in the gateway console Log tab. Copyright 2023 Cassia Networks, Inc. ...
  • Page 104 -new -key client.key -out client.csr openssl x509 -req -days 3650 -in client.csr -CA ca.crt -CAkey ca.key -CAcreateserial - out client.crt // generate client certificate ca.crt example: -----BEGIN CERTIFICATE----- MIIDdzCCAl+gAwIBAgIJALSD+kQkX3FuMA0GCSqGSIb3DQEBCwUAMFIxCzAJBgNV BAYTAkFVMRMwEQYDVQQIDApTb21lLVN0YXRlMSEwHwYDVQQKDBhJbnRlcm5ldCBX aWRnaXRzIFB0eSBMdGQxCzAJBgNVBAMMAmRkMB4XDTE5MDUwNTAzMDk0NloXDTIw MDUwNDAzMDk0NlowUjELMAkGA1UEBhMCQVUxEzARBgNVBAgMClNvbWUtU3RhdGUx Copyright 2023 Cassia Networks, Inc. ...
  • Page 105 -----BEGIN RSA PRIVATE KEY----- MIIEogIBAAKCAQEAvlwkLoVBJ3a/HPQ+7mcM4YuDls6txnmmV6WMhZ7BGPw+6P3Z XzzDHRPkx8OAUSfzxUThmegNt1t6fCorESGvc9di0aFWvJB9xVQQdiocPIuZ+8Sb Gj9m2dsmhCgn++7kea/Eusat0kVYUVnm8cMaN4/2xvrli1n4+bKZ+hGb7gV6IOuJ XDelfRRFFANXKSBBgLSqkLxXWBT4I7DC6Cjdp9jidAmRqmuHG3923xTzkhVbBtiG bq04SB3kfb6L139nB1O2z0V/+oH0G+CkuJQ94ZF/EmfLzipv6jSY/fCMSKzcGCQZ 3j/gbEsQYAG6v/PZ1S5XE+A1nKQ87qzMrsG2HwIDAQABAoIBACWVNYOFxY5QEH1b 74zMBawGCm3c0kxMOj41rh+3bzJKovUHIUJ/UZpNEi8qdwwO0j8RUWU8fnDD+9PF 04jnWKeLT7RJoUFLWbl61mEuATMm8LjXYTP2boz2io0vDG3eBXfM7w9dKHZKQJyX HlR/C48KulMgt+8iTVinHWVU0q9UR9+f8PTMxUThkVHh+F+BoMBhcKpXAJZruBWc oXyBlTF5T4Lt7neszHVkY6qx7E7yxVC7XY82zBExJPIu8/AzELONHT9F0DhioBJs iBPu18HK6fdLXPZDMhZX3CB0cvYSwRni5cCVLpqIcQJ5oJ6F+ZRu2xB2rPJlHBAw I/iDJsECgYEA9IUaY7elUliz9GdrmHynh4po70AZEoOviiayww1TyEsz2ho20jDq Svm03aemUod8sDdDwp/ajmcL3thhC3thFCVB1ZbSmq13DD269SDUK+fnr4roiv56 BVZnSdASa8rZim3qpDin7NblGVpEAiRax7Vmuy0Bi6bbhBxmF9/vL/8CgYEAx0wW JWkaU5WR/d1MTIsnRA/u/3CJukkkbOnOZPlW9YbG7MQAWEh40tToyhqdAWC4MxS8 jAq5q10AGA83v7qIeRiFr6u8VBL02yUaxjzRvpaL10frv/VCDEA7B0YSxFd8y4xt lK4kXOzjJ5OqyO11BS00iUIGbIacN1Jcd4AneeECgYAL9TpuJ/wAw+/BAxHC+k2j FkS9dpADVMdP5UaWvV8ci3j0sJV/v/6lPgL3WAyNOq0BXSKGMRUaI7Xz5vcP/a+o sY2/qUmRYOxSf+5VsI5Pu16cOhnXOkyzWB9i/7b26Ius9mUkNNUZgwTfMYfj5u09 mQR2IORTdQyFMHJZtozW9wKBgDO5YpIJCiUhT4eUlMXU47b9b6jqG0S20PZXZBK+ x7vnY991KyW+gWUujtBNQexmnsfbHOg3rGJ2O50C7hQbpGnRXHjwWGt1lAkAQ0ep 50HQrrCL4Pqr+51UWj2UCTDeB+yIILSS0aswa/AMmimVv2Y9ikIJWcN22DpfbNIy 94vhAoGAHNA6PAhP72+ze83Jz8ihEvpfIPJ1ekTpAsoE2EvfCtzMp+qtGV32wG3Q IYNtsvn3/fBQGAMeDBCDjaeFH4ZRY42A+G6RURftDiOzuaCicH+d0IHez2HqY+OO wC/sPSzYUeL9EST+WsehiUzZ2SSeIZa9qWjoCRdUECsxI9ifQBk= -----END RSA PRIVATE KEY----- client.crt example: Copyright 2023 Cassia Networks, Inc. ...
  • Page 106 -----BEGIN CERTIFICATE----- MIIDKzCCAhMCCQDgCfVlo1FF7TANBgkqhkiG9w0BAQsFADBSMQswCQYDVQQGEwJB VTETMBEGA1UECAwKU29tZS1TdGF0ZTEhMB8GA1UECgwYSW50ZXJuZXQgV2lkZ2l0 cyBQdHkgTHRkMQswCQYDVQQDDAJkZDAeFw0xOTA1MDUwNzM3NDNaFw0yMDA1MDQw NzM3NDNaMF0xCzAJBgNVBAYTAkFVMRMwEQYDVQQIDApTb21lLVN0YXRlMSEwHwYD VQQKDBhJbnRlcm5ldCBXaWRnaXRzIFB0eSBMdGQxFjAUBgNVBAMMDTE5Mi4xNjgu MC4yNDUwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQC+XCQuhUEndr8c 9D7uZwzhi4OWzq3GeaZXpYyFnsEY/D7o/dlfPMMdE+THw4BRJ/PFROGZ6A23W3p8 KisRIa9z12LRoVa8kH3FVBB2Khw8i5n7xJsaP2bZ2yaEKCf77uR5r8S6xq3SRVhR Webxwxo3j/bG+uWLWfj5spn6EZvuBXog64lcN6V9FEUUA1cpIEGAtKqQvFdYFPgj sMLoKN2n2OJ0CZGqa4cbf3bfFPOSFVsG2IZurThIHeR9vovXf2cHU7bPRX/6gfQb 4KS4lD3hkX8SZ8vOKm/qNJj98IxIrNwYJBneP+BsSxBgAbq/89nVLlcT4DWcpDzu rMyuwbYfAgMBAAEwDQYJKoZIhvcNAQELBQADggEBACc9mAkv9ErVQO7v7JrxweoJ XnYcq4jlHIo9S7x5flTou2C4GVp1231jVRjzxJs3yQ0o+Xj8WsePHLpITNZRmYOS SnAR/AhA3tUejHbfJsDKvsjHPBdG83hJ9MhQ1friyHiWVrMxVoPrPpvynG7mKN/i FSQlxh9bTwHtTWhBJ5X1bqOnJaz69qaumGvSIIey3IklLKJhs4LC5ADn4HHa2Xfs pRXC69CfPrYg/grTUPAY3uV/tPdTUDwCwxnvchR4bLgP4gUW6PSNvZ4MxRBx+ulx f9Z4+5j5cnmDhafUdBtE4Vs809VlfK5hgwvIy2gzZjONBLQvFKqN5duwNvr08EM= -----END CERTIFICATE----- Copyright 2023 Cassia Networks, Inc. ...

  • Page 107: Appendix F: Cassia Gateway Led Indicators

    * HW models E3372s-153, E3372h-153 and E8372h are DHCP cellular modems. MultiTech models MTCM-LNA3-B03 and MTCM2-L4G1 are PPPoE cellular modems. If you want to know the type of other USB cellular modems, please contact your Cassia sales/support contact E1000/S2000 LED (Green)
  • Page 108 X1000 LED (Blue) Function Status Description Power off Power status Solid on Power on X1000 LED may keep on blinking if the PoE power supply is not stable. Please try to replace the PoE injector. Copyright 2023 Cassia Networks, Inc. ...

  • Page 109: Appendix G: China Rohs

    此环保使用期限只适用于产品在产品手册中所规定的条件下工作。 The Environment-Friendly Use Period is valid only when the product is operated under the conditions defined in the product manual. Copyright 2023 Cassia Networks, Inc. ...

  • Page 110: Appendix H: Antenna Radiation Graphs

    Appendix H: Antenna Radiation Graphs 1. X2000 and X1000’s Internal Bluetooth Antenna If you place your gateway as depicted in the image above, the images below show the Antenna Gain in 3-D. Copyright 2023 Cassia Networks, Inc. ...
  • Page 111 E1000 and S2000’s Internal Bluetooth Antenna If you place the E1000 and S2000 on a tabletop (shown above), the radiation pattern graph results are shown below. Copyright 2023 Cassia Networks, Inc. ...
  • Page 112 Copyright 2023 Cassia Networks, Inc. ...

  • Page 113: Appendix I: Accessory Options

    X2000’s Radio Cables Antenna Length (m) Connector NJ-2 N Male - N Male NJ-5 N Male - N Male Customized Customized Customized X2000’s Optional Desktop Stand Kit For more questions regarding Cassia products, please contact support@cassianetworks.com. Copyright 2023 Cassia Networks, Inc. ...

This manual is also suitable for:

X1000E1000S2000

Table of Contents