- •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
'note that for UDP we specify sock_dgram
Idx = Getsocket(idx , Sock_dgram , 5000 , 0) ' get socket for UDP mode, specify port 5000
Print "Socket " ; Idx ; " " ; Idx
'UDP is a connection less protocol which means that you can not listen, connect or can get the status
'You can just use send and receive the same way as for TCP/IP. 'But since there is no connection protocol, you need to specify the destination IP address and port
'So compare to TCP/IP you send exactly the same, but with the addition of the IP and PORT
Do
Temp = Inkey() |
' wait for |
|
terminal input |
' ESC pressed |
|
If Temp = 27 Then |
|
|
Sstr = "Hello" |
|
|
Result = Udpwritestr(192.168.0.3 , 5000 , Idx , Sstr , 255) |
|
|
End If |
' get number of |
|
Result = Socketstat(idx , Sel_recv) |
||
bytes waiting |
|
|
If Result > 0 Then |
|
|
Print "Bytes waiting : " ; Result |
'the first 8 bytes |
|
Temp2 = Result - 8 |
||
are always the UDP header which consist of the length, IP number and port |
|
|
address |
' read the result |
|
Temp = Udpread(idx , S(1) , Result) |
||
For Temp = 1 To Temp2 |
' print result |
|
Print S(temp) ; " " ; |
|
|
Next |
|
|
' these are |
|
|
Print Peersize ; " " ; Peeraddress ; " " ; Peerport |
|
|
assigned when you use UDPREAD |
' print IP in |
|
Print Ipnum(peeraddress) |
|
|
usual format |
|
' |
Result = Udpwrite(192.168.0.3 , Peerport , Idx , S(1) , Temp2) |
||
write the received data back |
|
|
End If |
|
|
Loop |
|
|
'the sample above waits for data and send the data back for that reason temp2 is subtracted with 8, the header size
'this function can be used to display an IP number in normal format
Function Ipnum(ip As Long) As String
Local T As Byte , J As Byte
Ipnum = ""
For J = 1 To 4 T = Ip And 255
Ipnum = Ipnum + Str(t)
If J < 4 Then Ipnum = Ipnum + "."
Shift Ip , Right , 8
Next
End Function End
UDPWRITE
Action
Write UDP data to a socket.
page -704-
© MCS Electronics, 1995-2007
Syntax
Result = UDPwrite( IP, port, socket , var , bytes)
Result = UDPwrite( IP, port, socket , EPROM, address , bytes)
Remarks
Result |
A word variable that will be assigned with the number of bytes actually |
|
written to the socket. |
|
When the free transmission buffer is large enough to accept all the data, the |
|
result will be the same as BYTES. When there is not enough space, the |
|
number of written bytes will be returned. |
|
When there is no space, 0 will be returned. |
IP |
The IP number you want to send data to. |
|
Use the format 192.168.0.5 or use a LONG variable that contains the IP |
|
number. |
Port |
The port number you want to send data too. |
Socket |
The socket number you want to send data to(0-3). |
Var |
A constant string like "test" or a variable. |
|
When you send a constant string, the number of bytes to send does not need |
|
to be specified. |
Bytes |
A word variable or numeric constant that specifies how many bytes must be |
|
send. |
Address |
The address of the data stored in the chips internal EEPROM. You need to |
|
specify EPROM too in that case. |
EPROM |
An indication for the compiler so it knows that you will send data from |
|
EPROM. |
|
|
The UDPwrite function can be used to write data to a socket that is stored in EEPROM or in memory.
When you want to send data from an array, you need to specify the element : var(idx) for example.
Note that UDPwrite is almost the same as TCPwrite. Since UDP is a connection-less protocol, you need to specify the IP address and the port number.
UDP only requires an opened socket. The is no connect or close needed.
See also
CONFIG TCPIP, GETSOCKET , SOCKETCONNECT, SOCKETSTAT , TCPWRITESTR, TCPREAD, CLOSESOCKET , SOCKETLISTEN , UDPWRITESTR , UDPREAD
Example
See UDPwriteStr
page -705-
© MCS Electronics, 1995-2007
UDPWRITESTR
Action
Sends a string via UDP.
Syntax
Result = UDPwriteStr( IP, port, socket , var , param)
Remarks
Result |
A word variable that will be assigned with the number of bytes actually |
|
written to the socket. |
|
When the free transmission buffer is large enough to accept all the data, |
|
the result will be the same as BYTES. When there is not enough space, the |
|
number of written bytes will be returned. |
|
When there is no space, 0 will be returned. |
IP |
The IP number you want to send data to. |
|
Use the format 192.168.0.5 or use a LONG variable that contains the IP |
|
number. |
Port |
The port number you want to send data too. |
Socket |
The socket number you want to send data to (0-3). |
Var |
The name of a string variable. |
Param |
A parameter that might be 0 to send only the string or 255, to send the |
|
string with an additional CR + LF |
|
This option was added because many protocols expect CR + LF after the |
|
string. |
|
|
The UDPwriteStr function is a special variant of the UDPwrite function. It will use UDPWrite to send the data.
See also
CONFIG TCPIP, GETSOCKET , SOCKETCONNECT, SOCKETSTAT , TCPWRITE, TCPREAD, CLOSESOCKET , SOCKETLISTEN , UDPWRITE, UDPREAD
Example
'----------------------------------------------------------------------------- |
|
------------ |
: udptest.bas |
'name |
|
'copyright |
: (c) 1995-2005, MCS Electronics |
'purpose |
: start the easytcp.exe program after the chip is |
programmed and |
press UDP button |
' |
|
'micro |
: Mega161 |
'suited for demo |
: no |
'commercial addon needed |
: yes |
'----------------------------------------------------------------------------- |
|
------------ |
|
page -706-
© MCS Electronics, 1995-2007
$regfile = "m161def.dat" micro
$crystal = 4000000 frequency
$baud = 19200 $hwstack = 32
for the hardware stack $swstack = 10
for the SW stack $framesize = 40
for the frame space
Const Sock_stream = $01
Const Sock_dgram = $02
Const Sock_ipl_raw = $03
Sock
Const Sock_macl_raw = $04
Sock
Const Sel_control = 0
Status
Const Sel_send = 1
Buffer Size
Const Sel_recv = 2
Size
'socket status
Const Sock_closed = $00 Connection Closed Const Sock_arp = $01 Const Sock_listen = $02
Waiting For Tcp Connection Setup Const Sock_synsent = $03
Setting Up Tcp Connection Const Sock_synsent_ack = $04 Setting Up Tcp Connection Const Sock_synrecv = $05 Setting Up Tcp Connection Const Sock_established = $06 Connection Established Const Sock_close_wait = $07 Closing Tcp Connection Const Sock_last_ack = $08 Closing Tcp Connection Const Sock_fin_wait1 = $09 Closing Tcp Connection Const Sock_fin_wait2 = $0a Closing Tcp Connection Const Sock_closing = $0b Closing Tcp Connection Const Sock_time_wait = $0c Closing Tcp Connection Const Sock_reset = $0d Closing Tcp Connection Const Sock_init = $0e Initialization
Const Sock_udp = $0f
Const Sock_raw = $10
$lib "tcpip.lbx" tcpip library
Print "Init , set IP to 192.168.0.8" message
Enable Interrupts
'specify the used
'used crystal
'use baud rate
'default use 32
'default use 10
'default use 40
'Tcp
'Udp
'Ip Layer Raw
'Mac Layer Raw
'Confirm Socket
'Confirm Tx Free
'Confirm Rx Data
'Status Of
'Status Of Arp
'Status Of
'Status Of
'Status Of
'Status Of
'Status Of Tcp
'Status Of
'Status Of
'Status Of
'Status Of
'Status Of
'Status Of
'Status Of
'Status Of Socket
'Status Of Udp
'Status of IP RAW
'specify the
'display a
'before we use
page -707-
© MCS Electronics, 1995-2007
config tcpip , we need to enable the interrupts
Config Tcpip = Int0 , Mac = 12.128.12.34.56.78 , Ip = 192.168.0.8 , Submask = 255.255.255.0 , Gateway = 0.0.0.0 , Localport = 1000 , Tx = $55 , Rx = $55
'Use the line below if you have a gate way
'Config Tcpip = Int0 , Mac = 12.128.12.34.56.78 , Ip = 192.168.0.8 , Submask = 255.255.255.0 , Gateway = 192.168.0.1 , Localport = 1000 , Tx = $55 , Rx = $55
Dim Idx As Byte |
' socket number |
Dim Result As Word |
' result |
Dim S(80) As Byte |
|
Dim Sstr As String * 20 |
' temp bytes |
Dim Temp As Byte , Temp2 As Byte |
|
'----------------------------------------------------------------------------- |
|
---------------
'When you use UDP, you need to dimension the following variables in exactly the same order !
Dim Peersize As Integer , Peeraddress As Long , Peerport As Word '-----------------------------------------------------------------------------
--------------- |
' a handy function |
Declare Function Ipnum(ip As Long) As String |
|
'like with TCP, we need to get a socket first |
|
'note that for UDP we specify sock_dgram |
' get socket for |
Idx = Getsocket(idx , Sock_dgram , 5000 , 0) |
|
UDP mode, specify port 5000 |
|
Print "Socket " ; Idx ; " " ; Idx |
|
'UDP is a connection less protocol which means that you can not listen, connect or can get the status
'You can just use send and receive the same way as for TCP/IP. 'But since there is no connection protocol, you need to specify the destination IP address and port
'So compare to TCP/IP you send exactly the same, but with the addition of the IP and PORT
Do
Temp = Inkey() |
' wait for |
|
terminal input |
' ESC pressed |
|
If Temp = 27 Then |
|
|
Sstr = "Hello" |
|
|
Result = Udpwritestr(192.168.0.3 , 5000 , Idx , Sstr , 255) |
|
|
End If |
' get number of |
|
Result = Socketstat(idx , Sel_recv) |
||
bytes waiting |
|
|
If Result > 0 Then |
|
|
Print "Bytes waiting : " ; Result |
'the first 8 bytes |
|
Temp2 = Result - 8 |
||
are always the UDP header which consist of the length, IP number and port |
|
|
address |
' read the result |
|
Temp = Udpread(idx , S(1) , Result) |
||
For Temp = 1 To Temp2 |
' print result |
|
Print S(temp) ; " " ; |
|
|
Next |
|
|
' these are |
|
|
Print Peersize ; " " ; Peeraddress ; " " ; Peerport |
|
|
assigned when you use UDPREAD |
' print IP in |
|
Print Ipnum(peeraddress) |
|
|
usual format |
|
' |
Result = Udpwrite(192.168.0.3 , Peerport , Idx , S(1) , Temp2) |
||
write the received data back |
|
|
End If |
|
|
Loop |
|
|
'the sample above waits for data and send the data back for that reason temp2 is subtracted with 8, the header size
page -708-