Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 6 Next »

Documentation of the user interface to control a light box

Getting started


The light box has an array 8x8 LEDS connected into four banks of 2x8 controlled by a pulse width modular. The frequency, phase and duty cycle of the LEDs can be set. This guide is designed get the user interface controlling the light box and walk through the available controls.

Prerequisites

  1. A light box, 5v power supply and USB cable. (Note 5v, not 12v)

  1. A current installation of DevWare.
  2. Optionally a Demo2x board.

Configurations

There are two configurations that can be controlled. Direct USB and via the Demo2x board. It is preferable to control the light box via the USB however, if this fails to work for some reason, the Demo2x might be a useful backup.

This is the USB configuration:

By removing the back and attaching a Demo2X board this configuration can be achieved.

The connecting to the light box


Connect the lightbox to the PC in either configuration. Connect the 5v power to the light box too. Open the DevWare folder. Double click on LightBoxController.exe. If it's not there it's possible you'll need to upgrade to the current version of DevWare.
Ideally all the lights on the light box should flash and the user interface will come up with no errors. If this is the case you can skip the trouble shooting section and go onto the user interface controls.

Trouble shooting connecting to the light box

You will probably get an error message similar to this.

  1. You will find there are errors for both USB and Demo2X. It searches for both and if it finds neither will report all errors.
  2. Check the voltage on your power supply one more time. It should be 5v. If it's 12v power supply you have destroyed the light box. Find another light box and keep the 12v power away.
  3. Check the pc device manager. See if the Demo2x or mcp2221 (USB configuration) are visible devices. If they are not look to a hardware issue.
  4. If you are connecting via a USB and you have a Demo2x available try it. If it works it verifies the hardware is working. You can use the 'retry' button rather than restarting the application to search for the attached devices.
  5. Try all the USB ports on your machine. USB 2 / 3 issues can cause issues. Again use the 'retry' button.
  6. If you are still having problems over UBS you may need to upgrade the USB3 firmware.
  7. If none of that works try swapping hardware to identify the problem ideally with a known working system.

Main User interface

This describes the user interface that controls the light box LEDs.

Single Monochrome color

The light box will come up in a basic mode where the duty cycle of the all the LEDs can be controlled together. By changing the duty cycle the white light will change in intensity from all the LEDs. There is no update or apply button. If the interface is connected to the light box changes will show immediately.

Frequency control

The frequency of all the LEDs can be controlled using the top slider. Set the duty cycle to 50% and slide to the left for the lowest available frequency and you should see it flashing.
The all frequencies that can generated by the light box are available. They are non-linear. There are many more low frequencies that high ones. To get the best frequency setting slide to the approximate frequency and then use the left and right arrow keys to search for the best setting.

Color control

Click on the color radio button.

You should get three duty cycle sliders which you can use to set a color.

Phase control

The phase effects when the LEDs are pulsed. With 0% phase the pulse will start at the beginning of the cycle, a 50% phase will start half way through the cycle.

The above settings will look white at high frequencies but in fact the light box is red for the first 33% of the cycle, green for the next 33% and blue for the last 33%.
A setting phase and duty cycle of which total more than 100% is honored. By example a duty cycle of 20% and a phase of 90% will start at 90% into this cycle and end 10% through the next cycle.

LED selection

So far all setting have been applied to all LEDs but it is possible to select four bank 2x8 LEDs individually. Change the selection from 'All LEDs' to LEDs by sector. Use the radio buttons to select which bank you wish to change. The controls for duty cycle and phase are same as controlling all the LEDs. Select the bank, then select color / monochrome and then set the sliders. Repeat to set up each bank.

Animation

A pattern created by varying the setting for each sector can be scrolled across the lightbox. The pattern can be made to move one sector to the left or right at the given frequency. The last sector will be rotated to the first sector so that the pattern repeats. Most controls are disabled during animation. Only the frequency controls and pause are allowed. An animated pattern can be saved and will animate immediately on load (See saving setting). Note: animation is not supported in script mode. Script mode only loads one shot pattern and then exits.

Saving settings

The file menu allows save, save as and open. These will save all the current user interface setting to file <filename>.LightBox. The settings are held in xml so it is possible to edit them using a text editor. When a file is opened its settings will be immediately applied to the light box if one is connected.

Light Box Menu

This describes the Light Box menu

Connect

This option will have no effect if you are already connected to a Light Box. If you aren't connected to a light box it will search for a light box and on finding it will apply the current user interface settings to it. This can be used if the light box is physically connected to the PC after the user interface is already running. It can be used it some temporary problem causes the light box to disconnect.

Disconnect

This disconnects from the light box. It's a good idea if you about to physically disconnect the light box but wish to keep modifying the light box setting to save as a file or apply later using connect.

Test pattern

This displays a test pattern on the light box. It can be used to verify the light box is still connected and that all the light box channels are functional.

Modes

This describes other ways which the Light Box Controller can be used.

Offline mode

With no light box connected and selecting ignore on the failure to connect error the user interface can be run and used to create setting files which can be applied later or used in a script.

Script mode

Using the command LightBoxController.exe –n <filename>.LightBox the executable will apply the settings in the given file to the light box and immediately exit without starting a user interface allowing it to be used in a script for moving through a series of test patterns.




  • No labels