XMEGA-A3BU-XPLAINED board header file.

This file contains definitions and services related to the features of the XMEGA-A3BU Xplained board.

To use this board define BOARD=XMEGA_A3BU_XPLAINED.

#include <compiler.h>

Macros
#define	BOARD_NAME "XMEGA-A3BU-XPLAINED"

#define	MCU_SOC_NAME "ATxmega256A3BU"

Miscellaneous data
#define	COMMON_SENSOR_PLATFORM
	Validate board support for the common sensor service. More...

LEDs
LED0 and LED1 are single yellow LEDs that are active low. LED2 and LED3 are inside one package (Led red and green close to USB connector) but can be controlled individually. LED2 has a red color and is active low. This LED can be used for general purposes. LED3 has a green color and is active high. By default this LED is on since it shall indicate that power is applied to the board. By pulling the gate of a N-FET low it is possible to turn off the LED if needed.
#define	LED0_GPIO IOPORT_CREATE_PIN(PORTR, 0)

#define	LED1_GPIO IOPORT_CREATE_PIN(PORTR, 1)

#define	LED2_GPIO IOPORT_CREATE_PIN(PORTD, 4)

#define	LED3_GPIO IOPORT_CREATE_PIN(PORTD, 5)

#define	LED0 LED0_GPIO

#define	LED1 LED1_GPIO

#define	LED2 LED2_GPIO

#define	LED3 LED3_GPIO

#define	LED_COUNT 4
	Number of LEDs. More...

Push buttons
#define	GPIO_PUSH_BUTTON_0 IOPORT_CREATE_PIN(PORTE, 5)

#define	GPIO_PUSH_BUTTON_1 IOPORT_CREATE_PIN(PORTF, 1)

#define	GPIO_PUSH_BUTTON_2 IOPORT_CREATE_PIN(PORTF, 2)

QTouch button
This button requires the software QTouch library
#define	QTOUCH_BUTTON_SNS IOPORT_CREATE_PIN(PORTF, 6)

#define	QTOUCH_BUTTON_SNSK IOPORT_CREATE_PIN(PORTF, 7)

Light sensor
#define	LIGHT_SENSOR_ADC_MODULE ADCA

#define	LIGHT_SENSOR_ADC_INPUT ADCCH_POS_PIN0

#define	LIGHT_SENSOR_SIGNAL_PIN IOPORT_CREATE_PIN(PORTA, 0)

Temperature sensor (NTC)
#define	TEMPERATURE_SENSOR_ADC_MODULE ADCA

#define	TEMPERATURE_SENSOR_ADC_INPUT ADCCH_POS_PIN1

#define	TEMPERATURE_SENSOR_SIGNAL_PIN IOPORT_CREATE_PIN(PORTA, 1)

Analog filter (lowpass RC @ 159 Hz)
#define	FILTER_INPUT_SIGNAL_PIN IOPORT_CREATE_PIN(PORTF, 0)

#define	FILTER_OUTPUT_ADC_MODULE ADCA

#define	FILTER_OUTPUT_ADC_INPUT ADCCH_POS_PIN2

#define	FILTER_OUTPUT_SIGNAL_PIN IOPORT_CREATE_PIN(PORTA, 2)

LCD backlight
#define	LCD_BACKLIGHT_ENABLE_PIN IOPORT_CREATE_PIN(PORTE, 4)

#define	LCD_BACKLIGHT_ENABLE_LEVEL true

LCD controller (NHD-C12832A1Z-FSW-FBW-3V3)
#define	NHD_C12832A1Z_SPI &USARTD0

#define	NHD_C12832A1Z_SPI_SCK IOPORT_CREATE_PIN(PORTD, 1)

#define	NHD_C12832A1Z_SPI_MOSI IOPORT_CREATE_PIN(PORTD, 3)

#define	NHD_C12832A1Z_CSN IOPORT_CREATE_PIN(PORTF, 3)

#define	NHD_C12832A1Z_REGISTER_SELECT IOPORT_CREATE_PIN(PORTD, 0)
	If this signal is set high display data is sent otherwise commands. More...

#define	NHD_C12832A1Z_RESETN IOPORT_CREATE_PIN(PORTA, 3)

#define	NHD_C12832A1Z_BACKLIGHT IOPORT_CREATE_PIN(PORTE, 4)
	The backlight is active high. More...

LCD dimensions
#define	LCD_WIDTH_PIXELS (128)

#define	LCD_HEIGHT_PIXELS (32)

DataFlash memory (AT45DBX)
#define	AT45DBX_SPI &USARTD0

#define	AT45DBX_CS IOPORT_CREATE_PIN(PORTF, 4)

