Differences

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

--- config:remotecontrol:k8055 [2019/09/23 15:04] – [Supported Hardware] 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)
+as well as their (now obsolete) predecessors
+  * [[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.)
-The VM110(N) device is virtually the same as the K8055(N) but comes fully assembled, whereas the latter has to be completed by soldering first.
 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);