Skip to content

docs: add Goban multi-core documentation and sync recent GemminiBall updates#2

Draft
cursor[bot] wants to merge 4 commits intomainfrom
cursor/buckyball-documentation-sync-e6b6
Draft

docs: add Goban multi-core documentation and sync recent GemminiBall updates#2
cursor[bot] wants to merge 4 commits intomainfrom
cursor/buckyball-documentation-sync-e6b6

Conversation

@cursor
Copy link
Contributor

@cursor cursor bot commented Mar 17, 2026

Address documentation gaps identified in PR review:

Added:

  • Comprehensive Goban Multi-Core Architecture guide (en/zh):
    • Multi-core BBTile design with SPMD execution
    • BarrierUnit synchronization primitives
    • Barrier-based test examples (barrier_test, barrier_mvin_test)
    • Configuration variants: BuckyballGobanConfig, BuckyballGoban2TileConfig
    • Multi-core programming patterns and hart ID usage

Updated:

  • GemminiBall Architecture documentation (en/zh):
    • Document funct7 field partitioning: [6:4] = bank enable, [3:0] = opcode
    • Add new operations: IM2COL, TRANSPOSE, RELU, QUANT, DEQUANT, MATMUL_WARP16
    • Reference loop unroller enhancements (LoopMatmulUnroller, LoopConvUnroller)
    • Update instruction table with new funct7 encoding scheme from recent commits

Files modified:

  • content/en/Guide/Goban Multi-Core Architecture.md (new)
  • content/zh/Guide/Goban Multi-Core Architecture.md (new)
  • content/en/Guide/GemminiBall Architecture.md (updated)
  • content/zh/Guide/GemminiBall Architecture.md (updated)
Open in Web View Automation 

cursoragent and others added 4 commits March 17, 2026 21:43
- Add GemminiBall Architecture guide: instruction routing, funct7 encoding, configuration and execution paths
- Add Verilator Simulation and CI guide: clock handling improvements, memory configuration, test execution
- Add Development Workflow and Build System guide: Nix setup, bbdev tool usage, common tasks
- Update .order.json to include new Guide section
- Sync both English and Chinese documentation

Co-authored-by: Shiroha <whmio0115@gmail.com>
… GemminiBall enhancements

- Add comprehensive Goban documentation (en and zh) covering:
  - Multi-core BBTile architecture and synchronization primitives
  - BarrierUnit hardware synchronization support
  - SPMD programming model with examples
  - Configuration variants (1-tile, 2-tile)
  - Test workloads (barrier tests)

- Update GemminiBall Architecture documentation (en and zh):
  - Document funct7 encoding with bank enable bits [6:4]
  - Add new instructions: IM2COL, TRANSPOSE, RELU, QUANT, DEQUANT, MATMUL_WARP16
  - Clarify loop configuration and execution paths
  - Reference recent loop unroller enhancements

Addresses missing Goban documentation reported in PR comments.

Co-authored-by: Shiroha <whmio0115@gmail.com>
…ion info

- Add Goban configuration options (BuckyballGobanVerilatorConfig, BuckyballGoban2TileVerilatorConfig)
- Include example Goban barrier test command
- Add reference link to Goban Multi-Core Architecture documentation
- Update both en and zh versions

Co-authored-by: Shiroha <whmio0115@gmail.com>
- Add Architecture & Key Concepts section in both en and zh Overview
- Document core components: Ball, Blink, BBTile, BarrierUnit
- Reference Toy and Goban configuration models
- Add Goban barrier test example to Quick Start
- Link to detailed architecture guides (ISA, GemminiBall, Goban)

Co-authored-by: Shiroha <whmio0115@gmail.com>
@shirohasuki
Copy link
Member

Have not checks have been carried out to ensure that recent commits have not rendered parts of the existing documentation out of date, like Building Your Own Hardware Designs.md and Buckyball ISA.md

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants