[Tinyos-help] Time counting

[Chad Metcalf]

On 1/4/07, Michael Newman <mnewman at dragonnorth.com> wrote:
> The first thing I did was to read the documentation.
>
> The 2.0 Source code documentation link  on page
> http://www.tinyos.net/tinyos-2.x/doc/ is broken, it points to
> http://www.tinyos.net/tinyos-2.x/doc/html/nesdoc/ which gets a 404 error.
> The 2.0 TEP is quite clear, I never got there. The 2.0 Tutorial and the
> example code in Blink is wrong, leading you down the same path that I
> followed.
>

The best documentation is the source code itself. Timer.h and Timer.nc
point to TEP 102 for additional details. As for the tutorial being
wrong,

> The 1.1 documentation leads you to the tutorial which is clear too, it does
> not match the implementation. I only looked at the 1.1 documentation which
> matches my environment.
>
> I started on the web site, followed the links under documentation and the
> TinyOS 1.1 link there:
>
>         http://www.tinyos.net/tinyos-1.x/doc/
>
> There is no design document for timers (or link to the TEPs). From there I
> went to the tutorial and examples which are VERY CLEAR and describe the
> milliseconds as decimal time. They clearly describe one second as matching
> 1000 milliseconds with examples that show this correspondence.
>
> Note that an interface which takes arguments in decimal milliseconds can
> easily be presented against the existing back end. Rounding or truncation
> error will occur when the decimal arguments have no exact representation in
> binary milliseconds.
>
> I suggest having both interfaces, there is no cost in space or time it all
> gets resolved at compile time. The following would be equivalent calls:
>
>         call Timer.startMS(TIMER_REPEAT,  1000);
>         call Timer.startBinaryMS(TIMER_REPEAT,  1024);
>
> You can debate which way to implemented the current start interface, for
> compatibility it should match startBinaryMS, to match the 1.1 documentation
> and existing examples it should match startMS.
>
>         call Timer.start(TIMER_REPEAT,  1024);
>
>
> DOCUMENTATION BUG: The link to TEP 102 on the bottom of the page:
> http://www.tinyos.net/tinyos-2.x/doc/html/tutorial/lesson2.html goes to TEP
> 107.
>
> _______________________________________________
> Tinyos-help mailing list
> Tinyos-help at Millennium.Berkeley.EDU
> https://mail.millennium.berkeley.edu/cgi-bin/mailman/listinfo/tinyos-help
>


-- 
Chad @ Home