The Getting Started Device that 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 that you have decided to try 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:
- Go to app.onomondo.com/getting-started.
- Follow the instructions.
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 Traffic 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 find out more on Github: Device logic on Github.
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:
- Make sure the SIM is still activated when the device is turned on.
- Set the APN to “onomondo” (no caps)
- 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 Logs
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.
There are three kinds of users, and each level has different options -
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.
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.
They are only granted access based on the tags added to the user. You can read more below on Tags
Tags help you customize your platform and can be used in two different ways:
- Grouping SIMs (ie different product or projects)
- Customizing User Access levels for member users. (ie customer or supplier access)
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.
- API Documentation - docs.onomondo.com
- Setting up a webhook - how-do-i-set-up-a-webhook
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:
- a specific Cloud Connector (Currently we have Azure, and IBM IoT)
- A TLS Connector
- A HTTPS Connector
Please note: When setting up a Connector with the Getting Started Device, you must label both the SIM and Connector as getting-started in all lowercase.
Guides to help Develop/debug
Some useful guides that can help during the development and debugging:
- Can I remotely connect to my SIMs
- Error logs for Webhooks and Connectors
- Is the network down?
- How to ping using AT commands
- How to clear the FPLMN (forbidden network) list
For more information you can
- Talk to support using the chat function in the platform or via email@example.com.
- Submit a support ticket.