*****************************************************************************
*** Files Organization                                                    ***
*****************************************************************************

--{root}                        - ChibiOS directory.
  +--readme.txt                 - This file.
  +--documentation.html         - Shortcut to the web documentation page.
  +--license.txt                - GPL license text.
  +--demos/                     - Demo projects, one directory per platform.
  +--docs/                      - Documentation.
  |  +--common/                 - Documentation common build resources.
  |  +--hal/                    - Builders for HAL.
  |  +--nil/                    - Builders for NIL.
  |  +--rt/                     - Builders for RT.
  +--ext/                       - External libraries, not part of ChibiOS/RT.
  +--os/                        - ChibiOS components.
  |  +--common/                 - Shared OS modules.
  |  |  +--abstractions/        - API emulator wrappers.
  |  |  |  +--cmsis_os/         - CMSIS OS emulation layer for RT.
  |  |  |  +--nasa_osal/        - NASA Operating System Abstraction Layer.
  |  |  +--ext/                 - Vendor files used by the OS.
  |  |  +--ports/               - RTOS ports usable by both RT and NIL.
  |  |  +--startup/             - Startup support.
  |  +--ex/                     - EX component.
  |  |  +--dox/                 - EX documentation resources.
  |  |  +--Bosch /              - EX complex drivers for Bosch devices.
  |  |  +--ST/                  - EX complex drivers for ST devices.
  |  +--hal/                    - HAL component.
  |  |  +--boards/              - HAL board support files.
  |  |  +--dox/                 - HAL documentation resources.
  |  |  +--include/             - HAL high level headers.
  |  |  +--lib/                 - HAL libraries.
  |  |  |  +--complex/          - HAL collection of complex drivers.
  |  |  |  |  +--mfs/           - HAL managed flash storage driver.
  |  |  |  |  +--serial_nor/    - HAL managed flash storage driver.
  |  |  |  +--fallback/         - HAL fall back software drivers.
  |  |  |  +--peripherals/      - HAL peripherals interfaces.
  |  |  |  +--streams/          - HAL streams.
  |  |  +--osal/                - HAL OSAL implementations.
  |  |  |  +--lib/              - HAL OSAL common modules.
  |  |  +--src/                 - HAL high level source.
  |  |  +--ports/               - HAL ports.
  |  |  +--templates/           - HAL driver template files.
  |  |     +--osal/             - HAL OSAL templates.
  |  +--oslib/                  - RTOS modules usable by both RT and NIL.
  |  |  +--include/             - OSLIB high level headers.
  |  |  +--src/                 - OSLIB high level source.
  |  |  +--templates/           - OSLIB configuration template files.
  |  +--nil/                    - NIL RTOS component.
  |  |  +--dox/                 - NIL documentation resources.
  |  |  +--include/             - NIL high level headers.
  |  |  +--src/                 - NIL high level source.
  |  |  +--templates/           - NIL configuration template files.
  |  +--rt/                     - RT RTOS component.
  |  |  +--dox/                 - RT documentation resources.
  |  |  +--include/             - RT high level headers.
  |  |  +--src/                 - RT high level source.
  |  |  +--templates/           - RT configuration template files.
  |  +--various/                - Various portable support files.
  +--test/                      - Kernel test suite source code.
  |  +--lib/                    - Portable test engine.
  |  +--hal/                    - HAL test suites.
  |  |  +--testbuild/           - HAL build test and MISRA check.
  |  +--nil/                    - NIL test suites.
  |  |  +--testbuild/           - NIL build test and MISRA check.
  |  +--rt/                     - RT test suites.
  |  |  +--testbuild/           - RT build test and MISRA check.
  |  |  +--coverage/            - RT code coverage project.
  +--testex/                    - EX integration test demos.
  +--testhal/                   - HAL integration test demos.

*****************************************************************************
*** Releases and Change Log                                               ***
*****************************************************************************

*** 19.1.4 ***
- NEW: Updated debug tools to be independent from the toolchain position:
       they now rely on the environment variable CHIBISTUDIO.
