Subversion Repositories idreammicro-avr

Compare Revisions

Regard whitespace Rev 1 → Rev HEAD

/trunk/Doxyfile
0,0 → 1,1813
# Doxyfile 1.7.6.1
 
# 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
#---------------------------------------------------------------------------
 
# This tag specifies the encoding used for all characters in the config file
# that follow. The default is UTF-8 which is also the encoding used for all
# text before the first occurrence of this tag. Doxygen uses libiconv (or the
# iconv built into libc) for the transcoding. See
# http://www.gnu.org/software/libiconv for the list of possible encodings.
 
DOXYFILE_ENCODING = UTF-8
 
# The PROJECT_NAME tag is a single word (or sequence of words) that should
# identify the project. Note that if you do not use Doxywizard you need
# to put quotes around the project name if it contains spaces.
 
PROJECT_NAME = idreammicro-avr
 
# 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 =
 
# Using the PROJECT_BRIEF tag one can provide an optional one line description
# for a project that appears at the top of each page and should give viewer
# a quick idea about the purpose of the project. Keep the description short.
 
PROJECT_BRIEF =
 
# With the PROJECT_LOGO tag one can specify an logo or icon that is
# included in the documentation. The maximum height of the logo should not
# exceed 55 pixels and the maximum width should not exceed 200 pixels.
# Doxygen will copy the logo to the output directory.
 
PROJECT_LOGO =
 
# 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:
# Afrikaans, Arabic, Brazilian, Catalan, Chinese, Chinese-Traditional,
# Croatian, Czech, Danish, Dutch, Esperanto, Farsi, Finnish, French, German,
# Greek, Hungarian, Italian, Japanese, Japanese-en (Japanese with English
# messages), Korean, Korean-en, Lithuanian, Norwegian, Macedonian, Persian,
# Polish, Portuguese, Romanian, Russian, Serbian, Serbian-Cyrillic, Slovak,
# Slovene, Spanish, Swedish, Ukrainian, and Vietnamese.
 
OUTPUT_LANGUAGE = English
 
# 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 = "The $name class" \
"The $name widget" \
"The $name file" \
is \
provides \
specifies \
contains \
represents \
a \
an \
the
 
# 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 = YES
 
# 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 if your file system
# 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 regular Qt-style comments
# (thus requiring an explicit @brief command for a brief description.)
 
JAVADOC_AUTOBRIEF = NO
 
# If the QT_AUTOBRIEF tag is set to YES then Doxygen will
# interpret the first line (until the first dot) of a Qt-style
# comment as the brief description. If set to NO, the comments
# will behave just like regular Qt-style comments (thus requiring
# an explicit \brief command for a brief description.)
 
QT_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 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 the SEPARATE_MEMBER_PAGES tag is set to YES, then doxygen will produce
# a new page for each member. If set to NO, the documentation of a member will
# be part of the file/class/namespace that contains it.
 
SEPARATE_MEMBER_PAGES = 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 =
 
# This tag can be used to specify a number of word-keyword mappings (TCL only).
# A mapping has the form "name=value". For example adding
# "class=itcl::class" will allow you to use the command class in the
# itcl::class meaning.
 
TCL_SUBST =
 
# 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 OPTIMIZE_FOR_FORTRAN tag to YES if your project consists of Fortran
# sources only. Doxygen will then generate output that is more tailored for
# Fortran.
 
OPTIMIZE_FOR_FORTRAN = NO
 
# Set the OPTIMIZE_OUTPUT_VHDL tag to YES if your project consists of VHDL
# sources. Doxygen will then generate output that is tailored for
# VHDL.
 
OPTIMIZE_OUTPUT_VHDL = NO
 
# Doxygen selects the parser to use depending on the extension of the files it
# parses. With this tag you can assign which parser to use for a given extension.
# Doxygen has a built-in mapping, but you can override or extend it using this
# tag. The format is ext=language, where ext is a file extension, and language
# is one of the parsers supported by doxygen: IDL, Java, Javascript, CSharp, C,
# C++, D, PHP, Objective-C, Python, Fortran, VHDL, C, C++. For instance to make
# doxygen treat .inc files as Fortran files (default is PHP), and .f files as C
# (default is Fortran), use: inc=Fortran f=C. Note that for custom extensions
# you also need to set FILE_PATTERNS otherwise the files are not read by doxygen.
 
EXTENSION_MAPPING =
 
# If you use STL classes (i.e. std::string, std::vector, etc.) but do not want
# to include (a tag file for) the STL sources as input, then you should
# set this tag to YES in order to let doxygen match functions declarations and
# definitions whose arguments contain STL classes (e.g. func(std::string); v.s.
# func(std::string) {}). This also makes the inheritance and collaboration
# diagrams that involve STL classes more complete and accurate.
 
BUILTIN_STL_SUPPORT = NO
 
# If you use Microsoft's C++/CLI language, you should set this option to YES to
# enable parsing support.
 
CPP_CLI_SUPPORT = NO
 
# Set the SIP_SUPPORT tag to YES if your project consists of sip sources only.
# Doxygen will parse them like normal C++ but will assume all classes use public
# instead of private inheritance when no explicit protection keyword is present.
 
SIP_SUPPORT = NO
 
# For Microsoft's IDL there are propget and propput attributes to indicate getter
# and setter methods for a property. Setting this option to YES (the default)
# will make doxygen replace the get and set methods by a property in the
# documentation. This will only work if the methods are indeed getting or
# setting a simple type. If this is not the case, or you want to show the
# methods anyway, you should set this option to NO.
 
IDL_PROPERTY_SUPPORT = 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
 
# 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
 
# When the INLINE_GROUPED_CLASSES tag is set to YES, classes, structs and
# unions are shown inside the group in which they are included (e.g. using
# @ingroup) instead of on a separate page (for HTML and Man pages) or
# section (for LaTeX and RTF).
 
INLINE_GROUPED_CLASSES = NO
 
# When the INLINE_SIMPLE_STRUCTS tag is set to YES, structs, classes, and
# unions with only public data fields will be shown inline in the documentation
# of the scope in which they are defined (i.e. file, namespace, or group
# documentation), provided this scope is documented. If set to NO (the default),
# structs, classes, and unions are shown on a separate page (for HTML and Man
# pages) or section (for LaTeX and RTF).
 
INLINE_SIMPLE_STRUCTS = NO
 
# When TYPEDEF_HIDES_STRUCT is enabled, a typedef of a struct, union, or enum
# is documented as struct, union, or enum with the name of the typedef. So
# typedef struct TypeS {} TypeT, will appear in the documentation as a struct
# with name TypeT. When disabled the typedef will appear as a member of a file,
# namespace, or class. And the struct will be named TypeS. This can typically
# be useful for C code in case the coding convention dictates that all compound
# types are typedef'ed and only the typedef is referenced, never the tag name.
 
TYPEDEF_HIDES_STRUCT = NO
 
# The SYMBOL_CACHE_SIZE determines the size of the internal cache use to
# determine which symbols to keep in memory and which to flush to disk.
# When the cache is full, less often used symbols will be written to disk.
# For small to medium size projects (<1000 input files) the default value is
# probably good enough. For larger projects a too small cache size can cause
# doxygen to be busy swapping symbols to and from disk most of the time
# causing a significant performance penalty.
# If the system has enough physical memory increasing the cache will improve the
# performance by keeping more symbols in memory. Note that the value works on
# a logarithmic scale so increasing the size by one will roughly double the
# memory usage. The cache size is given by this formula:
# 2^(16+SYMBOL_CACHE_SIZE). The valid range is 0..9, the default is 0,
# corresponding to a cache size of 2^16 = 65536 symbols.
 
SYMBOL_CACHE_SIZE = 0
 
# Similar to the SYMBOL_CACHE_SIZE the size of the symbol lookup cache can be
# set using LOOKUP_CACHE_SIZE. This cache is used to resolve symbols given
# their name and scope. Since this can be an expensive process and often the
# same symbol appear multiple times in the code, doxygen keeps a cache of
# pre-resolved symbols. If the cache is too small doxygen will become slower.
# If the cache is too large, memory is wasted. The cache size is given by this
# formula: 2^(16+LOOKUP_CACHE_SIZE). The valid range is 0..9, the default is 0,
# corresponding to a cache size of 2^16 = 65536 symbols.
 
LOOKUP_CACHE_SIZE = 0
 
#---------------------------------------------------------------------------
# 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 = NO
 
# If the EXTRACT_PRIVATE tag is set to YES all private members of a class
# will be included in the documentation.
 
EXTRACT_PRIVATE = NO
 
# If the EXTRACT_STATIC tag is set to YES all static members of a file
# will be included in the documentation.
 
EXTRACT_STATIC = NO
 
# 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 this flag is set to YES, the members of anonymous namespaces will be
# extracted and appear in the documentation as a namespace called
# 'anonymous_namespace{file}', where file will be replaced with the base
# name of the file that contains the anonymous namespace. By default
# anonymous namespaces are hidden.
 
EXTRACT_ANON_NSPACES = 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 = YES
 
# 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 FORCE_LOCAL_INCLUDES tag is set to YES then Doxygen
# will list include files with double quotes in the documentation
# rather than with sharp brackets.
 
FORCE_LOCAL_INCLUDES = NO
 
# 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_MEMBERS_CTORS_1ST tag is set to YES then doxygen
# will sort the (brief and detailed) documentation of class members so that
# constructors and destructors are listed first. If set to NO (the default)
# the constructors will appear in the respective orders defined by
# SORT_MEMBER_DOCS and SORT_BRIEF_DOCS.
# This tag will be ignored for brief docs if SORT_BRIEF_DOCS is set to NO
# and ignored for detailed docs if SORT_MEMBER_DOCS is set to NO.
 
SORT_MEMBERS_CTORS_1ST = NO
 
# If the SORT_GROUP_NAMES tag is set to YES then doxygen will sort the
# hierarchy of group names into alphabetical order. If set to NO (the default)
# the group names will appear in their defined order.
 
SORT_GROUP_NAMES = 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
 
# If the STRICT_PROTO_MATCHING option is enabled and doxygen fails to
# do proper type resolution of all parameters of a function it will reject a
# match between the prototype and the implementation of a member function even
# if there is only one candidate or it is obvious which candidate to choose
# by doing a simple string match. By disabling STRICT_PROTO_MATCHING doxygen
# will still accept a match between prototype and implementation in such cases.
 
STRICT_PROTO_MATCHING = 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 macro 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 macros 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
 
# If the sources in your project are distributed over multiple directories
# then setting the SHOW_DIRECTORIES tag to YES will show the directory hierarchy
# in the documentation. The default is NO.
 
SHOW_DIRECTORIES = NO
 
# Set the SHOW_FILES tag to NO to disable the generation of the Files page.
# This will remove the Files entry from the Quick Index and from the
# Folder Tree View (if specified). The default is YES.
 
SHOW_FILES = YES
 
# Set the SHOW_NAMESPACES tag to NO to disable the generation of the
# Namespaces page. This will remove the Namespaces entry from the Quick Index
# and from the Folder Tree View (if specified). The default is YES.
 
SHOW_NAMESPACES = YES
 
# The FILE_VERSION_FILTER tag can be used to specify a program or script that
# doxygen should invoke to get the current version for each file (typically from
# the version control system). Doxygen will invoke the program by executing (via
# popen()) the command <command> <input-file>, where <command> is the value of
# the FILE_VERSION_FILTER tag, and <input-file> is the name of an input file
# provided by doxygen. Whatever the program writes to standard output
# is used as the file version. See the manual for examples.
 
FILE_VERSION_FILTER =
 
# The LAYOUT_FILE tag can be used to specify a layout file which will be parsed
# by doxygen. The layout file controls the global structure of the generated
# output files in an output format independent way. The create the layout file
# that represents doxygen's defaults, run doxygen with the -l option.
# You can optionally specify a file name after the option, if omitted
# DoxygenLayout.xml will be used as the name of the layout file.
 
LAYOUT_FILE =
 
# The CITE_BIB_FILES tag can be used to specify one or more bib files
# containing the references data. This must be a list of .bib files. The
# .bib extension is automatically appended if omitted. Using this command
# requires the bibtex tool to be installed. See also
# http://en.wikipedia.org/wiki/BibTeX for more info. For LaTeX the style
# of the bibliography can be controlled using LATEX_BIB_STYLE. To use this
# feature you need bibtex and perl available in the search path.
 
CITE_BIB_FILES =
 
#---------------------------------------------------------------------------
# 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_NO_PARAMDOC option can be enabled to get warnings for
# functions that are documented, but have no documentation for their parameters
# or return value. If set to NO (the default) doxygen will only warn about
# wrong or incomplete parameter documentation, but not about the absence of
# documentation.
 
WARN_NO_PARAMDOC = NO
 
# 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. Optionally the format may contain
# $version, which will be replaced by the version of the file (if it could
# be obtained via FILE_VERSION_FILTER)
 
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 = ./
 
# This tag can be used to specify the character encoding of the source files
# that doxygen parses. Internally doxygen uses the UTF-8 encoding, which is
# also the default input encoding. Doxygen uses libiconv (or the iconv built
# into libc) for the transcoding. See http://www.gnu.org/software/libiconv for
# the list of possible encodings.
 
INPUT_ENCODING = UTF-8
 
# 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++ *.d *.java *.ii *.ixx *.ipp *.i++ *.inl *.h *.hh
# *.hxx *.hpp *.h++ *.idl *.odl *.cs *.php *.php3 *.inc *.m *.mm *.dox *.py
# *.f90 *.f *.for *.vhd *.vhdl
 
FILE_PATTERNS = *.c \
*.cc \
*.cxx \
*.cpp \
*.c++ \
*.d \
*.java \
*.ii \
*.ixx \
*.ipp \
*.i++ \
*.inl \
*.h \
*.hh \
*.hxx \
*.hpp \
*.h++ \
*.idl \
*.odl \
*.cs \
*.php \
*.php3 \
*.inc \
*.m \
*.mm \
*.dox \
*.py \
*.f90 \
*.f \
*.for \
*.vhd \
*.vhdl
 
# 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 be
# 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.
# Note that relative paths are relative to the directory from which doxygen is
# run.
 
EXCLUDE =
 
# The EXCLUDE_SYMLINKS tag can be used to select whether or not files or
# directories that are symbolic links (a Unix file system 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. Note that the wildcards are matched
# against the file with absolute path, so to exclude all test directories
# for example use the pattern */test/*
 
EXCLUDE_PATTERNS =
 
# The EXCLUDE_SYMBOLS tag can be used to specify one or more symbol names
# (namespaces, classes, functions, etc.) that should be excluded from the
# output. The symbol name can be a fully qualified name, a word, or if the
# wildcard * is used, a substring. Examples: ANamespace, AClass,
# AClass::ANamespace, ANamespace::*Test
 
EXCLUDE_SYMBOLS =
 
# 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 or if
# non of the patterns match the file name, INPUT_FILTER is applied.
 
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
 
# The FILTER_SOURCE_PATTERNS tag can be used to specify source filters per file
# pattern. A pattern will override the setting for FILTER_PATTERN (if any)
# and it is also possible to disable source filtering for a specific pattern
# using *.ext= (so without naming a filter). This option only has effect when
# FILTER_SOURCE_FILES is enabled.
 
FILTER_SOURCE_PATTERNS =
 
#---------------------------------------------------------------------------
# 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 = YES
 
# If the REFERENCED_BY_RELATION tag is set to YES
# then for each documented function all documented
# functions referencing it will be listed.
 
REFERENCED_BY_RELATION = NO
 
# If the REFERENCES_RELATION tag is set to YES
# then for each documented function all documented entities
# called/used by that function will be listed.
 
REFERENCES_RELATION = NO
 
# If the REFERENCES_LINK_SOURCE tag is set to YES (the default)
# and SOURCE_BROWSER tag is set to YES, then the hyperlinks from
# functions in REFERENCES_RELATION and REFERENCED_BY_RELATION lists will
# link to the source code. Otherwise they will link to the documentation.
 
REFERENCES_LINK_SOURCE = YES
 
# If the USE_HTAGS tag is set to YES then the references to source code
# will point to the HTML generated by the htags(1) tool instead of doxygen
# built-in source browser. The htags tool is part of GNU's global source
# tagging system (see http://www.gnu.org/software/global/global.html). You
# will need version 4.8.6 or higher.
 
USE_HTAGS = NO
 
# 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 = YES
 
# 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. Note that when using a custom header you are responsible
# for the proper inclusion of any scripts and style sheets that doxygen
# needs, which is dependent on the configuration options used.
# It is advised to generate a default header using "doxygen -w html
# header.html footer.html stylesheet.css YourConfigFile" and then modify
# that header. Note that the header is subject to change so you typically
# have to redo this when upgrading to a newer version of doxygen or when
# changing the value of configuration settings such as GENERATE_TREEVIEW!
 
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
# style sheet in the HTML output directory as well, or it will be erased!
 
HTML_STYLESHEET =
 
# The HTML_EXTRA_FILES tag can be used to specify one or more extra images or
# other source files which should be copied to the HTML output directory. Note
# that these files will be copied to the base HTML output directory. Use the
# $relpath$ marker in the HTML_HEADER and/or HTML_FOOTER files to load these
# files. In the HTML_STYLESHEET file, use the file name only. Also note that
# the files will be copied as-is; there are no commands or markers available.
 
HTML_EXTRA_FILES =
 
# The HTML_COLORSTYLE_HUE tag controls the color of the HTML output.
# Doxygen will adjust the colors in the style sheet and background images
# according to this color. Hue is specified as an angle on a colorwheel,
# see http://en.wikipedia.org/wiki/Hue for more information.
# For instance the value 0 represents red, 60 is yellow, 120 is green,
# 180 is cyan, 240 is blue, 300 purple, and 360 is red again.
# The allowed range is 0 to 359.
 
HTML_COLORSTYLE_HUE = 220
 
# The HTML_COLORSTYLE_SAT tag controls the purity (or saturation) of
# the colors in the HTML output. For a value of 0 the output will use
# grayscales only. A value of 255 will produce the most vivid colors.
 
HTML_COLORSTYLE_SAT = 100
 
# The HTML_COLORSTYLE_GAMMA tag controls the gamma correction applied to
# the luminance component of the colors in the HTML output. Values below
# 100 gradually make the output lighter, whereas values above 100 make
# the output darker. The value divided by 100 is the actual gamma applied,
# so 80 represents a gamma of 0.8, The value 220 represents a gamma of 2.2,
# and 100 does not change the gamma.
 
HTML_COLORSTYLE_GAMMA = 80
 
# If the HTML_TIMESTAMP tag is set to YES then the footer of each generated HTML
# page will contain the date and time when the page was generated. Setting
# this to NO can help when comparing the output of multiple runs.
 
HTML_TIMESTAMP = YES
 
# 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 HTML_DYNAMIC_SECTIONS tag is set to YES then the generated HTML
# documentation will contain sections that can be hidden and shown after the
# page has loaded. For this to work a browser that supports
# JavaScript and DHTML is required (for instance Mozilla 1.0+, Firefox
# Netscape 6.0+, Internet explorer 5.0+, Konqueror, or Safari).
 
HTML_DYNAMIC_SECTIONS = NO
 
# If the GENERATE_DOCSET tag is set to YES, additional index files
# will be generated that can be used as input for Apple's Xcode 3
# integrated development environment, introduced with OSX 10.5 (Leopard).
# To create a documentation set, doxygen will generate a Makefile in the
# HTML output directory. Running make will produce the docset in that
# directory and running "make install" will install the docset in
# ~/Library/Developer/Shared/Documentation/DocSets so that Xcode will find
# it at startup.
# See http://developer.apple.com/tools/creatingdocsetswithdoxygen.html
# for more information.
 
GENERATE_DOCSET = NO
 
# When GENERATE_DOCSET tag is set to YES, this tag determines the name of the
# feed. A documentation feed provides an umbrella under which multiple
# documentation sets from a single provider (such as a company or product suite)
# can be grouped.
 
DOCSET_FEEDNAME = "Doxygen generated docs"
 
# When GENERATE_DOCSET tag is set to YES, this tag specifies a string that
# should uniquely identify the documentation set bundle. This should be a
# reverse domain-name style string, e.g. com.mycompany.MyDocSet. Doxygen
# will append .docset to the name.
 
DOCSET_BUNDLE_ID = org.doxygen.Project
 
# When GENERATE_PUBLISHER_ID tag specifies a string that should uniquely identify
# the documentation publisher. This should be a reverse domain-name style
# string, e.g. com.mycompany.MyDocSet.documentation.
 
DOCSET_PUBLISHER_ID = org.doxygen.Publisher
 
# The GENERATE_PUBLISHER_NAME tag identifies the documentation publisher.
 
DOCSET_PUBLISHER_NAME = Publisher
 
# 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 compiled 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 CHM_INDEX_ENCODING
# is used to encode HtmlHelp index (hhk), content (hhc) and project file
# content.
 
CHM_INDEX_ENCODING =
 
# 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
 
# If the GENERATE_QHP tag is set to YES and both QHP_NAMESPACE and
# QHP_VIRTUAL_FOLDER are set, an additional index file will be generated
# that can be used as input for Qt's qhelpgenerator to generate a
# Qt Compressed Help (.qch) of the generated HTML documentation.
 
GENERATE_QHP = NO
 
# If the QHG_LOCATION tag is specified, the QCH_FILE tag can
# be used to specify the file name of the resulting .qch file.
# The path specified is relative to the HTML output folder.
 
QCH_FILE =
 
# The QHP_NAMESPACE tag specifies the namespace to use when generating
# Qt Help Project output. For more information please see
# http://doc.trolltech.com/qthelpproject.html#namespace
 
QHP_NAMESPACE = org.doxygen.Project
 
# The QHP_VIRTUAL_FOLDER tag specifies the namespace to use when generating
# Qt Help Project output. For more information please see
# http://doc.trolltech.com/qthelpproject.html#virtual-folders
 
QHP_VIRTUAL_FOLDER = doc
 
# If QHP_CUST_FILTER_NAME is set, it specifies the name of a custom filter to
# add. For more information please see
# http://doc.trolltech.com/qthelpproject.html#custom-filters
 
QHP_CUST_FILTER_NAME =
 
# The QHP_CUST_FILT_ATTRS tag specifies the list of the attributes of the
# custom filter to add. For more information please see
# <a href="http://doc.trolltech.com/qthelpproject.html#custom-filters">
# Qt Help Project / Custom Filters</a>.
 
QHP_CUST_FILTER_ATTRS =
 
# The QHP_SECT_FILTER_ATTRS tag specifies the list of the attributes this
# project's
# filter section matches.
# <a href="http://doc.trolltech.com/qthelpproject.html#filter-attributes">
# Qt Help Project / Filter Attributes</a>.
 
QHP_SECT_FILTER_ATTRS =
 
# If the GENERATE_QHP tag is set to YES, the QHG_LOCATION tag can
# be used to specify the location of Qt's qhelpgenerator.
# If non-empty doxygen will try to run qhelpgenerator on the generated
# .qhp file.
 
QHG_LOCATION =
 
# If the GENERATE_ECLIPSEHELP tag is set to YES, additional index files
# will be generated, which together with the HTML files, form an Eclipse help
# plugin. To install this plugin and make it available under the help contents
# menu in Eclipse, the contents of the directory containing the HTML and XML
# files needs to be copied into the plugins directory of eclipse. The name of
# the directory within the plugins directory should be the same as
# the ECLIPSE_DOC_ID value. After copying Eclipse needs to be restarted before
# the help appears.
 
GENERATE_ECLIPSEHELP = NO
 
# A unique identifier for the eclipse help plugin. When installing the plugin
# the directory name containing the HTML and XML files should also have
# this name.
 
ECLIPSE_DOC_ID = org.doxygen.Project
 
# The DISABLE_INDEX tag can be used to turn on/off the condensed index (tabs)
# at top of each HTML page. The value NO (the default) enables the index and
# the value YES disables it. Since the tabs have the same information as the
# navigation tree you can set this option to NO if you already set
# GENERATE_TREEVIEW to YES.
 
DISABLE_INDEX = NO
 
# The GENERATE_TREEVIEW tag is used to specify whether a tree-like index
# structure should be generated to display hierarchical information.
# If the tag value 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 (i.e. any modern browser).
# Windows users are probably better off using the HTML help feature.
# Since the tree basically has the same information as the tab index you
# could consider to set DISABLE_INDEX to NO when enabling this option.
 
GENERATE_TREEVIEW = YES
 
# The ENUM_VALUES_PER_LINE tag can be used to set the number of enum values
# (range [0,1..20]) that doxygen will group on one line in the generated HTML
# documentation. Note that a value of 0 will completely suppress the enum
# values from appearing in the overview section.
 
ENUM_VALUES_PER_LINE = 4
 
# By enabling USE_INLINE_TREES, doxygen will generate the Groups, Directories,
# and Class Hierarchy pages using a tree view instead of an ordered list.
 
USE_INLINE_TREES = 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
 
# When the EXT_LINKS_IN_WINDOW option is set to YES doxygen will open
# links to external symbols imported via tag files in a separate window.
 
EXT_LINKS_IN_WINDOW = NO
 
# Use this tag to change the font size of Latex formulas included
# as images in the HTML documentation. The default is 10. Note that
# when you change the font size after a successful doxygen run you need
# to manually remove any form_*.png images from the HTML output directory
# to force them to be regenerated.
 
FORMULA_FONTSIZE = 10
 
# Use the FORMULA_TRANPARENT tag to determine whether or not the images
# generated for formulas are transparent PNGs. Transparent PNGs are
# not supported properly for IE 6.0, but are supported on all modern browsers.
# Note that when changing this option you need to delete any form_*.png files
# in the HTML output before the changes have effect.
 
FORMULA_TRANSPARENT = YES
 
# Enable the USE_MATHJAX option to render LaTeX formulas using MathJax
# (see http://www.mathjax.org) which uses client side Javascript for the
# rendering instead of using prerendered bitmaps. Use this if you do not
# have LaTeX installed or if you want to formulas look prettier in the HTML
# output. When enabled you also need to install MathJax separately and
# configure the path to it using the MATHJAX_RELPATH option.
 
USE_MATHJAX = NO
 
# When MathJax is enabled you need to specify the location relative to the
# HTML output directory using the MATHJAX_RELPATH option. The destination
# directory should contain the MathJax.js script. For instance, if the mathjax
# directory is located at the same level as the HTML output directory, then
# MATHJAX_RELPATH should be ../mathjax. The default value points to the
# mathjax.org site, so you can quickly see the result without installing
# MathJax, but it is strongly recommended to install a local copy of MathJax
# before deployment.
 
MATHJAX_RELPATH = http://www.mathjax.org/mathjax
 
# The MATHJAX_EXTENSIONS tag can be used to specify one or MathJax extension
# names that should be enabled during MathJax rendering.
 
MATHJAX_EXTENSIONS =
 
# When the SEARCHENGINE tag is enabled doxygen will generate a search box
# for the HTML output. The underlying search engine uses javascript
# and DHTML and should work on any modern browser. Note that when using
# HTML help (GENERATE_HTMLHELP), Qt help (GENERATE_QHP), or docsets
# (GENERATE_DOCSET) there is already a search function so this one should
# typically be disabled. For large projects the javascript based search engine
# can be slow, then enabling SERVER_BASED_SEARCH may provide a better solution.
 
SEARCHENGINE = YES
 
# When the SERVER_BASED_SEARCH tag is enabled the search engine will be
# implemented using a PHP enabled web server instead of at the web client
# using Javascript. Doxygen will generate the search PHP script and index
# file to put on the web server. The advantage of the server
# based approach is that it scales better to large projects and allows
# full text search. The disadvantages are that it is more difficult to setup
# and does not have live searching capabilities.
 
SERVER_BASED_SEARCH = NO
 
#---------------------------------------------------------------------------
# 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.
# Note that when enabling USE_PDFLATEX this option is only used for
# generating bitmaps for formulas in the HTML output, but not in the
# Makefile that is written to the output directory.
 
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, letter, legal and
# executive. If left blank a4wide will be used.
 
PAPER_TYPE = a4
 
# 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 =
 
# The LATEX_FOOTER tag can be used to specify a personal LaTeX footer for
# the generated latex document. The footer should contain everything after
# the last chapter. If it is left blank doxygen will generate a
# standard footer. Notice: only use this tag if you know what you are doing!
 
LATEX_FOOTER =
 
# 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 = YES
 
# 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 = YES
 
# 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
 
# If LATEX_SOURCE_CODE is set to YES then doxygen will include
# source code with syntax highlighting in the LaTeX output.
# Note that which sources are shown also depends on other settings
# such as SOURCE_BROWSER.
 
LATEX_SOURCE_CODE = NO
 
# The LATEX_BIB_STYLE tag can be used to specify the style to use for the
# bibliography, e.g. plainnat, or ieeetr. The default style is "plain". See
# http://en.wikipedia.org/wiki/BibTeX for more info.
 
LATEX_BIB_STYLE = plain
 
#---------------------------------------------------------------------------
# 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 style sheet 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_DEFINED tags.
 
EXPAND_ONLY_PREDEF = NO
 
# If the SEARCH_INCLUDES tag is set to YES (the default) the includes files
# pointed to by INCLUDE_PATH will be searched when 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. To prevent a macro definition from being
# undefined via #undef or recursively expanded use the := operator
# instead of the = operator.
 
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 that
# overrules the definition found in the source code.
 
EXPAND_AS_DEFINED =
 
# If the SKIP_FUNCTION_MACROS tag is set to YES (the default) then
# doxygen's preprocessor will remove all references to function-like macros
# that are alone on a line, have an all uppercase name, and do not end with a
# semicolon, because these 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 also works with HAVE_DOT disabled, but it is recommended to
# install and use dot, since it yields more powerful graphs.
 
CLASS_DIAGRAMS = NO
 
# You can define message sequence charts within doxygen comments using the \msc
# command. Doxygen will then run the mscgen tool (see
# http://www.mcternan.me.uk/mscgen/) to produce the chart and insert it in the
# documentation. The MSCGEN_PATH tag allows you to specify the directory where
# the mscgen tool resides. If left empty the tool is assumed to be found in the
# default search path.
 
MSCGEN_PATH =
 
# 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 = YES
 
# The DOT_NUM_THREADS specifies the number of dot invocations doxygen is
# allowed to run in parallel. When set to 0 (the default) doxygen will
# base this on the number of processors available in the system. You can set it
# explicitly to a value larger than 0 to get control over the balance
# between CPU load and processing speed.
 
DOT_NUM_THREADS = 0
 
# By default doxygen will use the Helvetica font for all dot files that
# doxygen generates. When you want a differently looking font you can specify
# the font name using DOT_FONTNAME. You need to make sure dot is able to find
# the font, which can be done by putting it in a standard location or by setting
# the DOTFONTPATH environment variable or by setting DOT_FONTPATH to the
# directory containing the font.
 
DOT_FONTNAME = Helvetica
 
# The DOT_FONTSIZE tag can be used to set the size of the font of dot graphs.
# The default size is 10pt.
 
DOT_FONTSIZE = 10
 
# By default doxygen will tell dot to use the Helvetica font.
# If you specify a different font using DOT_FONTNAME you can use DOT_FONTPATH to
# set the path where dot can find it.
 
DOT_FONTPATH =
 
# 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
# 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 GROUP_GRAPHS and HAVE_DOT tags are set to YES then doxygen
# will generate a graph for groups, showing the direct groups dependencies
 
GROUP_GRAPHS = 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 options 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 = YES
 
# If the CALLER_GRAPH and HAVE_DOT tags are set to YES then
# doxygen will generate a caller 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 caller
# graphs for selected functions only using the \callergraph command.
 
CALLER_GRAPH = YES
 
# If the GRAPHICAL_HIERARCHY and HAVE_DOT tags are set to YES then doxygen
# will generate a graphical hierarchy of all classes instead of a textual one.
 
GRAPHICAL_HIERARCHY = YES
 
# If the DIRECTORY_GRAPH, SHOW_DIRECTORIES and HAVE_DOT tags are set to YES
# then doxygen will show the dependencies a directory has on other directories
# in a graphical way. The dependency relations are determined by the #include
# relations between the files in the directories.
 
DIRECTORY_GRAPH = YES
 
# The DOT_IMAGE_FORMAT tag can be used to set the image format of the images
# generated by dot. Possible values are svg, png, jpg, or gif.
# If left blank png will be used. If you choose svg you need to set
# HTML_FILE_EXTENSION to xhtml in order to make the SVG files
# visible in IE 9+ (other browsers do not have this requirement).
 
DOT_IMAGE_FORMAT = png
 
# If DOT_IMAGE_FORMAT is set to svg, then this option can be set to YES to
# enable generation of interactive SVG images that allow zooming and panning.
# Note that this requires a modern browser other than Internet Explorer.
# Tested and working are Firefox, Chrome, Safari, and Opera. For IE 9+ you
# need to set HTML_FILE_EXTENSION to xhtml in order to make the SVG files
# visible. Older versions of IE do not have SVG support.
 
INTERACTIVE_SVG = NO
 
# 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 in 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 MSCFILE_DIRS tag can be used to specify one or more directories that
# contain msc files that are included in the documentation (see the
# \mscfile command).
 
MSCFILE_DIRS =
 
# The DOT_GRAPH_MAX_NODES tag can be used to set the maximum number of
# nodes that will be shown in the graph. If the number of nodes in a graph
# becomes larger than this value, doxygen will truncate the graph, which is
# visualized by representing a node as a red box. Note that doxygen if the
# number of direct children of the root node in a graph is already larger than
# DOT_GRAPH_MAX_NODES then the graph will not be shown at all. Also note
# that the size of a graph can be further restricted by MAX_DOT_GRAPH_DEPTH.
 
DOT_GRAPH_MAX_NODES = 50
 
# 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 the size of a graph can be further restricted by
# DOT_GRAPH_MAX_NODES. Using a depth of 0 means no depth restriction.
 
MAX_DOT_GRAPH_DEPTH = 0
 
# Set the DOT_TRANSPARENT tag to YES to generate images with a transparent
# background. This is disabled by default, because dot on Windows does not
# seem to support this out of the box. Warning: Depending on the platform used,
# enabling this option may lead to badly anti-aliased labels on the edges of
# a graph (i.e. they become hard to read).
 
DOT_TRANSPARENT = NO
 
# Set the DOT_MULTI_TARGETS tag to YES allow dot to generate multiple output
# files in one run (i.e. multiple -o and -T options on the command line). This
# makes dot run faster, but since only newer versions of dot (>1.8.10)
# support this, this feature is disabled by default.
 
DOT_MULTI_TARGETS = NO
 
# 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
/trunk/libraries/max7219/demo/max7219__demo.c
0,0 → 1,75
/**************************************************************************//**
* \brief USART library - Demonstration program
* \author Copyright (C) 2011 Julien Le Sech - www.idreammicro.com
* \version 1.0
* \date 20090314
*
* This file is part of the iDreamMicro library.
*
* This library is free software: you can redistribute it and/or modify it under
* the terms of the GNU Lesser General Public License as published by the Free
* Software Foundation, either version 3 of the License, or (at your option) any
* later version.
*
* This library is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
* FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more
* details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with this program. If not, see http://www.gnu.org/licenses/
******************************************************************************/
 
/**************************************************************************//**
* \file demo_max7219.c
******************************************************************************/
 
/******************************************************************************
* Header file inclusions.
******************************************************************************/
 
#include <max7219/max7219.h>
 
#include <util/delay.h>
 
#include <stdbool.h>
#include <stdlib.h>
 
/******************************************************************************
* Main function.
******************************************************************************/
 
/**************************************************************************//**
* \fn int main(void)
*
* \brief Main function.
******************************************************************************/
int
main
(
void
){
// Initialize and configure MAX7219.
max7219__initialize();
max7219__set_scan_limit(max7219__scan_limit__digit_0_to_7);
max7219__set_intensity(max7219__intensity__level_15);
max7219__set_decode_mode(max7219__decode_mode__all_digits);
 
// Switch on MAX7219 display.
max7219__set_shutdown_mode(max7219__shutdown_mode__normal_operation);
 
// Write values on digits.
 
max7219__write_char_on_digit(max7219__digit__0, max7219__character__zero, false);
max7219__write_char_on_digit(max7219__digit__1, max7219__character__one, true);
max7219__write_char_on_digit(max7219__digit__2, max7219__character__two, false);
max7219__write_char_on_digit(max7219__digit__3, max7219__character__three, true);
max7219__write_char_on_digit(max7219__digit__4, max7219__character__four, false);
max7219__write_char_on_digit(max7219__digit__5, max7219__character__five, true);
max7219__write_char_on_digit(max7219__digit__6, max7219__character__six, false);
max7219__write_char_on_digit(max7219__digit__7, max7219__character__seven, true);
 
for (;;);
 
return 0;
}
/trunk/libraries/max7219/src/SConscript
0,0 → 1,13
# Import environment set for target.
Import('env_target')
 
# Define target name.
TARGET = 'max7219'
 
# Define source files.
sources = [
'max7219.c'
]
 
# Build library.
env_target.BuildLibrary(sources, TARGET)
/trunk/libraries/max7219/src/max7219.c
0,0 → 1,269
/**************************************************************************//**
* \brief MAX7219 library
* \author Copyright (C) 2011 Julien Le Sech - www.idreammicro.com
* \version 1.0
* \date 20110908
*
* This file is part of the iDreamMicro library.
*
* This library is free software: you can redistribute it and/or modify it under
* the terms of the GNU Lesser General Public License as published by the Free
* Software Foundation, either version 3 of the License, or (at your option) any
* later version.
*
* This library is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
* FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more
* details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with this program. If not, see http://www.gnu.org/licenses/
******************************************************************************/
 
/**************************************************************************//**
* \file max7219.c
******************************************************************************/
 
/******************************************************************************
* Header file inclusions.
******************************************************************************/
 
#include "../max7219.h"
 
#include <digital_io/digital_io.h>
#include <spi/spi.h>
 
#include <util/delay.h>
 
#include <stdbool.h>
#include <stdint.h>
 
/******************************************************************************
* Private macros.
******************************************************************************/
 
#define REG_NO_OP 0x00
#define REG_DIGIT_0 0x01
#define REG_DIGIT_1 0x02
#define REG_DIGIT_2 0x03
#define REG_DIGIT_3 0x04
#define REG_DIGIT_4 0x05
#define REG_DIGIT_5 0x06
#define REG_DIGIT_6 0x07
#define REG_DIGIT_7 0x08
#define REG_DECODE_MODE 0x09
#define REG_INTENSITY 0x0A
#define REG_SCAN_LIMIT 0x0B
#define REG_SHUTDOWN 0x0C
#define REG_DISPLAY_TEST 0x0F
 
/******************************************************************************
* Private constants.
******************************************************************************/
 
static const digital_io__pin_position_t chip_select_pin =
DIGITAL_IO__PORT_B | DIGITAL_IO__PIN_2;
 
/******************************************************************************
* Private function prototypes.
******************************************************************************/
 
/**************************************************************************//**
* \fn void max7219__write(uint8_t address, uin8_t value)
*
* \brief Write value into MAX7219 register.
*
* \param address Register address.
* \param value Value to write.
******************************************************************************/
void
max7219__write
(
uint8_t address,
uint8_t value
);
 
/******************************************************************************
* Public function definitions.
******************************************************************************/
 
/**************************************************************************//**
* \fn void max7219__initialize(void)
*
* \brief Initialize SPI to drive MAX7219.
******************************************************************************/
void
max7219__initialize
(
void
){
// Configure chip select pin as output.
digital_io__configure_pin(chip_select_pin, DIGITAL_IO__DIRECTION__OUTPUT);
digital_io__set_pin_level(chip_select_pin, DIGITAL_IO__LEVEL__HIGH);
// Wait a little to allow MAX7219 to see a correct logic level on CS pin.
_delay_ms(2);
// Configure SPI.
spi_master__initialize();
spi__set_data_order(SPI__DATA_ORDER__MSB_FIRST);
spi__set_data_mode(SPI__DATA_MODE_0);
spi__set_clock_rate(SPI__CLOCK_RATE__FOSC_OVER_4);
}
 
/**************************************************************************//**
* \fn void max7219__set_decode_mode(max7219__decode_mode_t mode)
*
* \brief Set MAX7219 decode mode.
*
* \param mode Decode mode to set.
******************************************************************************/
void
max7219__set_decode_mode
(
max7219__decode_mode_t mode
){
max7219__write(REG_DECODE_MODE, mode);
}
 
/**************************************************************************//**
* \fn void max7219__set_intensity(max7219__intensity_t intensity)
*
* \brief Set MAX7219 intensity.
*
* \param intensity Intensity to set.
******************************************************************************/
void
max7219__set_intensity
(
max7219__intensity_t intensity
){
max7219__write(REG_INTENSITY, intensity);
}
 
/**************************************************************************//**
* \fn void max7219__set_scan_limit(max7219__scan_limit_t limit)
*
* \brief Set MAX7219 scan limit.
*
* \param limit Scan limit to set.
******************************************************************************/
void
max7219__set_scan_limit
(
max7219__scan_limit_t limit
){
max7219__write(REG_SCAN_LIMIT, limit);
}
 
/**************************************************************************//**
* \fn void max7219__set_shutdown_mode(max7219__shutdown_mode_t mode)
*
* \brief Set MAX7219 shutdown mode.
*
* \param mode Shutdown mode to set.
******************************************************************************/
void
max7219__set_shutdown_mode
(
max7219__shutdown_mode_t mode
){
max7219__write(REG_SHUTDOWN, mode);
}
 
/**************************************************************************//**
* \fn void max7219__set_display_test_mode(max7219__display_test_mode_t mode)
*
* \brief Set MAX7219 display test mode.
*
* \param mode Display test mode to set.
*****************************************************************************/
void
max7219__set_display_test_mode
(
max7219__display_test_mode_t mode
){
max7219__write(REG_DISPLAY_TEST, mode);
}
 
/**************************************************************************//**
* \fn void max7219__write_char_on_digit(
* max7219__digit_t digit,
* max7219__character_t character,
* bool decimal_point)
*
* \brief Write character on digit.
*
* \param digit Digit to write.
* \param character Character to write.
* \param decimal_point Display decimal point.
******************************************************************************/
void
max7219__write_char_on_digit
(
max7219__digit_t digit,
max7219__character_t character,
bool decimal_point
){
uint8_t value = character;
if (decimal_point)
{
// If decimal point must be switched on.
value |= max7219__segment__DP;
}
max7219__write(digit, value);
}
 
/**************************************************************************//**
* \fn void max7219__write_segments_on_digit(
* max7219__digit_t digit,
* max7219__segment_t segments)
*
* \brief Set segment(s) on digit.
*
* \param digit Digit to write.
* \param segment Segment(s) to set.
******************************************************************************/
void
max7219__write_segments_on_digit
(
max7219__digit_t digit,
max7219__segment_t segments
){
max7219__write(digit, segments);
}
 
/******************************************************************************
* Private function definitions.
******************************************************************************/
 
/**************************************************************************//**
* \fn void max7219__write(uint8_t address, uint8_t value)
*
* \brief Write value into MAX7219 register.
*
* \param address Register address.
* \param value Value to write.
******************************************************************************/
void
max7219__write
(
uint8_t address,
uint8_t value
){
// Reset chip select pin to select the device.
digital_io__set_pin_level(chip_select_pin, DIGITAL_IO__LEVEL__LOW);
 
// tcss
_delay_ms(1);
 
// Transmit data to the device, register address and value.
spi_master__transmit(address);
spi_master__transmit(value);
 
// Set chip select pin to valid data onto the device.
digital_io__set_pin_level(chip_select_pin, DIGITAL_IO__LEVEL__HIGH);
 
// tcsw
_delay_ms(1);
}
/trunk/libraries/max7219/SConscript
0,0 → 1,16
# Import environment set for target.
Import('env_target')
 
# Define directories to process.
directories = [
'src/'
]
 
# Process directories.
for directory in directories:
SConscript(
directory + 'SConscript',
variant_dir = '#build/' + '/libraries/max7219/' + env_target['NAME'],
exports = { 'env_target' : env_target },
duplicate = 0
)
/trunk/libraries/max7219/max7219.h
0,0 → 1,299
/**************************************************************************//**
* \brief MAX7219 library
* \author Copyright (C) 2011 Julien Le Sech - www.idreammicro.com
* \version 1.0
* \date 20110908
*
* This file is part of the iDreamMicro library.
*
* This library is free software: you can redistribute it and/or modify it under
* the terms of the GNU Lesser General Public License as published by the Free
* Software Foundation, either version 3 of the License, or (at your option) any
* later version.
*
* This library is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
* FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more
* details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with this program. If not, see http://www.gnu.org/licenses/
******************************************************************************/
 
/**************************************************************************//**
* \headerfile max7219.h
******************************************************************************/
#ifndef H__IDREAMMICRO__MAX7219__H
#define H__IDREAMMICRO__MAX7219__H
 
#ifdef _cplusplus
extern "C"{
#endif
 
/******************************************************************************
* Header file inclusions.
******************************************************************************/
 
#include <stdbool.h>
 
/******************************************************************************
* Public types.
******************************************************************************/
 
/**************************************************************************//**
* \enum max7219__decode_modes
* \typedef max7219__decode_mode_t
******************************************************************************/
typedef enum max7219__decode_modes
{
max7219__decode_mode__none = 0x00,
max7219__decode_mode__digit_0 = 0x01,
max7219__decode_mode__digit_1 = 0x02,
max7219__decode_mode__digit_2 = 0x04,
max7219__decode_mode__digit_3 = 0x08,
max7219__decode_mode__digit_4 = 0x10,
max7219__decode_mode__digit_5 = 0x20,
max7219__decode_mode__digit_6 = 0x40,
max7219__decode_mode__digit_7 = 0x80,
max7219__decode_mode__all_digits = 0xFF
} max7219__decode_mode_t;
 
/**************************************************************************//**
* \enum max7219__intensities
* \typedef max7219__intensity_t
******************************************************************************/
typedef enum max7219__intensities
{
max7219__intensity__level_0 = 0x00,
max7219__intensity__level_1 = 0x01,
max7219__intensity__level_2 = 0x02,
max7219__intensity__level_3 = 0x03,
max7219__intensity__level_4 = 0x04,
max7219__intensity__level_5 = 0x05,
max7219__intensity__level_6 = 0x06,
max7219__intensity__level_7 = 0x07,
max7219__intensity__level_8 = 0x08,
max7219__intensity__level_9 = 0x09,
max7219__intensity__level_10 = 0x0A,
max7219__intensity__level_11 = 0x0B,
max7219__intensity__level_12 = 0x0C,
max7219__intensity__level_13 = 0x0D,
max7219__intensity__level_14 = 0x0E,
max7219__intensity__level_15 = 0x0F
} max7219__intensity_t;
 
/**************************************************************************//**
* \enum max7219__scan_limits
* \typedef max7219__scan_limit_t
******************************************************************************/
typedef enum max7219__scan_limits
{
max7219__scan_limit__digit_0 = 0x00,
max7219__scan_limit__digit_0_to_1 = 0x01,
max7219__scan_limit__digit_0_to_2 = 0x02,
max7219__scan_limit__digit_0_to_3 = 0x03,
max7219__scan_limit__digit_0_to_4 = 0x04,
max7219__scan_limit__digit_0_to_5 = 0x05,
max7219__scan_limit__digit_0_to_6 = 0x06,
max7219__scan_limit__digit_0_to_7 = 0x07
} max7219__scan_limit_t;
 
/**************************************************************************//**
* \enum max7219__shutdown_modes
* \typedef max7219__shutdown_mode_t
******************************************************************************/
typedef enum max7219__shutdown_modes
{
max7219__shutdown_mode__shutdown = 0x00,
max7219__shutdown_mode__normal_operation = 0x01
} max7219__shutdown_mode_t;
 
/**************************************************************************//**
* \enum max7219__display_test_modes
* \typedef max7219__display_test_mode_t
******************************************************************************/
typedef enum max7219__display_test_modes
{
max7219__display_test_mode__normal_operation = 0x00,
max7219__display_test_mode__test_mode = 0x01
} max7219__display_test_mode_t;
 
/**************************************************************************//**
* \enum max7219__digits
* \typedef max7219__digit_t
******************************************************************************/
typedef enum max7219__digits
{
max7219__digit__0 = 0x01,
max7219__digit__1 = 0x02,
max7219__digit__2 = 0x03,
max7219__digit__3 = 0x04,
max7219__digit__4 = 0x05,
max7219__digit__5 = 0x06,
max7219__digit__6 = 0x07,
max7219__digit__7 = 0x08
} max7219__digit_t;
 
/**************************************************************************//**
* \enum max7219__characters
* \typedef max7219__character_t
******************************************************************************/
typedef enum max7219__characters
{
max7219__character__zero = 0x00,
max7219__character__one = 0x01,
max7219__character__two = 0x02,
max7219__character__three = 0x03,
max7219__character__four = 0x04,
max7219__character__five = 0x05,
max7219__character__six = 0x06,
max7219__character__seven = 0x07,
max7219__character__eight = 0x08,
max7219__character__nine = 0x09,
max7219__character__dash = 0x0A,
max7219__character__e = 0x0B,
max7219__character__h = 0x0C,
max7219__character__l = 0x0D,
max7219__character__p = 0x0E,
max7219__character__blank = 0x0F
} max7219__character_t;
 
/**************************************************************************//**
* \enum max7219__segments
* \typedef max7219__segment_t
******************************************************************************/
typedef enum max7219__segments
{
max7219__segment__DP = 0x80,
max7219__segment__A = 0x40,
max7219__segment__B = 0x20,
max7219__segment__C = 0x10,
max7219__segment__D = 0x08,
max7219__segment__E = 0x04,
max7219__segment__F = 0x02,
max7219__segment__G = 0x01
} max7219__segment_t;
 
/******************************************************************************
* Public function prototypes.
******************************************************************************/
 
/**************************************************************************//**
* \fn void max7219__initialize(void)
*
* \brief Initialize SPI to drive MAX7219.
******************************************************************************/
void
max7219__initialize
(
void
);
 
/**************************************************************************//**
* \fn void max7219__set_decode_mode(max7219__decode_mode_t mode)
*
* \brief Set MAX7219 decode mode.
*
* \param mode Decode mode to set.
******************************************************************************/
void
max7219__set_decode_mode
(
max7219__decode_mode_t mode
);
 
/**************************************************************************//**
* \fn void max7219__set_intensity(max7219__intensity_t intensity)
*
* \brief Set MAX7219 intensity.
*
* \param itensity Intensity to set.
******************************************************************************/
void
max7219__set_intensity
(
max7219__intensity_t intensity
);
 
/**************************************************************************//**
* \fn void max7219__set_scan_limit(max7219__scan_limit_t limit)
*
* \brief Set MAX7219 scan limit.
*
* \param limit Scan limit to set.
******************************************************************************/
void
max7219__set_scan_limit
(
max7219__scan_limit_t limit
);
 
/**************************************************************************//**
* \fn void max7219__set_shutdown_mode(max7219__shutdown_mode_t mode)
*
* \brief Set MAX7219 shutdown mode.
*
* \param mode Shutdown mode to set.
******************************************************************************/
void
max7219__set_shutdown_mode
(
max7219__shutdown_mode_t mode
);
 
/**************************************************************************//**
* \fn void max7219__set_display_test_mode(max7219__display_test_mode_t mode)
*
* \brief Set MAX7219 display test mode.
*
* \param mode Display test mode to set.
*****************************************************************************/
void
max7219__set_display_test_mode
(
max7219__display_test_mode_t mode
);
 
/**************************************************************************//**
* \fn void max7219__write_char_on_digit(
* max7219__digit_t digit,
* max7219__character_t character,
* bool decimal_point)
*
* \brief Write character on digit.
*
* \param digit Digit to write.
* \param character Character to write.
* \param decimal_point Display decimal point.
******************************************************************************/
void
max7219__write_char_on_digit
(
max7219__digit_t digit,
max7219__character_t character,
bool decimal_point
);
 
/**************************************************************************//**
* \fn void max7219__write_segments_on_digit(
* max7219__digit_t digit,
* max7219__segment_t segments)
*
* \brief Set segment(s) on digit.
*
* \param digit Digit to write.
* \param segment Segment(s) to set.
******************************************************************************/
void
max7219__write_segments_on_digit
(
max7219__digit_t digit,
max7219__segment_t segment
);
 
#ifdef _cplusplus
}
#endif
 
#endif /* H__IDREAMMICRO__MAX7219__H */
/trunk/libraries/spi/spi.h
0,0 → 1,174
/**************************************************************************//**
* \brief SPI library
* \author Copyright (C) 2011 Julien Le Sech - www.idreammicro.com
* \version 1.0
* \date 20110315
*
* This file is part of the iDreamMicro library.
*
* This library is free software: you can redistribute it and/or modify it under
* the terms of the GNU Lesser General Public License as published by the Free
* Software Foundation, either version 3 of the License, or (at your option) any
* later version.
*
* This library is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
* FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more
* details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with this program. If not, see http://www.gnu.org/licenses/
******************************************************************************/
 
/**************************************************************************//**
* \headerfile spi.h
******************************************************************************/
#ifndef H__IDREAMMICRO__SPI__H
#define H__IDREAMMICRO__SPI__H
 
#ifdef _cplusplus
extern "C"{
#endif
 
/******************************************************************************
* Header file inclusions.
******************************************************************************/
 
#include <stdint.h>
 
/******************************************************************************
* Public types.
******************************************************************************/
 
/**************************************************************************//**
*
******************************************************************************/
typedef enum spi__clock_rates
{
SPI__CLOCK_RATE__FOSC_OVER_2,
SPI__CLOCK_RATE__FOSC_OVER_4,
SPI__CLOCK_RATE__FOSC_OVER_8,
SPI__CLOCK_RATE__FOSC_OVER_16,
SPI__CLOCK_RATE__FOSC_OVER_32,
SPI__CLOCK_RATE__FOSC_OVER_64,
SPI__CLOCK_RATE__FOSC_OVER_128
} spi__clock_rate_t;
 
/**************************************************************************//**
*
******************************************************************************/
typedef enum spi__data_modes
{
SPI__DATA_MODE_0,
SPI__DATA_MODE_1,
SPI__DATA_MODE_2,
SPI__DATA_MODE_3
} spi__data_mode_t;
 
/**************************************************************************//**
*
******************************************************************************/
typedef enum spi__data_orders
{
SPI__DATA_ORDER__MSB_FIRST,
SPI__DATA_ORDER__LSB_FIRST
} spi__data_order_t;
 
/******************************************************************************
* Public function prototypes.
******************************************************************************/
 
/**************************************************************************//**
* \fn void spi_master__initialize(void)
*
* \brief Initialize SPI in master mode.
******************************************************************************/
void
spi_master__initialize
(
void
);
 
/**************************************************************************//**
* \fn void spi_master__transmit(uint8_t data)
*
* \brief Transmit data.
*
* \param data Data to transmit.
******************************************************************************/
void
spi_master__transmit
(
uint8_t data
);
 
/**************************************************************************//**
* \fn void spi_slave__initialize(void)
*
* \brief Initialize SPI in slave mode.
******************************************************************************/
void
spi_slave__initialize
(
void
);
 
/**************************************************************************//**
* \fn uint8_t spi_slave__receive(void)
*
* \brief Receive data.
*
* \return Received data.
******************************************************************************/
uint8_t
spi_slave__receive
(
void
);
 
/**************************************************************************//**
* \fn void spi__set_clock_rate(spi__clock_rate_t clock_rate)
*
* \brief Set clock rate.
*
* \param[in] clock_rate Clock rate to set.
******************************************************************************/
void
spi__set_clock_rate
(
spi__clock_rate_t clock_rate
);
 
/**************************************************************************//**
* \fn void spi__set_data_mode(spi__data_mode_t mode)
*
* \brief Set SPI data mode.
*
* \param[in] mode Data mode to set.
******************************************************************************/
void
spi__set_data_mode
(
spi__data_mode_t data_mode
);
 
/**************************************************************************//**
* \fn void spi__set_data_order(spi__data_order_t data_order)
*
* \brief Set SPI data order.
*
* \param[in] data_order Data order to set.
******************************************************************************/
void
spi__set_data_order
(
spi__data_order_t data_order
);
 
#ifdef _cplusplus
}
#endif
 
#endif /* H__IDREAMMICRO__SPI__H */
 
/trunk/libraries/spi/include/spi_atmega128.h
0,0 → 1,55
/**************************************************************************//**
* \brief SPI library
* \author Copyright (C) 2011 Julien Le Sech - www.idreammicro.com
* \version 1.0
* \date 20110315
*
* This file is part of the iDreamMicro library.
*
* This library is free software: you can redistribute it and/or modify it under
* the terms of the GNU Lesser General Public License as published by the Free
* Software Foundation, either version 3 of the License, or (at your option) any
* later version.
*
* This library is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
* FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more
* details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with this program. If not, see http://www.gnu.org/licenses/
******************************************************************************/
 
/**************************************************************************//**
* \headerfile spi_atmega128.h
******************************************************************************/
#ifndef H__IDREAMMICRO__SPI_ATMEGA128__H
#define H__IDREAMMICRO__SPI_ATMEGA128__H
 
#ifdef _cplusplus
extern "C"{
#endif
 
/******************************************************************************
* Header file inclusions.
******************************************************************************/
 
#include <avr/io.h>
 
/******************************************************************************
* Public macros.
******************************************************************************/
 
#define DDR_SPI DDRB
#define DD_SS PB0
#define DD_SCK PB1
#define DD_MOSI PB2
#define DD_MISO PB3
 
#ifdef _cplusplus
}
#endif
 
#endif /* H__IDREAMMICRO__SPI_ATMEGA128__H */
 
/trunk/libraries/spi/include/spi_atmega2560.h
0,0 → 1,55
/**************************************************************************//**
* \brief SPI library
* \author Copyright (C) 2011 Julien Le Sech - www.idreammicro.com
* \version 1.0
* \date 20110315
*
* This file is part of the iDreamMicro library.
*
* This library is free software: you can redistribute it and/or modify it under
* the terms of the GNU Lesser General Public License as published by the Free
* Software Foundation, either version 3 of the License, or (at your option) any
* later version.
*
* This library is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
* FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more
* details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with this program. If not, see http://www.gnu.org/licenses/
******************************************************************************/
 
/**************************************************************************//**
* \headerfile spi_atmega2560.h
******************************************************************************/
#ifndef H__IDREAMMICRO__SPI_ATMEGA2560__H
#define H__IDREAMMICRO__SPI_ATMEGA2560__H
 
#ifdef _cplusplus
extern "C"{
#endif
 
/******************************************************************************
* Header file inclusions.
******************************************************************************/
 
#include <avr/io.h>
 
/******************************************************************************
* Public macros.
******************************************************************************/
 
#define DDR_SPI DDRB
#define DD_SS PB0
#define DD_SCK PB1
#define DD_MOSI PB2
#define DD_MISO PB3
 
#ifdef _cplusplus
}
#endif
 
#endif /* H__IDREAMMICRO__SPI_ATMEGA2560__H */
 
/trunk/libraries/spi/include/spi_atmega328.h
0,0 → 1,55
/**************************************************************************//**
* \brief SPI library
* \author Copyright (C) 2011 Julien Le Sech - www.idreammicro.com
* \version 1.0
* \date 20110315
*
* This file is part of the iDreamMicro library.
*
* This library is free software: you can redistribute it and/or modify it under
* the terms of the GNU Lesser General Public License as published by the Free
* Software Foundation, either version 3 of the License, or (at your option) any
* later version.
*
* This library is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
* FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more
* details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with this program. If not, see http://www.gnu.org/licenses/
******************************************************************************/
 
/**************************************************************************//**
* \headerfile spi_atmega328.h
******************************************************************************/
#ifndef H__IDREAMMICRO__SPI_ATMEGA328__H
#define H__IDREAMMICRO__SPI_ATMEGA328__H
 
#ifdef _cplusplus
extern "C"{
#endif
 
/******************************************************************************
* Header file inclusions.
******************************************************************************/
 
#include <avr/io.h>
 
/******************************************************************************
* Public macros.
******************************************************************************/
 
#define DDR_SPI DDRB
#define DD_SS PB2
#define DD_SCK PB5
#define DD_MOSI PB3
#define DD_MISO PB4
 
#ifdef _cplusplus
}
#endif
 
#endif /* H__IDREAMMICRO__SPI_ATMEGA328__H */
 
/trunk/libraries/spi/src/spi_slave.c
0,0 → 1,85
/**************************************************************************//**
* \brief SPI library
* \author Copyright (C) 2011 Julien Le Sech - www.idreammicro.com
* \version 1.0
* \date 20110315
*
* This file is part of the iDreamMicro library.
*
* This library is free software: you can redistribute it and/or modify it under
* the terms of the GNU Lesser General Public License as published by the Free
* Software Foundation, either version 3 of the License, or (at your option) any
* later version.
*
* This library is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
* FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more
* details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with this program. If not, see http://www.gnu.org/licenses/
******************************************************************************/
 
/**************************************************************************//**
* \file spi_slave.c
******************************************************************************/
 
/******************************************************************************
* Header file inclusions.
******************************************************************************/
 
#include <spi/spi.h>
 
#include <useful/bits.h>
 
#include <avr/io.h>
 
#include <stdint.h>
 
#if defined (__AVR_ATmega128__)
#include "../include/spi_atmega128.h"
#elif defined (__AVR_ATmega328P__) || defined (__AVR_ATmega328__)
#include "../include/spi_atmega328.h"
#elif defined (__AVR_ATmega2560__)
#include "../include/spi_atmega2560.h"
#endif
 
/******************************************************************************
* Public function definitions.
******************************************************************************/
 
/**************************************************************************//**
* \fn void spi_slave__initialize(void)
*
* \brief Initialize SPI in slave mode.
******************************************************************************/
void
spi_slave__initialize
(
void
){
// Configure pins.
DDR_SPI = _BV(DD_MISO);
 
// Enable SPI.
SPCR = _BV(SPE);
}
 
/**************************************************************************//**
* \fn uint8_t spi_slave__receive(void)
*
* \brief Receive data.
*
* \return Received data.
******************************************************************************/
uint8_t
spi_slave__receive
(
void
){
// Wait for previous transmission complete.
while (!(SPSR & (1 << SPIF)));
 
// Read data from SPI data register.
return SPDR;
}
/trunk/libraries/spi/src/SConscript
0,0 → 1,15
# Import environment set for target.
Import('env_target')
 
# Define target name.
TARGET = 'spi'
 
# Define source files.
sources = [
'spi.c',
'spi_master.c',
'spi_slave.c'
]
 
# Build library.
env_target.BuildLibrary(sources, TARGET)
/trunk/libraries/spi/src/spi_master.c
0,0 → 1,85
/**************************************************************************//**
* \brief SPI library
* \author Copyright (C) 2011 Julien Le Sech - www.idreammicro.com
* \version 1.0
* \date 20110315
*
* This file is part of the iDreamMicro library.
*
* This library is free software: you can redistribute it and/or modify it under
* the terms of the GNU Lesser General Public License as published by the Free
* Software Foundation, either version 3 of the License, or (at your option) any
* later version.
*
* This library is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
* FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more
* details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with this program. If not, see http://www.gnu.org/licenses/
******************************************************************************/
 
/**************************************************************************//**
* \file spi_master.c
******************************************************************************/
 
/******************************************************************************
* Header file inclusions.
******************************************************************************/
 
#include <spi/spi.h>
 
#include <useful/bits.h>
 
#include <avr/io.h>
 
#include <stdint.h>
 
#if defined (__AVR_ATmega128__)
#include "../include/spi_atmega128.h"
#elif defined (__AVR_ATmega328P__) || defined (__AVR_ATmega328__)
#include "../include/spi_atmega328.h"
#elif defined (__AVR_ATmega2560__)
#include "../include/spi_atmega2560.h"
#endif
 
/******************************************************************************
* Public function definitions.
******************************************************************************/
 
/**************************************************************************//**
* \fn void spi_master__initialize(void)
*
* \brief Initialize SPI in master mode.
******************************************************************************/
void
spi_master__initialize
(
void
){
// Configure pins.
DDR_SPI |= _BV(DD_MOSI) | _BV(DD_SCK);
 
// Enable SPI and set master mode.
SPCR = _BV(SPE) | _BV(MSTR);
}
 
/**************************************************************************//**
* \fn void spi_master__transmit(uint8_t data)
*
* \brief Transmit data.
*
* \param data Data to transmit.
******************************************************************************/
void
spi_master__transmit
(
uint8_t data
){
// Write data to SPI data register.
SPDR = data;
 
// Wait for transmission complete.
while (!(SPSR & (1 << SPIF)));
}
/trunk/libraries/spi/src/spi.c
0,0 → 1,193
/**************************************************************************//**
* \brief SPI library
* \author Copyright (C) 2011 Julien Le Sech - www.idreammicro.com
* \version 1.0
* \date 20110315
*
* This file is part of the iDreamMicro library.
*
* This library is free software: you can redistribute it and/or modify it under
* the terms of the GNU Lesser General Public License as published by the Free
* Software Foundation, either version 3 of the License, or (at your option) any
* later version.
*
* This library is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
* FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more
* details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with this program. If not, see http://www.gnu.org/licenses/
******************************************************************************/
 
/**************************************************************************//**
* \file spi.c
******************************************************************************/
 
/******************************************************************************
* Header file inclusions.
******************************************************************************/
 
#include <spi/spi.h>
 
#include <useful/bits.h>
 
#include <avr/io.h>
 
#include <stdint.h>
 
#if defined (__AVR_ATmega128__)
#include "../include/spi_atmega128.h"
#elif defined (__AVR_ATmega328P__) || defined (__AVR_ATmega328__)
#include "../include/spi_atmega328.h"
#elif defined (__AVR_ATmega2560__)
#include "../include/spi_atmega2560.h"
#endif
/******************************************************************************
* Public function definitions.
******************************************************************************/
 
/**************************************************************************//**
* \fn void spi__set_clock_rate(spi__clock_rate_t clock_rate)
*
* \brief Set clock rate.
*
* \param[in] clock_rate Clock rate to set.
******************************************************************************/
void
spi__set_clock_rate
(
spi__clock_rate_t clock_rate
){
switch (clock_rate)
{
case SPI__CLOCK_RATE__FOSC_OVER_2:
{
BIT__SET(SPCR, SPI2X);
BIT__RST(SPCR, SPR1);
BIT__RST(SPCR, SPR0);
}
break;
 
case SPI__CLOCK_RATE__FOSC_OVER_4:
{
BIT__RST(SPCR, SPI2X);
BIT__RST(SPCR, SPR1);
BIT__RST(SPCR, SPR0);
}
break;
 
case SPI__CLOCK_RATE__FOSC_OVER_8:
{
BIT__SET(SPCR, SPI2X);
BIT__RST(SPCR, SPR1);
BIT__SET(SPCR, SPR0);
}
break;
 
case SPI__CLOCK_RATE__FOSC_OVER_16:
{
BIT__RST(SPCR, SPI2X);
BIT__RST(SPCR, SPR1);
BIT__SET(SPCR, SPR0);
}
break;
 
case SPI__CLOCK_RATE__FOSC_OVER_32:
{
BIT__SET(SPCR, SPI2X);
BIT__SET(SPCR, SPR1);
BIT__RST(SPCR, SPR0);
}
break;
 
case SPI__CLOCK_RATE__FOSC_OVER_64:
{
BIT__SET(SPCR, SPI2X);
BIT__SET(SPCR, SPR1);
BIT__SET(SPCR, SPR0);
}
break;
 
case SPI__CLOCK_RATE__FOSC_OVER_128:
{
BIT__RST(SPCR, SPI2X);
BIT__SET(SPCR, SPR1);
BIT__SET(SPCR, SPR0);
}
break;
default:
break;
}
}
 
/**************************************************************************//**
* \fn void spi__set_data_mode(spi__data_mode_t mode)
*
* \brief Set SPI data mode.
*
* \param[in] mode Data mode to set.
******************************************************************************/
void
spi__set_data_mode
(
spi__data_mode_t mode
){
switch (mode)
{
case SPI__DATA_MODE_0:
{
BIT__RST(SPCR, CPOL);
BIT__RST(SPCR, CPHA);
}
break;
 
case SPI__DATA_MODE_1:
{
BIT__RST(SPCR, CPOL);
BIT__SET(SPCR, CPHA);
}
break;
 
case SPI__DATA_MODE_2:
{
BIT__SET(SPCR, CPOL);
BIT__RST(SPCR, CPHA);
}
break;
 
case SPI__DATA_MODE_3:
{
BIT__SET(SPCR, CPOL);
BIT__SET(SPCR, CPHA);
}
break;
 
default:
break;
}
}
 
/**************************************************************************//**
* \fn void spi__set_data_order(spi__data_order_t data_order)
*
* \brief Set SPI data order.
*
* \param[in] data_order Data order to set.
******************************************************************************/
void
spi__set_data_order
(
spi__data_order_t data_order
){
if (SPI__DATA_ORDER__LSB_FIRST == data_order)
{
BIT__SET(SPCR, DORD);
}
else
{
BIT__RST(SPCR, DORD);
}
}
/trunk/libraries/spi/SConscript
0,0 → 1,16
# Import environment set for target.
Import('env_target')
 
# Define directories to process.
directories = [
'src/'
]
 
# Process directories.
for directory in directories:
SConscript(
directory + 'SConscript',
variant_dir = '#build/' + '/libraries/spi/' + env_target['NAME'],
exports = { 'env_target' : env_target },
duplicate = 0
)
/trunk/libraries/spi/SConstruct
0,0 → 1,40
# Import build tools.
SConscript('#min_env/build_tools.py')
 
# Set environment for AVR-GCC.
SConscript('#min_env/env_target.py')
 
# Import environment set for AVR-GCC.
Import('env_target')
 
# Append CPPPATH.
env_target.Append(CPPPATH = [ '#../' ])
 
# Build library.
SConscript(
'src/SConscript',
variant_dir = '#build/lib/',
exports = { 'env_target' : env_target },
duplicate = 0
)
 
# Append LIBPATH and LIBS.
env_target.Append(LIBPATH = [ '#build/lib/'])
env_target.Append(LIBS = [ 'spi' ])
 
# Build demonstration program.
SConscript(
'demo/SConscript',
variant_dir = '#build/demo/',
exports = { 'env_target' : env_target },
duplicate = 0
)
 
# Build test program.
SConscript(
'test/SConscript',
variant_dir = '#build/test/',
exports = { 'env_target' : env_target },
duplicate = 0
)
 
/trunk/libraries/spi/min_env/env_target.py
0,0 → 1,27
# Create and initialize the environment.
env_target = Environment()
 
# Set environment for AVR-GCC.
env_target['CC'] = 'avr-gcc'
env_target['CPPPATH'] = '/usr/lib/avr/include'
env_target['OBJCOPY'] = 'avr-objcopy'
env_target['SIZE'] = 'avr-size'
env_target['AR'] = 'avr-ar'
env_target['RANLIB'] = 'avr-ranlib'
env_target.Append(CCFLAGS = '-Os')
 
# Define environment name.
env_target.Append(NAME = 'env_target')
 
# Microcontroller type.
env_target.Append(MCU = 'atmega328p')
# Microcontroller frequency in Hertz.
env_target.Append(F_CPU = '16000000UL')
 
# Set environment for an Atmel AVR ATmega328p microcontroller.
env_target.Append(CCFLAGS = '-mmcu=' + env_target['MCU'])
env_target.Append(LINKFLAGS = '-mmcu=' + env_target['MCU'])
env_target.Append(CPPDEFINES = 'F_CPU=' + env_target['F_CPU'])
 
# Export environment set for target.
Export('env_target')
/trunk/libraries/spi/min_env/build_tools.py
0,0 → 1,41
"""
Build project.
"""
def BuildProject(env, sources, target_name):
# Build program.
env.Program(target = target_name + '.elf', source = sources)
# Create hex binary file.
env.Command(
target_name + '.hex',
target_name + '.elf',
env['OBJCOPY'] + ' -O ihex $SOURCE $TARGET'
)
AddMethod(Environment, BuildProject)
 
"""
Build library.
"""
def BuildLibrary(env, sources, target_name):
# Build static library.
env.StaticLibrary(target = target_name, source = sources)
# Append LIBPATH and LIBS.
env.Append(LIBPATH = [ '#build/libraries/' + target_name + '/' + env['NAME'] ])
env.Append(LIBS = [ target_name ])
 
AddMethod(Environment, BuildLibrary)
 
"""
Compute memory usage.
"""
def ComputeMemoryUsage(env, target_name):
# Compute memory usage.
env.Command(
None,
target_name + '.elf',
env['SIZE'] + ' -C --mcu=' + env['MCU'] + ' $SOURCE'
)
AddMethod(Environment, ComputeMemoryUsage)
/trunk/libraries/eeprom/demo/SConscript
0,0 → 1,16
# Import environment set for target.
Import('env_target')
 
# Set target name.
TARGET = 'eeprom__demo'
 
# Set source file.
sources = [
'eeprom__demo.c'
]
 
# Build project and libraries.
env_target.BuildProject(sources, TARGET)
 
# Compute memory usage.
env_target.ComputeMemoryUsage(TARGET)
/trunk/libraries/eeprom/demo/eeprom__demo.c
0,0 → 1,51
/**************************************************************************//**
* \brief EEPROM library
* \author Copyright (C) 2011 Julien Le Sech - www.idreammicro.com
* \version 1.0
* \date 20111017
*
* This file is part of the iDreamMicro library.
*
* This library is free software: you can redistribute it and/or modify it under
* the terms of the GNU Lesser General Public License as published by the Free
* Software Foundation, either version 3 of the License, or (at your option) any
* later version.
*
* This library is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
* FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more
* details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with this program. If not, see http://www.gnu.org/licenses/
******************************************************************************/
 
/**************************************************************************//**
* \file eeprom__demo.c
******************************************************************************/
 
/******************************************************************************
* Header file inclusions.
******************************************************************************/
 
#include "../eeprom.h"
 
#include <stdint.h>
 
/**************************************************************************//**
* \fn int main(void)
*
* \brief Main function.
******************************************************************************/
int
main
(
void
){
eeprom__write_byte(0, 0x85);
uint8_t read_byte = eeprom__read_byte(0);
 
for (;;);
 
return 0;
}
/trunk/libraries/eeprom/src/SConscript
0,0 → 1,13
# Import environment set for target.
Import('env_target')
 
# Define target name.
TARGET = 'eeprom'
 
# Define source files.
sources = [
'eeprom.c'
]
 
# Build library.
env_target.BuildLibrary(sources, TARGET)
/trunk/libraries/eeprom/src/eeprom.c
0,0 → 1,159
/**************************************************************************//**
* \brief EEPROM library
* \author Copyright (C) 2011 Julien Le Sech - www.idreammicro.com
* \version 1.0
* \date 20111017
*
* This file is part of the iDreamMicro library.
*
* This library is free software: you can redistribute it and/or modify it under
* the terms of the GNU Lesser General Public License as published by the Free
* Software Foundation, either version 3 of the License, or (at your option) any
* later version.
*
* This library is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
* FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more
* details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with this program. If not, see http://www.gnu.org/licenses/
******************************************************************************/
 
/**************************************************************************//**
* \file eeprom.c
******************************************************************************/
 
/******************************************************************************
* Header file inclusions.
******************************************************************************/
 
#include <eeprom/eeprom.h>
 
#include <avr/io.h>
 
#include <assert.h>
#include <stdint.h>
#include <stdlib.h>
 
/******************************************************************************
* Public function definitions.
******************************************************************************/
 
/**************************************************************************//**
* \fn void eeprom__write_byte(
* uint16_t address,
* uint8_t data)
*
* \brief Write a byte in EEPROM.
*
* \param address Address.
* \param data Data to write.
******************************************************************************/
void
eeprom__write_byte
(
uint16_t address,
uint8_t data
){
// Wait for completion of previous write.
while (EECR & (1 << EEPE));
 
// Set up address.
EEAR = address;
 
// Set up data.
EEDR = data;
 
// Write logical one to EEMPE.
EECR |= (1 << EEMPE);
 
// Start EEPROM write.
EECR |= (1 << EEPE);
}
 
/**************************************************************************//**
* \fn void eeprom__write_bytes(
* uint16_t address,
* uint16_t size,
* uint8_t* p_data)
*
* \brief Write bytes into EEPOM.
*
* \param address Address.
* \param size Data size.
* \param[in] p_data Data to write.
******************************************************************************/
void
eeprom__write_bytes
(
uint16_t address,
uint16_t size,
uint8_t* p_data
){
// Check the preconditions.
assert(NULL != p_data);
 
for (uint16_t i = 0; i < size; i++)
{
eeprom__write_byte(address + i, p_data[i]);
}
}
 
/**************************************************************************//**
* \fn uint8_t eeprom__read_byte(
* uint16_t address)
*
* \brief Read data into EEPROM.
*
* \param address Address of data to read.
*
* \return Read data.
******************************************************************************/
uint8_t
eeprom__read_byte
(
uint16_t address
){
// Wait for completion of previous write.
while (EECR & (1 << EEPE));
 
// Set up address.
EEAR = address;
 
// Start EEPROM read.
EECR |= (1 << EERE);
 
// Read data register.
uint8_t data = EEDR;
 
return data;
}
 
/**************************************************************************//**
* \fn void eeprom__read_bytes(
* uint16_t address,
* uint16_t size,
* uint8_t* p_data)
*
* \brief Read bytes from EEPROM.
*
* \param address Address to read.
* \param size Data size to read.
* \param[in] p_data Data buffer.
******************************************************************************/
void
eeprom__read_bytes
(
uint16_t address,
uint16_t size,
uint8_t* p_data
){
// Check the preconditions.
assert(NULL != p_data);
 
for (uint16_t i = 0; i < size; i++)
{
p_data[i] = eeprom__read_byte(address + i);
}
}
/trunk/libraries/eeprom/SConscript
0,0 → 1,16
# Import environment set for target.
Import('env_target')
 
# Define directories to process.
directories = [
'src/'
]
 
# Process directories.
for directory in directories:
SConscript(
directory + 'SConscript',
variant_dir = '#build/' + '/libraries/eeprom/' + env_target['NAME'],
exports = { 'env_target' : env_target },
duplicate = 0
)
/trunk/libraries/eeprom/SConstruct
0,0 → 1,40
# Import build tools.
SConscript('#min_env/build_tools.py')
 
# Set environment for AVR-GCC.
SConscript('#min_env/env_target.py')
 
# Import environment set for AVR-GCC.
Import('env_target')
 
# Append CPPPATH.
env_target.Append(CPPPATH = [ '#../' ])
 
# Build library.
SConscript(
'src/SConscript',
variant_dir = '#build/lib/',
exports = { 'env_target' : env_target },
duplicate = 0
)
 
# Append LIBPATH and LIBS.
env_target.Append(LIBPATH = [ '#build/lib/'])
env_target.Append(LIBS = [ 'eeprom' ])
 
# Build demonstration program.
SConscript(
'demo/SConscript',
variant_dir = '#build/demo/',
exports = { 'env_target' : env_target },
duplicate = 0
)
 
# Build test program.
SConscript(
'test/SConscript',
variant_dir = '#build/test/',
exports = { 'env_target' : env_target },
duplicate = 0
)
 
/trunk/libraries/eeprom/min_env/env_target.py
0,0 → 1,28
# Create and initialize the environment.
env_target = Environment()
 
# Set environment for AVR-GCC.
env_target['CC'] = 'avr-gcc'
env_target['CPPPATH'] = '/usr/lib/avr/include'
env_target['OBJCOPY'] = 'avr-objcopy'
env_target['SIZE'] = 'avr-size'
env_target['AR'] = 'avr-ar'
env_target['RANLIB'] = 'avr-ranlib'
env_target.Append(CCFLAGS = '-Os')
env_target.Append(CCFLAGS = '-std=c99')
 
# Define environment name.
env_target.Append(NAME = 'env_target')
 
# Microcontroller type.
env_target.Append(MCU = 'atmega328p')
# Microcontroller frequency in Hertz.
env_target.Append(F_CPU = '16000000UL')
 
# Set environment for an Atmel AVR ATmega328p microcontroller.
env_target.Append(CCFLAGS = '-mmcu=' + env_target['MCU'])
env_target.Append(LINKFLAGS = '-mmcu=' + env_target['MCU'])
env_target.Append(CPPDEFINES = 'F_CPU=' + env_target['F_CPU'])
 
# Export environment set for target.
Export('env_target')
/trunk/libraries/eeprom/min_env/build_tools.py
0,0 → 1,41
"""
Build project.
"""
def BuildProject(env, sources, target_name):
# Build program.
env.Program(target = target_name + '.elf', source = sources)
# Create hex binary file.
env.Command(
target_name + '.hex',
target_name + '.elf',
env['OBJCOPY'] + ' -O ihex $SOURCE $TARGET'
)
AddMethod(Environment, BuildProject)
 
"""
Build library.
"""
def BuildLibrary(env, sources, target_name):
# Build static library.
env.StaticLibrary(target = target_name, source = sources)
# Append LIBPATH and LIBS.
env.Append(LIBPATH = [ '#build/libraries/' + target_name + '/' + env['NAME'] ])
env.Append(LIBS = [ target_name ])
 
AddMethod(Environment, BuildLibrary)
 
"""
Compute memory usage.
"""
def ComputeMemoryUsage(env, target_name):
# Compute memory usage.
env.Command(
None,
target_name + '.elf',
env['SIZE'] + ' -C --mcu=' + env['MCU'] + ' $SOURCE'
)
AddMethod(Environment, ComputeMemoryUsage)
/trunk/libraries/eeprom/eeprom.h
0,0 → 1,121
/**************************************************************************//**
* \brief EEPROM library
* \author Copyright (C) 2011 Julien Le Sech - www.idreammicro.com
* \version 1.0
* \date 20111017
*
* This file is part of the iDreamMicro library.
*
* This library is free software: you can redistribute it and/or modify it under
* the terms of the GNU Lesser General Public License as published by the Free
* Software Foundation, either version 3 of the License, or (at your option) any
* later version.
*
* This library is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
* FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more
* details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with this program. If not, see http://www.gnu.org/licenses/
******************************************************************************/
 
/**************************************************************************//**
* \headerfile eeprom.h
******************************************************************************/
 
#ifndef H__IDREAMMICRO__EEPROM__H
#define H__IDREAMMICRO__EEPROM__H
 
#ifdef _cplusplus
extern "C"{
#endif
 
/******************************************************************************
* Header file inclusions.
******************************************************************************/
 
#include <stdint.h>
 
/******************************************************************************
* Public function definitions.
******************************************************************************/
 
/**************************************************************************//**
* \fn void eeprom__write_byte(
* uint16_t address,
* uint8_t data)
*
* \brief Write a byte in EEPROM.
*
* \param address Address.
* \param data Data to write.
******************************************************************************/
void
eeprom__write_byte
(
uint16_t address,
uint8_t data
);
 
/**************************************************************************//**
* \fn void eeprom__write_bytes(
* uint16_t address,
* uint16_t size,
* uint8_t* p_data)
*
* \brief Write bytes into EEPOM.
*
* \param address Address.
* \param size Data size.
* \param[in] p_data Data to write.
******************************************************************************/
void
eeprom__write_bytes
(
uint16_t address,
uint16_t size,
uint8_t* p_data
);
 
/**************************************************************************//**
* \fn uint8_t eeprom__read_byte(
* uint16_t address)
*
* \brief Read data into EEPROM.
*
* \param address Address of data to read.
*
* \return Read data.
******************************************************************************/
uint8_t
eeprom__read_byte
(
uint16_t address
);
 
/**************************************************************************//**
* \fn void eeprom__read_bytes(
* uint16_t address,
* uint16_t size,
* uint8_t* p_data)
*
* \brief Read bytes from EEPROM.
*
* \param address Address to read.
* \param size Data size to read.
* \param[in] p_data Data buffer.
******************************************************************************/
void
eeprom__read_bytes
(
uint16_t address,
uint16_t size,
uint8_t* p_data
);
 
#ifdef _cplusplus
}
#endif
 
#endif /* H__IDREAMMICRO__EEPROM__H */
/trunk/libraries/eeprom
Modification de propriétés sur libraries/eeprom
___________________________________________________________________
Added: svn:ignore
## -0,0 +1,2 ##
+build
+.sconsign.dblite
/trunk/libraries/digital_io/src/digital_io.c
0,0 → 1,359
/**************************************************************************//**
* \brief Digital I/O library - Implementation
* \author Copyright (C) 2009 Julien Le Sech - www.idreammicro.com
* \version 1.0
* \date 20090314
*
* This file is part of the iDreamMicro library.
*
* This library is free software: you can redistribute it and/or modify it under
* the terms of the GNU Lesser General Public License as published by the Free
* Software Foundation, either version 3 of the License, or (at your option) any
* later version.
*
* This library is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
* FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more
* details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with this program. If not, see http://www.gnu.org/licenses/
******************************************************************************/
 
/**************************************************************************//**
* \file digital_io.c
******************************************************************************/
 
/******************************************************************************
* Header file inclusions.
******************************************************************************/
 
#include <digital_io/digital_io.h>
 
#include <useful/bits.h>
 
#include <avr/io.h>
 
#include <stdint.h>
 
/******************************************************************************
* Private macro definitions.
******************************************************************************/
 
/**************************************************************************//**
* \def DIGITAL_IO__PORT_DIRECTION__INPUT
* \brief
******************************************************************************/
#define DIGITAL_IO__PORT_DIRECTION__INPUT 0x00
 
/**************************************************************************//**
* \def DIGITAL_IO__PORT_DIRECTION__OUTPUT
* \brief
******************************************************************************/
#define DIGITAL_IO__PORT_DIRECTION__OUTPUT 0xFF
 
/**************************************************************************//**
* \def digital_io__get_index(port)
* \brief
******************************************************************************/
#define digital_io__get_index(port) ((port) >> 4)
/******************************************************************************
* Private types.
******************************************************************************/
 
/**************************************************************************//**
* \struct digital_io__register
* \brief Digital I/O register.
*
* \typedef digital_io__register_t
* \brief Digital IO register.
******************************************************************************/
typedef struct digital_io__register
{
const uint8_t volatile * const p_input;
uint8_t volatile * const p_output;
uint8_t volatile * const p_direction;
} digital_io__register_t;
 
/******************************************************************************
* Private variable definitions.
******************************************************************************/
 
static const digital_io__register_t ports[] =
{
#ifdef PORTA
[digital_io__get_index(DIGITAL_IO__PORT_A)]
{ // PORT A.
.p_input = &PINA,
.p_output = &PORTA,
.p_direction = &DDRA
},
#endif
#ifdef PORTB
[digital_io__get_index(DIGITAL_IO__PORT_B)]
{ // PORT B.
.p_input = &PINB,
.p_output = &PORTB,
.p_direction = &DDRB
},
#endif
#ifdef PORTC
[digital_io__get_index(DIGITAL_IO__PORT_C)]
{ // PORT C.
.p_input = &PINC,
.p_output = &PORTC,
.p_direction = &DDRC
},
#endif
#ifdef PORTD
[digital_io__get_index(DIGITAL_IO__PORT_D)]
{ // PORT D.
.p_input = &PIND,
.p_output = &PORTD,
.p_direction = &DDRD
},
#endif
#ifdef PORTE
[digital_io__get_index(DIGITAL_IO__PORT_E)]
{ // PORT E.
.p_input = &PINE,
.p_output = &PORTE,
.p_direction = &DDRE
},
#endif
#ifdef PORTF
[digital_io__get_index(DIGITAL_IO__PORT_F)]
{ // PORT F.
.p_input = &PINF,
.p_output = &PORTF,
.p_direction = &DDRF
},
#endif
#ifdef PORTG
[digital_io__get_index(DIGITAL_IO__PORT_G)]
{ // PORT G.
.p_input = &PING,
.p_output = &PORTG,
.p_direction = &DDRG
},
#endif
#ifdef PORTH
[digital_io__get_index(DIGITAL_IO__PORT_H)]
{ // PORT H.
.p_input = &PINH,
.p_output = &PORTH,
.p_direction = &DDRH
},
#endif
#ifdef PORTJ
[digital_io__get_index(DIGITAL_IO__PORT_J)]
{ // PORT J.
.p_input = &PINJ,
.p_output = &PORTJ,
.p_direction = &DDRJ
},
#endif
#ifdef PORTK
[digital_io__get_index(DIGITAL_IO__PORT_K)] =
{ // PORT K.
.p_input = &PINK,
.p_output = &PORTK,
.p_direction = &DDRK
},
#endif
#ifdef PORTL
[digital_io__get_index(DIGITAL_IO__PORT_L)]
{ // PORT L.
.p_input = &PINL,
.p_output = &PORTL,
.p_direction = &DDRL
}
#endif
};
 
/******************************************************************************
* Public function definitions.
******************************************************************************/
 
/**************************************************************************//**
* \fn void digital_io__configure_pin(
* digital_io__pin_position_t pin_position,
* digital_io__direction_t direction)
*
* \brief Configure a pin.
*
* \param[in] pin_position pin position to configure
* \param direction pin direction
******************************************************************************/
void
digital_io__configure_pin
(
digital_io__pin_position_t pin_position,
digital_io__direction_t direction
){
// Alias.
digital_io__register_t const* p_register =
&(ports[digital_io__get_port(pin_position)]);
 
if (DIGITAL_IO__DIRECTION__INPUT == direction)
{
BIT__RST(*(p_register->p_direction), digital_io__get_pin(pin_position));
}
else
{
BIT__SET(*(p_register->p_direction), digital_io__get_pin(pin_position));
}
}
 
/**************************************************************************//**
* \fn digital_io__level_t digital_io__get_pin_level(
* digital_io__pin_position_t pin_position)
*
* \brief Get the level of a pin.
*
* \param pin_position pin position to get level
*
* \return digital io level
******************************************************************************/
digital_io__level_t
digital_io__get_pin_level
(
digital_io__pin_position_t pin_position
){
// Alias.
digital_io__register_t const* p_register =
&(ports[digital_io__get_port(pin_position)]);
 
digital_io__level_t level =
BIT__TST(*(p_register->p_input), digital_io__get_pin(pin_position)) ?
DIGITAL_IO__LEVEL__HIGH : DIGITAL_IO__LEVEL__LOW;
 
return level;
}
 
/**************************************************************************//**
* \fn void digital_io__set_pin_level(
* digital_io__pin_position_t pin_position,
* digital_io__level_t level)
*
* \brief Set the level of a pin.
*
* \param[in] pin_position pin position to set level
* \param level level to set
******************************************************************************/
void
digital_io__set_pin_level
(
digital_io__pin_position_t pin_position,
digital_io__level_t level
){
// Alias.
digital_io__register_t const* p_register =
&(ports[digital_io__get_port(pin_position)]);
 
if (DIGITAL_IO__LEVEL__LOW == level)
{
BIT__RST(*(p_register->p_output), digital_io__get_pin(pin_position));
}
else
{
BIT__SET(*(p_register->p_output), digital_io__get_pin(pin_position));
}
}
 
/**************************************************************************//**
* \fn void digital_io__toggle_pin_level(
* digital_io__pin_position_t pin_position)
*
* \brief Toggle the level of a pin.
*
* \param pin_position pin position to toggle level
******************************************************************************/
void
digital_io__toggle_pin_level
(
digital_io__pin_position_t pin_position
){
// Alias.
digital_io__register_t const* p_register =
&(ports[digital_io__get_port(pin_position)]);
 
BIT__TGL(*(p_register->p_output), digital_io__get_pin(pin_position));
}
 
/**************************************************************************//**
* \fn void digital_io__configure_port(
* digital_io__port_t port,
* digital_io__direction_t direction)
*
* \brief Configure a port.
*
* \param port port to configure
* \param direction port direction to configure
******************************************************************************/
void
digital_io__configure_port
(
digital_io__port_t port,
digital_io__direction_t direction
){
// Alias.
digital_io__register_t const* p_register =
&(ports[digital_io__get_port(port)]);
 
if (DIGITAL_IO__DIRECTION__INPUT == direction)
{
*(p_register->p_direction) = DIGITAL_IO__PORT_DIRECTION__INPUT;
}
else
{
*(p_register->p_direction) = DIGITAL_IO__PORT_DIRECTION__OUTPUT;
}
}
 
/**************************************************************************//**
* \fn uint8_t digital_io__get_port_value(digital_io__port_t port)
*
* \brief Get the value of a port.
*
* \param port port to get value
*
* \return port value
******************************************************************************/
digital_io__port_value_t
digital_io__get_port_value
(
digital_io__port_t port
){
// Alias.
digital_io__register_t const* p_register =
&(ports[digital_io__get_port(port)]);
 
uint8_t value = *(p_register->p_input);
 
return value;
}
 
/**************************************************************************//**
* \fn void digital_io__set_port_value(
* digital_io__port_t port,
* digital_io__port_value_t value)
*
* \brief Set the value of a port.
*
* \param port port to set value
* \param value port value to set
******************************************************************************/
void
digital_io__set_port_value
(
digital_io__port_t port,
digital_io__port_value_t value
){
// Alias.
digital_io__register_t const* p_register =
&(ports[digital_io__get_port(port)]);
 
*(p_register->p_output) = value;
}
/trunk/libraries/digital_io/src/SConscript
0,0 → 1,13
# Import environment set for target.
Import('env_target')
 
# Define target name.
TARGET = 'digital_io'
 
# Define source files.
sources = [
'digital_io.c'
]
 
# Build library.
env_target.BuildLibrary(sources, TARGET)
/trunk/libraries/digital_io/digital_io.h
0,0 → 1,354
/**************************************************************************//**
* \brief Digital I/O library - API
* \author Copyright (C) 2009 Julien Le Sech - www.idreammicro.com
* \version 1.0
* \date 20090314
*
* This file is part of the iDreamMicro library.
*
* This library is free software: you can redistribute it and/or modify it under
* the terms of the GNU Lesser General Public License as published by the Free
* Software Foundation, either version 3 of the License, or (at your option) any
* later version.
*
* This library is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
* FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more
* details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with this program. If not, see http://www.gnu.org/licenses/
******************************************************************************/
 
/**************************************************************************//**
* \headerfile digital_io.h
*
* \brief
*
* \see
******************************************************************************/
#ifndef H__IDREAMMICRO__DIGITAL_IO__H
#define H__IDREAMMICRO__DIGITAL_IO__H
 
#ifdef _cplusplus
extern "C"{
#endif
 
/******************************************************************************
* Header file inclusions.
******************************************************************************/
 
#include <avr/io.h>
 
#include <stdint.h>
 
/******************************************************************************
* Public macro definitions.
******************************************************************************/
 
/**************************************************************************//**
* \def digital_io__get_port(pin_position)
* \brief Get port from pin position.
******************************************************************************/
#define digital_io__get_port(pin_position) ((pin_position) >> 4)
 
/**************************************************************************//**
* \def digital_io__get_pin(pin_position)
* \brief Get pin form pin position.
******************************************************************************/
#define digital_io__get_pin(pin_position) ((pin_position) & 0x0F)
 
/**************************************************************************//**
* \def DIGITAL_IO__PORT_A
* \brief Port A.
******************************************************************************/
#define DIGITAL_IO__PORT_A 0x00
 
/**************************************************************************//**
* \def DIGITAL_IO__PORT_B
* \brief Port B.
******************************************************************************/
#define DIGITAL_IO__PORT_B 0x10
 
/**************************************************************************//**
* \def DIGITAL_IO__PORT_C
* \brief Port C.
******************************************************************************/
#define DIGITAL_IO__PORT_C 0x20
 
/**************************************************************************//**
* \def DIGITAL_IO__PORT_D
* \brief Port D.
******************************************************************************/
#define DIGITAL_IO__PORT_D 0x30
 
/**************************************************************************//**
* \def DIGITAL_IO__PORT_E
* \brief Port E.
******************************************************************************/
#define DIGITAL_IO__PORT_E 0x40
 
/**************************************************************************//**
* \def DIGITAL_IO__PORT_F
* \brief Port F.
******************************************************************************/
#define DIGITAL_IO__PORT_F 0x50
 
/**************************************************************************//**
* \def DIGITAL_IO__PORT_G
* \brief Port G.
******************************************************************************/
#define DIGITAL_IO__PORT_G 0x60
 
/**************************************************************************//**
* \def DIGITAL_IO__PORT_H
* \brief port H.
******************************************************************************/
#define DIGITAL_IO__PORT_H 0x70
 
/**************************************************************************//**
* \def DIGITAL_IO__PORT_J
* \brief Port J.
******************************************************************************/
#define DIGITAL_IO__PORT_J 0x80
 
/**************************************************************************//**
* \def DIGITAL_IO__PORT_K
* \brief Port K.
******************************************************************************/
#define DIGITAL_IO__PORT_K 0x90
 
/**************************************************************************//**
* \def DIGITAL_IO__PORT_L
* \brief Port L.
******************************************************************************/
#define DIGITAL_IO__PORT_L 0xA0
 
/**************************************************************************//**
* \def DIGITAL_IO__PIN_0
* \brief Pin 0.
******************************************************************************/
#define DIGITAL_IO__PIN_0 0
 
/**************************************************************************//**
* \def DIGITAL_IO__PIN_1
* \brief Pin 1.
******************************************************************************/
#define DIGITAL_IO__PIN_1 1
 
/**************************************************************************//**
* \def DIGITAL_IO__PIN_2
* \brief Pin 2.
******************************************************************************/
#define DIGITAL_IO__PIN_2 2
 
/**************************************************************************//**
* \def DIGITAL_IO__PIN_3
* \brief Pin 3.
******************************************************************************/
#define DIGITAL_IO__PIN_3 3
 
/**************************************************************************//**
* \def DIGITAL_IO__PIN_4
* \brief Pin 4.
******************************************************************************/
#define DIGITAL_IO__PIN_4 4
 
/**************************************************************************//**
* \def DIGITAL_IO__PIN_5
* \brief Pin 5.
******************************************************************************/
#define DIGITAL_IO__PIN_5 5
 
/**************************************************************************//**
* \def DIGITAL_IO__PIN_6
* \brief Pin 6.
******************************************************************************/
#define DIGITAL_IO__PIN_6 6
 
/**************************************************************************//**
* \def DIGITAL_IO__PIN_7
* \brief Pin 7.
******************************************************************************/
#define DIGITAL_IO__PIN_7 7
 
/******************************************************************************
* Public types.
******************************************************************************/
 
/**************************************************************************//**
* \typedef digital_io__port_t
* \brief Represent a digital port.
******************************************************************************/
typedef uint8_t digital_io__port_t;
 
/**************************************************************************//**
* \typedef digital_io__pin_t
* \brief Represent a digital pin.
******************************************************************************/
typedef uint8_t digital_io__pin_t;
 
/**************************************************************************//**
* \typedef digital_io__pin_position_t
* \brief Digital IO pin position.
* High nibble is used for the port, low nibble is used for the pin.
* digital_io__pin_position_t pin = DIGITAL_IO__PORT_B | DIGITAL_IO__PIN_5;
******************************************************************************/
typedef uint8_t digital_io__pin_position_t;
 
/**************************************************************************//**
* \enum digital_io__directions
* \brief Digital IO directions.
*
* \typedef digital_io__direction_t
* \brief Digital IO direction.
******************************************************************************/
typedef enum digital_io__directions
{
DIGITAL_IO__DIRECTION__INPUT, /*!< Input. */
DIGITAL_IO__DIRECTION__OUTPUT /*!< Output. */
} digital_io__direction_t;
 
/**************************************************************************//**
* \enum digital_io__levels
* \brief Digital IO levels.
*
* \typedef digital_io__level_t
* \brief Digital IO level.
******************************************************************************/
typedef enum digital_io__levels
{
DIGITAL_IO__LEVEL__LOW, /*!< Low level. */
DIGITAL_IO__LEVEL__HIGH /*!< High level. */
} digital_io__level_t;
 
/**************************************************************************//**
* \typedef digital_io__port_value_t
* \brief Port value.
******************************************************************************/
typedef uint8_t digital_io__port_value_t;
 
/******************************************************************************
* Public function prototypes.
******************************************************************************/
 
/**************************************************************************//**
* \fn void digital_io__configure_pin(
* digital_io__pin_position_t pin_position,
* digital_io__direction_t direction)
*
* \brief Configure a pin.
*
* \param pin_position pin position to configure
* \param direction pin direction to set
******************************************************************************/
void
digital_io__configure_pin
(
digital_io__pin_position_t pin_position,
digital_io__direction_t direction
);
 
/**************************************************************************//**
* \fn digital_io__level_t digital_io__get_pin_level(
* digital_io__pin_position_t pin_position)
*
* \brief Get the level of a pin.
*
* \param pin_position pin position to get level
*
* \return digital io level
******************************************************************************/
digital_io__level_t
digital_io__get_pin_level
(
digital_io__pin_position_t pin_position
);
 
/**************************************************************************//**
* \fn void digital_io__set_pin_level(
* digital_io__pin_position_t pin_position,
* digital_io__level_t level)
*
* \brief Set the level of a pin.
*
* \param pin_position pin position to set level
* \param level level to set
******************************************************************************/
void
digital_io__set_pin_level
(
digital_io__pin_position_t pin_position,
digital_io__level_t level
);
 
/**************************************************************************//**
* \fn void digital_io__toggle_pin_level(
* digital_io__pin_position_t pin_position)
*
* \brief Toggle the level of a pin.
*
* \param pin_position pin position to toggle level
******************************************************************************/
void
digital_io__toggle_pin_level
(
digital_io__pin_position_t pin_position
);
 
/**************************************************************************//**
* \fn void digital_io__configure_port(
* digital_io__port_t port,
* digital_io__direction_t direction)
*
* \brief Configure a port.
*
* \param port port to configure
* \param direction port direction to configure
******************************************************************************/
void
digital_io__configure_port
(
digital_io__port_t port,
digital_io__direction_t direction
);
 
/**************************************************************************//**
* \fn uint8_t digital_io__get_port_value(digital_io__port_t port)
*
* \brief Get the value of a port.
*
* \param port port to get value
*
* \return Port value
******************************************************************************/
digital_io__port_value_t
digital_io__get_port_value
(
digital_io__port_t port
);
 
/**************************************************************************//**
* \fn void digital_io__set_port_value(
* digital_io__port_t port,
* digital_io__port_value_t value)
*
* \brief Set the value of a port.
*
* \param port port to set value
* \param value port value to set
******************************************************************************/
void
digital_io__set_port_value
(
digital_io__port_t port,
digital_io__port_value_t value
);
 
#ifdef _cplusplus
}
#endif
 
#endif /* H__IDREAMMICRO__DIGITAL_IO__H */
 
/trunk/libraries/digital_io/test/digital_io__test.c
0,0 → 1,68
/**************************************************************************//**
* \brief Digital I/O library - Test program
* \author Copyright (C) 2011 Julien Le Sech - www.idreammicro.com
* \version 1.0
* \date 20090314
*
* This file is part of the iDreamMicro library.
*
* This library is free software: you can redistribute it and/or modify it under
* the terms of the GNU Lesser General Public License as published by the Free
* Software Foundation, either version 3 of the License, or (at your option) any
* later version.
*
* This library is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
* FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more
* details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with this program. If not, see http://www.gnu.org/licenses/
******************************************************************************/
 
/**************************************************************************//**
* \file digital_io__test.c
******************************************************************************/
 
/******************************************************************************
* Header file inclusions.
******************************************************************************/
 
#include "../digital_io.h"
 
#include <avr/io.h>
#include <util/delay.h>
 
/******************************************************************************
* Main function.
******************************************************************************/
 
/**************************************************************************//**
* \fn int main(void)
*
* \brief Main function.
******************************************************************************/
int
main
(
void
){
// Declare pin.
digital_io__pin_position_t pin = DIGITAL_IO__PORT_B | DIGITAL_IO__PIN_5;
// Configure pin as output.
digital_io__configure_pin(pin, DIGITAL_IO__DIRECTION__OUTPUT);
 
for (;;)
{
// Set pin level.
digital_io__set_pin_level(pin, DIGITAL_IO__LEVEL__HIGH);
_delay_ms(1000);
 
// Reset pin level.
digital_io__set_pin_level(pin, DIGITAL_IO__LEVEL__LOW);
_delay_ms(1000);
}
 
return 0;
}
/trunk/libraries/digital_io/test/SConscript
0,0 → 1,16
# Import environment set for target.
Import('env_target')
 
# Set target name.
TARGET = 'digital_io__test'
 
# Set source file.
sources = [
'digital_io__test.c'
]
 
# Build project and libraries.
env_target.BuildProject(sources, TARGET)
 
# Compute memory usage.
env_target.ComputeMemoryUsage(TARGET)
/trunk/libraries/digital_io/demo/digital_io__demo.c
0,0 → 1,68
/**************************************************************************//**
* \brief Digital I/O library - Demonstration program
* \author Copyright (C) 2011 Julien Le Sech - www.idreammicro.com
* \version 1.0
* \date 20090314
*
* This file is part of the iDreamMicro library.
*
* This library is free software: you can redistribute it and/or modify it under
* the terms of the GNU Lesser General Public License as published by the Free
* Software Foundation, either version 3 of the License, or (at your option) any
* later version.
*
* This library is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
* FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more
* details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with this program. If not, see http://www.gnu.org/licenses/
******************************************************************************/
 
/**************************************************************************//**
* \file digital_io__demo.c
******************************************************************************/
 
/******************************************************************************
* Header file inclusions.
******************************************************************************/
 
#include "../digital_io.h"
 
#include <avr/io.h>
#include <util/delay.h>
 
/******************************************************************************
* Main function.
******************************************************************************/
 
/**************************************************************************//**
* \fn int main(void)
*
* \brief Main function.
******************************************************************************/
int
main
(
void
){
// Declare pin.
digital_io__pin_position_t pin = DIGITAL_IO__PORT_B | DIGITAL_IO__PIN_5;
// Configure pin as output.
digital_io__configure_pin(pin, DIGITAL_IO__DIRECTION__OUTPUT);
 
for (;;)
{
// Set pin level.
digital_io__set_pin_level(pin, DIGITAL_IO__LEVEL__HIGH);
_delay_ms(1000);
 
// Reset pin level.
digital_io__set_pin_level(pin, DIGITAL_IO__LEVEL__LOW);
_delay_ms(1000);
}
 
return 0;
}
/trunk/libraries/digital_io/demo/SConscript
0,0 → 1,16
# Import environment set for target.
Import('env_target')
 
# Set target name.
TARGET = 'digital_io__demo'
 
# Set source file.
sources = [
'digital_io__demo.c'
]
 
# Build project and libraries.
env_target.BuildProject(sources, TARGET)
 
# Compute memory usage.
env_target.ComputeMemoryUsage(TARGET)
/trunk/libraries/digital_io/demo/.sconsign.dblite
Modification de propriétés sur libraries/digital_io/demo/.sconsign.dblite
___________________________________________________________________
Added: svn:mime-type
## -0,0 +1 ##
+application/octet-stream
\ No newline at end of property
/trunk/libraries/digital_io/SConstruct
0,0 → 1,40
# Import build tools.
SConscript('#min_env/build_tools.py')
 
# Set environment for AVR-GCC.
SConscript('#min_env/env_target.py')
 
# Import environment set for AVR-GCC.
Import('env_target')
 
# Append CPPPATH.
env_target.Append(CPPPATH = [ '#../' ])
 
# Build library.
SConscript(
'src/SConscript',
variant_dir = '#build/lib/',
exports = { 'env_target' : env_target },
duplicate = 0
)
 
# Append LIBPATH and LIBS.
env_target.Append(LIBPATH = [ '#build/lib/'])
env_target.Append(LIBS = [ 'digital_io' ])
 
# Build demonstration program.
SConscript(
'demo/SConscript',
variant_dir = '#build/demo/',
exports = { 'env_target' : env_target },
duplicate = 0
)
 
# Build test program.
SConscript(
'test/SConscript',
variant_dir = '#build/test/',
exports = { 'env_target' : env_target },
duplicate = 0
)
 
/trunk/libraries/digital_io/min_env/env_target.py
0,0 → 1,27
# Create and initialize the environment.
env_target = Environment()
 
# Set environment for AVR-GCC.
env_target['CC'] = 'avr-gcc'
env_target['CPPPATH'] = '/usr/lib/avr/include'
env_target['OBJCOPY'] = 'avr-objcopy'
env_target['SIZE'] = 'avr-size'
env_target['AR'] = 'avr-ar'
env_target['RANLIB'] = 'avr-ranlib'
env_target.Append(CCFLAGS = '-Os')
 
# Define environment name.
env_target.Append(NAME = 'env_target')
 
# Microcontroller type.
env_target.Append(MCU = 'atmega328p')
# Microcontroller frequency in Hertz.
env_target.Append(F_CPU = '16000000UL')
 
# Set environment for an Atmel AVR ATmega328p microcontroller.
env_target.Append(CCFLAGS = '-mmcu=' + env_target['MCU'])
env_target.Append(LINKFLAGS = '-mmcu=' + env_target['MCU'])
env_target.Append(CPPDEFINES = 'F_CPU=' + env_target['F_CPU'])
 
# Export environment set for target.
Export('env_target')
/trunk/libraries/digital_io/min_env/build_tools.py
0,0 → 1,41
"""
Build project.
"""
def BuildProject(env, sources, target_name):
# Build program.
env.Program(target = target_name + '.elf', source = sources)
# Create hex binary file.
env.Command(
target_name + '.hex',
target_name + '.elf',
env['OBJCOPY'] + ' -O ihex $SOURCE $TARGET'
)
AddMethod(Environment, BuildProject)
 
"""
Build library.
"""
def BuildLibrary(env, sources, target_name):
# Build static library.
env.StaticLibrary(target = target_name, source = sources)
# Append LIBPATH and LIBS.
env.Append(LIBPATH = [ '#build/libraries/' + target_name + '/' + env['NAME'] ])
env.Append(LIBS = [ target_name ])
 
AddMethod(Environment, BuildLibrary)
 
"""
Compute memory usage.
"""
def ComputeMemoryUsage(env, target_name):
# Compute memory usage.
env.Command(
None,
target_name + '.elf',
env['SIZE'] + ' -C --mcu=' + env['MCU'] + ' $SOURCE'
)
AddMethod(Environment, ComputeMemoryUsage)
/trunk/libraries/digital_io/SConscript
0,0 → 1,16
# Import environment set for target.
Import('env_target')
 
# Define directories to process.
directories = [
'src/'
]
 
# Process directories.
for directory in directories:
SConscript(
directory + 'SConscript',
variant_dir = '#build/' + '/libraries/digital_io/' + env_target['NAME'],
exports = { 'env_target' : env_target },
duplicate = 0
)
/trunk/libraries/digital_io/.sconsign.dblite
Modification de propriétés sur libraries/digital_io/.sconsign.dblite
___________________________________________________________________
Added: svn:mime-type
## -0,0 +1 ##
+application/octet-stream
\ No newline at end of property
/trunk/libraries/digital_io
Modification de propriétés sur libraries/digital_io
___________________________________________________________________
Added: svn:ignore
## -0,0 +1 ##
+build
/trunk/libraries/ds1307/ds1307.h
0,0 → 1,273
/**************************************************************************//**
* \brief DS1307 RTC library
* \author Copyright (C) 2011 Julien Le Sech - www.idreammicro.com
* \version 1.0
* \date 20090501
*
* This file is part of the iDreamMicro library.
*
* This library is free software: you can redistribute it and/or modify it under
* the terms of the GNU Lesser General Public License as published by the Free
* Software Foundation, either version 3 of the License, or (at your option) any
* later version.
*
* This library is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
* FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more
* details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with this program. If not, see http://www.gnu.org/licenses/
******************************************************************************/
 
/**************************************************************************//**
* \headerfile ds1307.h
******************************************************************************/
 
#ifndef H__IDREAMMICRO__DS1307__H
#define H__IDREAMMICRO__DS1307__H
 
#ifdef _cplusplus
extern "C"{
#endif
 
/******************************************************************************
* Header file inclusions.
******************************************************************************/
 
#include <useful/datetime.h>
 
#include <stdbool.h>
 
/******************************************************************************
* Public macro definitions.
******************************************************************************/
 
/**************************************************************************//**
* \def DS1307__CLOCK_RATE
* \brief DS1307 frequency in Hertz.
******************************************************************************/
#define DS1307__CLOCK_RATE 100000
 
/******************************************************************************
* Public type definitions.
******************************************************************************/
 
/**************************************************************************//**
* \enum ds1307__hour_modes.
* \brief RTC hour modes.
*
* \typedef ds1307__hour_mode_t.
* \brief RTC hour mode.
******************************************************************************/
typedef enum ds1307__hour_modes
{
DS1307__HOUR_MODE__24_HOUR = 0, /*!< 24-hour mode. */
DS1307__HOUR_MODE__12_HOUR = 1 /*!< 12-hour mode. */
} ds1307__hour_mode_t;
 
/**************************************************************************//**
* \enum ds1307__sqw_out_levels
* \brief
*
* \typedef ds1307__sqw_out_level_t
* \brief
******************************************************************************/
typedef enum ds1307__sqw_out_levels
{
DS1307__SQW_LEVEL__LOW, /*!< Low level. */
DS1307__SQW_LEVEL__HIGH /*!< High level. */
} ds1307__sqw_out_level_t;
 
/**************************************************************************//**
* \enum ds1307__sqw_out_frequencies
* \brief
*
* \typedef ds1307__sqw_out__frequency_t
* \brief
******************************************************************************/
typedef enum ds1307__sqw_out_frequencies
{
DS1307__SQW_FREQUENCY__1_HZ,
DS1307__SQW_FREQUENCY__4096_HZ,
DS1307__SQW_FREQUENCY__8192_HZ,
DS1307__SQW_FREQUENCY__32768_HZ
} ds1307__sqw_out__frequency_t;
 
/******************************************************************************
* Public function prototypes.
******************************************************************************/
 
/**************************************************************************//**
* \fn void ds1307__initialize(void)
*
* \brief Initialize DS1307 RTC.
******************************************************************************/
void
ds1307__initialize
(
void
);
 
/**************************************************************************//**
* \fn void ds1307__get_time(
* date_time__time_t* p_time,
* ds1307__hour_mode_t* p_hour_mode)
*
* \brief Get RTC time.
*
* \param p_time a pointer to fill with RTC time
* \param p_hour_mode a pointer to fill with RTC hour mode
******************************************************************************/
void
ds1307__get_time
(
datetime__time_t* p_time,
ds1307__hour_mode_t* p_hour_mode
);
 
/**************************************************************************//**
* \fn void ds1307__set_time(
* date_time__time_t* p_time,
* ds1307__hour_mode_t hour_mode)
*
* \brief Set RTC time.
*
* \param p_time time to set. p_time->meridiem isn't used in 12-hour mode.
* \param hour_mode hour mode
******************************************************************************/
void
ds1307__set_time
(
datetime__time_t* p_time,
ds1307__hour_mode_t hour_mode
);
 
/**************************************************************************//**
* \fn void ds1307__get_date(date_time__date_t* p_date)
*
* \brief Get RTC date.
*
* \param p_date a pointer to fill with RTC date
******************************************************************************/
void
ds1307__get_date
(
datetime__date_t* p_date
);
 
/**************************************************************************//**
* \fn void ds1307__set_date(date_time__date_t* p_date)
*
* \brief Set RTC date.
*
* \param p_date date to set
******************************************************************************/
void
ds1307__set_date
(
datetime__date_t* p_date
);
 
/**************************************************************************//**
* \fn void ds1307__set_square_wave_output_level(ds1307__sqw_out_level_t level)
*
* \brief Set square wave output pin level.
*
* \param level Level to set.
******************************************************************************/
void
ds1307__set_square_wave_output_level
(
ds1307__sqw_out_level_t level
);
 
/**************************************************************************//**
* \fn void ds1307__set_square_wave_output_signal(
* ds1307__sqw_out__frequency_t frequency,
* bool enable)
*
* \brief Set Square-Wave output signal.
*
* \param frequency Frequency.
* \param enable Status.
******************************************************************************/
void
ds1307__set_square_wave_output_signal
(
ds1307__sqw_out__frequency_t frequency,
bool enable
);
 
/**************************************************************************//**
* \fn uint8_t ds1307__read_byte_in_ram(uint8_t address)
*
* \brief Read a byte in DS1307 RAM.
*
* \param address Address to read.
*
* \return Read byte.
******************************************************************************/
uint8_t
ds1307__read_byte_in_ram
(
uint8_t address
);
 
/**************************************************************************//**
* \fn void ds1307__read_bytes_in_ram(
* uint8_t address,
* uint8_t length,
* uint8_t* p_data)
*
* \brief Read bytes in DS1307 RAM.
*
* \param address Address to read.
* \param length Number of bytes to read.
* \param[in] p_data Buffer to fill.
******************************************************************************/
void
ds1307__read_bytes_in_ram
(
uint8_t address,
uint8_t length,
uint8_t* p_data
);
 
/**************************************************************************//**
* \fn void ds1307__write_byte_in_ram(uint8_t address, uint8_t data)
*
* \brief Write a byte in DS1307 RAM.
*
* \param address Address to write.
* \param data Byte to write.
******************************************************************************/
void
ds1307__write_byte_in_ram
(
uint8_t address,
uint8_t data
);
 
/**************************************************************************//**
* \fn void ds1307__write_bytes_in_ram(uint8_t address, uint8_t data)
*
* \brief Write a byte in DS1307 RAM.
*
* \param address Address to write.
* \param length Number of bytes to write.
* \param[in] p_data Bytes to write.
******************************************************************************/
void
ds1307__write_bytes_in_ram
(
uint8_t address,
uint8_t length,
uint8_t* p_data
);
 
#ifdef _cplusplus
}
#endif
 
#endif /* H__IDREAMMICRO__DS1307__H */
/trunk/libraries/ds1307/src/ds1307.c
0,0 → 1,451
/**************************************************************************//**
* \brief DS1307 RTC library
* \author Copyright (C) 2009 Julien Le Sech - www.idreammicro.com
* \version 1.0
* \date 20090501
*
* This file is part of the iDreamMicro library.
*
* This library is free software: you can redistribute it and/or modify it under
* the terms of the GNU Lesser General Public License as published by the Free
* Software Foundation, either version 3 of the License, or (at your option) any
* later version.
*
* This library is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
* FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more
* details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with this program. If not, see http://www.gnu.org/licenses/
******************************************************************************/
 
/**************************************************************************//**
* \file ds1307.c
******************************************************************************/
 
/******************************************************************************
* Header file inclusions.
******************************************************************************/
 
#include <ds1307/ds1307.h>
 
#include <twi/twi.h>
#include <useful/bits.h>
#include <useful/datetime.h>
 
#include <avr/io.h>
 
#include <assert.h>
#include <stdbool.h>
#include <stdlib.h>
 
/******************************************************************************
* Private macros.
******************************************************************************/
 
#define DS1307__ADDRESS 0xD0
 
#define DS1307__REG_SECONDS 0x00
#define DS1307__REG_MINUTES 0x01
#define DS1307__REG_HOURS 0x02
#define DS1307__REG_DAY 0x03
#define DS1307__REG_DATE 0x04
#define DS1307__REG_MONTH 0x05
#define DS1307__REG_YEAR 0x06
#define DS1307__REG_CONTROL 0x07
 
#define DS1307__RS0 0x00
#define DS1307__RS1 0x01
#define DS1307__SQWE 0x04
#define DS1307__OUT 0x07
 
/**************************************************************************//**
* \def DS1307__REG_RAM
* \brief Start address of RAM registers (locations 0x08 to 0x3F).
******************************************************************************/
#define DS1307__REG_RAM 0x08
 
/******************************************************************************
* Public function definitions.
******************************************************************************/
 
/**************************************************************************//**
* \fn void ds1307__initialize(void)
*
* \brief Initialize RTC.
******************************************************************************/
void
ds1307__initialize
(
void
){
// We don't initialize TWI here: we may have several devices on the bus.
// Initialize TWI.
//twi__initialize(DS1307__CLOCK_RATE);
}
 
/**************************************************************************//**
* \fn void ds1307__get_time(
* date_time__time_t* p_time,
* ds1307__hour_mode_t* p_hour_mode)
*
* \brief Get RTC time.
*
* \param p_time a pointer to fill with RTC time
* \param p_hour_mode a pointer to fill with RTC hour mode
******************************************************************************/
void
ds1307__get_time
(
datetime__time_t* p_time,
ds1307__hour_mode_t* p_hour_mode
){
// Check the preconditions.
assert(NULL != p_time);
assert(NULL != p_hour_mode);
 
twi__start();
twi__send_slaw(DS1307__ADDRESS);
twi__send_data(DS1307__REG_SECONDS);
twi__stop();
 
twi__start();
twi__send_slar(DS1307__ADDRESS);
uint8_t seconds = 0;
twi__receive_data_ack(&seconds);
uint8_t minutes = 0;
twi__receive_data_ack(&minutes);
uint8_t hours = 0;
twi__receive_data_nack(&hours);
p_time->seconds = (((seconds & 0x70) >> 4) * 10) + (seconds & 0x0F);
p_time->minutes = (((minutes & 0x70) >> 4) * 10) + (minutes & 0x0F);
*p_hour_mode = (ds1307__hour_mode_t)((hours & 0x40) >> 6);
if (DS1307__HOUR_MODE__12_HOUR == *p_hour_mode)
{
p_time->meridiem = (datetime__meridiem_t)((hours & 0x20) >> 5);
p_time->hours = (((hours & 0x10) >> 4) * 10) + (hours & 0x0F);
}
else
{
p_time->hours = (((hours & 0x30) >> 4) * 10) + (hours & 0x0F);
}
twi__stop();
}
 
/**************************************************************************//**
* \fn void ds1307__set_time(
* date_time__time_t* p_time,
* ds1307__hour_mode_t hour_mode)
*
* \brief Set RTC time.
*
* \param p_time time to set. p_time->meridiem isn't used in 12-hour mode.
* \param hour_mode hour mode
******************************************************************************/
void
ds1307__set_time
(
datetime__time_t* p_time,
ds1307__hour_mode_t hour_mode
){
// Check the preconditions.
assert(NULL != p_time);
 
twi__start();
twi__send_slaw(DS1307__ADDRESS);
twi__send_data(DS1307__REG_SECONDS);
 
uint8_t seconds = ((p_time->seconds / 10) << 4) + (p_time->seconds % 10);
uint8_t minutes = ((p_time->minutes / 10) << 4) + (p_time->minutes % 10);
uint8_t hours = 0;
if (DS1307__HOUR_MODE__12_HOUR == hour_mode)
{
hours = (hour_mode << 6) + (p_time->meridiem << 5)
+ ((p_time->hours / 10) << 4) + (p_time->hours % 10);
}
else
{
hours = (hour_mode << 6) + ((p_time->hours / 10) << 4)
+ (p_time->hours % 10);
}
 
twi__send_data(seconds);
twi__send_data(minutes);
twi__send_data(hours);
 
twi__stop();
}
 
/**************************************************************************//**
* \fn void ds1307__get_date(date_time__date_t* p_date)
*
* \brief Get RTC date.
*
* \param p_date a pointer to fill with RTC date
******************************************************************************/
void
ds1307__get_date
(
datetime__date_t* p_date
){
// Check the preconditions.
assert(NULL != p_date);
 
twi__start();
twi__send_slaw(DS1307__ADDRESS);
twi__send_data(DS1307__REG_DAY);
twi__stop();
 
twi__start();
twi__send_slar(DS1307__ADDRESS);
 
uint8_t day = 0;
twi__receive_data_ack(&day);
uint8_t date = 0;
twi__receive_data_ack(&date);
uint8_t month = 0;
twi__receive_data_ack(&month);
uint8_t year = 0;
twi__receive_data_nack(&year);
 
p_date->day = day;
p_date->date = (((date & 0x30) >> 4) * 10) + (date & 0x0F);
p_date->month = (((month & 0x10) >> 4) * 10) + (month & 0x0F);
p_date->year = (((year & 0xF0) >> 4) * 10) + (year & 0x0F);
 
twi__stop();
}
 
/**************************************************************************//**
* \fn void ds1307__set_date(date_time__date_t* p_date)
*
* \brief Set RTC date.
*
* \param p_date date to set
******************************************************************************/
void
ds1307__set_date
(
datetime__date_t* p_date
){
// Check the preconditions.
assert(NULL != p_date);
 
twi__start();
twi__send_slaw(DS1307__ADDRESS);
twi__send_data(DS1307__REG_DAY);
 
uint8_t date = ((p_date->date / 10) << 4) + (p_date->date % 10);
uint8_t month = ((p_date->month / 10) << 4) + (p_date->month % 10);
uint8_t year = ((p_date->year / 10) << 4) + (p_date->year % 10);
 
twi__send_data(p_date->day);
twi__send_data(date);
twi__send_data(month);
twi__send_data(year);
 
twi__stop();
}
 
/**************************************************************************//**
* \fn void ds1307__set_square_wave_output_level(ds1307__sqw_out_level_t level)
*
* \brief Set square wave output pin level.
*
* \param level Level to set.
******************************************************************************/
void
ds1307__set_square_wave_output_level
(
ds1307__sqw_out_level_t level
){
twi__start();
twi__send_slaw(DS1307__ADDRESS);
twi__send_data(DS1307__REG_CONTROL);
uint8_t register_value = (level == DS1307__SQW_LEVEL__LOW) ? 0x00 : 0x80;
twi__send_data(register_value);
twi__stop();
}
 
/**************************************************************************//**
* \fn void ds1307__set_square_wave_output_signal(
* ds1307__sqw_out__frequency_t frequency,
* bool enable)
*
* \brief Set Square-Wave output signal.
*
* \param frequency Frequency.
* \param enable Status.
******************************************************************************/
void
ds1307__set_square_wave_output_signal
(
ds1307__sqw_out__frequency_t frequency,
bool enable
){
uint8_t register_value = 0;
 
// Rate select.
switch (frequency)
{
case DS1307__SQW_FREQUENCY__4096_HZ:
register_value = _BV(DS1307__RS0);
break;
 
case DS1307__SQW_FREQUENCY__8192_HZ:
register_value = _BV(DS1307__RS1);
break;
 
case DS1307__SQW_FREQUENCY__32768_HZ:
register_value = _BV(DS1307__RS1) | _BV(DS1307__RS0);
break;
 
case DS1307__SQW_FREQUENCY__1_HZ:
default:
register_value = 0;
break;
}
 
// Square-Wave enable.
if (enable)
{
BIT__SET(register_value, DS1307__SQWE);
}
 
twi__start();
twi__send_slaw(DS1307__ADDRESS);
twi__send_data(DS1307__REG_CONTROL);
twi__send_data(register_value);
twi__stop();
}
 
/**************************************************************************//**
* \fn uint8_t ds1307__read_byte_in_ram(uint8_t address)
*
* \brief Read a byte in DS1307 RAM.
*
* \param address Address to read.
*
* \return Read byte.
******************************************************************************/
uint8_t
ds1307__read_byte_in_ram
(
uint8_t address
){
// Check the preconditions.
assert(address >= 0x08);
assert(address <= 0x3F);
 
uint8_t data = 0;
 
twi__start();
twi__send_slaw(DS1307__ADDRESS);
twi__send_data(address);
twi__stop();
 
twi__start();
twi__send_slar(DS1307__ADDRESS);
twi__receive_data_nack(&data);
twi__stop();
 
return data;
}
 
/**************************************************************************//**
* \fn void ds1307__read_bytes_in_ram(
* uint8_t address,
* uint8_t length,
* uint8_t* p_data)
*
* \brief Read bytes in DS1307 RAM.
*
* \param address Address to read.
* \param length Number of bytes to read.
* \param[in] p_data Buffer to fill.
******************************************************************************/
void
ds1307__read_bytes_in_ram
(
uint8_t address,
uint8_t length,
uint8_t* p_data
){
// Check the preconditions.
assert(NULL != p_data);
assert(address >= 0x08);
assert(address <= 0x3F);
assert(length <= 56);
 
twi__start();
twi__send_slaw(DS1307__ADDRESS);
twi__send_data(address);
twi__stop();
 
twi__start();
twi__send_slar(DS1307__ADDRESS);
for (uint8_t i = 0; i < length - 1; i++)
{
twi__receive_data_ack(p_data + i);
}
twi__receive_data_nack(p_data + length - 1);
twi__stop();
}
 
/**************************************************************************//**
* \fn void ds1307__write_byte_in_ram(uint8_t address, uint8_t data)
*
* \brief Write a byte in DS1307 RAM.
*
* \param address Address to write.
* \param data Byte to write.
******************************************************************************/
void
ds1307__write_byte_in_ram
(
uint8_t address,
uint8_t data
){
// Check the preconditions.
assert(address >= 0x08);
assert(address <= 0x3F);
 
twi__start();
twi__send_slaw(DS1307__ADDRESS);
twi__send_data(address);
twi__send_data(data);
twi__stop();
}
 
/**************************************************************************//**
* \fn void ds1307__write_bytes_in_ram(uint8_t address, uint8_t data)
*
* \brief Write a byte in DS1307 RAM.
*
* \param address Address to write.
* \param length Number of bytes to write.
* \param[in] p_data Bytes to write.
******************************************************************************/
void
ds1307__write_bytes_in_ram
(
uint8_t address,
uint8_t length,
uint8_t* p_data
){
// Check the preconditions.
assert(NULL != p_data);
assert(address >= 0x08);
assert(address <= 0x3F);
assert(length <= 56);
 
twi__start();
twi__send_slaw(DS1307__ADDRESS);
twi__send_data(address);
for (uint8_t i = 0; i < length; i++)
{
twi__send_data(p_data[i]);
}
twi__stop();
}
/trunk/libraries/ds1307/src/SConscript
0,0 → 1,13
# Import environment set for target.
Import('env_target')
 
# Define target name.
TARGET = 'ds1307'
 
# Define source files.
sources = [
'ds1307.c'
]
 
# Build library.
env_target.BuildLibrary(sources, TARGET)
/trunk/libraries/ds1307/demo/ds1307__demo.c
0,0 → 1,95
/**************************************************************************//**
* \brief DS1307 RTC library - Demonstration program
* \author Copyright (C) 2009 Julien Le Sech - www.idreammicro.com
* \version 1.0
* \date 20090501
*
* This file is part of the iDreamMicro library.
*
* This library is free software: you can redistribute it and/or modify it under
* the terms of the GNU Lesser General Public License as published by the Free
* Software Foundation, either version 3 of the License, or (at your option) any
* later version.
*
* This library is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
* FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more
* details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with this program. If not, see http://www.gnu.org/licenses/
******************************************************************************/
 
/**************************************************************************//**
* \file ds1307__demo.c
******************************************************************************/
 
/******************************************************************************
* Header file inclusions.
******************************************************************************/
 
#include "../ds1307.h"
 
#include <twi/twi.h>
#include <useful/datetime.h>
 
#include <util/delay.h>
 
#include <stdio.h>
 
/******************************************************************************
* Main function.
******************************************************************************/
 
/**************************************************************************//**
* \fn int main(void)
*
* \brief Main function.
*
* \return 0
******************************************************************************/
int main(void)
{
// Initialize TWI.
twi__initialize(DS1307__CLOCK_RATE);
 
// Initialize RTC.
ds1307__initialize();
 
// Declare some variables.
datetime__time_t time =
{
.seconds = 00,
.minutes = 29,
.hours = 19,
.meridiem = 0
};
ds1307__hour_mode_t hour_mode = DS1307__HOUR_MODE__24_HOUR;
 
datetime__date_t date =
{
.day = 3,
.date = 5,
.month = 5,
.year = 9
};
 
// Set time and hour mode.
ds1307__set_time(&time, hour_mode);
 
// Set date.
ds1307__set_date(&date);
 
for (;;)
{
// Get RTC time.
ds1307__get_time(&time, &hour_mode);
 
// Get RTC date.
ds1307__get_date(&date);
 
_delay_ms(100);
}
 
return 0;
}
/trunk/libraries/ds1307/demo/SConscript
0,0 → 1,16
# Import environment set for target.
Import('env_target')
 
# Set target name.
TARGET = 'ds1307__demo'
 
# Set source file.
sources = [
'ds1307__demo.c'
]
 
# Build project and libraries.
env_target.BuildProject(sources, TARGET)
 
# Compute memory usage.
env_target.ComputeMemoryUsage(TARGET)
/trunk/libraries/ds1307/test/SConscript
0,0 → 1,16
# Import environment set for target.
Import('env_target')
 
# Set target name.
TARGET = 'ds1307__test'
 
# Set source file.
sources = [
'ds1307__test.c'
]
 
# Build project and libraries.
env_target.BuildProject(sources, TARGET)
 
# Compute memory usage.
env_target.ComputeMemoryUsage(TARGET)
/trunk/libraries/ds1307/SConscript
0,0 → 1,16
# Import environment set for target.
Import('env_target')
 
# Define directories to process.
directories = [
'src/'
]
 
# Process directories.
for directory in directories:
SConscript(
directory + 'SConscript',
variant_dir = '#build/' + '/libraries/ds1307/' + env_target['NAME'],
exports = { 'env_target' : env_target },
duplicate = 0
)
/trunk/libraries/ds1307/SConstruct
0,0 → 1,40
# Import build tools.
SConscript('#min_env/build_tools.py')
 
# Set environment for AVR-GCC.
SConscript('#min_env/env_target.py')
 
# Import environment set for AVR-GCC.
Import('env_target')
 
# Append CPPPATH.
env_target.Append(CPPPATH = [ '#../' ])
 
# Build library.
SConscript(
'src/SConscript',
variant_dir = '#build/lib/',
exports = { 'env_target' : env_target },
duplicate = 0
)
 
# Append LIBPATH and LIBS.
env_target.Append(LIBPATH = [ '#build/lib/'])
env_target.Append(LIBS = [ 'ds1307' ])
 
# Build demonstration program.
SConscript(
'demo/SConscript',
variant_dir = '#build/demo/',
exports = { 'env_target' : env_target },
duplicate = 0
)
 
# Build test program.
SConscript(
'test/SConscript',
variant_dir = '#build/test/',
exports = { 'env_target' : env_target },
duplicate = 0
)
 
/trunk/libraries/ds1307/min_env/env_target.py
0,0 → 1,27
# Create and initialize the environment.
env_target = Environment()
 
# Set environment for AVR-GCC.
env_target['CC'] = 'avr-gcc'
env_target['CPPPATH'] = '/usr/lib/avr/include'
env_target['OBJCOPY'] = 'avr-objcopy'
env_target['SIZE'] = 'avr-size'
env_target['AR'] = 'avr-ar'
env_target['RANLIB'] = 'avr-ranlib'
env_target.Append(CCFLAGS = '-Os')
 
# Define environment name.
env_target.Append(NAME = 'env_target')
 
# Microcontroller type.
env_target.Append(MCU = 'atmega328p')
# Microcontroller frequency in Hertz.
env_target.Append(F_CPU = '16000000UL')
 
# Set environment for an Atmel AVR ATmega328p microcontroller.
env_target.Append(CCFLAGS = '-mmcu=' + env_target['MCU'])
env_target.Append(LINKFLAGS = '-mmcu=' + env_target['MCU'])
env_target.Append(CPPDEFINES = 'F_CPU=' + env_target['F_CPU'])
 
# Export environment set for target.
Export('env_target')
/trunk/libraries/ds1307/min_env/build_tools.py
0,0 → 1,41
"""
Build project.
"""
def BuildProject(env, sources, target_name):
# Build program.
env.Program(target = target_name + '.elf', source = sources)
# Create hex binary file.
env.Command(
target_name + '.hex',
target_name + '.elf',
env['OBJCOPY'] + ' -O ihex $SOURCE $TARGET'
)
AddMethod(Environment, BuildProject)
 
"""
Build library.
"""
def BuildLibrary(env, sources, target_name):
# Build static library.
env.StaticLibrary(target = target_name, source = sources)
# Append LIBPATH and LIBS.
env.Append(LIBPATH = [ '#build/libraries/' + target_name + '/' + env['NAME'] ])
env.Append(LIBS = [ target_name ])
 
AddMethod(Environment, BuildLibrary)
 
"""
Compute memory usage.
"""
def ComputeMemoryUsage(env, target_name):
# Compute memory usage.
env.Command(
None,
target_name + '.elf',
env['SIZE'] + ' -C --mcu=' + env['MCU'] + ' $SOURCE'
)
AddMethod(Environment, ComputeMemoryUsage)
/trunk/libraries/adc/demo/SConscript
0,0 → 1,16
# Import environment set for target.
Import('env_target')
 
# Set target name.
TARGET = 'adc__demo'
 
# Set source file.
sources = [
'adc__demo.c'
]
 
# Build project and libraries.
env_target.BuildProject(sources, TARGET)
 
# Compute memory usage.
env_target.ComputeMemoryUsage(TARGET)
/trunk/libraries/adc/demo/adc__demo.c
0,0 → 1,60
/**************************************************************************//**
* \brief ADC library - Demonstration program
* \author Copyright (C) 2012 Julien Le Sech - www.idreammicro.com
* \version 1.0
* \date 20121104
*
* This file is part of the iDreamMicro library.
*
* This library is free software: you can redistribute it and/or modify it under
* the terms of the GNU Lesser General Public License as published by the Free
* Software Foundation, either version 3 of the License, or (at your option) any
* later version.
*
* This library is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
* FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more
* details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with this program. If not, see http://www.gnu.org/licenses/
******************************************************************************/
 
/**************************************************************************//**
* \file adc__demo.c
******************************************************************************/
 
/******************************************************************************
* Header file inclusions.
******************************************************************************/
 
#include "../adc.h"
 
#include <util/delay.h>
 
/******************************************************************************
* Main function.
******************************************************************************/
 
/**************************************************************************//**
* \fn int main(void)
*
* \brief Main function.
******************************************************************************/
int
main
(
void
){
// Initialize ADC.
adc__single_channel_initialize(ADC__CHANNEL_0);
 
for (;;)
{
// Read ADC value.
uint16_t value = adc__single_channel_read();
_delay_ms(100);
}
 
return 0;
}
/trunk/libraries/adc/src/adc.c
0,0 → 1,98
/**************************************************************************//**
* \brief ADC library.
* \author Copyright (C) 2012 Julien Le Sech - www.idreammicro.com
* \version 1.0
* \date 20121029
*
* This file is part of the iDreamMicro library.
*
* This library is free software: you can redistribute it and/or modify it under
* the terms of the GNU Lesser General Public License as published by the Free
* Software Foundation, either version 3 of the License, or (at your option) any
* later version.
*
* This library is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
* FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more
* details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with this program. If not, see http://www.gnu.org/licenses/
******************************************************************************/
 
/**************************************************************************//**
* \file adc.c
******************************************************************************/
 
/******************************************************************************
* Header file inclusions.
******************************************************************************/
 
#include "../adc.h"
 
#include <useful/bits.h>
 
#include <avr/io.h>
 
#include <stdint.h>
 
/******************************************************************************
* Public function definitions.
******************************************************************************/
 
/**************************************************************************//**
* \fn void adc__single_channel_initialize(adc__channel_t channel)
*
* \brief Initialize ADC.
*
* \param channel ADC channel.
******************************************************************************/
void
adc__single_channel_initialize
(
adc__channel_t channel
){
// Enable ADC.
BIT__SET(ADCSRA, ADEN);
 
// Clock prescaled by 16.
// If Clock speed is 16 MHz, then ADC clock = 16 MHz / 16 = 1 MHz.
ADCSRA |= 0b00000100;
 
// Disable Digital Input on ADC Channel 0 to reduce power consumption
DIDR0 = 0b00111111;
 
// Disable Left-Adjust.
ADMUX = 0b01000000;
 
// Select ADC channel as input.
ADMUX |= channel;
}
 
/**************************************************************************//**
* \fn uint16_t adc__single_channel_read(void)
*
* \brief Read ADC.
*
* \return Read value.
******************************************************************************/
uint16_t
adc__single_channel_read
(
void
){
// Start ADC Conversion.
BIT__SET(ADCSRA, ADSC);
 
// Wait till conversion is complete.
//while ((ADCSRA & (1 << ADIF)) != 0x10);
while (!BIT__TST(ADCSRA, ADIF));
 
// Read the ADC Result.
uint16_t value = ADC;
 
// Clear ADC Conversion Interrupt Flag.
BIT__RST(ADCSRA, ADIF);
 
return value;
}
/trunk/libraries/adc/src/SConscript
0,0 → 1,13
# Import environment set for target.
Import('env_target')
 
# Define target name.
TARGET = 'adc'
 
# Define source files.
sources = [
'adc.c'
]
 
# Build library.
env_target.BuildLibrary(sources, TARGET)
/trunk/libraries/adc/min_env/env_target.py
0,0 → 1,27
# Create and initialize the environment.
env_target = Environment()
 
# Set environment for AVR-GCC.
env_target['CC'] = 'avr-gcc'
env_target['CPPPATH'] = '/usr/lib/avr/include'
env_target['OBJCOPY'] = 'avr-objcopy'
env_target['SIZE'] = 'avr-size'
env_target['AR'] = 'avr-ar'
env_target['RANLIB'] = 'avr-ranlib'
env_target.Append(CCFLAGS = '-Os')
 
# Define environment name.
env_target.Append(NAME = 'env_target')
 
# Microcontroller type.
env_target.Append(MCU = 'atmega328p')
# Microcontroller frequency in Hertz.
env_target.Append(F_CPU = '16000000UL')
 
# Set environment for an Atmel AVR ATmega328p microcontroller.
env_target.Append(CCFLAGS = '-mmcu=' + env_target['MCU'])
env_target.Append(LINKFLAGS = '-mmcu=' + env_target['MCU'])
env_target.Append(CPPDEFINES = 'F_CPU=' + env_target['F_CPU'])
 
# Export environment set for target.
Export('env_target')
/trunk/libraries/adc/min_env/build_tools.py
0,0 → 1,41
"""
Build project.
"""
def BuildProject(env, sources, target_name):
# Build program.
env.Program(target = target_name + '.elf', source = sources)
# Create hex binary file.
env.Command(
target_name + '.hex',
target_name + '.elf',
env['OBJCOPY'] + ' -O ihex $SOURCE $TARGET'
)
AddMethod(Environment, BuildProject)
 
"""
Build library.
"""
def BuildLibrary(env, sources, target_name):
# Build static library.
env.StaticLibrary(target = target_name, source = sources)
# Append LIBPATH and LIBS.
env.Append(LIBPATH = [ '#build/libraries/' + target_name + '/' + env['NAME'] ])
env.Append(LIBS = [ target_name ])
 
AddMethod(Environment, BuildLibrary)
 
"""
Compute memory usage.
"""
def ComputeMemoryUsage(env, target_name):
# Compute memory usage.
env.Command(
None,
target_name + '.elf',
env['SIZE'] + ' -C --mcu=' + env['MCU'] + ' $SOURCE'
)
AddMethod(Environment, ComputeMemoryUsage)
/trunk/libraries/adc/adc.h
0,0 → 1,99
/**************************************************************************//**
* \brief ADC library.
* \author Copyright (C) 2012 Julien Le Sech - www.idreammicro.com
* \version 1.0
* \date 20121029
*
* This file is part of the iDreamMicro library.
*
* This library is free software: you can redistribute it and/or modify it under
* the terms of the GNU Lesser General Public License as published by the Free
* Software Foundation, either version 3 of the License, or (at your option) any
* later version.
*
* This library is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
* FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more
* details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with this program. If not, see http://www.gnu.org/licenses/
******************************************************************************/
 
/**************************************************************************//**
* \headerfile adc.h
******************************************************************************/
 
#ifndef H__IDREAMMICRO__ADC__H
#define H__IDREAMMICRO__ADC__H
 
#ifdef _cplusplus
extern "C"{
#endif
 
/******************************************************************************
* Header file inclusions.
******************************************************************************/
 
#include <stdint.h>
 
/******************************************************************************
* Public type definitions.
******************************************************************************/
 
/**************************************************************************//**
* \enum adc__channels
* \brief ADC channels.
*
* \typedef adc__channel_t
* \brief ADC channel.
******************************************************************************/
typedef enum adc__channels
{
ADC__CHANNEL_0, /*!< Channel 0. */
ADC__CHANNEL_1, /*!< Channel 1. */
ADC__CHANNEL_2, /*!< Channel 2. */
ADC__CHANNEL_3, /*!< Channel 3. */
ADC__CHANNEL_4, /*!< Channel 4. */
ADC__CHANNEL_5, /*!< Channel 5. */
ADC__CHANNEL_6, /*!< Channel 6. */
ADC__CHANNEL_7, /*!< Channel 7. */
ADC__CHANNEL_8 /*!< Channel 8. */
} adc__channel_t;
 
/******************************************************************************
* Public function prototypes.
******************************************************************************/
 
/**************************************************************************//**
* \fn void adc__single_channel_initialize(adc__channel_t channel)
*
* \brief Initialize ADC.
*
* \param channel ADC channel.
******************************************************************************/
void
adc__single_channel_initialize
(
adc__channel_t channel
);
 
/**************************************************************************//**
* \fn uint16_t adc__single_channel_read(void)
*
* \brief Read ADC.
*
* \return Read value.
******************************************************************************/
uint16_t
adc__single_channel_read
(
void
);
 
#ifdef _cplusplus
}
#endif
 
#endif /* H__IDREAMMICRO__ADC__H */
 
/trunk/libraries/adc/SConscript
0,0 → 1,16
# Import environment set for target.
Import('env_target')
 
# Define directories to process.
directories = [
'src/'
]
 
# Process directories.
for directory in directories:
SConscript(
directory + 'SConscript',
variant_dir = '#build/' + '/libraries/adc/' + env_target['NAME'],
exports = { 'env_target' : env_target },
duplicate = 0
)
/trunk/libraries/adc/SConstruct
0,0 → 1,40
# Import build tools.
SConscript('#min_env/build_tools.py')
 
# Set environment for AVR-GCC.
SConscript('#min_env/env_target.py')
 
# Import environment set for AVR-GCC.
Import('env_target')
 
# Append CPPPATH.
env_target.Append(CPPPATH = [ '#../' ])
 
# Build library.
SConscript(
'src/SConscript',
variant_dir = '#build/lib/',
exports = { 'env_target' : env_target },
duplicate = 0
)
 
# Append LIBPATH and LIBS.
env_target.Append(LIBPATH = [ '#build/lib/'])
env_target.Append(LIBS = [ 'adc' ])
 
# Build demonstration program.
SConscript(
'demo/SConscript',
variant_dir = '#build/demo/',
exports = { 'env_target' : env_target },
duplicate = 0
)
 
# Build test program.
SConscript(
'test/SConscript',
variant_dir = '#build/test/',
exports = { 'env_target' : env_target },
duplicate = 0
)
 
/trunk/libraries/adc
Modification de propriétés sur libraries/adc
___________________________________________________________________
Added: svn:ignore
## -0,0 +1,2 ##
+build
+.sconsign.dblite
/trunk/libraries/deuligne/demo/deuligne__demo.c
0,0 → 1,103
/**************************************************************************//**
* \brief Deuligne library - Demonstration program
* \author Copyright (C) 2011 Julien Le Sech - www.idreammicro.com
* \version 1.0
* \date 20121026
*
* This file is part of the iDreamMicro library.
*
* This library is free software: you can redistribute it and/or modify it under
* the terms of the GNU Lesser General Public License as published by the Free
* Software Foundation, either version 3 of the License, or (at your option) any
* later version.
*
* This library is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
* FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more
* details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with this program. If not, see http://www.gnu.org/licenses/
******************************************************************************/
 
/**************************************************************************//**
* \file deuligne__demo.c
******************************************************************************/
 
/******************************************************************************
* Header file inclusions.
******************************************************************************/
 
#include <deuligne/deuligne.h>
#include <mcp23008/mcp23008.h>
#include <twi/twi.h>
 
#include <util/delay.h>
 
#include <stdio.h>
 
/******************************************************************************
* Private constant definitions.
******************************************************************************/
 
static const char* strings[] =
{
[DEULIGNE__KEY__RIGHT] = "Right Key OK ",
[DEULIGNE__KEY__UP] = "Up Key OK ",
[DEULIGNE__KEY__DOWN] = "Down Key OK ",
[DEULIGNE__KEY__LEFT] = "Left Key OK ",
[DEULIGNE__KEY__SELECT] = "Select Key OK"
};
 
/******************************************************************************
* Public function definitions.
******************************************************************************/
 
/**************************************************************************//**
* \fn int main(void)
*
* \brief Main function.
******************************************************************************/
int
main
(
void
){
// Initialize TWI.
twi__initialize(MCP23008__CLOCK_RATE);
 
// Initialize Deuligne and configure display.
deuligne__initialize();
deuligne__set_display(true, false, false);
 
// Switch on backlight.
deuligne__switch_on_backlight();
 
deuligne__set_cursor_position(DEULIGNE__DISPLAY_LINE_1, 5);
deuligne__write_string("Setup");
deuligne__set_cursor_position(DEULIGNE__DISPLAY_LINE_2, 7);
deuligne__write_string("ok");
_delay_ms(2000);
 
deuligne__clear_display();
deuligne__write_string("Move Joystick");
 
// Infinite loop.
for(;;)
{
// Get key.
deuligne__key_t key = deuligne__get_key();
if (key != DEULIGNE__KEY__NONE)
{
// Set cursor position.
deuligne__set_cursor_position(DEULIGNE__DISPLAY_LINE_2, 0);
 
// Write string.
deuligne__write_string(strings[key]);
}
 
_delay_ms(250);
}
 
return 0;
}
/trunk/libraries/deuligne/demo/SConscript
0,0 → 1,26
# Import environment set for target.
Import('env_target')
 
# Set target name.
TARGET = 'deuligne__demo'
 
# Set libraries to use.
libraries = [
'deuligne',
'mcp23008',
'adc',
'twi'
]
 
# Set source file.
sources = [
'deuligne__demo.c'
]
 
# Build project and libraries.
env_target.BuildProject(sources, TARGET)
 
# Compute memory usage.
env_target.ComputeMemoryUsage(TARGET)
/trunk/libraries/deuligne/min_env/env_target.py
0,0 → 1,27
# Create and initialize the environment.
env_target = Environment()
 
# Set environment for AVR-GCC.
env_target['CC'] = 'avr-gcc'
env_target['CPPPATH'] = '/usr/lib/avr/include'
env_target['OBJCOPY'] = 'avr-objcopy'
env_target['SIZE'] = 'avr-size'
env_target['AR'] = 'avr-ar'
env_target['RANLIB'] = 'avr-ranlib'
env_target.Append(CCFLAGS = '-Os')
 
# Define environment name.
env_target.Append(NAME = 'env_target')
 
# Microcontroller type.
env_target.Append(MCU = 'atmega328p')
# Microcontroller frequency in Hertz.
env_target.Append(F_CPU = '16000000UL')
 
# Set environment for an Atmel AVR ATmega328p microcontroller.
env_target.Append(CCFLAGS = '-mmcu=' + env_target['MCU'])
env_target.Append(LINKFLAGS = '-mmcu=' + env_target['MCU'])
env_target.Append(CPPDEFINES = 'F_CPU=' + env_target['F_CPU'])
 
# Export environment set for target.
Export('env_target')
/trunk/libraries/deuligne/min_env/build_tools.py
0,0 → 1,41
"""
Build project.
"""
def BuildProject(env, sources, target_name):
# Build program.
env.Program(target = target_name + '.elf', source = sources)
# Create hex binary file.
env.Command(
target_name + '.hex',
target_name + '.elf',
env['OBJCOPY'] + ' -O ihex $SOURCE $TARGET'
)
AddMethod(Environment, BuildProject)
 
"""
Build library.
"""
def BuildLibrary(env, sources, target_name):
# Build static library.
env.StaticLibrary(target = target_name, source = sources)
# Append LIBPATH and LIBS.
env.Append(LIBPATH = [ '#build/libraries/' + target_name + '/' + env['NAME'] ])
env.Append(LIBS = [ target_name ])
 
AddMethod(Environment, BuildLibrary)
 
"""
Compute memory usage.
"""
def ComputeMemoryUsage(env, target_name):
# Compute memory usage.
env.Command(
None,
target_name + '.elf',
env['SIZE'] + ' -C --mcu=' + env['MCU'] + ' $SOURCE'
)
AddMethod(Environment, ComputeMemoryUsage)
/trunk/libraries/deuligne/deuligne.h
0,0 → 1,344
/**************************************************************************//**
* \brief Snootlab Deuligne library
* \author Copyright (C) 2012 Julien Le Sech - www.idreammicro.com
* \version 1.0
* \date 20121026
*
* This file is part of the iDreamMicro library.
*
* This library is free software: you can redistribute it and/or modify it under
* the terms of the GNU Lesser General Public License as published by the Free
* Software Foundation, either version 3 of the License, or (at your option) any
* later version.
*
* This library is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
* FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more
* details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with this program. If not, see http://www.gnu.org/licenses/
******************************************************************************/
 
/**************************************************************************//**
* \headerfile deuligne.h
******************************************************************************/
 
#ifndef H__IDREAMMICRO__DEULIGNE__H
#define H__IDREAMMICRO__DEULIGNE__H
 
#ifdef _cplusplus
extern "C"{
#endif
 
/******************************************************************************
* Header file inclusions.
******************************************************************************/
 
#include <stdbool.h>
#include <stdint.h>
 
/******************************************************************************
* Public types.
******************************************************************************/
 
/**************************************************************************//**
* \enum deuligne__keys
* \brief Available keys.
*
* \typedef deuligne__key_t
* \brief Key.
******************************************************************************/
typedef enum deuligne__keys
{
DEULIGNE__KEY__RIGHT,
DEULIGNE__KEY__UP,
DEULIGNE__KEY__DOWN,
DEULIGNE__KEY__LEFT,
DEULIGNE__KEY__SELECT,
DEULIGNE__KEY__NONE
} deuligne__key_t;
 
/**************************************************************************//**
* \enum deuligne__display_lines
* \brief LCD display lines.
*
* \typedef deuligne__display_line_t
* \brief LCD display line.
******************************************************************************/
typedef enum deuligne__display_lines
{
DEULIGNE__DISPLAY_LINE_1, /*!< One line display. */
DEULIGNE__DISPLAY_LINE_2 /*!< Two lines or more display. */
} deuligne__display_line_t;
 
/**************************************************************************//**
* \enum lcd__character_fonts
* \brief LCD character fonts.
*
* \typedef lcd__character_font_t
* \brief LCD character font.
******************************************************************************/
typedef enum deuligne__character_fonts
{
DEULIGNE__CHARACTER_FONT_5x8_DOTS, /*!< 5x8 character font. */
DEULIGNE__CHARACTER_FONT_5x10_DOTS /*!< 5x10 character font. */
} deuligne__character_font_t;
 
/**************************************************************************//**
* \enum lcd__address_modes
* \brief LCD address modes.
*
* \typedef lcd__address_mode_t
* \brief LCD address mode.
******************************************************************************/
typedef enum deuligne__address_modes
{
DEULIGNE__INCREMENT_ADDRESS, /*!< Increment address. */
DEULIGNE__DECREMENT_ADDRESS /*!< Decrement address. */
} deuligne__address_mode_t;
 
/**************************************************************************//**
* \enum lcd__display_shifts
* \brief LCD display shift types.
*
* \typedef lcd__display_shift_t
* \brief LCD display shift type.
******************************************************************************/
typedef enum deuligne__display_shifts
{
DEULIGNE__DISPLAY_SHIFT_DISABLED, /*!< Display shift disabled. */
DEULIGNE__DISPLAY_SHIFT_RIGHT, /*!< Display shift to right. */
DEULIGNE__DISPLAY_SHIFT_LEFT /*!< Display shift to left */
} deuligne__display_shift_t;
 
/**************************************************************************//**
* \enum lcd__shift_directions
* \brief LCD shift directions.
*
* \typedef lcd__shift_direction_t
* \brief LCD shift direction.
******************************************************************************/
typedef enum deuligne__shift_directions
{
DEULIGNE__SHIFT_DIRECTION_RIGHT, /*!< Shift to right. */
DEULIGNE__SHIFT_DIRECTION_LEFT /*!< Shift to left. */
} deuligne__shift_direction_t;
 
/**************************************************************************//**
* \enum lcd__lines
* \brief LCD lines.
*
* \typedef lcd__line_t
* \brief LCD line.
******************************************************************************/
typedef enum deuligne__lines
{
DEULIGNE__LINE_1, /*!< Line 1. */
DEULIGNE__LINE_2, /*!< Line 2. */
DEULIGNE__LINE_3, /*!< Line 3. */
DEULIGNE__LINE_4 /*!< Line 4. */
} deuligne__line_t;
 
/******************************************************************************
* Public function prototypes.
******************************************************************************/
 
/**************************************************************************//**
* \fn void deuligne__initialize(void)
*
* \brief Initialize Deuligne.
******************************************************************************/
void
deuligne__initialize
(
void
);
 
/**************************************************************************//**
* \fn void deuligne__set_function(
* deuligne__display_line_t display_line,
* deuligne__character_font_t character_font)
*
* \brief Set the number of lines available on LCD display and the character font.
*
* \param display_line number of lines
* \param character_font character font
******************************************************************************/
void
deuligne__set_function
(
deuligne__display_line_t display_line,
deuligne__character_font_t character_font
);
 
/**************************************************************************//**
* \fn void deuligne__set_entry_mode(
* deuligne__address_mode_t address_mode,
* deuligne__display_shift_t display_shift)
*
* \brief Set LCD display entry mode.
*
* \param address_mode specify if DDRAM address is incremented or decremented
* when a character code is written
* \param display_shift set the display shift when a character code is written
******************************************************************************/
void
deuligne__set_entry_mode
(
deuligne__address_mode_t address_mode,
deuligne__display_shift_t display_shift
);
 
/**************************************************************************//**
* \fn void deuligne__set_display(
* bool enable_display,
* bool enable_cursor_display,
* bool enable_cursor_blink)
*
* \brief Set LCD display.
* Enable or disable display, cursor display and cursor blink.
*
* \param enable_display true to enable display or false in contrary case
* \param enable_cursor_display true to enable cursor display or false in
* contrary case
* \param enable_cursor_blink true to enable cursor blink or false in contrary
* case
******************************************************************************/
void
deuligne__set_display
(
bool enable_display,
bool enable_cursor_display,
bool enable_cursor_blink
);
 
/**************************************************************************//**
* \fn void deuligne__clear_display(void)
*
* \brief Clear LCD display.
******************************************************************************/
void
deuligne__clear_display
(
void
);
 
/**************************************************************************//**
* \fn void deuligne__return_home(void)
*
* \brief Set cursor on the first column of the first line.
******************************************************************************/
void
deuligne__return_home
(
void
);
 
/**************************************************************************//**
*\fn void deuligne__set_cursor_position(deuligne__line_t line, uint8_t column)
*
* \brief Set cursor position.
*
* \param line destination line
* \param column destination column
******************************************************************************/
void
deuligne__set_cursor_position
(
deuligne__line_t line,
uint8_t column
);
 
/**************************************************************************//**
* \fn void deuligne__shift_display(deuligne__shift_direction_t shift_direction)
*
* \brief Shift the display on the right or on the left.
*
* \param shift_direction display shift direction
******************************************************************************/
void
deuligne__shift_display
(
deuligne__shift_direction_t shift_direction
);
 
/**************************************************************************//**
* \fn void deuligne__shift_cursor(deuligne__shift_direction_t shift_direction)
*
* \brief Shift the cursor on the right or on the left.
*
* \param shift_direction cursor shift direction
******************************************************************************/
void
deuligne__shift_cursor
(
deuligne__shift_direction_t shift_direction
);
 
/**************************************************************************//**
* \fn void deuligne__switch_on_backlight(void)
*
* \brief Switch on LCD backlight.
******************************************************************************/
void
deuligne__switch_on_backlight
(
void
);
 
/**************************************************************************//**
* \fn void deuligne__switch_off(voif)
*
* \brief Switch off backlight.
******************************************************************************/
void
deuligne__switch_off_backlight
(
void
);
 
/**************************************************************************//**
* \fn void deuligne__write_char(char data)
*
* \brief Write a character on LCD.
*
* \param data Character to write.
******************************************************************************/
void
deuligne__write_char
(
char data
);
 
/**************************************************************************//**
* \fn void deuligne__write_string(const char* string_to_write)
*
* \brief Write a string on LCD display from current cursor position.
*
* \param string_to_write string to write
******************************************************************************/
void
deuligne__write_string
(
const char* string_to_write
);
 
/**************************************************************************//**
* \fn void deuligne__get_key(void)
*
* \brief Get key.
*
* \return Key.
******************************************************************************/
deuligne__key_t
deuligne__get_key
(
void
);
 
#ifdef _cplusplus
}
#endif
 
#endif /* H__IDREAMMICRO__DEULIGNE__H */
/trunk/libraries/deuligne/src/SConscript
0,0 → 1,13
# Import environment set for target.
Import('env_target')
 
# Define target name.
TARGET = 'deuligne'
 
# Define source files.
sources = [
'deuligne.c'
]
 
# Build library.
env_target.BuildLibrary(sources, TARGET)
/trunk/libraries/deuligne/src/deuligne.c
0,0 → 1,733
/**************************************************************************//**
* \brief Snootlab Deuligne library
* \author Copyright (C) 2012 Julien Le Sech - www.idreammicro.com
* \version 1.0
* \date 20121026
*
* This file is part of the iDreamMicro library.
*
* This library is free software: you can redistribute it and/or modify it under
* the terms of the GNU Lesser General Public License as published by the Free
* Software Foundation, either version 3 of the License, or (at your option) any
* later version.
*
* This library is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
* FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more
* details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with this program. If not, see http://www.gnu.org/licenses/
******************************************************************************/
 
/**************************************************************************//**
* \headerfile deuligne.c
******************************************************************************/
 
/******************************************************************************
* Header file inclusions.
******************************************************************************/
 
#include "../deuligne.h"
 
#include <adc/adc.h>
#include <mcp23008/mcp23008.h>
 
#include <util/delay.h>
 
#include <assert.h>
#include <stdbool.h>
#include <stdint.h>
#include <stdlib.h>
 
/******************************************************************************
* Private macro definitions.
******************************************************************************/
 
/**************************************************************************//**
* \def DEULIGNE__HARDWARE_ADDRESS
* \brief MCP23008 hardware address. Pins A0 to A3.
******************************************************************************/
#define DEULIGNE__HARDWARE_ADDRESS 0x07
 
#define DEULIGNE__GPIO_E 4
#define DEULIGNE__GPIO_RW 5
#define DEULIGNE__GPIO_RS 6
#define DEULIGNE__GPIO_BACKLIGHT 7
 
/**************************************************************************//**
* \def LCD__CMD_CLEAR_DISPLAY
* \brief Clear display.
******************************************************************************/
#define LCD__CMD_CLEAR_DISPLAY 0x01
 
/**************************************************************************//**
* \def LCD__CMD_RETURN_HOME
* \brief Return Home (execution time = 1.52 ms).
******************************************************************************/
#define LCD__CMD_RETURN_HOME 0x02
 
// Function set (execution time = 37 s).
#define LCD__CMD_FUNCTION_SET 0x20
#define LCD__CMD_DATA_LENGTH_4_BIT 0x00
#define LCD__CMD_DATA_LENGTH_8_BIT 0x10
#define LCD__CMD_DISPLAY_LINE_1 0x00
#define LCD__CMD_DISPLAY_LINE_2 0x08
#define LCD__CMD_CHARACTER_FONT_5x8_DOTS 0x00
#define LCD__CMD_CHARACTER_FONT_5x10_DOTS 0x04
 
// Set entry mode (execution time = 37 s).
#define LCD__CMD_ENTRY_MODE_SET 0x04
#define LCD__CMD_INCREMENT_ADDRESS 0x02
#define LCD__CMD_DECREMENT_ADDRESS 0x00
#define LCD__CMD_DISPLAY_SHIFT_DISABLED 0x00
#define LCD__CMD_DISPLAY_SHIFT_RIGHT 0x01
#define LCD__CMD_DISPLAY_SHIFT_LEFT 0x03
 
// Display on/off control (execution time = 37 s).
#define LCD__CMD_DISPLAY_CONTROL 0x08
#define LCD__CMD_ENABLE_DISPLAY 0x04
#define LCD__CMD_DISABLE_DISPLAY 0x00
#define LCD__CMD_ENABLE_CURSOR_DISPLAY 0x02
#define LCD__CMD_DISABLE_CURSOR_DISPLAY 0x00
#define LCD__CMD_ENABLE_CURSOR_BLINK 0x01
#define LCD__CMD_DISABLE_CURSOR_BLINK 0x00
 
// Cursor or display shift (execution time = 37 s).
#define LCD__CMD_CURSOR_OR_DISPLAY_SHIFT 0x10
#define LCD__CMD_SHIFT_CURSOR 0x00
#define LCD__CMD_SHIFT_DISPLAY 0x08
#define LCD__CMD_SHIFT_RIGHT 0x04
#define LCD__CMD_SHIFT_LEFT 0x00
 
// CGRAM address.
#define LCD__CMD_SET_CGRAM_ADDRESS 0x40
 
// DDRAM address.
#define LCD__CMD_SET_DDRAM_ADDRESS 0x80
 
// Line addresses.
#define LCD__LINE_1_ADDRESS 0x40
#define LCD__LINE_2_ADDRESS 0x80
#define LCD__LINE_3_ADDRESS 0x54
#define LCD__LINE_4_ADDRESS 0x94
 
/******************************************************************************
* Private function prototypes.
******************************************************************************/
 
/**************************************************************************//**
* \fn static void deuligne__write_command(uint8_t command)
*
* \brief Write a command on LCD port.
*
* \param command Command to write.
******************************************************************************/
static
void
deuligne__write_command
(
uint8_t command
);
 
/**************************************************************************//**
* \fn static void deuligne__write_byte(uint8_t data)
*
* \brief Write a byte on LCD port.
*
* \param data Byte to write.
******************************************************************************/
static
void
deuligne__write_byte
(
uint8_t data
);
 
/**************************************************************************//**
* \fn static void deuligne__write_high_nibble(uint8_t data)
*
* \brief Write the high nibble of a byte on LCD port.
*
* \param data Byte which write high nibble.
******************************************************************************/
static
void
deuligne__write_high_nibble
(
uint8_t data
);
 
/**************************************************************************//**
* \fn static void deuligne__enable_data(void)
*
* \brief Enable data on LCD port.
******************************************************************************/
static
void
deuligne__enable_data
(
void
);
 
/******************************************************************************
* Private constant definitions.
******************************************************************************/
 
/**************************************************************************//**
*
******************************************************************************/
static const uint16_t deuligne__adc_values[] =
{
[DEULIGNE__KEY__RIGHT] = 50,
[DEULIGNE__KEY__UP] = 190,
[DEULIGNE__KEY__DOWN] = 400,
[DEULIGNE__KEY__LEFT] = 540,
[DEULIGNE__KEY__SELECT] = 770,
[DEULIGNE__KEY__NONE] = 1024
};
 
/******************************************************************************
* Public function definitions.
******************************************************************************/
 
/**************************************************************************//**
* \fn void deuligne__initialize(void)
*
* \brief Initialize Deuligne.
******************************************************************************/
void
deuligne__initialize
(
void
){
// Initialize MCP23008.
mcp23008__initialize(DEULIGNE__HARDWARE_ADDRESS);
 
// Configure all GPIOs in output.
mcp23008__configure_port(0x00);
 
mcp23008__set_pin_level(DEULIGNE__GPIO_RW, MCP23008__LEVEL__LOW);
 
// Wait for LCD display power-up initialization.
_delay_ms(45);
 
// Initialize LCD display.
 
// Set interface.
deuligne__write_high_nibble(LCD__CMD_FUNCTION_SET | LCD__CMD_DATA_LENGTH_8_BIT);
deuligne__write_high_nibble(LCD__CMD_FUNCTION_SET | LCD__CMD_DATA_LENGTH_8_BIT);
deuligne__write_high_nibble(LCD__CMD_FUNCTION_SET | LCD__CMD_DATA_LENGTH_8_BIT);
deuligne__write_high_nibble(LCD__CMD_FUNCTION_SET | LCD__CMD_DATA_LENGTH_4_BIT);
 
// Set function.
deuligne__set_function(DEULIGNE__DISPLAY_LINE_2, DEULIGNE__CHARACTER_FONT_5x8_DOTS);
 
// Set entry mode.
deuligne__set_entry_mode(DEULIGNE__INCREMENT_ADDRESS, DEULIGNE__DISPLAY_SHIFT_DISABLED);
 
// Clear display.
deuligne__clear_display();
 
// Initialize ADC.
adc__single_channel_initialize(ADC__CHANNEL_0);
}
 
/**************************************************************************//**
* \fn void deuligne__switch_on_backlight(void)
*
* \brief Switch on backlight.
******************************************************************************/
void
deuligne__switch_on_backlight
(
void
){
mcp23008__set_pin_level(DEULIGNE__GPIO_BACKLIGHT, MCP23008__LEVEL__HIGH);
}
 
/**************************************************************************//**
* \fn void deuligne__switch_off_backlight(void)
*
* \brief Switch off backlight.
******************************************************************************/
void
deuligne__switch_off_backlight
(
void
){
mcp23008__set_pin_level(DEULIGNE__GPIO_BACKLIGHT, MCP23008__LEVEL__LOW);
}
 
/**************************************************************************//**
* \fn void deuligne__set_function(
* deuligne__display_line_t display_line,
* deuligne__character_font_t character_font)
*
* \brief Set the number of lines available on LCD display and the character font.
*
* \param display_line number of lines
* \param character_font character font
******************************************************************************/
void
deuligne__set_function
(
deuligne__display_line_t display_line,
deuligne__character_font_t character_font
){
uint8_t command = LCD__CMD_FUNCTION_SET;
 
switch (display_line)
{
case DEULIGNE__DISPLAY_LINE_1:
{
command |= LCD__CMD_DISPLAY_LINE_1;
}
break;
 
case DEULIGNE__DISPLAY_LINE_2:
{
command |= LCD__CMD_DISPLAY_LINE_2;
}
break;
 
default:
break;
}
 
switch (character_font)
{
case DEULIGNE__CHARACTER_FONT_5x8_DOTS:
{
command |= LCD__CMD_CHARACTER_FONT_5x8_DOTS;
}
break;
 
case DEULIGNE__CHARACTER_FONT_5x10_DOTS:
{
command |= LCD__CMD_CHARACTER_FONT_5x10_DOTS;
}
break;
 
default:
break;
}
 
deuligne__write_command(command);
}
 
/**************************************************************************//**
* \fn void deuligne__set_entry_mode(
* deuligne__address_mode_t address_mode,
* deuligne__display_shift_t display_shift)
*
* \brief Set LCD display entry mode.
*
* \param address_mode specify if DDRAM address is incremented or decremented
* when a character code is written
* \param display_shift set the display shift when a character code is written
******************************************************************************/
void
deuligne__set_entry_mode
(
deuligne__address_mode_t address_mode,
deuligne__display_shift_t display_shift
){
uint8_t command = LCD__CMD_ENTRY_MODE_SET;
 
switch (address_mode)
{
case DEULIGNE__INCREMENT_ADDRESS:
{
command |= LCD__CMD_INCREMENT_ADDRESS;
}
break;
 
case DEULIGNE__DECREMENT_ADDRESS:
{
command |= LCD__CMD_DECREMENT_ADDRESS;
}
break;
 
default:
break;
}
 
switch (display_shift)
{
case DEULIGNE__DISPLAY_SHIFT_DISABLED:
{
command |= LCD__CMD_DISPLAY_SHIFT_DISABLED;
}
break;
 
case DEULIGNE__DISPLAY_SHIFT_RIGHT:
{
command |= LCD__CMD_DISPLAY_SHIFT_RIGHT;
}
break;
 
case DEULIGNE__DISPLAY_SHIFT_LEFT:
{
command |= LCD__CMD_DISPLAY_SHIFT_LEFT;
}
break;
 
default:
break;
}
 
deuligne__write_command(command);
}
 
/**************************************************************************//**
* \fn void deuligne__set_display(
* bool enable_display,
* bool enable_cursor_display,
* bool enable_cursor_blink)
*
* \brief Set LCD display.
* Enable or disable display, cursor display and cursor blink.
*
* \param enable_display true to enable display or false in contrary case
* \param enable_cursor_display true to enable cursor display or false in
* contrary case
* \param enable_cursor_blink true to enable cursor blink or false in contrary
* case
******************************************************************************/
void
deuligne__set_display
(
bool enable_display,
bool enable_cursor_display,
bool enable_cursor_blink
){
uint8_t command = LCD__CMD_DISPLAY_CONTROL;
if (enable_display)
{
command |= LCD__CMD_ENABLE_DISPLAY;
}
if (enable_cursor_display)
{
command |= LCD__CMD_ENABLE_CURSOR_DISPLAY;
}
if (enable_cursor_blink)
{
command |= LCD__CMD_ENABLE_CURSOR_BLINK;
}
deuligne__write_command(command);
}
 
/**************************************************************************//**
* \fn void deuligne__clear_display(void)
*
* \brief Clear LCD display.
* Wait time of 2 ms.
******************************************************************************/
void
deuligne__clear_display
(
void
){
deuligne__write_command(LCD__CMD_CLEAR_DISPLAY);
_delay_ms(2);
}
 
/**************************************************************************//**
* \fn void deuligne__return_home(void)
*
* \brief Set cursor on the first column of the first line.
* Wait time of 2 ms.
******************************************************************************/
void
deuligne__return_home
(
void
){
deuligne__write_command(LCD__CMD_RETURN_HOME);
_delay_ms(2);
}
 
/**************************************************************************//**
*\fn void deuligne__set_cursor_position(
* deuligne__line_t line,
* uint8_t column)
*
* \brief Set cursor position.
*
* \param line destination line
* \param column destination column
******************************************************************************/
void
deuligne__set_cursor_position
(
deuligne__line_t line,
uint8_t column
){
uint8_t address = 0;
 
switch (line)
{
case DEULIGNE__LINE_1:
{
address = LCD__LINE_1_ADDRESS;
}
break;
 
case DEULIGNE__LINE_2:
{
address = LCD__LINE_2_ADDRESS;
}
break;
 
case DEULIGNE__LINE_3:
{
address = LCD__LINE_3_ADDRESS;
}
break;
 
case DEULIGNE__LINE_4:
{
address = LCD__LINE_4_ADDRESS;
}
break;
 
default:
{
address = LCD__LINE_1_ADDRESS;
}
break;
}
 
address += column;
 
deuligne__write_command(LCD__CMD_SET_CGRAM_ADDRESS + address);
}
 
/**************************************************************************//**
* \fn void deuligne__shift_display(deuligne__shift_direction_t shift_direction)
*
* \brief Shift the display on the right or on the left.
*
* \param shift_direction display shift direction
******************************************************************************/
void
deuligne__shift_display
(
deuligne__shift_direction_t shift_direction
){
uint8_t command = LCD__CMD_CURSOR_OR_DISPLAY_SHIFT | LCD__CMD_SHIFT_DISPLAY;
 
switch (shift_direction)
{
case DEULIGNE__SHIFT_DIRECTION_RIGHT:
{
command |= LCD__CMD_SHIFT_RIGHT;
}
break;
 
case DEULIGNE__SHIFT_DIRECTION_LEFT:
{
command |= LCD__CMD_SHIFT_LEFT;
}
break;
 
default:
break;
}
 
deuligne__write_command(command);
}
 
/**************************************************************************//**
* \fn void deuligne__shift_cursor(deuligne__shift_direction_t shift_direction)
*
* \brief Shift the cursor on the right or on the left.
*
* \param shift_direction cursor shift direction
******************************************************************************/
void
deuligne__shift_cursor
(
deuligne__shift_direction_t shift_direction
){
uint8_t command = LCD__CMD_CURSOR_OR_DISPLAY_SHIFT | LCD__CMD_SHIFT_CURSOR;
 
switch (shift_direction)
{
case DEULIGNE__SHIFT_DIRECTION_RIGHT:
{
command |= LCD__CMD_SHIFT_RIGHT;
}
break;
 
case DEULIGNE__SHIFT_DIRECTION_LEFT:
{
command |= LCD__CMD_SHIFT_LEFT;
}
break;
 
default:
break;
}
 
deuligne__write_command(command);
}
 
/**************************************************************************//**
* \fn void deuligne__write_char(char data)
*
* \brief Write a character on LCD.
*
* \param data Character to write.
******************************************************************************/
void
deuligne__write_char
(
char data
){
mcp23008__set_pin_level(DEULIGNE__GPIO_RS, MCP23008__LEVEL__HIGH);
deuligne__write_byte(data);
}
 
/**************************************************************************//**
* \fn void deuligne__write_string(const char* string_to_write)
*
* \brief Write a string on LCD display from current cursor position.
*
* \param string_to_write string to write
******************************************************************************/
void
deuligne__write_string
(
const char* string_to_write
){
// Check the preconditions.
assert(NULL != string_to_write);
 
while (*string_to_write != '\0')
{
deuligne__write_char(*string_to_write++);
}
}
 
/**************************************************************************//**
* \fn void deuligne__get_key(void)
*
* \brief Get key.
*
* \return Key.
******************************************************************************/
deuligne__key_t
deuligne__get_key
(
void
){
deuligne__key_t key = DEULIGNE__KEY__NONE;
 
// Read ADC0 value.
uint16_t value = adc__single_channel_read();
 
// Find key.
for (deuligne__key_t i = DEULIGNE__KEY__RIGHT; i <= DEULIGNE__KEY__NONE; i++)
{
if (value < deuligne__adc_values[i])
{
key = i;
break;
}
}
 
return key;
}
 
/******************************************************************************
* Private function definitions.
******************************************************************************/
 
/**************************************************************************//**
* \fn static void deuligne__write_command(uint8_t command)
*
* \brief Write a command on LCD port.
*
* \param command Command to write.
******************************************************************************/
static
void
deuligne__write_command
(
uint8_t command
){
mcp23008__set_pin_level(DEULIGNE__GPIO_RS, MCP23008__LEVEL__LOW);
deuligne__write_byte(command);
}
 
/**************************************************************************//**
* \fn static void deuligne__write_byte(uint8_t data)
*
* \brief Write a byte on LCD port.
*
* \param data Byte to write.
******************************************************************************/
static
void
deuligne__write_byte
(
uint8_t data
){
// Get current port value.
uint8_t port_value = mcp23008__get_port_value() & 0xF0;
 
// Write high nibble.
port_value |= data >> 4;
mcp23008__set_port_value(port_value);
deuligne__enable_data();
_delay_ms(1);
 
// Write low nibble.
port_value &= 0xF0;
port_value |= data & 0x0F;
mcp23008__set_port_value(port_value);
deuligne__enable_data();
_delay_ms(1);
}
 
/**************************************************************************//**
* \fn static void deuligne__write_high_nibble(uint8_t data)
*
* \brief Write the high nibble of a byte on LCD port.
*
* \param data Byte which write high nibble.
******************************************************************************/
static
void
deuligne__write_high_nibble
(
uint8_t data
){
// Get current port value.
uint8_t port_value = mcp23008__get_port_value() & 0xF0;
 
// Write high nibble.
port_value |= data >> 4;
mcp23008__set_port_value(port_value);
deuligne__enable_data();
_delay_ms(1);
}
 
/**************************************************************************//**
* \fn static void deuligne__enable_data(void)
*
* \brief Enable data on LCD port.
******************************************************************************/
static
void
deuligne__enable_data
(
void
){
mcp23008__set_pin_level(DEULIGNE__GPIO_E, MCP23008__LEVEL__HIGH);
_delay_ms(1);
mcp23008__set_pin_level(DEULIGNE__GPIO_E, MCP23008__LEVEL__LOW);
_delay_ms(1);
}
/trunk/libraries/deuligne/SConscript
0,0 → 1,16
# Import environment set for target.
Import('env_target')
 
# Define directories to process.
directories = [
'src/'
]
 
# Process directories.
for directory in directories:
SConscript(
directory + 'SConscript',
variant_dir = '#build/' + '/libraries/deuligne/' + env_target['NAME'],
exports = { 'env_target' : env_target },
duplicate = 0
)
/trunk/libraries/deuligne/SConstruct
0,0 → 1,40
# Import build tools.
SConscript('#min_env/build_tools.py')
 
# Set environment for AVR-GCC.
SConscript('#min_env/env_target.py')
 
# Import environment set for AVR-GCC.
Import('env_target')
 
# Append CPPPATH.
env_target.Append(CPPPATH = [ '#../' ])
 
# Build library.
SConscript(
'src/SConscript',
variant_dir = '#build/lib/',
exports = { 'env_target' : env_target },
duplicate = 0
)
 
# Append LIBPATH and LIBS.
env_target.Append(LIBPATH = [ '#build/lib/'])
env_target.Append(LIBS = [ 'deuligne' ])
 
# Build demonstration program.
SConscript(
'demo/SConscript',
variant_dir = '#build/demo/',
exports = { 'env_target' : env_target },
duplicate = 0
)
 
# Build test program.
SConscript(
'test/SConscript',
variant_dir = '#build/test/',
exports = { 'env_target' : env_target },
duplicate = 0
)
 
/trunk/libraries/mcp23008/src/mcp23008.c
0,0 → 1,375
/**************************************************************************//**
* \brief MCP23008 library
* \author Copyright (C) 2012 Julien Le Sech - www.idreammicro.com
* \version 1.0
* \date 201201025
*
* This file is part of the iDreamMicro library.
*
* This library is free software: you can redistribute it and/or modify it under
* the terms of the GNU Lesser General Public License as published by the Free
* Software Foundation, either version 3 of the License, or (at your option) any
* later version.
*
* This library is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
* FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more
* details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with this program. If not, see http://www.gnu.org/licenses/
******************************************************************************/
 
/**************************************************************************//**
* \file mcp23008.c
******************************************************************************/
 
/******************************************************************************
* Header file inclusions.
******************************************************************************/
 
#include <mcp23008/mcp23008.h>
 
#include <twi/twi.h>
#include <useful/bits.h>
 
#include <stdint.h>
 
/******************************************************************************
* Private macros.
******************************************************************************/
 
/**************************************************************************//**
* \def MCP23008__ADDRESS
* \brief MCP23008 address on TWI bus (doesn't include hardware address).
* This value is given by the datasheet.
******************************************************************************/
#define MCP23008__ADDRESS 0x40
 
/**************************************************************************//**
* \def MCP23008__REG_IODIR
* \brief I/O direction register.
******************************************************************************/
#define MCP23008__REG_IODIR 0x00
 
/**************************************************************************//**
* \def MCP23008__REG_IPOL
* \brief Input polarity register.
******************************************************************************/
#define MCP23008__REG_IPOL 0x01
 
/**************************************************************************//**
* \def MCP23008__REG_GPINTEN
* \brief Interrupt on change control register.
******************************************************************************/
#define MCP23008__REG_GPINTEN 0x02
 
/**************************************************************************//**
* \def MCP23008__REG_DEFVAL
* \brief Default compare register for interrupt on change.
******************************************************************************/
#define MCP23008__REG_DEFVAL 0x03
 
/**************************************************************************//**
* \def MCP23008__REG_INTCON
* \brief Interrupt control register.
******************************************************************************/
#define MCP23008__REG_INTCON 0x04
 
/**************************************************************************//**
* \def MCP23008__REG_IOCON
* \brief Configuration register.
******************************************************************************/
#define MCP23008__REG_IOCON 0x05
 
/**************************************************************************//**
* \def MCP23008__REG_GPPU
* \brief Pull-up resistor configuration register.
******************************************************************************/
#define MCP23008__REG_GPPU 0x06
 
/**************************************************************************//**
* \def MCP23008__REG_INTF
* \brief Interrupt flag register.
******************************************************************************/
#define MCP23008__REG_INTF 0x07
 
/**************************************************************************//**
* \def MCP23008__REG_INTCAP
* \brief Interrupt capture register.
******************************************************************************/
#define MCP23008__REG_INTCAP 0x08
 
/**************************************************************************//**
* \def MCP23008__REG_GPIO
* \brief Port register.
******************************************************************************/
#define MCP23008__REG_GPIO 0x09
 
/**************************************************************************//**
* \def MCP23008__REG_OLAT
* \brief Output latch register.
******************************************************************************/
#define MCP23008__REG_OLAT 0x0A
 
/******************************************************************************
* Private function prototypes.
******************************************************************************/
 
/**************************************************************************//**
* \fn static uint8_t mcp23008__read_register(uint8_t address)
*
* \brief Read MCP23008 register value.
*
* \param address Address of the register to read value.
******************************************************************************/
static
uint8_t
mcp23008__read_register
(
uint8_t address
);
 
/**************************************************************************//**
* \fn static void mcp23008__write_register(uint8_t address, uint8_t value)
*
* \brief Write MCP23008 register value.
*
* \param address Address of the register to write value.
* \param value Value to write.
******************************************************************************/
static
void
mcp23008__write_register
(
uint8_t address,
uint8_t value
);
 
/******************************************************************************
* Private variable declarations.
******************************************************************************/
 
static uint8_t mcp23008__twi_address = 0;
 
/******************************************************************************
* Public function definitions.
******************************************************************************/
 
/**************************************************************************//**
* \fn void mcp23008__initialize(uint8_t hardware_address)
*
* \brief Initialize MCP23008.
*
* \param hardware_address Hardware address defined by pins A0 to A2.
******************************************************************************/
void
mcp23008__initialize
(
uint8_t hardware_address
){
// We don't initialize TWI here: we may have several devices on the bus.
// Initialize TWI.
//twi__initialize(MCP23008__CLOCK_RATE);
 
// Compute MCP23008 TWI address.
mcp23008__twi_address = MCP23008__ADDRESS | (hardware_address << 1);
 
twi__start();
twi__send_slaw(mcp23008__twi_address);
twi__send_data(MCP23008__REG_IODIR);
twi__send_data(0xFF);
twi__send_data(0x00);
twi__send_data(0x00);
twi__send_data(0x00);
twi__send_data(0x00);
twi__send_data(0x00);
twi__send_data(0x00);
twi__send_data(0x00);
twi__send_data(0x00);
twi__send_data(0x00);
twi__stop();
}
 
/**************************************************************************//**
* \fn void mcp23008__configure pin(
* mcp23008__gpio_t pin,
* mcp23008__direction_t direction)
*
* \brief Configure pin direction.
*
* \param pin Pin to configure.
* \param direction Pin direction.
******************************************************************************/
void
mcp23008__configure_pin
(
 
mcp23008__gpio_t pin,
mcp23008__direction_t direction
){
uint8_t port_configuration = mcp23008__read_register(MCP23008__REG_IODIR);
 
if (MCP23008__DIRECTION__INPUT == direction)
{
BIT__SET(port_configuration, pin);
}
else
{
BIT__RST(port_configuration, pin);
}
 
mcp23008__write_register(MCP23008__REG_IODIR, port_configuration);
}
 
/**************************************************************************//**
* \fn void mcp23008__configure_port(mcp23008__direction_t direction)
*
* \brief Configure port direction.
*
* \param direction Port direction.
******************************************************************************/
void
mcp23008__configure_port
(
mcp23008__direction_t direction
){
mcp23008__write_register(MCP23008__REG_IODIR, direction);
}
 
/**************************************************************************//**
* \fn mcp23008__level_t mcp23008__get_pin_level(mcp23008__gpio_t pin)
*
* \brief Get pin level.
*
* \param pin Pin to get level.
*
* \return Pin level.
******************************************************************************/
mcp23008__level_t
mcp23008__get_pin_level
(
mcp23008__gpio_t pin
){
uint8_t port_value = mcp23008__read_register(MCP23008__REG_GPIO);
 
mcp23008__level_t level = BIT__TST(port_value, pin);
 
return level;
}
 
/**************************************************************************//**
* \fn void mcp23008__set_pin_level(
* mcp23008__gpio_t pin,
* mcp23008__level_t level)
*
* \brief Set pin level.
*
* \param pin Pin to set level.
* \param level Level to set.
******************************************************************************/
void
mcp23008__set_pin_level
(
mcp23008__gpio_t pin,
mcp23008__level_t level
){
uint8_t port_value = mcp23008__read_register(MCP23008__REG_GPIO);
 
if (MCP23008__LEVEL__HIGH == level)
{
BIT__SET(port_value, pin);
}
else
{
BIT__RST(port_value, pin);
}
 
mcp23008__write_register(MCP23008__REG_GPIO, port_value);
}
 
/**************************************************************************//**
* \fn uin8_t mcp23008__get_port_value(void)
*
* \brief Get port value.
*
* \return Port value.
******************************************************************************/
uint8_t
mcp23008__get_port_value
(
void
){
uint8_t value = mcp23008__read_register(MCP23008__REG_GPIO);
 
return value;
}
 
/**************************************************************************//**
* \fn void mcp23008__set_port_value(uint8_t value)
*
* \brief Set port value.
*
* \param value Value to set.
******************************************************************************/
void
mcp23008__set_port_value
(
uint8_t value
){
mcp23008__write_register(MCP23008__REG_GPIO, value);
}
 
/******************************************************************************
* Private function definitions.
******************************************************************************/
 
/**************************************************************************//**
* \fn static uint8_t mcp23008__read_register(uint8_t address)
*
* \brief Read MCP23008 register value.
*
* \param address Address of the register to read value.
******************************************************************************/
static
uint8_t
mcp23008__read_register
(
uint8_t address
){
uint8_t value = 0;
 
twi__start();
twi__send_slaw(mcp23008__twi_address);
twi__send_data(address);
twi__stop();
 
twi__start();
twi__send_slar(mcp23008__twi_address);
twi__receive_data_nack(&value);
twi__stop();
 
return value;
}
 
/**************************************************************************//**
* \fn static void mcp23008__write_register(uint8_t address, uint8_t value)
*
* \brief Write MCP23008 register value.
*
* \param address Address of the register to write value.
* \param value Value to write.
******************************************************************************/
static
void
mcp23008__write_register
(
uint8_t address,
uint8_t value
){
twi__start();
twi__send_slaw(mcp23008__twi_address);
twi__send_data(address);
twi__send_data(value);
twi__stop();
}
/trunk/libraries/mcp23008/src/SConscript
0,0 → 1,13
# Import environment set for target.
Import('env_target')
 
# Define target name.
TARGET = 'mcp23008'
 
# Define source files.
sources = [
'mcp23008.c'
]
 
# Build library.
env_target.BuildLibrary(sources, TARGET)
/trunk/libraries/mcp23008/mcp23008.h
0,0 → 1,248
/**************************************************************************//**
* \brief MCP23008 library
* \author Copyright (C) 2012 Julien Le Sech - www.idreammicro.com
* \version 1.0
* \date 20121025
*
* This file is part of the iDreamMicro library.
*
* This library is free software: you can redistribute it and/or modify it under
* the terms of the GNU Lesser General Public License as published by the Free
* Software Foundation, either version 3 of the License, or (at your option) any
* later version.
*
* This library is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
* FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more
* details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with this program. If not, see http://www.gnu.org/licenses/
******************************************************************************/
 
/**************************************************************************//**
* \headerfile mcp23008.h
******************************************************************************/
 
#ifndef H__IDREAMMICRO__MCP23008__H
#define H__IDREAMMICRO__MCP23008__H
 
#ifdef _cplusplus
extern "C"{
#endif
 
/******************************************************************************
* Header file inclusions.
******************************************************************************/
 
#include <stdint.h>
 
/******************************************************************************
* Public macro definitions.
******************************************************************************/
 
/**************************************************************************//**
* \def MCP23008__CLOCK_RATE
* \brief MCP23008 frequency in Hertz.
* On ATmega, can be 100 kHz or 400 Khz.
******************************************************************************/
#define MCP23008__CLOCK_RATE 400000
 
/******************************************************************************
* MCP23008 GPIOs.
******************************************************************************/
 
/**************************************************************************//**
* \def MCP23008__GP0
* \brief I/O pin 0.
******************************************************************************/
#define MCP23008__GP0 0
 
/**************************************************************************//**
* \def MCP23008__GP1
* \brief I/O pin 1.
******************************************************************************/
#define MCP23008__GP1 1
 
/**************************************************************************//**
* \def MCP23008__GP2
* \brief I/O iin 2.
******************************************************************************/
#define MCP23008__GP2 2
 
/**************************************************************************//**
* \def MCP23008__GP3
* \brief I/O pin 3.
******************************************************************************/
#define MCP23008__GP3 3
 
/**************************************************************************//**
* \def MCP23008__GP4
* \brief I/O pin 4.
******************************************************************************/
#define MCP23008__GP4 4
 
/**************************************************************************//**
* \def MCP23008__GP5
* \brief I/O pin 5.
******************************************************************************/
#define MCP23008__GP5 5
 
/**************************************************************************//**
* \def MCP23008__GP6
* \brief I/O pin 6.
******************************************************************************/
#define MCP23008__GP6 6
 
/**************************************************************************//**
* \def MCP23008__GP7
* \brief I/O pin 7.
******************************************************************************/
#define MCP23008__GP7 7
 
/******************************************************************************
* Public type definitions.
******************************************************************************/
 
/**************************************************************************//**
* \enum mcp23008__directions
* \brief MCP23008 pin/port directions.
*
* \typedef mcp23008__direction_t
* \brief MCP23008 pin/port direction.
******************************************************************************/
typedef enum mcp23008__directions
{
MCP23008__DIRECTION__INPUT, /*!< Input. */
MCP23008__DIRECTION__OUTPUT /*!< Output. */
} mcp23008__direction_t;
 
/**************************************************************************//**
* \enum mcp23008__levels
* \brief MCP23008 GPIO levels.
*
* \typedef mcp23008__level_t
* \brief MCP23008 GPIO level.
******************************************************************************/
typedef enum mcp23008__levels
{
MCP23008__LEVEL__LOW, /*!< Low level. */
MCP23008__LEVEL__HIGH /*!< High level. */
} mcp23008__level_t;
 
/**************************************************************************//**
* \typedef mcp23008__gpio_t
* \brief
******************************************************************************/
typedef uint8_t mcp23008__gpio_t;
 
/******************************************************************************
* Public function prototypes.
******************************************************************************/
 
/**************************************************************************//**
* \fn void mcp23008__initialize(uint8_t hardware_address)
*
* \brief Initialize MCP23008.
*
* \param hardware_address Hardware address defined by pins A0 to A2.
******************************************************************************/
void
mcp23008__initialize
(
uint8_t hardware_address
);
 
/**************************************************************************//**
* \fn void mcp23008__configure pin(
* mcp23008__gpio_t pin,
* mcp23008__direction_t direction)
*
* \brief Configure pin direction.
*
* \param pin Pin to configure.
* \param direction Pin direction.
******************************************************************************/
void
mcp23008__configure_pin
(
mcp23008__gpio_t pin,
mcp23008__direction_t direction
);
 
/**************************************************************************//**
* \fn void mcp23008__configure_port(mcp23008__direction_t direction)
*
* \brief Configure port direction.
*
* \param direction Port direction.
******************************************************************************/
void
mcp23008__configure_port
(
mcp23008__direction_t direction
);
 
/**************************************************************************//**
* \fn mcp23008__level_t mcp23008__get_pin_level(mcp23008__gpio_t pin)
*
* \brief Get pin level.
*
* \param pin Pin to get level.
*
* \return Pin level.
******************************************************************************/
mcp23008__level_t
mcp23008__get_pin_level
(
mcp23008__gpio_t pin
);
 
/**************************************************************************//**
* \fn void mcp23008__set_pin_level(
* mcp23008__gpio_t pin,
* mcp23008__level_t level)
*
* \brief Set pin level.
*
* \param pin Pin to set level.
* \param level Level to set.
******************************************************************************/
void
mcp23008__set_pin_level
(
mcp23008__gpio_t pin,
mcp23008__level_t level
);
 
/**************************************************************************//**
* \fn uin8_t mcp23008__get_port_value(void)
*
* \brief Get port value.
*
* \return Port value.
******************************************************************************/
uint8_t
mcp23008__get_port_value
(
void
);
 
/**************************************************************************//**
* \fn void mcp23008__set_port_value(uint8_t value)
*
* \brief Set port value.
*
* \param value Value to set.
******************************************************************************/
void
mcp23008__set_port_value
(
uint8_t value
);
 
#ifdef _cplusplus
}
#endif
 
#endif /* H__IDREAMMICRO__MCP23008__H */
/trunk/libraries/mcp23008/SConscript
0,0 → 1,16
# Import environment set for target.
Import('env_target')
 
# Define directories to process.
directories = [
'src/'
]
 
# Process directories.
for directory in directories:
SConscript(
directory + 'SConscript',
variant_dir = '#build/' + '/libraries/mcp23008/' + env_target['NAME'],
exports = { 'env_target' : env_target },
duplicate = 0
)
/trunk/libraries/mcp23008/SConstruct
0,0 → 1,40
# Import build tools.
SConscript('#min_env/build_tools.py')
 
# Set environment for AVR-GCC.
SConscript('#min_env/env_target.py')
 
# Import environment set for AVR-GCC.
Import('env_target')
 
# Append CPPPATH.
env_target.Append(CPPPATH = [ '#../' ])
 
# Build library.
SConscript(
'src/SConscript',
variant_dir = '#build/lib/',
exports = { 'env_target' : env_target },
duplicate = 0
)
 
# Append LIBPATH and LIBS.
env_target.Append(LIBPATH = [ '#build/lib/'])
env_target.Append(LIBS = [ 'mcp23008' ])
 
# Build demonstration program.
SConscript(
'demo/SConscript',
variant_dir = '#build/demo/',
exports = { 'env_target' : env_target },
duplicate = 0
)
 
# Build test program.
SConscript(
'test/SConscript',
variant_dir = '#build/test/',
exports = { 'env_target' : env_target },
duplicate = 0
)
 
/trunk/libraries/eeprom_24c128_24c256/src/eeprom_24c128_24c256.c
0,0 → 1,293
/**************************************************************************//**
* \brief EEPROM 24C128/24C256 library.
* \author Copyright (C) 2012 Julien Le Sech - www.idreammicro.com
* \version 1.0
* \date 20121102
*
* This file is part of the iDreamMicro library.
*
* This library is free software: you can redistribute it and/or modify it under
* the terms of the GNU Lesser General Public License as published by the Free
* Software Foundation, either version 3 of the License, or (at your option) any
* later version.
*
* This library is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
* FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more
* details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with this program. If not, see http://www.gnu.org/licenses/
******************************************************************************/
 
/**************************************************************************//**
* \file eeprom_24c128_24c256.c
******************************************************************************/
 
/******************************************************************************
* Header file inclusions.
******************************************************************************/
 
#include "../eeprom_24c128_24c256.h"
 
#include <twi/twi.h>
 
#include <util/delay.h>
 
#include <assert.h>
#include <stdint.h>
#include <stdlib.h>
 
/******************************************************************************
* Private macro definitions.
******************************************************************************/
 
/**************************************************************************//**
* \def EEPROM_24C128_24C256__ADDRESS
* \brief EEPROM 24C128/24C256 address. Given by datasheet.
******************************************************************************/
#define EEPROM_24C128_24C256__ADDRESS 0xA0
 
/**************************************************************************//**
* \def EEPROM_24C128_24C256__PAGE_SIZE
* \brief Size of a page in EEPROM memory.
* This size is given by EEPROM memory datasheet.
******************************************************************************/
#define EEPROM_24C128_24C256__PAGE_SIZE 64
 
/******************************************************************************
* Private function prototypes.
******************************************************************************/
 
/**************************************************************************//**
* \fn static void eeprom_24c128_24c256__write_page(
* uint16_t address,
* uint8_t length,
* uint8_t* p_data)
*
* \brief Write a page in memory.
*
* \param address Start address of data to write.
* \param length Number of bytes to write.
* \param[in] p_data Bytes to write.
******************************************************************************/
static
void
eeprom_24c128_24c256__write_page
(
uint16_t address,
uint8_t length,
uint8_t* p_data
);
 
/******************************************************************************
* Private variable declarations.
******************************************************************************/
 
static uint8_t device_address = 0;
 
/******************************************************************************
* Public function definitions.
******************************************************************************/
 
/**************************************************************************//**
* \fn void eeprom_24c128_24c256__initialize(uint8_t hardware_address)
*
* \brief Initialize EEPROM 24C128/24C256.
*
* \param hardware_address Hardware address. Pins A0 to A2.
******************************************************************************/
void
eeprom_24c128_24c256__initialize
(
uint8_t hardware_address
){
// Compute device address.
device_address = EEPROM_24C128_24C256__ADDRESS | ((hardware_address & 0x07) << 1);
 
// We don't initialize TWI here: we may have several devices on the bus.
// Initialize TWI.
//twi__initialize(EEPROM_24C128_24C256__CLOCK_RATE);
}
 
/**************************************************************************//**
* \fn void eeprom_24c128_24c256__write_byte(uint16_t address, uint8_t data)
*
* \brief Write a byte into memory.
*
* \param address Address in memory.
* \param data Byte to write.
******************************************************************************/
void
eeprom_24c128_24c256__write_byte
(
uint16_t address,
uint8_t data
){
twi__start();
twi__send_slaw(device_address);
twi__send_data(address >> 8);
twi__send_data(address & 0xFF);
twi__send_data(data);
twi__stop();
}
 
/**************************************************************************//**
* \fn void eeprom_24c128_24c256__write_bytes(
* uint16_t address,
* uint16_t length,
* uint8_t* p_data)
*
* \brief Write bytes into memory.
*
* \param address Start address.
* \param length Number of bytes to write.
* \param[in] p_data Bytes to write.
******************************************************************************/
void
eeprom_24c128_24c256__write_bytes
(
uint16_t address,
uint16_t length,
uint8_t* p_data
){
// Check the preconditions.
assert(NULL != p_data);
 
// Write first page if not aligned.
uint8_t not_aligned_length = 0;
uint8_t page_offset = address % EEPROM_24C128_24C256__PAGE_SIZE;
if (page_offset > 0)
{
not_aligned_length = EEPROM_24C128_24C256__PAGE_SIZE - page_offset;
eeprom_24c128_24c256__write_page(address, not_aligned_length, p_data);
length -= not_aligned_length;
}
 
if (length > 0)
{
address += not_aligned_length;
p_data += not_aligned_length;
 
// Write complete and aligned pages.
uint16_t page_count = length / EEPROM_24C128_24C256__PAGE_SIZE;
for (uint16_t i = 0; i < page_count; i++)
{
eeprom_24c128_24c256__write_page(address, EEPROM_24C128_24C256__PAGE_SIZE, p_data);
address += EEPROM_24C128_24C256__PAGE_SIZE;
p_data += EEPROM_24C128_24C256__PAGE_SIZE;
length -= EEPROM_24C128_24C256__PAGE_SIZE;
}
 
if (length > 0)
{
// Write remaining uncomplete page.
eeprom_24c128_24c256__write_page(address, length, p_data);
}
}
}
 
/**************************************************************************//**
* \fn uint8_t eeprom_24c128_24c256__read_byte(uint16_t address)
*
* \brief Read a byte in memory.
*
* \param address Address to read.
*
* \return Read byte.
******************************************************************************/
uint8_t
eeprom_24c128_24c256__read_byte
(
uint16_t address
){
uint8_t data = 0;
 
twi__start();
twi__send_slaw(device_address);
twi__send_data(address >> 8);
twi__send_data(address & 0xFF);
twi__repeat_start();
twi__send_slar(device_address);
twi__receive_data_nack(&data);
twi__stop();
 
return data;
}
 
/**************************************************************************//**
* \fn void eeprom_24c128_24c256__read_bytes(
* uint16_t address,
* uint16_t length,
* uint8_t* p_data)
*
* \brief Read bytes in memory.
*
* \param address Start address of data to read.
* \param length Number of bytes to read.
* \param[in] p_data Buffer to fill with read bytes.
******************************************************************************/
void
eeprom_24c128_24c256__read_bytes
(
uint16_t address,
uint16_t length,
uint8_t* p_data
){
// Check the preconditions.
assert(NULL != p_data);
 
twi__start();
twi__send_slaw(device_address);
twi__send_data(address >> 8);
twi__send_data(address & 0xFF);
twi__repeat_start();
twi__send_slar(device_address);
for (uint16_t i = 0; i < length - 1; i++)
{
twi__receive_data_ack(p_data + i);
}
twi__receive_data_nack(p_data + length - 1);
twi__stop();
}
 
/******************************************************************************
* Private function definitions.
******************************************************************************/
 
/**************************************************************************//**
* \fn static void eeprom_24c128_24c256__write_page(
* uint16_t address,
* uint8_t length,
* uint8_t* p_data)
*
* \brief Write a page in memory.
*
* \param address Start address of data to write.
* \param length Number of bytes to write.
* \param[in] p_data Bytes to write.
******************************************************************************/
static
void
eeprom_24c128_24c256__write_page
(
uint16_t address,
uint8_t length,
uint8_t* p_data
){
// Check the preconditions.
assert(NULL != p_data);
 
twi__start();
twi__send_slaw(device_address);
twi__send_data(address >> 8);
twi__send_data(address & 0xFF);
for (uint8_t i = 0; i < length; i++)
{
twi__send_data(p_data[i]);
}
twi__stop();
 
// Write cycle time (tWR). See EEPROM memory datasheet for more details.
_delay_ms(10);
}
/trunk/libraries/eeprom_24c128_24c256/src/SConscript
0,0 → 1,13
# Import environment set for target.
Import('env_target')
 
# Define target name.
TARGET = 'eeprom_24c128_24c256'
 
# Define source files.
sources = [
'eeprom_24c128_24c256.c'
]
 
# Build library.
env_target.BuildLibrary(sources, TARGET)
/trunk/libraries/eeprom_24c128_24c256/eeprom_24c128_24c256.h
0,0 → 1,142
/**************************************************************************//**
* \brief EEPROM 24C128/24C256 library.
* \author Copyright (C) 2012 Julien Le Sech - www.idreammicro.com
* \version 1.0
* \date 20121102
*
* This file is part of the iDreamMicro library.
*
* This library is free software: you can redistribute it and/or modify it under
* the terms of the GNU Lesser General Public License as published by the Free
* Software Foundation, either version 3 of the License, or (at your option) any
* later version.
*
* This library is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
* FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more
* details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with this program. If not, see http://www.gnu.org/licenses/
******************************************************************************/
 
/**************************************************************************//**
* \headerfile eeprom_24c128_24c256.h
******************************************************************************/
 
#ifndef H__IDREAMMICRO__EEPROM_24C128_24C256__H
#define H__IDREAMMICRO__EEPROM_24C128_24C256__H
 
#ifdef _cplusplus
extern "C"{
#endif
 
/******************************************************************************
* Header file inclusion.
******************************************************************************/
 
#include <stdint.h>
 
/******************************************************************************
* Public macro definitions.
******************************************************************************/
 
/**************************************************************************//**
* \def EEPROM_24C128_24C256__CLOCK_RATE
* \brief 24C128/24C256 frequency in Hertz.
* On ATmega, can be 100 kHz or 400 Khz.
******************************************************************************/
#define EEPROM_24C128_24C256__CLOCK_RATE 100000
 
/******************************************************************************
* Public function prototypes.
******************************************************************************/
 
/**************************************************************************//**
* \fn void eeprom_24c128_24c256__initialize(uint8_t hardware_address)
*
* \brief Initialize EEPROM 24C128/24C256.
*
* \param hardware_address Hardware address. Pins A0 to A2.
******************************************************************************/
void
eeprom_24c128_24c256__initialize
(
uint8_t hardware_address
);
 
/**************************************************************************//**
* \fn void eeprom_24c128_24c256__write_byte(uint16_t address, uint8_t data)
*
* \brief Write a byte into memory.
*
* \param address Address in memory.
* \param data Byte to write.
******************************************************************************/
void
eeprom_24c128_24c256__write_byte
(
uint16_t address,
uint8_t data
);
 
/**************************************************************************//**
* \fn void eeprom_24c128_24c256__write_bytes(
* uint16_t address,
* uint16_t length,
* uint8_t* p_data)
*
* \brief Write bytes into memory.
*
* \param address Start address.
* \param length Number of bytes to write.
* \param[in] p_data Bytes to write.
******************************************************************************/
void
eeprom_24c128_24c256__write_bytes
(
uint16_t address,
uint16_t length,
uint8_t* p_data
);
 
/**************************************************************************//**
* \fn uint8_t eeprom_24c128_24c256__read_byte(uint16_t address)
*
* \brief Read a byte in memory.
*
* \param address Address to read.
*
* \return Read byte.
******************************************************************************/
uint8_t
eeprom_24c128_24c256__read_byte
(
uint16_t address
);
 
/**************************************************************************//**
* \fn void eeprom_24c128_24c256__read_bytes(
* uint16_t address,
* uint16_t length,
* uint8_t* p_data)
*
* \brief Read bytes in memory.
*
* \param address Start address of data to read.
* \param length Number of bytes to read.
* \param[in] p_data Buffer to fill with read bytes.
******************************************************************************/
void
eeprom_24c128_24c256__read_bytes
(
uint16_t address,
uint16_t length,
uint8_t* p_data
);
 
#ifdef _cplusplus
}
#endif
 
#endif /* H__IDREAMMICRO__EEPROM_24C128_24C256__H */
/trunk/libraries/eeprom_24c128_24c256/SConscript
0,0 → 1,16
# Import environment set for target.
Import('env_target')
 
# Define directories to process.
directories = [
'src/'
]
 
# Process directories.
for directory in directories:
SConscript(
directory + 'SConscript',
variant_dir = '#build/' + '/libraries/eeprom_24c128_24c256/' + env_target['NAME'],
exports = { 'env_target' : env_target },
duplicate = 0
)
/trunk/libraries/eeprom_24c04_24c16/src/eeprom_24c04_24c16.c
0,0 → 1,289
/**************************************************************************//**
* \brief EEPROM 24C04/24C08/24C16 library.
* \author Copyright (C) 2012 Julien Le Sech - www.idreammicro.com
* \version 1.0
* \date 20121102
*
* This file is part of the iDreamMicro library.
*
* This library is free software: you can redistribute it and/or modify it under
* the terms of the GNU Lesser General Public License as published by the Free
* Software Foundation, either version 3 of the License, or (at your option) any
* later version.
*
* This library is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
* FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more
* details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with this program. If not, see http://www.gnu.org/licenses/
******************************************************************************/
 
/**************************************************************************//**
* \file eeprom_24c04_24c16.c
******************************************************************************/
 
/******************************************************************************
* Header file inclusions.
******************************************************************************/
 
#include "../eeprom_24c04_24c16.h"
 
#include <twi/twi.h>
 
#include <util/delay.h>
 
#include <assert.h>
#include <stdint.h>
#include <stdlib.h>
 
/******************************************************************************
* Private macro definitions.
******************************************************************************/
 
/**************************************************************************//**
* \def EEPROM_24C04_24C16__ADDRESS
* \brief EEPROM 24C04/24C08/24C16 address. Given by datasheet.
******************************************************************************/
#define EEPROM_24C04_24C16__ADDRESS 0xA0
 
/**************************************************************************//**
* \def EEPROM_24C04_24C16__PAGE_SIZE
* \brief Size of a page in EEPROM memory.
* This size is given by EEPROM memory datasheet.
******************************************************************************/
#define EEPROM_24C04_24C16__PAGE_SIZE 16
 
/******************************************************************************
* Private function prototypes.
******************************************************************************/
 
/**************************************************************************//**
* \fn static void eeprom_24c04_24c16__write_page(
* uint16_t address,
* uint8_t length,
* uint8_t* p_data)
*
* \brief Write a page in memory.
*
* \param address Start address of data to write.
* \param length Number of bytes to write.
* \param[in] p_data Bytes to write.
******************************************************************************/
static
void
eeprom_24c04_24c16__write_page
(
uint16_t address,
uint8_t length,
uint8_t* p_data
);
 
/******************************************************************************
* Private variable declarations.
******************************************************************************/
 
static uint8_t device_address = 0;
 
/******************************************************************************
* Public function definitions.
******************************************************************************/
 
/**************************************************************************//**
* \fn void eeprom_24c04_24c16__initialize(uint8_t hardware_address)
*
* \brief Initialize EEPROM 24C04/24C08/24C16.
*
* \param hardware_address Hardware address. Pins A1 to A2.
******************************************************************************/
void
eeprom_24c04_24c16__initialize
(
uint8_t hardware_address
){
// Compute device address.
device_address = EEPROM_24C04_24C16__ADDRESS | ((hardware_address & 0x06) << 1);
 
// We don't initialize TWI here: we may have several devices on the bus.
// Initialize TWI.
//twi__initialize(EEPROM_24C04_24C16__CLOCK_RATE);
}
 
/**************************************************************************//**
* \fn void eeprom_24c04_24c16__write_byte(uint16_t address, uint8_t data)
*
* \brief Write a byte into memory.
*
* \param address Address in memory.
* \param data Byte to write.
******************************************************************************/
void
eeprom_24c04_24c16__write_byte
(
uint16_t address,
uint8_t data
){
twi__start();
twi__send_slaw(device_address | ((address & 0x30) >> 7));
twi__send_data(address & 0xFF);
twi__send_data(data);
twi__stop();
}
 
/**************************************************************************//**
* \fn void eeprom_24c04_24c16__write_bytes(
* uint16_t address,
* uint16_t length,
* uint8_t* p_data)
*
* \brief Write bytes into memory.
*
* \param address Start address.
* \param length Number of bytes to write.
* \param[in] p_data Bytes to write.
******************************************************************************/
void
eeprom_24c04_24c16__write_bytes
(
uint16_t address,
uint16_t length,
uint8_t* p_data
){
// Check the preconditions.
assert(NULL != p_data);
 
// Write first page if not aligned.
uint8_t not_aligned_length = 0;
uint8_t page_offset = address % EEPROM_24C04_24C16__PAGE_SIZE;
if (page_offset > 0)
{
not_aligned_length = EEPROM_24C04_24C16__PAGE_SIZE - page_offset;
eeprom_24c04_24c16__write_page(address, not_aligned_length, p_data);
length -= not_aligned_length;
}
 
if (length > 0)
{
address += not_aligned_length;
p_data += not_aligned_length;
 
// Write complete and aligned pages.
uint16_t page_count = length / EEPROM_24C04_24C16__PAGE_SIZE;
for (uint16_t i = 0; i < page_count; i++)
{
eeprom_24c04_24c16__write_page(address, EEPROM_24C04_24C16__PAGE_SIZE, p_data);
address += EEPROM_24C04_24C16__PAGE_SIZE;
p_data += EEPROM_24C04_24C16__PAGE_SIZE;
length -= EEPROM_24C04_24C16__PAGE_SIZE;
}
 
if (length > 0)
{
// Write remaining uncomplete page.
eeprom_24c04_24c16__write_page(address, length, p_data);
}
}
}
 
/**************************************************************************//**
* \fn uint8_t eeprom_24c04_24c16__read_byte(uint16_t address)
*
* \brief Read a byte in memory.
*
* \param address Address to read.
*
* \return Read byte.
******************************************************************************/
uint8_t
eeprom_24c04_24c16__read_byte
(
uint16_t address
){
uint8_t data = 0;
 
twi__start();
twi__send_slaw(device_address | ((address & 0x30) >> 7));
twi__send_data(address & 0xFF);
twi__repeat_start();
twi__send_slar(device_address);
twi__receive_data_nack(&data);
twi__stop();
 
return data;
}
 
/**************************************************************************//**
* \fn void eeprom_24c04_24c16__read_bytes(
* uint16_t address,
* uint16_t length,
* uint8_t* p_data)
*
* \brief Read bytes in memory.
*
* \param address Start address of data to read.
* \param length Number of bytes to read.
* \param[in] p_data Buffer to fill with read bytes.
******************************************************************************/
void
eeprom_24c04_24c16__read_bytes
(
uint16_t address,
uint16_t length,
uint8_t* p_data
){
// Check the preconditions.
assert(NULL != p_data);
 
twi__start();
twi__send_slaw(device_address | ((address & 0x30) >> 7));
twi__send_data(address & 0xFF);
twi__repeat_start();
twi__send_slar(device_address);
for (uint16_t i = 0; i < length - 1; i++)
{
twi__receive_data_ack(p_data + i);
}
twi__receive_data_nack(p_data + length - 1);
twi__stop();
}
 
/******************************************************************************
* Private function definitions.
******************************************************************************/
 
/**************************************************************************//**
* \fn static void eeprom_24c04_24c16__write_page(
* uint16_t address,
* uint8_t length,
* uint8_t* p_data)
*
* \brief Write a page in memory.
*
* \param address Start address of data to write.
* \param length Number of bytes to write.
* \param[in] p_data Bytes to write.
******************************************************************************/
static
void
eeprom_24c04_24c16__write_page
(
uint16_t address,
uint8_t length,
uint8_t* p_data
){
// Check the preconditions.
assert(NULL != p_data);
 
twi__start();
twi__send_slaw(device_address | ((address & 0x30) >> 7));
twi__send_data(address & 0xFF);
for (uint8_t i = 0; i < length; i++)
{
twi__send_data(p_data[i]);
}
twi__stop();
 
// Write cycle time (tWR). See EEPROM memory datasheet for more details.
_delay_ms(10);
}
/trunk/libraries/eeprom_24c04_24c16/src/SConscript
0,0 → 1,13
# Import environment set for target.
Import('env_target')
 
# Define target name.
TARGET = 'eeprom_24c04_24c16'
 
# Define source files.
sources = [
'eeprom_24c04_24c16.c'
]
 
# Build library.
env_target.BuildLibrary(sources, TARGET)
/trunk/libraries/eeprom_24c04_24c16/SConscript
0,0 → 1,16
# Import environment set for target.
Import('env_target')
 
# Define directories to process.
directories = [
'src/'
]
 
# Process directories.
for directory in directories:
SConscript(
directory + 'SConscript',
variant_dir = '#build/' + '/libraries/eeprom_24c04_24c16/' + env_target['NAME'],
exports = { 'env_target' : env_target },
duplicate = 0
)
/trunk/libraries/eeprom_24c04_24c16/eeprom_24c04_24c16.h
0,0 → 1,142
/**************************************************************************//**
* \brief EEPROM 24C04/24C08/24C16 library.
* \author Copyright (C) 2012 Julien Le Sech - www.idreammicro.com
* \version 1.0
* \date 20121102
*
* This file is part of the iDreamMicro library.
*
* This library is free software: you can redistribute it and/or modify it under
* the terms of the GNU Lesser General Public License as published by the Free
* Software Foundation, either version 3 of the License, or (at your option) any
* later version.
*
* This library is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
* FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more
* details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with this program. If not, see http://www.gnu.org/licenses/
******************************************************************************/
 
/**************************************************************************//**
* \headerfile eeprom_24c04_24c16.h
******************************************************************************/
 
#ifndef H__IDREAMMICRO__EEPROM_24C04_24C16__H
#define H__IDREAMMICRO__EEPROM_24C04_24C16__H
 
#ifdef _cplusplus
extern "C"{
#endif
 
/******************************************************************************
* Header file inclusion.
******************************************************************************/
 
#include <stdint.h>
 
/******************************************************************************
* Public macro definitions.
******************************************************************************/
 
/**************************************************************************//**
* \def EEPROM_24C04_24C16__CLOCK_RATE
* \brief 24C04/24C16 frequency in Hertz.
* On ATmega, can be 100 kHz or 400 Khz.
******************************************************************************/
#define EEPROM_24C04_24C16__CLOCK_RATE 100000
 
/******************************************************************************
* Public function prototypes.
******************************************************************************/
 
/**************************************************************************//**
* \fn void eeprom_24c04_24c16__initialize(uint8_t hardware_address)
*
* \brief Initialize EEPROM 24C04/24C08/24C16.
*
* \param hardware_address Hardware address. Pins A1 to A2.
******************************************************************************/
void
eeprom_24c04_24c16__initialize
(
uint8_t hardware_address
);
 
/**************************************************************************//**
* \fn void eeprom_24c04_24c16__write_byte(uint16_t address, uint8_t data)
*
* \brief Write a byte into memory.
*
* \param address Address in memory.
* \param data Byte to write.
******************************************************************************/
void
eeprom_24c04_24c16__write_byte
(
uint16_t address,
uint8_t data
);
 
/**************************************************************************//**
* \fn void eeprom_24c04_24c16__write_bytes(
* uint16_t address,
* uint16_t length,
* uint8_t* p_data)
*
* \brief Write bytes into memory.
*
* \param address Start address.
* \param length Number of bytes to write.
* \param[in] p_data Bytes to write.
******************************************************************************/
void
eeprom_24c04_24c16__write_bytes
(
uint16_t address,
uint16_t length,
uint8_t* p_data
);
 
/**************************************************************************//**
* \fn uint8_t eeprom_24c04_24c16__read_byte(uint16_t address)
*
* \brief Read a byte in memory.
*
* \param address Address to read.
*
* \return Read byte.
******************************************************************************/
uint8_t
eeprom_24c04_24c16__read_byte
(
uint16_t address
);
 
/**************************************************************************//**
* \fn void eeprom_24c04_24c16__read_bytes(
* uint16_t address,
* uint16_t length,
* uint8_t* p_data)
*
* \brief Read bytes in memory.
*
* \param address Start address of data to read.
* \param length Number of bytes to read.
* \param[in] p_data Buffer to fill with read bytes.
******************************************************************************/
void
eeprom_24c04_24c16__read_bytes
(
uint16_t address,
uint16_t length,
uint8_t* p_data
);
 
#ifdef _cplusplus
}
#endif
 
#endif /* H__IDREAMMICRO__EEPROM_24C04_24C16__H */
/trunk/libraries/eeprom_24c32_24c64/src/eeprom_24c32_24c64.c
0,0 → 1,293
/**************************************************************************//**
* \brief EEPROM 24C32/24C64 library.
* \author Copyright (C) 2012 Julien Le Sech - www.idreammicro.com
* \version 1.0
* \date 20121102
*
* This file is part of the iDreamMicro library.
*
* This library is free software: you can redistribute it and/or modify it under
* the terms of the GNU Lesser General Public License as published by the Free
* Software Foundation, either version 3 of the License, or (at your option) any
* later version.
*
* This library is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
* FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more
* details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with this program. If not, see http://www.gnu.org/licenses/
******************************************************************************/
 
/**************************************************************************//**
* \file eeprom_24c32_24c64.c
******************************************************************************/
 
/******************************************************************************
* Header file inclusions.
******************************************************************************/
 
#include "../eeprom_24c32_24c64.h"
 
#include <twi/twi.h>
 
#include <util/delay.h>
 
#include <assert.h>
#include <stdint.h>
#include <stdlib.h>
 
/******************************************************************************
* Private macro definitions.
******************************************************************************/
 
/**************************************************************************//**
* \def EEPROM_24C32_24C64__ADDRESS
* \brief EEPROM 24C32/24C64 address. Given by datasheet.
******************************************************************************/
#define EEPROM_24C32_24C64__ADDRESS 0xA0
 
/**************************************************************************//**
* \def EEPROM_24C32_24C64__PAGE_SIZE
* \brief Size of a page in EEPROM memory.
* This size is given by EEPROM memory datasheet.
******************************************************************************/
#define EEPROM_24C32_24C64__PAGE_SIZE 32
 
/******************************************************************************
* Private function prototypes.
******************************************************************************/
 
/**************************************************************************//**
* \fn static void eeprom_24c32_24c64__write_page(
* uint16_t address,
* uint8_t length,
* uint8_t* p_data)
*
* \brief Write a page in memory.
*
* \param address Start address of data to write.
* \param length Number of bytes to write.
* \param[in] p_data Bytes to write.
******************************************************************************/
static
void
eeprom_24c32_24c64__write_page
(
uint16_t address,
uint8_t length,
uint8_t* p_data
);
 
/******************************************************************************
* Private variable declarations.
******************************************************************************/
 
static uint8_t device_address = 0;
 
/******************************************************************************
* Public function definitions.
******************************************************************************/
 
/**************************************************************************//**
* \fn void eeprom_24c32_24c64__initialize(uint8_t hardware_address)
*
* \brief Initialize EEPROM 24C32/24C64.
*
* \param hardware_address Hardware address. Pins A0 to A2.
******************************************************************************/
void
eeprom_24c32_24c64__initialize
(
uint8_t hardware_address
){
// Compute device address.
device_address = EEPROM_24C32_24C64__ADDRESS | ((hardware_address & 0x07) << 1);
 
// We don't initialize TWI here: we may have several devices on the bus.
// Initialize TWI.
//twi__initialize(EEPROM_24C32_24C64__CLOCK_RATE);
}
 
/**************************************************************************//**
* \fn void eeprom_24c32_24c64__write_byte(uint16_t address, uint8_t data)
*
* \brief Write a byte into memory.
*
* \param address Address in memory.
* \param data Byte to write.
******************************************************************************/
void
eeprom_24c32_24c64__write_byte
(
uint16_t address,
uint8_t data
){
twi__start();
twi__send_slaw(device_address);
twi__send_data(address >> 8);
twi__send_data(address & 0xFF);
twi__send_data(data);
twi__stop();
}
 
/**************************************************************************//**
* \fn void eeprom_24c32_24c64__write_bytes(
* uint16_t address,
* uint16_t length,
* uint8_t* p_data)
*
* \brief Write bytes into memory.
*
* \param address Start address.
* \param length Number of bytes to write.
* \param[in] p_data Bytes to write.
******************************************************************************/
void
eeprom_24c32_24c64__write_bytes
(
uint16_t address,
uint16_t length,
uint8_t* p_data
){
// Check the preconditions.
assert(NULL != p_data);
 
// Write first page if not aligned.
uint8_t not_aligned_length = 0;
uint8_t page_offset = address % EEPROM_24C32_24C64__PAGE_SIZE;
if (page_offset > 0)
{
not_aligned_length = EEPROM_24C32_24C64__PAGE_SIZE - page_offset;
eeprom_24c32_24c64__write_page(address, not_aligned_length, p_data);
length -= not_aligned_length;
}
 
if (length > 0)
{
address += not_aligned_length;
p_data += not_aligned_length;
 
// Write complete and aligned pages.
uint16_t page_count = length / EEPROM_24C32_24C64__PAGE_SIZE;
for (uint16_t i = 0; i < page_count; i++)
{
eeprom_24c32_24c64__write_page(address, EEPROM_24C32_24C64__PAGE_SIZE, p_data);
address += EEPROM_24C32_24C64__PAGE_SIZE;
p_data += EEPROM_24C32_24C64__PAGE_SIZE;
length -= EEPROM_24C32_24C64__PAGE_SIZE;
}
 
if (length > 0)
{
// Write remaining uncomplete page.
eeprom_24c32_24c64__write_page(address, length, p_data);
}
}
}
 
/**************************************************************************//**
* \fn uint8_t eeprom_24c32_24c64__read_byte(uint16_t address)
*
* \brief Read a byte in memory.
*
* \param address Address to read.
*
* \return Read byte.
******************************************************************************/
uint8_t
eeprom_24c32_24c64__read_byte
(
uint16_t address
){
uint8_t data = 0;
 
twi__start();
twi__send_slaw(device_address);
twi__send_data(address >> 8);
twi__send_data(address & 0xFF);
twi__repeat_start();
twi__send_slar(device_address);
twi__receive_data_nack(&data);
twi__stop();
 
return data;
}
 
/**************************************************************************//**
* \fn void eeprom_24c32_24c64__read_bytes(
* uint16_t address,
* uint16_t length,
* uint8_t* p_data)
*
* \brief Read bytes in memory.
*
* \param address Start address of data to read.
* \param length Number of bytes to read.
* \param[in] p_data Buffer to fill with read bytes.
******************************************************************************/
void
eeprom_24c32_24c64__read_bytes
(
uint16_t address,
uint16_t length,
uint8_t* p_data
){
// Check the preconditions.
assert(NULL != p_data);
 
twi__start();
twi__send_slaw(device_address);
twi__send_data(address >> 8);
twi__send_data(address & 0xFF);
twi__repeat_start();
twi__send_slar(device_address);
for (uint16_t i = 0; i < length - 1; i++)
{
twi__receive_data_ack(p_data + i);
}
twi__receive_data_nack(p_data + length - 1);
twi__stop();
}
 
/******************************************************************************
* Private function definitions.
******************************************************************************/
 
/**************************************************************************//**
* \fn static void eeprom_24c32_24c64__write_page(
* uint16_t address,
* uint8_t length,
* uint8_t* p_data)
*
* \brief Write a page in memory.
*
* \param address Start address of data to write.
* \param length Number of bytes to write.
* \param[in] p_data Bytes to write.
******************************************************************************/
static
void
eeprom_24c32_24c64__write_page
(
uint16_t address,
uint8_t length,
uint8_t* p_data
){
// Check the preconditions.
assert(NULL != p_data);
 
twi__start();
twi__send_slaw(device_address);
twi__send_data(address >> 8);
twi__send_data(address & 0xFF);
for (uint8_t i = 0; i < length; i++)
{
twi__send_data(p_data[i]);
}
twi__stop();
 
// Write cycle time (tWR). See EEPROM memory datasheet for more details.
_delay_ms(10);
}
/trunk/libraries/eeprom_24c32_24c64/src/SConscript
0,0 → 1,13
# Import environment set for target.
Import('env_target')
 
# Define target name.
TARGET = 'eeprom_24c32_24c64'
 
# Define source files.
sources = [
'eeprom_24c32_24c64.c'
]
 
# Build library.
env_target.BuildLibrary(sources, TARGET)
/trunk/libraries/eeprom_24c32_24c64/SConscript
0,0 → 1,16
# Import environment set for target.
Import('env_target')
 
# Define directories to process.
directories = [
'src/'
]
 
# Process directories.
for directory in directories:
SConscript(
directory + 'SConscript',
variant_dir = '#build/' + '/libraries/eeprom_24c32_24c64/' + env_target['NAME'],
exports = { 'env_target' : env_target },
duplicate = 0
)
/trunk/libraries/eeprom_24c32_24c64/eeprom_24c32_24c64.h
0,0 → 1,142
/**************************************************************************//**
* \brief EEPROM 24C32/24C64 library.
* \author Copyright (C) 2012 Julien Le Sech - www.idreammicro.com
* \version 1.0
* \date 20121102
*
* This file is part of the iDreamMicro library.
*
* This library is free software: you can redistribute it and/or modify it under
* the terms of the GNU Lesser General Public License as published by the Free
* Software Foundation, either version 3 of the License, or (at your option) any
* later version.
*
* This library is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
* FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more
* details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with this program. If not, see http://www.gnu.org/licenses/
******************************************************************************/
 
/**************************************************************************//**
* \headerfile eeprom_24c32_24c64.h
******************************************************************************/
 
#ifndef H__IDREAMMICRO__EEPROM_24C32_24C64__H
#define H__IDREAMMICRO__EEPROM_24C32_24C64__H
 
#ifdef _cplusplus
extern "C"{
#endif
 
/******************************************************************************
* Header file inclusion.
******************************************************************************/
 
#include <stdint.h>
 
/******************************************************************************
* Public macro definitions.
******************************************************************************/
 
/**************************************************************************//**
* \def EEPROM_24C32_24C64__CLOCK_RATE
* \brief 24C32/24C64 frequency in Hertz.
* On ATmega, can be 100 kHz or 400 Khz.
******************************************************************************/
#define EEPROM_24C32_24C64__CLOCK_RATE 100000
 
/******************************************************************************
* Public function prototypes.
******************************************************************************/
 
/**************************************************************************//**
* \fn void eeprom_24c32_24c64__initialize(uint8_t hardware_address)
*
* \brief Initialize EEPROM 24C32/24C64.
*
* \param hardware_address Hardware address. Pins A0 to A2.
******************************************************************************/
void
eeprom_24c32_24c64__initialize
(
uint8_t hardware_address
);
 
/**************************************************************************//**
* \fn void eeprom_24c32_24c64__write_byte(uint16_t address, uint8_t data)
*
* \brief Write a byte into memory.
*
* \param address Address in memory.
* \param data Byte to write.
******************************************************************************/
void
eeprom_24c32_24c64__write_byte
(
uint16_t address,
uint8_t data
);
 
/**************************************************************************//**
* \fn void eeprom_24c32_24c64__write_bytes(
* uint16_t address,
* uint16_t length,
* uint8_t* p_data)
*
* \brief Write bytes into memory.
*
* \param address Start address.
* \param length Number of bytes to write.
* \param[in] p_data Bytes to write.
******************************************************************************/
void
eeprom_24c32_24c64__write_bytes
(
uint16_t address,
uint16_t length,
uint8_t* p_data
);
 
/**************************************************************************//**
* \fn uint8_t eeprom_24c32_24c64__read_byte(uint16_t address)
*
* \brief Read a byte in memory.
*
* \param address Address to read.
*
* \return Read byte.
******************************************************************************/
uint8_t
eeprom_24c32_24c64__read_byte
(
uint16_t address
);
 
/**************************************************************************//**
* \fn void eeprom_24c32_24c64__read_bytes(
* uint16_t address,
* uint16_t length,
* uint8_t* p_data)
*
* \brief Read bytes in memory.
*
* \param address Start address of data to read.
* \param length Number of bytes to read.
* \param[in] p_data Buffer to fill with read bytes.
******************************************************************************/
void
eeprom_24c32_24c64__read_bytes
(
uint16_t address,
uint16_t length,
uint8_t* p_data
);
 
#ifdef _cplusplus
}
#endif
 
#endif /* H__IDREAMMICRO__EEPROM_24C32_24C64__H */
/trunk/libraries/eeprom_24c512/src/eeprom_24c512.c
0,0 → 1,293
/**************************************************************************//**
* \brief EEPROM 24C512 library.
* \author Copyright (C) 2012 Julien Le Sech - www.idreammicro.com
* \version 1.0
* \date 20121031
*
* This file is part of the iDreamMicro library.
*
* This library is free software: you can redistribute it and/or modify it under
* the terms of the GNU Lesser General Public License as published by the Free
* Software Foundation, either version 3 of the License, or (at your option) any
* later version.
*
* This library is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
* FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more
* details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with this program. If not, see http://www.gnu.org/licenses/
******************************************************************************/
 
/**************************************************************************//**
* \file eeprom_24c512.c
******************************************************************************/
 
/******************************************************************************
* Header file inclusions.
******************************************************************************/
 
#include "../eeprom_24c512.h"
 
#include <twi/twi.h>
 
#include <util/delay.h>
 
#include <assert.h>
#include <stdint.h>
#include <stdlib.h>
 
/******************************************************************************
* Private macro definitions.
******************************************************************************/
 
/**************************************************************************//**
* \def EEPROM_24C512__ADDRESS
* \brief EEPROM 24C512 address. Given by datasheet.
******************************************************************************/
#define EEPROM_24C512__ADDRESS 0xA0
 
/**************************************************************************//**
* \def EEPROM_24C512__PAGE_SIZE
* \brief Size of a page in EEPROM memory.
* This size is given by EEPROM memory datasheet.
******************************************************************************/
#define EEPROM_24C512__PAGE_SIZE 128
 
/******************************************************************************
* Private function prototypes.
******************************************************************************/
 
/**************************************************************************//**
* \fn static void eeprom_24c512__write_page(
* uint16_t address,
* uint8_t length,
* uint8_t* p_data)
*
* \brief Write a page in memory.
*
* \param address Start address of data to write.
* \param length Number of bytes to write.
* \param[in] p_data Bytes to write.
******************************************************************************/
static
void
eeprom_24c512__write_page
(
uint16_t address,
uint8_t length,
uint8_t* p_data
);
 
/******************************************************************************
* Private variable declarations.
******************************************************************************/
 
static uint8_t device_address = 0;
 
/******************************************************************************
* Public function definitions.
******************************************************************************/
 
/**************************************************************************//**
* \fn void eeprom_24c512__initialize(uint8_t hardware_address)
*
* \brief Initialize EEPROM 24C512.
*
* \param hardware_address Hardware address. Pins A0 to A1.
******************************************************************************/
void
eeprom_24c512__initialize
(
uint8_t hardware_address
){
// Compute device address.
device_address = EEPROM_24C512__ADDRESS | ((hardware_address & 0x03) << 1);
 
// We don't initialize TWI here: we may have several devices on the bus.
// Initialize TWI.
//twi__initialize(EEPROM_24C512__CLOCK_RATE);
}
 
/**************************************************************************//**
* \fn void eeprom_24c512__write_byte(uint16_t address, uint8_t data)
*
* \brief Write a byte into memory.
*
* \param address Address in memory.
* \param data Byte to write.
******************************************************************************/
void
eeprom_24c512__write_byte
(
uint16_t address,
uint8_t data
){
twi__start();
twi__send_slaw(device_address);
twi__send_data(address >> 8);
twi__send_data(address & 0xFF);
twi__send_data(data);
twi__stop();
}
 
/**************************************************************************//**
* \fn void eeprom_24c512__write_bytes(
* uint16_t address,
* uint16_t length,
* uint8_t* p_data)
*
* \brief Write bytes into memory.
*
* \param address Start address.
* \param length Number of bytes to write.
* \param[in] p_data Bytes to write.
******************************************************************************/
void
eeprom_24c512__write_bytes
(
uint16_t address,
uint16_t length,
uint8_t* p_data
){
// Check the preconditions.
assert(NULL != p_data);
 
// Write first page if not aligned.
uint8_t not_aligned_length = 0;
uint8_t page_offset = address % EEPROM_24C512__PAGE_SIZE;
if (page_offset > 0)
{
not_aligned_length = EEPROM_24C512__PAGE_SIZE - page_offset;
eeprom_24c512__write_page(address, not_aligned_length, p_data);
length -= not_aligned_length;
}
 
if (length > 0)
{
address += not_aligned_length;
p_data += not_aligned_length;
 
// Write complete and aligned pages.
uint16_t page_count = length / EEPROM_24C512__PAGE_SIZE;
for (uint16_t i = 0; i < page_count; i++)
{
eeprom_24c512__write_page(address, EEPROM_24C512__PAGE_SIZE, p_data);
address += EEPROM_24C512__PAGE_SIZE;
p_data += EEPROM_24C512__PAGE_SIZE;
length -= EEPROM_24C512__PAGE_SIZE;
}
 
if (length > 0)
{
// Write remaining uncomplete page.
eeprom_24c512__write_page(address, length, p_data);
}
}
}
 
/**************************************************************************//**
* \fn uint8_t eeprom_24c512__read_byte(uint16_t address)
*
* \brief Read a byte in memory.
*
* \param address Address to read.
*
* \return Read byte.
******************************************************************************/
uint8_t
eeprom_24c512__read_byte
(
uint16_t address
){
uint8_t data = 0;
 
twi__start();
twi__send_slaw(device_address);
twi__send_data(address >> 8);
twi__send_data(address & 0xFF);
twi__repeat_start();
twi__send_slar(device_address);
twi__receive_data_nack(&data);
twi__stop();
 
return data;
}
 
/**************************************************************************//**
* \fn void eeprom_24c512__read_bytes(
* uint16_t address,
* uint16_t length,
* uint8_t* p_data)
*
* \brief Read bytes in memory.
*
* \param address Start address of data to read.
* \param length Number of bytes to read.
* \param[in] p_data Buffer to fill with read bytes.
******************************************************************************/
void
eeprom_24c512__read_bytes
(
uint16_t address,
uint16_t length,
uint8_t* p_data
){
// Check the preconditions.
assert(NULL != p_data);
 
twi__start();
twi__send_slaw(device_address);
twi__send_data(address >> 8);
twi__send_data(address & 0xFF);
twi__repeat_start();
twi__send_slar(device_address);
for (uint16_t i = 0; i < length - 1; i++)
{
twi__receive_data_ack(p_data + i);
}
twi__receive_data_nack(p_data + length - 1);
twi__stop();
}
 
/******************************************************************************
* Private function definitions.
******************************************************************************/
 
/**************************************************************************//**
* \fn static void eeprom_24c512__write_page(
* uint16_t address,
* uint8_t length,
* uint8_t* p_data)
*
* \brief Write a page in memory.
*
* \param address Start address of data to write.
* \param length Number of bytes to write.
* \param[in] p_data Bytes to write.
******************************************************************************/
static
void
eeprom_24c512__write_page
(
uint16_t address,
uint8_t length,
uint8_t* p_data
){
// Check the preconditions.
assert(NULL != p_data);
 
twi__start();
twi__send_slaw(device_address);
twi__send_data(address >> 8);
twi__send_data(address & 0xFF);
for (uint8_t i = 0; i < length; i++)
{
twi__send_data(p_data[i]);
}
twi__stop();
 
// Write cycle time (tWR). See EEPROM memory datasheet for more details.
_delay_ms(10);
}
/trunk/libraries/eeprom_24c512/src/SConscript
0,0 → 1,13
# Import environment set for target.
Import('env_target')
 
# Define target name.
TARGET = 'eeprom_24c512'
 
# Define source files.
sources = [
'eeprom_24c512.c'
]
 
# Build library.
env_target.BuildLibrary(sources, TARGET)
/trunk/libraries/eeprom_24c512/eeprom_24c512.h
0,0 → 1,142
/**************************************************************************//**
* \brief EEPROM 24C512 library.
* \author Copyright (C) 2012 Julien Le Sech - www.idreammicro.com
* \version 1.0
* \date 20121031
*
* This file is part of the iDreamMicro library.
*
* This library is free software: you can redistribute it and/or modify it under
* the terms of the GNU Lesser General Public License as published by the Free
* Software Foundation, either version 3 of the License, or (at your option) any
* later version.
*
* This library is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
* FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more
* details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with this program. If not, see http://www.gnu.org/licenses/
******************************************************************************/
 
/**************************************************************************//**
* \headerfile eeprom_24c512.h
******************************************************************************/
 
#ifndef H__IDREAMMICRO__EEPROM_24C512__H
#define H__IDREAMMICRO__EEPROM_24C512__H
 
#ifdef _cplusplus
extern "C"{
#endif
 
/******************************************************************************
* Header file inclusion.
******************************************************************************/
 
#include <stdint.h>
 
/******************************************************************************
* Public macro definitions.
******************************************************************************/
 
/**************************************************************************//**
* \def EEPROM_24C512__CLOCK_RATE
* \brief 24C512 frequency in Hertz.
* On ATmega, can be 100 kHz or 400 Khz.
******************************************************************************/
#define EEPROM_24C512__CLOCK_RATE 100000
 
/******************************************************************************
* Public function prototypes.
******************************************************************************/
 
/**************************************************************************//**
* \fn void eeprom_24c512__initialize(uint8_t hardware_address)
*
* \brief Initialize EEPROM 24C512.
*
* \param hardware_address Hardware address. Pins A0 to A1.
******************************************************************************/
void
eeprom_24c512__initialize
(
uint8_t hardware_address
);
 
/**************************************************************************//**
* \fn void eeprom_24c512__write_byte(uint16_t address, uint8_t data)
*
* \brief Write a byte into memory.
*
* \param address Address in memory.
* \param data Byte to write.
******************************************************************************/
void
eeprom_24c512__write_byte
(
uint16_t address,
uint8_t data
);
 
/**************************************************************************//**
* \fn void eeprom_24c512__write_bytes(
* uint16_t address,
* uint16_t length,
* uint8_t* p_data)
*
* \brief Write bytes into memory.
*
* \param address Start address.
* \param length Number of bytes to write.
* \param[in] p_data Bytes to write.
******************************************************************************/
void
eeprom_24c512__write_bytes
(
uint16_t address,
uint16_t length,
uint8_t* p_data
);
 
/**************************************************************************//**
* \fn uint8_t eeprom_24c512__read_byte(uint16_t address)
*
* \brief Read a byte in memory.
*
* \param address Address to read.
*
* \return Read byte.
******************************************************************************/
uint8_t
eeprom_24c512__read_byte
(
uint16_t address
);
 
/**************************************************************************//**
* \fn void eeprom_24c512__read_bytes(
* uint16_t address,
* uint16_t length,
* uint8_t* p_data)
*
* \brief Read bytes in memory.
*
* \param address Start address of data to read.
* \param length Number of bytes to read.
* \param[in] p_data Buffer to fill with read bytes.
******************************************************************************/
void
eeprom_24c512__read_bytes
(
uint16_t address,
uint16_t length,
uint8_t* p_data
);
 
#ifdef _cplusplus
}
#endif
 
#endif /* H__IDREAMMICRO__EEPROM_24C512__H */
/trunk/libraries/eeprom_24c512/SConscript
0,0 → 1,16
# Import environment set for target.
Import('env_target')
 
# Define directories to process.
directories = [
'src/'
]
 
# Process directories.
for directory in directories:
SConscript(
directory + 'SConscript',
variant_dir = '#build/' + '/libraries/eeprom_24c512/' + env_target['NAME'],
exports = { 'env_target' : env_target },
duplicate = 0
)
/trunk/libraries/eeprom_24c01_24c02/src/eeprom_24c01_24c02.c
0,0 → 1,289
/**************************************************************************//**
* \brief EEPROM 24C01/24C02 library.
* \author Copyright (C) 2012 Julien Le Sech - www.idreammicro.com
* \version 1.0
* \date 20121102
*
* This file is part of the iDreamMicro library.
*
* This library is free software: you can redistribute it and/or modify it under
* the terms of the GNU Lesser General Public License as published by the Free
* Software Foundation, either version 3 of the License, or (at your option) any
* later version.
*
* This library is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
* FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more
* details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with this program. If not, see http://www.gnu.org/licenses/
******************************************************************************/
 
/**************************************************************************//**
* \file eeprom_24c01_24c02.c
******************************************************************************/
 
/******************************************************************************
* Header file inclusions.
******************************************************************************/
 
#include "../eeprom_24c01_24c02.h"
 
#include <twi/twi.h>
 
#include <util/delay.h>
 
#include <assert.h>
#include <stdint.h>
#include <stdlib.h>
 
/******************************************************************************
* Private macro definitions.
******************************************************************************/
 
/**************************************************************************//**
* \def EEPROM_24C01_24C02__ADDRESS
* \brief EEPROM 24C01/24C02 address. Given by datasheet.
******************************************************************************/
#define EEPROM_24C01_24C02__ADDRESS 0xA0
 
/**************************************************************************//**
* \def EEPROM_24C01_24C02__PAGE_SIZE
* \brief Size of a page in EEPROM memory.
* This size is given by EEPROM memory datasheet.
******************************************************************************/
#define EEPROM_24C01_24C02__PAGE_SIZE 8
 
/******************************************************************************
* Private function prototypes.
******************************************************************************/
 
/**************************************************************************//**
* \fn static void eeprom_24c01_24c02__write_page(
* uint8_t address,
* uint8_t length,
* uint8_t* p_data)
*
* \brief Write a page in memory.
*
* \param address Start address of data to write.
* \param length Number of bytes to write.
* \param[in] p_data Bytes to write.
******************************************************************************/
static
void
eeprom_24c01_24c02__write_page
(
uint8_t address,
uint8_t length,
uint8_t* p_data
);
 
/******************************************************************************
* Private variable declarations.
******************************************************************************/
 
static uint8_t device_address = 0;
 
/******************************************************************************
* Public function definitions.
******************************************************************************/
 
/**************************************************************************//**
* \fn void eeprom_24c01_24c02__initialize(uint8_t hardware_address)
*
* \brief Initialize EEPROM 24C01/24C02.
*
* \param hardware_address Hardware address. Pins A0 to A2.
******************************************************************************/
void
eeprom_24c01_24c02__initialize
(
uint8_t hardware_address
){
// Compute device address.
device_address = EEPROM_24C01_24C02__ADDRESS | ((hardware_address & 0x07) << 1);
 
// We don't initialize TWI here: we may have several devices on the bus.
// Initialize TWI.
//twi__initialize(EEPROM_24C01_24C02__CLOCK_RATE);
}
 
/**************************************************************************//**
* \fn void eeprom_24c01_24c02__write_byte(uint8_t address, uint8_t data)
*
* \brief Write a byte into memory.
*
* \param address Address in memory.
* \param data Byte to write.
******************************************************************************/
void
eeprom_24c01_24c02__write_byte
(
uint8_t address,
uint8_t data
){
twi__start();
twi__send_slaw(device_address);
twi__send_data(address);
twi__send_data(data);
twi__stop();
}
 
/**************************************************************************//**
* \fn void eeprom_24c01_24c02__write_bytes(
* uint8_t address,
* uint8_t length,
* uint8_t* p_data)
*
* \brief Write bytes into memory.
*
* \param address Start address.
* \param length Number of bytes to write.
* \param[in] p_data Bytes to write.
******************************************************************************/
void
eeprom_24c01_24c02__write_bytes
(
uint8_t address,
uint8_t length,
uint8_t* p_data
){
// Check the preconditions.
assert(NULL != p_data);
 
// Write first page if not aligned.
uint8_t not_aligned_length = 0;
uint8_t page_offset = address % EEPROM_24C01_24C02__PAGE_SIZE;
if (page_offset > 0)
{
not_aligned_length = EEPROM_24C01_24C02__PAGE_SIZE - page_offset;
eeprom_24c01_24c02__write_page(address, not_aligned_length, p_data);
length -= not_aligned_length;
}
 
if (length > 0)
{
address += not_aligned_length;
p_data += not_aligned_length;
 
// Write complete and aligned pages.
uint8_t page_count = length / EEPROM_24C01_24C02__PAGE_SIZE;
for (uint8_t i = 0; i < page_count; i++)
{
eeprom_24c01_24c02__write_page(address, EEPROM_24C01_24C02__PAGE_SIZE, p_data);
address += EEPROM_24C01_24C02__PAGE_SIZE;
p_data += EEPROM_24C01_24C02__PAGE_SIZE;
length -= EEPROM_24C01_24C02__PAGE_SIZE;
}
 
if (length > 0)
{
// Write remaining uncomplete page.
eeprom_24c01_24c02__write_page(address, length, p_data);
}
}
}
 
/**************************************************************************//**
* \fn uint8_t eeprom_24c01_24c02__read_byte(uint8_t address)
*
* \brief Read a byte in memory.
*
* \param address Address to read.
*
* \return Read byte.
******************************************************************************/
uint8_t
eeprom_24c01_24c02__read_byte
(
uint8_t address
){
uint8_t data = 0;
 
twi__start();
twi__send_slaw(device_address);
twi__send_data(address);
twi__repeat_start();
twi__send_slar(device_address);
twi__receive_data_nack(&data);
twi__stop();
 
return data;
}
 
/**************************************************************************//**
* \fn void eeprom_24c01_24c02__read_bytes(
* uint8_t address,
* uint8_t length,
* uint8_t* p_data)
*
* \brief Read bytes in memory.
*
* \param address Start address of data to read.
* \param length Number of bytes to read.
* \param[in] p_data Buffer to fill with read bytes.
******************************************************************************/
void
eeprom_24c01_24c02__read_bytes
(
uint8_t address,
uint8_t length,
uint8_t* p_data
){
// Check the preconditions.
assert(NULL != p_data);
 
twi__start();
twi__send_slaw(device_address);
twi__send_data(address);
twi__repeat_start();
twi__send_slar(device_address);
for (uint8_t i = 0; i < length - 1; i++)
{
twi__receive_data_ack(p_data + i);
}
twi__receive_data_nack(p_data + length - 1);
twi__stop();
}
 
/******************************************************************************
* Private function definitions.
******************************************************************************/
 
/**************************************************************************//**
* \fn static void eeprom_24c01_24c02__write_page(
* uint8_t address,
* uint8_t length,
* uint8_t* p_data)
*
* \brief Write a page in memory.
*
* \param address Start address of data to write.
* \param length Number of bytes to write.
* \param[in] p_data Bytes to write.
******************************************************************************/
static
void
eeprom_24c01_24c02__write_page
(
uint8_t address,
uint8_t length,
uint8_t* p_data
){
// Check the preconditions.
assert(NULL != p_data);
 
twi__start();
twi__send_slaw(device_address);
twi__send_data(address);
for (uint8_t i = 0; i < length; i++)
{
twi__send_data(p_data[i]);
}
twi__stop();
 
// Write cycle time (tWR). See EEPROM memory datasheet for more details.
_delay_ms(10);
}
/trunk/libraries/eeprom_24c01_24c02/src/SConscript
0,0 → 1,13
# Import environment set for target.
Import('env_target')
 
# Define target name.
TARGET = 'eeprom_24c01_24c02'
 
# Define source files.
sources = [
'eeprom_24c01_24c02.c'
]
 
# Build library.
env_target.BuildLibrary(sources, TARGET)
/trunk/libraries/eeprom_24c01_24c02/eeprom_24c01_24c02.h
0,0 → 1,142
/**************************************************************************//**
* \brief EEPROM 24C01/24C02 library.
* \author Copyright (C) 2012 Julien Le Sech - www.idreammicro.com
* \version 1.0
* \date 20121102
*
* This file is part of the iDreamMicro library.
*
* This library is free software: you can redistribute it and/or modify it under
* the terms of the GNU Lesser General Public License as published by the Free
* Software Foundation, either version 3 of the License, or (at your option) any
* later version.
*
* This library is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
* FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more
* details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with this program. If not, see http://www.gnu.org/licenses/
******************************************************************************/
 
/**************************************************************************//**
* \headerfile eeprom_24c01_24c02.h
******************************************************************************/
 
#ifndef H__IDREAMMICRO__EEPROM_24C01_24C02__H
#define H__IDREAMMICRO__EEPROM_24C01_24C02__H
 
#ifdef _cplusplus
extern "C"{
#endif
 
/******************************************************************************
* Header file inclusion.
******************************************************************************/
 
#include <stdint.h>
 
/******************************************************************************
* Public macro definitions.
******************************************************************************/
 
/**************************************************************************//**
* \def EEPROM_24C01_24C02__CLOCK_RATE
* \brief 24C01/24C02 frequency in Hertz.
* On ATmega, can be 100 kHz or 400 Khz.
******************************************************************************/
#define EEPROM_24C01_24C02__CLOCK_RATE 100000
 
/******************************************************************************
* Public function prototypes.
******************************************************************************/
 
/**************************************************************************//**
* \fn void eeprom_24c01_24c02__initialize(uint8_t hardware_address)
*
* \brief Initialize EEPROM 24C01/24C02.
*
* \param hardware_address Hardware address. Pins A0 to A2.
******************************************************************************/
void
eeprom_24c01_24c02__initialize
(
uint8_t hardware_address
);
 
/**************************************************************************//**
* \fn void eeprom_24c01_24c02__write_byte(uint8_t address, uint8_t data)
*
* \brief Write a byte into memory.
*
* \param address Address in memory.
* \param data Byte to write.
******************************************************************************/
void
eeprom_24c01_24c02__write_byte
(
uint8_t address,
uint8_t data
);
 
/**************************************************************************//**
* \fn void eeprom_24c01_24c02__write_bytes(
* uint8_t address,
* uint8_t length,
* uint8_t* p_data)
*
* \brief Write bytes into memory.
*
* \param address Start address.
* \param length Number of bytes to write.
* \param[in] p_data Bytes to write.
******************************************************************************/
void
eeprom_24c01_24c02__write_bytes
(
uint8_t address,
uint8_t length,
uint8_t* p_data
);
 
/**************************************************************************//**
* \fn uint8_t eeprom_24c01_24c02__read_byte(uint8_t address)
*
* \brief Read a byte in memory.
*
* \param address Address to read.
*
* \return Read byte.
******************************************************************************/
uint8_t
eeprom_24c01_24c02__read_byte
(
uint8_t address
);
 
/**************************************************************************//**
* \fn void eeprom_24c01_24c02__read_bytes(
* uint8_t address,
* uint8_t length,
* uint8_t* p_data)
*
* \brief Read bytes in memory.
*
* \param address Start address of data to read.
* \param length Number of bytes to read.
* \param[in] p_data Buffer to fill with read bytes.
******************************************************************************/
void
eeprom_24c01_24c02__read_bytes
(
uint8_t address,
uint8_t length,
uint8_t* p_data
);
 
#ifdef _cplusplus
}
#endif
 
#endif /* H__IDREAMMICRO__EEPROM_24C01_24C02__H */
/trunk/libraries/eeprom_24c01_24c02/SConscript
0,0 → 1,16
# Import environment set for target.
Import('env_target')
 
# Define directories to process.
directories = [
'src/'
]
 
# Process directories.
for directory in directories:
SConscript(
directory + 'SConscript',
variant_dir = '#build/' + '/libraries/eeprom_24c01_24c02/' + env_target['NAME'],
exports = { 'env_target' : env_target },
duplicate = 0
)
/trunk/libraries/twi/src/twi.c
0,0 → 1,426
/**************************************************************************//**
* \brief TWI library
* \author Copyright (C) 2009 Julien Le Sech - www.idreammicro.com
* \version 1.0
* \date 20090501
*
* This file is part of the iDreamMicro library.
*
* This library is free software: you can redistribute it and/or modify it under
* the terms of the GNU Lesser General Public License as published by the Free
* Software Foundation, either version 3 of the License, or (at your option) any
* later version.
*
* This library is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
* FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more
* details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with this program. If not, see http://www.gnu.org/licenses/
******************************************************************************/
 
/**************************************************************************//**
* \file twi.c
******************************************************************************/
 
/******************************************************************************
* Header file inclusions.
******************************************************************************/
 
#include <twi/twi.h>
#include <useful/bits.h>
 
#include <avr/io.h>
#include <util/twi.h>
 
#include <assert.h>
#include <stdint.h>
#include <stdlib.h>
 
/******************************************************************************
* Private macros.
******************************************************************************/
 
/**************************************************************************//**
* \def TWI__MAX_FREQUENCY
* \brief Max frequency of TWI bus.
******************************************************************************/
#define TWI__MAX_FREQUENCY 400000
 
/******************************************************************************
* Private types.
******************************************************************************/
 
/**************************************************************************//**
* \enum twi__prescaler_values
* \brief Available TWI bus prescaler values.
*
* \typedef twi__prescaler_value_t
* \brief TWI bus prescaler value.
******************************************************************************/
typedef enum twi__prescaler_values
{
TWI__PRESCALER_VALUE__1,
TWI__PRESCALER_VALUE__4,
TWI__PRESCALER_VALUE__16,
TWI__PRESCALER_VALUE__64,
TWI__PRESCALER_VALUE__INVALID
} twi__prescaler_value_t;
 
/**************************************************************************//**
* \struct twi__prescaler_configuration
* \brief TWI bus prescaler configuration.
*
* \typedef twi__prescaler_configuration_t
* \brief TWI bus prescaler configuration.
******************************************************************************/
typedef struct twi__prescaler_configuration
{
uint8_t value;
uint8_t bits;
} twi__prescaler_configuration_t;
 
/******************************************************************************
* Private constant definitions.
******************************************************************************/
 
/**************************************************************************//**
* \var prescaler_configurations
* \brief Available prescaler configurations.
******************************************************************************/
static const twi__prescaler_configuration_t prescaler_configurations[] =
{
[TWI__PRESCALER_VALUE__1] =
{
.value = 1,
.bits = 0
},
[TWI__PRESCALER_VALUE__4] =
{
.value = 4,
.bits = _BV(TWPS0)
},
[TWI__PRESCALER_VALUE__16] =
{
.value = 16,
.bits = _BV(TWPS1)
},
[TWI__PRESCALER_VALUE__64] =
{
.value = 64,
.bits = _BV(TWPS1) | _BV(TWPS0)
}
};
 
/******************************************************************************
* Private function prototypes.
******************************************************************************/
 
/**************************************************************************//**
* \fn static inline uint8_t twi__compute_bit_rate(
* uint32_t f_scl,
* uint8_t prescaler_value)
*
* \brief
*
* \param f_scl SCL frequency.
* \param prescaler_value Prescaler value.
******************************************************************************/
static inline
uint8_t
twi__compute_bit_rate
(
uint32_t f_scl,
uint8_t prescaler_value
);
 
/******************************************************************************
* Public function definitions.
******************************************************************************/
 
/**************************************************************************//**
* \fn void twi__initialize(uint32_t frequency)
*
* \brief Initialize TWI.
*
* \param frequency TWI frequency (up to 400 kHz).
******************************************************************************/
void twi__initialize
(
uint32_t frequency
){
// Check the preconditions.
assert(TWI__MAX_FREQUENCY >= frequency);
 
uint16_t bit_rate = UINT16_MAX;
twi__prescaler_value_t prescaler_value = TWI__PRESCALER_VALUE__1;
 
// Compute bit rate and prescaler value.
do
{
bit_rate = twi__compute_bit_rate
(
frequency,
prescaler_configurations[prescaler_value].value
);
} while (UINT8_MAX < bit_rate && TWI__PRESCALER_VALUE__INVALID > prescaler_value++);
 
// Set bit rate.
TWBR = bit_rate;
 
// Set prescaler value.
TWSR = prescaler_configurations[prescaler_value].bits;
}
 
/**************************************************************************//**
* \fn twi__error_t twi__start(void)
*
* \brief
******************************************************************************/
twi__error_t
twi__start
(
void
){
// Send start condition.
TWCR = (1 << TWINT) | (1 << TWSTA) | (1 << TWEN);
 
// Wait for TWINT flag set. This indicates that the START condition has
// been transmitted.
while (!(TWCR & (1 << TWINT)));
 
// Check value of TWI Status Register. Mask prescaler bits.
if (TWSR & TW_NO_INFO != TW_START)
{
// If status is different from START (TW_START), return error.
return TWI__ERROR__ERROR;
}
 
return TWI__ERROR__NONE;
}
 
/**************************************************************************//**
* \fn twi__error_t twi__repeat_start(void)
*
* \brief
******************************************************************************/
twi__error_t
twi__repeat_start
(
void
){
// TODO: check if TWSTO must be set.
// Send start condition.
TWCR = (1 << TWEN) | (1 << TWINT) | (1 << TWSTA) | (1 << TWSTO);
 
// Wait for TWINT flag set. This indicates that the START condition has
// been transmitted.
while (!(TWCR & (1 << TWINT)));
 
// Check value of TWI Status Register. Mask prescaler bits.
if (TWSR & TW_NO_INFO != TW_REP_START)
{
// If status different from START (TW_REP_START), return error.
return TWI__ERROR__ERROR;
}
 
return TWI__ERROR__NONE;
}
 
/**************************************************************************//**
* \fn twi__error_t twi__send_slar(uint8_t sla)
*
* \brief
*
* \param sla
******************************************************************************/
twi__error_t
twi__send_slar
(
uint8_t sla
){
// Load SLA into TWDR register.
TWDR = sla | TW_READ;
 
// Clear TWINT bit in TWCR to start transmission of address.
TWCR = (1 << TWINT) | (1 << TWEN);
 
// Wait for TWINT flag set. This indicates that the SLA+W (TW_WRITE) has
// been transmitted, and ACK/NACK has been received.
while (!(TWCR & (1 << TWINT)));
 
// Check value of TWI Status Register. Mask prescaler bits. If status
// different from MT_SLA_ACK (TW_MR_SLA_ACK), return error.
if (TWSR & TW_NO_INFO != TW_MR_SLA_ACK)
{
return TWI__ERROR__ERROR;
}
 
return TWI__ERROR__NONE;
}
 
/**************************************************************************//**
* \fn twi__error_t twi__send_slaw(uint8_t sla)
*
* \brief
*
* \param sla
******************************************************************************/
twi__error_t
twi__send_slaw
(
uint8_t sla
){
// Load SLA into TWDR register.
TWDR = sla | TW_WRITE;
 
// Clear TWINT bit in TWCR to start transmission of address.
TWCR = (1 << TWINT) | (1 << TWEN);
 
// Wait for TWINT flag set. This indicates that the SLA+W (TW_WRITE) has
// been transmitted, and ACK/NACK has been received.
while (!(TWCR & (1 << TWINT)));
 
// Check value of TWI Status Register. Mask prescaler bits. If status
// different from MT_SLA_ACK (TW_MT_SLA_ACK), return error.
if (TWSR & TW_NO_INFO != TW_MT_SLA_ACK)
{
return TWI__ERROR__ERROR;
}
 
return TWI__ERROR__NONE;
}
 
/**************************************************************************//**
* \fn twi__error_t twi__send_data(uint8_t data)
*
* \brief
*
* \param data Data to send.
******************************************************************************/
twi__error_t
twi__send_data
(
uint8_t data
){
// Load data into TWDR register.
TWDR = data;
 
// Clear TWINT bit in TWCR to start transmission of data.
TWCR = (1 << TWINT) | (1 << TWEN);
 
// Wait for TWINT flag set. This indicates that the data has been
// transmitted, and ACK/NACK has been receiver.
while (!(TWCR & (1 << TWINT)));
 
// Check value of TWI status register. Mask prescaler bits. If status
// different from MT_DATA_ACK (TW_MT_DATA_ACK), return error.
if (TWSR & TW_NO_INFO != TW_MT_DATA_ACK)
{
return TWI__ERROR__ERROR;
}
 
return TWI__ERROR__NONE;
}
 
/**************************************************************************//**
* \fn twi__error_t twi__receive_data_ack(uint8_t* p_data)
*
* \brief
*
* \param p_data
******************************************************************************/
twi__error_t
twi__receive_data_ack
(
uint8_t* p_data
){
// Check the preconditions.
assert(NULL != p_data);
 
TWCR = (1 << TWEN) | (1 << TWINT) | (1 << TWEA);
 
while (!(TWCR & (1 << TWINT)));
 
if ((TWSR & TW_NO_INFO) != TW_MR_DATA_ACK)
{
return TWI__ERROR__ERROR;
}
 
*p_data = TWDR;
 
return TWI__ERROR__NONE;
}
 
/**************************************************************************//**
* \fn twi__error_t twi__receive_data_nack(uint8_t* p_data)
*
* \brief
*
* \param p_data
******************************************************************************/
twi__error_t
twi__receive_data_nack
(
uint8_t* p_data
){
// Check the preconditions.
assert(NULL != p_data);
 
TWCR = (1 << TWEN) | (1 << TWINT);
 
while (!(TWCR & (1 << TWINT)));
 
if ((TWSR & TW_NO_INFO) != TW_MR_DATA_NACK)
{
return TWI__ERROR__ERROR;
}
 
*p_data = TWDR;
 
return TWI__ERROR__NONE;
}
 
/**************************************************************************//**
* \fn void twi__stop(void)
*
* \brief Stop TWI.
******************************************************************************/
void
twi__stop
(
void
){
// Transmit stop operation.
TWCR = (1 << TWINT) | (1 << TWEN) | (1 << TWSTO);
 
// Wait for stop.
while (TWCR & (1 << TWSTO));
}
 
/******************************************************************************
* Private function definitions.
******************************************************************************/
 
/**************************************************************************//**
* \fn static inline uint8_t twi__compute_bit_rate(
* uint32_t f_scl,
* uint8_t prescaler_value)
*
* \brief
*
* \param f_scl SCL frequency.
* \param prescaler_value Prescaler value.
******************************************************************************/
static inline
uint8_t
twi__compute_bit_rate
(
uint32_t f_scl,
uint8_t prescaler_value
){
uint8_t bit_rate = (F_CPU - 16 * f_scl) / (2 * f_scl * prescaler_value);
 
return bit_rate;
}
/trunk/libraries/twi/src/SConscript
0,0 → 1,13
# Import environment set for target.
Import('env_target')
 
# Define target name.
TARGET = 'twi'
 
# Define source files.
sources = [
'twi.c'
]
 
# Build library.
env_target.BuildLibrary(sources, TARGET)
/trunk/libraries/twi/twi.h
0,0 → 1,176
/**************************************************************************//**
* \brief TWI library
* \author Copyright (C) 2011 Julien Le Sech - www.idreammicro.com
* \version 1.0
* \date 20090501
*
* This file is part of the iDreamMicro library.
*
* This library is free software: you can redistribute it and/or modify it under
* the terms of the GNU Lesser General Public License as published by the Free
* Software Foundation, either version 3 of the License, or (at your option) any
* later version.
*
* This library is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
* FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more
* details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with this program. If not, see http://www.gnu.org/licenses/
******************************************************************************/
 
/**************************************************************************//**
* \headerfile twi.h
******************************************************************************/
 
#ifndef H__IDREAMMICRO__TWI__H
#define H__IDREAMMICRO__TWI__H
 
#ifdef _cplusplus
extern "C"{
#endif
 
/******************************************************************************
* Header file inclusions.
******************************************************************************/
 
#include <stdint.h>
 
/******************************************************************************
* Public type definitions.
******************************************************************************/
 
/**************************************************************************//**
* \typedef twi__error_t
*
* \brief TWI errors.
******************************************************************************/
// TODO: more errors.
typedef enum twi__errors
{
TWI__ERROR__NONE,
TWI__ERROR__ERROR,
TWI__ERROR__INVALID
} twi__error_t;
 
/******************************************************************************
* Public function prototypes.
******************************************************************************/
 
/**************************************************************************//**
* \fn void twi__initialize(uint32_t frequency)
*
* \brief Initialize TWI.
*
* \param frequency TWI frequency (up to 400 kHz).
******************************************************************************/
void
twi__initialize
(
uint32_t frequency
);
 
/**************************************************************************//**
* \fn twi__error_t twi__start(void)
*
* \brief
******************************************************************************/
twi__error_t
twi__start
(
void
);
 
/**************************************************************************//**
* \fn twi__error_t twi__repeat_start(void)
*
* \brief
******************************************************************************/
twi__error_t
twi__repeat_start
(
void
);
 
/**************************************************************************//**
* \fn twi__error_t twi__send_slar(uint8_t sla)
*
* \brief
*
* \param sla
******************************************************************************/
twi__error_t
twi__send_slar
(
uint8_t sla
);
 
/**************************************************************************//**
* \fn twi__error_t twi__send_slaw(uint8_t sla)
*
* \brief
*
* \param sla
******************************************************************************/
twi__error_t
twi__send_slaw
(
uint8_t sla
);
 
/**************************************************************************//**
* \fn twi__error_t twi__send_data(uint8_t data)
*
* \brief
*
* \param data Data to send.
******************************************************************************/
twi__error_t
twi__send_data
(
uint8_t data
);
 
/**************************************************************************//**
* \fn twi__error_t twi__receive_data_ack(uint8_t* p_data)
*
* \brief
*
* \param p_data
******************************************************************************/
twi__error_t
twi__receive_data_ack
(
uint8_t* p_data
);
 
/**************************************************************************//**
* \fn twi__error_t twi__receive_data_nack(uint8_t* p_data)
*
* \brief
*
* \param p_data
******************************************************************************/
twi__error_t
twi__receive_data_nack
(
uint8_t* p_data
);
 
/**************************************************************************//**
* \fn void twi__stop(void)
*
* \brief
******************************************************************************/
void
twi__stop
(
void
);
 
#ifdef _cplusplus
}
#endif
 
#endif /* H__IDREAMMICRO__TWI__H */
/trunk/libraries/twi/test/SConscript
0,0 → 1,16
# Import environment set for target.
Import('env_target')
 
# Set target name.
TARGET = 'twi__test'
 
# Set source file.
sources = [
'twi__test.c'
]
 
# Build project and libraries.
env_target.BuildProject(sources, TARGET)
 
# Compute memory usage.
env_target.ComputeMemoryUsage(TARGET)
/trunk/libraries/twi/demo/SConscript
0,0 → 1,16
# Import environment set for target.
Import('env_target')
 
# Set target name.
TARGET = 'twi__demo'
 
# Set source file.
sources = [
'twi__demo.c'
]
 
# Build project and libraries.
env_target.BuildProject(sources, TARGET)
 
# Compute memory usage.
env_target.ComputeMemoryUsage(TARGET)
/trunk/libraries/twi/SConscript
0,0 → 1,16
# Import environment set for target.
Import('env_target')
 
# Define directories to process.
directories = [
'src/'
]
 
# Process directories.
for directory in directories:
SConscript(
directory + 'SConscript',
variant_dir = '#build/' + '/libraries/twi/' + env_target['NAME'],
exports = { 'env_target' : env_target },
duplicate = 0
)
/trunk/libraries/twi/SConstruct
0,0 → 1,40
# Import build tools.
SConscript('#min_env/build_tools.py')
 
# Set environment for AVR-GCC.
SConscript('#min_env/env_target.py')
 
# Import environment set for AVR-GCC.
Import('env_target')
 
# Append CPPPATH.
env_target.Append(CPPPATH = [ '#../' ])
 
# Build library.
SConscript(
'src/SConscript',
variant_dir = '#build/lib/',
exports = { 'env_target' : env_target },
duplicate = 0
)
 
# Append LIBPATH and LIBS.
env_target.Append(LIBPATH = [ '#build/lib/'])
env_target.Append(LIBS = [ 'twi' ])
 
# Build demonstration program.
SConscript(
'demo/SConscript',
variant_dir = '#build/demo/',
exports = { 'env_target' : env_target },
duplicate = 0
)
 
# Build test program.
SConscript(
'test/SConscript',
variant_dir = '#build/test/',
exports = { 'env_target' : env_target },
duplicate = 0
)
 
/trunk/libraries/twi/min_env/env_target.py
0,0 → 1,27
# Create and initialize the environment.
env_target = Environment()
 
# Set environment for AVR-GCC.
env_target['CC'] = 'avr-gcc'
env_target['CPPPATH'] = '/usr/lib/avr/include'
env_target['OBJCOPY'] = 'avr-objcopy'
env_target['SIZE'] = 'avr-size'
env_target['AR'] = 'avr-ar'
env_target['RANLIB'] = 'avr-ranlib'
env_target.Append(CCFLAGS = '-Os')
 
# Define environment name.
env_target.Append(NAME = 'env_target')
 
# Microcontroller type.
env_target.Append(MCU = 'atmega328p')
# Microcontroller frequency in Hertz.
env_target.Append(F_CPU = '16000000UL')
 
# Set environment for an Atmel AVR ATmega328p microcontroller.
env_target.Append(CCFLAGS = '-mmcu=' + env_target['MCU'])
env_target.Append(LINKFLAGS = '-mmcu=' + env_target['MCU'])
env_target.Append(CPPDEFINES = 'F_CPU=' + env_target['F_CPU'])
 
# Export environment set for target.
Export('env_target')
/trunk/libraries/twi/min_env/build_tools.py
0,0 → 1,41
"""
Build project.
"""
def BuildProject(env, sources, target_name):
# Build program.
env.Program(target = target_name + '.elf', source = sources)
# Create hex binary file.
env.Command(
target_name + '.hex',
target_name + '.elf',
env['OBJCOPY'] + ' -O ihex $SOURCE $TARGET'
)
AddMethod(Environment, BuildProject)
 
"""
Build library.
"""
def BuildLibrary(env, sources, target_name):
# Build static library.
env.StaticLibrary(target = target_name, source = sources)
# Append LIBPATH and LIBS.
env.Append(LIBPATH = [ '#build/libraries/' + target_name + '/' + env['NAME'] ])
env.Append(LIBS = [ target_name ])
 
AddMethod(Environment, BuildLibrary)
 
"""
Compute memory usage.
"""
def ComputeMemoryUsage(env, target_name):
# Compute memory usage.
env.Command(
None,
target_name + '.elf',
env['SIZE'] + ' -C --mcu=' + env['MCU'] + ' $SOURCE'
)
AddMethod(Environment, ComputeMemoryUsage)
/trunk/libraries/usart/usart0.h
0,0 → 1,339
/**************************************************************************//**
* \brief USART0 library
* \author Copyright (C) 2011 Julien Le Sech - www.idreammicro.com
* \version 1.0
* \date 20090426
*
* This file is part of the iDreamMicro library.
*
* This library is free software: you can redistribute it and/or modify it under
* the terms of the GNU Lesser General Public License as published by the Free
* Software Foundation, either version 3 of the License, or (at your option) any
* later version.
*
* This library is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
* FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more
* details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with this program. If not, see http://www.gnu.org/licenses/
******************************************************************************/
 
/**************************************************************************//**
* \headerfile usart0.h
******************************************************************************/
 
#ifndef H__IDREAMMICRO__USART0__H
#define H__IDREAMMICRO__USART0__H
 
#ifdef _cplusplus
extern "C"{
#endif
 
/******************************************************************************
* Header file inclusions.
******************************************************************************/
 
#include <usart/usart.h>
 
#include <stdbool.h>
#include <stdint.h>
 
/******************************************************************************
* Public function prototypes.
******************************************************************************/
 
/**************************************************************************//**
* \fn void usart0__initialize(usart__configuration_t* p_configuration)
*
* \brief Initialize USART0.
*
* \param[in] p_configuration USART configuration. If null, default settings
* will be used.
*
* Default settings:
* - baudrate = 9600 bps;
* - 8 data bits;
* - 1 stop bit;
* - no parity.
******************************************************************************/
void
usart0__initialize
(
const usart__configuration_t* p_configuration
);
 
/**************************************************************************//**
* \fn void usart0__set_baudrate(usart__baudrate_t baudrate)
*
* \brief Set USART0 baudrate.
*
* \param baudrate baudrate to set (in bauds per second)
******************************************************************************/
void
usart0__set_baudrate
(
usart__baudrate_t baudrate
);
 
/**************************************************************************//**
* \fn void usart0__set_mode(usart__mode_t usart_mode)
*
* \brief Set USART0 mode.
*
* \param usart_mode Mode to set.
******************************************************************************/
void
usart0__set_mode
(
usart__mode_t usart_mode
);
 
/**************************************************************************//**
* \fn void usart0__set_data_size(usart__data_size_t data_size)
*
* \brief Set USART0 data size.
*
* \param data_size data size (in bits)
******************************************************************************/
void
usart0__set_data_size
(
usart__data_size_t data_size
);
 
/**************************************************************************//**
* \fn void usart0__set_stop_size(usart__stop_size_t stop_size)
*
* \brief Set USART0 stop size.
*
* \param stop_size stop size (in bits)
******************************************************************************/
void
usart0__set_stop_size
(
usart__stop_size_t stop_size
);
 
/**************************************************************************//**
* \fn void usart0__set_parity(usart__parity_t parity)
*
* \brief Set USART0 parity.
*
* \param parity parity to set
******************************************************************************/
void
usart0__set_parity
(
usart__parity_t parity
);
 
/**************************************************************************//**
* \fn void usart0__set_double_speed(bool double_speed)
*
* \brief Set double speed.
*
* \param double_speed True to set double speed, false otherwise.
******************************************************************************/
void
usart0__set_double_speed
(
bool double_speed
);
 
/**************************************************************************//**
* \fn void usart0__enable_receiver(void)
*
* \brief Enable USART 0 receiver.
******************************************************************************/
void
usart0__enable_receiver
(
void
);
 
/**************************************************************************//**
* \fn void usart0__disable_receiver(void)
*
* \brief Disable USART 0 receiver.
******************************************************************************/
void
usart0__disable_receiver
(
void
);
 
/**************************************************************************//**
* \fn void usart0__enable_transmitter(void)
*
* \brief Enable USART 0 transmitter.
******************************************************************************/
void
usart0__enable_transmitter
(
void
);
 
/**************************************************************************//**
* \fn void usart0__disable_transmitter(void)
*
* \brief Disable USART 0 transmitter.
******************************************************************************/
void
usart0__disable_transmitter
(
void
);
 
/**************************************************************************//**
* \fn uint8_t usart0__receive_byte(void)
*
* \brief Receive a byte on USART0.
*
* \return received byte
******************************************************************************/
uint16_t
usart0__receive_byte
(
void
);
 
/**************************************************************************//**
* \fn usart0__transmit_byte(uint8_t byte_to_transmit)
*
* \brief Transmit a byte on USART0.
*
* \param byte_to_transmit byte to transmit
******************************************************************************/
void
usart0__transmit_byte
(
uint16_t byte_to_transmit
);
 
/**************************************************************************//**
* \fn void usart0__flush(void)
*
* \brief Flush USART0 receiver buffer.
******************************************************************************/
void
usart0__flush
(
void
);
 
/**************************************************************************//**
* \fn void usart0__enable_rx_complete_interrupt(void)
*
* \brief Enable USART 0 receive complete interrupt.
******************************************************************************/
void
usart0__enable_rx_complete_interrupt
(
void
);
 
/**************************************************************************//**
* \fn void usart0__disable_rx_complete_interrupt(void)
*
* \brief Disable USART 0 receive complete interrupt.
******************************************************************************/
void
usart0__disable_rx_complete_interrupt
(
void
);
 
/**************************************************************************//**
* \fn void usart0__set_rx_complete_callback(
* const usart__rx_complete_callback_t* p_callback)
*
* \brief Set a callback to call when receive byte complete interrupt is
* generated.
*
* \param[in] p_callback Callback to set.
******************************************************************************/
void
usart0__set_rx_complete_callback
(
const usart__rx_complete_callback_t* p_callback
);
 
/**************************************************************************//**
* \fn void usart0__enable_tx_complete_interrupt(void)
*
* \brief Enable interrupt when TX complete.
******************************************************************************/
void
usart0__enable_tx_complete_interrupt
(
void
);
 
/**************************************************************************//**
* \fn void usart0__disable_tx_complete_interrupt(void)
*
* \brief Disable interrupt when TX complete.
******************************************************************************/
void
usart0__disable_tx_complete_interrupt
(
void
);
 
/**************************************************************************//**
* \fn void usart0__set_tx_complete_callback(
* const usart__tx_complete_callback_t* p_callback)
*
* \brief Set a callback to call when TX is complete.
*
* \param[in] p_callback Function to call.
******************************************************************************/
void
usart0__set_tx_complete_callback
(
const usart__tx_complete_callback_t* p_callback
);
 
/**************************************************************************//**
* \fn void usart0__enable_data_register_empty_interrupt()
*
* \brief Enable interrupt when data register is empty.
******************************************************************************/
void
usart0__enable_data_register_empty_interrupt
(
void
);
 
/**************************************************************************//**
* \fn void usart0__disable_data_register_empty_interrupt()
*
* \brief Disable interrupt when data register is empty.
******************************************************************************/
void
usart0__disable_data_register_empty_interrupt
(
void
);
 
/**************************************************************************//**
* \fn void usart0__set_data_register_empty_callback(
* const usart__data_register_empty_callback_t* p_callback)
*
* \brief Set a callback to call when data register is empty.
*
* \param[in] p_callback Function to call.
******************************************************************************/
void
usart0__set_data_register_empty_callback
(
const usart__data_register_empty_callback_t* p_callback
);
 
#ifdef _cplusplus
}
#endif
 
#endif /* H__IDREAMMICRO__USART0__H */
/trunk/libraries/usart/src/usart0_m128.c
0,0 → 1,664
/**************************************************************************//**
* \brief USART0 library
* \author Copyright (C) 2011 Julien Le Sech - www.idreammicro.com
* \version 1.0
* \date 20090426
*
* This file is part of the iDreamMicro library.
*
* This library is free software: you can redistribute it and/or modify it under
* the terms of the GNU Lesser General Public License as published by the Free
* Software Foundation, either version 3 of the License, or (at your option) any
* later version.
*
* This library is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
* FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more
* details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with this program. If not, see http://www.gnu.org/licenses/
******************************************************************************/
 
/**************************************************************************//**
* \file usart0_m128.c
******************************************************************************/
 
/******************************************************************************
* Header file inclusions.
******************************************************************************/
 
#include "../usart0.h"
 
#include <usart/usart.h>
 
#include <useful/bits.h>
 
#include <avr/interrupt.h>
#include <avr/io.h>
 
#include <assert.h>
#include <stdbool.h>
#include <stdint.h>
#include <stdlib.h>
 
/******************************************************************************
* Private variable declarations.
******************************************************************************/
 
static usart__rx_complete_callback_t* p_rx_complete = NULL;
static usart__tx_complete_callback_t* p_tx_complete = NULL;
static usart__data_register_empty_callback_t* p_data_register_empty = NULL;
 
static usart__configuration_t configuration =
{
.mode = USART__MODE__ASYNCHRONOUS,
.baudrate = USART__BAUDRATE__9600,
.data_size = USART__DATA_SIZE__8_BITS,
.stop_size = USART__STOP_SIZE__1_BIT,
.parity = USART__PARITY__DISABLED
};
 
static bool double_speed_is_set = false;
 
/******************************************************************************
* Private function prototypes.
******************************************************************************/
 
/**************************************************************************//**
*
******************************************************************************/
static inline
uint16_t
usart0__compute_ubrr
(
void
);
 
/******************************************************************************
* Public function definitions.
******************************************************************************/
 
/**************************************************************************//**
* \fn void usart0__initialize(usart__configuration_t* p_configuration)
*
* \brief Initialize USART0.
*
* \param[in] p_configuration USART configuration. If null, default settings
* will be used.
*
* Default settings:
* - baudrate = 9600 bps;
* - 8 data bits;
* - 1 stop bit;
* - no parity.
******************************************************************************/
void
usart0__initialize
(
const usart__configuration_t* p_configuration
){
// If p_configuration is not null, use it!
if (NULL != p_configuration)
{
configuration = *p_configuration;
}
 
// Set mode.
usart0__set_mode(configuration.mode);
 
// Set baud rate.
usart0__set_baudrate(configuration.baudrate);
usart0__set_double_speed(false);
 
// Configure settings.
usart0__set_data_size(configuration.data_size);
usart0__set_stop_size(configuration.stop_size);
usart0__set_parity(configuration.parity);
}
 
/**************************************************************************//**
* \fn void usart0__set_baudrate(usart__baudrate_t baudrate)
*
* \brief Set USART0 baudrate.
*
* \param baudrate baudrate to set (in bauds per second)
******************************************************************************/
void
usart0__set_baudrate
(
usart__baudrate_t baudrate
){
configuration.baudrate = baudrate;
 
uint16_t ubrr = usart0__compute_ubrr();
UBRR0H = (uint8_t)(ubrr >> 8);
UBRR0L = (uint8_t)ubrr;
}
 
/**************************************************************************//**
* \fn void usart0__set_mode(usart__mode_t usart_mode)
*
* \brief Set USART0 mode.
*
* \param usart_mode Mode to set.
******************************************************************************/
void
usart0__set_mode
(
usart__mode_t usart_mode
){
// Check the preconditions.
assert(USART__MODE__INVALID > usart_mode);
 
configuration.mode = usart_mode;
 
switch (usart_mode)
{
case USART__MODE__ASYNCHRONOUS:
{
BIT__RST(UCSR0C, UMSEL0);
}
break;
 
case USART__MODE__SYNCHRONOUS:
{
BIT__SET(UCSR0C, UMSEL0);
}
break;
 
case USART__MODE__MASTER_SPI:
case USART__MODE__INVALID:
default:
break;
}
}
 
/**************************************************************************//**
* \fn void usart0__set_data_size(usart__data_sizet data_size)
*
* \brief Set USART0 data size.
*
* \param data_size data size (in bits)
******************************************************************************/
void
usart0__set_data_size
(
usart__data_size_t data_size
){
configuration.data_size = data_size;
 
switch (data_size)
{
case USART__DATA_SIZE__5_BITS:
{
BIT__RST(UCSR0B, UCSZ02);
BIT__RST(UCSR0C, UCSZ01);
BIT__RST(UCSR0C, UCSZ00);
}
break;
 
case USART__DATA_SIZE__6_BITS:
{
BIT__RST(UCSR0B, UCSZ02);
BIT__RST(UCSR0C, UCSZ01);
BIT__SET(UCSR0C, UCSZ00);
}
break;
 
case USART__DATA_SIZE__7_BITS:
{
BIT__RST(UCSR0B, UCSZ02);
BIT__SET(UCSR0C, UCSZ01);
BIT__RST(UCSR0C, UCSZ00);
}
break;
 
case USART__DATA_SIZE__8_BITS:
{
BIT__RST(UCSR0B, UCSZ02);
BIT__SET(UCSR0C, UCSZ01);
BIT__SET(UCSR0C, UCSZ00);
}
break;
 
case USART__DATA_SIZE__9_BITS:
{
BIT__SET(UCSR0B, UCSZ02);
BIT__SET(UCSR0C, UCSZ01);
BIT__SET(UCSR0C, UCSZ00);
}
break;
 
default:
break;
}
}
 
/**************************************************************************//**
* \fn void usart0__set_stop_size(usart__stop_size_t stop_size)
*
* \brief Set USART0 stop size.
*
* \param stop_size stop size (in bits)
******************************************************************************/
void
usart0__set_stop_size
(
usart__stop_size_t stop_size
){
configuration.stop_size = stop_size;
 
if (USART__STOP_SIZE__1_BIT == stop_size)
{
BIT__RST(UCSR0C, USBS0);
}
else
{
BIT__SET(UCSR0C, USBS0);
}
}
 
/**************************************************************************//**
* \fn void usart0__set_parity(usart__parity_t parity)
*
* \brief Set USART0 parity.
*
* \param parity parity to set
******************************************************************************/
void
usart0__set_parity
(
usart__parity_t parity
){
configuration.parity = parity;
 
switch (parity)
{
case USART__PARITY__DISABLED:
{
BIT__RST(UCSR0C, UPM01);
BIT__RST(UCSR0C, UPM00);
}
break;
 
case USART__PARITY__EVEN:
{
BIT__SET(UCSR0C, UPM01);
BIT__RST(UCSR0C, UPM00);
}
break;
 
case USART__PARITY__ODD:
{
BIT__SET(UCSR0C, UPM01);
BIT__SET(UCSR0C, UPM00);
}
break;
 
default:
break;
}
}
 
/**************************************************************************//**
* \fn void usart0__set_double_speed(bool double_speed)
*
* \brief Set double speed.
*
* \param double_speed True to set double speed, false otherwise.
******************************************************************************/
void
usart0__set_double_speed
(
bool double_speed
){
double_speed_is_set = double_speed;
 
if (double_speed_is_set)
{
BIT__SET(UCSR0A, U2X0);
}
else
{
BIT__RST(UCSR0A, U2X0);
}
}
 
/**************************************************************************//**
* \fn void usart0__enable_receiver(void)
*
* \brief Enable USART 0 receiver.
******************************************************************************/
void
usart0__enable_receiver
(
void
){
BIT__SET(UCSR0B, RXEN0);
}
 
/**************************************************************************//**
* \fn void usart0__disable_receiver(void)
*
* \brief Disable USART 0 receiver.
******************************************************************************/
void
usart0__disable_receiver
(
void
){
BIT__RST(UCSR0B, RXEN0);
}
 
/**************************************************************************//**
* \fn void usart0__enable_transmitter(void)
*
* \brief Enable USART 0 transmitter.
******************************************************************************/
void
usart0__enable_transmitter
(
void
){
BIT__SET(UCSR0B, TXEN0);
}
 
/**************************************************************************//**
* \fn void usart0__disable_transmitter(void)
*
* \brief Disable USART 0 transmitter.
******************************************************************************/
void
usart0__disable_transmitter
(
void
){
BIT__RST(UCSR0B, TXEN0);
}
 
/**************************************************************************//**
* \fn uint8_t usart0__receive_byte(void)
*
* \brief Receive a byte on USART0.
*
* \return received byte
******************************************************************************/
uint16_t
usart0__receive_byte
(
void
){
// Wait for data to be received.
while (!(UCSR0A & (1 << RXC0)));
 
// Get received data.
uint16_t received_byte = UDR0;
 
if (USART__DATA_SIZE__9_BITS == configuration.data_size)
{
// If 9-bit data size, get 9th bit.
uint8_t resh = UCSR0B;
resh = (resh >> 1) & 0x01;
received_byte = (resh << 8) | received_byte;
}
 
// Return received data from buffer.
return received_byte;
}
 
/**************************************************************************//**
* \fn usart0__transmit_byte(uint8_t byte_to_transmit)
*
* \brief Transmit a byte on USART0.
*
* \param byte_to_transmit byte to transmit
******************************************************************************/
void
usart0__transmit_byte
(
uint16_t byte_to_transmit
){
// Wait for empty transmit buffer.
while (!(UCSR0A & (1 << UDRE0)));
 
if (USART__DATA_SIZE__9_BITS == configuration.data_size)
{
// If 9-bit data size, copy 9th bit to TXB80.
UCSR0B &= ~(1 << TXB80);
if (byte_to_transmit & 0x0100)
{
UCSR0B |= (1 << TXB80);
}
}
 
// Put data into transmit buffer, sends the data.
UDR0 = byte_to_transmit;
}
 
/**************************************************************************//**
* \fn void usart0__flush(void)
*
* \brief Flush USART0 receiver buffer.
******************************************************************************/
void
usart0__flush
(
void
){
uint8_t dummy = 0;
while (UCSR0A & (1 << RXC0))
{
dummy = UDR0;
}
}
 
/**************************************************************************//**
* \fn void usart0__enable_rx_complete_interrupt(void)
*
* \brief Enable USART 0 receive complete interrupt.
******************************************************************************/
void
usart0__enable_rx_complete_interrupt
(
void
){
BIT__SET(UCSR0B, RXCIE0);
sei();
}
 
/**************************************************************************//**
* \fn void usart0__disable_rx_complete_interrupt(void)
*
* \brief Disable USART 0 receive complete interrupt.
******************************************************************************/
void
usart0__disable_rx_complete_interrupt
(
void
){
BIT__RST(UCSR0B, RXCIE0);
sei();
}
 
/**************************************************************************//**
* \fn void usart0__set_rx_complete_callback(
* const usart__rx_complete_callback_t* p_callback)
*
* \brief Set a callback to call when receive byte complete interrupt is generated.
*
* \param[in] p_callback Callback to set.
******************************************************************************/
void
usart0__set_rx_complete_callback
(
const usart__rx_complete_callback_t* p_callback
){
// Check the preconditions.
assert(NULL != p_callback);
 
p_rx_complete = p_callback;
}
 
/**************************************************************************//**
*
******************************************************************************/
void
usart0__enable_tx_complete_interrupt
(
void
){
BIT__SET(UCSR0B, TXCIE0);
sei();
}
 
/**************************************************************************//**
*
******************************************************************************/
void
usart0__disable_tx_complete_interrupt
(
void
){
BIT__RST(UCSR0B, TXCIE0);
sei();
}
 
/**************************************************************************//**
*
******************************************************************************/
void
usart0__set_tx_complete_callback
(
const usart__tx_complete_callback_t* p_callback
){
// Check the preconditions.
assert(NULL != p_callback);
 
p_tx_complete = p_callback;
}
 
/**************************************************************************//**
*
******************************************************************************/
void
usart0__enable_data_register_empty_interrupt
(
void
){
BIT__SET(UCSR0B, UDRIE0);
sei();
}
 
/**************************************************************************//**
*
******************************************************************************/
void
usart0__disable_data_register_empty_interrupt
(
void
){
BIT__RST(UCSR0B, UDRIE0);
sei();
}
 
/**************************************************************************//**
*
******************************************************************************/
void
usart0__set_data_register_empty_callback
(
const usart__data_register_empty_callback_t* p_callback
){
// Check the preconditions.
assert(NULL != p_callback);
 
p_data_register_empty = p_callback;
}
 
/******************************************************************************
* Private function definitions.
******************************************************************************/
 
/**************************************************************************//**
* \fn static uint16_t usart0__compute_ubrr(void)
*
* \brief Compute ubrr value.
*
* \return ubrr value.
******************************************************************************/
static inline
uint16_t
usart0__compute_ubrr
(
void
){
uint16_t ubrr = 0;
 
switch (configuration.mode)
{
case USART__MODE__ASYNCHRONOUS:
{
if (!double_speed_is_set)
{
ubrr = F_CPU / (16 * usart__baudrate_values[configuration.baudrate]) - 1;
}
else
{
ubrr = F_CPU / (8 * usart__baudrate_values[configuration.baudrate]) - 1;
}
}
break;
 
case USART__MODE__SYNCHRONOUS:
{
ubrr = F_CPU / (2 * usart__baudrate_values[configuration.baudrate]) - 1;
}
break;
 
case USART__MODE__MASTER_SPI:
break;
 
default:
break;
}
 
return ubrr;
}
 
/******************************************************************************
* Interrupt vectors.
******************************************************************************/
 
/**************************************************************************//**
* \fn ISR(USART_RX_vect)
******************************************************************************/
ISR(USART0_RX_vect)
{
if (NULL != p_rx_complete)
{
p_rx_complete();
}
}
 
/**************************************************************************//**
* \fn ISR(USART_TX_vect)
******************************************************************************/
ISR(USART0_TX_vect)
{
if (NULL != p_tx_complete)
{
p_tx_complete();
}
}
 
/**************************************************************************//**
* \fn ISR(USART_UDRE_vect)
******************************************************************************/
ISR(USART0_UDRE_vect)
{
if (NULL != p_data_register_empty)
{
p_data_register_empty();
}
}
/trunk/libraries/usart/src/usart0_m2560.c
0,0 → 1,702
/**************************************************************************//**
* \brief USART0 library
* \author Copyright (C) 2011 Julien Le Sech - www.idreammicro.com
* \version 1.0
* \date 20090426
*
* This file is part of the iDreamMicro library.
*
* This library is free software: you can redistribute it and/or modify it under
* the terms of the GNU Lesser General Public License as published by the Free
* Software Foundation, either version 3 of the License, or (at your option) any
* later version.
*
* This library is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
* FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more
* details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with this program. If not, see http://www.gnu.org/licenses/
******************************************************************************/
 
/**************************************************************************//**
* \file usart0_m2560.c
******************************************************************************/
 
/******************************************************************************
* Header file inclusions.
******************************************************************************/
 
#include "../usart0.h"
#include "../include/usart_prv.h"
 
#include <usart/usart.h>
 
#include <useful/bits.h>
 
#include <avr/interrupt.h>
#include <avr/io.h>
 
#include <assert.h>
#include <stdbool.h>
#include <stdint.h>
#include <stdlib.h>
 
/******************************************************************************
* Private variable declarations.
******************************************************************************/
 
static usart__rx_complete_callback_t* p_rx_complete = NULL;
static usart__tx_complete_callback_t* p_tx_complete = NULL;
static usart__data_register_empty_callback_t* p_data_register_empty = NULL;
 
static usart__configuration_t configuration =
{
.mode = USART__MODE__ASYNCHRONOUS,
.baudrate = USART__BAUDRATE__9600,
.data_size = USART__DATA_SIZE__8_BITS,
.stop_size = USART__STOP_SIZE__1_BIT,
.parity = USART__PARITY__DISABLED
};
 
static bool double_speed_is_set = false;
 
/******************************************************************************
* Private function prototypes.
******************************************************************************/
 
/**************************************************************************//**
* \fn static inline uint16_t usart0__compute_ubrr(void)
*
* \brief Compute UBRR register value.
*
* \return UBRR value.
******************************************************************************/
static inline
uint16_t
usart0__compute_ubrr
(
void
);
 
/******************************************************************************
* Public function definitions.
******************************************************************************/
 
/**************************************************************************//**
* \fn void usart0__initialize(usart__configuration_t* p_configuration)
*
* \brief Initialize USART0.
*
* \param[in] p_configuration USART configuration. If null, default settings
* will be used.
*
* Default settings:
* - baudrate = 9600 bps;
* - 8 data bits;
* - 1 stop bit;
* - no parity.
******************************************************************************/
void
usart0__initialize
(
const usart__configuration_t* p_configuration
){
// If p_configuration is not null, use it!
if (NULL != p_configuration)
{
configuration = *p_configuration;
}
 
// Set mode.
usart0__set_mode(configuration.mode);
 
// Set baud rate.
usart0__set_baudrate(configuration.baudrate);
usart0__set_double_speed(false);
 
// Configure settings.
usart0__set_data_size(configuration.data_size);
usart0__set_stop_size(configuration.stop_size);
usart0__set_parity(configuration.parity);
}
 
/**************************************************************************//**
* \fn void usart0__set_baudrate(usart__baudrate_t baudrate)
*
* \brief Set USART0 baudrate.
*
* \param baudrate baudrate to set (in bauds per second)
******************************************************************************/
void
usart0__set_baudrate
(
usart__baudrate_t baudrate
){
configuration.baudrate = baudrate;
 
uint16_t ubrr = usart0__compute_ubrr();
UBRR0H = (uint8_t)(ubrr >> 8);
UBRR0L = (uint8_t)ubrr;
}
 
/**************************************************************************//**
* \fn void usart0__set_mode(usart__mode_t usart_mode)
*
* \brief Set USART0 mode.
*
* \param usart_mode Mode to set.
******************************************************************************/
void
usart0__set_mode
(
usart__mode_t usart_mode
){
// Check the preconditions.
assert(USART__MODE__INVALID > usart_mode);
 
configuration.mode = usart_mode;
 
switch (usart_mode)
{
case USART__MODE__ASYNCHRONOUS:
{
BIT__RST(UCSR0C, UMSEL01);
BIT__RST(UCSR0C, UMSEL00);
}
break;
 
case USART__MODE__SYNCHRONOUS:
{
BIT__RST(UCSR0C, UMSEL01);
BIT__SET(UCSR0C, UMSEL00);
}
break;
 
case USART__MODE__MASTER_SPI:
{
BIT__SET(UCSR0C, UMSEL01);
BIT__SET(UCSR0C, UMSEL00);
}
break;
 
case USART__MODE__INVALID:
default:
break;
}
}
 
/**************************************************************************//**
* \fn void usart0__set_data_size(usart__data_sizet data_size)
*
* \brief Set USART0 data size.
*
* \param data_size data size (in bits)
******************************************************************************/
void
usart0__set_data_size
(
usart__data_size_t data_size
){
configuration.data_size = data_size;
 
switch (data_size)
{
case USART__DATA_SIZE__5_BITS:
{
BIT__RST(UCSR0B, UCSZ02);
BIT__RST(UCSR0C, UCSZ01);
BIT__RST(UCSR0C, UCSZ00);
}
break;
 
case USART__DATA_SIZE__6_BITS:
{
BIT__RST(UCSR0B, UCSZ02);
BIT__RST(UCSR0C, UCSZ01);
BIT__SET(UCSR0C, UCSZ00);
}
break;
 
case USART__DATA_SIZE__7_BITS:
{
BIT__RST(UCSR0B, UCSZ02);
BIT__SET(UCSR0C, UCSZ01);
BIT__RST(UCSR0C, UCSZ00);
}
break;
 
case USART__DATA_SIZE__8_BITS:
{
BIT__RST(UCSR0B, UCSZ02);
BIT__SET(UCSR0C, UCSZ01);
BIT__SET(UCSR0C, UCSZ00);
}
break;
 
case USART__DATA_SIZE__9_BITS:
{
BIT__SET(UCSR0B, UCSZ02);
BIT__SET(UCSR0C, UCSZ01);
BIT__SET(UCSR0C, UCSZ00);
}
break;
 
default:
break;
}
}
 
/**************************************************************************//**
* \fn void usart0__set_stop_size(usart__stop_size_t stop_size)
*
* \brief Set USART0 stop size.
*
* \param stop_size stop size (in bits)
******************************************************************************/
void
usart0__set_stop_size
(
usart__stop_size_t stop_size
){
configuration.stop_size = stop_size;
 
if (USART__STOP_SIZE__1_BIT == stop_size)
{
BIT__RST(UCSR0C, USBS0);
}
else
{
BIT__SET(UCSR0C, USBS0);
}
}
 
/**************************************************************************//**
* \fn void usart0__set_parity(usart__parity_t parity)
*
* \brief Set USART0 parity.
*
* \param parity parity to set
******************************************************************************/
void
usart0__set_parity
(
usart__parity_t parity
){
configuration.parity = parity;
 
switch (parity)
{
case USART__PARITY__DISABLED:
{
BIT__RST(UCSR0C, UPM01);
BIT__RST(UCSR0C, UPM00);
}
break;
 
case USART__PARITY__EVEN:
{
BIT__SET(UCSR0C, UPM01);
BIT__RST(UCSR0C, UPM00);
}
break;
 
case USART__PARITY__ODD:
{
BIT__SET(UCSR0C, UPM01);
BIT__SET(UCSR0C, UPM00);
}
break;
 
default:
break;
}
}
 
/**************************************************************************//**
* \fn void usart0__set_double_speed(bool double_speed)
*
* \brief Set double speed.
*
* \param double_speed True to set double speed, false otherwise.
******************************************************************************/
void
usart0__set_double_speed
(
bool double_speed
){
double_speed_is_set = double_speed;
 
if (double_speed_is_set)
{
BIT__SET(UCSR0A, U2X0);
}
else
{
BIT__RST(UCSR0A, U2X0);
}
}
 
/**************************************************************************//**
* \fn void usart0__enable_receiver(void)
*
* \brief Enable USART 0 receiver.
******************************************************************************/
void
usart0__enable_receiver
(
void
){
BIT__SET(UCSR0B, RXEN0);
}
 
/**************************************************************************//**
* \fn void usart0__disable_receiver(void)
*
* \brief Disable USART 0 receiver.
******************************************************************************/
void
usart0__disable_receiver
(
void
){
BIT__RST(UCSR0B, RXEN0);
}
 
/**************************************************************************//**
* \fn void usart0__enable_transmitter(void)
*
* \brief Enable USART 0 transmitter.
******************************************************************************/
void
usart0__enable_transmitter
(
void
){
BIT__SET(UCSR0B, TXEN0);
}
 
/**************************************************************************//**
* \fn void usart0__disable_transmitter(void)
*
* \brief Disable USART 0 transmitter.
******************************************************************************/
void
usart0__disable_transmitter
(
void
){
BIT__RST(UCSR0B, TXEN0);
}
 
/**************************************************************************//**
* \fn uint8_t usart0__receive_byte(void)
*
* \brief Receive a byte on USART0.
*
* \return received byte
******************************************************************************/
uint16_t
usart0__receive_byte
(
void
){
// Wait for data to be received.
while (!(UCSR0A & (1 << RXC0)));
 
// Get received data.
uint16_t received_byte = UDR0;
 
if (USART__DATA_SIZE__9_BITS == configuration.data_size)
{
// If 9-bit data size, get 9th bit.
uint8_t resh = UCSR0B;
resh = (resh >> 1) & 0x01;
received_byte = (resh << 8) | received_byte;
}
 
// Return received data from buffer.
return received_byte;
}
 
/**************************************************************************//**
* \fn usart0__transmit_byte(uint8_t byte_to_transmit)
*
* \brief Transmit a byte on USART0.
*
* \param byte_to_transmit byte to transmit
******************************************************************************/
void
usart0__transmit_byte
(
uint16_t byte_to_transmit
){
// Wait for empty transmit buffer.
while (!(UCSR0A & (1 << UDRE0)));
 
if (USART__DATA_SIZE__9_BITS == configuration.data_size)
{
// If 9-bit data size, copy 9th bit to TXB80.
UCSR0B &= ~(1 << TXB80);
if (byte_to_transmit & 0x0100)
{
UCSR0B |= (1 << TXB80);
}
}
 
// Put data into transmit buffer, sends the data.
UDR0 = byte_to_transmit;
}
 
/**************************************************************************//**
* \fn void usart0__flush(void)
*
* \brief Flush USART0 receiver buffer.
******************************************************************************/
void
usart0__flush
(
void
){
uint8_t dummy = 0;
while (UCSR0A & (1 << RXC0))
{
dummy = UDR0;
}
}
 
/**************************************************************************//**
* \fn void usart0__enable_rx_complete_interrupt(void)
*
* \brief Enable USART 0 receive complete interrupt.
******************************************************************************/
void
usart0__enable_rx_complete_interrupt
(
void
){
BIT__SET(UCSR0B, RXCIE0);
sei();
}
 
/**************************************************************************//**
* \fn void usart0__disable_rx_complete_interrupt(void)
*
* \brief Disable USART 0 receive complete interrupt.
******************************************************************************/
void
usart0__disable_rx_complete_interrupt
(
void
){
BIT__RST(UCSR0B, RXCIE0);
sei();
}
 
/**************************************************************************//**
* \fn void usart0__set_rx_complete_callback(
* const usart__rx_complete_callback_t* p_callback)
*
* \brief Set a callback to call when receive byte complete interrupt is
* generated.
*
* \param[in] p_callback Callback to set.
******************************************************************************/
void
usart0__set_rx_complete_callback
(
const usart__rx_complete_callback_t* p_callback
){
// Check the preconditions.
assert(NULL != p_callback);
 
p_rx_complete = p_callback;
}
 
/**************************************************************************//**
* \fn void usart0__enable_tx_complete_interrupt(void)
*
* \brief Enable interrupt when TX complete.
******************************************************************************/
void
usart0__enable_tx_complete_interrupt
(
void
){
BIT__SET(UCSR0B, TXCIE0);
sei();
}
 
/**************************************************************************//**
* \fn void usart0__disable_tx_complete_interrupt(void)
*
* \brief Disable interrupt when TX complete.
******************************************************************************/
void
usart0__disable_tx_complete_interrupt
(
void
){
BIT__RST(UCSR0B, TXCIE0);
sei();
}
 
/**************************************************************************//**
* \fn void usart0__set_tx_complete_callback(
* const usart__tx_complete_callback_t* p_callback)
*
* \brief Set a callback to call when TX is complete.
*
* \param[in] p_callback Function to call.
******************************************************************************/
void
usart0__set_tx_complete_callback
(
const usart__tx_complete_callback_t* p_callback
){
// Check the preconditions.
assert(NULL != p_callback);
 
p_tx_complete = p_callback;
}
 
/**************************************************************************//**
* \fn void usart0__enable_data_register_empty_interrupt()
*
* \brief Enable interrupt when data register is empty.
******************************************************************************/
void
usart0__enable_data_register_empty_interrupt
(
void
){
BIT__SET(UCSR0B, UDRIE0);
sei();
}
 
/**************************************************************************//**
* \fn void usart0__disable_data_register_empty_interrupt()
*
* \brief Disable interrupt when data register is empty.
******************************************************************************/
void
usart0__disable_data_register_empty_interrupt
(
void
){
BIT__RST(UCSR0B, UDRIE0);
sei();
}
 
/**************************************************************************//**
* \fn void usart0__set_data_register_empty_callback(
* const usart__data_register_empty_callback_t* p_callback)
*
* \brief Set a callback to call when data register is empty.
*
* \param[in] p_callback Function to call.
******************************************************************************/
void
usart0__set_data_register_empty_callback
(
const usart__data_register_empty_callback_t* p_callback
){
// Check the preconditions.
assert(NULL != p_callback);
 
p_data_register_empty = p_callback;
}
 
/******************************************************************************
* Private function definitions.
******************************************************************************/
 
/**************************************************************************//**
* \fn static inline uint16_t usart0__compute_ubrr(void)
*
* \brief Compute UBRR register value.
*
* \return UBRR value.
******************************************************************************/
static inline
uint16_t
usart0__compute_ubrr
(
void
){
uint16_t ubrr = 0;
 
switch (configuration.mode)
{
case USART__MODE__ASYNCHRONOUS:
{
if (!double_speed_is_set)
{
ubrr = F_CPU / (16 * usart__baudrate_values[configuration.baudrate]) - 1;
}
else
{
ubrr = F_CPU / (8 * usart__baudrate_values[configuration.baudrate]) - 1;
}
}
break;
 
case USART__MODE__SYNCHRONOUS:
{
ubrr = F_CPU / (2 * usart__baudrate_values[configuration.baudrate]) - 1;
}
break;
 
case USART__MODE__MASTER_SPI:
break;
 
default:
break;
}
 
return ubrr;
}
 
/******************************************************************************
* Interrupt vectors.
******************************************************************************/
 
/**************************************************************************//**
* \fn ISR(USART_RX_vect)
*
* \brief RX interrupt vector.
******************************************************************************/
ISR(USART0_RX_vect)
{
if (NULL != p_rx_complete)
{
p_rx_complete();
}
}
 
/**************************************************************************//**
* \fn ISR(USART_TX_vect)
*
* \brief TX interrupt vector.
******************************************************************************/
ISR(USART0_TX_vect)
{
if (NULL != p_tx_complete)
{
p_tx_complete();
}
}
 
/**************************************************************************//**
* \fn ISR(USART_UDRE_vect)
*
* \brief Data register empty interrupt vector.
******************************************************************************/
ISR(USART0_UDRE_vect)
{
if (NULL != p_data_register_empty)
{
p_data_register_empty();
}
}
/trunk/libraries/usart/src/usart0_m328.c
0,0 → 1,702
/**************************************************************************//**
* \brief USART0 library
* \author Copyright (C) 2011 Julien Le Sech - www.idreammicro.com
* \version 1.0
* \date 20090426
*
* This file is part of the iDreamMicro library.
*
* This library is free software: you can redistribute it and/or modify it under
* the terms of the GNU Lesser General Public License as published by the Free
* Software Foundation, either version 3 of the License, or (at your option) any
* later version.
*
* This library is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
* FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more
* details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with this program. If not, see http://www.gnu.org/licenses/
******************************************************************************/
 
/**************************************************************************//**
* \file usart0_m328.c
******************************************************************************/
 
/******************************************************************************
* Header file inclusions.
******************************************************************************/
 
#include "../usart0.h"
#include "../include/usart_prv.h"
 
#include <usart/usart.h>
 
#include <useful/bits.h>
 
#include <avr/interrupt.h>
#include <avr/io.h>
 
#include <assert.h>
#include <stdbool.h>
#include <stdint.h>
#include <stdlib.h>
 
/******************************************************************************
* Private variable declarations.
******************************************************************************/
 
static usart__rx_complete_callback_t* p_rx_complete = NULL;
static usart__tx_complete_callback_t* p_tx_complete = NULL;
static usart__data_register_empty_callback_t* p_data_register_empty = NULL;
 
static usart__configuration_t configuration =
{
.mode = USART__MODE__ASYNCHRONOUS,
.baudrate = USART__BAUDRATE__9600,
.data_size = USART__DATA_SIZE__8_BITS,
.stop_size = USART__STOP_SIZE__1_BIT,
.parity = USART__PARITY__DISABLED
};
 
static bool double_speed_is_set = false;
 
/******************************************************************************
* Private function prototypes.
******************************************************************************/
 
/**************************************************************************//**
* \fn static inline uint16_t usart0__compute_ubrr(void)
*
* \brief Compute UBRR register value.
*
* \return UBRR value.
******************************************************************************/
static inline
uint16_t
usart0__compute_ubrr
(
void
);
 
/******************************************************************************
* Public function definitions.
******************************************************************************/
 
/**************************************************************************//**
* \fn void usart0__initialize(usart__configuration_t* p_configuration)
*
* \brief Initialize USART0.
*
* \param[in] p_configuration USART configuration. If null, default settings
* will be used.
*
* Default settings:
* - baudrate = 9600 bps;
* - 8 data bits;
* - 1 stop bit;
* - no parity.
******************************************************************************/
void
usart0__initialize
(
const usart__configuration_t* p_configuration
){
// If p_configuration is not null, use it!
if (NULL != p_configuration)
{
configuration = *p_configuration;
}
 
// Set mode.
usart0__set_mode(configuration.mode);
 
// Set baud rate.
usart0__set_baudrate(configuration.baudrate);
usart0__set_double_speed(false);
 
// Configure settings.
usart0__set_data_size(configuration.data_size);
usart0__set_stop_size(configuration.stop_size);
usart0__set_parity(configuration.parity);
}
 
/**************************************************************************//**
* \fn void usart0__set_baudrate(usart__baudrate_t baudrate)
*
* \brief Set USART0 baudrate.
*
* \param baudrate baudrate to set (in bauds per second)
******************************************************************************/
void
usart0__set_baudrate
(
usart__baudrate_t baudrate
){
configuration.baudrate = baudrate;
 
uint16_t ubrr = usart0__compute_ubrr();
UBRR0H = (uint8_t)(ubrr >> 8);
UBRR0L = (uint8_t)ubrr;
}
 
/**************************************************************************//**
* \fn void usart0__set_mode(usart__mode_t usart_mode)
*
* \brief Set USART0 mode.
*
* \param usart_mode Mode to set.
******************************************************************************/
void
usart0__set_mode
(
usart__mode_t usart_mode
){
// Check the preconditions.
assert(USART__MODE__INVALID > usart_mode);
 
configuration.mode = usart_mode;
 
switch (usart_mode)
{
case USART__MODE__ASYNCHRONOUS:
{
BIT__RST(UCSR0C, UMSEL01);
BIT__RST(UCSR0C, UMSEL00);
}
break;
 
case USART__MODE__SYNCHRONOUS:
{
BIT__RST(UCSR0C, UMSEL01);
BIT__SET(UCSR0C, UMSEL00);
}
break;
 
case USART__MODE__MASTER_SPI:
{
BIT__SET(UCSR0C, UMSEL01);
BIT__SET(UCSR0C, UMSEL00);
}
break;
 
case USART__MODE__INVALID:
default:
break;
}
}
 
/**************************************************************************//**
* \fn void usart0__set_data_size(usart__data_sizet data_size)
*
* \brief Set USART0 data size.
*
* \param data_size data size (in bits)
******************************************************************************/
void
usart0__set_data_size
(
usart__data_size_t data_size
){
configuration.data_size = data_size;
 
switch (data_size)
{
case USART__DATA_SIZE__5_BITS:
{
BIT__RST(UCSR0B, UCSZ02);
BIT__RST(UCSR0C, UCSZ01);
BIT__RST(UCSR0C, UCSZ00);
}
break;
 
case USART__DATA_SIZE__6_BITS:
{
BIT__RST(UCSR0B, UCSZ02);
BIT__RST(UCSR0C, UCSZ01);
BIT__SET(UCSR0C, UCSZ00);
}
break;
 
case USART__DATA_SIZE__7_BITS:
{
BIT__RST(UCSR0B, UCSZ02);
BIT__SET(UCSR0C, UCSZ01);
BIT__RST(UCSR0C, UCSZ00);
}
break;
 
case USART__DATA_SIZE__8_BITS:
{
BIT__RST(UCSR0B, UCSZ02);
BIT__SET(UCSR0C, UCSZ01);
BIT__SET(UCSR0C, UCSZ00);
}
break;
 
case USART__DATA_SIZE__9_BITS:
{
BIT__SET(UCSR0B, UCSZ02);
BIT__SET(UCSR0C, UCSZ01);
BIT__SET(UCSR0C, UCSZ00);
}
break;
 
default:
break;
}
}
 
/**************************************************************************//**
* \fn void usart0__set_stop_size(usart__stop_size_t stop_size)
*
* \brief Set USART0 stop size.
*
* \param stop_size stop size (in bits)
******************************************************************************/
void
usart0__set_stop_size
(
usart__stop_size_t stop_size
){
configuration.stop_size = stop_size;
 
if (USART__STOP_SIZE__1_BIT == stop_size)
{
BIT__RST(UCSR0C, USBS0);
}
else
{
BIT__SET(UCSR0C, USBS0);
}
}
 
/**************************************************************************//**
* \fn void usart0__set_parity(usart__parity_t parity)
*
* \brief Set USART0 parity.
*
* \param parity parity to set
******************************************************************************/
void
usart0__set_parity
(
usart__parity_t parity
){
configuration.parity = parity;
 
switch (parity)
{
case USART__PARITY__DISABLED:
{
BIT__RST(UCSR0C, UPM01);
BIT__RST(UCSR0C, UPM00);
}
break;
 
case USART__PARITY__EVEN:
{
BIT__SET(UCSR0C, UPM01);
BIT__RST(UCSR0C, UPM00);
}
break;
 
case USART__PARITY__ODD:
{
BIT__SET(UCSR0C, UPM01);
BIT__SET(UCSR0C, UPM00);
}
break;
 
default:
break;
}
}
 
/**************************************************************************//**
* \fn void usart0__set_double_speed(bool double_speed)
*
* \brief Set double speed.
*
* \param double_speed True to set double speed, false otherwise.
******************************************************************************/
void
usart0__set_double_speed
(
bool double_speed
){
double_speed_is_set = double_speed;
 
if (double_speed_is_set)
{
BIT__SET(UCSR0A, U2X0);
}
else
{
BIT__RST(UCSR0A, U2X0);
}
}
 
/**************************************************************************//**
* \fn void usart0__enable_receiver(void)
*
* \brief Enable USART 0 receiver.
******************************************************************************/
void
usart0__enable_receiver
(
void
){
BIT__SET(UCSR0B, RXEN0);
}
 
/**************************************************************************//**
* \fn void usart0__disable_receiver(void)
*
* \brief Disable USART 0 receiver.
******************************************************************************/
void
usart0__disable_receiver
(
void
){
BIT__RST(UCSR0B, RXEN0);
}
 
/**************************************************************************//**
* \fn void usart0__enable_transmitter(void)
*
* \brief Enable USART 0 transmitter.
******************************************************************************/
void
usart0__enable_transmitter
(
void
){
BIT__SET(UCSR0B, TXEN0);
}
 
/**************************************************************************//**
* \fn void usart0__disable_transmitter(void)
*
* \brief Disable USART 0 transmitter.
******************************************************************************/
void
usart0__disable_transmitter
(
void
){
BIT__RST(UCSR0B, TXEN0);
}
 
/**************************************************************************//**
* \fn uint8_t usart0__receive_byte(void)
*
* \brief Receive a byte on USART0.
*
* \return received byte
******************************************************************************/
uint16_t
usart0__receive_byte
(
void
){
// Wait for data to be received.
while (!(UCSR0A & (1 << RXC0)));
 
// Get received data.
uint16_t received_byte = UDR0;
 
if (USART__DATA_SIZE__9_BITS == configuration.data_size)
{
// If 9-bit data size, get 9th bit.
uint8_t resh = UCSR0B;
resh = (resh >> 1) & 0x01;
received_byte = (resh << 8) | received_byte;
}
 
// Return received data from buffer.
return received_byte;
}
 
/**************************************************************************//**
* \fn usart0__transmit_byte(uint8_t byte_to_transmit)
*
* \brief Transmit a byte on USART0.
*
* \param byte_to_transmit byte to transmit
******************************************************************************/
void
usart0__transmit_byte
(
uint16_t byte_to_transmit
){
// Wait for empty transmit buffer.
while (!(UCSR0A & (1 << UDRE0)));
 
if (USART__DATA_SIZE__9_BITS == configuration.data_size)
{
// If 9-bit data size, copy 9th bit to TXB80.
UCSR0B &= ~(1 << TXB80);
if (byte_to_transmit & 0x0100)
{
UCSR0B |= (1 << TXB80);
}
}
 
// Put data into transmit buffer, sends the data.
UDR0 = byte_to_transmit;
}
 
/**************************************************************************//**
* \fn void usart0__flush(void)
*
* \brief Flush USART0 receiver buffer.
******************************************************************************/
void
usart0__flush
(
void
){
uint8_t dummy = 0;
while (UCSR0A & (1 << RXC0))
{
dummy = UDR0;
}
}
 
/**************************************************************************//**
* \fn void usart0__enable_rx_complete_interrupt(void)
*
* \brief Enable USART 0 receive complete interrupt.
******************************************************************************/
void
usart0__enable_rx_complete_interrupt
(
void
){
BIT__SET(UCSR0B, RXCIE0);
sei();
}
 
/**************************************************************************//**
* \fn void usart0__disable_rx_complete_interrupt(void)
*
* \brief Disable USART 0 receive complete interrupt.
******************************************************************************/
void
usart0__disable_rx_complete_interrupt
(
void
){
BIT__RST(UCSR0B, RXCIE0);
sei();
}
 
/**************************************************************************//**
* \fn void usart0__set_rx_complete_callback(
* const usart__rx_complete_callback_t* p_callback)
*
* \brief Set a callback to call when receive byte complete interrupt is
* generated.
*
* \param[in] p_callback Callback to set.
******************************************************************************/
void
usart0__set_rx_complete_callback
(
const usart__rx_complete_callback_t* p_callback
){
// Check the preconditions.
assert(NULL != p_callback);
 
p_rx_complete = p_callback;
}
 
/**************************************************************************//**
* \fn void usart0__enable_tx_complete_interrupt(void)
*
* \brief Enable interrupt when TX complete.
******************************************************************************/
void
usart0__enable_tx_complete_interrupt
(
void
){
BIT__SET(UCSR0B, TXCIE0);
sei();
}
 
/**************************************************************************//**
* \fn void usart0__disable_tx_complete_interrupt(void)
*
* \brief Disable interrupt when TX complete.
******************************************************************************/
void
usart0__disable_tx_complete_interrupt
(
void
){
BIT__RST(UCSR0B, TXCIE0);
sei();
}
 
/**************************************************************************//**
* \fn void usart0__set_tx_complete_callback(
* const usart__tx_complete_callback_t* p_callback)
*
* \brief Set a callback to call when TX is complete.
*
* \param[in] p_callback Function to call.
******************************************************************************/
void
usart0__set_tx_complete_callback
(
const usart__tx_complete_callback_t* p_callback
){
// Check the preconditions.
assert(NULL != p_callback);
 
p_tx_complete = p_callback;
}
 
/**************************************************************************//**
* \fn void usart0__enable_data_register_empty_interrupt()
*
* \brief Enable interrupt when data register is empty.
******************************************************************************/
void
usart0__enable_data_register_empty_interrupt
(
void
){
BIT__SET(UCSR0B, UDRIE0);
sei();
}
 
/**************************************************************************//**
* \fn void usart0__disable_data_register_empty_interrupt()
*
* \brief Disable interrupt when data register is empty.
******************************************************************************/
void
usart0__disable_data_register_empty_interrupt
(
void
){
BIT__RST(UCSR0B, UDRIE0);
sei();
}
 
/**************************************************************************//**
* \fn void usart0__set_data_register_empty_callback(
* const usart__data_register_empty_callback_t* p_callback)
*
* \brief Set a callback to call when data register is empty.
*
* \param[in] p_callback Function to call.
******************************************************************************/
void
usart0__set_data_register_empty_callback
(
const usart__data_register_empty_callback_t* p_callback
){
// Check the preconditions.
assert(NULL != p_callback);
 
p_data_register_empty = p_callback;
}
 
/******************************************************************************
* Private function definitions.
******************************************************************************/
 
/**************************************************************************//**
* \fn static inline uint16_t usart0__compute_ubrr(void)
*
* \brief Compute UBRR register value.
*
* \return UBRR value.
******************************************************************************/
static inline
uint16_t
usart0__compute_ubrr
(
void
){
uint16_t ubrr = 0;
 
switch (configuration.mode)
{
case USART__MODE__ASYNCHRONOUS:
{
if (!double_speed_is_set)
{
ubrr = F_CPU / (16 * usart__baudrate_values[configuration.baudrate]) - 1;
}
else
{
ubrr = F_CPU / (8 * usart__baudrate_values[configuration.baudrate]) - 1;
}
}
break;
 
case USART__MODE__SYNCHRONOUS:
{
ubrr = F_CPU / (2 * usart__baudrate_values[configuration.baudrate]) - 1;
}
break;
 
case USART__MODE__MASTER_SPI:
break;
 
default:
break;
}
 
return ubrr;
}
 
/******************************************************************************
* Interrupt vectors.
******************************************************************************/
 
/**************************************************************************//**
* \fn ISR(USART_RX_vect)
*
* \brief RX interrupt vector.
******************************************************************************/
ISR(USART_RX_vect)
{
if (NULL != p_rx_complete)
{
p_rx_complete();
}
}
 
/**************************************************************************//**
* \fn ISR(USART_TX_vect)
*
* \brief TX interrupt vector.
******************************************************************************/
ISR(USART_TX_vect)
{
if (NULL != p_tx_complete)
{
p_tx_complete();
}
}
 
/**************************************************************************//**
* \fn ISR(USART_UDRE_vect)
*
* \brief Data register empty interrupt vector.
******************************************************************************/
ISR(USART_UDRE_vect)
{
if (NULL != p_data_register_empty)
{
p_data_register_empty();
}
}
/trunk/libraries/usart/src/SConscript
0,0 → 1,18
# Import environment set for target.
Import('env_target')
 
# Define target name.
TARGET = 'usart'
 
# Define source files.
if env_target['MCU'] == 'atmega328p':
sources = [
'usart0_m328.c'
]
elif env_target['MCU'] == 'atmega2560':
sources = [
'usart0_m2560.c'
]
 
# Build library.
env_target.BuildLibrary(sources, TARGET)
/trunk/libraries/usart/include/usart_prv.h
0,0 → 1,68
/**************************************************************************//**
* \brief USART library
* \author Copyright (C) 2011 Julien Le Sech - www.idreammicro.com
* \version 1.0
* \date 20090426
*
* This file is part of the iDreamMicro library.
*
* This library is free software: you can redistribute it and/or modify it under
* the terms of the GNU Lesser General Public License as published by the Free
* Software Foundation, either version 3 of the License, or (at your option) any
* later version.
*
* This library is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
* FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more
* details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with this program. If not, see http://www.gnu.org/licenses/
******************************************************************************/
 
/**************************************************************************//**
* \headerfile usart_prv.h
******************************************************************************/
 
#ifndef H__IDREAMMICRO__USART_PRV__H
#define H__IDREAMMICRO__USART_PRV__H
 
#ifdef _cplusplus
extern "C"{
#endif
 
/**************************************************************************//**
* Header file inclusions.
******************************************************************************/
 
#include "../usart.h"
 
#include <stdint.h>
 
/**************************************************************************//**
* Internal constant definitions.
******************************************************************************/
 
const uint32_t usart__baudrate_values[] =
{
[USART__BAUDRATE__2400] = 2400,
[USART__BAUDRATE__4800] = 4800,
[USART__BAUDRATE__9600] = 9600,
[USART__BAUDRATE__14400] = 14400,
[USART__BAUDRATE__19200] = 19200,
[USART__BAUDRATE__28800] = 28800,
[USART__BAUDRATE__38400] = 38400,
[USART__BAUDRATE__57600] = 57600,
[USART__BAUDRATE__76800] = 76800,
[USART__BAUDRATE__115200] = 115200,
[USART__BAUDRATE__230400] = 230400,
[USART__BAUDRATE__250000] = 250000,
[USART__BAUDRATE__500000] = 500000,
[USART__BAUDRATE__1000000] = 1000000
};
 
#ifdef _cplusplus
}
#endif
 
#endif /* H__IDREAMMICRO__USART__H */
/trunk/libraries/usart/usart.h
0,0 → 1,174
/**************************************************************************//**
* \brief USART library
* \author Copyright (C) 2011 Julien Le Sech - www.idreammicro.com
* \version 1.0
* \date 20090426
*
* This file is part of the iDreamMicro library.
*
* This library is free software: you can redistribute it and/or modify it under
* the terms of the GNU Lesser General Public License as published by the Free
* Software Foundation, either version 3 of the License, or (at your option) any
* later version.
*
* This library is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
* FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more
* details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with this program. If not, see http://www.gnu.org/licenses/
******************************************************************************/
 
/**************************************************************************//**
* \headerfile usart.h
******************************************************************************/
 
#ifndef H__IDREAMMICRO__USART__H
#define H__IDREAMMICRO__USART__H
 
#ifdef _cplusplus
extern "C"{
#endif
 
/******************************************************************************
* Public types.
******************************************************************************/
 
/**************************************************************************//**
* \enum usart__baudrates
* \brief USART baudrates (in baud per second).
*
* \typedef usart__baudrate_t
* \brief USART baudrate (in baud per second).
******************************************************************************/
typedef enum usart__baudrates
{
USART__BAUDRATE__2400, /*!< 2400 bps. */
USART__BAUDRATE__4800, /*!< 4800 bps. */
USART__BAUDRATE__9600, /*!< 9600 bps. */
USART__BAUDRATE__14400, /*!< 14400 bps. */
USART__BAUDRATE__19200, /*!< 19200 bps. */
USART__BAUDRATE__28800, /*!< 28800 bps. */
USART__BAUDRATE__38400, /*!< 38400 bps. */
USART__BAUDRATE__57600, /*!< 57600 bps. */
USART__BAUDRATE__76800, /*!< 76800 bps. */
USART__BAUDRATE__115200, /*!< 115200 bps. */
USART__BAUDRATE__230400, /*!< 230400 bps. */
USART__BAUDRATE__250000, /*!< 250000 bps. */
USART__BAUDRATE__500000, /*!< 500000 bps. */
USART__BAUDRATE__1000000 /*!< 1000000 bps. */
} usart__baudrate_t;
 
/**************************************************************************//**
* \enum usart__modes
* \brief USART modes.
*
* \typedef usart__mode_t
* \brief USART mode.
******************************************************************************/
typedef enum usart__modes
{
USART__MODE__ASYNCHRONOUS,
USART__MODE__SYNCHRONOUS,
USART__MODE__MASTER_SPI,
USART__MODE__INVALID
} usart__mode_t;
 
/**************************************************************************//**
* \enum usart__data_sizes
* \brief USART data sizes.
*
* \typedef usart__data_size_t
* \brief USART data size.
******************************************************************************/
typedef enum usart__data_sizes
{
USART__DATA_SIZE__5_BITS, /*!< 5 data bits. */
USART__DATA_SIZE__6_BITS, /*!< 6 data bits. */
USART__DATA_SIZE__7_BITS, /*!< 7 data bits. */
USART__DATA_SIZE__8_BITS, /*!< 8 data bits. */
USART__DATA_SIZE__9_BITS /*!< 9 data bits. */
} usart__data_size_t;
 
/**************************************************************************//**
* \enum usart__stop_sizes
* \brief USART stop bits.
*
* \typedef usart__stop_size_t
* \brief USART stop bits.
******************************************************************************/
typedef enum usart__stop_sizes
{
USART__STOP_SIZE__1_BIT, /*!< 1 stop bit. */
USART__STOP_SIZE__2_BITS /*!< 2 stop bits. */
} usart__stop_size_t;
 
/**************************************************************************//**
* \enum usart__parities
* \brief USART parities.
*
* \typedef usart__parity_t
* \brief USART parity.
******************************************************************************/
typedef enum usart__parities
{
USART__PARITY__DISABLED, /*!< Parity disabled. */
USART__PARITY__EVEN, /*!< Even parity. */
USART__PARITY__ODD /*!< Odd parity. */
} usart__parity_t;
 
/**************************************************************************//**
* \struct usart__configuration
* \brief USART configuration.
*
* \typedef usart__configuration_t
* \brief USART configuration.
******************************************************************************/
typedef struct usart__configuration
{
usart__mode_t mode;
usart__baudrate_t baudrate;
usart__data_size_t data_size;
usart__stop_size_t stop_size;
usart__parity_t parity;
} usart__configuration_t;
 
/**************************************************************************//**
* \typedef usart__rx_complete_callback_t
* \brief RX complete callback.
******************************************************************************/
typedef
void
usart__rx_complete_callback_t
(
void
);
 
/**************************************************************************//**
* \typedef usart__tx_complete_callback_t
* \brief TX complete callback.
******************************************************************************/
typedef
void
usart__tx_complete_callback_t
(
void
);
 
/**************************************************************************//**
* \typedef usart__data_register_empty_callback_t
* \brief Data register empty callback.
******************************************************************************/
typedef
void
usart__data_register_empty_callback_t
(
void
);
 
#ifdef _cplusplus
}
#endif
 
#endif /* H__IDREAMMICRO__USART__H */
/trunk/libraries/usart/test/usart0__test.c
0,0 → 1,78
/**************************************************************************//**
* \brief USART library - Test program
* \author Copyright (C) 2011 Julien Le Sech - www.idreammicro.com
* \version 1.0
* \date 20090314
*
* This file is part of the iDreamMicro library.
*
* This library is free software: you can redistribute it and/or modify it under
* the terms of the GNU Lesser General Public License as published by the Free
* Software Foundation, either version 3 of the License, or (at your option) any
* later version.
*
* This library is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
* FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more
* details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with this program. If not, see http://www.gnu.org/licenses/
******************************************************************************/
 
/**************************************************************************//**
* \file usart0__test.c
******************************************************************************/
 
/******************************************************************************
* Header file inclusions.
******************************************************************************/
 
#include "../usart0.h"
 
#include <util/delay.h>
 
#include <stdlib.h>
 
/******************************************************************************
* Main function.
******************************************************************************/
 
/**************************************************************************//**
* \fn int main(void)
*
* \brief Main function.
*****************************************************************************/
int
main
(
void
){
// Initialize USART0.
usart0__initialize(NULL);
 
// Enbale transmitter.
usart0__enable_transmitter();
 
// Transmit characters.
for (;;)
{
usart0__transmit_byte('H');
usart0__transmit_byte('e');
usart0__transmit_byte('l');
usart0__transmit_byte('l');
usart0__transmit_byte('o');
usart0__transmit_byte(' ');
usart0__transmit_byte('W');
usart0__transmit_byte('o');
usart0__transmit_byte('r');
usart0__transmit_byte('l');
usart0__transmit_byte('d');
usart0__transmit_byte('!');
usart0__transmit_byte('\n');
 
_delay_ms(500);
}
 
return 0;
}
/trunk/libraries/usart/test/SConscript
0,0 → 1,16
# Import environment set for target.
Import('env_target')
 
# Set target name.
TARGET = 'usart0__test'
 
# Set source file.
sources = [
'usart0__test.c'
]
 
# Build project and libraries.
env_target.BuildProject(sources, TARGET)
 
# Compute memory usage.
env_target.ComputeMemoryUsage(TARGET)
/trunk/libraries/usart/demo/usart0__demo.c
0,0 → 1,78
/**************************************************************************//**
* \brief USART library - Demonstration program
* \author Copyright (C) 2011 Julien Le Sech - www.idreammicro.com
* \version 1.0
* \date 20090314
*
* This file is part of the iDreamMicro library.
*
* This library is free software: you can redistribute it and/or modify it under
* the terms of the GNU Lesser General Public License as published by the Free
* Software Foundation, either version 3 of the License, or (at your option) any
* later version.
*
* This library is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
* FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more
* details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with this program. If not, see http://www.gnu.org/licenses/
******************************************************************************/
 
/**************************************************************************//**
* \file usart0__demo.c
******************************************************************************/
 
/******************************************************************************
* Header file inclusions.
******************************************************************************/
 
#include "../usart0.h"
 
#include <util/delay.h>
 
#include <stdlib.h>
 
/******************************************************************************
* Main function.
******************************************************************************/
 
/**************************************************************************//**
* \fn int main(void)
*
* \brief Main function.
*****************************************************************************/
int
main
(
void
){
// Initialize USART0.
usart0__initialize(NULL);
 
// Enbale transmitter.
usart0__enable_transmitter();
 
// Transmit characters.
for (;;)
{
usart0__transmit_byte('H');
usart0__transmit_byte('e');
usart0__transmit_byte('l');
usart0__transmit_byte('l');
usart0__transmit_byte('o');
usart0__transmit_byte(' ');
usart0__transmit_byte('W');
usart0__transmit_byte('o');
usart0__transmit_byte('r');
usart0__transmit_byte('l');
usart0__transmit_byte('d');
usart0__transmit_byte('!');
usart0__transmit_byte('\n');
 
_delay_ms(500);
}
 
return 0;
}
/trunk/libraries/usart/demo/SConscript
0,0 → 1,16
# Import environment set for target.
Import('env_target')
 
# Set target name.
TARGET = 'usart0__demo'
 
# Set source file.
sources = [
'usart0__demo.c'
]
 
# Build project and libraries.
env_target.BuildProject(sources, TARGET)
 
# Compute memory usage.
env_target.ComputeMemoryUsage(TARGET)
/trunk/libraries/usart/.sconsign.dblite
Modification de propriétés sur libraries/usart/.sconsign.dblite
___________________________________________________________________
Added: svn:mime-type
## -0,0 +1 ##
+application/octet-stream
\ No newline at end of property
/trunk/libraries/usart/SConscript
0,0 → 1,16
# Import environment set for target.
Import('env_target')
 
# Define directories to process.
directories = [
'src/'
]
 
# Process directories.
for directory in directories:
SConscript(
directory + 'SConscript',
variant_dir = '#build/' + '/libraries/usart/' + env_target['NAME'],
exports = { 'env_target' : env_target },
duplicate = 0
)
/trunk/libraries/usart/SConstruct
0,0 → 1,40
# Import build tools.
SConscript('#min_env/build_tools.py')
 
# Set environment for AVR-GCC.
SConscript('#min_env/env_target.py')
 
# Import environment set for AVR-GCC.
Import('env_target')
 
# Append CPPPATH.
env_target.Append(CPPPATH = [ '#../' ])
 
# Build library.
SConscript(
'src/SConscript',
variant_dir = '#build/lib/',
exports = { 'env_target' : env_target },
duplicate = 0
)
 
# Append LIBPATH and LIBS.
env_target.Append(LIBPATH = [ '#build/lib/'])
env_target.Append(LIBS = [ 'usart' ])
 
# Build demonstration program.
SConscript(
'demo/SConscript',
variant_dir = '#build/demo/',
exports = { 'env_target' : env_target },
duplicate = 0
)
 
# Build test program.
SConscript(
'test/SConscript',
variant_dir = '#build/test/',
exports = { 'env_target' : env_target },
duplicate = 0
)
 
/trunk/libraries/usart/min_env/env_target.py
0,0 → 1,27
# Create and initialize the environment.
env_target = Environment()
 
# Set environment for AVR-GCC.
env_target['CC'] = 'avr-gcc'
env_target['CPPPATH'] = '/usr/lib/avr/include'
env_target['OBJCOPY'] = 'avr-objcopy'
env_target['SIZE'] = 'avr-size'
env_target['AR'] = 'avr-ar'
env_target['RANLIB'] = 'avr-ranlib'
env_target.Append(CCFLAGS = '-Os')
 
# Define environment name.
env_target.Append(NAME = 'env_target')
 
# Microcontroller type.
env_target.Append(MCU = 'atmega328p')
# Microcontroller frequency in Hertz.
env_target.Append(F_CPU = '16000000UL')
 
# Set environment for an Atmel AVR ATmega328p microcontroller.
env_target.Append(CCFLAGS = '-mmcu=' + env_target['MCU'])
env_target.Append(LINKFLAGS = '-mmcu=' + env_target['MCU'])
env_target.Append(CPPDEFINES = 'F_CPU=' + env_target['F_CPU'])
 
# Export environment set for target.
Export('env_target')
/trunk/libraries/usart/min_env/build_tools.py
0,0 → 1,41
"""
Build project.
"""
def BuildProject(env, sources, target_name):
# Build program.
env.Program(target = target_name + '.elf', source = sources)
# Create hex binary file.
env.Command(
target_name + '.hex',
target_name + '.elf',
env['OBJCOPY'] + ' -O ihex $SOURCE $TARGET'
)
AddMethod(Environment, BuildProject)
 
"""
Build library.
"""
def BuildLibrary(env, sources, target_name):
# Build static library.
env.StaticLibrary(target = target_name, source = sources)
# Append LIBPATH and LIBS.
env.Append(LIBPATH = [ '#build/libraries/' + target_name + '/' + env['NAME'] ])
env.Append(LIBS = [ target_name ])
 
AddMethod(Environment, BuildLibrary)
 
"""
Compute memory usage.
"""
def ComputeMemoryUsage(env, target_name):
# Compute memory usage.
env.Command(
None,
target_name + '.elf',
env['SIZE'] + ' -C --mcu=' + env['MCU'] + ' $SOURCE'
)
AddMethod(Environment, ComputeMemoryUsage)
/trunk/libraries/usart
Modification de propriétés sur libraries/usart
___________________________________________________________________
Added: svn:ignore
## -0,0 +1,2 ##
+build
+.sconsign.dblite
/trunk/libraries/useful/datetime.h
0,0 → 1,91
/**************************************************************************//**
* \brief Date and time management library
* \author Copyright (C) 2011 Julien Le Sech - www.idreammicro.com
* \version 1.0
* \date 20090501
*
* This file is part of the iDreamMicro library.
*
* This library is free software: you can redistribute it and/or modify it under
* the terms of the GNU Lesser General Public License as published by the Free
* Software Foundation, either version 3 of the License, or (at your option) any
* later version.
*
* This library is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
* FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more
* details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with this program. If not, see http://www.gnu.org/licenses/
******************************************************************************/
 
/**************************************************************************//**
* \headerfile datetime.h
******************************************************************************/
 
#ifndef H__IDREAMMICRO__USEFUL__DATETIME__H
#define H__IDREAMMICRO__USEFUL__DATETIME__H
 
#ifdef _cplusplus
extern "C"{
#endif
 
/******************************************************************************
* Header file inclusions.
******************************************************************************/
 
#include <stdint.h>
 
/******************************************************************************
* Public types definitions.
******************************************************************************/
 
/**************************************************************************//**
* \enum datetime__meridiems
* \brief Time meridiems.
*
* \typedef datetime__meridiem_t
* \brief Time meridiem.
******************************************************************************/
typedef enum datetime__meridiems
{
DATETIME__MERIDIEM__AM = 0, /*!< Ante meridiem. */
DATETIME__MERIDIEM__PM = 1 /*!< Post meridiem. */
} datetime__meridiem_t;
 
/**************************************************************************//**
* \struct datetime__time
* \brief Time.
*
* \typedef datetime__time_t
* \brief Time.
******************************************************************************/
typedef struct datetime__time
{
uint8_t seconds; /*!< Seconds (0-59). */
uint8_t minutes; /*!< Minutes (0-59). */
uint8_t hours; /*!< Hours (1-12 or 0-23). */
datetime__meridiem_t meridiem; /*!< Meridiem (AM-PM). */
} datetime__time_t;
 
/**************************************************************************//**
* \struct datetime__date
* \brief Date.
*
* \typedef datetime__date_t
* \brief Date.
******************************************************************************/
typedef struct datetime__date
{
uint8_t day; /*!< Day (1-7). */
uint8_t date; /*!< Date (1-31). */
uint8_t month; /*!< Month (1-12). */
uint8_t year; /*!< Year (0-99). */
} datetime__date_t;
 
#ifdef _cplusplus
}
#endif
 
#endif /* H__IDREAMMICRO__USEFUL__DATETIME__H */
/trunk/libraries/useful/miscellaneous.h
0,0 → 1,49
/**************************************************************************//**
* \brief Miscellaneous facilities
* \author Copyright (C) 2012 Julien Le Sech - www.idreammicro.com
* \version 1.0
* \date 20120709
*
* This file is part of the iDreamMicro library.
*
* This library is free software: you can redistribute it and/or modify it under
* the terms of the GNU Lesser General Public License as published by the Free
* Software Foundation, either version 3 of the License, or (at your option) any
* later version.
*
* This library is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
* FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more
* details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with this program. If not, see http://www.gnu.org/licenses/
******************************************************************************/
 
/**************************************************************************//**
* \headerfile miscellaneous.h
******************************************************************************/
 
#ifndef H__IDREAMMICRO__USEFUL__MISCELLANEOUS__H
#define H__IDREAMMICRO__USEFUL__MISCELLANEOUS__H
 
#ifdef _cplusplus
extern "C"{
#endif
 
/******************************************************************************
* Public macro definitions.
******************************************************************************/
 
/**************************************************************************//**
* \def ITEMS_IN_ARRAY
* \brief Get number of items in array.
******************************************************************************/
#define ITEMS_IN_ARRAY(array) (sizeof(array) / sizeof(*array))
 
#ifdef _cplusplus
}
#endif
 
#endif /* H__IDREAMMICRO__USEFUL__MISCELLANEOUS__H */
 
/trunk/libraries/useful/bits.h
0,0 → 1,67
/**************************************************************************//**
* \brief Bit manipulation library - API
* \author Copyright (C) 2011 Julien Le Sech - www.idreammicro.com
* \version 1.0
* \date 20110823
*
* This file is part of the iDreamMicro library.
*
* This library is free software: you can redistribute it and/or modify it under
* the terms of the GNU Lesser General Public License as published by the Free
* Software Foundation, either version 3 of the License, or (at your option) any
* later version.
*
* This library is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
* FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more
* details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with this program. If not, see http://www.gnu.org/licenses/
******************************************************************************/
 
/**************************************************************************//**
* \headerfile bits.h
******************************************************************************/
 
#ifndef H__IDREAMMICRO__USEFUL__BITS__H
#define H__IDREAMMICRO__USEFUL__BITS__H
 
#ifdef _cplusplus
extern "C"{
#endif
 
/******************************************************************************
* Public macro definitions.
******************************************************************************/
 
/**************************************************************************//**
* \def BIT__SET
* \brief Set a bit in a byte.
******************************************************************************/
#define BIT__SET(variable, bit) (variable |= (1 << bit))
 
/**************************************************************************//**
* \def BIT__RST
* \brief Reset a bit in a byte.
******************************************************************************/
#define BIT__RST(variable, bit) (variable &= ~(1 << bit))
 
/**************************************************************************//**
* \def BIT__TGL
* \brief Toggle a bit in a byte.
******************************************************************************/
#define BIT__TGL(variable, bit) (variable ^= (1 << bit))
 
/**************************************************************************//**
* \def BIT__TST
* \brief Test a bit in a byte.
******************************************************************************/
#define BIT__TST(variable, bit) (variable & (1 << bit))
 
#ifdef _cplusplus
}
#endif
 
#endif /* H__IDREAMMICRO__USEFUL__BITS__H */
 
/trunk/build_system/env_avr.py
0,0 → 1,29
# Create and initialize the environment.
env_avr = Environment()
 
# Set environment for AVR-GCC.
env_avr['CC'] = 'avr-gcc'
env_avr['OBJCOPY'] = 'avr-objcopy'
env_avr['SIZE'] = 'avr-size'
env_avr['AR'] = 'avr-ar'
env_avr['RANLIB'] = 'avr-ranlib'
env_avr['CPPPATH'] = '/usr/lib/avr/include'
 
# Set language standard.
env_avr.Append(CCFLAGS = '-std=c99')
 
# Set optimization level and call prologues/epilogues.
env_avr.Append(CCFLAGS = '-Os -mcall-prologues')
 
# Use short types.
env_avr.Append(CCFLAGS = '-funsigned-char -funsigned-bitfields -fpack-struct -fshort-enums')
 
# Don't include unused function and data.
env_avr.Append(CCFLAGS = '-ffunction-sections -fdata-sections')
env_avr.Append(LINKFLAGS = '-Wl,--gc-sections')
 
# Enable linker relaxation.
env_avr.Append(LINKFLAGS = '-Wl,--relax')
 
# Export environment set for AVR-GCC.
Export('env_avr')
/trunk/build_system/env_arduino_leonardo.py
0,0 → 1,21
# Import environment set for AVR-GCC.
Import('env_avr')
 
# Create target environment by cloning AVR environment.
env_target = env_avr.Clone()
 
# Define environment name.
env_target.Append(NAME = 'env_arduino_leonardo')
 
# Microcontroller type.
env_target.Append(MCU = 'atmega32u4')
# Microcontroller frequency in Hertz.
env_target.Append(F_CPU = '16000000UL')
 
# Set environment for an Atmel AVR ATmega32u4 microcontroller.
env_target.Append(CCFLAGS = '-mmcu=' + env_target['MCU'])
env_target.Append(LINKFLAGS = '-mmcu=' + env_target['MCU'])
env_target.Append(CPPDEFINES = 'F_CPU=' + env_target['F_CPU'])
 
# Export environment set for target.
Export('env_target')
/trunk/build_system/build_tools.py
0,0 → 1,49
"""
Build project.
"""
def BuildProject(env, libraries, sources, target_name):
# Build libraries.
for library in libraries:
SConscript(
'#libraries/' + library + '/SConscript',
exports = { 'env' : env },
duplicate = 0
)
# Build program.
env.Program(target = target_name + '.elf', source = sources)
# Create hex binary file.
env.Command(
target_name + '.hex',
target_name + '.elf',
env['OBJCOPY'] + ' -O ihex $SOURCE $TARGET'
)
AddMethod(Environment, BuildProject)
 
"""
Build library.
"""
def BuildLibrary(env, sources, target_name):
# Build static library.
env.StaticLibrary(target = target_name, source = sources)
# Append LIBPATH and LIBS.
env.Append(LIBPATH = [ '#build/libraries/' + target_name + '/' + env['NAME'] ])
env.Append(LIBS = [ target_name ])
 
AddMethod(Environment, BuildLibrary)
 
"""
Compute memory usage.
"""
def ComputeMemoryUsage(env, target_name):
# Compute memory usage.
env.Command(
None,
target_name + '.elf',
env['SIZE'] + ' -C --mcu=' + env['MCU'] + ' $SOURCE'
)
AddMethod(Environment, ComputeMemoryUsage)
/trunk/build_system/env_arduino_uno.py
0,0 → 1,21
# Import environment set for AVR-GCC.
Import('env_avr')
 
# Create target environment by cloning AVR environment.
env_target = env_avr.Clone()
 
# Define environment name.
env_target.Append(NAME = 'env_arduino_uno')
 
# Microcontroller type.
env_target.Append(MCU = 'atmega328p')
# Microcontroller frequency in Hertz.
env_target.Append(F_CPU = '16000000UL')
 
# Set environment for an Atmel AVR ATmega328p microcontroller.
env_target.Append(CCFLAGS = '-mmcu=' + env_target['MCU'])
env_target.Append(LINKFLAGS = '-mmcu=' + env_target['MCU'])
env_target.Append(CPPDEFINES = 'F_CPU=' + env_target['F_CPU'])
 
# Export environment set for target.
Export('env_target')
/trunk/build_system/env_arduino_mega2560.py
0,0 → 1,21
# Import environment set for AVR-GCC.
Import('env_avr')
 
# Create target environment by cloning AVR environment.
env_target = env_avr.Clone()
 
# Define environment name.
env_target.Append(NAME = 'env_arduino_mega2560')
 
# Microcontroller type.
env_target.Append(MCU = 'atmega2560')
# Microcontroller frequency in Hertz.
env_target.Append(F_CPU = '16000000UL')
 
# Set environment for an Atmel AVR Atmega 2560 microcontroller.
env_target.Append(CCFLAGS = '-mmcu=' + env_target['MCU'])
env_target.Append(LINKFLAGS = '-mmcu=' + env_target['MCU'])
env_target.Append(CPPDEFINES = 'F_CPU=' + env_target['F_CPU'])
 
# Export environment set for target.
Export('env_target')
/trunk/projects/clock/clock.c
0,0 → 1,172
/**************************************************************************//**
* \brief DS1307 RTC library - Demonstration program
* \author Copyright (C) 2011 Julien Le Sech - www.idreammicro.com
* \version 1.0
* \date 20090501
*
* This file is part of the iDreamMicro library.
*
* This library is free software: you can redistribute it and/or modify it under
* the terms of the GNU Lesser General Public License as published by the Free
* Software Foundation, either version 3 of the License, or (at your option) any
* later version.
*
* This library is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
* FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more
* details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with this program. If not, see http://www.gnu.org/licenses/
******************************************************************************/
 
/**************************************************************************//**
* \file demo_ds1307.c
******************************************************************************/
 
/******************************************************************************
* Header file inclusions.
******************************************************************************/
 
#include <deuligne/deuligne.h>
#include <ds1307/ds1307.h>
#include <twi/twi.h>
#include <usart/usart0.h>
#include <useful/datetime.h>
 
#include <avr/io.h>
#include <util/delay.h>
 
#include <assert.h>
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
 
/******************************************************************************
* Private function prototypes.
******************************************************************************/
 
/**************************************************************************//**
* \fn static void clock__transmit_string(const char* p_string)
*
* \brief Transmit a string through USART.
*
* \param[in] p_string String to transmit.
******************************************************************************/
static
void
clock__transmit_string
(
const char* p_string
);
 
/******************************************************************************
* Main function.
******************************************************************************/
 
/**************************************************************************//**
* \fn int main(void)
*
* \brief Main function.
*
* \return 0
******************************************************************************/
int main(void)
{
// Initialize USART0.
usart0__initialize(NULL);
 
// Enable transmitter.
usart0__enable_transmitter();
 
// Initialize TWI.
twi__initialize(DS1307__CLOCK_RATE);
 
// Initialize RTC.
ds1307__initialize();
 
// Declare some variables.
datetime__time_t time;
ds1307__hour_mode_t hour_mode;
datetime__date_t date;
 
// Initialize Deuligne and configure display.
deuligne__initialize();
deuligne__set_display(true, false, false);
 
// Switch on backlight.
deuligne__switch_on_backlight();
 
for (;;)
{
// Get RTC time.
ds1307__get_time(&time, &hour_mode);
 
// Get RTC date.
ds1307__get_date(&date);
 
char str_date[] = "dd/mm/yy";
snprintf
(
str_date,
strlen(str_date) + 1,
"%02u/%02u/%02u",
date.date,
date.month,
date.year
);
 
char str_time[] = "hh:mm:ss";
snprintf
(
str_time,
strlen(str_time) + 1,
"%02u:%02u:%02u",
time.hours,
time.minutes,
time.seconds
);
 
clock__transmit_string(&(str_date[0]));
usart0__transmit_byte(' ');
clock__transmit_string(&(str_time[0]));
usart0__transmit_byte('\n');
 
deuligne__set_cursor_position(DEULIGNE__DISPLAY_LINE_1, 0);
deuligne__write_string(str_date);
 
deuligne__set_cursor_position(DEULIGNE__DISPLAY_LINE_2, 0);
deuligne__write_string(str_time);
 
_delay_ms(1000);
}
 
return 0;
}
 
/******************************************************************************
* Private function definitions.
******************************************************************************/
 
/**************************************************************************//**
* \fn static void clock__transmit_string(const char* p_string)
*
* \brief Transmit a string through USART.
*
* \param[in] p_string String to transmit.
******************************************************************************/
static
void
clock__transmit_string
(
const char* p_string
){
// Check the preconditions.
assert(NULL != p_string);
 
while (*p_string != '\0')
{
usart0__transmit_byte(*p_string);
p_string++;
}
}
/trunk/projects/clock/SConscript
0,0 → 1,26
# Import environment set for target.
Import('env_target')
 
# Set target name.
TARGET = 'clock'
 
# Set libraries to use.
libraries = [
'deuligne',
'ds1307',
'mcp23008',
'adc',
'twi',
'usart'
]
 
# Set source file.
sources = 'clock.c'
 
# Build project and libraries.
env_target.BuildProject(libraries, sources, TARGET)
 
# Compute memory usage.
env_target.ComputeMemoryUsage(TARGET)
/trunk/projects/clock/SConstruct
0,0 → 1,30
# Set environment for AVR-GCC.
SConscript('#build_system/env_avr.py')
 
# Import environment set for AVR-GCC.
Import('env_avr')
 
# Append CPPPATH with the root path of libraries.
env_avr.Append(CPPPATH = [ '#libraries/' ])
 
# Define environments to use (one environment per target).
environments = [
'env_arduino_uno'
]
 
# Browse environments.
for environment in environments:
# Set environment for target.
SConscript(
'#build_system/' + environment + '.py',
exports = 'env_avr'
)
# Import environment set for target.
Import('env_target')
# Build program.
SConscript(
'SConscript',
variant_dir = '#build/' + 'projects/clock/' + environment,
exports = { 'env_target' : env_target },
duplicate = 0
)
/trunk/projects/ultimate/SConscript
0,0 → 1,23
# Import environment set for target.
Import('env_target')
 
# Set target name.
TARGET = 'ultimate'
 
# Set libraries to use.
libraries = [
'ds1307',
'digital_io',
'twi',
'usart'
]
 
# Set source file.
sources = 'ultimate.c'
 
# Build project and libraries.
env_target.BuildProject(libraries, sources, TARGET)
 
# Compute memory usage.
env_target.ComputeMemoryUsage(TARGET)
/trunk/projects/ultimate/ultimate.c
0,0 → 1,35
/**************************************************************************//**
* \file helloworld.c
******************************************************************************/
 
/******************************************************************************
* Header file inclusions.
******************************************************************************/
 
#include <digital_io/digital_io.h>
#include <twi/twi.h>
#include <usart/usart0.h>
 
#include <avr/io.h>
#include <util/delay.h>
 
/******************************************************************************
* Public function definitions.
******************************************************************************/
 
/**************************************************************************//**
* \fn int main(void)
*
* \brief Main function.
******************************************************************************/
int
main
(
void
){
for (;;)
{
_delay_ms(500);
}
return 0;
}
/trunk/projects/ultimate/SConstruct
0,0 → 1,31
# Set environment for AVR-GCC.
SConscript('#build_system/env_avr.py')
 
# Import environment set for AVR-GCC.
Import('env_avr')
 
# Append CPPPATH with the root path of libraries.
env_avr.Append(CPPPATH = [ '#libraries/' ])
 
# Define environments to use (one environment per target).
environments = [
'env_arduino_uno',
'env_arduino_mega2560'
]
 
# Browse environments.
for environment in environments:
# Set environment for target.
SConscript(
'#build_system/' + environment + '.py',
exports = 'env_avr'
)
# Import environment set for target.
Import('env_target')
# Build program.
SConscript(
'SConscript',
variant_dir = '#build/' + 'projects/ultimate/' + environment,
exports = { 'env_target' : env_target },
duplicate = 0
)
/trunk/projects/input_to_output/input_to_output.c
0,0 → 1,48
/**************************************************************************//**
* \file input_to_output.c
******************************************************************************/
 
/******************************************************************************
* Header file inclusions.
******************************************************************************/
 
#include <digital_io/digital_io.h>
 
#include <avr/io.h>
#include <util/delay.h>
 
/******************************************************************************
* Public function definitions.
******************************************************************************/
 
/**************************************************************************//**
* \fn int main(void)
*
* \brief Main function.
******************************************************************************/
int
main
(
void
){
// Configure PB4 as input.
digital_io__pin_position_t input = DIGITAL_IO__PORT_B | DIGITAL_IO__PIN_4;
digital_io__configure_pin(input, DIGITAL_IO__DIRECTION__INPUT);
// Configure PB5 as output.
digital_io__pin_position_t output = DIGITAL_IO__PORT_B | DIGITAL_IO__PIN_5;
digital_io__configure_pin(output, DIGITAL_IO__DIRECTION__OUTPUT);
 
for (;;)
{
// Get input level on PB4.
digital_io__level_t level = digital_io__get_pin_level(input);
 
// Set output level on PB5.
digital_io__set_pin_level(output, level);
 
_delay_ms(250);
}
 
return 0;
}
/trunk/projects/input_to_output/SConscript
0,0 → 1,19
# Import environment set for target.
Import('env_target')
 
# Set target name.
TARGET = 'input_to_output'
 
# Set libraries to use.
libraries = [
'digital_io'
]
 
# Set source file.
sources = 'input_to_output.c'
 
# Build project and libraries.
env_target.BuildProject(libraries, sources, TARGET)
 
# Compute memory usage.
env_target.ComputeMemoryUsage(TARGET)
/trunk/projects/input_to_output/SConstruct
0,0 → 1,32
# Set environment for AVR-GCC.
SConscript('#build_system/env_avr.py')
 
# Import environment set for AVR-GCC.
Import('env_avr')
 
# Append CPPPATH with the root path of libraries.
env_avr.Append(CPPPATH = [ '#libraries/' ])
 
# Define environments to use (one environment per target).
environments = [
'env_arduino_uno',
'env_arduino_mega2560'
]
 
# Browse environments.
for environment in environments:
# Set environment for target.
SConscript(
'#build_system/' + environment + '.py',
exports = 'env_avr'
)
# Import environment set for target.
Import('env_target')
# Build program.
SConscript(
'SConscript',
variant_dir = '#build/' + 'projects/input_to_output/' + environment,
exports = { 'env_target' : env_target },
duplicate = 0
)
 
/trunk/projects/helloworld/helloworld.c
0,0 → 1,46
/**************************************************************************//**
* \file helloworld.c
******************************************************************************/
 
/******************************************************************************
* Header file inclusions.
******************************************************************************/
 
#include <digital_io/digital_io.h>
 
#include <avr/io.h>
#include <util/delay.h>
 
/******************************************************************************
* Public function definitions.
******************************************************************************/
 
/**************************************************************************//**
* \fn int main(void)
*
* \brief Main function.
******************************************************************************/
int
main
(
void
){
// Declare pin.
digital_io__pin_position_t pin = DIGITAL_IO__PORT_B | DIGITAL_IO__PIN_5;
// Configure pin as output.
digital_io__configure_pin(pin, DIGITAL_IO__DIRECTION__OUTPUT);
 
for (;;)
{
// Set pin level.
digital_io__set_pin_level(pin, DIGITAL_IO__LEVEL__HIGH);
_delay_ms(1000);
 
// Reset pin level.
digital_io__set_pin_level(pin, DIGITAL_IO__LEVEL__LOW);
_delay_ms(1000);
}
 
return 0;
}
/trunk/projects/helloworld/SConscript
0,0 → 1,19
# Import environment set for target.
Import('env_target')
 
# Set target name.
TARGET = 'helloworld'
 
# Set libraries to use.
libraries = [
'digital_io'
]
 
# Set source file.
sources = 'helloworld.c'
 
# Build project and libraries.
env_target.BuildProject(libraries, sources, TARGET)
 
# Compute memory usage.
env_target.ComputeMemoryUsage(TARGET)
/trunk/projects/helloworld/SConstruct
0,0 → 1,31
# Set environment for AVR-GCC.
SConscript('#build_system/env_avr.py')
 
# Import environment set for AVR-GCC.
Import('env_avr')
 
# Append CPPPATH with the root path of libraries.
env_avr.Append(CPPPATH = [ '#libraries/' ])
 
# Define environments to use (one environment per target).
environments = [
'env_arduino_uno',
'env_arduino_mega2560'
]
 
# Browse environments.
for environment in environments:
# Set environment for target.
SConscript(
'#build_system/' + environment + '.py',
exports = 'env_avr'
)
# Import environment set for target.
Import('env_target')
# Build program.
SConscript(
'SConscript',
variant_dir = '#build/' + 'projects/helloworld/' + environment,
exports = { 'env_target' : env_target },
duplicate = 0
)
/trunk/projects/SConscript
0,0 → 1,11
# Define projects to build.
projects = [
'clock/',
'helloworld/',
'input_to_output/',
'ultimate/'
]
 
# Build each project.
for project in projects:
SConscript(project + 'SConstruct')
/trunk/SConstruct
0,0 → 1,5
# Import build tools.
SConscript('build_system/build_tools.py')
 
# Execute projects SConscript.
SConscript('projects/SConscript')
/trunk/.
Modification de propriétés sur .
___________________________________________________________________
Added: svn:ignore
## -0,0 +1 ##
+build