August 12, 2009 AT 7:18 am

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 arduino.cc 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!

Check out all the Circuit Playground Episodes! Our new kid’s show and subscribe!

Have an amazing project to share? Join the SHOW-AND-TELL every Wednesday night at 7:30pm ET on Google+ Hangouts.

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

Learn resistor values with Mho’s Resistance or get the best electronics calculator for engineers “Circuit Playground”Adafruit’s Apps!

Maker Business — Raspberry Pi and CoderDojo Join Forces

Wearables — Gold glow

Electronics — Linear Love

Biohacking — Nike’s Unlimited Stadium Will Put Your Best Foot Forward

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


  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: http://karatejutsu.blogspot.com/2006/05/guest-post-ganbaru.html

Sorry, the comment form is closed at this time.