CPG Properties
The following information is shown in the Properties tab of the Modifier Panel when a Control Panel Group (CPG) is selected in Site View. A Control Panel Group is a set of Control Panel pages that are managed together.
The same properties appear when you select the whole Control Panel Group in the Control Panel Group View, together with the Control Panel Properties of its panels.
A Managed Device is a special kind of Control Panel Group, so the two share several of the same sections. The Scripting, Script Status, Script Statistics, and action buttons described on this page also appear for Managed Devices. See Managed Device Properties for the sections that are specific to managed hardware.
Control Panel Group Properties
| Field | Description |
|---|---|
| CPG Name | The name of the Control Panel Group. |
| Notes | Free-form text you can associate with the Control Panel Group (up to 500 characters). |
| Total Panels | The number of Control Panels in the group. |
| Panel Size | Sets the panel's width and height to a T-Series touchscreen's resolution, or Custom to enter them yourself. See Panel Size. |
| W | The width of the panel, in pixels. Read-only unless Panel Size is Custom. |
| H | The height of the panel, in pixels. Read-only unless Panel Size is Custom. |
Panel Size
Choose the touchscreen the Control Panel Group will be shown on, and W and H are set to its resolution. The T-10 is listed twice, once in landscape and once in portrait, with the width and height swapped. The T-5 v2 and T-7 are landscape only.
| Panel Size | W × H (pixels) |
|---|---|
| Custom | Any size you enter. |
| T-5 v2 Landscape | 1280 × 720 |
| T-7 Landscape | 1280 × 800 |
| T-10 Landscape | 1920 × 1200 |
| T-10 Portrait | 1200 × 1920 |
While a touchscreen is chosen, W and H are read-only. Choose Custom to edit them again. They keep the touchscreen's size until you change them.
Control Panel Groups created in an earlier version start at Custom, with their existing size.
Panel Size is read-only for some Managed Devices:
- For a Managed Device whose Control Panel layout comes from its driver, such as an xIO device, Panel Size shows Auto Layout. The driver sets the panel's size.
- On a locked Managed Device, Panel Size, W, and H are read-only.
Web App
Settings that control how the Control Panel fits the window when it is served by a Smart Device, such as the C20, through the Web App. They have no effect on how the Control Panel looks or behaves in Cognio DesignOps.
| Field | Description |
|---|---|
| Vertical Scrolling | Lets the Control Panel scroll vertically when it is taller than the window showing it. A panel that fits shows no scrollbar. |
| Fit Width to View | Scales the Control Panel so its width fills the window showing it, growing or shrinking as needed. Control sizes and positions are preserved, and the panel's height scales with its width. |
Both settings are on by default for new Control Panel Groups. Control Panel Groups created in an earlier version keep their existing setting. On a locked Managed Device, both settings are read-only.
In most cases, turn both settings off for a Control Panel Group that will be shown on a T-Series touchscreen. Design the Control Panel to fit the touchscreen's screen, so it does not need to scale or scroll. Use Panel Size to set the panel to the touchscreen's resolution.
Because Fit Width to View keeps the panel's proportions, a wide, short window can make the panel taller than the window. Turn on both options so the panel can scroll in that case.
Remote Settings
Settings that control access to this Control Panel Group from the remote control port (a network port other systems use to read and operate the panel).
| Field | Description |
|---|---|
| Remote Enable | Allows access to this Control Panel Group from the remote control port. |
| Remote Name | The name the remote control port uses to identify this Control Panel Group. |
Scripting
Cognio can run a Lua script (a lightweight scripting language) against the Control Panel Group to add custom control logic.
| Field | Description |
|---|---|
| Enable Scripting | Turn scripting on for this Control Panel Group. |
| Script Location | The path to the Lua source script (.lua) on your computer. Use the browse button to select a file, or the edit button to open it. |
| Input Control Pins | The number of input control pins. Each pin is available as a destination for a control output module. A name field is shown for each pin. |
| Output Control Pins | The number of output control pins. Each pin is available as a source for a control input module. A name field is shown for each pin. |
| Import Lua Script | Re-imports the Lua script from the Script Location and restarts it. Use it after you edit the .lua file to load your changes. The button is unavailable until a Script Location is set, and flashes briefly when clicked. |
| Auto-Import Lua Script | Automatically import the Lua script when saved in an external editor. |
| Lua Script Debug Output File | The path where Lua debug output is written. Use the browse button to select a file, or the edit button to open it. |
| Enable Synced Debugging | Turn on synced debugging. |
| Remote Device IP | The IP address of the remote device used for debugging. |
Script Status
Read-only status of the running script, with controls to manage it.
- Restart — Restarts the script.
- Resume — Resumes a paused script.
- Pause — Pauses the script.
| Field | Description |
|---|---|
| Paused | Whether the script is currently paused. |
| Error Code | The current script error code (0 indicates no error). |
| Error Info | A description of the current error code. |
| CPU Used | The percentage of CPU the script is using. |
Script Status and Script Statistics are also available in Operation mode. While you work with an unlocked Control Panel Group in the Control Panel Group View, you can keep the Modifier Panel open to watch the script and to Restart, Pause, or Resume it. The other properties cannot be changed in Operation mode.
Script Statistics
Read-only performance statistics for the running script.
| Field | Description |
|---|---|
| Avg Execution Time | The average time per script pass, in milliseconds. |
| Total Passes | The total number of script passes run. |
| Skipped Passes | The number of script passes that were skipped. |
| Avg Load Factor | The average processing load of the script. |
Actions
- Delete — Removes the Control Panel Group from the Site.
- Duplicate — Creates a copy of the Control Panel Group.
- Export — Saves the Control Panel Group to a file so it can be reused in another Site.
These buttons are unavailable in Operation mode.