A watchdog is a device used to protect a system from specific software or hardware failures that may cause the system to stop responding.

The ConnectCore platforms have several watchdog devices. You can find more information in Hardware reference manuals.

Digi adds an API for Linux that allows the management of these watchdog devices. To use this API, include the following header file:

#include <libdigiapix/watchdog.h>

Request a watchdog

You can request a watchdog with the following function:

Function Description

wd_t *ldx_watchdog_request(char const * const wd_device_file)

Requests a watchdog by its absolute device node path.

It returns a pointer to wd_t on success, NULL on error.

A requested watchdog must be freed once it is not needed anymore. See Free a watchdog.

This function may fail and return NULL for the following reasons:

  • The provided device node path is not available on the system.

  • The API encountered problems allocating memory to initialize the watchdog. Your system may have run out of resources.

Request a watchdog
[...]

/* Request a Watchdog */
wd_t wd = ldx_watchdog_request("/dev/watchdog");

printf("The Watchdog %s was requested\n", wd->node);

[...]

Free a watchdog

You must free a requested watchdog when it is no longer required. To do so, use the ldx_watchdog_free() function.

int ldx_watchdog_free(wd_t *wd)
Free a requested watchdog
[...]

wd_t *wd = ...;

[...]

/* Free watchdog once it is not required anymore */
ldx_watchdog_free(wd);

[...]

Read and set the watchdog timeout

You can read and set the watchdog timer to configure a different timeout:

Function Description

int ldx_watchdog_get_timeout(wd_t *wd)

Retrieves the value of the watchdog timeout.

If the function encounters an error, it returns -1.

int ldx_watchdog_set_timeout(wd_t *wd, int timeout)

Configure a new timeout in seconds for the given watchdog timer.

It returns EXIT_SUCCESS on success, EXIT_FAILURE otherwise.

For more information, see [{XREF_bsp_r_mca-watchdog_PRTL}] in the Linux BSP section.

Read and set a watchdog value
[...]
 
wd_t *wd = ...;
int timeout = 10;
int current_timeout = -1;
 
[...]

/* Read the watchdog timeout value */
current_timeout = ldx_watchdog_get_timeout(wd);

printf("Current watchdog timeout is: %d", current_timeout);

/* Configure a custom timeout */
ldx_watchdog_set_timeout(wd, timeout);

printf("Watchdog timeout set to %d", timeout);

[...]

Watchdog example

This example demonstrates how to enable a watchdog on a ConnectCore board. Once the watchdog is enabled, the application refreshes the watchdog timer until the test time is consumed. After the timeout expires, the device automatically reboots.

To see an example of the watchdog API, import the watchdog example in Eclipse using the Digi Embedded Yocto plugin. For more information, see Create a new DEY sample project. This example is included in Digi Embedded Yocto. Go to GitHub to see the application source code.