Como conseguir lo mejor de este foro

Bienvenido al Foro de Arduino.
Esta guía explica cómo sacar el mejor provecho de este foro. Por favor, lee y sigue las instrucciones a continuación.

Si eres nuevo aquí, es posible que pienses que esto se trata de reglas por el mero hecho de tener reglas, pero ese no es el caso. Si no sigues las pautas, lo único que sucede es que hay un intercambio largo de publicaciones mientras intentamos que nos digas lo que necesitamos para ayudarte, lo cual es frustrante tanto para ti como para nosotros.

Las personas que intentan ayudar con tu proyecto son voluntarios que lo hacen de forma gratuita en su tiempo libre. Si sigues estas pautas, nos ayudas a ayudarte y tu proyecto comenzará a funcionar rápidamente.

Sin la información correcta, es difícil o imposible brindarte la ayuda que necesitas.

Idioma preferido
Si el español no es tu idioma preferido, hay categorías en otros idiomas

Esenciales

A continuación, hay algunas cosas que necesitamos y que a menudo las personas se olvidan de mencionar en su primera publicación:

Elige la categoría del foro correcta

Hay muchas categorías diferentes para elegir. Elegir la correcta es importante porque no todos los que podrían ayudarte leen todas las categorías. Algunas preguntas podrían encajar razonablemente en más de una categoría, pero por favor, no publiques la misma pregunta en dos o más categorías diferentes. Además, si tienes más de una pregunta pero todas las preguntas son sobre el mismo proyecto, generalmente es preferible mantener las preguntas en un solo tema. Mantenerlas juntas ayuda a obtener mejores respuestas, ya que la respuesta a una proporciona el contexto para la siguiente. Crear la misma pregunta varias veces o crear muchas preguntas diferentes sobre el mismo proyecto va en contra de las reglas del foro y provocará la ira de los moderadores cuando lo vean.

Hardware

Necesitamos saber exactamente qué hardware tienes. Necesitamos saber qué placa de Arduino (u otra marca, como ESP32) estás usando y exactamente qué otro hardware estás conectando a ella. Cuantos más detalles tengamos, más fácil será ayudarte.

Si estás utilizando algo que no es un producto de Arduino, ayuda tener un enlace a su hoja de datos técnicos o un enlace a donde lo compraste.

Problemas de código

Solo podemos encontrar problemas en el código que podemos ver. Por favor, proporciona tu código completo entre etiquetas de código . Más información sobre cómo publicar código y cómo usar etiquetas de código. Si estás utilizando Arduino Create, puedes publicar un enlace a tu proyecto (pero ten en cuenta que no todos usan Arduino Create).

Publicar un fragmento de código generalmente es inútil. El problema suele estar en otra parte del programa.

Antes de publicar el código, por favor, utiliza Herramientas / Formato Automático en la parte superior del IDE. Esto hace que el código sea mucho más fácil de leer y probablemente te resultará muy útil. Una vez que hayas hecho eso, utiliza Edición / Copiar para el foro.

Siempre utiliza etiquetas de código () al publicar código o mensajes de error del compilador.
El uso de etiquetas de código facilita la lectura del código y su copiado. No utilizar etiquetas de código hace que parte del código se muestre con caritas sonrientes y otras cosas que no deberían estar allí. Ten en cuenta que hay un límite de 120 000 caracteres para una publicación. Si tu código te lleva más allá de este límite, puedes agregar tu archivo .ino como un adjunto. Sin embargo, será mucho más fácil ayudarte si puedes escribir un programa corto que ilustre el problema que tienes y publicarlo.

Por favor, no publiques una imagen del código en lugar del código mismo, o una imagen de mensajes de error en lugar de los propios mensajes de error.

Es muy importante ser claro acerca de lo que se espera del código y lo que sucede en su lugar. El código SIEMPRE funciona; esa es la naturaleza del código. Lo que hace es otra cosa distinta. Necesitamos saber qué esperabas que hiciera el código y qué sucedió en cambio.
Más información sobre cómo publicar código y problemas de código comunes.

Mas acerca de postear códigos y sus problemas comunes.

Esquemáticos o diagramas de circuitos

