Board_Data.c

/************************************************************************/
/*  																	*/
/*	Board_Data.c --	Default Board Customization Data Declarations		*/
/*																		*/
/************************************************************************/
/*	Author: Gene Apperson												*/
/*	Copyright 2011, Digilent. All rights reserved						*/
/************************************************************************/
/*  File Description:													*/
/*																		*/
/* This file contains the board specific declartions and data structure	*/
/* to customize the chipKIT MPIDE for use with a generic board using a	*/
/* PIC32 part in a 64-pin package.										*/
/*																		*/
/* This code is based on earlier work:									*/
/*		Copyright (c) 2010, 2011 by Mark Sproul							*/
/*		Copyright (c) 2005, 2006 by David A. Mellis						*/
/*																		*/
/************************************************************************/
/*  Revision History:													*/
/*																		*/
/*	11/28/2011(GeneA): Created by splitting data out of Board_Defs.h	*/
/*  03/11/2012(BrianS): Modified for Fubarino board                     */
/*	02/12/2013(GeneA): removed dependency on Microchip plib library		*/
/*  20/05/2013(): Modified for Olimex Pinguino32 board					*/
/*  03/12/2013(SPP): Modified for Olimex Pinguino32 Micro board			*/
/*																		*/
/************************************************************************/
//*	This library is free software; you can redistribute it and/or
//*	modify it under the terms of the GNU Lesser General Public
//*	License as published by the Free Software Foundation; either
//*	version 2.1 of the License, or (at your option) any later version.
//*	
//*	This library is distributed in the hope that it will be useful,
//*	but WITHOUT ANY WARRANTY; without even the implied warranty of
//*	MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
//*	Lesser General Public License for more details.
//*	
//*	You should have received a copy of the GNU Lesser General
//*	Public License along with this library; if not, write to the
//*	Free Software Foundation, Inc., 59 Temple Place, Suite 330,
//*	Boston, MA  02111-1307  USA
/************************************************************************/

#if !defined(BOARD_DATA_C)
#define BOARD_DATA_C

#include <inttypes.h>
#include <Board_Defs.h>

/* ------------------------------------------------------------ */
/*					Data Tables									*/
/* ------------------------------------------------------------ */
/* The following declarations define data used in pin mapping.	*/
/* ------------------------------------------------------------ */

#if defined(OPT_BOARD_DATA)

/* ------------------------------------------------------------ */
/* This table is used to map from port number to the address of
** the TRIS register for the port. This is used for setting the
** pin direction.
*/
const uint32_t	port_to_tris_PGM[] = {
	NOT_A_PORT,				//index value 0 is not used

#if defined(_PORTA)
	(uint32_t)&TRISA,
#else
	NOT_A_PORT,
#endif

#if defined(_PORTB)
	(uint32_t)&TRISB,
#else
	NOT_A_PORT,
#endif

#if defined(_PORTC)
	(uint32_t)&TRISC,
#else
	NOT_A_PORT,
#endif

#if defined(_PORTD)
	(uint32_t)&TRISD,
#else
	NOT_A_PORT,
#endif

#if defined(_PORTE)
	(uint32_t)&TRISE,
#else
	NOT_A_PORT,
#endif

#if defined(_PORTF)
	(uint32_t)&TRISF,
#else
	NOT_A_PORT,
#endif

#if defined(_PORTG)
	(uint32_t)&TRISG,
#else
	NOT_A_PORT,
#endif

	NOT_A_PORT,
};

