Colony

<!-- Generated by Doxygen 1.5.5 -->

<div class="navigation" id="top">

  <div class="tabs">

    <ul>

      <li><a href="index.html"><span>Main&nbsp;Page</span></a></li>

      <li><a href="pages.html"><span>Related&nbsp;Pages</span></a></li>

      <li><a href="modules.html"><span>Modules</span></a></li>

      <li><a href="annotated.html"><span>Data&nbsp;Structures</span></a></li>

      <li><a href="files.html"><span>Files</span></a></li>

    </ul>

  </div>

<div class="contents">

<h1>Orbs</h1><table border="0" cellpadding="0" cellspacing="0">

#define&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__orbs.html#gcf2f6da92d895ef5e594223f1e39e4b1">ORB_OFF</a>&nbsp;&nbsp;&nbsp;0x00</td></tr>

<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Turn the orb off. <br></td></tr>

<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="gc443bd65dba694ea9731f3ea455831a8"></a><!-- doxytag: member="orbs::orb_mode_pwm" ref="gc443bd65dba694ea9731f3ea455831a8" args="" -->

#define&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__orbs.html#gc443bd65dba694ea9731f3ea455831a8">orb_mode_pwm</a>&nbsp;&nbsp;&nbsp;0</td></tr>

<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">PWM mode. <br></td></tr>

<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="gf6cc675aa67ca9348717db3e53f18ae9"></a><!-- doxytag: member="orbs::orb_mode_binary" ref="gf6cc675aa67ca9348717db3e53f18ae9" args="" -->

#define&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__orbs.html#gf6cc675aa67ca9348717db3e53f18ae9">orb_mode_binary</a>&nbsp;&nbsp;&nbsp;1</td></tr>

<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Binary mode. <br></td></tr>

<tr><td colspan="2"><br><h2>Typedefs</h2></td></tr>

<tr><td class="memItemLeft" nowrap align="right" valign="top">typedef uint8_t&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__orbs.html#ge1444a97f794787d7ffaa5ec12e2a1e2">orb_mode_t</a></td></tr>

<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Enables the orbs in default mode.  <a href="#g13069271f9d636674e9b4a8a355099b9"></a><br></td></tr>

<tr><td class="memItemLeft" nowrap align="right" valign="top">void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__orbs.html#g55a2b60caf9fe91346bed89c7bba73b7">orb_init_binary</a> (void)</td></tr>

<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Enables the orbs in binary mode.  <a href="#g55a2b60caf9fe91346bed89c7bba73b7"></a><br></td></tr>

<tr><td class="memItemLeft" nowrap align="right" valign="top">void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__orbs.html#gbb9bc432db2639616a7e8b3211544891">orb_init_pwm</a> (void)</td></tr>

<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Enables the orbs in PWM mode.  <a href="#gbb9bc432db2639616a7e8b3211544891"></a><br></td></tr>

<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="ga1d0fbfe351097e16652a658af5c8955"></a><!-- doxytag: member="orbs::orb_set_mode" ref="ga1d0fbfe351097e16652a658af5c8955" args="(orb_mode_t mode)" -->

void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__orbs.html#ga1d0fbfe351097e16652a658af5c8955">orb_set_mode</a> (<a class="el" href="group__orbs.html#ge1444a97f794787d7ffaa5ec12e2a1e2">orb_mode_t</a> mode)</td></tr>

<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Switches the orbs to the specified mode. <br></td></tr>

<tr><td class="memItemLeft" nowrap align="right" valign="top">void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__orbs.html#gf4effc092e3f85d937cea0ff72a003bf">orb_disable_timer</a> (void)</td></tr>

<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Disables the orb timer, but does not change the mode.  <a href="#gf4effc092e3f85d937cea0ff72a003bf"></a><br></td></tr>

<tr><td class="memItemLeft" nowrap align="right" valign="top">void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__orbs.html#ge626892624d9bd87fa7dcd0ebd6d19f3">orb_enable_timer</a> (void)</td></tr>

<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Enables the orb timer, but does not change the mode.  <a href="#ge626892624d9bd87fa7dcd0ebd6d19f3"></a><br></td></tr>

