The native core allows you to compile and run Arduino sketches on the PC, generally with no modification. It provides native versions of standard Arduino functions, and a command-line interepreter to give inputs to your sketch that would normally come from the hardware itself.
You can...
-
Run full-fledged Arduino sketches without any hardware. Perhaps you're away from your desk and didn't bring the hardware. Maybe you're on a plane? Or maybe the hardware isn't done yet.
-
Get a trace of exactly what your sketch is doing to the hardware and when it happened, to help debug your logic.
-
Use the debugger on Mac & Linux where there is no WinAVR.
-
Run automated tests using normal frameworks, such as cxxtest.
-
Run a script which pretends to be the hardware and see how your sketch reacts.
-
Make sure your sketch behaves properly under hardware error conditions which are impossible to trigger normally. (e.g. bad SD media)
NCORE runs on Linux and Mac. I use it on Ubuntu 11.04 and Mac OSX 10.6 (Snow Leopard).
NCORE runs from the command-line. It requires an understanding of build scripts and running build tools from the command-line.
Beyond that, the requirements are pretty simple. It just needs gcc and the 'ftjam' build tool.
If you want to build the tests, you'll need cxxtest from http://cxxtest.tigris.org. NCORE has been tested with cxxtest 3.10.1.
Clone it from github. Create a 'hardware' directory off your sketches directory, and clone into 'native' under that. For example...
$ cd ~/Source/Arduino
$ mkdir hardware
$ cd hardware
$ git clone git://github.com/maniacbug/ncore.git native
NCORE has been tested against all examples shipped with Arduino 1.0, plus many libraries which are handled by NCORE such as EEPROM and SPI. All are working without modification, except to forward-declare functions and fix bugs. Some bugs became much more obvious once they were running under NCORE.
The examples are in their own repository. To get them:
$ cd ~/Source/Arduino
$ git clone git://github.com/maniacbug/ncore-examples.git
$ cd ncore-examples
Edit Jamrules, and change the first line, CORE_DIR to point to where you installed the native core, and ARDUINO_DIR to where you installed Arduino.
First, build one of the examples. The following will build the 'Blink' example:
$ jam Blink
Then build all of the examples in one go:
$ jam -j10
Just be sure to have built ONE example first, or it takes forever to compile.
Also, the -j10 is optional. It goes faster that way.
From the examples directory, after building Blink, type:
$ out/Blink
After a few seconds, type 'list' to see a log of activity.
Type 'help' for a complete list of commands.
Type 'quit' when you're done.
Generally not. To compile for the command line, you do need to forward declare any functions because the Arduino IDE magically does that for you, and there's no IDE to do it here.
There is a compiler define 'NATIVE' which you can use to add native-only chunks of code to your sketch. Try to avoid that, but sometimes there's no way around it.
When setting up a sketch for NCORE, it's important to maintain interoperability with the Arduino IDE. Here's an example of how I set it up.
My "Sketch Directory" in the Arduino IDE is ~/Source/Arduino. Let's say we're setting up the "HelloWorld" sketch.
- Create the HelloWorld sketch in the IDE the normal way.
- This creates ~/Source/Arduino/HelloWorld/HelloWorld.pde.
- Create a 'native' directory underneath, e.g. ~/Source/Arduino/HelloWorld/native
- Copy Jamrules and Jamfile from ~/Source/Arduino/hardware/native/samples into ~/Source/Arduino/HelloWorld/native
- From a command prompt, cd to ~/Source/Arduino/HelloWorld/native, and type 'jam'
- Run out/HelloWorld
In your sketch, use the ".INO" extension for anything that should be included in both Arduino hardware builds and native builds. Use ".CPP" for files that should only be in the Arduino hardware build. The native build will not pick those up. In the 'native' directory off your sketch, include any files that should be only in the native build. The Arduino hardware build will not pick those up. This allows you to substitute native versions of any of your functions if you need it. This avoids lots of "#if NATIVE" everywhere in your sketch.
NCORE: Arduino Native Core
Copyright (C) 2011 [email protected] GPLv2
ncore 6$ at 5000 list
ncore 8$ at 5001 quit
NCORE: 000006 IN CORE Started
NCORE: 000008 SK AT 5000 list
NCORE: 000009 SK AT 5001 quit
NCORE: 000057 SK PINS 13 OUTPUT
NCORE: 000057 SK PINS 13 HIGH
NCORE: 000057 SK CLOK delay 1000
NCORE: 001057 SK PINS 13 LOW
NCORE: 001057 SK CLOK delay 1000
NCORE: 002057 SK PINS 13 HIGH
NCORE: 002057 SK CLOK delay 1000
NCORE: 003057 SK PINS 13 LOW
NCORE: 003057 SK CLOK delay 1000
NCORE: 004057 SK PINS 13 HIGH
NCORE: 004057 SK CLOK delay 1000
NCORE: Arduino Native Core
Copyright (C) 2011 [email protected] GPLv2
ncore 1$ log rate 50
ncore 4$ at 100 pin 2 press
ncore 6$ at 200 list
ncore 7$ at 201 quit
NCORE: 000001 IN CORE Started
NCORE: 000004 IN LOG set rate limit to 50ms
NCORE: 000006 SK AT 100 pin 2 press
NCORE: 000007 SK AT 200 list
NCORE: 000007 SK AT 201 quit
NCORE: 000051 SK PINS 13 OUTPUT
NCORE: 000051 SK PINS 2 INPUT
NCORE: 000051 SK PINS 13 LOW
NCORE: 000051 SK PINS 13 LOW
NCORE: 000052 SK PINS 13 LOW
NCORE: 000052 SK PINS 13 LOW
NCORE: 000052 SK PINS 13 LOW
NCORE: 000052 SK PINS 13 LOW
NCORE: 000052 SK PINS 13 LOW
NCORE: 000052 SK PINS 13 LOW
NCORE: 000052 SK PINS 13 LOW
NCORE: 000052 SK PINS 13 LOW
NCORE: 000052 SK PINS 13 LOW
NCORE: 000052 SK PINS 13 LOW
NCORE: 000052 SK PINS 13 LOW
NCORE: 000052 SK PINS 13 LOW
NCORE: 000052 SK PINS 13 LOW
NCORE: 000052 IN LOG delay 50 (rate limit)
NCORE: 000100 IN PINS 2 HIGH
NCORE: 000102 SK PINS 13 HIGH
NCORE: 000102 SK PINS 13 HIGH
NCORE: 000102 SK PINS 13 HIGH
NCORE: 000102 SK PINS 13 HIGH
NCORE: 000102 SK PINS 13 HIGH
NCORE: 000102 SK PINS 13 HIGH
NCORE: 000102 SK PINS 13 HIGH
NCORE: 000102 SK PINS 13 HIGH
NCORE: 000102 SK PINS 13 HIGH
NCORE: 000102 SK PINS 13 HIGH
NCORE: 000102 IN LOG delay 50 (rate limit)
NCORE: 000150 IN PINS 2 LOW
NCORE: 000152 SK PINS 13 LOW
NCORE: 000152 SK PINS 13 LOW
NCORE: 000152 SK PINS 13 LOW
NCORE: 000152 SK PINS 13 LOW
NCORE: 000152 SK PINS 13 LOW
NCORE: 000152 SK PINS 13 LOW
NCORE: 000152 SK PINS 13 LOW
NCORE: 000152 SK PINS 13 LOW
NCORE: 000152 SK PINS 13 LOW
NCORE: 000152 SK PINS 13 LOW
NCORE: 000152 IN LOG delay 50 (rate limit)
NCORE: Arduino Native Core
Copyright (C) 2011 [email protected] GPLv2
ncore 1$ log rate 0
ncore 3$ at 100 send 0,64,128 cr
ncore 3$ at 110 list
ncore 4$ at 111 quit
ncore 4$
NCORE: 000001 IN CORE Started
NCORE: 000003 IN LOG set rate limit to 0ms
NCORE: 000003 SK AT 100 send 0,64,128 cr
NCORE: 000004 SK AT 110 list
NCORE: 000004 SK AT 111 quit
NCORE: 000051 SK CORE Serial started.
NCORE: 000051 SK PINS 9 OUTPUT
NCORE: 000051 SK PINS 10 OUTPUT
NCORE: 000051 SK PINS 11 OUTPUT
NCORE: 000051 SK PINS 13 OUTPUT
NCORE: 000051 SK PINS 13 HIGH
NCORE: 000100 IN SERL send 0,64,128 (with CR)
NCORE: 000100 SK PINS 11: 255
NCORE: 000100 SK PINS 9: 191
NCORE: 000100 SK PINS 10: 127
NCORE: 000100 SK SERL Red: 0, Green: 64, Blue: 128