/* ------------------------------------------------------------ */
/* This table is used to map the digital pin number to the port
** containing that pin. The default mapping is to assign pin numbers
** for every possible port bit in order from PORTA to PORTG.
*/
const uint8_t	digital_pin_to_port_PGM[] = {
	NOT_A_PORT,	//	0

	_IOPORT_PC,	//  1  RC14
	_IOPORT_PC,	//  2  RC13
	_IOPORT_PE,	//  3  RE0
	_IOPORT_PE,	//  4  RE1
	_IOPORT_PE,	//  5  RE2
	_IOPORT_PE,	//  6  RE3
	_IOPORT_PE,	//  7  RE4
	_IOPORT_PE,	//  8  RE5
	_IOPORT_PE,	//  9  RE6
	_IOPORT_PE,	//  10 RE7
	_IOPORT_PF,	//  11 RF1
	_IOPORT_PG,	//  12 RG9
	_IOPORT_PD,	//  13 RD11
	_IOPORT_PD,	//  14 RD8
	_IOPORT_PD,	//  15 RD7
	_IOPORT_PB,	//  16 RB0
	NOT_A_PORT,	//  17 GND
	_IOPORT_PB,	//  18 RB0	?
	NOT_A_PORT,	//  19 5V
	NOT_A_PORT,	//  20 GND
	
	_IOPORT_PD,	//  21 RD6
	_IOPORT_PD,	//  22 RD5
	_IOPORT_PD,	//  23 RD4	?
	_IOPORT_PD,	//  24 RD3
	_IOPORT_PD,	//  25 RD2
	_IOPORT_PD,	//  26 RD1
	_IOPORT_PB,	//  27 RB14
    	_IOPORT_PB,	//  28 RB12
	_IOPORT_PB,	//  29 RB11
	_IOPORT_PB,	//  30 RB10
	_IOPORT_PB,	//  31 RB9
	_IOPORT_PB,	//  32 RB8
	_IOPORT_PB,	//  33 RB4
	_IOPORT_PB,	//  34 RB3
	_IOPORT_PB,	//  35 RB2
	_IOPORT_PB,	//  36 RB1
	NOT_A_PORT,	//  37 3.3V
	NOT_A_PORT,	//  38 GND
	NOT_A_PORT,	//  39 5V
	NOT_A_PORT,	//  40 GND
	
	// UEXT connector
	NOT_A_PORT, 	//	41 3.3V
	NOT_A_PORT,	//	42 GND
	_IOPORT_PF,	//	43 RF5
	_IOPORT_PF,	//	44 RF4
	_IOPORT_PD,	//	45 RD10
	_IOPORT_PD,	//	46 RD9
	_IOPORT_PG,	//	47 RG7
	_IOPORT_PG,	//	48 RG8
	_IOPORT_PG,	//	49 RG6
	_IOPORT_PF,	//	50 RF0

	_IOPORT_PB,	//   	51 RB13
};

/* ------------------------------------------------------------ */
/* This table is used to map from digital pin number to a bit mask
** for the corresponding bit within the port.
*/
const uint16_t	digital_pin_to_bit_mask_PGM[] = {
	_BV( 0 ) ,	//  0

	_BV( 14) ,	//  1  RC14
	_BV( 13) ,	//  2  RC13
	_BV( 0 ) ,	//  3  RE0
	_BV( 1 ) ,	//  4  RE1
	_BV( 2 ) ,	//  5  RE2
	_BV( 3 ) ,	//  6  RE3
	_BV( 4 ) ,	//  7  RE4
	_BV( 5 ) ,	//  8  RE5
	_BV( 6 ) ,	//  9  RE6
	_BV( 7 ) ,	//  10 RE7
	_BV( 1 ) ,	//  11 RF1
	_BV( 9 ) ,	//  12 RG9
	_BV( 11) ,	//  13 RD11
	_BV( 8 ) ,	//  14 RD8
	_BV( 7 ) ,	//  15 RD7
	_BV( 0 ) ,	//  16 RB0
	_BV( 0 ) ,	//  17 GND
	_BV( 0 ) ,	//  18 RB0	?
	_BV( 0 ) ,	//  19 5V
	_BV( 0 ) ,	//  20 GND
	
	_BV( 6 ) ,	//  21 RD6
	_BV( 5 ) ,	//  22 RD5
	_BV( 4 ) ,	//  23 RD4	?
	_BV( 3 ) ,	//  24 RD3
	_BV( 2 ) ,	//  25 RD2
	_BV( 1 ) ,	//  26 RD1
	_BV( 14) ,	//  27 RB14
   	_BV( 12) ,	//  28 RB12
	_BV( 11) ,	//  29 RB11
	_BV( 10) ,	//  30 RB10
	_BV( 9 ) ,	//  31 RB9
	_BV( 8 ) ,	//  32 RB8
	_BV( 4 ) ,	//  33 RB4
	_BV( 3 ) ,	//  34 RB3
	_BV( 2 ) ,	//  35 RB2
	_BV( 1 ) ,	//  36 RB1
	_BV( 0 ) ,	//  37 3.3V
	_BV( 0 ) ,	//  38 GND
	_BV( 0 ) ,	//  39 5V
	_BV( 0 ) ,	//  40 GND

	_BV( 0 ), //	41 3.3V
	_BV( 0 ),	//	42 GND
	_BV( 5 ),	//	43 RF5
	_BV( 4 ),	//	44 RF4
	_BV( 10),	//	45 RD10
	_BV( 9 ),	//	46 RD9
	_BV( 7 ),	//	47 RG7
	_BV( 8 ),	//	48 RG8
	_BV( 6 ),	//	49 RG6
	_BV( 0 ),	//	50 RF0
	_BV( 13),	//	51 RB13
};

