2.3-InternetRadio/nutos/nut/conf/repository.nut

--
-- Copyright (C) 2005-2007 by egnite Software GmbH. All rights reserved.
--
-- Redistribution and use in source and binary forms, with or without
-- modification, are permitted provided that the following conditions
-- are met:
--
-- 1. Redistributions of source code must retain the above copyright
--    notice, this list of conditions and the following disclaimer.
-- 2. Redistributions in binary form must reproduce the above copyright
--    notice, this list of conditions and the following disclaimer in the
--    documentation and/or other materials provided with the distribution.
-- 3. Neither the name of the copyright holders nor the names of
--    contributors may be used to endorse or promote products derived
--    from this software without specific prior written permission.
--
-- THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
-- ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
-- LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
-- FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
-- COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
-- INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
-- BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
-- OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
-- AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
-- OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF
-- THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
-- SUCH DAMAGE.
--
-- For additional information see http://www.ethernut.de/
--


-- The repository contains an enumerated list
-- of all top-level components.
--
-- $Log$
-- Revision 1.39  2009/03/06 23:54:31  olereinhardt
-- Added gorp library
--
-- Revision 1.38  2009/02/06 15:52:44  haraldkipp
-- Introduced target independent symbols for external interrutps.
--
-- Revision 1.37  2009/01/18 16:44:56  haraldkipp
-- Introduced target independent port numbers.
-- Distinguish between PIO IDs and port numbers.
--
-- Revision 1.36  2008/10/10 11:52:25  haraldkipp
-- Lua added.
--
-- Revision 1.35  2008/10/05 16:58:14  haraldkipp
-- Added new contrib directory for non-BSDL code.
--
-- Revision 1.34  2008/09/23 07:25:05  haraldkipp
-- Added support for remaining AT91SAM7 familiy members.
--
-- Revision 1.33  2008/08/28 11:08:20  haraldkipp
-- Added Lua routines which dynamically return GPIO ports and bits based on
-- the selected target platform.
--
-- Revision 1.32  2008/08/11 11:51:20  thiagocorrea
-- Preliminary Atmega2560 compile options, but not yet supported.
-- It builds, but doesn't seam to run properly at this time.
--
-- Revision 1.31  2008/08/06 12:51:07  haraldkipp
-- Added support for Ethernut 5 (AT91SAM9XE reference design).
--
-- Revision 1.30  2008/07/24 17:05:12  haraldkipp
-- Demonstrates some Configurator capabilities.
--
-- Revision 1.29  2008/07/14 13:04:28  haraldkipp
-- New Ethernut 3 link option with code in RAM and constant data in ROM.
--
-- Revision 1.28  2008/07/09 11:14:46  haraldkipp
-- Changelog corrected, again.
--
-- Revision 1.27  2008/04/01 10:12:08  haraldkipp
-- Added missing at91sam7s entries.
--
-- Revision 1.26  2008/02/15 17:05:52  haraldkipp
-- AT91SAM7SE512 support added. Global MCU list simplifies exclusivity
-- attribute. HW_EBI_AT91 added for MCUs with external bus interface.
--
-- Revision 1.25  2008/01/31 09:11:19  haraldkipp
-- Added ability to upload AT91 flash image via HTTP. Many thanks to
-- Matthias Wilde.
-- Added AVR ports H up to L.
--
-- Revision 1.24  2007/09/11 13:39:45  haraldkipp
-- Configurable startup file for ICCAVR.
--
-- Revision 1.23  2007/09/06 19:54:31  olereinhardt
-- Added ld script selection for eb40a_redboot_ram (EB40A Eval board with
-- redboot bootloader running, changed load address)
--
-- Revision 1.22  2007/04/12 09:09:27  haraldkipp
-- Allow to select empty entry for AT91 ports.
--
-- Revision 1.21  2007/02/15 16:19:44  haraldkipp
-- AT91 PIO IDs added.
--
-- Revision 1.20  2006/10/08 16:40:17  haraldkipp
-- Many thanks to Thiago Correa for adding LCD port configuration.
--
-- Revision 1.19  2006/10/05 17:14:03  haraldkipp
-- Added script, which extracts version information from C source file.
-- This demonstrates the new scripting capabilities of the Configurator.
--
-- Revision 1.18  2006/09/05 12:31:34  haraldkipp
-- Added missing linker script for SAM9260 applications running in external
-- RAM.
--
-- Revision 1.17  2006/08/01 07:34:16  haraldkipp
-- New linker script and new startup file support applications running in
-- flash memory.
--
-- Revision 1.16  2006/02/23 15:40:09  haraldkipp
-- Added choice for 32 bit ports.
--
-- Revision 1.15  2006/01/23 17:31:36  haraldkipp
-- Enhanced description of dev library.
--
-- Revision 1.14  2006/01/22 17:35:22  haraldkipp
-- Baudrate calculation for Ethernut 3 failed if MCU Clock was not specified.
--
-- Revision 1.13  2006/01/05 16:44:58  haraldkipp
-- PLL clock choices added.
--
-- Revision 1.12  2005/10/24 10:01:19  haraldkipp
-- New linker scripts added for AT91 apps running in RAM and ROM.
--
-- Revision 1.11  2005/10/07 22:10:29  hwmaier
-- Added support for PLATFORM macro
--
-- Revision 1.10  2005/07/26 16:14:21  haraldkipp
-- Better title for architecture.
--
-- Revision 1.9  2005/04/05 18:04:17  haraldkipp
-- Support for ARM7 Wolf Board added.
--
-- Revision 1.8  2005/01/22 19:18:37  haraldkipp
-- Changed AVR port configuration names from PORTx to AVRPORTx.
-- Added C++ support contributed by Oliver Schulz (MPI).
--
-- Revision 1.7  2004/11/24 14:47:24  haraldkipp
-- Empty items allow to disable choices
--
-- Revision 1.6  2004/10/03 18:37:39  haraldkipp
-- GBA support
--
-- Revision 1.5  2004/09/07 19:12:57  haraldkipp
-- Linker script support added
--
-- Revision 1.4  2004/09/01 14:09:49  haraldkipp
-- AVR interrupt selection simplified
--
-- Revision 1.3  2004/08/18 13:46:08  haraldkipp
-- Fine with avr-gcc
--
-- Revision 1.2  2004/08/03 15:09:30  haraldkipp
-- Another change of everything
--
-- Revision 1.1  2004/06/07 16:38:43  haraldkipp
-- First release
--
--

