com.oracle.deviceaccess.pwm

Class PWMChannelConfig

java.lang.Object

com.oracle.deviceaccess.pwm.PWMChannelConfig

All Implemented Interfaces:

PeripheralConfig<PWMChannel>, PeripheralConfig.HardwareAddressing

public class PWMChannelConfig
extends java.lang.Object
implements PeripheralConfig<PWMChannel>, PeripheralConfig.HardwareAddressing

The PWMChannelConfig class encapsulates the hardware addressing information, and static and dynamic configuration parameters of a PWM channel.

Some hardware addressing parameter, and static and dynamic configuration parameters may be set to PeripheralConfig.DEFAULT. Whether such default settings are supported is platform- as well as peripheral driver-dependent.

An instance of PWMChannelConfig can be passed to the PeripheralManager.open(PeripheralConfig) or PeripheralManager.open(Class, PeripheralConfig) method to open the designated PWM channel with the specified configuration. A PeripheralConfigInvalidException is thrown when attempting to open a peripheral device with an invalid or unsupported configuration.

See Also:

PeripheralManager.open(PeripheralConfig), PeripheralManager.open(Class, PeripheralConfig)

Nested Class Summary

Nested classes/interfaces inherited from interface com.oracle.deviceaccess.PeripheralConfig

PeripheralConfig.HardwareAddressing

Field Summary

Fields

Modifier and Type	Field and Description
static int	ALIGN_CENTER Center alignement.
static int	ALIGN_LEFT Left alignement.
static int	ALIGN_RIGHT Right alignement.
static int	IDLE_STATE_HIGH High idle state.
static int	IDLE_STATE_LOW Low idle state.

Fields inherited from interface com.oracle.deviceaccess.PeripheralConfig

DEFAULT

Constructor Summary

Constructors

Constructor and Description
PWMChannelConfig(int deviceNumber, int channelNumber, int idleState, int pulsePeriod, int pulseAlignment) Creates a new PWMChannelConfig with the specified hardware addressing information and type.
PWMChannelConfig(int deviceNumber, int channelNumber, int idleState, int pulsePeriod, int pulseAlignment, GPIOPin output) Creates a new PWMChannelConfig the specified hardware addressing information, type and GPIO pin output.
PWMChannelConfig(int deviceNumber, int channelNumber, int idleState, int pulsePeriod, int pulseAlignment, GPIOPinConfig output) Creates a new PWMChannelConfig the specified hardware addressing information, type and GPIO pin output.
PWMChannelConfig(java.lang.String deviceName, int channelNumber, int idleState, int pulsePeriod, int pulseAlignment) Creates a new PWMChannelConfig with the specified hardware addressing information and type.
PWMChannelConfig(java.lang.String deviceName, int channelNumber, int idleState, int pulsePeriod, int pulseAlignment, GPIOPin output) Creates a new PWMChannelConfig the specified hardware addressing information, type and GPIO pin output.
PWMChannelConfig(java.lang.String deviceName, int channelNumber, int idleState, int pulsePeriod, int pulseAlignment, GPIOPinConfig output) Creates a new PWMChannelConfig the specified hardware addressing information, type and GPIO pin output.

Method Summary

Methods

Modifier and Type	Method and Description
boolean	equals(java.lang.Object obj) Checks two PWMChannelConfig objects for equality.
int	getChannelNumber() Gets the configured PWM channel number.
java.lang.String	getDeviceName() Gets the configured device name (such as to its device file name on UNIX systems).
int	getDeviceNumber() Gets the configured device number (the PWM controller or generator number).
int	getIdleState() Gets the configured idle output state.
GPIOPin	getOutput() Gets the configured output on which the pulses are to be generated.
GPIOPinConfig	getOutputConfig() Gets the configured output configuration on which the pulses are to be generated.
int	getPulseAlignment() Gets the configured pulse alignment.
int	getPulsePeriod() Gets the configured default/initial pulse period (in microseconds).
int	hashCode() Returns the hash code value for this object.

Methods inherited from class java.lang.Object

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

Field Detail

IDLE_STATE_HIGH

public static final int IDLE_STATE_HIGH

High idle state. The idle state is the state of the PWM output when no pulse is generated.

See Also:

Constant Field Values

IDLE_STATE_LOW

public static final int IDLE_STATE_LOW

Low idle state. The idle state is the state of the PWM output when no pulse is generated.

See Also:

Constant Field Values

ALIGN_CENTER

public static final int ALIGN_CENTER

Center alignement. The pulse is centered within the pulse period.

See Also:

Constant Field Values

ALIGN_LEFT

public static final int ALIGN_LEFT

Left alignement. The start of the pulse coincides with the start of the pulse period.

See Also:

Constant Field Values

ALIGN_RIGHT

public static final int ALIGN_RIGHT

Right alignement. The end of the pulse coincides with the end of the pulse period.

See Also:

Constant Field Values

Constructor Detail

PWMChannelConfig

public PWMChannelConfig(int deviceNumber,
                int channelNumber,
                int idleState,
                int pulsePeriod,
                int pulseAlignment)

