View source for Coding Robotics with Arduino

= Objectives =
This guide will provide you a brief introduction to the sensors and coding that you will working with on your VEX robotic project.

== Arduino Overview ==
== Microcontrollers ==
A microcontroller is a cheap, programmable computer without any of the peripherals such as a mouse, keyboard, or screen. Microcontroller boards have direct access to the input and output pins of its processing chip so that the user can directly read from sensors and perform actions. Microcontrollers are present in many electrical appliances like microwaves.
Arduino boards were designed to be easily programmed and assembled into larger projects. These boards come in many shapes and sizes and some contain additional features such as WiFi or Bluetooth connectivity. Different boards can also have different features such as processing speed and memory size.

[[Image:arduino.jpg|250px|thumb|center|Figure 1: Arduino UNO]]
This lab will be using an Arduino UNO board created by SparkFun called a RedBoard. 
[[Image:redboard.jpg|250px|thumb|center|Figure 2: RedBoard]]

=== Arduino Hardware ===
[[Image:redboard_info.jpg|400px|thumb|center|Figure 3: RedBoard information]]
<b>Reset Button:</b> Restarts the Board<br/>
<b>USB Connector:</b> Provides power and connects it to the computer<br />
<b>Pin 13 LED:</b> Usable LED without making an LED circuit<br />
<b>Serial LEDS:</b> Shows if the Arduino is transmitting or receiving data from pins 0, 1 or the USB connection<br/>
[[Image:redboard_pins.jpg|150px|thumb|center|Figure 4: RedBoard pins]]
<center>Power Pins<br /></center>
<b>3.3V:</b> Usually used to power low-voltage sensors<br />
<b>5V:</b> Most common power pin used to power circuits<br />
<b>GND:</b> Ground pin which is 0V<br />
<b>VIN:</b> Voltage-In can be used to power the board using a battery<br/>
[[Image:redboard_IO.jpg|150px|thumb|center|Figure 5: RedBoard IO]]
<center>I/O Pins<br /></center>
<b>A0-A5:</b> Identical analog pins that can be used to read sensors or control analog devices. Pins A0-A3 are more stable than A4-A5.<br />
<b>Pins 0-1:</b> Transmit and Receive pins, don’t use these pins for this lab<br />
<b>Pins 2-12:</b> Digital pins that can be switched between HIGH states and LOW states<br />
<b>Pin 13:</b> Connected to the on-board LED, use it only as an input pin<br/>
=== The Arduino IDE ===
The Arduino IDE is a program that can be used to edit, compile, and upload code to a supported microcontroller. Figure 6 is a screenshot of the program: 
[[Image:arduinoide.jpg|thumb|center|300px|Figure 6: Arduino IDE screenshot]]
'''''Verify''''': checks code for errors and points to where the errors occurred after it finishes. Upload: verifies code and then uploads it to the Arduino board if there are no errors. <br />
'''''Console''''': shows any errors the software found in hardware. <br />
'''''Serial Monitor''''': a tool used to see how a program is running. It’s like a multimeter for the program.
Programs written in Arduino are called sketches. A basic sketch can be broken up into 3 different areas: global, setup and loop; these areas are pictured below.
 
[[Image:Sketchareas.jpg‎|thumb|center|Figure 7: Different areas]]
'''''Global''''': constants and imported libraries go here.<br />
'''''Setup''''': activate the pins and sensors used. This code only runs once.<br />
'''''Loop''''': the code that runs continuously such as reading sensors and turning pins HIGH or LOW.

