Bắt đầu tại đây

Nhập dự án từ công cụ khác

Đem dự án từ Wokwi, Tinkercad, Fritzing, KiCad, EasyEDA, LTspice, Arduino IDE, Project Hub và nhiều nơi khác vào, không cần đặt lại từng linh kiện.

Gõ mokxi.com/ trước link Wokwi, CircuitJS, GitHub, gist, GitLab, Bitbucket, Codeberg, trang dán, Dropbox, Google Drive, Instructables, Arduino Project Hub, Hackster hoặc link Arduino Cloud được chia sẻ trong thanh địa chỉ của trình duyệt, ví dụ mokxi.com/wokwi.com/projects/322062421191557714, rồi nhấn Enter. Trình soạn thảo mở ra với dự án đó đã được nhập. Không cần tài khoản. Link Tinkercad sẽ dẫn đến trang nhập, kèm các bước cho Tinkercad. Link Cirkit Designer không hoạt động theo cách này: hãy dán vào trang nhập.

Nhập ở đâu

Open the trang nhập, hoặc trong trình soạn thảo, mở ▾ beside Save and choose Import a project. You can also paste a project link, a diagram.json or a sketch anywhere on the canvas, or drop files, a folder or a zip straight onto the editor. Mokxi works out what the project is from what is inside it, not from its name.

Điều gì xảy ra khi mở

  • Dự án bạn đang mở vẫn được giữ nguyên. Nhấn Hoàn tác trên dòng tóm tắt của bản nhập để khôi phục lại, và Lưu ▾ > Quay lại dự án gần nhất của tôi sẽ mở lại dự án đó sau này.
  • Dòng tóm tắt cho biết những gì đã được đưa vào. Nhấn vào đó để xem báo cáo đầy đủ: những gì đã trở thành ghi chú trên khung vẽ, và những gì bị thiếu (đường nối, tệp và thư viện), kèm lý do cho từng mục.
  • Những linh kiện mà Mokxi không có sẽ trở thành ghi chú màu hồng ngay tại vị trí của chúng, và dòng "Bỏ lại:" trong báo cáo sẽ nêu tên từng linh kiện.
  • Dây nối được đi sẵn cho bạn. Với nguồn có vẽ sẵn đường dây (Wokwi, Cirkit, nhiều tệp Fritzing), dây đi theo đúng lộ trình đó. Với nguồn không có (sơ đồ nguyên lý, netlist, tệp bo mạch Tinkercad), bản nhập tối đa 30 dây sẽ được sắp gọn dây ngay khi mở. Bản lớn hơn giữ dây đi thẳng: nhấn T để sắp gọn chúng.
  • Mokxi AI có thể hoàn thiện nốt. Khi có thứ bị bỏ lại, dòng tóm tắt sẽ gợi ý Nhờ Mokxi AI hoàn thiện nốt. Mokxi AI đề xuất linh kiện Mokxi gần nhất cho mỗi ghi chú, kèm chân đã nối dây sẵn, cùng thư viện cần cài hoặc #include cần thay đổi cho từng linh kiện còn thiếu. Mỗi linh kiện và chân đều được đối chiếu với danh mục thật trước. Chưa có gì thay đổi cho đến khi bạn nhấn nút trên từng dòng (Thêm vào khung vẽ, Cài, Đổi lệnh include), và mỗi lần nhấn là một bước Hoàn tác.
  • Cho chúng tôi biết gửi kèm nguồn gốc của dự án và những gì bị thiếu (không bao giờ gửi code của bạn). Mỗi báo cáo đều có người thật đọc. Bản nhập thất bại sẽ gợi ý Thử lại khi việc thử thêm lần nữa có thể giúp được.

Các nguồn trên trang này

Wokwi, Cirkit Designer, GitHub, GitLab, Bitbucket và Codeberg, trang dán code, Dropbox và Google Drive, Instructables, Project Hub, Hackster và Arduino Cloud, Fritzing, SimulIDE, KiCad, EasyEDA, Qucs và gEDA, Falstad CircuitJS, Tinkercad, PlatformIO, Arduino IDE, một file .hex đã được biên dịch, một liên kết Mokxi, chữ đã dán, một ảnh chụp, LTspice, và Proteus, Multisim và CircuitMaker.

Từ Wokwi

Full guide: Nhập dự án Wokwi, với một liên kết mở ra dự án đã nhập.

Mới đến Mokxi từ Wokwi? Đến từ Wokwi sẽ đặt từng ý tưởng Wokwi cạnh tên của nó ở đây và cho biết có gì thay đổi.

Dùng bất kỳ cách nào sau đây:

  • Một liên kết. Dán liên kết của một dự án công khai, ví dụ https://wokwi.com/projects/322062421191557714. Máy chủ của Mokxi lấy các file của dự án từ wokwi.com, và chỉ từ đó thôi, rồi trình duyệt của bạn đọc chúng. Dự án riêng tư thì không ai lấy được ngoài bạn: hãy mở nó trên Wokwi, tải xuống file zip của dự án, rồi thả file đó vào thay thế.
  • Các file. Thả hoặc chọn diagram.json, sketch (sketch.ino hoặc tên gọi bất kỳ của nó), các tab .h và .cpp bổ sung nếu có, và libraries.txt.
  • File zip. File zip dự án tải về từ Wokwi dùng được ngay mà không cần chỉnh sửa.

