Sim7070

Onomondo getting started kit.

Example forked from esp-idf repo.

What is this?

The kit is designed to showcase some of the features provided by Onomondo. Already a customer? Head over to app.onomondo.com/getting-started to get a guided tour of the platform and to see the data packets in real-time.

Onomondo Connectors

Specifically, this example is powered by the Onomondo Connectors. It removes complexity (i.e. Cloud SDK) from the device and let the network handle it. Check out the code snippet below - would you have guessed that this is fully encrypted and integrated into the Azure IoT Hub? Get more info on Connectors here.

//init cellular connectivity
esp_err_t status = initCellular(SIM7xxx, 0);
...
...
// setup of sensor
...
...
// open a socket to a non-existing server
status = openSocket("1.2.3.4", 4321);

// payload formatting
sprintf(payload, "{\"battery\": %f,\"signal\": %f,\"temperature\": %f}", battery, signal, temp);

// transmit payload
status = sendData(payload, strlen(payload), 0);

This it what happens on the platform:

At this point the data has not yet reached any public networks. Since the SIM has a Connector configured, the payload gets neatly wrapped up and securely handed over to Azure IoT Hub (but not limited to Azure: Want a webhook event: ✔, any major cloud provider ✔, custom TLS endpoint ✔).

This is from the Azure Logs:

Notice how the network has added a few fields: A timestamp and a sim_id so the device can be identified. In addition to the extra fields everything has been fully encrypted.

How to use.

The kit is fully programmed when you get it. However, you are encouraged to modify the example we have provided.

First time use: Flick the power switch and the device should come online. The device will search for networks, register on a network and establish a data connection. Touch the touch-pad on the front to transmit a message with the current temperature, battery voltage and last known signal level. After a while the device will enter a low power state. Give it a shake to wake it up again.

Get the demo tour

On app.onomondo.com/getting-started you'll get the full tour.

Flash a precompiled firmware

In case the stock firmware gets overwritten, you can easily flash the device with a precompiled binary. Download the ESP flash download tool here, download the precompiled firmware (onomondo_getting_started.bin) from the repo and flash the device.

These procompiled binaries will in the future include firmware to assist in debugging connectivity with Onomondo.

Build and Flash Modified firmware.

Run idf.py --ccache -p PORT build flash monitor to build and flash the project..

(To exit the serial monitor, type Ctrl-].)

See the ESP-IDF Getting Started Guide for full steps to configure and use ESP-IDF to build projects.

Troubleshooting

If the device fails to connect (red flashing LED).

1. Is the sim activated
2. Attaching for the first time can be slow in some cases.
3. Is the antenna plugged in?
4. Is there sufficient charge on the battery? If the battery is discharged the device won't turn on until it has been plugged into a charger.

Check the Network logs on the Onomondo platform. Does the platform report any activity?

Plug the device into you computer (use the port marked as MCU Debug on the back). Have a look at the out below and see if anything stands out. Does the modem reponds to any commands? When does it stop responding?

Example Output

SIM7070G Output

I (451) main: Cpu freq: 160 MhZ
I (451) ACC: Config i2c param
I (461) ACC: Install i2c driver
I (461) ACC: Reading register....
I (481) main: Temperature: 26.500000
I (481) gpio: GPIO[4]| InputEn: 0| OutputEn: 1| OpenDrain: 0| Pullup: 0| Pulldown: 0| Intr:0
I (481) gpio: GPIO[5]| InputEn: 0| OutputEn: 1| OpenDrain: 0| Pullup: 0| Pulldown: 0| Intr:0
I (491) gpio: GPIO[25]| InputEn: 0| OutputEn: 1| OpenDrain: 0| Pullup: 0| Pulldown: 0| Intr:0
I (511) touch_driver: test init: touch pad [6] val is 686
I (511) uart: queue free spaces: 30
I (511) sim800: PWR pin 27
I (511) gpio: GPIO[27]| InputEn: 0| OutputEn: 1| OpenDrain: 0| Pullup: 0| Pulldown: 0| Intr:0
I (521) AT CMD: AT
E (621) esp-modem: esp_modem_dte_send_cmd(352): process command timeout
E (621) dce_service: esp_modem_dce_power_test(251): send command failed
I (721) AT CMD: AT
I (721) AT RESP: AT

E (721) esp-modem: esp_dte_handle_line(136): handle line failed
E (721) esp-modem: AT

I (721) AT RESP: OK

I (721) sim800: Modem is on!