In this month’s first tip, we will look at establishing a connection to a console or device outputting EDMX, the proprietary DMX-over- Ethernet protocol used by ETC consoles such as Eos, Ion, or Congo, or by ETC devices such as Net2 Nodes.
Establishing the Connection
The most important thing to remember for this connection is that unlike when connecting to all other consoles or devices, wysiwyg connects to an EDMX network/source ‘natively’—that is, the Device Manager in Live mode is not used. Instead, wysiwyg simply needs to be configured to look for an EDMX network; if available, wysiwyg will connect to it on startup and begin receiving EDMX data packets as soon as a file is open.
Enabling EDMX Reception
To configure wysiwyg for EDMX reception:
1. Run wysiwyg.
2. Without opening a file, click the Options menu and select Application Options.
Result: the Application Options window opens.
3. Click the Additional Interfaces tab.
4. In the ETC Interface section, click the Allow EDMX reception checkbox.
5. If needed, change the ETCNet 2 Version as required, although in most cases you will be using V4.
6. Click OK to save this setting.
Result: a message appears stating that you have to restart wysiwyg in order for these settings to take effect.
7. Click OK to close this message.
8. Click the File menu and select Exit to close wysiwyg.
Disabling the Firewall
Any firewall software that may be running on the computer also running wysiwyg, including the Windows Firewall, must be disabled in order for it to be able to receive EDMX data packets. The Windows Firewall is disabled via its control panel; please consult Win- dows Help for information on using it. If you use another firewall, perhaps one that is part of a “security suite”, please consult the documentation/help that came with the software for instructions on how to disable it.
Configuring AppMux in Windows 7 or Vista
Before starting wysiwyg once again, and if using a version of Windows other than XP (i.e. Windows Vista or Windows 7), there is one additional step you must take in order to ensure that EDMX data packets are actually received by wysiwyg: run the EDMX “listener” in Windows XP Service Pack 2 Compatibility Mode and as Administrator.
The EDMX “listener” is a background application called AppMux and it is always installed by the wysiwyg installer. AppMux does not have a user interface—one is not needed, as its sole purpose is to pick up EDMX data packets from the network, and stream them into wysiwyg. Please note that AppMux only runs (i.e. it is automatically run by wysiwyg without user interaction) when EDMX reception is enabled, as described above.
To configure AppMux to run correctly:
1. Navigate to the Bin folder within the wysiwyg installation folder, typically C:\Program Files\WYSIWYG Release 26\Bin or C:\Program Files (x86)\WYSIWYG Release 26\Bin on 64bit operating systems.
2. Right-click on the file AppMux.exe and select Properties from the pop-up menu.
3. In the window that appears, click the Compatibility tab.
4. Click the Run this program in compatibility mode for checkbox.
5. From the drop-down under this checkbox, select Windows XP (Service Pack 2).
6. Click the Run this program as an administrator checkbox.
7. Click OK to save these settings and close the Properties window for AppMux.exe.
8. Close the Bin folder.
wysiwyg should now be able to correctly-establish the connection to AppMux when a file is opened
The EDMX Patch
There is one more very important thing to remember: again unlike when connecting to all other consoles and devices, the fixtures in your file must be patched to the “EDMX” universe that exists in every .wyg file (and cannot be deleted). This is the universe to which AppMux streams the EDMX data packets, and if fixtures are not patched to here, they will not be able to interpret the console’s output.
IMPORTANT NOTE: As for all other console/device connections, it is important to remember that the patch in your .wyg file must match the patch on the console.
To visualize the console’s output once you’ve opened a correctly-patched file, simply switch to Live mode. As a simple test, turn on some of the fixtures (using the console) and their beams will appear in wysiwyg. If they do not, see the troubleshooting section below.
Troubleshooting the Connection
Unfortunately, in some cases, establishing the connection is not as easy as described above. Let us remember though, that EDMX and the related technologies and software are quite old (at least in computing terms), and sometimes it is simply impossible to keep things compatible with newer operating systems. Below are a few troubleshooting tips which should help you establish the connec- tion if simply doing the above does not work.
Dealing with Multiple Network Cards
The majority of modern/current computers feature multiple network interfaces. This is especially true of laptops powerful enough to properly run wysiwyg Perform: most such laptops feature one wired and one wireless (Wi-Fi) connection. Since AppMux is not able to auto-detect which network connection the EDMX data packets are streaming through, this information must be supplied by the User.
This is accomplished via a simple utility called NICPicker. NICPicker is part of ETC’s Network Configuration Editor (NCE) software suite; NCE is available for free from the ETC website—simply search for the words nce software in the Downloads section,http://www.etcconnect.com/downloads.aspx. Once you’ve downloaded and installed NCE (use the ‘Typical Installation’ option), you will find NICPicker.exe in the C:\Program Files\ETC\NICPicker folder (or the C:\Program Files (x86)\ETC\NICPicker folder, if running a 64bit operating system).
IMPORTANT NOTE: Just like AppMux, NICPicker must also be run in Windows XP Service Pack 2 Compatibility Mode and As Administrator. Please follow the instructions above to configure NICPicker to run correctly.
NICPicker is very simple to use: run it, click the checkbox for the network interface that is connected to your EDMX network/source, and save the configuration.
Note that extremely rare cases exist, where NICPicker fails to correctly select the network interface. In such situations, your only option is to disable the network interface that is not being used for EDMX.
• On a laptop, this is typically the Wi-Fi interface; most laptops feature a physical switch or a keyboard key combination by which Wi-Fi can be enabled or disabled—use this to disable the WiFi interface.
• On a desktop, access the Network and Sharing Center control panel and click theChange adapter settings link on the right. The window that opens displays all the available network interfaces. Right-click on the one that is not connected to the EDMX network/source, and select Disable from the pop-up menu; repeat this if you have more than two active network interfaces.
Once you’ve disabled all the unnecessary network interfaces, restart your computer.
Using Net2Util to Diagnose Network Problems
If even after following the tips above regarding multiple network cards, you still cannot visualize your console’s output in wysiwyg, the problem is likely in your network configuration. ETC’s Net2Util software, available by request only from ETC Technical Support, is great for diagnosing problems you may have with your network configuration. Here are some basic tips for how to use it:
• Click the Start button to list all the available EDMX-capable devices/consoles on your network. If you do not see your console or device in this list, check your IP addressing. Remember that your console/device must be in the same subnet as the com- puter running wysiwyg, otherwise EDMX data packets will not reach the computer.
• To ensure that EDMX data is actually being received by your computer, click the EDMX button. In the window that appears, set the EDMX Start address and the number of EDMX channels to “listen” for (top-left corner of the window), and then click the Live EDMX button: the grid below will fill up with numbers (0 through 255) indicating the level of each channel. If no numbers appear, your console/device may not be outputting EDMX packets correctly, so check its settings.
NOTE: More information about Net2Util and setting the IP address for the console is available from ETC technical support at 1.800.688.4116. For information on how to set/change the IP address for your computer, please consult Windows Help.