RTEMS  5.1
Functions | Variables
pinmux.c File Reference

I/O Multiplexing Module (IOMM) basic support. More...

#include <bsp/tms570.h>
#include <bsp/tms570-pinmux.h>
#include <bsp/irq.h>

Functions

void tms570_bsp_pin_set_function (int pin_num, int pin_fnc)
 select desired function of pin/ball More...
 
void tms570_bsp_pin_clear_function (int pin_num, int pin_fnc)
 clear connection between pin and specified peripherals/function More...
 
void tms570_bsp_pin_config_one (uint32_t pin_num_and_fnc)
 configure one pin according to its function specification More...
 
void tms570_bsp_pinmmr_config (const uint32_t *pinmmr_values, int reg_start, int reg_count)
 configure block or whole pin multiplexer More...
 

Variables

uint32_t tms570_bsp_pinmmr_kick_key0 = 0x83E70B13U
 
uint32_t tms570_bsp_pinmmr_kick_key1 = 0x95A4F1E0U
 

Detailed Description

I/O Multiplexing Module (IOMM) basic support.

Function Documentation

◆ tms570_bsp_pin_clear_function()

void tms570_bsp_pin_clear_function ( int  pin_num,
int  pin_fnc 
)

clear connection between pin and specified peripherals/function

This function switches off given connection and leaves rest of multiplexer setup intact.

Parameters
[in]pin_numpin/ball identifier (index into pinmux array)
[in]pin_fncfunction number 0 .. 7, if value TMS570_PIN_FNC_AUTO is specified then pin function is extracted from pin_num argument
Return values
Void

◆ tms570_bsp_pin_config_one()

void tms570_bsp_pin_config_one ( uint32_t  pin_num_and_fnc)

configure one pin according to its function specification

The function setups multiplexer to interconnect pin with specified function/peripheral. Predefined values for pins combined with function are in a format TMS570_BALL_ column row function (for example TMS570_BALL_W3_SCIRX). If the function can be connected to more pins then specification includes infomation which allows to disconnect alternative pin to peripheral input connection or switch input multiplexer to right pin.

Parameters
[in]pin_num_and_fncpin function descriptor is build by macro TMS570_PIN_AND_FNC which takes pin/pinmmr specification build by TMS570_BALL_WITH_MMR and function index in output multiplexer. If the peripheral can be connected to other input alternative then actual pin description and alternative to disconnected/reconnect are combined together by TMS570_PIN_WITH_IN_ALT macro. If clear of alternative connection is required then flag TMS570_PIN_CLEAR_RQ_MASK is ored to alternative description.
Return values
Void

◆ tms570_bsp_pin_set_function()

void tms570_bsp_pin_set_function ( int  pin_num,
int  pin_fnc 
)

select desired function of pin/ball

The function setups multiplexer to interconnect pin with specified function/peripheral. Pin number is index into pinmux entries array. Predefined values for pins are in a format TMS570_BALL_ column row (for example TMS570_BALL_N19). The multiplexer allows to interconnect one pin to multiple signal sources/sinks in the theory but it is usually bad choice. The function sets only specified function and clears all other connections.

Parameters
[in]pin_numpin/ball identifier (index into pinmux array),
[in]pin_fncfunction number 0 .. 7, if value TMS570_PIN_FNC_AUTO is specified then pin function is extracted from pin_num argument
Return values
Void

◆ tms570_bsp_pinmmr_config()

void tms570_bsp_pinmmr_config ( const uint32_t *  pinmmr_values,
int  reg_start,
int  reg_count 
)

configure block or whole pin multiplexer

Function change multiplexer content. It is intended for initial chip setup and does not use locking. If complete reconfiguration is required at runtime then it is application responsibility to protect and serialize change with peripherals drivers and parallel calls

Parameters
[in]pinmmr_valuespointer to array with required multiplexer setup
[in]reg_startstarting register, this allows to configure non-consecutive registers groups found on some MCU family members
[in]reg_countnumber of words in initialization array to set to corresponding registers
Return values
Void