Lutron Light Load Data Module Information


	L Cubed Solutions *Valued Independent Programmers*, AMX Certified Experts

Back to Corporate

General:

This module is used to read in, and write out light load data between the data files that define each light load and the structures where the data is stored. Two files are used for this purpose: LiteLoads.dat, and LiteLoadButtons.dat. While LiteLoads.dat contains information about the physical attributes of each load, LiteLoadButtons.dat contains a reference number (or button) for each load in order to have a way of referring to a load within the program that doesn't change even if the load's address or description changes.

Each entry in LiteLoads.dat has the load's type, name (description), lighting system address, and preferred intensity. The entries in this file are listed in display order for other uses. When the program boots, if no data files currently exist in the LightLoadData directory, template files will be created. Normally the LiteLoads.dat file is created from running an SQL query on the Homeworks or Homeworks Interactive project file, or from an Excel spreadsheet created using HW Illumination. Once a data file is properly read in, if no LiteLoadButtons.dat file exists, it will be created using the data from the LiteLoads.dat file. If a LiteLoadButtons.dat file exists, no change will be made to it unless requested, and then only additions (new loads) will be made. In this way, the load button numbers will stay valid.

Internal mechanisms are maintained to provide very fast lookup of any load's data in order to update its intensity. In this way, hundreds or thousands of loads can be monitored and updated with very little processor time.

Prerequisites:

None

Module Header:

Type	Name	Description
Dev	vdv	Virtual device for the module
Char[]	SaveDate	Date the data was last saved
Char[]	SaveTime	Time the data was last saved
Char[][]	Description	Load description
Char[]	Type	Each load's type
Char[]	PrefIntensity	Each load's preferred intensity
Integer[]	Address	Each load's system address (in compressed format)
Integer[]	DisplayOrder	Each load's display order
Integer[]	LoadButton	Each load's button value
Integer	MaxLoad	Maximum light loads read from file

Send_Commands:

'?' - This causes the module to display all supported commands via messages to the master.
'Ver' - Displays the compilation and version information for the module.
'Initialize' - Causes the data to be read and initialized. A channel on the virtual device is pulsed when completed.
'Load_Data' - Reads the data from disk. A channel on the virtual device is pulsed when completed.
'Save_Data' - Saves the data to disk. A channel on the virtual device is pulsed when completed.
'Update_Buttons' - Updates the load buttons as needed. A channel on the virtual device is pulsed when completed.

API Calls Supported:

None

API Calls Returned:

None

Last Modified: 05/16/2008 08:20:14 PM