Artifact ff846f24c673f8e62b8b97c507e72b22e42e4da8:
Wiki page
[
dallas] by
schelte
2014-03-20 11:10:47.
0000: 44 20 32 30 31 34 2d 30 33 2d 32 30 54 31 31 3a D 2014-03-20T11:
0010: 31 30 3a 34 37 2e 39 39 39 0a 4c 20 64 61 6c 6c 10:47.999.L dall
0020: 61 73 0a 55 20 73 63 68 65 6c 74 65 0a 57 20 31 as.U schelte.W 1
0030: 30 30 38 0a 3c 68 31 3e 54 68 65 20 64 61 6c 6c 008.<h1>The dall
0040: 61 73 20 63 6f 6d 6d 61 6e 64 3c 2f 68 31 3e 0d as command</h1>.
0050: 0a 0d 0a 3c 68 72 3e 0d 0a 0d 0a 3c 68 32 3e 53 ...<hr>....<h2>S
0060: 79 6e 6f 70 73 69 73 3c 2f 68 32 3e 0d 0a 3c 62 ynopsis</h2>..<b
0070: 3e 70 61 63 6b 61 67 65 20 72 65 71 75 69 72 65 >package require
0080: 20 64 61 6c 6c 61 73 3c 2f 62 3e 0d 0a 0d 0a 3c dallas</b>....<
0090: 62 3e 64 61 6c 6c 61 73 3c 2f 62 3e 20 3c 69 3e b>dallas</b> <i>
00a0: 73 75 62 63 6f 6d 6d 61 6e 64 3c 2f 69 3e 20 3f subcommand</i> ?
00b0: 3c 69 3e 61 72 67 20 2e 2e 2e 3c 2f 69 3e 3f 0d <i>arg ...</i>?.
00c0: 0a 0d 0a 3c 68 72 3e 0d 0a 0d 0a 3c 68 32 3e 44 ...<hr>....<h2>D
00d0: 65 73 63 72 69 70 74 69 6f 6e 3c 2f 68 32 3e 0d escription</h2>.
00e0: 0a 0d 0a 54 68 65 20 3c 62 3e 64 61 6c 6c 61 73 ...The <b>dallas
00f0: 3c 2f 62 3e 20 63 6f 6d 6d 61 6e 64 20 6c 65 74 </b> command let
0100: 73 20 79 6f 75 20 69 6e 74 65 72 61 63 74 20 77 s you interact w
0110: 69 74 68 20 44 53 31 36 32 31 20 62 61 73 65 64 ith DS1621 based
0120: 20 64 65 76 69 63 65 73 20 66 6f 72 20 6d 65 61 devices for mea
0130: 73 75 72 69 6e 67 20 74 65 6d 70 65 72 61 74 75 suring temperatu
0140: 72 65 2e 20 54 68 65 20 6c 65 67 61 6c 20 76 61 re. The legal va
0150: 6c 75 65 73 20 6f 66 20 3c 69 3e 73 75 62 63 6f lues of <i>subco
0160: 6d 6d 61 6e 64 3c 2f 69 3e 20 61 72 65 20 6c 69 mmand</i> are li
0170: 73 74 65 64 20 62 65 6c 6f 77 2e 20 4e 6f 74 65 sted below. Note
0180: 20 74 68 61 74 20 79 6f 75 20 63 61 6e 20 61 62 that you can ab
0190: 62 72 65 76 69 61 74 65 20 74 68 65 20 3c 69 3e breviate the <i>
01a0: 73 75 62 63 6f 6d 6d 61 6e 64 3c 2f 69 3e 73 2e subcommand</i>s.
01b0: 0d 0a 0d 0a 3c 64 6c 3e 0d 0a 3c 64 74 3e 3c 62 ....<dl>..<dt><b
01c0: 3e 64 61 6c 6c 61 73 20 64 73 31 36 32 31 3c 2f >dallas ds1621</
01d0: 62 3e 20 3c 69 3e 62 75 73 3c 2f 69 3e 20 3f 3c b> <i>bus</i> ?<
01e0: 69 3e 6e 75 6d 62 65 72 3c 2f 69 3e 3f 0d 0a 3c i>number</i>?..<
01f0: 64 64 3e 4f 70 65 6e 20 61 20 63 68 61 6e 6e 65 dd>Open a channe
0200: 6c 20 74 6f 20 61 20 44 53 31 36 32 31 20 74 65 l to a DS1621 te
0210: 6d 70 65 72 61 74 75 72 65 20 73 65 6e 73 6f 72 mperature sensor
0220: 2e 20 54 68 65 72 65 20 63 61 6e 20 62 65 20 75 . There can be u
0230: 70 20 74 6f 20 65 69 67 68 74 20 44 53 31 36 32 p to eight DS162
0240: 31 20 73 65 6e 73 6f 72 73 20 6f 6e 20 74 68 65 1 sensors on the
0250: 20 73 61 6d 65 20 69 32 63 20 62 75 73 2e 20 54 same i2c bus. T
0260: 68 65 20 3c 69 3e 6e 75 6d 62 65 72 3c 2f 69 3e he <i>number</i>
0270: 20 61 72 67 75 6d 65 6e 74 20 73 65 6c 65 63 74 argument select
0280: 73 20 77 68 69 63 68 20 6f 66 20 74 68 65 20 65 s which of the e
0290: 69 67 68 74 20 64 65 76 69 63 65 73 20 74 6f 20 ight devices to
02a0: 61 63 63 65 73 73 2e 20 54 68 65 20 63 6f 6d 6d access. The comm
02b0: 61 6e 64 20 72 65 74 75 72 6e 73 20 74 68 65 20 and returns the
02c0: 63 68 61 6e 6e 65 6c 20 68 61 6e 64 6c 65 2e 0d channel handle..
02d0: 0a 3c 64 74 3e 3c 62 3e 64 61 6c 6c 61 73 20 63 .<dt><b>dallas c
02e0: 6f 6e 76 65 72 74 3c 2f 62 3e 20 3c 69 3e 68 61 onvert</b> <i>ha
02f0: 6e 64 6c 65 3c 2f 69 3e 0d 0a 3c 64 64 3e 49 6e ndle</i>..<dd>In
0300: 73 74 72 75 63 74 20 74 68 65 20 64 65 76 69 63 struct the devic
0310: 65 20 74 6f 20 73 74 61 72 74 20 61 20 74 65 6d e to start a tem
0320: 70 65 72 61 74 75 72 65 20 6d 65 61 73 75 72 65 perature measure
0330: 6d 65 6e 74 2e 20 41 20 74 65 6d 70 65 72 61 74 ment. A temperat
0340: 75 72 65 20 63 6f 6e 76 65 72 73 69 6f 6e 20 74 ure conversion t
0350: 61 6b 65 73 20 61 20 6d 61 78 69 6d 75 6d 20 6f akes a maximum o
0360: 66 20 37 35 30 6d 73 2e 0d 0a 3c 64 74 3e 3c 62 f 750ms...<dt><b
0370: 3e 64 61 6c 6c 61 73 20 74 65 6d 70 65 72 61 74 >dallas temperat
0380: 75 72 65 3c 2f 62 3e 20 3c 69 3e 68 61 6e 64 6c ure</b> <i>handl
0390: 65 3c 2f 69 3e 0d 0a 3c 64 64 3e 4f 62 74 61 69 e</i>..<dd>Obtai
03a0: 6e 20 74 68 65 20 72 65 73 75 6c 74 20 6f 66 20 n the result of
03b0: 74 68 65 20 6c 61 73 74 20 74 65 6d 70 65 72 61 the last tempera
03c0: 74 75 72 65 20 63 6f 6e 76 65 72 73 69 6f 6e 2e ture conversion.
03d0: 20 54 68 69 73 20 63 6f 6d 6d 61 6e 64 20 77 69 This command wi
03e0: 6c 6c 20 77 61 69 74 20 66 6f 72 20 61 20 72 75 ll wait for a ru
03f0: 6e 6e 69 6e 67 20 63 6f 6e 76 65 72 73 69 6f 6e nning conversion
0400: 20 74 6f 20 63 6f 6d 70 6c 65 74 65 2c 20 69 66 to complete, if
0410: 20 6e 65 63 65 73 73 61 72 79 2e 0d 0a 3c 2f 64 necessary...</d
0420: 6c 3e 0d 0a 0a 5a 20 62 31 63 30 65 62 66 38 39 l>...Z b1c0ebf89
0430: 36 61 34 32 65 38 64 34 33 31 64 37 33 35 64 35 6a42e8d431d735d5
0440: 35 36 38 39 63 63 63 0a 5689ccc.