Chapter 2. Installing MagicQ Software & Drivers

2.1. MagicQ software

MagicQ software runs on PCs and Macs and can be downloaded free from the ChamSys web site www.chamsys.co.uk/download.

2.2. MagicDMX

MagicDMX devices do NOT need any additional drivers – they use HID drivers within the operating system. Simply plug in the device and start MagicQ.

To confirm that the MagicDMX is operating correctly go to Setup, View System, View status, Interfaces. The MagicDMX Status should say "Connected" and "DMX out".

MagicDMX is enabled as DMX output by default. It can be disable/enabled from Setup, View Setings, Ports, MagicDMX.

When first plugged in the MagicDMX alternates green and orange LEDs every second. When MagicQ is started and connects to the device then the green LED is on permanently and the orange flashes faster as it receives data from MagicQ.

When using MagicDMX Basic and MagicDMX Full interfaces demo mode will continue to be shown at the top of the MagicQ window. This does not affect the programming of MagicQ or restrict the output if you have a MagicDMX Full interface. Demo mode does restrict some advanced MagicQ functions which are unlocked with MagicQ hardware (Not MagicDMX).

2.3. MagicQ Wings & Interfaces

MagicQ Wings (Mini wing, PC Wing, Maxi Wing, Extra Wing, Playback Wing, Execute Wing) and MagicQ DMX interfaces (Dual DMX, Audio, MIDI/SMPTE) use a USB chipset made by FTDI which requires the installation of the correct drivers.

After the drivers have been installed then MagicQ can be started and the Wing/Interface should be detected. Ensure the setting “Setup, View Settings, Ports, MagicQ Wings & Interfaces” is set to “Yes (auto DMX)”

Note that the drivers for MagicQ Wings and MagicQ DMX interfaces ARE NOT applicable to MagicDMX Basic or MagicDMX Full. Do not attempt to install drivers for MagicDMX.

2.4. MagicQ on Windows

MagicQ runs fine on Windows Vista, Windows 7, Windows 8 and Windows 10.

MagicDMX devices do not need any drivers - see Section 2.2, “MagicDMX”.

To use MagicQ Wings and MagicQ Interfaces on Windows the FTDI drivers must be installed manually as Windows is not able to detect the products correctly. The drivers are included in the MagicQ installation folder

C:\ProgramFiles\ChamSys Ltd\Magicq\MagicQ Wing Drivers. On 64 bit systems MagicQ is installed in Program Files (x86) instead of Program Files.

Disconnect all MagicQ Wings and Interfaces except the one you are trying to install the driver for.

Open Device Manager. This is found in different places depending on the version of Windows, but it can normally be accessed by opening Control Panel and then selecting System, and then selecting Device Manager.

image

image

Device Manager lists all the devices on your system. The MagicQ device is normally listed at the bottom under Universal Serial Bus Controllers but it may be under any other section. It may be listed as a ChamSys or MagicQ device or just as a FTDI device. If you can not find it then try disconnecting and reconnecting the USB cable to the device - the listing should update and indicate to you which device is being plugged/unplugged.

image

When you have identified the device then right click and press Update Driver.

image

Select "Browse My Computer for Driver Software (Locate and Install Driver Software Manually)". Do not let Windows search for a driver.

image

Select the option "Let me pick from a list of device drivers on my computer".

image

Select "Have Disk". If you cannot find "Have Disk" then click on items in the list until you get it.

image

For PC Wing Compacts the drivers are in c:\Program Files\ChamSys Ltd\Magicq\MagicQ Wing Drivers\PC Wing Compact\CDM 2.08.24 WHQL Certified\ftdibus.inf

PC Wing Compacts require MagicQ software version 1.5.8.0 or above.

image

For all other products the drivers are in c:\Program Files\ChamSys Ltd\Magicq\MagicQ Wing Drivers\FTDI\chamsys.inf

image

If the MagicQ USB wing periodically disconnects and restarts then check the Windows settings for your USB ports - Windows may be shutting down the USB ports when it incorrectly thinks they are idle. Click on Control Panel, System, Device Manager and scroll to the bottom to get a list of the USB devices. For each USB Root Hub click on Properties, Power Management and make sure that the option "Allow the computer to turn off this device to save power" is NOT selected.

On some Windows systems the Update Drivers dialog will not show the driver files even though they are correctly in the MagicQ Wing Drivers folder. In this case try copying the whole MagicQ Wing Drivers folder to the desktop (using Windows Explorer) and then try to update the drivers again.

2.4.1. User permissions on Windows

Note that Vista, Windows 7, 8 and 10 has User Authentication which may cause your show / head files to be stored in c:\users\username\AppData\Local\VirtualStore\Program Files\ChamSys Ltd\MagicQ PC\show instead of c:\Program Files\ChamSys Ltd\MagicQ PC\show.

If MagicQ does not store settings after a restart - it forgets the number of universes, IP address or DMX I/O settings - then this is likely caused by Windows restricting write access to the folders where MagicQ stores this data. Check permissions and try to run MagicQ as administrator. To Run MagicQ as an administrator on Windows, right click on the MagicQ desktop icon and select run as administrator from the options menu.

