mirror of
https://github.com/apache/nuttx.git
synced 2026-10-08 06:45:19 +00:00
f6ecf80ebb
The documentation grew one page at a time, so the tree follows the
history of who wrote what and not the shape of NuttX. Scheduling is
spread over three places, a driver page can sit above the subsystem
that owns it, and the front page lists everything at the same level.
That is a lot to face when all you want to know is where the scheduler
lives.
This change files every page under the code it describes. It is a move,
not a rewrite: outside the ten pages named below, every page keeps the
text that is already in master, and no page's text is deleted.
What it does:
* Groups the table of contents into nine chapters.
* Moves the OS subsystems under os/: scheduling, memory, drivers,
filesystem, networking, IPC, interrupts, libs, time.
* Renames the platform pages to the names the source tree uses, and
derives their tags from the tree instead of by hand.
* Splits guides/ by subject.
* Adds Documentation/redirects.py, with a rule for every page that left
its old path, so old URLs keep working. The redirect page also carries
a link's #anchor across to the new page.
Ten pages have text that is new or rewritten. Nine of them are the
landing page of a chapter, which has to exist for the new structure:
index the front page
os/index OS Design
os/scheduling/index Scheduling
os/interrupts/index Interrupts
os/ipc/index IPC
os/time/index Time and timers
about/index About
developing/index Developing NuttX
ReleaseNotes/index Release notes
The tenth is os/libs/libbuiltin, the only page here with technical
content: libs/libbuiltin/ had no page at all. Five SVG diagrams come
with these pages, hand-written XML with no editor metadata.
Nothing outside Documentation/ is touched.
How it was checked:
* Sphinx builds with -W: no warnings, and no document left outside a
toctree.
* A script, offered in the PR, proves the narrow claim this rests on.
For every page outside the ten named above it erases what a move
touches -- link target, path, tag line, toctree block, table border --
from the whole old text and the whole new text, and requires the two
to be byte for byte identical. It also requires every sentence of a
deleted page to turn up somewhere, and every page that left its old
path to have a redirect, from a URL that existed, to where its content
went. It exits non-zero and names the page if any of that is not true,
and it tests added pages too, so forgetting to declare one cannot make
it pass.
* An independent audit checked 133 factual claims on these ten pages
against the tree, one shell command per claim: 130 confirmed, 1
refuted and fixed here, 2 not checkable.
* tools/checkpatch.sh is clean over the range.
The diff is large because moving a page changes every link that points
to it. Most of it is pure renames, and board pages that gained one tag
line.
Assisted-by: Claude:claude-opus-5
2.9 KiB
2.9 KiB
NuttX-6.21
The 88th release of NuttX, Version 6.21, was made on August 25, 2012, and is available for download from the SourceForge website. Note that release consists of two tarballs: nuttx-6.21.tar.gz and apps-6.21.tar.gz. Both may be needed (see the top-level nuttx/README.txt file for build information).
This release corresponds with SVN release number: r5052
Additional new features and extended functionality:
- Core: Add support for multiple registered atexit() functions. Syslog extended: Now any character driver may be used for the debug logging device. Mountpoint traversal logic.
- Drivers: Added support for the TI PGA112-7 amplifier/multiplexor.
- LPC43xx: Added clock ramp-up logic to run at 204 MHz
- LPC43xx Drivers: SPIFI block driver, RS-485 support, Minimal termios support. Framework for USB0 device controller driver.
- LPC17xx Drivers: Minimal termios support
- STM32: Support for STM32 F1 "Value Line" (contributed by Mike Smith). Add support for STM32 F107 "Connectivity Line" (contributed by Max Holtzberg). Clock restart logic needed for recovery from low power modes.
- STM32 Drivers: RTC alarm support. Usable for wakeup from sleep mode, Minimal serial termios support. USB OTG FS host driver (alpha).
- STM32 Boards: Add power management hooks for the STM32F4Discovery, Add support for the Olimex STM32-P107 (contributed by Max Holtzberg).
- PIC32: Add support for the Pinguino MIPS toolchain.
- PIC32 Drivers: GPIO driver now supports F1 analog regiaters (ANSEL).
- PIC32 Boards: Add support for the PGA117 on the Mirtoo module.
- Calypso: Add support for the SSD1783 LCD on the Compal E99.
- Library: cfsetispeed(), cfsetospeed(), tcflush(), memchr(), and memccpy().
- Applications: Port of freemodbus-v1.5.0. Add support for testing devices with multiple ADC, PWM, and QE devices. NSH: NSH 'mount' command (with no arguments) will now show mounted volumes. Add new NSH 'df' command. Extended 'help' support. NSH now catches the return value from spawned applications (provided by Mike Smith).
- Build System: mkconfig will not define CONFIG_DRAM_END. A lot of progress has been made on the automated NuttX configuration logic (Thanks go to Richard Cochran).
- Documentation: Document ways to customize the behavior of NSH.
Bugfixes (see the change log for details) :
- Serial drivers (all): Fix ioctl return value. Common "upper half" serial driver will now return with EINTR if a serial wait is interrupted by a signal.
- FAT: Fix statfs() file name length.
- LPC43xx: Clock configuration.
- STM32: Pinmap fixes, SPI driver re-initialization
- STM32 Boards: Correct and lower SDIO frequency for F2 and f4 boards.
- AVR: C++ build issues.
- PM: Fix a place where interrupts were not be re-enabled.
- Applications: NSH application start-up race conditions.
- Library: Fieldwidth and justification for %s format. Fixed several issues with presenting floating point numbers. NULL definition for C++
As well as other, less critical bugs (see the ChangeLog for details)