wdtkick

Watchdog timer

Syntax:

wdtkick [-a address]
        [-B offset:value]
        [-E offset:mask[:enable]]
        [-l length]
        [-p priority]
        [-r width]
        [-t time_milliseconds]
        [-v]
        [-w width]
        [-W offset:value]

Runs on:

QNX Neutrino

Options:

These are the options available for this driver.

-a address
The watchdog timer register's physical base address.
-B offset:value
Swap the register bits on the watchdog timer to kick the timer.
  • offset — Specifies the offset where the bits are swapped.
  • value — Specifies the value to use with the watchdog.

If a value isn't specified, then the value of 0xFFFFFFFF is used. Use either this option or the -W for each register that must be written.

-E offset:mask[:enable]
Write to register specified by the -a option at an offset to enable the watchdog timer:
  • offset—Specifies the offset from the base register.
  • mask—Specifies bitmask in the enable condition.
  • (Optional) enable— Specifies the enable condition. It defaults to the mask value when not specified.
-l length
The size of the address space for the watchdog's hardware register. The default size is 0x1000.
-p priority
Thread priority of the watchdog. The default is 10.
-r width
The width of the watchdog's enable register, in bits. The default is 32.
-t time_milliseconds
The kick-time interval, in milliseconds. The default is 15000 milliseconds when this option isn't specified.
-v
Enable verbosity. The -v option is cumulative; each additional v adds a level of verbosity.
-w width
The width of the watchdog write register in bits. The default is 32.
-W offset:value
Write a value to the register to kick the timer.
  • offset —Specifies the offset of the register to write to.
  • value — Specifies the value to write to the register.

Use either this option or the -B for each register that must be written.

Description:

A watchdog timer module (watchdog kicker) enables a hardware or virtual hardware watchdog, then writes at regular intervals to specified registers in hardware to let the watchdog know that the OS in which the kicker is running is indeed running. When using the QNX Hypervisor, the hardware could be host-physical or guest-physical, depending on where the kicker is running.

Watchdog timer modules are architecture- and board-specific, and are delivered in board support packages (BSPs) from QNX Software Systems. To learn about any additional options for this utility that apply to a particular board, see the BSP User's Guide for that board.

Example:

Specify the value and offset to write to:
wdtkick -W 0x0:0x5A5AFF00