Add monitor_cpu_load command

Makefile

@@ -85,6 +85,10 @@ ifeq ($(shell pkg-config --atleast-version=1.9.0 jack && echo true), true)
 INCS += -DHAVE_JACK2
 endif
 
+ifeq ($(shell pkg-config --atleast-version=1.9.23 jack && echo true), true)
+INCS += -DHAVE_JACK2_1_9_23
+endif
+
 ifeq ($(HAVE_NE10),true)
 LIBS += -lNE10
 INCS += -DHAVE_NE10

README.md

@@ -91,7 +91,7 @@ Options
     -i, --interactive
         interactive shell mode
 
-    -n, --nofork 
+    -n, --nofork
         run in non-forking mode
 
     -V, --version
@@ -107,15 +107,26 @@ Commands (or Protocol)
 The commands supported by mod-host are:
 
     add <lv2_uri> <instance_number>
-        * add an LV2 plugin encapsulated as a jack client
+        * add an LV2 plugin encapsulated as a jack client, in activated state
         e.g.: add "http://lv2plug.in/plugins/eg-amp" 0
         instance_number must be any value between 0 ~ 9990, inclusively
 
     remove <instance_number>
-        * remove an LV2 plugin instance (and also the jack client)
+        * remove an LV2 plugin instance, and also the jack client
         e.g.: remove 0
         when instance_number is -1 all plugins will be removed
 
+    activate <instance_number> <activate_value>
+        * toggle effect activated state
+        e.g.: activate 0 1
+        if activate_value = 1 activate effect
+        if activate_value = 0 deactivate effect
+
+    preload <lv2_uri> <instance_number>
+        * add an LV2 plugin encapsulated as a jack client, in deactivated state
+        e.g.: preload "http://lv2plug.in/plugins/eg-amp" 0
+        instance_number must be any value between 0 ~ 9990, inclusively
+
     preset_load <instance_number> <preset_uri>
         * load a preset state of an effect instance
         e.g.: preset_load 0 "http://drobilla.net/plugins/mda/presets#JX10-moogcury-lite"
@@ -132,10 +143,26 @@ The commands supported by mod-host are:
         * connect two jack ports
         e.g.: connect "system:capture_1" "effect_0:in"
 
+    connect_matching <matching_port> <destination_port>
+        * connect the same connected ports of a port to another, so they match.
+        e.g.: connect "effect_0:in" "effect_1:in"
+
+    connect_safe <origin_port> <destination_port>
+        * safely connect two jack ports, verifying that they exist beforehand
+        e.g.: connect_safe "system:capture_1" "effect_0:in"
+
     disconnect <origin_port> <destination_port>
         * disconnect two jack ports
         e.g.: disconnect "system:capture_1" "effect_0:in"
 
+    disconnect_all <origin_port>
+        * disconnect all connections of a jack port
+        e.g.: disconnect_all "effect_0:in"
+
+    disconnect_safe <origin_port> <destination_port>
+        * safely disconnect two jack ports, verifying that they exist and have connections beforehand
+        e.g.: disconnect_safe "system:capture_1" "effect_0:in"
+
     bypass <instance_number> <bypass_value>
         * toggle effect processing
         e.g.: bypass 0 1
@@ -154,6 +181,17 @@ The commands supported by mod-host are:
         * monitor a control port according to a condition
         e.g: param_monitor 0 "gain" ">" 2.5
 
+    params_flush <instance_number> <reset_value> <param_count> <params...>
+        * flush several param values at once and trigger reset if available
+        * reset value must be according to reset property spec
+        e.g.: params_flush 0 1 2 "gain" 0.0 "distortion" 0.5
+
+    pre_run <instance_number> <reset_value> <param_count> <params...>
+        * pre-run and flush several param values at once and trigger reset if available
+        * reset value must be according to reset property spec
+        * instance must be in deactivated state or global processing disabled (and plugin does not have isLive flag)
+        e.g.: pre_run 0 1 2 "gain" 0.0 "distortion" 0.5
+
     patch_set <instance_number> <property_uri> <value>
         * set the value of a control port
         e.g.: patch_set 0 "gain" 2.5
@@ -176,6 +214,10 @@ The commands supported by mod-host are:
         * request monitoring of an output control port (on the feedback port)
         e.g.: monitor_output 0 "meter"
 
+    monitor_output_off <instance_number> <param_symbol>
+        * turn off monitoring of an output control port (on the feedback port)
+        e.g.: monitor_output_off 0 "meter"
+
     midi_learn <instance_number> <param_symbol> <minimum> <maximum>
         * start MIDI learn for a control port
         e.g.: midi_learn 0 "gain" 0.0 1.0
@@ -189,21 +231,25 @@ The commands supported by mod-host are:
         * unmap the MIDI controller from a control port
         e.g.: midi_unmap 0 "gain"
 
+    monitor_audio_levels <source_port_name> <enable>
+        * monitor audio levels for a specific jack port (on the feedback port)
+        e.g.: monitor_audio_levels "system:capture_1" 1
+
+    monitor_cpu_load <enable> <instance_count> <instance_number...>
+        * monitor cpu load for specific instances
+        e.g.: monitor_cpu_load 1 2 0 1
+
+    monitor_midi_control <midi_channel> <enable>
+        * listen to MIDI control change messages (on the feedback port)
+        e.g.: monitor_midi_control 7 1
+
     monitor_midi_program <midi_channel> <enable>
         * listen to MIDI program change messages (on the feedback port)
         e.g.: monitor_midi_program 0 1
 