<tr><td class="memItemLeft" nowrap align="right" valign="top">void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__orbs.html#ge066e81a39023cf8a36efd432bb9a4ff">orb_n_set</a> (uint8_t num, uint8_t red, uint8_t green, uint8_t blue)</td></tr>

<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">set the specified orb to a specified color  <a href="#ge066e81a39023cf8a36efd432bb9a4ff"></a><br></td></tr>

<tr><td class="memItemLeft" nowrap align="right" valign="top">void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__orbs.html#g10dd6277826cd4c9305e48029c9011a4">orb_set</a> (uint8_t red, uint8_t green, uint8_t blue)</td></tr>

<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Set both orbs to a specified color.  <a href="#g10dd6277826cd4c9305e48029c9011a4"></a><br></td></tr>

<tr><td class="memItemLeft" nowrap align="right" valign="top">void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__orbs.html#g06c1b846b943bd327a2bc9f37b926497">orb1_set</a> (uint8_t red_led, uint8_t green_led, uint8_t blue_led)</td></tr>

<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Set orb1 to a specified color.  <a href="#g06c1b846b943bd327a2bc9f37b926497"></a><br></td></tr>

<tr><td class="memItemLeft" nowrap align="right" valign="top">void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__orbs.html#g618af3d39cb8cd954248da295f7f234c">orb2_set</a> (uint8_t red_led, uint8_t green_led, uint8_t blue_led)</td></tr>

<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Set orb2 to a specified color.  <a href="#g618af3d39cb8cd954248da295f7f234c"></a><br></td></tr>

<tr><td class="memItemLeft" nowrap align="right" valign="top">void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__orbs.html#g5ebe8d5597e2519d82486ce0a88906cc">orbs_set</a> (uint8_t red1, uint8_t green1, uint8_t blue1, uint8_t red2, uint8_t green2, uint8_t blue2)</td></tr>

<tr><td class="memItemLeft" nowrap align="right" valign="top">void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__orbs.html#g9bbced65e813e0937b7251a86853117f">orb_n_set_color</a> (uint8_t num, uint8_t col)</td></tr>

<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">set the specified orb to the specified color  <a href="#g9bbced65e813e0937b7251a86853117f"></a><br></td></tr>

<tr><td class="memItemLeft" nowrap align="right" valign="top">void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__orbs.html#g0dede06855e46c8b8abdbce5779917ba">orb1_set_color</a> (uint8_t col)</td></tr>

<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Set orb1 to a specified color.  <a href="#g0dede06855e46c8b8abdbce5779917ba"></a><br></td></tr>

<tr><td class="memItemLeft" nowrap align="right" valign="top">void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__orbs.html#g1eb5f3accec23e5a2ea137e95f5070d6">orb2_set_color</a> (uint8_t col)</td></tr>

<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Set orb2 to a specified color.  <a href="#g1eb5f3accec23e5a2ea137e95f5070d6"></a><br></td></tr>

<tr><td class="memItemLeft" nowrap align="right" valign="top">void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__orbs.html#g39224c46d5ed891d16e08239c959a8a8">orbs_set_color</a> (uint8_t col1, uint8_t col2)</td></tr>

<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">set the orbs to specified colors  <a href="#g39224c46d5ed891d16e08239c959a8a8"></a><br></td></tr>

<tr><td class="memItemLeft" nowrap align="right" valign="top">void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__orbs.html#g1710247e5331a3cb6076354a70e095e1">orb_set_color</a> (uint8_t col)</td></tr>

<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Set both orbs to a specified color.  <a href="#g1710247e5331a3cb6076354a70e095e1"></a><br></td></tr>

Quick start: call orb_init_pwm or orb_init_binary, depending on which mode you want to use. Call orb*set or orb*set_color to set the orbs.<p>

The orbs have two modes of operation: PWM mode and binary mode. In PWM mode, a pwm signal is generated by a hardware timer and the orbs can be set to a value of 0 through 255. In binary mode, the orbs can only be turned on or off and a value of 0 means "off" and any other value means "on". The mode can be chosen on initialization and can be changed at runtime using the orb_set_mode function.<p>

Operation (PWM mode): On timer overflow, all LEDs with a value&gt;0 are turned on and the output compare value for the first LED is loaded. On compare match, the corresponding LED is turned off and the next output compare value is loaded. All masks are precomputed and sorted by time when setting the values.<p>

