mirror of
https://github.com/cc65/cc65.git
synced 2024-12-23 04:30:10 +00:00
163 lines
6.5 KiB
PHP
163 lines
6.5 KiB
PHP
;****************************************************************************
|
|
;* *
|
|
;* ser-kernel.inc *
|
|
;* *
|
|
;* Serial communication API *
|
|
;* *
|
|
;* *
|
|
;* *
|
|
;*(C) 2003-2006, Ullrich von Bassewitz *
|
|
;* Römerstrasse 52 *
|
|
;* D-70794 Filderstadt *
|
|
;*EMail: uz@cc65.org *
|
|
;* *
|
|
;* *
|
|
;*This software is provided 'as-is', without any expressed or implied *
|
|
;*warranty. In no event will the authors be held liable for any damages *
|
|
;*arising from the use of this software. *
|
|
;* *
|
|
;*Permission is granted to anyone to use this software for any purpose, *
|
|
;*including commercial applications, and to alter it and redistribute it *
|
|
;*freely, subject to the following restrictions: *
|
|
;* *
|
|
;*1. The origin of this software must not be misrepresented; you must not *
|
|
;* claim that you wrote the original software. If you use this software *
|
|
;* in a product, an acknowledgment in the product documentation would be *
|
|
;* appreciated but is not required. *
|
|
;*2. Altered source versions must be plainly marked as such, and must not *
|
|
;* be misrepresented as being the original software. *
|
|
;*3. This notice may not be removed or altered from any source *
|
|
;* distribution. *
|
|
;* *
|
|
;****************************************************************************
|
|
|
|
|
|
|
|
;------------------------------------------------------------------------------
|
|
; The driver header
|
|
|
|
.struct SER_HDR
|
|
ID .byte 3 ; Contains 0x73, 0x65, 0x72 ("ser")
|
|
VERSION .byte 1 ; Interface version
|
|
LIBREF .addr ; Library reference
|
|
JUMPTAB .struct
|
|
INSTALL .addr ; INSTALL routine
|
|
UNINSTALL .addr ; UNINSTALL routine
|
|
OPEN .addr ; OPEN routine
|
|
CLOSE .addr ; CLOSE routine
|
|
GET .addr ; GET routine
|
|
PUT .addr ; PUT routine
|
|
STATUS .addr ; STATUS routine
|
|
IOCTL .addr ; IOCTL routine
|
|
IRQ .addr ; IRQ routine
|
|
.endstruct
|
|
.endstruct
|
|
|
|
|
|
;------------------------------------------------------------------------------
|
|
; The SER API version, stored SER_HDR::VERSION
|
|
|
|
SER_API_VERSION = $01
|
|
|
|
;------------------------------------------------------------------------------
|
|
; ser_params
|
|
|
|
.struct SER_PARAMS
|
|
BAUDRATE .byte ; Baudrate
|
|
DATABITS .byte ; Number of data bits
|
|
STOPBITS .byte ; Number of stop bits
|
|
PARITY .byte ; Parity setting
|
|
HANDSHAKE .byte ; Type of handshake to use
|
|
.endstruct
|
|
|
|
;------------------------------------------------------------------------------
|
|
; Serial parameters
|
|
|
|
; Baudrate
|
|
SER_BAUD_45_5 = $00
|
|
SER_BAUD_50 = $01
|
|
SER_BAUD_75 = $02
|
|
SER_BAUD_110 = $03
|
|
SER_BAUD_134_5 = $04
|
|
SER_BAUD_150 = $05
|
|
SER_BAUD_300 = $06
|
|
SER_BAUD_600 = $07
|
|
SER_BAUD_1200 = $08
|
|
SER_BAUD_1800 = $09
|
|
SER_BAUD_2400 = $0A
|
|
SER_BAUD_3600 = $0B
|
|
SER_BAUD_4800 = $0C
|
|
SER_BAUD_7200 = $0D
|
|
SER_BAUD_9600 = $0E
|
|
SER_BAUD_19200 = $0F
|
|
SER_BAUD_38400 = $10
|
|
SER_BAUD_57600 = $11
|
|
SER_BAUD_115200 = $12
|
|
SER_BAUD_230400 = $13
|
|
SER_BAUD_31250 = $14
|
|
SER_BAUD_62500 = $15
|
|
|
|
; Data bit settings
|
|
SER_BITS_5 = $00
|
|
SER_BITS_6 = $01
|
|
SER_BITS_7 = $02
|
|
SER_BITS_8 = $03
|
|
|
|
; Stop bit settings
|
|
SER_STOP_1 = $00
|
|
SER_STOP_2 = $01
|
|
|
|
; Parity
|
|
SER_PAR_NONE = $00
|
|
SER_PAR_ODD = $01
|
|
SER_PAR_EVEN = $02
|
|
SER_PAR_MARK = $03
|
|
SER_PAR_SPACE = $04
|
|
|
|
; Handshake
|
|
SER_HS_NONE = $00 ; No handshake
|
|
SER_HS_HW = $01 ; Hardware (RTS/CTS) handshake
|
|
SER_HS_SW = $02 ; Software handshake
|
|
|
|
; Bit masks to mask out things from the status returned by ser_status
|
|
SER_STATUS_PE = $01 ; Parity error
|
|
SER_STATUS_FE = $02 ; Framing error
|
|
SER_STATUS_OE = $04 ; Overrun error
|
|
SER_STATUS_DCD = $20 ; NOT data carrier detect
|
|
SER_STATUS_DSR = $40 ; NOT data set ready
|
|
|
|
;------------------------------------------------------------------------------
|
|
; Variables
|
|
|
|
.global _ser_drv ; Pointer to driver
|
|
|
|
;------------------------------------------------------------------------------
|
|
; Driver entry points
|
|
|
|
.global ser_install
|
|
.global ser_uninstall
|
|
.global ser_open
|
|
.global ser_close
|
|
.global ser_get
|
|
.global ser_put
|
|
.global ser_status
|
|
.global ser_ioctl
|
|
.global ser_irq
|
|
|
|
;------------------------------------------------------------------------------
|
|
; C callable functions
|
|
|
|
.global _ser_load_driver
|
|
.global _ser_unload
|
|
.global _ser_install
|
|
.global _ser_uninstall
|
|
.global _ser_open
|
|
.global _ser_close
|
|
.global _ser_get
|
|
.global _ser_put
|
|
.global _ser_status
|
|
.global _ser_ioctl
|
|
|
|
.global _ser_clear_ptr
|
|
|