Những gì bạn thấy
The Checkup is the Circuit Doctor inside Mokxi AI. It reads your wiring and your code together, in your browser, and stays quiet when it is not sure. Open it from Checkup in the serial monitor's bar or on the toolbar (see Kiểm tra). Mỗi phát hiện là một thẻ có nhãn Problem, Check or Tip, with one sentence on what is wrong and a line on what to do. Where a fix is safe there is a button for it, and Ctrl+Z undoes it like any edit.
Mỗi phát hiện dưới đây có mã ngắn trong ngoặc. Bạn không bao giờ cần nó; nó ở đó để bạn đối chiếu phát hiện với trang này, hoặc trích dẫn khi bạn viết cho chúng tôi.
Nguồn và mass
- Một nguồn được nối thẳng xuống mass (
short_circuit). Một dây, hoặc một dải breadboard, nối 5V hoặc 3V3 với GND. Trên bo mạch thật, điều này làm dây nóng lên và có thể hỏng cổng USB. Rút dây đó ra (nút Xóa dây đó làm sẵn), hoặc di chuyển linh kiện để hai chân rơi vào hai dải khác nhau. Một dạng thứ hai nói hai nguồn khác nhau dùng chung một dây: chỉ dùng một nguồn cho mỗi đường nguồn. - Hai mass không được nối với nhau (
ground_not_shared). Một linh kiện lấy nguồn từ pin hoặc nguồn riêng, nhưng mass của nó không đến được GND của bo mạch, nên tín hiệu không có đường trở về. Giữ nguyên nguồn và thêm một dây từ mass của nó đến GND của bo mạch. Nút sửa tự vẽ dây này. - Một module không có mass, hoặc không có nguồn (
module_no_gnd,module_no_vcc). Chân GND hoặc VCC của nó chưa được nối, hoặc đi đến chỗ không phải mass hay nguồn. Nối GND với GND của bo mạch, và VCC với 5V hoặc 3V3, tùy linh kiện yêu cầu gì. - Nguồn của một module nằm trên VIN, mà không có gì cấp cho VIN (
module_on_vin). VIN (RAW trên một số bo mạch) là đầu vào của ổn áp trên bo mạch. Chỉ khi có pin hoặc bộ đổi nguồn nối vào nó mới có điện áp, không phải khi cắm USB. Chuyển VCC của module sang 5V. - Một linh kiện mà sketch dùng chưa được nối với gì cả (
part_not_wired). Code nói chuyện với nó, nhưng không chân nào của nó được nối. Nối chân nguồn, mass và tín hiệu của nó vào bo mạch. - Một module được cấp điện áp quá thấp (
module_low_supply). Cấp VCC của nó từ 5V (VIN trên ESP32 DevKit). Nếu đầu ra của nó sau đó vọt lên 5 V mà đi vào bo mạch 3.3 V, thêm một mạch phân áp (1 kΩ và 2 kΩ). - 5 V on a 3.3 V pin (
voltage_5v_on_3v3). A 5 V part's output, or a 5 V rail, reaches a pin that takes 3.6 V at most. The simulator carries on, a real board may not. Power the part from 3V3 if it works there (the Move it to 3V3 button does it where it can), or put a divider or a level shifter on that wire. A 3.3 V part on 5 V gets the same finding: power it from 3V3. - Một đầu ra được nối thẳng vào đường nguồn (
output_to_rail). Một chân bo mạch đặt làm đầu ra nối thẳng xuống GND hoặc 5V, nên bị ngắn mạch khi code kéo nó theo chiều ngược lại. Đặt linh kiện, kèm điện trở của nó, vào giữa chân và đường nguồn. - Hai đầu ra trên một dây (
two_outputs). Hai đầu ra “đánh nhau” khi một bên ra HIGH còn bên kia ra LOW. Chỉ nối đầu ra với các đầu vào. - Một biến trở có thể gây ngắn nguồn (
pot_short). Chân giữa của nó nằm trên 5V hoặc GND, nên khi vặn đến hết tầm nó nối hai cực với nhau. Nối hai chân ngoài vào nguồn và mass, và đọc tín hiệu ở chân giữa.
LED và các linh kiện khác
- Một LED không có điện trở (
led_resistor). LED thật sẽ cháy nếu thiếu điện trở. Nút sửa tự lắp một điện trở 220 Ω nối tiếp. Nhiều LED nối chân với chân tính là một chuỗi: một điện trở ở bất kỳ đâu trong chuỗi là đủ, và thiếu nó là phát hiện này, báo trên LED gần chân nhất. - Điện trở quá lớn (
led_dim_resistor). Dòng qua quá ít nên LED gần như không sáng. Một dự án từ Wokwi có thể mang giá trị này mà trông vẫn ổn ở đó, vì Wokwi sáng LED bất kể điện trở bao nhiêu. Nút sửa đặt một giá trị làm LED sáng. - Điện trở quá nhỏ (
led_small_resistor). Dòng qua LED và chân quá lớn. Xem lại vòng màu thứ ba: 22 Ω và 220 Ω chỉ khác nhau ở vòng này. Nút sửa đặt 220 Ω. - Một LED bị lắp ngược (
led_reversed). Anode của nó (A, chân dài) nằm trên GND, còn cathode hướng về chân bo mạch, trực tiếp, qua điện trở hoặc qua LED khác. Đảo nó lại. Nút sửa hoán đổi hai dây của nó. - Hai chân của LED cùng một đường nối (
led_shorted). Cả hai chân cùng trên GND, trên một chân, hoặc cắm vào cùng một dải breadboard, nên LED không bao giờ sáng. Di chuyển một chân: A đến chân bo mạch qua một điện trở, C xuống GND. Một điện trở giữa chân LED và GND vẫn bị tính: nút sửa chuyển đầu kia của điện trở sang một chân trống. - Cathode của LED nằm trên nguồn (
led_cathode_to_supply). Chân ngắn (C) của nó nằm trên 3V3 hoặc 5V (thường là đường +) còn chân dài nằm trên một chân bo mạch. Chân bo mạch không bao giờ cao hơn nguồn, nên LED không bao giờ sáng. Chuyển C xuống GND (đường -). Nút sửa chuyển dây đó sang GND của bo mạch. LED có A trên nguồn và C trên chân bo mạch, sáng bằng mức LOW, là đúng và không phải trường hợp này. - Một điện trở không làm gì (
resistor_dangling). Một đầu không nối vào đâu, hoặc cả hai đầu cùng một đường nối, nên không có dòng chạy qua. Điện trở cho LED phải nối tiếp: chân bo mạch, điện trở, anode của LED. Ở đâu chân bo mạch nối thẳng vào LED bên cạnh, nút sửa chuyển dây đó sang đầu còn trống của điện trở. Điện trở không nối vào gì cả thì nhận một gợi ý: nối nó vào mạch, hoặc xóa đi. - Một chân chỉ dẫn điện trở xuống GND (
pin_to_ground_resistor). Code điều khiển chân như một đầu ra, nhưng thứ duy nhất trên nó là một điện trở thẳng xuống GND, nên không có gì sáng. Đặt LED sau điện trở: chân bo mạch, điện trở, A, rồi C xuống GND. Điện trở pull-down trên một chân vào là đúng và không phải trường hợp này. - Một tụ điện hóa bị lắp ngược (
capacitor_reversed). Chân có sọc của nó nằm về phía điện áp cao hơn. Trình mô phỏng không hiện gì, nhưng tụ thật bị rò, nóng lên và có thể nổ. Nút sửa đảo nó lại. - Một nút nhấn không thay đổi gì (
button_same_side). Cả hai dây nằm trên các chân luôn nối với nhau bên trong nút nhấn. Chuyển một dây sang chân ở phía bên kia, hoặc xoay nút nhấn một phần tư vòng. Nút sửa chuyển giúp bạn một dây. - Một động cơ hoặc servo trên chân GPIO (
motor_on_gpio). Một chân chỉ cho vài miliampe còn động cơ cần hàng trăm. Cấp VCC của servo từ 5V và chỉ giữ tín hiệu của nó trên một chân (nút sửa chuyển nó sang 5V). Điều khiển động cơ qua transistor hoặc bộ điều khiển động cơ như L298N. - Một động cơ bị nối ngược chiều (
motor_reversed). Hai động cơ trên một driver, với hai dây của một động cơ bị bắt chéo, nên cùng một đoạn code khiến chúng quay ngược nhau và xe quay tròn thay vì đi thẳng. Đổi chỗ hai dây của động cơ đó, hoặc hai chân IN của nó trong code; nút sửa sẽ đổi chỗ hai dây. Hai động cơ được vẽ quay mặt vào nhau, như hai bên của một chiếc xe, là có ý bị bắt chéo, và Checkup hiểu điều đó: trong trường hợp đó, hai động cơ nối giống nhau mới nhận cảnh báo này, vì xe sẽ quay tại chỗ. - I2C nối nhầm chân (
i2c_pins). SDA và SCL bị đổi chỗ, hoặc không nằm trên các chân mà bo mạch dùng cho I2C. Cảnh báo sẽ nêu đúng các chân, và nút sửa sẽ di chuyển hoặc đổi chỗ các dây. - Một linh kiện bị cháy, hoặc bị đẩy quá giới hạn định mức (
part_damaged). Linh kiện được vẽ tối màu, hoặc có vòng màu hổ phách khi nó được tha một lần. Cảnh báo cho biết nó đo được bao nhiêu so với định mức. Sửa nguyên nhân, rồi nhấn Dừng và Chạy: mọi linh kiện đều bắt đầu lại nguyên vẹn.
Chân và code
- Code và dây nối dùng hai chân khác nhau (
pin_mismatch). Nút sửa sẽ đổi số trong code, hoặc di chuyển dây nối. - Một thư viện dùng chân khác với dây nối (
library_pin). Chẳng hạn một servo gắn vào một chân nhưng nối dây sang chân khác. Hãy làm hai bên khớp nhau. - Một chân được code dùng nhưng không có gì nối vào (
pin_unwired), hoặc một linh kiện đã nối dây nhưng code không bao giờ dùng (pin_unused). Nối linh kiện vào chân mà code dùng, hoặc đổi code. - Thiếu
pinMode(pinmode_missing). Một chân được ghi giá trị vớidigitalWritevẫn là ngõ vào, nên LED trên đó sáng rất mờ hoặc không sáng. ThêmpinMode(pin, OUTPUT);trongsetup(). pinModebị đặt sai chiều (pinmode_wrong). Code ghi vào một chân được đặt là ngõ vào, hoặc đọc nút nhấn trên một chân được đặt là ngõ ra.analogReadtrên chân không có ngõ vào analog (analog_pin), hoặcanalogWritetrên chân không có PWM (pwm_pin). Cảnh báo liệt kê các chân có thể làm được.- Nút nhấn để chân bị lơ lửng (
button_floating). Không có gì giữ chân, nó sẽ đọc ra giá trị ngẫu nhiên. DùngINPUT_PULLUPvà nối nút nhấn với GND; khi đó chân đọc LOW khi nhấn. Một dạng thứ hai cho biết nút nhấn nối lên nguồn trong khiINPUT_PULLUPđã giữ chân ở mức HIGH: hãy nối nó vào GND thay vì vậy. - Chân không có điện trở kéo bên trong (
pin_no_pull). Trên ESP32, chân GPIO 34 đến 39 không có, nênINPUT_PULLUPkhông có tác dụng ở đó. Thêm một điện trở 10 kΩ, hoặc chuyển nút nhấn sang chân có điện trở kéo. - Một chân chạy được ở đây nhưng không chạy trên ESP32-S3 thật (
s3_reserved_pin). Trên các bo ESP32-S3 có PSRAM octal (N8R8 và N16R8 mà đa số mọi người mua), GPIO 35, 36 và 37 thuộc về PSRAM, còn GPIO 19 và 20 là D- và D+ của cổng USB. Mokxi không có PSRAM, nên linh kiện hoặc code trên những chân đó vẫn chạy ở đây, nhưng trên bo thật thì không. Chuyển sang một chân trống như chân 39 và đổi số chân trong code. Xem ESP32-S3-DevKitC-1. - Linh kiện trên chân 0 hoặc 1 (
serial_pin_used). Trên Uno, Nano, Mega hoặc Pro Mini, những chân đó là RX và TX, nối tới chip dùng để nạp sketch. Nó vẫn chạy trong Mokxi, nhưng trên bo thật linh kiện có thể chặn việc nạp và làm hỏng dữ liệu Serial. Chuyển sang một chân trống và đổi số chân trong code. - Một module serial trên chân 0 và 1 (
serial_module_upload). Đây là mẹo, không phải lỗi. Trên Uno, Nano hoặc Pro Mini, TX và RX của module trên chân 0 và 1 dùng chung Serial với USB. Nó vẫn hoạt động, cả ở đây lẫn trên bo mạch, nhưng trên bo thật hãy rút nó khỏi chân 0 khi nạp, hoặc chuyển sang hai chân khác với SoftwareSerial. - TX hoặc RX của module trên chân không truyền dữ liệu (
serial_power_pin). Chân TX hoặc RX của module (chẳng hạn module Bluetooth, GPS hay GSM) nằm trên IOREF, RESET, AREF, 5V, 3V3, VIN hoặc GND, nên nó không bao giờ nói chuyện được với bo mạch. Nối TX của nó vào RX của bo mạch và RX của nó vào TX của bo mạch (chân 0 và 1 trên Uno), hoặc sang hai chân khác với SoftwareSerial.
Serial và thời gian
- Thiếu
Serial.begin(serial_begin). Không gì hiển thị trên serial monitor cho đến khi cổng được khởi động. Nút sửa sẽ thêmSerial.begin(9600);. - Tốc độ baud không khớp, hoặc một bên bất thường (
serial_baud). Code nói chuyện ở một tốc độ còn serial monitor nghe ở tốc độ khác, nên kết quả ra là ký tự rác: nút sửa sẽ đặt tốc độ của monitor vào code. HoặcSerial.begindùng một tốc độ không chuẩn, nên serial monitor thật sẽ hiện ký tự rác: cảnh báo gợi ý tốc độ chuẩn gần nhất. - Một thời gian
millis()lưu trongint(millis_overflow), hoặc một phép so thời gian bị hỏng khimillis()tràn số. Hãy lưu thời gian trongunsigned long, và so sánhmillis() - startvới khoảng thời gian thay vì cộng dồn. Nút sửa sẽ đổi kiểu dữ liệu. - Một
delay()dài có thể bỏ lỡ cú nhấn nút (delay_button). Đây là mẹo, không phải lỗi. Hãy đo thời gian bằngmillis()và chống rung cho nút nhấn.
Cả mạch điện tử
- Mạch không thể đọc được theo như đang vẽ (
circuit_unreadable). Phần chi tiết cho biết lý do. Hoàn tác thay đổi cuối, hoặc xóa dây nối hay linh kiện mà nó nêu tên. - Một dây nối đi về hư không (
wire_nowhere). Một đầu trỏ vào chân không tồn tại. Lần chạy bỏ qua dây đó. Hãy xóa nó, hoặc vẽ lại. - Một linh kiện mà trình mô phỏng không biết (
part_unknown). Nếu trang cũ hơn linh kiện, Tải lại sẽ đưa nó vào và giữ nguyên công việc của bạn. Nếu không, lần chạy sẽ bỏ nó qua, nên hãy xóa nếu nó không nên ở đó. - Một phần mạch không bao giờ ổn định (
circuit_unsettled). Vài dây nối cứ dao động mà không gì làm chúng chậm lại, nên trình mô phỏng giữ chúng và chạy tiếp. Những linh kiện đó hiển thị có thể không giống mạch thật. Hãy kiểm tra hai linh kiện nối thành vòng lặp, hoặc hai chân của một linh kiện nằm cùng một hàng breadboard.
Vẫn chưa giải quyết được
Nhấn Giải thích trên một cảnh báo để hỏi Mokxi AI về nó (dùng một câu hỏi), hoặc xem không gì sáng lên cho những kiểm tra mà Checkup không thực hiện được. Nếu một cảnh báo có vẻ sai với mạch của bạn, hãy viết cho chúng tôi từ /support kèm mã của nó và liên kết đến dự án.