CCS C Compiler Manual PCB / PCM / PCH

pin_select()
Syntax:
Parameters:
pin_select(peripheral_pin, pin, [unlock],[lock])
peripheral_pin – a constant string specifying which peripheral pin to map
the specified pin to. Refer to #pin_select for all available strings. Using
“NULL” for the peripheral_pin parameter will unassign the output
peripheral pin that is currently assigned to the pin passed for the pin
parameter.
pin – the pin to map to the specified peripheral pin. Refer to device's
header file for pin defines. If the peripheral_pin parameter is an input,
passing FALSE for the pin parameter will unassign the pin that is
currently assigned to that peripheral pin.
unlock – optional parameter specifying whether to perform an unlock
sequence before writing the RPINRx or RPORx register register
determined by peripheral_pin and pin options. Default is TRUE if not
specified. The unlock sequence must be performed to allow writes to the
RPINRx and RPORx registers. This option allows calling pin_select()
multiple times without performing an unlock sequence each time.
Returns:
Availability:
Requires:
Examples:
lock – optional parameter specifying whether to perform a lock sequence
after writing the RPINRx or RPORx registers. Default is TRUE if not
specified. Although not necessary it is a good idea to lock the RPINRx
and RPORx registers from writes after all pins have been mapped. This
option allows calling pin_select() multiple times without performing a
lock sequence each time.
Nothing.
On device with remappable peripheral pins.
Pin defines in device's header file.
pin_select(“U2TX”,PIN_B0);
//Maps PIN_B0 to U2TX //peripheral pin, performs unlock
//and lock sequences.
pin_select(“U2TX”,PIN_B0,TRUE,FALSE);
//Maps PIN_B0 to U2TX //peripheral pin and performs //unlock
sequence.
pin_select(“U2RX”,PIN_B1,FALSE,TRUE);
Example Files:
Also See:
//Maps PIN_B1 to U2RX //peripheral pin and performs lock
//sequence.
None.
#pin_select
160