Skip to content

Releases

v0.4.9

Choose a tag to compare

@github-actions github-actions released this 27 Jun 15:35
f94e090

[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
      register DMAC_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. The CHN_CONFIG.ch_enable start path is kept
      for compatibility.
    • TIMER_V150 CURRENT_VALUE (#6): now a latch refreshed by the
      cnt_req/cnt_lock handshake (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.
  • Flash-clock-from-XIP hazard reproduced (#4): switching the flash clock
    (CLDO_CRG_CLK_SEL bit 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, and CLDO_CRG_CLK_SEL writes 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 -kernel skips) is documented in docs/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

Choose a tag to compare

@github-actions github-actions released this 27 Jun 11:28
7b5c49d

[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 new bs21.c
    machine reuses ws63.c's device models in place — exposed via a new shared
    header hw/riscv/hisi_riscv31.h (the WS63 INTC/UART/TIMER/GPIO/TCXO type names
    • ws63_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, patch 000N-...bs21...)
      selects CONFIG_WS63 so the shared models compile in; build.sh copies
      bs21.c + hisi_riscv31.h. M1 firmware (ws63-rs bs21-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.sh boots both examples (UART0 @ 0x52081000
      banner; GPIO0 @ 0x57010000 toggle, 0 illegal-instruction traps). WS63 unchanged
      — -M ws63 boots + all 5 qtests still pass. The full family split (shared models
      → hisi_riscv31.c under CONFIG_HISI_RISCV31, ROM-ABI machine callback, and the
      hisi-riscv31 CPU rename) is deferred to the connectivity-generalization pass.
  • Phase 1 test/dev infrastructure complete (ROADMAP §1):
    • qtest (tests/qtest/ws63-test.c, run via scripts/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 via qtest_irq_intercept_in); DMA
      channel-0 mem→mem block copy + raw completion status. Injected + meson-registered
      by scripts/build.sh.
    • -cpu ws63 named CPU (target/riscv patch): 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's default_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=1 adds -semihosting; the
      ws63-rs semihost_selftest example reports its result via the RISC-V semihosting
      SYS_EXIT_EXTENDED exit code (and SYS_WRITE0 console), so CI gets pass/fail
      without scraping UART (scripts/smoke-test.sh asserts exit code 0).
    • GPIO/DMA trace events — the temporary GPIO qemu_log calls became proper
      hw/riscv/trace-events events (ws63_gpio_set / ws63_gpio_clr / ws63_dma_xfer),
      enabled selectively with -d trace:ws63_gpio_*. build.sh appends them to the
      upstream hw/riscv/trace-events; smoke-test.sh's blinky check uses them.
  • System-reset model (SYS_CTL0 handler). GLB_CTL_M's chip-reset trigger
    (0x40002110 bit 2) now issues qemu_system_reset_request, and the reset-reason
    history record (SYS_RST_RECORD_0 @ 0x400000A0, cleared via SYS_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-rs System::software_reset / reset_reason
    rewrite: the new reset_demo example round-trips cold-boot → reset → Software, and
    scripts/smoke-test.sh asserts 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/netmac does a
    real frame round-trip; the ws63-rs net_ping example ARP/ICMP/UDPs over the
    SLIRP NAT; scripts/smoke-test.sh asserts NET 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.yml on every push to master.
  • Documentation CI. docs.yml validates internal links / anchors / Diátaxis
    layout / orphan pages / H1 via scripts/check-docs.py plus markdownlint;
    link-check.yml runs 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-version git format-patch series
    under patches/<QEMU_TAG>/,
    replacing the single ws63-target-riscv.patch + the sed/cat-append hooks in
    scripts/build.sh. New files (ws63.c, the xlinx decoder, the qtest) are copied
    from src/; edits to existing QEMU files are the series (0001 target/riscv,
    0002 machine registration, 0003 qtest registration; older versions add a
    0004 compat patch for the copied ws63.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.0 sysemu/→system/ headers and const Property[] (no terminator); v10.2
    insn_len→internals.h, declarative DEFINE_RISCV_CPU, table-driven
    decode_opc, CharBackend→CharFrontend, exec/→system/address-spaces.h;
    v11 six hw/*.h→hw/core/*.h. The qtest-matrix now 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
    (idle 0x1800) — instead of the textbook DesignWare packing (txfnf=1/txfe=2/
    rxfne=3, idle 0x6). The silicon (vendor hal_spi_v151_regs_def.h
    spi_wsr_data) spreads these flags out, and ws63-pac's SPI_WSR was corrected
    to match (2026-06-14, after the on-silicon SPI0 loopback bring-up); the old QEMU
    value made a PAC-correct driver poll txfnf at 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's riscv_pmu_read_ctr() slices the high/low half
    of ctr_prev/ctr_val for 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-rs rf_port_demo hung after
    osal_kmalloc on v11; fine on v9.2.4/v10.0.0/v10.2.3, which sliced internally).
    Fix slices the fixed-counter value with the same extract64. v11 firmware
    smoke-test 16/17 → 17/17. A generic upstream fix, worth reporting to QEMU.
  • scripts/build.sh re-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-copied ws63.c / bs2x.c lost their per-version hw/core/ + system/
    include rewrites, failing the qtest-matrix non-default-pin builds.
  • macOS / Apple clang builds of the 10.2+ pins. QEMU 10.2 made the QOM
    class_init data pointer const and added a uintptr_t ra parameter 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_*, so v10.2.3 / v11.0.1 build 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 ...

Read more

v0.4.7

Choose a tag to compare

@github-actions github-actions released this 27 Jun 11:14
274b87d

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

Choose a tag to compare

@github-actions github-actions released this 13 Jun 07:48

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

Choose a tag to compare

@github-actions github-actions released this 13 Jun 07:32

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

Choose a tag to compare

@github-actions github-actions released this 13 Jun 07:18

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

Choose a tag to compare

@github-actions github-actions released this 13 Jun 07:11

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

Choose a tag to compare

@github-actions github-actions released this 13 Jun 07:05

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

Choose a tag to compare

@github-actions github-actions released this 13 Jun 06:57

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

Choose a tag to compare

@github-actions github-actions released this 13 Jun 06:51

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