Mark usbif, audioif, cameraif and displayif as moved

.cursor/environment.json

@@ -7,7 +7,6 @@
     "github.com/PyDevices/PyDevices.github.io",
     "github.com/PyDevices/pydevices",
     "github.com/PyDevices/pydevices-examples",
-    "github.com/PyDevices/displayif",
     "github.com/PyDevices/audiodsp",
     "github.com/PyDevices/pygraphics",
     "github.com/PyDevices/palettes",

SUPPORT.md

@@ -5,7 +5,7 @@ Welcome to PyDevices! Here are the best ways to get help and ask questions acros
 ## 💬 Getting Help & Discussions
 
 - **Q&A & Ideas**: For questions, hardware setup discussions, or feature ideas, please use [pydevices Discussions](https://github.com/PyDevices/pydevices/discussions) — the single Q&A venue for the whole organization. Other repositories intentionally have Discussions disabled and use Issues only.
-- **Bug Reports**: If you have found a reproducible bug in a specific package, please open an issue in the corresponding repository (e.g. `pydevices`, `displayif`, `pygraphics`, `pdwidgets`).
+- **Bug Reports**: If you have found a reproducible bug in a specific package, please open an issue in the corresponding repository (e.g. `pydevices`, `micropython-pydevices`, `pygraphics`, `pdwidgets`).
 
 ## 📚 Live Documentation & Specs
 

assets/js/site-chrome.js

@@ -42,7 +42,7 @@
     '/pydevices/">Core Stack</a>' +
     '<a href="' +
     ROOT +
-    '/displayif/">DisplayIF</a>' +
+    '/micropython-pydevices/">Firmware</a>' +
     '<a href="' +
     ROOT +
     '/workbench/">Workbench</a>' +
@@ -101,15 +101,6 @@
           desc: "Unified display HAL & device driver abstraction",
           icon: '<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><rect x="2" y="3" width="20" height="14" rx="2"/><line x1="8" y1="21" x2="16" y2="21"/><line x1="12" y1="17" x2="12" y2="21"/></svg>'
         },
-        {
-          id: "displayif",
-          name: "displayif",
-          path: "/displayif/",
-          url: ROOT + "/displayif/",
-          tag: "C Bus",
-          desc: "Native C SPI, I2C, 8080 & RGB usermods",
-          icon: '<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><polyline points="22 12 18 12 15 21 9 3 6 12 2 12"/></svg>'
-        },
         {
           id: "audiodsp",
           name: "audiodsp",
@@ -119,15 +110,6 @@
           desc: "CircuitPython audio stack as MicroPython usermods",
           icon: '<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M4 10v4M8 7v10M12 4v16M16 7v10M20 10v4"/></svg>'
         },
-        {
-          id: "audioif",
-          name: "audioif",
-          path: "/audioif/",
-          url: ROOT + "/audioif/",
-          tag: "C Audio Driver",
-          desc: "I2S drivers and the audio pump's platform threads",
-          icon: '<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M4 10v4M8 7v10M12 4v16M16 7v10M20 10v4"/></svg>'
-        },
         {
           id: "audiocomponents",
           name: "audiocomponents",
@@ -137,24 +119,6 @@
           desc: "55 instruments and 45 effects on audiodsp",
           icon: '<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M4 21v-7M4 10V3M12 21v-9M12 8V3M20 21v-5M20 12V3M1 14h6M9 8h6M17 16h6"/></svg>'
         },