Creates a new PWMChannelConfig with the specified hardware addressing information and type. The output of the PWM channel is implicit (such as a dedicated output pin).

Parameters:

deviceNumber - the hardware PWM controller (or generator)'s number (a positive or zero integer) or PeripheralConfig.DEFAULT.

channelNumber - the hardware PWM channel's number (a positive or zero integer) or PeripheralConfig.DEFAULT.

idleState - the output idle state: IDLE_STATE_HIGH, IDLE_STATE_LOW or PeripheralConfig.DEFAULT.

pulsePeriod - the default pulse period in microseconds (a positive integer) or PeripheralConfig.DEFAULT.

pulseAlignment - the pulse alignment: ALIGN_CENTER, ALIGN_LEFT, ALIGN_RIGHT or PeripheralConfig.DEFAULT.

Throws:

java.lang.IllegalArgumentException - if any of the following is true:

• deviceNumber is not in the defined range;
• channelNumber is not in the defined range;
• idleState is not in the defined range;
• pulsePeriod is not in the defined range.
• pulseAlignment is not in the defined range.

PWMChannelConfig

public PWMChannelConfig(int deviceNumber,
                int channelNumber,
                int idleState,
                int pulsePeriod,
                int pulseAlignment,
                GPIOPinConfig output)

Creates a new PWMChannelConfig the specified hardware addressing information, type and GPIO pin output.

Parameters:

deviceNumber - the hardware PWM controller (or generator)'s number (a positive or zero integer) or PeripheralConfig.DEFAULT.

channelNumber - the hardware PWM channel's number (a positive or zero integer) or PeripheralConfig.DEFAULT.

idleState - the output idle state: IDLE_STATE_HIGH, IDLE_STATE_LOW or PeripheralConfig.DEFAULT.

pulsePeriod - the default pulse period in microseconds (a positive integer) or PeripheralConfig.DEFAULT.

pulseAlignment - the pulse alignment: ALIGN_CENTER, ALIGN_LEFT, ALIGN_RIGHT or PeripheralConfig.DEFAULT.

output - the configuration of the output (a GPIO output pin) on which the pulses are to be generated.

Throws:

java.lang.IllegalArgumentException - if any of the following is true:

• deviceNumber is not in the defined range;
• channelNumber is not in the defined range;
• idleState is not in the defined range;
• pulsePeriod is not in the defined range.
• pulseAlignment is not in the defined range.
• if the provided GPIO pin is not configured for output.

java.lang.NullPointerException - if output is null.

PWMChannelConfig

public PWMChannelConfig(int deviceNumber,
                int channelNumber,
                int idleState,
                int pulsePeriod,
                int pulseAlignment,
                GPIOPin output)

Creates a new PWMChannelConfig the specified hardware addressing information, type and GPIO pin output.

Parameters:

deviceNumber - the hardware PWM controller (or generator)'s number (a positive or zero integer) or PeripheralConfig.DEFAULT.

channelNumber - the hardware PWM channel's number (a positive or zero integer) or PeripheralConfig.DEFAULT.

idleState - the output idle state: IDLE_STATE_HIGH, IDLE_STATE_LOW or PeripheralConfig.DEFAULT.

pulsePeriod - the default pulse period in microseconds (a positive integer) or PeripheralConfig.DEFAULT.

pulseAlignment - the pulse alignment: ALIGN_CENTER, ALIGN_LEFT, ALIGN_RIGHT or PeripheralConfig.DEFAULT.

output - the configuration of the output (a GPIO output pin) on which the pulses are to be generated.

Throws:

java.lang.IllegalArgumentException - if any of the following is true:

• deviceNumber is not in the defined range;
• channelNumber is not in the defined range;
• idleState is not in the defined range;
• pulsePeriod is not in the defined range.
• pulseAlignment is not in the defined range.
• if the provided GPIO pin is not configured for output.

java.lang.NullPointerException - if output is null.

PWMChannelConfig

public PWMChannelConfig(java.lang.String deviceName,
                int channelNumber,
                int idleState,
                int pulsePeriod,
                int pulseAlignment)

Creates a new PWMChannelConfig with the specified hardware addressing information and type. The output of the PWM channel is implicit (such as a dedicated output pin).

Parameters:

deviceName - the device name (such as to its device file name on UNIX systems).

channelNumber - the hardware PWM channel's number (a positive or zero integer) or PeripheralConfig.DEFAULT.

idleState - the output idle state: IDLE_STATE_HIGH, IDLE_STATE_LOW or PeripheralConfig.DEFAULT.

pulsePeriod - the default pulse period in microseconds (a positive integer) or PeripheralConfig.DEFAULT.

pulseAlignment - the pulse alignment: ALIGN_CENTER, ALIGN_LEFT, ALIGN_RIGHT or PeripheralConfig.DEFAULT.

Throws:

java.lang.IllegalArgumentException - if any of the following is true:

• channelNumber is not in the defined range;
• idleState is not in the defined range;
• pulsePeriod is not in the defined range.
• pulseAlignment is not in the defined range.

