원클릭으로 Manus에서 모든 스킬 실행

flash

스타70

포크10

업데이트2026년 7월 11일 04:11

Flash an A2FPGA board's FPGA BITSTREAM (the .fs gateware) with openFPGALoader. Use when the user asks to flash, program, upload, load, or deploy a BITSTREAM/gateware to a board (a2mega, a2n20v2, a2n20v2-GS, a2n20v2-Enhanced, a2p25, a2n9, a2n20v1). NOT for the a2n20v2-Enhanced BL616 MCU/microcontroller FIRMWARE — for that use the `flash-mcu` skill (different tool, different chip; using this one would not touch the BL616).

설치

Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.

Manus에서 실행

출처

a2fpga

a2fpga/a2fpga_core

GitHub 저장소 열기 Creator 저장소 보기

다운로드

Manus에서 실행

Flash an A2FPGA board

Programs a board's bitstream with openFPGALoader, using the correct cable/board config per board. Wraps tools/flash.sh (humans run the same script directly).

Flashing is a real, outward action on hardware — confirm the board and that a device is connected before running, unless the user already said to go ahead.

Steps

Determine the board. If unspecified, ask. See docs/boards.md.
Confirm a bitstream exists. The script flashes boards/<board>/impl/pnr/<proj>.fs. If it's missing, build first with the build skill (tools/build.sh <board>).

Preview, then flash. To show the exact command without running it:

DRY_RUN=1 tools/flash.sh <board>

Then flash:

tools/flash.sh <board>          # write to persistent SPI flash (default)
tools/flash.sh <board> --sram   # load to volatile SRAM (lost on power-down; for quick test)

Per-board programming config (handled by the script)

Board(s)	openFPGALoader
a2n20v1, a2n20v2, a2n20v2-GS, a2n20v2-Enhanced (Tang Nano 20K)	`-b tangnano20k`
a2n9 (Tang Nano 9K)	`-b tangnano9k`
a2mega (Tang Mega 60K), a2p25 (Tang Primer 25K)	`-c esp32s3` (on-board ESP32S3; flash adds `--bulk-erase -f`)

Notes

a2mega (DDR3): power-cycle the board between flashes. Reprogramming without a power cycle can fail DDR3 init and produce a black screen that looks like a logic bug, not a programming failure. The script prints this reminder. See docs/gotchas.md.
Loader install (macOS): brew install openfpgaloader.
a2mega, indeterminate/corrupt flash state (a write errored or was interrupted; FPGA no longer configures at power-on; flash ops fail with "Read ID failed"): do NOT iterate on writes. Bulk-erase first at low speed — openFPGALoader -c esp32s3 --freq 500000 --bulk-erase — then replug and flash normally. The flash phase's default 10 MHz JTAG clock does not work on this board; 500 kHz does. Full recipe: docs/gotchas.md.

이 저장소의 다른 Skills

같은 저장소

setup

a2fpga/a2fpga_core

First-run environment setup for the A2FPGA project — detect which build/flash toolchains are installed (Gowin, openFPGALoader, BL616 firmware, ESP32 firmware) and guide installing the missing ones. Use when a new user or agent is getting started, has just cloned the repo, or asks to set up / check the build environment.

2026-06-2070

flash-mcu

a2fpga/a2fpga_core

Flash the BL616 MCU firmware on the a2n20v2-Enhanced board (Tang Nano 20K) using the a2n20-mcu-program tool. Use when the user asks to flash, program, upload, or update the BL616 / MCU / microcontroller firmware (the FT2232 device build or the USB-host XInput build) — NOT the FPGA bitstream (use the `flash` skill for that).

2026-06-2070

build

a2fpga/a2fpga_core

Build (synthesize + place & route) an A2FPGA FPGA board with the Gowin gw_sh CLI and verify timing. Use when the user asks to build, synthesize, compile, run PnR, or generate a bitstream for a board (a2mega, a2n20v2, a2n20v2-GS, a2n20v2-Enhanced, a2p25, a2n9, a2n20v1).

2026-06-1470

name

flash

description

Flash an A2FPGA board

Programs a board's bitstream with openFPGALoader, using the correct cable/board config per board. Wraps tools/flash.sh (humans run the same script directly).

Flashing is a real, outward action on hardware — confirm the board and that a device is connected before running, unless the user already said to go ahead.

Steps

Determine the board. If unspecified, ask. See docs/boards.md.
Confirm a bitstream exists. The script flashes boards/<board>/impl/pnr/<proj>.fs. If it's missing, build first with the build skill (tools/build.sh <board>).

Preview, then flash. To show the exact command without running it:

DRY_RUN=1 tools/flash.sh <board>

Then flash:

tools/flash.sh <board>          # write to persistent SPI flash (default)
tools/flash.sh <board> --sram   # load to volatile SRAM (lost on power-down; for quick test)

Per-board programming config (handled by the script)

Board(s)	openFPGALoader
a2n20v1, a2n20v2, a2n20v2-GS, a2n20v2-Enhanced (Tang Nano 20K)	`-b tangnano20k`
a2n9 (Tang Nano 9K)	`-b tangnano9k`
a2mega (Tang Mega 60K), a2p25 (Tang Primer 25K)	`-c esp32s3` (on-board ESP32S3; flash adds `--bulk-erase -f`)

Notes

a2mega (DDR3): power-cycle the board between flashes. Reprogramming without a power cycle can fail DDR3 init and produce a black screen that looks like a logic bug, not a programming failure. The script prints this reminder. See docs/gotchas.md.
Loader install (macOS): brew install openfpgaloader.
a2mega, indeterminate/corrupt flash state (a write errored or was interrupted; FPGA no longer configures at power-on; flash ops fail with "Read ID failed"): do NOT iterate on writes. Bulk-erase first at low speed — openFPGALoader -c esp32s3 --freq 500000 --bulk-erase — then replug and flash normally. The flash phase's default 10 MHz JTAG clock does not work on this board; 500 kHz does. Full recipe: docs/gotchas.md.