Differences

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

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
indigo_5_documentation:ui_tour [2012/04/24 14:45]
jay [Outline View]
indigo_5_documentation:ui_tour [2019/01/26 00:10] (current)
Line 1: Line 1:
 +====== Indigo Mac Client ======
  
 +When you double click on the **''​Indigo 5''​** icon in the **''​Applications''​** folder, you're actually starting the Indigo Mac Client, which will start up the Indigo Server process according to the options selected in the [[getting_started#​starting_indigo_server|Start Server]] dialog.
 +
 +===== Home Window =====
 +
 +The Home Window in the Mac client looks like this:
 +
 +{{:​indigo_5_documentation:​main_window.png?​800|}}
 +
 +The Home Window is in 5 areas:
 +
 +  - Outline View
 +  - Item List
 +  - Item Detail
 +  - Status Bar
 +
 +
 +==== Outline View ====
 +
 +The outline view shows all high-level objects (except [[overview#​variables|Variables]] which have their own window): [[overview#​Devices]],​ [[overview#​Triggers]],​ [[overview#​Schedules]],​ [[overview#​Action Groups]], and [[overview#​Control Pages]]. Selecting one of these in the outline view will switch the Item List to view all of those types of objects. The same goes for folders that are under the high-level headings except only the devices in those folders will show.
 +
 +To create a new folder, select the main object type in the list then click the plus (**''​+''​**) button at the lower-left corner of the outline view. A new folder will appear and you can just start typing it's new name. To delete a folder, select it, then click on the gear icon or right-click the folder (bring up the contextual menu). The resulting menu will allow you to select **''​Delete Folder''​** the delete it. If the folder isn't empty, it will show you a sheet with 3 options: **''​Cancel''​** (do nothing), **''​Delete Items''​** (delete the items in the folder along with the folder), or **''​Move Items''​** (move the items to the parent first then delete the folder).
 +
 +From the same menu, you can select **''​Rename Folder...''​** to rename it, Enable/​Disable Remote Display (for devices, action groups, and control pages) to show/hide it in remote clients (like Indigo Web Server (IWS) pages or Indigo Touch), or copy the unique folder ID for use in Python scripts.
 +
 +To move an object to a folder, just drag it from the list view onto the folder (or top-level object) - somewhat like moving mail messages from the inbox to a mail folder in the Mail application.
 +==== Item List ====
 +
 +The Item List contains the items contained in the object that's selected in the Outline View - so if DEVICES is selected, then all devices in your system are shown. If you have one of the device folders selected, only the devices in that folder are shown.
 +
 +The buttons above the table view perform actions on items in the list - the buttons will work on whatever list is displayed in the Item List. So, if you have DEVICES (or a device folder) selected in the Outline View, the item list will show devices and the buttons will operate on that list - **''​New...''​** device, **''​Edit...''​** the selected device, **''​Duplicate''​** the selected device, or **''​Delete''​** the selected device(s). The search bar will filter the list.
 +
 +The image above shows all possible columns in the device view. However, if you right-click on the table header:
 +
 +{{:​indigo_5_documentation:​device_column_selection_menu.png|}}
 +
 +you can customize what columns are shown by checking/​unchecking them in the list. Several of the columns have a checkbox in them - you can check/​uncheck the feature for the object by clicking on the checkbox. In a few rare cases the checkbox will be disabled (grayed out).
 +
 +
 +Every Item List is customizable in this regard. Also, if you right-click on a device:
 +
 +{{:​indigo_5_documentation:​device_contextual_menu.png|}}
 +
 +This menu will:
 +
 +  - Take you to the How-To wiki for that device type - if it's a plugin device, it will take you to the help page supplied by the plugin developer.
 +  - Toggle remote display - this tells Indigo whether to show the device in remote clients.
 +  - Toggle communication with the device - this effectively enables/​disables the device. If a device is disabled, it will show up gray in the list.
 +  - Copy the unique ID of the device to the clipboard - to assist in writing Python scripts that use the device
 +
 +Triggers and Schedules have a contextual menu when you right-click on them that will allow you to:
 +
 +  - Enable/​disable the event.
 +  - Hide executions in the event log - they trigger will continue to execute but nothing will be reported in the Event Log window.
 +  - Copy the unique ID of the trigger or schedule to the clipboard - to assist in writing Python scripts
 +
 +Action Groups have a contextual menu when you right-click on them that will allow you to:
 +
 +  - Toggle remote display - this tells Indigo whether to show the device in remote clients.
 +  - Copy the unique ID of the device to the clipboard - to assist in writing Python scripts that use the device
 +
 +And finally, Control Pages also have a contextual menu:
 +
 +  - Toggle remote display - this tells Indigo whether to show the device in remote clients.
 +  - Show in Browser - open the control page in the default browser.
 +  - Copy the unique ID of the device to the clipboard - to assist in writing Python scripts that use the device
 +
 +==== Item Detail ====
 +
 +The item detail area shows controls and extra state information depending on what type of object is selected. ​
 +
 +=== Devices ===
 +
 +If you have no device selected, only controls that effect collections of devices are shown:
 +
 +{{:​indigo_5_documentation:​no_devices_controls.png|}}
 +
 +Each of the other device types have their own sets of controls.
 +
 +== Lights/​Appliances and Sensors (Motion Sensors, etc) ==
 +
 +For lights (dimmers), appliance modules (relays), and sensors (Motion Sensor, TriggerLinc,​ etc), you see the same details above with some of the others enabled as is appropriate for the device.
 +
 +== iMeter ==
 +
 +{{:​indigo_5_documentation:​imeter_controls.png|}}
 +
 +The iMeter has it's own detail area - it shows the current load in watts, total usage (since the last reset) and the date of the last reset. Use the **''​Refresh All''​** button to immediately update the information and the **''​Reset Total Usage''​** button to reset the total usage information.
 +
 +== Sprinklers (Pro Only) ==
 +
 +{{:​indigo_5_documentation:​sprinkler_controls.png|}}
 +
 +Sprinkler detail allow you to turn on a specific zone, go to the next or previous zone, update the valve status. And, if a schedule is currently running, pause/​resume it, begin running the previous schedule, and stop all activity.
 +
 +== Thermostats (Pro Only) ==
 +
 +{{:​indigo_5_documentation:​thermostat_controls.png|}}
 +
 +The thermostat detail area shows the current temperature,​ humidity, mode, cool/heat setpoints, and fan mode. You can also adjust all of those as well as refresh the values and turn everything off. Note that on rev2 thermostat adaptors the circles next to cool and heat setpoints will be lit if their respective HVAC system is actually running (A/C or heater).
 +
 +== Control Input / Output Device (Pro Only) ==
 +
 +{{:​indigo_5_documentation:​io_controls.png|}}
 +
 +IO Device detail area shows the state of all the input and output states available for the device and you can update them immediately using the **''​Get Input/​OutputStatus''​** button. The **''​Outputs''​** grid shows all available outputs and their status. If you're unfamiliar with the square push buttons on the Mac, when they are light, they are OFF - when they are dark, they are ON. Use the **''​All Off''​** button to turn off all binary outputs.
 +
 +== Plugin Devices (Pro Only) ==
 +
 +{{:​indigo_5_documentation:​plugin_controls.png|}}
 +
 +Because plugin devices can define as many states as they like, we've provided a list of all states and values in the detail area for every plugin device.
 +
 +=== Triggers and Schedules ===
 +
 +{{:​indigo_5_documentation:​trigger_schedule_controls.png|}}
 +
 +The detail area for triggers and schedules is identical - it shows the triggering event (either a state change or some time/date description),​ whether the condition is always, rules, or a script, and a summary of actions. The popup will allow you to specify how the object is processed:
 +
 +  * **''​Enabled and Upload''​** - this means that it will be processed both while Indigo Server is running and it will be uploaded to your standalone controller (if it supports uploading).
 +  * **''​Enable''​** - this means that it will be processed while Indigo Server is running, and mirrors the Enabled column in the list if it's visible.
 +  * **''​Upload''​** - this means that it will only be uploaded and executed by your standalone controller (if it supports uploading) - while Indigo Server is controlling the logic it will not be enabled
 +  * **''​Disabled''​** - this means that it's completely disabled - it also mirrors the Enabled column in the list if it's available.
 +
 +The **''​Execute Actions Now''​** button will do exactly that - execute all the actions associated with the object. <color red>​NOTE</​color>:​ just as the triggering event will be ignored, so will any conditions associated with the object.
 +
 +=== Action Groups ===
 +
 +{{:​indigo_5_documentation:​action_group_controls.png|}}
 +
 +The action group detail shows a list of all the actions in the group. The **''​Execute Actions Now''​** button will do exactly that - execute all the actions associated with the action group.
 +
 +=== Control Pages ===
 +
 +The only thing in the detail area for a control page is the **''​Show in Browser''​** button, which will open the selected page in the default browser.
 +
 +==== Status Bar ====
 +
 +The status bar along the bottom of the window has several elements. First, there'​s the communication queue indicator. It's the longish rectangle next to the Indigo icon. This indicator will show green bars going from right to left, and purple bars going from left to right. Green bars indicate outgoing communication purple bars show incoming communications. If you see green bars begin to build up, you can tell that something is keeping the outgoing command queue from processing correctly.
 +
 +Next to that bar you'll see the names of the interfaces you have configured. If they are in green, then they are functioning properly. If they are in red with a line through them, Indigo can't communicate with them. If they are gray, they are offline for some reason.
 +
 +The next four sets are pretty self explanatory:​ the next sunrise time, the next sunset time, the current time (for the Indigo Server, so it may be different than the client time if you're running the client on a different machine), and the next time a schedule is going to execute.
 +
 +===== Event Log Window =====
 +
 +{{:​indigo_5_documentation:​event_log_window.png|}}
 +
 +The event log window shows you pretty much everything Indigo Server is doing at any given time. You see incoming and outgoing traffic, trigger and schedule executions, and other useful diagnostic information.
 +
 +Click the **''​Clear Window''​** button to clear the log entries. Click on **''​Show Event Logs Folder''​** to open the Logs folder in the Finder. Here you will find one file for each day's events. You can change how many day's worth of event log files are stored by selecting **''​Indigo 5->​Preferences...''​** and then selecting the **''​General''​** tab. There, you can enter the number of days of event log files that you want to keep. Indigo Server will delete all files outside of that period of time.
 +
 +===== Variable Window =====
 +
 +The variable window is discussed in the [[overview#​Variables]] overview section.
 +
 +===== Preferences Window =====
 +
 +In the Getting Started guide, we visited almost all of the tabs on the Indigo Preferences window. We did, however, miss the **''​General''​** tab:
 +
 +{{:​indigo_5_documentation:​general_prefs_tab.png|}}
 +
 +The first section of the tab is about update checking. The first checkbox will have the client check with our servers to see if there'​s an update to Indigo available when the client first starts up. If there is, it will let you know. The second checkbox will send anonymous information to us (and it really is anonymous) about your install - this helps us to better prioritize what future enhancements to add. The last checkbox will also check to see if there'​s a newer beta version available - if you aren't interested in getting betas then leave it unchecked.
 +
 +The next section we talked about above - how many days of event log files to keep.
 +
 +The last section is a rather technical configuration parameter - it is possible to get into an unending (infinite) loop when you're setting up your triggers. For instance, if you have a trigger the fires on a variable change, and it changes the variable to some new value each time, that would cause the trigger to fire again. Setting this value will cause it to stop eventually. Leaving it set to 5 is probably the best idea.
 +
 +===== Menus =====
 +
 +In this section, we'll go through each of the menus in Indigo.
 +
 +==== Indigo 5 Menu ====
 +
 +{{:​indigo_5_documentation:​indigo_5_menu.png|}}
 +
 +  * **''​About Indigo 5''​** - this will show the About window which will show what client and server versions you're running and what your registration code is
 +  * **''​Start Local Server...''​** - this will open the [[indigo_5_documentation:​getting_started#​starting_indigo_server|Start Server dialog]]
 +  * **''​Stop Server''​** - this will stop the Indigo Server
 +  * **''​Connect to Remote Server...''​** - this option will allow you to connect to a different Indigo server or a server running on another Mac
 +  * **''​Close Connection''​** - this will close the connection to the server
 +  * **''​Preferences...''​** - this opens the [[indigo_5_documentation:​ui_tour&#​preferences|preferences dialog]]
 +  * **''​Check for Updates...''​** - this will have the server your connected to contact us to see if there is an update available
 +==== File Menu ====
 +
 +{{:​indigo_5_documentation:​file_menu.png|}}
 +
 +  * **''​New Database...''​** - this will close the current database and create a new one - you'll be prompted for a name and save location
 +  * **''​Select Database...''​** - this will allow you to switch to a different database
 +  * **''​Close Window''​** - this will close the frontmost window
 +  * **''​New Device...''​** - this will switch the Home Window to the devices view and open the [[indigo_5_documentation:​overview#​devices|new device dialog]]
 +  * **''​New Trigger...''​** - this will switch the Home Window to the triggers view and open the [[indigo_5_documentation:​overview#​triggers |new trigger dialog]]
 +  * **''​New Schedule...''​** - this will switch the Home Window to the schedules view and open the [[indigo_5_documentation:​overview#​schedules |new schedule dialog]]
 +  * **''​New Action Group...''​** - this will switch the Home Window to the action groups view and open the [[indigo_5_documentation:​overview#​action_groups |new action group dialog]]
 +==== Edit Menu ====
 +
 +The Edit menu has the standard options on it that you would expect any Mac app to have. Note that the Delete and Duplicate options are available for most items in the user interface.
 +==== View Menu ====
 +
 +The View menu allows you to switch between views in the Home Window just as if you had clicked the major item types in the outline view: Devices, Triggers, Schedules, Action Groups and Control Pages.
 +==== Go Menu ====
 +
 +{{:​indigo_5_documentation:​go_menu.png|}}
 +
 +  * **''​Browser Devices Page''​** - this will open your default web browser to the built-in devices list
 +  * **''​Browser Actions Page''​** - this will open your default web browser to the built-in actions list
 +  * **''​Browser Variables Page''​** - this will open your default web browser to the built-in variable list
 +  * **''​Browser Control Pages''​** - this will open your default web browser to the control page list (this option is only available in Indigo Pro)
 +  * **''​Event Logs Folder''​** - this will open the Event Logs folder in the Finder
 +  * **''​Purchase Hardware''​** - this will open your default web browser to our online store (the Indigo Store) -- if you are running a trial copy this item will be called "​Purchase Indigo"​ and will take you to the Indigo purchase page
 +  * **''​Online Support Forum''​** - this will open your default web browser to our online support forums
 +==== Interfaces Menu ====
 +
 +  * **''​Manage Interfaces...''​** - opens the [[indigo_5_documentation:​getting_started#​configuring_indigo_to_use_your_interface |interface preferences]]
 +
 +=== INSTEON/X10 Powerline Submenu ===
 +
 +{{:​indigo_5_documentation:​interfaces-insteon_menu.png|}}
 +
 +  * **''​Enable/​Disable''​** - toggles the interface on and off
 +  * **''​Configure...''​** - opens the [[indigo_5_documentation:​getting_started#​configuring_indigo_to_use_your_interface |configuration preferences]] for this interface
 +  * **''​Upload Settings...''​** - opens the [[indigo_5_documentation:​getting_started&#​uploading_schedule_and_trigger_actions |upload dialog]]
 +  * **''​Manage INSTEON PowerLinc Links...''​** - opens the PowerLinc [[indigo_5_documentation:​insteon_link_management |link editor window]]
 +  * **''​Manage INSTEON Device Links...''​** - opens the device [[indigo_5_documentation:​insteon_link_management |link editor window]]
 +  * **''​Start Sync INSTEON Device Links...''​** - starts any pending link sync operations
 +  * **''​Stop Sync INSTEON Device Links''​** - stops any ongoing linking operations
 +
 +=== X10 RF Submenu ===
 +
 +{{:​indigo_5_documentation:​interfaces-x10rf_menu.png|}}
 +
 +  * **''​Enable/​Disable''​** - toggles the interface on and off
 +  * **''​Configure...''​** - opens the [[indigo_5_documentation:​getting_started#​configuring_indigo_to_use_your_interface |configuration preferences]] for this interface
 +==== Plugins Menu ====
 +
 +{{:​indigo_5_documentation:​plugins_menu.png|}}
 +
 +The Plugins menu (Indigo Pro Only) will adjust based on the what plugins you have installed. Three menu items will always be present:
 +
 +  * **''​Reload AppleScript Attachments''​** - this will reload all the attachment AppleScripts that are in the Scripts/​Attachments directory of the Indigo system directory (/​Library/​Application Support/​Perceptive Automation/​Indigo 5/)
 +  * **''​Online User Contribution Library''​** - this will open the file library in your default browser where you can find and download user-contributed plugins, scripts, applications,​ etc.
 +  * **''​Open Scripting Shell''​** - this will open a terminal window and start the interactive Python shell with the Indigo module loaded - see the [[indigo_5_documentation:​plugin_scripting_tutorial|Scripting Tutorial]] for more information
 +
 +For information about the plugins, see the **''​About...''​** menu item for each plugin.
 +==== Window Menu ====
 +
 +{{:​indigo_5_documentation:​window_menu.png|}}
 +
 +  * **''​Home Window''​** - this will show/bring to front the Home Window
 +  * **''​Event Log''​** - this will show/bring to front the Event Log Window
 +  * **''​Variable List''​** - this will show/bring to the front the Variable List Window
 +==== Help Menu ====
 +
 +{{:​indigo_5_documentation:​help_menu.png|}}
 +
 +  * **''​Help for Devices''​** - this will change slightly based on what window is selected and what's selected in that window - but it will open the default browser to the page in the help documentation for that particular item
 +  * **''​How-To Wiki''​** - this will also change slightly based on what's selected - it will open to the How-To wiki for the selected item (if a device is selected it will go to the wiki for that device, otherwise it will just go to the landing page)
 +  * **''​Indigo 5 Documentation''​** - this will open your browser to the landing page for all Indigo 5 documentation
 +  * **''​Getting Started Guide''​** - this will open your browser to the Getting Started Guide, the place where everyone new to Indigo should start
 +  * **''​Online Support Forum''​** - this will open your browser to our support forum - it's very active and is the primary place where you should seek help - we answer questions there very quickly and in fact we have many helpful users that can help as well
indigo_5_documentation/ui_tour.txt ยท Last modified: 2019/01/26 00:10 (external edit)
 

© Perceptive Automation, LLC. · Privacy