mcu_names = {
    "MCU_ATMEGA103",
    "MCU_ATMEGA128",
    "MCU_AT90CAN128",
    "MCU_AT90USB1287",
    "MCU_ATMEGA2560",
    "MCU_ATMEGA2561",
    "MCU_AT91SAM9260",
    "MCU_AT91SAM9G45",
    "MCU_AT91SAM9XE512",
    "MCU_AT91SAM7X128",
    "MCU_AT91SAM7X256",
    "MCU_AT91SAM7X512",
    "MCU_AT91SAM7S16",
    "MCU_AT91SAM7S32",
    "MCU_AT91SAM7S64",
    "MCU_AT91SAM7S128",
    "MCU_AT91SAM7S256",
    "MCU_AT91SAM7S512",
    "MCU_AT91SAM7SE32",
    "MCU_AT91SAM7SE256",
    "MCU_AT91SAM7SE512",
    "MCU_AT91R40008",
    "MCU_GBA",
    "MCU_LINUX_EMU",
    "MCU_H8_3068",
    "MCU_S3C4510B",
    "MCU_AVR32UC3A0512ES",
    "MCU_AVR32UC3A0512",
    "MCU_AVR32UC3A3256",
    "MCU_AVR32UC3B0256",
    "MCU_AVR32UC3B164",
    "MCU_AVR32UC3L064",
    "MCU_STM32F030",
    "MCU_STM32F031",
    "MCU_STM32F042",
    "MCU_STM32F051",
    "MCU_STM32F072",
    "MCU_STM32F101",
    "MCU_STM32F103",
    "MCU_STM32F105",
    "MCU_STM32F107",
    "MCU_STM32F205",
    "MCU_STM32F207",
    "MCU_STM32F215",
    "MCU_STM32F217",
    "MCU_STM32F302",
    "MCU_STM32F303",
    "MCU_STM32F313",
    "MCU_STM32F373",
    "MCU_STM32F383",
    "MCU_STM32F401",
    "MCU_STM32F405",
    "MCU_STM32F407",
    "MCU_STM32F415",
    "MCU_STM32F417",
    "MCU_STM32F427",
    "MCU_STM32F429",
    "MCU_STM32F437",
    "MCU_STM32L151x6",
    "MCU_STM32L151x8",
    "MCU_STM32L151xB",
    "MCU_STM32L151CC",
    "MCU_STM32L151UC",
    "MCU_STM32L151RC",
    "MCU_STM32L151RCA",
    "MCU_STM32L151VCA",
    "MCU_STM32L151QC",
    "MCU_STM32L151VC",
    "MCU_STM32L151xD",
    "MCU_STM32L151xE",
    "MCU_STM32L152x6",
    "MCU_STM32L152x8",
    "MCU_STM32L152xB",
    "MCU_STM32L152CC",
    "MCU_STM32L152UC",
    "MCU_STM32L152RC",
    "MCU_STM32L152RCY",
    "MCU_STM32L152RCA",
    "MCU_STM32L152VCA",
    "MCU_STM32L152QC",
    "MCU_STM32L152VC",
    "MCU_STM32L152xD",
    "MCU_STM32L152xE",
    "MCU_STM32L162RC",
    "MCU_STM32L162RCA",
    "MCU_STM32L162VC",
    "MCU_STM32L162VCA",
    "MCU_STM32L162QC",
    "MCU_STM32L162xD",
    "MCU_STM32L162xE",
    "MCU_LM3S9B96",
    "MCU_LPC1758",
    "MCU_LPC1768",
    "MCU_LPC1778",
    "MCU_MCF52259", 
    "MCU_MCF51CN128",
    "MCU_ZERO"
}

