This page gives useful information for the project management aspect of the integration of the MQTT API.

•  Planning and effort estimation for the integration:
  • Coding effort: from 1 to 2 staff days, integration support : 1 staff day;
  • Testing effort: 1 staff day;
  • The Integration can be done before, during or after deployment
• Integration procedure to follow / checklist:
  1. Get the Site ID and required credentials (MQTT certificate, etc) for the connection;
  2. Read and execute the python sample code to understand the typical integration;
  3. Get the MQTT Client lib for your language of choice;
  4. Implement MQTT connection;
  5. Implement MQTT subscription to the location topic;
  6. Implement location-based business logic (displaying the location on a maps, triggering a notification, etc). Pole Star strongly recommends filtering on the expected event "trigger" to start the associated business behaviors, so as to avoid unexpected events from triggering business logic;
  7. Implement error handling logic (warning or error messages in case of problem);
  8. Test.
• Testing methods:
  • If the fingerprinting is not done, you can simulate locations on the MQTT stream using the stub here:

    https://www.nao-cloud.com/nao_trackables/stub?site_id=<SITE_ID>.

    In this page, you can enter any tag ID and click “Start’. NAO Cloud will output pre-defined locations on the site to the MQTT stream, at 1 location per second.

  • If the fingerprinting is done, you can test the MQTT location topic with real tags on site.