blob: f0a79b92b024879cf034e13fe27897170ded03a7 [file] [log] [blame]
Tom Rini10e47792018-05-06 17:58:06 -04001// SPDX-License-Identifier: GPL-2.0
Peter Tyser9902e422008-12-17 16:36:21 -06002/*
3 * Copyright 2008 Extreme Engineering Solutions, Inc.
Peter Tyser9902e422008-12-17 16:36:21 -06004 */
5
6/*
Chris Packham9b383202010-12-19 10:12:13 +00007 * Driver for NXP's 4, 8 and 16 bit I2C gpio expanders (eg pca9537, pca9557,
8 * pca9539, etc)
Peter Tyser9902e422008-12-17 16:36:21 -06009 */
10
Tom Rinidec7ea02024-05-20 13:35:03 -060011#include <config.h>
Simon Glassed38aef2020-05-10 11:40:03 -060012#include <command.h>
Peter Tyser9902e422008-12-17 16:36:21 -060013#include <i2c.h>
14#include <pca953x.h>
Tom Rinidec7ea02024-05-20 13:35:03 -060015#include <vsprintf.h>
Tom Rinie2dc2812025-05-14 16:46:02 -060016#include <asm/byteorder.h>
Peter Tyser9902e422008-12-17 16:36:21 -060017
18/* Default to an address that hopefully won't corrupt other i2c devices */
Tom Rini6a5dccc2022-11-16 13:10:41 -050019#ifndef CFG_SYS_I2C_PCA953X_ADDR
20#define CFG_SYS_I2C_PCA953X_ADDR (~0)
Peter Tyser9902e422008-12-17 16:36:21 -060021#endif
22
23enum {
24 PCA953X_CMD_INFO,
25 PCA953X_CMD_DEVICE,
26 PCA953X_CMD_OUTPUT,
27 PCA953X_CMD_INPUT,
28 PCA953X_CMD_INVERT,
29};
30
Tom Rini6a5dccc2022-11-16 13:10:41 -050031#ifdef CFG_SYS_I2C_PCA953X_WIDTH
Chris Packham9b383202010-12-19 10:12:13 +000032struct pca953x_chip_ngpio {
33 uint8_t chip;
34 uint8_t ngpio;
35};
36
37static struct pca953x_chip_ngpio pca953x_chip_ngpios[] =
Tom Rini6a5dccc2022-11-16 13:10:41 -050038 CFG_SYS_I2C_PCA953X_WIDTH;
Chris Packham9b383202010-12-19 10:12:13 +000039
Chris Packham9b383202010-12-19 10:12:13 +000040/*
41 * Determine the number of GPIO pins supported. If we don't know we assume
42 * 8 pins.
43 */
44static int pca953x_ngpio(uint8_t chip)
45{
46 int i;
47
Axel Line9770432013-06-22 18:22:48 +080048 for (i = 0; i < ARRAY_SIZE(pca953x_chip_ngpios); i++)
Chris Packham9b383202010-12-19 10:12:13 +000049 if (pca953x_chip_ngpios[i].chip == chip)
50 return pca953x_chip_ngpios[i].ngpio;
51
52 return 8;
53}
54#else
55static int pca953x_ngpio(uint8_t chip)
56{
57 return 8;
58}
59#endif
60
Peter Tyser9902e422008-12-17 16:36:21 -060061/*
62 * Modify masked bits in register
63 */
64static int pca953x_reg_write(uint8_t chip, uint addr, uint mask, uint data)
65{
Chris Packham9b383202010-12-19 10:12:13 +000066 uint8_t valb;
67 uint16_t valw;
Peter Tyser9902e422008-12-17 16:36:21 -060068
Chris Packham9b383202010-12-19 10:12:13 +000069 if (pca953x_ngpio(chip) <= 8) {
70 if (i2c_read(chip, addr, 1, &valb, 1))
71 return -1;
72
73 valb &= ~mask;
74 valb |= data;
75
76 return i2c_write(chip, addr, 1, &valb, 1);
77 } else {
78 if (i2c_read(chip, addr << 1, 1, (u8*)&valw, 2))
79 return -1;
Peter Tyser9902e422008-12-17 16:36:21 -060080
Dirk Eibach4f515fb2015-10-29 13:51:27 +010081 valw = le16_to_cpu(valw);
Chris Packham9b383202010-12-19 10:12:13 +000082 valw &= ~mask;
83 valw |= data;
Dirk Eibach4f515fb2015-10-29 13:51:27 +010084 valw = cpu_to_le16(valw);
Peter Tyser9902e422008-12-17 16:36:21 -060085
Chris Packham9b383202010-12-19 10:12:13 +000086 return i2c_write(chip, addr << 1, 1, (u8*)&valw, 2);
87 }
Peter Tyser9902e422008-12-17 16:36:21 -060088}
89
Chris Packham9b383202010-12-19 10:12:13 +000090static int pca953x_reg_read(uint8_t chip, uint addr, uint *data)
91{
92 uint8_t valb;
93 uint16_t valw;
94
95 if (pca953x_ngpio(chip) <= 8) {
96 if (i2c_read(chip, addr, 1, &valb, 1))
97 return -1;
98 *data = (int)valb;
99 } else {
100 if (i2c_read(chip, addr << 1, 1, (u8*)&valw, 2))
101 return -1;
Dirk Eibach4f515fb2015-10-29 13:51:27 +0100102 *data = (uint)le16_to_cpu(valw);
Chris Packham9b383202010-12-19 10:12:13 +0000103 }
104 return 0;
105}
106
Peter Tyser9902e422008-12-17 16:36:21 -0600107/*
108 * Set output value of IO pins in 'mask' to corresponding value in 'data'
109 * 0 = low, 1 = high
110 */
111int pca953x_set_val(uint8_t chip, uint mask, uint data)
112{
113 return pca953x_reg_write(chip, PCA953X_OUT, mask, data);
114}
115
116/*
117 * Set read polarity of IO pins in 'mask' to corresponding value in 'data'
118 * 0 = read pin value, 1 = read inverted pin value
119 */
120int pca953x_set_pol(uint8_t chip, uint mask, uint data)
121{
122 return pca953x_reg_write(chip, PCA953X_POL, mask, data);
123}
124
125/*
126 * Set direction of IO pins in 'mask' to corresponding value in 'data'
127 * 0 = output, 1 = input
128 */
129int pca953x_set_dir(uint8_t chip, uint mask, uint data)
130{
131 return pca953x_reg_write(chip, PCA953X_CONF, mask, data);
132}
133
134/*
135 * Read current logic level of all IO pins
136 */
137int pca953x_get_val(uint8_t chip)
138{
Chris Packham9b383202010-12-19 10:12:13 +0000139 uint val;
Peter Tyser9902e422008-12-17 16:36:21 -0600140
Chris Packham9b383202010-12-19 10:12:13 +0000141 if (pca953x_reg_read(chip, PCA953X_IN, &val) < 0)
Peter Tyser9902e422008-12-17 16:36:21 -0600142 return -1;
143
144 return (int)val;
145}
146
Simon Glass7ec24132024-09-29 19:49:48 -0600147#if defined(CONFIG_CMD_PCA953X) && !defined(CONFIG_XPL_BUILD)
Peter Tyser9902e422008-12-17 16:36:21 -0600148/*
149 * Display pca953x information
150 */
151static int pca953x_info(uint8_t chip)
152{
153 int i;
Chris Packham9b383202010-12-19 10:12:13 +0000154 uint data;
155 int nr_gpio = pca953x_ngpio(chip);
156 int msb = nr_gpio - 1;
Peter Tyser9902e422008-12-17 16:36:21 -0600157
Chris Packham9b383202010-12-19 10:12:13 +0000158 printf("pca953x@ 0x%x (%d pins):\n\n", chip, nr_gpio);
159 printf("gpio pins: ");
160 for (i = msb; i >= 0; i--)
161 printf("%x", i);
162 printf("\n");
163 for (i = 11 + nr_gpio; i > 0; i--)
164 printf("-");
165 printf("\n");
Peter Tyser9902e422008-12-17 16:36:21 -0600166
Chris Packham9b383202010-12-19 10:12:13 +0000167 if (pca953x_reg_read(chip, PCA953X_CONF, &data) < 0)
Peter Tyser9902e422008-12-17 16:36:21 -0600168 return -1;
169 printf("conf: ");
Chris Packham9b383202010-12-19 10:12:13 +0000170 for (i = msb; i >= 0; i--)
Peter Tyser9902e422008-12-17 16:36:21 -0600171 printf("%c", data & (1 << i) ? 'i' : 'o');
172 printf("\n");
173
Chris Packham9b383202010-12-19 10:12:13 +0000174 if (pca953x_reg_read(chip, PCA953X_POL, &data) < 0)
Peter Tyser9902e422008-12-17 16:36:21 -0600175 return -1;
176 printf("invert: ");
Chris Packham9b383202010-12-19 10:12:13 +0000177 for (i = msb; i >= 0; i--)
Peter Tyser9902e422008-12-17 16:36:21 -0600178 printf("%c", data & (1 << i) ? '1' : '0');
179 printf("\n");
180
Chris Packham9b383202010-12-19 10:12:13 +0000181 if (pca953x_reg_read(chip, PCA953X_IN, &data) < 0)
Peter Tyser9902e422008-12-17 16:36:21 -0600182 return -1;
183 printf("input: ");
Chris Packham9b383202010-12-19 10:12:13 +0000184 for (i = msb; i >= 0; i--)
Peter Tyser9902e422008-12-17 16:36:21 -0600185 printf("%c", data & (1 << i) ? '1' : '0');
186 printf("\n");
187
Chris Packham9b383202010-12-19 10:12:13 +0000188 if (pca953x_reg_read(chip, PCA953X_OUT, &data) < 0)
Peter Tyser9902e422008-12-17 16:36:21 -0600189 return -1;
190 printf("output: ");
Chris Packham9b383202010-12-19 10:12:13 +0000191 for (i = msb; i >= 0; i--)
Peter Tyser9902e422008-12-17 16:36:21 -0600192 printf("%c", data & (1 << i) ? '1' : '0');
193 printf("\n");
194
195 return 0;
196}
Peter Tyser9902e422008-12-17 16:36:21 -0600197
Simon Glassed38aef2020-05-10 11:40:03 -0600198static struct cmd_tbl cmd_pca953x[] = {
Peter Tyser9902e422008-12-17 16:36:21 -0600199 U_BOOT_CMD_MKENT(device, 3, 0, (void *)PCA953X_CMD_DEVICE, "", ""),
200 U_BOOT_CMD_MKENT(output, 4, 0, (void *)PCA953X_CMD_OUTPUT, "", ""),
201 U_BOOT_CMD_MKENT(input, 3, 0, (void *)PCA953X_CMD_INPUT, "", ""),
202 U_BOOT_CMD_MKENT(invert, 4, 0, (void *)PCA953X_CMD_INVERT, "", ""),
Peter Tyser9902e422008-12-17 16:36:21 -0600203 U_BOOT_CMD_MKENT(info, 2, 0, (void *)PCA953X_CMD_INFO, "", ""),
Peter Tyser9902e422008-12-17 16:36:21 -0600204};
205
Simon Glassed38aef2020-05-10 11:40:03 -0600206static int do_pca953x(struct cmd_tbl *cmdtp, int flag, int argc,
207 char *const argv[])
Peter Tyser9902e422008-12-17 16:36:21 -0600208{
Tom Rini6a5dccc2022-11-16 13:10:41 -0500209 static uint8_t chip = CFG_SYS_I2C_PCA953X_ADDR;
Laurence Withers46a409d2012-07-25 03:55:48 +0000210 int ret = CMD_RET_USAGE, val;
Peter Tyser9902e422008-12-17 16:36:21 -0600211 ulong ul_arg2 = 0;
212 ulong ul_arg3 = 0;
Simon Glassed38aef2020-05-10 11:40:03 -0600213 struct cmd_tbl *c;
Peter Tyser9902e422008-12-17 16:36:21 -0600214
215 c = find_cmd_tbl(argv[1], cmd_pca953x, ARRAY_SIZE(cmd_pca953x));
216
217 /* All commands but "device" require 'maxargs' arguments */
218 if (!c || !((argc == (c->maxargs)) ||
Michal Simekfc2ef432016-04-11 13:51:26 +0200219 (((long)c->cmd == PCA953X_CMD_DEVICE) &&
Peter Tyser9902e422008-12-17 16:36:21 -0600220 (argc == (c->maxargs - 1))))) {
Laurence Withers46a409d2012-07-25 03:55:48 +0000221 return CMD_RET_USAGE;
Peter Tyser9902e422008-12-17 16:36:21 -0600222 }
223
224 /* arg2 used as chip number or pin number */
225 if (argc > 2)
Simon Glass3ff49ec2021-07-24 09:03:29 -0600226 ul_arg2 = hextoul(argv[2], NULL);
Peter Tyser9902e422008-12-17 16:36:21 -0600227
228 /* arg3 used as pin or invert value */
229 if (argc > 3)
Simon Glass3ff49ec2021-07-24 09:03:29 -0600230 ul_arg3 = hextoul(argv[3], NULL) & 0x1;
Peter Tyser9902e422008-12-17 16:36:21 -0600231
Michal Simekfc2ef432016-04-11 13:51:26 +0200232 switch ((long)c->cmd) {
Peter Tyser9902e422008-12-17 16:36:21 -0600233 case PCA953X_CMD_INFO:
Laurence Withers46a409d2012-07-25 03:55:48 +0000234 ret = pca953x_info(chip);
235 if (ret)
236 ret = CMD_RET_FAILURE;
237 break;
Laurence Withers46a409d2012-07-25 03:55:48 +0000238
Peter Tyser9902e422008-12-17 16:36:21 -0600239 case PCA953X_CMD_DEVICE:
240 if (argc == 3)
241 chip = (uint8_t)ul_arg2;
242 printf("Current device address: 0x%x\n", chip);
Laurence Withers46a409d2012-07-25 03:55:48 +0000243 ret = CMD_RET_SUCCESS;
244 break;
245
Peter Tyser9902e422008-12-17 16:36:21 -0600246 case PCA953X_CMD_INPUT:
Laurence Withers46a409d2012-07-25 03:55:48 +0000247 ret = pca953x_set_dir(chip, (1 << ul_arg2),
Peter Tyser9902e422008-12-17 16:36:21 -0600248 PCA953X_DIR_IN << ul_arg2);
249 val = (pca953x_get_val(chip) & (1 << ul_arg2)) != 0;
250
Laurence Withers46a409d2012-07-25 03:55:48 +0000251 if (ret)
252 ret = CMD_RET_FAILURE;
253 else
254 printf("chip 0x%02x, pin 0x%lx = %d\n", chip, ul_arg2,
255 val);
256 break;
257
Peter Tyser9902e422008-12-17 16:36:21 -0600258 case PCA953X_CMD_OUTPUT:
Laurence Withers46a409d2012-07-25 03:55:48 +0000259 ret = pca953x_set_dir(chip, (1 << ul_arg2),
Peter Tyser9902e422008-12-17 16:36:21 -0600260 (PCA953X_DIR_OUT << ul_arg2));
Laurence Withers46a409d2012-07-25 03:55:48 +0000261 if (!ret)
262 ret = pca953x_set_val(chip, (1 << ul_arg2),
263 (ul_arg3 << ul_arg2));
264 if (ret)
265 ret = CMD_RET_FAILURE;
266 break;
267
Peter Tyser9902e422008-12-17 16:36:21 -0600268 case PCA953X_CMD_INVERT:
Laurence Withers46a409d2012-07-25 03:55:48 +0000269 ret = pca953x_set_pol(chip, (1 << ul_arg2),
Peter Tyser9902e422008-12-17 16:36:21 -0600270 (ul_arg3 << ul_arg2));
Laurence Withers46a409d2012-07-25 03:55:48 +0000271 if (ret)
272 ret = CMD_RET_FAILURE;
273 break;
Peter Tyser9902e422008-12-17 16:36:21 -0600274 }
Laurence Withers46a409d2012-07-25 03:55:48 +0000275
276 if (ret == CMD_RET_FAILURE)
277 eprintf("Error talking to chip at 0x%x\n", chip);
278
279 return ret;
Peter Tyser9902e422008-12-17 16:36:21 -0600280}
281
282U_BOOT_CMD(
283 pca953x, 5, 1, do_pca953x,
Peter Tyserdfb72b82009-01-27 18:03:12 -0600284 "pca953x gpio access",
Peter Tyser9902e422008-12-17 16:36:21 -0600285 "device [dev]\n"
286 " - show or set current device address\n"
Peter Tyser9902e422008-12-17 16:36:21 -0600287 "pca953x info\n"
288 " - display info for current chip\n"
Peter Tyser9902e422008-12-17 16:36:21 -0600289 "pca953x output pin 0|1\n"
290 " - set pin as output and drive low or high\n"
291 "pca953x invert pin 0|1\n"
292 " - disable/enable polarity inversion for reads\n"
Laurence Withers7a63c652012-07-25 03:55:47 +0000293 "pca953x input pin\n"
Wolfgang Denkc54781c2009-05-24 17:06:54 +0200294 " - set pin as input and read value"
Peter Tyser9902e422008-12-17 16:36:21 -0600295);
296
297#endif /* CONFIG_CMD_PCA953X */