Skip to content

Add 1209:4665 ferros (Nick Spiker) #1208

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
nickspiker wants to merge 2 commits into
base: master
Choose a base branch
from
Open

Add 1209:4665 ferros (Nick Spiker) #1208

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
342097b
Add Nick Spiker org and 1209:4665 ferros
nickspiker May 13, 2026
708a6e0
1209:4665 ferros: name the hardware embodiment and USB device stack
nickspiker Sep 11, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 13 additions & 0 deletions 1209/4665/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,13 @@
---
layout: pid
title: ferros
owner: nickspiker
license: Apache-2.0
site: https://github.com/nickspiker/ferros
source: https://github.com/nickspiker/ferros
---
ferros is an open-source, bare-metal mobile operating system written in Rust. It replaces the stock OS on commercial ARM64 hardware. The current hardware embodiment is a Google Pixel 8 Pro (Tensor G3), booted from the phone's boot partition with no Linux or Android underneath; an Apple M1 MacBook Air (via m1n1) is the second target in bring-up.

ferros brings up the SoC's USB device controller itself: it initialises the Tensor G3 eUSB2 PHY and drives the Synopsys DWC3 core in device mode, builds the descriptors, and services EP0 plus one bulk IN and one bulk OUT endpoint. It enumerates as a vendor-specific device (bDeviceClass 0xFF) for its host tool `ferros-bridge`, which matches on this ID for diagnostics, kernel hot-reload and reboot. The device stack lives in `ferros_hal/src/usb.rs` (DWC3 driver and descriptors, Pixel 8 Pro) and `ferros_hal_m1/src/usb.rs` (M1). Every device running ferros enumerates with this single PID; the protocol carried over the bulk endpoints identifies the device's role.

The PID `0x4665` is the ASCII encoding of "Fe", the chemical symbol for iron (the etymological root of the project name) and a human-readable identifier in USB descriptor hex dumps.
6 changes: 6 additions & 0 deletions org/nickspiker/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
---
layout: org
title: Nick Spiker
site: https://github.com/nickspiker
---
Independent developer working on ferros, an open-source mobile operating system written from first principles in Rust, and related open hardware projects.