#define	AT45DBX_MASTER_SCK IOPORT_CREATE_PIN(PORTD, 1)
	SCK pin. More...

#define	AT45DBX_MASTER_MOSI IOPORT_CREATE_PIN(PORTD, 3)
	MOSI pin. More...

#define	AT45DBX_MASTER_MISO IOPORT_CREATE_PIN(PORTD, 2)
	MISO pin. More...

MXT143E Xplained top module
#define	MXT143E_XPLAINED_TWI &TWIC

#define	MXT143E_XPLAINED_USART_SPI &USARTC1

#define	MXT143E_XPLAINED_CS IOPORT_CREATE_PIN(PORTC, 4)

#define	MXT143E_XPLAINED_SCK IOPORT_CREATE_PIN(PORTC, 7)

#define	MXT143E_XPLAINED_MOSI IOPORT_CREATE_PIN(PORTC, 5)

#define	MXT143E_XPLAINED_MISO IOPORT_CREATE_PIN(PORTC, 6)

#define	MXT143E_XPLAINED_CHG IOPORT_CREATE_PIN(PORTC, 2)

#define	MXT143E_XPLAINED_DC IOPORT_CREATE_PIN(PORTC, 3)

#define	MXT143E_XPLAINED_BACKLIGHT IOPORT_CREATE_PIN(PORTA, 4)

#define	MXT143E_XPLAINED_LCD_RESET IOPORT_CREATE_PIN(PORTA, 6)

External oscillator
Todo: Need to measure the actual startup time on the hardware.
#define	BOARD_XOSC_HZ 32768

#define	BOARD_XOSC_TYPE XOSC_TYPE_32KHZ

#define	BOARD_XOSC_STARTUP_US 1000000

Communication interfaces on header J1
#define	TWIC_SDA IOPORT_CREATE_PIN(PORTC, 0)

#define	TWIC_SCL IOPORT_CREATE_PIN(PORTC, 1)

#define	USARTC0_RXD IOPORT_CREATE_PIN(PORTC, 2)

#define	USARTC0_TXD IOPORT_CREATE_PIN(PORTC, 3)

#define	SPIC_SS IOPORT_CREATE_PIN(PORTC, 4)

#define	SPIC_MOSI IOPORT_CREATE_PIN(PORTC, 5)

#define	SPIC_MISO IOPORT_CREATE_PIN(PORTC, 6)

#define	SPIC_SCK IOPORT_CREATE_PIN(PORTC, 7)

Connections of the AT86RFX transceiver
#define	AT86RFX_SPI &SPIC

#define	AT86RFX_RST_PIN IOPORT_CREATE_PIN(PORTC, 0)

#define	AT86RFX_MISC_PIN IOPORT_CREATE_PIN(PORTC, 1)

#define	AT86RFX_IRQ_PIN IOPORT_CREATE_PIN(PORTC, 2)

#define	AT86RFX_SLP_PIN IOPORT_CREATE_PIN(PORTC, 3)

#define	AT86RFX_SPI_CS IOPORT_CREATE_PIN(PORTC, 4)

#define	AT86RFX_SPI_MOSI IOPORT_CREATE_PIN(PORTC, 5)

#define	AT86RFX_SPI_MISO IOPORT_CREATE_PIN(PORTC, 6)

#define	AT86RFX_SPI_SCK IOPORT_CREATE_PIN(PORTC, 7)

#define	AT86RFX_INTC_INIT()

#define	AT86RFX_ISR() ISR(PORTC_INT0_vect)

#define	ENABLE_TRX_IRQ() (PORTC.INTCTRL \|= PORT_INT0LVL_gm)
	Enables the transceiver main interrupt. More...

#define	DISABLE_TRX_IRQ() (PORTC.INTCTRL &= ~PORT_INT0LVL_gm)
	Disables the transceiver main interrupt. More...

#define	CLEAR_TRX_IRQ() (PORTC.INTFLAGS = PORT_INT0IF_bm)
	Clears the transceiver main interrupt. More...

#define	ENTER_TRX_REGION() { uint8_t irq_mask = PORTC.INTCTRL; PORTC.INTCTRL &= ~PORT_INT0LVL_gm

#define	LEAVE_TRX_REGION() PORTC.INTCTRL = irq_mask; }

Pin connections on header J1
The whole port C is directly connected to J1. Note For the TWI lines there are footprints for pull up resistors, which are by default not mounted on the board.
#define	J1_PIN0 IOPORT_CREATE_PIN(PORTC, 0)

#define	J1_PIN1 IOPORT_CREATE_PIN(PORTC, 1)

#define	J1_PIN2 IOPORT_CREATE_PIN(PORTC, 2)

