Go Down

Topic: NilRTOS - A Fast Tiny Preemptive RTOS (Read 19832 times) previous topic - next topic


Jan 26, 2013, 04:55 pm Last Edit: Jan 26, 2013, 04:59 pm by fat16lib Reason: 1
I modified the program to log three ADC channels every 1024 microseconds.  

I added another performance measure, the minimum number of free data records.  For the the three ADC test the result is:

Maximum SD write latency: 48364 usec
Minimum free record count: 89
Unused Stack: 57 152

I ran for about 15 minutes with a high quality industrial SD. I allocated 150 FIFO records and the minimum number of free records was 89 so I was never close to an overrun.

The log file size was about 10 MB.


Thanks for your effort to find the compiler bit field bug.  Compiler bugs can be nasty.


Jan 26, 2013, 07:02 pm Last Edit: Jan 26, 2013, 07:05 pm by pito Reason: 1
I've tried with up to 5 channels, but getting overrun errors (with much smaller fifo_sizes, and cheap sdcard). It seems to me we have to find a way how to work with bitfields, though. Otherwise we waste the fifo space we desperately need..  :)


I tried a Mega and five is the limit.  The problem is that each ADC read takes 110 microseconds so there isn't enough time left in the SD thread to format the data.

You don't lose much accuracy by speeding up the ADC clock so that could help.

Finally you could trigger the ADC with a timer compare and read it in an ISR.  You could write binary...

But all of this is way beyond an example for NilRTOS.  Right now I want to improve all the RTOS ports.

I plan to post improved versions of ChibiOS/RT, FreeRTOS, and NilRTOS on http://code.google.com/p/rtoslibs/.

I was thinking about porting NilRTOS to ARM boards but I decided ChibiOS/RT is a better fit.

Here is a sample of 16 ADC channels logged every 4096 microseconds on a Mega:



Jan 26, 2013, 07:52 pm Last Edit: Jan 26, 2013, 08:10 pm by pito Reason: 1
For example it works here with:
Code: [Select]
struct FifoItem_t {
 uint16_t usec : 16;        // Low 16-bit of time in usec.
 uint16_t value0 : 10;  // ADC value.
 uint16_t value1 : 10;  // ADC value.
 uint16_t value2 : 10;  // ADC value.
 uint16_t value3 : 10;  // ADC value.
 uint16_t value4 : 10;  // ADC value.
 uint8_t error : 6;   // Overrun count since last point.

fifo_size 100, intervalTicks=2, no analogreference, no overrun for 30secs

PS: not sure we can do this (the original struct causing troubles):
Code: [Select]
struct FifoItem_t {
  uint16_t usec;        // Low 16-bit of time in usec.
  unsigned value : 10;  // ADC value.
  unsigned error : 6;   // Overrun count since last point.

within a struct - mixing int and bitfields - maybe within an union? ..


Jan 26, 2013, 09:47 pm Last Edit: Jan 26, 2013, 11:23 pm by fat16lib Reason: 1
I started using bit fields in this example because I have used them before on AVR.  

The original structure worked with some assignment statements and failed with others.  I tested it with a counter and that worked OK.

I don't trust bit fields now.  I wonder if the avr-gcc people have a description of the bug.

You could store the low 8-bits of each ADC in a byte and the upper 2-bits packed by using shifts and masks with four to a byte.  The inverse could be used in the SD print thread.

I was just at the gym exercising and I started to think about the ADC read problem.  I think I will do an ISR/semaphore replacement for analogRead().  I will setup the ADC so it interrupts when done.  I will sleep on a semaphore that will be signaled by the ADC ISR like the nilInterrupt example.

Edit: That was easy.  I now have nilAnalogRead(pin).  It takes 126 microseconds 110 is sleep while the ADC is doing the conversion and 16 is ISR, semaphore, and context switch overhead.  I get back 94 microseconds of CPU time per read but a read take 16 microseconds longer.

I can now log all six ADC channels on a Uno using a period of 1024 microseconds with nilAnalogRead().


Jan 27, 2013, 04:50 pm Last Edit: Jan 27, 2013, 08:53 pm by pito Reason: 1
Few pictures for you tutorial  :)
fifo_b - ..basic situation..
fifo5  - ..adc maybe faster than sdcard..
fifo6 -  ..till overrun error..

fifo_a - ..counting semaphores handshaking..



Wow these are great.  I was about to post an update but I will put your pictures in the Examples explanation.

I also found that I must restructure Nil into several libraries.  The ISR for nilAnalogRead() is always linked.  I guess I will need separate libraries for some parts of Nil.  I can't think of a workaround.


I have posted an updated version of Nil RTOS as NilRTOS20130127.zip http://code.google.com/p/rtoslibs/downloads/list.

It has new features including an ADC library that sleeps while conversions are in progress.  This saves CPU time and allows other threads to execute.

A new version of SdFat is included with a function that formats uint16_t fields three times faster than the standard Arduino Print.

A data logging example is included that can log five analog pins on an Uno to a csv file every tick (1024 usec) which is 976 Hz.  All 16 analog pins on a Mega can be logged to a csv file every 3 ticks which is 325 Hz.  A quality SD card is required to achieve these results.

Documentation has been improved and two bugs have been fixed.


Works nice!  :)
(ie. Uno, 5 adc channels, 2048usec period, cheap card, 7 minutes logging time, 5.5MB data.csv):
Code: [Select]
type any character to begin
type any character to end
FIFO record count: 75
Minimum free record count: 54
Maximum SD write latency: 41064 usec
Unused Stack: 51 125


