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