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

--
-- Copyright (C) 2004 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/
--

-- Operating system functions
--
-- $Log$
-- Revision 1.14  2009/02/18 12:48:27  olereinhardt
-- 2009-02-18  Ole Reinhardt <ole.reinhardt@thermotemp.de>
-- Added CRT_UNSETENV_POSIX, enable it when building for ARM using Newlib since
-- version 1.17.0 to avoid compile errors for unsetenv in setenv.c.
--
-- Revision 1.13  2009/02/13 14:44:25  haraldkipp
-- Debug versions of heap routines added.
--
-- Revision 1.12  2009/02/06 15:45:03  haraldkipp
-- Routines using heap memory moved from c to crt module.
-- We now have strdup() and calloc().
--
-- Revision 1.11  2008/10/10 11:51:38  haraldkipp
-- Floating point provision added.
--
-- Revision 1.10  2008/06/28 07:49:33  haraldkipp
-- Added floating point support for stdio running on ARM.
--
-- Revision 1.9  2008/01/31 09:09:07  haraldkipp
-- Added stdlib environment.
--
-- Revision 1.8  2005/08/05 11:25:01  olereinhardt
-- Added seek.c, tell.c
--
-- Revision 1.7  2005/06/26 11:33:31  chaac
-- Added forgotten kbhit.c to build process.
--
-- Revision 1.6  2004/11/24 14:48:34  haraldkipp
-- crt/crt.nut
--
-- Revision 1.5  2004/09/07 19:09:53  haraldkipp
-- Split program space I/O
--
-- Revision 1.4  2004/08/18 16:05:38  haraldkipp
-- Use consistent directory structure
--
-- Revision 1.3  2004/08/18 13:46:09  haraldkipp
-- Fine with avr-gcc
--
-- Revision 1.2  2004/08/03 15:09:31  haraldkipp
-- Another change of everything
--
-- Revision 1.1  2004/06/07 16:35:53  haraldkipp
-- First release
--
--

