Difference between revisions of "Component: PWM 16CH 12Bit (PCA9685) (General Output)"

Revision as of 15:23, 20 January 2023

Author	Matrix TSL
Version	1.0
Category	General Output

PWM 16CH 12Bit (PCA9685) component

The PCA9685 is an I²C-bus controlled 16-channel LED controller optimized for Red/Green/Blue/Amber (RGBA) color backlighting or Servo motor applications. Each output has its own 12-bit resolution (4096 steps) fixed frequency individual PWM controller that operates at a programmable frequency from a typical of 24 Hz to 1526 Hz. All outputs are set to the same PWM frequency. Up to 64 devices can be chained together on a single I²C-bus to provide up to 1024 individual PWM outputs.

Component Source Code

Please click here to download the component source project: FC_Comp_Source_PCA9685_16_Channel_PWM.fcfx

Please click here to view the component source code (Beta): FC_Comp_Source_PCA9685_16_Channel_PWM.fcfx

Detailed description

No detailed description exists yet for this component

Examples

No additional examples

Macro reference

	Reset
Sends a reset command to the PCA9685 chip over I2C
- VOID	Return

	SetPWMFrequency
Sets the PWM frequency for the entire chip, up to approx 1.6 KHz
- FLOAT	Frequency
Floating point frequency that we will attempt to match
- VOID	Return

	SetOutputMode
Sets the output mode of the PCA9685 to either open drain or push pull. Warning: LEDs with integrated zener diodes should only be driven in open drain mode.
- BOOL	Mode
0=OpenDrain, 1=Push/Pull
- VOID	Return

	Sleep
Puts the module into Sleep mode
- VOID	Return

	SetExternalClock
Sets EXTCLK pin to use the external clock
- BYTE	Prescale
External Clock Prescaler - Range: 3-255
- VOID	Return

	SetAddress
Allows a different I2C address to be specified allowing one component to control multiple PCA9685 modules.
- BYTE	Address
Range: 0x40 - 0x7F
- VOID	Return

	SetClockFrequency
Sets the current clock frequency, used for things like calculating the PWM frequency and Microsecond duty.
- ULONG	Clock

- VOID	Return

	GetClockFrequency
Returns the current clock frequency
- ULONG	Return

	WriteMicroseconds
Sets the PWM output of one of the PCA9685 pins based on the input microseconds, output is not precise
- BYTE	Output
One of the PWM output pins - Range: 0 to 15
- UINT	Microseconds
The number of Microseconds to turn the PWM output ON
- VOID	Return

	SetPWM
Sets the PWM output of one of the PCA9685 pins
- BYTE	Output
One of the PWM output pins - Range: 0 to 15
- UINT	On
At what point in the 4096-part cycle to turn the PWM output ON
- UINT	Off
At what point in the 4096-part cycle to turn the PWM output OFF
- VOID	Return

	Initialise
Sets up the I2C ready for communications to begin
- VOID	Return

	WakeUp
Wakes the module from Sleep mode
- VOID	Return

	SetPin
Sets pin without having to deal with on/off tick placement and properly handles a zero value as completely off and 4095 as completely on.
- BYTE	Output
One of the PWM output pins - Range: 0 to 15
- UINT	Duty
The number of ticks out of 4096 to be active
- BOOL	Invert
0=Normal, 1=Inverted
- VOID	Return

Property reference

	Properties
	Address
Module I2C Address. This setting can be overridden using the SetAddress component macro.
	Output Mode
Sets the output mode of the PCA9685 to either open drain or push pull. Warning: LEDs with integrated zener diodes should only be driven in open drain mode. Can be overridden using the SetOutputMode component macro.
	Clock Type
Configures the input clock source to the module.
	Clock Frequency
Frequency of the module. Internal oscillator defaults to 250000000 or 25MHz but can actually be anywhere from 23 to 27MHz. External clock frequency can be specified here up to a max value of 50000000 or 50MHz. This setting can be overridden using the SetClockFrequency component macro.
	Prescaler
External Clock Prescaler Range: 3 to 255
	Target PWM Frequency
The ideal PWM frequency we would like to generate on the output pins. Servo motors require an output frequency around 50Hz. LEDs require a mugh higher output frequency to avoid visible flicker.
	Actual PWM Frequency
