Quick-start guide

Trying out AirLink is easy:

1. Download two Android apps and install on two smartphones (one acting as device and one acting as the actual AirLink smartphone gateway),

2. Request the Demo tenant server login from EnAccess,

and you have the three components needed to try AirLink quickly without buying any hardware!

Who Is AirLink for?

AirLink is a ready-made protocol and software backend for businesses who want to enable Pay as you go control and data on their products using a smartphones as a gateway; either because the end product e.g. a home light does not have a remote control or GSM based pay as you go built in, or because adding a smartphone to your product offering adds significant value to your customers. AirLink is also for businesses who want their products secured against loss or theft using crowd-sourced ‘pings’ via everyone else who uses AirLink devices.

Components

1. Server: EnAccess.org runs a multi-tenant AirLink server for early adopters and people who want to try out airlink - you can subscribe to as a tenant
   1. Get a tenant login from EnAccess via an email request or use the Demo tenant to try out AirLink (contact EnAccess for login)
   2. Optional: Get your own thingsboard.io server configured to support AirLink using the JSON files available on AirLink Server Github page, then you don’t need the EnAccess server.

2. PAYG Devices: Get AirLink Devices
   1. Use a smartphone with the ‘AirLink Device Emulator’ app from the AirLink Devices repository to get started and test airlink without requiring any hardware!
   2. Find Suppliers or make your own Bluetooth hardware that is compatible with the AirLink Devices spec. Use the example firmware available for Nordic BLE products on the AirLink Devices Github library
   3. If you want to re-brand the devices that you sell, register with Bluetooth SIG, create a declaration for your product, and use ID text they provide as the 'advertisement' manufacturer text in the Bluetooth advertisement

3. Smartphone: Get an Android phone and install the Airlink App!
   1. Follow the steps in the next section to setup your AirLink Server tenant
   2. Scan the device via the app and see if it registers on the server

4. API: Use a third party business application to automate device on/off e.g. Solaris via API calls to the AirLink server
   1. Develop your business integrations further by building on the open source app for clients or API integrations with the IoT server
   2. Don't forget to integrate with the EnAccess server for the inter-company, crowdsourced 'Neighborhood Watch' (lost assets database)

How to get started with your AirLink Server tenant

Here is a step by step setup for your tenant login in the AirLink server. Alternatively, if you end up installing your own Thingsboard.io server, this guide can also help you configure it to AirLink specifications after the native thingsboard installation is ready. You will first setup the server, then connect the AirLink App to the server, provision a device using the App, and finally generate a Pay as you go token for the airlink device.

1. Assumption: You have a “Tenant Administrator” email login provided by EnAccess, or one that you made for your own server. Login with this administrator account.

2. Go to Users → Tenant Users, click on the + sign at the the top right of the page to create a new Tenant User. Once activated, note down the email and password. Note that the AirLink app uses this login information for administrative actions like registering devices via Oauth, whereas device data exchange is done using access tokens.

3. Setup Device Profiles

   

   1. Setup a “Gateways” profile and enable the “Allow provisioning...” option. To do this, you need to tap the pencil button and then remember to save by pressing the tick-mark button.

      

   2. Setup a “Devices” Profile, and enable the “Default” checkbox as in the figure above. Also enable the “Allow provisioning...” option as in the previous step
   3. Copy the Provisioning Keys and Secrets, you will need to input these in the AirLink app!

4. Import the rule chains: All data that flows to the thingsboard server goes to the root rule chain, and any other rule chain that the root chain hands off to. To process AirLink data, especially to enable PAYG token generation as well as the Neighborhood watch function, we customized this rule chain and saved it as a JSON file in the AirLink Server repository. To use functionality beyond just the core AirLink functionality, we created another “Business Logic” rule chain which gets handed off all the data from the Root rule chain.
   1. First import the “Business Logic” rule chain JSON file by going to Rule Chain → + → Import Rule Chain

      

   2. Next, Import the “Root Advertisements and Telemetry” Rule chain. Your rule chain setup should look like this with no errors now:

      

   3. Mark this rule chain as “Root” using the ‘flag’ button

      

5. That’s it for the minimum required configuration on the Server! Next, configure your AirLink App to talk to your server per the following video, and you are set to provision and test real devices!

   https://youtu.be/OAEcQaUBIao

6. After registering a device using the above flow, you can generate a Nexus Keycode PAYG token for it by using the Postman collection in the AirLink-Server repository.
   1. Download both the API calls collection and the environment, and upload to your Postman (getpostman.com)
   2. First use the login flow with the Tenant User username/password of the demo user to authenticate and get a JWT token, then
   3. enter the JWT token into the Airlink environment current value
   4. Use the Generate Token flow with the correct device ID to generate a Nexus Keycode PAYG token for your device. This token will be automatically saved in the device properties as well
   5. Connect the AirLink App and type the token in manually into the PC resource, or via keypad as shown in the video above