1 //---------------------------------------------------------------------------
2 // Copyright (C) 2000 Dallas Semiconductor Corporation, All Rights Reserved.
4 // Permission is hereby granted, free of charge, to any person obtaining a
5 // copy of this software and associated documentation files (the "Software"),
6 // to deal in the Software without restriction, including without limitation
7 // the rights to use, copy, modify, merge, publish, distribute, sublicense,
8 // and/or sell copies of the Software, and to permit persons to whom the
9 // Software is furnished to do so, subject to the following conditions:
11 // The above copyright notice and this permission notice shall be included
12 // in all copies or substantial portions of the Software.
14 // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
15 // OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
16 // MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
17 // IN NO EVENT SHALL DALLAS SEMICONDUCTOR BE LIABLE FOR ANY CLAIM, DAMAGES
18 // OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
19 // ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
20 // OTHER DEALINGS IN THE SOFTWARE.
22 // Except as contained in this notice, the name of Dallas Semiconductor
23 // shall not be used except as stated in the Dallas Semiconductor
25 //---------------------------------------------------------------------------
27 // tstow.C - Test application to test 1-Wire Net functions. No EPROM writes.
31 // History: 1.00 -> 1.01 Change to use msDelay instead of Sleep.
33 // 1.01 -> 1.02 Changed to generic OpenCOM/CloseCOM for easier
34 // use with other platforms.
35 // 1.02 -> 1.03 Removed caps in #includes for Linux capatibility
36 // Changed to use Acquire/Release 1-Wire Net functions
37 // 1.03 -> 2.00 Reorganization of Public Domain Kit
45 void PrintSerialNum(int portnum);
49 char *argv[]={__FILE__, "exow"};
51 //----------------------------------------------------------------------
54 int main() //short argc, char **argv)
56 int PortNum=1,rslt,i,j,testcnt=0,length;
57 uchar TempSerialNum[8];
58 uchar tran_buffer[2000], filename[10];
62 // check for required port name
65 printf("1-Wire Net name required on command line!\n"
66 " (example: \"COM1\" (Win32 DS2480),\"/dev/cua0\" "
67 "(Linux DS2480),\"1\" (Win32 TMEX)\n");
71 // attempt to acquire the 1-Wire Net
72 if (!owAcquire(portnum, argv[1], return_msg))
74 printf("%s",return_msg);
79 printf("%s",return_msg);
81 //----------------------------------------
83 printf("\n/---------------------------------------------\n");
84 printf(" The following is a test excersize of the\n"
85 " 1-Wire Net public domain library Version 2.00.\n\n"
86 " This test was run using with 2 DS1920's (DS1820),\n"
87 " 1 DS1971 (DS2430), and 1 DS1996.\n\n");
89 //----------------------------------------
90 // First the devices on the 1-Wire Net
91 printf("\n/---------------------------------------------\n");
92 printf("TEST%d: Searching for devices on 1-Wire Net\n",testcnt++);
94 // find the first device (all devices not just alarming)
95 rslt = owFirst(portnum,TRUE, FALSE);
98 // print the Serial Number of the device just found
99 PrintSerialNum(portnum);
101 // find the next device
102 rslt = owNext(portnum,TRUE, FALSE);
105 //----------------------------------------
106 // now search for the part with a 0x0C family code (DS1996)
107 printf("\n/---------------------------------------------\n");
108 printf("TEST%d: Set to find first device with 0x0C family code\n",testcnt++);
110 owFamilySearchSetup(portnum,0x0C);
112 // find the first 0x0c device
114 while (TempSerialNum[0]!=0x0c && owNext(portnum,TRUE,FALSE)) {
115 owSerialNum(portnum,TempSerialNum,TRUE);
117 printf("search result %d\n",TempSerialNum[0]==0x0c);
119 // print the Serial Number of the device just found
120 PrintSerialNum(portnum);
122 //----------------------------------------
123 // Access a device and read ram
124 printf("\n/---------------------------------------------\n");
125 printf("TEST%d: Access the current device and read ram\n",testcnt++);
127 printf("owAccess %d\n",owAccess(portnum));
129 printf("Read Ram 0xF0: %02X\n",owTouchByte(portnum,0xF0));
130 printf("Address0 0x00: %02X\n",owTouchByte(portnum,0x00));
131 printf("Address1 0x00: %02X\n",owTouchByte(portnum,0x00));
134 for (i = 0; i < 32; i++)
135 printf("%02X ",owTouchByte(portnum,0xFF));
138 //----------------------------------------
139 // Read ram with owBlock
140 printf("\n/---------------------------------------------\n");
141 printf("TEST%d: Read ram with owBlock\n",testcnt++);
142 for (i = 0; i < 32; i++)
143 tran_buffer[i] = 0xFF;
145 printf("owBlock %d\n",owBlock(portnum,FALSE,tran_buffer,32));
147 for (i = 0; i < 32; i++)
148 printf("%02X ",tran_buffer[i]);
151 //----------------------------------------
152 // Write a packet in each page of DS1996
153 printf("\n/---------------------------------------------\n");
154 printf("TEST%d: Place the DS1996 into overdrive\n",testcnt++);
155 printf("owOverdriveAccess %d\n",owOverdriveAccess(portnum));
157 //----------------------------------------
158 // Write 4 packets with owWritePacketStd
159 printf("\n/---------------------------------------------\n");
160 printf("TEST%d: Write 4 packets with owWritePacketStd\n",testcnt++);
162 for (j = 0; j < 4; j++)
164 for (i = 0; i < 29; i++)
165 tran_buffer[i] = (uchar)i + j;
167 printf("Write page %d: %d\n",j,owWritePacketStd(portnum,j,tran_buffer,29,FALSE,FALSE));
169 for (i = 0; i < 29; i++)
172 length = owReadPacketStd(portnum,TRUE,j,tran_buffer);
174 printf("Read page %d: %d\n",j,length);
176 for (i = 0; i < length; i++)
177 printf("%02X",tran_buffer[i]);
181 //----------------------------------------
182 // Write a file to DS1996
183 printf("\n/---------------------------------------------\n");
184 printf("TEST%d: Format and write a file (in overdrive)\n",testcnt++);
185 sprintf(filename,"DEMO");
186 // set the data to write
187 for (i = 0; i < 2000; i++)
188 tran_buffer[i] = i % 255;
189 printf("Format and write file DEMO.000 %d\n",
190 owFormatWriteFile(portnum,filename,2000,tran_buffer));
193 for (i = 0; i < 2000; i++)
194 tran_buffer[i] = 0x55;
195 printf("Read file DEMO.000 %d\n",owReadFile(portnum,filename,tran_buffer));
196 // print the data result
197 for (i = 0; i < 2000; i++)
201 printf("%02X",tran_buffer[i]);
205 //----------------------------------------
206 // Turn off overdrive
207 printf("\n/---------------------------------------------\n");
208 printf("TEST%d: Turn off overdrive\n",testcnt++);
209 printf("Set 1-Wire Net speed to normal %d\n",owSpeed(portnum,MODE_NORMAL));
211 //----------------------------------------
213 printf("\n/---------------------------------------------\n");
214 printf("TEST%d: Verify the current device\n",testcnt++);
216 printf("owVerify (normal) %d\n",owVerify(portnum,FALSE));
217 printf("owVerify (alarm) %d\n",owVerify(portnum,TRUE));
219 //----------------------------------------
220 // Skip the first family code found
221 printf("\n/---------------------------------------------\n");
222 printf("TEST%d: Skip the first family code found\n",testcnt++);
224 // find the next device
225 printf("search result of owFirst %d\n",owFirst(portnum,TRUE, FALSE));
227 // print the Serial Number of the device just found
228 PrintSerialNum(portnum);
230 // skip the first family type found
231 owSkipFamily(portnum);
232 printf("owSkipFamily called\n");
234 // find the next device
235 printf("search result of owNext %d\n",owNext(portnum,TRUE, FALSE));
237 // print the Serial Number of the device just found
238 PrintSerialNum(portnum);
240 //----------------------------------------
241 // Find first family code (DS1920) and read temperature
242 printf("\n/---------------------------------------------\n");
243 printf("TEST%d: Find first family code (DS1920) and read temperature\n",testcnt++);
245 // find the next device
246 printf("search result of owFirst %d\n",owFirst(portnum,TRUE, FALSE));
248 // print the Serial Number of the device just found
249 PrintSerialNum(portnum);
251 // send the convert temperature command
252 printf("Convert temperature command %02X\n",owTouchByte(portnum,0x44));
254 // set the 1-Wire Net to strong pull-up
255 printf("Set power delivery %d\n",owLevel(portnum,MODE_STRONG5));
257 // sleep for 1 second
260 // turn off the 1-Wire Net strong pull-up
261 printf("Disable power delivery %d\n",owLevel(portnum,MODE_NORMAL));
263 // read the DS1920 temperature value
264 printf("Access the DS1920 %d\n",owAccess(portnum));
265 tran_buffer[0] = 0xBE;
266 tran_buffer[1] = 0xFF;
267 tran_buffer[2] = 0xFF;
268 printf("Block to read temperature %d\n",owBlock(portnum,FALSE,tran_buffer,3));
269 // interpret the result
270 printf("result: DS1920 temperature read: %d C\n", (tran_buffer[1] |
271 ((int)tran_buffer[2] << 8)) / 2);
273 //----------------------------------------
274 // Verify the current device, could also be alarming
275 printf("\n/---------------------------------------------\n");
276 printf("TEST%d: Verify the current device, could also be alarming\n",testcnt++);
278 printf("owVerify (normal) %d\n",owVerify(portnum,FALSE));
279 printf("owVerify (alarm) %d\n",owVerify(portnum,TRUE));
281 //----------------------------------------
282 // Test setting the Serial Number with owSerialNum
283 printf("\n/---------------------------------------------\n");
284 printf("TEST%d: Test setting the Serial Number with owSerialNum\n",testcnt++);
286 // set the Serial Num to 0 to 7
287 for (i = 0; i < 8; i++)
288 TempSerialNum[i] = (uchar)i;
289 owSerialNum(portnum,TempSerialNum,FALSE);
291 // read back the Serial Number
292 PrintSerialNum(portnum);
294 //----------------------------------------
295 // Verify the current device (should fail, no such device)
296 printf("\n/---------------------------------------------\n");
297 printf("TEST%d: Verify the current device (should fail, no such device)\n",testcnt++);
299 printf("owVerify (normal) %d\n",owVerify(portnum,FALSE));
300 printf("owVerify (alarm) %d\n",owVerify(portnum,TRUE));
302 // release the 1-Wire Net
303 owRelease(portnum,return_msg);
304 printf("%s",return_msg);
310 //----------------------------------------------------------------------
311 // Read and print the Serial Number.
313 void PrintSerialNum(int portnum)
315 uchar TempSerialNumber[8];
318 owSerialNum(portnum,TempSerialNumber,TRUE);
319 for (i = 7; i >= 0; i--)
320 printf("%02X",TempSerialNumber[i]);