Microchip® Advanced Software Framework

 All Data Structures Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
Feature definitions
XMEGA-A3BU Xplained board

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)
 

#define AT45DBX_CS   IOPORT_CREATE_PIN(PORTF, 4)

Referenced by board_init().

#define AT45DBX_MASTER_MISO   IOPORT_CREATE_PIN(PORTD, 2)

MISO pin.

Referenced by board_init().

#define AT45DBX_MASTER_MOSI   IOPORT_CREATE_PIN(PORTD, 3)

MOSI pin.

Referenced by board_init().

#define AT45DBX_MASTER_SCK   IOPORT_CREATE_PIN(PORTD, 1)

SCK pin.

Referenced by board_init().

#define AT45DBX_SPI   &USARTD0
#define AT86RFX_INTC_INIT ( )
Value:
ioport_configure_pin(AT86RFX_IRQ_PIN, IOPORT_DIR_INPUT); \
PORTC.PIN2CTRL = PORT_ISC0_bm; \
PORTC.INT0MASK = PIN2_bm; \
PORTC.INTFLAGS = PORT_INT0IF_bm;
ioport_configure_pin
static void ioport_configure_pin(port_pin_t pin, port_pin_flags_t flags)
Select the port function for a single pin.
Definition: ioport_compat.h:172
IOPORT_DIR_INPUT
Definition: ioport.h:77
AT86RFX_IRQ_PIN
#define AT86RFX_IRQ_PIN
Definition: xmega_a3bu_xplained.h:207
#define AT86RFX_IRQ_PIN   IOPORT_CREATE_PIN(PORTC, 2)
#define AT86RFX_ISR ( )    ISR(PORTC_INT0_vect)
#define AT86RFX_MISC_PIN   IOPORT_CREATE_PIN(PORTC, 1)
#define AT86RFX_RST_PIN   IOPORT_CREATE_PIN(PORTC, 0)

Referenced by board_init().

#define AT86RFX_SLP_PIN   IOPORT_CREATE_PIN(PORTC, 3)

Referenced by board_init().

#define AT86RFX_SPI   &SPIC
#define AT86RFX_SPI_CS   IOPORT_CREATE_PIN(PORTC, 4)

Referenced by board_init().

#define AT86RFX_SPI_MISO   IOPORT_CREATE_PIN(PORTC, 6)

Referenced by board_init().

#define AT86RFX_SPI_MOSI   IOPORT_CREATE_PIN(PORTC, 5)

Referenced by board_init().

#define AT86RFX_SPI_SCK   IOPORT_CREATE_PIN(PORTC, 7)

Referenced by board_init().

#define BOARD_XOSC_HZ   32768

Referenced by osc_get_rate(), and sysclk_get_main_hz().

#define BOARD_XOSC_STARTUP_US   1000000
#define BOARD_XOSC_TYPE   XOSC_TYPE_32KHZ

Referenced by osc_enable_external().

#define CLEAR_TRX_IRQ ( )    (PORTC.INTFLAGS = PORT_INT0IF_bm)

Clears the transceiver main interrupt.

#define COMMON_SENSOR_PLATFORM

Validate board support for the common sensor service.

#define DISABLE_TRX_IRQ ( )    (PORTC.INTCTRL &= ~PORT_INT0LVL_gm)

Disables the transceiver main interrupt.

#define ENABLE_TRX_IRQ ( )    (PORTC.INTCTRL |= PORT_INT0LVL_gm)

Enables the transceiver main interrupt.

#define ENTER_TRX_REGION ( )    { uint8_t irq_mask = PORTC.INTCTRL; PORTC.INTCTRL &= ~PORT_INT0LVL_gm
#define FILTER_INPUT_SIGNAL_PIN   IOPORT_CREATE_PIN(PORTF, 0)
#define FILTER_OUTPUT_ADC_INPUT   ADCCH_POS_PIN2
#define FILTER_OUTPUT_ADC_MODULE   ADCA
#define FILTER_OUTPUT_SIGNAL_PIN   IOPORT_CREATE_PIN(PORTA, 2)
#define GPIO_PUSH_BUTTON_0   IOPORT_CREATE_PIN(PORTE, 5)

Referenced by board_init().

#define GPIO_PUSH_BUTTON_1   IOPORT_CREATE_PIN(PORTF, 1)

Referenced by board_init().

#define GPIO_PUSH_BUTTON_2   IOPORT_CREATE_PIN(PORTF, 2)

Referenced by board_init().

