Ioto 2.4.0 Update

I’m pleased to announce a big feature release of Ioto 2.4.0.

This is a release that has breaking changes and significant new features including a port to FreeRTOS and ESP32, on-demand MQTT connections, and a secure Printf replacement.

Breaking Changes

• The mqttAlloc and mqttConnect APIs have changed. The socket has been moved from mqttAlloc to mqttConnect. The MQTT callback now provides attach and detach events so the user can attach a socket on demand.
• The jsonGet API has been refactored into jsonGet and jsonGetClone. jsonGet returns a reference, jsonGetClone returns an allocated string which must be freed.
• Move the manager apps into a separate distribution “Ioto Apps”
• The safe runtime initialization routine has changed and now takes only 2 args: a fiber function and argument. The stackSize has been removed in favor of the API: rSetFiberStack.

Features

• ESP32 and FreeRTOS support
• On-demand MQTT connections. The mqttPublish and mqttSubscribe routines will automatically connect to the cloud if required.
• The mqttConnect username and password parameters have been moved to a separate API mqttSetCredentials.
• MQTT scheduled connections and disconnections.
• An mqtt.timeout configuration parameter defines how long the connection should live.
• An R_TIMEOUT event has been added to the runtime for when blocking / waiting APIs timeout past their deadline.
• Add rEnter and rLeave APIs to define fiber critical sections.
• Mqtt message receipt has been optimized.
• Improve the rState definition. Set to R_STARTED on launch and R_INITIALIZED when the safe runtime is initialized and R_READY when the app is ready. Also set ioto->ready.
• Enhanced json query/edit and converter program for JSON and JSON5
• Optimized web requests
• Reduced memory and stack load
• Fast event path for direct calls without invoking a fiber
• Modular Safe Runtime to select only required components
• Safe, secure Printf replacement that is tolerant of NULLs

Fixes

• The rCloseSocket API no longer frees an attached wait structure which is freed in rFreeSocket.
• The runtime svalue() API converts the strings “never” and “forever” into slightly smaller numbers so that date arithmetic will not overflow.
• Run expired events in rWait
• Set of minor fixes to apps
• Fix some memory leaks
• Cleanup some compiler warnings
• Optimize mqtt message throttling
• Fix issue with buffered data synchronized updates

Upgrading

This should be a simple upgrade for all users, but there are a few noted API evolutions.

Download

Go to the Builder and navigate to the Product List to download. Select a product using “Ioto” as the device agent and click the Download icon.

Ongoing Maintenance

If you have questions, please contact us at: sales@embedthis.com.