How to add a new Board to the library

In order to create a new board wiring for a board "XBOARD" with an ATmega32, do

Create a board name.

Create a short and a long name for the board. The long form should contain 12 ... 16 upper case letters and numbers and underlines, e.g.

long : XBOARD_MEGA32
e.g.: RDK_230, STK_541, WDB_A1281, ...

The short form should contain 4 ... 8 lower case letters and numbers, e.g.

short : xbrd32
e.g.: rcb230, stk541, wdba1281, ...

Modify const.h

add long name identifier macro of board name

    /*=== board constants ================================================*/
    #define  STK500_MEGA8    (1) 
    #define  STK500_MEGA16   (2) 
    #define  IC_MEGA8_8      (3) 
    #define  ICT_RF230       (4) 
    #define  XBOARD_MEGA32   (5)

add a CPU macro, if not already defined

    /*=== cpu constants ==================================================*/
    #define  CPU_M8          (1) 
    #define  CPU_M16         (2) 
    #define  CPU_M1281       (3) 
    #define  CPU_M32         (4)

Modify board.h

add the include statement for the board definition header file board_xbrdm32.h.

   #elif defined(xbrdm32)
   # include "board_xbrdm32.h"
   #else
   # error ....
   #endif

Create a board definition header file

copy board_dummy.h to board_xbrdm32.h
- fill wiring comment
- replace include guards BOARD_DUMMY_H with BOARD_XBRDM32_H
- fill CPU_TYPE (see const.h, if necessarry add your cpu there)
- fill all "..." placeholder according your wiring
- for impl. of the Macros TRX_IRQ_INIT, DI_TRX_IRQ,EI_TRX_IRQ consult the CPU data sheet
- in necessary adapt the inline function SPI_INIT
- implement LED_SET_VALUE and LED_GET_VALUE in order to reflect if your LED's react inverted (STK500) or not.
- TUNED_OSCCAL is necessarry if your CPU uses the internal RC Oscilator and runs at different voltage level then during the factory calibration of your CPU. Use the calosc.c application in order to check this. Tuning the OSCCAL register is only needed, if you need a correct uart baud rate.

Add the board documentation.

Insert the board definition in the doxy_input_files variable in Doc/Usr/SConscript

doc["doxy_input_files"] = doc.Split("""\
                            Doc/trx.dox
                            Src/Lib/Inc/const.h
                            Src/Lib/Inc/board.h
                            Src/Lib/Inc/boards/board_dummy.h
                            Src/Lib/Inc/boards/board_stkm8.h
                            Src/Lib/Inc/boards/board_stkm16.h
                            Src/Lib/Inc/boards/board_icm8.h
                            Src/Lib/Inc/boards/board_ict230.h
                            Src/Lib/Inc/boards/board_xbrd32.h
                            Src/Lib/Inc/radio.h
                            Src/Lib/Inc/rf230/trx_rf230.h
                            Src/Lib/Rf230/radio_rf230.c
                            Src/Lib/Rf230/trx_rf230.c
                            """)

Add the board to the build process.

edit SConstruct and add the CPU type for the new board

        com['boardopts'] = {
            "stkm8" :  "atmega8",
            "stkm16":  "atmega16",
            "icm8"  :  "atmega8",
            "ict230":  "atmega1281",
            "xbrd32":  "atmega32",
            }