Content including 1) features; 2) driver design logic and use method; 3) typical use case. More...

Features

Inter Peripheral Crossbar-Switch

This module implements an array of M N-input combinational muxes. All muxes share the same N inputs in the same order, but each mux has its own independent select field. The intended application of this module is to provide a flexible crossbar switch function that allows any input (typically from external GPIO or internal module outputs) to be connected to any output (typically to external GPIO or internal module inputs) under user control. This is used to allow user configuration of data paths between internal modules and between internal modules and GPIO.

A subset of the muxes can be configured to support edge detection and either interrupt or DMA request generation based on detected signal edges on the mux output. This allows signal transitions on the signals feeding the crossbar to trigger interrupts or initiate data transfers via DMA into or out of other system modules.

How this driver is designed

This driver is designed around the basic configuration unit of XBAR output which get input signal, edge detection mode and interrupt/dma generation configuration.

xbar output signal is defined in SOC header file with enumeration name as xbar_output_signal_t. This enumeration list all available signals with its meaning provided in enumerator. Note that not all XBAR output is able to generate interrupt/DMA according to edge detected in input signal, only xbar_output_signal_t enumerator equal or smaller than kXBAR_OuputMaxInterruptDMASignal can be configurated with edge detection and interrupt/dma request generation.

Available xbar input singal is also proivde in SOC header file with enumeration name as xbar_input_signal_t.

There are a series of MACRO functions starting with XBAR_ provided but it is not necessary to understand these macro function on using this driver. These macro functions are provided to find the register fields to operate with a given xbar output xbar_output_signal_t.

This driver provide several function group to do with the configuration of output channel.

Initialization and Deinitialization groups
- This group initialize / deinitialize the XBAR module not relevant to specific output signal.
- This gorup init a xbar output with all supported configuration.
Output configuration Interface
- This group provide configuration API to do functionality configuration for one XBAR output.
Status Get/Clear Interface
- This group Get/Clear status flags. This peripheral get only one type of status flag.

How to use this driver

Action needed outside driver
Initialize XBAR module calling XBAR_Init(), Note that this only need be called once.
Configure the signal connection by calling XBAR_SetSignalConnection.
[Optional] Configure the edge detection mode xbara_active_edge_t and configure the interrupt/dma request generation when edge detected.

Typical use case

NA