#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)
#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)
#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)
#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)
#define LCD_BACKLIGHT_ENABLE_LEVEL   true
#define LCD_BACKLIGHT_ENABLE_PIN   IOPORT_CREATE_PIN(PORTE, 4)
#define LCD_HEIGHT_PIXELS   (32)
#define LCD_WIDTH_PIXELS   (128)
#define LEAVE_TRX_REGION ( )    PORTC.INTCTRL = irq_mask; }
#define LED0   LED0_GPIO
#define LED0_GPIO   IOPORT_CREATE_PIN(PORTR, 0)

Referenced by board_init().

#define LED1   LED1_GPIO
#define LED1_GPIO   IOPORT_CREATE_PIN(PORTR, 1)

Referenced by board_init().

#define LED2   LED2_GPIO
#define LED2_GPIO   IOPORT_CREATE_PIN(PORTD, 4)

Referenced by board_init().

#define LED3   LED3_GPIO
#define LED3_GPIO   IOPORT_CREATE_PIN(PORTD, 5)

Referenced by board_init().

#define LED_COUNT   4

Number of LEDs.

#define LIGHT_SENSOR_ADC_INPUT   ADCCH_POS_PIN0
#define LIGHT_SENSOR_ADC_MODULE   ADCA
#define LIGHT_SENSOR_SIGNAL_PIN   IOPORT_CREATE_PIN(PORTA, 0)
#define MXT143E_XPLAINED_BACKLIGHT   IOPORT_CREATE_PIN(PORTA, 4)

Referenced by board_init().

#define MXT143E_XPLAINED_CHG   IOPORT_CREATE_PIN(PORTC, 2)

Referenced by board_init().

#define MXT143E_XPLAINED_CS   IOPORT_CREATE_PIN(PORTC, 4)

Referenced by board_init().

#define MXT143E_XPLAINED_DC   IOPORT_CREATE_PIN(PORTC, 3)

Referenced by board_init().

#define MXT143E_XPLAINED_LCD_RESET   IOPORT_CREATE_PIN(PORTA, 6)

Referenced by board_init().

#define MXT143E_XPLAINED_MISO   IOPORT_CREATE_PIN(PORTC, 6)

Referenced by board_init().

#define MXT143E_XPLAINED_MOSI   IOPORT_CREATE_PIN(PORTC, 5)

Referenced by board_init().

#define MXT143E_XPLAINED_SCK   IOPORT_CREATE_PIN(PORTC, 7)

Referenced by board_init().

#define MXT143E_XPLAINED_TWI   &TWIC
#define MXT143E_XPLAINED_USART_SPI   &USARTC1
#define NHD_C12832A1Z_BACKLIGHT   IOPORT_CREATE_PIN(PORTE, 4)

The backlight is active high.

Referenced by board_init().

#define NHD_C12832A1Z_CSN   IOPORT_CREATE_PIN(PORTF, 3)

Referenced by board_init().

#define NHD_C12832A1Z_REGISTER_SELECT   IOPORT_CREATE_PIN(PORTD, 0)

If this signal is set high display data is sent otherwise commands.

Referenced by board_init().

#define NHD_C12832A1Z_RESETN   IOPORT_CREATE_PIN(PORTA, 3)

Referenced by board_init().

#define NHD_C12832A1Z_SPI   &USARTD0
#define NHD_C12832A1Z_SPI_MOSI   IOPORT_CREATE_PIN(PORTD, 3)

Referenced by board_init().

#define NHD_C12832A1Z_SPI_SCK   IOPORT_CREATE_PIN(PORTD, 1)

Referenced by board_init().

#define QTOUCH_BUTTON_SNS   IOPORT_CREATE_PIN(PORTF, 6)
#define QTOUCH_BUTTON_SNSK   IOPORT_CREATE_PIN(PORTF, 7)
#define SPIC_MISO   IOPORT_CREATE_PIN(PORTC, 6)
#define SPIC_MOSI   IOPORT_CREATE_PIN(PORTC, 5)
#define SPIC_SCK   IOPORT_CREATE_PIN(PORTC, 7)
#define SPIC_SS   IOPORT_CREATE_PIN(PORTC, 4)
#define TEMPERATURE_SENSOR_ADC_INPUT   ADCCH_POS_PIN1
#define TEMPERATURE_SENSOR_ADC_MODULE   ADCA
#define TEMPERATURE_SENSOR_SIGNAL_PIN   IOPORT_CREATE_PIN(PORTA, 1)
#define TWIC_SCL   IOPORT_CREATE_PIN(PORTC, 1)
#define TWIC_SDA   IOPORT_CREATE_PIN(PORTC, 0)
#define USARTC0_RXD   IOPORT_CREATE_PIN(PORTC, 2)
#define USARTC0_TXD   IOPORT_CREATE_PIN(PORTC, 3)
Generated on Sat Mar 5 2022 00:03:52 for Common API for Clocks Control / Example 2 for XMEGA-A3BU XPLAINED by   doxygen 1.8.5