El lenguaje de la electrónica es un esquema o diagrama de circuito. Las descripciones largas de lo que está conectado a qué generalmente son inútiles. Un esquema es un dibujo de lo que se conecta a qué; por favor, haz uno y fotográfialo. No nos importa si está dibujado a mano, es desordenado y no utiliza los símbolos correctos. Por favor, no publiques diagramas de Fritzing. Pueden verse bien, pero son muy fáciles de interpretar erróneamente.

Si deseas utilizar software de computadora para crear un esquema, es posible que desees probar Eagle o KiCad.
Más información sobre cómo crear un esquema de su proyecto, incluido cómo cargar una imagen.

Si deseas usar un software de computadora para crear un esquema, puedes probar Eagle o KiCad.
Más información sobre cómo crear un esquema de su proyecto, incluido cómo cargar una imagen.

General

Por favor, intenta evitar publicar enlaces a otros sitios donde se alojan código, fotos o esquemas. La mayoría de nosotros no seguiremos tales enlaces, en parte debido al riesgo de que contengan malware u otro contenido no deseado, en parte para mantener todo en este sitio para beneficio de futuros usuarios que buscan una respuesta a una pregunta similar, y en parte porque creemos que si quieres nuestra ayuda, debes proporcionarnos todo lo que necesitamos en este sitio y no esperar que vayamos a buscarlo en otro lugar.

Investigación

Por favor, investigue un poco antes de publicar. La mayoría de los problemas de principiantes ya se han resuelto en el foro, así que utilice la [herramienta de búsqueda del foro] (Search results for '' - Arduino Forum) y el [Centro de ayuda de Arduino] (https://support.arduino.cc) /hc/en-us) para tratar de encontrar una respuesta a su pregunta. También puede usar su motor de búsqueda favorito para encontrar respuestas.

Se específico

Por favor, haz una pregunta específica sobre el problema que tienes para que podamos proporcionarte una respuesta clara y específica.

Si no entiendes alguno de los consejos que recibes, por favor, dilo. Así podemos explicarlo con más detalle. Si quieres saber más sobre cómo hacer una pregunta que probablemente obtenga una respuesta realmente útil, entonces lee este tutorial, aunque sea bastante largo: Cómo hacer preguntas de manera inteligente 73 y utiliza los principios explicados allí para hacer una pregunta realmente efectiva aquí.

Contenido generado por IA

Los servicios de inteligencia artificial (IA), como ChatGPT, son capaces de generar código de proyectos de Arduino y respuestas a preguntas relacionadas con Arduino. Al igual que otras fuentes no autorizadas de información que se encuentran en Internet, esto debe utilizarse con precaución.

Preguntas sobre información proporcionada por una IA

Si deseas solicitar asistencia con código generado por IA o información aquí en el foro, por favor, identifica claramente la fuente.

Uso de contenido generado por IA para proporcionar asistencia

Cuando proporcionas asistencia, copiar y pegar contenido sin pensar en la información es irresponsable, independientemente de la fuente de esa información.

Evalúa cuidadosamente el contenido generado por IA en cuanto a precisión, relevancia y adecuación dentro del contexto antes de utilizarlo para proporcionar asistencia. Si no puedes realizar tal evaluación, por favor, no compartas el contenido aquí en el foro.

Sobre nosotros

Quienes respondemos preguntas tenemos una amplia variedad de antecedentes y conocimientos en electrónica, algunos a través del trabajo en electrónica o informática, otros a través de la electrónica o informática como pasatiempo, y algunos en ambos campos. La mayoría de nosotros no estamos capacitados como maestros, por lo que probablemente pasamos por alto los puntos más finos de cómo enseñar y explicar las cosas de manera efectiva. A excepción de algunos casos, no somos empleados o representantes de Arduino.
También recuerda que somos voluntarios que hacemos esto de forma gratuita en nuestro tiempo libre y estamos más inclinados a ayudar a las personas que nos facilitan brindar ayuda al proporcionar la información que solicitamos.

Acerca de ti

Solo sabemos sobre ti y tu proyecto lo que nos dices. Si nos cuentas tu nivel de experiencia en electrónica o microcontroladores, podemos adaptar nuestra respuesta a tu nivel de conocimiento. Tampoco sabemos si tienes problemas con el inglés o el lenguaje o la comunicación en general a menos que nos lo digas. Podemos ser comprensivos con cosas que conocemos, pero si no nos cuentas, no lo sabemos.

Mas información

Hay más información a continuación.

Haciendo tu primer posteo

Haciendo tu primera publicación
Ahora, por favor, ve al [Español - Arduino Forum), selecciona la categoría correcta y realiza tu primera publicación.

Gracias.

Haciendo tu primera publicación

1. Elige la categoría correcta

Es importante elegir la categoría correcta y el idioma adecuado para que las personas más capacitadas para ayudarte vean tu pregunta. No todos aquí leen preguntas en todas las categorías, así que tómate tu tiempo y publica en una categoría relacionada con tu pregunta.
Si el español no es tu idioma preferido, desplázate hacia abajo y elige una de las otras categorías de idioma.

Por favor, publica solo en inglés en las categorías de idioma inglés. Si tu idioma no aparece, utiliza Google Translate y publica en una categoría de idioma inglés utilizando el inglés.

2. Crea un tema

Una vez que hayas encontrado la categoría adecuada, puedes comenzar tu publicación. Haz clic en "Nuevo tema".

Starting a new topic

3. Escribe tu publicación

Ingresa un título y una descripción de tu problema:

No olvides incluir el código en etiquetas de código y un esquema de tu circuito.

Para tus dos primeras publicaciones, en el lado derecho del panel del compositor de publicaciones se mostrará un mensaje de bienvenida. Una vez que hayas cerrado ese mensaje, verás una vista previa de cómo se verá tu publicación una vez que la hayas enviado.

4. Publish your topic

Cuando estés satisfecho con tu publicación, haz clic en "+ Crear tema" para enviarla.

¡Eso completa tu primera publicación!

Publica todo tu código

Sin tu código, todo tu código, no podemos brindar ninguna respuesta sobre tu código, excepto las respuestas más vagas y probablemente poco útiles. Una de las cosas frustrantes de escribir código es que un error en un lugar puede producir un error en lo que parece ser un lugar completamente diferente e irrelevante. Esto es una pesadilla si eres nuevo en la escritura de código, pero a menudo es fácil de detectar para cualquier persona con experiencia en buscar ese tipo de problemas. Por esta razón, queremos todo tu código, no solo la parte con el error o la parte que crees que está causando el problema.

[ Formatea tu código

Antes de copiar tu código para el foro, ve a la opción "Herramientas" en la barra de menú del Arduino IDE y selecciona "Auto Formato". Esto formateará el código correctamente. Si lo prefieres, puedes usar Ctrl+T para hacer lo mismo. Una vez formateado, puedes copiar y pegar tu código con las etiquetas de código.

Usa etiquetas de código

El código debe estar dentro de etiquetas de código, que son <CODE/> en la barra de herramientas de arriba donde editas tu publicación, y formateado correctamente, como este ejemplo:

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);
  }
}

