From: lottaviano Date: Tue, 29 Sep 2009 12:39:19 +0000 (+0000) Subject: doc: Various fixes to documentation infrastructure X-Git-Tag: 2.3.0~88 X-Git-Url: https://codewiz.org/gitweb?a=commitdiff_plain;h=e908bacaa1f3309e2d06049a2555d978d3d7e7f9;p=bertos.git doc: Various fixes to documentation infrastructure - Move all doc related files to doc/ - Use INPUT directive to correctly generate docs - Move FILE_PATTERNS to common Doxyfile git-svn-id: https://src.develer.com/svnoss/bertos/trunk@2992 38d2e660-2303-0410-9eaa-f027e97ec537 --- diff --git a/Doxyfile b/Doxyfile index efbf87a2..2ba9bf1b 100644 --- a/Doxyfile +++ b/Doxyfile @@ -9,16 +9,12 @@ OUTPUT_DIRECTORY = doc/reference -# If the value of the INPUT tag contains directories, you can use the -# FILE_PATTERNS tag to specify one or more wildcard pattern (like *.cpp -# and *.h) to filter out the source-files in the directories. If left -# blank the following patterns are tested: -# *.c *.cc *.cxx *.cpp *.c++ *.java *.ii *.ixx *.ipp *.i++ *.inl *.h *.hh *.hxx -# *.hpp *.h++ *.idl *.odl *.cs *.php *.php3 *.inc *.m *.mm *.py *.f90 - -FILE_PATTERNS = *.h \ - Mainpage.online \ - *.c +# 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 += doc/Mainpage.online # 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 diff --git a/Doxyfile-common b/Doxyfile-common index d728550e..6b9d751a 100644 --- a/Doxyfile-common +++ b/Doxyfile-common @@ -552,7 +552,17 @@ WARN_LOGFILE = # directories like "/usr/src/myproject". Separate the files or directories # with spaces. -INPUT = +INPUT += bertos/ + +# If the value of the INPUT tag contains directories, you can use the +# FILE_PATTERNS tag to specify one or more wildcard pattern (like *.cpp +# and *.h) to filter out the source-files in the directories. If left +# blank the following patterns are tested: +# *.c *.cc *.cxx *.cpp *.c++ *.java *.ii *.ixx *.ipp *.i++ *.inl *.h *.hh *.hxx +# *.hpp *.h++ *.idl *.odl *.cs *.php *.php3 *.inc *.m *.mm *.py *.f90 + +FILE_PATTERNS = *.h \ + *.c # 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 diff --git a/Doxyfile-offline b/Doxyfile-offline index be718f6b..80b361a8 100644 --- a/Doxyfile-offline +++ b/Doxyfile-offline @@ -10,18 +10,13 @@ OUTPUT_DIRECTORY = doc/offline-reference +# 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. -# If the value of the INPUT tag contains directories, you can use the -# FILE_PATTERNS tag to specify one or more wildcard pattern (like *.cpp -# and *.h) to filter out the source-files in the directories. If left -# blank the following patterns are tested: -# *.c *.cc *.cxx *.cpp *.c++ *.java *.ii *.ixx *.ipp *.i++ *.inl *.h *.hh *.hxx -# *.hpp *.h++ *.idl *.odl *.cs *.php *.php3 *.inc *.m *.mm *.py *.f90 - -FILE_PATTERNS = *.h \ - README.bertos \ - *.c \ - STATUS +INPUT += doc/README.bertos \ + doc/STATUS # 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 diff --git a/Doxyfile-snapshot b/Doxyfile-snapshot index 07100ba2..d4bbed28 100644 --- a/Doxyfile-snapshot +++ b/Doxyfile-snapshot @@ -7,18 +7,14 @@ # 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/reference - -# If the value of the INPUT tag contains directories, you can use the -# FILE_PATTERNS tag to specify one or more wildcard pattern (like *.cpp -# and *.h) to filter out the source-files in the directories. If left -# blank the following patterns are tested: -# *.c *.cc *.cxx *.cpp *.c++ *.java *.ii *.ixx *.ipp *.i++ *.inl *.h *.hh *.hxx -# *.hpp *.h++ *.idl *.odl *.cs *.php *.php3 *.inc *.m *.mm *.py *.f90 - -FILE_PATTERNS = *.h \ - Mainpage.snapshot \ - *.c +OUTPUT_DIRECTORY = doc/reference-snapshot + +# 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 += doc/Mainpage.snapshot # 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 diff --git a/Mainpage.online b/Mainpage.online deleted file mode 100644 index 07a36d88..00000000 --- a/Mainpage.online +++ /dev/null @@ -1,100 +0,0 @@ -/*! - - - -\mainpage - -\section overview Overview - -BeRTOS is a real-time operating system designed for building applications -for embedded systems, like reference boards, test boards, or custom boards. - -It has a modular structure: its components can be used in very different -environments, from 8-bit processor to Linux and Win32 hosted application -(for debug purpose), using a wide range of compilers. - -\section history History and Motivation - -BeRTOS was born as a extremely modular, highly optimized and fine-tuned -operating system for embedded programming. -As a result, each module has its own scope and can be used alone or in -cooperation with other modules. -It's even possible to use most of the drivers without activating the kernel module. - -We have grown it following our guidelines: simplicity and beauty. -These guidelines made it possible to evolve it in a full-featured real -time operating system, with more modularity than many other embedded OSes, -without giving up reliability and performace. - -To achieve the highest possible reusability, most BeRTOS components are -designed for fine-grained modularity and minimal external dependencies. -Most non-essential features can be configured out for applications with small -memory footprint requirements. - -\section features Features - - - multitasking kernel with IPC, semaphores, priority levels; - - a comprehensive set of generic drivers for a wide range of devices, - which can be easily customized to the actual hardware: timer, serial, - adc, ntc, pwm, stepper motors, dc motors, lcd, keyboards, buzzer, eeprom; - - full graphic subsystem for simple displays, with font support, bitmaps, - clipping, text formatting, interactive menus; - - simple console with command parser; - - readline-like support for command history; - - entropy generator and random numbers generator optimized for embedded - systems; - - checksumming and hashing functions (CRC, MD2); - - full hash-table implementation with double-hashing collision resolution; - - XMODEM protocol implementation; - - RLE compression algorithm; - -\section structure Directory Structure - -The modules are sorted in subdirectories by their category: - - - app/ : demo applications; - - bertos/algo/ : algorithms; - - bertos/cfg/ : configuration stuff; - - bertos/drv/ : hardware drivers; - - bertos/dt/ : experimental object oriented gui toolkit; - - bertos/emul/ : Qt-based emulator framework for embedded applications; - - bertos/fonts/ : fonts; - - bertos/fs/ : file system related stuff; - - bertos/gfx/ : general purpose graphics routines; - - bertos/gui/ : widgets for simple displays; - - bertos/hw/ : hardware-specific declarations; - - bertos/icons/ : conversion tool from image TXT format to LCD bitmap; - - bertos/kern/ : multitasking kernel; - - bertos/mware/ : algorithms, other standalone code; - - bertos/struct/ : containers and other data structures; - - bertos/os/ : OS-abstraction layers for hosted environments; - - doc/ : documentation; - -The top-level directory contains a few support headers that are meant to be -usable by any C/C++ embedded or hosted application. - -\section license License - -BeRTOS is provided under the term of the GNU General Public License -(see LICENSE.GPL) with following exception: - -\verbatim - -As a special exception, you may use this file as part of a free software -library without restriction. Specifically, if other files instantiate -templates or use macros or inline functions from this file, or you compile -this file and link it with other files to produce an executable, this -file does not by itself cause the resulting executable to be covered by -the GNU General Public License. This exception does not however -invalidate any other reasons why the executable file might be covered by -the GNU General Public License. - -\endverbatim - -*/ diff --git a/Mainpage.snapshot b/Mainpage.snapshot deleted file mode 100644 index b20936de..00000000 --- a/Mainpage.snapshot +++ /dev/null @@ -1,103 +0,0 @@ -/*! - - - -\mainpage - -This documentation is generated from BeRTOS SVN. As such, it may contain modules -and/or additional documentation not present in official releases. - -\section overview Overview - -BeRTOS is a real-time operating system designed for building applications -for embedded systems, like reference boards, test boards, or custom boards. - -It has a modular structure: its components can be used in very different -environments, from 8-bit processor to Linux and Win32 hosted application -(for debug purpose), using a wide range of compilers. - -\section history History and Motivation - -BeRTOS was born as a extremely modular, highly optimized and fine-tuned -operating system for embedded programming. -As a result, each module has its own scope and can be used alone or in -cooperation with other modules. -It's even possible to use most of the drivers without activating the kernel module. - -We have grown it following our guidelines: simplicity and beauty. -These guidelines made it possible to evolve it in a full-featured real -time operating system, with more modularity than many other embedded OSes, -without giving up reliability and performace. - -To achieve the highest possible reusability, most BeRTOS components are -designed for fine-grained modularity and minimal external dependencies. -Most non-essential features can be configured out for applications with small -memory footprint requirements. - -\section features Features - - - multitasking kernel with IPC, semaphores, priority levels; - - a comprehensive set of generic drivers for a wide range of devices, - which can be easily customized to the actual hardware: timer, serial, - adc, ntc, pwm, stepper motors, dc motors, lcd, keyboards, buzzer, eeprom; - - full graphic subsystem for simple displays, with font support, bitmaps, - clipping, text formatting, interactive menus; - - simple console with command parser; - - readline-like support for command history; - - entropy generator and random numbers generator optimized for embedded - systems; - - checksumming and hashing functions (CRC, MD2); - - full hash-table implementation with double-hashing collision resolution; - - XMODEM protocol implementation; - - RLE compression algorithm; - -\section structure Directory Structure - -The modules are sorted in subdirectories by their category: - - - app/ : demo applications; - - bertos/algo/ : algorithms; - - bertos/cfg/ : configuration stuff; - - bertos/drv/ : hardware drivers; - - bertos/dt/ : experimental object oriented gui toolkit; - - bertos/emul/ : Qt-based emulator framework for embedded applications; - - bertos/fonts/ : fonts; - - bertos/fs/ : file system related stuff; - - bertos/gfx/ : general purpose graphics routines; - - bertos/gui/ : widgets for simple displays; - - bertos/hw/ : hardware-specific declarations; - - bertos/icons/ : conversion tool from image TXT format to LCD bitmap; - - bertos/kern/ : multitasking kernel; - - bertos/mware/ : algorithms, other standalone code; - - bertos/struct/ : containers and other data structures; - - bertos/os/ : OS-abstraction layers for hosted environments; - - doc/ : documentation; - -The top-level directory contains a few support headers that are meant to be -usable by any C/C++ embedded or hosted application. - -\section license License - -BeRTOS is provided under the term of the GNU General Public License -(see LICENSE.GPL) with following exception: - -\verbatim - -As a special exception, you may use this file as part of a free software -library without restriction. Specifically, if other files instantiate -templates or use macros or inline functions from this file, or you compile -this file and link it with other files to produce an executable, this -file does not by itself cause the resulting executable to be covered by -the GNU General Public License. This exception does not however -invalidate any other reasons why the executable file might be covered by -the GNU General Public License. - -\endverbatim - -*/ diff --git a/README.bertos b/README.bertos deleted file mode 100644 index 65edccce..00000000 --- a/README.bertos +++ /dev/null @@ -1,102 +0,0 @@ -/*! - - - -\mainpage - -\section overview Overview - -BeRTOS is a real-time operating system designed for building applications -for embedded systems, like reference boards, test boards, or custom boards. - -It has a modular structure: its components can be used in very different -environments, from 8-bit processor to Linux and Win32 hosted application -(for debug purpose), using a wide range of compilers. - -\section history History and Motivation - -BeRTOS was born as a extremely modular, highly optimized and fine-tuned -operating system for embedded programming. -As a result, each module has its own scope and can be used alone or in -cooperation with other modules. -It's even possible to use most of the drivers without activating the kernel module. - -We have grown it following our guidelines: simplicity and beauty. -These guidelines made it possible to evolve it in a full-featured real -time operating system, with more modularity than many other embedded OSes, -without giving up reliability and performace. - -To achieve the highest possible reusability, most BeRTOS components are -designed for fine-grained modularity and minimal external dependencies. -Most non-essential features can be configured out for applications with small -memory footprint requirements. - -\section features Features - - - multitasking kernel with IPC, semaphores, priority levels; - - a comprehensive set of generic drivers for a wide range of devices, - which can be easily customized to the actual hardware: timer, serial, - adc, ntc, pwm, stepper motors, dc motors, lcd, keyboards, buzzer, eeprom; - - full graphic subsystem for simple displays, with font support, bitmaps, - clipping, text formatting, interactive menus; - - simple console with command parser; - - readline-like support for command history; - - entropy generator and random numbers generator optimized for embedded - systems; - - checksumming and hashing functions (CRC, MD2); - - full hash-table implementation with double-hashing collision resolution; - - XMODEM protocol implementation; - - RLE compression algorithm; - -\section structure Directory Structure - -The modules are sorted in subdirectories by their category: - - - app/ : demo applications; - - bertos/algo/ : algorithms; - - bertos/cfg/ : configuration stuff; - - bertos/drv/ : hardware drivers; - - bertos/dt/ : experimental object oriented gui toolkit; - - bertos/emul/ : Qt-based emulator framework for embedded applications; - - bertos/fonts/ : fonts; - - bertos/fs/ : file system related stuff; - - bertos/gfx/ : general purpose graphics routines; - - bertos/gui/ : widgets for simple displays; - - bertos/hw/ : hardware-specific declarations; - - bertos/icons/ : conversion tool from image TXT format to LCD bitmap; - - bertos/kern/ : multitasking kernel; - - bertos/mware/ : algorithms, other standalone code; - - bertos/struct/ : containers and other data structures; - - bertos/os/ : OS-abstraction layers for hosted environments; - - doc/ : documentation; - -The top-level directory contains a few support headers that are meant to be -usable by any C/C++ embedded or hosted application. - -See the \ref dev_status page for information about the various drivers. - -\section license License - -BeRTOS is provided under the term of the GNU General Public License -(see LICENSE.GPL) with following exception: - -\verbatim - -As a special exception, you may use this file as part of a free software -library without restriction. Specifically, if other files instantiate -templates or use macros or inline functions from this file, or you compile -this file and link it with other files to produce an executable, this -file does not by itself cause the resulting executable to be covered by -the GNU General Public License. This exception does not however -invalidate any other reasons why the executable file might be covered by -the GNU General Public License. - -\endverbatim - -*/ diff --git a/STATUS b/STATUS deleted file mode 100644 index fa19e610..00000000 --- a/STATUS +++ /dev/null @@ -1,315 +0,0 @@ -/*! - - - - - - - - -\page dev_status BeRTOS Development Status - -If you are looking for the list of BeRTOS ports or a detailed overview of all modules completeness and stability this is the right place. - -BeRTOS is quite stable (it is used in production environments) but it is also a very large project, so all of its parts may not be at the same level. - -Table of contents: - - \li \ref kernel - \li \ref compilers - \li \ref core_drivers - \li \ref internal_peripherals - \li \ref independant_drivers - \li \ref emulator - \li \ref algorithms - \li \ref graphics - \li \ref networking - \li \ref fs - \li \ref data_structures - \li \ref mware - -\section kernel Kernel -BeRTOS features a cooperative kernel with synchronization primitives. - -Embedded systems are mostly I/O bound systems. In these systems the microprocessor/microcontroller spends the most part of its computing power doing... absolutely nothing :-) - -Since the system simply waits for external events to happen we decided to implement a strong and robust cooperative kernel with very low memory footprint and high modularity. This allows the kernel to be used on a variety of different CPUs, even the smaller ones. -Currently the kernel code is very stable. - - Kernel features : - \li \link coop.c Cooperative \endlink round-robin scheduling. - \li \link monitor.h Stack process monitor \endlink, useful to prevent stack overflows. - \li \link msg.h Inter-process messaging system \endlink (with very low overhead). - \li \link sem.h Binary semaphores \endlink. - \li \link signal.c Signals \endlink. - -We have plans to add, as soon as possible, a preemptive scheduler , browse kernel source code to see the latest additions. - -The kernel has a port layer (a single assembly function) that needs to be reimplemented each time a new CPU is added. -Here is a list of currently available CPU family ports: - - - - - - - - - - -
CPU Family Port status
ARM stable
Atmel AVR stable
Freescale DSP56800 unmantained
Intel i196 unmantained
PowerPC \ref emulator only
Intel/AMD x86 \ref emulator only
Intel/AMD x86-64 \ref emulator only
- -\section compilers Compilers -BeRTOS is primarily intended to be used with open source tools such as GCC, although it supports other compilers too. It is possible to develop with BeRTOS on Linux, Windows and Mac. - -For every port we have indicated the current compiler used and were to find a suitable development suite: - - - - - - - - - - - -
CPU Family Compiler Linux/Mac Toolchain Windows Toolchain
ARM GCC Sourcery G++ toolchain (open source) BeRTOS ARM IDE (open source)
ARM IAR (unmantained) none http://www.iar.com (proprietary)
AVR GCC AVR Toolchain installer (open source) BeRTOS AVR IDE (open source)
DSP56800 CodeWarrior (unmantained) none CodeWarrior (proprietary)
i196 fillme fillme fillme
PowerPC GCC use your system GCC none
x86 GCC use your system GCC http://www.mingw.org/ (open source)
x86 MSVC (unmantained) none Visual Studio (proprietary)
x86-64 GCC use your system GCC none
- - -\section core_drivers Core Drivers -BeRTOS is not only a kernel, it aims to supply full operating system services. -To achieve this we need at least some core drivers for every CPU port. - -These drivers are: system timer , debug system and serial comm driver . - -Here is the list of CPU whose internal core drivers are supported: - - - - - - - - - - - - - - - - - - - - - -
Family CPU Core driver status
ARM AT91SAM7S64 stable
ARM AT91SAM7S128 stable
ARM AT91SAM7S256 stable
ARM AT91SAM7S512 stable
ARM AT91SAM7X128 stable
ARM AT91SAM7X256 stable
ARM AT91SAM7X512 stable
AVR ATMega8 stable
AVR ATMega32 stable
AVR ATMega64 stable
AVR ATMega103 stable
AVR ATMega128 stable
AVR ATMega168 stable
AVR ATMega1281 stable
DSP56800 all unmantained
i196 all unmantained
PowerPC all see \ref emulator
x86 all see \ref emulator
x86-64 all see \ref emulator
- -Adding CPU support for an already present CPU family is quite simple since hardware manufacturers share peripherals design between the same CPU cores. - -\section internal_peripherals MCU Internal peripheral drivers -Since BeRTOS aims to supply full operating system services, for every CPU port we try to implement as much drivers as possible. This section covers the current development status for MCU Internal peripheral drivers. - - \li MCU family: Atmel AVR - - - - - - - - - -
Driver Status
\link adc_avr.c ADC \endlink stable
\link flash_avr.c Internal Flash \endlink stable
UART stable
SPI stable
Timer stable
\link i2c_avr.c TWI \endlink stable
- - To get up to date informations look at the AVR drivers source code. - - \li MCU family: Atmel AT91 ARM - - - - - - - - - - -
Driver Status
UART stable
SPI stable
Timers stable
TWI beta
ADC beta
PWM beta
\link i2s_at91.h I2S \endlink digital audio bus stable
- - To get up to date informations look at the ARM drivers source code. - - \li MCU family: Freescale DSP56800 - - Only core drivers are supported. - - \li MCU family: Intel i196 - - Only core drivers are supported. - - \li MCU family: PowerPC - - See \ref emulator. - - \li MCU family: x86 - - See \ref emulator. - - \li MCU family: x86-64 - - See \ref emulator. - -\section independant_drivers Generic CPU independent drivers -BeRTOS supplies a full set of CPU independent generic hardware drivers. To achieve this all drivers are structured to have an hardware abstraction layer (HAL) that isolate CPU specific code and makes porting to new CPU easy. -Current driver list: - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Driver Status
\link adc.h ADC API \endlink stable
\link buzzer.h Buzzer \endlink stable
\link dataflash.h Atmel Dataflash \endlink stable
\link eeprom.h I2C EEPROM \endlink stable
\link flash25.h AT25Fxxx Atmel flash memories \endlink beta
\link ft245rl.h FT245RL USB to parallel converter \endlink beta
\link kbd.h Keyboard \endlink stable
\link i2c.h I2C \endlink with bitbang support stable
Displaytech 32122A Graphic LCD stable
\link dc_motor.h DC Motor with PID \endlink stable
\link lcd_text.h Alphanumeric LCD \endlink stable
\link mcp41.h MPC41 digital potentiometer \endlink stable
\link ntc.h NTC \endlink stable
\link phase.h TRIAC phase partialization \endlink stable
\link pwm.h PWM API \endlink beta
\link pcf8574.h PCF85974 I2C port expander \endlink beta
\link sd.h Secure Digital card API \endlink stable
\link ser.h Serial API \endlink stable
\link spi_bitbang.h Bitbanged SPI \endlink stable
\link tas5706a.h TAS5706A \endlink digital audio DSP stable
\link tc520.h TC520 ADC \endlink obsolete
\link thermo.h Thermostat \endlink stable
\link timer.h System timer API \endlink stable
\link stepper.h Stepper motor with ramps \endlink stable
Watchdog beta
- -To get up to date informations look at the drivers source code. - -\section emulator Emulator -BeRTOS features can be emulated on a common PC, check DemoApp. - -The emulator uses Qt to display emulated I/O devices in a window. It supports task -scheduling and a number of other embedded peripherals. - - - - - - - - - - - - - - -
Emulator Status
timer stable
scheduler stable
keyboard stable
graphical LCD display stable
text LCD display unmaintained
buzzer unmaintained
serial port unmaintained
flash unmaintained
debug console stable
file read/write stable
- -\section algorithms Algorithms -In embedded programming sometimes you have to cope with protocols, security systems and things like that. -BeRTOS comes in help with a set of optimized portable algorithms: - - - - - - - - - - -
Algorithm Status
\link crc.h CRC16 \endlink stable
\link md2.c MD2 \endlink beta
\link randpool.c Cryptographically secure Random Pool \endlink beta
\link rotating_hash.h Rotating hash checksum \endlink stable
\link tea.h TEA (Tiny Encryption Algorithm) \endlink stable
\link ramp.h Stepper motor ramp generator \endlink stable
\link pid_control.h PID Controller \endlink stable
\link rle.c RLE (Run lenght en/decondig) \endlink stable
- -To get up to date informations look at the algorithms source code. - -\section graphics Graphic subsystem -BeRTOS also features a complete graphic subsystem, suitable for generating compact yet powerful GUI. -This system is composed of several modules ranging from simple graphic primitives to complex menu management functions. - - - - - - - - - - - -
Module Status
\link bitmap.c Bitmaps manipulation \endlink stable
\link line.c Lines drawing \endlink stable
\link line.c Rectangles drawing \endlink stable
\link win.h Simple windowing system \endlink stable
Proportional and fixed size fonts stable
\link text.h Text rendering \endlink stable
\link charts.h Simple Charts \endlink stable
\link menu.h Menus \endlink stable
- -To get up to date informations look at the source code in the directories \b gfx, \b gui or \b fonts. - -\section networking Network protocols -Since BeRTOS can also be used in very tiny systems, some simple communication protocols has been developed. - -This is the current status: - - - - - -
Protocol Status
\link pocketbus.c PocketBus \endlink stable
\link keytag.c Keytag (for 125KHz transponders) \endlink stable
\link xmodem.c XModem protocol \endlink stable
- -For more information take a look at network directory. - - -\section fs File system -The latest SVN version of BeRTOS supports \link fat.h FAT \endlink filesystems using the FatFs library. The module is highly configurable, for example it can be compiled in read-only mode for some space saving. - -\link battfs.h BattFs\endlink, a file system specifically planned for embedded platforms, is in the beta stage. The goal is to have a filesystem suitable for little flash and eeprom memories (like dataflash), reliable, robust and capable of wear-levelling the memory pages to increase its life. -Currently you can create files, append data to them but file deletion is still not supported. Wear-levelling is achieved by rotating a page every time it is written. Plans are to add even transactions (a whole write can be performed atomically). - -File system development takes place in the fs directory. - -\section data_structures Data Structures -BeRTOS supplies common data structures, implemented and optimized for low memory footprint and speed. - - - - - - - -
Module Status
\link fifobuf.h FIFO \endlink stable
\link hashtable.h Hash table \endlink stable
\link heap.h Embedded-optimized dynamic memory allocator \endlink stable
\link list.h Lists \endlink stable
- -\section mware Middleware -This section covers all BeRTOS modules that provide general purpose utility functions. Most of them should be moved to \ref algorithms directory. - -In the meanwhile, here is the list: - - - - - - - - -
Module Status
\link cpu/byteorder.h Integers to/from host byte-order conversion \endlink stable
\link event.h Events \endlink stable
\link except.h C++ like exception handling in C \endlink stable
\link formatwr.c Embedded-optimized printf \endlink stable
\link readline.h Command shell with history \endlink stable
\link ini_reader.h Ini file reader \endlink stable
- -As usual, check source code for detailed reference. -*/ diff --git a/doc/Mainpage.online b/doc/Mainpage.online new file mode 100644 index 00000000..07a36d88 --- /dev/null +++ b/doc/Mainpage.online @@ -0,0 +1,100 @@ +/*! + + + +\mainpage + +\section overview Overview + +BeRTOS is a real-time operating system designed for building applications +for embedded systems, like reference boards, test boards, or custom boards. + +It has a modular structure: its components can be used in very different +environments, from 8-bit processor to Linux and Win32 hosted application +(for debug purpose), using a wide range of compilers. + +\section history History and Motivation + +BeRTOS was born as a extremely modular, highly optimized and fine-tuned +operating system for embedded programming. +As a result, each module has its own scope and can be used alone or in +cooperation with other modules. +It's even possible to use most of the drivers without activating the kernel module. + +We have grown it following our guidelines: simplicity and beauty. +These guidelines made it possible to evolve it in a full-featured real +time operating system, with more modularity than many other embedded OSes, +without giving up reliability and performace. + +To achieve the highest possible reusability, most BeRTOS components are +designed for fine-grained modularity and minimal external dependencies. +Most non-essential features can be configured out for applications with small +memory footprint requirements. + +\section features Features + + - multitasking kernel with IPC, semaphores, priority levels; + - a comprehensive set of generic drivers for a wide range of devices, + which can be easily customized to the actual hardware: timer, serial, + adc, ntc, pwm, stepper motors, dc motors, lcd, keyboards, buzzer, eeprom; + - full graphic subsystem for simple displays, with font support, bitmaps, + clipping, text formatting, interactive menus; + - simple console with command parser; + - readline-like support for command history; + - entropy generator and random numbers generator optimized for embedded + systems; + - checksumming and hashing functions (CRC, MD2); + - full hash-table implementation with double-hashing collision resolution; + - XMODEM protocol implementation; + - RLE compression algorithm; + +\section structure Directory Structure + +The modules are sorted in subdirectories by their category: + + - app/ : demo applications; + - bertos/algo/ : algorithms; + - bertos/cfg/ : configuration stuff; + - bertos/drv/ : hardware drivers; + - bertos/dt/ : experimental object oriented gui toolkit; + - bertos/emul/ : Qt-based emulator framework for embedded applications; + - bertos/fonts/ : fonts; + - bertos/fs/ : file system related stuff; + - bertos/gfx/ : general purpose graphics routines; + - bertos/gui/ : widgets for simple displays; + - bertos/hw/ : hardware-specific declarations; + - bertos/icons/ : conversion tool from image TXT format to LCD bitmap; + - bertos/kern/ : multitasking kernel; + - bertos/mware/ : algorithms, other standalone code; + - bertos/struct/ : containers and other data structures; + - bertos/os/ : OS-abstraction layers for hosted environments; + - doc/ : documentation; + +The top-level directory contains a few support headers that are meant to be +usable by any C/C++ embedded or hosted application. + +\section license License + +BeRTOS is provided under the term of the GNU General Public License +(see LICENSE.GPL) with following exception: + +\verbatim + +As a special exception, you may use this file as part of a free software +library without restriction. Specifically, if other files instantiate +templates or use macros or inline functions from this file, or you compile +this file and link it with other files to produce an executable, this +file does not by itself cause the resulting executable to be covered by +the GNU General Public License. This exception does not however +invalidate any other reasons why the executable file might be covered by +the GNU General Public License. + +\endverbatim + +*/ diff --git a/doc/Mainpage.snapshot b/doc/Mainpage.snapshot new file mode 100644 index 00000000..5e50e27b --- /dev/null +++ b/doc/Mainpage.snapshot @@ -0,0 +1,103 @@ +/*! + + + +\mainpage + +This documentation is generated from BeRTOS SVN. As such, it may contain modules +and/or additional documentation not present in official releases. + +\section overview Overview + +BeRTOS is a real-time operating system designed for building applications +for embedded systems, like reference boards, test boards, or custom boards. + +It has a modular structure: its components can be used in very different +environments, from 8-bit processor to Linux and Win32 hosted application +(for debug purpose), using a wide range of compilers. + +\section history History and Motivation + +BeRTOS was born as a extremely modular, highly optimized and fine-tuned +operating system for embedded programming. +As a result, each module has its own scope and can be used alone or in +cooperation with other modules. +It's even possible to use most of the drivers without activating the kernel module. + +We have grown it following our guidelines: simplicity and beauty. +These guidelines made it possible to evolve it in a full-featured real +time operating system, with more modularity than many other embedded OSes, +without giving up reliability and performace. + +To achieve the highest possible reusability, most BeRTOS components are +designed for fine-grained modularity and minimal external dependencies. +Most non-essential features can be configured out for applications with small +memory footprint requirements. + +\section features Features + + - multitasking kernel with IPC, semaphores, priority levels; + - a comprehensive set of generic drivers for a wide range of devices, + which can be easily customized to the actual hardware: timer, serial, + adc, ntc, pwm, stepper motors, dc motors, lcd, keyboards, buzzer, eeprom; + - full graphic subsystem for simple displays, with font support, bitmaps, + clipping, text formatting, interactive menus; + - simple console with command parser; + - readline-like support for command history; + - entropy generator and random numbers generator optimized for embedded + systems; + - checksumming and hashing functions (CRC, MD2); + - full hash-table implementation with double-hashing collision resolution; + - XMODEM protocol implementation; + - RLE compression algorithm; + +\section structure Directory Structure + +The modules are sorted in subdirectories by their category: + + - app/ : demo applications; + - bertos/algo/ : algorithms; + - bertos/cfg/ : configuration stuff; + - bertos/drv/ : hardware drivers; + - bertos/dt/ : experimental object oriented gui toolkit; + - bertos/emul/ : Qt-based emulator framework for embedded applications; + - bertos/fonts/ : fonts; + - bertos/fs/ : file system related stuff; + - bertos/gfx/ : general purpose graphics routines; + - bertos/gui/ : widgets for simple displays; + - bertos/hw/ : hardware-specific declarations; + - bertos/icons/ : conversion tool from image TXT format to LCD bitmap; + - bertos/kern/ : multitasking kernel; + - bertos/mware/ : algorithms, other standalone code; + - bertos/struct/ : containers and other data structures; + - bertos/os/ : OS-abstraction layers for hosted environments; + - doc/ : documentation; + +The top-level directory contains a few support headers that are meant to be +usable by any C/C++ embedded or hosted application. + +\section license License + +BeRTOS is provided under the term of the GNU General Public License +(see LICENSE.GPL) with following exception: + +\verbatim + +As a special exception, you may use this file as part of a free software +library without restriction. Specifically, if other files instantiate +templates or use macros or inline functions from this file, or you compile +this file and link it with other files to produce an executable, this +file does not by itself cause the resulting executable to be covered by +the GNU General Public License. This exception does not however +invalidate any other reasons why the executable file might be covered by +the GNU General Public License. + +\endverbatim + +*/ diff --git a/doc/README.bertos b/doc/README.bertos new file mode 100644 index 00000000..65edccce --- /dev/null +++ b/doc/README.bertos @@ -0,0 +1,102 @@ +/*! + + + +\mainpage + +\section overview Overview + +BeRTOS is a real-time operating system designed for building applications +for embedded systems, like reference boards, test boards, or custom boards. + +It has a modular structure: its components can be used in very different +environments, from 8-bit processor to Linux and Win32 hosted application +(for debug purpose), using a wide range of compilers. + +\section history History and Motivation + +BeRTOS was born as a extremely modular, highly optimized and fine-tuned +operating system for embedded programming. +As a result, each module has its own scope and can be used alone or in +cooperation with other modules. +It's even possible to use most of the drivers without activating the kernel module. + +We have grown it following our guidelines: simplicity and beauty. +These guidelines made it possible to evolve it in a full-featured real +time operating system, with more modularity than many other embedded OSes, +without giving up reliability and performace. + +To achieve the highest possible reusability, most BeRTOS components are +designed for fine-grained modularity and minimal external dependencies. +Most non-essential features can be configured out for applications with small +memory footprint requirements. + +\section features Features + + - multitasking kernel with IPC, semaphores, priority levels; + - a comprehensive set of generic drivers for a wide range of devices, + which can be easily customized to the actual hardware: timer, serial, + adc, ntc, pwm, stepper motors, dc motors, lcd, keyboards, buzzer, eeprom; + - full graphic subsystem for simple displays, with font support, bitmaps, + clipping, text formatting, interactive menus; + - simple console with command parser; + - readline-like support for command history; + - entropy generator and random numbers generator optimized for embedded + systems; + - checksumming and hashing functions (CRC, MD2); + - full hash-table implementation with double-hashing collision resolution; + - XMODEM protocol implementation; + - RLE compression algorithm; + +\section structure Directory Structure + +The modules are sorted in subdirectories by their category: + + - app/ : demo applications; + - bertos/algo/ : algorithms; + - bertos/cfg/ : configuration stuff; + - bertos/drv/ : hardware drivers; + - bertos/dt/ : experimental object oriented gui toolkit; + - bertos/emul/ : Qt-based emulator framework for embedded applications; + - bertos/fonts/ : fonts; + - bertos/fs/ : file system related stuff; + - bertos/gfx/ : general purpose graphics routines; + - bertos/gui/ : widgets for simple displays; + - bertos/hw/ : hardware-specific declarations; + - bertos/icons/ : conversion tool from image TXT format to LCD bitmap; + - bertos/kern/ : multitasking kernel; + - bertos/mware/ : algorithms, other standalone code; + - bertos/struct/ : containers and other data structures; + - bertos/os/ : OS-abstraction layers for hosted environments; + - doc/ : documentation; + +The top-level directory contains a few support headers that are meant to be +usable by any C/C++ embedded or hosted application. + +See the \ref dev_status page for information about the various drivers. + +\section license License + +BeRTOS is provided under the term of the GNU General Public License +(see LICENSE.GPL) with following exception: + +\verbatim + +As a special exception, you may use this file as part of a free software +library without restriction. Specifically, if other files instantiate +templates or use macros or inline functions from this file, or you compile +this file and link it with other files to produce an executable, this +file does not by itself cause the resulting executable to be covered by +the GNU General Public License. This exception does not however +invalidate any other reasons why the executable file might be covered by +the GNU General Public License. + +\endverbatim + +*/ diff --git a/doc/STATUS b/doc/STATUS new file mode 100644 index 00000000..fa19e610 --- /dev/null +++ b/doc/STATUS @@ -0,0 +1,315 @@ +/*! + + + + + + + + +\page dev_status BeRTOS Development Status + +If you are looking for the list of BeRTOS ports or a detailed overview of all modules completeness and stability this is the right place. + +BeRTOS is quite stable (it is used in production environments) but it is also a very large project, so all of its parts may not be at the same level. + +Table of contents: + + \li \ref kernel + \li \ref compilers + \li \ref core_drivers + \li \ref internal_peripherals + \li \ref independant_drivers + \li \ref emulator + \li \ref algorithms + \li \ref graphics + \li \ref networking + \li \ref fs + \li \ref data_structures + \li \ref mware + +\section kernel Kernel +BeRTOS features a cooperative kernel with synchronization primitives. + +Embedded systems are mostly I/O bound systems. In these systems the microprocessor/microcontroller spends the most part of its computing power doing... absolutely nothing :-) + +Since the system simply waits for external events to happen we decided to implement a strong and robust cooperative kernel with very low memory footprint and high modularity. This allows the kernel to be used on a variety of different CPUs, even the smaller ones. +Currently the kernel code is very stable. + + Kernel features : + \li \link coop.c Cooperative \endlink round-robin scheduling. + \li \link monitor.h Stack process monitor \endlink, useful to prevent stack overflows. + \li \link msg.h Inter-process messaging system \endlink (with very low overhead). + \li \link sem.h Binary semaphores \endlink. + \li \link signal.c Signals \endlink. + +We have plans to add, as soon as possible, a preemptive scheduler , browse kernel source code to see the latest additions. + +The kernel has a port layer (a single assembly function) that needs to be reimplemented each time a new CPU is added. +Here is a list of currently available CPU family ports: + + + + + + + + + + +
CPU Family Port status
ARM stable
Atmel AVR stable
Freescale DSP56800 unmantained
Intel i196 unmantained
PowerPC \ref emulator only
Intel/AMD x86 \ref emulator only
Intel/AMD x86-64 \ref emulator only
+ +\section compilers Compilers +BeRTOS is primarily intended to be used with open source tools such as GCC, although it supports other compilers too. It is possible to develop with BeRTOS on Linux, Windows and Mac. + +For every port we have indicated the current compiler used and were to find a suitable development suite: + + + + + + + + + + + +
CPU Family Compiler Linux/Mac Toolchain Windows Toolchain
ARM GCC Sourcery G++ toolchain (open source) BeRTOS ARM IDE (open source)
ARM IAR (unmantained) none http://www.iar.com (proprietary)
AVR GCC AVR Toolchain installer (open source) BeRTOS AVR IDE (open source)
DSP56800 CodeWarrior (unmantained) none CodeWarrior (proprietary)
i196 fillme fillme fillme
PowerPC GCC use your system GCC none
x86 GCC use your system GCC http://www.mingw.org/ (open source)
x86 MSVC (unmantained) none Visual Studio (proprietary)
x86-64 GCC use your system GCC none
+ + +\section core_drivers Core Drivers +BeRTOS is not only a kernel, it aims to supply full operating system services. +To achieve this we need at least some core drivers for every CPU port. + +These drivers are: system timer , debug system and serial comm driver . + +Here is the list of CPU whose internal core drivers are supported: + + + + + + + + + + + + + + + + + + + + + +
Family CPU Core driver status
ARM AT91SAM7S64 stable
ARM AT91SAM7S128 stable
ARM AT91SAM7S256 stable
ARM AT91SAM7S512 stable
ARM AT91SAM7X128 stable
ARM AT91SAM7X256 stable
ARM AT91SAM7X512 stable
AVR ATMega8 stable
AVR ATMega32 stable
AVR ATMega64 stable
AVR ATMega103 stable
AVR ATMega128 stable
AVR ATMega168 stable
AVR ATMega1281 stable
DSP56800 all unmantained
i196 all unmantained
PowerPC all see \ref emulator
x86 all see \ref emulator
x86-64 all see \ref emulator
+ +Adding CPU support for an already present CPU family is quite simple since hardware manufacturers share peripherals design between the same CPU cores. + +\section internal_peripherals MCU Internal peripheral drivers +Since BeRTOS aims to supply full operating system services, for every CPU port we try to implement as much drivers as possible. This section covers the current development status for MCU Internal peripheral drivers. + + \li MCU family: Atmel AVR + + + + + + + + + +
Driver Status
\link adc_avr.c ADC \endlink stable
\link flash_avr.c Internal Flash \endlink stable
UART stable
SPI stable
Timer stable
\link i2c_avr.c TWI \endlink stable
+ + To get up to date informations look at the AVR drivers source code. + + \li MCU family: Atmel AT91 ARM + + + + + + + + + + +
Driver Status
UART stable
SPI stable
Timers stable
TWI beta
ADC beta
PWM beta
\link i2s_at91.h I2S \endlink digital audio bus stable
+ + To get up to date informations look at the ARM drivers source code. + + \li MCU family: Freescale DSP56800 + + Only core drivers are supported. + + \li MCU family: Intel i196 + + Only core drivers are supported. + + \li MCU family: PowerPC + + See \ref emulator. + + \li MCU family: x86 + + See \ref emulator. + + \li MCU family: x86-64 + + See \ref emulator. + +\section independant_drivers Generic CPU independent drivers +BeRTOS supplies a full set of CPU independent generic hardware drivers. To achieve this all drivers are structured to have an hardware abstraction layer (HAL) that isolate CPU specific code and makes porting to new CPU easy. +Current driver list: + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Driver Status
\link adc.h ADC API \endlink stable
\link buzzer.h Buzzer \endlink stable
\link dataflash.h Atmel Dataflash \endlink stable
\link eeprom.h I2C EEPROM \endlink stable
\link flash25.h AT25Fxxx Atmel flash memories \endlink beta
\link ft245rl.h FT245RL USB to parallel converter \endlink beta
\link kbd.h Keyboard \endlink stable
\link i2c.h I2C \endlink with bitbang support stable
Displaytech 32122A Graphic LCD stable
\link dc_motor.h DC Motor with PID \endlink stable
\link lcd_text.h Alphanumeric LCD \endlink stable
\link mcp41.h MPC41 digital potentiometer \endlink stable
\link ntc.h NTC \endlink stable
\link phase.h TRIAC phase partialization \endlink stable
\link pwm.h PWM API \endlink beta
\link pcf8574.h PCF85974 I2C port expander \endlink beta
\link sd.h Secure Digital card API \endlink stable
\link ser.h Serial API \endlink stable
\link spi_bitbang.h Bitbanged SPI \endlink stable
\link tas5706a.h TAS5706A \endlink digital audio DSP stable
\link tc520.h TC520 ADC \endlink obsolete
\link thermo.h Thermostat \endlink stable
\link timer.h System timer API \endlink stable
\link stepper.h Stepper motor with ramps \endlink stable
Watchdog beta
+ +To get up to date informations look at the drivers source code. + +\section emulator Emulator +BeRTOS features can be emulated on a common PC, check DemoApp. + +The emulator uses Qt to display emulated I/O devices in a window. It supports task +scheduling and a number of other embedded peripherals. + + + + + + + + + + + + + + +
Emulator Status
timer stable
scheduler stable
keyboard stable
graphical LCD display stable
text LCD display unmaintained
buzzer unmaintained
serial port unmaintained
flash unmaintained
debug console stable
file read/write stable
+ +\section algorithms Algorithms +In embedded programming sometimes you have to cope with protocols, security systems and things like that. +BeRTOS comes in help with a set of optimized portable algorithms: + + + + + + + + + + +
Algorithm Status
\link crc.h CRC16 \endlink stable
\link md2.c MD2 \endlink beta
\link randpool.c Cryptographically secure Random Pool \endlink beta
\link rotating_hash.h Rotating hash checksum \endlink stable
\link tea.h TEA (Tiny Encryption Algorithm) \endlink stable
\link ramp.h Stepper motor ramp generator \endlink stable
\link pid_control.h PID Controller \endlink stable
\link rle.c RLE (Run lenght en/decondig) \endlink stable
+ +To get up to date informations look at the algorithms source code. + +\section graphics Graphic subsystem +BeRTOS also features a complete graphic subsystem, suitable for generating compact yet powerful GUI. +This system is composed of several modules ranging from simple graphic primitives to complex menu management functions. + + + + + + + + + + + +
Module Status
\link bitmap.c Bitmaps manipulation \endlink stable
\link line.c Lines drawing \endlink stable
\link line.c Rectangles drawing \endlink stable
\link win.h Simple windowing system \endlink stable
Proportional and fixed size fonts stable
\link text.h Text rendering \endlink stable
\link charts.h Simple Charts \endlink stable
\link menu.h Menus \endlink stable
+ +To get up to date informations look at the source code in the directories \b gfx, \b gui or \b fonts. + +\section networking Network protocols +Since BeRTOS can also be used in very tiny systems, some simple communication protocols has been developed. + +This is the current status: + + + + + +
Protocol Status
\link pocketbus.c PocketBus \endlink stable
\link keytag.c Keytag (for 125KHz transponders) \endlink stable
\link xmodem.c XModem protocol \endlink stable
+ +For more information take a look at network directory. + + +\section fs File system +The latest SVN version of BeRTOS supports \link fat.h FAT \endlink filesystems using the FatFs library. The module is highly configurable, for example it can be compiled in read-only mode for some space saving. + +\link battfs.h BattFs\endlink, a file system specifically planned for embedded platforms, is in the beta stage. The goal is to have a filesystem suitable for little flash and eeprom memories (like dataflash), reliable, robust and capable of wear-levelling the memory pages to increase its life. +Currently you can create files, append data to them but file deletion is still not supported. Wear-levelling is achieved by rotating a page every time it is written. Plans are to add even transactions (a whole write can be performed atomically). + +File system development takes place in the fs directory. + +\section data_structures Data Structures +BeRTOS supplies common data structures, implemented and optimized for low memory footprint and speed. + + + + + + + +
Module Status
\link fifobuf.h FIFO \endlink stable
\link hashtable.h Hash table \endlink stable
\link heap.h Embedded-optimized dynamic memory allocator \endlink stable
\link list.h Lists \endlink stable
+ +\section mware Middleware +This section covers all BeRTOS modules that provide general purpose utility functions. Most of them should be moved to \ref algorithms directory. + +In the meanwhile, here is the list: + + + + + + + + +
Module Status
\link cpu/byteorder.h Integers to/from host byte-order conversion \endlink stable
\link event.h Events \endlink stable
\link except.h C++ like exception handling in C \endlink stable
\link formatwr.c Embedded-optimized printf \endlink stable
\link readline.h Command shell with history \endlink stable
\link ini_reader.h Ini file reader \endlink stable
+ +As usual, check source code for detailed reference. +*/