Getting started AWS IoT Core Squid.Link Content Cautionary notes ............................................4 Getting started with Squid link gateway .................................. 5 Installation manual..........................................5 Squid Smart APP API intro ........................................ 6 API Documentation ..........................................7 Adding devices to the gateway ....................................8 AWS IoT Core handler ..........................................9...
Page 3
Getting started AWS IoT Core Squid.Link 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.
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.
Further description of the Squid.link gateway can be found using the link - Squid.link Gateway [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...
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.
Getting started AWS IoT Core Squid.Link 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...
Getting started AWS IoT Core Squid.Link 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 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.
Page 10
Getting started AWS IoT Core Squid.Link Figure 6 AWS IoT Core system 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.
Getting started AWS IoT Core Squid.Link To configure AWS IoT handler on the gateway, the following configuration parameters are required : • AWS IoT server URL • Thing name from AWS IoT core • CA certificate from AWS IoT core •...
On the Creating AWS IoT things page, choose Create a single thing. On the Add your device to the device registry page, enter a name for your IoT thing (for example, Squid.Link 1, and then choose Next. You can't change the name of a thing after you create it. To change a thing's name, you must create a new thing, give it the new name, and then delete the old thing.
Page 13
Getting started AWS IoT Core Squid.Link On the Add a certificate for your thing page, choose Create certificate. Figure 10 creating certificate Choose the Download links to download the certificate, private key, and root CA certificate. Important Figure 11 Downloading Certificates This is the only time you can download your certificate and private key.
Getting started AWS IoT Core Squid.Link 4.2.3 Creating a policy Follow the steps below to create a policy In the AWS IoT console, if a Get started button appears, choose it. Otherwise, in the navigation pane, expand Secure, and then choose Policies.
Getting started AWS IoT Core Squid.Link Figure 12 Creating a policy All devices in your fleet must have with privileges that authorize intended actions only, which include (but not limited to) AWS IoT MQTT actions such as publishing messages or subscribing to topics with specific scope and context.
Getting started AWS IoT Core Squid.Link Figure 13 downloading CA certificate 4.2.5 AWS IoT server URL To find AWS IoT server URL one should go to the created thing and select interact you will find REST API Endpoint for the thing shadow.
Getting started AWS IoT Core Squid.Link 4.3 Configuring Squidsmart api AWS IoT Handler Now we have all the configuration parameters needed from the above steps. This section demonstrates how to configure the AWS IoT Handler by using the parameters. First step is to go to /config/awsiot of the Squidsmart api and press Try it out and paste config information and then...
Getting started AWS IoT Core Squid.Link Figure 17 Successful connection 4.4 Whitelisting devices In order to enable ZigBee devices to send datapoint to shadow via the Squidlink gateway, one has to post whitelist logic. For example the following logic shows how to enable all ZigBee data points from the gateway. It is important to remember that AWS IoT handler works under the principle of denying all by default, principle of least privilage.
Getting started AWS IoT Core Squid.Link Figure 18 Whitelisting devices 5 Interoperability with Device Shadows over MQTT The above steps show how to configure the AWS IoT handler to communicate with AWS IoT Core and check for successful connection. Current state information of the device can be seen from the device shadow.
Page 20
Getting started AWS IoT Core Squid.Link Publish on topic: On the MQTT client page, in the Publish section, in the Specify a topic and a message to publish field, enter - $aws/things/mqtttest/shadow/update/ Figure 19 Publish to a topic Develco Products A/S Tangen 6 http://develcoproducts.com...
Page 21
Getting started AWS IoT Core Squid.Link The device shadow can also be used to get and set the state of the device over MQTT . To set state of the device one has to put desired parameters by editing the shadow document.
Updates for the Squid Smart App are available for download at the Pre-built Rootfs page. https://supportforum.develcoproducts.com/squidlink/prebuilt-rootfs 7 Contact Information Technical support: Please contact Develco Products for support. products@develcoproducts.com Sales: Please contact Develco Products for information on prices, availability, and lead time. info@develcoproducts.com 8 References [1] D. Products, “Develco Products,”...
Need help?
Do you have a question about the Squid.link and is the answer not in the manual?
Questions and answers