Arduino101

From XPUB & Lens-Based wiki


Arduino is umbrella term for a collection of programmable microcontrollers. These microcontrollers allows you to easily interface the physical world of knobs and 'sensors' with code. The term 'arduino' covers both a physical device and an integrated development environment (IDE) that allows you to write, review, debug and upload code to your microcontroller. The Arduino IDE supports a wide variety of microcontrollers from different manufacturers with equally varying specifications (ATMEL, ESP32, ESP8266, etc). The original Arduino project takes a bare 8 bit microcontroller and adds an USB port (+ usb-to-serial converter by FTDI), voltage regulators, input/output header pins for plug and play experience. It's schematics are open source and allowed the proliferation of many varieties and clones. It is also very easy (and cheap) to make your own 'Arduino' clone on a breadboard with a handful of components.


Software

NOTE: Arduino clones need a special driver, see below.

Graphical

All Platforms (Windows/OSX/Linux) >> Download the IDE here: https://www.arduino.cc/en/Main/Software

Installation OSX Unpack, mount, drag to applications folder

Installation Win Run installer, follow installation procedure.

Installation Linux https://www.instructables.com/id/Install-Arduino-IDE-182-on-Linux/

Command Line

First, install the Graphical IDE, then: https://github.com/sudar/Arduino-Makefile

See also: https://git.xpub.nl/XPUB/special-issue-x/src/branch/master/templates/arduino-make and https://git.xpub.nl/XPUB/special-issue-x/src/branch/master/templates/bare-make

Driver

WIN+OSX:http://sparks.gogo.co.nz/ch340.html OSX Mojave has the driver built in. Recent Linux flavours have the driver built in.

Web

https://www.circuito.io/ https://create.arduino.cc/editor


Hardware

To program (or flash) your arduino, you need to connect it to your computer (using USB). Connect your Arduino, open the Arduino IDE and see if your board appears:

Arduino-uno-origiginal-serial.png
Screenshot showing original Arduino UNO connected to serial port on OSX.

Important settings
Board: Select the correct Arduino AVR Board from the list (UNO or Nano in our case). Note in the case of the Nano, there are 2 different chips, 328p and 328p (Old bootloader). If you get errors while uploading your sketch, play with this option.

Port: Select the right serial port to upload your sketch to:
linux: /dev/ttyACM# or /dev/ttyUSB (# = number)
osx: /dev/cu.wchusbserial# or dev/cu.usbmodem# (# = number)
win: COM# (# = number)


Arduino-nano-clone-serial.png
Screenshot showing clone Arduino Nano connected to serial port on OSX.

Arduino-bootloader.png
Screenshot showing clone Arduino Nano 'bootloader' options on OSX.

Sketches

Anatomy of a sketch

Arduino programs are called 'sketches'. The language used it a variant of C/C++. When you open a new sketch (File > New), you are presented with the following code:

void setup() {
  // put your setup code here, to run once:

}

void loop() {
  // put your main code here, to run repeatedly:

}

Void

Setup

Loop

Comments

Debugging

Output

blink

Input

Arduino + Processing

Using Serial for Visualising, also add cli way (for more flexible/modular approach(promoting approaches not apps))!

Prototyping

Breadboard

Breadboard101.png
Solderless breadboard, (hand drawn) red lines indicate interconnected contacts

Input

Rather than talking about 'sensors' (marketing term), lets look at practices involved in creating and manipulating data from various components attached to your arduino board.


Voltage divider

Smoothing in Software

Software smoothing and filtering: https://www.megunolink.com/articles/coding/3-methods-filter-noisy-arduino-measurements/

Output

Protect ya Led

A LED (Light Emitting Diode) is a diode and thus has polarity. In one direction it blocks current and the other direction allows infinite current. This infinite current thirst can cause the LED to burn through. We must limit the current using a resistor (even a 3v battery can destroy a LED when connected directly):
Arduino-uno-circuito-led.png

Online Led protection resistance calculator and rationale


Sound

(Tone?)

DAC

Arduino can convert analog signals (voltages) into 8 bit digital numbers (0-1023 using an 'ADC' or Analog to Digital converter). The arduino cannot output analog voltages only digital suqare waves in the shape of a PWM (Pulse Width Modulation) signal. To retireve analog voltages you need external hardware.

Simple Hardware

R2R ladder filter, RC Filter (filter harmonics from the pwm), https://provideyourown.com/2011/analogwrite-convert-pwm-to-voltage/

Intermediate Hardware

https://create.arduino.cc/projecthub/Arduino_Scuola/build-a-simple-dac-for-your-arduino-4c00bd.

Hard Hardware

https://www.electroschematics.com/arduino-dac-guide/

Considerations

Clones vs Real Deal

Clones use inferior usb to serial chips, voltage regulators and non removable atmel microcontrollers. With buying an original Arduino you support the development and community (needs proof ;p).