Develco Squid.link User manual

Squid.link gateway AWS IoT
Core: Getting started
Revised 04.11.2020

Getting started AWS IoT Core Squid.Link
Develco Products A/S
Tangen 6
http://develcoproducts.com
DK-8200 Aarhus N
[e-mail]
2
Content
1Cautionary notes ......................................................................................................................................................................................................................4
2Getting started with Squid link gateway..................................................................................................................................................................5
2.1 Installation manual.............................................................................................................................................................................................................5
3Squid Smart APP API intro ................................................................................................................................................................................................ 6
3.1 API Documentation............................................................................................................................................................................................................7
3.2 Adding devices to the gateway ............................................................................................................................................................................... 8
4AWS IoT Core handler..........................................................................................................................................................................................................9
4.1 AWS IoT Core ........................................................................................................................................................................................................................9
4.2 Configuring AWS IoT......................................................................................................................................................................................................11
4.2.1 Set up your AWS account.................................................................................................................................................................................11
4.2.2 Creating a thing and certificates ..................................................................................................................................................................12
4.2.3 Creating a policy..................................................................................................................................................................................................... 14
4.2.4 Ca certificate............................................................................................................................................................................................................. 15
4.2.5 AWS IoT server URL............................................................................................................................................................................................. 16
4.3 Configuring Squidsmart api AWS IoT Handler..............................................................................................................................................17
4.4 Whitelisting devices....................................................................................................................................................................................................... 18
5Interoperability with Device Shadows over MQTT......................................................................................................................................... 19
6Updates.......................................................................................................................................................................................................................................22
7Contact Information ............................................................................................................................................................................................................22
8References ................................................................................................................................................................................................................................22
Copyright © Develco Products A/S
All rights reserved.

Getting started AWS IoT Core Squid.Link
Develco Products A/S
Tangen 6
http://develcoproducts.com
DK-8200 Aarhus N
[e-mail]
3
Develco Products assumes no responsibility for any errors, which may appear in this manual. Furthermore, Develco
Products reserves the right to alter the hardware, software, and/or specifications detailed herein at any time without
notice, and Develco Products does not make any commitment to update the information contained herein.
All the trademarks listed herein are owned by their respective owners.

Getting started AWS IoT Core Squid.Link
Develco Products A/S
Tangen 6
http://develcoproducts.com
DK-8200 Aarhus N
[e-mail]
4
1Cautionary notes
Develco Products A/S reserves the right to make changes to any product to improve reliability without further
notice. Develco Products A/S does not assume any liability arising out of the application or use of any product or
circuit described herein; neither does it convey any license under patent rights or the rights of third parties.

Getting started AWS IoT Core Squid.Link
Develco Products A/S
Tangen 6
http://develcoproducts.com
DK-8200 Aarhus N
[e-mail]
5
2Getting started with Squid link gateway
The Squid.link Gateway is an open Linux platform including multiple wireless networks for communication with IoT
devices like Smart meters, Smart Sensors, Smart plugs, Smart Thermostats etc. The gateway is modular and can
handle many different wireless protocols at the same time.
The Squid.link Gateway has options for ZigBee, Z-Wave, Wireless M-Bus, Bluetooth Low Energy (BLE), and WLAN
HAN networks. Communication with servers and e.g. smartphones can be established via WLAN, Ethernet (to local
modem) or cellular networks. The price is extremely competitive since you will only pay for your selected
communication modules.
The gateway includes processor power to implement even very complex local intelligence. The memory options
leave room for data storage and logging. You are no longer dependent on one vendor but can combine your Home
Area network exactly the way you prefer.
Figure 1 Squid.link Gateway
The Squid.link Gateway is configured when put into production. You can also design the appearance of the Gateway
the way you want. There are numerous design and color options that can be tailored according to your needs.
Further description of the Squid.link gateway can be found using the link - Squid.link Gateway [1]
2.1 Installation manual
The installation manual for the gateway can be found at the below link. Please go to Download / Squid.link
Gateway/Installation Manual section at the bottom of the page - Squid.link gateway installation manual

Getting started AWS IoT Core Squid.Link
Develco Products A/S
Tangen 6
http://develcoproducts.com
DK-8200 Aarhus N
[e-mail]
6
Figure 2 Squid.link Gateway Installation Manual
3Squid Smart APP API intro
The Squid Smart App is a middleware application that allows developers to communicate with smart home
appliances in a protocol-agnostic fashion which is achieved by displaying all devices as a resource in the REST API.
The application should run on the Develco Products Squid.link Gateway. The application is prepared for
communicating with devices using different wireless technologies. Currently, the application supports ZigBee,
Wireless M-Bus, and Bluetooth technologies.
The Squid Smart App offers the REST API, and each device linked to the gateway is modelled as an API resource
and it relies on easy-to-read templates to identify which resources are accessible. The datapoints that belong
logically together are grouped in a logical device. The Squid Smart App offers various ways of connection to the
cloud/server side system by using MQTT, raw socket, web socket and AWS IoT handlers. The choice of connection
is defined based on customer and use case requirement. Chapter 4 elaborates more on AWS IoT core handler.