Si no utilizas etiquetas de código, el código se verá así:


char message[][4] = { "hi", "bye" }; // <---- There's a box now

void setup() {
//Serial.begin() configures the serial port // <---- Some strange link
Serial.begin(9600); // <---- Indentation lost
}

void loop() {
for (byte x = 0; x < 2; x++) {
Serial.println(message[x]); // <---- There's a checkbox
delay(1000);
}
}


Hay más de una forma de agregar etiquetas de código, puedes:

  • Pegar tu código en el cuadro donde estás editando tu publicación, seleccionar todo el código y hacer clic en <CODE/>.
  • En el IDE de Arduino, en el menú "Editar", hay una opción llamada "Copiar para el foro" que coloca tu código en el portapapeles con las etiquetas de código añadidas, listo para pegarlo en tu pregunta.

Ejemplo Mínimo y Reproducible

El foro tiene un límite de 120,000 caracteres por publicación, lo que significa que no puedes publicar un programa más largo que esto directamente. En este caso, puedes adjuntar el archivo .ino a tu publicación o, si estás utilizando Arduino Create, puedes publicar un enlace a tu proyecto.

Sin embargo, debes considerar que cuanto más largo sea tu programa, más difícil será para cualquier persona entenderlo y ayudarte. Por esta razón, considera escribir un programa corto que ilustre el problema y publicar o enlazar eso en su lugar. Es más probable que obtengas ayuda con un programa corto y fácil de entender que con uno largo y complicado. Para obtener más información sobre esto, consulta Cómo crear un Ejemplo Mínimo y Reproducible.

Mensajes de error