nutcrt =
{
    --
    -- Low level I/O
    --
    {
        name = "nutcrt_file",
        brief = "Low level file I/O",
        requires = { "DEV_FILE" },
        provides = { "CRT_FILE" },
        sources =
        {
            "close.c",
            "clrerr.c",
            "ioctl.c",
            "open.c",
            "select.c",
        },
        options = 
        {
            {
                macro = "CRT_DISABLE_SELECT_POLL",
                brief = "Disable select() and poll()",
                description = "Disable build of select() and poll() to save some flash ressources and "..
                              "to ensure real-time behaviour. The select wait queue handling in some "..
                              "drivers may introduce non deterministic interrupt latencies, if the "..
                              "driver is used together with the select functions.",
                flavor = "boolean",
                file = "include/cfg/crt.h"
            }
        },
    },
    {
        name = "nutcrt_read",
        brief = "Low level file read",
        requires = { "DEV_READ", "CRT_FILE" },
        provides = { "CRT_READ" },
        sources =
        {
            "getf.c",
            "read.c",
        }
    },
    {
        name = "nutcrt_write",
        brief = "Low Level Write",
        requires = { "DEV_WRITE", "CRT_FILE" },
        provides = { "CRT_WRITE" },
        sources =
        {
            "putf.c",
            "write.c"
        }
    },
    {
        name = "nutcrt_write_p",
        brief = "Low Level Write (PGM-Space)",
        requires = { "HW_MCU_AVR", "DEV_WRITE", "CRT_FILE" },
        provides = { "CRT_WRITE_P" },
        sources =
        {
            "write_p.c"
        }
    },

    --
    -- Stream I/O
    --
    {
        name = "nutcrt_stream",
        brief = "File Streams",
        provides = { "CRT_STREAM" },
        sources =
        {
            "fclose.c",
            "fcloseall.c",
            "fdopen.c",
            "feof.c",
            "ferror.c",
            "fflush.c",
            "filelength.c",
            "fileno.c",
            "flushall.c",
            "fmode.c",
            "fopen.c",
            "fpurge.c",
            "freopen.c",
            "fseek.c",
            "ftell.c",
            "funopen.c",
            "seek.c",
            "tell.c"
        },
        options =
        {
            {
                macro = "STDIO_FLOATING_POINT",
                brief = "Floating point",
                description = "Enables floating point support for standard input/output.",
                flavor = "boolean",
                provides = { "FLOATING_POINT_IO" },
                file = "include/cfg/crt.h"
            },
            {
                macro = "STDIO_64_BIT",
                brief = "Handling of 64-bit values",
                description = "Enables handling of 64-bit values for standard input/output.",
                flavor = "boolean",
                provides = { "FLOATING_64_BIT" },
                file = "include/cfg/crt.h"
            },
            {
                macro = "FOPEN_MAX",
                brief = "Max. Open Streams",
                description = "Maximum number of concurrently opened filedescriptors / streams.\n\n"..
                              "Default is 8",
                type = "integer",
                flavor = "booldata",
                file = "include/cfg/crt.h"
            }
        }

    },
    {
        name = "nutcrt_istream",
        brief = "File Stream Input",
        provides = { "CRT_STREAM_READ" },
        sources =
        {
            "fgetc.c",
            "fgets.c",
            "fread.c",
            "fscanf.c",
            "getc.c",
            "getchar.c",
            "gets.c",
            "kbhit.c",
            "scanf.c",
            "ungetc.c",
            "vfscanf.c"
        }
    },
    {
        name = "nutcrt_istream_p",
        brief = "File Stream Input (PGM-Space)",
        requires = { "HW_MCU_AVR" },
        provides = { "CRT_STREAM_READ_P" },
        sources =
        {
            "fscanf_p.c",
            "scanf_p.c",
            "vfscanf_p.c"
        }
    },
    {
        name = "nutcrt_ostream",
        brief = "File Stream Output",
        provides = { "CRT_STREAM_WRITE" },
        sources =
        {
            "fprintf.c",
            "fputc.c",
            "fputs.c",
            "fwrite.c",
            "printf.c",
            "putc.c",
            "putchar.c",
            "puts.c",
            "vfprintf.c"
        }
    },
    {
        name = "nutcrt_ostream_p",
        brief = "File Stream Output (PGM-Space)",
        requires = { "HW_MCU_AVR" },
        provides = { "CRT_STREAM_WRITE_P" },
        sources =
        {
            "fprintf_p.c",
            "fputs_p.c",
            "fwrite_p.c",
            "printf_p.c",
            "puts_p.c",
            "vfprintf_p.c"
        }
    },

    --
    -- String I/O
    --
    {
        name = "nutcrt_fstrio",
        brief = "Formatted String I/O",
        sources =
        {
            "asprintf.c",
            "sprintf.c",
            "snprintf.c",
            "sscanf.c",
            "vasprintf.c",
            "vsprintf.c",
            "vsnprintf.c",
            "vsscanf.c"
        }
    },
    {
        name = "nutcrt_fstrio_p",
        brief = "Formatted String I/O (PGM-Space)",
        requires = { "HW_MCU_AVR" },
        sources =
        {
            "sprintf_p.c",
            "snprintf_p.c",
            "sscanf_p.c",
            "vsprintf_p.c",
            "vsnprintf_p.c",
            "vsscanf_p.c"
        }
    },

    {
        name = "nutcrt_vis",
        brief = "Visual String Codec",
        sources =
        { "vis.c", "unvis.c" }
    },

    --
    -- Date and time
    --
    {
        name = "nutcrt_time",
        brief = "Time and date",
        provides = { "CRT_DATETIME" },
        sources =
        {
            "gmtime.c",
            "localtime.c",
            "asctime.c",
            "mktime.c",
            "time.c",
            "timeofday.c",
            "tzset.c"
        }
    },

    --
    -- Date and time
    --
    {
        name = "nutcrt_errno",
        brief = "Global errno",
        sources = { "errno.c" }
    },

    --
    -- Heap memory
    --
    {
        name = "nutcrt_malloc",
        brief = "Heap memory",
        description = "Although some runtime libraries provide "..
                      "identical routines, we better use our own to avoid "..
                      "memory management conflicts.",
        requires = { "NUT_HEAPMEM" },
        provides = { "CRT_HEAPMEM" },
        sources =
        {
            "calloc.c",
            "calloc_dbg.c",
            "malloc.c",
            "malloc_dbg.c",
            "realloc.c",
            "realloc_dbg.c",
            "strdup.c",
            "strdup_dbg.c"
        }
    },
    {
        name = "nutcrt_sbrk",
        brief = "Library Heap Support",
        requires = { "NUT_HEAPMEM", "TOOL_ARMLIB" },
        provides = { "CRT_SBRK" },
        sources = { "sbrk.c" }
    },

    --
    -- Environment
    --
    {
        name = "nutcrt_environ",
        brief = "Environment",
        description = "Nut/OS provides Posix like environment variables. They are stored "..
                      "in non-volatile memory and are immediately available after reboot.\n\n"..
                      "The Nut/OS libraries do not use environment variables, because in most "..
                      "cases they occupy significantly more memory space than directly storing "..
                      "specific configuration structures at pre-defined memory locations. "..
                      "Application code, however, may benefit from portability. Furthermore, "..
                      "in situations where only a few out of a large number of settings need "..
                      "to be overridden, environment variables may even save non-volatile "..
                      "memory space.",
        requires = { "NUT_HEAPMEM" },
        sources = { "getenv.c", "putenv.c", "setenv.c", "environ.c" },
        options =
        {
            {
                macro = "ENVIRON_EE_OFFSET",
                brief = "Location",
                description = "This is the non-volatile memory address offset, where the "..
                              "runtime library expects  the list of environment variables.\n\n"..
                              "Note, that changing this value will invalidate previously "..
                              "stored environment after upgrading to this new version. You must "..
                              "also make sure, that this memory area will not conflict with "..
                              "others, specifically system and network configurations.\n\n"..
                              "This items is available only if the target system offers any "..
                              "non-volatile memory. Check the non-volatile memory "..
                              "module in the device driver section.",
                requires = { "DEV_NVMEM" },
                default = "256",
                type = "integer",
                file = "include/cfg/eeprom.h"
            },
            {
                macro = "CRT_UNSETENV_POSIX",
                brief = "Posix compatible unsetenv",
                description = "Enable posix compatible definition of unsetenv. Newlib since version "..
                              "1.17.0 declares unsetenv returning int. Older versions are declared "..
                              "as void function. This will help to avoid compilation errors because "..
                              "of incompatible declarations.",
                flavor = "boolean",
                file = "include/cfg/crt.h"
            }
        },
    },

    --
    -- Misc
    --
    {
        name = "nutcrt_strtok_r",
        brief = "Recursive strtok",
        requires = { "TOOL_ICC" },
        sources = { "strtok_r.c" }
    }
}