The data structure (pwm_t) containing the PWM times and masks is triple buffered. This is because the buffer the ISR is reading from may only be modified on timer overflow before the next PWM sequence is started, because otherwise the next OCR value might be sed to a value smaller than the current timer value, resulting in the remaining channels not being turned off in that PWM period (flash to on). When using two buffers, the page flip can only occur on a timer overflow for the same reason. So after writing a buffer and marking it for page flip, neither of the buffers could be modified because the front buffer is read by the ISR and the back buffer could be switched at any time. So the calling thread would have to be delayed by up to one full PWM period (8ms in the current implementation, but 20ms-50ms would be a reasonable value to expect here). To avoid this, triple buffering is used.<p>

The code for applying the orbs is fairly optimized. See the apply_orbs function for some time measurements and further nodes.<p>

The PWM frequency is 120Hz (8ms period time). The next lower frequency (determined by the prescaler) is 30 Hz which is too slow (orbs flicker).<p>

The orbs code is thread safe, which means that the functions may be called from another interrupt handler. If there are multiple concurrent calls to the orb*set* functions, one of them is ignored and the orbs are never left in an inconsistent state. For example, if the orbs are set to green by the main thread and to red by an interrupt handler, the resulting color will be either red or green, but never yellow. Thread safety is achieved by grabbing a lock at the beginning of all functions that modify the orb code and releasing the lock at the end. If the lock is already taken, the function just returns doing nothing.<p>

Some performance measurements:<ul>

<li>Time for setting new orb values (PWM mode): 35us-72us (depending on the degree to which the array is already in the correct order)</li><li>Time for setting new orb values (binary mode): 5.5us</li></ul>

<ul>

<li>Interrupt time (PWM mode only): 8us (overflow) 10us (output compare) 6us (last output compare) 30us (output compare, all value equal)</li></ul>

<p>

<ul>

<li>Maximum total interrupt time per period: 64us</li><li>Maximum CPU usage for interrupts (PWM mode only): &lt;0.8%</li></ul>

<p>

<ul>

<li>Maximum contiguous synchronized block: 30us (output compare interrupt, all values equal)</li></ul>

<p>

There are some potential optimizations left. See the source code for more information.<p>

A note on robustness: if the output compare interrupt is disabled for too long, either due to a long ISR or a long synchronized code block, the orbs will flicker to brighter values for being turned off too late. With software PWM, there's nothing at all to be done about that. The problem can be alleviated by using a lower PWM frequency, but then the orbs will start flickering all the time due to the low update frequency. Some measurements: with 100us synchronized blocks, the flickering is accepptably low. Longer synchronized blocks mean more flickering. At 1ms synchronized blocks, the flickering is quite bad, especially for low orb values. Note that orb value 0 never flickers at all because the corresponding channels are not turned on at all. Test code (note the _delay_us restrictions!) orb_set (1,1,1); while (1) { SYNC { for (uint8_t m=0; m&lt;10; ++m) { _delay_us(10); } } } <hr><h2>Typedef Documentation</h2>

<a class="anchor" name="ge1444a97f794787d7ffaa5ec12e2a1e2"></a><!-- doxytag: member="lights.h::orb_mode_t" ref="ge1444a97f794787d7ffaa5ec12e2a1e2" args="" -->

          <td class="memname">typedef uint8_t <a class="el" href="group__orbs.html#ge1444a97f794787d7ffaa5ec12e2a1e2">orb_mode_t</a>          </td>

        </tr>

      </table>

</div>

<div class="memdoc">

<p>

Specification of the orb mode 

</div>

</div><p>

<hr><h2>Function Documentation</h2>

<a class="anchor" name="g06c1b846b943bd327a2bc9f37b926497"></a><!-- doxytag: member="lights.h::orb1_set" ref="g06c1b846b943bd327a2bc9f37b926497" args="(uint8_t red_led, uint8_t green_led, uint8_t blue_led)" -->

<div class="memitem">

<div class="memproto">

      <table class="memname">

        <tr>

          <td class="paramtype">uint8_t&nbsp;</td>

          <td class="paramname"> <em>red</em>, </td>

          <td class="paramtype">uint8_t&nbsp;</td>

          <td class="paramname"> <em>green</em>, </td>

          <td class="paramtype">uint8_t&nbsp;</td>

          <td class="paramname"> <em>blue</em></td><td>&nbsp;</td>

