summaryrefslogtreecommitdiff
path: root/tools/i2cdump.c
diff options
context:
space:
mode:
Diffstat (limited to 'tools/i2cdump.c')
-rw-r--r--tools/i2cdump.c487
1 files changed, 487 insertions, 0 deletions
diff --git a/tools/i2cdump.c b/tools/i2cdump.c
new file mode 100644
index 0000000..84b4bca
--- /dev/null
+++ b/tools/i2cdump.c
@@ -0,0 +1,487 @@
+/*
+ i2cdump.c - a user-space program to dump I2C registers
+ Copyright (C) 2002-2003 Frodo Looijaard <frodol@dds.nl>, and
+ Mark D. Studebaker <mdsxyz123@yahoo.com>
+ Copyright (C) 2004-2008 Jean Delvare <khali@linux-fr.org>
+
+ This program is free software; you can redistribute it and/or modify
+ it under the terms of the GNU General Public License as published by
+ the Free Software Foundation; either version 2 of the License, or
+ (at your option) any later version.
+
+ This program is distributed in the hope that it will be useful,
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ GNU General Public License for more details.
+
+ You should have received a copy of the GNU General Public License
+ along with this program; if not, write to the Free Software
+ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
+ MA 02110-1301 USA.
+*/
+
+#include <errno.h>
+#include <string.h>
+#include <stdio.h>
+#include <stdlib.h>
+#include <unistd.h>
+#include <linux/i2c-dev.h>
+#include "i2cbusses.h"
+#include "util.h"
+#include "../version.h"
+
+static void help(void)
+{
+ fprintf(stderr,
+ "Usage: i2cdump [-f] [-y] [-r first-last] I2CBUS ADDRESS [MODE [BANK [BANKREG]]]\n"
+ " I2CBUS is an integer or an I2C bus name\n"
+ " ADDRESS is an integer (0x03 - 0x77)\n"
+ " MODE is one of:\n"
+ " b (byte, default)\n"
+ " w (word)\n"
+ " W (word on even register addresses)\n"
+ " s (SMBus block)\n"
+ " i (I2C block)\n"
+ " c (consecutive byte)\n"
+ " Append p for SMBus PEC\n");
+}
+
+static int check_funcs(int file, int size, int pec)
+{
+ unsigned long funcs;
+
+ /* check adapter functionality */
+ if (ioctl(file, I2C_FUNCS, &funcs) < 0) {
+ fprintf(stderr, "Error: Could not get the adapter "
+ "functionality matrix: %s\n", strerror(errno));
+ return -1;
+ }
+
+ switch(size) {
+ case I2C_SMBUS_BYTE:
+ if (!(funcs & I2C_FUNC_SMBUS_READ_BYTE)) {
+ fprintf(stderr, MISSING_FUNC_FMT, "SMBus receive byte");
+ return -1;
+ }
+ if (!(funcs & I2C_FUNC_SMBUS_WRITE_BYTE)) {
+ fprintf(stderr, MISSING_FUNC_FMT, "SMBus send byte");
+ return -1;
+ }
+ break;
+
+ case I2C_SMBUS_BYTE_DATA:
+ if (!(funcs & I2C_FUNC_SMBUS_READ_BYTE_DATA)) {
+ fprintf(stderr, MISSING_FUNC_FMT, "SMBus read byte");
+ return -1;
+ }
+ break;
+
+ case I2C_SMBUS_WORD_DATA:
+ if (!(funcs & I2C_FUNC_SMBUS_READ_WORD_DATA)) {
+ fprintf(stderr, MISSING_FUNC_FMT, "SMBus read word");
+ return -1;
+ }
+ break;
+
+ case I2C_SMBUS_BLOCK_DATA:
+ if (!(funcs & I2C_FUNC_SMBUS_READ_BLOCK_DATA)) {
+ fprintf(stderr, MISSING_FUNC_FMT, "SMBus block read");
+ return -1;
+ }
+ break;
+
+ case I2C_SMBUS_I2C_BLOCK_DATA:
+ if (!(funcs & I2C_FUNC_SMBUS_READ_I2C_BLOCK)) {
+ fprintf(stderr, MISSING_FUNC_FMT, "I2C block read");
+ return -1;
+ }
+ break;
+ }
+
+ if (pec
+ && !(funcs & (I2C_FUNC_SMBUS_PEC | I2C_FUNC_I2C))) {
+ fprintf(stderr, "Warning: Adapter does "
+ "not seem to support PEC\n");
+ }
+
+ return 0;
+}
+
+int main(int argc, char *argv[])
+{
+ char *end;
+ int i, j, res, i2cbus, address, size, file;
+ int bank = 0, bankreg = 0x4E, old_bank = 0;
+ char filename[20];
+ int block[256], s_length = 0;
+ int pec = 0, even = 0;
+ int flags = 0;
+ int force = 0, yes = 0, version = 0;
+ const char *range = NULL;
+ int first = 0x00, last = 0xff;
+
+ /* handle (optional) flags first */
+ while (1+flags < argc && argv[1+flags][0] == '-') {
+ switch (argv[1+flags][1]) {
+ case 'V': version = 1; break;
+ case 'f': force = 1; break;
+ case 'r': range = argv[1+(++flags)]; break;
+ case 'y': yes = 1; break;
+ default:
+ fprintf(stderr, "Error: Unsupported option "
+ "\"%s\"!\n", argv[1+flags]);
+ help();
+ exit(1);
+ }
+ flags++;
+ }
+
+ if (version) {
+ fprintf(stderr, "i2cdump version %s\n", VERSION);
+ exit(0);
+ }
+
+ if (argc < flags + 2) {
+ fprintf(stderr, "Error: No i2c-bus specified!\n");
+ help();
+ exit(1);
+ }
+ i2cbus = lookup_i2c_bus(argv[flags+1]);
+ if (i2cbus < 0) {
+ help();
+ exit(1);
+ }
+
+ if (argc < flags + 3) {
+ fprintf(stderr, "Error: No address specified!\n");
+ help();
+ exit(1);
+ }
+ address = parse_i2c_address(argv[flags+2]);
+ if (address < 0) {
+ help();
+ exit(1);
+ }
+
+ if (argc < flags + 4) {
+ fprintf(stderr, "No size specified (using byte-data access)\n");
+ size = I2C_SMBUS_BYTE_DATA;
+ } else if (!strncmp(argv[flags+3], "b", 1)) {
+ size = I2C_SMBUS_BYTE_DATA;
+ pec = argv[flags+3][1] == 'p';
+ } else if (!strncmp(argv[flags+3], "w", 1)) {
+ size = I2C_SMBUS_WORD_DATA;
+ pec = argv[flags+3][1] == 'p';
+ } else if (!strncmp(argv[flags+3], "W", 1)) {
+ size = I2C_SMBUS_WORD_DATA;
+ even = 1;
+ } else if (!strncmp(argv[flags+3], "s", 1)) {
+ size = I2C_SMBUS_BLOCK_DATA;
+ pec = argv[flags+3][1] == 'p';
+ } else if (!strncmp(argv[flags+3], "c", 1)) {
+ size = I2C_SMBUS_BYTE;
+ pec = argv[flags+3][1] == 'p';
+ } else if (!strcmp(argv[flags+3], "i"))
+ size = I2C_SMBUS_I2C_BLOCK_DATA;
+ else {
+ fprintf(stderr, "Error: Invalid mode!\n");
+ help();
+ exit(1);
+ }
+
+ if (argc > flags + 4) {
+ bank = strtol(argv[flags+4], &end, 0);
+ if (*end || size == I2C_SMBUS_I2C_BLOCK_DATA) {
+ fprintf(stderr, "Error: Invalid bank number!\n");
+ help();
+ exit(1);
+ }
+ if ((size == I2C_SMBUS_BYTE_DATA || size == I2C_SMBUS_WORD_DATA)
+ && (bank < 0 || bank > 15)) {
+ fprintf(stderr, "Error: bank out of range!\n");
+ help();
+ exit(1);
+ }
+ if (size == I2C_SMBUS_BLOCK_DATA
+ && (bank < 0 || bank > 0xff)) {
+ fprintf(stderr, "Error: block command out of range!\n");
+ help();
+ exit(1);
+ }
+
+ if (argc > flags + 5) {
+ bankreg = strtol(argv[flags+5], &end, 0);
+ if (*end || size == I2C_SMBUS_BLOCK_DATA) {
+ fprintf(stderr, "Error: Invalid bank register "
+ "number!\n");
+ help();
+ exit(1);
+ }
+ if (bankreg < 0 || bankreg > 0xff) {
+ fprintf(stderr, "Error: bank out of range "
+ "(0-0xff)!\n");
+ help();
+ exit(1);
+ }
+ }
+ }
+
+ /* Parse optional range string */
+ if (range) {
+ char *dash;
+
+ first = strtol(range, &dash, 0);
+ if (dash == range || *dash != '-'
+ || first < 0 || first > 0xff) {
+ fprintf(stderr, "Error: Invalid range parameter!\n");
+ exit(1);
+ }
+ last = strtol(++dash, &end, 0);
+ if (end == dash || *end != '\0'
+ || last < first || last > 0xff) {
+ fprintf(stderr, "Error: Invalid range parameter!\n");
+ exit(1);
+ }
+
+ /* Check mode constraints */
+ switch (size) {
+ case I2C_SMBUS_BYTE:
+ case I2C_SMBUS_BYTE_DATA:
+ break;
+ case I2C_SMBUS_WORD_DATA:
+ if (!even || (!(first%2) && last%2))
+ break;
+ /* Fall through */
+ default:
+ fprintf(stderr,
+ "Error: Range parameter not compatible with selected mode!\n");
+ exit(1);
+ }
+ }
+
+ file = open_i2c_dev(i2cbus, filename, 0);
+ if (file < 0
+ || check_funcs(file, size, pec)
+ || set_slave_addr(file, address, force))
+ exit(1);
+
+ if (pec) {
+ if (ioctl(file, I2C_PEC, 1) < 0) {
+ fprintf(stderr, "Error: Could not set PEC: %s\n",
+ strerror(errno));
+ exit(1);
+ }
+ }
+
+ if (!yes) {
+ fprintf(stderr, "WARNING! This program can confuse your I2C "
+ "bus, cause data loss and worse!\n");
+
+ fprintf(stderr, "I will probe file %s, address 0x%x, mode "
+ "%s\n", filename, address,
+ size == I2C_SMBUS_BLOCK_DATA ? "smbus block" :
+ size == I2C_SMBUS_I2C_BLOCK_DATA ? "i2c block" :
+ size == I2C_SMBUS_BYTE ? "byte consecutive read" :
+ size == I2C_SMBUS_BYTE_DATA ? "byte" : "word");
+ if (pec)
+ fprintf(stderr, "PEC checking enabled.\n");
+ if (even)
+ fprintf(stderr, "Only probing even register "
+ "addresses.\n");
+ if (bank) {
+ if (size == I2C_SMBUS_BLOCK_DATA)
+ fprintf(stderr, "Using command 0x%02x.\n",
+ bank);
+ else
+ fprintf(stderr, "Probing bank %d using bank "
+ "register 0x%02x.\n", bank, bankreg);
+ }
+ if (range) {
+ fprintf(stderr,
+ "Probe range limited to 0x%02x-0x%02x.\n",
+ first, last);
+ }
+
+ fprintf(stderr, "Continue? [Y/n] ");
+ fflush(stderr);
+ if (!user_ack(1)) {
+ fprintf(stderr, "Aborting on user request.\n");
+ exit(0);
+ }
+ }
+
+ /* See Winbond w83781d data sheet for bank details */
+ if (bank && size != I2C_SMBUS_BLOCK_DATA) {
+ res = i2c_smbus_read_byte_data(file, bankreg);
+ if (res >= 0) {
+ old_bank = res;
+ res = i2c_smbus_write_byte_data(file, bankreg,
+ bank | (old_bank & 0xf0));
+ }
+ if (res < 0) {
+ fprintf(stderr, "Error: Bank switching failed\n");
+ exit(1);
+ }
+ }
+
+ /* handle all but word data */
+ if (size != I2C_SMBUS_WORD_DATA || even) {
+ /* do the block transaction */
+ if (size == I2C_SMBUS_BLOCK_DATA
+ || size == I2C_SMBUS_I2C_BLOCK_DATA) {
+ unsigned char cblock[288];
+
+ if (size == I2C_SMBUS_BLOCK_DATA) {
+ res = i2c_smbus_read_block_data(file, bank,
+ cblock);
+ /* Remember returned block length for a nicer
+ display later */
+ s_length = res;
+ } else {
+ for (res = 0; res < 256; res += i) {
+ i = i2c_smbus_read_i2c_block_data(file,
+ res, 32, cblock + res);
+ if (i <= 0) {
+ res = i;
+ break;
+ }
+ }
+ }
+ if (res <= 0) {
+ fprintf(stderr, "Error: Block read failed, "
+ "return code %d\n", res);
+ exit(1);
+ }
+ if (res >= 256)
+ res = 256;
+ for (i = 0; i < res; i++)
+ block[i] = cblock[i];
+ if (size != I2C_SMBUS_BLOCK_DATA)
+ for (i = res; i < 256; i++)
+ block[i] = -1;
+ }
+
+ if (size == I2C_SMBUS_BYTE) {
+ res = i2c_smbus_write_byte(file, first);
+ if(res != 0) {
+ fprintf(stderr, "Error: Write start address "
+ "failed, return code %d\n", res);
+ exit(1);
+ }
+ }
+
+ printf(" 0 1 2 3 4 5 6 7 8 9 a b c d e f"
+ " 0123456789abcdef\n");
+ for (i = 0; i < 256; i+=16) {
+ if (size == I2C_SMBUS_BLOCK_DATA && i >= s_length)
+ break;
+ if (i/16 < first/16)
+ continue;
+ if (i/16 > last/16)
+ break;
+
+ printf("%02x: ", i);
+ for (j = 0; j < 16; j++) {
+ fflush(stdout);
+ /* Skip unwanted registers */
+ if (i+j < first || i+j > last) {
+ printf(" ");
+ if (size == I2C_SMBUS_WORD_DATA) {
+ printf(" ");
+ j++;
+ }
+ continue;
+ }
+
+ if (size == I2C_SMBUS_BYTE_DATA) {
+ block[i+j] = res =
+ i2c_smbus_read_byte_data(file, i+j);
+ } else if (size == I2C_SMBUS_WORD_DATA) {
+ res = i2c_smbus_read_word_data(file,
+ i+j);
+ if (res < 0) {
+ block[i+j] = res;
+ block[i+j+1] = res;
+ } else {
+ block[i+j] = res & 0xff;
+ block[i+j+1] = res >> 8;
+ }
+ } else if (size == I2C_SMBUS_BYTE) {
+ block[i+j] = res =
+ i2c_smbus_read_byte(file);
+ } else
+ res = block[i+j];
+
+ if (size == I2C_SMBUS_BLOCK_DATA
+ && i+j >= s_length) {
+ printf(" ");
+ } else if (res < 0) {
+ printf("XX ");
+ if (size == I2C_SMBUS_WORD_DATA)
+ printf("XX ");
+ } else {
+ printf("%02x ", block[i+j]);
+ if (size == I2C_SMBUS_WORD_DATA)
+ printf("%02x ", block[i+j+1]);
+ }
+ if (size == I2C_SMBUS_WORD_DATA)
+ j++;
+ }
+ printf(" ");
+
+ for (j = 0; j < 16; j++) {
+ if (size == I2C_SMBUS_BLOCK_DATA
+ && i+j >= s_length)
+ break;
+ /* Skip unwanted registers */
+ if (i+j < first || i+j > last) {
+ printf(" ");
+ continue;
+ }
+
+ res = block[i+j];
+ if (res < 0)
+ printf("X");
+ else
+ if ((res & 0xff) == 0x00
+ || (res & 0xff) == 0xff)
+ printf(".");
+ else
+ if ((res & 0xff) < 32
+ || (res & 0xff) >= 127)
+ printf("?");
+ else
+ printf("%c", res & 0xff);
+ }
+ printf("\n");
+ }
+ } else {
+ printf(" 0,8 1,9 2,a 3,b 4,c 5,d 6,e 7,f\n");
+ for (i = 0; i < 256; i+=8) {
+ if (i/8 < first/8)
+ continue;
+ if (i/8 > last/8)
+ break;
+
+ printf("%02x: ", i);
+ for (j = 0; j < 8; j++) {
+ /* Skip unwanted registers */
+ if (i+j < first || i+j > last) {
+ printf(" ");
+ continue;
+ }
+
+ res = i2c_smbus_read_word_data(file, i+j);
+ if (res < 0)
+ printf("XXXX ");
+ else
+ printf("%04x ", res & 0xffff);
+ }
+ printf("\n");
+ }
+ }
+ if (bank && size != I2C_SMBUS_BLOCK_DATA) {
+ i2c_smbus_write_byte_data(file, bankreg, old_bank);
+ }
+ exit(0);
+}
generated by cgit v1.2.3 (git 2.25.1) at 2024-11-21 18:01:56 +0000