Windows controls the level of access to system folders through the User Account Control Settings. This can be found in Control Panel, User Accounts, Change User Account Control settings. Setting this to "Never Notify" will make Windows less restrictive. Note that for security reasons this is only recommended for stand alone systems dedicated to MagicQ which are not connected to the internet - please make sure you understand the implications for your computer, before changing this setting.

2.5. MagicQ on Mac

MagicQ on Mac includes all the required drivers and no action should be required to install them.

MagicQ Wings and Interfaces must be powered up and connected to the Mac before MagicQ is started.

2.5.1. OSX 10.11 El Capitan

In 10.11 El Capitan, Apple have forced the use of their Apple FTDI Driver rather than the manufacturer provided driver - the option to Disable the Apple FTDI Drivers in the MagicQ Tools Menu will not work as Apple have blocked it.

In MagicQ version 1.7.0.2 we have modified MagicQ to enable MagicQ PC Wing Compact and MagicQ Extra Wing Compact to use the Apple inbuilt FTDI (VCP) Drivers. If you are only trying to connect a MagicQ PC Wing Compact or a MagicQ Extra Wing Compact, then check that the option Setup, View Settings, Ports, MagicQ Wings & Interfaces is set to "Yes, auto DMX".

Due to problems with the Apple FTDI Driver, when MagicQ version 1.7.0.2 is run on OSX 10.11 then by default it does not have support enabled for older MagicQ Wings such as MagicQ Mini Wing, Maxi Wing, old PC Wing, old Extra Wing, Playback Wing, Extra Wing and 3rd party devices such as Enttec Pro.

To use these interfaces with v1.7.0.2 on OSX 10.11, set the option Setup, View Settings, Ports, MagicQ Wings & Interfaces to "FTDI + VCP driver, auto DMX". When this option is enabled, MagicQ will take about a minute to start up and look for wings even if there are none present - during this time the system will be blocked. We are working with FTDI to try to find a work around to this problem.

2.5.2. OSX 10.10 Yosemite

With OSX10.10 Yosemite, Apple FTDI drivers are not compatible with MagicQ Wings and Hardware.

MagicQ version 1.6.7.1 onwards now includes a utility to disable the Apple FTDI Driver and use the correct drivers. To Disable the Apple FTDI drivers, run MagicQ and select the option to disable the Apple FTDI driver from the Tools menu at the top of the window. MagicQ will ask for your system password and then confirm the driver is disabled, so the correct drivers can then be used. Quit MagicQ and restart for the wing to be detected.

This operation only needs to be carried out after a clean install or OSX update.

2.5.3. OSX 10.9 Mavericks

On OSX 10.9 Mavericks you may need to move the mouse pointer whilst MagicQ is starting to avoid a problem in OSX whereby the mouse/keyboard become unresponsive.

Due to Apple compatibility issues, MagicQ version 1.5.9.9 or higher is required when running on OSX 10.9 Mavericks.

2.5.4. Turning off App Nap

On all versions we recommend you disable Computer sleep and turn off App Nap to avoid MagicQ being shut down inadvertently.

  • Quit MagicQ
  • From the OSX Finder, navigate to the /Applications/MagicQ folder
  • Select MagicQ.app, then go to the “File” menu and select “Get Info” (or select the app and hit Command+i)
  • Check the box for “Prevent App Nap”, found under the General section of Get Info

image

2.5.5. Making the MagicQ folder writeable

If you get the message "Cannot write file" when trying to save a show file, or your settings changes are not saved then check that the MagicQ folder and all its subfolders have both read and write permission.

If you get a message starting with "MagicQ needs to write to the install folder…", you will need to check the permisions of the "MagicQ" folder. There are detailed steps in the troubleshooting chapter.

2.6. MagicQ on Linux

We recommend that only users familiar with Linux based operating systems try to use MagicQ under Linux. We cannot provide generic support on how to set your system up, but there are many forums and communities online which will be able to.

To install MagicQ on Linux based systems, you will need a Debian based distribution; we recommend Ubuntu 16.04.

To use MagicQ Wings and MagicQ Interfaces Linux requires the ftdi_sio kernel driver which is included as part of most standard kernel installations.

There are two ways to install MagicQ, either through the repository, which is recommended as you get automatic updates, or by manually downloading the installer.

2.6.1. Installing from the repository

Open up a terminal, and type in the following commands:

  1. Install the Chamsys public key

    wget http://repo.magicq.co.uk/magicq.co.uk.gpg -qO - | sudo apt-key add -
  2. Add the repository to your /etc/apt/sources.list file

    echo deb http://repo.magicq.co.uk/magicq/ magicq main | sudo tee -a /etc/apt/sources.list
  3. Update the package list

    sudo apt-get update
  4. Install the latest stable version of MagicQ

    sudo apt-get install magicq

    Or if you want the latest beta release

    sudo apt-get install magicq-beta

To run MagicQ, simply go to your launcher menu, and select "MagicQ" (possibly inside "Multimedia").

When a new version of MagicQ is released, you will have to run sudo apt-get update and sudo apt-get upgrade.

2.6.2. Installing the downloaded package

To install the downloaded .deb file, run the following command in a terminal:

sudo dpkg -i magicq_x.x.x.x_arch.deb

Replacing the filename above the the name of the downloaded file.