QMK/lib/chibios/readme.txt

134 lines
7.3 KiB
Plaintext
Raw Normal View History

2020-03-23 10:48:11 +01:00
*****************************************************************************
*** 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.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.