Differences

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

--- config:remotecontrol:emberplus [2016/09/06 09:16] – [Commands] tw
+++ config:remotecontrol:emberplus [2020/02/27 10:25] (current) – [Supported Hardware] tw
@@ Line 15: / Line 15: @@
 A list of manufacturers who have implemented Ember+ in their products can be found [[https://github.com/Lawo/ember-plus/wiki|in the ember-plus Wiki]]. Products include [[https://www.lawo.com/de/produkte/virtual-radio/r3lay-vrx-jade-studio.html|Lawo R3LAY VRX]] (formerly JADE Studio), and also DHD Series 52 with firmware 8.x.x.x (as an alternative or addition to the native DHD control protocol).
+===== System Requirements =====
+The Ember+ remote is based on ember_slim.dll which requires Microsoft Visual C++ Redistributable 2013 **x86** to be installed on your system: http://www.microsoft.com/en-us/download/details.aspx?id=40784
 ===== Configuration =====
@@ Line 34: / Line 38: @@
 On the //Commands// tab, you assign [[reference:remote_control_commands|remote control commands]] to Ember+ parameter changes.
-{{ :config:remotecontrol:pasted:20160906-090831.png }}
+{{ :config:remotecontrol:pasted:20160906-090831.png?400 }}
-Parameter names are specified in a path-like manner, using the ''/'' sign as a separator.
+Parameter names are specified in a path-like manner, using the ''/'' sign as a separator. The easiest way to assign a command to a parameter is to double-click a parameter in the monitor or parameter tree view, but you may also add one manually.
 For numeric parameters, various conditions (equal, greater than, greater or equal, ...) can be used to match the received value.
@@ Line 44: / Line 48: @@
 Please note that boolean parameters use the values ''true'' and ''false'' (in lower case letters).
 ==== Parameter tree ====
+When the monitor function is enabled on the //Connection// tab, mAirList will propagate the parameter tree which is display on the last tab of the configuration dialog:
 {{ :config:remotecontrol:pasted:20160906-090918.png?400 }}
+Parameter updates received from the provider will be displayed in real time, and you can also double-click any parameter in order to assign a remote control command to it (see above).
+===== Scripting =====
+The Ember+ remote control provides a script extension that can be used to send parameter updates to the Ember+ provider from a script.
+The remotes are accessed by the following function:
+  function EmberPlusConsumerRemote(iIndex: integer): IEmberPlusConsumerRemote;
+Remotes are 0-based, so ''EmberPlusConsumerRemote(0)'' returns the first Ember+ remote in the system, as a reference to an ''IEmberPlusConsumerRemote'' interface. That interface provides a method for parameter updates:
+  procedure SetParameterValue(iIDPath: string; iValue: string);
+''IDPath'' is the path to the parameter in the tree, using the ''/'' sign as the delimiter (the same notation as used in the remote control command assignments, see above).
+Example:
+  EmberPlusConsumerRemote(0).SetParameterValue('/Device/SomeLabel', 'foobar');
+Note that the value is always given as a string, mAirList will automatically convert it to the correct type. Use '''true''' and '''false''' for boolean parameters.
+Important notice: mAirList fetches the entire parameter tree from the provider. This is an asynchronous operation, and depending on the size of the tree, it can take a few seconds until the entire tree is known to mAirList. If you try to set a parameter that has not been fetched yet (e.g. in an ''OnLoad'' procedure that is executed during startup), you wil see an //Unknown parameter// error message. In this case, try to defer the call for a bit, using a ''sleep(...)'' operation.