Example

====== Enable/Disable DMX Outputs ======

^ by: | Sebastian Beutel, March 2020 |
^ published: | here |
^ description: | enables/disables DMX outputs |
^ remarks: | idea: https://www.facebook.com/groups/1811437589141428/permalink/2601186196833226/ |

{{tag>enable disable output dmx artnet sacn}}

==== functions ====
  * [[:macros:function:Dmx.EnableDmxModule]]
 
===== Code =====
<code xml enableOutputs.xml>
<?xml version="1.0" encoding="utf-8"?>
<avolites.macros>

  <macro id="wiki.enableArtnet" name="Enable Artnet Output">
    <sequence>
      <step>Dmx.EnableDmxModule("LocalDevice", "5", true)</step>
    </sequence>
  </macro>
  <macro id="wiki.disableArtnet" name="Disable Artnet Output">
    <sequence>
      <step>Dmx.EnableDmxModule("LocalDevice", "5", false)</step>
    </sequence>
  </macro>
	
  <macro id="wiki.enableSacn" name="Enable sACN Output">
    <sequence>
      <step>Dmx.EnableDmxModule("LocalDevice", "10", true)</step>
    </sequence>
  </macro>
  <macro id="wiki.disableSacn" name="Disable sACN Output">
    <sequence>
      <step>Dmx.EnableDmxModule("LocalDevice", "10", false)</step>
    </sequence>
  </macro>
	
  <macro id="wiki.enableDmx" name="Enable DMX Output">
    <sequence>
      <step>Dmx.EnableDmxModule("LocalDevice", "7", true)</step>
    </sequence>
  </macro>
  <macro id="wiki.disableDmx" name="Disable DMX Output">
    <sequence>
      <step>Dmx.EnableDmxModule("LocalDevice", "7", false)</step>
    </sequence>
  </macro>

</avolites.macros>
</code>


===== Explanation =====

This explains the functional steps within the sequence. For all the other XML details please refer to [[:macros:formats_and_syntax#xml_format|Formats and syntax]]

In order to ensble/disable the various DMX output modules [[:macros:function:Dmx.EnableDmxModule]] is called with appropriate parameters:
  * ''"LocalDevice"'' is the dfeNodeId for the local outputs, i.e. not those at a TNP
  * ''"5"'', ''"7"'' or ''"10"'' denote the output modules Art-Net, DMX or sACN
  * ''true'' resp. ''false'' indicate whether to enable or disable this output

===== How to use it =====

  - [[:macros:deploying|make this macro available]]
  - trigger such a macro in order to enable/disable an output


~~DISCUSSION~~