avr_bit_choice = { " ", "0", "1", "2", "3", "4", "5", "6", "7" }
avr_port_choice =
{
    " ",
    "AVRPORTA",
    "AVRPORTB",
    "AVRPORTC",
    "AVRPORTD",
    "AVRPORTE",
    "AVRPORTF",
    "AVRPORTG",
    "AVRPORTH",
    "AVRPORTI",
    "AVRPORTJ",
    "AVRPORTK",
    "AVRPORTL"
}
avr_irq_choice = { " ", "INT0", "INT1", "INT2", "INT3", "INT4", "INT5", "INT6", "INT7" }

iccavr_startup_choice = { "crtenutram", "crtenut", "crtnutram", "crtnut", "crtnutm256" }

mcu_32bit_choice =
{
    " ",
    "0", "1", "2", "3", "4", "5", "6", "7",
    "8", "9", "10", "11", "12", "13", "14", "15",
    "16", "17", "18", "19", "20", "21", "22", "23",
    "24", "25", "26", "27", "28", "29", "30", "31"
}

stm32_bit_choice =
{
    " ",
    "0", "1", "2", "3", "4", "5", "6", "7",
    "8", "9", "10", "11", "12", "13", "14", "15"
}
mcf5_bit_choice = { " ",
                    "0", "1", "2", "3", "4", "5", "6", "7" }
