# DMX Motors

Within the <mark style="color:blue;">**Machinery**</mark> library, under <mark style="color:blue;">**\_Generic**</mark> folder, you can find several DMX motor types. There are typically used for stage automation *(moving truss, moving platforms, etc ...)*

## Motor types

Following your automation needs (only translation or rotation, or combined), we have designed several motor types:

<figure><img src="https://content.gitbook.com/content/SJPsyh5CBOise9BtVNGO/blobs/wJwOrB8eflZyhVCWr5xw/2024-03-31%2022_03_50-Clipboard.png" alt=""><figcaption><p>Machinery > _Generic</p></figcaption></figure>

Each motor type contains a small 3D cube *(10cm)* to easily localize the motor origin *(this last does not cast shadows for rendering, but can still be deleted if needed)*:

<figure><img src="https://content.gitbook.com/content/SJPsyh5CBOise9BtVNGO/blobs/FMwOXtZtYgU6x5Ji4vRJ/image.png" alt=""><figcaption></figcaption></figure>

To adjust the translation/rotation rang&#x65;*(s)*, or spee&#x64;*(s)*, please read the [Lighting Fixtures Settings](https://help.depence.com/depence-construction/fixtures/depence-lighting-fixtures-settings).

{% hint style="info" %}
The "- Snap" variants are designed for instantaneous movement *(ultra high speed motor)*
{% endhint %}

### Move motor

<figure><img src="https://content.gitbook.com/content/SJPsyh5CBOise9BtVNGO/blobs/EExaoIK8gGydChsovLxL/Move.png" alt="" width="128"><figcaption></figcaption></figure>

This motor type is designed to control a <mark style="color:blue;">**translation**</mark> movement *(Y axis per default (vertical))*

<figure><img src="https://content.gitbook.com/content/SJPsyh5CBOise9BtVNGO/blobs/IJK0l1U4WhXniFiTWIb0/Move-Motor.webp" alt=""><figcaption></figcaption></figure>

#### DMX charts

{% tabs %}
{% tab title="8-Bit" %}

<table><thead><tr><th width="116">Channel</th><th width="204">Preset Range (default)</th><th>Description</th></tr></thead><tbody><tr><td>1</td><td>0-255 <em>(128)</em></td><td><p>Controls motor position from min to max</p><p><em>(default is -50 cm to +50 cm)</em></p></td></tr></tbody></table>
{% endtab %}

{% tab title="16-Bit" %}

<table><thead><tr><th width="116">Channel</th><th width="204">Preset Range (default)</th><th>Description</th></tr></thead><tbody><tr><td>1-2</td><td>0-255 <em>(128)</em></td><td><p>Controls motor position from min to max</p><p><em>(default is -50 cm to +50 cm)</em></p></td></tr></tbody></table>
{% endtab %}
{% endtabs %}

### Rotate Motor

<figure><img src="https://content.gitbook.com/content/SJPsyh5CBOise9BtVNGO/blobs/T2iki8BMlsuZBT5GUNv1/Rotate.png" alt="" width="128"><figcaption></figcaption></figure>

This motor type is designed to control a <mark style="color:blue;">**rotation**</mark> movement *(Y axis per default (vertical))*

<figure><img src="https://content.gitbook.com/content/SJPsyh5CBOise9BtVNGO/blobs/ypopIKAN8ry4u7kP1TEC/Rotate%20Motor.webp" alt=""><figcaption></figcaption></figure>

#### DMX charts

{% tabs %}
{% tab title="8-Bit" %}

<table><thead><tr><th width="116">Channel</th><th width="204">Preset Range (default)</th><th>Description</th></tr></thead><tbody><tr><td>1</td><td>0-255 <em>(128)</em></td><td><p>Controls motor rotation from min to max</p><p><em>(default is -180° to +180°)</em></p></td></tr></tbody></table>
{% endtab %}

{% tab title="16-Bit" %}

