Annotation of sys/dev/ic/tc921x.c, Revision 1.1.1.1
1.1 nbrk 1: /* $OpenBSD: tc921x.c,v 1.3 2007/05/22 04:14:03 jsg Exp $ */
2:
3: /*
4: * Copyright (c) 2001, 2002 Vladimir Popov <jumbo@narod.ru>.
5: *
6: * Redistribution and use in source and binary forms, with or without
7: * modification, are permitted provided that the following conditions
8: * are met:
9: * 1. Redistributions of source code must retain the above copyright
10: * notice, this list of conditions and the following disclaimer.
11: * 2. Redistributions in binary form must reproduce the above copyright
12: * notice, this list of conditions and the following disclaimer in the
13: * documentation and/or other materials provided with the distribution.
14: *
15: * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
16: * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
17: * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
18: * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
19: * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
20: * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
21: * OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
22: * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
23: * OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
24: * ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
25: */
26: /*
27: * Toshiba's High Speed PLL for DTS
28: *
29: * TC9216P, TC9217P, TC9217F are a high speed PLL-LSI with built-in 2 modulus
30: * prescaler. Each function is controlled through 3 serial bus lines and high
31: * performance digital tuning system can be constituted.
32: *
33: * Each function is controlled by the data setting to a pair of 24-bit
34: * registers. Each data of these registers is exchanged with controller side
35: * by 3 serial lines of DATA, CLOCK and PERIOD.
36: *
37: * 8 address bits and 24 data bits, total 32 bits, are transferred thru
38: * serial port.
39: *
40: * Input data is latched to the first and second input registers at the fall
41: * of PERIOD signal and each function is activated.
42: *
43: * Each output data is latched to output register in parallel at the fall
44: * timing of the 9th of CLOCK signal and can be received serially over the
45: * DATA line. Serial data of DATA, CLOCK and PERIOD is synchronized with
46: * crystal oscillation clock and tacken into the internal circuit of LSI.
47: * Thus, if crystal oscillator is stopped, serial data can not be input.
48: */
49:
50: #include <sys/param.h>
51: #include <sys/radioio.h>
52:
53: #include <dev/ic/tc921x.h>
54:
55: #define PL_CL_DL(c) ((0 << c->period) | (0 << c->clock) | (0 << c->data))
56: #define PL_CL_DH(c) ((0 << c->period) | (0 << c->clock) | (1 << c->data))
57: #define PL_CH_DL(c) ((0 << c->period) | (1 << c->clock) | (0 << c->data))
58: #define PL_CH_DH(c) ((0 << c->period) | (1 << c->clock) | (1 << c->data))
59:
60: #define PH_CL_DL(c) ((1 << c->period) | (0 << c->clock) | (0 << c->data))
61: #define PH_CL_DH(c) ((1 << c->period) | (0 << c->clock) | (1 << c->data))
62: #define PH_CH_DL(c) ((1 << c->period) | (1 << c->clock) | (0 << c->data))
63: #define PH_CH_DH(c) ((1 << c->period) | (1 << c->clock) | (1 << c->data))
64:
65: #define PERIOD_LOW 0
66: #define PERIOD_HIGH 1
67:
68: static void __tc921x_write_burst(unsigned int, u_int32_t, struct tc921x_t *, int);
69: static u_int32_t __tc921x_read_burst(unsigned int, struct tc921x_t *);
70:
71: u_int32_t
72: tc921x_encode_freq(u_int32_t freq) {
73: /* Normalize incoming frequency */
74: if (freq < MIN_FM_FREQ)
75: freq = MIN_FM_FREQ;
76: if (freq > MAX_FM_FREQ)
77: freq = MAX_FM_FREQ;
78:
79: return (freq + IF_FREQ)/10;
80: }
81:
82: u_int32_t
83: tc921x_decode_freq(u_int32_t reg) {
84: return (reg & TC921X_D0_FREQ_DIVIDER) * 10 - IF_FREQ;
85: }
86:
87: u_int32_t
88: tc921x_read_addr(struct tc921x_t *c, u_int8_t addr) {
89: u_int32_t ret;
90:
91: /* Finish previous transmission - PERIOD HIGH, CLOCK HIGH, DATA HIGH */
92: bus_space_write_1(c->iot, c->ioh, c->offset, PH_CH_DH(c));
93: /* Start transmission - PERIOD LOW, CLOCK HIGH, DATA HIGH */
94: bus_space_write_1(c->iot, c->ioh, c->offset, PL_CH_DH(c));
95:
96: /*
97: * Period must be low when the register address transmission starts.
98: * Period must be high when the register data transmission starts.
99: * Do the switch in the middle of the address transmission.
100: */
101: __tc921x_write_burst(4, addr, c, PERIOD_LOW);
102: __tc921x_write_burst(4, addr >> 4, c, PERIOD_HIGH);
103:
104: /* Reading data from the register */
105: ret = __tc921x_read_burst(TC921X_REGISTER_LENGTH, c);
106:
107: /* End of transmission - PERIOD goes LOW then HIGH */
108: bus_space_write_1(c->iot, c->ioh, c->offset, PL_CH_DH(c));
109: bus_space_write_1(c->iot, c->ioh, c->offset, PH_CH_DH(c));
110:
111: return ret;
112: }
113:
114: void
115: tc921x_write_addr(struct tc921x_t *c, u_int8_t addr, u_int32_t reg) {
116: /* Finish previous transmission - PERIOD HIGH, CLOCK HIGH, DATA HIGH */
117: bus_space_write_1(c->iot, c->ioh, c->offset, PH_CH_DH(c));
118: /* Start transmission - PERIOD LOW, CLOCK HIGH, DATA HIGH */
119: bus_space_write_1(c->iot, c->ioh, c->offset, PL_CH_DH(c));
120:
121: /*
122: * Period must be low when the register address transmission starts.
123: * Period must be high when the register data transmission starts.
124: * Do the switch in the middle of the address transmission.
125: */
126: __tc921x_write_burst(4, addr, c, PERIOD_LOW);
127: __tc921x_write_burst(4, addr >> 4, c, PERIOD_HIGH);
128:
129: /* Writing data to the register */
130: __tc921x_write_burst(TC921X_REGISTER_LENGTH, reg, c, 1);
131:
132: /* End of transmission - PERIOD goes LOW then HIGH */
133: bus_space_write_1(c->iot, c->ioh, c->offset, PL_CH_DH(c));
134: bus_space_write_1(c->iot, c->ioh, c->offset, PH_CH_DH(c));
135: }
136:
137: static void
138: __tc921x_write_burst(unsigned int length, u_int32_t data, struct tc921x_t *c, int p) {
139: int i;
140: u_int8_t cldh, chdh, cldl, chdl;
141:
142: cldh = p == PERIOD_LOW ? PL_CL_DH(c) : PH_CL_DH(c);
143: chdh = p == PERIOD_LOW ? PL_CH_DH(c) : PH_CH_DH(c);
144: cldl = p == PERIOD_LOW ? PL_CL_DL(c) : PH_CL_DL(c);
145: chdl = p == PERIOD_LOW ? PL_CH_DL(c) : PH_CH_DL(c);
146:
147: for (i = 0; i < length; i++)
148: if (data & (1 << i)) {
149: bus_space_write_1(c->iot, c->ioh, c->offset, cldh);
150: bus_space_write_1(c->iot, c->ioh, c->offset, chdh);
151: } else {
152: bus_space_write_1(c->iot, c->ioh, c->offset, cldl);
153: bus_space_write_1(c->iot, c->ioh, c->offset, chdl);
154: }
155: }
156:
157: static u_int32_t
158: __tc921x_read_burst(unsigned int length, struct tc921x_t *c) {
159: unsigned int i;
160: u_int32_t ret = 0ul;
161:
162: #define DATA_ON (1 << c->data)
163:
164: for (i = 0; i < length; i++) {
165: bus_space_write_1(c->iot, c->ioh, c->offset, PH_CL_DH(c));
166: bus_space_write_1(c->iot, c->ioh, c->offset, PH_CH_DH(c));
167: ret |= bus_space_read_1(c->iot, c->ioh, c->offset) & DATA_ON ?
168: (1 << i) : (0 << i);
169: }
170:
171: return ret;
172: }
CVSweb