Set orb1 to the color specified. The orbs must be initialized before this function may be used. Note that, when setting both orbs, using orbs_set is faster then setting the orbs individually because the values are only sorted once.<p>

    <tr><td valign="top"></td><td valign="top"><em>red</em>&nbsp;</td><td>the red component of the color </td></tr>

    <tr><td valign="top"></td><td valign="top"><em>green</em>&nbsp;</td><td>the green component of the color </td></tr>

    <tr><td valign="top"></td><td valign="top"><em>blue</em>&nbsp;</td><td>the blue component of the color</td></tr>

<dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="group__orbs.html#g13069271f9d636674e9b4a8a355099b9" title="Enables the orbs in default mode.">orb_init</a> </dd></dl>

<p>References <a class="el" href="dragonfly__lib_8h-source.html#l00110">RELEASE_LOCK</a>, and <a class="el" href="dragonfly__lib_8h-source.html#l00107">REQUIRE_LOCK_OR_RETURN</a>.</p>

<p>Referenced by <a class="el" href="lights_8c-source.html#l00611">orb1_set_color()</a>.</p>

<a class="anchor" name="g0dede06855e46c8b8abdbce5779917ba"></a><!-- doxytag: member="lights.h::orb1_set_color" ref="g0dede06855e46c8b8abdbce5779917ba" args="(uint8_t col)" -->

          <td class="paramtype">uint8_t&nbsp;</td>

Set orb1 to the specified color. This function is intended to be used with the predefined colors.<p>

    <tr><td valign="top"></td><td valign="top"><em>col</em>&nbsp;</td><td>the color to set the orbs to </td></tr>

<p>References <a class="el" href="lights_8c-source.html#l00506">orb1_set()</a>.</p>

<a class="anchor" name="g618af3d39cb8cd954248da295f7f234c"></a><!-- doxytag: member="lights.h::orb2_set" ref="g618af3d39cb8cd954248da295f7f234c" args="(uint8_t red_led, uint8_t green_led, uint8_t blue_led)" -->

          <td class="paramtype">uint8_t&nbsp;</td>

          <td class="paramname"> <em>red</em>, </td>

          <td class="paramtype">uint8_t&nbsp;</td>

          <td class="paramname"> <em>green</em>, </td>

          <td class="paramtype">uint8_t&nbsp;</td>

          <td class="paramname"> <em>blue</em></td><td>&nbsp;</td>

Set orb2 to the color specified. The orbs must be initialized before this function may be used. Note that, when setting both orbs, using orbs_set is faster then setting the orbs individually because the values are only sorted once.<p>

<dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="group__orbs.html#g13069271f9d636674e9b4a8a355099b9" title="Enables the orbs in default mode.">orb_init</a> </dd></dl>

<p>References <a class="el" href="dragonfly__lib_8h-source.html#l00110">RELEASE_LOCK</a>, and <a class="el" href="dragonfly__lib_8h-source.html#l00107">REQUIRE_LOCK_OR_RETURN</a>.</p>

<p>Referenced by <a class="el" href="lights_8c-source.html#l00620">orb2_set_color()</a>.</p>

<a class="anchor" name="g1eb5f3accec23e5a2ea137e95f5070d6"></a><!-- doxytag: member="lights.h::orb2_set_color" ref="g1eb5f3accec23e5a2ea137e95f5070d6" args="(uint8_t col)" -->

          <td class="paramtype">uint8_t&nbsp;</td>

Set orb2 to the specified color. This function is intended to be used with the predefined colors.<p>

    <tr><td valign="top"></td><td valign="top"><em>col</em>&nbsp;</td><td>the color to set the orbs to </td></tr>

<p>References <a class="el" href="lights_8c-source.html#l00526">orb2_set()</a>.</p>

<a class="anchor" name="gf4effc092e3f85d937cea0ff72a003bf"></a><!-- doxytag: member="lights.h::orb_disable_timer" ref="gf4effc092e3f85d937cea0ff72a003bf" args="(void)" -->

          <td class="memname">void orb_disable_timer           </td>

          <td class="paramtype">void&nbsp;</td>

Disables the orb timer, but does not change the mode. 

