reboot

Usage

>> instrument reboot [delay=<milliseconds-delay>]

Security

Open

Description

This command executes a logger CPU reset.  The reset will apply only to the CPU itself and any hardware directly under its control; there is no guarantee that every component in the logger system will be reset in the same way that cycling power to the logger would achieve.

Whether or not there is a response to the command depends on the confirmation setting: if confirmation is off there will be no response - see the examples below. The confirmation setting is controlled by the settings command.

The delay option can be useful when using the command over a USB-CDC communication link. A <milliseconds-delay> value must be supplied if the option is used; there is no default value. When the logger CPU resets, any USB-CDC link between it and the host will be torn down and then re-established, meaning that the virtual serial port associated with the CDC profile temporarily disappears for a brief time. Not all communications software is able to cope with such an event, so providing some time to disconnect the software from the logger before the port disappears allows the operation to be performed gracefully.

This does not apply to a true Serial link, so there are no side effects if the logger is reset without specifying a delay. The link command can be used to verify the type of communications link if there is any doubt.

Examples

% settings confirmation=on
>> instrument reboot
<< instrument reboot
% reboot ocurrs

Successfully resets the logger CPU following the confirmation of the request.

% settings confirmation=on
>> instrument reboot delay=5000
% ... 5-second delay...
<< instrument reboot delay=5000
% reboot ocurrs

Successfully resets the logger CPU following the requested delay. Confirmation of the request is sent if confirmation is enabled, but of course if the purpose of the delay was to allow time to disconnect the logger, the message will not be seen.

% settings confirmation=off
>> instrument reboot
% reboot occurs

Successfully resets the logger CPU without issuing a confirmation of the request.