gpio_port_choice =
{
    " ",
    "NUTGPIO_PORTA",
    "NUTGPIO_PORTB",
    "NUTGPIO_PORTC",
    "NUTGPIO_PORTD",
    "NUTGPIO_PORTE",
    "NUTGPIO_PORTF",
    "NUTGPIO_PORTG",
    "NUTGPIO_PORTH",
    "NUTGPIO_PORTI",
    "NUTGPIO_PORTJ",
    "NUTGPIO_PORTK",
    "NUTGPIO_PORTL"
}

gpio_irq_choice =
{
    " ",
    "NUTGPIO_EXTINT0",
    "NUTGPIO_EXTINT1",
    "NUTGPIO_EXTINT2",
    "NUTGPIO_EXTINT3",
    "NUTGPIO_EXTINT4",
    "NUTGPIO_EXTINT5",
    "NUTGPIO_EXTINT6",
    "NUTGPIO_EXTINT7"
}

at91_pio_id_choice = { " ", "PIO_ID", "PIOA_ID", "PIOB_ID", "PIOC_ID" }

avr32_pio_id_choice = { " ", "PIO_ID", "PIOA_ID", "PIOB_ID", "PIOC_ID" }

pll_clk_choice = { " ", "0", "1", "2", "3", "4" }

hd44780_databits_choice = { " ", "0xFF", "0xF0", "0x0F" }

pca9555_port_choice = { "IOXP_PORT0", "IOXP_PORT1" }
pca9555_pin_choice = { " ", "0", "1", "2", "3", "4", "5", "6", "7" }

--
-- Check for custom configuration.
--
-- Executes custom/custom.nut, if it exists. This allows to extend the
-- configuration without modifying any existing file.
--
-- For example, an application may provide its own file system driver.
-- But mkdir, rmdir and similar function will become available only,
-- if certain requirements are provided. This can be done by creating
-- the file custom.nut with the following contents:
--
-- nutcustom =
-- {
--   {
--     name = "nutcustom_cfs",
--     brief = "CFS",
--     description = "Custom file system driver.",
--     provides = {
--       "NUT_FS",
--       "NUT_FS_READ",
--       "NUT_FS_WRITE",
--       "NUT_FS_DIR"
--     }
--   }
-- }
--
-- Developer's note: The custom directory is reserved for this kind of
-- extensions and must not exist in the official repository. However,
-- it may be included in specialized Nut/OS distributions.
--
function CheckCustomConfig()
    local fp

    fp = io.open(c_repo_path() .. "/custom/custom.nut", "r")
    if fp == nil then
        return {}
    end
    fp:close()
    return
        {
            name = "nutcustom",
            brief = "Custom Configuration",
            description = "Allows to add custom specific configuration items.\n",
            subdir = "custom",
            script = "custom/custom.nut"
        }
end

