TWEAKER USER MANUAL WWW.ELECTRIXPRO.
ELECTRIX TWEAKER User Manual Table of Contents 1 2 3 4 5 6 Getting Started 1.1 Introduction 1.2 What‘s Included in the Box? 1.3 Product Registration 1.4 Height Extension Legs 1.5 Overlay Installation 1.6 Firmware & Utilities Connections 2.1 USB 2.2 MIDI In 2.3 MIDI Out Hardware Controls 3.1 Buttons 3.2 Encoders 3.3 LED’s (Button Indicators) 3.4 LED Rings 3.5 Pressure Sensitive Pads 3.6 Potentiometers Default MIDI Settings The Settings Channel 5.1 Encoder Settings 5.
ELECTRIX TWEAKER User Manual 6.2 6.3 6.4 Set Messages Request Responses Message Glossary 32 39 40 Safety Instructions liquid has been spilled or objects have fallen into the apparatus, the apparatus has been exposed to rain or moisture, does not operate normally, or has been dropped. Read these instructions. Keep these instructions. Heed all warnings. Follow all instructions. Do not use the apparatus near water. Clean only with dry cloth. Use in accordance with the manufacturer’s instructions.
1. Getting Started 1 Getting Started Thank you for purchasing the TWEAKER on behalf of the entire Electrix team. We hope you enjoy performing with the TWEAKER as much as we enjoyed making it! 1.1 Introduction TWEAKER is a universal controller that offers lots of options for customization, but for those who want to get started right away, we included mappings and overlays for popular programs like Traktor and Ableton.
1. Getting Started 1.2 What’s Included in the Box? The TWEAKER box contains the following items: The TWEAKER Controller A set of four height-extension legs A USB cable A Quick Start poster An installation CD including: Traktor 2 LE, TWEAKER EDITOR software, and the Ableton Live Remote Script 8 An overlay for the included Traktor 2 LE software 8 An overlay for the included Ableton Live Remote Script 8 8 8 8 8 1.
1. Getting Started The TWEAKER enclosure was designed to keep overlays in place with minimal movement during performances. 1.6 Firmware & Utilities The TWEAKER’s firmware updates via USB. Firmware updates may become available from time to time. Visit www.electrixpro.com to register your product and sign up to receive TWEAKER updates. 1.6.
1. Getting Started 1.6.2 Updating Firmware 1. Hold down the round rubber button located in the center of the four directional navigation buttons, while connecting Tweaker to your computer, 2. A volume named TweakerDisk will mount on your system, 3. Drag the Tweaker firmware binary file and drop it onto the TweakerDisk volume, 4. The velocity pads will flash while the firmware is updating. Do not disconnect the USB cable during this process, 5.
2. Connections 2 Connections Any of the controls on TWEAKER can be configured to provide a wide range of functionality. Here are some basic terms and uses for the controls. 2.1 USB The USB port connects to your computer to send and receive MIDI message, update the firmware, and power the unit. This port is available to your software as Tweaker Port 1. 2.2 MIDI In The MIDI Input port provides a standard 5 PIN MIDI jack to connect other MIDI devices to TWEAKER.
3. Hardware Controls 3 Hardware Controls Any of the controls on the TWEAKER can be configured to provide a wide range of functionality. Here are some basic terms and uses for the controls. 3.1 Buttons The TWEAKER has 7 encoder push buttons and 43 custom-designed, soft-touch rubber buttons. All button parameters can be controlled using the TWEAKER EDITOR software. The specific MIDI messages that the TWEAKER recognizes are also detailed below. Most music programs are designed to use momentary buttons.
3. Hardware Controls 3.1.2 Mappability Each button can be mapped to output Notes or CC’s. Each button may also function as a speed control button for the encoders (detailed below). The assignment of each button may be modified using the TWEAKER EDITOR or the ‘Set Button Mapping’ SysEx. Note/ CC Each button can be mapped to any note (0-127) and any CC (0-119). Multiple buttons can be mapped to output to the same Note/ CC, but only one indicator LED can receive feedback on that Note/CC.
3. Hardware Controls 3.2 Encoders The TWEAKER has 7 encoders. Each encoder is capable of outputting in Absolute or Relative Mode. The output mode of each encoder can be adjusted using the TWEAKER EDITOR, the Settings Channel, or using the “Set Encoder Output Modes” SysEx. 3.2.1 Absolute Mode When in Absolute Mode, an encoder outputs very much like an ordinary potentiometer. By default, the six channel strip encoders are in Absolute Mode.
3. Hardware Controls Encoder speeds are assignable by the TWEAKER EDITOR’s “encspeedA” and “encspeedB” functions, by sending a message to an encoder on the Settings Channel, or using the “Set Encoder Speeds” SysEx Message. MIDI Feedback Encoders in Absolute Mode accept standard MIDI Feedback. If the TWEAKER receives a message with the same mapping as an encoder, it will use the value of that message to set the current value of the encoder.
3. Hardware Controls MIDI Feedback Encoders in Relative Mode are capable of accepting MIDI feedback to the LED Rings. If the TWEAKER receives a message with the same mapping as an LED Ring, the TWEAKER will use that message to set the current display of the LED Ring based on the LED Ring’s Display Mode and the value of the message.
3. Hardware Controls Default Settings 8 8 8 8 8 The RGB LED’s are mapped to Notes 1-38 The Red LED’s used for the navigation style buttons are mapped to Notes 39-43. The Red LED’s used for pressure sensitive pads are mapped to Notes 63-70. The Blue LED’s to indicate encoder push button activity are mapped to Notes 45-50. All LED’s are mapped to MIDI Channel 1 Button Local Control These Button Indicator LED’s can also be locally controlled.
3. Hardware Controls 3.3.2 Display Styles RGB LED’s There are 38 RGB (Red/Green/Blue) LED’s: 32 for the grid and three per channel strip. They have eight states: 8 000-000: Off 8 001-003: Green 8 004-007: Red 8 008-015: Yellow 8 016-031: Blue 8 032-063: Cyan 8 064-126: Magenta 8 127-127: White Monochromatic LED’s There are 13 red monochrome LED’s and 6 blue monochrome LED’s. They have two states: 8 000-063: LED Turns Off 8 064-127: LED Turns Solid On 3.
3. Hardware Controls encoder value. Default Settings The LED Rings are mapped to CC79-84 on MIDI Channel 1. Encoder Local Control By default, the LED rings are locally controlled by the encoders. Locally controlled encoders can update the LED rings when: 8 User turns the encoder, or 8 TWEAKER receives a MIDI message (also known as a feedback message) that matches the mapping of the encoder. 3.4.2 Display Modes The LED rings have four modes to accurately display the current state of any function.
3. Hardware Controls EQ EQ mode lights from the center LED and stretches either to the left or right depending on the LED ring’s display value. When the LED ring’s display value reaches 0, the LED’s on the left side will all be lit. When the LED ring’s display value reaches 127, the LED’s on the right side will all be lit. This mode has 13 states, so the visual resolution of each state is about 10 MIDI Values. This mode is good for parameters that are centered around MIDI value 63-64, such as EQ and pan.
3. Hardware Controls 3.5 Pressure Sensitive Pads The TWEAKER has 8 large pressure sensitive pads for drumming or expressive control of effects. 3.5.1 Modes of Output Each pad is capable of outputting in Note messages upon press and release (like a keyboard), to trigger drums or play melodies. Each pad can also stream CC messages of the current value while the pad is depressed, so you can use your favorite software modulate LFO’s or perform bends on the notes after trigger.
3. Hardware Controls 3.5.4 Pad CC Retrigger Rate The pads are capable of outputting CC’s at a predefined rate in multiples of 5 milliseconds (ms). By default, this rate is 45ms. It can be modified using the TWEAKER EDITOR or the “Force Sensitive Pad Settings” SysEx message. 3.5.5 Mappability Each pad can output Notes and CC’s. The Note mapping acts like a normal keyboard key, with a Note On message of a velocity proportional to the force of the hit when the pad is struck.
3. Hardware Controls 8 Potentiometer reaches center: TWEAKER sends note off (velocity 0) 8 Potentiometer leaves center (increasing) TWEAKER sends note on velocity 127 8 Potentiometer leaves center (decreasing): TWEAKER sends note on velocity 64 These messages were designed so that a tweaker’s potentiometer can naturally turn off filters and effects when it reaches center value, or have a different effect or function assigned to each half of the pot.
3. Hardware Controls 3.6.1 Mappability CC Messages Each potentiometer can be mapped to output to any CC (0-119) using the TWEAKER EDITOR or the “Set Potentiometer Mappings” SysEx. Multiple pots can be mapped to output to the same CC. Each encoder has it’s own individual output channel that can be changed using the TWEAKER EDITOR. Center Note Messages Each potentiometer’s center note message is mapped to the same note as it’s cc mapping.
4. Default MIDI Settings 4 Default MIDI Settings The following is a list of the TWEAKER’s factory default MIDI note and CC settings.
4.
5. The Settings Channel 5 The Settings Channel The settings channel is reserved for the use of standard MIDI CC messages to configure different TWEAKER settings. Send a CC number on this channel to the TWEAKER and, if it matches the CC number mapping for an LED ring or an encoder, the value will change its properties.
5. The Settings Channel 4RM = Ring Mode 4SB = Security Bit (0 = ignore message, 1=accept message) 4ES = Encoder Speed 4EOM0 = Encoder Output Mode (0=absolute,1=relative 4EOM1 4ENCR = Encoder Relative Local Control 4ENCA = Encoder Absolute Local Control 4ANA = Analog Local Control 5.1 Encoder Settings 5.1.1 Default Settings Settings Channel: 16 Encoder Mappings: Min: CC56 Max: CC62 5.1.
5.
5.
5.
5. The Settings Channel 5.2.
5.
5.
6. SysEx Messages 6 SysEx Messages The following is a list of the TWEAKER’s factory default MIDI note and CC settings. 6.1 System Exclusive Command Bytes The System Exclusive message includes the official MIDI Manufacturer ID for ELECTRIX, a Product number, and the Command number. Each command is described in the following sections. 240, 0, 1, 106, 1, NN, ...
6.
6. SysEx Messages Message for Default Settings: < 240, 00, 01, 106, 01, 03, 00, 56, 00, 57, 00, 58, 00, 59, 00, 60, 00, 61, 00, 62, 247 > 04 : Force Sensitive Pad Mappings This message changes the MIDI mapping of all 8 force sensitive pads (Channel, Notes (CC’s), and Number).
6. SysEx Messages Data Bytes: 3 Data Bytes per Encoder : Not Applicable Message for Default Settings: < 240, 0, 1, 106, 01, 05, 126, 05, 01, 247 > 06 : FSR Settings This message changes all settings for all pads.
6. SysEx Messages 07 : LED Ring Output Modes This Message changes the display mode of all LED rings (Walk, Fill, Spread, or EQ).
6. SysEx Messages 09 : Map LED Rings This message changes the MIDI mapping of all LED rings (Channel, CC Only, and Number). Total Bytes: 19 Data Bytes: 12 Data Bytes per LED Ring: 2 1st Data Byte Received: Mapping Number 2nd Data Byte Received: Channel Number/ Output Type Message for Default Settings: < 240, 00, 01, 106, 01, 09, 0, 79, 0, 80, 0, 81, 0, 82, 0, 83, 0, 84, 247 > 13 : Set Settings Channel This Message changes the Settings Channel.
6. SysEx Messages 14 : Disable Encoder Local Control This message can enable or disable Ring Local Control for the encoders.
6. SysEx Messages 127 : Save Maps and Settings The TWEAKER saves all of its current settings as the default settings when it receives this message. User settings will be stored in flash memory and automatically restored whenever it is powered up. Message to Save Settings: < 240, 0, 1, 106, 01, 127, 247 > 6.3 Request Responses 125 : Acknowledgement The TWEAKER sends this message any time it receives a valid SysEx message.
6. SysEx Messages 126 : Receive Controller Configuration The TWEAKER sends this message in response to a Request Controller Configuration Message.
6. SysEx Messages Channel Number/ Output Type Bitwise: x c3 c2 c1 c0 m2 m1 m0 Note or CC (m2:m0) : Min: 0 (Note) Max: 1 (CC) Values 2-7 can be sent but are invalid states. MIDI Channel (c3:c0): Min: 0 (MIDI Channel 1) Max: 15 (MIDI Channel 16) Encoders Absolute/ Relative This Data Byte determines whether each encoder outputs in Absolute Mode or Relative (2’s Compliment Mode).
6. SysEx Messages Defaults: Speed A: 5 Speed B: 1 CC Retrigger On This pair of Bytes determines whether or not each pressure sensitive pad will stream CC messages of a value related to the current pressure while the pad is depressed.
6. SysEx Messages Note: Setting the Note Off pressure threshold higher than the Note On pressure threshold will create a pressure zone, where the TWEAKER will generate a Note Off message immediately after it generates a Note On message. This is not usually desirable behavior and should be avoided. CC Retrigger Rate This Data Byte determines the rate at which all force sensitive pads stream CC messages, when CC messages are enabled. This is a multiple of 5-milliseconds (ms).
Electrix is a Division of Mixware, LLC 11070 Fleetwood St, Unit F Sun Valley, CA 91352 USA www.electrixpro.com © 2012 Mixware, LLC. All rights reserved. Tweaker was developed by Electrix and Livid Instruments. This document is based on firmware version 5.01. The information contained herein is subject to change without prior notice and does not represent a commitment on the part of Mixware, LLC. Electrix and the Electrix logo are registered trademarks of Mixware, LLC. Ableton is a trademark of Ableton AG.