<table><thead><tr><th width="116">Channel</th><th width="204">Preset Range (default)</th><th>Description</th></tr></thead><tbody><tr><td>1-2</td><td>0-255 <em>(128)</em></td><td><p>Controls motor rotation from min to max</p><p><em>(default is -180° to +180°)</em></p></td></tr></tbody></table>
{% endtab %}

{% tab title="8-Bit - Continuous Rotation" %}

<table><thead><tr><th width="116">Channel</th><th width="204">Preset Range (default)</th><th>Description</th></tr></thead><tbody><tr><td>1</td><td>0-255 <em>(128)</em></td><td><p>Controls motor rotation from min to max</p><p><em>(default is -180° to +180°)</em></p></td></tr><tr><td>2</td><td>0 <em>(0)</em><br>1-127<br>128-128<br>129-255</td><td>Off<br>Endless CW rotation <em>(min to max speed)</em><br>Stop<br>Endless CCW rotation <em>(max to min speed)</em></td></tr></tbody></table>
{% endtab %}

{% tab title="16-Bit - Continuous Rotation" %}

<table><thead><tr><th width="116">Channel</th><th width="204">Preset Range (default)</th><th>Description</th></tr></thead><tbody><tr><td>1-2</td><td>0-255 <em>(128)</em></td><td><p>Controls motor rotation from min to max</p><p><em>(default is -180° to +180°)</em></p></td></tr><tr><td>3-4</td><td>0 <em>(0)</em><br>1-127<br>128-128<br>129-255</td><td>Off<br>Endless CW rotation <em>(min to max speed)</em><br>Stop<br>Endless CCW rotation <em>(max to min speed)</em></td></tr></tbody></table>
{% endtab %}
{% endtabs %}

### Move and Rotate

<figure><img src="https://content.gitbook.com/content/SJPsyh5CBOise9BtVNGO/blobs/rs1efrRiHvAl0wUERw9L/Move%20And%20Rotate.png" alt="" width="128"><figcaption></figcaption></figure>

This motor type is designed to control <mark style="color:blue;">**translation**</mark> and <mark style="color:blue;">**rotation**</mark> movement on all axis *(X, Y, Z)*

<figure><img src="https://content.gitbook.com/content/SJPsyh5CBOise9BtVNGO/blobs/K9U1t9p1kqNNXA2LyYCL/Move%20and%20Rotate%20Motor.webp" alt=""><figcaption></figcaption></figure>

#### DMX Charts

{% tabs %}
{% tab title="8-Bit" %}

<table><thead><tr><th width="116">Channel</th><th width="204">Preset Range (default)</th><th>Description</th></tr></thead><tbody><tr><td>1</td><td>0-255 <em>(128)</em></td><td><p>Controls motor position X from min to max</p><p><em>(default is -100 cm to +100 cm)</em></p></td></tr><tr><td>2</td><td>0-255 <em>(128)</em></td><td><p>Controls motor position Y from min to max</p><p><em>(default is -100 cm to +100 cm)</em></p></td></tr><tr><td>3</td><td>0-255 <em>(128)</em></td><td><p>Controls motor position Z from min to max</p><p><em>(default is -100 cm to +100 cm)</em></p></td></tr><tr><td>4</td><td>0-255 <em>(128)</em></td><td><p>Controls motor rotation X from min to max</p><p><em>(default is -180° to +180°)</em></p></td></tr><tr><td>5</td><td>0-255 <em>(128)</em></td><td><p>Controls motor rotation Y from min to max</p><p><em>(default is -180° to +180°)</em></p></td></tr><tr><td>6</td><td>0-255 <em>(128)</em></td><td><p>Controls motor rotation Z from min to max</p><p><em>(default is -180° to +180°)</em></p></td></tr></tbody></table>
{% endtab %}

{% tab title="16-Bit" %}