Disables the orb timer. Note that you usually don't want to use this function directly. Instead, use orb_set_mode. <dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="group__orbs.html#ga1d0fbfe351097e16652a658af5c8955" title="Switches the orbs to the specified mode.">orb_set_mode</a> </dd></dl>

<p>Referenced by <a class="el" href="lights_8c-source.html#l00693">orb_set_mode()</a>.</p>

<a class="anchor" name="ge626892624d9bd87fa7dcd0ebd6d19f3"></a><!-- doxytag: member="lights.h::orb_enable_timer" ref="ge626892624d9bd87fa7dcd0ebd6d19f3" args="(void)" -->

          <td class="memname">void orb_enable_timer           </td>

          <td class="paramtype">void&nbsp;</td>

Enables the orb timer, but does not change the mode. 

Enables the orb timer. Note that you usually don't want to use this function directly. Instead, use orb_set_mode. <dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="group__orbs.html#ga1d0fbfe351097e16652a658af5c8955" title="Switches the orbs to the specified mode.">orb_set_mode</a> </dd></dl>

<p>Referenced by <a class="el" href="lights_8c-source.html#l00693">orb_set_mode()</a>.</p>

<a class="anchor" name="g13069271f9d636674e9b4a8a355099b9"></a><!-- doxytag: member="lights.h::orb_init" ref="g13069271f9d636674e9b4a8a355099b9" args="(void)" -->

          <td class="paramtype">void&nbsp;</td>

Enables the orbs in default mode. 

Initializes the orbs in default mode. One of the orb_init* functions must be called before the orbs can be used. Use the orb_init_binary or orb_init_pwm function if you want one specific mode.<p>

<dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="group__orbs.html#gbb9bc432db2639616a7e8b3211544891" title="Enables the orbs in PWM mode.">orb_init_pwm</a> <p>

<a class="el" href="group__orbs.html#g55a2b60caf9fe91346bed89c7bba73b7" title="Enables the orbs in binary mode.">orb_init_binary</a> </dd></dl>

<p>References <a class="el" href="lights_8c-source.html#l00743">orb_init_pwm()</a>.</p>

<p>Referenced by <a class="el" href="dragonfly__lib_8c-source.html#l00068">dragonfly_init()</a>.</p>

<a class="anchor" name="g55a2b60caf9fe91346bed89c7bba73b7"></a><!-- doxytag: member="lights.h::orb_init_binary" ref="g55a2b60caf9fe91346bed89c7bba73b7" args="(void)" -->

          <td class="memname">void orb_init_binary           </td>

          <td>(</td>

          <td class="paramtype">void&nbsp;</td>

          <td class="paramname">          </td>

          <td>&nbsp;)&nbsp;</td>

          <td width="100%"></td>

        </tr>

      </table>

</div>

<div class="memdoc">

<p>

Enables the orbs in binary mode. 

<p>

Initializes the orbs in PWM mode. One of the orb_init* functions must be called before the orbs can be used.<p>

<dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="group__orbs.html#gbb9bc432db2639616a7e8b3211544891" title="Enables the orbs in PWM mode.">orb_init_pwm</a> </dd></dl>

<p>References <a class="el" href="lights_8h-source.html#l00169">orb_mode_binary</a>, and <a class="el" href="lights_8c-source.html#l00693">orb_set_mode()</a>.</p>

</div>

</div><p>

<a class="anchor" name="gbb9bc432db2639616a7e8b3211544891"></a><!-- doxytag: member="lights.h::orb_init_pwm" ref="gbb9bc432db2639616a7e8b3211544891" args="(void)" -->

<div class="memitem">

<div class="memproto">

      <table class="memname">

        <tr>

          <td class="memname">void orb_init_pwm           </td>

          <td>(</td>

          <td class="paramtype">void&nbsp;</td>

          <td class="paramname">          </td>

          <td>&nbsp;)&nbsp;</td>

          <td width="100%"></td>

        </tr>

      </table>

</div>

<div class="memdoc">

<p>

Enables the orbs in PWM mode. 

<p>

Initializes the orbs in PWM mode. One of the orb_init* functions must be called before the orbs can be used.<p>

<dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="group__orbs.html#g55a2b60caf9fe91346bed89c7bba73b7" title="Enables the orbs in binary mode.">orb_init_binary</a> </dd></dl>

