Runtime Control

Once an Ndigo5G device is configured, the following functions can be used to control the behavior of it.

These functions return quickly with very little overhead. However, they are not guaranteed to be thread safe.

int ndigo_start_capture(ndigo_device *device)

Starts data acquisition.

ndigo_start_capture will reset the memory buffer. If you do wish to stop recording and resume later without clearing the buffer, use ndigo_pause_capture and ndigo_continue_capture instead.

Parameters:

device – [in] Pointer to the device.

Returns:

A status code.

int ndigo_stop_capture(ndigo_device *device)

Stop data acquisition.

Parameters:

device – [in] Pointer to the device.

Returns:

A status code.

int ndigo_pause_capture(ndigo_device *device)

Pause data acquisition.

Data acquisition can be continued using ndigo_continue_capture.

ndigo_pause_capture and ndigo_continue_capture have less overhead than ndigo_stop_capture and ndigo_start_capture, but do not allow for a configuration change.

Parameters:

device – [in] Pointer to the device.

Returns:

A status code.

int ndigo_continue_capture(ndigo_device *device)

Resume data acquisition.

Can only be called if data acquisition was paused using ndigo_pause_capture.

ndigo_pause_capture and ndigo_continue_capture have less overhead than ndigo_stop_capture and ndigo_start_capture, but do not allow for a configuration change.

Parameters:

device – [in] Pointer to the device.

Returns:

A status code.

int ndigo_single_shot(ndigo_device *device, int channel_mask)

Enable each of the specified channels for one (or more) trigger(s), respectively.

The number of triggers is configured using ndigo_trigger_block::multi_shot_count.

Parameters:

  • device – [in] Pointer to the device.

  • channel_mask – [in] Bitmask of channels to trigger.

Returns:

A status code.

int ndigo_manual_trigger(ndigo_device *device, int channel_mask)

Enable manual triggering.

Parameters:

  • device – [in] Pointer to the device.

  • channel_mask – [in] Bitmask of channels to manually trigger.

Returns:

A status code.