hueso/Sensor-Watch
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Activity

deploy: af18673e1a

Browse Source
This commit is contained in:
joeycastillo
2024-02-07 19:02:57 +00:00
parent cd62140803
commit 849ae6e1c4
103 changed files with 1303 additions and 985 deletions
Download Patch File Download Diff File Expand all files Collapse all files

50
group__adc.html
View File

@@ -3,7 +3,7 @@
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<meta http-equiv="X-UA-Compatible" content="IE=11"/>
<meta name="generator" content="Doxygen 1.9.5"/>
<meta name="generator" content="Doxygen 1.9.8"/>
<meta name="viewport" content="width=device-width, initial-scale=1"/>
<title>Sensor Watch: Analog Input</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
@@ -30,7 +30,7 @@
</table>
</div>
<!-- end header part -->
<!-- Generated by Doxygen 1.9.5 -->
<!-- Generated by Doxygen 1.9.8 -->
<script type="text/javascript">
/* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&amp;dn=expat.txt MIT */
var searchBox = new SearchBox("searchBox", "search/",'.html');
@@ -82,7 +82,7 @@ $(function() {
<table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a id="enum-members" name="enum-members"></a>
Enumerations</h2></td></tr>
<tr class="memitem:ga844283c184c3510635199e50c64304c8"><td class="memItemLeft" align="right" valign="top"><a id="ga844283c184c3510635199e50c64304c8" name="ga844283c184c3510635199e50c64304c8"></a>enum &#160;</td><td class="memItemRight" valign="bottom"><b>watch_adc_reference_voltage</b> { <b>ADC_REFERENCE_INTREF</b> = 0
<tr class="memitem:ga844283c184c3510635199e50c64304c8" id="r_ga844283c184c3510635199e50c64304c8"><td class="memItemLeft" align="right" valign="top"><a id="ga844283c184c3510635199e50c64304c8" name="ga844283c184c3510635199e50c64304c8"></a>enum &#160;</td><td class="memItemRight" valign="bottom"><b>watch_adc_reference_voltage</b> { <b>ADC_REFERENCE_INTREF</b> = 0
, <b>ADC_REFERENCE_VCC_DIV1POINT6</b>
, <b>ADC_REFERENCE_VCC_DIV2</b>
, <b>ADC_REFERENCE_VCC</b>
@@ -91,37 +91,37 @@ Enumerations</h2></td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a id="func-members" name="func-members"></a>
Functions</h2></td></tr>
<tr class="memitem:ga908b5334af677309b03d7679d77aaa02"><td class="memItemLeft" align="right" valign="top"><a id="ga908b5334af677309b03d7679d77aaa02" name="ga908b5334af677309b03d7679d77aaa02"></a>
<tr class="memitem:ga908b5334af677309b03d7679d77aaa02" id="r_ga908b5334af677309b03d7679d77aaa02"><td class="memItemLeft" align="right" valign="top"><a id="ga908b5334af677309b03d7679d77aaa02" name="ga908b5334af677309b03d7679d77aaa02"></a>
void&#160;</td><td class="memItemRight" valign="bottom"><b>watch_enable_adc</b> (void)</td></tr>
<tr class="memdesc:ga908b5334af677309b03d7679d77aaa02"><td class="mdescLeft">&#160;</td><td class="mdescRight">Enables the ADC peripheral. You must call this before attempting to read a value from an analog pin. <br /></td></tr>
<tr class="separator:ga908b5334af677309b03d7679d77aaa02"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:ga30a491e9cab049a2812f75862a613aa8"><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__adc.html#ga30a491e9cab049a2812f75862a613aa8">watch_enable_analog_input</a> (const uint8_t pin)</td></tr>
<tr class="memdesc:ga30a491e9cab049a2812f75862a613aa8"><td class="mdescLeft">&#160;</td><td class="mdescRight">Configures the selected pin for analog input. <a href="group__adc.html#ga30a491e9cab049a2812f75862a613aa8">More...</a><br /></td></tr>
<tr class="memitem:ga30a491e9cab049a2812f75862a613aa8" id="r_ga30a491e9cab049a2812f75862a613aa8"><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__adc.html#ga30a491e9cab049a2812f75862a613aa8">watch_enable_analog_input</a> (const uint8_t pin)</td></tr>
<tr class="memdesc:ga30a491e9cab049a2812f75862a613aa8"><td class="mdescLeft">&#160;</td><td class="mdescRight">Configures the selected pin for analog input. <br /></td></tr>
<tr class="separator:ga30a491e9cab049a2812f75862a613aa8"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:ga2064244f68cff87a1df08f6b07183069"><td class="memItemLeft" align="right" valign="top">uint16_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__adc.html#ga2064244f68cff87a1df08f6b07183069">watch_get_analog_pin_level</a> (const uint8_t pin)</td></tr>
<tr class="memdesc:ga2064244f68cff87a1df08f6b07183069"><td class="mdescLeft">&#160;</td><td class="mdescRight">Reads an analog value from one of the pins. <a href="group__adc.html#ga2064244f68cff87a1df08f6b07183069">More...</a><br /></td></tr>
<tr class="memitem:ga2064244f68cff87a1df08f6b07183069" id="r_ga2064244f68cff87a1df08f6b07183069"><td class="memItemLeft" align="right" valign="top">uint16_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__adc.html#ga2064244f68cff87a1df08f6b07183069">watch_get_analog_pin_level</a> (const uint8_t pin)</td></tr>
<tr class="memdesc:ga2064244f68cff87a1df08f6b07183069"><td class="mdescLeft">&#160;</td><td class="mdescRight">Reads an analog value from one of the pins. <br /></td></tr>
<tr class="separator:ga2064244f68cff87a1df08f6b07183069"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:ga90bac58a3fa935d8fd640f4b58c8037d"><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__adc.html#ga90bac58a3fa935d8fd640f4b58c8037d">watch_set_analog_num_samples</a> (uint16_t samples)</td></tr>
<tr class="memdesc:ga90bac58a3fa935d8fd640f4b58c8037d"><td class="mdescLeft">&#160;</td><td class="mdescRight">Sets the number of samples to accumulate when measuring a pin level. Default is 16. <a href="group__adc.html#ga90bac58a3fa935d8fd640f4b58c8037d">More...</a><br /></td></tr>
<tr class="memitem:ga90bac58a3fa935d8fd640f4b58c8037d" id="r_ga90bac58a3fa935d8fd640f4b58c8037d"><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__adc.html#ga90bac58a3fa935d8fd640f4b58c8037d">watch_set_analog_num_samples</a> (uint16_t samples)</td></tr>
<tr class="memdesc:ga90bac58a3fa935d8fd640f4b58c8037d"><td class="mdescLeft">&#160;</td><td class="mdescRight">Sets the number of samples to accumulate when measuring a pin level. Default is 16. <br /></td></tr>
<tr class="separator:ga90bac58a3fa935d8fd640f4b58c8037d"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:gae9f9ed34e8752e211c1692af473a88dc"><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__adc.html#gae9f9ed34e8752e211c1692af473a88dc">watch_set_analog_sampling_length</a> (uint8_t cycles)</td></tr>
<tr class="memdesc:gae9f9ed34e8752e211c1692af473a88dc"><td class="mdescLeft">&#160;</td><td class="mdescRight">Sets the length of time spent sampling, which allows measurement of higher impedance inputs. Default is 1. <a href="group__adc.html#gae9f9ed34e8752e211c1692af473a88dc">More...</a><br /></td></tr>
<tr class="memitem:gae9f9ed34e8752e211c1692af473a88dc" id="r_gae9f9ed34e8752e211c1692af473a88dc"><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__adc.html#gae9f9ed34e8752e211c1692af473a88dc">watch_set_analog_sampling_length</a> (uint8_t cycles)</td></tr>
<tr class="memdesc:gae9f9ed34e8752e211c1692af473a88dc"><td class="mdescLeft">&#160;</td><td class="mdescRight">Sets the length of time spent sampling, which allows measurement of higher impedance inputs. Default is 1. <br /></td></tr>
<tr class="separator:gae9f9ed34e8752e211c1692af473a88dc"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:ga9ea7b8aef4573f02ff3adafcf891cd93"><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__adc.html#ga9ea7b8aef4573f02ff3adafcf891cd93">watch_set_analog_reference_voltage</a> (watch_adc_reference_voltage reference)</td></tr>
<tr class="memdesc:ga9ea7b8aef4573f02ff3adafcf891cd93"><td class="mdescLeft">&#160;</td><td class="mdescRight">Selects the reference voltage to use for analog readings. Default is ADC_REFERENCE_VCC. <a href="group__adc.html#ga9ea7b8aef4573f02ff3adafcf891cd93">More...</a><br /></td></tr>
<tr class="memitem:ga9ea7b8aef4573f02ff3adafcf891cd93" id="r_ga9ea7b8aef4573f02ff3adafcf891cd93"><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__adc.html#ga9ea7b8aef4573f02ff3adafcf891cd93">watch_set_analog_reference_voltage</a> (watch_adc_reference_voltage reference)</td></tr>
<tr class="memdesc:ga9ea7b8aef4573f02ff3adafcf891cd93"><td class="mdescLeft">&#160;</td><td class="mdescRight">Selects the reference voltage to use for analog readings. Default is ADC_REFERENCE_VCC. <br /></td></tr>
<tr class="separator:ga9ea7b8aef4573f02ff3adafcf891cd93"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:ga465fcb058492d350d29fe4403df85b14"><td class="memItemLeft" align="right" valign="top">uint16_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__adc.html#ga465fcb058492d350d29fe4403df85b14">watch_get_vcc_voltage</a> (void)</td></tr>
<tr class="memdesc:ga465fcb058492d350d29fe4403df85b14"><td class="mdescLeft">&#160;</td><td class="mdescRight">Returns the voltage of the VCC supply in millivolts (i.e. 3000 mV == 3.0 V). If running on a coin cell, this will be the battery voltage. <a href="group__adc.html#ga465fcb058492d350d29fe4403df85b14">More...</a><br /></td></tr>
<tr class="memitem:ga465fcb058492d350d29fe4403df85b14" id="r_ga465fcb058492d350d29fe4403df85b14"><td class="memItemLeft" align="right" valign="top">uint16_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__adc.html#ga465fcb058492d350d29fe4403df85b14">watch_get_vcc_voltage</a> (void)</td></tr>
<tr class="memdesc:ga465fcb058492d350d29fe4403df85b14"><td class="mdescLeft">&#160;</td><td class="mdescRight">Returns the voltage of the VCC supply in millivolts (i.e. 3000 mV == 3.0 V). If running on a coin cell, this will be the battery voltage. <br /></td></tr>
<tr class="separator:ga465fcb058492d350d29fe4403df85b14"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:gae38e15840bc5f3eca16ccb782dbb1c31"><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__adc.html#gae38e15840bc5f3eca16ccb782dbb1c31">watch_disable_analog_input</a> (const uint8_t pin)</td></tr>
<tr class="memdesc:gae38e15840bc5f3eca16ccb782dbb1c31"><td class="mdescLeft">&#160;</td><td class="mdescRight">Disables the analog circuitry on the selected pin. <a href="group__adc.html#gae38e15840bc5f3eca16ccb782dbb1c31">More...</a><br /></td></tr>
<tr class="memitem:gae38e15840bc5f3eca16ccb782dbb1c31" id="r_gae38e15840bc5f3eca16ccb782dbb1c31"><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__adc.html#gae38e15840bc5f3eca16ccb782dbb1c31">watch_disable_analog_input</a> (const uint8_t pin)</td></tr>
<tr class="memdesc:gae38e15840bc5f3eca16ccb782dbb1c31"><td class="mdescLeft">&#160;</td><td class="mdescRight">Disables the analog circuitry on the selected pin. <br /></td></tr>
<tr class="separator:gae38e15840bc5f3eca16ccb782dbb1c31"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:gaf443c79008bec5ceecbd21ad401d52cb"><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__adc.html#gaf443c79008bec5ceecbd21ad401d52cb">watch_disable_adc</a> (void)</td></tr>
<tr class="memdesc:gaf443c79008bec5ceecbd21ad401d52cb"><td class="mdescLeft">&#160;</td><td class="mdescRight">Disables the ADC peripheral. <a href="group__adc.html#gaf443c79008bec5ceecbd21ad401d52cb">More...</a><br /></td></tr>
<tr class="memitem:gaf443c79008bec5ceecbd21ad401d52cb" id="r_gaf443c79008bec5ceecbd21ad401d52cb"><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__adc.html#gaf443c79008bec5ceecbd21ad401d52cb">watch_disable_adc</a> (void)</td></tr>
<tr class="memdesc:gaf443c79008bec5ceecbd21ad401d52cb"><td class="mdescLeft">&#160;</td><td class="mdescRight">Disables the ADC peripheral. <br /></td></tr>
<tr class="separator:gaf443c79008bec5ceecbd21ad401d52cb"><td class="memSeparator" colspan="2">&#160;</td></tr>
</table>
<a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2>
<p >This section covers functions related to the SAM L22's analog-to-digital converter, as well as configuring and reading values from the five analog-capable pins on the 9-pin connector. </p>
<p>This section covers functions related to the SAM L22's analog-to-digital converter, as well as configuring and reading values from the five analog-capable pins on the 9-pin connector. </p>
<h2 class="groupheader">Function Documentation</h2>
<a id="gaf443c79008bec5ceecbd21ad401d52cb" name="gaf443c79008bec5ceecbd21ad401d52cb"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gaf443c79008bec5ceecbd21ad401d52cb">&#9670;&#160;</a></span>watch_disable_adc()</h2>
@@ -241,7 +241,7 @@ void&#160;</td><td class="memItemRight" valign="bottom"><b>watch_enable_adc</b>
</div><div class="memdoc">
<p>Returns the voltage of the VCC supply in millivolts (i.e. 3000 mV == 3.0 V). If running on a coin cell, this will be the battery voltage. </p>
<p >Unlike other ADC functions, this function does not return a raw value from the ADC, but rather scales it to an actual number of millivolts. This is because the ADC doesn't let us measure VCC per se; it instead lets us measure VCC / 4, and we choose to measure it against the internal reference voltage of 1.024 V. In short, the ADC gives us a number that's complicated to deal with, so we just turn it into a useful number for you :) </p><dl class="section note"><dt>Note</dt><dd>This function depends on INTREF being 1.024V. If you have changed it by poking at the supply controller's VREF.SEL bits, this function will return inaccurate values. </dd></dl>
<p>Unlike other ADC functions, this function does not return a raw value from the ADC, but rather scales it to an actual number of millivolts. This is because the ADC doesn't let us measure VCC per se; it instead lets us measure VCC / 4, and we choose to measure it against the internal reference voltage of 1.024 V. In short, the ADC gives us a number that's complicated to deal with, so we just turn it into a useful number for you :) </p><dl class="section note"><dt>Note</dt><dd>This function depends on INTREF being 1.024V. If you have changed it by poking at the supply controller's VREF.SEL bits, this function will return inaccurate values. </dd></dl>
</div>
</div>
@@ -302,8 +302,8 @@ void&#160;</td><td class="memItemRight" valign="bottom"><b>watch_enable_adc</b>
</dd>
</dl>
<p>In order to turn an analog voltage into a 16-bit integer, the ADC needs to compare the measured voltage to a reference point. For example, if you were powering the watch with VCC == 3.0V and you had two 10K resistors connected in series from 3V to GND, you could expect to get 3 volts when you measure the top of the voltage divider, 0 volts at the bottom, and 1.5 volts in the middle. If you read these values uising a reference voltage of ADC_REFERENCE_VCC, the top value would be about 65535, the bottom about 0, and the middle about 32768. However! If we used ADC_REFERENCE_VCC_DIV2 as our reference, we would expect to get 65535 both at the top and the middle, because the largest value the ADC can measure in this configutation is 1.5V (VCC / 2).</p>
<p >By changing the reference voltage from ADC_REFERENCE_VCC to ADC_REFERENCE_VCC_DIV1POINT6 or ADC_REFERENCE_VCC_DIV2, you can get more resolution when measuring small voltages (i.e. a phototransistor circuit in low light).</p>
<p >There is also a special reference voltage called ADC_REFERENCE_INTREF. The SAM L22's Supply Controller provides a selectable voltage reference (by default, 1.024 V) that you can select as a reference voltage for ADC conversions. Unlike the three references we talked about in the last paragraph, this reference voltage does not depend on VCC, which makes it very useful for measuring the battery voltage (since you can't really compare VCC to itself). You can change the INTREF voltage to 2.048 or 4.096 V by poking at the supply controller's VREF register, but the watch library does not support this use case. </p>
<p>By changing the reference voltage from ADC_REFERENCE_VCC to ADC_REFERENCE_VCC_DIV1POINT6 or ADC_REFERENCE_VCC_DIV2, you can get more resolution when measuring small voltages (i.e. a phototransistor circuit in low light).</p>
<p>There is also a special reference voltage called ADC_REFERENCE_INTREF. The SAM L22's Supply Controller provides a selectable voltage reference (by default, 1.024 V) that you can select as a reference voltage for ADC conversions. Unlike the three references we talked about in the last paragraph, this reference voltage does not depend on VCC, which makes it very useful for measuring the battery voltage (since you can't really compare VCC to itself). You can change the INTREF voltage to 2.048 or 4.096 V by poking at the supply controller's VREF register, but the watch library does not support this use case. </p>
</div>
</div>
@@ -338,7 +338,7 @@ void&#160;</td><td class="memItemRight" valign="bottom"><b>watch_enable_adc</b>
</div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
Generated by&#160;<a href="https://www.doxygen.org/index.html"><img class="footer" src="doxygen.svg" width="104" height="31" alt="doxygen"/></a> 1.9.5
Generated by&#160;<a href="https://www.doxygen.org/index.html"><img class="footer" src="doxygen.svg" width="104" height="31" alt="doxygen"/></a> 1.9.8
</small></address>
</body>
</html>