<p>References <a class="el" href="lights_8h-source.html#l00166">orb_mode_pwm</a>, and <a class="el" href="lights_8c-source.html#l00693">orb_set_mode()</a>.</p>

<p>Referenced by <a class="el" href="lights_8c-source.html#l00755">orb_init()</a>.</p>

</div>

</div><p>

<a class="anchor" name="ge066e81a39023cf8a36efd432bb9a4ff"></a><!-- doxytag: member="lights.h::orb_n_set" ref="ge066e81a39023cf8a36efd432bb9a4ff" args="(uint8_t num, uint8_t red, uint8_t green, uint8_t blue)" -->

<div class="memitem">

<div class="memproto">

      <table class="memname">

        <tr>

          <td class="memname">void orb_n_set           </td>

          <td>(</td>

          <td class="paramtype">uint8_t&nbsp;</td>

          <td class="paramname"> <em>num</em>, </td>

        </tr>

        <tr>

          <td class="paramkey"></td>

          <td></td>

          <td class="paramtype">uint8_t&nbsp;</td>

          <td class="paramname"> <em>red</em>, </td>

        </tr>

        <tr>

          <td class="paramkey"></td>

          <td></td>

          <td class="paramtype">uint8_t&nbsp;</td>

          <td class="paramname"> <em>green</em>, </td>

        </tr>

        <tr>

          <td class="paramkey"></td>

          <td></td>

          <td class="paramtype">uint8_t&nbsp;</td>

          <td class="paramname"> <em>blue</em></td><td>&nbsp;</td>

        </tr>

        <tr>

          <td></td>

          <td>)</td>

          <td></td><td></td><td width="100%"></td>

        </tr>

      </table>

</div>

<div class="memdoc">

<p>

set the specified orb to a specified color 

<p>

Sets the specified orb to the specified color. The orbs must be initialized before this function may be used. Note that, when setting both orbs, using orbs_set is faster then setting the orbs individually because the values are only sorted once.<p>

<dl compact><dt><b>Parameters:</b></dt><dd>

  <table border="0" cellspacing="2" cellpadding="0">

    <tr><td valign="top"></td><td valign="top"><em>num</em>&nbsp;</td><td>the number of the orb to set (0 or 1) </td></tr>

    <tr><td valign="top"></td><td valign="top"><em>red</em>&nbsp;</td><td>the red value for the specified orb </td></tr>

    <tr><td valign="top"></td><td valign="top"><em>green</em>&nbsp;</td><td>the green value for the specified orb </td></tr>

    <tr><td valign="top"></td><td valign="top"><em>blue</em>&nbsp;</td><td>the blue value for the specified orb </td></tr>

  </table>

</dl>

<dl class="see" compact><dt><b>See also:</b></dt><dd></dd></dl>

<p>References <a class="el" href="dragonfly__lib_8h-source.html#l00110">RELEASE_LOCK</a>, and <a class="el" href="dragonfly__lib_8h-source.html#l00107">REQUIRE_LOCK_OR_RETURN</a>.</p>

<p>Referenced by <a class="el" href="lights_8c-source.html#l00602">orb_n_set_color()</a>.</p>

</div>

</div><p>

<a class="anchor" name="g9bbced65e813e0937b7251a86853117f"></a><!-- doxytag: member="lights.h::orb_n_set_color" ref="g9bbced65e813e0937b7251a86853117f" args="(uint8_t num, uint8_t col)" -->

<div class="memitem">

<div class="memproto">

      <table class="memname">

        <tr>

          <td class="memname">void orb_n_set_color           </td>

          <td>(</td>

          <td class="paramtype">uint8_t&nbsp;</td>

          <td class="paramname"> <em>num</em>, </td>

        </tr>

        <tr>

          <td class="paramkey"></td>

          <td></td>

          <td class="paramtype">uint8_t&nbsp;</td>

          <td class="paramname"> <em>col</em></td><td>&nbsp;</td>

        </tr>

        <tr>

          <td></td>

          <td>)</td>

          <td></td><td></td><td width="100%"></td>

        </tr>

      </table>

</div>

<div class="memdoc">

<p>

set the specified orb to the specified color 

<p>

Set the specified orb to the specified color. This function is intended to be used with the predefined colors.<p>

