Differences

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

--- config:remotecontrol:emberplus [2016/09/06 09:19] – [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 53: / Line 57: @@
 ===== 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.