C Compilers

Overview

An easy way to test C code without uploading onto a microcontroller is to run it directly on your computer. An IDE is not necessary, you can compile and run directly from the command line!

For Windows, we recommend gcc from MinGW.

For Mac, we recommend Xcode.

Installing MinGW

Go to the MinGW homepage and click the "Download Installer" button in the top right of the screen.

Download MinGW.

This will take you to a sourceforge.net link. You do not have to click anything here (it's all ads), the download will start automatically after 5 seconds.

Run mingw-get-setup.exe.

mingw-get-setup.exe.

Click install. Let the files be saved in C:\MinGW, and say Continue.

Save in default location.

It will take a minute to install. When it is complete, click Continue.

MinGW Manager Setup Tool Installation complete.

This will bring you to the MinGW Installation Manager, where you select the Package you want to install. We are only interested in gcc, not fortan or g++ or any of that, so select 'mingw32-base' and say 'Mark for installation'. In the top left, click Installation -> Apply Changes, and click apply in the pop-up window.

Select mingw32-base to get gcc.

This will download the package, extract and install gcc. When complete, click Close.

Scheduled Changes complete.

You can close the Installation Manager.

Verify that you have gcc.exe installed by opening C:\MinGW\bin.

gcc.exe.

Before we compile code, we need to tell Windows where to find gcc.exe. Open the Control Panel, and click System and Security, click System, and click on Advanced system settings.

Control Panel -> System and Security -> System.

Click the Environment Variables... button.

Environment Variables...

Under System variables, find Path.

Environment Variables -> Path

Click Edit..., and at the end, add C:\MinGW\bin; and say OK to all the windows.

Add C:\MinGW\bin; to the Path

Now we can compile some code! In Windows, I like to use Notepad++ as a text editor. Here I have saved our HelloWorld code as hello.c in C:\example.

hello.c in Notepad++

Now I can open the Command Window (cmd.exe), use 'cd' to change the directory to C:\example, use 'dir' to verify that hello.c is there, and use 'gcc' to compile the code (gcc hello.c -o hello). This creates hello.exe, so if I type 'hello', the code runs, and I see "Hello World!"

Compiled Hello World!

Now you are ready to start coding.

Installing Xcode

Xcode is the Mac IDE for creating programs and apps for the Mac environment. It does not come pre-installed, so you have to download and install it.

Go to the Xcode page and click View in Mac Apple Store.

Xcode page.

And again click View in Mac Apple Store. This will bring up the App Store where you can download Xcode.

Xcode in app store.

Click Free, and then click Install App. Sign in with your Apple ID and password, and the Install App button will say "Installing." You can follow a progress bar in the Finder under Applications -> Xcode. It will take a while.

When it is installed, run Xcode and agree to the terms. Go to Xcode -> Preferences, and select the Downloads tab. Download the Command Line Tools.

Command Line Tools.

Then close Xcode, because we will use the command line version of the compiler, not the IDE.

Open TextEdit, and go to Format -> Make Plain Text. Now you can save the file with a .c extension. Copy the Hello World! code and save.

Hello world! in TextEdit.

Open Terminal from Applications -> Utilities -> Terminal. You can see where you are by typing the command 'pwd'. You can see the contents of the folder using 'ls'. Navigate to the folder with hello.c using 'cd', and compile the code with 'gcc hello.c -o hello'. Verify that the program hello is there, and run it with './hello'.

Hello world! using Xcode.

Now you can start writing your own code!