<dl compact><dt><b>Parameters:</b></dt><dd>

  <table border="0" cellspacing="2" cellpadding="0">

    <tr><td valign="top"></td><td valign="top"><em>num</em>&nbsp;</td><td>the number of the orb to set (0 or 1) </td></tr>

    <tr><td valign="top"></td><td valign="top"><em>col</em>&nbsp;</td><td>the color to set the orbs to </td></tr>

  </table>

</dl>

<p>References <a class="el" href="lights_8c-source.html#l00486">orb_n_set()</a>.</p>

</div>

</div><p>

<a class="anchor" name="g10dd6277826cd4c9305e48029c9011a4"></a><!-- doxytag: member="lights.h::orb_set" ref="g10dd6277826cd4c9305e48029c9011a4" args="(uint8_t red, uint8_t green, uint8_t blue)" -->

<div class="memitem">

<div class="memproto">

      <table class="memname">

        <tr>

          <td class="paramtype">uint8_t&nbsp;</td>

          <td class="paramname"> <em>red</em>, </td>

          <td class="paramtype">uint8_t&nbsp;</td>

          <td class="paramname"> <em>green</em>, </td>

          <td class="paramtype">uint8_t&nbsp;</td>

          <td class="paramname"> <em>blue</em></td><td>&nbsp;</td>

Set both orbs to the color specified. The orbs must be initialized before this function may be used.<p>

<dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="group__orbs.html#g13069271f9d636674e9b4a8a355099b9" title="Enables the orbs in default mode.">orb_init</a>, <a class="el" href="group__orbs.html#g06c1b846b943bd327a2bc9f37b926497" title="Set orb1 to a specified color.">orb1_set</a>, <a class="el" href="group__orbs.html#g618af3d39cb8cd954248da295f7f234c" title="Set orb2 to a specified color.">orb2_set</a> </dd></dl>

<p>References <a class="el" href="dragonfly__lib_8h-source.html#l00110">RELEASE_LOCK</a>, and <a class="el" href="dragonfly__lib_8h-source.html#l00107">REQUIRE_LOCK_OR_RETURN</a>.</p>

<p>Referenced by <a class="el" href="lights_8c-source.html#l00629">orb_set_color()</a>.</p>

<a class="anchor" name="g1710247e5331a3cb6076354a70e095e1"></a><!-- doxytag: member="lights.h::orb_set_color" ref="g1710247e5331a3cb6076354a70e095e1" args="(uint8_t col)" -->

          <td class="paramtype">uint8_t&nbsp;</td>

Set both orbs to the specified color. This function is intended to be used with the predefined colors.<p>

    <tr><td valign="top"></td><td valign="top"><em>col</em>&nbsp;</td><td>the color to set the orbs to </td></tr>

<p>References <a class="el" href="lights_8c-source.html#l00544">orb_set()</a>.</p>

<a class="anchor" name="g5ebe8d5597e2519d82486ce0a88906cc"></a><!-- doxytag: member="lights.h::orbs_set" ref="g5ebe8d5597e2519d82486ce0a88906cc" args="(uint8_t red1, uint8_t green1, uint8_t blue1, uint8_t red2, uint8_t green2, uint8_t blue2)" -->

<div class="memitem">

<div class="memproto">

      <table class="memname">

        <tr>

          <td class="memname">void orbs_set           </td>

          <td>(</td>

          <td class="paramtype">uint8_t&nbsp;</td>

          <td class="paramname"> <em>red1</em>, </td>

        </tr>

        <tr>

          <td class="paramkey"></td>

          <td></td>

          <td class="paramtype">uint8_t&nbsp;</td>

          <td class="paramname"> <em>green1</em>, </td>

        </tr>

        <tr>

          <td class="paramkey"></td>

          <td></td>

          <td class="paramtype">uint8_t&nbsp;</td>

          <td class="paramname"> <em>blue1</em>, </td>

        </tr>

        <tr>

          <td class="paramkey"></td>

          <td></td>

          <td class="paramtype">uint8_t&nbsp;</td>

          <td class="paramname"> <em>red2</em>, </td>

        </tr>

        <tr>

          <td class="paramkey"></td>

          <td></td>

          <td class="paramtype">uint8_t&nbsp;</td>

          <td class="paramname"> <em>green2</em>, </td>

        </tr>

        <tr>

          <td class="paramkey"></td>

          <td></td>

          <td class="paramtype">uint8_t&nbsp;</td>

          <td class="paramname"> <em>blue2</em></td><td>&nbsp;</td>

        </tr>

        <tr>

          <td></td>

          <td>)</td>

          <td></td><td></td><td width="100%"></td>

        </tr>

      </table>

