Merge pull request #3580 from LinuxCNC/python_halui

ZMQ messages from HALUI to GUIs

See those recent commits:

d0ac241  qtvcp -pushbutton: fix setting of group pin type
8c7ef3a axis -docs: add info about HALUI gui pins
b87ecdc axis -sim: for halui zmq messages
08846ca axis -incorporate zmq messages
4c03568 gmoccapy -add docs for halui messages
f25a9cb gmoccapy -add a halui test config with a sim test panel
2c229a6 gmoccapy -dialogs: allow setting of message type for yes/no dialog
814ca65 gmoccapy -fix request to run macro with variables
a6c2482 gmoccapy -fix request macro function to call macro properly
2ad3a0b gmoccapy -create a dialog in gmoccapy for system shutdown
7552e60 gmoccapy -dialogs: cleanup/fixes
8763580 gmoccapy -add MPG input to zoom and scroll
e28edfe gmoccapy -respond to softkeys and make exit do shutdown
29a41fb gmoccapy -honour shutdown request
900acbd gmoccapy -update the angular speedcontrol to new angular type
eb46c63 gmoccapy -dialogs: search through focused dialogs, clean up code
1766ccb gmoccapy -entry dialog respond to halui, add non blocking wait code
fe0ac1d gmoccapy -update external pause/start behavior
ba36508 gmoccapy -can submit the current MDI command from HALUI
e1e7b58 gmoccapy -use halui message to cancel notifications
b25c710 gmoccapy -set jog speed control widget to use messages
e7514d7 gmoccapy -change warning dialogs to accept HALUI messages
d61f24f gmoccapy -change system dialog to accept halui messages
5466ba2 gmoccapy -used new mode return INI MDI function
5e4c53a gmoccapy -add gstat message control of start and pause
45a82f5 gmoccapy -ability to run INI MDI commands using HAL bridge
5d45ef0 gmoccapy -allow ZMQ messages to call macros in gmoccapy
38cdc1c qtdragon -add docs for halui messages/gui pins
c0e0fb6 qtdragon -add halui test sim
2459b4f qtdragon -adjust request macro function signature
78ba9e9 qtdragon -add basic support for softkeys to select main tabs
bcb5f0b qtdragon -external run of macros, use cycle start for MDI running
2416dea qtdragon -fix MPG selection from panel
b930b9f qtdragon -find the currently visible dialog to send messages to
a03370e qtdragon -add mpg_select button logic control
432d089 qtdragon -adjust external pause message to toggle
6e43ebb common/iniinfo -parse ini commands in a better way
851d6df qtvcp -allow setting of window title from designer
35b69b1 qtvcp -fix close dialog response when using zmq messages
c2a036f qtvcp -dialog_widget: check ZMQ messages directly
2638f03 qtvcp -axis tool button: allow for MPG selection
c372dce qtvcp -baseclass: register dialogs for later checks
429ae62 qtvcp -dialog widget: add status message control of tool change dialog
b52b5bd gladevcp -gtk_action: get shutdown to work reliably
d594e96 gladevcp -hal_gremlin: clear the plot if reloading the screen
3144696 qtvcp/gladevcp -action: add ability; return to mode after INI mdi
b2fed2c gladevcp -gtk_action: add ability to run new style INI MDI commands
450da54 gladevcp -speedcontrol: add angular jograte type and command and Gstat
e1869a5 halui - add docs for halui zmq messages and pins
7836c07 bridge -Don't break everything if there is no ZMQ library
a3dbe9e bridge - send out a key string with macro/mdi name
9da2cc9 halui/bridge -quiet print statements
1015177 halui -change gui. pin names
822e4c1 halui -add softkey pins and message
d1ba8cc halui -add reload display and shutdown pins
ee2369c hal_bridge -add a warning if the write address is already used
d8e9af9 halui -use angular jograte pin/messages for angular axis
29c46c4 halui -add an angular jograte pin and send angular jograte messages
72ab87b halui initial testing of embedded python halui
cffe26d add python3-zmq to python3 depends
0741c23 add python3-zmq package for halui
0f3d22e hal_glib -check if zmq read socket is available
7aaff76 hal_glib -add soft key messages
3b8bdf9 hal_glib -change request macro function signature to add a key string
eb1e890 hal_glib -add function to process one ZMQ message
75e015e hal_glib -add a function to run the gobject mainloop once

Author: hansu

docs/src/gui/gmoccapy.adoc

@@ -940,64 +940,50 @@ So writing a program makes you responsible to include an G43 after each tool cha
 HALUI will create halui.gui pins that interface with GMOCCAPY. +
 This could be used to connect a control panel that interacts better with GMOCCAPY.
 
-- There is a cycle start and pause pin - these call the code in GMOCCAPY rather then the motion controller. +
-- If there are macros/mdi commands defined in the INI there will be (up to 64) pins available to initiate them. +
-- clear/reload the display
-- shutdown the linux system
-- ok/cancel of dialogs and notify (error) messages
 - HALUI selected axis will be reported to GMOCCAPY. +
 - HALUI selected jog rate will be reported to GMOCCAPY. +
 In either case the last changed rate/axis (either HALUI or GMOCCAPY) will be used for screen button jogging or HALUI pin jogging.
