s390.c revision 1.9 1 /* $NetBSD: s390.c,v 1.9 2025/09/07 21:45:16 thorpej Exp $ */
2
3 /*-
4 * Copyright (c) 2011 Frank Wille.
5 * All rights reserved.
6 *
7 * Written by Frank Wille for The NetBSD Project.
8 *
9 * Redistribution and use in source and binary forms, with or without
10 * modification, are permitted provided that the following conditions
11 * are met:
12 * 1. Redistributions of source code must retain the above copyright
13 * notice, this list of conditions and the following disclaimer.
14 * 2. Redistributions in binary form must reproduce the above copyright
15 * notice, this list of conditions and the following disclaimer in the
16 * documentation and/or other materials provided with the distribution.
17 *
18 * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
19 * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
20 * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
21 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
22 * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
23 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
24 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
25 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
26 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
27 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
28 * POSSIBILITY OF SUCH DAMAGE.
29 */
30
31 #include <sys/cdefs.h>
32 __KERNEL_RCSID(0, "$NetBSD: s390.c,v 1.9 2025/09/07 21:45:16 thorpej Exp $");
33
34 #include <sys/param.h>
35 #include <sys/systm.h>
36 #include <sys/device.h>
37 #include <sys/conf.h>
38
39 #include <dev/clock_subr.h>
40
41 #include <dev/i2c/i2cvar.h>
42 #include <dev/i2c/s390reg.h>
43
44 struct s390rtc_softc {
45 device_t sc_dev;
46 i2c_tag_t sc_tag;
47 i2c_addr_t sc_addr;
48 struct todr_chip_handle sc_todr;
49 };
50
51 static int s390rtc_match(device_t, cfdata_t, void *);
52 static void s390rtc_attach(device_t, device_t, void *);
53
54 CFATTACH_DECL_NEW(s390rtc, sizeof(struct s390rtc_softc),
55 s390rtc_match, s390rtc_attach, NULL, NULL);
56
57 static int s390rtc_gettime_ymdhms(struct todr_chip_handle *,
58 struct clock_ymdhms *);
59 static int s390rtc_settime_ymdhms(struct todr_chip_handle *,
60 struct clock_ymdhms *);
61 static int s390rtc_read(struct s390rtc_softc *, int, uint8_t *, size_t);
62 static int s390rtc_write(struct s390rtc_softc *, int, uint8_t *, size_t);
63 static uint8_t bitreverse(uint8_t);
64
65 static const struct device_compatible_entry compat_data[] = {
66 { .compat = "sii,s35390a" },
67 DEVICE_COMPAT_EOL
68 };
69
70 static int
71 s390rtc_match(device_t parent, cfdata_t cf, void *arg)
72 {
73 struct i2c_attach_args *ia = arg;
74 int match_result;
75
76 if (iic_use_direct_match(ia, cf, compat_data, &match_result))
77 return match_result;
78
79 /* indirect config - check typical address */
80 if (ia->ia_addr == S390_ADDR)
81 return I2C_MATCH_ADDRESS_ONLY;
82
83 return 0;
84 }
85
86 static void
87 s390rtc_attach(device_t parent, device_t self, void *arg)
88 {
89 struct s390rtc_softc *sc = device_private(self);
90 struct i2c_attach_args *ia = arg;
91 uint8_t reg[1];
92
93 aprint_naive(": Real-time Clock\n");
94 aprint_normal(": Seiko Instruments 35390A Real-time Clock\n");
95
96 sc->sc_tag = ia->ia_tag;
97 sc->sc_addr = ia->ia_addr;
98 sc->sc_dev = self;
99
100 /* Reset the chip and turn on 24h mode, after power-off or battery. */
101 if (s390rtc_read(sc, S390_STATUS1, reg, sizeof(reg)))
102 return;
103 if (reg[0] & (S390_ST1_POC | S390_ST1_BLD)) {
104 reg[0] |= S390_ST1_24H | S390_ST1_RESET;
105 if (s390rtc_write(sc, S390_STATUS1, reg, sizeof(reg)))
106 return;
107 }
108
109 /* Disable the test mode, when enabled. */
110 if (s390rtc_read(sc, S390_STATUS2, reg, sizeof(reg)))
111 return;
112 if ((reg[0] & S390_ST2_TEST)) {
113 reg[0] &= ~S390_ST2_TEST;
114 if (s390rtc_write(sc, S390_STATUS2, reg, sizeof(reg)))
115 return;
116 }
117
118 sc->sc_todr.todr_dev = self;
119 sc->sc_todr.todr_gettime_ymdhms = s390rtc_gettime_ymdhms;
120 sc->sc_todr.todr_settime_ymdhms = s390rtc_settime_ymdhms;
121 todr_attach(&sc->sc_todr);
122 }
123
124 static int
125 s390rtc_gettime_ymdhms(struct todr_chip_handle *ch, struct clock_ymdhms *dt)
126 {
127 struct s390rtc_softc *sc = device_private(ch->todr_dev);
128 uint8_t bcd[S390_RT1_NBYTES];
129 int error;
130
131 if ((error = s390rtc_read(sc, S390_REALTIME1, bcd,
132 S390_RT1_NBYTES)) != 0)
133 return error;
134
135 /*
136 * Convert the register values into something useable.
137 */
138 dt->dt_sec = bcdtobin(bcd[S390_RT1_SECOND]);
139 dt->dt_min = bcdtobin(bcd[S390_RT1_MINUTE]);
140 dt->dt_hour = bcdtobin(bcd[S390_RT1_HOUR] & 0x3f);
141 dt->dt_day = bcdtobin(bcd[S390_RT1_DAY]);
142 dt->dt_mon = bcdtobin(bcd[S390_RT1_MONTH]);
143 dt->dt_year = bcdtobin(bcd[S390_RT1_YEAR]) + 2000;
144
145 return 0;
146 }
147
148 static int
149 s390rtc_settime_ymdhms(struct todr_chip_handle *ch, struct clock_ymdhms *dt)
150 {
151 struct s390rtc_softc *sc = device_private(ch->todr_dev);
152 uint8_t bcd[S390_RT1_NBYTES];
153
154 /*
155 * Convert our time representation into something the S-xx390
156 * can understand.
157 */
158 bcd[S390_RT1_SECOND] = bintobcd(dt->dt_sec);
159 bcd[S390_RT1_MINUTE] = bintobcd(dt->dt_min);
160 bcd[S390_RT1_HOUR] = bintobcd(dt->dt_hour);
161 bcd[S390_RT1_DAY] = bintobcd(dt->dt_day);
162 bcd[S390_RT1_WDAY] = bintobcd(dt->dt_wday);
163 bcd[S390_RT1_MONTH] = bintobcd(dt->dt_mon);
164 bcd[S390_RT1_YEAR] = bintobcd(dt->dt_year % 100);
165
166 return s390rtc_write(sc, S390_REALTIME1, bcd, S390_RT1_NBYTES);
167 }
168
169 static int
170 s390rtc_read(struct s390rtc_softc *sc, int reg, uint8_t *buf, size_t len)
171 {
172 int i, error;
173
174 if ((error = iic_acquire_bus(sc->sc_tag, 0)) != 0) {
175 aprint_error_dev(sc->sc_dev,
176 "%s: failed to acquire I2C bus\n", __func__);
177 return error;
178 }
179
180 if ((error = iic_exec(sc->sc_tag, I2C_OP_READ_WITH_STOP,
181 sc->sc_addr + reg, NULL, 0, buf, len, 0)) != 0) {
182 iic_release_bus(sc->sc_tag, 0);
183 aprint_error_dev(sc->sc_dev,
184 "%s: failed to read reg%d\n", __func__, reg);
185 return error;
186 }
187
188 iic_release_bus(sc->sc_tag, 0);
189
190 /* this chip returns each byte in reverse order */
191 for (i = 0; i < len; i++)
192 buf[i] = bitreverse(buf[i]);
193
194 return 0;
195 }
196
197 static int
198 s390rtc_write(struct s390rtc_softc *sc, int reg, uint8_t *buf, size_t len)
199 {
200 int i, error;
201
202 if ((error = iic_acquire_bus(sc->sc_tag, 0)) != 0) {
203 aprint_error_dev(sc->sc_dev,
204 "%s: failed to acquire I2C bus\n", __func__);
205 return error;
206 }
207
208 /* this chip expects each byte in reverse order */
209 for (i = 0; i < len; i++)
210 buf[i] = bitreverse(buf[i]);
211
212 if ((error = iic_exec(sc->sc_tag, I2C_OP_WRITE_WITH_STOP,
213 sc->sc_addr + reg, NULL, 0, buf, len, 0)) != 0) {
214 iic_release_bus(sc->sc_tag, 0);
215 aprint_error_dev(sc->sc_dev,
216 "%s: failed to write reg%d\n", __func__, reg);
217 return error;
218 }
219
220 iic_release_bus(sc->sc_tag, 0);
221 return 0;
222 }
223
224 static uint8_t
225 bitreverse(uint8_t x)
226 {
227 static unsigned char nibbletab[16] = {
228 0, 8, 4, 12, 2, 10, 6, 14, 1, 9, 5, 13, 3, 11, 7, 15
229 };
230
231 return (nibbletab[x & 15] << 4) | nibbletab[x >> 4];
232 }
233