Roflin
ccf4eb4996
gc_bba_test/ builds a .dol that drives the adapter over raw EXI from the
console and reports pass/fail per test on the TV, navigable with the pad.
Uses libogc's EXI API against EXI0:2 (Serial Port 1) rather than its bba
network driver: driving the register file directly gives each check its own
verdict, so a failure points at a specific register instead of at
'networking'. Six suites - identity, registers, reset/control, EXI link
integrity (including an EXI clock-index sweep), ethernet TX/RX, SPRAM/DMA
streaming.
Encodes the hardware lessons from bring-up so the app cannot mislead:
* the device ID is a one-shot cleared by the first NCRA reset, so it is
reported SKIP on a re-run rather than FAIL
* TI means the frame reached the W5100, NOT the wire - the TX test says so
* register reads clock exactly the requested length (over-clocking
desynchronises the next transaction)
* TXDATA is written one byte per transaction (eff_addr auto-increments)
.devcontainer/Dockerfile gains the devkitPro gamecube-dev group. devkitPro
publishes no .deb on GitHub, so this uses their installer script against
apt.devkitpro.org -- which is 403 from inside the running container's egress
but reachable from a host-side docker build. Rebuild the container to get it.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
96 lines
4.0 KiB
Docker
96 lines
4.0 KiB
Docker
FROM debian:sid-slim
|
|
|
|
RUN apt-get update && apt-get install -y --no-install-recommends \
|
|
ca-certificates \
|
|
curl \
|
|
git \
|
|
git-lfs \
|
|
sudo \
|
|
python3 \
|
|
python3-venv \
|
|
python3-pip \
|
|
yosys \
|
|
nextpnr-ice40 \
|
|
fpga-icestorm \
|
|
libusb-1.0-0 \
|
|
libftdi1-2 \
|
|
tshark \
|
|
nodejs npm \
|
|
graphviz \
|
|
poppler-utils \
|
|
kicad \
|
|
kicad-libraries \
|
|
&& rm -rf /var/lib/apt/lists/*
|
|
# libusb-1.0-0 + libftdi1-2: USB backend for `iceprog` (FPGA flash) and `pyftdi`
|
|
# (FT2232H EEPROM). sudo: the /dev/bus/usb nodes are root-owned, so the vscode
|
|
# user flashes via `sudo` (NOPASSWD, configured below).
|
|
|
|
ENV TZ="Europe/Amsterdam"
|
|
|
|
# Debian marks the system Python as externally-managed (PEP 668), so install
|
|
# project deps into a venv. /opt/venv is first on PATH, so `python`/`pip` resolve
|
|
# to it for all users.
|
|
ENV VIRTUAL_ENV=/opt/venv
|
|
RUN python3 -m venv "$VIRTUAL_ENV"
|
|
ENV PATH="$VIRTUAL_ENV/bin:$PATH"
|
|
|
|
# ENV PATH alone is not enough: Debian's /etc/profile REsets PATH unconditionally,
|
|
# so any *login* shell (VS Code's integrated terminal, `su - vscode`, ssh) drops
|
|
# /opt/venv/bin and then `python` does not exist at all (slim has only python3).
|
|
# Re-prepend the venv for login shells so the documented `python -m exi_bba.synth`
|
|
# works everywhere.
|
|
RUN printf 'PATH="%s/bin:$PATH"\nexport PATH\n' "$VIRTUAL_ENV" > /etc/profile.d/10-venv.sh
|
|
|
|
RUN npm install -g @anthropic-ai/claude-code
|
|
|
|
COPY requirements.txt /tmp/requirements.txt
|
|
RUN pip install --no-cache-dir -r /tmp/requirements.txt
|
|
|
|
# pyftdi: programs the FT2232H EEPROM over libusb, and (with pyserial) reads the
|
|
# FT2232H channel-B UART directly over libusb for bring-up diagnostics.
|
|
RUN pip install --no-cache-dir pyftdi pyserial
|
|
|
|
# ── GameCube homebrew toolchain (devkitPPC + libogc) ────────────────────────
|
|
# Needed to build the on-console BBA test app in `gc_bba_test/` into a .dol.
|
|
# devkitPro does NOT publish a .deb on GitHub -- the Debian package only exists
|
|
# in their own apt repo -- so this uses their maintained installer script, which
|
|
# adds the repo, imports the key and installs dkp-pacman. `gamecube-dev` is a
|
|
# package GROUP (devkitPPC, libogc, libfat, tools incl. elf2dol).
|
|
#
|
|
# NOTE this pulls from apt.devkitpro.org / pkg.devkitpro.org. Those hosts are
|
|
# blocked (HTTP 403) from inside the running container's network egress, but a
|
|
# host-side `docker build` reaches them fine -- which is why this lives in the
|
|
# Dockerfile rather than being installed at runtime. Adds roughly 1.5-2 GB.
|
|
RUN curl -fsSL https://apt.devkitpro.org/install-devkitpro-pacman -o /tmp/install-devkitpro-pacman \
|
|
&& chmod +x /tmp/install-devkitpro-pacman \
|
|
&& yes | /tmp/install-devkitpro-pacman \
|
|
&& dkp-pacman -S --noconfirm gamecube-dev \
|
|
&& dkp-pacman -Scc --noconfirm \
|
|
&& rm -f /tmp/install-devkitpro-pacman
|
|
|
|
ENV DEVKITPRO=/opt/devkitpro
|
|
ENV DEVKITPPC=/opt/devkitpro/devkitPPC
|
|
ENV PATH="$DEVKITPPC/bin:$DEVKITPRO/tools/bin:$PATH"
|
|
|
|
# Same /etc/profile PATH-reset problem as the venv above: login shells drop the
|
|
# ENV PATH, and devkitPro's Makefiles resolve $(DEVKITPPC)/bin from the
|
|
# environment, so export all three for login shells too.
|
|
RUN printf 'export DEVKITPRO=/opt/devkitpro\nexport DEVKITPPC=/opt/devkitpro/devkitPPC\nPATH="$DEVKITPPC/bin:$DEVKITPRO/tools/bin:$PATH"\nexport PATH\n' \
|
|
> /etc/profile.d/20-devkitpro.sh
|
|
|
|
RUN useradd -m -u 1000 -s /bin/bash vscode \
|
|
&& echo 'vscode ALL=(ALL) NOPASSWD:ALL' > /etc/sudoers.d/vscode \
|
|
&& chmod 0440 /etc/sudoers.d/vscode
|
|
|
|
USER vscode
|
|
|
|
# KiCad global library tables (copied from the installed templates) so kicad-cli
|
|
# can run the library-parity DRC/ERC checks. Without these, every standard
|
|
# footprint/symbol reports "library not configured". KiCad's built-in defaults
|
|
# resolve the ${KICAD10_*_DIR} paths inside the templates, so no env vars needed.
|
|
RUN mkdir -p /home/vscode/.config/kicad/10.0 \
|
|
&& cp /usr/share/kicad/template/fp-lib-table /home/vscode/.config/kicad/10.0/fp-lib-table \
|
|
&& cp /usr/share/kicad/template/sym-lib-table /home/vscode/.config/kicad/10.0/sym-lib-table
|
|
|
|
WORKDIR /workspace
|