repository =
{
    {
        name = "nutinfo",
        brief = "Hardware Platform",
        description = "Board specific settings.",
        options =
        {
            {
                macro = "PLATFORM",
                brief = "Platform Macro",
                description = "String constant identifying the target hardware used.\n\n"..
                      "Examples are ETHERNUT1, ETHERNUT2 etc. "..
                      "This string constant is passed as a macro definition to "..
                      "the Makefiles and allows conditional compilation "..
                      "depending on the hardware used.\n\n"..
                      "If required, the lower case variant of this string will be used "..
                      "as a source file name containing board specific functions. Such files "..
                      "are located in directory arch/MCU/board.",
                provides = { "HW_TARGET_BOARD" },
                flavor = "booldata",
                file = "include/cfg/arch.h",
                makedefs = { "PLATFORM", "HWDEF+=-D$(PLATFORM)" }
            },
            {
                macro = "PLATFORM_SUB",
                brief = "User Platform Macro",
                description = "String constant identifying a user specific hardware that is based on the "..
                      "PLATFORM macro above.\n\n"..
                      "This macro can be used if a project is developed for different targets "..
                      "that are based mainly on the same base project and hardware.\n\n"..
                      "An example: You develop different EIR applications, same chip, same board, but "..
                      "one with an OLED, another with an LC-display and a third without display but IR-remote\n\n"..
                      "This string constant is passed as a macro definition to "..
                      "the Makefiles and allows conditional compilation "..
                      "depending on the hardware used.",
                flavor = "booldata",
                file = "include/cfg/arch.h",
                makedefs = { "SUBPLATFORM", "HWDEF+=-D$(SUBPLATFORM)" }
            },
            {
                macro = "NUT_INIT_BOARD",
                brief = "Board Initialization",
                description = "If selected, a board specific initialization function "..
                      "is called before system initialization. At this time the C runtime "..
                      "is basically available and all global and static variables "..
                      "are set. However, kernel services like memory management, "..
                      "timers, threads etc. are not available in this stage.\n\n"..
                      "A related source file must be provided in the "..
                      "arch/MCU/board/ directory, named after the PLATFORM macro.",
                requires = { "HW_TARGET_BOARD" },
                provides = { "HW_BOARD_SUPPORT" },
                flavor = "boolean",
                file = "include/cfg/arch.h",
            },
            {
                macro = "NUT_INIT_IDLE",
                brief = "Idle Initialization",
                description = "If selected, a board specific initialization function "..
                      "is called at the beginning of the idle thread. At this time "..
                      "heap memory management is available and even new threads may be "..
                      "created. However, context switching will not work and timer "..
                      "services (including time outs) are not available.\n\n"..
                      "A related source file must be provided in the "..
                      "arch/MCU/board/ directory, named after the PLATFORM macro.",
                requires = { "HW_TARGET_BOARD" },
                provides = { "HW_BOARD_SUPPORT" },
                flavor = "boolean",
                file = "include/cfg/arch.h",
            },
            {
                macro = "NUT_INIT_MAIN",
                brief = "Main Initialization",
                description = "If selected, a board specific initialization function "..
                      "is called immediately before calling the application's main function. "..
                      "At this time the system is fully functional.\n\n"..
                      "A related source file must be provided in the "..
                      "arch/MCU/board/ directory, named after the PLATFORM macro.",
                requires = { "HW_TARGET_BOARD" },
                provides = { "HW_BOARD_SUPPORT" },
                flavor = "boolean",
                file = "include/cfg/arch.h",
            }
        }
    },
    {
        name = "nuttools",
        brief = "Tools",
        description = "Tool selection.",
        script = "tools.nut"
    },
    {
        name = "nutarch",
        brief = "Architecture",
        description = "Target selection.",
        subdir = "arch",
        script = "arch/arch.nut"
    },
    {
        name = "nutos",
        brief = "RTOS Kernel",
        description = "Operating system core functions",
        requires = { "HW_TARGET" },
        subdir = "os",
        script = "os/os.nut"
    },
    {
        name = "nutdev",
        brief = "Device Drivers",
        description = "This library contains architecture independant...\n"..
                      "... hardware device drivers, typically supporting external chips.\n"..
                      "... device driver frameworks, which provide the hardware independant part of a driver\n"..
                      "... helper routines, which are of general use for device drivers.",
        requires = { "HW_TARGET" },
        subdir = "dev",
        script = "dev/dev.nut"
    },
    {
        name = "nutc",
        brief = "C runtime (tool specific)",
        description = "Hardware independent C runtime",
        requires = { "HW_TARGET" },
        subdir = "c",
        script = "c/c.nut"
    },
    {
        name = "nutcrt",
        brief = "C runtime (target specific)",
        description = "Hardware dependent C runtime",
        requires = { "HW_TARGET" },
        subdir = "crt",
        script = "crt/crt.nut"
    },
    {
        name = "nutgorp",
        brief = "Gorp: Code snipped library",
        description = "Additional libraries and code snippets used all around in NutOS and application code",
        requires = { "HW_TARGET" },
        subdir = "gorp",
        script = "gorp/gorp.nut"
    },
    {
        name = "nutnet",
        brief = "Network (general)",
        description = "Network functions",
        requires = { "HW_TARGET" },
        subdir = "net",
        script = "net/net.nut"
    },
    {
        name = "nutpro",
        brief = "Network (application layer)",
        description = "High level network protocols",
        requires = { "HW_TARGET" },
        subdir = "pro",
        script = "pro/pro.nut"
    },
    {
        name = "nutfs",
        brief = "File system",
        description = "File systems",
        requires = { "HW_TARGET" },
        subdir = "fs",
        script = "fs/fs.nut"
    },
    {
        name = "nutcpp",
        brief = "C++ runtime extensions",
        description = "C++ runtime extensions",
        requires = { "HW_TARGET", "TOOL_CXX" },
        subdir = "cpp",
        script = "cpp/cpp.nut"
    },
    {
        name = "nutlua",
        brief = "Lua Support",
        description = "Lua is a powerful, light-weight scripting language. "..
                      "It offers good support for object-oriented, "..
                      "functional as well as data-driven programming.\n\n"..
                      "Currently available with the GNU compiler only.",
        requires = { "HW_TARGET" },
        subdir = "lua",
        script = "lua/lua.nut"
    },
    {
        name = "nutcrypto",
        brief = "Cryptographic library",
        description = "Cryptographic functions, needed to TLS support",
        requires = { "HW_TARGET" },
        subdir = "crypto",
        script = "crypto/crypto.nut"
    },
    {
        name = "nuttls",
        brief = "TLS library",
        description = "TLS client and server library. Needs libcrypto",
        requires = { "HW_TARGET" },
        subdir = "tls",
        script = "tls/tls.nut"
    },
    {
        name = "nutcontrib",
        brief = "Non-BSDL Code",
        description = "Packages in this module are not released under BSD license.\n"..
                      "More restrictive licenses are acceptable here, but extra effort"..
                      "is demanded of anyone using the code for commercial purposes.",
        requires = { "HW_TARGET" },
        subdir = "contrib",
        script = "contrib/contrib.nut"
    },
    CheckCustomConfig()
}