Getting started AWS IoT Core Squid.Link
Develco Products A/S
Tangen 6
http://develcoproducts.com
DK-8200 Aarhus N
[e-mail]
7
Figure 3 Gateway Architecture with Squid Smart APP as middleware
To illustrate the concept there is an example below showing the URL of the onoff datapoint of a smartplug. In this
case it is device 1 and the name of the logical device is “smartplug”. {hostname} should be replaced by the hostname
or IP of the gateway (E.g.,hostname can be gw-244A, where 244A is the last four digits of gateway serial number at
the back of the gateway). In the default configuration the API is available on port 80. If the application has been
configured to use another port, remember to include the port number in the URL.
Error! Hyperlink reference not valid.
The logical device named Smart Plug also contains datapoints for reading current, voltage and consumed energy.
The device also has a logical device named diagnostic which contains datapoints for reading network link strength,
etc.
The application has been designed so that it’s possible to discover which resources are available. To get a list of
devices send a GET request to:
http://{hostname}/ssapi/zb/dev/
To get the list of logical endpoints on a specific device send a GET request to:
http://{hostname}/ssapi/zb/dev/{device no}/ldev/
3.1 API Documentation
The API doc is also available directly on the gateway or Internet. It can be accessed at the following URLs:
http://[hostname]/api-docs/interactive/index.html#/
http://api.squid.link/

Getting started AWS IoT Core Squid.Link
Develco Products A/S
Tangen 6
http://develcoproducts.com
DK-8200 Aarhus N
[e-mail]
8
The interactive documentation will allow you to try out the API calls directly from the browser.
Figure 4 Squid Smart API
The API can be accessed over HTTP or by connecting to a WebSocket or a raw socket. When using HTTP the
message pattern is request/response. The WebSocket and raw socket wrap the REST API and adds support for
push messages. Messages are pushed when a resource is: added, removed or updated.
The raw socket can be access on port 10000 and only from localhost. The WebSocket and HTTP interface is
available on port 80. The port number can be changed in the configuration file.
3.2 Adding devices to the gateway
The ZigBee handler takes care of adding and discovering devices. When a device has been discovered and a
matching template has been found the handler will add all the appropriate resources to the API.
A ZigBee device can be added in three ways:
1. Adding with EUI
a. This is done by sending a POST request with the eui of the ZigBee device to /zb/dev. It is
recommended to also include the installcode for improved security.

Getting started AWS IoT Core Squid.Link
Develco Products A/S
Tangen 6
http://develcoproducts.com
DK-8200 Aarhus N
[e-mail]
9
2. Enable scan mode
a. Scan mode is enabled by sending a PUT request to /zb. By setting the autoAdd option to false any
found device will be added to the list of prospects. The devices which should be added to the API
should be added afterwards using method 1. Alternatively, the devices can be added automatically
by setting autoAdd to true.
b. The list of prospects can be read by sending a GET request to /zb. If connected to a WebSocket
or a raw socket the prospects list will be pushed every 5 seconds while the scan is active.
3. Adding with barcode
a. Devices can be added similar to method 1. Only not adding the eui and install code but instead
the string read from the device barcode (currently supports DP and EnOcean barcode formats)
Figure 5 Adding a zigbee device using API
4AWS IoT Core handler
4.1 AWS IoT Core
AWS IoT enables Internet-connected devices to connect to the AWS Cloud and lets applications in the cloud
interact with Internet-connected devices. Common IoT applications either collect and process telemetry from
devices or enable users to control a device remotely.
The block diagram below gives an overview of the AWS IoT system. The goal is to integrate squid.Link gateway with
AWS IoT Core to facilitate access to all connected devices underneath the gateway.

Getting started AWS IoT Core Squid.Link
Develco Products A/S
Tangen 6
http://develcoproducts.com
DK-8200 Aarhus N
[e-mail]
10
Figure 6 AWS IoT Core system [2]
The state of each device connected to AWS IoT is stored in a device shadow. The Device Shadow service manages
device shadows by responding to requests to retrieve or update device state data. The Device Shadow service
makes it possible for devices to communicate with applications and for applications to communicate with devices.
Communication between a device and AWS IoT is protected through the use of X.509 certificates. AWS IoT can
generate a certificate or we can use our own. In either case, the certificate must be registered and activated with
AWS IoT, and then copied onto your device. When a device communicates with AWS IoT, it presents the certificate
to AWS IoT as a credential. It is recommended that all devices that connect to AWS IoT have an entry in the registry.
The registry stores information about a device and the certificates that are used by the device to secure
communication with AWS IoT.
Figure 7 Logical representation of a smart home with IoT devices connected to the cloud via a gateway and AWS
IoT Core
You can create rules that define one or more actions to perform based on the data in a message. For example, you
can insert, update, or query a DynamoDB table or invoke a Lambda function. Rules use expressions to filter
messages. When a rule matches a message, the rules engine triggers the action using the selected properties. Rules
also contain an IAM role that grants AWS IoT permission to the AWS resources used to perform the action [2].