Artifact 2f08a4d1014e15967664f6d180b73d2490e841b4:
Wiki page
[
onewire] by
schelte
2014-03-20 11:47:55.
0000: 44 20 32 30 31 34 2d 30 33 2d 32 30 54 31 31 3a D 2014-03-20T11:
0010: 34 37 3a 35 35 2e 34 36 33 0a 4c 20 6f 6e 65 77 47:55.463.L onew
0020: 69 72 65 0a 55 20 73 63 68 65 6c 74 65 0a 57 20 ire.U schelte.W
0030: 31 39 32 31 0a 3c 68 31 3e 54 68 65 20 6f 6e 65 1921.<h1>The one
0040: 77 69 72 65 20 63 6f 6d 6d 61 6e 64 3c 2f 68 31 wire command</h1
0050: 3e 0d 0a 0d 0a 3c 68 72 3e 0d 0a 0d 0a 3c 68 32 >....<hr>....<h2
0060: 3e 53 79 6e 6f 70 73 69 73 3c 2f 68 32 3e 0d 0a >Synopsis</h2>..
0070: 3c 62 3e 70 61 63 6b 61 67 65 20 72 65 71 75 69 <b>package requi
0080: 72 65 20 6f 6e 65 77 69 72 65 3c 2f 62 3e 0d 0a re onewire</b>..
0090: 0d 0a 3c 62 3e 6f 6e 65 77 69 72 65 3c 2f 62 3e ..<b>onewire</b>
00a0: 20 3c 69 3e 73 75 62 63 6f 6d 6d 61 6e 64 3c 2f <i>subcommand</
00b0: 69 3e 20 3f 3c 69 3e 61 72 67 20 2e 2e 2e 3c 2f i> ?<i>arg ...</
00c0: 69 3e 3f 0d 0a 0d 0a 3c 68 72 3e 0d 0a 0d 0a 3c i>?....<hr>....<
00d0: 68 32 3e 44 65 73 63 72 69 70 74 69 6f 6e 3c 2f h2>Description</
00e0: 68 32 3e 0d 0a 0d 0a 54 68 65 20 3c 62 3e 6f 6e h2>....The <b>on
00f0: 65 77 69 72 65 3c 2f 62 3e 20 63 6f 6d 6d 61 6e ewire</b> comman
0100: 64 20 6c 65 74 73 20 79 6f 75 20 69 6e 74 65 72 d lets you inter
0110: 61 63 74 20 77 69 74 68 20 44 53 32 34 38 32 20 act with DS2482
0120: 62 61 73 65 64 20 64 65 76 69 63 65 73 2e 20 42 based devices. B
0130: 6f 74 68 20 74 68 65 20 44 53 32 34 38 32 2d 31 oth the DS2482-1
0140: 30 30 2c 20 64 72 69 76 69 6e 67 20 61 20 73 69 00, driving a si
0150: 6e 67 6c 65 20 31 2d 77 69 72 65 20 69 6e 74 65 ngle 1-wire inte
0160: 72 66 61 63 65 2c 20 61 6e 64 20 74 68 65 20 44 rface, and the D
0170: 53 32 34 38 32 2d 38 30 30 20 64 72 69 76 69 6e S2482-800 drivin
0180: 67 20 38 20 31 2d 77 69 72 65 20 69 6e 74 65 72 g 8 1-wire inter
0190: 66 61 63 65 73 2c 20 63 61 6e 20 62 65 20 75 73 faces, can be us
01a0: 65 64 2e 20 54 68 65 20 6c 65 67 61 6c 20 76 61 ed. The legal va
01b0: 6c 75 65 73 20 6f 66 20 3c 69 3e 73 75 62 63 6f lues of <i>subco
01c0: 6d 6d 61 6e 64 3c 2f 69 3e 20 61 72 65 20 6c 69 mmand</i> are li
01d0: 73 74 65 64 20 62 65 6c 6f 77 2e 20 4e 6f 74 65 sted below. Note
01e0: 20 74 68 61 74 20 79 6f 75 20 63 61 6e 20 61 62 that you can ab
01f0: 62 72 65 76 69 61 74 65 20 74 68 65 20 3c 69 3e breviate the <i>
0200: 73 75 62 63 6f 6d 6d 61 6e 64 3c 2f 69 3e 73 2e subcommand</i>s.
0210: 0d 0a 0d 0a 3c 64 6c 3e 0d 0a 3c 64 74 3e 3c 62 ....<dl>..<dt><b
0220: 3e 6f 6e 65 77 69 72 65 20 64 73 32 34 38 32 3c >onewire ds2482<
0230: 2f 62 3e 20 3c 69 3e 62 75 73 3c 2f 69 3e 20 3f /b> <i>bus</i> ?
0240: 3c 69 3e 6e 75 6d 62 65 72 3c 2f 69 3e 3f 0d 0a <i>number</i>?..
0250: 3c 64 64 3e 4f 70 65 6e 20 61 20 63 68 61 6e 6e <dd>Open a chann
0260: 65 6c 20 74 6f 20 61 20 44 53 32 34 38 32 20 64 el to a DS2482 d
0270: 65 76 69 63 65 2e 20 54 68 65 72 65 20 63 61 6e evice. There can
0280: 20 62 65 20 75 70 20 74 6f 20 66 6f 75 72 20 44 be up to four D
0290: 53 32 34 38 32 2d 31 30 30 20 64 65 76 69 63 65 S2482-100 device
02a0: 73 2c 20 6f 72 20 75 70 20 74 6f 20 65 69 67 68 s, or up to eigh
02b0: 74 20 44 53 32 34 38 32 2d 38 30 30 20 64 65 76 t DS2482-800 dev
02c0: 69 63 65 73 20 6f 6e 20 74 68 65 20 73 61 6d 65 ices on the same
02d0: 20 69 32 63 20 62 75 73 2e 20 54 68 65 20 3c 69 i2c bus. The <i
02e0: 3e 6e 75 6d 62 65 72 3c 2f 69 3e 20 61 72 67 75 >number</i> argu
02f0: 6d 65 6e 74 20 73 65 6c 65 63 74 73 20 77 68 69 ment selects whi
0300: 63 68 20 6f 66 20 74 68 65 20 64 65 76 69 63 65 ch of the device
0310: 73 20 74 6f 20 61 63 63 65 73 73 2e 20 54 68 65 s to access. The
0320: 20 63 6f 6d 6d 61 6e 64 20 72 65 74 75 72 6e 73 command returns
0330: 20 74 68 65 20 63 68 61 6e 6e 65 6c 20 68 61 6e the channel han
0340: 64 6c 65 2e 0d 0a 3c 64 74 3e 3c 62 3e 6f 6e 65 dle...<dt><b>one
0350: 77 69 72 65 20 63 6f 6e 66 69 67 75 72 65 3c 2f wire configure</
0360: 62 3e 20 3c 69 3e 68 61 6e 64 6c 65 3c 2f 69 3e b> <i>handle</i>
0370: 20 3f 3c 69 3e 6f 70 74 69 6f 6e 3c 2f 69 3e 20 ?<i>option</i>
0380: 2e 2e 2e 3f 0d 0a 3c 64 64 3e 43 6f 6e 66 69 67 ...?..<dd>Config
0390: 75 72 65 20 74 68 65 20 31 2d 77 69 72 65 20 69 ure the 1-wire i
03a0: 6e 74 65 72 66 61 63 65 20 6f 70 74 69 6f 6e 73 nterface options
03b0: 2e 20 41 6c 6c 20 73 70 65 63 69 66 69 65 64 20 . All specified
03c0: 6f 70 74 69 6f 6e 73 20 77 69 6c 6c 20 62 65 20 options will be
03d0: 65 6e 61 62 6c 65 64 2c 20 77 68 69 6c 65 20 75 enabled, while u
03e0: 6e 73 70 65 63 69 66 69 65 64 20 6f 70 74 69 6f nspecified optio
03f0: 6e 73 20 61 72 65 20 64 69 73 61 62 6c 65 64 2e ns are disabled.
0400: 20 56 61 6c 69 64 20 6f 70 74 69 6f 6e 73 20 61 Valid options a
0410: 72 65 3a 0d 0a 3c 75 6c 3e 3c 6c 69 3e 3c 62 3e re:..<ul><li><b>
0420: 41 50 55 3c 2f 62 3e 20 2d 20 41 63 74 69 76 65 APU</b> - Active
0430: 20 70 75 6c 6c 2d 75 70 3c 6c 69 3e 3c 62 3e 53 pull-up<li><b>S
0440: 50 55 3c 2f 62 3e 20 2d 20 53 74 72 6f 6e 67 20 PU</b> - Strong
0450: 70 75 6c 6c 2d 75 70 3c 6c 69 3e 3c 62 3e 31 57 pull-up<li><b>1W
0460: 53 3c 2f 62 3e 20 2d 20 4f 76 65 72 64 72 69 76 S</b> - Overdriv
0470: 65 20 73 70 65 65 64 3c 2f 75 6c 3e 0d 0a 3c 64 e speed</ul>..<d
0480: 74 3e 3c 62 3e 6f 6e 65 77 69 72 65 20 63 68 61 t><b>onewire cha
0490: 6e 6e 65 6c 3c 2f 62 3e 20 3c 69 3e 68 61 6e 64 nnel</b> <i>hand
04a0: 6c 65 3c 2f 69 3e 20 3c 69 3e 63 68 61 6e 6e 65 le</i> <i>channe
04b0: 6c 3c 2f 69 3e 0d 0a 3c 64 64 3e 53 65 6c 65 63 l</i>..<dd>Selec
04c0: 74 20 77 68 69 63 68 20 6f 66 20 74 68 65 20 38 t which of the 8
04d0: 20 31 2d 77 69 72 65 20 63 68 61 6e 6e 65 6c 73 1-wire channels
04e0: 20 74 6f 20 61 63 63 65 73 73 2e 20 54 68 69 73 to access. This
04f0: 20 69 73 20 6f 6e 6c 79 20 61 70 70 6c 69 63 61 is only applica
0500: 62 6c 65 20 66 6f 72 20 44 53 32 34 38 32 2d 38 ble for DS2482-8
0510: 30 30 20 64 65 76 69 63 65 73 2e 0d 0a 3c 64 74 00 devices...<dt
0520: 3e 3c 62 3e 6f 6e 65 77 69 72 65 20 69 6e 76 65 ><b>onewire inve
0530: 6e 74 6f 72 79 3c 2f 62 3e 20 3c 69 3e 68 61 6e ntory</b> <i>han
0540: 64 6c 65 3c 2f 69 3e 0d 0a 3c 64 64 3e 46 69 6e dle</i>..<dd>Fin
0550: 64 20 74 68 65 20 61 64 64 72 65 73 73 65 73 20 d the addresses
0560: 6f 66 20 61 6c 6c 20 31 2d 77 69 72 65 20 64 65 of all 1-wire de
0570: 76 69 63 65 73 20 6f 6e 20 74 68 65 20 31 2d 77 vices on the 1-w
0580: 69 72 65 20 62 75 73 2e 20 54 68 65 20 61 64 64 ire bus. The add
0590: 72 65 73 73 65 73 20 61 72 65 20 72 65 74 75 72 resses are retur
05a0: 6e 65 64 20 61 73 20 61 20 6c 69 73 74 2c 20 77 ned as a list, w
05b0: 68 65 72 65 20 65 61 63 68 20 64 65 76 69 63 65 here each device
05c0: 20 69 73 20 61 20 6c 69 73 74 20 6f 66 20 38 20 is a list of 8
05d0: 62 79 74 65 73 20 65 78 70 72 65 73 73 65 64 20 bytes expressed
05e0: 69 6e 20 64 65 63 69 6d 61 6c 2e 0d 0a 3c 64 74 in decimal...<dt
05f0: 3e 3c 62 3e 6f 6e 65 77 69 72 65 20 63 6f 6e 76 ><b>onewire conv
0600: 65 72 74 3c 2f 62 3e 20 3c 69 3e 68 61 6e 64 6c ert</b> <i>handl
0610: 65 3c 2f 69 3e 20 3f 3c 69 3e 64 65 76 69 63 65 e</i> ?<i>device
0620: 3c 2f 69 3e 3f 0d 0a 3c 64 64 3e 49 6e 73 74 72 </i>?..<dd>Instr
0630: 75 63 74 20 6f 6e 65 20 6f 72 20 61 6c 6c 20 74 uct one or all t
0640: 65 6d 70 65 72 61 74 75 72 65 20 73 65 6e 73 6f emperature senso
0650: 72 73 20 6f 6e 20 74 68 65 20 31 2d 77 69 72 65 rs on the 1-wire
0660: 20 62 75 73 20 74 6f 20 73 74 61 72 74 20 61 20 bus to start a
0670: 74 65 6d 70 65 72 61 74 75 72 65 20 63 6f 6e 76 temperature conv
0680: 65 72 73 69 6f 6e 2e 0d 0a 3c 64 74 3e 3c 62 3e ersion...<dt><b>
0690: 6f 6e 65 77 69 72 65 20 74 65 6d 70 65 72 61 74 onewire temperat
06a0: 75 72 65 3c 2f 62 3e 20 3c 69 3e 68 61 6e 64 6c ure</b> <i>handl
06b0: 65 3c 2f 69 3e 20 3f 3c 69 3e 64 65 76 69 63 65 e</i> ?<i>device
06c0: 3c 2f 69 3e 3f 0d 0a 3c 64 64 3e 52 65 61 64 20 </i>?..<dd>Read
06d0: 74 68 65 20 72 65 73 75 6c 74 20 6f 66 20 74 68 the result of th
06e0: 65 20 6c 61 73 74 20 74 65 6d 70 65 72 61 74 75 e last temperatu
06f0: 72 65 20 63 6f 6e 76 65 72 73 69 6f 6e 2e 20 54 re conversion. T
0700: 68 65 20 3c 69 3e 64 65 76 69 63 65 3c 2f 69 3e he <i>device</i>
0710: 20 61 72 67 75 6d 65 6e 74 20 6d 61 79 20 6f 6e argument may on
0720: 6c 79 20 62 65 20 6f 6d 69 74 74 65 64 20 69 66 ly be omitted if
0730: 20 74 68 65 72 65 20 69 73 20 65 78 61 63 74 6c there is exactl
0740: 79 20 6f 6e 65 20 31 2d 77 69 72 65 20 64 65 76 y one 1-wire dev
0750: 69 63 65 20 63 6f 6e 6e 65 63 74 65 64 20 6f 6e ice connected on
0760: 20 74 68 65 20 62 75 73 2e 20 54 68 69 73 20 63 the bus. This c
0770: 6f 6d 6d 61 6e 64 20 73 75 70 70 6f 72 74 73 20 ommand supports
0780: 62 6f 74 68 20 44 53 31 38 53 32 30 20 61 6e 64 both DS18S20 and
0790: 20 44 53 31 38 42 32 30 20 74 65 6d 70 65 72 61 DS18B20 tempera
07a0: 74 75 72 65 20 73 65 6e 73 6f 72 73 2e 0d 0a 3c ture sensors...<
07b0: 2f 64 6c 3e 0d 0a 0a 5a 20 33 64 65 63 36 34 61 /dl>...Z 3dec64a
07c0: 30 64 62 37 64 36 32 34 65 33 31 66 39 32 30 61 0db7d624e31f920a
07d0: 62 61 35 32 64 33 31 64 64 0a ba52d31dd.