jdk.dio.pwm

Class PWMChannelConfig

java.lang.Object

jdk.dio.pwm.PWMChannelConfig

All Implemented Interfaces:

DeviceConfig<PWMChannel>, DeviceConfig.HardwareAddressing

public class PWMChannelConfig
extends java.lang.Object
implements DeviceConfig<PWMChannel>, DeviceConfig.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 DeviceConfig.DEFAULT. Whether such default settings are supported is platform- as well as device driver-dependent.

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

See Also:

DeviceManager.open(DeviceConfig), DeviceManager.open(Class, DeviceConfig)

Nested Class Summary

Nested classes/interfaces inherited from interface jdk.dio.DeviceConfig

DeviceConfig.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 jdk.dio.DeviceConfig

DEFAULT

Constructor Summary

Constructors

Constructor and Description
PWMChannelConfig(int controllerNumber, int channelNumber, int idleState, int pulsePeriod, int pulseAlignment) Creates a new PWMChannelConfig with the specified hardware addressing information and type.
PWMChannelConfig(int controllerNumber, 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 controllerName, int channelNumber, int idleState, int pulsePeriod, int pulseAlignment) Creates a new PWMChannelConfig with the specified hardware addressing information and type.
PWMChannelConfig(java.lang.String controllerName, 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	getControllerName() Gets the configured controller name (such as its device file name on UNIX systems).
int	getControllerNumber() Gets the configured controller number (the PWM controller or generator number).
int	getIdleState() Gets the configured idle output state.
GPIOPin	getOutput() Gets the 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 controllerNumber,
                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:

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

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

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

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

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

Throws:

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

• controllerNumber 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 controllerNumber,
                int channelNumber,
                int idleState,
                int pulsePeriod,
                int pulseAlignment,
                GPIOPinConfig output)

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

Note that if the access modes (exclusive or shared) supported by the designated GPIO pin output are incompatible with those required by the underlying PWMChannel device or device driver, attempting to open the PWMChannel device using this configuration may result in a InvalidDeviceConfigException to be thrown.

Parameters:

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

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

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

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

pulseAlignment - the pulse alignment: ALIGN_CENTER, ALIGN_LEFT, ALIGN_RIGHT or DeviceConfig.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:

• controllerNumber 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 controllerName,
                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:

controllerName - the controller name (such as its device file name on UNIX systems).

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

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

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

pulseAlignment - the pulse alignment: ALIGN_CENTER, ALIGN_LEFT, ALIGN_RIGHT or DeviceConfig.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 controllerName is null.

PWMChannelConfig

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

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

Note that if the access modes (exclusive or shared) supported by the designated GPIO pin output are incompatible with those required by the underlying PWMChannel device or device driver, attempting to open the PWMChannel device using this configuration may result in a InvalidDeviceConfigException to be thrown.

Parameters:

controllerName - the controller name (such as its device file name on UNIX systems).

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

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

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

pulseAlignment - the pulse alignment: ALIGN_CENTER, ALIGN_LEFT, ALIGN_RIGHT or DeviceConfig.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 controllerName 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 DeviceConfig.DEFAULT.

getControllerNumber

public int getControllerNumber()

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

Specified by:

getControllerNumber in interface DeviceConfig.HardwareAddressing

Returns:

the controller number (a positive or zero integer) or DeviceConfig.DEFAULT.

getControllerName

public java.lang.String getControllerName()

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

Specified by:

getControllerName in interface DeviceConfig.HardwareAddressing

Returns:

the controllerName 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 output on which the pulses are to be generated.

A concurrent runtime change of the dynamic configuration parameters of the output (such as of its direction) may result in IOException being thrown by PWM operations.

Returns:

the output on which the pulses are to be generated; or null if the output is implicit or if this PWMChannelConfig instance is not associated to an actual PWMChannel instance.

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 DeviceConfig.DEFAULT.

getIdleState

public int getIdleState()

Gets the configured idle output state.

Returns:

the idle output state: : IDLE_STATE_HIGH, IDLE_STATE_LOW or DeviceConfig.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 DeviceConfig.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.