The Octave Developer Hub

Welcome to the Octave developer hub. You'll find comprehensive guides and documentation to help you start working with Octave as quickly as possible, as well as support if you get stuck. Let's jump right in!

Get Started

Utilitary Resources

Resources under the /util/ category are available by default on all Octave edge devices. They allow for control and monitoring of several edge system-level processes.

  • /util/cellular and /util/sim are able to report information about the cellular connectivity status.
  • /util/time provides time information.
  • /util/reboot/trigger is used to manually force the device to reboot. This is accomplished by clicking the Resource's Send Command button and then clicking Trigger. You can also set the value from a REST API call by passing { "elems" : { "/util/reboot/trigger" : 1 } } as the data. Note that you will need to use escape characters when invoking the call from programs like cURL.
  • /util/ulpm is used to configure and operate ULPM as indicated here.
  • /util/counter and /util/delay are used to handle periodic timers and delays on the Edge side. Their usage is detailed below.

Counter Resource

The /counter Resource is used to configure periodic executions on the Octave Edge side.

In order to configure a periodic counter:

  • set /counter/enable to True
  • set /counter/period to the desired period value (in seconds)

Once this is done, the /counter/value will be increased by one unit every time the period expires.

The typical usage is to observe this counter to trigger an Edge Action on a periodic basis.
To handle multiple periods, multiple Observations can be made on the same counter with a throttling introduced in the Observations. Or one unique Edge Action can compute different modulo values of the counter to run different parts of code.

/counter/trigger can be written to in order to force a counter increment at any time (the counter needs to be enabled, and this increment will be done on top of ongoing periodic increments).

📘

Use the Counter to Periodically Report Multiple Resource Values to the Cloud

The counter feature can be used as indicated in this reference implementation

Delay Resource

The Delay Resource is used to trigger an Event at a given time after an initial Event.

In order to use the Delay feature:

  • set /delay/set to the desired delay value (in seconds)
  • observe the /delay/value : it will be updated (to the delay value) as soon as the delay has expired

The typical method for using the delay feature is for an Edge Action to perform an action (based on other inputs/logic) and to initiate a given delay. Then, with an Observation on /delay/value targeting another Edge Action, this allows execution of a secondary action systematically, any given time after the initial Edge Action.

🚧

Only one Delay can be Handled at the Same Time

If delay is set before a previously ongoing delay has expired, the new delay will supersede the ongoing one.

Updated about a month ago

Utilitary Resources


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.