package system import ( "fmt" "log" "os" "syscall" "unsafe" ) const i2cDeviceDebug = false const ( // From /usr/include/linux/i2c-dev.h: // ioctl signals I2C_SLAVE = 0x0703 I2C_FUNCS = 0x0705 I2C_SMBUS = 0x0720 // Read/write markers I2C_SMBUS_READ = 1 I2C_SMBUS_WRITE = 0 // From /usr/include/linux/i2c.h: // Adapter functionality I2C_FUNC_SMBUS_READ_BYTE = 0x00020000 I2C_FUNC_SMBUS_WRITE_BYTE = 0x00040000 I2C_FUNC_SMBUS_READ_BYTE_DATA = 0x00080000 I2C_FUNC_SMBUS_WRITE_BYTE_DATA = 0x00100000 I2C_FUNC_SMBUS_READ_WORD_DATA = 0x00200000 I2C_FUNC_SMBUS_WRITE_WORD_DATA = 0x00400000 I2C_FUNC_SMBUS_READ_BLOCK_DATA = 0x01000000 I2C_FUNC_SMBUS_WRITE_BLOCK_DATA = 0x02000000 I2C_FUNC_SMBUS_READ_I2C_BLOCK = 0x04000000 // I2C-like block transfer with 1-byte reg. addr. I2C_FUNC_SMBUS_WRITE_I2C_BLOCK = 0x08000000 // I2C-like block transfer with 1-byte reg. addr. // Transaction types I2C_SMBUS_BYTE = 1 I2C_SMBUS_BYTE_DATA = 2 I2C_SMBUS_WORD_DATA = 3 I2C_SMBUS_PROC_CALL = 4 I2C_SMBUS_BLOCK_DATA = 5 I2C_SMBUS_I2C_BLOCK_BROKEN = 6 I2C_SMBUS_BLOCK_PROC_CALL = 7 /* SMBus 2.0 */ I2C_SMBUS_I2C_BLOCK_DATA = 8 /* SMBus 2.0 */ ) type i2cSmbusIoctlData struct { readWrite byte command byte protocol uint32 data unsafe.Pointer } type i2cDevice struct { location string file File funcs uint64 // adapter functionality mask sys systemCaller fs filesystem } // NewI2cDevice returns an io.ReadWriteCloser with the proper ioctrl given // an i2c bus location. func (a *Accesser) NewI2cDevice(location string) (*i2cDevice, error) { if location == "" { return nil, fmt.Errorf("the given character device location is empty") } d := &i2cDevice{ location: location, sys: a.sys, fs: a.fs, } return d, nil } // SetAddress sets the address of the i2c device to use. func (d *i2cDevice) SetAddress(address int) error { // for go vet false positives, see: https://github.com/golang/go/issues/41205 if err := d.syscallIoctl(I2C_SLAVE, unsafe.Pointer(uintptr(byte(address))), "Setting address"); err != nil { return err } return nil } // Close closes the character device file. func (d *i2cDevice) Close() error { if d.file != nil { return d.file.Close() } return nil } // ReadByte reads a byte from the current register of an i2c device. func (d *i2cDevice) ReadByte() (byte, error) { if err := d.queryFunctionality(I2C_FUNC_SMBUS_READ_BYTE, "read byte"); err != nil { return 0, err } var data uint8 = 0xFC // set value for debugging purposes err := d.smbusAccess(I2C_SMBUS_READ, 0, I2C_SMBUS_BYTE, unsafe.Pointer(&data)) return data, err } // ReadByteData reads a byte from the given register of an i2c device. func (d *i2cDevice) ReadByteData(reg uint8) (val uint8, err error) { if err := d.queryFunctionality(I2C_FUNC_SMBUS_READ_BYTE_DATA, "read byte data"); err != nil { return 0, err } var data uint8 = 0xFD // set value for debugging purposes err = d.smbusAccess(I2C_SMBUS_READ, reg, I2C_SMBUS_BYTE_DATA, unsafe.Pointer(&data)) return data, err } // ReadWordData reads a 16 bit value starting from the given register of an i2c device. func (d *i2cDevice) ReadWordData(reg uint8) (val uint16, err error) { if err := d.queryFunctionality(I2C_FUNC_SMBUS_READ_WORD_DATA, "read word data"); err != nil { return 0, err } var data uint16 = 0xFFFE // set value for debugging purposes err = d.smbusAccess(I2C_SMBUS_READ, reg, I2C_SMBUS_WORD_DATA, unsafe.Pointer(&data)) return data, err } // ReadBlockData fills the given buffer with reads starting from the given register of an i2c device. func (d *i2cDevice) ReadBlockData(reg uint8, data []byte) error { dataLen := len(data) if dataLen > 32 { return fmt.Errorf("Reading blocks larger than 32 bytes (%v) not supported", len(data)) } data[0] = 0xFF // set value for debugging purposes if err := d.queryFunctionality(I2C_FUNC_SMBUS_READ_I2C_BLOCK, "read block data"); err != nil { if i2cDeviceDebug { log.Printf("%s, use fallback\n", err.Error()) } return d.readBlockDataFallback(reg, data) } // set the first element with the data size buf := make([]byte, dataLen+1) buf[0] = byte(dataLen) copy(buf[1:], data) if err := d.smbusAccess(I2C_SMBUS_READ, reg, I2C_SMBUS_I2C_BLOCK_DATA, unsafe.Pointer(&buf[0])); err != nil { return err } // get data from buffer without first size element copy(data, buf[1:]) return nil } // WriteByte writes the given byte value to the current register of an i2c device. func (d *i2cDevice) WriteByte(val byte) error { if err := d.queryFunctionality(I2C_FUNC_SMBUS_WRITE_BYTE, "write byte"); err != nil { return err } return d.smbusAccess(I2C_SMBUS_WRITE, val, I2C_SMBUS_BYTE, nil) } // WriteByteData writes the given byte value to the given register of an i2c device. func (d *i2cDevice) WriteByteData(reg uint8, val uint8) error { if err := d.queryFunctionality(I2C_FUNC_SMBUS_WRITE_BYTE_DATA, "write byte data"); err != nil { return err } var data = val return d.smbusAccess(I2C_SMBUS_WRITE, reg, I2C_SMBUS_BYTE_DATA, unsafe.Pointer(&data)) } // WriteWordData writes the given 16 bit value starting from the given register of an i2c device. func (d *i2cDevice) WriteWordData(reg uint8, val uint16) error { if err := d.queryFunctionality(I2C_FUNC_SMBUS_WRITE_WORD_DATA, "write word data"); err != nil { return err } var data = val return d.smbusAccess(I2C_SMBUS_WRITE, reg, I2C_SMBUS_WORD_DATA, unsafe.Pointer(&data)) } // WriteBlockData writes the given buffer starting from the given register of an i2c device. func (d *i2cDevice) WriteBlockData(reg uint8, data []byte) error { dataLen := len(data) if dataLen > 32 { return fmt.Errorf("Writing blocks larger than 32 bytes (%v) not supported", len(data)) } if err := d.queryFunctionality(I2C_FUNC_SMBUS_WRITE_I2C_BLOCK, "write i2c block"); err != nil { if i2cDeviceDebug { log.Printf("%s, use fallback\n", err.Error()) } return d.writeBlockDataFallback(reg, data) } // set the first element with the data size buf := make([]byte, dataLen+1) buf[0] = byte(dataLen) copy(buf[1:], data) return d.smbusAccess(I2C_SMBUS_WRITE, reg, I2C_SMBUS_I2C_BLOCK_DATA, unsafe.Pointer(&buf[0])) } // WriteBytes writes the given buffer starting from the current register of an i2c device. func (d *i2cDevice) WriteBytes(data []byte) error { n, err := d.Write(data) if err != nil { return err } if n != len(data) { return fmt.Errorf("Write %v bytes to device by sysfs, expected %v", n, len(data)) } return nil } // Read implements the io.ReadWriteCloser method by direct I2C read operations. func (d *i2cDevice) Read(b []byte) (n int, err error) { // lazy initialization if d.file == nil { if d.file, err = d.fs.openFile(d.location, os.O_RDWR, os.ModeExclusive); err != nil { return 0, err } } return d.file.Read(b) } // Write implements the io.ReadWriteCloser method by direct I2C write operations. func (d *i2cDevice) Write(b []byte) (n int, err error) { // lazy initialization if d.file == nil { if d.file, err = d.fs.openFile(d.location, os.O_RDWR, os.ModeExclusive); err != nil { return 0, err } } return d.file.Write(b) } func (d *i2cDevice) smbusAccess(readWrite byte, command byte, protocol uint32, dataStart unsafe.Pointer) error { smbus := i2cSmbusIoctlData{ readWrite: readWrite, command: command, protocol: protocol, data: dataStart, // the reflected value of unsafePointer equals uintptr(dataStart), } if err := d.syscallIoctl(I2C_SMBUS, unsafe.Pointer(&smbus), "SMBus access"); err != nil { return err } return nil } func (d *i2cDevice) readBlockDataFallback(reg uint8, data []byte) error { if err := d.WriteBytes([]byte{reg}); err != nil { return err } if err := d.readAndCheckCount(data); err != nil { return err } return nil } func (d *i2cDevice) writeBlockDataFallback(reg uint8, data []byte) error { buf := make([]byte, len(data)+1) copy(buf[1:], data) buf[0] = reg if err := d.WriteBytes(buf); err != nil { return err } return nil } func (d *i2cDevice) readAndCheckCount(data []byte) error { n, err := d.Read(data) if err != nil { return err } if n != len(data) { return fmt.Errorf("Read %v bytes from device by sysfs, expected %v", n, len(data)) } return nil } func (d *i2cDevice) queryFunctionality(requested uint64, sender string) error { // lazy initialization if d.funcs == 0 { if err := d.syscallIoctl(I2C_FUNCS, unsafe.Pointer(&d.funcs), "Querying functionality"); err != nil { return err } } if d.funcs&requested == 0 { return fmt.Errorf("SMBus %s not supported", sender) } return nil } func (d *i2cDevice) syscallIoctl(signal uintptr, payload unsafe.Pointer, sender string) (err error) { // lazy initialization if d.file == nil { if d.file, err = d.fs.openFile(d.location, os.O_RDWR, os.ModeExclusive); err != nil { return err } } if _, _, errno := d.sys.syscall(syscall.SYS_IOCTL, d.file, signal, payload); errno != 0 { return fmt.Errorf("%s failed with syscall.Errno %v", sender, errno) } return nil }