#define	J1_PIN3 IOPORT_CREATE_PIN(PORTC, 3)

#define	J1_PIN4 IOPORT_CREATE_PIN(PORTC, 4)

#define	J1_PIN5 IOPORT_CREATE_PIN(PORTC, 5)

#define	J1_PIN6 IOPORT_CREATE_PIN(PORTC, 6)

#define	J1_PIN7 IOPORT_CREATE_PIN(PORTC, 7)

Pin connections on header J2
The lower half of port B is connected to the lower pins of J2 while the upper half of port A is connected to the upper pins of J2. The port pins are connected directly to this header and are not shared with any on-board functionality.
#define	J2_PIN0 IOPORT_CREATE_PIN(PORTB, 0)

#define	J2_PIN1 IOPORT_CREATE_PIN(PORTB, 1)

#define	J2_PIN2 IOPORT_CREATE_PIN(PORTB, 2)

#define	J2_PIN3 IOPORT_CREATE_PIN(PORTB, 3)

#define	J2_PIN4 IOPORT_CREATE_PIN(PORTA, 4)

#define	J2_PIN5 IOPORT_CREATE_PIN(PORTA, 5)

#define	J2_PIN6 IOPORT_CREATE_PIN(PORTA, 6)

#define	J2_PIN7 IOPORT_CREATE_PIN(PORTA, 7)

Pin connections on header J3
The lower half of port A is connected to the lower pins of J3 while the upper half of port B is connected to the upper pins of J3. Following pins are shared with on-board functionality: J3_PIN0 Light sensor output (can be disconnected via scratch pad) J3_PIN1 NTC sensor output (can be disconnected via scratch pad) J3_PIN2 Filter output (can be disconnected via scratch pad) J3_PIN3 Display reset input (can't be used when display is in use) J3_PIN4 JTAG TMS (pin can't be used while JTAG device connected) J3_PIN5 JTAG TDI (pin can't be used while JTAG device connected) J3_PIN6 JTAG TCK (pin can't be used while JTAG device connected) J3_PIN7 JTAG TDO & PID DATA (pin can't be used while JTAG/PDI device is connected)
#define	J3_PIN0 IOPORT_CREATE_PIN(PORTA, 0)

#define	J3_PIN1 IOPORT_CREATE_PIN(PORTA, 1)

#define	J3_PIN2 IOPORT_CREATE_PIN(PORTA, 2)

#define	J3_PIN3 IOPORT_CREATE_PIN(PORTA, 3)

#define	J3_PIN4 IOPORT_CREATE_PIN(PORTB, 4)

#define	J3_PIN5 IOPORT_CREATE_PIN(PORTB, 5)

#define	J3_PIN6 IOPORT_CREATE_PIN(PORTB, 6)

#define	J3_PIN7 IOPORT_CREATE_PIN(PORTB, 7)

Pin connections on header J4
The lower half of port E is connected to the lower pins of J4 and the lower half of port D is connected to the upper pins of J4.
#define	J4_PIN0 IOPORT_CREATE_PIN(PORTE, 0)

#define	J4_PIN1 IOPORT_CREATE_PIN(PORTE, 1)

#define	J4_PIN2 IOPORT_CREATE_PIN(PORTE, 2)

#define	J4_PIN3 IOPORT_CREATE_PIN(PORTE, 3)

#define	J4_PIN4 IOPORT_CREATE_PIN(PORTD, 0)

#define	J4_PIN5 IOPORT_CREATE_PIN(PORTD, 3)

#define	J4_PIN6 IOPORT_CREATE_PIN(PORTD, 2)

#define	J4_PIN7 IOPORT_CREATE_PIN(PORTD, 1)

Initialization
Note Define these symbols in conf_board.h to enable the corresponding features.
#define	CONF_BOARD_C12832A1Z
	Initialize SPI and control pins for C12832A1Z LCD controller. More...

#define	CONF_BOARD_AT45DBX
	Initialize SPI pins for AT45DBX DataFlash. More...

#define	CONF_BOARD_ENABLE_AC_PINS
	Initialize IO pins for Analog Comparator. More...

#define	CONF_BOARD_ENABLE_USARTC0
	Initialize IO pins for USART 0 on port C. More...

#define	CONF_BOARD_ENABLE_USARTD0
	Initialize IO pins for USART 0 on port D. More...

#define	CONF_BOARD_ENABLE_USARTE0
	Initialize IO pins for USART 0 on port E. More...

#define BOARD_NAME "XMEGA-A3BU-XPLAINED"

#define MCU_SOC_NAME "ATxmega256A3BU"

Microchip® Advanced Software Framework

Macros