<table><thead><tr><th width="116">Channel</th><th width="204">Preset Range (default)</th><th>Description</th></tr></thead><tbody><tr><td>1-2</td><td>0-255 <em>(128)</em></td><td><p>Controls motor position X from min to max</p><p><em>(default is -100 cm to +100 cm)</em></p></td></tr><tr><td>3-4</td><td>0-255 <em>(128)</em></td><td><p>Controls motor position Y from min to max</p><p><em>(default is -100 cm to +100 cm)</em></p></td></tr><tr><td>5-6</td><td>0-255 <em>(128)</em></td><td><p>Controls motor position Z from min to max</p><p><em>(default is -100 cm to +100 cm)</em></p></td></tr><tr><td>7-8</td><td>0-255 <em>(128)</em></td><td><p>Controls motor rotation X from min to max</p><p><em>(default is -180° to +180°)</em></p></td></tr><tr><td>9-10</td><td>0-255 <em>(128)</em></td><td><p>Controls motor rotation Y from min to max</p><p><em>(default is -180° to +180°)</em></p></td></tr><tr><td>11-12</td><td>0-255 <em>(128)</em></td><td><p>Controls motor rotation Z from min to max</p><p><em>(default is -180° to +180°)</em></p></td></tr></tbody></table>
{% endtab %}

{% tab title="8-Bit - Continuous Rotation" %}

<table><thead><tr><th width="116">Channel</th><th width="204">Preset Range (default)</th><th>Description</th></tr></thead><tbody><tr><td>1</td><td>0-255 <em>(128)</em></td><td><p>Controls motor position X from min to max</p><p><em>(default is -100 cm to +100 cm)</em></p></td></tr><tr><td>2</td><td>0-255 <em>(128)</em></td><td><p>Controls motor position Y from min to max</p><p><em>(default is -100 cm to +100 cm)</em></p></td></tr><tr><td>3</td><td>0-255 <em>(128)</em></td><td><p>Controls motor position Z from min to max</p><p><em>(default is -100 cm to +100 cm)</em></p></td></tr><tr><td>4</td><td>0-255 <em>(128)</em></td><td><p>Controls motor rotation X from min to max</p><p><em>(default is -180° to +180°)</em></p></td></tr><tr><td>5</td><td>0-255 <em>(128)</em></td><td><p>Controls motor rotation Y from min to max</p><p><em>(default is -180° to +180°)</em></p></td></tr><tr><td>6</td><td>0-255 <em>(128)</em></td><td><p>Controls motor rotation Z from min to max</p><p><em>(default is -180° to +180°)</em></p></td></tr><tr><td>7</td><td>0 <em>(0)</em><br>1-127<br>128-128<br>129-255</td><td>Off<br>Endless CW rotation X <em>(min to max speed)</em><br>Stop<br>Endless CCW rotation X <em>(max to min speed)</em></td></tr><tr><td>8</td><td>0 <em>(0)</em><br>1-127<br>128-128<br>129-255</td><td>Off<br>Endless CW rotation Y <em>(min to max speed)</em><br>Stop<br>Endless CCW rotation Y <em>(max to min speed)</em></td></tr><tr><td>9</td><td>0 <em>(0)</em><br>1-127<br>128-128<br>129-255</td><td>Off<br>Endless CW rotation Z <em>(min to max speed)</em><br>Stop<br>Endless CCW rotation Z <em>(max to min speed)</em></td></tr></tbody></table>
{% endtab %}

{% tab title="16-Bit - Continuous Rotation" %}