--
-- Read first 8 kBytes from C source file.
--
function GetSourceFileHead(source_path)
    local fp, buf

    -- Retrieve the repository path by calling a C function provided
    -- by the Configurator and read the first 8k of the file.
    fp = io.open(c_repo_path() .. "/../" .. source_path, "r")
    if fp ~= nil then
        buf = fp:read(8192)
        fp:close()
    end
    return buf
end

--
-- Read OS Version from C source file.
--
-- First version of a dynamic item:
-- The string contains a Lua script, which is compiled and executed by the Configurator.
-- This version is deprecated.
--        brief = "--\n".. -- Strings starting with this sequence are executed.
--                "return 'Nut/OS ' .. GetNutOsVersion()\n", -- This is the executed script.

-- Second version of a dynamic item:
-- A function result is combined with a static string. Note, that the function
-- is executed when this script file is loaded and must have been defined
-- previously.
--        brief = "Nut/OS " .. GetNutOsVersion(),

-- Third version of a dynamic item:
-- The value is specified as a function returning a string. In this case any function
-- used in our function body may be defined later.
--
function GetNutOsVersion()
    local buf, p1, p2, vers, subvers

    -- Try to read the version from a string in os/version.c.
    -- This worked until 4.9.7.
    buf = GetSourceFileHead("os/version.c")
    if buf ~= nil then
        p1, p2, vers = string.find(buf, "os_version_string.+\"(.+)\"")
    end

    -- If this doesn't work, we may have 4.9.8 or later.
    -- We will find the hex coded version in include/sys/version.h.
    if vers == nil then
      buf = GetSourceFileHead("include/sys/version.h")
      p1, p2, vers = string.find(buf, "NUT_VERSION_MAJOR%s+(%d+)")
      if vers == nil then
        vers = "?"
      end
      vers = vers .. "."
      p1, p2, subvers = string.find(buf, "NUT_VERSION_MINOR%s+(%d+)")
      if subvers == nil then
        subvers = "?"
      end
      vers = vers .. subvers .. "."
      p1, p2, subvers = string.find(buf, "NUT_VERSION_RELEASE%s+(%d+)")
      if subvers == nil then
        subvers = "?"
      end
      vers = vers .. subvers .. "."
      p1, p2, subvers = string.find(buf, "NUT_VERSION_BUILD%s+(%d+)")
      if subvers == nil then
        subvers = "?"
      end
      vers = vers .. subvers
    end

    return vers or "Unknown"
