5.1.73. Peak and hold injector output (pdx_PeakHoldInjectorOutput)

Control a peak and hold injector.

5.1.73.1. Supported targets

None at the moment

5.1.73.2. Required license

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

5.1.73.3. Description

The peak and hold injector output block causes a stepped current signal to be generated at the selected injector frequency, in which the current is firstly controlled to the peak current threshold for the duration determined by the peak duty cycle, after which it is controlled to the hold current threshold for the remaining duration of the peak-hold duty cycle (i.e. the duration of the peak-hold duty cycle minus the peak duty cycle), after which the current falls to zero until the beginning of the next cycle.

The injector frequency, clock frequency, peak duty cycle and peak-hold duty cycle are all driven from block inputs. The actual duty cycles are scaled by the mask parameter Min/Max duty cycle as follows:

output peak duty cycle = Minimum duty cycle + (Maximum duty cycle - Minimum duty cycle) * peak_duty_cycle

output peak-hold duty cycle = Minimum duty cycle + (Maximum duty cycle - Minimum duty cycle) * peak_hold_duty_cycle

Furthermore, the output peak-hold duty cycle is always constrained to be at least as great as the output peak duty cycle.

The channel output can be offset from other injector channels of the same frequency. The Offset parameter is used to delay the start of the injector cycle, so that the injector will not activate at the same time as other injector signals of the same frequency.

If the inport fault input is non-zero, then the output peak duty cycle is set to the mask parameter Peak default duty cycle and the output peak-hold duty cycle is set to the mask parameter Peak-hold default duty cycle.

5.1.73.4. Inports

  • injector_frequency

    The frequency of the injector cycles.

    Range: [0.1, 1000] Hz

    Value type:Real
    Calibratable:No
  • peak_duty_cycle

    After being rescaled by the mask parameter Min/Max duty cycle as described above, this is the ratio of the peak current time to the injector cycle time.

    Range: [0, 1] duty-cycle

    Value type:Real
    Calibratable:No
  • peak_hold_duty_cycle

    After being rescaled by the mask parameter Min/Max duty cycle as described above, this is the ratio of the peak-hold current time to the injector cycle time.

    Range: [0, 1] duty-cycle

    Value type:Real
    Calibratable:No
  • fault

    Set to 1 to force the block to use the default peak and peak-hold duty cycles, 0 otherwise.

    Range: 0 or 1

    Value type:Boolean
    Calibratable:No
  • clock_frequency

    The frequency of the injector clock.

    Range: [1, 10000] Hz

    Value type:Real
    Calibratable:No

5.1.73.5. Outports

  • sim_injector_frequency

    Only used in simulation. This outport is set to the calculated frequency for the injector cycles.

    Range: [0.1, 1000] Hz

    Value type:Real
    Calibratable:No
  • sim_peak_duty_cycle

    Only used in simulation. This outport is set to the calculated duty cycle (after rescaling by the mask parameter Min/Max duty cycle as described above) for the peak channel.

    Range: [0, 1] duty-cycle

    Value type:Real
    Calibratable:No
  • sim_peak_hold_duty_cycle

    Only used in simulation. This outport is set to the calculated duty cycle (after rescaling by the mask parameters Min/Max duty cycle as described above) for the peak-hold channel. It is constrained to be at least as great as the peak duty cycle.

    Range: [0, 1] duty-cycle

    Value type:Real
    Calibratable:No
  • sim_clock_frequency

    Only used in simulation. This outport is set to the calculated frequency for the injector clock.

    Range: [1, 10000] Hz

    Value type:Real
    Calibratable:No

5.1.73.6. Mask parameters

  • Injector channel

    The injector channel for this block. The peak, peak-hold and injector clock channels are automatically assigned based on this.

    Value type:List
    Calibratable:No
  • Initial injector frequency

    The frequency of the channel signal before the block first iterates.

    Range: [0.1, 1000] Hz

    Value type:Real
    Calibratable:Yes, offline
  • Peak default duty cycle

    This is the final duty cycle of the peak signal when inport fault is set. The duty cycle is mapped directly to the output channel.

    Range: 0 or 1 duty-cycle

    Value type:Real
    Calibratable:Yes, offline and online
  • Peak initial duty cycle

    The duty cycle of the peak signal (prior to rescaling by Min/Max duty cycle) before the block has first been executed.

    Range: [0, 1] duty-cycle

    Value type:Real
    Calibratable:Yes, offline
  • Peak-hold default duty cycle

    This is the final duty cycle of the peak-hold signal when inport fault is set. The duty cycle is mapped directly to the output channel.

    Range: 0 or 1 duty-cycle

    Value type:Boolean
    Calibratable:Yes, offline and online
  • Peak-hold initial duty cycle

    The duty cycle of the peak-hold signal (prior to rescaling by Min/Max duty cycle) before the block has first been executed.

    Range: [0, 1] duty-cycle

    Value type:Real
    Calibratable:Yes, offline
  • Clock initial frequency

    The frequency of the injector clock signal before the block first iterates.

    Range: [1, 10000] Hz

    Value type:Real
    Calibratable:Yes, offline
  • Min/Max duty cycle

    Defines the lower and upper end of the window into which the input duty cycles are rescaled before use. The lower limit must be in the range 0 to (upper limit - 0.1). Similarly the upper limit must be in the range (lower limit + 0.1) to 1.0.

    Range: [0, 1] duty-cycle

    Value type:Real
    Calibratable:Yes, offline and online
  • Offset

    The desired phase offset, in milliseconds, of the injector output, relative to other injector output channels that have been configured with the same frequency.

    Range: [0, 10000] ms

    Value type:Integer
    Calibratable:Yes, offline and online

5.1.73.7. Notes