- NEW: Added support for .cc files extensions in makefiles.
- NEW: Made bus acquire/release functions in SNOR driver public.
- FIX: Fixed STM32H7xx ADC problem in dual mode (bug #1089).
- FIX: Fixed invalid CHSEL DMA setting in STM32 UART drivers (bug #1088).
- FIX: Fixed undefined TEST_CFG_SIZE_REPORT warning (bug #1087).
- FIX: Fixed wrong arguments for the cacheBufferInvalidate in the STM32 SPI 
       demo (bug #1086).
- FIX: Fixed race condition in HAL MAC driver (bug #1083).
- FIX: Fixed problem in chMtxUnlockAllS() (bug #1076).
- FIX: Fixed state check in CMSIS osKernelInitialize() wrapper (bug #1075).
- FIX: Fixed duplicated code in TIMv1/hal_gpt_lld.c (bug #1074).
- FIX: Fixed missing IRQ disabling in ADCv1 and ADCv3 STM32 drivers (bug #1073).
- FIX: Fixed missing parenthesis in ADC _adc_isr_error_code macro (bug #1072).
- FIX: Fixed invalid macro check in test library (bug #1071).
- FIX: Fixed non-standard declaration in STM32 ADCv3 driver (bug #1070).
- FIX: Fixed problem in the I2C fallback driver (bug #1069).
- FIX: Fixed TIM8 missing on STM32H7xx (bug #1068).
- FIX: Fixed Sharing issues with GPT TIMv1 driver (bug #1067).
- FIX: Fixed wrong check on STM32_DAC_DUAL_MODE in DACv1 STM32 driver
       (bug #1065).
- FIX: Fixed I2Cv1 extra interrupts (bug #1064).
- FIX: Fixed I2C4 broken on STM32H7xx (bug #1063).
- FIX: Fixed I2C fallback driver broken (bug #1061).
- FIX: Fixed STM32 ADC1 sample time macros (bug #1059).
- FIX: Fixed STM32 ADCv1 error callback disabled on some devices (bug #1058).
- FIX: Fixed error in uartSendFullTimeout() HAL function (bug #1057).
- FIX: Fixed OS-less Cortex-M OSAL problem with critical zones (bug #1056).
- FIX: Fixed missing RTCv1 definitions in STM32F37x registry (bug #1054).
- FIX: Fixed assertion triggered in STM32 OTGv1 driver (bug #1053).
- FIX: Fixed STM32 CANv1 compile fails if CAN3 is used alone (bug #1052).
- FIX: Fixed palIsLineEventEnabledX() compile fail on STM32L4 (bug #1051).
- FIX: Fixed wrong clock disable check in STM32 DACv1 driver (bug #1050).
- FIX: Fixed clock tree differences in STM32F4 family (bug #1049).
- FIX: Fixed wrong debug check in STM32 I2Cv1 driver (bug #1048).
- FIX: Fixed warning in simulator PAL driver (bug #1047).
- FIX: Fixed board initialization failure on STM32F030x6 (bug #1046).
- FIX: Fixed STM32 I2Cv1 BTF event not cleared (bug #1045).
- FIX: Fixed serial NOR driver wrong macro definition (bug #1044).
- FIX: Fixed STM32F7 I2C registry dma channel (bug #1043).
- FIX: Fixed missing dummy cycles in memory map mode on STM32 QSPI driver
       (bug #1042).
- FIX: Fixed missing DMA definitions for STM32F412 I2C3 (bug #1041).
- FIX: Fixed misplaced parenthesis in hal_files.h (bug #1040).
- FIX: Fixed GCC scatter files alignment problem (bug #1033).
- FIX: Fixed incorrect pointer type in lwipthread.c low_level_input causes
       panic on packet reception (bug #1009).

*** 19.1.3 ***
- NEW: Added a "library generator" project for RT, it allows to
       generate a library with a pre-configured RT. It also includes
       an "header generator" able to generate an unified "ch.h" with
       all options resolved.
- FIX: Fixed missing bracket in MX25 flash driver (bug #1038).
- FIX: Fixed some M7 demos compile as M4 bug #1037).
- FIX: Fixed missing I2C4 RCC definitions for L4/L4+ (bug #1036).
- FIX: Fixed missing delay after STM32 wait states setup (bug #1035).
- FIX: Fixed reduced time slices in RT (bug #1034).
- FIX: Fixed GCC scatter files alignment problem (bug #1033).
- FIX: Fixed long intervals fail when interval type is larger than time type
       (bug #1031).
- FIX: Fixed Round Robin check missing when in tick-less mode (bug #1030).
- FIX: Fixed RCC_AHB1ENR_BKPSRAMEN not present in all STMF4xx devices
       (bug #1029).
- FIX: Fixed MPU fix #1027 broke stack checking on Cortex-M devices without
       MPU (bug #1028).

*** 19.1.2 ***
- NEW: Modified AES GCM function signatures.
- NEW: updates to MFS from trunk code.
- NEW: updates to test library from trunk code.
- HAL: Added H753 to all H7 mcuconf.h files.
- FIX: Fixed MPU setup missing on thread start (bug #1027).
- FIX: Fixed invalid I2C4 DMAs for STM32F76x (bug #1026).
- FIX: Fixed invalid STM32_UART7_RX_DMA_CHN for STM32F469 (bug #1025).
- FIX: Fixed invalid EXTI registry constant for STM32L4+ (bug #1024).
- FIX: Fixed missing RTC definitions in STM32L1xx registry (bug #1023).
- FIX: Fixed missing EXTI driver integration on some platforms (bug #1022).

*** 19.1.1 ***
- LIB: Re-introduced missing chGuardedPoolGetCounterI() function to guarded
       pools allocator.
- NEW: Extra timer checks in STM32 ST driver.
- FIX: Fixed various UART clock naming errors in STM32H7 HAL (bug #1021).
- FIX: Fixed missing STM32L4+ check in GPIOv3 driver (bug #1020).
- FIX: Fixed call to obsolete dmaStreamRelease() in STM32 I2Cv3 driver
       (bug #1019).
- FIX: Fixed misconfiguration in STM32L4R9I DIscovery board files (bug #1018).
- FIX: Fixed wrong Debug launch configuration in STM32L4Rx demos (bug #1017).
- FIX: Fixed wrong ADCSEL definitions in STM32H7 HAL (bug #1016).
- FIX: Fixed chTimeIsInRangeX() failing under some configurations (bug #1015).
- FIX: Fixed invalid AXI errata fix for STM32H7xx (bug #1014).
- FIX: Fixed invalid ADCD3 initialization in STM32 ADCv3 driver (bug #1013).
- FIX: Fixed invalid call to dmaStreamRelease() in STM32 SDIOv1 driver
       (bug #1012).
- FIX: Fixed wrong license restriction check in Nil (bug #1011).
- FIX: Fixed uninitialized variables in STM32 DMA drivers (bug #1010).
- FIX: Fixed wrong mcuconf.h in some testex demos related to STM32F407 
       (bug #1008).
- FIX: Fixed problem in STM32 mcuconf.h template files (bug #1007).
- EX:  Fixed I2C Acquire bus called twice in the HTS221 initialization 
       (bug #1006).
- EX:  Fixed missing I2C release bus in LPS22HB initialization (bug #1005).

*** 19.1.0 ***
- First 19.1.x release, see release note 19.1.0.
