Differences

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

--- config:remotecontrol:k8055 [2019/09/23 14:56] – Analogausgang ergänzt tondose
+++ config:remotecontrol:k8055 [2022/08/25 15:12] (current) – Erg. tondose
@@ Line 1: / Line 1: @@
-====== Velleman K8055 and K8055N ======
+====== Velleman K8055 ======
 This article describes remote control for the Velleman K8055 family of USB experiment boards.
@@ Line 7: / Line 7: @@
 Supported Velleman products are:
-  * [[http://www.velleman.eu/products/view/?id=404880|K8055N]]
+  * [[https://www.velleman.eu/products/view/?id=461858|WSI8055N]] (kit for self-assembly)
-  * [[http://www.velleman.eu/products/view/?id=351346|K8055]] (obsolete old version)
+  * [[https://www.velleman.eu/products/view/?id=460494|WPI110N]] (assembled device)
-  * [[http://www.velleman.eu/products/view/?id=404998|VM110N]]
-  * [[http://www.velleman.eu/products/view/?id=351980|VM110]] (obsolete old version)
-mAirList supports the five digital inputs for the triggering of remote commands.
+as well as their (now obsolete) predecessors
-The digital outputs as well as the analogue output can be used via scriptirng.
+  * [[https://www.velleman.eu/products/view/?id=404880|K8055N]]
+  * [[https://www.velleman.eu/products/view/?id=351346|K8055]]
+  * [[https://www.velleman.eu/products/view/?id=404998|VM110N]]
+  * [[https://www.velleman.eu/products/view/?id=351980|VM110]]
+(To keep the editing effort as low as possible, all these units are referred to as //K8055// throughout the software and this documentation.)
+mAirList supports the five digital inputs for triggering of [[reference:remote_control_commands|remote commands]] directly. The digital as well as the analogue outputs can be used via scripting.
+----
 ===== Configuration =====
@@ Line 29: / Line 37: @@
 Then you can assign a [[reference:remote_control_commands|command]] for each input 1-5, and for the event that the pin goes ON or OFF, respectively.
+----
 ===== Scripting =====
@@ Line 38: / Line 48: @@
   function K8055Remote(iIndex: integer): IK8055Remote;
-''iIndex'' is the number of the K8055 remote set up in the system, with 0 being the first (and often) only one.
+''iIndex'' is the number of the K8055 remote set up in the system, with ''0'' being the first (and often only) one („zero-based“).
 The function will return a reference to a ''IK8055Remote'' interface, which provides amongst others the following methods:
@@ Line 45: / Line 55: @@
   procedure ClearDigitalChannel(Channel: integer);
   procedure ClearAllDigital;
+''Channel'' refers to the digital channels, where ''1'' is the first one („one-based“).
 A complete call for switching on (setting) digital channel 3 on the first Velleman unit then should look like this:
   K8055Remote(0).SetDigitalChannel(3);
+=== Digital Inputs ===
+The status of the digital inputs can be read by the fucntions
+  function ReadDigitalChannel(Channel: integer): boolean;
+  function ReadAllDigital: integer;
+The former reads the status for each input individually, e. g. for channel 2:
+  K8055Remote(0).ReadDigitalChannel(2);
+whereas the latter gives a complete survey of all five inputs via the five least significant bits.
+Example:
+A value of 25 corresponds to inputs 1, 4 and 5 being set („on“) and inputs 2 and 3 being cleared „off“).
+⋅ 2⁰ + 0 ⋅ 2¹ + 0 ⋅ 2² + 1 ⋅ 2³ + 1 ⋅ 2⁴  =  1 + 0 + 0 + 8 + 16  =  25
+  ^        ^       ^        ^       ^
+  Bit 1    |       Bit 3    |       Bit 5
+  Inp 1    Bit 2   Inp 3    Bit 4   Inp 5
+           Inp 2            Inp 4
 === Analogue Outputs ===
-The analogue output can be actuated with the following method:
+The analogue outputs can be actuated with the following method:
   procedure OutputAnalogChannel(Channel, Value: integer);