end

--
-- Retrieve platform specific GPIO banks.
--
function GetGpioBanks()
    if c_is_provided("HW_MCU_AVR") then
        return GetAvrPorts()
    end
    if c_is_provided("HW_MCU_AT91") then
        if c_is_provided("HW_MCU_AT91R40008") then
            return { " " }
        else
            return { " ", "NUTGPIO_PORTA", "NUTGPIO_PORTB", "NUTGPIO_PORTC" }
        end
    end
    if c_is_provided("HW_MCU_AVR32") then
        return GetAvr32PioIds()
    end
    if c_is_provided("HW_MCU_STM32") then
        return GetStm32PioIds()
    end
    if c_is_provided("HW_MCU_LPC17xx") then
        return GetLpc17xxPioIds()
    end;
    return gpio_port_choice
end

--
-- Retrieve platform specific GPIO port IDs.
--
function GetGpioPortIds()
    if c_is_provided("HW_MCU_AVR") then
        return avr_port_choice
    end
    if c_is_provided("HW_MCU_AT91") then
        return at91_pio_id_choice
    end
    if c_is_provided("HW_MCU_AVR32") then
        return GetAvr32PioIds()
    end
    if c_is_provided("HW_MCU_STM32") then
        return GetStm32PioIds()
    end
    if c_is_provided("HW_MCU_LPC17xx") then
        return GetLpc17xxPioIds()
    end;
    if c_is_provided("HW_MCU_COLDFIRE") then
        return GetColdfirePioIds()
    end;
    return { " " }
end

--
-- Retrieve AT91 PIO IDs.
--
function GetAt91PioIds()
    if c_is_provided("HW_MCU_AT91R40008") then
        return { " ", "PIO_ID" }
    end
    return { " ", "PIOA_ID", "PIOB_ID", "PIOC_ID" }
end

--
-- Retrieve AVR32 PIO IDs.
--

function GetAvr32PioIds()
    return { " ", "PIOA_ID", "PIOB_ID", "PIOC_ID", "PIOD_ID" }
end

--
-- Retrieve STM32 PIO struct pointers.
-- These IDs represet an struct pointer value of the port.
--
function GetStm32Pio()
    return { " ", "GPIOA", "GPIOB", "GPIOC", "GPIOD", "GPIOE", "GPIOF", "GPIOG" }
end

--
-- Retrieve STM32 PIO IDs.
-- These IDs represet an struct pointer value of the port.
--
function GetStm32PioIds()
    return {
        " ",
        "NUTGPIO_PORTA",
        "NUTGPIO_PORTB",
        "NUTGPIO_PORTC",
        "NUTGPIO_PORTD",
        "NUTGPIO_PORTE",
        "NUTGPIO_PORTF",
        "NUTGPIO_PORTG",
    }
end

--
-- Retrieve STM32 PIO Base.
-- These IDs represet an uint32_t value of the base address of the port.
--
function GetStm32PioBase()
    return { " ", "GPIOA_BASE", "GPIOB_BASE", "GPIOC_BASE", "GPIOD_BASE", "GPIOE_BASE", "GPIOF_BASE", "GPIOG_BASE" }