=== Arduino Programming ===
The Arduino programming language is based on C/C++, but it is designed to be simpler and easier to learn. The most intuitive way to think about programming is like building with LEGO blocks: certain rules must be followed and different building blocks can be used to build bigger parts. 
'''''General'''''
* Every line must either end with a semicolon ‘;’ unless it’s a conditional, loop, or function
* Comments start with a //
** Comments are text that the program ignores
** Used to label and explain code
'''''Datatypes'''''
Datatypes are the different kinds of data values that can be used, manipulated and stored using C++. The table below includes the most basic and widely used datatypes.
{| class="wikitable"
!Datatype!!What it stores (examples)!!Default value!!Notes
|-
|Boolean||style="text-align: center;"|A true value (1, TRUE, HIGH) or<br />a false value (0, FALSE, LOW)||style="text-align: center;"|0, FALSE, LOW||style="text-align: center;"|-
|-
|int||style="text-align: center;"|An integer number (-5, 15, 1047, etc.)||style="text-align: center;"|0||style="text-align: center;"|Can be positive or negative
|-
|double||style="text-align: center;"|A decimal number (-0.5, 123.77, etc.)||style="text-align: center;"|0||style="text-align: center;"|Can be positive or negative
|-
|char||style="text-align: center;"|A single character (‘c’, ‘A’, ‘5’, ‘?’, etc.)||style="text-align: center;"|Indeterminate||style="text-align: center;"|Must be enclosed in single quotes
|-
|string||style="text-align: center;"|A sequence of characters (“Hello World!”,<br /> “10”, “157+5”, etc.)||style="text-align: center;"|Empty (“”)||style="text-align: center;"|Must be enclosed in double quotes
|}
'''''Operators'''''
Operators perform operations on variables and constants. The results of these operations are usually stored in a variable. The table below includes common operators.
{| class="wikitable"
!Operator!!What it does!!Notes
|-
|style="text-align: center;"|=||style="text-align: center;"|Assigns a value to a variable||style="text-align: center;"|
|-
|style="text-align: center;"|+||style="text-align: center;"|Adds two or more values||style="text-align: center;"|
|-
|style="text-align: center;"|<nowiki>-</nowiki>||style="text-align: center;"|Subtracts two or more values||style="text-align: center;"|
|-
|style="text-align: center;"|*||style="text-align: center;"|Multiplies two or more values||style="text-align: center;"|
|-
|style="text-align: center;"|/||style="text-align: center;"|Divides two or more values||style="text-align: center;"|
|-
|style="text-align: center;"|++||style="text-align: center;"|Increment by 1||style="text-align: center;"|Usually used in loops
|-
|style="text-align: center;"|<nowiki>--</nowiki>||style="text-align: center;"|Decrement by 1||style="text-align: center;"|Usually used in loops
|-
|style="text-align: center;"|==||style="text-align: center;"|Checks if two value are equal||style="text-align: center;"|Usually used in conditionals
|-
|style="text-align: center;"|!=||style="text-align: center;"|Checks if two value are not equal||style="text-align: center;"|Usually used in conditionals
|-
|style="text-align: center;"|> or <||style="text-align: center;"|Less than/Greater than comparison||style="text-align: center;"|Usually used in conditionals
|-
|style="text-align: center;"|<= or >=||style="text-align: center;"|Less than/greater than or equal to comparison||style="text-align: center;"|Usually used in conditionals
|-
|style="text-align: center;"|&& or <nowiki>||</nowiki>||style="text-align: center;"|Boolean AND or Boolean OR Used to cascade multiple Boolean operations||style="text-align: center;"|Usually used in conditionals
|-
|}
'''''Constants and Variables'''''
Constants and variables hold data according to their datatype. They need to be given a name so they can be referred to later. Constants hold data that will NOT change while a program is running. Constants usually contain pin numbers or sensor threshold values. Variables contain data that WILL change while a program is running. Variables usually contain sensor values and other values that need to have mathematical operations done on them.  Below is an example of how to create different constants and variables.
[[Image:variables.png‎|thumb|center|300px|Figure 8: Constants and variables]]
'''''Conditional Statements'''''
Conditional statements run code enclosed by their curly brackets when a condition is met. 
[[Image:conditionals.jpg‎|thumb|center|400px|Figure 9: Conditional statements]]
''Loops''
Loops run the code enclosed by their curly brackets a specific amount of times or until a condition is met.
''While-loop''
While-loops are used to perform a task until a condition is met
''For-loop''
For-loops are used when you want something to run a specific number of times. Although they seem complicated at first, the structure of most for-loops is the same. In the parenthesis, the first part sets a variable (usually ‘i’ for ‘index’) to a value used to begin a count, the middle is the condition when the loop stops, and the third part is where you increment or decrement the counting variable. 
[[Image:while.jpg|thumb|center|400px|Figure 10: While and for-loops]]
'''''Commonly Used Arduino Functions'''''
{| class="wikitable"
!Function!!What it does
|-
|style="text-align: center;"|pinMode(pin,mode)||style="text-align: center;"|Sets a pin as an input or output
|-
|style="text-align: center;"|digitalWrite(pin, value)||style="text-align: center;"|Sets a digital output pin to HIGH or LOW
|-
|style="text-align: center;"|digitalRead(pin)||style="text-align: center;"|Reads an digital input pin as HIGH or LOW
|-
|style="text-align: center;"|analogWrite(pin, value)||style="text-align: center;"|Sets an analog output pin to a value 0-1023
|-
|style="text-align: center;"|analogRead(pin)||style="text-align: center;"|Reads an analog output pin as a value 0-1023
|-
|style="text-align: center;"|delay(milliseconds)||style="text-align: center;"|Pauses the program for a certain amount of time
|-
|style="text-align: center;"|Serial.print(value)||style="text-align: center;"|Prints the value (variable) to the Serial Monitor.
|}


==How to work on the same code from different Computers==


==Common Online Resources==


=Coding Robotics=