Probe

SD027 Posted on April 2, 2021 Updated on February 11, 2026 Download PDF pdf icon

Table of Contents

The probe variable block creates a variable that can be watched and logged in real-time using using imperix Cockpit. It supports the int32, uint32, and float data types.

The probe block can also be configured to periodically transmit the variable value:

On B-Box 4, probes connected to ADC blocks become oversampled probes. When using this probe in the Scope module of Cockpit, 2 curves are displayed:

  • data acquired at the CPU rate and used by the control algorithm.
  • oversampled data, acquired at the ADC sampling rate, allows the signal to be viewed as if using an oscilloscope.

Simulink block

Signal specification

The input is the data to probe. Any scalar signal or array can be probed.

When connected to a vector, N variables are created where N is the vector size. For example, when a probe named V_grid is connected to a vector containing 3 values, 3 variables named V_grid_0, V_grid_1 , and V_grid_2 are created.

To appear as an oversampled probe in the Cockpit Scope (B-Box 4 only), the probe must be connected to an ADC block either directly or solely through gain and bias blocks. If any other block types are placed between the ADC and the probe, oversampling is disabled, and the probe will function as a standard probe.

Parameters

  • Variable name sets the variable name. This variable must start with a character and must not contain any spaces or special characters except for the “_“ character.
  • Data type sets the variable type. (int32, uint32, or single)
  • Name extension when the probe is connected to a vector, N variables are created, where N is the vector size. In this case, the extension of the created variable names can be modified using this parameter.
Probe Simulink dialog parameters variable
Probe Simulink dialog parameters CAN
Probe Simulink dialog parameters Ethernet

PLECS block

Signal specification

The data input port accepts either a signal or a vector of signals.

When connected to a vector, N variables are created where N is the vector size. For example, when a probe named V_grid is connected to a vector containing 3 values, 3 variables named V_grid_0, V_grid_1 , and V_grid_2 are created.

Oversampled probes are supported only on PLECS 4.8 or later (B-Box 4 only). Probes that are connected directly to an ADC block appear as oversampled probes in the Scope module of Cockpit. All other probes appear as classic probes without oversampling.

Parameters

  • Probe name sets the variable name. This variable must start with a character and must not contain any spaces or special characters except for the “_“ character.
  • Signal type sets the variable type. (int32, uint32, or float32)

C++ functions

All global variables of type int, unsigned int, or float can be scoped by the BB Control utility software.

Data can be sent using the CAN output mailbox or the UDP output mailbox.


Related Articles