Commit | Line | Data |
---|---|---|
c3bc4cae BW |
1 | Kernel driver max6875 |
2 | ===================== | |
3 | ||
4 | Supported chips: | |
089bd866 JD |
5 | * Maxim MAX6874, MAX6875 |
6 | Prefix: 'max6875' | |
93ffa435 | 7 | Addresses scanned: None (see below) |
089bd866 | 8 | Datasheet: |
c3bc4cae BW |
9 | http://pdfserv.maxim-ic.com/en/ds/MAX6874-MAX6875.pdf |
10 | ||
11 | Author: Ben Gardner <bgardner@wabtec.com> | |
12 | ||
13 | ||
c3bc4cae BW |
14 | Description |
15 | ----------- | |
16 | ||
089bd866 | 17 | The Maxim MAX6875 is an EEPROM-programmable power-supply sequencer/supervisor. |
c3bc4cae BW |
18 | It provides timed outputs that can be used as a watchdog, if properly wired. |
19 | It also provides 512 bytes of user EEPROM. | |
20 | ||
089bd866 | 21 | At reset, the MAX6875 reads the configuration EEPROM into its configuration |
c3bc4cae BW |
22 | registers. The chip then begins to operate according to the values in the |
23 | registers. | |
24 | ||
089bd866 JD |
25 | The Maxim MAX6874 is a similar, mostly compatible device, with more intputs |
26 | and outputs: | |
089bd866 JD |
27 | vin gpi vout |
28 | MAX6874 6 4 8 | |
29 | MAX6875 4 3 5 | |
30 | ||
93ffa435 | 31 | See the datasheet for more information. |
c3bc4cae BW |
32 | |
33 | ||
34 | Sysfs entries | |
35 | ------------- | |
36 | ||
93ffa435 | 37 | eeprom - 512 bytes of user-defined EEPROM space. |
c3bc4cae BW |
38 | |
39 | ||
40 | General Remarks | |
41 | --------------- | |
42 | ||
93ffa435 | 43 | Valid addresses for the MAX6875 are 0x50 and 0x52. |
44 | Valid addresses for the MAX6874 are 0x50, 0x52, 0x54 and 0x56. | |
45 | The driver does not probe any address, so you must force the address. | |
46 | ||
47 | Example: | |
48 | $ modprobe max6875 force=0,0x50 | |
49 | ||
50 | The MAX6874/MAX6875 ignores address bit 0, so this driver attaches to multiple | |
51 | addresses. For example, for address 0x50, it also reserves 0x51. | |
bd8d421f | 52 | The even-address instance is called 'max6875', the odd one is 'dummy'. |
93ffa435 | 53 | |
54 | ||
55 | Programming the chip using i2c-dev | |
56 | ---------------------------------- | |
57 | ||
58 | Use the i2c-dev interface to access and program the chips. | |
0283fe6c | 59 | Reads and writes are performed differently depending on the address range. |
93ffa435 | 60 | |
61 | The configuration registers are at addresses 0x00 - 0x45. | |
62 | Use i2c_smbus_write_byte_data() to write a register and | |
63 | i2c_smbus_read_byte_data() to read a register. | |
64 | The command is the register number. | |
65 | ||
66 | Examples: | |
67 | To write a 1 to register 0x45: | |
68 | i2c_smbus_write_byte_data(fd, 0x45, 1); | |
69 | ||
70 | To read register 0x45: | |
71 | value = i2c_smbus_read_byte_data(fd, 0x45); | |
72 | ||
73 | ||
74 | The configuration EEPROM is at addresses 0x8000 - 0x8045. | |
75 | The user EEPROM is at addresses 0x8100 - 0x82ff. | |
76 | ||
77 | Use i2c_smbus_write_word_data() to write a byte to EEPROM. | |
78 | ||
79 | The command is the upper byte of the address: 0x80, 0x81, or 0x82. | |
80 | The data word is the lower part of the address or'd with data << 8. | |
81 | cmd = address >> 8; | |
82 | val = (address & 0xff) | (data << 8); | |
83 | ||
84 | Example: | |
85 | To write 0x5a to address 0x8003: | |
86 | i2c_smbus_write_word_data(fd, 0x80, 0x5a03); | |
87 | ||
88 | ||
89 | Reading data from the EEPROM is a little more complicated. | |
90 | Use i2c_smbus_write_byte_data() to set the read address and then | |
91 | i2c_smbus_read_byte() or i2c_smbus_read_i2c_block_data() to read the data. | |
92 | ||
93 | Example: | |
94 | To read data starting at offset 0x8100, first set the address: | |
95 | i2c_smbus_write_byte_data(fd, 0x81, 0x00); | |
96 | ||
97 | And then read the data | |
98 | value = i2c_smbus_read_byte(fd); | |
99 | ||
100 | or | |
101 | ||
4b2643d7 | 102 | count = i2c_smbus_read_i2c_block_data(fd, 0x84, 16, buffer); |
93ffa435 | 103 | |
104 | The block read should read 16 bytes. | |
105 | 0x84 is the block read command. | |
106 | ||
107 | See the datasheet for more details. | |
c3bc4cae | 108 |