end

--
-- Retrieve LPC17xx PIO IDs.
-- These IDs represet an struct pointer value of the port.
--
function GetLpc17xxPioIds()
    return {
        " ",
        "NUTGPIO_PORT0",
        "NUTGPIO_PORT1",
        "NUTGPIO_PORT2",
        "NUTGPIO_PORT3",
        "NUTGPIO_PORT4",
        "NUTGPIO_PORT5",
    }
end

--
-- Retrieve COLDFIRE PIO IDs.
-- These IDs represet an struct pointer value of the port.
--
function GetColdfirePioIds()
    if c_is_provided("HW_MCU_MCF5225X") then
        return {
            " ",
            "PORTTE",
            "PORTTF",
            "PORTTG",
            "PORTTH",
            "PORTTI",
            "PORTTJ",
            "PORTNQ",
            "PORTAN",
            "PORTAS",
            "PORTQS",
            "PORTTA",
            "PORTTC",
            "PORTUA",
            "PORTUB",
            "PORTUC",
            "PORTDD",
        }
    end
    if c_is_provided("HW_MCU_MCF51CN") then
        return {
            " ",
            "PORTA",
            "PORTB",
            "PORTC",
            "PORTD",
            "PORTE",
            "PORTF",
            "PORTG",
            "PORTH",
            "PORTJ",
        }
    end
    return { " " }
end

--
-- Retrieve AVR Port IDs.
--
function GetAvrPorts()
    if c_is_provided("HW_MCU_ATMEGA103") then
        return { " ", "AVRPORTA", "AVRPORTB", "AVRPORTC", "AVRPORTD", "AVRPORTE", "AVRPORTF" }
    end
    if c_is_provided("HW_MCU_ATMEGA128") then
        return { " ", "AVRPORTA", "AVRPORTB", "AVRPORTC", "AVRPORTD", "AVRPORTE", "AVRPORTF", "AVRPORTG" }
    end
    return avr_port_choice
end

--
-- Retrieve IOExpander specific Ports bits.
--
function GetIoxpPorts()
    if c_is_provided("DEV_IOEXP") then
        return pca9555_port_choice
    end
    return { " " }
end

--
-- Retrieve IOExpander specific GPIO bits.
--
function GetIoxpBits()
    if c_is_provided("DEV_IOEXP") then
        return pca9555_pin_choice
    end
    return { " " }
end

--
-- Retrieve platform specific GPIO bits.
--
function GetGpioBits()
    if c_is_provided("HW_MCU_AVR") then
        return avr_bit_choice
    end
    if c_is_provided("HW_MCU_STM32") then
        return stm32_bit_choice
    end
    if c_is_provided("HW_MCU_COLDFIRE") then
        return mcf5_bit_choice
    end
    return mcu_32bit_choice
end


--
-- Retrieve platform specific GPIO header path.
--
function GetGpioHeaderPath()
    local basepath

    basepath = "include/cfg/arch/"
    if c_is_provided("HW_MCU_AVR") then
        return basepath .. "avrpio.h"
    end
    if c_is_provided("HW_MCU_ARM") then
        return basepath .. "armpio.h"
    end
    if c_is_provided("HW_MCU_AVR32") then
        return basepath .. "avr32pio.h"
    end
    if c_is_provided("HW_MCU_LPC17xx") then
        return basepath .. "lpc17xxpio.h"
    end
    if c_is_provided("HW_MCU_STM32") then
        return basepath .. "stm32pio.h"
    end
    if c_is_provided("HW_MCU_COLDFIRE") then
        return basepath .. "mcf5pio.h"
    end
    return basepath .. "pio.h"
end


--
-- Retrieve platform specific GPIO Special Functions
--
function GetAlternativePinsets()
    return { "ALTERNATE_PIN_SET1", "ALTERNATE_PIN_SET2", "ALTERNATE_PIN_SET3" }
end