Lo que ves
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 Chequeo). Cada hallazgo es una tarjeta marcada como 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.
Cada hallazgo de abajo tiene su código corto entre corchetes. Nunca lo necesitas; está ahí para que puedas relacionar un hallazgo con esta página, o citarlo cuando escríbenos.
Alimentación y tierra
- Una fuente está conectada directo a tierra (
short_circuit). Un cable, o una tira de la protoboard, une 5V o 3V3 con GND. En una placa real eso calienta los cables y puede dañar el puerto USB. Quita el cable (el botón Quitar ese cable lo hace), o mueve el componente para que los dos pines caigan en tiras distintas. Una segunda forma dice que dos fuentes distintas comparten un mismo cable: usa una fuente por riel. - Dos tierras no están unidas (
ground_not_shared). Un componente toma su energía de una batería o de una fuente, pero su tierra no llega al GND de la placa, así que la señal no tiene por dónde regresar. Deja la fuente y agrega un cable de su tierra al GND de la placa. El botón de corrección lo dibuja. - Un módulo no tiene tierra, o no tiene alimentación (
module_no_gnd,module_no_vcc). Su pin GND o VCC no está conectado, o va a un lugar que no es tierra ni una fuente. Conecta GND al GND de la placa, y VCC a 5V o 3V3, según lo que pida el componente. - La alimentación de un módulo está en VIN, y nada alimenta VIN (
module_on_vin). VIN (RAW en algunas placas) es la entrada del regulador de la placa. Solo tiene voltaje cuando se conecta una batería o un adaptador, no por USB. Mueve el VCC del módulo a 5V. - Un componente que usa el sketch no está conectado a nada (
part_not_wired). El código le habla, pero ninguno de sus pines está conectado. Conecta sus pines de alimentación, tierra y señal a la placa. - Un módulo está alimentado con un voltaje demasiado bajo (
module_low_supply). Alimenta su VCC desde 5V (VIN en un ESP32 DevKit). Si su salida entonces llega a 5 V y va a una placa de 3.3 V, agrega un divisor (1 kΩ y 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. - Una salida está conectada directo a un riel (
output_to_rail). Un pin de la placa configurado como salida va directo a GND o a 5V, así que se cortocircuita cuando el código lo impulsa al estado contrario. Pon el componente, con su resistencia, entre el pin y el riel. - Dos salidas en un mismo cable (
two_outputs). Dos salidas pelean cuando una dice HIGH y la otra LOW. Conecta una salida solo a entradas. - Un potenciómetro puede cortocircuitar la fuente (
pot_short). Su pin del medio está en 5V o GND, así que girado al extremo los une. Conecta los dos pines externos a la fuente y a tierra, y lee el pin del medio.
LEDs y otros componentes
- Un LED no tiene resistencia (
led_resistor). Los LEDs reales se queman sin una. El botón de corrección pone una resistencia de 220 Ω en serie. Los LEDs encadenados pata con pata cuentan como una sola cadena: una resistencia en cualquier punto de ella basta, y no tenerla es este hallazgo, en el LED más cercano al pin. - La resistencia es demasiado grande (
led_dim_resistor). Pasa tan poca corriente que el LED casi no alumbra. Un proyecto de Wokwi puede traer este valor y verse bien ahí, porque Wokwi enciende un LED sin importar su resistencia. El botón de corrección pone un valor que lo enciende. - La resistencia es demasiado pequeña (
led_small_resistor). Demasiada corriente pasa por el LED y el pin. Revisa la tercera banda de color: 22 Ω y 220 Ω solo difieren ahí. El botón de corrección pone 220 Ω. - Un LED está al revés (
led_reversed). Su ánodo (A, la pata más larga) está en GND, y su cátodo apunta al pin, directamente, a través de una resistencia o de otro LED. Voltéalo. El botón de corrección intercambia sus dos cables. - Ambas patas de un LED en una misma red (
led_shorted). Ambas patas están en GND, en un mismo pin, o metidas en la misma tira de la protoboard, así que el LED nunca puede encender. Mueve una pata: A a su pin a través de una resistencia, C a GND. Una resistencia entre una pata y GND también cuenta: el botón de corrección mueve el otro extremo de la resistencia a un pin libre. - El cátodo de un LED en la fuente (
led_cathode_to_supply). Su pata corta (C) está en 3V3 o 5V (a menudo el riel +) y su pata larga en un pin. Un pin no sube más que la fuente, así que nunca enciende. Mueve C a GND (el riel -). El botón de corrección mueve ese cable al GND de la placa. Un LED con A en la fuente y C en el pin, encendido con un LOW, está bien y no es esto. - Una resistencia que no hace nada (
resistor_dangling). Un extremo no está conectado a nada, o ambos extremos están en la misma red, así que no pasa corriente por ella. Una resistencia para un LED va en serie: pin, resistencia, el ánodo del LED. Donde un pin está conectado directo al LED de al lado, el botón de corrección mueve ese cable al extremo libre de la resistencia. Una resistencia conectada a nada en absoluto recibe un consejo: conéctala o bórrala. - Un pin que solo impulsa una resistencia a GND (
pin_to_ground_resistor). El código impulsa el pin como salida, y su único componente es una resistencia directo a GND, así que nada enciende. Pon el LED después de la resistencia: pin, resistencia, A, y luego C a GND. Una resistencia pull-down en un pin de entrada está bien y no es esto. - Un capacitor electrolítico está al revés (
capacitor_reversed). Su pata rayada está en el voltaje más alto. El simulador no muestra nada, pero uno real gotea, se calienta y puede reventar. El botón de corrección lo voltea. - Un botón que no cambia nada (
button_same_side). Ambos cables están en patas que siempre están unidas dentro del botón. Mueve un cable a una pata del otro lado, o gira el botón un cuarto de vuelta. El botón de corrección mueve un cable por ti. - Un motor o servo en un pin GPIO (
motor_on_gpio). Un pin da unos pocos miliamperios y un motor quiere cientos. Alimenta el VCC de un servo desde 5V y deja solo su señal en un pin (el botón de corrección lo mueve a 5V). Maneja un motor con un transistor o un driver de motores como el L298N. - Un motor conectado al revés (
motor_reversed). Dos motores en un driver, con los dos cables de un motor cruzados, así que el mismo código los gira en sentidos opuestos y un auto gira en lugar de avanzar recto. Intercambia los dos cables de ese motor, o sus dos pines IN en el código; el botón para corregirlo intercambia los cables. Los motores dibujados enfrentados, como los dos lados de un auto, deben ir cruzados, y el Chequeo lo sabe: ahí, dos motores cableados igual reciben este hallazgo, porque el auto gira sobre su propio eje. - I2C en los pines equivocados (
i2c_pins). SDA y SCL están intercambiados, o no están en los pines que la placa usa para I2C. El hallazgo indica los pines correctos, y el botón para corregirlo mueve o intercambia los cables. - Un componente se quemó o se llevó al límite de su especificación (
part_damaged). El componente se ve oscuro, o con un aro ámbar si se le perdonó una vez. El hallazgo dice qué midió frente a su límite. Corrige la causa, luego presiona Detener y Ejecutar: cada componente vuelve a empezar intacto.
Pines y código
- El código y el cable usan pines distintos (
pin_mismatch). Los botones para corregirlo cambian el número en el código, o mueven el cable. - Una biblioteca usa un pin distinto del cable (
library_pin). Por ejemplo un servo conectado en el código a un pin y cableado a otro. Haz que los dos coincidan. - Un pin que usa el código no tiene nada conectado (
pin_unwired), o un componente cableado que el código nunca usa (pin_unused). Conecta el componente al pin que usa el código, o cambia el código. - Falta
pinMode(pinmode_missing). Un pin escrito condigitalWritesigue siendo entrada, así que un LED en él brilla débilmente o nada. AgregapinMode(pin, OUTPUT);ensetup(). pinModeestá configurado al revés (pinmode_wrong). El código escribe en un pin configurado como entrada, o lee un botón en un pin configurado como salida.analogReaden un pin sin entrada analógica (analog_pin), oanalogWriteen un pin sin PWM (pwm_pin). El hallazgo lista los pines que sí pueden.- Un botón deja su pin flotante (
button_floating). Sin nada que sostenga el pin, este lee valores aleatorios. UsaINPUT_PULLUPy conecta el botón a GND; así el pin lee LOW mientras está presionado. Una segunda forma dice que el botón va a la alimentación mientrasINPUT_PULLUPya sostiene el pin en HIGH: conéctalo a GND en su lugar. - Un pin sin resistencia de pull interna (
pin_no_pull). En un ESP32, GPIO 34 a 39 no la tienen, así queINPUT_PULLUPno hace nada ahí. Agrega una resistencia de 10 kΩ, o mueve el botón a un pin que la tenga. - Un pin que funciona aquí pero no en un ESP32-S3 real (
s3_reserved_pin). En las placas ESP32-S3 con PSRAM octal (la N8R8 y la N16R8 que compra la mayoría), GPIO 35, 36 y 37 pertenecen a la PSRAM, y GPIO 19 y 20 son el D- y D+ del puerto USB. Mokxi no tiene PSRAM, así que un componente o código en esos pines funciona aquí, pero en una placa real no. Muévelo a un pin libre como el 39 y cambia el pin en el código. Consulta la ESP32-S3-DevKitC-1. - Un componente en el pin 0 o 1 (
serial_pin_used). En un Uno, Nano, Mega o Pro Mini esos pines son RX y TX, conectados al chip que carga los sketches. Funciona en Mokxi, pero en una placa real el componente puede impedir la carga y hacer que el Serial salga con basura. Muévelo a un pin libre y cambia el número de pin en el código. - Un módulo serie en los pines 0 y 1 (
serial_module_upload). Un consejo, no un error. En un Uno, Nano o Pro Mini, el TX y RX de un módulo en los pines 0 y 1 comparten el Serial con el USB. Funciona, aquí y en la placa, pero en una placa real desconéctalo del pin 0 mientras cargas, o muévelo a otros dos pines con SoftwareSerial. - El TX o RX de un módulo en un pin que no lleva datos (
serial_power_pin). El pin TX o RX de un módulo (de Bluetooth, GPS o GSM, por ejemplo) está en IOREF, RESET, AREF, 5V, 3V3, VIN o GND, así que nunca podrá comunicarse con la placa. Conecta su TX al RX de la placa y su RX al TX de la placa (pines 0 y 1 en un Uno), o a otros dos pines con SoftwareSerial.
Serial y temporización
- Falta
Serial.begin(serial_begin). Nada llega al monitor serie hasta que el puerto se inicia. El botón para corregirlo agregaSerial.begin(9600);. - Las velocidades de baudios no coinciden, o una es poco común (
serial_baud). El código habla a una velocidad y el monitor serie escucha a otra, así que la salida es basura: el botón para corregirlo pone la velocidad del monitor en el código. OSerial.beginusa una velocidad que no es estándar, así que un monitor serie real mostraría basura: el hallazgo sugiere la velocidad estándar más cercana. - Un tiempo de
millis()guardado en unint(millis_overflow), o una comprobación de tiempo que falla cuandomillis()se desborda. Guarda los tiempos en ununsigned long, y comparamillis() - startcon el intervalo en lugar de sumar. El botón para corregirlo cambia el tipo. - Un
delay()largo puede perder una pulsación de botón (delay_button). Un consejo, no un error. Cronometra conmillis()y aplica antirrebote al botón.
El circuito en conjunto
- El circuito no se puede leer como está dibujado (
circuit_unreadable). El detalle dice por qué. Deshaz el último cambio, o borra el cable o componente que menciona. - Un cable no lleva a ningún lado (
wire_nowhere). Un extremo apunta a un pin que no existe. La ejecución deja el cable fuera. Bórralo, o dibújalo de nuevo. - Un componente que este simulador no conoce (
part_unknown). Si la página es más antigua que el componente, Recargar lo trae y conserva tu trabajo. Si no, la ejecución lo deja fuera, así que quítalo si no debería estar ahí. - Parte del circuito nunca se estabilizó (
circuit_unsettled). Algunos cables seguían cambiando sin nada que los frenara, así que el simulador los retuvo y siguió ejecutando. Lo que muestran esos componentes puede no coincidir con un circuito real. Revisa si hay dos componentes unidos en un lazo, o las dos patas de un componente en la misma fila de la protoboard.
¿Sigue atascado?
Presiona Explicar en un hallazgo para preguntarle a Mokxi AI sobre él (usa una pregunta), o consulta no enciende nada para las comprobaciones que el Chequeo no puede hacer. Si un hallazgo parece incorrecto para tu circuito, escríbenos desde /support con su código y un enlace al proyecto.