5.1.116. Waveform — configuration, phases (prop_WaveformConfig)

Specify the voltage, current and duration properties of a waveform.

5.1.116.1. Supported targets

M670-000

5.1.116.2. Required license

None (Main library). (See Section 2.3, “Licensed Features”.)

5.1.116.3. Description

This block configures the properties of a waveform by setting the voltage, current and durations for up to three phases. An example of a possible waveform is shown in Figure 5.19, “Three stage, waveform”.

Figure 5.19. Three stage, waveform

Three stage, waveform

In the above diagram, T1 and T2 correspond to Phase 1, T3 and T4 correspond to Phase 2 and Phase 3 is the remaining portion of the waveform up to the entire pulse duration, T5. The Phase 1 on duration is set with the Phase 1 - Duration (us) paramter (T1) and the Phase 2 on duration is set with the Phase 2 - Duration (us) paramter (T3). The T5 duration is set with either a time-based or angular-based output block configured for the corresponding output pin.

The block allows either the boost supply or battery supply to be selected for the voltage during each Phase 1 and Phase 2. These options can be configured with the Phase 1 - Select Vboost and Phase 2 - Select Vboost parameters.

The current setpoint can be selected individually for each phase providing for a number of different possible combinations. Phase 1 and 2 are unique in that they can be configured to terminate when the current setpoint is reached with the Phase 1 - Switch at current and Phase 2 - Switch at current, parameters. When the waveform is configured in this manner, the Phase 1 - Duration (us) (T1) and/or Phase 2 - Duration (us) (T2) options are used as maximum duration timeouts. If the load current cannot be reached within the duration configured for the phase, the output will switch to the next phase. If the phase duration is set to zero, the phase is skipped. Phase 3 will continue for the remaining duration of the pulse (T5).

During each phase a dither off time can be configured individually per phase. (Phase 1 - Dither off duration (us), Phase 2 - Dither off duration (us), Phase 3 - Dither off duration (us)). When the current setpoint is reached during the phase, the output will turn off for the dither off time before turning back on, to regulate the current at the setpoint. This parameter can be used to increase or decrease the amount of dither around the current setpoint during each phase.

At the end of the phase before switching to the next phase, a phase switch off time can be configured to provide for a faster current decay rate between phases. During this time current is allowed to recirculate freely through the load, providing for a faster switch between two current setpoints. The Phase 1 switch off duration is set with the Phase 1 - Switch off duration (us) paramter (T2) and the Phase 2 switch off duration is set with the Phase 1 - Switch off duration (us) paramter (T4).

A prop_WaveformConfig block must be present in the model and specified for an output channel with a prop_WaveformSetChannel block for either boosted/non-boosted or overlapping/non-overlapping peak and hold outputs to operate.

5.1.116.4. Inports

None.

5.1.116.5. Outports

None.