-- Zoom the gcode display with an MPG
-
-=== Typical HAL pins available:
-----
-Component Pins:
-Owner   Type  Dir                 Value  Name
-    25  bit   IN                  FALSE  halui.gui.cycle-pause
-    25  bit   IN                  FALSE  halui.gui.cycle-start
-    25  bit   IN                  FALSE  halui.gui.mdi-command.MACRO0
-    25  bit   IN                  FALSE  halui.gui.mdi-command.MACRO1
-    25  bit   IN                  FALSE  halui.gui.mdi-command.MACRO2
-    25  bit   IN                  FALSE  halui.gui.mdi-command.MACRO3
-    25  bit   IN                  FALSE  halui.gui.mdi-command.0
-    25  bit   IN                  FALSE  halui.gui.mdi-command.1
-    25  bit   IN                  FALSE  halui.gui.mpg-aux.0
-    25  bit   IN                  FALSE  halui.gui.reload-preview
-    25  bit   IN                  FALSE  halui.gui.response.cancel
-    25  bit   IN                  FALSE  halui.gui.response.ok
-    25  bit   IN                  FALSE  halui.gui.shutdown
-    25  bit   IN                  FALSE  halui.gui.softkey.00
-    25  bit   IN                  FALSE  halui.gui.softkey.01
-    25  bit   IN                  FALSE  halui.gui.softkey.02
-    25  bit   IN                  FALSE  halui.gui.softkey.03
-    25  bit   IN                  FALSE  halui.gui.softkey.04
-    25  bit   IN                  FALSE  halui.gui.softkey.05
-    25  bit   IN                  FALSE  halui.gui.softkey.06
-    25  bit   IN                  FALSE  halui.gui.softkey.07
-    25  bit   IN                  FALSE  halui.gui.softkey.08
-    25  bit   IN                  FALSE  halui.gui.softkey.09
-    25  bit   IN                  FALSE  halui.gui.softkey.10
-    25  bit   IN                  FALSE  halui.gui.softkey.11
-    25  bit   IN                  FALSE  halui.gui.softkey.12
-    25  bit   IN                  FALSE  halui.gui.softkey.13
-    25  bit   IN                  FALSE  halui.gui.softkey.14
-    25  bit   IN                  FALSE  halui.gui.softkey.15
-    25  bit   IN                  FALSE  halui.gui.softkey.16
-    25  bit   IN                  FALSE  halui.gui.softkey.17
-    25  bit   IN                  FALSE  halui.gui.softkey.18
-    25  bit   IN                  FALSE  halui.gui.softkey.19
-
-----
-
-=== HALUI GUI Cycle Start
-The halui.gui.cycle-start pin will request GMOCCAPY to start a cycle. +
-GMOCCAPY will decide what will happen by what mode it's in. +
-In Auto mode, a loaded gcode program will run. +
-In MDI mode, the command in GMOCCAPY's MDI line will run.  
 
+=== Pins
+
+- *halui.gui.cycle-pause* _(bit IN)_ - This will pause a running MDI command or a running program.
+- *halui.gui.cycle-start* _(bit IN)_ - This will request GMOCCAPY to start a cycle. 
+GMOCCAPY will decide what will happen by what mode it's in. 
+In Auto mode, a loaded gcode program will run. In MDI mode, the command in GMOCCAPY's MDI line will run.  
+- *halui.gui.mdi-command.MACRO-_NN_* _(bit IN)_ - See <<gmocccapy-halui-mdi-commands,HALUI MDI Commands>>.
+- *halui.gui.mdi-command._NN_* _(bit IN)_ - See <<gmocccapy-halui-gui-macros,HALUI GUI Macros>>.
+- *halui.gui.mpg-aux.0* _(bit IN)_ - Enabling this pin will allow zooming of the gcode plot with the gmoccapy.mpg-in pin, typically connected to an MPG encoder count pin.
+- *halui.gui.reload-preview* _(bit IN)_ - Clear/reload the preview
+- *halui.gui.response.cancel* _(bit IN)_ - Close notification/message dialog
+- *halui.gui.response.ok* _(bit IN)_ - Confirm notification/message dialog
+- *halui.gui.shutdown* _(bit IN)_ - If true, a confirmation dialog will display.
+If the system supports a builtin shutdown option dialog, it will show, otherwise the system will immediately shutdown. 
+- *halui.gui.softkey.00* _(bit IN)_
+- *halui.gui.softkey.01* _(bit IN)_
+- *halui.gui.softkey.02* _(bit IN)_
+- *halui.gui.softkey.03* _(bit IN)_
+- *halui.gui.softkey.04* _(bit IN)_
+- *halui.gui.softkey.05* _(bit IN)_
+- *halui.gui.softkey.06* _(bit IN)_
+- *halui.gui.softkey.07* _(bit IN)_
+- *halui.gui.softkey.08* _(bit IN)_
+- *halui.gui.softkey.09* _(bit IN)_
+- *halui.gui.softkey.10* _(bit IN)_
+- *halui.gui.softkey.11* _(bit IN)_
+- *halui.gui.softkey.12* _(bit IN)_
+- *halui.gui.softkey.13* _(bit IN)_
+- *halui.gui.softkey.14* _(bit IN)_
+- *halui.gui.softkey.15* _(bit IN)_
+- *halui.gui.softkey.16* _(bit IN)_
+- *halui.gui.softkey.17* _(bit IN)_
+- *halui.gui.softkey.18* _(bit IN)_
+- *halui.gui.softkey.19* _(bit IN)_ - Softkeys 0 - 11 control GMOCCAPY's main tab keys: +
+halui.gui.softkey.00 - halui.gui.softkey.06 are the vertical keys. +
+halui.gui.softkey.10 - halui.gui.softkey.09 are the horizontal keys.
+
+[[gmocccapy-halui-gui-macros]]
 === HALUI GUI Macros
