pio_8h.html

BlueLab3 bluetooth API 说明文档

<p>
Returns TRUE if VREG_EN is raised. 
<p>
This is only supported on BlueCore variants with charger hardware. Currently this must be polled if we wish to see detect if the user has pressed the button again.<p>
(Typically an ON/OFF button is wired to VREG_EN. When the button is pressed, VREG_EN goes high, the chip powers up, and the firmware latches the SMPSU regulator as part of the early boot sequence. VREG_EN can then be removed. To turn off the chip using the same button we need to have visibility of VREG_EN.)     </td>
  </tr>
</table>
<a class="anchor" name="a13" doxytag="pio.h::PioSetMicBias" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
  <tr>
    <td class="mdRow">
      <table cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td class="md" nowrap valign="top"> void PioSetMicBias           </td>
          <td class="md" valign="top">(&nbsp;</td>
          <td class="md" nowrap valign="top"><a class="el" href="csrtypes_8h.html#a9">bool</a>&nbsp;</td>
          <td class="mdname1" valign="top" nowrap> <em>enabled</em>          </td>
          <td class="md" valign="top">&nbsp;)&nbsp;</td>
          <td class="md" nowrap></td>
        </tr>
      </table>
    </td>
  </tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
Control the linear-regulator bit (typically used to control the microphone bias when when the switched mode power supply is being used.). 
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td></td><td valign=top><em>enabled</em>&nbsp;</td><td>Enable(TRUE) or Disable(FALSE).</td></tr>
  </table>
</dl>
This is only supported on BlueCore variants with charger hardware.     </td>
  </tr>
</table>
<a class="anchor" name="a14" doxytag="pio.h::PioSetLed0" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
  <tr>
    <td class="mdRow">
      <table cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td class="md" nowrap valign="top"> void PioSetLed0           </td>
          <td class="md" valign="top">(&nbsp;</td>
          <td class="md" nowrap valign="top"><a class="el" href="csrtypes_8h.html#a9">bool</a>&nbsp;</td>
          <td class="mdname1" valign="top" nowrap> <em>enabled</em>          </td>
          <td class="md" valign="top">&nbsp;)&nbsp;</td>
          <td class="md" nowrap></td>
        </tr>
      </table>
    </td>
  </tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
Control the LED0 output pin. 
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td></td><td valign=top><em>enabled</em>&nbsp;</td><td>Enable(TRUE) or Disable(FALSE).</td></tr>
  </table>
</dl>
Only available on certain BlueCore variants.     </td>
  </tr>
</table>
<a class="anchor" name="a15" doxytag="pio.h::PioSetLed1" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
  <tr>
    <td class="mdRow">
      <table cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td class="md" nowrap valign="top"> void PioSetLed1           </td>
          <td class="md" valign="top">(&nbsp;</td>
          <td class="md" nowrap valign="top"><a class="el" href="csrtypes_8h.html#a9">bool</a>&nbsp;</td>
          <td class="mdname1" valign="top" nowrap> <em>enabled</em>          </td>
          <td class="md" valign="top">&nbsp;)&nbsp;</td>
          <td class="md" nowrap></td>
        </tr>
      </table>
    </td>
  </tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
Control the LED1 output pin. 
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td></td><td valign=top><em>enabled</em>&nbsp;</td><td>Enable(TRUE) or Disable(FALSE).</td></tr>
  </table>
</dl>
Only available on certain BlueCore variants.     </td>
  </tr>
</table>
<a class="anchor" name="a16" doxytag="pio.h::PioSetPsuRegulator" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
  <tr>
    <td class="mdRow">
      <table cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td class="md" nowrap valign="top"> void PioSetPsuRegulator           </td>
          <td class="md" valign="top">(&nbsp;</td>
          <td class="md" nowrap valign="top"><a class="el" href="csrtypes_8h.html#a9">bool</a>&nbsp;</td>
          <td class="mdname1" valign="top" nowrap> <em>enabled</em>          </td>
          <td class="md" valign="top">&nbsp;)&nbsp;</td>
          <td class="md" nowrap></td>
        </tr>
      </table>
    </td>
  </tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
Enable or disable the SMPSU regulator. 
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td></td><td valign=top><em>enabled</em>&nbsp;</td><td>Enable(TRUE) or Disable(FALSE).</td></tr>
  </table>
</dl>
This is only supported on BlueCore variants with charger hardware.     </td>
  </tr>
</table>
<a class="anchor" name="a17" doxytag="pio.h::PioSetPsuTrim" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
  <tr>
    <td class="mdRow">
      <table cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td class="md" nowrap valign="top"> void PioSetPsuTrim           </td>
          <td class="md" valign="top">(&nbsp;</td>
          <td class="md" nowrap valign="top"><a class="el" href="csrtypes_8h.html#a4">uint16</a>&nbsp;</td>
          <td class="mdname1" valign="top" nowrap> <em>trim</em>          </td>
          <td class="md" valign="top">&nbsp;)&nbsp;</td>
          <td class="md" nowrap></td>
        </tr>
      </table>
    </td>
  </tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
