HOW TO – Get help with your Arduino project

2088974416 330Bbf2647 B
From the our customer support forums… Some handy tips on getting help in our forums, troubleshooting and more… have other suggestions? Post in the forums or comment on this post!

Electronixy beginners don’t know how to ask for help because they are beginners. this post will indicate some of the problems. please read through the suggestions. if you don’t, you’ll probably be pointed to it anyways so you might as well save yourself the time.

1. Learn how to upload code to your arduino – if you dont know how to save and upload sketches and VERIFY that the sketches have been actually uploaded, you will not be able to get your project working. this is a big problem. see Arduino tutorial part 1 for how to upload new code. make sure you get a Done Uploading notice. note on the screen, if you see any errors or failures, your code didnt upload so you have to fix it before continuing.

2. Understand the difference between setup() and loop() – setup() occurs only once, loop() occurs constantly. For more information see Arduino tutorial part 2.

3. Learn how to use Serial.print() Printing is key to debugging – You must print out variables, notes, and hints to yourself about what is going on constantly. Not sure if your temperature sensor is working? Print out what the analogread() function returns. make sure that all the numbers make sense. Not sure how many times a loop is running, or if its running at all? Print out an incrementing number. For more information see Arduino tutorial part 4.

4. Never say “It doesn’t work” – There is nothing more useless than the phrase “It doesn’t work”. Its like going to a doctor and demanding treatment but never telling what the symptoms are. You have to define what “it” is – is it the code? is it the LCD? is it the sensor? Second, you have to explain “doesn’t work”, how do you know it doesnt work (often times, its working fine but the user doesnt understand that). What have you done to verify that its not working? Do you have an examples of it working ever? What should it be doing? Describe as -precisely- as you can muster.

5. Use the [code] tag – Its a button up top (in the forums) see? it says code! its for pasting code cleanly. and cleanliness is near godliness, so use it!

6. If you must post code, post the minimal code that demonstrates what doesn’t work – Your temperature sensor doesnt work. OK, that may be a problem…maybe its broken? maybe its not wired up right? But why are you pasting a sketch that has LCD and ethernet code in there too? Make a new sketch with all the extra stuff deleted, if it still doesnt work, you can post that because at least you’re debugging only one thing. (see below) 6b. If you’re posting code and claiming that something doesn’t work, make sure the code -shows- that it doesnt work. If your LCD doesnt print on the second line, post code that shows you at least tried to print to the second line.

7. For every component in your project, have a sketch that JUST tests that component and nothing else – using Serial.print() to tell you that it works Have an RGB LED? Are you sure you know the pinout? Might be handy to have a sketch that only tests that part, that way if you break it, there’s a quick way for you to verify

8. Don’t eat a cow in one bite – Code increases in complexity/difficulty the longer it is. That is a fact. Lets say you want to make an internet-enabled cat-feeder (so you can feed your cat over the internet, of course!) Do not try to write all the code and then click compile and pray. That is foolish! Instead, just get a motor turning. Once that works, attach the motor to the cat feeding device and verify it works with serial commands or button presses. Then figure out how to get an LED to light via an Ethernet shield. Finally you can combine the two halves (motor/servo control and Internet control). So if your internet-controlled-cat-feeder doesnt work, and you need help, don’t just dump 300 lines of code and say “HALP”. Instead, have little tester scripts that verify each part of the project to determine what is breaking!

9. Post nice clear photos or schematics – Sometimes the problem is wiring. In fact, much of the time the problem is wiring. This is unlike software where there is rarely any wires involved. For that reason, you should learn out to take a good, clear photo. An expensive camera is not required but good lighting, some care and setup is. Don’t want to bother with all that? Draw a clear schematic or diagram. Think that takes too much time? Those that request help from others need to spend a little effort.

10. Did you look through the forums/internet? There are literally thousands of posts on various forums that Arduino users visit, including at and other sites that google indexes. Did you use the search box to see if maybe your problem is common? Most problems are the same issue occurring over and over again. You’ll learn a lot, even if its not the exact same problem you’re having.

