- •Table of Contents
- •Index
- •Keyword Reference
- •Installation
- •Installation of BASCOM
- •BASCOM IDE
- •Running BASCOM-AVR
- •File New
- •File Close
- •File Save
- •File Save As
- •File Print Preview
- •File Print
- •File Exit
- •View PinOut
- •View PDF viewer
- •View Error Panel
- •Edit Undo
- •Edit Redo
- •Edit Cut
- •Edit Copy
- •Edit Paste
- •Edit Find
- •Edit Find Next
- •Edit Replace
- •Edit Goto
- •Edit Toggle Bookmark
- •Edit Goto Bookmark
- •Edit Indent Block
- •Edit Unindent Block
- •Edit Remark Block
- •Program Compile
- •Program Syntax Check
- •Program Show Result
- •Program Simulate
- •Program Send to Chip
- •Tools Terminal Emulator
- •Tools LCD Designer
- •Tools LIB Manager
- •Tools Graphic Converter
- •Tools Stack Analyzer
- •Tools Plugin Manager
- •Tools Batch Compile
- •Options Compiler
- •Options Compiler Chip
- •Options Compiler Output
- •Options Compiler Communication
- •Options Compiler I2C, SPI, 1WIRE
- •Options Compiler LCD
- •Options Communication
- •Options Environment
- •Options Simulator
- •Options Programmer
- •Supported Programmers
- •ISP programmer
- •PG302 programmer
- •Sample Electronics cable programmer
- •KITSRUS Programmer
- •MCS Universal Interface Programmer
- •STK500 Programmer
- •Lawicel BootLoader
- •AVR ISP Programmer
- •USB-ISP Programmer
- •MCS Bootloader
- •Options Monitor
- •Options Printer
- •Window Cascade
- •Window Tile
- •Window Arrange Icons
- •Window Minimize All
- •Help About
- •Help Index
- •Help MCS Forum
- •Help MCS Shop
- •Help Support
- •Help Knowledge Base
- •Help Credits
- •BASCOM Editor Keys
- •Program Development Order
- •PlugIns
- •Font Editor
- •PinOut
- •BASCOM HARDWARE
- •Additional Hardware
- •AVR Internal Hardware
- •AVR Internal Registers
- •AVR Internal Hardware TIMER0
- •AVR Internal Hardware TIMER1
- •AVR Internal Hardware Watchdog timer
- •AVR Internal Hardware Port B
- •AVR Internal Hardware Port D
- •Adding XRAM
- •Attaching an LCD Display
- •Memory usage
- •Using the 1 WIRE protocol
- •Using the SPI protocol
- •Power Up
- •Chips
- •ATtiny22
- •ATtiny13
- •ATtiny15
- •ATtiny25
- •ATtiny45
- •ATtiny85
- •ATtiny26
- •ATtiny2313
- •ATMEGA8
- •ATMEGA16
- •ATMEGA32
- •ATMEGA48
- •ATMEGA88
- •ATMEGA168
- •ATMEGA64
- •ATMEGA103
- •ATMEGA128
- •ATMEGA161
- •ATMEGA162
- •ATMEGA163
- •ATMEGA165
- •ATMEGA169
- •ATMEGA323
- •ATMEGA603
- •ATMEGA8515
- •ATMEGA8535
- •BASCOM Language Fundamentals
- •Changes compared to BASCOM-8051
- •Language Fundamentals
- •Mixing ASM and BASIC
- •Assembler mnemonics
- •Reserved Words
- •Error Codes
- •Newbie problems
- •Tips and tricks
- •ASCII chart
- •BASCOM Language Reference
- •$BAUD
- •$BAUD1
- •$BOOT
- •$CRYSTAL
- •$DATA
- •$DEFAULT
- •$EEPLEAVE
- •$EEPROM
- •$EEPROMHEX
- •$EXTERNAL
- •$FRAMESIZE
- •$HWSTACK
- •$INCLUDE
- •$INITMICRO
- •$LCDPUTCTRL
- •$LCDPUTDATA
- •$LCDRS
- •$LCDVFO
- •$LOADER
- •$LOADERSIZE
- •$NOCOMP
- •$NOINIT
- •$NORAMCLEAR
- •$PROG
- •$PROGRAMMER
- •$REGFILE
- •$ROMSTART
- •$SERIALINPUT
- •$SERIALINPUT1
- •$SERIALINPUT2LCD
- •$SERIALOUTPUT
- •$SERIALOUTPUT1
- •$SWSTACK
- •$TIMEOUT
- •$TINY
- •$WAITSTATE
- •$XRAMSIZE
- •$XRAMSTART
- •1WIRECOUNT
- •1WRESET
- •1WREAD
- •1WSEARCHFIRST
- •1WSEARCHNEXT
- •1WVERIFY
- •1WWRITE
- •ACOS
- •ALIAS
- •ASIN
- •BASE64DEC
- •BASE64ENC
- •BAUD
- •BAUD1
- •BINVAL
- •BIN2GRAY
- •BITWAIT
- •BITS
- •BLOAD
- •BSAVE
- •BUFSPACE
- •BYVAL
- •CALL
- •CHECKSUM
- •CIRCLE
- •CLEAR
- •CLOCKDIVISION
- •CLOSE
- •CLOSESOCKET
- •CONFIG
- •CONFIG 1WIRE
- •CONFIG ACI
- •CONFIG ADC
- •CONFIG ATEMU
- •CONFIG BCCARD
- •CONFIG CLOCK
- •CONFIG CLOCKDIV
- •CONFIG COM1
- •CONFIG COM2
- •CONFIG COMx
- •CONFIG DATE
- •CONFIG DCF77
- •CONFIG DEBOUNCE
- •CONFIG I2CDELAY
- •CONFIG I2CSLAVE
- •CONFIG INPUT
- •CONFIG INTx
- •CONFIG GRAPHLCD
- •CONFIG KBD
- •CONFIG KEYBOARD
- •CONFIG LCD
- •CONFIG LCDBUS
- •CONFIG LCDMODE
- •CONFIG LCDPIN
- •CONFIG PORT
- •CONFIG PRINT
- •CONFIG PRINTBIN
- •CONFIG PS2EMU
- •CONFIG RC5
- •CONFIG SDA
- •CONFIG SCL
- •CONFIG SERIALIN
- •CONFIG SERIALIN1
- •CONFIG SERIALOUT
- •CONFIG SERIALOUT1
- •CONFIG SINGLE
- •CONFIG SPI
- •CONFIG SERVOS
- •CONFIG TCPIP
- •CONFIG TIMER0
- •CONFIG TIMER1
- •CONFIG TIMER2
- •CONFIG TWI
- •CONFIG TWISLAVE
- •CONFIG WAITSUART
- •CONFIG WATCHDOG
- •CONFIG X10
- •CONFIG XRAM
- •CONST
- •COSH
- •COUNTER0 and COUNTER1
- •CPEEK
- •CPEEKH
- •CRYSTAL
- •CURSOR
- •DATA
- •DAYOFWEEK
- •DAYOFYEAR
- •DATE$
- •DATE
- •DEBUG
- •DEBOUNCE
- •DECR
- •DECLARE FUNCTION
- •DECLARE SUB
- •DEFxxx
- •DEFLCDCHAR
- •DELAY
- •DISABLE
- •DISKFREE
- •DISKSIZE
- •DISPLAY
- •DO-LOOP
- •DriveCheck
- •DriveGetIdentity
- •DriveInit
- •DriveReset
- •DriveReadSector
- •DriveWriteSector
- •DTMFOUT
- •ECHO
- •ELSE
- •ENABLE
- •ENCODER
- •EXIT
- •FILEATTR
- •FILEDATE
- •FILEDATETIME
- •FILELEN
- •FILETIME
- •FLUSH
- •FORMAT
- •FOR-NEXT
- •FOURTHLINE
- •FRAC
- •FREEFILE
- •FUSING
- •GETADC
- •GETATKBD
- •GETATKBDRAW
- •GETDSTIP
- •GETDSTPORT
- •GETKBD
- •GETRC
- •GETRC5
- •GETTCPREGS
- •GETSOCKET
- •GLCDCMD
- •GLCDDATA
- •GOSUB
- •GOTO
- •GRAY2BIN
- •HEXVAL
- •HIGH
- •HIGHW
- •HOME
- •I2CINIT
- •I2CRECEIVE
- •I2CSEND
- •I2START,I2CSTOP, I2CRBYTE, I2CWBYTE
- •IDLE
- •IF-THEN-ELSE-END IF
- •INCR
- •INITFILESYSTEM
- •INITLCD
- •INKEY
- •INPUTBIN
- •INPUTHEX
- •INPUT
- •INSTR
- •ISCHARWAITING
- •KILL
- •LCASE
- •LCDAT
- •LCDCONTRAST
- •LEFT
- •LINE
- •LINE INPUT
- •LTRIM
- •LOAD
- •LOADADR
- •LOADLABEL
- •LOADWORDADR
- •LOCAL
- •LOCATE
- •LOOKDOWN
- •LOOKUP
- •LOOKUPSTR
- •LOWERLINE
- •MAKEBCD
- •MAKEINT
- •MAKEDEC
- •MAKETCP
- •MEMCOPY
- •NBITS
- •ON INTERRUPT
- •ON VALUE
- •OPEN
- •PEEK
- •POKE
- •POPALL
- •POWER
- •POWERDOWN
- •POWERSAVE
- •PRINTBIN
- •PSET
- •PS2MOUSEXY
- •PULSEIN
- •PULSEOUT
- •PUSHALL
- •RC5SEND
- •RC5SENDEXT
- •RC6SEND
- •READ
- •READEEPROM
- •READMAGCARD
- •RESET
- •RESTORE
- •RETURN
- •RIGHT
- •ROTATE
- •ROUND
- •RTRIM
- •SECELAPSED
- •SECOFDAY
- •SEEK
- •SELECT-CASE-END SELECT
- •SETFONT
- •SETTCP
- •SETTCPREGS
- •SENDSCAN
- •SENDSCANKBD
- •SERIN
- •SEROUT
- •SETIPPROTOCOL
- •SHIFT
- •SHIFTCURSOR
- •SHIFTIN
- •SHIFTOUT
- •SHIFTLCD
- •SHOWPIC
- •SHOWPICE
- •SINH
- •SOCKETCONNECT
- •SOCKETLISTEN
- •SOCKETSTAT
- •SONYSEND
- •SOUND
- •SPACE
- •SPIIN
- •SPIINIT
- •SPIMOVE
- •SPIOUT
- •SPLIT
- •START
- •STCHECK
- •STOP
- •STRING
- •SYSSEC
- •SYSSECELAPSED
- •SYSDAY
- •SWAP
- •TCPCHECKSUM
- •TCPREAD
- •TCPWRITE
- •TCPWRITESTR
- •TANH
- •THIRDLINE
- •TIME$
- •TIME
- •TOGGLE
- •TRIM
- •UCASE
- •UDPREAD
- •UDPWRITE
- •UDPWRITESTR
- •UPPERLINE
- •VARPTR
- •VERSION
- •WAIT
- •WAITKEY
- •WAITMS
- •WAITUS
- •WHILE-WEND
- •WRITE
- •WRITEEEPROM
- •X10DETECT
- •X10SEND
- •#IF ELSE ENDIF
- •International Resellers
- •International Resellers
- •ASM Libraries
- •EXTENDED I2C
- •MCSBYTE
- •MCSBYTEINT
- •TCPIP
- •LCD4BUSY
- •GLCD
- •GLCDSED
- •LCD-EPSON
- •AVR-DOS File System
- •CF Card
- •Compact FlashCard Driver
- •Elektor CF-Interface
- •XRAM CF-Interface for simulation
- •New CF-Card Drivers
- •Floating Point
- •FP_TRIG
- •DOUBLE
- •I2C SLAVE
- •I2CSLAVE
- •I2C TWI Slave
- •SPISLAVE
- •DATE TIME
- •EUROTIMEDATE
- •DATETIME
- •PS2-AT Mouse and Keyboard Emulation
- •AT_EMULATOR
- •PS2MOUSE_EMULATOR
- •BCCARD
- •BCCARD
- •BCDEF
- •BCCALL
- •BCRESET
- •Tools
- •LCD RGB-8 Converter
© 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
1WRESET
Action
This statement brings the 1wire pin to the correct state, and sends a reset to the bus.
Syntax
1WRESET
1WRESET , PORT , PIN
page -256-
|
© MCS Electronics, 1995-2007 |
|
Remarks |
||
1WRESET |
Reset the 1WIRE bus. The error variable ERR will return 1 if an error |
|
|
occurred |
|
Port |
The register name of the input port. Like PINB, PIND. |
|
Pin |
The pin number to use. In the range from 0-7. May be a numeric constant |
|
|
or variable. |
|
|
|
|
The global variable ERR is set when an error occurs.
There is also support for multi 1-wire devices on different pins.
To use this you must specify the port and pin that is 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) , for the configured 1 wire pin
var = 1WREAD(bytes, port, pin) ,for reading multiple bytes
See also
1WREAD , 1WWRITE
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 |
|
page -257- |
© MCS Electronics, 1995-2007 |
|
'On the STK200 jumper B.0 must be inserted |
|
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 -258-
© MCS Electronics, 1995-2007
1WREAD
Action
This statement reads data from the 1wire bus into a variable.
Syntax
var2 = 1WREAD( [ bytes] )
var2 = 1WREAD( bytes , port , pin)
Remarks
var2 |
Reads a byte from the bus and places it into variable var2. |
|
Optional the number of bytes to read can be specified. |
Port |
The PIN port name like PINB or PIND. |
Pin |
The pin number of the port. In the range from 0-7. Maybe a numeric |
|
constant or variable. |
|
|
Multi 1-wire devices on different pins are supported.
To use this you must specify the port pin that is 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
1WWRITE , 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
page -259-
|
© MCS Electronics, 1995-2007 |
$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 |
|
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
page -260-