Có ba cách làm việc với dự án ngoài trình duyệt, và cả ba đều dùng chung các tệp, nên bạn có thể kết hợp tùy ý: lưu lên GitHub từ trình soạn thảo, clone repository và mở trong VS Code, đồng bộ từ VS Code hoặc terminal, rồi mở lại trong Mokxi.
Một dự án đã lưu trông như thế nào
Mỗi lần lưu lên GitHub, mỗi lần mokxi pull và mỗi dự án mà VS Code mở đều có cùng bố cục:
| Tệp | Đây là gì |
|---|---|
Blink/Blink.ino |
sketch, dạng một thư mục Arduino IDE, cùng các tab khác bên cạnh |
diagram.mokxi.json |
toàn bộ dự án: linh kiện, dây nối, ghi chú và code. Mokxi mở nguyên như vậy |
README.md |
dự án là gì, kèm huy hiệu Open in Mokxi |
.vscode/extensions.json |
gợi ý cài tiện ích Mokxi khi thư mục mở trong VS Code |
.vscode/settings.json |
thư mục thuộc dự án Mokxi nào |
.vscode/tasks.json |
push, pull, chạy, biên dịch và nạp như các tác vụ VS Code |
.gitignore |
bỏ qua trạng thái đồng bộ và kết quả biên dịch của dòng lệnh |
Thư mục lấy tên theo dự án, nên Arduino IDE mở nguyên như vậy (File > Open > Blink/Blink.ino). Dự án có hai bo mạch sẽ có một thư mục riêng cho mỗi bo, chẳng hạn Traffic_Lights_uno1/ và Traffic_Lights_esp1/.
Hãy sửa sketch trong thư mục, đừng sửa bên trong diagram.mokxi.json: khi Mokxi đọc lại repository, thư mục sẽ được ưu tiên. Một tab bạn xóa khỏi thư mục sẽ bị xóa khỏi dự án, và một tệp mới trong đó sẽ trở thành tab mới.
README, .gitignore và các tệp .vscode là của bạn một khi chúng đã tồn tại: Mokxi ghi chúng lần đầu và không đụng vào các chỉnh sửa của bạn sau đó.
Lưu lên GitHub từ trình soạn thảo
- Mở Xuất ở thanh tiêu đề của trình soạn thảo.
- Trong mục GitHub, nhấn Connect GitHub. GitHub hỏi bạn có cho phép Mokxi ghi vào các repository công khai của bạn không. Tích Include private repositories trước nếu bạn muốn cả repository riêng tư.
- Quay lại trình soạn thảo, mở Xuất lần nữa và nhấn Lưu lên GitHub.
- Chọn New repository (Mokxi đặt tên theo dự án) hoặc một repository của bạn, viết thông điệp commit nếu muốn, rồi nhấn Lưu lên GitHub.
Bạn nhận được liên kết tới commit trên GitHub. Mỗi lần lưu sau đó là một commit mới trên cùng nhánh. Dòng trên cùng của thẻ cho biết bạn đang ở đâu:
- Synced with ada/blink (main): GitHub có đúng dự án này.
- Changes not saved to ada/blink yet: bạn đã thay đổi dự án kể từ đó.
- ada/blink has newer commits: ai đó đã push lên repository. Dùng Open from GitHub để lấy các commit đó.
Mở từ GitHub
Mở Xuất và nhấn Mở từ GitHub, rồi chọn một repository của bạn hoặc dán vào bất kỳ repository nào bạn có quyền đọc (owner/name hoặc liên kết github.com).
- Một repository được lưu từ Mokxi sẽ mở đúng như lúc lưu, kèm mọi chỉnh sửa đã được thực hiện với thư mục sketch trên GitHub hoặc trong VS Code.
- Một repository sketch Arduino thông thường (thư mục chứa tệp
.ino) cũng mở được. Mokxi sẽ đặt nó lên bo Uno, hoặc ESP32 nếu sketch có dùng WiFi. Hãy đổi bo mạch nếu sketch dành cho bo khác.
Những gì đang mở trước đó sẽ được đưa lên giá trước, giống như với Mở JSON, nên không mất gì cả. Huy hiệu Mở trong Mokxi trong README của repository đã lưu sẽ mở dự án ngay lập tức.
Kết nối và ngắt kết nối
Mokxi chỉ xin GitHub cấp quyền truy cập repository khi bạn nhấn Kết nối GitHub, không bao giờ khi bạn đăng nhập. Đây là một quyền riêng biệt với việc đăng nhập bằng GitHub, và cách hoạt động giống nhau dù bạn đăng nhập bằng Google, Microsoft hay email.
Quyền truy cập này được lưu mã hóa cùng tài khoản của bạn và chỉ dùng khi bạn nhấn Lưu hoặc Mở. Không có gì khác trong Mokxi đọc được nó, và nó không bao giờ được gửi tới trình duyệt của bạn.
Để ngắt kết nối, vào Cài đặt > Tài khoản đã kết nối và nhấn Ngắt kết nối. Mokxi sẽ thu hồi quyền truy cập tại GitHub và xóa nó. Đóng tài khoản cũng làm điều tương tự. Bạn cũng có thể tự thu hồi trên GitHub, tại Settings > Applications > Authorized OAuth Apps.
Tính năng đồng bộ GitHub không dành cho học sinh trong lớp học hay tài khoản của trẻ em.
VS Code
Cài Mokxi từ VS Code Marketplace (tìm Mokxi trong mục Extensions), hoặc từ Open VSX nếu dùng VSCodium và Cursor. Một thư mục được lưu từ Mokxi đã sẵn gợi ý cài tiện ích này.
Chạy mạch trong VS Code
Mở một thư mục dự án: dự án Mokxi, dự án Wokwi (wokwi.toml và diagram.json) hoặc một sketch. Nhấn Start Simulator (nút phát trên sketch hoặc trên sơ đồ). Mạch chạy trong một bảng cạnh code của bạn, trên cùng engine với trình soạn thảo Mokxi, và terminal Mokxi Serial Monitor hiển thị những gì bo mạch in ra; gõ một dòng ở đó rồi nhấn Enter để gửi. Lưu sketch hoặc sơ đồ, hoặc biên dịch lại bằng công cụ build của bạn, sẽ chạy lại mạch. Nút Dừng và Chạy lại nằm trên thanh tiêu đề của bảng và trong thanh trạng thái.
Dự án có bản build (firmware được ghi trong wokwi.toml, bản build PlatformIO hoặc bản build arduino-cli) sẽ chạy bản build đó; nếu không, bảng sẽ biên dịch sketch giống như trình soạn thảo. Tất cả những việc này không cần tài khoản.
Kiểm thử, lint và CI
- Các tệp kịch bản (
mokxi.test.yaml,*.test.yaml,*.scenario.yamlcủa Wokwi) hiện trong khung Testing của VS Code. Mỗi kịch bản là một bài kiểm thử với các bước bên dưới; nếu lỗi, nó trỏ đến dòng của bước đó, kèm các dòng serial cuối cùng. - Mokxi: Kiểm tra mạch (Lint) đưa các lỗi nối dây vào bảng Problems. Nó cũng chạy khi bạn lưu sơ đồ.
- Mokxi: Chụp ảnh một màn hình lưu ảnh một màn hình thành PNG ngay thời điểm bạn chọn.
- Mokxi: Thiết lập CI (GitHub Actions hoặc GitLab) ghi ra workflow, tệp GitLab CI, hoặc cả hai, và một
mokxi.test.yamlnếu dự án chưa có. Xem kiểm thử mô phỏng trong CI.
Dự án Mokxi của bạn
- Nhấn biểu tượng Mokxi trong thanh hoạt động và nhấn Đăng nhập. Phê duyệt mã ngắn trong trình duyệt của bạn, hoặc dán token từ Settings > Developer.
- Các dự án của bạn được liệt kê ở thanh bên. Nhấn vào một dự án để mở nó như một thư mục.
- Chỉnh sửa sketch. Tệp
.inođược tô sáng cú pháp kiểu Arduino, cùng các đoạn mẫu nhưsketch,blink,buttonvàevery. - Nhấn Sync (biểu tượng đám mây trên thanh tiêu đề của trình soạn code) để gửi nó đến Mokxi.
- Open in Mokxi (mục Mokxi trên thanh trạng thái) sẽ mở nó trong trình soạn code ngay trên trình duyệt của bạn.
Sync sẽ không ghi đè lên công việc bạn đã làm trong trình duyệt từ lần sync gần nhất, và Pull sẽ không vứt bỏ những chỉnh sửa bạn chưa sync. Mỗi thao tác đều cho bạn biết lý do và cho phép bạn lựa chọn. Mở, sync, pull và nạp là tính năng của gói Pro.
Biên dịch và nạp
Mokxi: Compile (arduino-cli) dùng arduino-cli nếu máy bạn có sẵn, với lỗi hiển thị trong bảng Problems, còn Mokxi: Compile and Upload to Mokxi sẽ sync, biên dịch và lưu bản build cùng dự án, nhờ đó mokxi.com chạy đúng thứ bạn đã build. Bạn không cần arduino-cli cho bảng mô phỏng, vốn tự biên dịch sketch.
Dòng lệnh
Những việc này cũng làm được từ terminal với npx @mokxi/cli. Xem
Dòng lệnh mokxi.
npx @mokxi/cli login
npx @mokxi/cli pull https://mokxi.com/p/abc123 blink
cd blink && git init
npx @mokxi/cli push
npx @mokxi/cli run --timeout 5s
Những gói nào
GitHub sync and the command line are on every plan. mokxi run and mokxi test compile and simulate on your own machine, so they are free and need no
sign-in. In VS Code, the simulator panel, tests, lint, screenshots, Set Up CI
and Compile are free and need no account too. Your Mokxi projects in VS
Code (opening, Sync, Pull and Compile and Upload to Mokxi) are part of Pro
(and the student price and Classroom); without it, the extension says
so and offers the 7-day Pro trial where you can still start it. CI runs (the GitHub
Action, or the command line tool in a CI job) are free for public
repositories; for private ones, CI comes with Pro (and the student price,
Classroom, the trial, Lifetime, and Ultra for accounts that still have it); see kiểm thử mô phỏng trong CI. If you used either in the 60 days before
October 12, 2026, you keep it until December 11, 2026, and the tool tells you
so. mokxi run --cloud and mokxi simulate run on Mokxi's servers and use the
API minutes your plan includes; the developers page lists them.