O que você vê
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 Checkup). Cada apontamento é um cartão marcado 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 apontamento abaixo tem seu código curto entre colchetes. Você nunca vai precisar dele; ele está aí para você ligar um apontamento a esta página, ou citá-lo quando você escreva para nós.
Alimentação e terra
- Uma fonte está ligada direto ao terra (
short_circuit). Um fio, ou uma trilha da protoboard, une 5V ou 3V3 ao GND. Numa placa real isso aquece os fios e pode queimar a porta USB. Tire o fio (o botão Remover esse fio faz isso), ou mova o componente para que os dois pinos caiam em trilhas diferentes. Uma segunda forma diz que duas fontes diferentes compartilham um fio: use uma fonte por trilha. - Dois terras não estão unidos (
ground_not_shared). Um componente recebe energia de uma bateria ou de uma fonte, mas seu terra não chega ao GND da placa, então o sinal não tem caminho de volta. Mantenha a fonte e adicione um fio do terra dela ao GND da placa. O botão de correção desenha esse fio. - Um módulo está sem terra ou sem alimentação (
module_no_gnd,module_no_vcc). Seu pino GND ou VCC não está conectado, ou vai para um lugar que não é terra nem fonte. Ligue o GND ao GND da placa, e o VCC a 5V ou 3V3, o que o componente pedir. - A alimentação de um módulo está no VIN, e nada alimenta o VIN (
module_on_vin). VIN (RAW em algumas placas) é a entrada do regulador da placa. Ele só tem tensão quando uma bateria ou adaptador está ligado a ele, não no USB. Mova o VCC do módulo para 5V. - Um componente que o sketch usa não está ligado a nada (
part_not_wired). O código conversa com ele, mas nenhum de seus pinos está conectado. Ligue seus pinos de alimentação, terra e sinal à placa. - Um módulo está alimentado com tensão baixa demais (
module_low_supply). Alimente o VCC dele com 5V (VIN num ESP32 DevKit). Se a saída dele então variar até 5 V e for para uma placa de 3.3 V, adicione um divisor (1 kΩ e 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. - Uma saída está ligada direto a uma trilha (
output_to_rail). Um pino da placa configurado como saída vai direto ao GND ou ao 5V, então ele curto-circuita quando o código o puxa para o outro lado. Coloque o componente, com seu resistor, entre o pino e a trilha. - Duas saídas num mesmo fio (
two_outputs). Duas saídas brigam quando uma diz HIGH e a outra LOW. Conecte uma saída só a entradas. - Um potenciômetro pode curto-circuitar a fonte (
pot_short). O pino do meio dele está no 5V ou no GND, então, girado até o fim, ele os une. Ligue os dois pinos externos à fonte e ao terra, e leia o pino do meio.
LEDs e outros componentes
- Um LED está sem resistor (
led_resistor). LEDs reais queimam sem um. O botão de correção coloca um resistor de 220 Ω em série. LEDs encadeados perna com perna contam como uma só cadeia: um resistor em qualquer ponto dela basta, e a ausência dele gera este achado, no LED mais próximo do pino. - O resistor é grande demais (
led_dim_resistor). Tão pouca corrente passa que o LED fica quase apagado. Um projeto vindo do Wokwi pode trazer esse valor e parecer certo lá, porque o Wokwi acende um LED seja qual for o resistor. O botão de correção define um valor que o acende. - O resistor é pequeno demais (
led_small_resistor). Corrente demais passa pelo LED e pelo pino. Confira a terceira faixa de cor: 22 Ω e 220 Ω só diferem nela. O botão de correção define 220 Ω. - Um LED está invertido (
led_reversed). Seu anodo (A, a perna mais longa) está no GND, e seu catodo aponta para o pino, diretamente, por um resistor ou por outro LED. Vire-o. O botão de correção troca seus dois fios. - As duas pernas de um LED num mesmo nó (
led_shorted). As duas pernas estão no GND, num mesmo pino, ou enfiadas na mesma trilha da protoboard, então o LED nunca acende. Mova uma perna: A para o pino passando por um resistor, C para o GND. Um resistor entre uma perna e o GND ainda conta: o botão de correção move a outra ponta do resistor para um pino livre. - O catodo de um LED na alimentação (
led_cathode_to_supply). Sua perna curta (C) está no 3V3 ou no 5V (geralmente a trilha +) e sua perna longa num pino. Um pino não passa da alimentação, então ele nunca acende. Mova C para o GND (a trilha -). O botão de correção move esse fio para o GND da placa. Um LED com A na alimentação e C no pino, aceso por um LOW, está certo e não é isto. - Um resistor que não faz nada (
resistor_dangling). Uma ponta não está conectada a nada, ou as duas pontas estão no mesmo nó, então nenhuma corrente passa por ele. Um resistor de LED vai em série: pino, resistor, anodo do LED. Onde um pino está ligado direto ao LED ao lado, o botão de correção move esse fio para a ponta livre do resistor. Um resistor ligado a nada ganha uma dica: ligue-o ou apague-o. - Um pino alimentando só um resistor para o GND (
pin_to_ground_resistor). O código usa o pino como saída, e seu único componente é um resistor direto ao GND, então nada acende. Coloque o LED depois do resistor: pino, resistor, A, e C para o GND. Um resistor de pull-down num pino de entrada está certo e não é isto. - Um capacitor eletrolítico está invertido (
capacitor_reversed). Sua perna listrada está na tensão mais alta. O simulador não mostra nada, mas um real vaza, esquenta e pode estourar. O botão de correção o vira. - Um botão que não muda nada (
button_same_side). Os dois fios estão em pernas que ficam sempre unidas dentro do botão. Mova um fio para uma perna do outro lado, ou gire o botão um quarto de volta. O botão de correção move um fio para você. - Um motor ou servo num pino GPIO (
motor_on_gpio). Um pino fornece alguns miliampères e um motor quer centenas. Alimente o VCC de um servo com 5V e deixe só o sinal dele num pino (o botão de correção o move para 5V). Acione um motor através de um transistor ou de um driver de motor como a L298N. - Um motor ligado ao contrário (
motor_reversed). Dois motores num mesmo driver, com os dois fios de um motor cruzados, então o mesmo código os gira em sentidos opostos e o carro gira em vez de seguir reto. Troque os dois fios desse motor, ou os dois pinos IN dele no código; o botão de correção troca os fios. Motores desenhados frente a frente, como os dois lados de um carro, devem ser cruzados, e o Checkup sabe disso: nesse caso, dois motores ligados do mesmo jeito geram este achado, porque o carro gira no próprio eixo. - I2C nos pinos errados (
i2c_pins). SDA e SCL estão trocados, ou não estão nos pinos que a placa usa para I2C. O achado indica os pinos certos, e o botão de correção move ou troca os fios. - Um componente queimou, ou passou do seu limite (
part_damaged). O componente aparece escuro, ou com um anel âmbar quando foi poupado uma vez. O achado diz o que foi medido em comparação com o limite. Corrija a causa e aperte Parar e Rodar: todo componente começa inteiro de novo.
Pinos e código
- O código e o fio usam pinos diferentes (
pin_mismatch). Os botões de correção mudam o número no código, ou movem o fio. - Uma biblioteca usa um pino diferente do fio (
library_pin). Por exemplo, um servo ligado por código a um pino e conectado a outro. Faça os dois concordarem. - Um pino usado pelo código não tem nada ligado nele (
pin_unwired), ou um componente ligado que o código nunca usa (pin_unused). Ligue o componente ao pino que o código usa, ou altere o código. - Falta
pinMode(pinmode_missing). Um pino escrito comdigitalWritecontinua como entrada, então um LED nele acende fraco ou nada. AdicionepinMode(pin, OUTPUT);emsetup(). pinModeestá configurado do jeito errado (pinmode_wrong). O código escreve num pino configurado como entrada, ou lê um botão num pino configurado como saída.analogReadnum pino sem entrada analógica (analog_pin), ouanalogWritenum pino sem PWM (pwm_pin). A verificação lista os pinos que podem.- Um botão deixa o pino flutuando (
button_floating). Com nada segurando o pino, ele lê valores aleatórios. UseINPUT_PULLUPe ligue o botão ao GND; assim o pino lê LOW enquanto pressionado. Uma segunda forma diz que o botão vai para a alimentação enquantoINPUT_PULLUPjá mantém o pino em HIGH: ligue-o ao GND. - Um pino sem resistor de pull interno (
pin_no_pull). Num ESP32, GPIO 34 a 39 não têm, entãoINPUT_PULLUPnão faz nada ali. Adicione um resistor de 10 kΩ, ou mude o botão para um pino que tenha. - Um pino que funciona aqui mas não num ESP32-S3 de verdade (
s3_reserved_pin). Nas placas ESP32-S3 com PSRAM octal (a N8R8 e a N16R8 que a maioria compra), GPIO 35, 36 e 37 pertencem à PSRAM, e GPIO 19 e 20 são o D- e o D+ da porta USB. O Mokxi não tem PSRAM, então um componente ou código nesses pinos funciona aqui, mas numa placa de verdade não. Mude para um pino livre como o 39 e altere o pino no código. Veja o ESP32-S3-DevKitC-1. - Um componente no pino 0 ou 1 (
serial_pin_used). Num Uno, Nano, Mega ou Pro Mini esses pinos são RX e TX, ligados ao chip que faz upload dos sketches. Funciona no Mokxi, mas numa placa de verdade o componente pode travar o upload e bagunçar a Serial. Mude para um pino livre e altere o número do pino no código. - Um módulo serial nos pinos 0 e 1 (
serial_module_upload). Uma dica, não um erro. Num Uno, Nano ou Pro Mini, o TX e o RX de um módulo nos pinos 0 e 1 dividem a Serial com o USB. Funciona, aqui e na placa, mas numa placa de verdade desligue-o do pino 0 durante o upload, ou mude para outros dois pinos com SoftwareSerial. - O TX ou RX de um módulo num pino que não carrega dados (
serial_power_pin). O pino TX ou RX de um módulo (de Bluetooth, GPS ou GSM, por exemplo) está em IOREF, RESET, AREF, 5V, 3V3, VIN ou GND, então ele nunca vai conseguir falar com a placa. Ligue o TX dele ao RX da placa e o RX dele ao TX da placa (pinos 0 e 1 num Uno), ou a outros dois pinos com SoftwareSerial.
Serial e tempo
- Falta
Serial.begin(serial_begin). Nada chega ao monitor serial até a porta ser iniciada. O botão de correção adicionaSerial.begin(9600);. - As velocidades não combinam, ou uma é incomum (
serial_baud). O código fala numa velocidade e o monitor serial escuta em outra, então a saída vira lixo: o botão de correção coloca a velocidade do monitor no código. OuSerial.beginusa uma velocidade fora dos padrões, então um monitor serial de verdade mostraria lixo: a verificação sugere a velocidade padrão mais próxima. - Um tempo de
millis()guardado numint(millis_overflow), ou uma checagem de tempo que quebra quandomillis()passa do limite. Guarde tempos numunsigned long, e comparemillis() - startcom o intervalo em vez de somar. O botão de correção muda o tipo. - Um
delay()longo pode perder um aperto de botão (delay_button). Uma dica, não um erro. Marque o tempo commillis()e trate o bounce do botão.
O circuito como um todo
- O circuito não pode ser lido como está desenhado (
circuit_unreadable). O detalhe diz o porquê. Desfaça a última mudança, ou apague o fio ou componente indicado. - Um fio não vai a lugar nenhum (
wire_nowhere). Uma ponta aponta para um pino que não existe. A execução deixa o fio de fora. Apague-o, ou desenhe de novo. - Um componente que este simulador não conhece (
part_unknown). Se a página for mais antiga que o componente, Recarregar o traz e mantém seu trabalho. Caso contrário, a execução o deixa de fora, então remova-o se ele não deveria estar ali. - Parte do circuito nunca se estabilizou (
circuit_unsettled). Alguns fios ficaram alternando sem nada para desacelerá-los, então o simulador os segurou e continuou rodando. O que esses componentes mostram pode não corresponder a um circuito de verdade. Veja se há dois componentes unidos em loop, ou as duas pernas de um componente na mesma linha da protoboard.
Ainda travado
Aperte Explicar num achado para perguntar ao Mokxi AI sobre ele (isso usa uma pergunta), ou veja nada acende para as verificações que o Checkup não consegue fazer. Se um achado parecer errado para o seu circuito, escreva para nós em /support com o código dele e um link para o projeto.