-        {
-          id: "usbif",
-          name: "usbif",
-          path: "/usbif/",
-          url: ROOT + "/usbif/",
-          tag: "C USB",
-          desc: "USB device and host classes for MicroPython",
-          icon: '<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M12 2v14"/><path d="M9 5l3-3 3 3"/><path d="M12 12l-5-3V7M12 14l5-3V9"/><circle cx="12" cy="19" r="3"/></svg>'
-        },
-        {
-          id: "cameraif",
-          name: "cameraif",
-          path: "/cameraif/",
-          url: ROOT + "/cameraif/",
-          tag: "C Camera",
-          desc: "MIPI-CSI camera as a MicroPython object",
-          icon: '<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M14.5 4h-5L7 7H4a2 2 0 0 0-2 2v9a2 2 0 0 0 2 2h16a2 2 0 0 0 2-2V9a2 2 0 0 0-2-2h-3z"/><circle cx="12" cy="13" r="3"/></svg>'
-        },
         {
           id: "pydevices-examples",
           name: "examples",

data/repos_db.json

@@ -30,6 +30,12 @@
     "excluded": {
       ".github (dotgithub)": "No landing page by design. It holds org-wide data, scripts, and community health files, and is documented as markdown only.",
       "android-runner": "Exists solely to enable pydevices/bin/android.py. The APK is documented in pydevices; the runner publishes no site."
+    },
+    "moved": {
+      "displayif": "now [`modules/displayif`](https://github.com/PyDevices/micropython-pydevices/tree/main/modules/displayif) in micropython-pydevices. The old repository is archived.",
+      "audioif": "now [`modules/audioif`](https://github.com/PyDevices/micropython-pydevices/tree/main/modules/audioif) in micropython-pydevices. The old repository is archived.",
+      "cameraif": "now [`modules/cameraif`](https://github.com/PyDevices/micropython-pydevices/tree/main/modules/cameraif) in micropython-pydevices. The old repository is archived.",
+      "usbif": "the C module is now [`modules/usbhost`](https://github.com/PyDevices/micropython-pydevices/tree/main/modules/usbhost) in micropython-pydevices; the Python USB packages are in [pydevices](https://github.com/PyDevices/pydevices/blob/main/docs/usb.md). The old repository is archived."
     }
   },
   "pydevices": {
@@ -73,37 +79,32 @@
   "displayif": {
     "tier": 1,
     "page": "portal-subdir",
+    "portal_grid": false,
+    "title": "PyDevices - displayif (moved)",
     "tier_name": "Core Platform & Board Contract",
     "theme_color": "var(--tier-1-amber)",
-    "eyebrow": "displayif",
-    "headline": "displayif — C hardware bus engine & usermod drivers.",
-    "description": "High-performance C hardware bus engines (SPI, I2C, Intel 8080, RGB/DPI, MIPI DSI) and native usermod display drivers for MicroPython and CircuitPython.",
-    "hero_canvas": {
-      "app": "bus_scope",
-      "width": 240,
-      "height": 240,
-      "shape": "square",
-      "app_url": "https://PyDevices.github.io/assets/apps/bus_scope.py"
-    },
+    "eyebrow": "displayif · moved",
+    "headline": "displayif has moved into micropython-pydevices.",
+    "description": "Moved to micropython-pydevices as modules/displayif, with its history. It was never published on its own: it reaches you in firmware built by micropython-pydevices' build_mp.py, so that is where it is built, tested and changed now. Your code doesn't change. The old repository is archived.",
     "buttons": [
       {
-        "label": "GitHub Repo",
-        "href": "https://github.com/PyDevices/displayif",
+        "label": "modules/displayif",
+        "href": "https://github.com/PyDevices/micropython-pydevices/tree/main/modules/displayif",
         "primary": true
       },
       {
-        "label": "Hardware Bring-up",
-        "href": "https://github.com/PyDevices/displayif/blob/main/docs/soft-reset-and-bring-up.md",
+        "label": "Hardware bring-up",
+        "href": "https://github.com/PyDevices/micropython-pydevices/blob/main/modules/displayif/docs/soft-reset-and-bring-up.md",
         "tier_color": true
       },
       {
-        "label": "pygraphics",
-        "href": "https://pydevices.github.io/pygraphics/",
+        "label": "micropython-pydevices",
+        "href": "https://pydevices.github.io/micropython-pydevices/",
         "tier_color": true
       },
       {
-        "label": "pydevices Core",
-        "href": "https://pydevices.github.io/pydevices/",
+        "label": "Archived repo",
+        "href": "https://github.com/PyDevices/displayif",
         "tier_color": true
       }
     ]
@@ -149,37 +150,32 @@
   "audioif": {
     "tier": 1,
     "page": "portal-subdir",
+    "portal_grid": false,
+    "title": "PyDevices - audioif (moved)",
     "tier_name": "Core Platform & Board Contract",
     "theme_color": "var(--tier-1-amber)",
-    "eyebrow": "audioif",
-    "headline": "audioif — the audio hardware layer: the platform drivers under the audio pump.",
-    "description": "The part of the audio stack that knows what a thread is, where the clock comes from and where the sound goes: a pinned task and the I2S peripheral on ESP32, a native thread on unix and Windows, and a CircuitPython-shaped audiobusio.I2SOut over all of it. With it in a firmware, a graph keeps an exact clock while a screen redraws and a USB stack runs, and audiodev plays through it without being asked. The portable half of the pump, and every DSP node, is audiodsp.",
-    "hero_canvas": {
-      "app": "signal_gen",
-      "width": 480,
-      "height": 480,
-      "shape": "square",
-      "app_url": "https://PyDevices.github.io/assets/apps/signal_gen.py"
-    },
+    "eyebrow": "audioif · moved",
+    "headline": "audioif has moved into micropython-pydevices.",
+    "description": "Moved to micropython-pydevices as modules/audioif, with its history. It was never published on its own: it reaches you in firmware built by micropython-pydevices' build_mp.py, so that is where it is built, tested and changed now. Your code doesn't change. The old repository is archived.",
     "buttons": [
       {
-        "label": "GitHub Repo",
-        "href": "https://github.com/PyDevices/audioif",
+        "label": "modules/audioif",
+        "href": "https://github.com/PyDevices/micropython-pydevices/tree/main/modules/audioif",
         "primary": true
       },
       {
-        "label": "Releases",
-        "href": "https://github.com/PyDevices/audioif/releases/latest",
+        "label": "Audio in pydevices",
+        "href": "https://github.com/PyDevices/pydevices/blob/main/docs/audio.md",
         "tier_color": true
       },
       {
-        "label": "audiodsp",
-        "href": "https://pydevices.github.io/audiodsp/",
+        "label": "micropython-pydevices",
+        "href": "https://pydevices.github.io/micropython-pydevices/",
         "tier_color": true
       },
       {
-        "label": "Audio in pydevices",
-        "href": "https://github.com/PyDevices/pydevices/blob/main/docs/audio.md",
+        "label": "Archived repo",
+        "href": "https://github.com/PyDevices/audioif",
         "tier_color": true
       }
     ]
@@ -225,75 +221,65 @@
   "usbif": {
     "tier": 1,
     "page": "portal-subdir",
+    "portal_grid": false,
+    "title": "PyDevices - usbif (moved)",
     "tier_name": "Core Platform & Board Contract",
     "theme_color": "var(--tier-1-amber)",
-    "eyebrow": "usbif",
-    "headline": "usbif — native USB for MicroPython: device, host, and both at once.",
-    "description": "A board a computer sees as a sound card, a MIDI instrument, a keyboard, a drive or a webcam — and, on the same board, a USB host that a keyboard, thumb drive, MIDI controller or camera plugs into. One of the PyDevices *if modules, with displayif, audioif and cameraif: a native C module with a thin, stable Python surface that runs unchanged on a workstation.",
-    "hero_canvas": {
-      "app": "encoder",
-      "width": 480,
-      "height": 480,
-      "shape": "square",
-      "app_url": "https://PyDevices.github.io/assets/apps/encoder.py"
-    },
+    "eyebrow": "usbif · moved",
+    "headline": "usbif has moved, to two homes.",
+    "description": "The C module is now usbhost, in micropython-pydevices as modules/usbhost (its binding is _usbhost, it was _usbif). The Python USB packages (usb.core, the host and device classes, usb-hid) are top-level packages in pydevices, installed with mip. Code that uses the packages doesn't change. The old repository is archived.",
     "buttons": [
       {
-        "label": "GitHub Repo",
-        "href": "https://github.com/PyDevices/usbif",
+        "label": "modules/usbhost",
+        "href": "https://github.com/PyDevices/micropython-pydevices/tree/main/modules/usbhost",
         "primary": true
       },
       {
-        "label": "Portable API",
-        "href": "https://github.com/PyDevices/usbif/blob/main/lib/usbif/README.md",
+        "label": "USB packages in pydevices",
+        "href": "https://github.com/PyDevices/pydevices/blob/main/docs/usb.md",
         "tier_color": true
       },
       {
-        "label": "Examples",
-        "href": "https://github.com/PyDevices/usbif/tree/main/examples",
+        "label": "micropython-pydevices",
+        "href": "https://pydevices.github.io/micropython-pydevices/",
         "tier_color": true
       },
       {
-        "label": "audiodsp",
-        "href": "https://pydevices.github.io/audiodsp/",
+        "label": "Archived repo",
+        "href": "https://github.com/PyDevices/usbif",
         "tier_color": true
       }
     ]
   },
   "cameraif": {
     "tier": 1,
     "page": "portal-subdir",
+    "portal_grid": false,
+    "title": "PyDevices - cameraif (moved)",
     "tier_name": "Core Platform & Board Contract",
     "theme_color": "var(--tier-1-amber)",
-    "eyebrow": "cameraif",
-    "headline": "cameraif — a MIPI-CSI camera as a MicroPython object.",
-    "description": "Point the board at something and read the frame. The sensor is found by probing rather than named in code, so a different camera is a build-time option away, not a rewrite. Hardware JPEG, zero-copy frames and hardware scaling straight into a display's scanout buffer, with every rate in its README measured on the board it names.",
-    "hero_canvas": {
-      "app": "encoder",
-      "width": 480,
-      "height": 480,
-      "shape": "square",
-      "app_url": "https://PyDevices.github.io/assets/apps/encoder.py"
-    },
+    "eyebrow": "cameraif · moved",
+    "headline": "cameraif has moved into micropython-pydevices.",
+    "description": "Moved to micropython-pydevices as modules/cameraif, with its history. It was never published on its own: it reaches you in firmware built by micropython-pydevices' build_mp.py, so that is where it is built, tested and changed now. Your code doesn't change. The old repository is archived.",
     "buttons": [
       {
-        "label": "GitHub Repo",
-        "href": "https://github.com/PyDevices/cameraif",
+        "label": "modules/cameraif",
+        "href": "https://github.com/PyDevices/micropython-pydevices/tree/main/modules/cameraif",
         "primary": true
       },
       {
         "label": "Examples",
-        "href": "https://github.com/PyDevices/cameraif/tree/main/examples",
+        "href": "https://github.com/PyDevices/micropython-pydevices/tree/main/modules/cameraif/examples",
         "tier_color": true
       },
       {
-        "label": "displayif",
-        "href": "https://pydevices.github.io/displayif/",
+        "label": "micropython-pydevices",
+        "href": "https://pydevices.github.io/micropython-pydevices/",
         "tier_color": true
       },
       {
-        "label": "usbif",
-        "href": "https://pydevices.github.io/usbif/",
+        "label": "Archived repo",
+        "href": "https://github.com/PyDevices/cameraif",
         "tier_color": true
       }
     ]
@@ -830,7 +816,7 @@
     "theme_color": "var(--tier-5-steel)",
     "eyebrow": "micropython-pydevices",
     "headline": "micropython-pydevices — the versioned MicroPython runtime overlay.",
-    "description": "The PyDevices patch queue for MicroPython, kept like a distribution keeps one: an ordered, provenance-tracked patch series over the pinned upstream release (v1.29.0), with presets, boards and variants that build PyDevices modules into firmware with upstream's own make.",
+    "description": "The PyDevices patch queue for MicroPython, kept like a distribution keeps one: an ordered, provenance-tracked patch series over the pinned upstream (MicroPython v1.30.0-preview-160), with presets, boards and variants that build PyDevices modules into firmware with upstream's own make.",
     "hero_canvas": {
       "app": "radar_scope",
       "width": 240,

docs/github-presence.md

@@ -101,7 +101,7 @@ icons. Header brand stays on the shared org logo.
 | [palettes](https://github.com/PyDevices/palettes) | Color palette toolkit for PyDevices | [pydevices.github.io/palettes](https://pydevices.github.io/palettes/) |
 | [pdwidgets](https://github.com/PyDevices/pdwidgets) | Cross-platform widget toolkit for PyDevices | [pydevices.github.io/pdwidgets](https://pydevices.github.io/pdwidgets/) |
 | [lvgl-bindings](https://github.com/PyDevices/lvgl-bindings) | LVGL C→binding generator (source of truth for the native bindings consumers) | [pydevices.github.io/lvgl-bindings](https://pydevices.github.io/lvgl-bindings/) |
-| [displayif](https://github.com/PyDevices/displayif) | Native display bus/framebuffer modules | [pydevices.github.io/displayif](https://pydevices.github.io/displayif/) |
+| [micropython-pydevices](https://github.com/PyDevices/micropython-pydevices) | MicroPython with PyDevices' C modules (`displayif`, `audioif`, `cameraif`, `usbhost`, …) built in | [pydevices.github.io/micropython-pydevices](https://pydevices.github.io/micropython-pydevices/) (the old `displayif`, `audioif`, `cameraif` and `usbif` pages stay up as pointers) |
 | [audiodsp](https://github.com/PyDevices/audiodsp) | CircuitPython-compatible audio for MicroPython plus `pydevices-audiodsp` CPython/Android/Pyodide wheels | [pydevices.github.io/audiodsp](https://pydevices.github.io/audiodsp/) · [TestPyPI](https://test.pypi.org/project/pydevices-audiodsp/) |
 | [pygraphics](https://github.com/PyDevices/pygraphics) | Native + pure-Python FrameBuffer/Area (`import pygraphics`); docs on [RTD](https://pygraphics.readthedocs.io) | [pydevices.github.io/pygraphics](https://pydevices.github.io/pygraphics/) |
 | [lvgl-micropython](https://github.com/PyDevices/lvgl-micropython) | MicroPython user C module glue for LVGL | [pydevices.github.io/lvgl-micropython](https://pydevices.github.io/lvgl-micropython/) |