xref: /freebsd/sys/dev/ic/cd180.h (revision 95ee2897e98f5d444f26ed2334cc7c439f9c16c6)
1 /*-
2  * SPDX-License-Identifier: BSD-2-Clause
3  *
4  * Copyright (C) 1995 by Pavel Antonov, Moscow, Russia.
5  * Copyright (C) 1995 by Andrey A. Chernov, Moscow, Russia.
6  * All rights reserved.
7  *
8  * Redistribution and use in source and binary forms, with or without
9  * modification, are permitted provided that the following conditions
10  * are met:
11  * 1. Redistributions of source code must retain the above copyright
12  *    notice, this list of conditions and the following disclaimer.
13  * 2. Redistributions in binary form must reproduce the above copyright
14  *    notice, this list of conditions and the following disclaimer in the
15  *    documentation and/or other materials provided with the distribution.
16  *
17  * THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND
18  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
19  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
20  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
21  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
22  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
23  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
24  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
25  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
26  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
27  * SUCH DAMAGE.
28  */
29 
30 /*
31  * Cirrus Logic CD180 registers
32  */
33 
34 /* Global registers */
35 #define CD180_GIVR      0x40    /* Global Interrupt Verctor Register      */
36 #define CD180_GICR      0x41    /* Global Interrupting Channel Register   */
37 #define CD180_PILR1     0x61    /* Priority Interrupt Level Register 1    */
38 #define CD180_PILR2     0x62    /* Priority Interrupt Level Register 2    */
39 #define CD180_PILR3     0x63    /* Priority Interrupt Level Register 3    */
40 #define CD180_CAR       0x64    /* Channel Access Register                */
41 #define CD180_GFRCR     0x6B    /* Global Firmware Revision Code Register */
42 #define CD180_PPRH      0x70    /* Prescaler Period Register MSB          */
43 #define CD180_PPRL      0x71    /* Prescaler Period Register LSB          */
44 #define CD180_RDR       0x78    /* Receiver Data Register                 */
45 #define CD180_RCSR      0x7A    /* Receiver Character Status Register     */
46 #define CD180_TDR       0x7B    /* Transmit Data Register                 */
47 #define CD180_EOIR      0x7F    /* End of Interrupt Register              */
48 
49 /* Channel Registers */
50 #define CD180_CCR       0x01    /* Channel Command Register               */
51 #define CD180_IER       0x02    /* Interrupt Enable Register              */
52 #define CD180_COR1      0x03    /* Channel Option Register 1              */
53 #define CD180_COR2      0x04    /* Channel Option Register 1              */
54 #define CD180_COR3      0x05    /* Channel Option Register 1              */
55 #define CD180_CCSR      0x06    /* Channel Control STatus Register        */
56 #define CD180_RDCR      0x07    /* Receive Data Count Register            */
57 #define CD180_SCHR1     0x09    /* Special Character Register 1           */
58 #define CD180_SCHR2     0x0A    /* Special Character Register 2           */
59 #define CD180_SCHR3     0x0B    /* Special Character Register 3           */
60 #define CD180_SCHR4     0x0C    /* Special Character Register 4           */
61 #define CD180_MCOR1     0x10    /* Modem Change Option 1 Register         */
62 #define CD180_MCOR2     0x11    /* Modem Change Option 2 Register         */
63 #define CD180_MCR       0x12    /* Modem Change Register                  */
64 #define CD180_RTPR      0x18    /* Receive Timeout Period Register        */
65 #define CD180_MSVR      0x28    /* Modem Signal Value Register            */
66 #define CD180_RBPRH     0x31    /* Receive Baud Rate Period Register MSB  */
67 #define CD180_RBPRL     0x32    /* Receive Baud Rate Period Register LSB  */
68 #define CD180_TBPRH     0x39    /* Transmit Baud Rate Period Register MSB */
69 #define CD180_TBPRL     0x3A    /* Transmit Baud Rate Period Register LSB */
70 
71 /** Register descritpions **/
72 
73 /* Global Interrupt Vector Register */
74 #define GIVR_IT_MSCI    0x01    /* Modem Signal Change Interrupt          */
75 #define GIVR_IT_TDI     0x02    /* Transmit Data Interrupt                */
76 #define GIVR_IT_RGDI    0x03    /* Receive Good Data Interrupt            */
77 #define GIVR_IT_REI     0x07    /* Receive Exception Interrupt            */
78 
79 /* Global Interrupt Channel Register */
80 #define GICR_CHAN       0x1C    /* Channel Number Mask                    */
81 #define GICR_LSH        2       /* Channel Number Shift                   */
82 
83 /* Channel Address Register */
84 #define CAR_CHAN        0x07    /* Channel Number Mask                    */
85 #define	CAR_A7          0x08    /* Address bit 7 (unused)                  */
86 
87 /* Receive Character Status Register */
88 #define RCSR_OE         0x01    /* Overrun Error                          */
89 #define RCSR_FE         0x02    /* Frame Error                            */
90 #define RCSR_PE         0x04    /* Parity Error                           */
91 #define RCSR_Break      0x08    /* Break detected                         */
92 #define RCSR_Timeout    0x80    /* Rx Timeout                             */
93 #define RCSR_SCMASK     0x70    /* Special Character Detected Mask        */
94 #define RCSR_SC1        0x10    /* Special Char 1 (or 1 & 3 seq matched)  */
95 #define RCSR_SC2        0x20    /* Special Char 2 (or 2 & 4 seq matched)  */
96 #define RCSR_SC3        0x30    /* Special Char 3                         */
97 #define RCSR_SC4        0x40    /* Special Char 4                         */
98 
99 /* Channel Command Register */
100 #define CCR_ResetChan   0x80    /* Reset Channel                          */
101 #define CCR_HWRESET     0x81    /* Hardware Reset (all channels)          */
102 #define CCR_CORCHG1     0x42    /* Channel Option Register 1 Changed      */
103 #define CCR_CORCHG2     0x44    /* Channel Option Register 2 Changed      */
104 #define CCR_CORCHG3     0x48    /* Channel Option Register 3 Changed      */
105 #define CCR_SENDSPCH1   0x21    /* Send Special Character 1               */
106 #define CCR_SENDSPCH2   0x22    /* Send Special Character 2               */
107 #define CCR_SENDSPCH3   0x23    /* Send Special Character 3               */
108 #define CCR_SENDSPCH4   0x24    /* Send Special Character 4               */
109 #define CCR_RCVRDIS     0x11    /* Receiver Disable                       */
110 #define CCR_RCVREN      0x12    /* Receiver Enable                        */
111 #define CCR_XMTRDIS     0x14    /* Transmitter Disable                    */
112 #define CCR_XMTREN      0x18    /* Transmitter Enable                     */
113 
114 /* Interrupt Enable Register */
115 #define IER_DSR         0x80    /* Enable interrupt on DSR change         */
116 #define IER_CD          0x40    /* Enable interrupt on CD change          */
117 #define IER_CTS         0x20    /* Enable interrupt on CTS change         */
118 #define IER_RxData      0x10    /* Enable interrupt on Receive Data       */
119 #define IER_RxSC        0x08    /* Enable interrupt on Receive Spec. Char */
120 #define IER_TxRdy       0x04    /* Enable interrupt on TX FIFO empty      */
121 #define IER_TxMpty      0x02    /* Enable interrupt on TX completely empty*/
122 #define IER_RET         0x01    /* Enable interrupt on RX Except. Timeout */
123 
124 /* Channel Option Register 1 */
125 #define COR1_ODDP       0x80    /* Odd Parity                             */
126 #define COR1_ParMMASK   0x60    /* Parity Mode mask                       */
127 #define COR1_NOPAR      0x02    /* No Parity                              */
128 #define COR1_FORCEPAR   0x20    /* Force Parity                           */
129 #define COR1_NORMPAR    0x40    /* Normal Parity                          */
130 #define COR1_Ignore     0x10    /* Ignore Parity on RX                    */
131 #define COR1_StopMASK   0x0C    /* Stop Bits mode mask                    */
132 #define COR1_1SB        0x00    /* 1 Stop Bit                             */
133 #define COR1_15SB       0x04    /* 1.5 Stop Bits                          */
134 #define COR1_2SB        0x08    /* 2 Stop Bits                            */
135 #define COR1_CHLMASK    0x03    /* Character Length mask                  */
136 #define COR1_5BITS      0x00    /* 5 bits                                 */
137 #define COR1_6BITS      0x01    /* 6 bits                                 */
138 #define COR1_7BITS      0x02    /* 7 bits                                 */
139 #define COR1_8BITS      0x03    /* 8 bits                                 */
140 
141 /* Channel Option Register 2 */
142 #define COR2_IXM        0x80    /* Implied XON mode                       */
143 #define COR2_TxIBE      0x40    /* Enable In-Band XON/XOFF Flow Control   */
144 #define COR2_ETC        0x20    /* Embedded Tx Commands Enable            */
145 #define COR2_LLM        0x10    /* Local Loopback Mode                    */
146 #define COR2_RLM        0x08    /* Remote Loopback Mode                   */
147 #define COR2_RtsAO      0x04    /* RTS Automatic Output Enable            */
148 #define COR2_CtsAE      0x02    /* CTS Automatic Enable                   */
149 #define COR2_DsrAE      0x01    /* DSR Automatic Enable                   */
150 
151 /* Channel Option Register 3 */
152 #define COR3_XonCH      0x80    /* XON is a double seq (1 & 3)            */
153 #define COR3_XoffCH     0x40    /* XOFF is a double seq (1 & 3)           */
154 #define COR3_FCT        0x20    /* Flow-Control Transparency Mode         */
155 #define COR3_SCDE       0x10    /* Special Character Detection Enable     */
156 #define COR3_RxTHMASK   0x0F    /* RX FIFO Threshold value (1-8)          */
157 
158 /* Channel Control Status Register */
159 #define CCSR_RxEn       0x80    /* Revceiver Enabled                      */
160 #define CCSR_RxFloff    0x40    /* Receive Flow Off (XOFF sent)           */
161 #define CCSR_RxFlon     0x20    /* Receive Flow On (XON sent)             */
162 #define CCSR_TxEn       0x08    /* Transmitter Enabled                    */
163 #define CCSR_TxFloff    0x04    /* Transmit Flow Off (got XOFF)           */
164 #define CCSR_TxFlon     0x02    /* Transmit Flow On (got XON)             */
165 
166 /* Modem Change Option Register 1 */
167 #define MCOR1_DSRzd     0x80    /* Detect 0->1 transition of DSR          */
168 #define MCOR1_CDzd      0x40    /* Detect 0->1 transition of CD           */
169 #define MCOR1_CTSzd     0x20    /* Detect 0->1 transition of CTS          */
170 #define MCOR1_DTRthMASK 0x0F    /* Automatic DTR FC Threshold (1-8) chars */
171 
172 /* Modem Change Option Register 2 */
173 #define MCOR2_DSRod     0x80    /* Detect 1->0 transition of DSR          */
174 #define MCOR2_CDod      0x40    /* Detect 1->0 transition of CD           */
175 #define MCOR2_CTSod     0x20    /* Detect 1->0 transition of CTS          */
176 
177 /* Modem Change Register */
178 #define MCR_DSRchg      0x80    /* DSR Changed                            */
179 #define MCR_CDchg       0x40    /* CD  Changed                            */
180 #define MCR_CTSchg      0x20    /* CTS Changed                            */
181 
182 /* Modem Signal Value Register */
183 #define MSVR_DSR        0x80    /* Current state of DSR input             */
184 #define MSVR_CD         0x40    /* Current state of DSR input             */
185 #define MSVR_CTS        0x20    /* Current state of CTS input             */
186 #define MSVR_DTR        0x02    /* Current state of DTR output            */
187 #define MSVR_RTS        0x01    /* Current state of RTS output            */
188 
189 /* Escape characters */
190 #define CD180_C_ESC     0x00    /* Escape character                       */
191 #define CD180_C_SBRK    0x81    /* Start sending BREAK                    */
192 #define CD180_C_DELAY   0x82    /* Delay output                           */
193 #define CD180_C_EBRK    0x83    /* Stop sending BREAK                     */
194 
195 /* Miscellaneous */
196 #define CD180_NCHAN     8       /* 8 channels per chip                    */
197 #define CD180_CTICKS    16      /* 16 ticks for character processing      */
198 #define CD180_NFIFO     8       /* 8 bytes in FIFO                        */
199