Skip to content

CoM260_Kit: add Buildroot test report - #399

Merged
DuoQilai merged 1 commit into
ruyisdk:mainfrom
DuoQilai:docs/k3-com260-kit-tests
Sep 20, 2026
Merged

DuoQilai merged 1 commit into
ruyisdk:mainfrom
DuoQilai:docs/k3-com260-kit-tests

Conversation

@DuoQilai

@DuoQilai DuoQilai commented Sep 14, 2026

Copy link
Copy Markdown
Collaborator

Welcome to Pull Request

Thank you for your contribution! Please refer to the contributing guidelines for more details.

If you are working on the support-matrix report

We appreciate your effort in improving the support matrix. To generate the SVG image locally, you can use:

python assets/generate_svgimage.py -p . -o assets/output --html https://${{ github.repository_owner }}.github.io/support-matrix

For internationalization (i18n) SVG generation test, simply add the -l zh option.

If you're creating a new report, please refer to our templates:

Checklist

  • SVG table generation passes successfully
  • Appropriate changes to documentation are included in the PR
  • i18n for documentation (optional)

If you are working on the assets toolchain

Fixes #<issue_number_goes_here>

We recommend opening an issue for discussion before making significant changes.

Checklist

  • Changes to workflow/codes are fully tested
  • Appropriate changes to documentation are included in the PR
  • This fixes an issue
  • New feature added

Summary by Sourcery

Add bilingual board information and a successful Buildroot support-matrix test report for the SpacemiT K3 CoM260 Kit.

New Features:

  • Add the SpacemiT K3 CoM260 Kit board profile with hardware specifications in English and Chinese.
  • Document successful Buildroot v1.0.7 installation and validation on the CoM260 Kit, including flashing, serial login, boot results, and Weston desktop verification.

Documentation:

  • Provide bilingual user-facing setup and test documentation for flashing Buildroot and accessing the CoM260 Kit over serial.

Tests:

  • Record a successful Buildroot test result for the 16GB RAM / 128GB storage CoM260 Kit configuration.

@sourcery-ai

sourcery-ai Bot commented Sep 14, 2026

Copy link
Copy Markdown

Reviewer's Guide

Adds a bilingual SpacemiT K3 CoM260 Kit board entry and a detailed Buildroot v1.0.7 test report, including reproducible flashing and serial-login instructions, successful boot evidence, version discrepancy documentation, and supporting images.

Sequence diagram for flashing and serial login on the CoM260 Kit

sequenceDiagram
    participant Host as Ubuntu host
    participant TITANTOOLS
    participant CoM260
    participant Serial as USB-to-TTL adapter

    Host->>TITANTOOLS: Launch TITANTOOLS
    Host->>CoM260: Short FC_REC to GND and apply DC power
    Host->>TITANTOOLS: Scan device and load Buildroot-K3-v1.0.7-20260819142006.zip
    TITANTOOLS->>CoM260: Flash image over USB
    Host->>CoM260: Power-cycle board
    Host->>Serial: Connect GND, UART_TXD to RXD, UART_RXD to TXD
    Host->>Serial: Start tio at 115200 baud
    Serial->>CoM260: Monitor boot output
    Host->>CoM260: Log in as root
Loading

Flow diagram for CoM260 Kit Buildroot installation and validation

flowchart LR
    Host[Ubuntu x86_64 host] --> Tool[TITANTOOLS]
    Tool -->|USB flashing| Board[CoM260 Kit]
    Board -->|DC power| Boot[Buildroot boots]
    Board -->|UART_TXD and UART_RXD| Serial[USB-to-TTL serial adapter]
    Serial --> Login[Serial login and system checks]
Loading

File-Level Changes

Change Details Files
Adds a complete Buildroot v1.0.7 validation report for the SpacemiT K3 CoM260 Kit, including installation, flashing, serial access, results, and evidence.
  • Documents hardware and host prerequisites plus TITANTOOLS image-flashing procedure.
  • Provides board pin mappings and platform-specific Mac/Linux serial-console instructions.
  • Records successful boot and login results with kernel, CPU, OS-version output, asciinema evidence, and Weston desktop screenshot.
  • Notes the discrepancy between the v1.0.7 image filename and the device-reported Buildroot v1.0.6 version.
CoM260 Kit/BuildRoot/README.md
CoM260 Kit/BuildRoot/README_zh.md
Adds the CoM260 Kit board entry and bilingual hardware overview for the support matrix.
  • Defines product, CPU, core, memory, storage, and vendor metadata.
  • Documents K3/X100+A100 specifications, tested configuration, power ratings, and datasheet reference.
  • Adds the corresponding Chinese overview and specifications.
