Olá,
Bem-vindo ao Fórum Arduíno.
Esse guia explica como obter o melhor do Fórum. Por favor leia as instruções abaixo.
Sendo novo aqui, você pode pensar que regras são apenas uma formalidade, mas não é o caso. Se você não seguir as orientações, haverá uma longa troca de postagens tentando fazer com que você nos dê as informações que precisamos, o que é frustrante para você e frustrante para nós. Já se você cooperar, teremos condições de colocar o seu projeto em funcionamento rapidamente.
Sem as informações adequadas, será difícil ou impossível oferecer a ajuda que você precisa.
Tenha em mente que as pessoas que tentarão ajudá-lo são voluntários, que fazem isso de graça em seu tempo livre.
Idioma Preferido
Se Português não for o seu idioma, existem tópicos em outras línguas.
O Básico
Abaixo estão algumas coisas que geralmente não são observadas por quem posta pela primeira vez.
Escolha a categoria correta do Fórum
Se você for postar em inglês, na área geral do Fórum existem várias categorias diferentes para você escolher. Escolher a correta é importante porque nem todo mundo que pode ajudar lê todas as categorias.
Algumas questões cabem em mais de uma categoria, mas POR FAVOR não poste a mesma questão em duas ou mais categorias. Do mesmo jeito, se você tem mais de uma questão relacionada ao mesmo projeto é melhor que elas fiquem no mesmo post. Mantê-las juntas ajuda a obter melhores respostas à medida em que oferecem um contexto mais completo sobre o seu projeto.
Perguntar a mesma coisa várias vezes ou criar diferentes tópicos sobre a mesma pergunta é contra as regras do fórum e irritará bastante os moderadores.
Hardware
Nós precisamos saber exatamente qual é o hardware que você tem. Qual modelo de placa Arduíno (ou de outra marca, como ESP32) você está usando e quais outros sensores você está conectando nela. Quanto mais detalhes nós tivermos, mais fácil será para ajudarmos.
Se você estiver usando um produto que não é Arduíno, é importante fornecer um link com os dados técnicos dele (data sheet) ou para o site onde você o comprou.
Problemas de Código
Nós só conseguiremos encontrar problemas no seu código se tivermos acesso a ele. Por favor forneça seu código completo, usando a formatação de código <CODE/>. Se você estiver usando o Arduino Create, você também pode postar um link para o seu projeto (mas tenha em mente que nem todo mundo usa o Arduino Create).
Postar um trecho do código geralmente é inútil. O problema está quase sempre em outra parte do programa.
Antes de postar código, por favor use Ferramentas / Auto Formatação no topo da IDE (Interface Integrada de Desenvolvimento) do Arduíno. Isso torna o código bem mais fácil de ser lido e você mesmo provavelmente acabará achando útil. Uma vez feito isso, use editar / copiar para o Fórum.
Sempre use a formatação de código <CODE/> quando estiver postando código ou mensagens de erro do compilador. Usar esse formato torna o código mais fácil de ser lido e copiado. Não usar o formato implica na aparição de carinhas sorrindo e outras coisas que não deveriam estar lá. Esteja atento para o fato de que há um limite de 120.000 caracteres para uma postagem. Se seu código for maior que esse limite, você pode adicionar o seu arquivo .ino como um anexo. No entanto, será muito mais fácil de ajudarmos se você puder escrever e postar um pequeno programa que ilustre o problema que você está tendo.
Por favor não poste imagens do seu código ou de erros do compilador. Poste o código ou os erros usando a formatação de código.
É muito importante que você esclareça o que o código deveria estar fazendo e o que ele está fazendo de fato. O código SEMPRE funciona, é a natureza dele realizar o que foi programado. Se ele está fazendo o que você queria é outra coisa. Nós precisamos saber a diferença entre o que você queria e o que está acontecendo.
Esquemáticos ou diagramas de circuitos
A linguagem da eletrônica são os esquemáticos ou diagramas do circuito. Longas descrições do que está conectado aonde são geralmente inúteis. Um esquemático é um desenho de como os elementos do circuito estão conectados um ao outro. Faça um e nos mostre. Não nos importamos se ele for feito à mão, com traços desalinhados ou usando símbolos incorretos. Por favor não poste diagramas do Fritzing. Eles são bonitos, mas não trazem as informações necessárias e podem ser facilmente mal interpretados.
Se você quiser usar um programa de computador para criar um esquemático, então você pode experimentar o Eagle ou o KiCad.
Dica Geral
Evite postar links para outros sites que abriguem código ou fotos. A maioria de nós não clicará nesses links, não só pelo risco de que eles contenham vírus, mas também para que todo conteúdo necessário permaneça no Fórum, beneficiando outros usuários que tenham questões semelhantes.
Pesquise
Antes de postar, pesquise sobre sua dúvida no mecanismo de busca do Fórum. A maioria dos problemas encontrados por iniciantes já foram tratados anteriormente, de modo que a resposta para sua pergunta pode já existir. Você também pode usar o motor de busca de sua preferência.
Seja claro
Faça perguntas específicas sobre o problema que você está tendo, a fim de que possamos oferecer uma resposta clara. Se você não entender alguma das sugestões que receber, avise, para que possamos explicar com maiores detalhes.
Sobre a gente
As pessoas que estão respondendo às perguntas possuem uma ampla variedade de formações e experiências, quer seja por terem trabalhado em eletrônica e computação ou por terem isso como hobby. Poucos são professores, então provavelmente a maioria não terá muita didática para explicar as coisas de maneira efetiva. Salvo raras exceções, nós não somos empregados ou representantes da Arduíno.
Lembre-se que as pessoas que tentarão ajudá-lo são voluntários, que fazem isso de graça em seu tempo livre.
Sobre você
Tudo o que sabemos sobre você é aquilo que você está nos dizendo. Se você nos contar sua experiência com eletrônica ou programação, tentaremos adequar o nível da resposta ao seu conhecimento. Se você não nos contar, não saberemos.
Postando código e problemas comuns
Poste todo o seu código
Sem termos o seu código, ou melhor, todo o seu código, não podemos oferecer nada além de respostas vagas e que provavelmente não ajudam. Uma das coisas chatas de escrever programas é que um erro em uma parte do código pode provocar problemas em outra parte completamente diferente. Isso é um pesadelo se você for novato, mas quem tem mais experiência facilmente identifica o problema. Esse é o motivo pelo qual a gente quer todo o seu código, não apenas o pedaço com erro ou que você acredita que está provocando o erro.
Formate seu código
Antes de copiar seu código da IDE para o Fórum, procure nas Ferramentas do menu a opção "Auto Formatar". Isso ajustará o código para o formato correto. Se você preferir, Ctrl+T fará a mesma coisa. Uma vez formatado, o código pode ser copiado e colado no Fórum, usando a formatação de código.
Use a formatação de código
O código deve ser postado usando a formatação de código. Ela tem esse símbolo <CODE/> na barra de ferramentas que fica acima do campo onde você edita seu post. Quando formatado corretamente, o código aparece assim:
char message[][4] = { "hi", "bye" };
void setup() {
//Serial.begin() configures the serial port
Serial.begin(9600);
}
void loop() {
for (byte x = 0; x < 2; x++) {
Serial.println(message[x]);
delay(1000);
}
}
Se você não usar a formatação de código, vai ficar assim:
char message[][4] = { "hi", "bye" }; // <---- Tem uma caixa aqui
void setup() {
//Serial.begin () configures the serial port // <---- Algum link estranho
Serial.begin(9600); // <---- Perdeu a indentação
}
void loop() {
for (byte x = 0; x < 2; x++) {
Serial.println(message[x]); // <---- Marcaram com x essa opção
delay(1000);
}
}
Existe mais de uma maneira de colocar o código dentro da formatação de código, você pode:
-
Colar o código na caixa de edição, selecioná-lo e clicar em
<CODE/> -
No menu Editar da IDE do Arduíno existe a opção "Copiar para o Forum". Isso coloca o código na área de transferência do computador já com a formatação de código, pronto para ser colado no seu post.
Exemplo mínimo replicável
O Fórum tem um limite de 120.000 caracteres por post, o que quer dizer que você não pode postar diretamente um código maior do que isso. Se isso acontecer, você pode anexar seu arquivo .ino no seu post ou, se estiver usando o Arduino Create, um link para seu projeto.
Note que quanto maior for o programa, maior é a dificuldade de alguém entender e ajudar. Por isso, considere a possibilidade de escrever um pequeno código que replique o problema e poste ele ao invés do código maior. Será mais fácil obter ajuda com um programa pequeno e fácil de entender do que com um longo e mais complicado.
Mensagens de erro
Quando você compila seu código, a IDE do Arduíno verifica a existência de problemas e gera mensagens de erro que apontam o que foi encontrado. Elas oferecem pistas para a identificação dos problemas e nós precisamos vê-las também. No canto direito inferior da IDE existe um botão para copiar as mensagens de erro. Clique nele e cole o resultado no seu post. Não se esqueça de usar a formatação de código.
Erros comuns em códigos e na postagem de códigos
A captura de tela do código ou das mensagens de erro não ajuda, porque ela não pode ser coladas como texto em outros lugares. Para podermos testar seu código, precisamos conseguir copiá-lo e colá-lo em nossos computadores. Poste o código e as mensagens de erro, não fotos deles.
De um modo geral, problemas em códigos não ficam exatamente onde parecem estar. Um erro em um pedaço do programa pode criar problemas em outro pedaço. A única maneira de lidarmos com essa situação é vendo seu código completo. Tenha em mente também que um mesmo problema pode provocar múltiplos erros. Se isso acontecer, tente resolver o primeiro deles para ver se os demais desaparecem.
É essencial que cada chave { ou parêntese ( aberto tenha o seu correspondente ) fechando a declaração }. Na IDE, se você colocar o cursor em cima de qualquer tipo de chave ou parêntese verá um retângulo indicando sua contraparte. Se não houver uma contraparte ou se for indicada uma diferente da que você esperava, então você achou um problema. Se você usar a auto formatação do código, os pares serão conectados e será bem mais fácil identificar algum que tenha sido esquecido.
Regras do Fórum e netiqueta
As instruções abaixo são para ajudá-lo a obter sucesso em seu post, ou seja, obter uma resposta útil e satisfatória para sua questão. Para mantermos o Fórum funcionando tranquilamente há algumas regras que se aplicam a todos e que se forem quebradas podem resultar em suspensão ou banimento do Fórum.
Faça sua pergunta apenas uma vez e em uma categoria
Nós sabemos que você está ansioso por uma resposta, mas postar a mesma questão em categorias diferentes duplica os esforços e divide o foco de quem está tentando ajudar. Será bem mais produtivo se todos puderem discutir sua questão juntos no mesmo tópico. Fazer a mesma pergunta em diferentes tópicos ou categorias é chamado de "cross-posting" e chateia bastante as pessoas. Se você fizer isso, os moderadores vão apagar as postagens duplicadas e você será advertido. Evite aborrecimentos e poste a pergunta uma única vez.
Não se aproprie de um tópico existente, comece um novo
Pode ser que você encontre um tópico relacionado ao que você quer perguntar e sinta vontade de adicionar sua pergunta nele. Não faça isso. Se você encontrou a solução para o seu problema, a nova postagem não é necessária. Se você não encontrou, então abra um novo tópico. Não há problema em incluir um link para a discussão anterior se você achar que é relevante.
Não perturbe!
Não tente obter uma resposta de maneira insistente. Por causa dos diferentes fusos horários, a pessoa que sabe a resposta pode estar dormindo, sem internet ou mesmo em férias. Talvez após uns dois dias valha a pena se perguntar ou nos perguntar se você realmente ofereceu todas as informações quer eram necessárias.
Pedindo ajuda a uma pessoa específica
Uma pessoa específica pode ter dado respostas que interessam a você e que podem te ajudar. Você pode chamar a atenção dessa pessoa para a sua pergunta usando @ mais o nome de usuário dela. Por exemplo: @nomedousuário. Se você fizer isso, essa pessoa recebe uma notificação.
Não envie sua pergunta em uma mensagem privada para alguém que você não conhece. Ela será ignorada pela maioria das pessoas.
Projetos comerciais
Uma coisa que certamente fará com que você não receba qualquer ajuda é dizer que você não pode dar detalhes de seu projeto porque ele é confidencial. Se o projeto é comercial e não pode ser divulgado, então contrate alguém para fazê-lo e certifique-se que haja uma cláusula de confidencialidade no contrato. Há uma categoria específica para isso na parte internacional do Fórum. O Fórum é destinado a hobbystas, não a trabalhar de graça para os outros.
Código pronto
Não existe programa pronto que sirva para tudo. Pedir que alguém escreva o programa para você não vai te levar a lugar algum e pode resultar em uma resposta malcriada. Ou você escreve seu próprio programa e nos diz onde você tem dúvidas, ou paga alguém para escrever o programa para você. Se você não quer aprender e nem quer pagar, veio ao lugar errado.
Seja educado
Cortesia e educação não fazem mal a ninguém. Mesmo que você receba uma pergunta repetida ou não entenda uma resposta dada, tente manter a calma. Muitas pessoas que respondem frequentemente no Fórum lidam com as mesmas perguntas todos os dias e podem ser ríspidas se acharem que você não está se esforçando o suficiente. Mantenha a tranquilidade e muito provavelmente você terá seu problema resolvido. Insultos, grosserias e palavrões não são aceitáveis e resultarão em banimento. Concentre-se no problema.
NÃO GRITE
ESCREVER COM LETRAS MAIÚSCULAS é entendido como gritar. Isso não fará com que você tenha uma resposta mais rápida, vai apenas aborrecer os outros.
Deveres escolares
Nós recebemos muitas perguntas de estudantes tentando resolver seus deveres de casa. Essas perguntas são geralmente de dois tipos: as de estudantes que estão claramente fazendo algum esforço, mas estão tendo dificuldades (essas são respondidas); e as de estudantes preguiçosos que querem que nós façamos o dever casa para eles (esses normalmente recebem uma bronca). Se você tiver dúvidas sobre seu dever de casa, peça ajuda, mas certifique-se de ter se esforçado antes.
Agradeça as pessoas que te ajudaram
Aqueles de nós que estão respondendo aqui estão fazendo isso de graça, apenas pelo prazer de compartilhar o conhecimento. Agradeça as pessoas que lhe derem respostas úteis e não esqueça de curtir 
essas respostas.
Também ajuda se você marcar a resposta que melhor lhe atendeu, apertando o botão 
Solução abaixo dela. Isso fará com que outras pessoas com a mesma questão encontrem mais facilmente a resposta.
Créditos
O presente texto é uma tradução livre do tópico How to get the best out of this forum escrito por @PerryBebbington. Traduzido para o Português por @Brazilino .