11. Spend more time on it – Your friend bought a piano yesterday, but hes upset because for some reason everything he plays sounds awful. Whats up with that? Its because he’s never practiced! Electronics, like any skill, requires many hours (even years) of practice. It is not unreasonable to spend a week on a problem, trying different approaches, looking at example code, reading books, examining datasheets, using search engines, all to find a solution. Is it frustrating? Yes. But note that the only way to learn is to have difficulties. When everything goes right, there is no lesson learned. Persevere! Ganbatte!

Adafruit publishes a wide range of writing and video content, including interviews and reporting on the maker market and the wider technology world. Our standards page is intended as a guide to best practices that Adafruit uses, as well as an outline of the ethical standards Adafruit aspires to. While Adafruit is not an independent journalistic institution, Adafruit strives to be a fair, informative, and positive voice within the community – check it out here:

Join Adafruit on Mastodon

Adafruit is on Mastodon, join in!

Stop breadboarding and soldering – start making immediately! Adafruit’s Circuit Playground is jam-packed with LEDs, sensors, buttons, alligator clip pads and more. Build projects with Circuit Playground in a few minutes with the drag-and-drop MakeCode programming site, learn computer science using the CS Discoveries class on, jump into CircuitPython to learn Python and hardware together, TinyGO, or even use the Arduino IDE. Circuit Playground Express is the newest and best Circuit Playground board, with support for CircuitPython, MakeCode, and Arduino. It has a powerful processor, 10 NeoPixels, mini speaker, InfraRed receive and transmit, two buttons, a switch, 14 alligator clip pads, and lots of sensors: capacitive touch, IR proximity, temperature, light, motion and sound. A whole wide world of electronics and coding is waiting for you, and it fits in the palm of your hand.

Have an amazing project to share? The Electronics Show and Tell is every Wednesday at 7pm ET! To join, head over to YouTube and check out the show’s live chat – we’ll post the link there.

Join us every Wednesday night at 8pm ET for Ask an Engineer!

Join over 36,000+ makers on Adafruit’s Discord channels and be part of the community!

CircuitPython – The easiest way to program microcontrollers –

Maker Business — “Packaging” chips in the US

Wearables — Enclosures help fight body humidity in costumes

Electronics — Transformers: More than meets the eye!

Python for Microcontrollers — Python on Microcontrollers Newsletter: Silicon Labs introduces CircuitPython support, and more! #CircuitPython #Python #micropython @ThePSF @Raspberry_Pi

Adafruit IoT Monthly — Guardian Robot, Weather-wise Umbrella Stand, and more!

Microsoft MakeCode — MakeCode Thank You!

EYE on NPI — Maxim’s Himalaya uSLIC Step-Down Power Module #EyeOnNPI @maximintegrated @digikey

New Products – Adafruit Industries – Makers, hackers, artists, designers and engineers! — #NewProds 7/19/23 Feat. Adafruit Matrix Portal S3 CircuitPython Powered Internet Display!

Get the only spam-free daily newsletter about wearables, running a "maker business", electronic tips and more! Subscribe at !


  1. Thanks for posting this, i think i’m going to forward this on to anyone that is interested in Arduino work.

  2. Yes, this is great stuff. Many times I’ve found when preparing a problem I’m having for discussion, the process of winnowing down and singling out the problem helps solve it.

  3. Sometimes when I see posts on forums along the lines of…

    “this is my first arduino project and I want to make a thing that flies around my bedroom and picks fleas off my dog’s tail. where do i start? help!”

    …I feel the need to design a keyboard muzzle for myself.

    Where is the thrill of learning and discovery by reading and research?

    For said posts, I am also constantly amazed by the patience and politeness of the unfailing responders to these bleats.

  4. Ok I’ll bite. I Googled and ran Google translate but I can’t figure out what the meaning of the last words on your post mean.

    Persevere! Ganbatte!

    I’m guessing “Take care and good luck.”

  5. I just meant the plaintive cry of a little lamb, looking to be fed a solution 🙂

    1 : the cry of a sheep or goat; also : a similar sound
    2 : a feeble outcry, protest, or complaint

  6. This is a good explanation:

Sorry, the comment form is closed at this time.