The calculated actual PWM frequency available using the Clock Frequency and Prescaler
	PWM Resolution
Number of microseconds the PWM output can resolve to
	I2C Communications
	Channel
Channel selection
	Baud Select
Baud rate option selector
	Baud Rate
Baud rate to be used
	SDA
Pin used for SDA (data signal)
	SCL
Pin used for SCL (clock signal)
	Stop Delay
On older microcontroller devices there is a potential for the I2C hardware channel to lock up if there is not a 10ms delay between an I2C stop event and the next I2C start event. Most modern microcontrollers will not have a problem so this property can be disabled to speed up the I2C communications.
	Simulation
	Simulate Comms

==Macro reference==

	Reset
Sends a reset command to the PCA9685 chip over I2C
- VOID	Return

	SetPWMFrequency
Sets the PWM frequency for the entire chip, up to approx 1.6 KHz
- FLOAT	Frequency
Floating point frequency that we will attempt to match
- VOID	Return

	SetOutputMode
Sets the output mode of the PCA9685 to either open drain or push pull. Warning: LEDs with integrated zener diodes should only be driven in open drain mode.
- BOOL	Mode
0=OpenDrain, 1=Push/Pull
- VOID	Return

	Sleep
Puts the module into Sleep mode
- VOID	Return

	SetExternalClock
Sets EXTCLK pin to use the external clock
- BYTE	Prescale
External Clock Prescaler - Range: 3-255
- VOID	Return

	SetAddress
Allows a different I2C address to be specified allowing one component to control multiple PCA9685 modules.
- BYTE	Address
Range: 0x40 - 0x7F
- VOID	Return

	SetClockFrequency
Sets the current clock frequency, used for things like calculating the PWM frequency and Microsecond duty.
- ULONG	Clock

- VOID	Return

	GetClockFrequency
Returns the current clock frequency
- ULONG	Return

	WriteMicroseconds
Sets the PWM output of one of the PCA9685 pins based on the input microseconds, output is not precise
- BYTE	Output
One of the PWM output pins - Range: 0 to 15
- UINT	Microseconds
The number of Microseconds to turn the PWM output ON
- VOID	Return

	SetPWM
Sets the PWM output of one of the PCA9685 pins
- BYTE	Output
One of the PWM output pins - Range: 0 to 15
- UINT	On
At what point in the 4096-part cycle to turn the PWM output ON
- UINT	Off
At what point in the 4096-part cycle to turn the PWM output OFF
- VOID	Return

	Initialise
Sets up the I2C ready for communications to begin
- VOID	Return

	WakeUp
Wakes the module from Sleep mode
- VOID	Return

	SetPin
Sets pin without having to deal with on/off tick placement and properly handles a zero value as completely off and 4095 as completely on.
- BYTE	Output
One of the PWM output pins - Range: 0 to 15
- UINT	Duty
The number of ticks out of 4096 to be active
- BOOL	Invert
0=Normal, 1=Inverted
- VOID	Return

Property reference

	Properties
	Address
Module I2C Address. This setting can be overridden using the SetAddress component macro.
	Output Mode
Sets the output mode of the PCA9685 to either open drain or push pull. Warning: LEDs with integrated zener diodes should only be driven in open drain mode. Can be overridden using the SetOutputMode component macro.
	Clock Type
Configures the input clock source to the module.
	Clock Frequency
Frequency of the module. Internal oscillator defaults to 250000000 or 25MHz but can actually be anywhere from 23 to 27MHz. External clock frequency can be specified here up to a max value of 50000000 or 50MHz. This setting can be overridden using the SetClockFrequency component macro.
	Prescaler
External Clock Prescaler Range: 3 to 255
	Target PWM Frequency
The ideal PWM frequency we would like to generate on the output pins. Servo motors require an output frequency around 50Hz. LEDs require a mugh higher output frequency to avoid visible flicker.
	Actual PWM Frequency
The calculated actual PWM frequency available using the Clock Frequency and Prescaler
	PWM Resolution
Number of microseconds the PWM output can resolve to
	I2C Communications
	Channel
Channel selection
	Baud Select
Baud rate option selector
	Baud Rate
