Developing in C for the ATmega328P: Edit

6 minute read

Where I describe the process of developing code for the Arduino Uno(AVR ATmega328P), specifically, editing the code.

Setup Your Screen

It’s important to setup your screen properly for working with the C tool chain. The three programs you will use the most are your code editor, terminal applications and a serial monitor. In these videos, I will show how I setup the three applications. Its also advisable to have your browser open and available as well.

macOS: Screen Setup

The macOS video also has an interesting compile error which I detail here

Windows: Screen Setup

Keyboard Commands Cheatsheet

Use these keyboard commands to make your life easier!

Description Windows Keys macOS Keys
Copy selection Ctrl - c Cmd - c
Paste clipboard Ctrl - v Cmd - v
Select all Ctrl - a Cmd - a

Terminal Commands Cheatsheet

Use these Terminal commands to make your life easier!

Description Command or key Comments
Change directories cd Use to change folders
Expand current text to a folder name Tab Type first few letters then hit Tab
Present working directory pwd What folder are you in?
List contents of directory ls Show what is in the folder
Previous command Up arrow display previous command

The Arduino IDE

We use the Arduino Uno as the hardware platform for developing C programs on embedded microcontrollers. The Uno is a phenomenal tool for this in that it is easily available, relatively inexpensive, and there is tremendous amount of information available on it and the microcontroller it uses, the AVR ATmega328P.

That said, we specifically do NOT use the Arduino IDE. Why is that? We don’t for the following reasons:

  • It uses C++ and we want to specifically use only the C language
  • Its code editor is light-weight and specific to the Arduino
  • It hides the process of building programs

I do advise installing the IDE as it is a time-tested method of confirming you have a known, good connection between your Uno and your PC. It is typically easier to debug the serial connection using the IDE than using the command line tools. And, it can also be used as “check” to confirm, “yes, my board is working”".

And in fairness, you are able to specify external editor’s and you can specify “verbose” in the build process, however, the top issue remains. And I want to help you understand software development, and using the IDE, won’t do that well.

The Five Steps

There are five specific steps which the IDE enables and any one must take, in order to develop software for the Uno:

  1. Editing the code
  2. Compiling the code
  3. Linking the code
  4. Locating (sometimes referred to as loading)
  5. Uploading the code to the Uno

The middle three steps compile/link/locate are typically called the build process, which can simplify the five steps to three:

  1. Edit
  2. Build
  3. Upload

I find it best to keep the three steps separate, as it is in these three steps, where most errors occur. For a detailed and very worthwhile description of the middle steps, I highly recommend this page, Compiling, Link and Locating: Barr Group.

Possible code editors:

  • All: Sublime Text 4 - $99, nagware (will ask for payment, however you can still use), the best pure code editor
  • Windows: Notepad++ - free, and very good for Windows
  • All: Vim - steep learning curve, very powerful
  • All: bluefish I haven’t tried this one, however, it appears quite capable
  • All: Atom - sun-setted by GitHub, not recommended
  • All?: zed I’m hopeful that zed continues to evolve, as we need a robust community of code editors. Too experimental for now

Setup Screen: Simple Explanation

Here is an image of how I do it.

Screen Setup for Using C tool Chain

Screen Setup for Using C tool Chain

Large Version to see detail

I setup my code editor (in this case, Sublime Text 4 (ST4)) in a full length window, covering the left half of the screen. In the upper right hand quarter of the screen, I setup my terminal window (in this example, I’m using Warp). In the image I made the window slightly longer to show all the commands I use for setup.

Commands in Terminal

# make sure I'm in my home folder
cd
# go to my main folder for this project
cd Documents/School/MPC/2022\ Fall\ CSIS10C/10c_labs_class/
# at this point, I typically open ST4 using "st ."
# in this example, I move to the folder where I'll be compiling code
cd dev/1B/1_blink/
# I want to start with a clean set of code, source and Makefile only
make clean
# I have connected my Uno to my computer, time to compile and upload
make flash

In depth: Editing

A very good code editor can help prevent errors in the remaining steps of the process, by syntactically highlighting the code. For example, in the screen shot below, you can see that “digitalWrit” is in a different color on line 14 vs. line 16. Both lines need to be quite similar and the color difference indicates I’m referencing a different function. [Note: The function digitalWrit doesn’t exist and will cause an error when I attempt to link the code in step 3.]

Wrong function name, digitalWrit

Wrong function name, digitalWrit

Large Version to see detail

An even better code editor will provide the probable function name which I’m attempting to use, as Sublime Text does with the tabnine plug-in. See image. At this point, I hit return and it fills in the proper function.

Suggested function name, digitalWrite

Suggested function name, digitalWrite

Large Version to see detail

I use Sublime Text 4 (ST4) as I like it, its fast, and it has a large number of plug-ins to enhance its behavior. I’ve also used it for over 10 years, so I’m comfortable in it. I use it to edit Python, Forth, C, Julia, and markdown text (as in this website).

The last point is the most important point, as a software developer, I need a tool which I am able to use on different languages and in different situations. Its valuable to me to use the same tool for editing this website, for developing Python scripts to image recognition and for developing code for embedded systems. I am also able to use ST4 on all three platforms, Linux, macOS and Windows.

I don’t use nor advocate using an IDE such as Visual Studio or Visual Studio Code. I attempted to use VSC to develop for the Uno, several years ago, however, I spent more time configuring it than made it worthwhile to use. MicroChip also has an IDE for the AVR series of microcontrollers and I only use it to reprogram the ATmega328P (using the IPE, not the IDE).

One last note on ST4, yes, it costs $99. That said, I’m in it 20-30 hours per week, 52 weeks a year (for a 3 year subscription). So yeah, I’ll say its worth it.

To finish on editing, I always have my editor window open while I’m developing code. It covers the left half of the screen, while my terminal program covers the top right quarter of the screen and a serial program covers the bottom right quarter. This covers 95% of my development needs.

In this specific case, I’m working on the analogRead function, so I’m cycling between the code editor (left-side), terminal window (top-right) and serial monitor (bottom-right). This is a fairly simple example of a dev environment and it works for me, I highly recommend you begin determining a setup which works for you.

Typical development environment

Typical development environment

Large Version to see detail

Next Steps

Developing in C for the ATmega328P: Build

Comments powered by Talkyard.