-    set_midi_program_change_pedalboard_bank_channel <enable> <midi_channel>
-        * set the MIDI channel which changes pedalboard banks on MIDI program change. <midi_channel> is in the range of [0,15].
-        e.g.: set_midi_program_change_pedalboard_bank_channel 1 5 to enable listening for bank changes on channel 6
-
-    set_midi_program_change_pedalboard_snapshot_channel <enable> <midi_channel>
-        * set the MIDI channel which changes pedalboard snapshots on MIDI program change. <midi_channel> is in the range of [0,15].
-        e.g.: set_midi_program_change_pedalboard_snapshot_channel 1 4 to enable listening for preset changes on channel 5
-
-    cc_map <instance_number> <param_symbol> <device_id> <actuator_id> <label> <value> <minimum> <maximum> <steps> <unit> <scalepoints_count> <scalepoints...>
+    cc_map <instance_number> <param_symbol> <device_id> <actuator_id> <label> <value> <minimum> <maximum> <steps> <extraflags> <unit> <scalepoints_count> <scalepoints...>
         * map a Control Chain actuator to a control port
-        e.g.: cc_map 0 "gain" 0 1 "Gain" 0.0 -24.0 3.0 33 "dB" 0
+        e.g.: cc_map 0 "gain" 0 1 "Gain" 0.0 -24.0 3.0 33 0 "dB" 0
 
     cc_unmap <instance_number> <param_symbol>
         * unmap the Control Chain actuator from a control port
@@ -222,7 +268,10 @@ The commands supported by mod-host are:
         e.g.: cv_unmap 0 "gain"
 
     cpu_load
-        * return current jack cpu load
+        * return current average jack cpu load
+
+    max_cpu_load
+        * return current maximum jack cpu load
 
     load <file_name>
         * load a history command file
@@ -268,6 +317,52 @@ The commands supported by mod-host are:
     output_data_ready
         * report feedback port ready for more messages
 
+    multi_add <instance_count> <lv2_uri,instance_number...>
+        * add an LV2 plugin encapsulated as a jack client, in activated state (multiple instance variant)
+        e.g.: multi_add 2 "http://lv2plug.in/plugins/eg-amp" 0 "http://lv2plug.in/plugins/eg-amp" 1
+        instance_number must be any value between 0 ~ 9990, inclusively
+
+    multi_remove <instance_count> <instance_number...>
+        * remove an LV2 plugin instance, and also the jack client (multiple instance variant)
+        e.g.: multi_remove 2 0 1
+
+    multi_activate <activate_value> <instance_count> <instance_number...>
+        * toggle effect activated state (multiple instance variant)
+        e.g.: multi_activate 0 2 0 1
+        if activate_value = 1 activate effect
+        if activate_value = 0 deactivate effect
+
+    multi_preload <instance_count> <lv2_uri,instance_number...>
+        * add an LV2 plugin encapsulated as a jack client, in deactivated state (multiple instance variant)
+        e.g.: multi_preload 2 "http://lv2plug.in/plugins/eg-amp" 0 "http://lv2plug.in/plugins/eg-amp" 1
+        instance_number must be any value between 0 ~ 9990, inclusively
+
+    multi_bypass <bypass_value> <instance_count> <instance_number...>
+        * toggle effect processing (multiple instance variant)
+        e.g.: multi_bypass 0 2 0 1
+        if bypass_value = 1 bypass effect
+        if bypass_value = 0 process effect
+
+    multi_param_set <param_symbol> <param_value> <instance_count> <instance_number...>
+        * set the value of a control port (multiple instance variant)
+        * must be instances of the same plugin
+        e.g.: multi_param_set "gain" 2.5 2 0 1
+
+    multi_params_flush <reset_value> <instance_count> <instance_number...> <param_count> <params...>
+        * flush several param values at once and trigger reset if available (multiple instance variant)
+        * reset value must be according to reset property spec
+        * all instances must be in activated state
+        e.g.: multi_params_flush 1 2 0 1 2 "gain" 0.0 "distortion" 0.5
+
+    multi_pre_run <reset_value> <instance_count> <instance_number...> <param_count> <params...>
+        * pre-run and flush several param values at once and trigger reset if available (multiple instance variant)
+        * reset value must be according to reset property spec
+        * all instances must be in deactivated state or global processing disabled (and plugins do not have isLive flag)
+        e.g.: multi_pre_run 1 2 0 1 2 "gain" 0.0 "distortion" 0.5
+
+    wait_audio_cycle
+        * wait for at least 1 audio cycle to pass
+
     help
         * show a help message
 
@@ -300,12 +395,16 @@ If status is a negative number an error has occurred. The table below shows the
 | -204    | ERR\_JACK\_PORT\_REGISTER        |
 | -205    | ERR\_JACK\_PORT\_CONNECTION      |
 | -206    | ERR\_JACK\_PORT\_DISCONNECTION   |
+| -207    | ERR\_JACK\_VALUE\_OUT\_OF\_RANGE |
 | -301    | ERR\_ASSIGNMENT\_ALREADY\_EXISTS |
 | -302    | ERR\_ASSIGNMENT\_INVALID\_OP     |
 | -303    | ERR\_ASSIGNMENT\_LIST\_FULL      |
 | -304    | ERR\_ASSIGNMENT\_FAILED          |
+| -304    | ERR\_ASSIGNMENT\_UNUSED          |
 | -401    | ERR\_CONTROL\_CHAIN\_UNAVAILABLE |
 | -402    | ERR\_LINK\_UNAVAILABLE           |
+| -403    | ERR\_HMI\_UNAVAILABLE            |
+| -404    | ERR\_EXTERNAL\_UI\_UNAVAILABLE   |
 | -901    | ERR\_MEMORY\_ALLOCATION          |
 | -902    | ERR\_INVALID\_OPERATION          |