usb_gadget 1.0.3

Implement USB gadgets for UDC-capable Linux systems — Kernel Functions and FunctionFS

Changelog

All notable changes to this project will be documented in this file. The format is based on [Keep a Changelog], and this project adheres to [Semantic Versioning].

1.0.3

Fixed

• Unistd.fcntl now passes its third argument to the syscall. The generated FFI binding fixed fcntl to two parameters, so the optional argument was silently dropped — leaving setFlags, setNonBlocking, and any F_SET*/F_DUPFD command a no-op. A 3-arg fcntl is now bound directly in the wrapper.
• Gadget.remove() no longer silently does nothing for auto-named gadgets. register() now records the resolved configfs name (e.g. usb-gadget0) so remove() can locate the gadget even when name was left null.
• AIO and EP0 watcher isolates now epoll_wait with a bounded (1 s) timeout instead of blocking indefinitely. An indefinitely-blocked FFI call left the isolate un-pausable, hanging process shutdown and dart test when teardown was skipped (e.g. a failed setUpAll). Real events/completions still wake the isolate immediately, so there is no added latency.

Changed

• EP0 control events are now delivered event-driven via a dedicated epoll_wait watcher isolate instead of a 1 ms polling timer. This removes the constant idle-CPU wakeups and the up-to-1 ms latency the timer added to every control transfer. Reads and writes still happen on the main isolate, preserving the ep0.read / ep0.write contract; the watcher only signals readiness. The watch is EPOLLONESHOT and the main isolate reads exactly one event batch per wake then re-arms — EP0 is a control state machine, so reading again before answering a pending SETUP would corrupt the kernel's setup state (the reply would fail with ESRCH).
• BufferPool.free is now O(1) (address→index map + membership flags) instead of two linear scans per released buffer, removing per-packet overhead on the AIO hot path.
• EP0 control writes use a zero-copy Uint8List.sublistView window instead of allocating a fresh sublist on every EAGAIN retry.

1.0.2

Fixed

• Track live RegGadget instances in a global registry so RegGadget.all() and Gadget.remove() operate on the original instances containing populated function lists, rather than reconstructing empty shells from the filesystem. This fixes remove() failing to unmount FunctionFs instances (EBUSY) and leaving stale configfs directories behind.

1.0.1

Changed

• Update lints to 6.1.0 and include package:lints/recommended.yaml

Fixed

• Add missing curly braces to control flow statements in aio_stream.dart and net.dart
• Remove unnecessary await on non-future in gadget/core.dart
• Remove redundant this. qualifier in endpoint/core.dart
• Simplify getConfigAttributes in NetworkFunction using null-aware syntax

1.0.0

Added

• UsbGadget.remove() to clean up configfs registrations without holding a RegGadget handle
• Integration tests for bulk transfers, ZLP, and endpoint halt via Python USB host driver

Changed

• BREAKING: RegGadget.bind() is now void (was Future<void>) — call sites no longer need await
• BREAKING: Remove RegGadget.unbindAll()
• Move gadget.register() inside try block; use gadget.remove() in finally for simplified lifecycle
• Move USB Chapter 9 definitions (descriptors, speeds, types) to lib/src/usb/ch9/ sub-package
• Simplify Future.delayed calls — remove redundant <void> type arguments
• Simplify doc comments in Errno and FunctionFs

Fixed

• HID endpoint poll and report intervals corrected to 8ms for High-Speed USB compatibility (was 10ms, which is invalid for HS)
• UDC binding error now includes the target UDC name in the log message

0.7.0

Added

• writeWhile method for continuous AIO writes
• isDummyUDC property on UDC
• usb-gadget CLI tool for managing Linux USB gadgets
• Comprehensive UVC frame and control configuration support
• Expanded UAC1 and UAC2 audio function attributes
• devicePath() method to HIDFunction
• Unit and integration tests for kernel USB functions
• Integration tests for bulk transfers, ZLP, and endpoint halt

Changed

• Rename ffs module to userland
• Rename GadgetFunctionType to FunctionType
• Rename USBDeviceState to DeviceState
• Rename USBHIDDescriptor to HIDDescriptor
• Remove legacy USBSpeed typedef
• Overhaul gadget and configuration management
• Delegate UDC state management and simplify Gadget API
• Improve Id, Class, and Config API stability and validation
• Introduce FunctionFsInterface and improve descriptor handling
• Introduce ConfigFsTree for robust gadget teardown
• Make prepare() asynchronous
• Make write() asynchronous and implement backpressure
• Make onDisable a synchronous method on HID
• Replace Comparable implementation with comparison operators in Speed enum
• Tune AIO buffer sizing
• Update examples to use writeWhile and improve lifecycle handling
• Rewrite ping/pong example to support large transfers and benchmarking

Fixed

• Add state checks to write() and flush()
• Ignore EINVAL in read loop and include stack traces
• Support zero-length packets in AioStream
• Default HID endpoint intervals for high-speed compatibility
• Use numeric value for MaxPower attribute in gadget configfs

0.6.0

Added

• FFI bindings and Epoll wrapper for Linux epoll and eventfd system calls, supporting I/O multiplexing with create, add, modify, delete, and wait, plus eventfd notification helpers

Changed

• Restructure kernel AIO bindings — rename platform/aio to platform/libaio, introduce a Libaio wrapper with scratch arrays to minimize allocations, and add an Iocb owning wrapper with factory methods for read/write ops
• Restructure endpoint directory and simplify AIO initialization
• Relocate AioStream and BufferPool to lib/src/endpoint/aio/; remove seek offsets and ensure data is copied from native buffers before pool return to prevent use-after-free
• Remove AioSink, old AioContext, and other high-level AIO abstractions in favor of the more direct libaio interface
• Rename DeviceClass.composite to perInterface
• Use DynamicLibrary.process() to access libc in errno handling

Fixed

• Refresh OUT endpoints on enable to recover from host de-configuration, replacing dead AioStream instances without requiring consumers to re-subscribe
• Rename restart() to refresh() on FunctionFS

0.5.0

Changed

• Use release() instead of close() for endpoint lifecycle
• Move Releasable mixin and release() to EndpointFile base class
• Remove droppedWrites tracking from AioSink

Fixed

• Add disabled state and fix onDisable transition in FunctionFS
• Await _releaseEndpoints to prevent concurrent map modification
• Do not release endpoints on disable or release in HID
• Prevent removing from empty write queue in AioSink
• Await close during resource release in AioSink
• Handle writing to closed sink gracefully in AioSink

0.4.3

Changed

• Export Logger class and remove PlatformLogger export

Fixed

• Add missing fatal log method to Logger class
• Prevent double release of resources
• Log stack trace when present in printer function

0.4.2

Changed

• Export ILogger as public to allow custom mixin creation outside the library

Fixed

• Release endpoints on disable to prevent resource leaks

0.4.1

Added

• Compile-time environment-based logging configuration

Changed

• Simplify log level representation
• Enhance log formatting and color handling

Fixed

• Replace hardcoded log level with environment-based constant

0.4.0

Added

• Initial release of the package