1
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
2
"http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
3
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
5
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
6
<meta name="generator" content="AsciiDoc 8.4.5" />
7
<title>modbus_read_input_bits(3)</title>
8
<style type="text/css">
10
p, li, dt, dd, div, pre, h1, h2, h3, h4, h5, h6 {
12
border: 1px solid red;
17
margin: 1em 5% 1em 5%;
22
text-decoration: underline;
42
h1, h2, h3, h4, h5, h6 {
44
font-family: sans-serif;
51
border-bottom: 2px solid silver;
69
border: 1px solid silver;
88
font-family: sans-serif;
94
span#revnumber, span#revdate, span#revremark {
95
font-family: sans-serif;
99
font-family: sans-serif;
101
border-top: 2px solid silver;
107
padding-bottom: 0.5em;
111
padding-bottom: 0.5em;
116
margin-bottom: 1.5em;
118
div.tableblock, div.imageblock, div.exampleblock, div.verseblock,
119
div.quoteblock, div.literalblock, div.listingblock, div.sidebarblock,
120
div.admonitionblock {
122
margin-bottom: 1.5em;
124
div.admonitionblock {
126
margin-bottom: 2.5em;
129
div.content { /* Block element content. */
133
/* Block element titles. */
134
div.title, caption.title {
136
font-family: sans-serif;
140
margin-bottom: 0.5em;
146
td div.title:first-child {
149
div.content div.title:first-child {
152
div.content + div.title {
156
div.sidebarblock > div.content {
158
border: 1px solid silver;
162
div.listingblock > div.content {
163
border: 1px solid silver;
172
div.quoteblock > div.attribution {
181
div.verseblock > div.content {
184
div.verseblock > div.attribution {
188
/* DEPRECATED: Pre version 8.2.7 verse style literal block. */
189
div.verseblock + div.attribution {
193
div.admonitionblock .icon {
197
text-decoration: underline;
199
padding-right: 0.5em;
201
div.admonitionblock td.content {
203
border-left: 2px solid silver;
206
div.exampleblock > div.content {
207
border-left: 2px solid silver;
211
div.imageblock div.content { padding-left: 0; }
212
span.image img { border-style: none; }
213
a.image:visited { color: white; }
217
margin-bottom: 0.8em;
230
list-style-position: outside;
233
list-style-type: decimal;
236
list-style-type: lower-alpha;
239
list-style-type: upper-alpha;
242
list-style-type: lower-roman;
245
list-style-type: upper-roman;
248
div.compact ul, div.compact ol,
249
div.compact p, div.compact p,
250
div.compact div, div.compact div {
252
margin-bottom: 0.1em;
255
div.tableblock > table {
256
border: 3px solid #527bbd;
259
font-family: sans-serif;
271
/* Because the table frame attribute is overriden by CSS in most browsers. */
272
div.tableblock > table[frame="void"] {
275
div.tableblock > table[frame="hsides"] {
276
border-left-style: none;
277
border-right-style: none;
279
div.tableblock > table[frame="vsides"] {
280
border-top-style: none;
281
border-bottom-style: none;
287
margin-bottom: 0.8em;
290
padding-bottom: 15px;
292
dt.hdlist1.strong, td.hdlist1.strong {
298
padding-right: 0.8em;
304
div.hdlist.compact tr {
314
div#footer-badges { display: none; }
319
font-family: sans-serif;
323
margin-bottom: 0.1em;
326
div.toclevel1, div.toclevel2, div.toclevel3, div.toclevel4 {
342
/* Overrides for manpage documents */
345
padding-bottom: 0.5em;
346
border-top: 2px solid silver;
347
border-bottom: 2px solid silver;
357
div#toc { display: none; }
360
/* Workarounds for IE6's broken and incomplete CSS2. */
362
div.sidebar-content {
364
border: 1px solid silver;
367
div.sidebar-title, div.image-title {
369
font-family: sans-serif;
372
margin-bottom: 0.5em;
375
div.listingblock div.content {
376
border: 1px solid silver;
381
div.quoteblock-attribution {
386
div.verseblock-content {
389
div.verseblock-attribution {
394
div.exampleblock-content {
395
border-left: 2px solid silver;
399
/* IE6 sets dynamically generated links as visited. */
400
div#toc a:visited { color: blue; }
406
modbus_read_input_bits(3) Manual Page
409
<div class="sectionbody">
410
<p>modbus_read_input_bits -
415
<h2 id="_synopsis">SYNOPSIS</h2>
416
<div class="sectionbody">
417
<div class="paragraph"><p><strong>int modbus_read_input_bits(modbus_t *<em>ctx</em>, int <em>addr</em>, int <em>nb</em>, uint8_t *<em>dest</em>);</strong></p></div>
419
<h2 id="_description">DESCRIPTION</h2>
420
<div class="sectionbody">
421
<div class="paragraph"><p>The <em>modbus_read_input_bits()</em> function shall read the content of the <em>nb</em> input
422
bits to the address <em>addr</em> of the remote device. The result of reading is stored
423
in <em>dest</em> array as unsigned bytes (8 bits) set to <em>TRUE</em> or <em>FALSE</em>.</p></div>
424
<div class="paragraph"><p>You must take care to allocate enough memory to store the results in <em>dest</em>
425
(at least <em>nb</em> * sizeof(uint8_t)).</p></div>
426
<div class="paragraph"><p>The function uses the Modbus function code 0x02 (read input status).</p></div>
428
<h2 id="_return_value">RETURN VALUE</h2>
429
<div class="sectionbody">
430
<div class="paragraph"><p>The <em>modbus_read_input_status()</em> function shall return the number of read
431
input status if successful. Otherwise it shall return -1 and set errno.</p></div>
433
<h2 id="_errors">ERRORS</h2>
434
<div class="sectionbody">
435
<div class="dlist"><dl>
441
Too many discrete inputs requested
446
<h2 id="_see_also">SEE ALSO</h2>
447
<div class="sectionbody">
448
<div class="paragraph"><p><a href="modbus_read_input_registers.html">modbus_read_input_registers(3)</a></p></div>
450
<h2 id="_authors">AUTHORS</h2>
451
<div class="sectionbody">
452
<div class="paragraph"><p>The libmodbus documentation was written by Stéphane Raimbault
453
<<a href="mailto:stephane.raimbault@gmail.com">stephane.raimbault@gmail.com</a>></p></div>
456
<div id="footnotes"><hr /></div>
458
<div id="footer-text">
459
libmodbus 3.0.3<br />
460
Last updated 2011-09-09 22:29:56 CEST
added
removed
doc/modbus_read_input_bits.html
