Skip to content

Commit 3f2a214

Browse files
authored
Merge pull request #22 from libdriver/dev
fix: fix doc errors
2 parents e8d771b + bbe33d3 commit 3f2a214

23 files changed

+248
-242
lines changed

CHANGELOG.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,9 @@
1+
## 2.0.2 (2024-12-21)
2+
3+
## Bug Fixes
4+
5+
- fix doc errors
6+
17
## 2.0.1 (2024-08-10)
28

39
## Bug Fixes

doc/html/group__pcf8591__base__driver.html

Lines changed: 35 additions & 35 deletions
Original file line numberDiff line numberDiff line change
@@ -393,9 +393,9 @@ <h2 class="memtitle"><span class="permalink"><a href="#ga020ba9f4bcaf91a966fa795
393393
<p>convert a dac value to a register raw data </p>
394394
<dl class="params"><dt>Parameters</dt><dd>
395395
<table class="params">
396-
<tr><td class="paramdir">[in]</td><td class="paramname">*handle</td><td>points to a pcf8591 handle structure </td></tr>
397-
<tr><td class="paramdir">[in]</td><td class="paramname">dac</td><td>is a converted dac value </td></tr>
398-
<tr><td class="paramdir">[out]</td><td class="paramname">*reg</td><td>points to a register raw buffer </td></tr>
396+
<tr><td class="paramdir">[in]</td><td class="paramname">*handle</td><td>pointer to a pcf8591 handle structure </td></tr>
397+
<tr><td class="paramdir">[in]</td><td class="paramname">dac</td><td>converted dac value </td></tr>
398+
<tr><td class="paramdir">[out]</td><td class="paramname">*reg</td><td>pointer to a register raw buffer </td></tr>
399399
</table>
400400
</dd>
401401
</dl>
@@ -430,7 +430,7 @@ <h2 class="memtitle"><span class="permalink"><a href="#gac8910d5e29cfdaf4aba0f9f
430430
<p>close the chip </p>
431431
<dl class="params"><dt>Parameters</dt><dd>
432432
<table class="params">
433-
<tr><td class="paramdir">[in]</td><td class="paramname">*handle</td><td>points to a pcf8591 handle structure </td></tr>
433+
<tr><td class="paramdir">[in]</td><td class="paramname">*handle</td><td>pointer to a pcf8591 handle structure </td></tr>
434434
</table>
435435
</dd>
436436
</dl>
@@ -476,8 +476,8 @@ <h2 class="memtitle"><span class="permalink"><a href="#ga6b7b4a26473158a84565a31
476476
<p>get the address pin </p>
477477
<dl class="params"><dt>Parameters</dt><dd>
478478
<table class="params">
479-
<tr><td class="paramdir">[in]</td><td class="paramname">*handle</td><td>points to a pcf8591 handle structure </td></tr>
480-
<tr><td class="paramdir">[out]</td><td class="paramname">*addr_pin</td><td>points to a chip address pins buffer </td></tr>
479+
<tr><td class="paramdir">[in]</td><td class="paramname">*handle</td><td>pointer to a pcf8591 handle structure </td></tr>
480+
<tr><td class="paramdir">[out]</td><td class="paramname">*addr_pin</td><td>pointer to a chip address pins buffer </td></tr>
481481
</table>
482482
</dd>
483483
</dl>
@@ -521,8 +521,8 @@ <h2 class="memtitle"><span class="permalink"><a href="#ga3bf3fefc3ff64a69db20f81
521521
<p>get the adc auto increment read mode </p>
522522
<dl class="params"><dt>Parameters</dt><dd>
523523
<table class="params">
524-
<tr><td class="paramdir">[in]</td><td class="paramname">*handle</td><td>points to a pcf8591 handle structure </td></tr>
525-
<tr><td class="paramdir">[out]</td><td class="paramname">*enable</td><td>points to a bool value buffer </td></tr>
524+
<tr><td class="paramdir">[in]</td><td class="paramname">*handle</td><td>pointer to a pcf8591 handle structure </td></tr>
525+
<tr><td class="paramdir">[out]</td><td class="paramname">*enable</td><td>pointer to a bool value buffer </td></tr>
526526
</table>
527527
</dd>
528528
</dl>
@@ -567,8 +567,8 @@ <h2 class="memtitle"><span class="permalink"><a href="#ga1b89f2a27fbf992a7ea6291
567567
<p>get the adc channel </p>
568568
<dl class="params"><dt>Parameters</dt><dd>
569569
<table class="params">
570-
<tr><td class="paramdir">[in]</td><td class="paramname">*handle</td><td>points to a pcf8591 handle structure </td></tr>
571-
<tr><td class="paramdir">[out]</td><td class="paramname">*channel</td><td>points to an adc channel buffer </td></tr>
570+
<tr><td class="paramdir">[in]</td><td class="paramname">*handle</td><td>pointer to a pcf8591 handle structure </td></tr>
571+
<tr><td class="paramdir">[out]</td><td class="paramname">*channel</td><td>pointer to an adc channel buffer </td></tr>
572572
</table>
573573
</dd>
574574
</dl>
@@ -613,8 +613,8 @@ <h2 class="memtitle"><span class="permalink"><a href="#ga7636444b3f59c57d92ebdf8
613613
<p>get the adc mode </p>
614614
<dl class="params"><dt>Parameters</dt><dd>
615615
<table class="params">
616-
<tr><td class="paramdir">[in]</td><td class="paramname">*handle</td><td>points to a pcf8591 handle structure </td></tr>
617-
<tr><td class="paramdir">[out]</td><td class="paramname">*mode</td><td>points to an adc mode buffer </td></tr>
616+
<tr><td class="paramdir">[in]</td><td class="paramname">*handle</td><td>pointer to a pcf8591 handle structure </td></tr>
617+
<tr><td class="paramdir">[out]</td><td class="paramname">*mode</td><td>pointer to an adc mode buffer </td></tr>
618618
</table>
619619
</dd>
620620
</dl>
@@ -659,8 +659,8 @@ <h2 class="memtitle"><span class="permalink"><a href="#ga9b94fdde9cd15430b01efe7
659659
<p>get the adc reference voltage </p>
660660
<dl class="params"><dt>Parameters</dt><dd>
661661
<table class="params">
662-
<tr><td class="paramdir">[in]</td><td class="paramname">*handle</td><td>points to a pcf8591 handle structure </td></tr>
663-
<tr><td class="paramdir">[out]</td><td class="paramname">*ref_voltage</td><td>points to an adc reference voltage buffer </td></tr>
662+
<tr><td class="paramdir">[in]</td><td class="paramname">*handle</td><td>pointer to a pcf8591 handle structure </td></tr>
663+
<tr><td class="paramdir">[out]</td><td class="paramname">*ref_voltage</td><td>pointer to an adc reference voltage buffer </td></tr>
664664
</table>
665665
</dd>
666666
</dl>
@@ -695,7 +695,7 @@ <h2 class="memtitle"><span class="permalink"><a href="#ga0c522639b1a95beb4edb8db
695695
<p>get chip's information </p>
696696
<dl class="params"><dt>Parameters</dt><dd>
697697
<table class="params">
698-
<tr><td class="paramdir">[out]</td><td class="paramname">*info</td><td>points to a pcf8591 info structure </td></tr>
698+
<tr><td class="paramdir">[out]</td><td class="paramname">*info</td><td>pointer to a pcf8591 info structure </td></tr>
699699
</table>
700700
</dd>
701701
</dl>
@@ -729,7 +729,7 @@ <h2 class="memtitle"><span class="permalink"><a href="#ga2ca386791960303ac6c0309
729729
<p>initialize the chip </p>
730730
<dl class="params"><dt>Parameters</dt><dd>
731731
<table class="params">
732-
<tr><td class="paramdir">[in]</td><td class="paramname">*handle</td><td>points to a pcf8591 handle structure </td></tr>
732+
<tr><td class="paramdir">[in]</td><td class="paramname">*handle</td><td>pointer to a pcf8591 handle structure </td></tr>
733733
</table>
734734
</dd>
735735
</dl>
@@ -787,10 +787,10 @@ <h2 class="memtitle"><span class="permalink"><a href="#ga4b82a0a9a1f4ebc8bf6bf9e
787787
<p>read the multiple channel data from the chip </p>
788788
<dl class="params"><dt>Parameters</dt><dd>
789789
<table class="params">
790-
<tr><td class="paramdir">[in]</td><td class="paramname">*handle</td><td>points to a pcf8591 handle structure </td></tr>
791-
<tr><td class="paramdir">[out]</td><td class="paramname">*raw</td><td>points to a raw adc buffer </td></tr>
792-
<tr><td class="paramdir">[out]</td><td class="paramname">*adc</td><td>points to a converted adc buffer </td></tr>
793-
<tr><td class="paramdir">[in,out]</td><td class="paramname">*len</td><td>points to an adc length buffer </td></tr>
790+
<tr><td class="paramdir">[in]</td><td class="paramname">*handle</td><td>pointer to a pcf8591 handle structure </td></tr>
791+
<tr><td class="paramdir">[out]</td><td class="paramname">*raw</td><td>pointer to a raw adc buffer </td></tr>
792+
<tr><td class="paramdir">[out]</td><td class="paramname">*adc</td><td>pointer to a converted adc buffer </td></tr>
793+
<tr><td class="paramdir">[in,out]</td><td class="paramname">*len</td><td>pointer to an adc length buffer </td></tr>
794794
</table>
795795
</dd>
796796
</dl>
@@ -842,9 +842,9 @@ <h2 class="memtitle"><span class="permalink"><a href="#ga0b39dca43839c19d3ec6e0b
842842
<p>read data from the chip </p>
843843
<dl class="params"><dt>Parameters</dt><dd>
844844
<table class="params">
845-
<tr><td class="paramdir">[in]</td><td class="paramname">*handle</td><td>points to a pcf8591 handle structure </td></tr>
846-
<tr><td class="paramdir">[out]</td><td class="paramname">*raw</td><td>points to a raw adc buffer </td></tr>
847-
<tr><td class="paramdir">[out]</td><td class="paramname">*adc</td><td>points to a converted adc buffer </td></tr>
845+
<tr><td class="paramdir">[in]</td><td class="paramname">*handle</td><td>pointer to a pcf8591 handle structure </td></tr>
846+
<tr><td class="paramdir">[out]</td><td class="paramname">*raw</td><td>pointer to a raw adc buffer </td></tr>
847+
<tr><td class="paramdir">[out]</td><td class="paramname">*adc</td><td>pointer to a converted adc buffer </td></tr>
848848
</table>
849849
</dd>
850850
</dl>
@@ -890,8 +890,8 @@ <h2 class="memtitle"><span class="permalink"><a href="#ga1b674f6f1a1fc601617b690
890890
<p>set the address pin </p>
891891
<dl class="params"><dt>Parameters</dt><dd>
892892
<table class="params">
893-
<tr><td class="paramdir">[in]</td><td class="paramname">*handle</td><td>points to a pcf8591 handle structure </td></tr>
894-
<tr><td class="paramdir">[in]</td><td class="paramname">addr_pin</td><td>is the chip address pins </td></tr>
893+
<tr><td class="paramdir">[in]</td><td class="paramname">*handle</td><td>pointer to a pcf8591 handle structure </td></tr>
894+
<tr><td class="paramdir">[in]</td><td class="paramname">addr_pin</td><td>chip address pins </td></tr>
895895
</table>
896896
</dd>
897897
</dl>
@@ -935,8 +935,8 @@ <h2 class="memtitle"><span class="permalink"><a href="#gaf6ae6ea059b986cd3074649
935935
<p>set the adc auto increment read mode </p>
936936
<dl class="params"><dt>Parameters</dt><dd>
937937
<table class="params">
938-
<tr><td class="paramdir">[in]</td><td class="paramname">*handle</td><td>points to a pcf8591 handle structure </td></tr>
939-
<tr><td class="paramdir">[in]</td><td class="paramname">enable</td><td>is a bool value </td></tr>
938+
<tr><td class="paramdir">[in]</td><td class="paramname">*handle</td><td>pointer to a pcf8591 handle structure </td></tr>
939+
<tr><td class="paramdir">[in]</td><td class="paramname">enable</td><td>bool value </td></tr>
940940
</table>
941941
</dd>
942942
</dl>
@@ -982,8 +982,8 @@ <h2 class="memtitle"><span class="permalink"><a href="#ga6abca278ca1c99c4a5e1a0d
982982
<p>set the adc channel </p>
983983
<dl class="params"><dt>Parameters</dt><dd>
984984
<table class="params">
985-
<tr><td class="paramdir">[in]</td><td class="paramname">*handle</td><td>points to a pcf8591 handle structure </td></tr>
986-
<tr><td class="paramdir">[in]</td><td class="paramname">channel</td><td>is the adc channel </td></tr>
985+
<tr><td class="paramdir">[in]</td><td class="paramname">*handle</td><td>pointer to a pcf8591 handle structure </td></tr>
986+
<tr><td class="paramdir">[in]</td><td class="paramname">channel</td><td>adc channel </td></tr>
987987
</table>
988988
</dd>
989989
</dl>
@@ -1029,8 +1029,8 @@ <h2 class="memtitle"><span class="permalink"><a href="#ga58e39aaf064b360541c8a2f
10291029
<p>set the adc mode </p>
10301030
<dl class="params"><dt>Parameters</dt><dd>
10311031
<table class="params">
1032-
<tr><td class="paramdir">[in]</td><td class="paramname">*handle</td><td>points to a pcf8591 handle structure </td></tr>
1033-
<tr><td class="paramdir">[in]</td><td class="paramname">mode</td><td>is the adc mode </td></tr>
1032+
<tr><td class="paramdir">[in]</td><td class="paramname">*handle</td><td>pointer to a pcf8591 handle structure </td></tr>
1033+
<tr><td class="paramdir">[in]</td><td class="paramname">mode</td><td>adc mode </td></tr>
10341034
</table>
10351035
</dd>
10361036
</dl>
@@ -1076,8 +1076,8 @@ <h2 class="memtitle"><span class="permalink"><a href="#ga66e04d5b655adbdbb4ae475
10761076
<p>set the adc reference voltage </p>
10771077
<dl class="params"><dt>Parameters</dt><dd>
10781078
<table class="params">
1079-
<tr><td class="paramdir">[in]</td><td class="paramname">*handle</td><td>points to a pcf8591 handle structure </td></tr>
1080-
<tr><td class="paramdir">[in]</td><td class="paramname">ref_voltage</td><td>is the adc reference voltage </td></tr>
1079+
<tr><td class="paramdir">[in]</td><td class="paramname">*handle</td><td>pointer to a pcf8591 handle structure </td></tr>
1080+
<tr><td class="paramdir">[in]</td><td class="paramname">ref_voltage</td><td>adc reference voltage </td></tr>
10811081
</table>
10821082
</dd>
10831083
</dl>
@@ -1122,8 +1122,8 @@ <h2 class="memtitle"><span class="permalink"><a href="#ga1d6327acfcb231d13be8295
11221122
<p>write to the dac </p>
11231123
<dl class="params"><dt>Parameters</dt><dd>
11241124
<table class="params">
1125-
<tr><td class="paramdir">[in]</td><td class="paramname">*handle</td><td>points to a pcf8591 handle structure </td></tr>
1126-
<tr><td class="paramdir">[in]</td><td class="paramname">data</td><td>is the dac value </td></tr>
1125+
<tr><td class="paramdir">[in]</td><td class="paramname">*handle</td><td>pointer to a pcf8591 handle structure </td></tr>
1126+
<tr><td class="paramdir">[in]</td><td class="paramname">data</td><td>dac value </td></tr>
11271127
</table>
11281128
</dd>
11291129
</dl>

