com.diozero.devices

Class PCA9685

java.lang.Object

com.diozero.internal.provider.AbstractDeviceFactory

com.diozero.devices.PCA9685

All Implemented Interfaces:

DeviceFactoryInterface, PwmOutputDeviceFactoryInterface, Closeable, AutoCloseable

public class PCA9685
extends AbstractDeviceFactory
implements PwmOutputDeviceFactoryInterface

PCA9685 I2C-bus controlled 16-channel 12-bit PWM controller as used in the popular Adafruit PWM add-on board Datasheet: http://www.nxp.com/documents/data_sheet/PCA9685.pdf

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	PCA9685.PCA9685BoardPinInfo

Field Summary

Fields

Modifier and Type	Field and Description
static int	DEFAULT_ADDRESS

Fields inherited from class com.diozero.internal.provider.AbstractDeviceFactory

closed, deviceStates

Constructor Summary

Constructors

Constructor and Description
PCA9685(int pwmFrequency)
PCA9685(int controller, int pwmFrequency)
PCA9685(int controller, int address, int pwmFrequency)

Method Summary

Modifier and Type	Method and Description
void	close()
void	closeChannel(int channel)
PwmOutputDeviceInterface	createPwmOutputDevice(String key, PinInfo pinInfo, int pwmFrequency, float initialValue)
BoardPinInfo	getBoardPinInfo()
int	getBoardPwmFrequency()
String	getName()
float	getValue(int channel)
void	setBoardPwmFrequency(int pwmFrequency)
void	setServoPulseWidthMs(int channel, double pulseWidthMs) Set the pulse duration (micro-seconds) E.g.
void	setValue(int channel, float value) Set PWM output on a specific channel, value must be 0..1

Methods inherited from class com.diozero.internal.provider.AbstractDeviceFactory

createI2CKey, createPinKey, createSpiKey, deviceClosed, deviceOpened, getDevice, getDevice, isClosed, isDeviceOpened

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface com.diozero.internal.provider.PwmOutputDeviceFactoryInterface

provisionPwmOutputDevice

Methods inherited from interface com.diozero.internal.provider.DeviceFactoryInterface

createI2CKey, createPinKey, createSpiKey, deviceClosed, deviceOpened, getDevice, getDevice, isClosed, isDeviceOpened

Field Detail

DEFAULT_ADDRESS

public static final int DEFAULT_ADDRESS

See Also:

Constant Field Values

Constructor Detail

PCA9685

public PCA9685(int pwmFrequency)
        throws RuntimeIOException

Throws:

RuntimeIOException

PCA9685

public PCA9685(int controller,
               int pwmFrequency)
        throws RuntimeIOException

Throws:

RuntimeIOException

PCA9685

public PCA9685(int controller,
               int address,
               int pwmFrequency)
        throws RuntimeIOException

Throws:

RuntimeIOException

Method Detail

setServoPulseWidthMs

public void setServoPulseWidthMs(int channel,
                                 double pulseWidthMs)
                          throws RuntimeIOException

Set the pulse duration (micro-seconds) E.g. For TowerPro SG90 servo pulse width range = 500-2400 us TowerPro SG5010 servo pulse width range = 1ms-2ms

Parameters:

channel - PWM channel

pulseWidthMs - The desired pulse width in milli-seconds

Throws:

RuntimeIOException - if an I/O error occurs

getName

public String getName()

Specified by:

getName in interface DeviceFactoryInterface

close

public void close()
           throws RuntimeIOException

Specified by:

close in interface DeviceFactoryInterface

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable

Overrides:

close in class AbstractDeviceFactory

Throws:

RuntimeIOException

closeChannel

public void closeChannel(int channel)
                  throws RuntimeIOException

Throws:

RuntimeIOException

createPwmOutputDevice

public PwmOutputDeviceInterface createPwmOutputDevice(String key,
                                                      PinInfo pinInfo,
                                                      int pwmFrequency,
                                                      float initialValue)
                                               throws RuntimeIOException

Specified by:

createPwmOutputDevice in interface PwmOutputDeviceFactoryInterface

Throws:

RuntimeIOException

getValue

public float getValue(int channel)
               throws RuntimeIOException

Throws:

RuntimeIOException

setValue

public void setValue(int channel,
                     float value)
              throws RuntimeIOException

Set PWM output on a specific channel, value must be 0..1

Parameters:

channel - PWM channel

value - Must be 0..1

Throws:

RuntimeIOException - if an I/O error occurs

getBoardPwmFrequency

public int getBoardPwmFrequency()

Specified by:

getBoardPwmFrequency in interface PwmOutputDeviceFactoryInterface

setBoardPwmFrequency

public void setBoardPwmFrequency(int pwmFrequency)

Specified by:

setBoardPwmFrequency in interface PwmOutputDeviceFactoryInterface

getBoardPinInfo

public BoardPinInfo getBoardPinInfo()

Specified by:

getBoardPinInfo in interface DeviceFactoryInterface