Thay đổi hai dòng
Trên GitHub Actions, đổi dòng uses: và secret mà đầu vào token đọc. Mọi thứ khác trong bước đó giữ nguyên.
- uses: actions/checkout@v4
-- uses: wokwi/wokwi-ci-action@v1
+- uses: mokxiorg/sim-action@v1
with:
- token: ${{ secrets.WOKWI_CLI_TOKEN }}
+ token: ${{ secrets.MOKXI_TOKEN }}
path: .
timeout: 10000
scenario: test.scenario.yaml
expect_text: Ready
fail_text: panic
serial_log_file: serial.log
A public repository needs no token: Mokxi CI is free for it, so you can delete the token: line. For a private one, CI comes with Pro (and the student price, Lifetime, Classroom and the trial; an account that still has Ultra keeps it too), so you need a CI token from a Pro account. Make the token under Settings > Developer, and save it as a repository secret named MOKXI_TOKEN. The action passes it to the command line tool, which checks your plan with it. Until December 11, 2026 everybody keeps CI and each run prints a notice.
Action nhận các tên đầu vào của Wokwi (path, timeout, scenario, expect_text, fail_text, serial_log_file, elf, diagram_file, timeout_exit_code, args) với ý nghĩa của Wokwi: timeout đứng riêng là mili giây, path: / là thư mục gốc của kho, scenario được đọc tương đối so với thư mục dự án, còn args là một dòng các tùy chọn cách nhau bằng dấu cách.
Trong shell, wokwi-cli <dir> trở thành npx @mokxi/cli run <dir>, và các tùy chọn giữ nguyên tên (--timeout, --expect-text, --fail-text, --scenario, --serial-log-file, --elf, --diagram-file, --timeout-exit-code, --screenshot-part, --screenshot-time, --screenshot-file, --vcd-file).
Những gì chạy không đổi
- Tệp dự án.
diagram.json, sketch và các tab của nó,libraries.txt, vàwokwi.toml. Khiwokwi.tomlchỉ đến một tệp firmware tồn tại (bản build PlatformIO, ESP-IDF, arduino-cli hoặc Rust), bản build đó được chạy, như Wokwi vẫn làm. Khi nó không tồn tại, Mokxi tự biên dịch sketch, nên một kho chỉ có mã nguồn cũng chạy được. - Các bước kịch bản.
wait-serial,write-serial(chữ hoặc danh sách byte),delay,set-control,expect-pin(với khóapinvàcontrol, hoặc khóa mới hơn làname),take-screenshotvớisave-tovàcompare-with, cùngtouch,touch-press,touch-movevàtouch-releasetrên các màn hình cảm ứng ILI9341. - Id của linh kiện. Một bước gọi linh kiện bằng id của nó trong
diagram.jsoncủa bạn.
Ba điểm khác biệt:
- Mã thoát mặc định khi hết thời gian là 1. Của Wokwi là 42. Đặt
timeout_exit_code: 42(hoặc--timeout-exit-code 42) nếu workflow của bạn kiểm tra mã này. - Các bo mạch dòng Uno mất 65 ms để khởi động. Uno, Nano và các bo ATmega khác mô phỏng độ trễ khởi động lúc cấp nguồn của chip, nên một chân được kiểm tra trong khoảng 70 ms đầu tiên của lần chạy sẽ đọc khác so với Wokwi. Hãy bắt đầu scenario bằng
delay: 100mshoặc mộtwait-serial. - Ảnh chụp toàn bộ mạch là SVG. Ảnh chụp một linh kiện màn hình (OLED, TFT, LCD ký tự, e-paper hoặc màn Nokia) là tệp PNG gồm đúng các điểm ảnh của màn, và
compare-withso nó với ảnh tham chiếu của bạn từng điểm ảnh một. Ảnh chụp linh kiện khác là bản vẽ SVG, vàcompare-withkhông được kiểm tra cho nó. Hãy chụp lại ảnh tham chiếu bằng Mokxi: lần chạy đầu của mộtcompare-withchưa có tệp tham chiếu sẽ lưu ảnh chụp vào đó để bạn kiểm tra và commit.
Linh kiện Wokwi không có tương đương trên Mokxi sẽ bị bỏ qua và được nêu tên trong log, giống như khi bạn nhập dự án vào trình soạn thảo. Nhập từ công cụ khác liệt kê những gì được chuyển sang.
So sánh hai bên
| Mokxi | Wokwi CI | |
|---|---|---|
| Nơi chạy mô phỏng | Trên runner CI của bạn | Trên máy chủ của Wokwi |
| Biên dịch sketch trong CI | Có, bằng chính trình biên dịch của trình soạn thảo, có cache | Không, bạn phải build trước |
| CI miễn phí | Kho công khai, không giới hạn số lần chạy (chạy trên runner của bạn) | Khoảng 50 phút CI mỗi tháng (theo tài liệu Wokwi, kiểm tra ngày 26-10-2026) |
| CI trả phí | Kho riêng tư với Pro; không đếm số phút trên runner của bạn | Pro, from one seat, 2,000 CI minutes a month |
| Tệp kịch bản Wokwi | Có, không thay đổi | Có |
| Các bước bổ sung | press, click, set, wait-pin, expect-toggles (định thời), expect-led, expect-probe, expect-display |
|
| Kiểm tra màn hình | expect-display (điểm sáng, một vùng, một điểm, trống) và PNG compare-with |
PNG compare-with |
| Báo cáo JUnit | Có | Không có trong tài liệu Wokwi |
| Tóm tắt job và chú thích | Có: bảng kết quả, mỗi lỗi hiện trên dòng của kịch bản kèm các dòng cuối của đầu ra serial | Không có trong tài liệu Wokwi |
| Máy phân tích logic sang VCD | --vcd-file |
--vcd-file |
| Thời gian mô phỏng và thời gian thực | Được báo cáo cho mỗi lần chạy | |
| Chia giữa các job | --shard 1/3 |
|
| CI khác (GitLab, Jenkins, CircleCI) | Có, bất kỳ máy nào có Node 18 | Có |
| Kiểm tra sơ đồ | mokxi lint |
wokwi-cli lint |
| Giám sát bộ nhớ heap ESP-IDF | Not yet | Có |
| Ảnh thẻ SD | Not yet | Có |
| Máy chủ GDB | Not yet | Có |
| Độ bao phủ code | Not yet | Có |
| Chip tùy chỉnh | Not yet | Có |
| Gõ vào một lần chạy từ stdin | Not yet | --interactive |
Bảng giá
Running mokxi run and mokxi test on your own computer is free, with no account. CI is free for public repositories on GitHub and gitlab.com, with no limit on runs: they run on your runner, not ours. A private repository comes with Pro, with 2,000 API minutes a month for mokxi simulate and mokxi run --cloud (an account that still has Ultra keeps CI and its 5,000 minutes).
Wokwi Pro có giá EUR 25 mỗi suất mỗi tháng, hoặc EUR 20 mỗi tháng khi thanh toán theo năm (theo wokwi.com/pricing, kiểm tra ngày 26-10-2026).
Xem Simulation tests in CI để có đầy đủ lệnh và tài liệu tham chiếu về kịch bản.