CoM260 Kit/README.md
CoM260 Kit/README_zh.md
Adds visual assets used by the Buildroot test report.
  • Provides the boot-pin reference image and TITANTOOLS flashing screenshots.
  • Adds the Weston desktop result screenshot.
CoM260 Kit/BuildRoot/boot-pins.png
CoM260 Kit/BuildRoot/titantools-select-image.png
CoM260 Kit/BuildRoot/titantools-flashing.png
CoM260 Kit/BuildRoot/weston-desktop.png

Tips and commands

Interacting with Sourcery

  • Trigger a new review: Comment @sourcery-ai review on the pull request.
  • Continue discussions: Reply directly to Sourcery's review comments.
  • Generate a GitHub issue from a review comment: Ask Sourcery to create an
    issue from a review comment by replying to it. You can also reply to a
    review comment with @sourcery-ai issue to create an issue from it.
  • Generate a pull request title: Write @sourcery-ai anywhere in the pull
    request title to generate a title at any time. You can also comment
    @sourcery-ai title on the pull request to (re-)generate the title at any time.
  • Generate a pull request summary: Write @sourcery-ai summary anywhere in
    the pull request body to generate a PR summary at any time exactly where you
    want it. You can also comment @sourcery-ai summary on the pull request to
    (re-)generate the summary at any time.
  • Generate reviewer's guide: Comment @sourcery-ai guide on the pull
    request to (re-)generate the reviewer's guide at any time.
  • Resolve all Sourcery comments: Comment @sourcery-ai resolve on the
    pull request to resolve all Sourcery comments. Useful if you've already
    addressed all the comments and don't want to see them anymore.
  • Dismiss all Sourcery reviews: Comment @sourcery-ai dismiss on the pull
    request to dismiss all existing Sourcery reviews. Especially useful if you
    want to start fresh with a new review - don't forget to comment
    @sourcery-ai review to trigger a new review!

Customizing Your Experience

Access your dashboard to:

  • Enable or disable review features such as the Sourcery-generated pull request
    summary, the reviewer's guide, and others.
  • Change the review language.
  • Add, remove or edit custom review instructions.
  • Adjust other review settings.

Getting Help

@sourcery-ai sourcery-ai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hey - I've found 2 issues

Prompt for AI Agents
Please address the comments from this code review:

## Individual Comments

### Comment 1
<location path="CoM260 Kit/BuildRoot/README.md" line_range="46" />
<code_context>
+
+Prepare 1 female-to-female jumper wire. Orient the board as shown below, with the USB and Ethernet ports at the bottom and the button header at the top. Count positions from the left end of the header toward the right in this orientation.
+
+![CoM260 Kit button header](./boot-pins.png)
+
+| Positions counted from the left | Signals to short | Purpose |
</code_context>
<issue_to_address>
**issue:** All eight local image references point to files that are not added anywhere in this diff, so the button-header, flashing-tool, and Weston screenshots render as broken images in both reports.

**Suggested fix:** Add the referenced PNG files under `CoM260 Kit/BuildRoot/`, or remove/update the references to files that exist.
</issue_to_address>

### Comment 2
<location path="CoM260 Kit/BuildRoot/README.md" line_range="3" />
<code_context>
+---
+sys: buildroot
+sys_ver: "1.0.7"
+sys_var: null
</code_context>
<issue_to_address>
**issue:** The support-matrix metadata advertises system version 1.0.7 while the boot evidence in both reports identifies the running system as `k3-br-v1.0.6`, so the matrix labels a test result with a different runtime version than the one shown by the report.

**Suggested fix:** Reconcile the release metadata and runtime version, or set `sys_ver` to the actually verified version and explain the image-package discrepancy separately.

```suggestion
sys_ver: "1.0.6"
```
</issue_to_address>

Sourcery assessment

Approval pending. 2 findings to address first.

Blocking findings: CoM260 Kit/BuildRoot/README.md:46, CoM260 Kit/BuildRoot/README.md:3


Sourcery is free for open source - if you like our reviews please consider sharing them ✨

Comment thread CoM260_Kit/BuildRoot/README.md
Comment thread CoM260_Kit/BuildRoot/README.md
Signed-off-by: DuoQilai <duoqilai@outlook.com>
@DuoQilai
DuoQilai force-pushed the docs/k3-com260-kit-tests branch from 0be98b6 to 627f9d8 Compare September 20, 2026 08:28
@DuoQilai DuoQilai changed the title docs: add SpacemiT K3 CoM260 Kit Buildroot test report CoM260_Kit: add Buildroot test report Sep 20, 2026
@DuoQilai
DuoQilai merged commit 21c8e46 into ruyisdk:main Sep 20, 2026
3 checks passed
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.

1 participant