Những gì được giữ lại:

  • Linh kiện. Bo mạch, LED, điện trở, nút nhấn, công tắc gạt, biến trở, servo, còi, LCD ký tự (có hoặc không có module I2C), màn hình OLED, NeoPixels, vòng và dải LED, màn hình bảy đoạn và TM1637, ma trận MAX7219, màn hình ILI9341, HC-SR04, DHT22, PIR, DS18B20, MPU6050, DS1307 và HX711, bàn phím ma trận, bộ mã hóa quay, joystick, rơ le, driver và động cơ bước, thanh ghi dịch, thẻ microSD và cổng logic sẽ trở thành linh kiện Mokxi tương ứng, với màu sắc, giá trị, địa chỉ I2C và số điểm ảnh của chúng.
  • Dây nối. Mỗi kết nối giữa hai linh kiện có ánh xạ sẽ thành một dây nối, với tên chân được dịch (GND.2 là chân GND thứ hai của bo mạch, V+ trên servo là VCC, v.v.) và màu dây Mokxi gần nhất. Dây nối đi theo đường vẽ trong Wokwi; dây không có đường thì có một khúc cua duy nhất. Nhấn Sắp gọn dây để đi dây né quanh các linh kiện.
  • Breadboard. Linh kiện cắm vào breadboard trên Wokwi sẽ được cắm vào đúng các lỗ đó trên breadboard của Mokxi. Nếu linh kiện Mokxi có kích thước khác (điện trở ở đây ngắn hơn), một chân nằm trong lỗ của nó và các chân còn lại được nối dây đến lỗ tương ứng.
  • Nhãn. Nhãn chữ trên Wokwi sẽ thành ghi chú dán.
  • Code. Sketch và các tab của nó sẽ trở thành các file trên bo mạch.

Những gì không được hỗ trợ, và cách bạn được thông báo:

  • Custom chips come across as parts that run their own code when the chip's files come with them (<name>.chip.json and <name>.chip.c, a bare chip.json and chip.c, a chip in a folder of its own, or a built chip.wasm), or when diagram.json names them under dependencies. See chip tùy chỉnh. Code của chip không bao giờ trở thành một tab trong sketch của bo mạch. Chip thiếu tệp sẽ thành một ghi chú màu hồng, và báo cáo cho biết thiếu gì, chẳng hạn một .chip.c that came without its .chip.json.
  • Các linh kiện mà Mokxi chưa có trở thành ghi chú màu hồng trên khung vẽ ngay vị trí linh kiện đó, kèm tên của linh kiện. Các dây nối của chúng được liệt kê trong báo cáo.
  • Các kết nối serial monitor của Wokwi bị bỏ qua: serial monitor của Mokxi luôn được nối với bo mạch.
  • Dự án MicroPython chạy trên Raspberry Pi Pico và các bo ESP32 đời đầu (DevKit V1, DevKitC và LOLIN32 Lite). Trên các bo khác, các tệp .py được giữ lại dạng văn bản nhưng không chạy.
  • Dự án CircuitPython (tệp code.py) chạy trên Raspberry Pi Pico và Arduino Nano RP2040 Connect, với firmware CircuitPython chính thức. Trên các bo khác, tệp code.py được giữ lại dạng văn bản, và báo cáo nêu lý do.

Từ Cirkit Designer

Full guide: Mở liên kết dự án Cirkit Designer, kèm danh sách linh kiện và các bước thực hiện.

