ADVATEK Mk1 PixLite Control Board User Guide
- June 15, 2024
- ADVATEK
Table of Contents
ADVATEK Mk1 PixLite Control Board
Introduction
Note: This document details configuration of PixLite Mk2 and prior devices. For PixLite Mk3 devices, see the PixLite Mk3 Management Guide.
The Advatek Assistant allows for easy and powerful configuration of your
controller.
Features such as the single discovery table allow the user to search for
multiple controllers on the network and have them all appear in one place for
easy monitoring and configuration. This also means there is no need to have to
remember the individual IP addresses of any controllers which is ideal in
larger setups.
Current versions of the Assistant and PixLite firmware even allow detection of PixLite controllers on totally different network ranges that have incorrect IP configuration. The controllers can then have their network settings updated to ones that are in the correct range to talk to your computer, with ease.
New advanced features like ‘auto-complete’ now also make channel configuration easier than ever before.
Important: The contents of this guide assume you are using the latest version
of firmware on the PixLite device. Some settings and options shown here may be
missing if you are not up to date. The latest version of the firmware is
available from here:
www.advateklighting.com/download
Assistant Requirements
The latest version of the Advatek Assistant needs to be installed on your machine. The Assistant will operate on either macOS (MAC) or Windows (PC) based platforms.
You should always make sure you use the latest firmware and the latest Advatek Assistant for compatibility reasons. These can be downloaded from here: www.advateklighting.com/downloads
Network Configuration
Overview
Once all controllers are connected and powered on, open the Assistant. By default it will open the “Network Devices” tab, as shown in Figure 1 below.
Clicking on the “Search” button will then discover any PixLite controllers currently connected to the LAN. Each controller will appear on its own row in the main discovery window showing the following information: Model, Nickname, IP Address, Firmware Version and Current Temperature. Double clicking on a controller in the list will then bring up a separate configuration window allowing you to configure that specific controller.
To sort the list of controllers you can click on the heading above any column. For example clicking on the “Nickname” heading will sort the list in alphabetical order based on the nickname you configure for each device
Figure 1: Main View – Network Devices
Network Adapter Selection
At the top of the network devices tab you will see a drop down box showing one or more IP addresses. If there are none, it means an active network adapter was not detected on your PC. You must have one or more active cards to search for network devices.
If you have multiple network cards in your PC, such as a wireless card for your normal network and a wired card for your lighting network, you can select the one to search on here. Pressing the “Refresh Adapters” button will regenerate that list. This can be used if a network card is enabled/disabled or its IP settings are changed while the Assistant is running.
If multiple adapters are shown and you aren’t sure which one your PixLite is connected to, you can safely try them all.
Controllers with Invalid IP Settings
Sometimes a PixLite controller may be connected to your network and have invalid IP settings. This is common when moving a controller to another network or using the controller for the first time, or you may have just forgotten the IP address. As of Advatek Assistant version 2.2.0 and PixLite firmware version V1.4.5 there is a solution to this.
The Assistant will still detect these controllers and add them to your controller list. You can see an example of this in Figure 1 above. In this example our PC is set to 192.168.1.120 as shown in the adapter box and there’s an already configured PixLite at 10.0.0.120. A brand new PixLite 16 has been connected to the network switch. As there is no router with DHCP capabilities on the network, the controller has used its default IP of 192.168.0.50.
Both of these controllers are outside of the range of the PC’s network adapter, which will prevent us from properly operating the device. However if we double click on each controller a message pops up, as shown in Figure 2 below.
Figure 2: Invalid IP Range Popup
If we click yes to this we can now change the controller’s IP settings to something in our network range without ever needing to change our computer’s IP settings.
Basic Controller Configuration
Network
In this tab, as shown in Figure 3 below, the user can specify the static IP address and subnet mask that the controller will operate on as well as the type of IP connection. If you wish to use the IP address that you manually type in, make sure to select the ‘Static’ button.
If you wish to let the controller be assigned an IP automatically by a router, select the ‘DHCP’ button. DHCP is the default mode of operation and will allow the controller to connect instantly to most home or corporate networks that have a router.
If you are connecting your controller directly to your PC or via a basic network switch on a network without a router, you will need to use a Static IP address.
Figure 3: Network Tab
Control
This tab, as shown in Figure 4 below, allows you to automatically setup your pixel fixture very quickly by simply specifying the start universe, start channel and the number of pixels per output. The Assistant then automatically allocates the correct sequential universe addressing for all the pixels on all the outputs for you. This is very useful if your fixture has the same number of pixels on each of the outputs. If more specific control is needed for your application, the “Advanced” checkbox can be selected. Refer to Section 6.2 of this guide for information on advanced configuration.
The ‘Hold Last Frame’ checkbox allows you to tell the controller that it should continue to hold the last received data frame on all outputs if the controller stops receiving input data. Leaving it unchecked (default) will result in the controller timing out and blanking all outputs after a few seconds of not receiving any valid input data.
Lastly, the DMX512 outputs are also configured from this tab. Each of the four outputs can be turned on or off using the slider and the sACN or Art-Net universe of each DMX512 output can be specified.
Figure 4: Control Tab
LEDs
This tab, as shown in Figure 5 below, allows you to select the type of pixel IC you wish to control, set the RGB color order and specify any gamma correction.
Chip Type
You can only operate a single pixel chip protocol from a single controller (e.g. you can’t run the WS2811 protocol on strings 1-8 and SM16716 on strings 9-16).
Driver Speed
Some pixels that don’t have a clock line can operate at multiple speeds. Usually there are two speeds available, a slow and a fast option. If this is possible you will see this selection appear next to the Pixel IC box.
Clock Speed
Depending on the controller’s features, there may be an adjustable clock speed setting (for pixels that use a clock line). This allows you to change the frequency of the clocked signal. Faster signals give a better refresh rate but slower clock speeds work better over longer distances.
Long Range Mk1 Controllers – Condensed Mode
If a PixLite Long Range Mk1 controller is being used, an option called condensed mode is available. Long Range Mk2 controllers use expanded mode instead. If condensed mode is available, there will be an option available under this tab to select either ‘All’ or ‘Condensed’ mode for the controller outputs. ‘All’ mode will use all 8 output jacks on the controller (2 data and 2 clock lines per jack) while ‘Condensed’ mode will only use the first 4 output jacks with 4 data outputs per jack. These options will be unavailable if you selected a chip type that has a clock line, as condensed mode is not possible under that circumstance.
Expanded Mode
If using a controller that supports expanded mode and you select a pixel type that is a single wire protocol with no clock line, then you will have the option to select expanded mode. This mode allows the clock output on each of the pixel outputs on the control board to function as a data output instead of a clock line. This doubles the number of physical data outputs available and also increases the refresh rate. On a PixLite 16 Mk2 for example, your data outputs will go from 16 to 32 in expanded mode and the max RGB pixels per data output will drop from 1020 to 510.
LED Type
Some pixel drivers can operate RGB or RGBW LEDs. In this case, an option will be shown to select the type you are using. RGB LEDs use 3 channels and RGBW LEDs use 4 channels per pixel.
RGB(W) Order
Under this tab you can also change the RGB (W) color order of all the outputs simultaneously, or change it for individual outputs separately. This is useful if the lights you are using are not physically wired in the standard red, green, blue order. To change the order of all outputs at once simply select the order from the dropdown box. To change specific outputs, click the ‘Advanced’ checkbox and then click the ‘Advanced’ button to bring up the RGB (W) configuration window for individual outputs.
Gamma Correction
Gamma correction is the method used for correcting the output of the LEDs so that they respond in a much more linear fashion when viewed by the human eye (the spectral response of the human eye is non-linear). This is particularly important when the LEDs are being faded, and also provides more accurate and vivid color representation. It can only be applied to pixels that have greater than 8-bit resolution, E.G. TLS3001. The Assistant provides a very easy to use slider system enabling you to easily set the gamma correction value for each RGB(W) color. Typically, a gamma-corrected value of 2.0 is a good place to start.
Figure 5: LED’s Tab
Misc
This tab, as shown in Figure 6 below, allows the user to assign a custom nickname to the controller, perform a firmware update, identify the controller and also displays the current bank voltage of each of the power bank(s).
It also allows the user to set the enclosure target temperature if a fan is connected to the auxiliary output on a PixLite controller. This is only available on some versions of the controller. For more information on how this feature works please refer to your specific PixLite version’s user manual. If the user manual does not talk about the auxiliary fan output then your controller does not support this feature.
The ‘Start Identify’ button will set the device’s status LED to flash in an
identifiable way.
This may be advantageous if you lose track of which controller you are
configuring. If a second controller is set to identify mode, the first will
automatically exit this mode. To stop the identify mode, simply press ‘Stop
Identify’.
For more information about how to perform a firmware update, please refer to the relevant section in the controller’s user manual. If you can see the update button below you will just have to click it and then browse for the downloaded firmware update ‘.hex’ file.
Figure 6: Misc. Tab
Advanced Configuration
Overview
Clicking on the ‘Advanced’ checkbox and then the ‘Advanced’ button in the Control tab allows for advanced configuration of the individual outputs, as shown in Figure 7 below. Each output can have advanced parameters individually configured.
There are some automatic features that will help with understanding the channel usage range and with sequential addressing.
Figure 7: Advanced Output Configuration
Channel Output Configuration
The advanced configuration permits an extremely flexible channel setup. The controller is capable of “connecting” the beginning of an output to any channel within any universe. Outputs can be connected to the same universe data as each other, be sequential to each other, or even be separated by hundreds of universes if required.
The key is to correctly match the universe outputs of your lighting software to the channel outputs you have configured for your PixLite controller. It should be noted that the PixLite controller only uses 510 channels out of a possible 512 in any Universe when using RGB pixels. It does this to avoid splitting a single pixel (3 channels) over 2 Universes which is bad practice (some software control programs do this as well.) If using RGBW pixels however, it uses the full 512 channels per Universe and should be configured as such in your lighting software.
The Assistant will show the last universe and channel that it uses for each output based on other entered parameters for that output like the number of pixels and grouping. This helps show you exactly what range of channels the output is using for your reference.
The user may also click on the ‘Automatic Sequential Channels’ checkbox at the bottom of the configuration window to enable auto-calculation of the start universes and channels for outputs 2 onwards. This feature is intended to help the user configure all their output channels even faster by automatically working out those fields based on other parameters already provided by the user.
Null Pixels
Null pixels allow the controller to ignore or skip a specified number of pixels at the beginning of an output. This is useful when you want to extend the distance between controller and your actual lights, as the data signals used by pixel chips are not designed to travel over long distances.
Sometimes the signal between controller and first pixel gets degraded and causes problems such as flickering lights. In these cases inserting a “fake” (null) pixel between controller and first real pixel can help as they reproduce the signal on their output; remember that they will not actually light up as they are ignored by the controller.
Typical distances a signal will travel before requiring null pixels will depend on several factors including the type of pixel used, voltage and wire gauge. Typically it is a process of trial and error to determine how far you can go between pixels in a specific setup
The PixLite treats null pixels as an entirely different parameter to normal pixels. So for example if you had 50 pixels in your pixel fixture and needed to insert 2 null pixels before the start, the ‘Null Pixels’ field for that output would need to be set to 2 and the ‘Num Pixels’ field would remain at 50 (even though there are 52 physical pixels in total on that output).
Zig Zag
The zig zag feature allows for a simpler physical connection of pixels in certain circumstances where the pixels connect in alternating directions. For example the below matrix has 6 rows with 5 pixels in each. The simplest way to connect the data wires between rows is shown in Figure 8 below. Unfortunately, this results in every second row lighting up in reverse order as shown by the numbers which indicate the order pixels will light up in
Figure 8: Pixels In Reverse Order
The zig zag feature of the PixLite allows this physical wiring to be virtually changed to the equivalent of wiring the pixels like Figure 9 below. In this example, you would set the zig zag on the output to ‘5’ to achieve this effect.
Figure 9: Zig-Zag Enabled to Correct Pixel Order
This feature is typically used in elements such as a matrix of pixels (like the example).
Grouping
Grouping allows the user to specify how many physical pixels are grouped together and treated as one single pixel to the outside world. For example, if you had a pixel strip with 150 physical pixels on an output and entered 10 in the grouping field for that output, it would effectively turn that strip of 150 individual pixels into a strip of 15 individual ‘pixels’. Each ‘pixel’ would now actually consist of a group of 10 physical pixels all grouped together as one single ‘pixel’ as far as your lighting control software or console is concerned.
Intensity
This allows the user to specify a value between 0 and 100% for the brightness level of the pixels on a given output. Note that the brightness output is scaled based on the input level provided to the controller. This is used in circumstances where the lights are too bright for your application. If you set the Intensity limit to 50% for example, the PixLite would halve all incoming data values.
Reversing
Turning on the reversed option tells the controller to light up the pixels in reverse order to the way that they are physically connected. This means the first pixel to light will actually be the last physical pixel on that output instead of the first physical pixel.
Test Modes
This tab allows you to remotely select a number of different hardware test modes on the controller that can help to determine if your pixels are connected correctly and are working as they should. Simply select the test you wish to run from the drop-down box to turn it on, and select either an individual pixel output or all pixel outputs for the test to be applied to. Note: Before running the tests the pixel type and outputs should be configured correctly or it will not work.
None (Live Data)
Test mode is not running and the pixels will be responding to live sACN (E1.31) or ArtNet data, as shown in Figure 10 below.
Figure 10: Test Mode – None (Live Data)
RGBW Cycle
This will automatically cycle all pixels on the selected output(s) through red, green, blue and white in sequence.
Individual Colors
This will allow you to select a solid color of red, blue, green or white and will turn on all pixels on the selected output(s) to that color.
Set Color
This will allow you to select a custom color for all pixels on the selected output(s), as shown in Figure 11 below. The color can be selected by either the shade palette, vertical bar or RGB(W) sliders. All pixels will respond in real time to the changes.
Figure 11: Test Mode – Set Color
Color Fade
This test will automatically perform a continual colour fade through the entire colour range on all pixels on the selected output(s).
Single Pixel
This test mode, as shown in Figure 12 below, is useful for testing an individual pixel on the selected output(s). Simply entering a number in the Pixel Number box or pressing up/down will activate the test.
This mode can also count through the pixels automatically. Set the speed at which the Auto Increment will count to (in seconds, from 0.5s to 60s), and press ‘Start’.
This test will turn on physical pixels one at a time. Null pixels are included in the test and advanced configuration options such as grouping and reversing are ignored, as the purpose of this test is to check individual pixel function or to count the number of physical pixels on the output(s).
Figure 12: Test Mode – Single Pixel
Further Information and Support
For the latest information, more specific troubleshooting guides and other
help, you should refer to our online Knowledge Base here:
www.advateklighting.com/knowledge-base
Alternatively, you can contact our support team at:
www.advateklighting.com/contact
support@advateklighting.com
www.advateklighting.com
PixLite Mk1 & Mk2 Configuration Guide V20230823
References
- PixLite® Professional LED Pixel Controllers & SHOWTime® - Advatek
- Contact us - Advatek
- Pixel lighting articles, inspiration and information - Advatek
Read User Manual Online (PDF format)
Read User Manual Online (PDF format) >>