For this tutorial you will need the following items :-
Plug in your Uno board, make sure the lights come on, then launch the Arduino software. From the tools menu, set the Board type to Arduino Uno
For the first sketch, or program, we will load one of the examples that ships with the arduino environment.
From the menus, select File -> Examples -> 01 Basics -> Blink
This will load the example program which blinks the onboard LED that is connected to pin 13
Press the tick icon to 'Verify' (compile) the program, and if that has no errors press the arrow icon to upload the software to your arduino. If all went correctly then the program will run immediately after the upload has completed.
You should see one of the onboard LEDs flashing on and off slowly.
Programs for the arduino are written in the C++ (you may also use plain C) programming language. There must always be two specific functions, these are 'setup' which is run once when the device powers up or resets, and 'loop' which runs over and over again forever.
In the 'Blink' example, the setup function has one task, and that is to set pin 13 to be a digital (on/off) output.
The loop function then turns the output on, pauses, turns the output off, pauses again, then repeats.
You can satisfy yourself that it is your function that is running ont he arduino by modifying these instructions to flahs the LED in a different pattern or speed.
For this program we are going to fade an LED on and off instead of blinking it, however this requires one of the output pins that is labelled as supporting PWM mode, which does not include pin 13, so we have to wire our own LED to a different pin. For example, pin 9
You should now see your LED fade on and off.
This sketch worked by using the AnalogWrite function to output a PWM signal that varies the LEDs brightness.
This sketch demonstrates a very simple use of a push button.
By setting the pinMode to INPUT_PULLUP we are telling the chip to connect a resistor between the pin and the 5v power rail, this has the effect of gently pulling the line to a definite on/1 state, instead of leaving it floating at an arbitrary level. When you press your button, the pin gets connected directly to the Gnd line, which overpowers the resistor and pulls the line down to an off/0 state. The software reads this on/off state and changes the output to the LED accordingly.
This example will demonstrate how you can have the arduino send messages through its serial port back to your laptop, this allows you to receive more detailed information from your sketch, to output debugging messages, or even to write a user interface.
This sketch runs a continuous loop of testing the value of the input pin, and then printing the value to the serial port for you to see. As pressing the button changes the state of the input pin, so does the printed message change.
This example will build upon the previous ones to show how you can read more than just on/off states, in this case we will be reading a voltage that varies due to the changing resistance of a Light Dependant Resistor placed in a Voltage Divider configuration.
The serial monitor now shows the a value between 0 and 1023, which represents a voltage on the input pin between 0 and 5 volts. When you cover the LDR or expose it to light, the value will change. The exact range of values it will show depends upon the resistance range of the LDR and the chosen resistor value.
You can expand on this example by replacing the LDR with a Thermistor to measure temperature.
This example demonstrates how to output a signal that when connected to a speaker makes a noise, you can use this to make alarm noises, user feedback beeps, or even play a tune.
Experiment writing your own tunes.
This example shows one wy to have your Arduino make something physically move, we will use a servo for this example, these devices rotate to a position within a 180 degree arc based upon a signal from a controller. These are used extensively in remote control toys, but you can use them for many other things, e.g. making an old style analogue pointer dial, or indicator, by printing and attaching a pointing arm to the servo.
This example simply loops from 0 to 180 and back again, updating the servo position with each step.
For an interesting alternative, mix this example with the LDR reading from sketch 5, and have the position of the servo shift in response to brightness.
The NeoPixel / WS2812 LED devices are a small package containing Red, Green, and Blue LEDs along with a controller chip, that chip can be sent a digital signal which represents the 8-bit (0-255) values of brightness that it should display on its LEDs. This allows you to set each package to one of 16 million colours. These devices are also connected together in a chain, such that when to send a 25th bit to the first chip, it will output the 1st bit it was sent, and shuffle all of the values along, such that you can use a single data line to transmit different values to each light in pretty much any length of chain.
The complexities of transmitting the very precisely timed messages that the LEDs require is handled by the Adafruit NeoPixel library, and our software only needs to concern itself with which colours should be displayed at any given time.
The setBrightness is necessry because these lights can be extremely bright, and at full brightness they can also draw a lot of power from your Arduino, potentially overloading it, so setting it to a low value saves both your eyes and your board.
The WS2812 lights can be bought in many forms; rings, grids, and strips, both from Adafruit themselves and many other sources. In the UK you will typically pay around £20 for a one metre strip with 60 WS2812 LEDs on it, but if you buy in bulk from china the price drops quite a lot.