Cuando compiles tu código, el entorno de desarrollo integrado (IDE) de Arduino verificará si hay ciertos problemas con el código y generará mensajes de error para indicar cualquier problema que encuentre. Si esto sucede, necesitamos ver los mensajes de error junto con el código completo, ya que los mensajes de error ofrecen pistas sobre cuál es el problema. Si tienes mensajes de error, en la esquina inferior derecha del IDE habrá un botón "Copiar mensajes de error ". Haz clic en el botón y pega el resultado en tu pregunta, no olvides agregar las etiquetas de código.

Errores comunes con el código y su publicación

Publicar una captura de pantalla del código o de los mensajes de error. Una captura de pantalla no sirve de nada, ya que es imposible pegar el código en el IDE y probarlo. Por favor, publica tu código y los mensajes de error, no una imagen de los mismos.

Solo publicar la parte del código que crees que tiene el problema. A menudo, los problemas de código no están en el lugar donde parecen obviamente estar, a menudo un error en un lugar se manifiesta como un problema en otro lugar. La única forma de ver esto es ver todo el código. Además, ten en cuenta que algunos errores causan una cascada de múltiples errores. Si esto sucede, ocúpate del primero y verifica si los demás desaparecen.

Es esencial que cada llave de apertura tenga una llave de cierre correspondiente. Verifica que cada { tenga una } correspondiente, cada ( tenga una ) correspondiente y cada [ tenga una ] correspondiente antes de publicar tu código. En el IDE, si colocas el cursor junto a cualquier llave de cualquier tipo, el IDE dibujará un rectángulo alrededor de su pareja; si no hay una llave correspondiente, o hay una llave correspondiente pero no es la que esperabas, entonces has encontrado tu problema. Además, si utilizas el formato automático (Herramientas > Formato Automático o Ctrl+T), tu código se ordenará y las llaves faltantes de todo tipo deberían ser mucho más fáciles de identificar.

Reglas del Foro y netiquette

Las instrucciones anteriores están diseñadas para ayudarte a realizar una publicación exitosa, donde "exitosa" significa que obtienes una respuesta útil y satisfactoria a tu pregunta. Para mantener el funcionamiento fluido del foro, existen algunas reglas que se aplican a todos y su incumplimiento puede resultar en suspensión o eliminación del foro por completo.

Solo haz tu pregunta una vez, en una categoría del foro

Sabemos que tienes ansias de obtener una respuesta a tu problema, pero volver a publicar la misma pregunta en múltiples categorías del foro genera un esfuerzo duplicado y divide el enfoque en tu problema. Obtendrás una mejor respuesta si todos pueden discutirlo en un solo lugar. Hacer la misma pregunta varias veces se llama publicación cruzada (cross-posting). La publicación cruzada es muy molesta para las personas que intentan ayudarte. Si publicas de manera cruzada, los moderadores eliminarán tus publicaciones adicionales y recibirás una advertencia. Ahórrate todo el problema y simplemente publica la pregunta una vez. Será notada.

Si no estás seguro/a en qué categoría publicar (Preguntas de programación, Electrónica general, etc.), haz una suposición. No hagas una publicación cruzada "por si acaso".

Comienza un nuevo tema, no te apoderes del existente

Es posible que veas un tema existente relacionado con lo que quieres preguntar y pienses en etiquetar tu pregunta al final. Por favor, no lo hagas. Si la pregunta existente es justo lo que estabas buscando y la respuesta te ayuda, entonces no es necesario. De lo contrario, el tema existente no es lo que buscabas y deberías crear un nuevo tema. No hay ningún problema en incluir un enlace de regreso a la discusión existente si crees que tiene relevancia.

No hagas bump!

No actualices tu tema después de una hora. Debido a las diferentes zonas horarias, es posible que la persona que conoce la respuesta esté dormida, este ausente durante el día o de vacaciones. Quizás después de un par de días, pero incluso entonces, considera si has proporcionado suficiente información y has formulado una pregunta que pueda ser respondida. Incluso podrías preguntarnos "¿qué más puedo agregar para obtener ayuda?".

Obtener ayuda de una persona en particular

Es posible que hayas leído respuestas de una persona en particular y pienses que esa persona sería la mejor para ayudarte. Puedes llamar la atención de alguien usando @ seguido de su nombre de usuario, por ejemplo @nombredeusuario. Si lo haces, recibirán una notificación. Por favor, no envíes un mensaje privado (PM) a alguien que no conoces para hacer una pregunta; la mayoría te ignorará.

