The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

Device::SMBus - Perl interface for smbus using libi2c-dev library.

VERSION

version 1.04

SYNOPSIS

   use Device::SMBus;
   $dev = Device::SMBus->new(
     I2CBusDevicePath => '/dev/i2c-1',
     I2CDeviceAddress => 0x1e,
   );
   print $dev->readByteData(0x20);

DESCRIPTION

This is a perl interface to smbus interface using libi2c-dev library.

Prerequisites:

  • sudo apt-get install libi2c-dev i2c-tools build-essential

Enabling the I2C on a Raspberry Pi:

You will need to comment out the driver from the blacklist. currently the I2C driver isn't being loaded.

     sudo vim /etc/modprobe.d/raspi-blacklist.conf

Replace this line

     blacklist i2c-bcm2708

with this

     #blacklist i2c-bcm2708

You now need to edit the modules conf file.

     sudo vim /etc/modules

Add these two lines;

     i2c-dev
     i2c-bcm2708

Now run this command(replace 1 with 0 for older model Pi)

     sudo i2cdetect -y 1

you should now see the addresses of the i2c devices connected to your i2c bus

ATTRIBUTES

I2CBusDevicePath

Device path of the I2C Device.

 * On Raspberry Pi Model A this would usually be /dev/i2c-0 if you are using the default pins.
 * On Raspberry Pi Model B this would usually be /dev/i2c-1 if you are using the default pins.

I2CDeviceAddress

This is the Address of the device on the I2C bus, this is usually available in the device Datasheet.

 * for /dev/i2c-0 look at output of `sudo i2cdetect -y 0' 
 * for /dev/i2c-1 look at output of `sudo i2cdetect -y 1' 

METHODS

fileError

returns IO::Handle->error() for the device handle since the last clearerr

writeQuick

$self->writeQuick($value)

readByte

$self->readByte()

writeByte

$self->writeByte()

readByteData

$self->readByteData($register_address)

writeByteData

$self->writeByteData($register_address,$value)

readNBytes

$self->readNBytes($lowest_byte_address, $number_of_bytes);

Read together N bytes of Data in linear register order. i.e. to read from 0x28,0x29,0x2a

$self->readNBytes(0x28,3);

readWordData

$self->readWordData($register_address)

writeWordData

$self->writeWordData($register_address,$value)

processCall

$self->processCall($register_address,$value)

DEMOLISH

Destructor

CONSTANTS

I2C_SLAVE

USAGE

  • This module provides a simplified object oriented interface to the libi2c-dev library for accessing electronic peripherals connected on the I2C bus. It uses Moose.

see ALSO

SUPPORT

Bugs / Feature Requests

Please report any bugs or feature requests through github at https://github.com/shantanubhadoria/device-smbus/issues. You will be notified automatically of any progress on your issue.

Source Code

This is open source software. The code repository is available for public review and contribution under the terms of the license.

https://github.com/shantanubhadoria/device-smbus

  git clone git://github.com/shantanubhadoria/device-smbus.git

AUTHOR

Shantanu Bhadoria <shantanu at cpan dott org>

CONTRIBUTORS

  • Neil Bowers <neil@bowers.com>

  • Shantanu <shantanu@cpan.org>

  • Shantanu Bhadoria <shantanu.bhadoria@gmail.com>

  • Shantanu Bhadoria <shantanu@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2013 by Shantanu Bhadoria.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.