Baud rate to be used
	SDA
Pin used for SDA (data signal)
	SCL
Pin used for SCL (clock signal)
	Stop Delay
On older microcontroller devices there is a potential for the I2C hardware channel to lock up if there is not a 10ms delay between an I2C stop event and the next I2C start event. Most modern microcontrollers will not have a problem so this property can be disabled to speed up the I2C communications.
	Simulation
	Simulate Comms

==Macro reference==

	Reset
Sends a reset command to the PCA9685 chip over I2C
- VOID	Return

	SetPWMFrequency
Sets the PWM frequency for the entire chip, up to approx 1.6 KHz
- FLOAT	Frequency
Floating point frequency that we will attempt to match
- VOID	Return

	SetOutputMode
Sets the output mode of the PCA9685 to either open drain or push pull. Warning: LEDs with integrated zener diodes should only be driven in open drain mode.
- BOOL	Mode
0=OpenDrain, 1=Push/Pull
- VOID	Return

	Sleep
Puts the module into Sleep mode
- VOID	Return

	SetExternalClock
Sets EXTCLK pin to use the external clock
- BYTE	Prescale
External Clock Prescaler - Range: 3-255
- VOID	Return

	SetAddress
Allows a different I2C address to be specified allowing one component to control multiple PCA9685 modules.
- BYTE	Address
Range: 0x40 - 0x7F
- VOID	Return

	SetClockFrequency
Sets the current clock frequency, used for things like calculating the PWM frequency and Microsecond duty.
- ULONG	Clock

- VOID	Return

	GetClockFrequency
Returns the current clock frequency
- ULONG	Return

	WriteMicroseconds
Sets the PWM output of one of the PCA9685 pins based on the input microseconds, output is not precise
- BYTE	Output
One of the PWM output pins - Range: 0 to 15
- UINT	Microseconds
The number of Microseconds to turn the PWM output ON
- VOID	Return

	SetPWM
Sets the PWM output of one of the PCA9685 pins
- BYTE	Output
One of the PWM output pins - Range: 0 to 15
- UINT	On
At what point in the 4096-part cycle to turn the PWM output ON
- UINT	Off
At what point in the 4096-part cycle to turn the PWM output OFF
- VOID	Return

	Initialise
Sets up the I2C ready for communications to begin
- VOID	Return

	WakeUp
Wakes the module from Sleep mode
- VOID	Return

	SetPin
Sets pin without having to deal with on/off tick placement and properly handles a zero value as completely off and 4095 as completely on.
- BYTE	Output
One of the PWM output pins - Range: 0 to 15
- UINT	Duty
The number of ticks out of 4096 to be active
- BOOL	Invert
0=Normal, 1=Inverted
- VOID	Return

Property reference

	Properties
	Address
Module I2C Address. This setting can be overridden using the SetAddress component macro.
	Output Mode
Sets the output mode of the PCA9685 to either open drain or push pull. Warning: LEDs with integrated zener diodes should only be driven in open drain mode. Can be overridden using the SetOutputMode component macro.
	Clock Type
Configures the input clock source to the module.
	Clock Frequency
Frequency of the module. Internal oscillator defaults to 250000000 or 25MHz but can actually be anywhere from 23 to 27MHz. External clock frequency can be specified here up to a max value of 50000000 or 50MHz. This setting can be overridden using the SetClockFrequency component macro.
	Prescaler
External Clock Prescaler Range: 3 to 255
	Target PWM Frequency
The ideal PWM frequency we would like to generate on the output pins. Servo motors require an output frequency around 50Hz. LEDs require a mugh higher output frequency to avoid visible flicker.
	Actual PWM Frequency
The calculated actual PWM frequency available using the Clock Frequency and Prescaler
	PWM Resolution
Number of microseconds the PWM output can resolve to
	I2C Communications
	Channel
Channel selection
	Baud Select
Baud rate option selector
	Baud Rate
Baud rate to be used
	SDA
Pin used for SDA (data signal)
	SCL
Pin used for SCL (clock signal)
	Stop Delay
On older microcontroller devices there is a potential for the I2C hardware channel to lock up if there is not a 10ms delay between an I2C stop event and the next I2C start event. Most modern microcontrollers will not have a problem so this property can be disabled to speed up the I2C communications.
	Simulation
	Simulate Comms

