Difference between revisions of "Axe-Fx SysEx Documentation"

From Fractal Audio Wiki
Jump to navigation Jump to search
m (→‎General SysEx Message Overview: change offset of notation I used)
m (→‎Parameter Numbers: wiki syntax)
Line 373: Line 373:
 
=Parameter Numbers=
 
=Parameter Numbers=
 
:IDs listed below are as of firmware revision 8.02
 
:IDs listed below are as of firmware revision 8.02
:For firmware 10.3, see the ''default.axeml'' file included with ''Axe-Edit'' for a complete list of Effect Block and Parameter IDs as described [[http://www.fractalaudio.com/forum/viewtopic.php?f=14&t=9077&start=49| in this forum post]].
+
:For firmware 10.3, see the ''default.axeml'' file included with ''Axe-Edit'' for a complete list of Effect Block and Parameter IDs as described [http://www.fractalaudio.com/forum/viewtopic.php?f=14&t=9077&start=49| in this forum post].
  
 
==Effect Block IDs==
 
==Effect Block IDs==

Revision as of 22:50, 6 December 2010

Axe-Fx System Exclusive Message Spec

This is a user-driven project to document the SysEx messages used by the Axe-Fx. For a list of controllers capable of sending (and possible receiving) SysEx information to your Axe-Fx please see [SysEx Capable Controllers].

Disclaimer

Use of the SysEx messages to access your Axe-Fx is not supported by Fractal Audio. You use these messages at your own risk.

The SysEx messages are copyright Fractal Audio and are printed here with the permission of Fractal Audio.

When in doubt: ask questions in the forum before using this stuff.

General SysEx Message Overview

(Attempting to describe the general format of the SysEx messages used by the Axe-Fx here. Please expand this!)

A sample Axe-Fx SysEx message (10.3 firmware):

Message: F0  00  01  74  01  02 0A 06 00 00 01 00 01  F7
Block:   1   2   3   4   5  (--------- data --------) 7
SysEx Message Blocks Described
Block Description
1 SysEx Start byte. From the GM spec. Indicates the start of a MIDI SysEx message.
2 Manufacturer sysex ID byte 0. As of firmware 8.02 this is always 00.
3 Manufacturer sysex ID byte 1. As of firmware 10.02, this is always 01 (in previous firmware versions this was 00).
4 Manufacture sysex ID byte 2. As of firmware 10.02, this is 74 (in previous firmware versions this was 7D). If you're sending messages this should be set to the SysEx ID of your Axe-Fx. Failing to set this to the SysEx ID of the target unit will see all your SysEx messages ignored by the unit. This is true for patch dumps as well.
5 MIDI device ID
data The data portion of the SysEx message. You construct this portion using the tables below. The first two bytes are used to indicate the effect block or feature on the Axe-Fx being accessed.
7 SysEx End byte.

Axe-Fx Sysex Message Formats

reformatted from Axe-Fx MIDI Remote Programming, courtesy of Cliff Chase/Fractal Audio
warning: this document was from an early stage in the Axe's development, so some things may have changed
***REMINDER: THIS IS NOT SUPPORTED BY FRACTAL AUDIO - DO NOT ASK THEM FOR HELP, AND USE AT YOUR OWN RISK***

Introduction

The Axe-Fx allows remote programming via it's MIDI interface. To utilize this feature the remote programmer (PC) is connected to the Axe-Fx MIDI in and out jacks. Commands are sent to the MIDI in and replies are returned from MIDI out.

There are only two basic objects in the Axe-Fx: effects and modifiers. Effects include all effect objects and modifiers are the transform between an internal or external controller and an effect parameter. All effects have a unique effect ID and all modifiers have a unique ID.

All parameters in the Axe-Fx are stored as 8-bit values with a range of 0 to 254 (255 not used). Axe-Fx parameters fall into 3 different types: integer, linear and log. Integer parameters have a direct correspondence between the parameter value and the parameter itself. Linear parameters have a linear relationship between the parameter value and the parameter itself. Log parameters have an exponential relationship between the parameter value and the parameter itself. Integer parameters typically have a limited range of allowable values.


All MIDI functions have the same header as follows:

0xF0 sysex start
0x00 Manf. ID byte0
0x00 Manf. ID byte1
0x7d Manf. ID byte2 (this value is configurable within the Axe-Fx)
0x00 Model #
0xdd Function ID

Byte2 of the manufacturers ID is configurable in the Axe-Fx on the MIDI menu. This value should match or the Axe-Fx may reject the message. The function ID indicates the type of function and sets the formatting of the data to follow.

Note from iaresee: When they say "this value is configurable on the Axe-Fx" they're talking about the SysEx ID. This byte in the message is the SysEx ID of your unit. If it doesn't match with what you've set on your unit the message is ignored by it.

MIDI Send Messages

These messages are sent to the Axe-Fx to carry out an action.

The following functions are available:


MIDI_SET_PARAMETER

This function sets or queries an effect parameter.

Format:

0xF0 sysex start
0x00 Manf. ID byte0
0x00 Manf. ID byte1
0x7d Manf. ID byte2 (this value is configurable within the Axe-Fx)
0x00 Model #
0x02 Function ID
0xdd effect ID LS nibble
0xdd effect ID MS nibble
0xdd parameter ID LS nibble
0xdd parameter ID MS nibble
0xdd parameter value LS nibble
0xdd parameter value MS nibble
0xdd query(0) or set(1) value
0xF7 sysex end

The effect identified by the effect ID has its parameter identified by the parameter ID set to a value of between 0 and 254. You can query the current value by setting or clearing the set byte.

Rather than trying to keep track of the range of all parameters and their types this MIDI function operates as a virtual interface. After calling MIDI_SET_PARAM the Axe-Fx responds with the actual parameter value and a string representation of the parameter.

For example, if setting a rate parameter the Axe-Fx will respond with the parameter value (0 - 254) and a string representing the actual value of the rate, i.e. "1.234 Hz".

The value response allows querying a parameter and also does range checking on integer types. If one attempts to set an integer type outside of its range the Axe-Fx will set the value to the minimum or maximum value allowable and respond with the actual value set.

Values can be queried by simply setting the set/query byte to 0. The parameter value is irrelevant. The Axe-Fx will then respond with the current value and string representation.

When first editing an effect all the parameters should be queried to determine their current values. To then edit a parameter simply send the new parameter value and await the response.


MIDI_SET_MODIFIER

This function sets or queries a modifier parameter.

Message format:

0xF0 sysex start
0x00 Manf. ID byte0
0x00 Manf. ID byte1
0x7d Manf. ID byte2 (this value is configurable within the Axe-Fx)
0x00 Model #
0x07 Function ID
0xdd effect ID LS nibble
0xdd effect ID MS nibble
0xdd parameter ID LS nibble
0xdd parameter ID MS nibble
0xdd modifier parameter ID LS nibble
0xdd modifier parameter ID MS nibble
0xdd modifier value LS nibble
0xdd modifier value MS nibble
0xdd query(0) or set(1) value
0xF7 sysex end


This function sets the value of a modifier parameter. The modifier parameter identified by its ID has its value set to the modifier value. The effect being controlled and the parameter being controlled are indicated by the effect and parameter ID's. Note that the effect parameter ID will be different than the basic parameter ID. For example, a rate control may have a parameter ID = 3. To control it in real-time via a modifier the corresponding parameter ID will be different. Modifiable parameters have a corresponding parameter with an ID greater than or equal to 100.

There are 16 modifiers available in the Axe-Fx, meaning that up to 16 parameters can be controlled at one time. A modifier is connected to a parameter when the modifier control ID is nonzero. To connect a modifier to a parameter call this function with the desired effect ID and parameter ID with the modifier parameter equal to MOD_CTRTLID and a modifier value equal to the desired controller. A non-zero value will automatically connect the modifier. A value of zero will disconnect the modifier.

Once a modifier is connected the other parameters can be set or queried accordingly. Like the MIDI_SET_PARAMETER function this function responds with the value set and a text string representation of the actual value.


MIDI_PLACE_EFFECT

Places an effect at a position in the effects grid.

Message format:

0xF0 sysex start
0x00 Manf. ID byte0
0x00 Manf. ID byte1
0x7d Manf. ID byte2 (this value is configurable within the Axe-Fx)
0x00 Model #
0x05 Function ID
0xdd effect ID LS nibble
0xdd effect ID MS nibble
0xdd grid position
0xdd query(0) or set(1) value
0xF7 sysex end


The effect identified by its ID is placed at a position in the grid. The grid is 4 rows by 12 columns. A grid position is given by position = 4 * column_number + row_number. Rows and columns are enumerated starting with zero.

If another effect is at the position it is removed.


MIDI_CONNECT_EFFECT

Connects two effects.

Message format:

0xF0 sysex start
0x00 Manf. ID byte0
0x00 Manf. ID byte1
0x7d Manf. ID byte2 (this value is configurable within the Axe-Fx)
0x00 Model #
0x06 Function ID
0xdd source position
0xdd destination position
0xdd connect (1) | disconnect (0)

The effect at the source position is connected or disconnected to/from the effect at the destination position. The position is as described above. A null block cannot be one of the two effects being connected and will result in the function failing.


MIDI_GET_FIRMWARE_VERSION

Query installed version of firwmare.

Message format:

0xF0 sysex start
0x00 Manf. ID byte0
0x01 Manf. ID byte1
0x74 Manf. ID byte2 (this value is configurable within the Axe-Fx)
0x01 Model #
0x08 Function ID
0xF7 sysex end

The device will respond with the firmware version. For example, 10.3 is reported as: F0 00 01 74 01 08 0A 03 F7

MIDI Return Messages

Upon sending a message to the Axe-Fx it will return a message. The following return messages are implemented:


MIDI_PARAM_VALUE

Message format:

0xF0 sysex start
0x00 Manf. ID byte0
0x00 Manf. ID byte1
0x7d Manf. ID byte2 (this value is configurable within the Axe-Fx)
0x00 Model #
0x02 Function ID (2)
0xdd effect ID LS nibble
0xdd effect ID MS nibble
0xdd parameter ID LS nibble
0xdd parameter ID MS nibble
0xdd parameter value LS nibble
0xdd parameter value MS nibble
0xdd null-terminated string byte0
0xdd byte1
...
0x00 null character
0xF7 sysex end


This message is returned after sending the MIDI_SET_PARAMETER message.


MIDI_MODIFIER_VALUE

Message format:

0xF0 sysex start
0x00 Manf. ID byte0
0x00 Manf. ID byte1
0x7d Manf. ID byte2 (this value is configurable within the Axe-Fx)
0x00 Model #
0x07 Function ID (7)
0xdd effect ID LS nibble
0xdd effect ID MS nibble
0xdd parameter ID LS nibble
0xdd parameter ID MS nibble
0xdd modifier parameter ID LS nibble
0xdd modifier parameter ID MS nibble
0xdd modifier value LS nibble
0xdd modifier value MS nibble
0xdd null-terminated string byte0
0xdd byte1
...
0x00 null character
0xF7 sysex end


This message is returned after sending the MIDI_SET_MODIFIER message.


MIDI_STATUS

Reports success or failure.

Message format:

0xF0 sysex start
0x00 Manf. ID byte0
0x00 Manf. ID byte1
0x7d Manf. ID byte2 (this value is configurable within the Axe-Fx)
0x00 Model #
0xdd Calling Function ID
0xdd status
0xF7 sysex end

All other function calls respond with this message. The calling function ID is indicated and success (1) or failure (0) indicated in the status byte.

MIDI Realtime Sysex Messages

Realtime sysex messages for tempo and tuner info are sent by default. They can be disabled in the IO / MIDI / SEND REALTIME SYSEX menu.

MIDI_TUNER_INFO

When the tuner is active this message is streamed to the MIDI out port.

Message format:

0xF0 sysex start
0x00 Manf. ID byte0
0x00 Manf. ID byte1
0x7d Manf. ID byte2 (this value is configurable within the Axe-Fx)
0x00 Model #
0x0d Calling Function ID
0x?? Note value (0 = A, 1 = A#, 2 = B, 3 = C etc)
0x?? Note octave
0x?? Fine tune (0 = very flat, 0x7f - very sharp, 0x3f/0x40? - in tune)
0xF7 sysex end

MIDI_TEMPO_BEAT

Tempo beats (corresponding to the blinking tempo LED) are streamed to the MIDI out port.

Message format:

0xF0 sysex start
0x00 Manf. ID byte0
0x01 Manf. ID byte1
0x74 Manf. ID byte2 (this value is configurable within the Axe-Fx)
0x01 Model #
0x10 Tempo function ID
0xF7 sysex end

Parameter Numbers

IDs listed below are as of firmware revision 8.02
For firmware 10.3, see the default.axeml file included with Axe-Edit for a complete list of Effect Block and Parameter IDs as described in this forum post.

Effect Block IDs

Common

00 06 =
01 06 =
02 06 =
03 06 =
04 06 = Comp1
05 06 = Comp2
06 06 = GEQ1
07 06 = GEQ2
08 06 = PEQ1
09 06 = PEQ2
0A 06 = Amp1
0B 06 = Amp2
0C 06 = Cab1
0D 06 = Cab2
0E 06 = Reverb1
0F 06 = Reverb2
00 07 = Delay1
01 07 = Delay2
02 07 = Multi-Delay1
03 07 = Multi-Delay2
04 07 = Chorus1
05 07 = Chorus2
06 07 = Flanger1
07 07 = Flanger2
08 07 = Rotary1
09 07 = Rotary2
0A 07 = Phaser1
0B 07 = Phaser2
0C 07 = Wah1
0D 07 = Wah2
0E 07 = Formant
0F 07 = Volume/Pan
00 08 = Tremolo/Pan1
01 08 = Tremolo/Pan2
02 08 = Pitch
03 08 = Filter1
04 08 = Filter2
05 08 = Drive1
06 08 = Drive2
07 08 = Enhancer
08 08 = FX Loop
09 08 = Mixer1
0A 08 = Mixer2
0B 08 =
0C 08 =
0D 08 =
0E 08 = Feedback Send
0F 08 = Feedback Return

Ultra-Only

00 09 = Synth1
01 09 = Synth2
02 09 = Vocoder
03 09 = MegaTap Delay
04 09 = Crossover1
05 09 = Crossover2
06 09 = Gate/Exp1
07 09 = Gate/Exp2
08 09 = Ring Mod
09 09 = Pitch2
0A 09 = MBC1
0B 09 = MBC2
0C 09 = QuadCho1
0D 09 = QuadCho2
0E 09 = Resonator1
0F 09 = Resonator2
00 0A = GEQ3
01 0A = GEQ4
02 0A = PEQ3
03 0A = PEQ4
04 0A = Filter3
05 0A = Filter4
06 0A = Vol/Pan2
07 0A = Vol/Pan3
08 0A = Vol/Pan4

Amp Block Parameters

00 00 = Type
01 00 = Drive
02 00 = Bass
03 00 = Mids
04 00 = Treble
05 00 = Master Volume
06 00 = Low Cut
07 00 = Hi Cut
08 00 = Tonestack Frequency
09 00 =
0A 00 = Bright Cap
0B 00 =
0C 00 = Xformer LF
0D 00 = Xformer HF
0E 00 = Tonestack Location
0F 00 = Input Select
00 01 = Deep
01 01 =
02 01 =
03 01 = Sag
04 01 = Presence
05 01 = Level
06 01 = Balance
07 01 = Bypass Mode
08 01 = Damping
09 01 = Presence Frequency
0A 01 = Speaker Resonance Freq
0B 01 = Transformer Match (Depth)
0C 01 = Bright Switch & Boost Switch
0D 01 = Warmth
0E 01 = Thump
0F 01 = Global Amp
00 02 =
01 02 = Stabilizer
02 02 = Tonestack Type
03 02 = B+ Capacitance
04 02 = Bias

Cab Block Parameters

00 00 = Cab (L)
01 00 = Mic (L)
02 00 = Cab R
03 00 = Mic R
04 00 = Link off/on
05 00 = Level L
06 00 = Level R
07 00 = Pan L
08 00 = Pan R
09 00 = Level
0A 00 = Balance
0B 00 = Bypass Mode
0C 00 = Type
00 00 = Mono HiRes
01 00 = Mono LoRes
02 00 = Stereo
0D 00 =
0E 00 = Drive (L)
0F 00 = Drive R

Chorus Block Parameters

04 07 = Chorus1
05 07 = Chorus2
00 00 = Voices
01 00 = Rate
02 00 = Tempo
03 00 = Depth
04 00 = Bass
05 00 = Treble
06 00 = Bass Freq
07 00 = Treble Freq
08 00 = Delay Time
09 00 = LFO Phase
0A 00 = LFO Type
0B 00 = Auto Depth off/on
0C 00 = Mix
0D 00 = Level
0E 00 = Balance
0F 00 = Bypass Mode
00 01 = Global Mix
01 01 = Phase Reverse
02 01 =
03 01 = Width
04 01 = LFO2 Rate
05 01 = LFO2 Depth

Comp Block Parameters

04 06 = Comp1
05 06 = Comp2
00 00 = Threshold
01 00 = Compression
02 00 = Attack
03 00 = Release
04 00 = Level
05 00 = Knee
06 00 = Makeup Switch
07 00 = Detect
08 00 = Filter
09 00 =
0A 00 = SCSEL
0B 00 = Mix
0C 00 = Type (Studio/Pedal)

Delay Block Parameters

00 07 = Delay1
01 07 = Delay2
00 00 = Type
01 00 = Time MSB?
02 00 = Time LSB?
03 00 = Ratio (Stereo)
04 00 = Feedback (Mono)
05 00 = Feedback L
06 00 = Feedback R
07 00 = Echo Pan
08 00 = Spread
09 00 = Tempo
0A 00 = Lowcut
0B 00 = High cut
0C 00 = LFO1 Rate
0D 00 = LFO2 Rate
0E 00 = LFO1 Depth
0F 00 = LFO2 Depth
00 01 = Drive
01 01 = Mix
02 01 = Level
03 01 = Pan
04 01 = Bypass Mode
05 01 = Global Mix
06 01 =
07 01 = In Gain
08 01 = LFO1 Type
09 01 = LFO2 Type
0A 01 = Time R (Dual) MSB?
0B 01 = Time R (Dual) LSB?
0C 01 = Master Feedback
0D 01 = Tempo R (Dual)
0E 01 = Feedback LR (Dual)
0F 01 = Feedback RL (Dual)
00 02 = Level L (Dual)
01 02 = Level R (Dual)
02 02 = Pan L (Dual)
03 02 = Pan R (Dual)
04 02 = LFO1 Phase
05 02 = LFO2 Phase
06 02 = XFade Time (Rev)
07 02 = Run (Reverse)
08 02 = Trig Restart (Reverse)
09 02 = Filter Slope
0A 02 = Ducker Att
0B 02 = Threshold
0C 02 = Release Rate
0D 02 = Depth Range
0E 02 = Diffusion
0F 02 = Diff Time
00 03 = Phase Rev
01 03 = LFO1 Target
02 03 = LFO2 Target
03 03 = LFO1 Tempo
04 03 = LFO2 Tempo

Drive Block Parameters

Please note: this does not match with firmware 8.02 and all of this section needs updating.

05 08 = Drive1
06 08 = Drive2
00 00 = Type?
01 00 = Drive
02 00 = Tone
03 00 = Level
04 00 = Mix
05 00 = Bypass Mode
06 00 = Slew Limit
07 00 =
08 00 = Low Cut
09 00 = High Cut
0A 00 = Clip Type
0B 00 = Bias

Filter Block Parameters

03 08 = Filter1
04 08 = Filter2
00 00 = Type
01 00 = Freq
02 00 = Q
03 00 = Gain
04 00 = Level
05 00 = Balance
06 00 = Bypass Mode
07 00 = R Offset
08 00 =
09 00 = Pan L
0A 00 = Pan R

Flanger Block Parameters

06 07 = Flanger1
07 07 = Flanger2
00 00 = Rate
01 00 = Tempo
02 00 = Depth
03 00 = Feedback
04 00 = Bass
05 00 = Treble
06 00 = Bass Freq
07 00 = Treble Freq
08 00 = Time
09 00 = Manual
0A 00 = LFO Phase
0B 00 = LFO Type
0C 00 = LFO Hicut
0D 00 = Auto Depth
0E 00 = Mix
0F 00 = Level
00 01 = Balance
01 01 = Bypass Mode
02 01 = Global Mix
03 01 =
04 01 = Phase Reverse
05 01 = Dry Delay

Graphic EQ Block Parameters

06 06 = GEQ1
07 06 = GEQ2
00 00 = 63
01 00 = 125
02 00 = 250
03 00 = 500
04 00 = 1K
05 00 = 2K
06 00 = 4K
07 00 = 8K
08 00 =
09 00 = Level
0A 00 = Balance
0B 00 = Bypass Mode

Mixer Block Parameters

09 08 = Mixer1
0A 08 = Mixer2
00 00 = Gain1
01 00 = Gain2
02 00 = Gain3
03 00 = Gain4
04 00 = Pan1
05 00 = Pan2
06 00 = Pan3
07 00 = Pan4
08 00 = Master Level
09 00 = Output Mode

Parametric EQ Block Parameters

08 06 = PEQ1
09 06 = PEQ2
00 00 = Freq1
01 00 = Freq2
02 00 = Freq3
03 00 = Freq4
04 00 = Freq5
05 00 = Q1
06 00 = Q2
07 00 = Q3
08 00 = Q4
09 00 = Q5
0A 00 = Gain1
0B 00 = Gain2
0C 00 = Gain3
0D 00 = Gain4
0E 00 = Gain5
0F 00 =
00 01 = Level
01 01 = Pan
02 01 = Bypass Mode
03 01 =
04 01 = Type 1 (Low)
00 00 = Shelving
01 00 = Peaking
02 00 = Blocking
05 01 = Type 5 (High)

Parametric EQ Block Parameters

08 06 = PEQ1
09 06 = PEQ2
00 00 = Freq1
01 00 = Freq2
02 00 = Freq3
03 00 = Freq4
04 00 = Freq5
05 00 = Q1
06 00 = Q2
07 00 = Q3
08 00 = Q4
09 00 = Q5
0A 00 = Gain1
0B 00 = Gain2
0C 00 = Gain3
0D 00 = Gain4
0E 00 = Gain5
0F 00 =
00 01 = Level
01 01 = Pan
02 01 = Bypass Mode
03 01 =
04 01 = Type 1 (Low)
00 00 = Shelving
01 00 = Peaking
02 00 = Blocking
05 01 = Type 5 (High)