Main Content

Peripheral Configuration

Map peripherals in the SoC model to peripheral registers in the MCU

Description

View and edit the map of peripherals in the SoC model to the hardware peripherals.

Using the Peripheral Configuration tool, you can:

  • View and edit the assignment of peripherals to MCU peripheral registers.

  • Check the peripheral to register map of your model for any conflicts between peripherals.

Open the Peripheral Configuration

  • In the Configuration Parameters dialog box, select Hardware Implementation from the left pane. Under Hardware board settings > Design mapping, click View/Edit Peripheral Map.

  • In the SoC Builder tool, in the Review Memory and Interrupt Map section, click View/Edit Peripheral Map.

Parameters

ADC

Select an ADC Read block from the model to apply the code generation parameter configurations.

Example: RefModel/ADC Read

Open the ADC Read block selected in the Simulink block parameter in the model.

Select the ADC module A through D on the hardware board.

Identify the start-of-conversion trigger by number.

Select the input channel to which this ADC conversion applies.

Define the length of the acquisition period in ADC clock cycles. The value of this parameter depends on the SYSCLK and the minimum ADC sample time.

Select the event source that triggers the start of the conversion.

At the end of conversion, use the ADCINT1 or ADCINT2 interrupt to trigger a start of conversion. This loop creates a continuous sequence of conversions. The default selection, No ADCINT disables this parameter. To set the interrupt, select the Post interrupt at EOC trigger option, and choose the appropriate interrupt.

Enable post interrupts when the ADC triggers EOC pulses. When you select this option, the dialog box displays the Interrupt selection and Interrupt continuous mode options.

Select which ADCINT# interrupt the ADC posts to after triggering an EOC pulse.

When the ADC generates an end of conversion (EOC) signal, generate an ADCINT# interrupt, whether the previous interrupt flag has been acknowledged or not.

PWM

Select an PWM Write block from the model to apply the code generation parameter configurations.

Example: RefModel/PWM Write

Open the PWM Write block selected in the Simulink block parameter in the model.

Select the appropriate ePWM module, ePWMx, where x is a positive integer.

Set the high speed time base clock prescaler divider, HSPCLKDIV.

Use the Time base clock, TBCLK, prescaler divider, CLKDIV, and the high speed time base clock, HSPCLKDIV, prescaler divider, HSPCLKDIV, to configure the Time-base clock speed, TBCLK, for the ePWM module. Calculate TBCLK using this equation: TBCLK = PWM clock/(HSPCLKDIV * CLKDIV).

For example, the default values of both CLKDIV and HSPCLKDIV are 1, and the default frequency of PWM clock is 200 MHz, so: TBCLK in Hz = 200 MHz/(1 * 1) = 200 MHz TBCLK in seconds = 1/TBCLK in Hz = 1/200 MHz = 0.005 μs.

Set the period of the ePWM counter waveform.

The timer period is in clock cycles:

Count ModeCalculationExample
Up or downThe value entered in clock cycles is used to calculate time-base period, TBPRD, for the ePWM timer register. The period of the ePWM timer is TCTR = (TBPRD + 1) * TBCLK, where TCTR is the timer period in seconds, and TBCLK is the time-base clock.

For ePWM clock, EPWMCLK, frequency = 200 MHz, and TBCLK = 5 ns. EPWMCLK will be equal to SYSCLKOUT or SYSCLKOUT/2 depending on the ePWM clock divider, EPWMCLKDIV, parameter setting. When the timer period is entered in clock cycles TBPRD = 9999, and the ePWM timer period is calculated as TCTR = 50 µs. For the default action settings on the ePWMx tab, the ePWM period = 50 µs.

Up-downThe value entered in clock cycles is used to calculate the time-base period, TBPRD, for the ePWM timer register. The period of the ePWM timer is TCTR = 2 * TBPRD * TBCLK, where TCTR is the timer period in seconds and TBCLK is the time-base clock.For EPWMCLK frequency = 200 MHz and TBCLK = 5 ns. When the timer period is entered in clock cycles, TBPRD = 10000, and the ePWM timer period is calculated as TCTR = 100 µs. For the default action settings on the ePWMx tab, the ePWM period = 100 µs.

The initial duty cycle of the waveform from the time the PWM peripheral starts operation until the ePWM input port receives a new value for the duty cycle is Timer period / 2.

Enables to provide a timer phase offset value.

The specified offset value is loaded in the time base counter on a synchronization event. Enter the phase offset value, TBPHS, in TBCLK cycles from 0 to 65535.

Specify the counting mode of the PWM internal counter. This figure shows three counting waveforms.

Internal counter of PWM waveform generator

This group determines the behavior of the action qualifier (AQ) submodule. The AQ module determines which events are converted into one of the various action types, producing the required switched waveforms of the ePWMA circuit. The ePWMB always generates a complement signal of ePWMA.

This group determines the behavior of the Action Qualifier (AQ) submodule. The AQ module determines which events are converted into one of the various action types, producing the required switched waveforms of the ePWMA circuit. The ePWMB always generates a complement signal of ePWMA.

This group determines the behavior of the action qualifier (AQ) submodule. The AQ module determines which events are converted into one of the various action types, producing the required switched waveforms of the ePWMA circuit. The ePWMB always generates a complement signal of ePWMA.

This group determines the behavior of the action qualifier (AQ) submodule. The AQ module determines which events are converted into one of the various action types, producing the required switched waveforms of the ePWMA circuit. The ePWMB always generates a complement signal of ePWMA.

When shadow mode is not enabled, the CMPA register refreshes immediately. Provide different reload mode for CMPA register.

The time when the counter period resets based on the following condition:

  • Counter equals to zero (CTR=Zero) – Refreshes the counter period when the value of the counter is 0.

  • Counter equals to period (CTR=PRD) – Refreshes the counter period when the value of the counter is period.

  • Counter equals to Zero or period (CTR=Zero or CTR=PRD) – Refreshes the counter period when the value of the counter is 0 or period.

  • Freeze – Refreshes the counter period when the value of the counter is freeze.

This parameter specifies the counter match condition that triggers an ADC start of the conversion event. The choices are:

  • Counter equals to zero (CTR=Zero) – Triggers an ADC start of the conversion event when the ePWM counter reaches 0.

  • Counter equals to period (CTR=PRD) – Triggers an ADC start of the conversion event wen the ePWM counter reaches the period value.

  • Counter equals to Zero or period (CTR=Zero or CTR=PRD) – Triggers an ADC start of the conversion event when the time base counter, TBCTR, reaches zero or when the time base counter reaches the period, TBCTR = TBPRD.

  • Disable – Disable ADC start of conversion event.

This parameter specifies the deadband delay for rising edge and falling edge in time-base clock cycles.

Introduced in R2020b