Peripheral Pin Select Library

The Peripheral Pin Select library enables user to have more than one digital peripheral multiplexed on a single pin. Users may independently map the input and/or output of any one of many digital peripherals to any one of these I/O pins.
The peripherals managed by the Peripheral Pin Select library are all digital only peripherals.

A key difference between pin select and non pin select peripherals is that pin select peripherals are not associated with a default I/O pin. The peripheral must always be assigned to a specific I/O pin before it can be used.
In contrast, non pin select peripherals are always available on a default pin, assuming that the peripheral is active and not conflicting with another peripheral.

When a pin selectable peripheral is active on a given I/O pin, it takes priority over all other digital I/O and digital communication peripherals associated with the pin.

  Important :

Library Routines

Unlock_IOLOCK

Prototype

void Unlock_IOLOCK();

Description

Unlocks I/O pins for Peripheral Pin Mapping.

Parameters

None.

Returns

Nothing.

Requires

Nothing.

Example
Unlock_IOLOCK();
Notes

None.

Lock_IOLOCK

Prototype

void Lock_IOLOCK();

Description

Locks I/O pins for Peripheral Pin Mapping.

Parameters

None.

Returns

Nothing.

Requires

Nothing.

Example
Lock_IOLOCK();

PPS_Mapping

Prototype

unsigned PPS_Mapping(unsigned short rp_num, unsigned short direction, unsigned short funct_name);

Description

Sets desired internal MCU module to be mapped on the requested pins.

Parameters
Returns
  • 0 - if non-existing peripheral pin is selected.
  • 255 - if peripheral pin mapping was successful.
Requires

Nothing.

Example
PPS_Mapping(_RPC6, _OUTPUT, _U1TX);   // Sets pin PORTC.B6 to be Output and maps UART1 Transmit to it
PPS_Mapping(_RPC7, _INPUT, _U1RX);    // Sets pin PORTC.B7 to be Input and maps UART1 Receive to it
Notes

Use this routine when IOL1WAY bit is cleared.

PPS_Mapping_NoLock

Prototype

unsigned PPS_Mapping_NoLock(unsigned short rp_num, unsigned short input_output, unsigned short funct_name);

Description

Sets desired internal MCU module to be mapped on the requested pins.

This function doesn't use Unlock_IOLOCK and Lock_IOLOCK routines, so the user must call them before and after this function call (very useful if IOL1WAY bit is set, when after one lock sequence it is not possible to unlock it).

Parameters
Returns
  • 0 - if non-existing peripheral pin is selected.
  • 255 - if peripheral pin mapping was successful.
Requires

Nothing.

Example
Unlock_IOLOCK();

PPS_Mapping(_RPC6, _OUTPUT, _U1TX);   // Sets pin PORTC.B6 to be Output and maps UART1 Transmit to it
PPS_Mapping(_RPC7, _INPUT, _U1RX);    // Sets pin PORTC.B7 to be Input and maps UART1 Receive to it

Lock_IOLOCK();

Notes

None.

Remappable Pins

Pin Identifer Description
_RPA0 Remappable Pin PORTA.B0
_RPA1 Remappable Pin PORTA.B1
_RPA2 Remappable Pin PORTA.B2
_RPA3 Remappable Pin PORTA.B3
_RPA4 Remappable Pin PORTA.B4
_RPA8 Remappable Pin PORTA.B8
_RPA9 Remappable Pin PORTA.B9
_RPB0 Remappable Pin PORTB.B0
_RPB1 Remappable Pin PORTB.B1
_RPB2 Remappable Pin PORTB.B2
_RPB3 Remappable Pin PORTB.B3
_RPB4 Remappable Pin PORTB.B4
_RPB5 Remappable Pin PORTB.B5
_RPB6 Remappable Pin PORTB.B6
_RPB7 Remappable Pin PORTB.B7
_RPB8 Remappable Pin PORTB.B8
_RPB9 Remappable Pin PORTB.B9
_RPB10 Remappable Pin PORTB.B10
_RPB11 Remappable Pin PORTB.B11
_RPB12 Remappable Pin PORTB.B12
_RPB13 Remappable Pin PORTB.B13
_RPB14 Remappable Pin PORTB.B14
_RPB15 Remappable Pin PORTB.B15
_RPC0 Remappable Pin PORTC.B0
_RPC1 Remappable Pin PORTC.B1
_RPC2 Remappable Pin PORTC.B2
_RPC3 Remappable Pin PORTC.B3
_RPC4 Remappable Pin PORTC.B4
_RPC5 Remappable Pin PORTC.B5
_RPC6 Remappable Pin PORTC.B6
_RPC7 Remappable Pin PORTC.B7
_RPC8 Remappable Pin PORTC.B8
_RPC9 Remappable Pin PORTC.B9

Direction Parameters

Direction Parameter Description
_INPUT Sets selected pin as input
_OUTPUT Sets selected pin as output

Input Functions

Function Name Description
_REFCLKI Reference Input Clock
_OCFA Output Compare Fault A Input
_OCFB Output Compare Fault B Inputk
_IC1 Input Capture 1
_IC2 Input Capture 2
_IC3 Input Capture 3
_IC4 Input Capture 4
_IC5 Input Capture 5
_INT1 External Interrupt 1
_INT2 External Interrupt 2
_INT3 External Interrupt 3
_INT4 External Interrupt 4
_SDI1 SPI1 Data Input
_SDI2 SPI2 Data Input
_SS1 SPI1 Slave Select Input
_SS2 SPI2 Slave Select Input
_T2CK Timer2 External Clock
_T3CK Timer3 External Clock
_T4CK Timer4 External Clock
_T5CK Timer5 External Clock
_U1CTS UART1 Clear To Send
_U2CTS UART2 Clear To Send
_U1RX UART1 Receive
_U2RX UART2 Receive

Output Functions

Function Name Description
_C1OUT Comparator 1 Output
_C2OUT Comparator 2 Output
_OC1 Output Compare 1
_OC2 Output Compare 2
_OC3 Output Compare 3
_OC4 Output Compare 4
_OC5 Output Compare 5
_REFCLKO REFCLK output signal
_SDO1 SPI1 Data Output
_SDO2 SPI2 Data Output
_SS1X SPI1 Slave Synchronization or Frame Pulse I/O
_SS2X SPI2 Slave Synchronization or Frame Pulse I/O
_U1RTS UART1 Request To Send
_U2RTS UART2 Request To Send
_U1TX UART1 Transmit
_U2TX UART2 Transmit
Copyright (c) 2002-2012 mikroElektronika. All rights reserved.
What do you think about this topic ? Send us feedback!
Want more examples and libraries? 
Find them on LibStock - A place for the code