Difference between revisions of "Component: PWM 16CH 12Bit (PCA9685) (General Output)"

Revision as of 15:23, 20 January 2023

Contents

PWM 16CH 12Bit (PCA9685) component

Component Source Code

Detailed description

Examples

Macro reference

Property reference

Property reference

Property reference

Navigation menu

Page actions

Page actions

Personal tools

Navigation

Search

Tools

@@ Line 16: / Line 16: @@
 ==Component Source Code==
+Please click here to download the component source project: [https://www.flowcode.co.uk/wikicopy/componentsource/FC_Comp_Source_PCA9685_16_Channel_PWM.fcfx FC_Comp_Source_PCA9685_16_Channel_PWM.fcfx]
 Please click here to view the component source code (Beta): [https://www.flowcode.co.uk/FlowchartView/?wfile=componentsource/FC_Comp_Source_PCA9685_16_Channel_PWM.fcfx FC_Comp_Source_PCA9685_16_Channel_PWM.fcfx]
 ==Detailed description==
@@ Line 42: / Line 46: @@
 ==Examples==
@@ Line 66: / Line 72: @@
 ==Macro reference==
+{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
+|-
+| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
+| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''Reset'''
+|-
+| colspan="2" | Sends a reset command to the PCA9685 chip over I2C&nbsp;
+|-
+|-
+| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-void-icon.png]] - VOID
+| width="90%" style="border-top: 2px solid #000;" | ''Return''
+|}
+{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
+|-
+| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
+| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''SetPWMFrequency'''
+|-
+| colspan="2" | Sets the PWM frequency for the entire chip, up to approx 1.6 KHz&nbsp;
+|-
+|-
+| width="10%" align="center" | [[File:Fc9-f32-icon.png]] - FLOAT
+| width="90%" | Frequency
+|-
+| colspan="2" | Floating point frequency that we will attempt to match&nbsp;
+|-
+| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-void-icon.png]] - VOID
+| width="90%" style="border-top: 2px solid #000;" | ''Return''
+|}
+{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
+|-
+| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
+| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''SetOutputMode'''
+|-
+| colspan="2" | Sets the output mode of the PCA9685 to either open drain or push pull. Warning: LEDs with integrated zener diodes should only be driven in open drain mode.&nbsp;
+|-
+|-
+| width="10%" align="center" | [[File:Fc9-bool-icon.png]] - BOOL
+| width="90%" | Mode
+|-
+| colspan="2" | 0=OpenDrain, 1=Push/Pull&nbsp;
+|-
+| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-void-icon.png]] - VOID
+| width="90%" style="border-top: 2px solid #000;" | ''Return''
+|}
+{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
+|-
+| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
+| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''Sleep'''
+|-
+| colspan="2" | Puts the module into Sleep mode&nbsp;
+|-
+|-
+| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-void-icon.png]] - VOID
+| width="90%" style="border-top: 2px solid #000;" | ''Return''
+|}
+{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
+|-
+| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
+| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''SetExternalClock'''
+|-
+| colspan="2" | Sets EXTCLK pin to use the external clock&nbsp;
+|-
+|-
+| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
+| width="90%" | Prescale
+|-
+| colspan="2" | External Clock Prescaler - Range: 3-255&nbsp;
+|-
+| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-void-icon.png]] - VOID
+| width="90%" style="border-top: 2px solid #000;" | ''Return''
+|}
+{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
+|-
+| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
+| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''SetAddress'''
+|-
+| colspan="2" | Allows a different I2C address to be specified allowing one component to control multiple PCA9685 modules.&nbsp;
+|-
+|-
+| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
+| width="90%" | Address
+|-
+| colspan="2" | Range: 0x40 - 0x7F&nbsp;
+|-
+| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-void-icon.png]] - VOID
+| width="90%" style="border-top: 2px solid #000;" | ''Return''
+|}
+{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
+|-
+| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
+| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''SetClockFrequency'''
+|-
+| colspan="2" | Sets the current clock frequency, used for things like calculating the PWM frequency and Microsecond duty.&nbsp;
+|-
+|-
+| width="10%" align="center" | [[File:Fc9-u32-icon.png]] - ULONG
+| width="90%" | Clock
+|-
+| colspan="2" | &nbsp;
+|-
+| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-void-icon.png]] - VOID
+| width="90%" style="border-top: 2px solid #000;" | ''Return''
+|}
+{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
+|-
+| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
+| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''GetClockFrequency'''
+|-
+| colspan="2" | Returns the current clock frequency&nbsp;
+|-
+|-
+| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-u32-icon.png]] - ULONG
+| width="90%" style="border-top: 2px solid #000;" | ''Return''
+|}
+{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
+|-
+| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
+| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''WriteMicroseconds'''
+|-
+| colspan="2" | Sets the PWM output of one of the PCA9685 pins based on the input microseconds, output is not precise&nbsp;
+|-
+|-
+| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
+| width="90%" | Output
+|-
+| colspan="2" | One of the PWM output pins - Range: 0 to 15&nbsp;
+|-
+| width="10%" align="center" | [[File:Fc9-u16-icon.png]] - UINT
+| width="90%" | Microseconds
+|-
+| colspan="2" | The number of Microseconds to turn the PWM output ON&nbsp;
+|-
+| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-void-icon.png]] - VOID
+| width="90%" style="border-top: 2px solid #000;" | ''Return''
+|}
+{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
+|-
+| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
+| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''SetPWM'''
+|-
+| colspan="2" | Sets the PWM output of one of the PCA9685 pins&nbsp;
+|-
+|-
+| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
+| width="90%" | Output
+|-
+| colspan="2" | One of the PWM output pins - Range: 0 to 15&nbsp;
+|-
+| width="10%" align="center" | [[File:Fc9-u16-icon.png]] - UINT
+| width="90%" | On
+|-
+| colspan="2" | At what point in the 4096-part cycle to turn the PWM output ON&nbsp;
+|-
+| width="10%" align="center" | [[File:Fc9-u16-icon.png]] - UINT
+| width="90%" | Off
+|-
+| colspan="2" | At what point in the 4096-part cycle to turn the PWM output OFF&nbsp;
+|-
+| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-void-icon.png]] - VOID
+| width="90%" style="border-top: 2px solid #000;" | ''Return''
+|}
+{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
+|-
+| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
+| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''Initialise'''
+|-
+| colspan="2" | Sets up the I2C ready for communications to begin&nbsp;
+|-
+|-
+| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-void-icon.png]] - VOID
+| width="90%" style="border-top: 2px solid #000;" | ''Return''
+|}
+{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
+|-
+| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
+| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''WakeUp'''
+|-
+| colspan="2" | Wakes the module from Sleep mode&nbsp;
+|-
+|-
+| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-void-icon.png]] - VOID
+| width="90%" style="border-top: 2px solid #000;" | ''Return''
+|}
+{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
+|-
+| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
+| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''SetPin'''
+|-
+| colspan="2" | Sets pin without having to deal with on/off tick placement and properly handles a zero value as completely off and 4095 as completely on.&nbsp;
+|-
+|-
+| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
+| width="90%" | Output
+|-
+| colspan="2" | One of the PWM output pins - Range: 0 to 15&nbsp;
+|-
+| width="10%" align="center" | [[File:Fc9-u16-icon.png]] - UINT
+| width="90%" | Duty
+|-
+| colspan="2" | The number of ticks out of 4096 to be active&nbsp;
+|-
+| width="10%" align="center" | [[File:Fc9-bool-icon.png]] - BOOL
+| width="90%" | Invert
+|-
+| colspan="2" | 0=Normal, 1=Inverted&nbsp;
+|-
+| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-void-icon.png]] - VOID
+| width="90%" style="border-top: 2px solid #000;" | ''Return''
+|}
+==Property reference==
+{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
+|-
+| width="10%" align="center" style="background-color:#D8C9D8;" | [[File:Fc9-prop-icon.png]]
+| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''Properties'''
+|-
+|-
+| width="10%" align="center" | [[File:Fc9-type-16-icon.png]]
+| width="90%" | Address
+|-
+| colspan="2" | Module I2C Address. This setting can be overridden using the SetAddress component macro.&nbsp;
+|-
+| width="10%" align="center" | [[File:Fc9-type-16-icon.png]]
+| width="90%" | Output Mode
+|-
+| colspan="2" | Sets the output mode of the PCA9685 to either open drain or push pull. Warning: LEDs with integrated zener diodes should only be driven in open drain mode. Can be overridden using the SetOutputMode component macro.&nbsp;
+|-
+| width="10%" align="center" | [[File:Fc9-type-16-icon.png]]
+| width="90%" | Clock Type
+|-
+| colspan="2" | Configures the input clock source to the module.&nbsp;
+|-
+| width="10%" align="center" | [[File:Fc9-type-21-icon.png]]
+| width="90%" | Clock Frequency
+|-
+| colspan="2" | Frequency of the module. Internal oscillator defaults to 250000000 or 25MHz but can actually be anywhere from 23 to 27MHz. External clock frequency can be specified here up to a max value of 50000000 or 50MHz. This setting can be overridden using the SetClockFrequency component macro.&nbsp;
+|-
+| width="10%" align="center" | [[File:Fc9-type-21-icon.png]]
+| width="90%" | Prescaler
+|-
+| colspan="2" | External Clock Prescaler Range: 3 to 255&nbsp;
+|-
+| width="10%" align="center" | [[File:Fc9-type-15-icon.png]]
+| width="90%" | Target PWM Frequency
+|-
+| colspan="2" | The ideal PWM frequency we would like to generate on the output pins. Servo motors require an output frequency around 50Hz. LEDs require a mugh higher output frequency to avoid visible flicker.&nbsp;
+|-
+| width="10%" align="center" | [[File:Fc9-type-15-icon.png]]
+| width="90%" | Actual PWM Frequency
+|-
+| colspan="2" | The calculated actual PWM frequency available using the Clock Frequency and Prescaler&nbsp;
+|-
+| width="10%" align="center" | [[File:Fc9-type-15-icon.png]]
+| width="90%" | PWM Resolution
+|-
+| colspan="2" | Number of microseconds the PWM output can resolve to&nbsp;
+|-
+| width="10%" align="center" style="background-color:#EAE1EA;" | [[File:Fc9-conn-icon.png]]
+| width="90%" style="background-color:#EAE1EA; color:#4B008D;" | I2C Communications
+|-
+|-
+| width="10%" align="center" | [[File:Fc9-type-16-icon.png]]
+| width="90%" | Channel
+|-
+| colspan="2" | Channel selection&nbsp;
+|-
+| width="10%" align="center" | [[File:Fc9-type-16-icon.png]]
+| width="90%" | Baud Select
+|-
+| colspan="2" | Baud rate option selector&nbsp;
+|-
+| width="10%" align="center" | [[File:Fc9-type-14-icon.png]]
+| width="90%" | Baud Rate
+|-
+| colspan="2" | Baud rate to be used&nbsp;
+|-
+| width="10%" align="center" | [[File:Fc9-type-5-icon.png]]
+| width="90%" | SDA
+|-
+| colspan="2" | Pin used for SDA (data signal)&nbsp;
+|-
+| width="10%" align="center" | [[File:Fc9-type-5-icon.png]]
+| width="90%" | SCL
+|-
+| colspan="2" | Pin used for SCL (clock signal)&nbsp;
+|-
+| width="10%" align="center" | [[File:Fc9-type-7-icon.png]]
+| width="90%" | Stop Delay
+|-
+| colspan="2" | On older microcontroller devices there is a potential for the I2C hardware channel to lock up if there is not  a 10ms delay between an I2C stop event and the next I2C start event.  Most modern microcontrollers will not have a problem so this property can be disabled to speed up the  I2C communications. &nbsp;
+|-
+| width="10%" align="center" style="background-color:#EAE1EA;" | [[File:Fc9-conn-icon.png]]
+| width="90%" style="background-color:#EAE1EA; color:#4B008D;" | Simulation
+|-
+|-
+| width="10%" align="center" | [[File:Fc9-type-7-icon.png]]
+| width="90%" | Simulate Comms
+|-
+| colspan="2" | &nbsp;
+|}==Macro reference==
 {| class="wikitable" style="width:60%; background-color:#FFFFFF;"