<table><thead><tr><th width="116">Channel</th><th width="204">Preset Range (default)</th><th>Description</th></tr></thead><tbody><tr><td>1-2</td><td>0-255 <em>(128)</em></td><td><p>Controls motor position X from min to max</p><p><em>(default is -100 cm to +100 cm)</em></p></td></tr><tr><td>3-4</td><td>0-255 <em>(128)</em></td><td><p>Controls motor position Y from min to max</p><p><em>(default is -100 cm to +100 cm)</em></p></td></tr><tr><td>5-6</td><td>0-255 <em>(128)</em></td><td><p>Controls motor position Z from min to max</p><p><em>(default is -100 cm to +100 cm)</em></p></td></tr><tr><td>7-8</td><td>0-255 <em>(128)</em></td><td><p>Controls motor rotation X from min to max</p><p><em>(default is -180° to +180°)</em></p></td></tr><tr><td>9-10</td><td>0-255 <em>(128)</em></td><td><p>Controls motor rotation Y from min to max</p><p><em>(default is -180° to +180°)</em></p></td></tr><tr><td>11-12</td><td>0-255 <em>(128)</em></td><td><p>Controls motor rotation Z from min to max</p><p><em>(default is -180° to +180°)</em></p></td></tr><tr><td>13-14</td><td>0 <em>(0)</em><br>1-127<br>128-128<br>129-255</td><td>Off<br>Endless CW rotation X <em>(min to max speed)</em><br>Stop<br>Endless CCW rotation X <em>(max to min speed)</em></td></tr><tr><td>15-16</td><td>0 <em>(0)</em><br>1-127<br>128-128<br>129-255</td><td>Off<br>Endless CW rotation Y <em>(min to max speed)</em><br>Stop<br>Endless CCW rotation Y <em>(max to min speed)</em></td></tr><tr><td>17-18</td><td>0 <em>(0)</em><br>1-127<br>128-128<br>129-255</td><td>Off<br>Endless CW rotation Z <em>(min to max speed)</em><br>Stop<br>Endless CCW rotation Z <em>(max to min speed)</em></td></tr></tbody></table>
{% endtab %}
{% endtabs %}

## General informations

### Embed motors

If needed, you can add motor into another motor.

If you do not see them independently in the programmer, it can comes because the programmer view mode is set to <mark style="color:blue;">**Combine Modules**</mark>.

Switch the programmer view mode to <mark style="color:blue;">**Single View Mode**</mark> to see all of them:

<figure><img src="https://content.gitbook.com/content/SJPsyh5CBOise9BtVNGO/blobs/dCIbkzq0cPDobbStkdNt/image.png" alt=""><figcaption><p>Combine module is combining the same fixture as one single control</p></figcaption></figure>

<figure><img src="https://content.gitbook.com/content/SJPsyh5CBOise9BtVNGO/blobs/NePKSPShnMw0Mic95aFQ/image.png" alt=""><figcaption><p>Single view mode shows every fixture independently </p></figcaption></figure>

### Transformation

As any object in the 3D Hierarchy, the position of object are relative to its parent *(see* [*Transformation* ](https://help.depence.com/depence-construction/depence-editor-tools/transformation)*for deeper information)*.

In other words, when you use motors, you have to take a special care to the transformation applied on the tree where your objec&#x74;*(s)* i&#x73;*(are)*.

In a general manner, the origin of your object should be the same than your motor:

{% tabs %}
{% tab title="Motor" %}

<figure><img src="https://content.gitbook.com/content/SJPsyh5CBOise9BtVNGO/blobs/YOjKO9945unYbF1p16e9/2024-03-31%2023_27_41-Syncronorm%20Depence%20R3%20NFR%20-%20(NOT%20FOR%20RESALE).png" alt=""><figcaption><p>Motor origin is at 0,0,0</p></figcaption></figure>
{% endtab %}

{% tab title="Truss group" %}

<figure><img src="https://content.gitbook.com/content/SJPsyh5CBOise9BtVNGO/blobs/ehCqA0okHOUWzIZHX40h/image.png" alt=""><figcaption><p>Truss group origin is at 0,0,0</p></figcaption></figure>
{% endtab %}
{% endtabs %}

Then, you can safely move the motor, containing your truss (and its fixture), at the right location.

{% hint style="success" %} <mark style="color:blue;">**ALT**</mark> key is your best friend when you move object in the 3D Hierarchy *(it keeps the original transformation when dragging and dropping object)*
{% endhint %}

If you moved your object inside the motor, it can result to an unwanted result as following:

<figure><img src="https://content.gitbook.com/content/SJPsyh5CBOise9BtVNGO/blobs/qZ5Mp7xhwEbWRdmdXuxU/Unwanted%20Transformation.webp" alt=""><figcaption></figcaption></figure>