Documentation - ShowCockpit

Show Control and Integration Made Easy

Driver Documentation for v4.11.2

This page contains documentation of the available drivers.

Lighting / MA Lighting / GrandMA2 (v3.8.0.0 - v3.9.60.4)

Connects to GrandMA2 Systems

< Back to drivers list

    YouTube Videos


    Frequently Asked Questions (FAQs)


Any configuration needed on MA2 side?

The driver uses the Web Remote API, so you have to configure GrandMA2 the same way. Please see section "Console Configuration" on this tutorial. Some functions work better if you are logged in the same user as in the desk/OnPC.


Can I control the 4 enconder wheels on OnPC?

Yes, you can dynamically control attributes (also aware of the selected resolution Normal/Fine/Ultra). You can also use encoders to directly control fixed attributes (Dimmer, Color, Pan, Tilt, etc.) using the "Attribute Scroll" function.


Does this work on MA Dot2 as well?

No. This driver is only for MA2 systems - there is a separate driver for dot2.


I can't connect to MA2 - why?

First of all, can you connect and login to the web-remote using a browser? If you can't, then the problem has nothing to do with this driver. Please make sure you configure your GrandMA2 correctly and can connect and login using the web-remote first.
Double check that you have followed all the instructions on this tutorial video.
Make sure you are running a the correct (compatible) version on your GrandMA2 system - please check above.
In case you are connecting in the local machine, please use the loopback IP address 127.0.0.1


Does this work on GrandMA2 version X.Y.Z?

Releases will always be targeted at the latest GrandMA2 versions. If X.Y.Z is a fresh new release, please give us some time for upgrading this driver. If X.Y.Z is an old release, the answer is no.


My executors do not follow the page change. Why?

Because this driver communicates with MA2 through the web-remote interface, there are some limitations. If you open the web-remote on the browser and change the page in MA2, you will notice that the web-remote page remains in the previous page - this is the web-remote behaviour and could only be changed by MA Lighting.

Luckily, there is a workaround - you need to change pages always through ShowCockpit - if you enable the "Sync pages" option, the driver will automatically make sure that each time you use the "Change Page" function in ShowCockpit, the MA2 page is also updated.

    Element Options


IP Address

The IP address of the MA2 system

Username

Username

Password

Password

Sync Pages

Syncronize pages on MA2 sytem when page change occurs via ShowCockpit, using the Change Page function.

Default Faders Page

Default page for faders

Default Buttons Page

Default page for buttons

    Functions


Enable Element   Button LUA Script

Enable this element

Disable Element   Button LUA Script

Disable this element

Change Element Page   Button LUA Script

Changes the page on this element
  • Change Type: The change type - one of {Next, Previous, Go To}
  • Change to Page: Change to specific page, when Change Type is "Go To"

Executor Fader   Fader LUA Script

Controls an executor fader
  • Executor Number: The number of the executor (1-90)

Executor Fader Fixed   Fader LUA Script

Controls an executor fader on a fixed page (does not provide feedback)
  • Executor Number: The number of the executor (1-90)
  • Page Number: The number of the executor (1-500)

Executor Button   Button LUA Script

Controls an executor button on MA2 system
  • Executor Number: The number of the executor (1-190)
  • Button Number: Button number of the executor (1-3)

Executor Button Fixed   Button LUA Script

Controls an executor button on MA2 system on a fixed page (does not provide feedback)
  • Executor Number: The number of the executor (1-190)
  • Button Number: Button number of the executor (1-3)
  • Page Number: The number of the executor (1-500)

Encoder Wheel   Button Fader Encoder Axis LUA Script

Controls the encoder wheels
  • Wheel Number: What encoder to control (1-4 for the main encoders; 5-10 for the screen encoders)

Change Preset Type   Button LUA Script

Changes the selected preset type
  • Preset Type: Preset Type to switch to - one of {1 - Dimmer, 2 - Position, 3 - Gobo, 4 - Color, 5 - Beam, 6 - Focus, 7 - Control, 8 - Shapers, 9 - Video}

Command Execute   Button LUA Script

Executes a command on the command-line
  • Command: Command to execute

Change Page   Button Selector LUA Script

Changes fader/button page on MA2
  • Page Type: Type of page - one of {Faders, Buttons}
  • Change Type: Type change - one of {Next, Previous, Jump To}
  • Jump To Page: Page to jump to when "Change Type" = "Jump To"

Hardkey   Button LUA Script

Emulates a hardkey press on MA2
  • Key: The MA2 hardkey to control - one of {<<<, >>>, Align, Assign, At, Backup, Black-Out, Blind, Bt Pg -, Bt Pg +, Ch Pg -, Ch Pg +, Channel, Clear, Copy, Cue, Delete, Dot, Down, Edit, Effect, Esc, Exec, Fd Pg -, Fd Pg +, Fix, Fixture, Freeze, Full, Go- (Large), Go- (Small), Go+ (Large), Go+ (Small), Goto, Group, Help, Highlight, If, Learn, List, MA, Macro, Minus, Move, Next, Nipple, Num 0, Num 1, Num 2, Num 3, Num 4, Num 5, Num 6, Num 7, Num 8, Num 9, Off, On, Oops, Page, Pause (Large), Pause (Small), Please, Plus, Preset, Preview, Previous, Select, Sequ, Set, Setup, Solo, Store, Temp, Thru, Time, Tools, Top, U1, U2, U3, U4, Up, Update, User 1, User 2, V1, V10, V2, V3, V4, V5, V6, V7, V8, V9, View, X1, X10, X11, X12, X13, X14, X15, X16, X17, X18, X19, X2, X20, X3, X4, X5, X6, X7, X8, X9}

Attribute Scroll   Fader Encoder Axis LUA Script

Changes specific attribute for selected fixtures
  • Attribute Name: Name of the attribute to control
  • Scroll Amount: Amount of scrolling

Get Executor Appearance   LUA Script

Returns the appearance of the executor
  • Executor Number: The executor number to get the name from

Get Executor Label   LUA Script

Returns the label of the executor
  • Executor Number: The executor number to get the name from

Get Executor Previous Cue   LUA Script

Returns the name of the previous cue
  • Executor Number: The executor number to get the cue name from

Get Executor Current Cue   LUA Script

Returns the name of the current cue
  • Executor Number: The executor number to get the cue name from

Get Executor Next Cue   LUA Script

Returns the name of the next cue
  • Executor Number: The executor number to get the cue name from

Get Executor Cue Progress   LUA Script

Returns the progress of the current cue
  • Executor Number: The executor number to get the cue name from

Is Executor Assigned   LUA Script

Returns true if the executor is assigned
  • Executor Number: The executor number to get the cue name from