🤔

How to get started

Is AirLink right for your business?

AirLink is the protocol and software for businesses who want to enable Pay as you go control on their devices via phone gateway devices, either because the end product does not have remote control / GSM built in, or because they are used in areas without 100% phone coverage. AirLink is also for businesses who want their products secured and discoverable using crowd-sourced location via everyone else who uses AirLink devices!

Does the workflow that AirLink espouses work with how you want to sell your products?

Infrastructure

  1. EnAccess.org runs a multi-tenant AirLink server that you could subscribe to as a tenant!
    1. Get a tenant login from EnAccess
    1. Optional: Get your own thingsboard.io server configured to support AirLink
  1. Get AirLink Devices
    1. Find Suppliers or make your own Bluetooth hardware that is compatible with the AirLink Devices spec.
    1. 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
  1. Get an Android phone and install the Airlink App!
    1. Follow the steps in the next section to setup your AirLink Server tenant
    1. Scan the device via the app and see if it registers on the server
  1. Use a third party business application to automate device on/off e.g. Solaris
    1. Develop your business integrations further by building on the open source app for clients or API integrations with the IoT server
    1. 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 (also in AirLink Server)

Here is a step by step setup to your own tenancy in the AirLink server. Alternatively, if you end up installing your own Thingsboard.io server, this guide can also help you right past the end of the installation steps detailed on Thingsboard.io.

  1. Assumption: You have a “Tenant Administrator” email login provided by EnAccess for the first AirLink server, or one that you made for your own server
  1. 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.
    1. 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
    1. Copy the Provisioning Keys and Secrets, you will need to input these in the AirLink app!
  1. 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
    1. Next, Import the “Root Advertisements and Telemetry” Rule chain. Your rule chain setup should look like this with no errors now:
    1. Mark this rule chain as “Root” using the ‘flag’ button
  1. Setup Test Devices, Customers, Users, Assets etc as shown in test entities above to assign devices, test the “Relationships” property and so on to build a digital model of your IoT business model. As you can see, each screenshot above has our own Test entities for good measure!
  1. That’s it for the minimum required configuration! Next, configure your AirLink App to talk to your server, and your set to test with real devices!