/* ------------------------------------------------------------ */
/* This table is used to map from digital pin number to the output
** compare number, input capture number, and timer external clock
** input associated with that pin.
*/
const uint16_t	digital_pin_to_timer_PGM[] = {
	NOT_ON_TIMER,	// 0

	NOT_ON_TIMER,	//  1  RC14
	NOT_ON_TIMER,	//  2  RC13
	NOT_ON_TIMER,	//  3  RE0
	NOT_ON_TIMER,	//  4  RE1
	NOT_ON_TIMER,	//  5  RE2
	NOT_ON_TIMER,	//  6  RE3
	NOT_ON_TIMER,	//  7  RE4
	NOT_ON_TIMER,	//  8  RE5
	NOT_ON_TIMER,	//  9  RE6
	NOT_ON_TIMER,	//  10 RE7
	NOT_ON_TIMER,	//  11 RF1
	NOT_ON_TIMER,	//  12 RG9
	_TIMER_IC4 ,	//  13 RD11
	_TIMER_IC1 ,	//  14 RD8
	NOT_ON_TIMER,	//  15 RD7
	NOT_ON_TIMER,	//  16 RB0
	NOT_ON_TIMER,	//  17 GND
	NOT_ON_TIMER,	//  18 RB0	?
	NOT_ON_TIMER,	//  19 5V
	NOT_ON_TIMER,	//  20 GND
	
	NOT_ON_TIMER,	//  21 RD6
	NOT_ON_TIMER,	//  22 RD5
	_TIMER_OC5 | _TIMER_IC5 ,	//  23 RD4	?
	_TIMER_OC4 ,	//  24 RD3
	_TIMER_OC3 ,	//  25 RD2
	_TIMER_OC2 ,	//  26 RD1
	NOT_ON_TIMER,	//  27 RB14
    NOT_ON_TIMER,	//  28 RB12
	NOT_ON_TIMER,	//  29 RB11
	NOT_ON_TIMER,	//  30 RB10
	NOT_ON_TIMER,	//  31 RB9
	NOT_ON_TIMER,	//  32 RB8
	NOT_ON_TIMER,	//  33 RB4
	NOT_ON_TIMER,	//  34 RB3
	NOT_ON_TIMER,	//  35 RB2
	NOT_ON_TIMER,	//  36 RB1
	NOT_ON_TIMER,	//  37 3.3V
	NOT_ON_TIMER,	//  38 GND
	NOT_ON_TIMER,	//  39 5V
	NOT_ON_TIMER,	//  40 GND
	
	NOT_A_PORT, 	//	41 3.3V
	NOT_A_PORT,	//	42 GND
	_IOPORT_PB,	//	43 RF5
	_IOPORT_PB,	//	44 RF4
	_TIMER_IC3,	//	45 RD10
	_TIMER_IC2,	//	46 RD9
	_IOPORT_PB,	//	47 RG7
	_IOPORT_PB,	//	48 RG8
	_IOPORT_PB,	//	49 RG6
	_IOPORT_PB,	//	50 RF0
	NOT_A_PORT,  	//	SS MMC
};