-One can initiate GMOCCAPY styled Macros from HALUI pins. +
+One can initiate GMOCCAPY styled macros from HALUI pins. +
 These would be the macros found in the INI under the heading [MACROS] +
 These call Oword subroutines of the same name. +
 These Oword subroutines can require variables supplied at runtime by the user. + 
@@ -1023,7 +1009,8 @@ The above example 'increment', will prompt the user for two values 'xinc' and 'y
 All defined Oword files must be located on the system as defined in the
 [DISPLAY]PROGRAM_PREFIX or [RS274NGC]SUBROUTINE_PATH INI entries.
 
-=== HALUI INI MDI Commands
+[[gmocccapy-halui-mdi-commands]]
+=== HALUI MDI Commands
 One can initiate MDI Command Macros from HALUI pins. +
 MDI commands are defined under the heading [MDI_COMMAND_LIST] as +
 MDI_COMMAND_MACRO0 = gcode +
@@ -1053,18 +1040,7 @@ Then move to X0 and Y0 in the current user system, and finally move the Z axis t
 The sequence will run like this: move Z axis up first in G53 (machine coordinate system) mode. +
 Then move to X0 and Y0 in the G53 mode.
 
-=== Soft Keys
-Softkeys 0 - 11 control GMOCCAPY's main tab keys: +
-halui.gui.softkey.00 - halui.gui.softkey.06 are the vertical keys. +
-halui.gui.softkey.10 - halui.gui.softkey.09 are the horizontal keys.
 
-=== MPG-Aux
-Enabling halui.gui.mpg-aux.0, will allow zooming of the gcode plot with the gmoccapy.mpg-in pin, typically connected to an MPG encoder count pin.
-
-=== Shutdown
-If halui.gui.shutdown is set true, a confirmation dialog will display. +
-If confirmed, the whole linux system will shutdown. +
-If the system supports a builtin shutdown option dialog, it will show, otherwise the system will immediately shutdown. 
 
 
 [[gmoccapy:auto-tool-measurement]]

docs/src/gui/halui.adoc

@@ -117,18 +117,17 @@ Or see http://linuxcnc.org/docs/devel/html/man/man1/halui.1.html
 * 'halui.feed-override.scale' (float, in) - pin for setting the scale for increase and decrease of 'feed-override'.
 * 'halui.feed-override.value' (float, out) - current FO value
 
-=== Gui
+=== GUI
 These are pins used to 'request' a function to run in a screen. +
 What these exactly do is dependant on the (GUI) screen used. 
 
 * 'halui.gui.cycle-start' (bit, in) - pin for requesting the screen to run a cycle
 * 'halui.gui.cycle-pause' (bit, in) - pin for requesting the screen to pause a cycle
 * 'halui.gui.response.cancel' (bit, in) - pin for cancel/closing dialogs
 * 'halui.gui.response.ok' (bit, in) - pin for ok/apply dialogs
-* 'halui.gui.mdi-command.MACRO_<nn>_' (bit, in) - pin for calling mdi commands
-* 'halui.gui.mdi-command._<nn>_' (bit, in) - pin for calling macro commands
-_<nn>_ is a one or two digit number starting from 0 to 63 +
-There can be up to 64 commands defined in the INI under the [MDI_COMMAND_LIST] or [MACROS] headings. +
+* 'halui.gui.mdi-command._<nn>_' (bit, in) - pin for calling macros if defined in the INI in the [MACROS] section
+* 'halui.gui.mdi-command.MACRO_<nn>_' (bit, in) - pin for calling mdi commands. _<nn>_ is a one or two digit number starting from 0 to 63. +
+There can be up to 64 commands defined in the INI under the [MDI_COMMAND_LIST]. +
 * 'halui.gui.reload-preview' (bit, in) - pin for reloading the screen plot
 * 'halui.gui.shutdown' (bit, in) - pin for shutting down linuxcnc or system
 * 'halui.gui.softkey._<nn>_' (bit, in) - pins for screen defined functions