</div>

<div class="memdoc">

<p>

Set the orbs to the respective values. The orbs must be initialized before this function may be used. Note that, when setting both orbs, this function is faster than calling orb1_set and orb2_set (or orb_n_set) because the values are only sorted once.<p>

<dl compact><dt><b>Parameters:</b></dt><dd>

  <table border="0" cellspacing="2" cellpadding="0">

    <tr><td valign="top"></td><td valign="top"><em>red1</em>&nbsp;</td><td></td></tr>

    <tr><td valign="top"></td><td valign="top"><em>green1</em>&nbsp;</td><td></td></tr>

    <tr><td valign="top"></td><td valign="top"><em>blue1</em>&nbsp;</td><td></td></tr>

    <tr><td valign="top"></td><td valign="top"><em>red2</em>&nbsp;</td><td></td></tr>

    <tr><td valign="top"></td><td valign="top"><em>green2</em>&nbsp;</td><td></td></tr>

    <tr><td valign="top"></td><td valign="top"><em>blue2</em>&nbsp;</td><td></td></tr>

  </table>

</dl>

<dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="group__orbs.html#g06c1b846b943bd327a2bc9f37b926497" title="Set orb1 to a specified color.">orb1_set</a> <p>

<a class="el" href="group__orbs.html#g618af3d39cb8cd954248da295f7f234c" title="Set orb2 to a specified color.">orb2_set</a> <p>

<a class="el" href="group__orbs.html#ge066e81a39023cf8a36efd432bb9a4ff" title="set the specified orb to a specified color">orb_n_set</a> </dd></dl>

<p>References <a class="el" href="dragonfly__lib_8h-source.html#l00110">RELEASE_LOCK</a>, and <a class="el" href="dragonfly__lib_8h-source.html#l00107">REQUIRE_LOCK_OR_RETURN</a>.</p>

<p>Referenced by <a class="el" href="lights_8c-source.html#l00639">orbs_set_color()</a>.</p>

</div>

</div><p>

<a class="anchor" name="g39224c46d5ed891d16e08239c959a8a8"></a><!-- doxytag: member="lights.h::orbs_set_color" ref="g39224c46d5ed891d16e08239c959a8a8" args="(uint8_t col1, uint8_t col2)" -->

<div class="memitem">

<div class="memproto">

      <table class="memname">

        <tr>

          <td class="memname">void orbs_set_color           </td>

          <td>(</td>

          <td class="paramtype">uint8_t&nbsp;</td>

          <td class="paramname"> <em>col1</em>, </td>

        </tr>

        <tr>

          <td class="paramkey"></td>

          <td></td>

          <td class="paramtype">uint8_t&nbsp;</td>

          <td class="paramname"> <em>col2</em></td><td>&nbsp;</td>

        </tr>

        <tr>

          <td></td>

          <td>)</td>

          <td></td><td></td><td width="100%"></td>

        </tr>

      </table>

</div>

<div class="memdoc">

<p>

set the orbs to specified colors 

<p>

Set the orbs to the respective color. This function is intended to be used with the predefined colors.<p>

<dl compact><dt><b>Parameters:</b></dt><dd>

  <table border="0" cellspacing="2" cellpadding="0">

    <tr><td valign="top"></td><td valign="top"><em>col1</em>&nbsp;</td><td>the color to set orb 1 to </td></tr>

    <tr><td valign="top"></td><td valign="top"><em>col2</em>&nbsp;</td><td>the color to set orb 2 to </td></tr>

  </table>

</dl>

<p>References <a class="el" href="lights_8c-source.html#l00569">orbs_set()</a>.</p>

</div>

</div><p>

</div>

<hr size="1"><address style="text-align: right;"><small>Generated on Thu Apr 16 18:33:23 2009 for libdragonfly by&nbsp;

<img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.5 </small></address>