/* ------------------------------------------------------------ */
/* This table maps from a digital pin number to the corresponding
** analog pin number.
*/
//#if defined(_NOT_USED_)
const uint8_t digital_pin_to_analog_PGM[] = {
	NOT_ANALOG_PIN,	//	0

	NOT_ANALOG_PIN,	//  1  RC14
	NOT_ANALOG_PIN,	//  2  RC13
	NOT_ANALOG_PIN,	//  3  RE0
	NOT_ANALOG_PIN,	//  4  RE1
	NOT_ANALOG_PIN,	//  5  RE2
	NOT_ANALOG_PIN,	//  6  RE3
	NOT_ANALOG_PIN,	//  7  RE4
	NOT_ANALOG_PIN,	//  8  RE5
	NOT_ANALOG_PIN,	//  9  RE6
	NOT_ANALOG_PIN,	//  10 RE7
	NOT_ANALOG_PIN,	//  11 RF1
	NOT_ANALOG_PIN,	//  12 RG9
	NOT_ANALOG_PIN,	//  13 RD11
	NOT_ANALOG_PIN,	//  14 RD8
	NOT_ANALOG_PIN,	//  15 RD7
	_BOARD_AN0,	//  16 RB0
	NOT_ANALOG_PIN,	//  17 GND
	_BOARD_AN0,	//  18 RB0
	NOT_ANALOG_PIN,	//  19 5V
	NOT_ANALOG_PIN,	//  20 GND
	
	NOT_ANALOG_PIN,	//  21 RD6
	NOT_ANALOG_PIN,	//  22 RD5
	NOT_ANALOG_PIN,	//  23 RD4
	NOT_ANALOG_PIN,	//  24 RD3
	NOT_ANALOG_PIN,	//  25 RD2
	NOT_ANALOG_PIN,	//  26 RD1
	_BOARD_AN14,	//  27 RB14
    _BOARD_AN12,	//  28 RB12
	_BOARD_AN11,	//  29 RB11
	_BOARD_AN10,	//  30 RB10
	_BOARD_AN9,	//  31 RB9
	_BOARD_AN8,	//  32 RB8
	_BOARD_AN4,	//  33 RB4
	_BOARD_AN3,	//  34 RB3
	_BOARD_AN2,	//  35 RB2
	_BOARD_AN1,	//  36 RB1
	NOT_ANALOG_PIN,	//  37 3.3V
	NOT_ANALOG_PIN,	//  38 GND
	NOT_ANALOG_PIN,	//  39 5V
	NOT_ANALOG_PIN,	//  40 GND

	NOT_ANALOG_PIN, //	41 3.3V
	NOT_ANALOG_PIN,	//	42 GND
	NOT_ANALOG_PIN,	//	43 RF5
	NOT_ANALOG_PIN,	//	44 RF4
	NOT_ANALOG_PIN,	//	45 RD10
	NOT_ANALOG_PIN,	//	46 RD9
	NOT_ANALOG_PIN,	//	47 RG7
	NOT_ANALOG_PIN,	//	48 RG8
	NOT_ANALOG_PIN,	//	49 RG6
	NOT_ANALOG_PIN,	//	50 RF0
	NOT_ANALOG_PIN,	//	51 RB13
};
//#endif

/* ------------------------------------------------------------ */
/* This table is used to map from the analog pin number to the
** actual A/D converter channel used for that pin.
** In the default case, where there is a one-to-one mapping, this
** table isn't needed as the analogInPinToChannel() macro is defined
** to provide the mapping.
*/
//#if defined(_NOT_USED_)
const uint8_t analog_pin_to_channel_PGM[] = {
			//*	Arduino Pin		PIC32 Analog channel
	0,		//* 	A0
	1,		//*	A1
	2,		//*	A2
	3,		//*	A3
	4,		//*	A4
	5,		//*	A5
	6,		//*	A6
	7,		//*	A7
	8,		//*	A8
	9,		//*	A9
	10,		//*	A10
	11,		//*	A11
	12,		//*	A12
	13,		//*	A13
	14,		//*	A14
	15,		//*	A15
};
//#endif

/* ------------------------------------------------------------ */
/*		Include Files for Board Customization Functions			*/
/* ------------------------------------------------------------ */


/* ------------------------------------------------------------ */
/*				Board Customization Functions					*/
/* ------------------------------------------------------------ */
/*																*/
/* The following can be used to customize the behavior of some	*/
/* of the core API functions. These provide hooks that can be	*/
/* used to extend or replace the default behavior of the core	*/
/* functions. To use one of these functions, add the desired	*/
/* code to the function skeleton below and then set the value	*/
/* of the appropriate compile switch above to 1. This will		*/
/* cause the hook function to be compiled into the build and	*/
/* to cause the code to call the hook function to be compiled	*/
/* into the appropriate core function.							*/
/*																*/
/* ------------------------------------------------------------ */
/***	_board_init
**
**	Parameters:
**		none
**
**	Return Value:
**		none
**
**	Errors:
**		none
**
**	Description:
**		This function is called from the core init() function.
**		This can be used to perform any board specific init
**		that needs to be done when the processor comes out of
**		reset and before the user sketch is run.
*/
#if	(OPT_BOARD_INIT != 0)

void _board_init(void) {

	/*	Turn off Secondary oscillator so pins can be used as GPIO
	*/
	OSCCONCLR	=	_OSCCON_SOSCEN_MASK;

}

#endif

/* ------------------------------------------------------------ */
/***	_board_pinMode
**
**	Parameters:
**		pin		- digital pin number to configure
**		mode	- mode to which the pin should be configured
**
**	Return Value:
**		Returns 0 if not handled, !0 if handled.
**
**	Errors:
**		none
**
**	Description:
**		This function is called at the beginning of the pinMode
**		function. It can perform any special processing needed
**		when setting the pin mode. If this function returns zero,
**		control will pass through the normal pinMode code. If
**		it returns a non-zero value the normal pinMode code isn't
**		executed.
*/
#if	(OPT_BOARD_DIGITAL_IO != 0)

