Repository navigation
Releases
v0.4.9
[0.4.9] - 2026-06-27
On-silicon HIL bring-up surfaced six peripheral-model divergences (issues #2–#7,
"modelled as X but silicon does Y"); this release aligns the models to silicon.
Changed
- DMA / TIMER / SDMA device models aligned to WS63 silicon:
- M_DMA (#5): a transfer now also starts on the global channel-enable
registerDMAC_EN_CHNS(DesignWare-style), and the channel's bit auto-clears
on single-block completion — the start/done path the vendor HAL and
silicon-faithful drivers use. TheCHN_CONFIG.ch_enablestart path is kept
for compatibility. - TIMER_V150
CURRENT_VALUE(#6): now a latch refreshed by the
cnt_req/cnt_lockhandshake (CONTROL bits 5/6), not a live counter — a raw
read without the handshake returns the stale snapshot, matching silicon (and
the vendor HAL, which always does the handshake). - SDMA (#7): the secure DMA (
0x520A_0000) is modelled as unprovisioned —
a transfer there never runs or completes (it would stall AXI and hang the bus
on silicon) and warns loudly. Vendor mem→mem always uses the primary M_DMA.
- M_DMA (#5): a transfer now also starts on the global channel-enable
- Flash-clock-from-XIP hazard reproduced (#4): switching the flash clock
(CLDO_CRG_CLK_SELbit 18) while the CPU executes XIP from flash now disables
the flash XIP window so the next instruction fetch faults — reproducing the
silicon crash (SFC XIP timing invalidated → core + RISC-V DM hang) instead of
QEMU's false green. flashboot switches the flash clock from ITCM, so it is
unaffected.
Added
- UART / clock diagnostics (#2, #3): the effective UART baud is logged on
divider writes, andCLDO_CRG_CLK_SELwrites note that clocks are modelled at
nominal (post-clock_init) rates — surfacing the wrong-clock/baud hazards QEMU
cannot otherwise reproduce. The clock-tree-at-nominal boundary (TCG does not
model CPU frequency; the chardev is not rate-limited; the PLL is locked by the
boot ROM that-kernelskips) is documented indocs/explanation/limitations.md
§6 (issue #3 closed as not planned). - New register-level qtests (
timer_current_latch,dma_en_chns_start,
sdma_unprovisioned) and a smoke firmware (xip_flash_clk_hazard, from
ws63-examples) covering the above.
WS63 / BS2X QEMU emulator (-M ws63, -M bs21, -M bs21e, -M bs22, -M bs20)
qemu-system-riscv32 (fork of QEMU v10.0.0) with the HiSilicon
WS63 / BS2X machine models and the xlinx custom RISC-V ISA, so
unmodified vendor-compiled firmware runs without hardware.
Per-host downloads (runnable, libs bundled)
| Host | Asset |
|---|---|
| Linux x86_64 | hisi-riscv-qemu-x86_64-linux.tar.gz |
| Linux aarch64 | hisi-riscv-qemu-aarch64-linux.tar.gz |
| macOS (Apple Silicon) | hisi-riscv-qemu-aarch64-darwin.tar.gz |
| Windows x86_64 | hisi-riscv-qemu-x86_64-windows.zip (experimental) |
Legacy qemu-system-riscv32-ws63-* (raw Ubuntu x86_64 binary) and the
OS-independent ws63-qemu-src-*.tar.gz source bundle (rebuild any host via
scripts/build.sh; this is how Intel-mac users build) are also attached.
macOS: binaries are unsigned — clear quarantine after extracting:
xattr -dr com.apple.quarantine hisi-riscv-qemu-aarch64-darwin/
Run
./qemu-system-riscv32 -M ws63 -nographic -serial mon:stdio -kernel <firmware.elf>
📖 Documentation: https://hispark-rs.github.io/hisi-riscv-qemu/
What's Changed
- hw/riscv/ws63: align DMA/timer/SDMA to silicon + clock diagnostics (issues #2-#7) by @sanchuanhehe in #19
- docs(limitations): document the clock-tree-at-nominal boundary (issue #3) by @sanchuanhehe in #20
- hw/riscv/ws63: fully model the issue-#4 flash-clock-from-XIP hazard by @sanchuanhehe in #21
- Release v0.4.9 — HIL device-model alignment (issues #2-#7) by @sanchuanhehe in #22
Full Changelog: v0.4.8...v0.4.9
v0.4.8
[0.4.8] - 2026-06-27
This section consolidates everything notable since v0.3.0: the intermediate
v0.4.0–v0.4.7 tags shipped without their own changelog sections, so their
changes are archived here. v0.4.8 is also the first release whose notes are
generated from this changelog.
Added
-M bs21— HiSilicon BS21 / BS2X machine (multi-chip family, milestone 1).
BS21 is a BLE 5.4 + SLE (NearLink) SoC, no Wi-Fi, on the same HiSilicon
"HimiDeer" riscv31 core as WS63 (identical LOCI interrupt architecture + custom
CSRs, identical UART v151 / TIMER v150 / GPIO v150 IP). So the newbs21.c
machine reuses ws63.c's device models in place — exposed via a new shared
headerhw/riscv/hisi_riscv31.h(the WS63 INTC/UART/TIMER/GPIO/TCXO type namesws63_make_ram/ws63_register_custom_csrs/ws63_intc_set_cpu_env) — at
BS21's own memory map + base addresses + IRQ numbers (docs/bs21-recon.md, from
the fbb_bs2x SDK).CONFIG_BS21(Kconfig + meson, patch000N-...bs21...)
selectsCONFIG_WS63so the shared models compile in;build.shcopies
bs21.c+hisi_riscv31.h. M1 firmware (ws63-rsbs21-examples/{blinky, uart_hello},--features chip-bs21) emits only standard RV32IMFC and never
calls the mask ROM, so this machine needs neither the HiSilicon custom-ISA
decoder nor ROM interception (both deferred with connectivity). Validated
on v10.0.0:scripts/bs21-smoke-test.shboots both examples (UART0 @ 0x52081000
banner; GPIO0 @ 0x57010000 toggle, 0 illegal-instruction traps). WS63 unchanged
—-M ws63boots + all 5 qtests still pass. The full family split (shared models
→hisi_riscv31.cunderCONFIG_HISI_RISCV31, ROM-ABI machine callback, and the
hisi-riscv31CPU rename) is deferred to the connectivity-generalization pass.
- Phase 1 test/dev infrastructure complete (ROADMAP §1):
- qtest (
tests/qtest/ws63-test.c, run viascripts/qtest.sh, in CI) — a
register-level, boot-free regression that drives the GPIO/UART/timer/INTC/DMA
models directly over MMIO via libqtest. 4 cases: GPIO DATA set/clr/OEN/INT-EN
read-back; UART FIFO/line-status reset values; timer load/enable/fire with
delivery into the INTC (IRQ 26, observed viaqtest_irq_intercept_in); DMA
channel-0 mem→mem block copy + raw completion status. Injected + meson-registered
byscripts/build.sh. -cpu ws63named CPU (target/riscvpatch): RV32IMFC_Zicsr + Zcf, no A/D,
no MMU, Zcb/Zcmp deliberately disabled (the xlinx custom code-size insns own that
compressed encoding). It is now the machine'sdefault_cpu_type, so machine init
no longer pokes the configurable CPU's per-letter properties — which also makes the
machine initialise under-accel qtest(that accel doesn't expose those properties).- Semihosting pass/fail —
scripts/run.sh SEMIHOST=1adds-semihosting; the
ws63-rssemihost_selftestexample reports its result via the RISC-V semihosting
SYS_EXIT_EXTENDEDexit code (andSYS_WRITE0console), so CI gets pass/fail
without scraping UART (scripts/smoke-test.shasserts exit code 0). - GPIO/DMA trace events — the temporary GPIO
qemu_logcalls became proper
hw/riscv/trace-eventsevents (ws63_gpio_set/ws63_gpio_clr/ws63_dma_xfer),
enabled selectively with-d trace:ws63_gpio_*.build.shappends them to the
upstreamhw/riscv/trace-events;smoke-test.sh's blinky check uses them.
- qtest (
- System-reset model (SYS_CTL0 handler). GLB_CTL_M's chip-reset trigger
(0x40002110bit 2) now issuesqemu_system_reset_request, and the reset-reason
history record (SYS_RST_RECORD_0@0x400000A0, cleared viaSYS_DIAG_CLR_1@
0x400000A4) is modelled with a host-side record that survives the guest reset —
so firmware reads back "software reset" on the next boot. Mirrors fbb_ws63
reboot_porting.c. Validates the ws63-rsSystem::software_reset/reset_reason
rewrite: the newreset_demoexample round-trips cold-boot → reset → Software, and
scripts/smoke-test.shasserts it (CI now builds all default-member examples). - Connectivity base (ROADMAP §5): synthetic Wi-Fi/Ethernet MAC (
ws63-netmac
@ 0x44210000, IRQ 45) bridging the ws63-rf-rs netif seam to a host netdev via
SLIRP (--enable-slirp,libslirp-dev); no RF/PHY. qtest/ws63/netmacdoes a
real frame round-trip; the ws63-rsnet_pingexample ARP/ICMP/UDPs over the
SLIRP NAT;scripts/smoke-test.shassertsNET PING: PASS. - qtest matrix (
.github/workflows/qtest-matrix.yml): runs the register-level
qtest across every supported QEMU version (required) plus the newest stable
(experimental forward-compat radar). Weekly cron. - Documentation site (mdBook). The
docs/tree is published to GitHub Pages
at https://hispark-rs.github.io/hisi-riscv-qemu/, built and deployed by
.github/workflows/mdbook.ymlon every push tomaster. - Documentation CI.
docs.ymlvalidates internal links / anchors / Diátaxis
layout / orphan pages / H1 viascripts/check-docs.pyplus markdownlint;
link-check.ymlruns a weekly lychee external-URL check.
Changed
- Rebased to QEMU v10.0.0 (default; up from v9.2.4) and migrated the
injection to a per-versiongit format-patchseries underpatches/<QEMU_TAG>/,
replacing the singlews63-target-riscv.patch+ the sed/cat-append hooks in
scripts/build.sh. New files (ws63.c, the xlinx decoder, the qtest) are copied
fromsrc/; edits to existing QEMU files are the series (0001target/riscv,
0002machine registration,0003qtest registration; older versions add a
0004compat patch for the copiedws63.c). v9.2.4, v10.0.0, v10.2.3, and
v11.0.1 are maintained — each verified to apply, build, and pass qtest 5/5
(v10.x + v11 additionally pass the C-SDK suite). API drift handled per version:
v10.0sysemu/→system/headers andconstProperty[](no terminator); v10.2
insn_len→internals.h, declarativeDEFINE_RISCV_CPU, table-driven
decode_opc,CharBackend→CharFrontend,exec/→system/address-spaces.h;
v11 sixhw/*.h→hw/core/*.h. Theqtest-matrixnow has all four versions
green; the forward radar will point at the next QEMU release. See
patches/README.md. - Documentation reorganized into the Diátaxis four
quadrants (tutorials / how-to / reference / explanation) with a documentation
map; the previous combined user-manual / design docs were split by quadrant. - Release notes are now generated from this changelog. The release workflow
extracts the matching## [x.y.z]section and prepends it to the per-host
download notes (still followed by GitHub's auto-generated PR list).
Fixed
- SPI WSR status layout (
ws63.c): the SPI status register (0xE4) now returns
the HiSilicon SSI v151 silicon layout —txfnf=bit11,txfe=bit12,rxfne=bit4
(idle0x1800) — instead of the textbook DesignWare packing (txfnf=1/txfe=2/
rxfne=3, idle0x6). The silicon (vendorhal_spi_v151_regs_def.h
spi_wsr_data) spreads these flags out, andws63-pac'sSPI_WSRwas corrected
to match (2026-06-14, after the on-silicon SPI0 loopback bring-up); the old QEMU
value made a PAC-correct driver polltxfnfat bit 11 = 0 and time out. QEMU is
not the reference — this realigns the model to silicon so SPI firmware runs under
both. No qtest covers SPI yet, so no test change. - QEMU v11.0 upstream regression in RV32
mcycleh/minstreth
(patches/v11.0.1/0005): v11'sriscv_pmu_read_ctr()slices the high/low half
ofctr_prev/ctr_valfor an RV32 fixed counter but reads the fixed-counter
value (cpu_get_host_ticks()) un-sliced, so the upper-half read returns the
low 32 bits — which change every read. Firmware doing the standard atomic
64-bit cycle read (csrr hi,mcycleh; csrr lo,mcycle; csrr hi2,mcycleh; bne)
never converges and spins forever (ws63-rsrf_port_demohung after
osal_kmallocon v11; fine on v9.2.4/v10.0.0/v10.2.3, which sliced internally).
Fix slices the fixed-counter value with the sameextract64. v11 firmware
smoke-test 16/17 → 17/17. A generic upstream fix, worth reporting to QEMU. scripts/build.shre-applies the patch-series deterministically. It now
resets the patched upstream files to the pinned tag and replays the whole
series every run. Previously the apply step was gated on a single marker, so a
CI cache hit — which re-copies the overlay sources pristine — skipped it and the
re-copiedws63.c/bs2x.clost their per-versionhw/core/+system/
include rewrites, failing theqtest-matrixnon-default-pin builds.- macOS / Apple clang builds of the 10.2+ pins. QEMU 10.2 made the QOM
class_initdata pointerconstand added auintptr_t raparameter to
riscv_csr_write_fn— warnings under gcc (--disable-werror) but hard errors
under Apple clang. The overlay sources now version-alias both shapes via
QEMU_VERSION_*, sov10.2.3/v11.0.1build under Apple clang too.
WS63 / BS2X QEMU emulator (-M ws63, -M bs21, -M bs21e, -M bs22, -M bs20)
qemu-system-riscv32 (fork of QEMU v10.0.0) with the HiSilicon
WS63 / BS2X machine models and the xlinx custom RISC-V ISA, so
unmodified vendor-compiled firmware runs without hardware.
Per-host downloads (runnable, libs bundled)
| Host | Asset |
|---|---|
| Linux x86_64 | hisi-riscv-qemu-x86_64-linux.tar.gz |
| Linux aarch64 | hisi-riscv-qemu-aarch64-linux.tar.gz |
| macOS (Apple Silicon) | hisi-riscv-qemu-aarch64-darwin.tar.gz |
| Windows x86_64 | hisi-riscv-qemu-x86_64-windows.zip (experimental) |
Legacy qemu-system-riscv32-ws63-* (raw Ubuntu x86_64 binary) and the
OS-independent ws63-qemu-src-*.tar.gz source bundle (rebuild any host via
scripts/build.sh; this is how Intel-mac users build) are also ...
v0.4.7
WS63 / BS2X QEMU emulator (-M ws63, -M bs21, -M bs21e, -M bs22, -M bs20)
qemu-system-riscv32 (fork of QEMU v10.0.0) with the HiSilicon
WS63 / BS2X machine models and the xlinx custom RISC-V ISA, so
unmodified vendor-compiled firmware runs without hardware.
Per-host downloads (runnable, libs bundled)
| Host | Asset |
|---|---|
| Linux x86_64 | hisi-riscv-qemu-x86_64-linux.tar.gz |
| Linux aarch64 | hisi-riscv-qemu-aarch64-linux.tar.gz |
| macOS (Apple Silicon) | hisi-riscv-qemu-aarch64-darwin.tar.gz |
| Windows x86_64 | hisi-riscv-qemu-x86_64-windows.zip (experimental) |
Legacy qemu-system-riscv32-ws63-* (raw Ubuntu x86_64 binary) and the
OS-independent ws63-qemu-src-*.tar.gz source bundle (rebuild any host via
scripts/build.sh; this is how Intel-mac users build) are also attached.
macOS: binaries are unsigned — clear quarantine after extracting:
xattr -dr com.apple.quarantine hisi-riscv-qemu-aarch64-darwin/
Run
./qemu-system-riscv32 -M ws63 -nographic -serial mon:stdio -kernel <firmware.elf>
What's Changed
- docs: reorganize into Diátaxis + docs CI, deps detail, QEMU links by @sanchuanhehe in #8
- docs: update renamed repo URLs (ws63-* → hisi-riscv-*) by @sanchuanhehe in #9
- docs(getting-started): clone into renamed dirs, sync paths by @sanchuanhehe in #10
- docs(tutorials): split getting-started into install + first-run by @sanchuanhehe in #11
- docs: align toolchain install with upstream + note rustup prerequisite by @sanchuanhehe in #12
- docs: reference fbb_ws63-qemu for C firmware + surface prebuilt binary in onboarding by @sanchuanhehe in #13
- fix(build): re-apply patch-series deterministically (fix qtest-matrix) by @sanchuanhehe in #14
- fix(macos): build 10.2+ pins under Apple clang (const class_init, CSR ra) by @sanchuanhehe in #15
- docs: deploy docs as an mdBook site on GitHub Pages by @sanchuanhehe in #16
- docs(mdbook): clickable section landing pages + fix link-check race by @sanchuanhehe in #17
Full Changelog: v0.4.6...v0.4.7
v0.4.6
WS63 / BS2X QEMU emulator (-M ws63, -M bs21, -M bs21e, -M bs22, -M bs20)
qemu-system-riscv32 (fork of QEMU v10.0.0) with the HiSilicon
WS63 / BS2X machine models and the xlinx custom RISC-V ISA, so
unmodified vendor-compiled firmware runs without hardware.
Per-host downloads (runnable, libs bundled)
| Host | Asset |
|---|---|
| Linux x86_64 | hisi-riscv-qemu-x86_64-linux.tar.gz |
| Linux aarch64 | hisi-riscv-qemu-aarch64-linux.tar.gz |
| macOS (Apple Silicon) | hisi-riscv-qemu-aarch64-darwin.tar.gz |
| Windows x86_64 | hisi-riscv-qemu-x86_64-windows.zip (experimental) |
Legacy qemu-system-riscv32-ws63-* (raw Ubuntu x86_64 binary) and the
OS-independent ws63-qemu-src-*.tar.gz source bundle (rebuild any host via
scripts/build.sh; this is how Intel-mac users build) are also attached.
macOS: binaries are unsigned — clear quarantine after extracting:
xattr -dr com.apple.quarantine hisi-riscv-qemu-aarch64-darwin/
Run
./qemu-system-riscv32 -M ws63 -nographic -serial mon:stdio -kernel <firmware.elf>
Full Changelog: v0.4.5...v0.4.6
v0.4.5
WS63 / BS2X QEMU emulator (-M ws63, -M bs21, -M bs21e, -M bs22, -M bs20)
qemu-system-riscv32 (fork of QEMU v10.0.0) with the HiSilicon
WS63 / BS2X machine models and the xlinx custom RISC-V ISA, so
unmodified vendor-compiled firmware runs without hardware.
Per-host downloads (runnable, libs bundled)
| Host | Asset |
|---|---|
| Linux x86_64 | hisi-riscv-qemu-x86_64-linux.tar.gz |
| Linux aarch64 | hisi-riscv-qemu-aarch64-linux.tar.gz |
| macOS (Apple Silicon) | hisi-riscv-qemu-aarch64-darwin.tar.gz |
| Windows x86_64 | hisi-riscv-qemu-x86_64-windows.zip (experimental) |
Legacy qemu-system-riscv32-ws63-* (raw Ubuntu x86_64 binary) and the
OS-independent ws63-qemu-src-*.tar.gz source bundle (rebuild any host via
scripts/build.sh; this is how Intel-mac users build) are also attached.
macOS: binaries are unsigned — clear quarantine after extracting:
xattr -dr com.apple.quarantine hisi-riscv-qemu-aarch64-darwin/
Run
./qemu-system-riscv32 -M ws63 -nographic -serial mon:stdio -kernel <firmware.elf>
Full Changelog: v0.4.4...v0.4.5
v0.4.4
WS63 / BS2X QEMU emulator (-M ws63, -M bs21, -M bs21e, -M bs22, -M bs20)
qemu-system-riscv32 (fork of QEMU v10.0.0) with the HiSilicon
WS63 / BS2X machine models and the xlinx custom RISC-V ISA, so
unmodified vendor-compiled firmware runs without hardware.
Per-host downloads (runnable, libs bundled)
| Host | Asset |
|---|---|
| Linux x86_64 | hisi-riscv-qemu-x86_64-linux.tar.gz |
| Linux aarch64 | hisi-riscv-qemu-aarch64-linux.tar.gz |
| macOS (Apple Silicon) | hisi-riscv-qemu-aarch64-darwin.tar.gz |
| Windows x86_64 | hisi-riscv-qemu-x86_64-windows.zip (experimental) |
Legacy qemu-system-riscv32-ws63-* (raw Ubuntu x86_64 binary) and the
OS-independent ws63-qemu-src-*.tar.gz source bundle (rebuild any host via
scripts/build.sh; this is how Intel-mac users build) are also attached.
macOS: binaries are unsigned — clear quarantine after extracting:
xattr -dr com.apple.quarantine hisi-riscv-qemu-aarch64-darwin/
Run
./qemu-system-riscv32 -M ws63 -nographic -serial mon:stdio -kernel <firmware.elf>
Full Changelog: v0.4.3...v0.4.4
v0.4.3
WS63 / BS2X QEMU emulator (-M ws63, -M bs21, -M bs21e, -M bs22, -M bs20)
qemu-system-riscv32 (fork of QEMU v10.0.0) with the HiSilicon
WS63 / BS2X machine models and the xlinx custom RISC-V ISA, so
unmodified vendor-compiled firmware runs without hardware.
Per-host downloads (runnable, libs bundled)
| Host | Asset |
|---|---|
| Linux x86_64 | hisi-riscv-qemu-x86_64-linux.tar.gz |
| Linux aarch64 | hisi-riscv-qemu-aarch64-linux.tar.gz |
| macOS (Apple Silicon) | hisi-riscv-qemu-aarch64-darwin.tar.gz |
| Windows x86_64 | hisi-riscv-qemu-x86_64-windows.zip (experimental) |
Legacy qemu-system-riscv32-ws63-* (raw Ubuntu x86_64 binary) and the
OS-independent ws63-qemu-src-*.tar.gz source bundle (rebuild any host via
scripts/build.sh; this is how Intel-mac users build) are also attached.
macOS: binaries are unsigned — clear quarantine after extracting:
xattr -dr com.apple.quarantine hisi-riscv-qemu-aarch64-darwin/
Run
./qemu-system-riscv32 -M ws63 -nographic -serial mon:stdio -kernel <firmware.elf>
Full Changelog: v0.4.2...v0.4.3
v0.4.2
WS63 / BS2X QEMU emulator (-M ws63, -M bs21, -M bs21e, -M bs22, -M bs20)
qemu-system-riscv32 (fork of QEMU v10.0.0) with the HiSilicon
WS63 / BS2X machine models and the xlinx custom RISC-V ISA, so
unmodified vendor-compiled firmware runs without hardware.
Per-host downloads (runnable, libs bundled)
| Host | Asset |
|---|---|
| Linux x86_64 | hisi-riscv-qemu-x86_64-linux.tar.gz |
| Linux aarch64 | hisi-riscv-qemu-aarch64-linux.tar.gz |
| macOS (Apple Silicon) | hisi-riscv-qemu-aarch64-darwin.tar.gz |
| Windows x86_64 | hisi-riscv-qemu-x86_64-windows.zip (experimental) |
Legacy qemu-system-riscv32-ws63-* (raw Ubuntu x86_64 binary) and the
OS-independent ws63-qemu-src-*.tar.gz source bundle (rebuild any host via
scripts/build.sh; this is how Intel-mac users build) are also attached.
macOS: binaries are unsigned — clear quarantine after extracting:
xattr -dr com.apple.quarantine hisi-riscv-qemu-aarch64-darwin/
Run
./qemu-system-riscv32 -M ws63 -nographic -serial mon:stdio -kernel <firmware.elf>
Full Changelog: v0.4.1...v0.4.2
v0.4.1
WS63 / BS2X QEMU emulator (-M ws63, -M bs21, -M bs21e, -M bs22, -M bs20)
qemu-system-riscv32 (fork of QEMU v10.0.0) with the HiSilicon
WS63 / BS2X machine models and the xlinx custom RISC-V ISA, so
unmodified vendor-compiled firmware runs without hardware.
Per-host downloads (runnable, libs bundled)
| Host | Asset |
|---|---|
| Linux x86_64 | hisi-riscv-qemu-x86_64-linux.tar.gz |
| Linux aarch64 | hisi-riscv-qemu-aarch64-linux.tar.gz |
| macOS (Apple Silicon) | hisi-riscv-qemu-aarch64-darwin.tar.gz |
| Windows x86_64 | hisi-riscv-qemu-x86_64-windows.zip (experimental) |
Legacy qemu-system-riscv32-ws63-* (raw Ubuntu x86_64 binary) and the
OS-independent ws63-qemu-src-*.tar.gz source bundle (rebuild any host via
scripts/build.sh; this is how Intel-mac users build) are also attached.
macOS: binaries are unsigned — clear quarantine after extracting:
xattr -dr com.apple.quarantine hisi-riscv-qemu-aarch64-darwin/
Run
./qemu-system-riscv32 -M ws63 -nographic -serial mon:stdio -kernel <firmware.elf>
Full Changelog: v0.4.0...v0.4.1
v0.4.0
WS63 / BS2X QEMU emulator (-M ws63, -M bs21, -M bs21e, -M bs22, -M bs20)
qemu-system-riscv32 (fork of QEMU v10.0.0) with the HiSilicon
WS63 / BS2X machine models and the xlinx custom RISC-V ISA, so
unmodified vendor-compiled firmware runs without hardware.
Per-host downloads (runnable, libs bundled)
| Host | Asset |
|---|---|
| Linux x86_64 | hisi-riscv-qemu-x86_64-linux.tar.gz |
| Linux aarch64 | hisi-riscv-qemu-aarch64-linux.tar.gz |
| macOS (Apple Silicon) | hisi-riscv-qemu-aarch64-darwin.tar.gz |
| Windows x86_64 | hisi-riscv-qemu-x86_64-windows.zip (experimental) |
Legacy qemu-system-riscv32-ws63-* (raw Ubuntu x86_64 binary) and the
OS-independent ws63-qemu-src-*.tar.gz source bundle (rebuild any host via
scripts/build.sh; this is how Intel-mac users build) are also attached.
macOS: binaries are unsigned — clear quarantine after extracting:
xattr -dr com.apple.quarantine hisi-riscv-qemu-aarch64-darwin/
Run
./qemu-system-riscv32 -M ws63 -nographic -serial mon:stdio -kernel <firmware.elf>
Full Changelog: v0.3.0...v0.4.0