1. Knowledge Base
  2. Getting Started Device

Seeing what Onomondo has to offer using the getting-started device.

The getting-started device that we have sent out is a great little tool that can quickly show you how some of the features work on Onomondo without having to first alter your own hardware.

We are really excited to hear that you are trying out Onomondo. As a little extra, we have included a getting started device for you to try out.

How do I use it?

Once you have a login to our platform, to see some of the features in action simply:

  1. Go to app.onomondo.com/getting-started 
  2. Follow the instructions

gettingStartedDevice

This device uses LTE-M technology with a 2G fallback on a SimCom SIM7070G module. Once you have seen how the device connects using a connector and how the data packets are displayed in the live-monitor, you can start to have a look around the platform.

If you want to know more about the device and ways you can use it, you will find it:

  1. Device logic on github
  2. How to use the Board

Setting up our SIMs in your own devices

We always activate SIMs before sending them out. This is because it doesn’t cost you anything, and leaves the device setup to 3 steps:

  1. Make sure the SIM is still activated when the device is turned on.
  2. Set the APN to “onomondo” (no caps)
  3. Allow data on roaming networks (only required on some devices)

If you are having problems connecting to the network, there is a helpful article on the AT commands to use to connect to our network


Key Features to understand

Network-whitelists and the network-log

Being able to create different network-whitelists for different use cases and projects is a great way to manage connectivity costs. Understanding how they work and how to read the network-logs will help you understand better what is happening between your device and our network. There is a great article on how to read network-logs.

User profiles

There are three kinds of users, and each level has different options -

  1. Owner
    These users are set up when on the platform when the organization is created. They are the only user type that can create admin users. They can also see Audit logs on the platform. Otherwise, they have the same functionality as "Admin" users.
  2. Admin
    They are able to access and add, delete and edit most objects on the platform as well as set up, tags, API and Webhooks. Finally they can add Member users and modify tags associated to member users.
  3. Member
    They are only granted access based on the tags added to the user. You can read more below on Tags

Tags

Tags help you customize your platform and can be used in two different ways:

  1. Grouping SIMs (ie different product or projects)
    help.onomondo.com/how-do-i-set-up-tags
  2. Customizing User Access levels for member users. (ie customer or supplier access)
    help.onomondo.com/en/set-up-user-access-control-using-tags

Webhooks /API

With an API key, you can use the different requests to create custom scripts. Our own platform is built on top of these API calls. We also have webhooks available that allow you to stream events. Each webhook can be customized to a specific Group of SIMs (with a Tag) and filtered on event type.

  1. API Documentation - docs.onomondo.com
  2. Setting up a webhook - help.onomondo.com/en/how-do-i-set-up-a-webhook

Connectors

Connectors have many benefits by removing the SDK information from the device and putting it into the network which can improve security, reduce data transmissions and frequency of firmware updates. If you want to test them, you can set up:

  1. a specific Cloud Connector (Currently we have Azure, and IBM IoT)
    help.onomondo.com/how-do-i-use-connectors
  2. A TLS Connector
    help.onomondo.com/en/setup-tls-connector
  3. A HTTPS Connector
    help.onomondo.com/en/how-do-i-set-up-an-https-connector

Guides to help Develop/debug

Some useful guides that can help during the development and debugging:

  1. Can I remotely connect to my SIMs
  2. Error logs for Webhooks and Connectors
  3. Is the network down?
  4. How to ping using AT commands
  5. How to clear the FPLMN (forbidden network) list

For more information you can

  1. Visit our help portal - help.onomondo.com
  2. Talk to support using the chat function in the platform or via support@onomondo.com
  3. Fill out the form below