Apache NuttX is a mature, real-time embedded operating system (RTOS) https://nuttx.apache.org/
Find a file
Justin Hammond ba7c7e1f77 drivers/usbhost: Support USB hubs on xHCI.
The driver refused CONFIG_USBHOST_HUB outright.  Everything needed to
describe a device behind a hub is now in place, so implement the rest.

- xhci_device_init() took a root hub port and read the slot, the control
  endpoint and the device out of it, all of which belong to the device.
  It now takes the hub port and the control endpoint, and records the
  device on the root port only when that is where it sits: once a hub is
  plugged in, the device a root port names is the hub.  xhci_address_set()
  and xhci_device_deinit() likewise work on a device, and
  xhci_disconnect() finds the device by the port going away.
- The hub asks for a port's control endpoint before it reports the
  connection, so xhci_epalloc() has nothing to attach one to.  It returns
  an endpoint with no slot, and xhci_connect() gives it one when it
  creates the device.
- A hub must be described to the controller as a hub before anything
  behind it can be reached, and nothing knows it is one when its slot is
  created.  xhci_hub_update() corrects the slot context with a Configure
  Endpoint command the first time something appears behind it.
- A hub reports each changed port without waiting for the last to be dealt
  with, so the connect method queues them; holding one pointer meant the
  second report overwrote the first.  No more can be outstanding than the
  controller has slots.
- Report the root port and slot counts from HCSPARAMS1, and the port count
  from a hub's descriptor.

Tested on an EIC7700X board with a hub on one controller and a keyboard on
the other.  Behind the hub, a 59 GB mass storage device mounts and reads a
file back, and a composite CDC device gives four ttyACM nodes.

Assisted-by: Claude:claude-opus-5
Signed-off-by: Justin Hammond <justin@dynam.ac>
2026-09-28 21:45:57 +08:00
.github build(deps): bump docker/setup-buildx-action from 4.3.0 to 4.4.1 2026-09-21 16:28:50 +08:00
arch arch/nrf52: add SAADC external TIMER trigger over PPI 2026-09-28 11:20:31 +02:00
audio audio: limit the buffer count guard to shared ring requests 2026-08-05 07:58:53 +02:00
binfmt binfmt/elf: Load FDPIC modules through the ELF loader. 2026-09-26 11:13:30 -03:00
boards boards/arm/stm32l4/stm32l476vg-disco: Add CMakeLists.txt. 2026-09-28 06:43:27 -03:00
cmake cmake: fix undefined function name in parse args error messages 2026-09-11 21:15:22 +08:00
crypto crypto: fix chacha constants under GCC 15. 2026-09-20 08:22:11 -03:00
Documentation arch/nrf52: add SAADC external TIMER trigger over PPI 2026-09-28 11:20:31 +02:00
drivers drivers/usbhost: Support USB hubs on xHCI. 2026-09-28 21:45:57 +08:00
dummy
fs sched/semaphore: Fix pre-existing nxstyle issues in the touched files 2026-09-25 10:37:43 +02:00
graphics graphics/nxterm: consume SGR escape sequences 2026-08-23 10:46:02 +08:00
include usbhost: Report what a hub is on the port it occupies. 2026-09-28 21:45:57 +08:00
libs libs/libc/elf: Link a kernel-build program the way the loader loads it. 2026-09-26 11:13:57 -03:00
mm mm/iob: fix CONFIG_NET_TIMESTAMPING typo in iob_alloc 2026-09-19 16:36:47 -03:00
net net/pkt: remove unused variable conn in append_timestamping 2026-09-19 18:32:45 -03:00
openamp cmake: Use NUTTX(_DIR/_BIN_DIR) instead CMAKE(_SRC_DIR/_BIN_DIR) 2026-08-09 11:13:08 -03:00
pass1 tools: fix stale archive members surviving a Kconfig-driven CSRCS change 2026-07-28 21:26:03 -03:00
sched sched/profil: Fix declaration spacing. 2026-09-28 06:44:34 -03:00
syscall fs: add chroot() syscall 2026-09-20 22:27:38 +08:00
tools tools/ci: Build the NXFLAT configurations that convert a module. 2026-09-27 11:25:12 -03:00
video video/videomode: Fix EDID parsing and formatting of video mode dumps 2026-08-29 11:09:11 -03:00
wireless wireless/bluetooth: Validate Number Of Completed Packets event. 2026-09-25 10:35:51 +02:00
.asf.yaml github: master branch protection tune. 2025-05-07 18:37:13 -05:00
.codespell-ignore-lines arch/arm: Reserve r10 via ARCHCFLAGS and hoist the PIC module flags. 2026-07-24 23:09:08 +08:00
.codespellrc zbus: Add linker support and documentation for the zbus port 2026-09-21 08:40:14 -03:00
.editorconfig .editorconfig: fix character encoding property specification 2025-11-28 19:12:13 +08:00
.gitignore boards/risc-v/eic7700x: Adopt the common board layout. 2026-08-19 01:40:57 +08:00
.gitmessage docs/contributing: Add a commit message template 2025-06-03 17:33:24 +08:00
.mcp.json arch/risc-v/eic7700x: Describe and configure the pads. 2026-09-28 16:19:01 +08:00
.pre-commit-config.yaml pre-commit: enable codespell checks 2025-05-05 12:34:39 +08:00
.yamllint
AUTHORS AUTHORS: add Jorge Guzman 2026-08-25 08:43:13 -04:00
CMakeLists.txt cmake: reconfigure when .config changes 2026-09-14 18:40:45 -03:00
CONTRIBUTING.md contributing: Add requirement for 'Assisted-by' commit field 2026-07-12 09:42:28 +08:00
INVIOLABLES.md
Kconfig include/nuttx: Add link-time iterable sections infrastructure 2026-08-27 01:04:05 +08:00
LICENSE libs/libdsp: Add Matrix operations 2026-07-11 14:55:59 -03:00
Makefile !boards: enforce secure ROMFS passwd and TEA key setup 2026-07-09 22:41:11 +08:00
NOTICE
README.md ci/testing: Add MemBrowse Integration 2026-06-18 12:07:41 -03:00
ReleaseNotes

POSIX Badge License Issues Tracking Badge Contributors GitHub Build Badge Documentation Badge MemBrowse

Apache NuttX is a real-time operating system (RTOS) with an emphasis on standards compliance and small footprint. Scalable from 8-bit to 64-bit microcontroller environments, the primary governing standards in NuttX are POSIX and ANSI standards. Additional standard APIs from Unix and other common RTOSs (such as VxWorks) are adopted for functionality not available under these standards, or for functionality that is not appropriate for deeply-embedded environments (such as fork()).

For brevity, many parts of the documentation will refer to Apache NuttX as simply NuttX.

Getting Started

First time on NuttX? Read the Getting Started guide! If you don't have a board available, NuttX has its own simulator that you can run on terminal.

Documentation

You can find the current NuttX documentation on the Documentation Page.

Alternatively, you can build the documentation yourself by following the Documentation Build Instructions.

The old NuttX documentation is still available in the Apache wiki.

Supported Boards

NuttX supports a wide variety of platforms. See the full list on the Supported Platforms page.

Contributing

If you wish to contribute to the NuttX project, read the Contributing guidelines for information on Git usage, coding standard, workflow and the NuttX principles.

License

The code in this repository is under either the Apache 2 license, or a license compatible with the Apache 2 license. See the License Page for more information.