Linking widgets to your site with My targets
Widgets control real equipment through targets: controllers, zones, groups, devices and system variables read from a site in the zencontrol cloud. You build a short list of targets for the project in My targets, then apply one to each widget. Manual IP and address entry is no longer used.
1. Sign in
Click My targets in the toolbar.
Click Sign in with zencontrol and complete the sign-in in the window that opens.
Once signed in, the My targets window shows Refresh, the time of the last refresh, Re-sync IPs and Sign out.
2. Choose the site
Pick the site from the Site list. Every site your account can access is listed.
If the site has tenancies, filter with Tenancy (default All tenancies).
Use Search targets... to find a target by name or address.
3. Add targets to the project
The window has two lists: Site targets on the left and My targets (the project's list) on the right. Each has tabs:
| Tab | Lists | Shown as |
|---|---|---|
| Controller | Each application controller on the site | Number, name and model; once added it is used as that controller's Broadcast target |
| Zone | Zones (including multicast zones) | Zone name and its multicast address |
| Group | DALI groups per controller | Controller name, group number and name |
| Device | Individual DALI devices | Controller.address and name, for example 1.0 |
| Variable | System variables | Variable name per controller |
To add targets:
Tick one or more rows and click the > arrow in the middle, or
Double-click a row to move it across straight away.
To remove targets, tick them in My targets and click <, or double-click them. The tab labels on the right show counts, for example Group 2, Device 1. Close the window when done.
4. Apply a target to a widget
Select the widget.
In Command / Target (or Targeting on data widgets, Targets on Schedule buttons), click Use my targets.
A list of your saved targets opens, grouped by type, each with its controller's IP address. Click one.
The target now shows at the top of the section, and the widget's command fields appear.
Each widget only offers the target types it can use:
| Widget | Target types offered |
|---|---|
| Command button, On/off button, sliders, colour widgets | Groups, devices, zones, broadcast (On/off and Command also accept system variables) |
| Data slider, Variable, Adjustable data | System variables only |
| Schedule button | Up to 20 groups, devices, zones or broadcast (not system variables) |
If the list says No matching targets, add a target of the right type in My targets first.
Keeping targets current
Refresh reloads the site's controllers, groups, devices and variables after changes in the zencontrol app.
Re-sync IPs updates the controller IP addresses stored with your targets, for example after a controller is re-addressed. Re-sync before saving a project for site handover.
Targets are saved in the project file, so reopening the project restores each widget's target.
Tips
Name groups and devices well in the zencontrol site before you start; those names are what you will pick from.
Add only the targets the project needs. A short My targets list makes applying them quick.
The builder may briefly show a rate-limit banner on very large sites while it loads data; it retries automatically.