Proyectos comerciales

Una cosa que garantiza que no recibirás ayuda es decirnos que no puedes proporcionar toda la información porque es confidencial comercialmente. Si es confidencial comercialmente, deberías considerar pagarle a alguien para que te ayude y asegurarte de tener un acuerdo de confidencialidad con ellos. Si deseas ayuda con un proyecto comercial, crea un tema en Jobs and Paid Consultancy - Arduino Forum e indica cuáles son tus condiciones, incluido tu presupuesto. Este es un foro de aficionados, no un lugar para obtener ayuda gratuita con proyectos comerciales.
Crearemos una sección en el foro en Español.

Código ya escrito

El código ya escrito para cada aplicación posible no existe, incluido para tu aplicación. Pedir el código para lo que estás intentando hacer no te llevará a ninguna parte, aparte de recibir posiblemente respuestas molestas. Tienes que escribir tu propio código, para lo cual estamos aquí para ayudarte cuando te atasques, o puedes pagarle a otra persona para que lo escriba por ti. Si deseas que alguien escriba código por ti, el lugar para preguntar es Jobs and Paid Consultancy - Arduino Forum. Si no deseas aprender a escribir código por ti mismo ni pagarle a alguien más para que lo haga, entonces probablemente este no sea el lugar adecuado para ti.

Se amable

Un poco de cortesía y amabilidad van muy lejos. Incluso si crees que una pregunta ya ha sido formulada antes o no ves el sentido de ella, intenta responder de manera educada. Recuerda que muchas personas con un alto número de publicaciones ven las mismas preguntas todos los días y pueden ponerse un poco cortantes si parece que no has hecho mucho esfuerzo para ayudarte a ti mismo/a en primer lugar. Descubrirás que si respondes de manera amistosa, las personas seguirán ayudándote y casi con certeza resolverás tu problema. Los insultos personales, la rudeza y el lenguaje ofensivo no son aceptables y resultarán en una prohibición. Mantente en el tema.

¡NO GRITES!

ESCRIBIR TODO EN MAYÚSCULAS se considera como GRITAR. No te dará una respuesta más rápida, solo molestará a las personas.

Tareas escolares

Recibimos muchas preguntas de estudiantes que desean ayuda con sus tareas escolares. Dichas preguntas generalmente son de dos tipos: preguntas de estudiantes que obviamente están haciendo un verdadero esfuerzo y preguntas de estudiantes que solo quieren que se les haga todo el trabajo. No ayudaremos a los estudiantes que quieren que se les haga todo el trabajo. Es importante aprender haciendo y no recibir respuestas sin ningún esfuerzo propio.

Cuando solicites ayuda con una tarea escolar, es esencial que muestres algún esfuerzo propio. Explica qué has intentado, qué no está funcionando y qué necesitas ayuda. Estamos aquí para ayudarte a aprender y resolver problemas, no para hacer todo tu trabajo por ti.

Al seguir estas pautas y reglas, tendrás una mayor probabilidad de recibir ayuda valiosa y relevante para tu problema en el foro de Arduino. Recuerda ser claro y preciso al describir tu problema, proporcionar toda la información relevante, utilizar etiquetas de código y errores, y ser amable y respetuoso con los demás miembros del foro. ¡Buena suerte con tus proyectos de Arduino!

Agradece a las personas que te ayudan

Aquellos de nosotros que respondemos preguntas aquí lo hacemos de forma gratuita, por espíritu de comunidad. Por favor, agradece a las personas que brindan respuestas útiles y no olvides dar :heart:s también.

También ayuda si haces clic en el botón :ballot_box_with_check: Solución en la parte inferior de la respuesta que responde tu pregunta. Esto facilitará que los ayudantes vean que está resuelto y que otros con la misma pregunta encuentren la respuesta rápidamente.

Créditos

Gran parte de este tutorial ha sido inspirado o copiado de las instrucciones originales del foro creadas por Nick Gammon. Agradezco a Ballscrewbob, Robin2 e Idahowalker, todos ellos han brindado un gran apoyo y comentarios, sin los cuales este tutorial tendría muchos más errores y sería mucho menos claro de lo que es.

Comentarios

Por favor, proporciona comentarios, retroalimentación o sugerencias de mejora para estas instrucciones aquí.
Solo en ingles

Gracias.

1 Like