Dán liên kết của dự án được chia sẻ (https://app.cirkitdesigner.com/project/<id>, có hoặc không có số phiên bản ở cuối) vào trang nhập hoặc vào khung vẽ. Máy chủ của Mokxi lấy tệp dự án từ Cirkit, và chỉ từ đó thôi, không cần đăng nhập. Dự án không được chia sẻ thì không thể đọc được.

  • Linh kiện. Arduino Uno, Nano và Mega, ESP32 và ESP32-S3, Raspberry Pi Pico, LED và LED RGB, điện trở kèm giá trị, nút nhấn, còi, servo, biến trở, DHT11 và DHT22, HC-SR04, OLED SSD1306, LCD 16x2 (có hoặc không có I2C), rơ le, 74HC595, L298N, DS18B20, MPU6050, đầu thu IR, cảm biến PIR, module cảm biến ánh sáng, bàn phím ma trận, NeoPixel, vòng và dải, màn hình TM1637 và MAX7219 và màn hình 7 đoạn.
  • Dây nối đi theo các đường đã vẽ trong Cirkit.
  • Code. Sketch của một bo mạch sẽ được chuyển sang chính bo mạch đó.
  • Bất kỳ thứ gì khác trở thành ghi chú màu hồng kèm tên, và được liệt kê trong báo cáo.

Từ GitHub

Full guide: GitHub sang Mokxi, từng bước một, kèm ví dụ mở ngay tại đây.

Dán liên kết đến một kho công khai, một thư mục trong kho, một tệp .ino riêng lẻ, hoặc một gist. Dự án PlatformIO hoặc thư mục sketch Arduino sẽ được chuyển nguyên cả code lẫn danh sách thư viện. Liên kết đến tệp platformio.ini, hoặc đến một tệp trong thư mục src/ của PlatformIO, sẽ mang theo cả dự án bao quanh nó. Máy chủ của Mokxi chỉ tải các dự án công khai từ GitHub, không gửi bất kỳ thông tin đăng nhập nào, và giới hạn kích thước (10 MB cho một kho, 2 MB cho một tệp hoặc gist). Với kho riêng tư, hãy tải tệp zip từ GitHub về rồi thả vào thay thế.

Từ GitLab, Bitbucket và Codeberg

Giống như GitHub: dán liên kết đến kho công khai, thư mục trong kho hoặc tệp sketch riêng lẻ trên gitlab.com, bitbucket.org hoặc codeberg.org. Mokxi đọc tệp zip do chính trang đó tạo cho kho (tối đa 10 MB) và mở thư mục bạn đã liên kết, hoặc tệp (tối đa 2 MB). Kho riêng tư cần đăng nhập, điều Mokxi không bao giờ làm, nên hãy tải tệp zip ở đó về rồi thả vào thay thế.

Từ các trang paste

Dán liên kết đến một bài paste trên pastebin.com, paste.ee, dpaste.org hoặc hastebin.com. Mokxi tải văn bản thô của nó và đọc giống như bất kỳ nội dung nào được dán vào: một sketch, một diagram.json, một bản xuất CircuitJS. Bài paste mà trang giữ sau màn đăng nhập (hastebin.com giờ yêu cầu đăng nhập) sẽ không đọc được; hãy sao chép nội dung của nó rồi dán vào.

Từ Dropbox và Google Drive

Liên kết tệp hoặc thư mục Dropbox, và liên kết tệp Google Drive, hoạt động khi bất kỳ ai có liên kết đều có thể mở mà không cần đăng nhập. Thư mục Dropbox đến dưới dạng tệp zip do Dropbox tạo, và được đọc như một tệp zip được thả vào. Thư mục Drive, Google Doc, tệp yêu cầu đăng nhập, và tệp quá lớn để Drive quét virus sẽ không đọc được: Mokxi sẽ báo như vậy, và bạn có thể tải tệp về rồi thả vào. Tệp bị giới hạn ở 2 MB, tệp zip ở 10 MB.

Từ Instructables

Dán địa chỉ dự án (instructables.com/<Project-Name>/). Mokxi đọc các liên kết đính kèm trên trang và mở các tệp .ino, .zip và .fzz đính kèm, cùng bất kỳ tệp đính kèm .txt nào chứa code. Nó chỉ đọc instructables.com và máy chủ tệp của trang này, tối đa tám tệp đính kèm, tổng cộng 8 MB. Dự án không có tệp đính kèm thì không có gì để đọc: hãy sao chép code từ các bước của nó rồi dán vào.

Từ Arduino Project Hub, Hackster và Arduino Cloud

Full guides: Arduino Project Hub, Hackster and Arduino Cloud, mỗi bản gồm các bước và những gì trang đọc được.

Dán địa chỉ trang dự án (projecthub.arduino.cc/<user>/<project> hoặc hackster.io/<user>/<project>). Mokxi đọc code được dán trong trang (phần Code, và bất kỳ khối nào trong bài viết là một sketch), cùng các tệp .ino, .zip, .fzz, .h, .cpp và tệp .txt chứa code đính kèm. Sketch đầu tiên mở thành <project>.ino; các khối code khác thành các tab của nó, và một sketch hoàn chỉnh thứ hai (các trang thường hiện hai bản) được giữ thành một tab .txt. Lệnh shell và bảng linh kiện bị bỏ qua. Khi trang không có code riêng nhưng liên kết đến GitHub, Mokxi mở dự án GitHub mà nó trỏ tới. Phần cứng mà trang liệt kê chỉ được ghi thành một ghi chú trong báo cáo, không thành linh kiện: hãy tự đặt chúng. Hình sơ đồ mạch, hình breadboard, tệp in 3D và video không được chuyển sang. Mokxi chỉ đọc chính trang đó và máy chủ tệp của nó, tối đa tám tệp, tổng cộng 8 MB.

Một sketch Arduino Cloud được chia sẻ (liên kết app.arduino.cc/sketches/<id>, hoặc liên kết create.arduino.cc/editor/.../preview từ Share Sketch) mở kèm các tệp code của nó, khi chủ sở hữu đặt thành Public, anyone with the link can view the sketch. Sketch riêng tư không thể đọc được nếu không đăng nhập: hãy tải nó ở đó (Download Sketch, cho ra một tệp zip) rồi thả tệp zip vào trang nhập.

Từ Fritzing

Full guide: Fritzing sang Mokxi, từng bước một, kèm ví dụ mở ngay tại đây.

Thả tệp .fzz (File, Save trong Fritzing sẽ tạo tệp này). Đó là một tệp zip chứa sketch và code từ tab Code của Fritzing, và cả hai đều được mang sang. Một tệp .fz đơn giản cũng hoạt động, kèm tệp .ino đặt cạnh nó.

  • Những gì được đọc. Chế độ breadboard: mọi linh kiện, vị trí của chúng, mọi dây nối, và các dải của breadboard. Chế độ sơ đồ và PCB không được đọc, vì dây chỉ vẽ ở đó thì chưa từng nằm trên breadboard; báo cáo đếm các linh kiện chỉ có ở đó.
  • Linh kiện. Thư viện lõi của Fritzing: Arduino Uno, Nano và Mega 2560, điện trở kèm giá trị, LED kèm màu sắc, LED RGB, nút nhấn, công tắc gạt, công tắc nghiêng và công tắc reed, biến trở, tụ gốm và tụ hóa, diode và diode Zener, transistor NPN và PNP, MOSFET kênh N, ổn áp 7805, quang trở, nhiệt trở, LM35, FSR, HC-SR04, RHT03 (DHT22), còi piezo, servo, động cơ DC, LCD 16x2, màn hình 7 đoạn, 555, 74HC595, cầu H L293D và pin 9 V cùng pin AA; ngoài ra các diode, tụ và ổn áp mọi kiểu đóng gói, đầu cắm DC, chip mà Mokxi có theo mã linh kiện (LM358, 4N35, IC chung của Fritzing ghi nhãn 595), ATmega168 hoặc 328 trần (chạy như bo Uno mà nó là trái tim), cùng nguồn, đồng hồ vạn năng và máy hiện sóng của trình mô phỏng.
  • Bo kẻ đồng. Các dải đồng, và các vết cắt trên đó, được nối bằng dây giống như dải của breadboard.
  • Header chân và dây đo là đầu nối, không phải linh kiện: chúng bị bỏ đi, và các dây gặp nhau ở đó vẫn gặp nhau.
  • Breadboard. Bản thân breadboard không được chuyển sang. Thay vào đó, các linh kiện trên mỗi dải của nó được nối với nhau bằng dây, nối đúng vào những chân giống hệt vậy.
  • Ghi chú. Ghi chú của Fritzing thành ghi chú dán.
  • Linh kiện từ thư viện khác và linh kiện tùy chỉnh sẽ trở thành ghi chú màu hồng ghi tên linh kiện.

Từ SimulIDE

Full guide: SimulIDE sang Mokxi, từng bước một, kèm ví dụ mở ngay tại đây.

Thả tệp mạch: .sim1 từ SimulIDE 1.0 trở lên, hoặc .simu từ các phiên bản cũ hơn.

  • Những gì được đọc. Mọi linh kiện, vị trí và hướng xoay của chúng, mọi dây nối, các nút giao, và tunnel (hai tunnel cùng tên là một kết nối). Nhãn chữ sẽ thành ghi chú dán.
  • Linh kiện. Điện trở, tụ điện, cuộn cảm, LED, diode và diode Zener, biến trở, quang trở, nhiệt trở, mass, nguồn áp cố định, đường nguồn và pin, BJT, MOSFET, khuếch đại thuật, LM555, nút nhấn và công tắc, động cơ DC, servo, DHT22, HC-SR04, LCD HD44780, màn hình 7 đoạn, cổng AND, OR và XOR hai ngõ vào, xung clock, và Arduino Uno, Nano và Mega (chân của chúng được đọc theo nhãn, như D13 và A0); ngoài ra các chip 74xx và CD4000, mảng điện trở, thanh LED, màn hình nhiều chữ số, cổng nhiều ngõ vào hơn (thành chuỗi cổng hai ngõ vào), que đo, đồng hồ vạn năng, scope và máy phân tích logic, màn hình Nokia 5110, SSD1306 và ILI9341, và ATmega trần (như Uno). SimulIDE cấp nguồn cho chip và màn hình mà không cần dây, nên khi nhập Mokxi tự nối nguồn giúp chúng.
  • Code. SimulIDE giữ sketch trong trình soạn thảo riêng của nó và nạp file .hex đã biên dịch vào bo mạch, còn Mokxi biên dịch từ mã nguồn, vì vậy hãy đặt file .ino vào thư mục hoặc file zip cùng với mạch. Báo cáo sẽ cho biết khi chỉ có đường dẫn .hex.

Từ KiCad

Full guide: KiCad sang Mokxi, từng bước một, kèm ví dụ mở ngay tại đây.

Thả sơ đồ vào đây: file .kicad_sch (KiCad 6 trở lên), file .kicad_pro hoặc file zip của thư mục dự án (Mokxi sẽ mở sơ đồ gốc của dự án), hoặc file .sch của KiCad 4 và 5. Sao chép và dán nội dung văn bản của file cũng được.

  • Những gì được đọc. Mọi ký hiệu linh kiện, vị trí, hướng xoay và lật gương, mọi dây nối và điểm nối, nhãn, nhãn toàn cục và ký hiệu nguồn. Các đường nối được tạo theo đúng cách KiCad tạo: đầu dây, chân và nhãn gặp nhau thì được nối chung, một chân hoặc nhãn nằm giữa sợi dây sẽ nối vào dây đó, các dây chỉ giao nhau thì không nối, còn các nhãn hoặc ký hiệu nguồn trùng tên thì thuộc cùng một đường nối. Các chân nguồn ẩn của chip (như VCC và GND của 74HC595) nối vào đường nối trùng tên với chân đó, giống như trong KiCad.
  • Linh kiện. Bo mạch Arduino Uno, Nano và Mega, các module ESP32, ESP32-S3, ESP32-C3 và Pico, điện trở, tụ điện, cuộn cảm, LED và LED RGB, diode và diode Zener, biến trở, nút nhấn hai chân, công tắc trượt ba chân, transistor và MOSFET, buzzer, pin, các chip 74xx và CD4000, chip 555, khuếch thuật, ổn áp tuyến tính (78xx, AMS1117), NeoPixels, và các module cảm biến và màn hình phổ biến theo tên. Linh kiện hai chân giữ nguyên hướng như sơ đồ vẽ.
  • Được để lại thành ghi chú. Ký hiệu nào Mokxi không có linh kiện tương ứng sẽ thành ghi chú có nhãn ngay vị trí cũ, và báo cáo liệt kê kèm các đường nối mà nó mang theo. Một linh kiện chỉ được ánh xạ khi nó đúng là linh kiện đó: một mảng diode TVS không phải là diode, động cơ AC không phải động cơ DC, công tắc bốn chân hoặc công tắc SPST không phải công tắc của Mokxi, và một đầu nối ghi "OLED" vẫn là hàng chân cắm. Hàng chân cắm, điểm đo và lỗ bắt vít là nơi cáp kết nối, nên chúng được bỏ qua và nêu tên trong báo cáo.
  • Các sheet lồng trong sheet. Một sheet con có file đi kèm trong bản tải lên, và chỉ được dùng một lần, sẽ được đọc và nối vào qua các nhãn phân cấp và các chân sheet trên sheet cha. Một sheet con thiếu trong bản tải lên, hoặc được dùng nhiều hơn một lần, sẽ bị bỏ qua và nêu tên trong báo cáo.
  • File cũ hơn. File .sch từ KiCad 4 hoặc 5 không chứa ký hiệu linh kiện, nên các chân của chúng được tìm trong file -cache.lib hoặc .lib đi kèm. Hãy thêm file này vào bản tải lên. Nếu không có, các linh kiện sẽ thành ghi chú và báo cáo sẽ giải thích lý do; không chân nào được đoán mò.
  • Code. Sơ đồ không có code. Thêm file .ino vào bản tải lên để nó được nạp vào bo mạch.
  • Không được đọc. Các bus (dây bus, lối vào bus và nhãn dạng D[0..7]), bố cục bo mạch (.kicad_pcb), các mô hình mô phỏng và ký hiệu được đánh dấu là không lắp linh kiện.
  • Vị trí. Các linh kiện giữ vị trí tương đối trên sheet. Dây được sắp gọn bằng Tidy khi dự án mở (tối đa 30 dây); sơ đồ lớn hơn sẽ có dây nối thẳng, chân tới chân, cho đến khi bạn nhấn Tidy wires.

Từ EasyEDA

Full guide: EasyEDA sang Mokxi, từng bước một, kèm ví dụ mở ngay tại đây.

Mở sơ đồ trong trình soạn thảo EasyEDA Standard, chọn File, rồi Export, rồi EasyEDA Source, và thả file .json vào đây (hoặc dán nội dung văn bản của nó). Liên kết tới dự án EasyEDA hoặc OSHWLab sẽ không được tải về: Mokxi sẽ hướng dẫn bạn các bước này. Dự án EasyEDA Pro (.epro) dùng định dạng khác và chưa được đọc. File lớn hơn 1 MB bị bỏ qua, nên khi dự án lớn bạn chỉ nên xuất sơ đồ thôi.

  • Những gì được đọc. Mọi linh kiện kèm ký hiệu, giá trị, package và chân; các dây nối; điểm nối; nhãn đường nối; và cờ nguồn và mass. File nguồn EasyEDA không có netlist, nên Mokxi tự tìm các kết nối theo cách trình soạn thảo vẽ chúng: một dây nối mọi thứ nằm trên nó, và các nhãn, cờ cùng tên là một kết nối, trên mọi sheet. Các sheet được xếp cạnh nhau.
  • Linh kiện. Điện trở, tụ điện, cuộn cảm, LED, diode, transistor, công tắc, biến trở, các module phổ biến và chip 74xx, CD4000, cùng các bo mạch kiểu Arduino, theo ký hiệu, giá trị, quy cách đóng gói và tên chân của chúng (cùng bảng mà trình đọc KiCad và SPICE dùng). Linh kiện nào Mokxi không có sẽ thành ghi chú màu hồng ghi tên nó, và báo cáo liệt kê nó.
  • Chân. Chân nào không có phần tương ứng trong linh kiện của Mokxi sẽ được liệt kê trong báo cáo và bỏ ngỏ, tuyệt đối không đoán mò.
  • Không được đọc. Bo mạch (PCB) trong cùng dự án, hình vẽ và chữ trên tờ, và các thư viện linh kiện. Khung hoặc logo không có chân sẽ bị bỏ qua.
  • Code. Sơ đồ không có code. Thêm file .ino vào bản tải lên và nó sẽ được đưa lên bo mạch.

Từ Qucs và gEDA

Full guides: Qucs and gEDA và Lepton EDA, mỗi công cụ có một sơ đồ mẫu mở được tại đây.

Thả sơ đồ vào đây, một file .sch. Mokxi đọc nội dung bên trong để biết công cụ nào đã lưu nó: Qucs (cùng Qucs-S và QucsStudio, lưu theo cùng cách) hoặc gEDA gschem (cùng Lepton EDA, phần tiếp nối của gEDA). Bạn cũng có thể dán nội dung văn bản của file vào ô này.

  • Linh kiện. Điện trở, tụ điện, cuộn cảm, diode và diode Zener, BJT (NPN và PNP), MOSFET, đất (mass), nguồn áp một chiều và nguồn sin, từ cả hai công cụ; từ gEDA còn có LED, pin, biến trở, nút nhấn và ký hiệu nguồn (Vcc, +5V, +3.3V). Linh kiện khác trở thành ghi chú dán ghi tên nó và được liệt kê trong báo cáo.
  • Chân và đường nối. Không file nào nói chân của linh kiện nằm ở đâu: Qucs giữ chúng trong chương trình, còn gEDA giữ trong file .sym của từng ký hiệu. Mokxi biết chân của các linh kiện chuẩn nói trên, và tự tính vị trí từng chân khi linh kiện bị xoay hoặc lật gương. Các dây và đường nối gặp nhau thì nối chung, nhãn dây của Qucs và tên đường nối của gEDA trùng tên thì là một đường nối, còn ký hiệu nguồn của gEDA là đường nối có tên. Ký hiệu gEDA nhúng trong sơ đồ tự mang chân của nó, nên cũng được đọc.
  • Bị bỏ qua. Các khối mô phỏng (.DC, .TR), phương trình, sơ đồ, chỉ thị và mô hình SPICE, khung tiêu đề và hình vẽ: Mokxi tự chạy mạch, nên hãy đặt que đo, đồng hồ hoặc scope ở nơi bạn muốn quan sát. Giá trị mà Qucs lấy từ một biến (R = Rload) sẽ dùng giá trị mặc định của Mokxi, và báo cáo sẽ cho biết là giá trị nào.
  • KiCad. File .sch của KiCad là định dạng khác: xem phần Từ KiCad ở trên.

Từ Falstad CircuitJS

Full guide: Falstad CircuitJS sang Mokxi, từng bước một, kèm ví dụ mở ngay tại đây.

Dùng bất kỳ cách nào sau đây:

  • Một liên kết. Dán liên kết CircuitJS chứa ?ctz= hoặc ?cct=, lấy từ File, Export As Link. Mạch được lưu ngay trong liên kết, nên Mokxi đọc tại chỗ và không tải gì thêm.
  • Nội dung văn bản. Dán văn bản từ File, Export As Text, hoặc thả file mạch đã lưu. Cả định dạng văn bản lâu đời và định dạng XML mới hơn đều được đọc.

Những gì được chuyển sang: điện trở, tụ điện, cuộn cảm, nguồn DC và đường nguồn, nguồn dạng sin, vuông, tam giác, răng cưa và xung (như một máy tạo tín hiệu), đất, công tắc, diode, diode Zener, LED với màu của chúng, transistor NPN và PNP, MOSFET, op-amp, biến trở, con 555, quang trở, nhiệt điện trở, động cơ DC, cổng logic (nhiều hơn hai đầu vào thành một chuỗi cổng hai đầu vào), bộ đảo, đầu vào và đầu ra logic, flip-flop D và JK, bộ đếm, bộ ghép kênh và công tắc analog (dạng chip 74HC và CD4000 kèm nguồn), rơ le, đèn, màn hình 7 đoạn và màn hình số, cùng vôn kế và ampe kế (dạng đồng hồ vạn năng). Các nút có nhãn nối mọi nút cùng tên với nhau, và chữ trở thành ghi chú dán.

Hai điều khác biệt trong Mokxi, và báo cáo ghi rõ điều đó: op-amp của CircuitJS được cấp nguồn không cần dây, nên lúc nhập sẽ thêm một nguồn và một đất cho nó; và CircuitJS không cần ký hiệu đất, nên hãy thêm một đất nơi mạch có mức 0 V nếu mạch chưa có. Mọi phần tử khác (biến áp, đường truyền, mạch con tùy chỉnh và tương tự) trở thành ghi chú màu hồng ghi tên nó.

Từ Tinkercad

Full guide: Tinkercad sang Mokxi, từng bước, kèm ví dụ mở ngay tại đây.

Tinkercad Circuits có thể xuất một mạch thành tệp bo mạch, trong đó chứa mọi linh kiện và mọi dây nối. Kèm theo code của nó, cả dự án được chuyển sang nguyên vẹn, đã nối dây:

  1. Mạch. Mở mạch trong Tinkercad, bấm Export và tải tệp .brd về.
  2. Đoạn code. Mở Code, chuyển sang Text, rồi bấm nút tải xuống để lưu tệp .ino (hoặc chọn hết và sao chép nó).
  3. Kéo thả cả hai vào trang nhập hoặc vào trình soạn thảo, cùng lúc với nhau.

Mokxi đặt mọi linh kiện nó có đúng vị trí như cũ: bo Uno và micro:bit, LED với màu của chúng, LED RGB, điện trở và biến trở kèm giá trị, nút nhấn, công tắc gạt và DIP, còi piezo, servo, động cơ DC và động cơ có hộp số, TMP36, quang trở và quang transistor, HC-SR04, PIR, thu hồng ngoại, cảm biến độ ẩm đất, lực và khí, bàn phím 4x4, LCD 16x2 và I2C, màn hình 7 đoạn, NeoPixels, transistor, diode, tụ điện, pin 9 V và nguồn, rơ le, 7805, L293D, LM741, 555, chip 74HC và CD4511. Mỗi linh kiện được nối dây đúng như Tinkercad đã có, và code được nạp lên bo mạch. Breadboard không được chuyển sang: các dải của nó đã nằm trong đường nối rồi. Linh kiện mà Mokxi không có (chẳng hạn cảm biến Parallax PING) trở thành ghi chú ghi tên nó, và báo cáo liệt kê nó.

Tệp bo mạch không có code và không có các thiết lập như điện áp của nguồn (đặt là 5 V) hay địa chỉ I2C, nên báo cáo sẽ ghi rõ khi chúng quan trọng.

Không có tệp .brd? Sao chép bảng Danh sách linh kiện (hoặc tải xuống dạng CSV), dán vào ô nhập kèm code bên dưới, hoặc kéo thả tệp .csv và .ino cùng lúc. Các linh kiện xuất hiện thành từng hàng kèm giá trị, để bạn tự nối dây.

Mokxi không bao giờ đọc các trang của Tinkercad: liên kết Tinkercad cần đăng nhập, nên trang nhập sẽ hướng dẫn cách xuất thay thế.

Từ PlatformIO

Full guide: PlatformIO sang Mokxi, từng bước, kèm ví dụ mở ngay tại đây.

Kéo thả thư mục dự án, hoặc tệp zip của nó, với platformio.ini ở ngay gốc.

  • Bo mạch lấy từ môi trường biên dịch mặc định (default_envs, nếu không thì [env:...] đầu tiên), trường board được đọc giống cách bản xuất của PlatformIO ghi nó, và bạn có thể chọn bo khác.
  • Code. src/main.cpp trở thành sketch.ino của bo mạch (phần #include <Arduino.h> và các khai báo hoạt động nguyên trạng), còn các tệp khác trong src/ và include/ đến kèm bên cạnh. Các tệp trong thư mục bên trong src/ thì không, vì dự án Mokxi không có thư mục.
  • Thư viện. Mỗi mục lib_deps được kiểm tra như một dòng libraries.txt của Wokwi, còn thư viện riêng của dự án trong lib/ cũng đến cùng dưới dạng thư viện riêng của dự án. Thư viện mà PlatformIO lấy từ URL Git sẽ được ghi là thiếu.
  • Các framework khác. Mokxi biên dịch sketch Arduino; báo cáo sẽ ghi rõ khi dự án dùng một framework khác, ví dụ như ESP-IDF.

Từ Arduino IDE

Full guide: Mở tệp .ino trực tuyến, với bo mạch dự đoán, phần nối dây Mokxi thêm vào và một sketch mẫu.

Kéo một tệp .ino, cả thư mục sketch, hoặc tệp zip của nó vào, hoặc dán sketch vào ô nhập. Mỗi tab .ino, .h, .cpp và .c nằm cạnh sketch đều được chuyển sang. Các tệp trong thư mục bên trong sketch (như src/) thì không, vì dự án Mokxi không có thư mục: hãy chuyển chúng đến cạnh sketch và include theo tên.

Khi thư mục sketch có tệp sketch.yaml (Arduino IDE 2 và arduino-cli) hoặc sketch.json (bản tải từ Arduino Cloud), bo mạch lấy từ đó, và thư viện được kiểm tra, cùng với dòng depends= của từng thư viện trong thư mục libraries/. Tệp thingProperties.h của sketch Arduino Cloud được giữ lại, nhưng bo mạch mô phỏng không kết nối được Arduino IoT Cloud, nên các biến đám mây của nó giữ giá trị ban đầu.

Nếu không, Arduino IDE không ghi lại bo mạch, nên Mokxi đoán từ sketch: WiFi.h hoặc ledcWrite nghĩa là ESP32, ESP8266WiFi.h là ESP8266, Serial1 hoặc chân 40 là Mega, A7 là Nano, v.v. Hãy chọn đúng bo trong danh sách Board trước khi mở.

Sketch đến mà không có mạch, nên Mokxi tự nối dây dựa trên những gì code nói: các thư viện nó include (Servo, DHT, LiquidCrystal_I2C, Adafruit_SSD1306, Adafruit_NeoPixel và những thư viện khác) và các chân nó thiết lập và sử dụng. LED có điện trở 220 ohm của nó. Phần tóm tắt cho biết đã nối gì, chẳng hạn "Chúng tôi đã nối: servo ở chân 9, LED ở chân 13 (kèm 220 ohm)"; hãy di chuyển hoặc nối lại bất cứ gì khác với mạch của bạn. Khi code không nói gì về phần nối dây, dự án mở ra chỉ với bo mạch, sẵn sàng để bạn nối dây. Để trả lời bài đăng trên diễn đàn của ai đó với code đã sửa và chạy được, hãy dùng mokxi.com/fix (xem Giúp người khác sửa code).

Từ tệp .hex đã biên dịch

Drop a compiled program, the .hex file the Arduino IDE saves with Sketch, Export Compiled Binary, or one somebody sent you, and it runs as it is: the project opens with the board alone, running that program as the one uploaded in its Bảng Firmware. Nó chạy trên Uno, hoặc trên Mega 2560 khi chương trình quá lớn đối với Uno. A .hex does not say which board it was built for, so pick the right one from the Board list before opening: the list offers the AVR boards whose flash holds it (Uno, Nano, Mega 2560, Leonardo, Pro Mini and ATtiny85). When the Arduino IDE saved two, the one without with_bootloader in its name is used.

Chương trình đã biên dịch không có code để chỉnh sửa. Nối linh kiện vào các chân như bình thường; để thay đổi hoạt động của nó, hãy nhập sketch gốc đã dùng để biên dịch thay vào đó.

Một liên kết Mokxi được dán vào ô nhập, chẳng hạn mokxi.com/p/... hoặc liên kết trình soạn thảo được chia sẻ từ app.mokxi.com, vốn đã là dự án Mokxi, nên không có gì để nhập: ô nhập sẽ ghi rõ điều đó và mở nó ra.

Dán

Hộp nhập đọc những gì trình trò chuyện và diễn đàn dán vào: code nằm trong khối Markdown (```), một diagram.json của Wokwi cùng sketch của nó trong hai khối của cùng một câu trả lời, và một dự án kèm vài lời văn xung quanh. Một liên kết đến trang Mokxi không đọc được sẽ cho biết trang đó lưu dự án ở đâu và cách đưa nó sang (một thư mục Drive, một liên kết OneDrive hay Mega, một video YouTube).

Ảnh chụp hoặc ảnh chụp màn hình

Mokxi không thể tự đọc ảnh chụp một mạch. Khi bạn thả một ảnh vào, hộp nhập sẽ gợi ý Copy photo prompt: đưa câu lệnh đó cùng bức ảnh cho ChatGPT, Claude hoặc Gemini, rồi dán câu trả lời của nó vào đây. Nó sẽ viết mạch theo định dạng dự án AI của Mokxi và liệt kê những gì nó phải đoán.

Từ LTspice

Full guide: LTspice sang Mokxi, từng bước một, kèm ví dụ mở ngay tại đây.

Thả sơ đồ (.asc) vào trang nhập hoặc vào trình soạn thảo, hoặc dán văn bản của nó. LTspice lưu vị trí của từng ký hiệu và từng đoạn dây chạy như thế nào, chứ không lưu những chân nào nối với nhau, nên Mokxi tự suy ra các đường nối theo cách LTspice làm: một chân, một đầu dây hoặc một cờ nằm cùng một điểm là một node, đầu dây rơi lên dây khác thì nối với dây đó, dây chỉ cắt nhau thì không nối, và các cờ cùng tên là một đường nối. Cờ tên 0 là mass, và mỗi cờ trở thành một linh kiện mass.

Những gì chuyển được sang: điện trở, tụ điện (kể cả phân cực), cuộn cảm, diode (kể cả Schottky và zener), LED, transistor NPN và PNP, MOSFET kênh N và P, nguồn áp một chiều (dưới dạng nguồn không nối mass), nguồn sin và xung (dưới dạng bộ tạo sóng, khi chân âm của nguồn nằm trên mass), và các op-amp năm chân (UniversalOpamp2, opamp2) khi chân nguồn âm của chúng là mass. Tên mô hình được giữ khi Mokxi có đúng linh kiện đó (2N3904, 1N4007, IRLZ44N; một nhóm độ lợi như BC337-40 chính là linh kiện đó), nếu không thì linh kiện là loại mặc định của Mokxi và báo cáo sẽ nói rõ. Một dòng .param được dùng để điền vào {name} trong một giá trị. Các chú thích trở thành ghi chú dán.

The simulation commands (.tran, .op, .ac, .step and the rest) are read into the report's notes. Mokxi runs live, so press Run and watch the nodes with a scope or a meter; a frequency or DC sweep is not carried.

Những gì không chuyển được, mỗi thứ thành một ghi chú hồng ghi rõ tên nó: nguồn dòng, nguồn hành vi, PWL và các nguồn đặc biệt khác, nguồn sin hoặc xung có chân âm không nằm trên mass, op-amp dùng nguồn âm, mọi ký hiệu không nằm trong số các ký hiệu chuẩn ở trên (IC, công tắc, đường truyền, mạch con), vì vị trí chân của chúng nằm trong tệp ký hiệu mà LTspice giữ, không nằm trong sơ đồ. Các thẻ mô hình và thư viện (.model, .lib) không được nhập. Không cần cài LTspice, và không có gì trong tệp được chạy.

Netlist SPICE do LTspice xuất (View > SPICE Netlist, tệp .net, hoặc .cir) sẽ mở ra dưới dạng netlist, như ở phần tiếp theo.

Từ Proteus, Multisim và CircuitMaker

Proteus, Multisim và CircuitMaker lưu thiết kế trong định dạng đóng riêng của chúng, chỉ chính chúng mới mở được. Từ Multisim, chọn Transfer, rồi Export Netlist; từ CircuitMaker, chọn File, rồi Export, rồi SPICE Netlist. Mở .cir bằng Lưu ▾ > Mở JSON hoặc SPICE. Từ Proteus, hãy chụp màn hình và dùng câu lệnh cho ảnh. Một netlist LTspice (.net, từ View > SPICE Netlist) mở ra giống như bất kỳ netlist SPICE nào, và sơ đồ LTspice (.asc) được nhập trực tiếp (xem Từ LTspice).

Thư viện

Báo cáo kiểm tra mọi thư viện mà dự án nêu tên, trong libraries.txt của Wokwi, lib_deps của PlatformIO, và các dòng #include của sketch:

  • Có sẵn. Mokxi biên dịch trực tiếp với chính thư viện đó, như Servo.h, LiquidCrystal_I2C.h, Adafruit_SSD1306.h, Adafruit_NeoPixel.h và DHT.h.
  • Dùng cái này thay thế. Mokxi có trình điều khiển làm cùng một việc dưới tên khác, và báo cáo sẽ cho biết cần include tệp header nào.
  • Thiếu. Không có gì trong Mokxi cung cấp nó.

Một tệp zip có thư mục libraries/ (bố cục sketchbook của Arduino), hoặc một dự án PlatformIO lib/ thư mục, sẽ mang theo thư viện của nó làm thư viện riêng của dự án, trên mọi gói. Xem các gói.

Lấy dự án ra lại

Không có gì khóa dự án lại. Nút Xuất ở phần đầu trình soạn thảo tải dự án về dưới dạng dự án Wokwi (diagram.json, sketch.ino và libraries.txt, nén zip), một thư mục sketch Arduino IDE hoặc một dự án PlatformIO. Bản xuất Wokwi mang theo cả linh kiện, dây nối lẫn code; linh kiện mà Wokwi không có tương đương sẽ được liệt kê trong README của nó, và các dải trên breadboard trở thành dây nối trực tiếp.

An toàn

Không có gì bạn nhập vào được chạy trong lúc đọc. Tệp tải lên, zip và văn bản dán đều có giới hạn dung lượng; đường dẫn leo ra ngoài dự án (../) hoặc bắt đầu từ một ổ đĩa sẽ bị từ chối và nêu tên trong báo cáo; chỉ tệp nguồn và tệp dự án được giữ; tệp XML khai báo document type hoặc entity sẽ bị từ chối, nên không entity nào bao giờ được mở rộng hay tải về; liên kết CircuitJS được giải nén với giới hạn; và tệp thư viện phải tuân theo các quy tắc giống như thư viện tải lên trong trình soạn thảo.