Lmpacent at 15:34, 15 April 2026

2026-04-15T15:34:14Z

← Older revision		Revision as of 15:34, 15 April 2026
Line 1:		Line 1:
			[[Category:IntroGuide]]
			{{#seo:\|keywords=Addressable LED}}
	{{#seo:\|description=Get started with your Addressable LED Phidget}}		{{#seo:\|description=Get started with your Addressable LED Phidget}}
	~~[[Category:IntroGuide]]~~
	<div class="nonumtoc">		<div class="nonumtoc">
	<div class="toclimit-4">		<div class="toclimit-4">

Mparadis at 20:27, 27 January 2026

2026-01-27T20:27:56Z

← Older revision		Revision as of 20:27, 27 January 2026
Line 17:		Line 17:


	[[Image:LED0100_ControlPanelExample2.jpg\|center\|link=https://~~wwwdev.int~~.phidgets.com/docs/images/3/3e/LED0100_ControlPanelExample2.jpg]]		[[Image:LED0100_ControlPanelExample2.jpg\|center\|link=https://cdn.phidgets.com/docs/images/3/3e/LED0100_ControlPanelExample2.jpg]]


Line 28:		Line 28:
	==Configuration==		==Configuration==
	===Color Order===		===Color Order===
	[[Image:Ledarray_colororder_addressableLED.png\|thumb\|400px\|link=https://~~wwwdev.int~~.phidgets.com/docs/images/1/19/Ledarray_colororder_addressableLED.png\|<center>Illustration of a RGBW Addressable LED<center>]]		[[Image:Ledarray_colororder_addressableLED.png\|thumb\|400px\|link=https://cdn.phidgets.com/docs/images/1/19/Ledarray_colororder_addressableLED.png\|<center>Illustration of a RGBW Addressable LED<center>]]

	Addressable LEDs consist of red, green, blue, and sometimes white LEDs, as shown in the illustration on the right.		Addressable LEDs consist of red, green, blue, and sometimes white LEDs, as shown in the illustration on the right.
Line 76:		Line 76:


	[[Image:Ledarray_ledarraycolor_selector.jpg\|center\|link=https://~~wwwdev.int~~.phidgets.com/docs/images/9/92/Ledarray_ledarraycolor_selector.jpg]]		[[Image:Ledarray_ledarraycolor_selector.jpg\|center\|link=https://cdn.phidgets.com/docs/images/9/92/Ledarray_ledarraycolor_selector.jpg]]


Line 91:		Line 91:
	This pattern will repeat if it is shorter than the total number of LEDs being controlled, as defined by the start and end addresses. For example, if the start address is set to 0 and the end address to 7, we would see the following result:		This pattern will repeat if it is shorter than the total number of LEDs being controlled, as defined by the start and end addresses. For example, if the start address is set to 0 and the end address to 7, we would see the following result:

	[[Image:ledarray_ledpattern_bluegreen4.png\|center\|800px\|link=https://~~wwwdev.int~~.phidgets.com/docs/images/7/77/Ledarray_ledpattern_bluegreen4.png]]		[[Image:ledarray_ledpattern_bluegreen4.png\|center\|800px\|link=https://cdn.phidgets.com/docs/images/7/77/Ledarray_ledpattern_bluegreen4.png]]

	Conversely, if the pattern is longer than the total number of LEDs being controlled, it will be truncated.		Conversely, if the pattern is longer than the total number of LEDs being controlled, it will be truncated.

Mparadis: Created page with "{{#seo:|description=Get started with your Addressable LED Phidget}} Category:IntroGuide

=Introduction= This guide will provide information about the LEDArray API to get you up and running with your new Addressable LED Phidget. =LEDArray API Overview= ==Phidget Control Panel== After wiring your Addressable LED Phidget using the Quick Start Guide on the product page, we recommend opening the [https://www.phidgets.com/doc..."

2026-01-27T20:24:48Z

Created page with "{{#seo:|description=Get started with your Addressable LED Phidget}} Category:IntroGuide <div class="nonumtoc"> <div class="toclimit-4"> =Introduction= This guide will provide information about the LEDArray API to get you up and running with your new Addressable LED Phidget. =LEDArray API Overview= ==Phidget Control Panel== After wiring your Addressable LED Phidget using the Quick Start Guide on the product page, we recommend opening the [https://www.phidgets.com/doc..."

New page

{{#seo:|description=Get started with your Addressable LED Phidget}}
[[Category:IntroGuide]]
<div class="nonumtoc">
<div class="toclimit-4">
=Introduction=
This guide will provide information about the LEDArray API to get you up and running with your new Addressable LED Phidget.

=LEDArray API Overview=
==Phidget Control Panel==
After wiring your Addressable LED Phidget using the Quick Start Guide on the product page, we recommend opening the [https://www.phidgets.com/docs/Phidget_Control_Panel Phidget Control Panel] on a Windows computer to experiment with key features.

[[Image:LED0100_ControlPanel.png|center|link=]]

When the Addressable LED Phidget is plugged in via USB or VINT, it will appear up on the Phidget Control Panel device list as shown above. Double-click on the entry to view the program.

[[Image:LED0100_ControlPanelExample2.jpg|center|link=https://wwwdev.int.phidgets.com/docs/images/3/3e/LED0100_ControlPanelExample2.jpg]]

After opening the program, you will see the screen shown above. The program is split into multiple sections to help you get familiar with your controller.
#Phidget Info
#Configuration
#Basic/Advanced Tabs
In this guide, we will focus on the areas that contain important information about controlling your LEDs. For information about the Phidget Info section, and the Phidget Control Panel in general, visit our [https://www.phidgets.com/docs/Phidget_Control_Panel Phidget Control Panel] Page.

==Configuration==
===Color Order===
[[Image:Ledarray_colororder_addressableLED.png|thumb|400px|link=https://wwwdev.int.phidgets.com/docs/images/1/19/Ledarray_colororder_addressableLED.png|<center>Illustration of a RGBW Addressable LED<center>]]

Addressable LEDs consist of red, green, blue, and sometimes white LEDs, as shown in the illustration on the right.

To control these LEDs, the LED chip must receive data from the Addressable LED Phidget in a specific order. The most common sequences are:
* RGB
* GRB
* RGBW
* GRBW

Refer to the product page or datasheet of your addressable LEDs to determine which sequence is used, and configure your controller accordingly using this property.

===Gamma===
The brightness of an LED increases linearly with current, however, the human eye perceives this brightness in a non-linear fashion. The Addressable LED Phidget includes built-in gamma correction to compensate for this.

The default value of this property is 2.2, which matches most computer displays.

===Brightness===
Apply a brightness value to all LEDs.

====Other Considerations====
Increasing the brightness of your LEDs will increase their current draw. Ensure you are using an appropriately sized power supply.

===PowerEnabled===
Control the power to your LEDs with this property.

====Other Considerations====
If an [[#Over Current|Over Current]] error event occurs, you must toggle Power Enabled to resume operation.

===Clear===
This will turn off all LEDs. It will also stop any [[#Animations|animations]].

==Basic Tab==
The basic tab uses the {{Code|setLEDs}} method to apply a single color to the LEDs specified by the start and end addresses.

===Other Considerations===
The {{Code|MinAddress}} is 0, and the {{Code|MaxAddress}} is 2047 for this controller. This means you can control up to 2048 LEDs, which is specified by the {{Code|MaxLEDCount}} property.

If you are using addressable LEDs with a white component (e.g., RGBW), the {{Code|MaxAddress}} is reduced to 1535 and the {{Code|MaxLEDCount}} is reduced to 1536.

==Advanced Tab==
The advanced tab also uses the {{Code|setLEDs}} method, however, it exposes extra parameters to experiment with.

===LED Pattern===
The LED Pattern selector can be used to define a color pattern that can be sent to the controller.

[[Image:Ledarray_ledarraycolor_selector.jpg|center|link=https://wwwdev.int.phidgets.com/docs/images/9/92/Ledarray_ledarraycolor_selector.jpg]]

This is equivalent to the following {{Code|LEDArrayColor}} array:

<syntaxhighlight lang='CSharp'>
//C#
LEDArrayColor[] exampleArray = new LEDArrayColor[2];
exampleArray[0].B = 255;
exampleArray[1].G = 255;
</syntaxhighlight>

This pattern will repeat if it is shorter than the total number of LEDs being controlled, as defined by the start and end addresses. For example, if the start address is set to 0 and the end address to 7, we would see the following result:

[[Image:ledarray_ledpattern_bluegreen4.png|center|800px|link=https://wwwdev.int.phidgets.com/docs/images/7/77/Ledarray_ledpattern_bluegreen4.png]]

Conversely, if the pattern is longer than the total number of LEDs being controlled, it will be truncated.

===Fade Time===
If a fade time is defined, the controller will smoothly fade the LED from its previous state to its new state.

===Other Considerations===
The {{Code|MinAddress}} is 0, and the {{Code|MaxAddress}} is 2047 for this controller. This means you can control up to 2048 LEDs, which is specified by the {{Code|MaxLEDCount}} property.

If you are using addressable LEDs with a white component (e.g., RGBW), the {{Code|MaxAddress}} is reduced to 1535 and the {{Code|MaxLEDCount}} is reduced to 1536.

==Animations==
<center>{{#ev:youtube|dJqAxyxWizY|rel=0}}</center>

The Addressable LED Phidget can perform various animations on board.

===Animation Type===
There are five animation types:
* ForwardScroll
* ReverseScroll
* ForwardScrollMirror
* ReverseScrollMirror
* Randomize

===Animation Slot===
Up to 16 animations can run concurrently. The animation slot (animation ID) is used when setting and stopping an animation.

===Start/End Address===
Define the range of your animation. Animations cannot overlap.

===Time===
Define the time between changes in milliseconds.

===Other Considerations===
Animations can be especially useful when paired with [{{SERVER}}/docs/Channel_Persistence_Guide Channel Persistence], as they are executed directly by the controller and can continue running even after the software application is no longer active.

==Errors==
===Over Current===
Addressable LEDs can demand significant power, especially when many LEDs are used at high brightness. The Addressable LED Phidget intelligently monitors current draw and will shut off power when the following limits are exceeded:

{| class="wikitable" style="margin:auto;width:75%;text-align:center"
! style="text-align: center;" | Power Source
! style="text-align: center;" | Current Limit (mA)
|-
| USB || 800
|-
| External (Power Jack) || 3200
|-
| External (Direct to LEDs) || N/A*
|}

<nowiki>*</nowiki>The Addressable LED Phidget can only monitor current draw when the LEDs are powered via USB or the onboard power jack. If the LEDs are powered directly, they are not protected by the onboard fuse or current monitoring circuitry. In these situations, the user is responsible for implementing adequate overcurrent protection to prevent damage or injury.

====Other Considerations====
If an '''OverCurrent''' error occurs, you will need to toggle [[#Power Enabled|Power Enabled]] to resume operation.

LEDArray API Guide - Revision history

Lmpacent at 15:34, 15 April 2026

Mparadis at 20:27, 27 January 2026