Differences

This shows you the differences between two versions of the page.

--- xtension_manual:controllingunits [2017/02/24 16:22] – external edit 127.0.0.1
+++ xtension_manual:controllingunits [2018/04/10 02:43] – James Sentman
@@ Line 3: / Line 3: @@
 The [[xtension_manual:lists|List]] is the main interface element in XTension for controlling of units. It offers many options and keystroke shortcuts for sending the command or setting the value that you wish.
-{{ :xtension_manual:masterlist.png |}}
+{{ :xtension_manual:masterlist_9.4.png?direct&600 |}}
+For a simple toggle of the Unit you can use the default toggle control which will display in the Control column, If the unit has it’s [[xtension_manual:editunitdialog|Ignore Clicks In List]] setting turned on then the toggle will not display a paddle for you to click on, but just the current value or value label of the unit. This stops you from accidentally clicking on a unit that should not be directly controlled.
+{{:xtension_manual:hvac_popup_control.png?300 |}}For some units a toggle might not make sense. You can change the control type displayed for a unit by changing the list control type in the Edit Unit dialog, or just control click on the Unit in any list and select a different a different List Control Type. The "buttons” control type lets you send an On or an Off regardless of the current state of the unit, The Text Field displays the current value of the unit and clicking on the table cell lets you enter a new value for the number. Pressing return, clicking away or tabbing away from the field sends the new value to the unit, pressing escape closes the edit field without sending the new value. The Popup Menu type lets you select from a list of possible values. You can define the list in the Edit Unit dialog. This is useful for devices for which text names for the different values make more sense than just a numerical value. For example a thermostat mode unit might be able to be set to Off, Heat or AC. The values you have to set that to might be 0, 1 and 2, but that doesn’t make for easy control. By creating a list of 3 entries in an HVAC Mode unit you can select from a popup of the valid values. Lastly you can also select “none” and then that unit will not display any control in this column. You can hide or show the entire control column by control clicking on the headers of the list and using the contextual menu entries for managing columns.
+All of these features work the same way on the Web Interface with the exception currently of editing the layout of the list. Setup your lists the way you wish them in the App and they will be presented in the same way when you’re accessing remotely via the web remote.
+\\
+You can bring up a more detailed control window for a unit in several ways. Clicking on the background of the Toggle control, on the Value column or on the unit jewel in the Name column will open the detailed controls dialog for that window. The controls displayed will depend on the capabilities of the unit and if you’ve fully expanded the window to show all controls via the disclosure triangle on the upper left hand side.
-The simplest control is just to double click a unit in the list. Unless you have the Ignore Clicks checkbox turned on in the [[xtension_manual:editunitdialog|Edit Unit Window]] the Unit will be toggled from it’s current state. If the unit does have it’s “Ignore Clicks” property set then you cannot control the unit from the list menu directly. It will still respond from any of the second tier interfaces such as the Popup Control window.
 \\
 \\
-If you click on the unit icon or the state indicator in the Unit Name column or highlight a Unit in the list and press the left arrow key XTension will popup the quick control window with most of the controls you might need to control a unit or even to create some simple events for the future of the unit. If the unit you want to control is not dimmable you’ll get the simplest of the popup control windows.
 {{:xtension_manual:hudnondimmable.png |}} From this window you can immediately send an ON or OFF for the Unit. You can also Block or UNBlock a unit. A blocked unit will refuse to send any commands from XTension unless you use the [[dictionary:unitcontrol:forceon|Force On]] or [[dictionary:unitcontrol:forceoff|Force Off]] scripting commands. It can’t stop the unit from receiving and responding to commands generated from other devices or NON-XTension interfaces to your system however, so if commands are received the state in the database is updated but no Unit Scripts will be executed for a blocked unit. By clicking the Edit button or by clicking on the Name of the Unit XTension will switch you to the [[xtension_manual:editunitdialog|Edit Unit Window]] for this Unit. After clicking the ON or OFF button the command is sent immediately and the window is closed.
@@ Line 14: / Line 22: @@
 {{ :xtension_manual:huddimmable.png|}} Opening the popup control window for a Unit that is dimmable opens a similar window but with additional controls for setting the value. A vertical slider is added to the window for quickly sending a new dim value. The new value is sent as soon as you let go of the slider but no attempt is made to send continual commands as you drag it up and down. For most dimmable units the slider limits are 0 and 100%. If the Unit is a “Register” type with a min/max value set or other Unit type that supports the min/max settings then those will be reflected in the sliders top and bottom values. For more precise value entry, perhaps for a thermostat setpoint, or one that requires a decimal point you can type directly into the Value field and click the Set button or press Return.
+\\
+{{:xtension_manual:detailed_controls_with_popup.png?325 |}} If you have set the list control type to a popup, then instead of the standard value field you’ll get a popup of the value choices you entered on the edit unit dialog page.
+\\
+\\
+\\
+\\
+\\
+\\
+\\
 \\