int	_board_pinMode(uint8_t pin, uint8_t mode) {

	return 0;

}

#endif

/* ------------------------------------------------------------ */
/***	_board_getPinMode
**
**	Parameters:
**		pin		- digital pin number
**		mode	- pointer to variable to receive mode value
**
**	Return Value:
**		Returns 0 if not handled, !0 if handled.
**
**	Errors:
**		none
**
**	Description:
**		This function is called at the beginning of the getPinMode
**		function. It can perform any special processing needed
**		when getting the pin mode. If this function returns zero,
**		control will pass through the normal getPinMode code. If
**		it returns a non-zero value the normal getPinMode code isn't
**		executed.
*/
#if	(OPT_BOARD_DIGITAL_IO != 0)

int	_board_getPinMode(uint8_t pin, uint8_t * mode) {

	return 0;

}

#endif

/* ------------------------------------------------------------ */
/***	_board_digitalWrite
**
**	Parameters:
**		pin		- digital pin number
**		val		- value to write to the pin
**
**	Return Value:
**		Returns 0 if not handled, !0 if handled.
**
**	Errors:
**		none
**
**	Description:
**		This function is called at the beginning of the digitalWrite
**		function. It can perform any special processing needed
**		in writing to the pin. If this function returns zero,
**		control will pass through the normal digitalWrite code. If
**		it returns a non-zero value the normal digitalWrite code isn't
**		executed.
*/
#if	(OPT_BOARD_DIGITAL_IO != 0)

int	_board_digitalWrite(uint8_t pin, uint8_t val) {
	
	return 0;

}

#endif

/* ------------------------------------------------------------ */
/***	_board_digitalRead
**
**	Parameters:
**		pin		- digital pin number
**		val		- pointer to variable to receive pin value
**
**	Return Value:
**		Returns 0 if not handled, !0 if handled.
**
**	Errors:
**		none
**
**	Description:
**		This function is called at the beginning of the digitalRead
**		function. It can perform any special processing needed
**		in reading from the pin. If this function returns zero,
**		control will pass through the normal digitalRead code. If
**		it returns a non-zero value the normal digitalRead code isn't
**		executed.
*/
#if	(OPT_BOARD_DIGITAL_IO != 0)

int	_board_digitalRead(uint8_t pin, uint8_t * val) {
	
	return 0;

}

#endif

/* ------------------------------------------------------------ */
/***	_board_analogRead
**
**	Parameters:
**		pin		- analog channel number
**		val		- pointer to variable to receive analog value
**
**	Return Value:
**		Returns 0 if not handled, !0 if handled.
**
**	Errors:
**		none
**
**	Description:
**		This function is called at the beginning of the analogRead
**		function. It can perform any special processing needed
**		in reading from the pin. If this function returns zero,
**		control will pass through the normal analogRead code. If
**		it returns a non-zero value the normal analogRead code isn't
**		executed.
*/
#if (OPT_BOARD_ANALOG_READ != 0)

int	_board_analogRead(uint8_t pin, int * val) {

	return 0;

}

#endif

/* ------------------------------------------------------------ */
/***	_board_analogReference
**
**	Parameters:
**
**	Return Value:
**		Returns 0 if not handled, !0 if handled.
**
**	Errors:
**		none
**
**	Description:
**		This function is called at the beginning of the analogReference
**		function. It can perform any special processing needed
**		to set the reference voltage. If this function returns zero,
**		control will pass through the normal analogReference code. If
**		it returns a non-zero value the normal analogReference code isn't
**		executed.
*/
#if (OPT_BOARD_ANALOG_READ != 0)

int	_board_analogReference(uint8_t mode) {

	return 0;

}

#endif

/* ------------------------------------------------------------ */
/***	_board_analogWrite
**
**	Parameters:
**		pin		- pin number
**		val		- analog value to write
**
**	Return Value:
**		Returns 0 if not handled, !0 if handled.
**
**	Errors:
**		none
**
**	Description:
**		This function is called at the beginning of the analogWrite
**		function. It can perform any special processing needed
**		in writing to the pin. If this function returns zero,
**		control will pass through the normal analogWrite code. If
**		it returns a non-zero value the normal analogWrite code isn't
**		executed.
*/
#if (OPT_BOARD_ANALOG_WRITE != 0)

int	_board_analogWrite(uint8_t pin, int val) {

	return 0;

}

#endif

#endif // OPT_BOARD_DATA

/* ------------------------------------------------------------ */

#endif	// BOARD_DATA_C

/************************************************************************/