Trình soạn thảo

Chip tùy chỉnh viết bằng C

Chip tùy chỉnh là linh kiện có hành vi bằng code: một cảm biến Mokxi chưa có linh kiện, trình điều khiển màn hình hoặc bộ nhớ. Chip Wokwi chạy nguyên trạng.

These are different from the chip bạn tạo từ linh kiện. Những chip đó là một mạch được gói lại trong một hộp. Còn chip tùy chỉnh là một chương trình.

Mang chip từ Wokwi sang

Chip luôn đi kèm dự án chứa nó. Nhập dự án như cách thường lệ và các chip sẽ đi theo dưới dạng linh kiện, cùng chân và dây nối của chúng:

  • Một dự án Wokwi cho VS Code hoặc Wokwi CLI đã có sẵn từng chip được dựng: file chip.wasm mà wokwi.toml nêu tên, nằm cạnh một file chip.json. Mokxi chạy file đó.
  • Một dự án từ wokwi.com có mỗi chip là hai tệp, <name>.chip.json và <name>.chip.c. Hãy đưa cả hai vào. Một chip.json và chip.c riêng lẻ, một chip nằm trong thư mục riêng của nó, hoặc chip.json và src/main.c của dự án Wokwi cho VS Code đều dùng được, và các tệp header mà code của chip include từ cạnh nó cũng vậy.
  • Một chip mà dự án nêu tên dưới dependencies trong diagram.json của nó, ví dụ "chip-pwm": "github:Dlloydev/Wokwi-Chip-PWM@1.0.6", sẽ được tải xuống từ bản release đó trên GitHub, như Wokwi vẫn làm.

Báo cáo nhập cho biết chip nào đã được chuyển sang, và thiếu gì ở những chip chưa đủ. Một chip mà các file của nó không có trong phần tải lên sẽ thành một ghi chú trên khung vẽ, ngay chỗ nó từng đứng.

Code của chip không bao giờ nằm trong sketch của bo mạch. Một file .c include wokwi-api.h nhưng không kèm .chip.json sẽ được nêu trong báo cáo: hãy thêm .chip.json của nó và nhập lại để chạy. Code chip dán vào một tab của bo mạch sẽ bị loại khỏi bản biên dịch của bo mạch, kèm cảnh báo trên tab đó nói rằng đây là chip tùy chỉnh, để sketch vẫn chạy được. Để chạy nó, hãy tạo chip bằng New custom chip và dán code vào file .chip.c của chip.

Tự viết chip của bạn

Mở menu Thêm trên thanh công cụ khung vẽ và chọn Tạo chip tùy chỉnh mới…. Đặt tên cho nó, chip sẽ xuất hiện trên khung vẽ, ban đầu là một bộ đảo logic. Nó cũng nằm trong bảng linh kiện dưới mục Chip trong dự án này, nên bạn có thể đặt bao nhiêu tùy thích.

Hai file của chip mở trong bảng code, chọn như file của bo mạch từ danh sách ở đầu bảng:

  • <name>.chip.json đặt tên cho các chân của nó, theo thứ tự từ chân 1, và có thể thêm thanh trượt (controls) cùng một màn hình. Vị trí của chân trong danh sách chính là vị trí của nó trên chip: xuống bên trái, rồi lên bên phải.
  • <name>.chip.c là những gì chip làm, viết bằng C với chip API của Wokwi: pin_init, pin_watch, pin_write, timer_start, attr_read, i2c_init, spi_init, uart_init và các hàm còn lại.

Nhấn Run và Mokxi biên dịch code của chip trước, ngay trong trình duyệt của bạn. Lỗi trong code hiện trên dòng thông báo biên dịch phía trên vùng code, nhấn vào đó sẽ nhảy tới dòng lỗi. Chip viết trong Mokxi cũng là chip Wokwi: cùng hai file đó dùng được bên đó.

Chạy thử

Nhấn Run. Mỗi chip chạy code riêng của nó cạnh mạch, với tốc độ của mô phỏng: bộ đếm thời gian một mili-giây của chip sẽ kích hoạt sau một mili-giây mô phỏng.

  • Những gì chip in ra bằng printf hiện trong Serial Monitor, dưới id của chip.
  • Chip có màn hình thì vẽ ngay trên thân của nó.
  • Chip có điều khiển (nhiệt độ, mức ánh sáng) sẽ có một thanh trượt cho mỗi điều khiển trong bảng của nó. Nhấn vào chip và kéo thanh trượt khi mạch đang chạy; chip đọc giá trị mới ngay lập tức.

Các cài đặt khác của chip là thuộc tính của nó, như trong diagram.json của Wokwi.

An toàn khi chạy

Code của chip chạy trong một hộp riêng. Nó không thể truy cập trang web, file của bạn, mạng hay bất kỳ phần nào khác của mạch, ngoại trừ qua các chân của chính nó. Nó được tối đa 16 MB bộ nhớ. Nếu code của nó kẹt trong vòng lặp không bao giờ kết thúc, Mokxi dừng riêng chip đó, thông báo trong Serial Monitor, và phần còn lại của mạch vẫn chạy.

Khác gì so với Wokwi

Mokxi mô phỏng điện áp còn Wokwi thì không, nên chân chip đọc mức cao khi trên 2.5 V. Một mạch chỉ chạy được trên Wokwi vì mức tín hiệu ở đó hoàn hảo có thể cần thêm một điện trở ở đây, như trên bàn thí nghiệm thật. Ngõ ra của chip phát ở mức điện áp trên chân VCC của nó, nên chip trên bo mạch 3.3 V sẽ phát 3.3 V.

Các hàm thử nghiệm của Wokwi để đọc bộ nhớ vi điều khiển có biên dịch được nhưng chưa làm gì trong Mokxi: chúng trả về 0, và chip dùng chúng sẽ nói vậy trong Serial Monitor.

Chip viết bằng Rust chạy đúng như tác giả phát hành (file chip.wasm của họ), và những gì in bằng debugPrint cũng hiện trong Serial Monitor.