5.1.116.6. Mask parameters

  • Waveform

    A drop down to identify the waveform to configure. The selection of waveform is dependent on the target ECU hardware selected in the put_Identification block.

    Value type:List
    Calibratable:No
  • Phase 1 - Enable

    Enables Phase 1 of the waveform. If this option is unchecked, the phase will be skipped.

    Value type:Boolean
    Calibratable:No
  • Phase 1 - Select Vboost

    Enables the boost supply as the source of the high side during Phase 1 of the waveform. If this option is unchecked, the high side will be driven with battery voltage.

    Value type:Boolean
    Calibratable:No
  • Phase 1 - Duration (us)

    Sets the duration of the driven (i.e. T1) period of Phase 1 of the waveform. If Phase 1 - Switch at current is unchecked the current will be regulated to value set by Phase 1 - Current (A). If Phase 1 - Switch at current is checked the duration is the maximum time to wait before switching to the next phase if the phase current has not been reached.

    Range: [0, 3000] us (boosted) Range: [0, 10922.5] us (non-boosted)

    Value type:Real
    Calibratable:Yes, offline
  • Phase 1 - Switch at current

    Enables Phase 1 of the waveform to be terminated immediately upon reaching the current set by Phase 1 - Current (A). If this option is unchecked, the phase will be active for the entire duration set by Phase 1 - Duration (us).

    Value type:Boolean
    Calibratable:No
  • Phase 1 - Current (A)

    Sets the current level during the driven (i.e. T1) period of Phase 1 of the waveform.

    Range: [0, 25] A (boosted) Range: [0, 16] A (non-boosted)

    Value type:Real
    Calibratable:Yes, offline
  • Phase 1 - Dither off duration (us)

    Sets the duration of the off period after reaching the phase current during the driven period of Phase 1 (i.e. T1) of the waveform. The duration will affect the current dither during the phase. A larger value will allow the current to drop further, providing more dither.

    Range: [10, 10922.5] us

    Value type:Real
    Calibratable:Yes, offline
  • Phase 1 - Switch off duration (us)

    Sets the duration of the non-driven (i.e. T2) period of Phase 1 of the waveform. During this phase, both the high side and low side of the output are turned off allowing current to recirculate through the load to the Vboost supply, providing a faster current decay rate when switching phases. If no recirculation is required, the duration can be set to zero.

    Range: [0, 10922.5] us

    Value type:Real
    Calibratable:Yes, offline
  • Phase 2 - Enable

    Enables Phase 2 of the waveform. If this option is unchecked, the phase will be skipped.

    Value type:Boolean
    Calibratable:No
  • Phase 2 - Select Vboost

    Enables the boost supply as the source of the high side during Phase 2 of the waveform. If this option is unchecked, the high side will be driven with battery voltage.

    Value type:Boolean
    Calibratable:No
  • Phase 2 - Duration (us)

    Sets the duration of the driven (i.e. T3) period of Phase 2 of the waveform. If Phase 2 - Switch at current is unchecked the current will be regulated to value set by Phase 2 - Current (A). If Phase 2 - Switch at current is checked the duration is the maximum time to wait before switching to the next phase if the phase current has not been reached.

    Range: [0, 3000] us (boosted) Range: [0, 10922.5] us (non-boosted)

    Value type:Real
    Calibratable:Yes, offline
  • Phase 2 - Switch at current

    Enables Phase 2 of the waveform to be terminated immediately upon reaching the current set by Phase 2 - Current (A). If this option is unchecked, the phase will be active for the entire duration set by Phase 2 - Duration (us).

    Value type:Boolean
    Calibratable:No
  • Phase 2 - Current (A)

    Sets the current level during the driven (i.e. T3) period of Phase 2 of the waveform.

    Range: [0, 25] A (boosted) Range: [0, 16] A (non-boosted)

    Value type:Real
    Calibratable:Yes, offline
  • Phase 2 - Dither off duration (us)

    Sets the duration of the off period after reaching the phase current during the driven period of Phase 2 (i.e. T3) of the waveform. The duration will affect the current dither during the phase. A larger value will allow the current to drop further, providing more dither.

    Range: [10, 10922.5] us

    Value type:Real
    Calibratable:Yes, offline
  • Phase 2 - Switch off duration (us)

    Sets the duration of the non-driven (i.e. T3) period of Phase 2 of the waveform. During this phase, both the high side and low side of the output are turned off allowing current to recirculate through the load to the Vboost supply, providing a faster current decay rate when switching phases. If no recirculation is required, the duration can be set to zero.

    Range: [0, 10922.5] us

    Value type:Real
    Calibratable:Yes, offline
  • Phase 3 - Current (A)

    Sets the current level during the driven (i.e. after T4) period of Phase 3 of the waveform.

    Range: [0, 16] A

    Value type:Real
    Calibratable:Yes, offline
  • Phase 3 - Dither off duration (us)

    Sets the duration of the off period after reaching the phase current during the driven period of Phase 3 (i.e. after T4) of the waveform. The duration will affect the current dither during the phase. A larger value will allow the current to drop further, providing more dither.

    Range: [10, 10922.5] us

    Value type:Real
    Calibratable:Yes, offline

5.1.116.7. Notes

Phase 3 of the waveform is always enabled.

Setting the switch off duration or dither off duration to a very large value may allow the current to decay to zero during the injection, possibly allowing the injector to close, and triggering an electrical diagnostic fault.