From: asterix <asterix@38d2e660-2303-0410-9eaa-f027e97ec537>
Date: Fri, 2 Oct 2009 15:12:47 +0000 (+0000)
Subject: Import NMEAP 0.3 library.
X-Git-Tag: 2.3.0~79
X-Git-Url: https://codewiz.org/gitweb?a=commitdiff_plain;h=5f97189f443a8ca50cc5f61f32066c2b65b6f44d;p=bertos.git

Import NMEAP 0.3 library.


git-svn-id: https://src.develer.com/svnoss/bertos/trunk@3002 38d2e660-2303-0410-9eaa-f027e97ec537
---

diff --git a/bertos/net/nmeap/COPYING b/bertos/net/nmeap/COPYING
new file mode 100644
index 00000000..9c542461
--- /dev/null
+++ b/bertos/net/nmeap/COPYING
@@ -0,0 +1,31 @@
+/*
+Copyright (c) 2005, David M Howard (daveh at dmh2000.com)
+All rights reserved.
+
+This product is licensed for use and distribution under the BSD Open Source License:
+
+Redistribution and use in source and binary forms, with or without 
+modification, are permitted provided that the following conditions are met:
+
+    * Redistributions of source code must retain the above copyright notice, 
+	  this list of conditions and the following disclaimer.
+    * 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.
+    * Neither the name of the copyright holders nor the names of its 
+	  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. 
+*/
+
diff --git a/bertos/net/nmeap/Doxyfile b/bertos/net/nmeap/Doxyfile
new file mode 100644
index 00000000..aae008ec
--- /dev/null
+++ b/bertos/net/nmeap/Doxyfile
@@ -0,0 +1,1153 @@
+# Doxyfile 1.3.8
+
+# This file describes the settings to be used by the documentation system
+# doxygen (www.doxygen.org) for a project
+#
+# All text after a hash (#) is considered a comment and will be ignored
+# The format is:
+#       TAG = value [value, ...]
+# For lists items can also be appended using:
+#       TAG += value [value, ...]
+# Values that contain spaces should be placed between quotes (" ")
+
+#---------------------------------------------------------------------------
+# Project related configuration options
+#---------------------------------------------------------------------------
+
+# The PROJECT_NAME tag is a single word (or a sequence of words surrounded 
+# by quotes) that should identify the project.
+
+PROJECT_NAME           = NMEAP
+
+# The PROJECT_NUMBER tag can be used to enter a project or revision number. 
+# This could be handy for archiving the generated documentation or 
+# if some version control system is used.
+
+PROJECT_NUMBER         = 0.1
+
+# The OUTPUT_DIRECTORY tag is used to specify the (relative or absolute) 
+# base path where the generated documentation will be put. 
+# If a relative path is entered, it will be relative to the location 
+# where doxygen was started. If left blank the current directory will be used.
+
+OUTPUT_DIRECTORY       = doc
+
+# If the CREATE_SUBDIRS tag is set to YES, then doxygen will create 
+# 4096 sub-directories (in 2 levels) under the output directory of each output 
+# format and will distribute the generated files over these directories. 
+# Enabling this option can be useful when feeding doxygen a huge amount of source 
+# files, where putting all generated files in the same directory would otherwise 
+# cause performance problems for the file system.
+
+CREATE_SUBDIRS         = NO
+
+# The OUTPUT_LANGUAGE tag is used to specify the language in which all 
+# documentation generated by doxygen is written. Doxygen will use this 
+# information to generate all constant output in the proper language. 
+# The default language is English, other supported languages are: 
+# Brazilian, Catalan, Chinese, Chinese-Traditional, Croatian, Czech, Danish, 
+# Dutch, Finnish, French, German, Greek, Hungarian, Italian, Japanese, 
+# Japanese-en (Japanese with English messages), Korean, Korean-en, Norwegian, 
+# Polish, Portuguese, Romanian, Russian, Serbian, Slovak, Slovene, Spanish, 
+# Swedish, and Ukrainian.
+
+OUTPUT_LANGUAGE        = English
+
+# This tag can be used to specify the encoding used in the generated output. 
+# The encoding is not always determined by the language that is chosen, 
+# but also whether or not the output is meant for Windows or non-Windows users. 
+# In case there is a difference, setting the USE_WINDOWS_ENCODING tag to YES 
+# forces the Windows encoding (this is the default for the Windows binary), 
+# whereas setting the tag to NO uses a Unix-style encoding (the default for 
+# all platforms other than Windows).
+
+USE_WINDOWS_ENCODING   = NO
+
+# If the BRIEF_MEMBER_DESC tag is set to YES (the default) Doxygen will 
+# include brief member descriptions after the members that are listed in 
+# the file and class documentation (similar to JavaDoc). 
+# Set to NO to disable this.
+
+BRIEF_MEMBER_DESC      = YES
+
+# If the REPEAT_BRIEF tag is set to YES (the default) Doxygen will prepend 
+# the brief description of a member or function before the detailed description. 
+# Note: if both HIDE_UNDOC_MEMBERS and BRIEF_MEMBER_DESC are set to NO, the 
+# brief descriptions will be completely suppressed.
+
+REPEAT_BRIEF           = YES
+
+# This tag implements a quasi-intelligent brief description abbreviator 
+# that is used to form the text in various listings. Each string 
+# in this list, if found as the leading text of the brief description, will be 
+# stripped from the text and the result after processing the whole list, is used 
+# as the annotated text. Otherwise, the brief description is used as-is. If left 
+# blank, the following values are used ("$name" is automatically replaced with the 
+# name of the entity): "The $name class" "The $name widget" "The $name file" 
+# "is" "provides" "specifies" "contains" "represents" "a" "an" "the"
+
+ABBREVIATE_BRIEF       = 
+
+# If the ALWAYS_DETAILED_SEC and REPEAT_BRIEF tags are both set to YES then 
+# Doxygen will generate a detailed section even if there is only a brief 
+# description.
+
+ALWAYS_DETAILED_SEC    = NO
+
+# If the INLINE_INHERITED_MEMB tag is set to YES, doxygen will show all inherited 
+# members of a class in the documentation of that class as if those members were 
+# ordinary class members. Constructors, destructors and assignment operators of 
+# the base classes will not be shown.
+
+INLINE_INHERITED_MEMB  = NO
+
+# If the FULL_PATH_NAMES tag is set to YES then Doxygen will prepend the full 
+# path before files name in the file list and in the header files. If set 
+# to NO the shortest path that makes the file name unique will be used.
+
+FULL_PATH_NAMES        = NO
+
+# If the FULL_PATH_NAMES tag is set to YES then the STRIP_FROM_PATH tag 
+# can be used to strip a user-defined part of the path. Stripping is 
+# only done if one of the specified strings matches the left-hand part of 
+# the path. The tag can be used to show relative paths in the file list. 
+# If left blank the directory from which doxygen is run is used as the 
+# path to strip.
+
+STRIP_FROM_PATH        = 
+
+# The STRIP_FROM_INC_PATH tag can be used to strip a user-defined part of 
+# the path mentioned in the documentation of a class, which tells 
+# the reader which header file to include in order to use a class. 
+# If left blank only the name of the header file containing the class 
+# definition is used. Otherwise one should specify the include paths that 
+# are normally passed to the compiler using the -I flag.
+
+STRIP_FROM_INC_PATH    = 
+
+# If the SHORT_NAMES tag is set to YES, doxygen will generate much shorter 
+# (but less readable) file names. This can be useful is your file systems 
+# doesn't support long names like on DOS, Mac, or CD-ROM.
+
+SHORT_NAMES            = NO
+
+# If the JAVADOC_AUTOBRIEF tag is set to YES then Doxygen 
+# will interpret the first line (until the first dot) of a JavaDoc-style 
+# comment as the brief description. If set to NO, the JavaDoc 
+# comments will behave just like the Qt-style comments (thus requiring an 
+# explicit @brief command for a brief description.
+
+JAVADOC_AUTOBRIEF      = NO
+
+# The MULTILINE_CPP_IS_BRIEF tag can be set to YES to make Doxygen 
+# treat a multi-line C++ special comment block (i.e. a block of //! or /// 
+# comments) as a brief description. This used to be the default behaviour. 
+# The new default is to treat a multi-line C++ comment block as a detailed 
+# description. Set this tag to YES if you prefer the old behaviour instead.
+
+MULTILINE_CPP_IS_BRIEF = NO
+
+# If the DETAILS_AT_TOP tag is set to YES then Doxygen 
+# will output the detailed description near the top, like JavaDoc.
+# If set to NO, the detailed description appears after the member 
+# documentation.
+
+DETAILS_AT_TOP         = NO
+
+# If the INHERIT_DOCS tag is set to YES (the default) then an undocumented 
+# member inherits the documentation from any documented member that it 
+# re-implements.
+
+INHERIT_DOCS           = YES
+
+# If member grouping is used in the documentation and the DISTRIBUTE_GROUP_DOC 
+# tag is set to YES, then doxygen will reuse the documentation of the first 
+# member in the group (if any) for the other members of the group. By default 
+# all members of a group must be documented explicitly.
+
+DISTRIBUTE_GROUP_DOC   = NO
+
+# The TAB_SIZE tag can be used to set the number of spaces in a tab. 
+# Doxygen uses this value to replace tabs by spaces in code fragments.
+
+TAB_SIZE               = 8
+
+# This tag can be used to specify a number of aliases that acts 
+# as commands in the documentation. An alias has the form "name=value". 
+# For example adding "sideeffect=\par Side Effects:\n" will allow you to 
+# put the command \sideeffect (or @sideeffect) in the documentation, which 
+# will result in a user-defined paragraph with heading "Side Effects:". 
+# You can put \n's in the value part of an alias to insert newlines.
+
+ALIASES                = 
+
+# Set the OPTIMIZE_OUTPUT_FOR_C tag to YES if your project consists of C sources 
+# only. Doxygen will then generate output that is more tailored for C. 
+# For instance, some of the names that are used will be different. The list 
+# of all members will be omitted, etc.
+
+OPTIMIZE_OUTPUT_FOR_C  = YES
+
+# Set the OPTIMIZE_OUTPUT_JAVA tag to YES if your project consists of Java sources 
+# only. Doxygen will then generate output that is more tailored for Java. 
+# For instance, namespaces will be presented as packages, qualified scopes 
+# will look different, etc.
+
+OPTIMIZE_OUTPUT_JAVA   = NO
+
+# Set the SUBGROUPING tag to YES (the default) to allow class member groups of 
+# the same type (for instance a group of public functions) to be put as a 
+# subgroup of that type (e.g. under the Public Functions section). Set it to 
+# NO to prevent subgrouping. Alternatively, this can be done per class using 
+# the \nosubgrouping command.
+
+SUBGROUPING            = YES
+
+#---------------------------------------------------------------------------
+# Build related configuration options
+#---------------------------------------------------------------------------
+
+# If the EXTRACT_ALL tag is set to YES doxygen will assume all entities in 
+# documentation are documented, even if no documentation was available. 
+# Private class members and static file members will be hidden unless 
+# the EXTRACT_PRIVATE and EXTRACT_STATIC tags are set to YES
+
+EXTRACT_ALL            = YES
+
+# If the EXTRACT_PRIVATE tag is set to YES all private members of a class 
+# will be included in the documentation.
+
+EXTRACT_PRIVATE        = YES
+
+# If the EXTRACT_STATIC tag is set to YES all static members of a file 
+# will be included in the documentation.
+
+EXTRACT_STATIC         = YES
+
+# If the EXTRACT_LOCAL_CLASSES tag is set to YES classes (and structs) 
+# defined locally in source files will be included in the documentation. 
+# If set to NO only classes defined in header files are included.
+
+EXTRACT_LOCAL_CLASSES  = YES
+
+# This flag is only useful for Objective-C code. When set to YES local 
+# methods, which are defined in the implementation section but not in 
+# the interface are included in the documentation. 
+# If set to NO (the default) only methods in the interface are included.
+
+EXTRACT_LOCAL_METHODS  = NO
+
+# If the HIDE_UNDOC_MEMBERS tag is set to YES, Doxygen will hide all 
+# undocumented members of documented classes, files or namespaces. 
+# If set to NO (the default) these members will be included in the 
+# various overviews, but no documentation section is generated. 
+# This option has no effect if EXTRACT_ALL is enabled.
+
+HIDE_UNDOC_MEMBERS     = NO
+
+# If the HIDE_UNDOC_CLASSES tag is set to YES, Doxygen will hide all 
+# undocumented classes that are normally visible in the class hierarchy. 
+# If set to NO (the default) these classes will be included in the various 
+# overviews. This option has no effect if EXTRACT_ALL is enabled.
+
+HIDE_UNDOC_CLASSES     = NO
+
+# If the HIDE_FRIEND_COMPOUNDS tag is set to YES, Doxygen will hide all 
+# friend (class|struct|union) declarations. 
+# If set to NO (the default) these declarations will be included in the 
+# documentation.
+
+HIDE_FRIEND_COMPOUNDS  = NO
+
+# If the HIDE_IN_BODY_DOCS tag is set to YES, Doxygen will hide any 
+# documentation blocks found inside the body of a function. 
+# If set to NO (the default) these blocks will be appended to the 
+# function's detailed documentation block.
+
+HIDE_IN_BODY_DOCS      = NO
+
+# The INTERNAL_DOCS tag determines if documentation 
+# that is typed after a \internal command is included. If the tag is set 
+# to NO (the default) then the documentation will be excluded. 
+# Set it to YES to include the internal documentation.
+
+INTERNAL_DOCS          = NO
+
+# If the CASE_SENSE_NAMES tag is set to NO then Doxygen will only generate 
+# file names in lower-case letters. If set to YES upper-case letters are also 
+# allowed. This is useful if you have classes or files whose names only differ 
+# in case and if your file system supports case sensitive file names. Windows 
+# and Mac users are advised to set this option to NO.
+
+CASE_SENSE_NAMES       = NO
+
+# If the HIDE_SCOPE_NAMES tag is set to NO (the default) then Doxygen 
+# will show members with their full class and namespace scopes in the 
+# documentation. If set to YES the scope will be hidden.
+
+HIDE_SCOPE_NAMES       = NO
+
+# If the SHOW_INCLUDE_FILES tag is set to YES (the default) then Doxygen 
+# will put a list of the files that are included by a file in the documentation 
+# of that file.
+
+SHOW_INCLUDE_FILES     = YES
+
+# If the INLINE_INFO tag is set to YES (the default) then a tag [inline] 
+# is inserted in the documentation for inline members.
+
+INLINE_INFO            = YES
+
+# If the SORT_MEMBER_DOCS tag is set to YES (the default) then doxygen 
+# will sort the (detailed) documentation of file and class members 
+# alphabetically by member name. If set to NO the members will appear in 
+# declaration order.
+
+SORT_MEMBER_DOCS       = YES
+
+# If the SORT_BRIEF_DOCS tag is set to YES then doxygen will sort the 
+# brief documentation of file, namespace and class members alphabetically 
+# by member name. If set to NO (the default) the members will appear in 
+# declaration order.
+
+SORT_BRIEF_DOCS        = NO
+
+# If the SORT_BY_SCOPE_NAME tag is set to YES, the class list will be 
+# sorted by fully-qualified names, including namespaces. If set to 
+# NO (the default), the class list will be sorted only by class name, 
+# not including the namespace part. 
+# Note: This option is not very useful if HIDE_SCOPE_NAMES is set to YES.
+# Note: This option applies only to the class list, not to the 
+# alphabetical list.
+
+SORT_BY_SCOPE_NAME     = NO
+
+# The GENERATE_TODOLIST tag can be used to enable (YES) or 
+# disable (NO) the todo list. This list is created by putting \todo 
+# commands in the documentation.
+
+GENERATE_TODOLIST      = YES
+
+# The GENERATE_TESTLIST tag can be used to enable (YES) or 
+# disable (NO) the test list. This list is created by putting \test 
+# commands in the documentation.
+
+GENERATE_TESTLIST      = YES
+
+# The GENERATE_BUGLIST tag can be used to enable (YES) or 
+# disable (NO) the bug list. This list is created by putting \bug 
+# commands in the documentation.
+
+GENERATE_BUGLIST       = YES
+
+# The GENERATE_DEPRECATEDLIST tag can be used to enable (YES) or 
+# disable (NO) the deprecated list. This list is created by putting 
+# \deprecated commands in the documentation.
+
+GENERATE_DEPRECATEDLIST= YES
+
+# The ENABLED_SECTIONS tag can be used to enable conditional 
+# documentation sections, marked by \if sectionname ... \endif.
+
+ENABLED_SECTIONS       = 
+
+# The MAX_INITIALIZER_LINES tag determines the maximum number of lines 
+# the initial value of a variable or define consists of for it to appear in 
+# the documentation. If the initializer consists of more lines than specified 
+# here it will be hidden. Use a value of 0 to hide initializers completely. 
+# The appearance of the initializer of individual variables and defines in the 
+# documentation can be controlled using \showinitializer or \hideinitializer 
+# command in the documentation regardless of this setting.
+
+MAX_INITIALIZER_LINES  = 30
+
+# Set the SHOW_USED_FILES tag to NO to disable the list of files generated 
+# at the bottom of the documentation of classes and structs. If set to YES the 
+# list will mention the files that were used to generate the documentation.
+
+SHOW_USED_FILES        = YES
+
+#---------------------------------------------------------------------------
+# configuration options related to warning and progress messages
+#---------------------------------------------------------------------------
+
+# The QUIET tag can be used to turn on/off the messages that are generated 
+# by doxygen. Possible values are YES and NO. If left blank NO is used.
+
+QUIET                  = NO
+
+# The WARNINGS tag can be used to turn on/off the warning messages that are 
+# generated by doxygen. Possible values are YES and NO. If left blank 
+# NO is used.
+
+WARNINGS               = YES
+
+# If WARN_IF_UNDOCUMENTED is set to YES, then doxygen will generate warnings 
+# for undocumented members. If EXTRACT_ALL is set to YES then this flag will 
+# automatically be disabled.
+
+WARN_IF_UNDOCUMENTED   = YES
+
+# If WARN_IF_DOC_ERROR is set to YES, doxygen will generate warnings for 
+# potential errors in the documentation, such as not documenting some 
+# parameters in a documented function, or documenting parameters that 
+# don't exist or using markup commands wrongly.
+
+WARN_IF_DOC_ERROR      = YES
+
+# The WARN_FORMAT tag determines the format of the warning messages that 
+# doxygen can produce. The string should contain the $file, $line, and $text 
+# tags, which will be replaced by the file and line number from which the 
+# warning originated and the warning text.
+
+WARN_FORMAT            = "$file:$line: $text"
+
+# The WARN_LOGFILE tag can be used to specify a file to which warning 
+# and error messages should be written. If left blank the output is written 
+# to stderr.
+
+WARN_LOGFILE           = 
+
+#---------------------------------------------------------------------------
+# configuration options related to the input files
+#---------------------------------------------------------------------------
+
+# The INPUT tag can be used to specify the files and/or directories that contain 
+# documented source files. You may enter file names like "myfile.cpp" or 
+# directories like "/usr/src/myproject". Separate the files or directories 
+# with spaces.
+
+INPUT                  = inc/nmeap.h
+
+# If the value of the INPUT tag contains directories, you can use the 
+# FILE_PATTERNS tag to specify one or more wildcard pattern (like *.cpp 
+# and *.h) to filter out the source-files in the directories. If left 
+# blank the following patterns are tested: 
+# *.c *.cc *.cxx *.cpp *.c++ *.java *.ii *.ixx *.ipp *.i++ *.inl *.h *.hh *.hxx *.hpp 
+# *.h++ *.idl *.odl *.cs *.php *.php3 *.inc *.m *.mm
+
+FILE_PATTERNS          = *.h
+
+# The RECURSIVE tag can be used to turn specify whether or not subdirectories 
+# should be searched for input files as well. Possible values are YES and NO. 
+# If left blank NO is used.
+
+RECURSIVE              = YES
+
+# The EXCLUDE tag can be used to specify files and/or directories that should 
+# excluded from the INPUT source files. This way you can easily exclude a 
+# subdirectory from a directory tree whose root is specified with the INPUT tag.
+
+EXCLUDE                = 
+
+# The EXCLUDE_SYMLINKS tag can be used select whether or not files or directories 
+# that are symbolic links (a Unix filesystem feature) are excluded from the input.
+
+EXCLUDE_SYMLINKS       = NO
+
+# If the value of the INPUT tag contains directories, you can use the 
+# EXCLUDE_PATTERNS tag to specify one or more wildcard patterns to exclude 
+# certain files from those directories.
+
+EXCLUDE_PATTERNS       = 
+
+# The EXAMPLE_PATH tag can be used to specify one or more files or 
+# directories that contain example code fragments that are included (see 
+# the \include command).
+
+EXAMPLE_PATH           = 
+
+# If the value of the EXAMPLE_PATH tag contains directories, you can use the 
+# EXAMPLE_PATTERNS tag to specify one or more wildcard pattern (like *.cpp 
+# and *.h) to filter out the source-files in the directories. If left 
+# blank all files are included.
+
+EXAMPLE_PATTERNS       = 
+
+# If the EXAMPLE_RECURSIVE tag is set to YES then subdirectories will be 
+# searched for input files to be used with the \include or \dontinclude 
+# commands irrespective of the value of the RECURSIVE tag. 
+# Possible values are YES and NO. If left blank NO is used.
+
+EXAMPLE_RECURSIVE      = NO
+
+# The IMAGE_PATH tag can be used to specify one or more files or 
+# directories that contain image that are included in the documentation (see 
+# the \image command).
+
+IMAGE_PATH             = 
+
+# The INPUT_FILTER tag can be used to specify a program that doxygen should 
+# invoke to filter for each input file. Doxygen will invoke the filter program 
+# by executing (via popen()) the command <filter> <input-file>, where <filter> 
+# is the value of the INPUT_FILTER tag, and <input-file> is the name of an 
+# input file. Doxygen will then use the output that the filter program writes 
+# to standard output.  If FILTER_PATTERNS is specified, this tag will be 
+# ignored.
+
+INPUT_FILTER           = 
+
+# The FILTER_PATTERNS tag can be used to specify filters on a per file pattern 
+# basis.  Doxygen will compare the file name with each pattern and apply the 
+# filter if there is a match.  The filters are a list of the form: 
+# pattern=filter (like *.cpp=my_cpp_filter). See INPUT_FILTER for further 
+# info on how filters are used. If FILTER_PATTERNS is empty, INPUT_FILTER 
+# is applied to all files.
+
+FILTER_PATTERNS        = 
+
+# If the FILTER_SOURCE_FILES tag is set to YES, the input filter (if set using 
+# INPUT_FILTER) will be used to filter the input files when producing source 
+# files to browse (i.e. when SOURCE_BROWSER is set to YES).
+
+FILTER_SOURCE_FILES    = NO
+
+#---------------------------------------------------------------------------
+# configuration options related to source browsing
+#---------------------------------------------------------------------------
+
+# If the SOURCE_BROWSER tag is set to YES then a list of source files will 
+# be generated. Documented entities will be cross-referenced with these sources. 
+# Note: To get rid of all source code in the generated output, make sure also 
+# VERBATIM_HEADERS is set to NO.
+
+SOURCE_BROWSER         = NO
+
+# Setting the INLINE_SOURCES tag to YES will include the body 
+# of functions and classes directly in the documentation.
+
+INLINE_SOURCES         = NO
+
+# Setting the STRIP_CODE_COMMENTS tag to YES (the default) will instruct 
+# doxygen to hide any special comment blocks from generated source code 
+# fragments. Normal C and C++ comments will always remain visible.
+
+STRIP_CODE_COMMENTS    = NO
+
+# If the REFERENCED_BY_RELATION tag is set to YES (the default) 
+# then for each documented function all documented 
+# functions referencing it will be listed.
+
+REFERENCED_BY_RELATION = YES
+
+# If the REFERENCES_RELATION tag is set to YES (the default) 
+# then for each documented function all documented entities 
+# called/used by that function will be listed.
+
+REFERENCES_RELATION    = YES
+
+# If the VERBATIM_HEADERS tag is set to YES (the default) then Doxygen 
+# will generate a verbatim copy of the header file for each class for 
+# which an include is specified. Set to NO to disable this.
+
+VERBATIM_HEADERS       = YES
+
+#---------------------------------------------------------------------------
+# configuration options related to the alphabetical class index
+#---------------------------------------------------------------------------
+
+# If the ALPHABETICAL_INDEX tag is set to YES, an alphabetical index 
+# of all compounds will be generated. Enable this if the project 
+# contains a lot of classes, structs, unions or interfaces.
+
+ALPHABETICAL_INDEX     = NO
+
+# If the alphabetical index is enabled (see ALPHABETICAL_INDEX) then 
+# the COLS_IN_ALPHA_INDEX tag can be used to specify the number of columns 
+# in which this list will be split (can be a number in the range [1..20])
+
+COLS_IN_ALPHA_INDEX    = 5
+
+# In case all classes in a project start with a common prefix, all 
+# classes will be put under the same header in the alphabetical index. 
+# The IGNORE_PREFIX tag can be used to specify one or more prefixes that 
+# should be ignored while generating the index headers.
+
+IGNORE_PREFIX          = 
+
+#---------------------------------------------------------------------------
+# configuration options related to the HTML output
+#---------------------------------------------------------------------------
+
+# If the GENERATE_HTML tag is set to YES (the default) Doxygen will 
+# generate HTML output.
+
+GENERATE_HTML          = YES
+
+# The HTML_OUTPUT tag is used to specify where the HTML docs will be put. 
+# If a relative path is entered the value of OUTPUT_DIRECTORY will be 
+# put in front of it. If left blank `html' will be used as the default path.
+
+HTML_OUTPUT            = html
+
+# The HTML_FILE_EXTENSION tag can be used to specify the file extension for 
+# each generated HTML page (for example: .htm,.php,.asp). If it is left blank 
+# doxygen will generate files with .html extension.
+
+HTML_FILE_EXTENSION    = .html
+
+# The HTML_HEADER tag can be used to specify a personal HTML header for 
+# each generated HTML page. If it is left blank doxygen will generate a 
+# standard header.
+
+HTML_HEADER            = 
+
+# The HTML_FOOTER tag can be used to specify a personal HTML footer for 
+# each generated HTML page. If it is left blank doxygen will generate a 
+# standard footer.
+
+HTML_FOOTER            = 
+
+# The HTML_STYLESHEET tag can be used to specify a user-defined cascading 
+# style sheet that is used by each HTML page. It can be used to 
+# fine-tune the look of the HTML output. If the tag is left blank doxygen 
+# will generate a default style sheet. Note that doxygen will try to copy 
+# the style sheet file to the HTML output directory, so don't put your own 
+# stylesheet in the HTML output directory as well, or it will be erased!
+
+HTML_STYLESHEET        = 
+
+# If the HTML_ALIGN_MEMBERS tag is set to YES, the members of classes, 
+# files or namespaces will be aligned in HTML using tables. If set to 
+# NO a bullet list will be used.
+
+HTML_ALIGN_MEMBERS     = YES
+
+# If the GENERATE_HTMLHELP tag is set to YES, additional index files 
+# will be generated that can be used as input for tools like the 
+# Microsoft HTML help workshop to generate a compressed HTML help file (.chm) 
+# of the generated HTML documentation.
+
+GENERATE_HTMLHELP      = NO
+
+# If the GENERATE_HTMLHELP tag is set to YES, the CHM_FILE tag can 
+# be used to specify the file name of the resulting .chm file. You 
+# can add a path in front of the file if the result should not be 
+# written to the html output directory.
+
+CHM_FILE               = 
+
+# If the GENERATE_HTMLHELP tag is set to YES, the HHC_LOCATION tag can 
+# be used to specify the location (absolute path including file name) of 
+# the HTML help compiler (hhc.exe). If non-empty doxygen will try to run 
+# the HTML help compiler on the generated index.hhp.
+
+HHC_LOCATION           = 
+
+# If the GENERATE_HTMLHELP tag is set to YES, the GENERATE_CHI flag 
+# controls if a separate .chi index file is generated (YES) or that 
+# it should be included in the master .chm file (NO).
+
+GENERATE_CHI           = NO
+
+# If the GENERATE_HTMLHELP tag is set to YES, the BINARY_TOC flag 
+# controls whether a binary table of contents is generated (YES) or a 
+# normal table of contents (NO) in the .chm file.
+
+BINARY_TOC             = NO
+
+# The TOC_EXPAND flag can be set to YES to add extra items for group members 
+# to the contents of the HTML help documentation and to the tree view.
+
+TOC_EXPAND             = NO
+
+# The DISABLE_INDEX tag can be used to turn on/off the condensed index at 
+# top of each HTML page. The value NO (the default) enables the index and 
+# the value YES disables it.
+
+DISABLE_INDEX          = NO
+
+# This tag can be used to set the number of enum values (range [1..20]) 
+# that doxygen will group on one line in the generated HTML documentation.
+
+ENUM_VALUES_PER_LINE   = 4
+
+# If the GENERATE_TREEVIEW tag is set to YES, a side panel will be
+# generated containing a tree-like index structure (just like the one that 
+# is generated for HTML Help). For this to work a browser that supports 
+# JavaScript, DHTML, CSS and frames is required (for instance Mozilla 1.0+, 
+# Netscape 6.0+, Internet explorer 5.0+, or Konqueror). Windows users are 
+# probably better off using the HTML help feature.
+
+GENERATE_TREEVIEW      = NO
+
+# If the treeview is enabled (see GENERATE_TREEVIEW) then this tag can be 
+# used to set the initial width (in pixels) of the frame in which the tree 
+# is shown.
+
+TREEVIEW_WIDTH         = 250
+
+#---------------------------------------------------------------------------
+# configuration options related to the LaTeX output
+#---------------------------------------------------------------------------
+
+# If the GENERATE_LATEX tag is set to YES (the default) Doxygen will 
+# generate Latex output.
+
+GENERATE_LATEX         = NO
+
+# The LATEX_OUTPUT tag is used to specify where the LaTeX docs will be put. 
+# If a relative path is entered the value of OUTPUT_DIRECTORY will be 
+# put in front of it. If left blank `latex' will be used as the default path.
+
+LATEX_OUTPUT           = latex
+
+# The LATEX_CMD_NAME tag can be used to specify the LaTeX command name to be 
+# invoked. If left blank `latex' will be used as the default command name.
+
+LATEX_CMD_NAME         = latex
+
+# The MAKEINDEX_CMD_NAME tag can be used to specify the command name to 
+# generate index for LaTeX. If left blank `makeindex' will be used as the 
+# default command name.
+
+MAKEINDEX_CMD_NAME     = makeindex
+
+# If the COMPACT_LATEX tag is set to YES Doxygen generates more compact 
+# LaTeX documents. This may be useful for small projects and may help to 
+# save some trees in general.
+
+COMPACT_LATEX          = NO
+
+# The PAPER_TYPE tag can be used to set the paper type that is used 
+# by the printer. Possible values are: a4, a4wide, letter, legal and 
+# executive. If left blank a4wide will be used.
+
+PAPER_TYPE             = a4wide
+
+# The EXTRA_PACKAGES tag can be to specify one or more names of LaTeX 
+# packages that should be included in the LaTeX output.
+
+EXTRA_PACKAGES         = 
+
+# The LATEX_HEADER tag can be used to specify a personal LaTeX header for 
+# the generated latex document. The header should contain everything until 
+# the first chapter. If it is left blank doxygen will generate a 
+# standard header. Notice: only use this tag if you know what you are doing!
+
+LATEX_HEADER           = 
+
+# If the PDF_HYPERLINKS tag is set to YES, the LaTeX that is generated 
+# is prepared for conversion to pdf (using ps2pdf). The pdf file will 
+# contain links (just like the HTML output) instead of page references 
+# This makes the output suitable for online browsing using a pdf viewer.
+
+PDF_HYPERLINKS         = NO
+
+# If the USE_PDFLATEX tag is set to YES, pdflatex will be used instead of 
+# plain latex in the generated Makefile. Set this option to YES to get a 
+# higher quality PDF documentation.
+
+USE_PDFLATEX           = NO
+
+# If the LATEX_BATCHMODE tag is set to YES, doxygen will add the \\batchmode. 
+# command to the generated LaTeX files. This will instruct LaTeX to keep 
+# running if errors occur, instead of asking the user for help. 
+# This option is also used when generating formulas in HTML.
+
+LATEX_BATCHMODE        = NO
+
+# If LATEX_HIDE_INDICES is set to YES then doxygen will not 
+# include the index chapters (such as File Index, Compound Index, etc.) 
+# in the output.
+
+LATEX_HIDE_INDICES     = NO
+
+#---------------------------------------------------------------------------
+# configuration options related to the RTF output
+#---------------------------------------------------------------------------
+
+# If the GENERATE_RTF tag is set to YES Doxygen will generate RTF output 
+# The RTF output is optimized for Word 97 and may not look very pretty with 
+# other RTF readers or editors.
+
+GENERATE_RTF           = NO
+
+# The RTF_OUTPUT tag is used to specify where the RTF docs will be put. 
+# If a relative path is entered the value of OUTPUT_DIRECTORY will be 
+# put in front of it. If left blank `rtf' will be used as the default path.
+
+RTF_OUTPUT             = rtf
+
+# If the COMPACT_RTF tag is set to YES Doxygen generates more compact 
+# RTF documents. This may be useful for small projects and may help to 
+# save some trees in general.
+
+COMPACT_RTF            = NO
+
+# If the RTF_HYPERLINKS tag is set to YES, the RTF that is generated 
+# will contain hyperlink fields. The RTF file will 
+# contain links (just like the HTML output) instead of page references. 
+# This makes the output suitable for online browsing using WORD or other 
+# programs which support those fields. 
+# Note: wordpad (write) and others do not support links.
+
+RTF_HYPERLINKS         = NO
+
+# Load stylesheet definitions from file. Syntax is similar to doxygen's 
+# config file, i.e. a series of assignments. You only have to provide 
+# replacements, missing definitions are set to their default value.
+
+RTF_STYLESHEET_FILE    = 
+
+# Set optional variables used in the generation of an rtf document. 
+# Syntax is similar to doxygen's config file.
+
+RTF_EXTENSIONS_FILE    = 
+
+#---------------------------------------------------------------------------
+# configuration options related to the man page output
+#---------------------------------------------------------------------------
+
+# If the GENERATE_MAN tag is set to YES (the default) Doxygen will 
+# generate man pages
+
+GENERATE_MAN           = NO
+
+# The MAN_OUTPUT tag is used to specify where the man pages will be put. 
+# If a relative path is entered the value of OUTPUT_DIRECTORY will be 
+# put in front of it. If left blank `man' will be used as the default path.
+
+MAN_OUTPUT             = man
+
+# The MAN_EXTENSION tag determines the extension that is added to 
+# the generated man pages (default is the subroutine's section .3)
+
+MAN_EXTENSION          = .3
+
+# If the MAN_LINKS tag is set to YES and Doxygen generates man output, 
+# then it will generate one additional man file for each entity 
+# documented in the real man page(s). These additional files 
+# only source the real man page, but without them the man command 
+# would be unable to find the correct page. The default is NO.
+
+MAN_LINKS              = NO
+
+#---------------------------------------------------------------------------
+# configuration options related to the XML output
+#---------------------------------------------------------------------------
+
+# If the GENERATE_XML tag is set to YES Doxygen will 
+# generate an XML file that captures the structure of 
+# the code including all documentation.
+
+GENERATE_XML           = NO
+
+# The XML_OUTPUT tag is used to specify where the XML pages will be put. 
+# If a relative path is entered the value of OUTPUT_DIRECTORY will be 
+# put in front of it. If left blank `xml' will be used as the default path.
+
+XML_OUTPUT             = xml
+
+# The XML_SCHEMA tag can be used to specify an XML schema, 
+# which can be used by a validating XML parser to check the 
+# syntax of the XML files.
+
+XML_SCHEMA             = 
+
+# The XML_DTD tag can be used to specify an XML DTD, 
+# which can be used by a validating XML parser to check the 
+# syntax of the XML files.
+
+XML_DTD                = 
+
+# If the XML_PROGRAMLISTING tag is set to YES Doxygen will 
+# dump the program listings (including syntax highlighting 
+# and cross-referencing information) to the XML output. Note that 
+# enabling this will significantly increase the size of the XML output.
+
+XML_PROGRAMLISTING     = YES
+
+#---------------------------------------------------------------------------
+# configuration options for the AutoGen Definitions output
+#---------------------------------------------------------------------------
+
+# If the GENERATE_AUTOGEN_DEF tag is set to YES Doxygen will 
+# generate an AutoGen Definitions (see autogen.sf.net) file 
+# that captures the structure of the code including all 
+# documentation. Note that this feature is still experimental 
+# and incomplete at the moment.
+
+GENERATE_AUTOGEN_DEF   = NO
+
+#---------------------------------------------------------------------------
+# configuration options related to the Perl module output
+#---------------------------------------------------------------------------
+
+# If the GENERATE_PERLMOD tag is set to YES Doxygen will 
+# generate a Perl module file that captures the structure of 
+# the code including all documentation. Note that this 
+# feature is still experimental and incomplete at the 
+# moment.
+
+GENERATE_PERLMOD       = NO
+
+# If the PERLMOD_LATEX tag is set to YES Doxygen will generate 
+# the necessary Makefile rules, Perl scripts and LaTeX code to be able 
+# to generate PDF and DVI output from the Perl module output.
+
+PERLMOD_LATEX          = NO
+
+# If the PERLMOD_PRETTY tag is set to YES the Perl module output will be 
+# nicely formatted so it can be parsed by a human reader.  This is useful 
+# if you want to understand what is going on.  On the other hand, if this 
+# tag is set to NO the size of the Perl module output will be much smaller 
+# and Perl will parse it just the same.
+
+PERLMOD_PRETTY         = YES
+
+# The names of the make variables in the generated doxyrules.make file 
+# are prefixed with the string contained in PERLMOD_MAKEVAR_PREFIX. 
+# This is useful so different doxyrules.make files included by the same 
+# Makefile don't overwrite each other's variables.
+
+PERLMOD_MAKEVAR_PREFIX = 
+
+#---------------------------------------------------------------------------
+# Configuration options related to the preprocessor   
+#---------------------------------------------------------------------------
+
+# If the ENABLE_PREPROCESSING tag is set to YES (the default) Doxygen will 
+# evaluate all C-preprocessor directives found in the sources and include 
+# files.
+
+ENABLE_PREPROCESSING   = YES
+
+# If the MACRO_EXPANSION tag is set to YES Doxygen will expand all macro 
+# names in the source code. If set to NO (the default) only conditional 
+# compilation will be performed. Macro expansion can be done in a controlled 
+# way by setting EXPAND_ONLY_PREDEF to YES.
+
+MACRO_EXPANSION        = NO
+
+# If the EXPAND_ONLY_PREDEF and MACRO_EXPANSION tags are both set to YES 
+# then the macro expansion is limited to the macros specified with the 
+# PREDEFINED and EXPAND_AS_PREDEFINED tags.
+
+EXPAND_ONLY_PREDEF     = NO
+
+# If the SEARCH_INCLUDES tag is set to YES (the default) the includes files 
+# in the INCLUDE_PATH (see below) will be search if a #include is found.
+
+SEARCH_INCLUDES        = YES
+
+# The INCLUDE_PATH tag can be used to specify one or more directories that 
+# contain include files that are not input files but should be processed by 
+# the preprocessor.
+
+INCLUDE_PATH           = 
+
+# You can use the INCLUDE_FILE_PATTERNS tag to specify one or more wildcard 
+# patterns (like *.h and *.hpp) to filter out the header-files in the 
+# directories. If left blank, the patterns specified with FILE_PATTERNS will 
+# be used.
+
+INCLUDE_FILE_PATTERNS  = 
+
+# The PREDEFINED tag can be used to specify one or more macro names that 
+# are defined before the preprocessor is started (similar to the -D option of 
+# gcc). The argument of the tag is a list of macros of the form: name 
+# or name=definition (no spaces). If the definition and the = are 
+# omitted =1 is assumed.
+
+PREDEFINED             = 
+
+# If the MACRO_EXPANSION and EXPAND_ONLY_PREDEF tags are set to YES then 
+# this tag can be used to specify a list of macro names that should be expanded. 
+# The macro definition that is found in the sources will be used. 
+# Use the PREDEFINED tag if you want to use a different macro definition.
+
+EXPAND_AS_DEFINED      = 
+
+# If the SKIP_FUNCTION_MACROS tag is set to YES (the default) then 
+# doxygen's preprocessor will remove all function-like macros that are alone 
+# on a line, have an all uppercase name, and do not end with a semicolon. Such 
+# function macros are typically used for boiler-plate code, and will confuse the 
+# parser if not removed.
+
+SKIP_FUNCTION_MACROS   = YES
+
+#---------------------------------------------------------------------------
+# Configuration::additions related to external references   
+#---------------------------------------------------------------------------
+
+# The TAGFILES option can be used to specify one or more tagfiles. 
+# Optionally an initial location of the external documentation 
+# can be added for each tagfile. The format of a tag file without 
+# this location is as follows: 
+#   TAGFILES = file1 file2 ... 
+# Adding location for the tag files is done as follows: 
+#   TAGFILES = file1=loc1 "file2 = loc2" ... 
+# where "loc1" and "loc2" can be relative or absolute paths or 
+# URLs. If a location is present for each tag, the installdox tool 
+# does not have to be run to correct the links.
+# Note that each tag file must have a unique name
+# (where the name does NOT include the path)
+# If a tag file is not located in the directory in which doxygen 
+# is run, you must also specify the path to the tagfile here.
+
+TAGFILES               = 
+
+# When a file name is specified after GENERATE_TAGFILE, doxygen will create 
+# a tag file that is based on the input files it reads.
+
+GENERATE_TAGFILE       = 
+
+# If the ALLEXTERNALS tag is set to YES all external classes will be listed 
+# in the class index. If set to NO only the inherited external classes 
+# will be listed.
+
+ALLEXTERNALS           = NO
+
+# If the EXTERNAL_GROUPS tag is set to YES all external groups will be listed 
+# in the modules index. If set to NO, only the current project's groups will 
+# be listed.
+
+EXTERNAL_GROUPS        = YES
+
+# The PERL_PATH should be the absolute path and name of the perl script 
+# interpreter (i.e. the result of `which perl').
+
+PERL_PATH              = /usr/bin/perl
+
+#---------------------------------------------------------------------------
+# Configuration options related to the dot tool   
+#---------------------------------------------------------------------------
+
+# If the CLASS_DIAGRAMS tag is set to YES (the default) Doxygen will 
+# generate a inheritance diagram (in HTML, RTF and LaTeX) for classes with base or 
+# super classes. Setting the tag to NO turns the diagrams off. Note that this 
+# option is superseded by the HAVE_DOT option below. This is only a fallback. It is 
+# recommended to install and use dot, since it yields more powerful graphs.
+
+CLASS_DIAGRAMS         = YES
+
+# If set to YES, the inheritance and collaboration graphs will hide 
+# inheritance and usage relations if the target is undocumented 
+# or is not a class.
+
+HIDE_UNDOC_RELATIONS   = YES
+
+# If you set the HAVE_DOT tag to YES then doxygen will assume the dot tool is 
+# available from the path. This tool is part of Graphviz, a graph visualization 
+# toolkit from AT&T and Lucent Bell Labs. The other options in this section 
+# have no effect if this option is set to NO (the default)
+
+HAVE_DOT               = NO
+
+# If the CLASS_GRAPH and HAVE_DOT tags are set to YES then doxygen 
+# will generate a graph for each documented class showing the direct and 
+# indirect inheritance relations. Setting this tag to YES will force the 
+# the CLASS_DIAGRAMS tag to NO.
+
+CLASS_GRAPH            = YES
+
+# If the COLLABORATION_GRAPH and HAVE_DOT tags are set to YES then doxygen 
+# will generate a graph for each documented class showing the direct and 
+# indirect implementation dependencies (inheritance, containment, and 
+# class references variables) of the class with other documented classes.
+
+COLLABORATION_GRAPH    = YES
+
+# If the UML_LOOK tag is set to YES doxygen will generate inheritance and 
+# collaboration diagrams in a style similar to the OMG's Unified Modeling 
+# Language.
+
+UML_LOOK               = NO
+
+# If set to YES, the inheritance and collaboration graphs will show the 
+# relations between templates and their instances.
+
+TEMPLATE_RELATIONS     = NO
+
+# If the ENABLE_PREPROCESSING, SEARCH_INCLUDES, INCLUDE_GRAPH, and HAVE_DOT 
+# tags are set to YES then doxygen will generate a graph for each documented 
+# file showing the direct and indirect include dependencies of the file with 
+# other documented files.
+
+INCLUDE_GRAPH          = YES
+
+# If the ENABLE_PREPROCESSING, SEARCH_INCLUDES, INCLUDED_BY_GRAPH, and 
+# HAVE_DOT tags are set to YES then doxygen will generate a graph for each 
+# documented header file showing the documented files that directly or 
+# indirectly include this file.
+
+INCLUDED_BY_GRAPH      = YES
+
+# If the CALL_GRAPH and HAVE_DOT tags are set to YES then doxygen will 
+# generate a call dependency graph for every global function or class method. 
+# Note that enabling this option will significantly increase the time of a run. 
+# So in most cases it will be better to enable call graphs for selected 
+# functions only using the \callgraph command.
+
+CALL_GRAPH             = NO
+
+# If the GRAPHICAL_HIERARCHY and HAVE_DOT tags are set to YES then doxygen 
+# will graphical hierarchy of all classes instead of a textual one.
+
+GRAPHICAL_HIERARCHY    = YES
+
+# The DOT_IMAGE_FORMAT tag can be used to set the image format of the images 
+# generated by dot. Possible values are png, jpg, or gif
+# If left blank png will be used.
+
+DOT_IMAGE_FORMAT       = png
+
+# The tag DOT_PATH can be used to specify the path where the dot tool can be 
+# found. If left blank, it is assumed the dot tool can be found on the path.
+
+DOT_PATH               = 
+
+# The DOTFILE_DIRS tag can be used to specify one or more directories that 
+# contain dot files that are included in the documentation (see the 
+# \dotfile command).
+
+DOTFILE_DIRS           = 
+
+# The MAX_DOT_GRAPH_WIDTH tag can be used to set the maximum allowed width 
+# (in pixels) of the graphs generated by dot. If a graph becomes larger than 
+# this value, doxygen will try to truncate the graph, so that it fits within 
+# the specified constraint. Beware that most browsers cannot cope with very 
+# large images.
+
+MAX_DOT_GRAPH_WIDTH    = 1024
+
+# The MAX_DOT_GRAPH_HEIGHT tag can be used to set the maximum allows height 
+# (in pixels) of the graphs generated by dot. If a graph becomes larger than 
+# this value, doxygen will try to truncate the graph, so that it fits within 
+# the specified constraint. Beware that most browsers cannot cope with very 
+# large images.
+
+MAX_DOT_GRAPH_HEIGHT   = 1024
+
+# The MAX_DOT_GRAPH_DEPTH tag can be used to set the maximum depth of the 
+# graphs generated by dot. A depth value of 3 means that only nodes reachable 
+# from the root by following a path via at most 3 edges will be shown. Nodes that 
+# lay further from the root node will be omitted. Note that setting this option to 
+# 1 or 2 may greatly reduce the computation time needed for large code bases. Also 
+# note that a graph may be further truncated if the graph's image dimensions are 
+# not sufficient to fit the graph (see MAX_DOT_GRAPH_WIDTH and MAX_DOT_GRAPH_HEIGHT). 
+# If 0 is used for the depth value (the default), the graph is not depth-constrained.
+
+MAX_DOT_GRAPH_DEPTH    = 0
+
+# If the GENERATE_LEGEND tag is set to YES (the default) Doxygen will 
+# generate a legend page explaining the meaning of the various boxes and 
+# arrows in the dot generated graphs.
+
+GENERATE_LEGEND        = YES
+
+# If the DOT_CLEANUP tag is set to YES (the default) Doxygen will 
+# remove the intermediate dot files that are used to generate 
+# the various graphs.
+
+DOT_CLEANUP            = YES
+
+#---------------------------------------------------------------------------
+# Configuration::additions related to the search engine   
+#---------------------------------------------------------------------------
+
+# The SEARCHENGINE tag specifies whether or not a search engine should be 
+# used. If set to NO the values of all tags below this one will be ignored.
+
+SEARCHENGINE           = NO
diff --git a/bertos/net/nmeap/Makefile b/bertos/net/nmeap/Makefile
new file mode 100644
index 00000000..425079a3
--- /dev/null
+++ b/bertos/net/nmeap/Makefile
@@ -0,0 +1,23 @@
+# rules
+export CC=gcc
+export CDEFS = -DNDEBUG
+
+# directories
+BASE :=$(shell pwd)
+export SRC=$(BASE)/src
+export TST=$(BASE)/tst
+export INC=$(BASE)/inc
+export LIB=$(BASE)/lib
+
+all :
+	cd $(SRC) && $(MAKE) all
+	cd $(TST) && $(MAKE) all
+	
+
+clean :
+	cd $(SRC) && $(MAKE) clean
+	cd $(TST) && $(MAKE) clean
+	
+doc  :
+	doxygen
+
diff --git a/bertos/net/nmeap/README b/bertos/net/nmeap/README
new file mode 100644
index 00000000..bc2a6a08
--- /dev/null
+++ b/bertos/net/nmeap/README
@@ -0,0 +1,24 @@
+NMEAP is licensed under the BSD Open Source License. See the file COPYING for terms of the license
+
+VERSION 0.2 - bug fixes and tutorial
+	a. fixed a bug in test3.c
+	b. added a tutorial in doc/tutorial.html
+
+Installation:
+
+Unpack the tarball or zip file into the desired working directory.
+
+Building:
+
+Under Linux, execute 'make' from the top level directory.
+
+Under Win32, execute 'nmake -f win32.mak' from the top level directory
+
+Using:
+
+This library is statically linked to the application. Just include it in 
+your linker command line. See the file 'nmeap.h' and the examples in the
+'tst' directory for usage instructions.
+
+
+
diff --git a/bertos/net/nmeap/doc/tutorial.html b/bertos/net/nmeap/doc/tutorial.html
new file mode 100644
index 00000000..539a05ac
--- /dev/null
+++ b/bertos/net/nmeap/doc/tutorial.html
@@ -0,0 +1,151 @@
+<html>
+<body>
+<h1>NMEAP TUTORIAL AND REFERENCE</h1>
+<hr />
+<pre>
+copyright (c) 2005 David M. Howard
+This work is licensed under the Creative Commons Attribution License.
+To view a copy of this license, visit
+http://creativecommons.org/licenses/by/2.0/ or send a letter to
+Creative Commons, 559 Nathan Abbott Way, Stanford, California 94305,USA
+You are free:
+    * to copy, distribute, display, and perform the work
+    * to make derivative works
+    * to make commercial use of the work
+Under the following conditions:
+Attribution. You must give the original author credit.
+    * For any reuse or distribution, you must make clear to others the
+      license terms of this work.
+    * Any of these conditions can be waived if you get permission from
+      the author.
+</pre>	 
+<hr />
+<h2>Table Of Contents</h2>
+<ol>
+<li><a href="#c1">Installing the Source Code</a></li>
+<li><a href="#c2">Building the Library</a></li>
+<li><a href="#c3">Description and Examples</a></li>
+<li><a href="#c4">API Documentation</a></li>
+</ol>
+<a name="c1">&nbsp;</a>
+</a><h2>1. Installing the source code</h2>
+Get the source code from <a href="http://sourceforge.net/projects/nmeap/">NMEAP at sourceforge.net</a>
+<pre>
+
+Linux:
+	expand the tarball to a directory of your choice.
+	>tar --gzip -xf [tarball name]
+	>cd [nmeap...]
+	
+Windows:
+	use Winzip to unzip the zipfile to a directory of your choice
+	
+</pre>
+
+<a name="c2">&nbsp;</a>
+<h2>2. Building the library </h2>
+<pre>
+
+Linux:
+	>cd [working directory]
+	>make
+	This builds a static library named libnmeap.a in the 'lib' directory. there is no option for a dynamic library. 
+	This thing is so small that it isn't worth the trouble. It also builds the test/examples programs in
+	'tst'.
+	
+Windows:
+	>cd [working directory]
+	>nmake -f win32.mak
+	Again, this builds a static library names libnmeap.lib in the 'lib' direcotry, plus the test programs in 'tst'
+</pre>
+<a name="c3">&nbsp;</a>
+<h2>3. Description and Examples</h2>
+<p>The NMEA-0183 standard specifies how the output is formatted for GPS data output, usually on a serial port. The data 
+consists of 'sentences' delimited by CR/LF end of line markers. A lot has been written about the format, so this document
+won't cover the specifics. A good place to start is the <a href="http://vancouver-webpages.com/peter/nmeafaq.txt">NMEA FAQ</a> 
+maintained by Peter Bennett.</p> 
+<p>NMEAP is an extensible C language parser library that takes NMEA sentences as input and spits out the decoded data as output. You link
+NMEAP in to your application, set it up, initialize it and feed it bytes. It signals you when it has found a complete valid sentence and 
+provides the parsed out data to you. Parsing NMEA-0183 is pretty easy but it has a few tricky bits. The value of NMEAP is not that it is
+rocket science to write an NMEA parser, but that it provides a relatively efficient implementation that works, along with an
+extension framework to add more sentence parsers without hacking the base source code.</p>
+<p>An NMEA 'sentence' has the following format:</p>
+<pre>
+	$name,data1,data2,...,dataN*XX[CR/LF]
+	OR
+	$name,data1,data2,...,dataN[CR/LF]
+	
+where
+	header       := a 5 digit sentence identifier. all ASCII upper case. e.g. GPGGA
+	data1..dataN := some number of data elements, all ASCII numbers or letters, in all kinds of weird formats.
+                    fields can be empty, in which case 2 commas will be side by side.
+                    normally data fields are identified by their position in the sentence. 
+	*XX          := a '*' plus two ASCII hex digits of checksum. this field is optional.
+	[CR/LF]      := end of line is terminated by a carriage return/linefeed pair.
+	
+example from the <a href="http://vancouver-webpages.com/peter/nmeafaq.txt">NMEA FAQ</a>:
+ 	$GPGGA,123519,4807.038,N,01131.324,E,1,08,0.9,545.4,M,46.9,M,,*42
+</pre>	
+<p>The NMEAP parser works as follows:
+<ol>
+	<li>the application sets up the parser and specifies which sentences are to be parsed
+		and what is to be done with the output data from the parser.</li>
+	<li>the application reads raw bytes from its IO device and passes the bytes to the parser,
+		either byte by byte or as a buffer/length pair.</li>
+	<li>nmeap:
+	<ul>
+		<li>runs the input bytes through a lexical scanner that recognizes complete and valid sentences</li>
+		<li>when a sentence is recognized, a second lexical scanner divides the sentence into discrete tokens.</li>
+		<li>the name field is matched internally to a sentence parser for that name</li>
+		<li> the sentence parser picks out the data strings and decodes them into an nmeap or user 
+		defined data structure	with normal data types such as integer, float, double etc. </li>
+		<li>notifies the client application that a sentence was found and decoded, either thru a callout 
+		to an event handler (ala Expat) or via a return code and a shared data structure, or both.</li>
+	</ul>
+	</li>
+</ol>
+<h4>Sentence Parsers</h4>
+<p>Most of the work in NMEAP is done by the sentence parsers. Each type of NMEA sentence string has an associated parser. NMEAP provides
+standard ones, and the user can add more in a systematic way.
+The sentence parser is responsible for knowing the token position of the data elements and whatever format they 
+are in. There are functions in nmeap to decode standard data element formats. If something is nonstandard, 
+the sentence parser decodes it. Each sentence parser has a 'struct' type associated with it
+that the decoded data gets poked into an instance of that data structure, which is provided by the client application when nmeap is set
+up.</p>
+<h4>Memory Allocation</h4>
+<p>All memory allocation is done by the application. Several data items are required. The application can declare them statically or use
+malloc or whatever. NMEAP doesn't do any memory allocation on its own. This is an important requirement for portability and especially in
+embedded systems where memory allocation needs to be tightly defined and controlled.
+</p>
+<h4>Threads</h4>
+<p>NMEAP as implemented is not meant to be called from multiple threads. It expects to execute within the context of a single thread. The sentence callouts execute
+in the context of the thread of the nmeap client thread. Given how nmeap works, it doesn't really make sense to make nmeap thread-safe
+because the usage pattern is intrinsically single thread. If one wanted to, one could add some mutex locking within the nmeap function
+calls to make it thread safe. In a multithreaded environment, a more likely approach to thread-safety is to put synchronization in the client side of the application,
+within the sentence parser callouts or inline handling of sentence data.
+</p>
+<h4>IO</h4>
+<p>NMEAP is IO agnostic. That is a pompous way of saying that NMEAP doesn't do the IO, the client application does it. There are way too
+many IO schemes to handle to keep it portable, especially in the embedded world. That said, the example programs contain a Linux and a Win32 specific
+program that includes serial IO for those two platforms.
+</p>
+
+<h4>Examples</h4>
+Look at the code for the following example programs to see the usage patterns. The are all located in the
+'tst' directory. There are big, obvious comments delineating the steps to setting up and using NMEAP.
+The IO is simulated in the samples. Follow the comments in the code
+to see the sequence of operations to setup and run the parser. When you are ready just plug in your own IO.
+<ol>
+	<li>tst/test1.c Setup for standard GGA and RMC sentences with byte by byte IO (easiest to code up)</li>
+	<li>tst/test2.c Setup for standard GGA and RMC sentences with block IO (more efficient from a system call standpoint)</li>
+	<li>tst/test3.c Adding a custom parser</li>
+	<li>tst/wingps.c A console program that reads a serial port and writes the decoded data to standard out for WIN32 applications</li>
+</ol>
+<a name="c4">&nbsp;</a>
+<h3>API Documentation</h3>
+The documentation for the actual API is in <a href="www.doxygen.org">Doxygen<a> HTML format and is contained in the 'doc' directory of
+the source distribution. Or, all the external data structures, constants and functions are defined in 'inc/nmeap.h'. 
+
+<p>END</p>
+</body>
+</html>
diff --git a/bertos/net/nmeap/inc/nmeap.h b/bertos/net/nmeap/inc/nmeap.h
new file mode 100644
index 00000000..6386c665
--- /dev/null
+++ b/bertos/net/nmeap/inc/nmeap.h
@@ -0,0 +1,216 @@
+/*
+Copyright (c) 2005, David M Howard (daveh at dmh2000.com)
+All rights reserved.
+
+This product is licensed for use and distribution under the BSD Open Source License.
+see the file COPYING for more details.
+
+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. 
+
+*/
+
+#ifndef __NMEAP_H__
+#define __NMEAP_H__
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/* 
+============================================
+COMPILE TIME CONFIGURATION CONSTANTS
+============================================
+*/
+
+/* these constants affect the size of the context object. tweak them as desired but know what you are doing */
+
+/** maximum number of sentence parsers supported */
+#define NMEAP_MAX_SENTENCES            8
+/** length of sentence name. leave this at 5 unless you really know what you are doing */
+#define NMEAP_MAX_SENTENCE_NAME_LENGTH 5
+/** max length of a complete sentence. the standard says 82 bytes, but its probably better to go at least 128 since
+ * some units don't adhere to the 82 bytes especially for proprietary sentences */
+#define NMEAP_MAX_SENTENCE_LENGTH      255
+/** max tokens in one sentence. 24 is enough for any standard sentence */
+#define NMEAP_MAX_TOKENS               24
+
+/* predefined message ID's */
+
+/* GGA MESSAGE ID */
+#define NMEAP_GPGGA 1
+/* RMC MESSAGE ID */
+#define NMEAP_GPRMC 2
+
+/** user defined parsers should make ID numbers using NMEAP_USER as the base value, plus some increment */
+#define NMEAP_USER  100
+
+/* forward references */
+struct nmeap_context;
+struct nmeap_sentence;
+
+/* 
+============================================
+CALLOUTS
+============================================
+*/
+
+/**
+ * sentence callout function type
+ * a callout is fired for each registered sentence type
+ * the callout gets the object context and a pointer to sentence specific data.
+ * the callout must cast the 'sentence_data' to the appropriate type for that callout
+ * @param context			nmea object context
+ * @param sentence_data		sentence specific data
+*/ 
+typedef void (*nmeap_callout_t)(struct nmeap_context *context,void *sentence_data,void *user_data);
+
+/**
+ * sentence parser function type
+ * stored in the object context and called internally when the sentence name matches
+ * the specified value
+ * the callout gets the object context and a pointer to sentence specific data.
+ * the callout must cast the 'sentence_data' to the appropriate type for that callout
+ * @param context			nmea object context
+ * @param sentence_data		sentence specific data
+ * @return id of sentence  (each sentence parser knows its own ID)
+*/ 
+typedef int (*nmeap_sentence_parser_t)(struct nmeap_context *context,struct nmeap_sentence *sentence);
+
+
+/* ==== opaque types === */
+#include "nmeap_def.h"
+
+
+/* 
+============================================
+STANDARD SENTENCE DATA STRUCTURES
+============================================
+*/
+
+/** extracted data from a GGA message */
+struct nmeap_gga {
+	double        latitude;
+	double        longitude;
+	double        altitude;
+	unsigned long time;
+	int           satellites;
+	int           quality;
+	double        hdop;
+	double        geoid;
+};
+typedef struct nmeap_gga nmeap_gga_t;
+
+/** extracted data from an RMC message */
+struct nmeap_rmc {
+	unsigned long time;
+	char          warn;
+	double        latitude;
+	double        longitude;
+	double        speed;
+	double        course;
+	unsigned long date;
+	double        magvar;
+};
+
+typedef struct nmeap_rmc nmeap_rmc_t;
+
+/* 
+============================================
+METHODS
+============================================
+*/
+
+/**
+ * initialize an NMEA parser. call this function to initialize a user allocated context object
+ * @param context 		nmea object context. allocated by user statically or dynamically.
+ * @param user_data 	pointer to user defined data
+ * @return 0 if ok, -1 if initialization failed
+ */
+int nmeap_init(nmeap_context_t *context,void *user_data);
+
+/**
+ * register an NMEA sentence parser
+ * @param context 		   nmea object context
+ * @param sentence_name    string matching the sentence name for this parser. e.g. "GPGGA". not including the '$'
+ * @param sentence_parser  parser function for this sentence
+ * @param sentence_callout callout triggered when this sentence is received and parsed. 
+ *                         if null, no callout is triggered for this sentence
+ * @param sentence_data    user allocated sentence specific data defined by the application. the parser uses
+                           this data item to store the extracted data. This data object needs to persist over the life
+						   of the parser, so be careful if allocated on the stack. 
+ * @return 0 if registered ok, -1 if registration failed
+ */
+int nmeap_addParser(nmeap_context_t         *context,
+					 const char             *sentence_name,
+					 nmeap_sentence_parser_t sentence_parser,
+					 nmeap_callout_t         sentence_callout,
+					 void                   *sentence_data
+					 );
+
+/** 
+ * parse a buffer of nmea data.
+ * @param context 		   nmea object context
+ * @param buffer          buffer of input characters
+ * @param length          [in,out] pointer to length of buffer. on return, contains number of characters not used for
+ *                        the current sentence
+ * @return -1 if error, 0 if the data did not complete a sentence, sentence code if a sentence was found in the stream
+ */
+int nmeap_parseBuffer(nmeap_context_t *context,const char *buffer,int *length);
+
+/** 
+ * parse one character of nmea data.
+ * @param context 		   nmea object context
+ * @param ch              input character
+ * @return -1 if error, 0 if the data did not complete a sentence, sentence code if a sentence was found in the stream  
+ */
+int nmeap_parse(nmeap_context_t *context,char ch);
+
+
+/** 
+ * built-in parser for GGA sentences.
+ * @param context 		   nmea object context
+ * @param sentence         sentence object for this parser
+  */
+int nmeap_gpgga(nmeap_context_t *context,nmeap_sentence_t *sentence);
+
+/** 
+ * built-in parser for RMC sentences.
+ * @param context 		   nmea object context
+ * @param sentence         sentence object for this parser
+ */
+int nmeap_gprmc(nmeap_context_t *context,nmeap_sentence_t *sentence);
+
+/**
+ * extract latitude from 2 tokens in ddmm.mmmm,h format.
+ * @param plat pointer to token with numerical latitude
+ * @param phem pointer to token with hemisphere
+ * @return latitude in degrees and fractional degrees
+ */
+double nmeap_latitude(const char *plat,const char *phem);
+
+
+/**
+ * extract longitude from 2 tokens in ddmm.mmmm,h format.
+ * @param plat pointer to token with numerical longitude
+ * @param phem pointer to token with hemisphere
+ * @return longitude in degrees and fractional degrees
+ */
+double nmeap_longitude(const char *plat,const char *phem);
+
+#ifdef __cplusplus
+} // extern C
+#endif
+
+
+#endif
+
diff --git a/bertos/net/nmeap/inc/nmeap_def.h b/bertos/net/nmeap/inc/nmeap_def.h
new file mode 100644
index 00000000..c9d1a3c8
--- /dev/null
+++ b/bertos/net/nmeap/inc/nmeap_def.h
@@ -0,0 +1,72 @@
+/*
+Copyright (c) 2005, David M Howard (daveh at dmh2000.com)
+All rights reserved.
+
+This product is licensed for use and distribution under the BSD Open Source License.
+see the file COPYING for more details.
+
+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. 
+
+*/
+
+#ifndef __NMEAP_DEF_H__
+#define __NMEAP_DEF_H__
+
+/**
+ * context for a single sentence 
+ */
+typedef struct nmeap_sentence {
+    char                    name[NMEAP_MAX_SENTENCE_NAME_LENGTH + 1];
+	int                     id;
+    nmeap_sentence_parser_t parser;
+    nmeap_callout_t         callout;
+    void                   *data;
+} nmeap_sentence_t;
+
+/** 
+ * parser context
+ */
+struct nmeap_context {
+	/** support up to 8 sentences */
+	nmeap_sentence_t sentence[NMEAP_MAX_SENTENCES];		/* sentence descriptors */
+	int              sentence_count;						/* number of initialized descriptors */
+	
+	/** sentence input buffer */
+	char             input[NMEAP_MAX_SENTENCE_LENGTH + 1];	 /* input line buffer */
+	int              input_count;	                        /* index into 'input */
+	int              input_state;	                        /* current lexical scanner state */
+	char             input_name[6];                        /* sentence name */
+	char             icks; 			                        /* input checksum    */
+	char             ccks; 			                        /* computed checksum */
+	
+	/* tokenization */
+	char            *token[NMEAP_MAX_TOKENS];              /* list of delimited tokens */
+	int              tokens;							     /* list of tokens */
+	
+	/** errors and debug. optimize these as desired */
+	unsigned long    msgs;    /* count of good messages */
+	unsigned long    err_hdr; /* header error */							
+	unsigned long    err_ovr; /* overrun error */
+	unsigned long    err_unk; /* unknown error */
+	unsigned long    err_id;  /* bad character in id */
+	unsigned long    err_cks; /* bad checksum */
+	unsigned long    err_crl; /* expecting cr or lf, got something else */
+	char             debug_input[NMEAP_MAX_SENTENCE_LENGTH + 1];	 /* input line buffer for debug */
+	
+	/** opaque user data */
+	void *user_data;
+};
+
+typedef struct nmeap_context nmeap_context_t;
+
+#endif /* __NMEAP_DEF_H__ */ 
diff --git a/bertos/net/nmeap/src/Makefile b/bertos/net/nmeap/src/Makefile
new file mode 100644
index 00000000..5e94960c
--- /dev/null
+++ b/bertos/net/nmeap/src/Makefile
@@ -0,0 +1,31 @@
+# specify compiler flags
+CFLAGS = -I $(INC) $(CDEFS) -g -O0 -Werror -Wall
+
+# set library name
+LIBNAME  = libnmeap.a
+
+COBJ     = nmeap01.o
+
+INCLUDES=	$(INC)/nmeap.h $(INC)/nmeap_def.h
+
+# build everything
+all : $(LIB)/$(LIBNAME)
+
+# build the library
+$(LIB)/$(LIBNAME) : $(COBJ)
+	-$(RM) $(LIB)/$(LIBNAME)
+	$(AR)  -q $(LIB)/$(LIBNAME) $(COBJ)
+
+# build all c files into .o files
+$(COBJ): %.o: %.c
+	$(CC) -c $(CFLAGS) $(SRC)/$< -o $@	
+
+# erase all intermediate and output files
+clean :
+	-$(RM) *.o
+	-$(RM) *~
+	-$(RM) $(LIB)/$(LIBNAME)
+
+# include file dependencies
+$(COBJ) : $(INCLUDES)
+
diff --git a/bertos/net/nmeap/src/nmeap.mak b/bertos/net/nmeap/src/nmeap.mak
new file mode 100644
index 00000000..703ffc9d
--- /dev/null
+++ b/bertos/net/nmeap/src/nmeap.mak
@@ -0,0 +1,20 @@
+INCLUDES= ..\inc\nmeap.h ..\inc\nmeap_def.h
+CSRC    = nmeap01.c
+LIBNAME = ..\lib\libnmeap.lib
+
+# build everything
+all : $(LIBNAME)
+
+$(LIBNAME) : nmeap01.obj
+	-erase $(LIBNAME)
+	lib /OUT:$(LIBNAME) nmeap01.obj
+
+nmeap01.obj : nmeap01.c $(INCLUDES)
+	cl /DNDEBUG /c /I..\inc nmeap01.c
+
+# erase all intermediate and output files
+clean :
+	-erase *.obj
+	-erase $(LIBNAME)
+
+
diff --git a/bertos/net/nmeap/src/nmeap01.c b/bertos/net/nmeap/src/nmeap01.c
new file mode 100644
index 00000000..82b041eb
--- /dev/null
+++ b/bertos/net/nmeap/src/nmeap01.c
@@ -0,0 +1,621 @@
+/*
+Copyright (c) 2005, David M Howard (daveh at dmh2000.com)
+All rights reserved.
+
+This product is licensed for use and distribution under the BSD Open Source License.
+see the file COPYING for more details.
+
+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. 
+
+*/
+
+/**
+ * nmeap01.c
+ * nmeap gps data parser
+ * 
+ * see the file COPYING for terms of the licnese
+*/ 
+ 
+ 
+#include <stdio.h>
+#include <stdlib.h>
+#include <string.h>
+#include <assert.h>
+#include <ctype.h>
+#include "nmeap.h"
+
+/* this only works if you are sure you have an upper case hex digit */
+#define HEXTOBIN(ch) ((ch <= '9') ? ch - '0' : ch - ('A' - 10))
+
+/* forward references */
+int nmeap_init(nmeap_context_t *context,void *user_data);
+int nmeap_addParser(nmeap_context_t         *context,
+					 const char             *sentence_name,
+					 nmeap_sentence_parser_t sentence_parser,
+					 nmeap_callout_t         sentence_callout,
+                     void                  *sentence_data
+					 );
+int nmeap_tokenize(nmeap_context_t *context);
+int nmeap_process(nmeap_context_t *context);
+int nmeap_parse(nmeap_context_t *context,char ch);
+int nmeap_parseBuffer(nmeap_context_t *context,const char *buffer,int *length);
+
+/**
+ * get a latitude out of a pair of nmea tokens 
+ */
+double nmeap_latitude(const char *plat,const char *phem)
+{
+    double lat;
+    int    deg;
+    double min;
+    int    ns;
+    
+    assert(plat != 0);
+    assert(phem != 0);
+    
+    if (*plat == 0) {
+        return 0.0;
+    }
+    if (*phem == 0) {
+        return 0.0;
+    }
+    
+    /* north lat is +, south lat is - */
+    if (*phem == 'N') {
+        ns = 1;
+    }
+    else {
+        ns = -1;
+    }
+    
+    /* latitude is degrees, minutes, fractional minutes */
+    /* no validation is performed on the token. it better be good.*/
+    /* if it comes back 0.0 then probably the token was bad */
+    lat = atof(plat);
+    
+    /* extract the degree part */
+    deg = (int)(lat / 100.0);
+    
+    /* mask out the degrees */
+    min = lat - (deg * 100.0);
+    
+    /* compute the actual latitude in degrees.decimal-degrees */
+    lat = (deg + (min / 60.0)) * ns;
+    
+    return lat;
+}
+
+/**
+ * get a longitude out of a pair of nmea tokens 
+ */
+double nmeap_longitude(const char *plon,const char *phem)
+{
+    double lon;
+    int    deg;
+    double min;
+    int    ew;
+    
+    assert(plon != 0);
+    assert(phem != 0);
+    
+    if (*plon == 0) {
+        return 0.0;
+    }
+    if (*phem == 0) {
+        return 0.0;
+    }
+    
+    /* west long is negative, east long is positive */
+    if (*phem == 'E') {
+        ew = 1;
+    }
+    else {
+        ew = -1;
+    }
+    
+    /* longitude is degrees, minutes, fractional minutes */
+    /* no validation is performed on the token. it better be good.*/
+    /* if it comes back 0.0 then probably the token was bad */
+    lon = atof(plon);
+    
+    /* extract the degree part */
+    deg = (int)(lon / 100.0);
+    
+    /* mask out the degrees */
+    min = lon - (deg * 100.0);
+    
+    /* compute the actual lonitude in degrees.decimal-degrees */
+    lon = (deg + (min / 60.0)) * ew;
+
+    
+    return lon;
+}
+
+/**
+ * get an altitude longitude out of a pair of nmea tokens
+ * ALTITUDE is returned in METERS 
+ */
+double nmeap_altitude(const char *palt,const char *punits)
+{
+    double alt;
+    
+    if (*palt == 0) {
+        return 0.0;
+    }
+    
+    /* convert with no error checking */
+    alt = atof(palt);
+    
+    if (*punits == 'M') {
+        /* already in meters */ 
+    }
+    else if (*punits == 'F') {
+        /* convert to feet */
+        alt = alt * 3.2808399;
+    }
+    
+    return alt;
+}
+
+/**
+ * initialize an NMEA parser
+ */
+int nmeap_init(nmeap_context_t *context,void *user_data)
+{
+    assert(context != 0);
+
+    memset(context,0,sizeof(*context));
+
+    context->user_data = user_data;
+
+    return 0;    
+}
+
+ 
+/**
+ * register an NMEA sentence parser
+ */
+int nmeap_addParser(nmeap_context_t         *context,
+					 const char             *sentence_name,
+					 nmeap_sentence_parser_t sentence_parser,
+					 nmeap_callout_t         sentence_callout,
+                     void                  *sentence_data
+					 )
+{
+    nmeap_sentence_t *s = 0;
+    
+    /* runtime error */
+    assert(context != 0);
+    
+    /* sentence capacity overflow */
+    if (context->sentence_count >= NMEAP_MAX_SENTENCES) {
+        return -1;
+    }
+    
+    /* point at next empty sentence buffer */
+    s = &context->sentence[context->sentence_count];
+    
+    /* advance sentence data count */
+    context->sentence_count++;
+    
+    /* clear the sentence data */
+    memset(s,0,sizeof(*s));
+    
+    /* name */
+    strncpy(s->name,sentence_name,NMEAP_MAX_SENTENCE_NAME_LENGTH);
+    
+    /* parser */
+    s->parser = sentence_parser;
+    
+    /* callout */
+    s->callout = sentence_callout;
+    
+    /* data */
+    s->data    = sentence_data;
+
+    return 0;
+}
+
+/** 
+ * tokenize a buffer
+ */
+int nmeap_tokenize(nmeap_context_t *context)
+{
+    char *s;
+    int   tokens;
+    int   state;
+    
+    /* first token is header. assume it is there */
+    tokens = 0;
+    s = context->input;
+    context->token[tokens] = s;
+    
+    /* get rest of tokens */
+    tokens = 1;
+    state = 0;
+    while((*s != 0)&&(tokens < NMEAP_MAX_TOKENS)) {
+        switch(state) {
+        case 0:
+            /* looking for end of a token */
+            if (*s == ',') {
+                /* delimit at the comma */
+                *s    = 0;
+                /* new token */
+                state = 1;
+            }
+            break;
+        case 1:
+            /* start of next token, might be another comma */
+            context->token[tokens++] = s;
+            if (*s == ',') {
+                /* delimit at the comma */
+                *s    = 0;
+            }
+            else {   
+                /* not a comma */
+                state = 0;
+            }
+            break;
+        default:
+            state = 0;
+            break;
+        }
+        
+        // next character
+        s++;
+    }
+    return tokens;
+}
+
+/**
+ * process a sentence 
+ */
+int nmeap_process(nmeap_context_t *context)
+{
+    int id;
+    int i;
+    nmeap_sentence_t *s;
+	
+    /* copy the input to a debug buffer */
+    /* remove debug_input when everything is working. */
+    strncpy(context->debug_input,context->input,sizeof(context->debug_input));
+    
+    /* tokenize the input */
+    context->tokens = nmeap_tokenize(context);
+    
+    /* try to find a matching sentence parser */
+    /* this search is O(n). it has a lot of potential for optimization, at the expense of complexity, if you have a lot of sentences */
+    /* binary search instead of linear (have to keep sentences in sorted order) O(NlogN) */
+    /* OR, when sentences are added, create a TRIE structure to find the names with a constant time search O(5) */
+    for(i=0;i<context->sentence_count;i++) {
+        s = &context->sentence[i];
+        assert(s != 0);
+        if (strncmp(context->input_name,s->name,5) == 0) {
+            /* found a match, call its parser */
+            id = (*context->sentence[i].parser)(context,s);
+            if (id > 0) {
+                break;
+            }
+        }
+    }
+        
+    return id;
+}
+
+/**
+                 +-5-+              +---+
+                 v   |              v   |
+ +------+       +------+           +------+         +------+         +------+
+ |   0  |--$--> |1-hdr |--alnum--> |2-data|----\r-->| 6-LF |---\n--->| done |--> 0
+ +------+       +------+           +------+         +------+         +------+
+                                    |                 ^
+                                    *                 +--------\r-------+
+                                    V                                   |
+                                 +------+           +------+         +------+
+                                 |3-cks |--xdigit-->|4-cks |-xdigit->| 5-CR |
+                                 +------+           +------+         +------+
+                                 
+return to start conditions:
+1. buffer overflow
+2. invalid character for state
+
+checksum calculation
+two hex digits represent the XOR of all characters between, but not
+including, the "$" and "*".  A checksum is required on some
+sentences.
+
+*/
+int nmeap_parse(nmeap_context_t *context,char ch)
+{
+    int status = 0;
+    
+    /* check for input buffer overrun first to avoid duplicating code in the
+    individual states
+    */
+    if (context->input_count >= (sizeof(context->input)-1)) {
+        /* input buffer overrun, restart state machine */
+        context->input_state = 0;
+        /* reset input count */
+        context->input_count = 0;
+    }
+    
+    /* store the byte */
+    context->input[context->input_count] = ch;
+    
+    /* next buffer position */
+    context->input_count++;
+    
+    /* run it through the lexical scanner */
+    switch(context->input_state) {
+    /* LOOKING FOR $ */
+    case 0:
+        if (ch == '$') {
+            /*look for id */
+            context->input_state = 1;
+            context->ccks        = 0;
+			context->icks        = 0;
+        }
+        else {
+            /* header error, start over */
+            context->err_hdr++;
+            context->input_state = 0;
+            context->input_count = 0;
+        }
+        break;
+    /* LOOKING FOR 5 CHARACTER SENTENCE ID */
+    case 1:
+        /* allow numbers even though it isn't usually done */
+        /* a proprietary id might have a numeral */
+        if (isalnum(ch)) {
+            /* store name separately */
+            context->input_name[context->input_count - 2] = ch;
+            /* checksum */
+            context->ccks ^= ch;
+            /* end of header? */
+            if (context->input_count >= 6) {
+                /* yes, get body */
+                context->input_state = 2;
+            }
+        }
+        else {
+            /* bad character, start over */
+            context->err_id++;
+            context->input_state = 0;
+            context->input_count = 0;
+        }
+        break;
+    /* LOOKING FOR CR OR CHECKSUM INDICATOR */
+    case 2:
+        if (ch == '*') {
+            /* this sentence has a checksum */
+            context->input_state = 3;
+        }
+        else if (ch == '\r') {
+            /* carriage return, no checksum, force a match */
+			context->icks = 0;
+			context->ccks = 0;
+            context->input_state = 6;
+        }
+        else {
+            /* continue accumulating data */
+            /* checksum */
+            context->ccks ^= ch;
+        }
+        break;
+    /* LOOKING FOR FIRST CHECKSUM CHARACTER */
+    case 3:
+        /* must be upper case hex digit */
+        if (isxdigit(ch) && (ch <= 'F')) {
+            /* got first checksum byte */
+            context->input_state = 4;
+            context->icks = HEXTOBIN(ch) << 4;
+        }
+        else {
+            /* input error, restart */
+            context->err_cks++;
+            context->input_state = 0;
+            context->input_count = 0;
+        }
+        break;
+        /* LOOKING FOR SECOND CHECKSUM CHARACTER */
+    case 4:
+        /* must be upper case hex digit */
+        if (isxdigit(ch) && (ch <= 'F')) {
+            /* got second checksum byte */
+            context->input_state = 5;
+            context->icks += HEXTOBIN(ch);
+        }
+        else {
+            /* input error, restart */
+            context->err_cks++;
+            context->input_state = 0;
+            context->input_count = 0;
+        }
+        break;
+    /* LOOKING FOR CR */
+    case 5:
+        if (ch == '\r') {
+            /* carriage return */
+            context->input_state = 6;
+        }
+        else {
+            /* input error, restart */
+            context->err_crl++;
+            context->input_state = 0;
+            context->input_count = 0;
+        }
+        break;
+    /* LOOKING FOR LINE FEED */
+    case 6:
+        if (ch == '\n') {
+            /* linefeed, line complete */
+            
+            /* delimit buffer */
+            context->input[context->input_count] = 0;
+            
+            /* if the checksums match, process the sentence */
+			if (context->ccks == context->icks) {
+				/* process */
+				status = nmeap_process(context);
+				
+				/* count good messages */
+				context->msgs++;
+			}
+			else {
+				/* count checksum errors */
+				context->err_cks++;
+			}
+            
+            /* restart next time */
+            context->input_state = 0;
+            context->input_count = 0;
+        }
+        else {
+            /* input error, restart */
+            context->err_crl++;
+            context->input_state = 0;
+            context->input_count = 0;
+        }
+        break;
+    default:
+        context->err_unk++;
+        context->input_state = 0;
+        break;
+    }
+            
+	return status;
+}
+
+/** 
+ * parse a buffer of nmea data
+ */
+int nmeap_parseBuffer(nmeap_context_t *context,const char *buffer,int *length)
+{
+    int  i;
+    int  status;
+    int  rem;
+    int  tlen;
+    
+    tlen   = *length;
+    rem    = *length;
+    status = 0;
+    /* for each byte in the buffer */
+    for(i=0;i<tlen;i++) {
+        /* decrement remaining byte count */
+        rem--;
+        /* parse the byte */
+        status = nmeap_parse(context,buffer[i]);
+        if (status != 0) {
+            /* message found or error */
+            break;
+        }
+    }
+	
+    /* return remaining byte count */
+    *length = rem;
+	
+    return status;
+}
+
+/** 
+ * standard GPGGA sentence parser 
+ */
+int nmeap_gpgga(nmeap_context_t *context,nmeap_sentence_t *sentence)
+{
+#ifndef NDEBUG	
+    int i;
+#endif
+    
+    /* get pointer to sentence data */
+    nmeap_gga_t *gga = (nmeap_gga_t *)sentence->data;
+    
+    /* if there is a data element, extract data from the tokens */
+	if (gga != 0) {
+		gga->latitude  = nmeap_latitude(context->token[2],context->token[3]);
+		gga->longitude = nmeap_longitude(context->token[4],context->token[5]);
+		gga->altitude  = nmeap_altitude(context->token[9],context->token[10]);
+		gga->time       = atoi(context->token[1]);
+		gga->satellites = atoi(context->token[7]);
+		gga->quality    = atoi(context->token[6]);
+		gga->hdop       = atof(context->token[8]);
+		gga->geoid      = nmeap_altitude(context->token[11],context->token[12]);
+	}
+
+#ifndef NDEBUG    
+    /* print raw input string */
+    printf("%s",context->debug_input);
+    
+    /* print some validation data */
+    printf("%s==%s %02x==%02x\n",context->input_name,sentence->name,context->icks,context->ccks);
+    
+    /* print the tokens */
+    for(i=0;i<context->tokens;i++) {
+        printf("%d:%s\n",i,context->token[i]);
+    }
+#endif   
+
+    /* if the sentence has a callout, call it */
+    if (sentence->callout != 0) {
+        (*sentence->callout)(context,gga,context->user_data);
+    }
+    
+    return NMEAP_GPGGA;
+}
+
+/** 
+ * standard GPRMCntence parser 
+ */
+int nmeap_gprmc(nmeap_context_t *context,nmeap_sentence_t *sentence)
+{
+#ifndef NDEBUG	
+    int i;
+#endif
+
+    /* get pointer to sentence data */
+    nmeap_rmc_t *rmc = (nmeap_rmc_t *)sentence->data;
+    
+	/* if there is a data element, use it */
+	if (rmc != 0) {
+		/* extract data from the tokens */
+		rmc->time       = atoi(context->token[1]);
+		rmc->warn       = *context->token[2];
+		rmc->latitude  = nmeap_latitude(context->token[3],context->token[4]);
+		rmc->longitude = nmeap_longitude(context->token[5],context->token[6]);
+		rmc->speed      = atof(context->token[7]);
+		rmc->course     = atof(context->token[8]);
+		rmc->date       = atoi(context->token[9]);
+		rmc->magvar     = atof(context->token[10]);
+	}
+
+#ifndef NDEBUG    
+    /* print raw input string */
+    printf("%s",context->debug_input);
+    
+    /* print some validation data */
+    printf("%s==%s %02x==%02x\n",context->input_name,sentence->name,context->icks,context->ccks);
+    
+    /* print the tokens */
+    for(i=0;i<context->tokens;i++) {
+        printf("%d:%s\n",i,context->token[i]);
+    }
+#endif   
+
+    /* if the sentence has a callout, call it */
+    if (sentence->callout != 0) {
+        (*sentence->callout)(context,rmc,context->user_data);
+    }
+    
+    return NMEAP_GPRMC;
+}
+
+
diff --git a/bertos/net/nmeap/tst/Makefile b/bertos/net/nmeap/tst/Makefile
new file mode 100644
index 00000000..e8407529
--- /dev/null
+++ b/bertos/net/nmeap/tst/Makefile
@@ -0,0 +1,17 @@
+all : test1 test2 test3 
+
+test1 : $(LIB)/libnmeap.a $(TST)/test1.c 
+	gcc -g -O0 -I $(INC) $(CDEFS) -Wall -Werror -o test1 $(TST)/test1.c $(LIB)/libnmeap.a
+
+test2 : $(LIB)/libnmeap.a $(TST)/test2.c 
+	gcc -g -O0 -I $(INC) $(CDEFS) -Wall -Werror -o test2 $(TST)/test2.c $(LIB)/libnmeap.a
+
+test3 : $(LIB)/libnmeap.a $(TST)/test3.c 
+	gcc -g -O0 -I $(INC) $(CDEFS) -Wall -Werror -o test3 $(TST)/test3.c $(LIB)/libnmeap.a
+
+clean:
+	-$(RM) test1
+	-$(RM) test2
+	-$(RM) test3
+
+
diff --git a/bertos/net/nmeap/tst/test1.c b/bertos/net/nmeap/tst/test1.c
new file mode 100644
index 00000000..3c5e18b5
--- /dev/null
+++ b/bertos/net/nmeap/tst/test1.c
@@ -0,0 +1,193 @@
+/*
+Copyright (c) 2005, David M Howard (daveh at dmh2000.com)
+All rights reserved.
+
+This product is licensed for use and distribution under the BSD Open Source License.
+see the file COPYING for more details.
+
+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. 
+
+*/
+
+/*
+========================================================================================================
+EXAMPLE : SETUP FOR GGA AND RMC SENTENCES WITH CHARACTER BY CHARACTER IO
+=======================================================================================================
+*/   
+
+
+#include <stdio.h>
+#include <stdlib.h>
+#include <string.h>
+#include "nmeap.h"
+
+nmeap_gga_t g_gga;
+
+char test_vector[] = {
+"$GPGGA,123519,3929.946667,N,11946.086667,E,1,08,0.9,545.4,M,46.9,M,,*4A\r\n" /* good */
+"$xyz,1234,asdfadfasdfasdfljsadfkjasdfk\r\n"                                  /* junk */
+"$GPRMC,225446,A,4916.45,N,12311.12,W,000.5,054.7,191194,020.3,E*68\r\n"      /* good */
+"$GPRMC,225446,A,4916.45,N,12311.12,W,000.5,054.7,191194,020.3,E*48\r\n"      /* checksum error */
+};
+
+char *pvec = test_vector;
+
+/** simulate character by character IO */
+int readchar() 
+{
+    int ch;
+    if (*pvec == 0) {
+        ch = -1;
+    }
+    else {
+        ch = *pvec++;
+    }
+    return ch;
+}
+
+/** do something with the GGA data */
+static void print_gga(nmeap_gga_t *gga)
+{
+    printf("found GPGGA message %.6f %.6f %.0f %lu %d %d %f %f\n",
+            gga->latitude  ,
+            gga->longitude, 
+            gga->altitude , 
+            gga->time     , 
+            gga->satellites,
+            gga->quality   ,
+            gga->hdop      ,
+            gga->geoid     
+            );
+}
+
+/** called when a gpgga message is received and parsed */
+static void gpgga_callout(nmeap_context_t *context,void *data,void *user_data)
+{
+    nmeap_gga_t *gga = (nmeap_gga_t *)data;
+    
+    printf("-------------callout\n");
+    print_gga(gga);
+}
+
+
+/** do something with the RMC data */
+static void print_rmc(nmeap_rmc_t *rmc)
+{
+    printf("found GPRMC Message %lu %c %.6f %.6f %f %f %lu %f\n",
+            rmc->time,
+            rmc->warn,
+            rmc->latitude,
+            rmc->longitude,
+            rmc->speed,
+            rmc->course,
+            rmc->date,
+            rmc->magvar
+            );
+}
+
+/** called when a gprmc message is received and parsed */
+static void gprmc_callout(nmeap_context_t *context,void *data,void *user_data)
+{
+    nmeap_rmc_t *rmc = (nmeap_rmc_t *)data;
+    
+    printf("-------------callout\n");
+    print_rmc(rmc);
+}
+
+/* ---------------------------------------------------------------------------------------*/
+/* STEP 1 : allocate the data structures. be careful if you put them on the stack because */
+/*          they need to be live for the duration of the parser                           */
+/* ---------------------------------------------------------------------------------------*/
+static nmeap_context_t nmea;	   /* parser context */
+static nmeap_gga_t     gga;		   /* this is where the data from GGA messages will show up */
+static nmeap_rmc_t     rmc;		   /* this is where the data from RMC messages will show up */
+static int             user_data; /* user can pass in anything. typically it will be a pointer to some user data */
+
+int main(int argc,char *argv[])
+{
+    int             status;
+    char            ch;
+    
+	/* ---------------------------------------*/
+	/*STEP 2 : initialize the nmea context    */                                                
+	/* ---------------------------------------*/
+    status = nmeap_init(&nmea,(void *)&user_data);
+    if (status != 0) {
+        printf("nmeap_init %d\n",status);
+        exit(1);
+    }
+    
+	/* ---------------------------------------*/
+	/*STEP 3 : add standard GPGGA parser      */                                                
+	/* -------------------------------------- */
+    status = nmeap_addParser(&nmea,"GPGGA",nmeap_gpgga,gpgga_callout,&gga);
+    if (status != 0) {
+        printf("nmeap_add %d\n",status);
+        exit(1);
+    }
+
+	/* ---------------------------------------*/
+	/*STEP 4 : add standard GPRMC parser      */                                                
+	/* -------------------------------------- */
+    status = nmeap_addParser(&nmea,"GPRMC",nmeap_gprmc,gprmc_callout,&rmc);
+    if (status != 0) {
+        printf("nmeap_add %d\n",status);
+        exit(1);
+    }
+    
+	/* ---------------------------------------*/
+	/*STEP 5 : process input until done       */                                                
+	/* -------------------------------------- */
+    for(;;) {
+		/* ---------------------------------------*/
+		/*STEP 6 : get a byte at a time           */                                                
+		/* -------------------------------------- */
+        ch = readchar();
+        if (ch <= 0) {
+            break;
+        }
+        
+		/* --------------------------------------- */
+		/*STEP 7 : pass it to the parser           */
+		/* status indicates whether a complete msg */
+		/* arrived for this byte                   */
+		/* NOTE : in addition to the return status */
+		/* the message callout will be fired when  */
+		/* a complete message is processed         */
+		/* --------------------------------------- */
+        status = nmeap_parse(&nmea,ch);
+        
+		/* ---------------------------------------*/
+		/*STEP 8 : process the return code        */                                                
+		/* -------------------------------------- */
+        switch(status) {
+        case NMEAP_GPGGA:
+			/* GOT A GPGGA MESSAGE */
+            printf("-------------switch\n");
+            print_gga(&gga);
+            printf("-------------\n");
+            break;
+        case NMEAP_GPRMC:
+			/* GOT A GPRMC MESSAGE */
+            printf("-------------switch\n");
+            print_rmc(&rmc);
+            printf("-------------\n");
+            break;
+        default:
+            break;
+        }
+    }
+    
+    return 0;
+}
+
diff --git a/bertos/net/nmeap/tst/test2.c b/bertos/net/nmeap/tst/test2.c
new file mode 100644
index 00000000..39a700f3
--- /dev/null
+++ b/bertos/net/nmeap/tst/test2.c
@@ -0,0 +1,208 @@
+/*
+Copyright (c) 2005, David M Howard (daveh at dmh2000.com)
+All rights reserved.
+
+This product is licensed for use and distribution under the BSD Open Source License.
+see the file COPYING for more details.
+
+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. 
+
+*/
+
+/*
+========================================================================================================
+EXAMPLE : SETUP FOR GGA AND RMC SENTENCES WITH CHARACTER BY CHARACTER IO
+=======================================================================================================
+*/   
+
+
+#include <stdio.h>
+#include <stdlib.h>
+#include <string.h>
+#include "nmeap.h"
+
+nmeap_gga_t g_gga;
+
+char test_vector[] = {
+"$GPGGA,123519,3929.946667,N,11946.086667,E,1,08,0.9,545.4,M,46.9,M,,*4A\r\n" /* good */
+"$xyz,1234,asdfadfasdfasdfljsadfkjasdfk\r\n"                                  /* junk */
+"$GPRMC,225446,A,4916.45,N,12311.12,W,000.5,054.7,191194,020.3,E*68\r\n"      /* good */
+"$GPRMC,225446,A,4916.45,N,12311.12,W,000.5,054.7,191194,020.3,E*48\r\n"      /* checksum error */
+};
+
+char *pvec = test_vector;
+
+/** simulate block IO */
+int readbuffer(char *buffer,int len)
+{
+    int i;
+    
+    if (*pvec == 0) {
+        // end of file
+        return -1;
+    }
+    
+    for(i=0;i<len;i++) {
+        /* quit when no more data */
+        if (*pvec == 0) {
+            break;
+        }
+        buffer[i] = *pvec++;
+    }
+    return i;
+}
+
+/** do something with the GGA data */
+static void print_gga(nmeap_gga_t *gga)
+{
+    printf("found GPGGA message %.6f %.6f %.0f %lu %d %d %f %f\n",
+            gga->latitude  ,
+            gga->longitude, 
+            gga->altitude , 
+            gga->time     , 
+            gga->satellites,
+            gga->quality   ,
+            gga->hdop      ,
+            gga->geoid     
+            );
+}
+
+/** called when a gpgga message is received and parsed */
+static void gpgga_callout(nmeap_context_t *context,void *data,void *user_data)
+{
+    nmeap_gga_t *gga = (nmeap_gga_t *)data;
+    
+    printf("-------------callout\n");
+    print_gga(gga);
+}
+
+
+/** do something with the RMC data */
+static void print_rmc(nmeap_rmc_t *rmc)
+{
+    printf("found GPRMC Message %lu %c %.6f %.6f %f %f %lu %f\n",
+            rmc->time,
+            rmc->warn,
+            rmc->latitude,
+            rmc->longitude,
+            rmc->speed,
+            rmc->course,
+            rmc->date,
+            rmc->magvar
+            );
+}
+
+/** called when a gprmc message is received and parsed */
+static void gprmc_callout(nmeap_context_t *context,void *data,void *user_data)
+{
+    nmeap_rmc_t *rmc = (nmeap_rmc_t *)data;
+    
+    printf("-------------callout\n");
+    print_rmc(rmc);
+}
+
+/* ---------------------------------------------------------------------------------------*/
+/* STEP 1 : allocate the data structures. be careful if you put them on the stack because */
+/*          they need to be live for the duration of the parser                           */
+/* ---------------------------------------------------------------------------------------*/
+static nmeap_context_t nmea;	   /* parser context */
+static nmeap_gga_t     gga;		   /* this is where the data from GGA messages will show up */
+static nmeap_rmc_t     rmc;		   /* this is where the data from RMC messages will show up */
+static int             user_data; /* user can pass in anything. typically it will be a pointer to some user data */
+
+int main(int argc,char *argv[])
+{
+    int  status;
+    int  rem;
+	int  offset;
+	int  len;
+	char buffer[32];
+    
+	/* ---------------------------------------*/
+	/*STEP 2 : initialize the nmea context    */                                                
+	/* ---------------------------------------*/
+    status = nmeap_init(&nmea,(void *)&user_data);
+    if (status != 0) {
+        printf("nmeap_init %d\n",status);
+        exit(1);
+    }
+    
+	/* ---------------------------------------*/
+	/*STEP 3 : add standard GPGGA parser      */                                                
+	/* -------------------------------------- */
+    status = nmeap_addParser(&nmea,"GPGGA",nmeap_gpgga,gpgga_callout,&gga);
+    if (status != 0) {
+        printf("nmeap_add %d\n",status);
+        exit(1);
+    }
+
+	/* ---------------------------------------*/
+	/*STEP 4 : add standard GPRMC parser      */                                                
+	/* -------------------------------------- */
+    status = nmeap_addParser(&nmea,"GPRMC",nmeap_gprmc,gprmc_callout,&rmc);
+    if (status != 0) {
+        printf("nmeap_add %d\n",status);
+        exit(1);
+    }
+    
+	/* ---------------------------------------*/
+	/*STEP 5 : process input until done       */                                                
+	/* -------------------------------------- */
+    for(;;) {
+		/* ---------------------------------------*/
+		/*STEP 6 : get a buffer of input          */                                                
+		/* -------------------------------------- */
+        len = rem = readbuffer(buffer,sizeof(buffer));
+        if (len <= 0) {
+            break;
+        }
+        
+		/* ----------------------------------------------*/
+		/*STEP 7 : process input until buffer is used up */                                                
+		/* --------------------------------------------- */
+		offset = 0;
+        while(rem > 0) {
+			/* --------------------------------------- */
+			/*STEP 8 : pass it to the parser           */
+			/* status indicates whether a complete msg */
+			/* arrived for this byte                   */
+			/* NOTE : in addition to the return status */
+			/* the message callout will be fired when  */
+			/* a complete message is processed         */
+			/* --------------------------------------- */
+            status = nmeap_parseBuffer(&nmea,&buffer[offset],&rem);
+			offset += (len - rem); 
+            
+			/* ---------------------------------------*/
+			/*STEP 9 : process the return code        */                                                
+			/* -------------------------------------- */
+            switch(status) {
+            case NMEAP_GPGGA:
+                printf("-------------switch\n");
+                print_gga(&gga);
+                printf("-------------\n");
+                break;
+            case NMEAP_GPRMC:
+                printf("-------------switch\n");
+                print_rmc(&rmc);
+                printf("-------------\n");
+                break;
+            default:
+                break;
+            }
+        }
+    }
+    
+    return 0;
+}
+
diff --git a/bertos/net/nmeap/tst/test3.c b/bertos/net/nmeap/tst/test3.c
new file mode 100644
index 00000000..250f53c4
--- /dev/null
+++ b/bertos/net/nmeap/tst/test3.c
@@ -0,0 +1,306 @@
+/*
+Copyright (c) 2005, David M Howard (daveh at dmh2000.com)
+All rights reserved.
+
+This product is licensed for use and distribution under the BSD Open Source License.
+see the file COPYING for more details.
+
+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. 
+
+*/
+
+/*
+========================================================================================================
+EXAMPLE : SETUP FOR GGA AND RMC SENTENCES + A CUSTOM SENTENCE PARSER WITH CHARACTER BY CHARACTER IO
+=======================================================================================================
+*/   
+
+
+/*
+$PGRMF
+
+GARMIN PROPRIETARY GPS Position Fix Data
+
+$PGRMF,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15*HH
+1 = GPS week number
+2 = GPS seconds in current week
+3 = UTC date, ddmmyy format
+4 = UTC time, hhmmss format
+5 = GPS leap second count
+6 = Latitude, dddmm.mmmm format
+7 = Latitude hemisphere, N or S
+8 = Longitude, dddmm.mmmm format
+9 = Longitude hemisphere, E or W
+10 = Mode (M=Manual, A=Automatic)
+11 = Fix type (0=No fix, 1=2D fix, 2=3D fix)
+12 = Speed over ground, kilometres / hour
+13 = Course over ground, degrees true
+14 = PDOP (Position dilution of precision), rounded to nearest integer
+15 = TDOP (Time dilution of precision), rounded to nearest integer
+HH = Checksum 
+*/
+
+
+
+#include <stdio.h>
+#include <stdlib.h>
+#include <string.h>
+#include <assert.h>
+#include "nmeap.h"
+
+nmeap_gga_t g_gga;
+
+char test_vector[] = {
+"$GPGGA,123519,3929.946667,N,11946.086667,E,1,08,0.9,545.4,M,46.9,M,,*4A\r\n"
+"$GPRMC,225446,A,4916.45,N,12311.12,W,000.5,054.7,191194,020.3,E*68\r\n"
+"$PGRMF,1,100,191105,123519,13,3929.946667,N,12311.12,W,A,2,100.1,181.2,3,8*35\r\n"
+};
+
+char *pvec = test_vector;
+
+/** simulate character by character IO */
+int readchar() 
+{
+    int ch;
+    if (*pvec == 0) {
+        ch = -1;
+    }
+    else {
+        ch = *pvec++;
+    }
+    return ch;
+}
+/* --------------------------------------------------------------*/
+/*STEP 1a : define a data structure to contain the sentence data */                                                
+/* ------------------------------------------------------------- */
+struct garmin_rmf {
+    /* field                            position in sentence */
+    int            week;             /*    1 = GPS week number                                                          */
+    int            seconds_of_week;  /*    2 = GPS seconds in current week                                              */
+    unsigned long  date;             /*    3 = UTC date, ddmmyy format                                                  */
+    unsigned long  time;             /*    4 = UTC time, hhmmss format                                                  */
+    int            leap;             /*    5 = GPS leap second count                                                    */
+    double         lat;              /*  6,7 = Latitude, dddmm.mmmm format (north positive)                             */
+    double         lon;              /*  8,9 = Longitude, dddmm.mmmm format (east positive)                             */
+    int            mode;             /*   10 = Mode (M=Manual, A=Automatic)                                             */
+    int            fix;              /*   11 = Fix type (0=No fix, 1=2D fix, 2=3D fix)                                  */
+    double         speed;            /*   12 = Speed over ground, kilometres / hour                                     */
+    double         course;           /*   13 = Course over ground, degrees true                                         */
+    int            pdop;             /*   14 = PDOP (Position dilution of precision), rounded to nearest integer        */
+    int            tdop;             /*   15 = TDOP (Time dilution of precision), rounded to nearest integer            */
+};
+typedef struct garmin_rmf garmin_rmf_t;
+
+/* --------------------------------------------------------------*/
+/*STEP 1b : define an id value for the message                   */                                                
+/* ------------------------------------------------------------- */
+#define GARMIN_PGRMF (NMEAP_USER + 0)
+
+
+/* --------------------------------------------------------------*/
+/* STEP 1c : write the sentence parser                            */                                                
+/* ------------------------------------------------------------- */
+int custom_pgrmf(nmeap_context_t *context,nmeap_sentence_t *sentence)
+{
+#ifndef NDEBUG	
+    int i;
+#endif
+    
+	/* get pointer to sentence data */
+	garmin_rmf_t *rmf = (garmin_rmf_t *)sentence->data;
+	
+	if (rmf != 0) {
+		/* if the sentence has a data storage element, use it */
+		
+		
+		/* extract data from the tokens */
+		rmf->week            = atoi(context->token[1]);
+		rmf->seconds_of_week = atoi(context->token[2]);
+		rmf->date            = (unsigned long)atol(context->token[3]);
+		rmf->time            = (unsigned long)atol(context->token[4]); 
+		rmf->leap            = atoi(context->token[5]);
+		rmf->lat             = nmeap_latitude(context->token[6],context->token[7]);
+		rmf->lon             = nmeap_longitude(context->token[8],context->token[9]);
+		rmf->mode            = atoi(context->token[10]);
+		rmf->fix             = atoi(context->token[11]);
+		rmf->speed           = atof(context->token[12]);
+		rmf->course          = atof(context->token[13]);
+		rmf->pdop            = atoi(context->token[14]); 
+		rmf->tdop            = atoi(context->token[15]);
+	}
+	/* else there was no data element to store into */
+
+#ifndef NDEBUG    
+    /* print raw input string */
+    printf("%s",context->debug_input);
+    
+    /* print some validation data */
+    printf("%s==%s %02x==%02x\n",context->input_name,sentence->name,context->icks,context->ccks);
+    
+    /* print the tokens */
+    for(i=0;i<context->tokens;i++) {
+        printf("%d:%s\n",i,context->token[i]);
+    }
+#endif   
+
+    /* if the sentence has a callout, call it */
+    if (sentence->callout != 0) {
+        (*sentence->callout)(context,rmf,context->user_data);
+    }
+    
+    return GARMIN_PGRMF;
+}
+
+
+/* -------------------------------------------------------------*/
+/*STEP 2 : write a function to do something with the data       */                                                
+/* ------------------------------------------------------------ */
+static void print_pgrmf(garmin_rmf_t *rmf)
+{
+	assert(rmf != 0);         
+	
+	printf("                    w sec date   time   lp lat       lon         m f spd    crs    p t\n");
+    printf("found PGRMF message %d %d %lu %lu %d %.6f %.6f %d %d %.2f %.2f %d %d\n",
+            rmf->week,                   
+            rmf->seconds_of_week, 
+            rmf->date,            
+            rmf->time,            
+            rmf->leap,            
+            rmf->lat,             
+            rmf->lon,             
+            rmf->mode,            
+            rmf->fix,             
+            rmf->speed,           
+            rmf->course,          
+            rmf->pdop,            
+            rmf->tdop            
+            );
+}
+
+/* -------------------------------------------------------------*/
+/*STEP 3 : if using the callout method, write the callout       */                                                
+/* ------------------------------------------------------------ */
+static void pgrmf_callout(nmeap_context_t *context,void *data,void *user_data)
+{
+    garmin_rmf_t *rmf = (garmin_rmf_t *)data;
+    
+    printf("-------------callout\n");
+    print_pgrmf(rmf);
+}
+
+
+/* ---------------------------------------------------------------------------------------*/
+/* STEP 4 : allocate the data structures. be careful if you put them on the stack because */
+/*          they need to be live for the duration of the parser                           */
+/* ---------------------------------------------------------------------------------------*/
+static nmeap_context_t nmea;       /* parser context */
+static nmeap_gga_t     gga;        /* this is where the data from GGA messages will show up */
+static nmeap_rmc_t     rmc;        /* this is where the data from RMC messages will show up */
+static garmin_rmf_t    rmf;        /* this is where the data from RMF messages will show up */
+static int             user_data; /* user can pass in anything. typically it will be a pointer to some user data */
+
+int main(int argc,char *argv[])
+{
+    int             status;
+    char            ch;
+    
+    /* ---------------------------------------*/
+    /*STEP 5 : initialize the nmea context    */                                                
+    /* ---------------------------------------*/
+    status = nmeap_init(&nmea,(void *)&user_data);
+    if (status != 0) {
+        printf("nmeap_init %d\n",status);
+        exit(1);
+    }
+    
+    /* ---------------------------------------*/
+    /*STEP 6 : add standard GPGGA parser      */
+	/*         (no callout this time)         */
+    /* -------------------------------------- */
+    status = nmeap_addParser(&nmea,"GPGGA",nmeap_gpgga,0,&gga);
+    if (status != 0) {
+        printf("nmeap_add %d\n",status);
+        exit(1);
+    }
+
+    /* ---------------------------------------*/
+    /*STEP 7 : add standard GPRMC parser      */                                                
+	/*         (no callout this time)         */
+    /* -------------------------------------- */
+    status = nmeap_addParser(&nmea,"GPRMC",nmeap_gprmc,0,&rmc);
+    if (status != 0) {
+        printf("nmeap_add %d\n",status);
+        exit(1);
+    }
+    
+    /* ---------------------------------------*/
+    /*STEP 8 : ADD THE CUSTOM PARSER          */                                                
+	/*         with callout         )         */
+    /* -------------------------------------- */
+    status = nmeap_addParser(&nmea,"PGRMF",custom_pgrmf,pgrmf_callout,&rmf);
+    if (status != 0) {
+        printf("nmeap_add %d\n",status);
+        exit(1);
+    }
+    /* ---------------------------------------*/
+    /*STEP 9 : process input until done       */                                                
+    /* -------------------------------------- */
+    for(;;) {
+        /* ---------------------------------------*/
+        /*STEP 10: get a byte at a time           */                                                
+        /* -------------------------------------- */
+        ch = readchar();
+        if (ch <= 0) {
+            break;
+        }
+        
+        /* --------------------------------------- */
+        /*STEP 11: pass it to the parser          */
+        /* status indicates whether a complete msg */
+        /* arrived for this byte                   */
+        /* NOTE : in addition to the return status */
+        /* the message callout will be fired when  */
+        /* a complete message is processed         */
+        /* --------------------------------------- */
+        status = nmeap_parse(&nmea,ch);
+        
+        /* ---------------------------------------*/
+        /*STEP 12 : process the return code       */                                                
+        /* -------------------------------------- */
+        switch(status) {
+        case NMEAP_GPGGA:
+            /* GOT A GPGGA MESSAGE */
+            printf("-------------switch\n");
+            printf("GPGGA\n");
+            printf("-------------\n");
+            break;
+        case NMEAP_GPRMC:
+            /* GOT A GPRMC MESSAGE */
+            printf("-------------switch\n");
+            printf("GPRMC\n");
+            printf("-------------\n");
+            break;
+        case GARMIN_PGRMF:
+            /* GOT A PGRMF MESSAGE */
+            printf("-------------switch\n");
+            print_pgrmf(&rmf);
+            printf("-------------\n");
+            break;
+        default:
+            break;
+        }
+    }
+    
+    return 0;
+}
+
diff --git a/bertos/net/nmeap/tst/tst.mak b/bertos/net/nmeap/tst/tst.mak
new file mode 100644
index 00000000..df5f3493
--- /dev/null
+++ b/bertos/net/nmeap/tst/tst.mak
@@ -0,0 +1,29 @@
+INCLUDES= ..\inc\nmeap.h ..\inc\nmeap_def.h
+CSRC    = nmeap01.c
+LIBNAME = ..\lib\libnmeap.lib
+
+# build everything
+all : test1.exe test2.exe test3.exe wingps.exe 
+
+test1.exe : test1.c $(LIBNAME)
+	cl /DNDEBUG /c /I..\inc test1.c
+	link /OUT:test1.exe test1.obj $(LIBNAME) 
+	
+test2.exe : test2.c $(LIBNAME)
+	cl /DNDEBUG /c /I..\inc test2.c
+	link /OUT:test2.exe test2.obj $(LIBNAME)
+	
+test3.exe : test3.c $(LIBNAME)
+	cl /DNDEBUG /c /I..\inc test3.c
+	link /OUT:test3.exe test3.obj $(LIBNAME)
+	
+wingps.exe : wingps.c $(LIBNAME)
+	cl /DNDEBUG /c /I..\inc wingps.c
+	link /OUT:wingps.exe wingps.obj $(LIBNAME)
+
+# erase all intermediate and output files
+clean :
+	-erase *.obj
+	-erase *.exe
+
+
diff --git a/bertos/net/nmeap/tst/wingps.c b/bertos/net/nmeap/tst/wingps.c
new file mode 100644
index 00000000..7e6b093a
--- /dev/null
+++ b/bertos/net/nmeap/tst/wingps.c
@@ -0,0 +1,244 @@
+/*
+Copyright (c) 2005, David M Howard (daveh at dmh2000.com)
+All rights reserved.
+
+This product is licensed for use and distribution under the BSD Open Source License.
+see the file COPYING for more details.
+
+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. 
+
+*/
+
+/*
+========================================================================================================
+EXAMPLE : SETUP FOR GGA AND RMC SENTENCES WITH SERIAL IO FOR WIN32
+=======================================================================================================
+*/   
+#define WIN32_LEAN_AND_MEAN
+#include <windows.h>
+#include <stdio.h>
+#include <stdlib.h>
+#include <string.h>
+#include "nmeap.h"
+
+/** open a serial port */
+static HANDLE openPort(const char *port,int baud)
+{
+	HANDLE       h;
+	DCB          dcb;
+	COMMTIMEOUTS tmo;
+	int          status;
+
+	/* open the port */
+	h = CreateFile( port,  
+                    GENERIC_READ | GENERIC_WRITE, 
+                    0, 
+                    0, 
+                    OPEN_EXISTING,
+                    0,
+                    0);
+	if (h == INVALID_HANDLE_VALUE) {
+		/* quit on error */
+		return h;
+	}
+   
+
+	/* read current configuration */
+   status = GetCommState(h,&dcb);
+   if (status == 0) {
+	   CloseHandle(h);
+	   return INVALID_HANDLE_VALUE;
+   }
+
+   /* set the baud rate and other parameters */
+   dcb.BaudRate = baud;
+   dcb.ByteSize = 8;
+   dcb.Parity   = NOPARITY; 
+   dcb.StopBits = ONESTOPBIT;
+
+   /* set configuration */
+   status = SetCommState(h, &dcb);
+   if (status == 0) {
+	   CloseHandle(h);
+	   return INVALID_HANDLE_VALUE;
+   }
+
+   /* read timeout configuration */
+   status = GetCommTimeouts(h,&tmo);
+   if (status == 0) {
+	   CloseHandle(h);
+	   return INVALID_HANDLE_VALUE;
+   }
+
+   /* set to indefinite blocking */
+   tmo.ReadIntervalTimeout        = 0;
+   tmo.ReadTotalTimeoutConstant   = 0;
+   tmo.ReadTotalTimeoutMultiplier = 0;
+   status = SetCommTimeouts(h,&tmo);
+   if (status == 0) {
+	   CloseHandle(h);
+	   return INVALID_HANDLE_VALUE;
+   }
+
+	return h;
+}
+
+/** read a byte (blocking) */
+static int readPort(HANDLE h)
+{
+	BOOL  status;
+	char  ch;
+	DWORD count;
+	status =  ReadFile(h,&ch,1,&count,0);
+	if (status == 0) {
+		return -1;
+	}
+
+	return (int)ch;
+}
+
+
+static void closePort(HANDLE h)
+{
+	CloseHandle(h);
+}
+
+
+/** print current data */
+static void printGps(nmeap_gga_t *gga,nmeap_rmc_t *rmc)
+{
+	printf("%lu %lu %.6f %.6f %.0f %f %f %d %d\n",
+			gga->time,
+			rmc->date,
+            gga->latitude  ,
+            gga->longitude, 
+            gga->altitude , 
+			rmc->course,
+			rmc->speed,
+            gga->satellites,
+            gga->quality   
+            );
+}
+
+/* ---------------------------------------------------------------------------------------*/
+/* STEP 1 : allocate the data structures. be careful if you put them on the stack because */
+/*          they need to be live for the duration of the parser                           */
+/* ---------------------------------------------------------------------------------------*/
+static nmeap_context_t nmea;	   /* parser context */
+static nmeap_gga_t     gga;		   /* this is where the data from GGA messages will show up */
+static nmeap_rmc_t     rmc;		   /* this is where the data from RMC messages will show up */
+static int             user_data; /* user can pass in anything. typically it will be a pointer to some user data */
+
+int main(int argc,char *argv[])
+{
+    int             status;
+    char            ch;
+	const char     *port;
+	int             baud;
+	HANDLE          h;
+
+	/* require both arguments */
+	if (argc != 3) {
+		printf("%s <comport> <baud>\n",argv[0]);
+		return 1;
+	}
+
+	/* serial port argument */
+	port = argv[1];
+
+	/* baud rate argument */
+	status = sscanf(argv[2],"%d",&baud);
+	if (status != 1) {
+		printf("%s <comport> <baud>\n",argv[0]);
+		printf("invalid <baud> : %s\n",argv[2]);
+		return 1;
+	}
+
+	/** open the serial port */
+	h = openPort(port,baud);
+	if (h == INVALID_HANDLE_VALUE) {
+		printf("can't open port : %s\n",port);
+		return 1;
+	}
+    
+	/* ---------------------------------------*/
+	/*STEP 2 : initialize the nmea context    */                                                
+	/* ---------------------------------------*/
+    status = nmeap_init(&nmea,(void *)&user_data);
+    if (status != 0) {
+        printf("nmeap_init %d\n",status);
+        exit(1);
+    }
+    
+	/* ---------------------------------------*/
+	/*STEP 3 : add standard GPGGA parser      */                                                
+	/* -------------------------------------- */
+    status = nmeap_addParser(&nmea,"GPGGA",nmeap_gpgga,0,&gga);
+    if (status != 0) {
+        printf("nmeap_add %d\n",status);
+        exit(1);
+    }
+
+	/* ---------------------------------------*/
+	/*STEP 4 : add standard GPRMC parser      */                                                
+	/* -------------------------------------- */
+    status = nmeap_addParser(&nmea,"GPRMC",nmeap_gprmc,0,&rmc);
+    if (status != 0) {
+        printf("nmeap_add %d\n",status);
+        exit(1);
+    }
+
+	/* ---------------------------------------*/
+	/*STEP 5 : process input until done       */                                                
+	/* -------------------------------------- */
+    for(;;) {
+		/* ---------------------------------------*/
+		/*STEP 6 : get a byte at a time           */                                                
+		/* -------------------------------------- */
+        ch = readPort(h);
+        if (ch <= 0) {
+            break;
+        }
+        
+		/* --------------------------------------- */
+		/*STEP 7 : pass it to the parser           */
+		/* status indicates whether a complete msg */
+		/* arrived for this byte                   */
+		/* NOTE : in addition to the return status */
+		/* the message callout will be fired when  */
+		/* a complete message is processed         */
+		/* --------------------------------------- */
+        status = nmeap_parse(&nmea,ch);
+        
+		/* ---------------------------------------*/
+		/*STEP 8 : process the return code        */                                                
+		/* -------------------------------------- */
+        switch(status) {
+        case NMEAP_GPGGA:
+			/* GOT A GPGGA MESSAGE */
+            printGps(&gga,&rmc);
+            break;
+        case NMEAP_GPRMC:
+			/* GOT A GPRMC MESSAGE */
+            printGps(&gga,&rmc);
+            break;
+        default:
+            break;
+        }
+    }
+
+	/* close and quit */
+	closePort(h);
+    
+    return 0;
+}
diff --git a/bertos/net/nmeap/win32.mak b/bertos/net/nmeap/win32.mak
new file mode 100644
index 00000000..5c79366f
--- /dev/null
+++ b/bertos/net/nmeap/win32.mak
@@ -0,0 +1,22 @@
+# directories
+SRC=src
+TST=tst
+
+all :
+	cd $(SRC)
+	$(MAKE) -f nmeap.mak all
+	cd ..\$(TST) 
+	$(MAKE) -f tst.mak all
+	cd ..
+	
+
+clean :
+	cd $(SRC)
+	$(MAKE) -f nmeap.mak clean
+	cd ..\$(TST)
+	$(MAKE) -f tst.mak clean
+	cd ..
+	
+doc  :
+	doxygen
+