doc/html/group__pcf8591__example__driver.html

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -233,8 +233,8 @@ <h2 class="memtitle"><span class="permalink"><a href="#ga71e7a511f7541292975a421
233233
<p>basic example init </p>
234234
<dl class="params"><dt>Parameters</dt><dd>
235235
<table class="params">
236-
<tr><td class="paramdir">[in]</td><td class="paramname">addr</td><td>is the iic device address </td></tr>
237-
<tr><td class="paramdir">[in]</td><td class="paramname">mode</td><td>is the adc mode </td></tr>
236+
<tr><td class="paramdir">[in]</td><td class="paramname">addr</td><td>iic device address </td></tr>
237+
<tr><td class="paramdir">[in]</td><td class="paramname">mode</td><td>adc mode </td></tr>
238238
</table>
239239
</dd>
240240
</dl>
@@ -278,8 +278,8 @@ <h2 class="memtitle"><span class="permalink"><a href="#ga479a5a31c9d239209625030
278278
<p>basic example read the adc </p>
279279
<dl class="params"><dt>Parameters</dt><dd>
280280
<table class="params">
281-
<tr><td class="paramdir">[out]</td><td class="paramname">*raw</td><td>points to a raw adc buffer </td></tr>
282-
<tr><td class="paramdir">[out]</td><td class="paramname">*adc</td><td>points to a converted adc buffer </td></tr>
281+
<tr><td class="paramdir">[out]</td><td class="paramname">*raw</td><td>pointer to a raw adc buffer </td></tr>
282+
<tr><td class="paramdir">[out]</td><td class="paramname">*adc</td><td>pointer to a converted adc buffer </td></tr>
283283
</table>
284284
</dd>
285285
</dl>
@@ -313,7 +313,7 @@ <h2 class="memtitle"><span class="permalink"><a href="#ga613fbe7c6ff5ed9a4a8b9f6
313313
<p>basic example set the channel </p>
314314
<dl class="params"><dt>Parameters</dt><dd>
315315
<table class="params">
316-
<tr><td class="paramdir">[in]</td><td class="paramname">channel</td><td>is the adc channel </td></tr>
316+
<tr><td class="paramdir">[in]</td><td class="paramname">channel</td><td>adc channel </td></tr>
317317
</table>
318318
</dd>
319319
</dl>
@@ -347,7 +347,7 @@ <h2 class="memtitle"><span class="permalink"><a href="#gaa77694966f650bcd5140ed2
347347
<p>basic example write the dac </p>
348348
<dl class="params"><dt>Parameters</dt><dd>
349349
<table class="params">
350-
<tr><td class="paramdir">[in]</td><td class="paramname">dac</td><td>is a converted dac value </td></tr>
350+
<tr><td class="paramdir">[in]</td><td class="paramname">dac</td><td>converted dac value </td></tr>
351351
</table>
352352
</dd>
353353
</dl>
@@ -419,8 +419,8 @@ <h2 class="memtitle"><span class="permalink"><a href="#ga104ac87d4afd92b148bf0a4
419419
<p>increment example init </p>
420420
<dl class="params"><dt>Parameters</dt><dd>
421421
<table class="params">
422-
<tr><td class="paramdir">[in]</td><td class="paramname">addr</td><td>is the iic device address </td></tr>
423-
<tr><td class="paramdir">[in]</td><td class="paramname">mode</td><td>is the adc mode </td></tr>
422+
<tr><td class="paramdir">[in]</td><td class="paramname">addr</td><td>iic device address </td></tr>
423+
<tr><td class="paramdir">[in]</td><td class="paramname">mode</td><td>adc mode </td></tr>
424424
</table>
425425
</dd>
426426
</dl>
@@ -470,9 +470,9 @@ <h2 class="memtitle"><span class="permalink"><a href="#ga256ce26b3f9203c33c0b0ce
470470
<p>increment example read the adc </p>
471471
<dl class="params"><dt>Parameters</dt><dd>
472472
<table class="params">
473-
<tr><td class="paramdir">[out]</td><td class="paramname">*raw</td><td>points to a raw adc buffer </td></tr>
474-
<tr><td class="paramdir">[out]</td><td class="paramname">*adc</td><td>points to a converted adc buffer </td></tr>
475-
<tr><td class="paramdir">[in,out]</td><td class="paramname">*len</td><td>points to a input buffer length address </td></tr>
473+
<tr><td class="paramdir">[out]</td><td class="paramname">*raw</td><td>pointer to a raw adc buffer </td></tr>
474+
<tr><td class="paramdir">[out]</td><td class="paramname">*adc</td><td>pointer to a converted adc buffer </td></tr>
475+
<tr><td class="paramdir">[in,out]</td><td class="paramname">*len</td><td>pointer to a input buffer length address </td></tr>
476476
</table>
477477
</dd>
478478
</dl>
@@ -506,7 +506,7 @@ <h2 class="memtitle"><span class="permalink"><a href="#ga44fed10e2dd370f7b315aa8
506506
<p>increment example write the dac </p>
507507
<dl class="params"><dt>Parameters</dt><dd>
508508
<table class="params">
509-
<tr><td class="paramdir">[in]</td><td class="paramname">dac</td><td>is a converted dac value </td></tr>
509+
<tr><td class="paramdir">[in]</td><td class="paramname">dac</td><td>converted dac value </td></tr>
510510
</table>
511511
</dd>
512512
</dl>

