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 resolution of the digital conversion output.

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.

Set the initial count value of the comparator in clock cycles.

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.

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 when 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.

  • Counter is direction and equal to CMPx – Triggers an ADC start of the conversion event when the counter equals the specified comparator and the counter direction is either incrementing or decrementing.

This parameter registers that an interrupt occurs for the specified event and generates interrupt service routine (ISR) code to be used by the Task Manager. The choices are:

  • Counter equals to zero (CTR=Zero) – Generates an ISR for when the ePWM counter reaches 0.

  • Counter equals to period (CTR=PRD) – Generates an ISR for when the ePWM counter reaches the period value.

  • Counter equals to Zero or period (CTR=Zero or CTR=PRD) – Generates an ISR for when the time base counter, TBCTR, reaches zero or when the time base counter reaches the period, TBCTR = TBPRD.

  • Disable – Disable ISR generation.

  • Counter is direction and equal to CMPx – Generates an ISR for when the counter equals the specified comparator and the counter direction is either incrementing or decrementing.

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

Video Capture

Select the Video Capture block in the processor model. You can use the View block button to open and highlight the block in the model.

This parameter specifies the VLS4 video device to use in the generated code as a Linux® hardware path.

Video Display

Select the Video Display block in the processor model. You can use the View block button to open and highlight the block in the model.

This parameter specifies the title of the video viewer shown on the screen of a connected monitor.

Audio Capture

Select the Audio Capture block in the processor model. You can use the View block button to open and highlight the block in the model.

This parameter specifies the ALSA hardware card, X, and device, Y, mapping on the embedded Linux device.

This parameter specifies the audio sampling frequency of the device managed by the ALSA driver. The selected value must be supported by the embedded Linux peripheral device.

Audio Playback

Select the Audio Playback block in the processor model. You can use the View block button to open and highlight the block in the model.

This parameter specifies the ALSA hardware card, X, and device, Y, mapping on the embedded Linux device.

This parameter specifies the audio sampling frequency of the device managed by the ALSA driver. The selected value must be supported by the peripheral device and the ALSA driver on your embedded Linux device.

Introduced in R2020b