diff --git a/source/chapters/appendix/version_history.rst b/source/chapters/appendix/version_history.rst index 0efb23a947..ad32e801a1 100644 --- a/source/chapters/appendix/version_history.rst +++ b/source/chapters/appendix/version_history.rst @@ -104,7 +104,7 @@ Version History * Add logging when script ControlObject callback is disconnected successfully `#2054 `__ * Add controller mapping for :ref:`Roland DJ-505 ` `#2111 `__ * Add controller mapping for :ref:`Numark iDJ Live II ` `#2818 `__ - * Add controller mapping for Hercules DJControl Inpulse 200 `#2542 `__ + * Add controller mapping for :ref:`Hercules DJControl Inpulse 200 ` `#2542 `__ * Add controller mapping for :ref:`Hercules DJControl Jogvision ` `#2370 `__ * Add controller mapping for :ref:`Pioneer DDJ-200 ` `#3185 `__ `#3193 `__ `#3479 `__ * Add controller mapping for :ref:`Pioneer DDJ-400 ` `#3479 `__ diff --git a/source/hardware/controllers/hercules_djcontrol_inpulse_200.rst b/source/hardware/controllers/hercules_djcontrol_inpulse_200.rst new file mode 100644 index 0000000000..9683504c1e --- /dev/null +++ b/source/hardware/controllers/hercules_djcontrol_inpulse_200.rst @@ -0,0 +1,147 @@ +.. _hercules-djcontrol-inpulse-200: + +Hercules DJControl Inpulse 200 +============================== + +- `Manufacturer’s product page `__ +- `Manufacturer’s support and downloads page `__ +- `Forum thread `__ + +.. versionadded:: 2.3.0 + +Compatibility +------------- + +This controller is a class compliant USB MIDI and audio device, so it can be used without any special drivers on GNU/Linux, Mac OS X, and Windows. However, if you wish to use the `ASIO sound API `__ under Windows, please install the latest driver package available from the `Support page `__. + +Sound Card Setup +---------------- + +This controller has built-in 4 channel output sound card, with :hwlabel:`MASTER` output (RCA) and :hwlabel:`HEADPHONE` output (3.5mm jack). + +1. Open :guilabel:`Preferences > Sound Hardware` +2. Select the :guilabel:`Output` tab +3. From the :guilabel:`Main` drop-down menu, select the audio interface, then :guilabel:`Channels 1 - 2` +4. From the :guilabel:`Headphones` drop-down menu, select the audio interface, then :guilabel:`Channels 3 - 4` +5. Click :guilabel:`Apply` to save the changes. + +.. seealso:: + The :ref:`example setups section ` provides more details about the audio configuration in Mixxx. + +.. note:: + The :hwlabel:`MASTER` and :hwlabel:`HEADPHONE` knobs, as well as the + :hwlabel:`MASTER` button are hardware controls and interact directly with the + integrated sound card’s output. Although they also send MIDI messages, + they have NOT been mapped in Mixxx, so do not expect an on-screen + reaction when using them. This was done to prevent the knobs to adjust + both the gain on the controller’s sound card and in Mixxx. + +Mapping description +------------------- + +All controls not mentioned behave as labeled. + +Decks +~~~~~ + +=============================================================== ========================================== +Control Function +=============================================================== ========================================== +:hwlabel:`SYNC` button Toggle :ref:`Sync Lock `. +:hwlabel:`SHIFT` + :hwlabel:`SYNC` button Set deck as Sync leader. +:hwlabel:`CUE` button Specifies, plays or recalls temporary cue point. +:hwlabel:`SHIFT` + :hwlabel:`CUE` button Return to the beginning of the track. +Play button Play/Pause the current track. +:hwlabel:`SHIFT` + Play button Cue Stutter. +:hwlabel:`VINYL` button Toggle scratch mode (default: on) +Loop :hwlabel:`IN` button Enable Beatloop. +:hwlabel:`SHIFT` + Loop :hwlabel:`IN` button Halve the current loop size. +Loop :hwlabel:`OUT` button Disable Beatloop. +:hwlabel:`SHIFT` + Loop :hwlabel:`OUT` button Double the current loop size. +Beat Align LED Track end warning (make sure :hwlabel:`BEATMATCH GUIDE` is on for this to work) +=============================================================== ========================================== + +Browser +~~~~~~~ + +=============================================================== ========================================== +Control Function +=============================================================== ========================================== +:hwlabel:`BROWSER` encoder (turn) Move up/down list. +:hwlabel:`BROWSER` encoder (press) Switch focus between list and file view. +:hwlabel:`SHIFT` + Encoder (press) Maximize/Minimize library view. +:hwlabel:`ASSISTANT` button Toggle AutoDJ (be sure a playlist was created for AutoDJ before activating this function). +=============================================================== ========================================== + +Performance Pads +~~~~~~~~~~~~~~~~ + +Hot Cue Mode +^^^^^^^^^^^^ + +=============================================================== ========================================== +Control Function +=============================================================== ========================================== +Pad 1 - 4 Set and trigger :term:`hotcue` 1 - 4 +:hwlabel:`SHIFT` + Pad 1 - 4 Delete :term:`hotcue` 1 - 4. +=============================================================== ========================================== + +Roll Mode +^^^^^^^^^ + +=============================================================== ========================================== +Control Function +=============================================================== ========================================== +Pad 1 Set Beatloop of 1 beat size. +Pad 2 Set Beatloop of 2 beat size. +Pad 3 Set Beatloop of 4 beat size. +Pad 4 Set Beatloop of 8 beat size. +=============================================================== ========================================== + +FX Mode +^^^^^^^ + +When using **Firmware v1.68 and earlier**, each FX pad will send multiple and different Note and CC messages. +As these could not all be used properly with Mixxx current effect framework, a simplified configuration was assigned using the pad in :hwlabel:`SHIFT` mode for convenience. + +=============================================================== ========================================== +Control Function +=============================================================== ========================================== +:hwlabel:`SHIFT` + Pad 1 - 3 Toggle Effect 1 - 3. +:hwlabel:`SHIFT` + Pad 4 (deck A) Toggle Effect Rack 1. +:hwlabel:`SHIFT` + Pad 4 (deck B) Toggle Effect Rack 2. +=============================================================== ========================================== + +However, after applying **Firmware v1.72**, each FX pad now sends a simple Note On/Note Off (as is the case in every other Pad mode). +This makes it easier to use the pads to control effect and the latest mapping take advantage of this possibility by removing the use of the :hwlabel:`SHIFT` button. + +=============================================================== ========================================== +Control Function +=============================================================== ========================================== +Pad 1 - 3 Toggle Effect 1 - 3. +Pad 4 (deck A) Toggle Effect Rack 1. +Pad 4 (deck B) Toggle Effect Rack 2. +=============================================================== ========================================== + +.. seealso:: + Read the update guide for more details about `updating the firmware `__. + +Sampler Mode +^^^^^^^^^^^^ + +=============================================================== ========================================== +Control Function +=============================================================== ========================================== +Pad 1 - 4 (deck A) Trigger Sampler 1 - 4. +Pad 1 - 4 (deck B) Trigger Sampler 5 - 8. +=============================================================== ========================================== + +Unmapped Controls +~~~~~~~~~~~~~~~~~ + +The following controls are not mapped because they are controlled by the hardware. + +- :hwlabel:`MASTER` knob +- :hwlabel:`HEADPHONE` knob +- :hwlabel:`MASTER` buttons +- :hwlabel:`BEATMATCH` guide