Control the trim on PSU. 
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td></td><td valign=top><em>trim</em>&nbsp;</td><td>The trim value to use.</td></tr>
  </table>
</dl>
Valid trim values range from 0 to 0xf. The trim value alters:<p>
The voltage at which the charger will move from "trickle charge" to "fast charge" modes ranging from approximately 2.7 - 3.075 V in 25mV steps.<p>
The voltage at which the charger will move from "fast charge" to "standby" modes ranging from approximately 3.8 - 4.55 V in 50mV steps.<p>
The voltage at which the charger will move from "standby" to "fast charge" modes ranging from approximately 3.75 - 4.35 V in 40mV steps.<p>
This is only supported on BlueCore variants with charger hardware.     </td>
  </tr>
</table>
<a class="anchor" name="a18" doxytag="pio.h::PioDimLed0" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
  <tr>
    <td class="mdRow">
      <table cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td class="md" nowrap valign="top"> <a class="el" href="csrtypes_8h.html#a9">bool</a> PioDimLed0           </td>
          <td class="md" valign="top">(&nbsp;</td>
          <td class="md" nowrap valign="top"><a class="el" href="csrtypes_8h.html#a4">uint16</a>&nbsp;</td>
          <td class="mdname" nowrap> <em>duty_cycle</em>, </td>
        </tr>
        <tr>
          <td class="md" nowrap align="right"></td>
          <td></td>
          <td class="md" nowrap><a class="el" href="csrtypes_8h.html#a4">uint16</a>&nbsp;</td>
          <td class="mdname" nowrap> <em>period</em></td>
        </tr>
        <tr>
          <td></td>
          <td class="md">)&nbsp;</td>
          <td class="md" colspan="2"></td>
        </tr>
      </table>
    </td>
  </tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
Controls the intensity of LED0. 
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td></td><td valign=top><em>duty_cycle</em>&nbsp;</td><td>The PWM duty cycle. Valid values range from 0..0xFFF. 0x0 turns the LED off fully, 0xFFF turns the LED on fully. All other values set the duty cycle to the value /4096. </td></tr>
    <tr><td></td><td valign=top><em>period</em>&nbsp;</td><td>The PWM period. Valid values range from 0..0xF. The period is used as follows...</td></tr>
  </table>
</dl>
ClockPeriod(1/16MHz) * PWMSequenceLength(4096) * 2^PWMPeriod<p>
The resultant range of values in 256us...8.39s when BlueCore is running at full speed. The clock period will be longer when BlueCore is in shallow or deep sleep.<p>
Invalid parameters will result in a FALSE return value and the LED brightness will not be altered.<p>
Note: B3-audio does not include LED dimmer controls, and so calling this function will return FALSE and have no effect.     </td>
  </tr>
</table>
<a class="anchor" name="a19" doxytag="pio.h::PioDimLed1" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
  <tr>
    <td class="mdRow">
      <table cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td class="md" nowrap valign="top"> <a class="el" href="csrtypes_8h.html#a9">bool</a> PioDimLed1           </td>
          <td class="md" valign="top">(&nbsp;</td>
          <td class="md" nowrap valign="top"><a class="el" href="csrtypes_8h.html#a4">uint16</a>&nbsp;</td>
          <td class="mdname" nowrap> <em>duty_cycle</em>, </td>
        </tr>
        <tr>
          <td class="md" nowrap align="right"></td>
          <td></td>
          <td class="md" nowrap><a class="el" href="csrtypes_8h.html#a4">uint16</a>&nbsp;</td>
          <td class="mdname" nowrap> <em>period</em></td>
        </tr>
        <tr>
          <td></td>
          <td class="md">)&nbsp;</td>
          <td class="md" colspan="2"></td>
        </tr>
      </table>
    </td>
  </tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
Controls the intensity of LED1. 
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td></td><td valign=top><em>duty_cycle</em>&nbsp;</td><td>The PWM duty cycle. Valid values range from 0..0xFFF. </td></tr>
    <tr><td></td><td valign=top><em>period</em>&nbsp;</td><td>The PWM period. Valid values range from 0..0xF.</td></tr>
  </table>
</dl>
The duty_cycle and period operate as in PioDimLed0.<p>
Invalid parameters will result in a FALSE return value and the LED brightness will not be altered.<p>
Note: B3-audio does not include LED dimmer controls, and so calling this function will return FALSE and have no effect.     </td>
  </tr>
</table>
<a class="anchor" name="a20" doxytag="pio.h::PioSetMicBiasHwEnabled" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">