Jan 28, 2013, 01:54 pm Last Edit: Jan 28, 2013, 02:46 pm by pito Reason: 1
Fyi - here is the 1024usec period, 4 ADC channels, Latency and FreeFifo stored to the sdcard. You may see Latency and FreeFifo chart over the time (32k measurements shown).
Time is in msec, Latency in usec,  FreeFifo in free records..
Code: [Select]
type any character to begin
type any character to end
FIFO record count: 90
Minimum free record count: 0
Maximum SD write latency: 35072 usec
Unused Stack: 51 144

** overrun errors **
Maximum overrun count: 32


Jan 28, 2013, 02:22 pm Last Edit: Jan 28, 2013, 02:37 pm by pito Reason: 1
And the same with 2048usec period (Time is *2 msecs). You may see how the freefifo dropped to 69 during the highest latency hit (40msec).
Code: [Select]
type any character to begin
type any character to end
FIFO record count: 90
Minimum free record count: 69
Maximum SD write latency: 40292 usec
Unused Stack: 51 151


Jan 28, 2013, 02:36 pm Last Edit: Jan 28, 2013, 02:52 pm by fat16lib Reason: 1

I wrapped the FIFO code in a C++ template so it is easy to use. Here is an example:
Code: [Select]

#include <NilRTOS.h>
#include <NilFIFO.h>

// FIFO with ten ints
NilFIFO<int, 10> fifo;

// Use tiny unbuffered NilRTOS NilSerial library.
#include <NilSerial.h>
#define Serial NilSerial

NIL_WORKING_AREA(waThread1, 64);

NIL_THREAD(Thread1, arg) {
 int n = 0;
 while (TRUE) {

   int* p = fifo.waitFree(TIME_IMMEDIATE);
   // continue if no free space
   if (p == 0) continue;
   *p = n++;
NIL_THREADS_TABLE_ENTRY(NULL, Thread1, NULL, waThread1, sizeof(waThread1))
void setup() {

 // start kernel
void loop() {
 int* p = fifo.waitData(TIME_IMMEDIATE);
 // return if no data
 if (p == 0) return;
 int n = *p;


 if (n == 20) {

Here are the last lines of output:

FIFO record count: 10
Minimum free count: 9

I attached the template as NilFIFO.h. It's not documented yet

I downloaded your new diagrams for a future update of the documentation.

The SD performance is interesting.  SD controllers are impossible to understand since they are a trade top secret.
Users could benefit from your plots, I should write an article to include with SdFat.  My to-do list is getting so long.


Jan 28, 2013, 03:22 pm Last Edit: Jan 28, 2013, 07:35 pm by pito Reason: 1
..as a very first step I would strongly recommend to ask kindly the maintainers to open a new item on this forum ie. in Topics or Development - "RTOS", as it is clear the topic will cover a very important concept all arduino users may easily benefit from..
PS: and maybe to move all the rtos-related topics there..


Feb 01, 2013, 06:46 pm Last Edit: Feb 01, 2013, 06:58 pm by pito Reason: 1
I've tried with 1284p (16MHz) and 1024us period. Fifosize=10kBytes, 2minutes logging time.
5ADC channels:
Code: [Select]
FIFO record count: 833
Minimum free record count: 0
Maximum SD write latency: 48860 usec
Unused Stack: 51 5341

** overrun errors **
Maximum overrun count: 44

4ADC channels:
Code: [Select]
FIFO record count: 1000
Minimum free record count: 0
Maximum SD write latency: 55124 usec
Unused Stack: 51 5354

** overrun errors **
Maximum overrun count: 11

3ADC channels:
Code: [Select]
FIFO record count: 1250
Minimum free record count: 1115
Maximum SD write latency: 49640 usec
Unused Stack: 51 5354

We need a faster ADCs and SDcards :)

8ADC channels and 2048us period:
Code: [Select]
FIFO record count: 555
Minimum free record count: 499
Maximum SD write latency: 49764 usec
Unused Stack: 51 5364


Feb 01, 2013, 07:52 pm Last Edit: Feb 01, 2013, 07:57 pm by fat16lib Reason: 1
First, I just posted a new NilRTOS http://code.google.com/p/rtoslibs/downloads/list.  Look at the new nilSdLogger.ino example, it uses the FIFO template and NilTimer1.

The problem is CPU power to format numbers for these examples.

My new SdFat printField() is about three times faster than Arduino Print but is still the bottleneck when you have lots of RAM.


FIFO record count: 833
Minimum free record count: 0
Maximum SD write latency: 48860 usec
Unused Stack: 51 5341

The 833 FIFO records at 1024 usec provides about 850 milliseconds of buffering.  The max latency was under 50 milliseconds so text formatting is the problem.

Go Up

Please enter a valid email to subscribe

Confirm your email address

We need to confirm your email address.
To complete the subscription, please click the link in the email we just sent you.

Thank you for subscribing!

via Egeo 16
Torino, 10131