doc/html/group__pcf8591__extern__driver.html

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -141,9 +141,9 @@ <h2 class="memtitle"><span class="permalink"><a href="#gac14d76f8f19207991bc4295
141141
<p>get the chip register </p>
142142
<dl class="params"><dt>Parameters</dt><dd>
143143
<table class="params">
144-
<tr><td class="paramdir">[in]</td><td class="paramname">*handle</td><td>points to a pcf8591 handle structure </td></tr>
145-
<tr><td class="paramdir">[out]</td><td class="paramname">*buf</td><td>points to a data buffer. </td></tr>
146-
<tr><td class="paramdir">[in]</td><td class="paramname">len</td><td>is the data buffer </td></tr>
144+
<tr><td class="paramdir">[in]</td><td class="paramname">*handle</td><td>pointer to a pcf8591 handle structure </td></tr>
145+
<tr><td class="paramdir">[out]</td><td class="paramname">*buf</td><td>pointer to a data buffer. </td></tr>
146+
<tr><td class="paramdir">[in]</td><td class="paramname">len</td><td>data buffer length </td></tr>
147147
</table>
148148
</dd>
149149
</dl>
@@ -195,9 +195,9 @@ <h2 class="memtitle"><span class="permalink"><a href="#gafe8bc995155299255e0b299
195195
<p>set the chip register </p>
196196
<dl class="params"><dt>Parameters</dt><dd>
197197
<table class="params">
198-
<tr><td class="paramdir">[in]</td><td class="paramname">*handle</td><td>points to a pcf8591 handle structure </td></tr>
199-
<tr><td class="paramdir">[in]</td><td class="paramname">*buf</td><td>points to a data buffer. </td></tr>
200-
<tr><td class="paramdir">[in]</td><td class="paramname">len</td><td>is the data buffer </td></tr>
198+
<tr><td class="paramdir">[in]</td><td class="paramname">*handle</td><td>pointer to a pcf8591 handle structure </td></tr>
199+
<tr><td class="paramdir">[in]</td><td class="paramname">*buf</td><td>pointer to a data buffer. </td></tr>
200+
<tr><td class="paramdir">[in]</td><td class="paramname">len</td><td>data buffer length </td></tr>
201201
</table>
202202
</dd>
203203
</dl>

0 commit comments

Comments
 (0)