Skip to content
No description, website, or topics provided.
C Shell
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
img
.gitignore
00-intro.md
01-hello-world.md
02-hello-world-explained.md
03-offboard-leds.md
04-build-systems.md
05-interrupts.c
05-interrupts.md
README.md
mac-setup-docker.sh

README.md

Summary

Over the last year, I've been asked the same question over and over again.

How do I get started with embedded software development?

I usually tell people to go buy an Arduino, throw away the Arduino IDE and libraries, and figure out how to blink a light using just the AVR toolchain.
This "book" is designed to teach you how to do exactly that, and then move on to the other basics of embedded software dev that you need to know to start your journey.

Prerequisites

As an introduction, this "course" requires no prior knowledge of embedded software, C, or C++, or electronics, but does assume a general knowledge of programming in general.

Hardware

For this course, we'll use an Arduino Uno because of its ubiquity and availability. Feel free to purchase a clone, personally, I like the SparkFun Redboard, but many different Uno clones are available for as little as $10. You'll also need a small breadboard, some jumpers, leds, resistors, capacitors, buttons, and other odds and ends to get the most out of this.
I recommend something like Adafruit's Parts Pal kit or SparkFun's Beginners Parts Kit and Half Sized Breadboard.
We're not going to cover electronics at any depth, but we will need to wire up a few simple circuits.

Datasheets

Software

For my own projects, I've developed a Docker image for AVR development.
It contains the AVR toolchain and relevant software you'll need.

If you're running Linux, you need no additional setup, beyond some configuration files to tell avrdude and minicom which serial port your board is attached to.

Install tools on Mac via Homebrew

This is the recommended way of installing the tools on OS X. For some people the docker setup below works fine, for others, VirtualBox can't see the USB device. For that reason, I highly recommend you just use Homebrew to install the AVR toolchain.

Be advised that compiling & installing the compilers can take quite some time.

brew tap osx-cross/avr
brew install \
    avr-gcc \
    avrdude \
    minicom \
    cpputest \
    pkg-config \
    gcc

Using the docker image on Mac

For reasons you can read about on my blog if you care, connecting a docker container to USB ports on Mac requires a bit more software and setup.

  • Download and Install VirtualBox 6.06 or greater.
    • You MUST have version 6.06 or greater, there was a bug in earlier versions that cause this to fail.
  • Download and install the VirtualBox extension pack
  • Download and run the mac-setup-docker.sh script.
  • Setup your terminal by running eval $(docker-machine env)
    • You'll need to run this each time you create a new terminal, or add it to your profile.

Table of Contents

License

Creative Commons License
This work is licensed under a Creative Commons Attribution-ShareAlike 4.0 International License.

Addititionally, all code in this repository is licensed under the MIT license.

MIT License

Copyright (c) 2019 Christopher J. McClellan

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
You can’t perform that action at this time.