docs: moved GladeVCP related part to GladeVCP page

Author: hansu

docs/src/gui/gladevcp.adoc

@@ -3032,6 +3032,42 @@ def get_handlers(halcomp,builder,useropts):
     return [HandlerClass(halcomp,builder,useropts)]
 ----
 
+=== Value-changed callback with hal_glib
+
+GladeVCP uses the hal_glib library, which can be used to connect a "watcher" signal on a HAL input pin. +
+This signal can be used to register a function to call when the HAL pin changes state. +
+
+One must import the `hal_glib` and the `hal` modules:
+
+[source,python]
+----
+import hal_glib
+import hal
+----
+
+Then make a pin and connect a 'value-changed' (the watcher) signal to a function call:
+
+[source,python]
+----
+class HandlerClass:
+    def __init__(self, halcomp,builder,useropts):
+        self.example_trigger = hal_glib.GPin(halcomp.newpin('example-trigger', hal.HAL_BIT, hal.HAL_IN))
+        self.example_trigger.connect('value-changed', self._on_example_trigger_change)
+----
+
+And have a function to be called:
+
+[source,python]
+----
+    def _on_example_trigger_change(self,pin,userdata=None):
+        print("pin value changed to: {}".format(pin.get()))
+        print("pin name= {}".format(pin.get_name()))
+        print("pin type= {}".format(pin.get_type()))
+
+        # this can be called outside the function
+        self.example_trigger.get()
+----
+
 === Examples, and rolling your own GladeVCP application
 
 Visit `linuxcnc_root_directory/configs/apps/gladevcp` for running

docs/src/hal/halmodule.adoc

@@ -193,96 +193,4 @@ Read these to acquire information about the realtime system.
 * is_sim
 * is_userspace
 
-== Use with hal_glib in GladeVCP Handler
-
-GladeVCP uses the hal_glib library, which can be used to connect a "watcher" signal on a HAL input pin. +
-This signal can be used to register a function to call when the HAL pin changes state. +
-
-One must import the `hal_glib` and the `hal` modules:
-
-[source,python]
-----
-import hal_glib
-import hal
-----
-
-Then make a pin and connect a 'value-changed' (the watcher) signal to a function call:
-
-[source,python]
-----
-class HandlerClass:
-    def __init__(self, halcomp,builder,useropts):
-        self.example_trigger = hal_glib.GPin(halcomp.newpin('example-trigger', hal.HAL_BIT, hal.HAL_IN))
-        self.example_trigger.connect('value-changed', self._on_example_trigger_change)
-----
-
-And have a function to be called:
-
-[source,python]
-----
-    def _on_example_trigger_change(self,pin,userdata=None):
-        print("pin value changed to: {}".format(pin.get()))
-        print("pin name= {}".format(pin.get_name()))
-        print("pin type= {}".format(pin.get_type()))
-
-        # this can be called outside the function
-        self.example_trigger.get()
-----
-
-== Use with hal_glib in QtVCP Handler
-
-QtVCP uses the hal_glib library, which can be used to connect a "watcher" signal on a HAL input pin.
-This signal can be used to register a function to call when the HAL pin changes state.
-
-One must import the `hal` module:
-
-[source,python]
-----
-import hal
-----
-
-Then make a pin and connect a 'value_changed' (the watcher) signal to a function call:
-
-[source,python]
-----
-    ########################
-    # **** INITIALIZE **** #
-    ########################
-    # widgets allows access to  widgets from the qtvcp files
-    # at this point the widgets and HAL pins are not instantiated
-    def __init__(self, halcomp,widgets,paths):
-        self.hal = halcomp
-        self.testPin = self.hal.newpin('test-pin', hal.HAL_BIT, hal.HAL_IN)
-        self.testPin.value_changed.connect(lambda s: self.setTestPin(s))
-----
-
-And have a function to be called.
-This shows ways to get the pin value and information.
-
-[source,python]
-----
-    #####################
-    # general functions #
-    #####################
-    def setTestPin(self, data):
-        print("Test pin value changed to:" % (data))
-        print('halpin object =', self.w.sender())
-        print('halpin name: ',self.sender().text())
-        print('halpin type: ',self.sender().get_type())
-
-        # this can be called outside the function
-        print(self.testPin.get())
-----
-
-== Project ideas
-
-* Create an external control panel with buttons, switches, and indicators.
-  Connect everything to a microcontroller, and connect the microcontroller to the PC using a serial interface.
-  Python has a very capable serial interface module called https://pyserial.readthedocs.io/en/latest/[pyserial]
-  (Ubuntu package name "python3-serial", in the universe repository).
-* Attach a http://lcdproc.omnipotent.net/[LCDProc]-compatible LCD module
-  and use it to display a digital readout with information of your choice
-  (Ubuntu package name "lcdproc", in the universe repository).
-* Create a virtual control panel using any GUI library supported by Python (gtk, Qt, wxWindows, etc.).
-
 // vim: set syntax=asciidoc: