© MCS Electronics, 1995-2007
'___1wid_bit_number, Byte '___1wlast_zero, Byte '___1wlast_discrepancy , Byte '___1wire_data , string * 7 (8 bytes)
'[DIM variables used]
'we need some space from at least 8 bytes to store the ID
Dim Reg_no(8) As Byte
'we need a loop counter and a word/integer for counting the ID's on the bus
Dim I As Byte , W As Word
'Now search for the first device on the bus Reg_no(1) = 1wsearchfirst()
For I = 1 To 8 |
'print the number |
Print Hex(reg_no(i)); |
|
Next |
|
|
|
Do |
|
'Now search for other devices |
|
Reg_no(1) = 1wsearchnext() |
|
For I = 1 To 8 |
|
Print Hex(reg_no(i)); |
|
Next |
|
|
|
Loop Until Err = 1 |
|
'When ERR = 1 is returned it means that no device is found anymore 'You could also count the number of devices
W = 1wirecount()
'It is IMPORTANT that the 1wirecount function returns a word/integer 'So the result variable must be of the type word or integer
'But you may assign it to a byte or long too of course
Print W
'as a bonus the next routine :
'first fill the array with an existing number Reg_no(1) = 1wsearchfirst()
'unremark next line to chance a byte to test the ERR flag 'Reg_no(1) = 2
'now verify if the number exists 1wverify Reg_no(1)
Print Err
'err =1 when the ID passed n reg_no() does NOT exist
'optinal call it with pinnumber line 1wverify reg_no(1),pinb,1
'As for the other 1wire statements/functions, you can provide the port and pin number as anoption
'W = 1wirecount(pinb , 1) 'for example look at pin PINB.1
End
1WVERIFY
Action
This verifies if an ID is available on the 1wire bus.
page -265-
© MCS Electronics, 1995-2007
Syntax
1WVERIFY ar(1)
Remarks
Ar(1) |
A byte array that holds the ID to verify. |
|
|
Returns ERR set to 0 when the ID is found on the bus otherwise it wil be 1.
ASM
The following asm routines are called from mcs.lib.
_1wire_Search_Next : (calls _1WIRE, _ADJUST_PIN , _ADJUST_BIT_ADDRESS)
See also
1WWRITE , 1WRESET , 1WREAD , 1WSEARCHFIRST, 1WIRECOUNT
Example
'----------------------------------------------------------------------------- |
|
--- |
: 1wireSearch.bas |
'name |
|
'copyright |
: (c) 1995-2005, MCS Electronics |
'purpose |
: demonstrates 1wsearch |
'micro |
: Mega48 |
'suited for demo |
: yes |
'commercial addon needed |
: no |
'----------------------------------------------------------------------------- |
|
--- |
|
$regfile = "m48def.dat" |
|
$crystal = 4000000 |
|
$hwstack = 32 |
' default use 32 |
for the hardware stack |
'default use 10 |
$swstack = 10 |
|
for the SW stack |
'default use 40 |
$framesize = 40 |
|
for the frame space |
|
Config 1wire = Portb.0 |
'use this pin |
'On the STK200 jumper B.0 |
must be inserted |
'The following internal bytes are used by the scan routines '___1w_bitstorage , Byte used for bit storage :
'lastdeviceflag bit 0
' |
id_bit |
bit 1 |
|
' |
cmp_id_bit |
bit |
2 |
' |
search_dir |
bit |
3 |
'___1wid_bit_number, Byte '___1wlast_zero, Byte '___1wlast_discrepancy , Byte '___1wire_data , string * 7 (8 bytes)
'[DIM variables used]
'we need some space from at least 8 bytes to store the ID
Dim Reg_no(8) As Byte
page -266-
© MCS Electronics, 1995-2007
'we need a loop counter and a word/integer for counting the ID's on the bus
Dim I As Byte , W As Word
'Now search for the first device on the bus Reg_no(1) = 1wsearchfirst()
For I = 1 To 8 |
'print the number |
Print Hex(reg_no(i)); |
|
Next |
|
|
|
Do |
|
'Now search for other devices |
|
Reg_no(1) = 1wsearchnext() |
|
For I = 1 To 8 |
|
Print Hex(reg_no(i)); |
|
Next |
|
|
|
Loop Until Err = 1 |
|
'When ERR = 1 is returned it means that no device is found anymore 'You could also count the number of devices
W = 1wirecount()
'It is IMPORTANT that the 1wirecount function returns a word/integer 'So the result variable must be of the type word or integer
'But you may assign it to a byte or long too of course
Print W
'as a bonus the next routine :
'first fill the array with an existing number Reg_no(1) = 1wsearchfirst()
'unremark next line to chance a byte to test the ERR flag 'Reg_no(1) = 2
'now verify if the number exists 1wverify Reg_no(1)
Print Err
'err =1 when the ID passed n reg_no() does NOT exist
'optinal call it with pinnumber line 1wverify reg_no(1),pinb,1
'As for the other 1wire statements/functions, you can provide the port and pin number as anoption
'W = 1wirecount(pinb , 1) 'for example look at pin PINB.1
End
1WWRITE
Action
This statement writes a variable to the 1wire bus.
Syntax
1WWRITE var1
1WWRITE var1, bytes 1WWRITE var1 , bytes , port , pin
page -267-
© MCS Electronics, 1995-2007
Remarks
var1 |
Sends the value of var1 to the bus. The number of bytes can be specified too |
|
but this is optional. |
bytes |
The number of bytes to write. Must be specified when port and pin are used. |
port |
The name of the PORT PINx register like PINB or PIND. |
pin |
The pin number in the range from 0-7. May be a numeric constant or |
|
variable. |
|
|
Multiple 1-wire devices on different pins are supported.
To use this you must specify the port and pin that are used for the communication.
The 1wreset, 1wwrite and 1wread statements will work together when used with the old syntax. And the pin can be configured from the compiler options or with the CONFIG 1WIRE statement.
The syntax for additional 1-wire devices is : 1WRESET port , pin
1WWRITE var/constant, bytes, port , pin
var = 1WREAD(bytes, port, pin) ,for reading multiple bytes
See also
1WREAD , 1WRESET
Example
'----------------------------------------------------------------------------- |
|
--- |
: 1wire.bas |
'name |
|
'copyright |
: (c) 1995-2005, MCS Electronics |
'purpose |
: demonstrates 1wreset, 1wwrite and 1wread() |
'micro |
: Mega48 |
'suited for demo |
: yes |
'commercial addon needed |
: no |
' pull-up of 4K7 required to VCC from Portb.2 |
|
' DS2401 serial button connected to Portb.2 |
|
'----------------------------------------------------------------------------- |
|
--- |
|
$regfile = "m48def.dat" |
|
$crystal = 4000000 |
|
$hwstack = 32 |
' default use 32 |
for the hardware stack |
'default use 10 |
$swstack = 10 |
|
for the SW stack |
'default use 40 |
$framesize = 40 |
|
for the frame space |
|
'when only bytes are used, use the following lib for smaller code |
|
$lib "mcsbyte.lib" |
|
Config 1wire = Portb.0 |
'use this pin |
'On the STK200 jumper B.0 must be inserted page -268-
© MCS Electronics, 1995-2007 |
|
Dim Ar(8) As Byte , A As Byte , I As Byte |
|
Do |
|
Wait 1 |
'reset the device |
1wreset |
|
Print Err |
'print error 1 if |
error |
'read ROM command |
1wwrite &H33 |
|
For I = 1 To 8 |
'place into array |
Ar(i) = 1wread() |
|
Next |
|
'You could also read 8 bytes a time by unremarking the next line |
|
'and by deleting the for next above |
'read 8 bytes |
'Ar(1) = 1wread(8) |
|
For I = 1 To 8 |
'print output |
Print Hex(ar(i)); |
|
Next |
'linefeed |
Loop |
|
'NOTE THAT WHEN YOU COMPILE THIS SAMPLE THE CODE WILL RUN TO THIS POINT 'THIS because of the DO LOOP that is never terminated!!!
'New is the possibility to use more than one 1 wire bus |
|
'The following syntax must be used: |
|
For I = 1 To 8 |
'clear array to |
Ar(i) = 0 |
|
see that it works |
|
Next |
|
1wreset Pinb , 2 |
'use this port and |
pin for the second device |
'note that now the |
1wwrite &H33 , 1 , Pinb , 2 |
|
number of bytes must be specified! |
|
'1wwrite Ar(1) , 5,pinb,2 |
|
'reading is also different |
'read 8 bytes from |
Ar(1) = 1wread(8 , Pinb , 2) |
|
portB on pin 2 |
|
For I = 1 To 8 |
|
Print Hex(ar(i)); |
|
Next |
|
'you could create a loop with a variable for the bit number !
For I = 0 To 3 'for pin 0-3 1wreset Pinb , I
1wwrite &H33 , 1 , Pinb , I Ar(1) = 1wread(8 , Pinb , I)
For A = 1 To 8 Print Hex(ar(a));
Next
Print Next
End
page -269-