]> git.sur5r.net Git - cc65/blob - asminc/ser-kernel.inc
Moved the 'graph' files from 'geos-cbm' to 'geos-common' which are believed to work...
[cc65] / asminc / ser-kernel.inc
1 ;****************************************************************************
2 ;*                                                                          *
3 ;*                              ser-kernel.inc                              *
4 ;*                                                                          *
5 ;*                        Serial communication API                          *
6 ;*                                                                          *
7 ;*                                                                          *
8 ;*                                                                          *
9 ;*(C) 2003-2006, Ullrich von Bassewitz                                      *
10 ;*               Römerstrasse 52                                            *
11 ;*               D-70794 Filderstadt                                        *
12 ;*EMail:         uz@cc65.org                                                *
13 ;*                                                                          *
14 ;*                                                                          *
15 ;*This software is provided 'as-is', without any expressed or implied       *
16 ;*warranty.  In no event will the authors be held liable for any damages    *
17 ;*arising from the use of this software.                                    *
18 ;*                                                                          *
19 ;*Permission is granted to anyone to use this software for any purpose,     *
20 ;*including commercial applications, and to alter it and redistribute it    *
21 ;*freely, subject to the following restrictions:                            *
22 ;*                                                                          *
23 ;*1. The origin of this software must not be misrepresented; you must not   *
24 ;*   claim that you wrote the original software. If you use this software   *
25 ;*   in a product, an acknowledgment in the product documentation would be  *
26 ;*   appreciated but is not required.                                       *
27 ;*2. Altered source versions must be plainly marked as such, and must not   *
28 ;*   be misrepresented as being the original software.                      *
29 ;*3. This notice may not be removed or altered from any source              *
30 ;*   distribution.                                                          *
31 ;*                                                                          *
32 ;****************************************************************************
33
34
35
36 ;------------------------------------------------------------------------------
37 ; The driver header
38
39 .struct SER_HDR
40         ID      .byte   3       ; Contains 0x73, 0x65, 0x72 ("ser")
41         VERSION .byte   1       ; Interface version
42         JUMPTAB .struct
43             INSTALL     .word   ; INSTALL routine
44             UNINSTALL   .word   ; UNINSTALL routine
45             OPEN        .word   ; OPEN routine
46             CLOSE       .word   ; CLOSE routine
47             GET         .word   ; GET routine
48             PUT         .word   ; PUT routine
49             STATUS      .word   ; STATUS routine
50             IOCTL       .word   ; IOCTL routine
51             IRQ         .word   ; IRQ routine
52         .endstruct
53 .endstruct
54
55
56 ;------------------------------------------------------------------------------
57 ; The SER API version, stored SER_HDR::VERSION
58
59 SER_API_VERSION         = $00
60
61 ;------------------------------------------------------------------------------
62 ; ser_params
63
64 .struct SER_PARAMS
65         BAUDRATE        .byte           ; Baudrate
66         DATABITS        .byte           ; Number of data bits
67         STOPBITS        .byte           ; Number of stop bits
68         PARITY          .byte           ; Parity setting
69         HANDSHAKE       .byte           ; Type of handshake to use
70 .endstruct
71
72 ;------------------------------------------------------------------------------
73 ; Serial parameters
74
75 ; Baudrate
76 SER_BAUD_45_5           =       $00
77 SER_BAUD_50             =       $01
78 SER_BAUD_75             =       $02
79 SER_BAUD_110            =       $03
80 SER_BAUD_134_5          =       $04
81 SER_BAUD_150            =       $05
82 SER_BAUD_300            =       $06
83 SER_BAUD_600            =       $07
84 SER_BAUD_1200           =       $08
85 SER_BAUD_1800           =       $09
86 SER_BAUD_2400           =       $0A
87 SER_BAUD_3600           =       $0B
88 SER_BAUD_4800           =       $0C
89 SER_BAUD_7200           =       $0D
90 SER_BAUD_9600           =       $0E
91 SER_BAUD_19200          =       $0F
92 SER_BAUD_38400          =       $10
93 SER_BAUD_57600          =       $11
94 SER_BAUD_115200         =       $12
95 SER_BAUD_230400         =       $13
96 SER_BAUD_31250          =       $14
97 SER_BAUD_62500          =       $15
98
99 ; Data bit settings
100 SER_BITS_5              =       $00
101 SER_BITS_6              =       $01
102 SER_BITS_7              =       $02
103 SER_BITS_8              =       $03
104
105 ; Stop bit settings
106 SER_STOP_1              =       $00
107 SER_STOP_2              =       $01
108
109 ; Parity
110 SER_PAR_NONE            =       $00
111 SER_PAR_ODD             =       $01
112 SER_PAR_EVEN            =       $02
113 SER_PAR_MARK            =       $03
114 SER_PAR_SPACE           =       $04
115
116 ; Handshake
117 SER_HS_NONE             =       $00    ; No handshake
118 SER_HS_HW               =       $01    ; Hardware (RTS/CTS) handshake
119 SER_HS_SW               =       $02    ; Software handshake
120
121 ; Bit masks to mask out things from the status returned by rs232_status
122 SER_STATUS_PE           =       $01     ; Parity error
123 SER_STATUS_FE           =       $02     ; Framing error
124 SER_STATUS_OE           =       $04     ; Overrun error
125 SER_STATUS_DCD          =       $20     ; NOT data carrier detect
126 SER_STATUS_DSR          =       $40     ; NOT data set ready
127
128 ;------------------------------------------------------------------------------
129 ; Variables
130
131         .global _ser_drv                         ; Pointer to driver
132
133 ;------------------------------------------------------------------------------
134 ; Driver entry points
135
136         .global ser_install
137         .global ser_uninstall
138         .global ser_open
139         .global ser_close
140         .global ser_get
141         .global ser_put
142         .global ser_status
143         .global ser_ioctl
144         .global ser_irq
145
146 ;------------------------------------------------------------------------------
147 ; C callable functions
148
149         .global _ser_load_driver
150         .global _ser_unload
151         .global _ser_install
152         .global _ser_uninstall
153         .global _ser_open
154         .global _ser_close
155         .global _ser_get
156         .global _ser_put
157         .global _ser_status
158         .global _ser_ioctl
159
160         .global _ser_clear_ptr
161