Pages: [1]   Go Down
Author Topic: Timer Docs Anyone?  (Read 605 times)
0 Members and 1 Guest are viewing this topic.
0
Offline Offline
Sr. Member
****
Karma: 0
Posts: 267
dinosaur cork
View Profile
WWW
 Bigger Bigger  Smaller Smaller  Reset Reset

It is my belief that the Arduino language really needs some docs on how the timers work: what functions use what timers? what will break when a timer is repurposed etc.

I don't really feel competent to do this, but many people have written libraries based on the timers. There are so many things that can ONLY be done by using timers and AVR code, that I feel it's time to give users a place to begin using these valuable tools, and also a way into really understanding the source code. Plus I want to know for selfish reasons, so I can understand the source code, and begin playing with timers and interrupts myself.

If anyone would like to take a shot at writing some docs / and or a tutorial on timers vis a vis Arduino , I will try and compile and edit it and get it in the docs somewhere, and help to extend it and maintain it.

Where the docs go when they are written remains another issue, but we'll find a place.

PaulB
« Last Edit: July 28, 2009, 11:45:59 pm by paulb » Logged

Pullman, WA
Offline Offline
Edison Member
*
Karma: 11
Posts: 1245
Arduino Ninja
View Profile
WWW
 Bigger Bigger  Smaller Smaller  Reset Reset

This was posted in these forums on the 25th, you can find the post by typing "timers" into the search box at the top right corner of the Arduino Forums page: http://arcfn.com/2009/07/secrets-of-arduino-pwm.html

It focuses mainly on timers as related to PWM, but most of the information is there.
« Last Edit: July 30, 2009, 01:25:33 pm by macegr » Logged

Wearable Arduino-compatible LED matrix glasses: https://www.kickstarter.com/projects/macetech/rgb-led-shades

0
Offline Offline
Sr. Member
****
Karma: 0
Posts: 267
dinosaur cork
View Profile
WWW
 Bigger Bigger  Smaller Smaller  Reset Reset

Thanks macegr - this  is great piece. I'll see if the author minds if we reformat for the Arduino docs wiki. Not much I saw on the Arduino source code but I just scanned it. I'm sure writing it up will get me most of the way there.

Arudino forums are amazing.

Paul
« Last Edit: July 30, 2009, 01:41:44 pm by paulb » Logged

Forum Administrator
Cambridge, MA
Offline Offline
Faraday Member
*****
Karma: 12
Posts: 3538
View Profile
WWW
 Bigger Bigger  Smaller Smaller  Reset Reset

Also we wrote up a document listing the hardware resources used by each of the functions: http://code.google.com/p/arduino/wiki/HardwareResourceMap
Logged

0
Offline Offline
Sr. Member
****
Karma: 0
Posts: 267
dinosaur cork
View Profile
WWW
 Bigger Bigger  Smaller Smaller  Reset Reset

Thanks David,

Very useful. In my ideal world I think a lot of this material would be in a more accessible place.

I propose starting to add sections on the reference page that are "below the fold". This is, after the footer (don't know if the footer would let use do that but the footer boilderplate could be some kind of shtml include instead. Maybe a heavy rule could be added to reinforce where the "standard" docs are ending.

Material "below the fold" could include geeky details like are listed on the resources page, how long the function takes to execute, other geeky caveats about which functions the function is likely to interfere with etc. Plus some advanced examples. Users would never need to see the material unless they wanted to scroll down. And beginning students could be instructed to generally ignore the extra notes.

There have been several other requests on this forum topic for that kind of detailed information, that has been heretofore unavailable, unless one really wanted to dig through the source code.
« Last Edit: July 31, 2009, 08:05:01 pm by paulb » Logged

Pages: [1]   Go Up
Jump to: