Tài khoản và các gói

Chuyển từ Wokwi CI

Chuyển một workflow Wokwi CI sang Mokxi chỉ bằng cách đổi hai dòng. Thư mục dự án, diagram.json, wokwi.toml và các tệp scenario giữ nguyên.

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. Khi wokwi.toml chỉ đế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óa pin và control, hoặc khóa mới hơn là name), take-screenshot với save-to và compare-with, cùng touch, touch-press, touch-move và touch-release trê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.json củ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: 100ms hoặc một wait-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-with so 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-with khô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ột compare-with chư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.