java.lang.NullPointerException - if deviceName is null.

PWMChannelConfig

public PWMChannelConfig(java.lang.String deviceName,
                int channelNumber,
                int idleState,
                int pulsePeriod,
                int pulseAlignment,
                GPIOPinConfig output)

Creates a new PWMChannelConfig the specified hardware addressing information, type and GPIO pin output.

Parameters:

deviceName - the device name (such as to its device file name on UNIX systems).

channelNumber - the hardware PWM channel's number (a positive or zero integer) or PeripheralConfig.DEFAULT.

idleState - the output idle state: IDLE_STATE_HIGH, IDLE_STATE_LOW or PeripheralConfig.DEFAULT.

pulsePeriod - the default pulse period in microseconds (a positive integer) or PeripheralConfig.DEFAULT.

pulseAlignment - the pulse alignment: ALIGN_CENTER, ALIGN_LEFT, ALIGN_RIGHT or PeripheralConfig.DEFAULT.

output - the configuration of the output (a GPIO output pin) on which the pulses are to be generated.

Throws:

java.lang.IllegalArgumentException - if any of the following is true:

• channelNumber is not in the defined range;
• idleState is not in the defined range;
• pulsePeriod is not in the defined range.
• pulseAlignment is not in the defined range.
• if the provided GPIO pin is not configured for output.

java.lang.NullPointerException - if deviceName or output is null.

PWMChannelConfig

public PWMChannelConfig(java.lang.String deviceName,
                int channelNumber,
                int idleState,
                int pulsePeriod,
                int pulseAlignment,
                GPIOPin output)

Creates a new PWMChannelConfig the specified hardware addressing information, type and GPIO pin output.

Parameters:

deviceName - the device name (such as to its device file name on UNIX systems).

channelNumber - the hardware PWM channel's number (a positive or zero integer) or PeripheralConfig.DEFAULT.

idleState - the output idle state: IDLE_STATE_HIGH, IDLE_STATE_LOW or PeripheralConfig.DEFAULT.

pulsePeriod - the default pulse period in microseconds (a positive integer) or PeripheralConfig.DEFAULT.

pulseAlignment - the pulse alignment: ALIGN_CENTER, ALIGN_LEFT, ALIGN_RIGHT or PeripheralConfig.DEFAULT.

output - the configuration of the output (a GPIO output pin) on which the pulses are to be generated.

Throws:

java.lang.IllegalArgumentException - if any of the following is true:

• channelNumber is not in the defined range;
• idleState is not in the defined range;
• pulsePeriod is not in the defined range.
• pulseAlignment is not in the defined range.
• if the provided GPIO pin is not configured for output.

java.lang.NullPointerException - if deviceName or output is null.

Method Detail

getChannelNumber

public int getChannelNumber()

Gets the configured PWM channel number.

Returns:

the hardware channel's number (a positive or zero integer) or PeripheralConfig.DEFAULT.

getDeviceNumber

public int getDeviceNumber()

Gets the configured device number (the PWM controller or generator number).

Specified by:

getDeviceNumber in interface PeripheralConfig.HardwareAddressing

Returns:

the device number (a positive or zero integer) or PeripheralConfig.DEFAULT.

getDeviceName

public java.lang.String getDeviceName()

Gets the configured device name (such as to its device file name on UNIX systems).

Specified by:

getDeviceName in interface PeripheralConfig.HardwareAddressing

Returns:

the deviceName or null.

getOutputConfig

public GPIOPinConfig getOutputConfig()

Gets the configured output configuration on which the pulses are to be generated.

Returns:

the output on which the pulses are to be generated; or null if the output is implicit.

getOutput

public GPIOPin getOutput()

Gets the configured output on which the pulses are to be generated.

Returns:

the output on which the pulses are to be generated; or null if the output is implicit.

getPulsePeriod

public int getPulsePeriod()

Gets the configured default/initial pulse period (in microseconds).

Returns:

the default/initial pulse period in microseconds (a positive integer) or PeripheralConfig.DEFAULT.

getIdleState

public int getIdleState()

Gets the configured idle output state.

Returns:

the idle output state: : IDLE_STATE_HIGH, IDLE_STATE_LOW or PeripheralConfig.DEFAULT.

getPulseAlignment

public int getPulseAlignment()

Gets the configured pulse alignment. The alignment of the pulse within the pulse period.

Returns:

the pulse alignment: ALIGN_CENTER, ALIGN_LEFT, ALIGN_RIGHT or PeripheralConfig.DEFAULT

hashCode

public int hashCode()

Returns the hash code value for this object.

Overrides:

hashCode in class java.lang.Object

Returns:

a hash code value for this object.

equals

public boolean equals(java.lang.Object obj)

Checks two PWMChannelConfig objects for equality.

Overrides:

equals in class java.lang.Object

Parameters:

obj - the object to test for equality with this object.

Returns:

true if obj is a PWMChannelConfig and has the same hardware addressing information and configuration parameter values as this PWMChannelConfig object.