# Ultra MK2 Full Manual v1.4<no value>

# <span id="anchor"></span>Declaration Of Conformity

<img src="Pictures/10000000000003E80000056085DFB847.jpg" style="width:576px;height:auto" /> <img src="Pictures/10000000000004F4000007029017E676.jpg" style="width:624px;height:auto" /> <img src="Pictures/10000000000004F400000702828DCDF7.jpg" style="width:576px;height:auto" /> <img src="Pictures/10000000000004F4000007024E0751E6.jpg" style="width:576px;height:auto" />

# <span id="anchor-1"></span>Safety Warning

<span id="anchor-2"></span><img src="Pictures/10000000000001B30000018313BD7FA6.png" style="width:190px;height:auto" />

<span style="font-size:40px; font-weight:bold;">WARNING!</span>

**LASER RADIATION**

**AVOID EYE OR SKIN EXPOSURE TO**

**DIRECT OR SCATTERED RADIATION**

**CLASS 4 LASER PRODUCT**

**BEFORE USING THIS PRODUCT, READ AND FOLLOW ALL NOTICES AND SAFETY
INFORMATION THROUGHOUT THIS GUIDE.**

**THIS LASER PRODUCT IS NOT TO BE USED OUTDOORS**

**Some US states require additional licensing and/or registration. Many
locations require operation only under the supervision of a trained
Laser Safety Officer (LSO).**

**FOR PROFESSIONAL USE ONLY.**

<img src="Pictures/1000D8E4000028C20000061D5E5100AB.svg" style="width:396px;height:auto" />

12/F, San Toi Building, 137-139

Connaught Road Central, Hong Kong

Email: support@laseros.com

If you have any questions about any of the content of this manual

or the safe operation of your new laser projector, please do not
hesitate

to contact LaserDock Ltd. directly.

# <span id="anchor-3"></span>LaserCube Parts Diagram

1.  **Laser Aperture:** Laser light is emitted from this opening.
2.  **Beam Block:** Prevents laser emission and also restricts the laser
    scan from going into an audience. Can be locked using the screws
    either side.
3.  **Mounting Bracket:** For secure installation. Tilt may be locked
    using Screws 3a
4.  **WiFi Antenna Connector:** to facilitate wireless connection.
5.  **Status LED:** For showing Connection Mode.
6.  **RJ-45 Ethernet Port:** For cable connection to network.
7.  **Safety Key Control:** Prevents accidental operation. Resetting of
    the key control will be required if there is a power loss or remote
    interlock cycling.
8.  **RJ45 Remote Interlock Connectors:** In/Through. Provides a safety
    shut-off for terminating the laser emission via a jumper connection.
    *A jumper is included with the product*.\* Do not attach Ethernet
    devices to these connectors.

> *\*For the **US LaserCube** model, the jumper is not included. It is
> required to be operated with an E-Stop for FDA compliance and will not
> work with only the safety jumper installed. *

> 

9.  **Emission LEDs:** Indicate when the Laser is emitting or ready to
    emit.
10. **Power Switch:** Toggles the power ON or OFF.
11. **Power LED:** Indicates when the Power Switch is ON.
12. **Power (19V DC) Input:** Power connection/charging port via wall
    outlet.
13. **Charging Status LED indicator:** Red = Charging, Green = Fully
    Charged
14. **Rotary / Push Menu Knob:** Navigate Cube OS and adjust settings.
15. **LCD Display for CubeOS**.
16. **USB Port:** Connect a USB MIDI device (APC40Mk2 / APC Mini Mk2)
17. **MicroSD Card slot:** Stores content for MIDI, ArtNet, DMX and
    Stand Alone mode.
18. **Internal Microphone:** Audio input source for built-in
    visualisers.
19. **3.5mm Audio Line Input:** Audio input source for built-in
    visualisers
20. **3.5mm Audio Line Output:** Audio Laser show output to powered
    speakers.
21. ILDA Ports (In/Out):

> **21a. ILDA Input Connector: DB25 Male:** The Laser cube will
> automatically change from the internal LaserOS DAC to an external ILDA
> compatible DAC if connected to this port.

> In the settings for the software that accompanies the external DAC, we
> suggest configuring the scan rate to 30000 points per second.

> **21b. ILDA Output Connector: DB25 Female:** Duplicate of the internal
> LaserOS DAC signals, of those of an external DAC when connected to the
> ILDA input. \*ILDA output is NOT present on the smaller EVO models.

> 

22. **DMX connectors (In/Out):** Connect to a lighting desk / controller

> **22a.** DMX Input (EVO is input on LHS, and output on RHS, via the
> two 3.5mm Jacks)

> **22b.** DMX Output

> 

23. **Safety Eye Bolt:** When mounted at height, attach safety cable
    through the eye.

> 

> 

> 

>  **Ultra
> MK2**<img src="Pictures/1000000100000522000007BCC49CE081.png"
> style="width:15.171cm;height:22.86cm" />

EVO

<img src="Pictures/10000001000005140000041E0A7C8F03.png" style="width:643px;height:auto" />

# <span id="anchor-4"></span>Technical Specifications

<span id="anchor-5"></span>(all current production and previous models
listed below)

<span id="anchor-6"></span> **10 Ultra MK2**

<table>
<tbody>
<tr>
<td>Name:</td>
<td>LaserCube</td>
</tr>
<tr>
<td>Model:</td>
<td>10 Ultra Mk2</td>
</tr>
<tr>
<td>Laser Class:</td>
<td>Class 4</td>
</tr>
<tr>
<td>Power:</td>
<td>10000mW</td>
</tr>
<tr>
<td>Blue 455nm:</td>
<td>5000mW</td>
</tr>
<tr>
<td>Green 525nm:</td>
<td>2800mW</td>
</tr>
<tr>
<td>Red 638nm:</td>
<td>2800mW</td>
</tr>
<tr>
<td>Battery:</td>
<td>92.16Wh </td>
</tr>
<tr>
<td>Modulation:</td>
<td>Analog 70kHz</td>
</tr>
<tr>
<td><strong>Scan speed:</strong></td>
<td><strong>&gt;35,000pps @ 7 deg</strong></td>
</tr>
<tr>
<td>Max Scan Angle:</td>
<td>&gt;37 degrees</td>
</tr>
<tr>
<td>Connectivity:</td>
<td><p>WiFi RP-SMA Female, 2.4GHz<br />
Ethernet RJ45 connector, 100Mbps</p>
<p>ILDA Ports (In/Out)</p>
<p>DMX Ports (In/Out)</p>
<p>USB-A Port (for APC USB MIDI device)</p>
<p>3.5mm Stereo Line Audio Ports (In/Out)</p>
<p>MicroSD card socket</p>
<p>Interlock RJ45 connectors (In/Through)</p></td>
</tr>
<tr>
<td>Size:</td>
<td>15.5 x 15 x 15.5 cm</td>
</tr>
<tr>
<td>Weight:</td>
<td>3.7 kg</td>
</tr>
<tr>
<td>Voltage:</td>
<td>19V DC, 120W adapter</td>
</tr>
<tr>
<td>Warranty:</td>
<td>1 year</td>
</tr>
<tr>
<td>Software:</td>
<td>Internal CubeOS + <a
href="https://www.wickedlasers.com/laserdock"><em>LaserOS Included</em></a></td>
</tr>
<tr>
<td>Safety:</td>
<td>Features key, interlock, beam block, indicator LED. Complies with
latest safety standard IEC 60825-1</td>
</tr>
</tbody>
</table>

7.5 Ultra MK2

<table>
<tbody>
<tr>
<td>Name:</td>
<td>LaserCube</td>
</tr>
<tr>
<td>Model:</td>
<td>7.5 Ultra Mk2</td>
</tr>
<tr>
<td>Laser Class:</td>
<td>Class 4</td>
</tr>
<tr>
<td>Power:</td>
<td>7500mW</td>
</tr>
<tr>
<td>Blue 455nm:</td>
<td>4000mW</td>
</tr>
<tr>
<td>Green 525nm:</td>
<td>2000mW</td>
</tr>
<tr>
<td>Red 638nm:</td>
<td>1500mW</td>
</tr>
<tr>
<td>Battery:</td>
<td>92.16Wh </td>
</tr>
<tr>
<td>Modulation:</td>
<td>Analog 70kHz</td>
</tr>
<tr>
<td><strong>Scan speed:</strong></td>
<td><strong>&gt;35,000pps @ 7 deg</strong></td>
</tr>
<tr>
<td>Max Scan Angle:</td>
<td>&gt;37 degrees</td>
</tr>
<tr>
<td>Connectivity:</td>
<td><p>WiFi RP-SMA Female, 2.4GHz<br />
Ethernet RJ45 connector, 100Mbps</p>
<p>ILDA Ports (In/Out)</p>
<p>DMX Ports (In/Out)</p>
<p>USB-A Port (for APC USB MIDI device)</p>
<p>3.5mm Stereo Line Audio Ports (In/Out)</p>
<p>MicroSD card socket</p>
<p>Interlock RJ45 connectors (In/Through)</p></td>
</tr>
<tr>
<td>Size:</td>
<td>15.5 x 15 x 15.5 cm</td>
</tr>
<tr>
<td>Weight:</td>
<td>3.7 kg</td>
</tr>
<tr>
<td>Voltage:</td>
<td>19V DC, 120W adapter</td>
</tr>
<tr>
<td>Warranty:</td>
<td>1 year</td>
</tr>
<tr>
<td>Software:</td>
<td>Internal CubeOS + <a
href="https://www.wickedlasers.com/laserdock"><em>LaserOS Included</em></a></td>
</tr>
<tr>
<td>Safety:</td>
<td>Features key, interlock, beam block, indicator LED. Complies with
latest safety standard IEC 60825-1</td>
</tr>
</tbody>
</table>

6.0 Ultra MK2

<table>
<tbody>
<tr>
<td>Name:</td>
<td>LaserCube</td>
</tr>
<tr>
<td>Model:</td>
<td>6.0 Ultra Mk2</td>
</tr>
<tr>
<td>Laser Class:</td>
<td>Class 4</td>
</tr>
<tr>
<td>Power:</td>
<td>6000mW</td>
</tr>
<tr>
<td>Blue 455nm:</td>
<td>2700mW</td>
</tr>
<tr>
<td>Green 525nm:</td>
<td>1500mW</td>
</tr>
<tr>
<td>Red 638nm:</td>
<td>1800mW</td>
</tr>
<tr>
<td>Battery:</td>
<td>92.16Wh </td>
</tr>
<tr>
<td>Modulation:</td>
<td>Analog 70kHz</td>
</tr>
<tr>
<td><strong>Scan speed:</strong></td>
<td><strong>&gt;35,000pps @ 7 deg</strong></td>
</tr>
<tr>
<td>Max Scan Angle:</td>
<td>&gt;37 degrees</td>
</tr>
<tr>
<td>Connectivity:</td>
<td><p>WiFi RP-SMA Female, 2.4GHz<br />
Ethernet RJ45 connector, 100Mbps</p>
<p>ILDA Ports (In/Out)</p>
<p>DMX Ports (In/Out)</p>
<p>USB-A Port (for APC USB MIDI device)</p>
<p>3.5mm Stereo Line Audio Ports (In/Out)</p>
<p>MicroSD card socket</p>
<p>Interlock RJ45 connectors (In/Through)</p></td>
</tr>
<tr>
<td>Size:</td>
<td>15.5 x 15 x 15.5 cm</td>
</tr>
<tr>
<td>Weight:</td>
<td>3.7 kg</td>
</tr>
<tr>
<td>Voltage:</td>
<td>19V DC, 120W adapter</td>
</tr>
<tr>
<td>Warranty:</td>
<td>1 year</td>
</tr>
<tr>
<td>Software:</td>
<td>Internal CubeOS + <a
href="https://www.wickedlasers.com/laserdock"><em>LaserOS Included</em></a></td>
</tr>
<tr>
<td>Safety:</td>
<td>Features key, interlock, beam block, indicator LED. Complies with
latest safety standard IEC 60825-1</td>
</tr>
</tbody>
</table>

2.5 Ultra MK2

<table>
<tbody>
<tr>
<td>Name:</td>
<td>LaserCube</td>
</tr>
<tr>
<td>Model:</td>
<td>2.5 Ultra Mk2</td>
</tr>
<tr>
<td>Laser Class:</td>
<td>Class 4</td>
</tr>
<tr>
<td>Power:</td>
<td>2500mW</td>
</tr>
<tr>
<td>Blue 455nm:</td>
<td>1300mW</td>
</tr>
<tr>
<td>Green 525nm:</td>
<td>800mW</td>
</tr>
<tr>
<td>Red 638nm:</td>
<td>400mW</td>
</tr>
<tr>
<td>Battery:</td>
<td>92.16Wh </td>
</tr>
<tr>
<td>Modulation:</td>
<td>Analog 70kHz</td>
</tr>
<tr>
<td><strong>Scan speed:</strong></td>
<td><strong>&gt;35,000pps @ 7 deg</strong></td>
</tr>
<tr>
<td>Max Scan Angle:</td>
<td>&gt;37 degrees</td>
</tr>
<tr>
<td>Connectivity:</td>
<td><p>WiFi RP-SMA Female, 2.4GHz<br />
Ethernet RJ45 connector, 100Mbps</p>
<p>ILDA Ports (In/Out)</p>
<p>DMX Ports (In/Out)</p>
<p>USB-A Port (for APC USB MIDI device)</p>
<p>3.5mm Stereo Line Audio Ports (In/Out)</p>
<p>MicroSD card socket</p>
<p>Interlock RJ45 connectors (In/Through)</p></td>
</tr>
<tr>
<td>Size:</td>
<td>15.5 x 15 x 15.5 cm</td>
</tr>
<tr>
<td>Weight:</td>
<td>3.7 kg</td>
</tr>
<tr>
<td>Voltage:</td>
<td>19V DC, 120W adapter</td>
</tr>
<tr>
<td>Warranty:</td>
<td>1 year</td>
</tr>
<tr>
<td>Software:</td>
<td>Internal CubeOS + <a
href="https://www.wickedlasers.com/laserdock"><em>LaserOS Included</em></a></td>
</tr>
<tr>
<td>Safety:</td>
<td>Features key, interlock, beam block, indicator LED. Complies with
latest safety standard IEC 60825-1</td>
</tr>
</tbody>
</table>

6.0 EVO

<table>
<tbody>
<tr>
<td>Name:</td>
<td>LaserCube</td>
</tr>
<tr>
<td>Model:</td>
<td>6.0 EVO</td>
</tr>
<tr>
<td>Laser Class:</td>
<td>Class 4</td>
</tr>
<tr>
<td>Power:</td>
<td>6000mW</td>
</tr>
<tr>
<td>Blue 455nm:</td>
<td>2700mW</td>
</tr>
<tr>
<td>Green 525nm:</td>
<td>1500mW</td>
</tr>
<tr>
<td>Red 638nm:</td>
<td>1800mW</td>
</tr>
<tr>
<td>Battery:</td>
<td>70Wh </td>
</tr>
<tr>
<td>Modulation:</td>
<td>Analog 70kHz</td>
</tr>
<tr>
<td><strong>Scan speed:</strong></td>
<td><strong>&gt;35,000pps @ 7 deg</strong></td>
</tr>
<tr>
<td>Max Scan Angle:</td>
<td>&gt;37 degrees</td>
</tr>
<tr>
<td>Connectivity:</td>
<td><p>WiFi RP-SMA Female, 2.4GHz<br />
Ethernet RJ45 connector, 100Mbps</p>
<p>ILDA Port (In)</p>
<p>USB-A Port (for APC USB MIDI device)</p>
<p>3.5mm Stereo Line Audio Ports (In/Out)</p>
<p>MicroSD card socket</p>
<p>Interlock RJ45 connectors (In/Through)</p></td>
</tr>
<tr>
<td>Size:</td>
<td>15.5 x 15 x 15.5 cm</td>
</tr>
<tr>
<td>Weight:</td>
<td>3.7 kg</td>
</tr>
<tr>
<td>Voltage:</td>
<td>19V DC, 120W adapter</td>
</tr>
<tr>
<td>Warranty:</td>
<td>1 year</td>
</tr>
<tr>
<td>Software:</td>
<td>Internal CubeOS + <a
href="https://www.wickedlasers.com/laserdock"><em>LaserOS Included</em></a></td>
</tr>
<tr>
<td>Safety:</td>
<td>Features key, interlock, beam block, indicator LED. Complies with
latest safety standard IEC 60825-1</td>
</tr>
</tbody>
</table>

3.0 EVO

<table>
<tbody>
<tr>
<td>Name:</td>
<td>LaserCube</td>
</tr>
<tr>
<td>Model:</td>
<td>3.0 EVO</td>
</tr>
<tr>
<td>Laser Class:</td>
<td>Class 4</td>
</tr>
<tr>
<td>Power:</td>
<td>3000mW</td>
</tr>
<tr>
<td>Blue 455nm:</td>
<td>1350mW</td>
</tr>
<tr>
<td>Green 525nm:</td>
<td>850mW</td>
</tr>
<tr>
<td>Red 638nm:</td>
<td>950mW</td>
</tr>
<tr>
<td>Battery:</td>
<td>70Wh </td>
</tr>
<tr>
<td>Modulation:</td>
<td>Analog 70kHz</td>
</tr>
<tr>
<td><strong>Scan speed:</strong></td>
<td><strong>&gt;35,000pps @ 7 deg</strong></td>
</tr>
<tr>
<td>Max Scan Angle:</td>
<td>&gt;37 degrees</td>
</tr>
<tr>
<td>Connectivity:</td>
<td><p>WiFi RP-SMA Female, 2.4GHz<br />
Ethernet RJ45 connector, 100Mbps</p>
<p>ILDA Port (In)</p>
<p>USB-A Port (for APC USB MIDI device)</p>
<p>3.5mm Stereo Line Audio Ports (In/Out)</p>
<p>MicroSD card socket</p>
<p>Interlock RJ45 connectors (In/Through)</p></td>
</tr>
<tr>
<td>Size:</td>
<td>15.5 x 15 x 15.5 cm</td>
</tr>
<tr>
<td>Weight:</td>
<td>3.7 kg</td>
</tr>
<tr>
<td>Voltage:</td>
<td>19V DC, 120W adapter</td>
</tr>
<tr>
<td>Warranty:</td>
<td>1 year</td>
</tr>
<tr>
<td>Software:</td>
<td>Internal CubeOS + <a
href="https://www.wickedlasers.com/laserdock"><em>LaserOS Included</em></a></td>
</tr>
<tr>
<td>Safety:</td>
<td>Features key, interlock, beam block, indicator LED. Complies with
latest safety standard IEC 60825-1</td>
</tr>
</tbody>
</table>

# <span id="anchor-7"></span>Product Labelling and Placement

<img src="Pictures/10000001000003EC000003D08E2217CA.png" style="width:349px;height:auto" /> <img src="Pictures/10000000000000C80000005A255D295D.jpg" style="width:200px;height:auto" /> <img src="Pictures/100000010000016200000104B6A30C86.png" style="width:215px;height:auto" /> <img src="Pictures/10000001000002EA0000039A472BE24B.png" style="width:325px;height:auto" /> <img src="Pictures/10000001000003EC000003D08E2217CA.png" style="width:349px;height:auto" />

# <span id="anchor-8"></span>Safety Guidelines and Proper Usage

1\. No scheduled maintenance necessary to keep the product in
compliance. Simply keep the laser free from dust or other contaminates
that could cloud or dirty the laser aperture. Cleaning the aperture
window and vents are the ONLY maintenance allowed and must be performed
with the unit powered down and locked off. **Servicing by the user is
not allowed. Any attempt to open or modify the unit is prohibited.
Instant permanent blindness may result in case of an accidental eye
exposure to the beam.**

2\. Do not expose the human eye directly or indirectly to focused or
scattered laser radiation as loss of vision, complete blindness, and/or
other serious injuries may result. Lasers are capable of starting fires
at great distances. Do not use around flammable materials.\*

3\. Do not take apart, modify or dismantle the laser or operate it under
abnormal current load (doing so will void the warranty). Strictly no
service is allowed. Servicing should only be handled by authorized
factory trained technicians.

4\. Always treat your laser with great care as some components are very
fragile and must not be subjected to shock.

5\. Avoid turning the laser on and off frequently as it will reduce the
diode life. This device does not have a set duty cycle but we do not
recommend using it for more than four hours continuously.

6\. From time to time, clean the laser aperture with a dry tissue that
does not pill. You may also use an alcohol prep wipe and compressed air
to blow dust from the vents. BE SURE the alcohol has dried fully before
activating the laser. **Cleaning the aperture and vents are the only
user maintenance allowed and can ONLY be performed with the unit powered
down and locked off.**

7\. Always keep all factory supplied labels on the unit and visible.
These are required for legal compliance.

8\. During use, be sure to leave an open space around all sides of the
laser to facilitate airflow through the heat sink beneath the device.

9\. Operate your laser only within the specified temperature range of
10°C (50°F) to 40°C (104°F). Failure to do so may result in weak output,
overly strong output which will diminish the life of the unit and/or
large output power swings. The LaserCube is thermostatically monitored
so we can determine if a failure was temperature related. Such failures
are NOT covered under our manufacturer’s warranty. Extreme cold and hot
temperatures WILL cause a diode failure. Keep this unit climate
controlled at ALL times.

10\. Always ensure that the main power supply is properly grounded
before use. Do not use a 2 prong IEC cord with this projector. You
should always hook up a laser system in such a way that you have both a
primary and backup means of instantly terminating laser emissions.

11\. DO NOT USE the laser device if you suspect that it contains a
defect of any kind either from manufacturing, damage, general wear or
has a broken manufacturer’s seal. Contact us to return the unit to the
factory for service and/or maintenance immediately.

12\. Should you have difficulty operating the laser properly and
troubleshooting does not work, go to
[www.LaserOS.com](https://www.laseros.com/) for support and RMA
assistance if necessary. Do not attempt to service, modify or fix the
laser yourself. You will be provided with instructions on how to send
the laser projector back for repair.

13\. Before using this product in any capacity, ensure that the unit is
properly secured to prevent accidental beam shifts and that a safety
cable is used for any aerial rigging.

14\. This product is not a toy and should be kept inaccessible to
unauthorized persons before, during, and after use. Keep away from
minors.

15\. The LaserCube includes all required safety features per
international regulations. For US residents, authorized persons should
only be employees of an FDA variance holder.

16\. This product is not to be used outdoors. Do not allow laser light
to escape indoor settings as this level of laser light can interfere
with Aircraft operation at many miles. DO NOT allow lasers to hit
aircraft or enter airspace. Shining a laser at an aircraft in the US is
considered a federal crime punishable by fines or jail time.\*\*

17\. Before using this product, it is the responsibility of the user to
be familiar with all Federal and State reporting and usage requirements.
Laws vary by state, some US states require additional licensing and/or
registration. Many locations require operation only under the
supervision of a trained Laser Safety Officer (LSO). An FDA variance is
required to operate this product in the United States.

18\. For all venues you must designate safe and restricted areas of the
venue where persons are or are not allowed to be respectively. The “safe
areas” should not be subject to any laser radiation either directly or
indirectly. By protocol, there must be at least a 3 meter buffer between
safe and restricted areas on all sides. In other words, all laser beams
must terminate (ie. not be reflected away) in the restricted areas to
avoid human contact. The laser must never be aimed at or allowed to be
directed or reflected toward other people or reflective objects.

19\. Do not stand in front of the laser while active. All persons should
wear protective eyewear while rigging, maintaining, or otherwise working
with the laser.

\*Failure to follow the above precautions and other precautions
contained in this user manual, particularly with regard to human
exposure to laser radiation and electrical safety, may result in serious
injury, loss of vision, electric shock or skin damage. Class 4 lasers
must be handled and operated with care and extreme caution.

\*\*This product shall NOT be operated by persons who are not trained in
proper laser safety procedures and/or do not know how to use all
components of a laser system properly. The safety procedures outlined in
this manual must be observed at all times to provide you with safe and
fun laser displays. Please contact us if you have any questions about
how to safely and effectively use our products!

For more safety information & guidance please refer to:

[**IEC/TR 60825-3:2022 Laser Show
Guidance**](https://www.en-standard.eu/iec-tr-60825-3-2022-safety-of-laser-products-part-3-guidance-for-laser-displays-and-shows/)

[*https://www.en-standard.eu/iec-tr-60825-3-2022-safety-of-laser-products-part-3-guidance-for-laser-displays-and-shows/*](https://www.en-standard.eu/iec-tr-60825-3-2022-safety-of-laser-products-part-3-guidance-for-laser-displays-and-shows/)

### <span id="anchor-9"></span>Abstract

IEC/TR 60825-3:2022

Safety of laser products - Part 3: Guidance for laser displays and shows

IEC TR 60825-3:2022 gives guidance on the planning and design, set-up
and conduct of laser displays and shows that make use of high power
lasers emitting output between 380 nm and 780 nm.

This document is a code of practice for the design, installation,
operation and evaluation of the safety of laser light shows and
displays, and the equipment employed in their production. This document
is also intended for persons who modify laser display installations or
equipment.

The laser power needed to produce visually effective theatrical or
artistic displays in large spaces such as theatres, arenas, or
architectural sites is great enough to pose a severe accidental exposure
hazard, even when personal exposure is very brief. For this reason, IEC
TR 60825-14 states that only laser products that are Class 1, Class 2 or
visible-beam Class 3R should be used for demonstration, display or
entertainment purposes in unsupervised areas. Only under carefully
controlled conditions and under the control of a trained experienced
operator can laser products of higher classes be used for visual
entertainment.

This document expands upon the principles considered in IEC TR 60825-14,
providing specific technical guidance appropriate for the safe use of
laser products used for the purposes of visual entertainment.

# <span id="anchor-10"></span><span id="anchor-11"></span><span id="anchor-12"></span>Enabling the Laser E-Stop / Interlock

<span id="anchor-13"></span>

<figure>
<img src="Pictures/10000001000003F2000001E0A4D9C7FB.png" style="width:576px;height:auto" />
<figcaption aria-hidden="true"></figcaption>
</figure>

# <span id="anchor-14"></span>E-STOP Setup Guide

This part of the guide is only relevant to the US version of the MK2.

<div class="row g-3 align-items-start">
  <div class="col">
    {{< img src="Pictures/10000001000001B1000002B076B4CB4A.png" formats="webp jpeg" >}}
  </div>
  <div class="col">
    {{< img src="Pictures/1000000100000178000002B3252F4301.png" formats="webp jpeg" >}}
  </div>
</div>

1\) Connect the e-stop pendant to the LaserCube.

2\) On the laser, turn key to the "ON" position.

3\) On the e-stop pendant, if the red STOP switch is pushed in, rotate
clockwise until it can be raised.

4\) On the e-stop pendant, turn the key clockwise to the “ON” position.

5\) With the red STOP switch raised plus keys on both the laser and
pendant set to the “ON” position the Interlock / Emission LEDs will
flash slowly, once every 3 seconds.

6\) After the second flash, the laser may be enabled by briefly pressing
the green START button. The Interlock / Emission LEDs will begin
flashing more quickly, once every second. After 10 seconds the LEDS will
remain solidly on and the laser will be capable of emission.

<img src="Pictures/10000001000004F3000001A243958368.png" style="width:551px;height:auto" />

NOTE: In case of an emergency and you need to stop the laser, press the
big red button.

# <span id="anchor-15"></span>Hardware Installation

1\. Adjust the beam block with the unit powered off, make sure the key
is not connected, secure projector aiming, then make adjustments to the
beam block.

Note: You may need to repeatedly power the laser back on to check for
the proper beam block setting until it prevents any scanning into
audience areas. All beams must be maintained at least 3 Meters (10 feet)
above the floor level where people may be present. **Eye exposure to
laser light can cause instant injury and permanent blindness.**

<img src="Pictures/1000000100000399000002F7049CBEAD.png" style="width:469px;height:auto" />

2\. Place appropriate compliant ANSI area warning sign(s) in and around
the laser show venue especially areas accessible to the audience.

<img src="Pictures/10000001000006B40000040B51480D28.png" style="width:620px;height:auto" />

**Visit** [**www.laseros.com/guide**](http://www.laseros.com/guide)
**for the full LaserOS guide.**

<span id="anchor-16"></span><span id="anchor-17"></span>**Visit**
[**www.laseros.com/wiki**](http://www.laseros.com/wiki) **for the online
Ultra Mk2 guide.**

# <span id="anchor-18"></span>CubeOS LCD Settings and Status

The rear panel LCD displays certain status information, and allows
configuration of the control mode and connection settings as well as a
live preview of points entering the DAC\*.

<div class="row g-3 align-items-start">
  <div class="col">
    {{< img src="Pictures/10000000000000F000000140983831BA.bmp" formats="webp jpeg" >}}
  </div>
  <div class="col">
    {{< img src="Pictures/10000000000000F00000014045EBEFAD.bmp" formats="webp jpeg" >}}
  </div>
  <div class="col">
    {{< img src="Pictures/10000000000000F000000140FAA77239.bmp" formats="webp jpeg" >}}
  </div>
</div>

<div class="row g-3 align-items-start">
  <div class="col">
    {{< img src="Pictures/10000000000000F000000140A0990F82.bmp" formats="webp jpeg" >}}
  </div>
  <div class="col">
    {{< img src="Pictures/10000000000000F000000140DF397414.bmp" formats="webp jpeg" >}}
  </div>
</div>

<span id="anchor-19"></span>The status bar area at the bottom of the
display gives the user a quick overview of the device, and displays any
important messages or warnings. The background colour will also change
to indicate certain connection states. e.g. a green background indicates
active samples being received over the network, and a cyan background
indicates the ILDA analog input is being used (overriding the current
DAC data for the currently selected ctrl mode).

<span id="anchor-20"></span>\*Note: The live preview only works for DAC
samples received over the network, or internally generated projections,
NOT data from the analog ILDA port on the back of the device.

# <span id="anchor-21"></span>Control Modes

The Ultra MK2 / Evo currently has 8 selectable control modes:

- LaserOS control mode
- ArtNet control mode
- DMX control mode
- Visualizer control mode
- Playlist control mode
- Laser show control mode
- IDN (ILDA digital network protocol, streaming up to 35K pps)
- Ether-dream (DAC network protocol)

<img src="Pictures/10000000000007D80000050063744350.png" style="width:643px;height:auto" />

## <span id="anchor-22"></span>LaserOS Control Mode

This mode is used when you want our LaserOS application to be in
complete control of the MK2 laser cube, or you wish to use any of the
supported third party applications like Liberation, LaserShowGen,
Madmapper, Touch Designer etc.

In this mode all projections are streamed over LAN/WiFI directly to the
laser cube, so the Settings→Projection menu items will not be available
since these are now adjusted via the LaserOS settings menu, or other
third party software projection settings.

1)  Select Control Mode, LaserOS

> <img src="Pictures/10000000000000F000000140A5F3C3F9.png"
> style="width:3.293cm;height:4.392cm" /><img src="Pictures/10000000000000F000000140F4DB06AC.png"
> style="width:3.293cm;height:4.392cm" />

> 

2)  Select Settings -\> Connection -\> WiFi server

> <img src="Pictures/10000000000000F000000140093C94D8.png"
> style="width:3.507cm;height:4.674cm" /><img src="Pictures/10000000000000F00000014036541C9C.png"
> style="width:3.493cm;height:4.657cm" /><img src="Pictures/10000000000000F000000140A1880E4F.png"
> style="width:3.493cm;height:4.657cm" />

> 

3)  when using WiFi server, connect to the Laser cube’s Access Point
    with your mobile or desktop / Laptop device. By default, the SSID is
    **LaserCube**. The default WiFi password is **Laser2020**. These
    settings may be changed under Settings -\> Network -\> WiFi Server.

<div class="row g-3 align-items-start">
  <div class="col">
    {{< img src="Pictures/10000000000000F000000140093C94D8.png" formats="webp jpeg" >}}
  </div>
  <div class="col">
    {{< img src="Pictures/10000000000000F0000001409D4CA66C.png" formats="webp jpeg" >}}
  </div>
  <div class="col">
    {{< img src="Pictures/10000000000000F000000140F4B55E87.png" formats="webp jpeg" >}}
  </div>
</div>

<div class="row g-3 align-items-start">
  <div class="col">
    {{< img src="Pictures/10000000000000F000000140BAFD1B0E.png" formats="webp jpeg" >}}
  </div>
</div>

In order to get the best projection quality with minimal projection
interruptions we recommend using the WiFi scan button in the WiFi server
settings page to show the current congestion status of the available
2.4GHz WiFi channels. If the channel scan is heavily congested then we
recommend using a wired connection method. Using WiFi outdoors should be
absolutely fine, but in some apartment buildings it could likely result
in projection break-up unless the supplied LAN adapter is used with your
mobile/desktop device.

<div class="row g-3 align-items-start">
  <div class="col">
    {{< img src="Pictures/10000000000000F000000140A5EF5ED7.bmp" formats="webp jpeg" >}}
  </div>
  <div class="col">
    {{< img src="Pictures/10000000000000F0000001407743B4A1.bmp" formats="webp jpeg" >}}
  </div>
</div>

4)  If using LAN, we recommend using LAN client if you are planning to
    connect to your home router or switch. If no DHCP server is present
    on the network to assign an IP address (e.g. direct LAN cable
    connection between mac and laser cube), the Laser cube will
    self-assign an APIPA address, or you can instead select LAN server
    and the cube will auto assign an IP address to your MacBook or
    Windows Laptop etc.

The images below show how to set the connection mode:

<div class="row g-3 align-items-start">
  <div class="col">
    {{< img src="Pictures/10000000000000F000000140093C94D8.png" formats="webp jpeg" >}}
  </div>
  <div class="col">
    {{< img src="Pictures/10000000000000F00000014036541C9C.png" formats="webp jpeg" >}}
  </div>
  <div class="col">
    {{< img src="Pictures/10000000000000F000000140B71EF241.png" formats="webp jpeg" >}}
  </div>
</div>

> If changing the connection method, the Laser cube will ask you to
> reboot the device. Highlight “YES” using the red cursor box then push
> the encoder knob to confirm.

> 

{{< img src="Pictures/10000000000000F00000014066AA589C.bmp" formats="webp jpeg" >}}

### <span id="anchor-23"></span>Installing LaserOS 0.18.1 or later

Before you can add content to your Ultra/Evo, or directly stream to it,
our LaserOS desktop software must firstly be installed onto your PC/Mac.
Go to <http://www.laseros.com/> and scroll down until you see the
download links as shown in the image below:

<img src="Pictures/10000001000004E00000036122E30F7D.png" style="width:643px;height:auto" />

Alternatively, you can use the direct web links provided below for
PC/Mac operating systems.

Note: You cannot use the iOS or Android version of LaserOS to export to
the MK2 SD card. Mobile platforms are for direct streaming to cubes
only. Adding content must be done via PC/Mac version.

#### <span id="anchor-24"></span>Windows Platform

- Follow this link to [download for PCs running
  Windows](https://laseros.s3.amazonaws.com/releases/LaserOS64_Setup.exe)*.*
- Double click on the downloaded .exe file to install LaserOS.  
- Occasionally, Windows will display the following warning.  Click on
  “more info” to enable the “run anyway option”.  Click on “run anyway”.

<img src="Pictures/10000001000004D8000002367B86816B.png" style="width:643px;height:auto" />
#### <span id="anchor-25"></span>MacOS Platform

- Follow this link to [download and install for Mac
  OS](https://laseros.s3.amazonaws.com/releases/LaserOS.pkg)*.*
- Double-click on the .pkg file and run the installer app.

Follow the instructions for installing LaserOS on your chosen platform,
then run the software by opening Launchpad on MacOS, or click the icon
for LaserOS on your desktop if using a Windows platform.

### <span id="anchor-26"></span><span id="anchor-27"></span><span id="anchor-28"></span>Using LaserOS

After connecting your LaserCube(s) over LAN or WiFi to your network, the
LaserOS app will detect if any are connected. The LaserCube can then be
turned on or off from the power menu in the top left corner of the app.
Pressing the ESC key will also turn it off.

<img src="Pictures/100000000000017F000000EE3A344951.jpg" style="width:338px;height:auto" />

Note: While securing projector aiming, turn off the unit and remove the
key. Check for the proper beam block setting. Repeat until beam block
prevents any scanning into audience areas.

From the main menu, you can easily select from the different apps, modes
and laser show effects available. Audio, power level, colour/hue and
other settings can also be adjusted from here.

<img src="Pictures/100000000000022400000141865A7806.jpg" style="width:455px;height:auto" />

## <span id="anchor-29"></span>Playlist Control Mode

This control mode is used to play custom playlists exported from our
LaserOS app to the SD card.

It can be selected by going to the Control Mode menu and selecting
“Playlist” from the options.

<div class="row g-3 align-items-start">
  <div class="col">
    {{< img src="Pictures/10000000000000F000000140A0990F82.bmp" formats="webp jpeg" >}}
  </div>
  <div class="col">
    {{< img src="Pictures/10000000000000F00000014065F93298.bmp" formats="webp jpeg" >}}
  </div>
</div>

### <span id="anchor-30"></span>Creating a custom playlist

Before being able to project content on the Mk2 in playlist mode you
must first create a playlist or export an existing playlist to the MK2
SD card using the desktop version of our LaserOS software.

The method of adding new content to the MK2 is via a LaserOS playlist,
by either selecting an existing one you already created, or by creating
a new one from scratch.

You can create a new playlist by selecting the playlists app from the
centre pane, then click the small ‘+’ icon as shown in the image below:

<img src="Pictures/10000001000002CD0000017B64D99980.png" style="width:488px;height:auto" />

Once you create a playlist, you will now be able to drag content from
the various categories into the playlist pane on the right hand side.
You can also add content to a playlist by right clicking on any CUE
within laserOS, and then use the “add to playlist” button.

This is the method we will show in this document, so for now you can
simply save the empty playlist with the name of your choice as shown
below:

<img src="Pictures/10000001000004620000028B1AACD4BA.png" style="width:495px;height:auto" />

When you click the “save playlist” button you will need to give the
playlist a name. Keep this name as short as possible, as the MK2 can
only display a limited number of characters on the LCD when selecting a
playlist from the drop down menu on the MK2 LCD.

<img src="Pictures/100000010000046000000286103F085E.png" style="width:546px;height:auto" />

In this example guide we name the new playlist “Content 1”.

Now you have a custom playlist added, it is now possible to add content
to the playlist by selecting items from the various LaserOS categories
and right clicking on the CUE you wish to add to the playlist.

When you right click on a CUE (Animations→Vectors→Axe Chop in our
example), a pop-up menu will appear which will then allow you to select
the newly created playlist from the “Add To Playlist” drop-down, then
click the “Add” button to add the item to the chosen playlist as shown
below:

<img src="Pictures/100000010000045F00000284D3824741.png" style="width:585px;height:auto" />Note: The above image also shows
a manual “Assign Duration” option which can be set to disabled for now,
and its purpose is described further down in this document.

### <span id="anchor-31"></span>Adding a custom SVG to the Playlist

If you have any custom content you wish to display with the MK2 such as
a company logo in SVG file format, you can add this to the playlist by
using the import app within LaserOS.

<img src="Pictures/100000010000045F000002868111205F.png" style="width:643px;height:auto" />

Select the import app, then select the playlist you wish to import
content into, then click the import files button.

Note: If you have an animated SVG then you would click the “import
folder with SVG animation instead”. See the LaserOS video tutorials on
laserOS.com for more info on this feature.

Select the SVG file you wish to add using the file browser window which
appears after clicking the “import File button”

<img src="Pictures/100000010000045D00000280FB86CC44.png" style="width:540px;height:auto" />

In our example we are importing the Wicked Lasers Logo as an SVG file.

The import app will also allow other image file formats (.png, .jpg,
.ild), but for the best results we recommend using SVG or ILD formats.

If you select a non vector image format like .jpg or .png then this type
of image will need to be converted to vector format. A separate popup
window will be displayed to allow user adjustments of sensitivity, line
length and other parameters with a live preview of the result, as shown
below:

<img src="Pictures/1000000100000443000003008894245F.png" style="width:403px;height:auto" />

After importing your custom image you can return to the playlists app
and select the “Content 1” playlist by double clicking which will then
show all the items added to this playlist.

The playlist should contain all the items you have selected and added
via the right click popup menu. The image below shows the newly added
custom SVG called “WL Logo”

<img src="Pictures/100000010000045F00000285D7EB338D.png" style="width:481px;height:auto" />

Some content imported from SVG may need its render quality changing
depending on how complex the image is. Since the Galvo Scanners can only
render a certain number of points per second you may see the projection
start to flicker if the imported SVG is too complex, or the quality
slider is adjusted to maximum quality, as the laser will need to render
more points in order to display the image with sharper corners and more
detail. You can turn on “Show FPS” in Settings→General in order to get
an idea of the frame rate the item will render at. (\>=45 FPS will not
appear to flicker).

You can adjust the render quality by right clicking on an item in the
playlist and turning on the “assign render quality” toggle followed by
adjusting the render quality slider as shown below.

<img src="Pictures/100000010000045F0000028466006F7A.png" style="width:541px;height:auto" />

It is also possible to assign a manual duration override to the playlist
item, or set the number of times an animated item will play before the
playlist player on the MK2 moves to the next item in the playlist.

This can be seen in the previous image below the render quality slider
options.

To perform a manual playlist duration override on an item, enable
“Assign Duration” option and select either “time” or “cycles” from the
drop down.

Note: The “Beats” option is not currently supported on the MK2.

If time is selected then the number of seconds between 1 and 999 can be
entered, and if animation cycles is selected then the number of times an
animation plays can be set between 1 and 999.

The animation cycles option is especially useful when assigned to a
scrolling text item created with the LaserOS text app, as it can be set
to animation cycle of 1 so the scrolling text only displays once before
moving on to the next playlist item. If this was no set then the text
may have only partially scrolled before moving on, depending on the
playlist player CUE delay time.

Note: The “Assign Effect” option in right-click CUE popup is not
currently supported on the MK2.

### <span id="anchor-32"></span>Exporting a Playlist to the micro SD card

Once you have finished adding CUE’s to your new playlist, you can then
export the entire playlist to the micro SD card.

You will need to insert the micro SD card provided with the laser cube
into a USB 3.x reader and then connect the reader to your PC/Mac.

The SD card should appear in File Explorer / Finder as a removable
device with the volume name “WL”. The card should also contain a folder
in the root called “Lasercube”.In LaserOS, select the playlists app,
then select the playlist you wish to export, then finally click the SD
card export button as shown in the image below:

<img src="Pictures/100000010000045F00000285BCC87EC8.png" style="width:571px;height:auto" />

Your OS may ask for permission to access files on a removable volume, if
so then click “Allow”.

If the SD card is detected on your machine then LaserOS will show an
export progress bar depending on how many items need exporting to the SD
card.

<img src="Pictures/10000001000004600000028BFBD43A10.png" style="width:568px;height:auto" />

If the playlist already exists on the SD card (as you may have already
added it once before) you may be prompted as to whether you wish to
overwrite the playlist on the SD card or not, as shown below.

<img src="Pictures/100000010000045B000002832AB914EE.png" style="width:576px;height:auto" />

If you accept to replace the playlist then the previous playlist on the
SD card will be deleted and replaced by the current one.

If when you click the export to SD card you see an “SD card not Found”
message box, then please ensure you have inserted the provided SD card
into your reader and into your PC properly, and also check that the
volume name of the SD card is shown as “WL”. If the SD card volume name
is not “WL” without the quotes then you can right click on the removable
device and rename the card to “WL” using Windows file manager. This
should only be necessary if you have used your own SD card and forgot to
rename the volume. The SD card should also contain a folder called
“Lasercube”. If it does not then you need to download the factory SD
card image again from our GitHub here:
<https://github.com/Wickedlasers/mk2SDContent>

<img src="Pictures/10000001000003A1000001D5DA72B162.png" style="width:508px;height:auto" />The image below shows the
contents of the SD card with the new “Content 1” playlist folder and
files added.

Each playlist exported from LaserOS to the SD card also has a playlist
file which is a human readable JSON file with the extension “.ldpl”, and
each playlist also has an associated folder of the same name containing
the actual CUE files for each item in the playlist. The order in which
CUEs will be played on the device (with shuffle mode disabled) is based
on the order of the entries in the “.ldpl” file.

*Note: Both the folder and playlist “.ldpl” file must be present for the
playlist to be available on the device. e.g. if either “Content 1.ldpl”
or “Content 1” folder are not present then “Content 1” will not be
listed in the playlists drop down on the device.*

### <span id="anchor-33"></span>Manual Customization of the Playlist File

The image below shows a small preview of the contents of another
playlist already provided on the factory supplied SD card for the Ultra
MK2 / Evo. This is an extract of the Beams 1 playlist “.ldpl” JSON file
viewed in a text editor:

<img src="Pictures/100000010000027B00000211DBABF6C6.png" style="width:392px;height:auto" />

This file has been edited after export in order to add custom MIDI
mapping for an APC40 MK2 controller. “apc_note” field within the JSON
array allows the user to choose which button on the APC will activate
this playlist item.

You will need to consult the data sheet for the relevant APC MIDI device
to determine which MIDI note value corresponds to which button on the
APC.

Similarly, “apc_color” field allows the user to choose which colour the
button will be (if RGB is available on the chosen APC button).

The available values for “apc_color” field are:

|     |            |
|-----|------------|
| 1   | Red        |
| 2   | Green      |
| 3   | Blue       |
| 4   | Yellow     |
| 5   | Cyan       |
| 6   | Magenta    |
| 7   | White      |
| 8   | Orange     |
| 9   | Purple     |
| 10  | Salmon     |
| 11  | Pink       |
| 12  | Lime       |
| 13  | Cornflower |
| 14  | Mocha      |
| 15  | Ice Blue   |

If playlist items do not have these fields present in the JSON file when
an APC40 MK2 or APC mini MK2 is used in the playlist control mode then
the playlist items will be automatically allocated to the available APC
grid buttons.

Note: The Ultra / Evo has this playlist and others as part of the demo
SD card provided with the device.

### <span id="anchor-34"></span>Using the new playlist on the Ultra MK2 / Evo.

To project the CUE’s from the example “Content 1” playlist we just
exported from LaserOS, you need to firstly safely eject the SD card from
your PC/Mac. This can be done by right clicking the SD card in file
manager and selecting “Eject”.

Place the SD card back into the device and power on the cube. Select
playlist control mode, then select the “Content 1” playlist which should
now be available in the playlist drop-down within the playlist player
menu.

The photo below shows the custom SVG that was imported to LaserOS, then
exported to the MK2 as “Content 1” playlist.

<img src="Pictures/10000000000002EA0000041E2108CC67.jpg" style="width:360px;height:auto" />

### <span id="anchor-35"></span>Playlist Player UI

The playlist that the device will use is selected from the Playlist
selection menu drop down.

<div class="row g-3 align-items-start">
  <div class="col">
    {{< img src="Pictures/10000000000000F000000140D1F3FD65.bmp" formats="webp jpeg" >}}
  </div>
  <div class="col">
    {{< img src="Pictures/10000000000000F000000140F26F2383.bmp" formats="webp jpeg" >}}
  </div>
  <div class="col">
    {{< img src="Pictures/10000000000000F0000001402C799E3B.bmp" formats="webp jpeg" >}}
  </div>
</div>

The chosen playlist selection will be saved and used again even through
a power cycle of the device.

Note: The last chosen playlist will project immediately after a power
cycle if the device is in playlist control mode and “Power-On play” is
enabled in the playlist options menu, but projection will only occur
once the interlock is enabled. This is to allow for fixed installations
to quickly start up and project the users chosen content with minimal
setup time. If you do not want the playlist to automatically start
projecting at power-on, set “Power-On Play” to Disabled in the playlist
options menu.

The main media controls for the playlist player are shown below.

{{< img src="Pictures/10000000000000F0000001404DB9C2B2.bmp" formats="webp jpeg" >}}

Auto-Play (when enabled) will automatically cycle through another CUE in
the currently selected playlist every \<cue delay\> seconds. Auto play
is enabled when the pause button is visible, and pressing the pause
button will move to auto-play disabled, and UI will show the play
button.

Press the play button to re-enable the CUE Auo-Play. While Auto-Play is
off, the playlist will remain at the last selected CUE.

Note: If an APC MIDI device is connected and a CUE is manually selected
using an APC button, or a CUE is manually selected via the playlist web
app, then the device will no longer cycle through items in the playlist
until the Auto-play button is selected again.

The playlist can also be shuffled in order to randomize the order of
CUE’s in the playlist.

{{< img src="Pictures/10000000000000F0000001404A57E48E.bmp" formats="webp jpeg" >}}

### <span id="anchor-36"></span>CUE playback Speed

The user can adjust the playback speed of any CUE being projected while
in the playlist control mode.

This can be done using the Settings→Playback Speed menu

<div class="row g-3 align-items-start">
  <div class="col">
    {{< img src="Pictures/10000000000000F000000140ED7194DC.bmp" formats="webp jpeg" >}}
  </div>
  <div class="col">
    {{< img src="Pictures/10000000000000F000000140E74E4BE8.bmp" formats="webp jpeg" >}}
  </div>
</div>

The playback speed slider can also be assigned to a MIDI knob or fader
if using an APC40 MK2 or APC mini MK2 (see <a href="#anchor-133">MIDI Mapping</a>
or the online wiki).

## <span id="anchor-37"></span>Playlist Player Web App

The playlist control mode includes a web server which can be used to
control the laser cube from your mobile or Laptop/PC device via a web
browser (tested with Safari / Mozilla Firefox).

You firstly need to connect to the laser cube using the chosen
connection method. If WiFi server is your chosen connection method (see
settings→connection menu), then look for the network “LaserCube” in the
WiFi list and connect using the default password “Laser2020”.

Once your device’s WiFi has connected to the laser cube, go to your
device web browser (Firefox, Safari etc) and enter the IP address of the
cube. This is “192.168.4.1” by default, and can be checked in
settings→network, or just look at the LCD status bar for the IP address,
as it is located in the bottom right corner.

Example image of the playlist web app being served from the cube to
Firefox macOS browser:

<img src="Pictures/1000000100000496000006DA42D932D5.png" style="width:364px;height:auto" />

### <span id="anchor-38"></span>Quick Image Settings

The Quick image settings allow you to adjust basic projection items such
as projection size, rotation, and output power.

An example of the quick image settings menu is shown below:

<img src="Pictures/100000010000048C0000066E8A66DA17.png" style="width:269px;height:auto" />

Note: Any of the image settings can be reset to their default values by
pressing the button to the right of any slider.

- Rotation

  This allows the image to be rotated from 0 to +/- 90 degrees

- Zoom

  This allows the image size to be adjusted from 10% to 100%

- Power

  This allows the projection power to be adjusted from 0% to 100%

### <span id="anchor-39"></span>Quick Player Settings

The Quick player settings allow changes to how the player behaves,
including its colour theme.

This menu also shows the interlock status, current battery percentage,
and cube internal temperature at the bottom of the menu.

<img src="Pictures/10000001000004920000068AE04DAA35.png" style="width:271px;height:auto" />

- Theme Selection

> The theme selection allows the colour theme of the web app to be
> changed. Options are Dark Blue, Icy Green, Dark Red, Pink, Purple, or
> Orange. The theme choice is stored using local web storage on your
> device’s web browser.

- Animated Previews

  This will show the playlist items as animated icons instead of static.
  Note that this is only possible on certain devices that have
  sufficient performance to allow many animated icons. (Apple devices
  have known issues with poor performance of animated image files such
  as animated .webp files, so it is recommended to have this set to
  off).

- Shuffle Playlist

  This allows the playlist items to be played in a random order, instead
  of in playlist sequence order.

- CUE Delay

  This changes how many seconds each CUE will be projected for, before
  moving on to the next CUE in the playlist (Only when Auto-Play is
  enabled).

- Play Speed

  This adjusts the animation speed of any animated projections (100 = 1x
  play speed)

### <span id="anchor-40"></span>Quick Effect Settings

This menu allows you to quickly select an image effect and/or a colour
effect. Most of these effects are also audio reactive. A long-press on
items with a blue mark in the bottom right will bring up any adjustments
that can be made to the selected effect. Note the effect must be
selected before accessing the effects adjustments.

<img src="Pictures/10000001000004940000067CC273E75E.png" style="width:246px;height:auto" /> <img src="Pictures/10000001000004900000067AF758D28F.png" style="width:231px;height:auto" />

You can see a description of all the available effects in the <a href="#anchor-109">Effects Section</a>

Note: You can only have one image effect and one colour effect active at
once. Choose “No Effect” to turn off any active image/colour effect.

### <span id="anchor-41"></span>Playlist Options Menu

<div class="row g-3 align-items-start">
  <div class="col">
    {{< img src="Pictures/10000000000000F0000001403A1B507E.bmp" formats="webp jpeg" >}}
  </div>
  <div class="col">
    {{< img src="Pictures/10000000000000F000000140EAAA4BDF.bmp" formats="webp jpeg" >}}
  </div>
  <div class="col">
    {{< img src="Pictures/10000000000000F0000001402BDE43AB.bmp" formats="webp jpeg" >}}
  </div>
</div>

<div class="row g-3 align-items-start">
  <div class="col">
    {{< img src="Pictures/10000000000000F000000140ECDB213E.bmp" formats="webp jpeg" >}}
  </div>
</div>

The playlist options menu is present on the top level menu (below the
playlist player menu item) of the LCD UI when in playlist control mode

This menu allows you to adjust the fade in/out time between playlist
items (default 250ms), the source of the web app html to be selected,
and also allows the user to select whether the playlist starts
projecting at power-on (immediately after interlock is enabled), or only
after activating the projection button in the playlist player or web
app. The default for power-on play is enabled, and any changes to this
are retained thru power cycle.

The Fade time is used to control how fast the current item is faded out,
and the new item is faded in. The fade is done through adjusting the
brightness of the image/animation. Set this to 0ms for no fade in/out.
Fade is retained thru power cycle.

The Options for Web html are internal factory app (default selection),
or SD card. The SD card option is useful if the user wishes to customise
the provided web app, assuming the user has the relevant HTML/CSS/JS
knowledge.

Note: The web app is provided on the latest SD card image in the
following location: /Lasercube/res/web/playlist_index.html

The file is a single html file containing all html / css / javascript to
run the web app.

*The latest SD card contents are available on our GitHub Here:* [MK2 SD
Card Contents](https://github.com/Wickedlasers/mk2SDContent)
(https://github.com/Wickedlasers/mk2SDContent)

## <span id="anchor-42"></span><span id="anchor-43"></span>Laser Show Control Mode

<div class="row g-3 align-items-start">
  <div class="col">
    {{< img src="Pictures/10000000000000F000000140203B6FB9.png" formats="webp jpeg" >}}
  </div>
  <div class="col">
    {{< img src="Pictures/10000000000000F00000014016D5EF32.png" formats="webp jpeg" >}}
  </div>
  <div class="col">
    {{< img src="Pictures/10000000000000F000000140B1450E8F.png" formats="webp jpeg" >}}
  </div>
</div>

<div class="row g-3 align-items-start">
  <div class="col">
    {{< img src="Pictures/10000000000000F000000140209CE050.bmp" formats="webp jpeg" >}}
  </div>
  <div class="col">
    {{< img src="Pictures/10000000000000F000000140C9F97C93.bmp" formats="webp jpeg" >}}
  </div>
  <div class="col">
    {{< img src="Pictures/10000000000000F000000140E837EBBD.bmp" formats="webp jpeg" >}}
  </div>
</div>

> The latest version of the laser show player now has a categories
> selection drop-down menu, allowing the user to choose the type of
> laser show to play.

> There are currently 38 shows to choose from throughout the 7 provided
> categories (EDM, Christmas, Thanksgiving, New Year, Birthday, Wedding,
> Halloween).

> 

> After choosing a category, selecting the Play icon will begin the
> show, and the player will advance to the next show in the selected
> category after the current show has finished playing. Manually
> choosing a different show from the playlist drop-down will also start
> the show, and also selecting via a connected MIDI controller.

> 

> Show audio will be played from the 3.5mm stereo audio output socket.

If Cube Link is enabled – see the Cube Link entry here: <a href="#anchor-101">Cube Link</a>

Selecting Play on a Cube Link Master will begin playback on the Master,
plus any

Cube Link Slave devices configured with the same Link Channel and PIN.

> For laser shows designed for more than one projector, ensure the Group
> number is set on each Cube Link device. Cube Link connected Slave
> devices have the status area background changed to purple. Also ensure
> all cube link devices have the same show category selected before
> starting play (e.g. all devices have “EDM Shows” selected).

> 

*Note: The Laser shows are provided on the SD card supplied with the
device. If no items are shown in the drop down then this could be due to
the SD card not being inserted, or not having the factory contents
present on the card. The latest SD card contents are available on our
GitHub Here:* [MK2 SD Card
Contents](https://github.com/Wickedlasers/mk2SDContent)
(https://github.com/Wickedlasers/mk2SDContent)

### <span id="anchor-44"></span>Multi-projector Laser Shows

Using Cube-Link, the playback of multi-projector laser shows can be
synchronized.

*Note: Ensure WIFI Antenna’s are connected on all units before using
Cube-Link.*

#### <span id="anchor-45"></span>Example: Alive (2CH) Laser Show

Choose one laser cube to be the Master. This will be the one which
commands

> playback to start on all the slaves. Set the Link Channel and PIN to
> be the same on all Cube Link connected devices. Select Group
> corresponding to the parts of the Laser Show, so for Alive (2CH) all
> Group 1 devices will project one part, all Group 2 devices the other.

> Master

> <img src="Pictures/10000000000000F000000140622AC15E.png"
> style="width:3.307cm;height:4.41cm" />
> <img src="Pictures/10000000000000F00000014063C21C6C.png"
> style="width:3.307cm;height:4.41cm" />
> <img src="Pictures/10000000000000F000000140AC40A616.png"
> style="width:3.281cm;height:4.374cm" />
> <img src="Pictures/10000000000000F000000140DCDA1340.png"
> style="width:3.281cm;height:4.374cm" />

> 

> Slave

> <img src="Pictures/10000000000000F000000140622AC15E.png"
> style="width:3.307cm;height:4.41cm" />
> <img src="Pictures/10000000000000F00000014008442071.png"
> style="width:3.281cm;height:4.374cm" />
> <img src="Pictures/10000000000000F00000014017394292.png"
> style="width:3.268cm;height:4.357cm" />
> <img src="Pictures/10000000000000F000000140AAE686DC.png"
> style="width:3.268cm;height:4.357cm" />

> 

> For a 2 channel show using 4 projectors, set 2 projectors to Group 1
> and 2 projectors to Group 2. Only have one configured as a master
> though.

> 

> Selecting Alive (2CH) on the master will now start projection on all
> devices, providing the same playlist (EDM Shows in this example) is
> already selected on all devices.

> 

> <img src="Pictures/10000000000000F000000140148EAA59.png"
> style="width:3.24cm;height:4.322cm" />
> <img src="Pictures/10000000000000F000000140B9E9F4BA.png"
> style="width:3.293cm;height:4.392cm" />
> <img src="Pictures/10000000000000F000000140E48D960F.png"
> style="width:3.293cm;height:4.392cm" />

> 

## <span id="anchor-46"></span>Visualizer Control Mode

There are currently 91 audio reactive visuals in the current (v2.0)
release of the Ultra MK2 / Evo firmware. More visualizers will be added
in future firmware updates.

The factory supplied SD card also includes example MIDI mapping of some
of these visualizers to the APC40 MK2 / APC mini MK2 grid buttons.

{{< img src="Pictures/10000000000000F000000140154C09F7.bmp" formats="webp jpeg" >}}

CubeOS has 91 built-in audio reactive visualizers, and these can be
manually selected via the drop-down list once an active playlist has
been selected (or “All” playlist selected)

{{< img src="Pictures/10000000000000F000000140DDC28B22.bmp" formats="webp jpeg" >}}

These react to the Audio Input source configured in Settings -\> Audio
-\> Audio Input, and the input can be either set to the built in
microphone, or the 3.5mm stereo audio line input jack. The audio gain
may also need to be adjusted based on the volume of the external audio.

Some of the visualizers are also affected by the current tempo setting
which can be set in Settings→Tempo menu on the LCD. The transition time
when moving between visualizer CUE’s can also be adjusted through the
Viz Options menu. Auto play at power-on can also be adjusted.

<div class="row g-3 align-items-start">
  <div class="col">
    {{< img src="Pictures/10000000000000F000000140C817037D.bmp" formats="webp jpeg" >}}
  </div>
  <div class="col">
    {{< img src="Pictures/10000000000000F000000140F448796E.bmp" formats="webp jpeg" >}}
  </div>
</div>

Below is the current list of visualizers present in the v2.0 Ultra MK2 /
Evo firmware in visualizer ctrl mode:

Spectrum, Waveform & Audio Meters (16)

|  |  |  |
|----|----|----|
| <img src="Pictures/100000000000007800000078FC9B38E8.png" style="width:40px;height:auto;max-width:none" /> | Spectrum 1 | FFT spectrum analyser - a row of vertical frequency bars rising from the baseline, coloured across the spectrum. |
| <img src="Pictures/100000000000007800000078BEE9FFB2.png" style="width:40px;height:auto;max-width:none" /> | Spectrum 2 | Spectrum-analyser variant drawn in a second bar style. |
| <img src="Pictures/100000000000007800000078F22564EB.png" style="width:40px;height:auto;max-width:none" /> | Spectrum 3 | Spectrum analyser mirrored about the centre line, bars growing up and down from the middle. |
| <img src="Pictures/1000000000000078000000784F5418FB.png" style="width:40px;height:auto;max-width:none" /> | Spectrum W1 | Terrain-style spectrum wave (port of ldTerra) - the FFT drawn as a rolling illuminated waveform landscape. |
| <img src="Pictures/100000000000007800000078EE4516DE.png" style="width:40px;height:auto;max-width:none" /> | Spectrum W2 | A second spectrum-wave style with a different rolling FFT waveform. |
| <img src="Pictures/1000000000000078000000780E614A5D.png" style="width:40px;height:auto;max-width:none" /> | Voice | Voice / FFT-reactive visualizer that shapes the beam to the vocal content of the audio. |
| <img src="Pictures/100000000000007800000078DE6B4469.png" style="width:40px;height:auto;max-width:none" /> | Vocoder | Vocoder-style channels - the spectrum split into bands that pump with the music. |
| <img src="Pictures/100000000000007800000078B0C7A570.png" style="width:40px;height:auto;max-width:none" /> | Waveform | A live oscilloscope trace of the raw audio waveform drawn straight across the frame. |
| <img src="Pictures/1000000000000078000000782BAB296C.png" style="width:40px;height:auto;max-width:none" /> | FFT Beams | One radial beam per FFT bin fanning out from centre; length follows magnitude, hue runs bass=red to treble=violet. |
| <img src="Pictures/100000000000007800000078393D98B0.png" style="width:40px;height:auto;max-width:none" /> | Audio Horizon | A mountain-skyline silhouette from 16 FFT bins, mirrored on a centre line; it scrolls and its peaks ride the audio. |
| <img src="Pictures/100000000000007800000078485D09C3.png" style="width:40px;height:auto;max-width:none" /> | Audio River | A horizontal waveform from three bass/mid/treble sines with a dim reflection below, scrolling like a river of light. |
| <img src="Pictures/100000000000007800000078CEB9FD54.png" style="width:40px;height:auto;max-width:none" /> | Audio Curtain | A column of hanging vertical strands that sway to their own FFT bin, with a travelling wave rippling through them. |
| <img src="Pictures/100000000000007800000078CAF7418B.png" style="width:40px;height:auto;max-width:none" /> | Audio Marquee | Vertical FFT bars scroll in from the right and wrap around the edges like a marquee; height, speed and hue track audio. |
| <img src="Pictures/100000000000007800000078191C96CF.png" style="width:40px;height:auto;max-width:none" /> | Chord Choir | Seven staggered horizontal bars, each spanning with its own spectral band and drifting side to side; hues reshuffle on the beat. |
| <img src="Pictures/1000000000000078000000785EC89C97.png" style="width:40px;height:auto;max-width:none" /> | Mesh Wave | A woven cross-hatch of six warp and six weft lines; the raw waveform pushes each vertex radially so the sound ripples through the cloth. |
| <img src="Pictures/10000000000000780000007876296A15.png" style="width:40px;height:auto;max-width:none" /> | Pulse Matrix | A digital square-wave grid of rows toggling high/low with per-row FFT coupling; rows scroll together then split by phase on the beat. |

Particles, Swarms & Trails (22)

|  |  |  |
|----|----|----|
| <img src="Pictures/1000000000000078000000786C47F67C.png" style="width:40px;height:auto;max-width:none" /> | Flying Stars | Stars flying through the frame to the beat (port of ldFlyingStars). |
| <img src="Pictures/100000000000007800000078D32AFDD0.png" style="width:40px;height:auto;max-width:none" /> | Snake | A beam snake that slithers around the frame (port of ldBeamSnake). |
| <img src="Pictures/1000000000000078000000782A7B5C81.png" style="width:40px;height:auto;max-width:none" /> | Warp Stars | Classic hyperspace warp - white stars streak outward from a vanishing point; bass drives the warp speed. |
| <img src="Pictures/10000000000000780000007831FF5969.png" style="width:40px;height:auto;max-width:none" /> | Fireflies | A grid of bouncing dot particles, each trapped in its own cell, whose speed and movement style shift with the FFT every few bars. |
| <img src="Pictures/100000000000007800000078E1F56B2C.png" style="width:40px;height:auto;max-width:none" /> | Constellation | Ten stars faintly linked in a cycle, each on its own audio-driven path bouncing off the bounds so the shape keeps morphing. |
| <img src="Pictures/1000000000000078000000787A63BE9A.png" style="width:40px;height:auto;max-width:none" /> | Radial Bursts | Expanding ring bursts spawn at random angles on audio peaks, over a slow inner heartbeat ring. |
| <img src="Pictures/1000000000000078000000788338AECC.png" style="width:40px;height:auto;max-width:none" /> | Meteor Swirl | Falling meteors on curved, wind-sheared trajectories, continuously spawned with audio-driven density and bend. |
| <img src="Pictures/1000000000000078000000783FEA02C4.png" style="width:40px;height:auto;max-width:none" /> | Fireworks | Radial firework bursts fired on each audio peak (BPM-synced at silence); particles drift out under gravity and fade. |
| <img src="Pictures/1000000000000078000000780222032D.png" style="width:40px;height:auto;max-width:none" /> | Audio Fountain | Particles erupt from the bottom-centre, arc up and fall under gravity with bright trails - a fountain of light driven by sound. |
| <img src="Pictures/100000000000007800000078703D0239.png" style="width:40px;height:auto;max-width:none" /> | Polar Snake | A ring-buffer trail wandering toward random targets that re-roll on each bass peak; hue rotates along the trail. |
| <img src="Pictures/100000000000007800000078FCA8C3AE.png" style="width:40px;height:auto;max-width:none" /> | Warp Streaks | Particle streaks fly outward from centre along log-spiral arms; the scene rotates and flips direction on each bass peak. |
| <img src="Pictures/100000000000007800000078A7C3075D.png" style="width:40px;height:auto;max-width:none" /> | Radial Dots | Eight-fold radial symmetry of dwell-dots on curved outward paths; bins drive activity, bass speed, treble hue. |
| <img src="Pictures/100000000000007800000078A3B9BC6F.png" style="width:40px;height:auto;max-width:none" /> | Emberlight | An ember column rising from the bottom, each particle trailing a warm gradient tail along a swaying sinusoidal path. |
| <img src="Pictures/1000000000000078000000785A05FB41.png" style="width:40px;height:auto;max-width:none" /> | Facet Storm | Eight faceted hexagonal jewels orbit the centre, each spinning and flipping direction on bass peaks - a polyrhythmic storm. |
| <img src="Pictures/100000000000007800000078B158734F.png" style="width:40px;height:auto;max-width:none" /> | Flare Garden | Five flares rooted on a ground line, each a swept stem capped by a bloom; stems grow on bass, sway on mid, blooms pulse per bin. |
| <img src="Pictures/100000000000007800000078C209629C.png" style="width:40px;height:auto;max-width:none" /> | Radial Cascade | Twelve spokes each carrying a stack of tick marks travelling outward and wrapping back, each pulsing at its FFT bin's rate. |
| <img src="Pictures/10000000000000780000007891D125A2.png" style="width:40px;height:auto;max-width:none" /> | Lanterns | A swarm of hexagonal lantern silhouettes wandering on Lissajous orbits, each growing on hits of its own FFT bin. |
| <img src="Pictures/100000000000007800000078AA1C3615.png" style="width:40px;height:auto;max-width:none" /> | Spark Rings | Orbiting emitters on concentric circular tracks, each driven by its own band, spraying tight rings of spark dots. |
| <img src="Pictures/1000000000000078000000781C54D7D0.png" style="width:40px;height:auto;max-width:none" /> | Fleas | Fleas settle inside a circular bowl; a beat hit makes them jump up and swirl again. |
| <img src="Pictures/100000000000007800000078F00035FD.png" style="width:40px;height:auto;max-width:none" /> | Flow Field | Particles advected by a sin/cos vector field, leaving hue-aged curved trails. |
| <img src="Pictures/100000000000007800000078AB64A3A5.png" style="width:40px;height:auto;max-width:none" /> | Gale Ribbons | Wind-streak particles flowing along a turbulent vector field; raw audio gusts them into long braided ribbon tails. |
| <img src="Pictures/1000000000000078000000784DD7B120.png" style="width:40px;height:auto;max-width:none" /> | Starfield Drift | A parallax star swarm streaming outward toward the viewer, bass warping the drift forward and easing back in quiet. |

Geometric & Parametric Patterns (35)

|  |  |  |
|----|----|----|
| <img src="Pictures/100000000000007800000078C4F438F3.png" style="width:40px;height:auto;max-width:none" /> | Swirly Spheres | Nested swirling spheres of light (port of ldSwirlySphere). |
| <img src="Pictures/100000000000007800000078933D4FDC.png" style="width:40px;height:auto;max-width:none" /> | Synesthesia | A flowing synesthetic colour-and-form field reacting to the music (port of ldSynesthesia3). |
| <img src="Pictures/100000000000007800000078CA5A260B.png" style="width:40px;height:auto;max-width:none" /> | Cubes | A spinning 3D cube (port of ld3dCube). |
| <img src="Pictures/10000000000000780000007853077D07.png" style="width:40px;height:auto;max-width:none" /> | Sunshine | A radiant sun with pulsing rays reacting to the music (port of ldSunshine). |
| <img src="Pictures/100000000000007800000078DEF62887.png" style="width:40px;height:auto;max-width:none" /> | Wave Circles | Concentric circles rippling with the audio (port of ldWaveCircles). |
| <img src="Pictures/10000000000000780000007870AF6D2A.png" style="width:40px;height:auto;max-width:none" /> | Lotus | An unfolding lotus-flower geometry animated to the music (port of ldLotus). |
| <img src="Pictures/100000000000007800000078BD67ED8D.png" style="width:40px;height:auto;max-width:none" /> | Circle Arc | A rotating 3D circle-arc figure (port of ld3dCircleArc). |
| <img src="Pictures/1000000000000078000000781DCE41EF.png" style="width:40px;height:auto;max-width:none" /> | Atomic | Orbiting electron rings around a nucleus, spinning to the beat (port of ldAtomic). |
| <img src="Pictures/10000000000000780000007860BF21FB.png" style="width:40px;height:auto;max-width:none" /> | Plasma Ball | A plasma-ball orb with arcing tendrils reacting to sound (port of ldPlasmaBall). |
| <img src="Pictures/1000000000000078000000789DBC220A.png" style="width:40px;height:auto;max-width:none" /> | Butterfly | A butterfly-curve figure fluttering to the audio. |
| <img src="Pictures/10000000000000780000007812CBAD33.png" style="width:40px;height:auto;max-width:none" /> | Halo | A glowing halo ring that breathes with the audio. |
| <img src="Pictures/100000000000007800000078AD618926.png" style="width:40px;height:auto;max-width:none" /> | Turbine | Spinning turbine blades radiating from centre, rotating to the beat. |
| <img src="Pictures/100000000000007800000078CAD0B8BB.png" style="width:40px;height:auto;max-width:none" /> | Lissajous | Animated Lissajous figures morphing through figure-eight, pretzel and knot shapes; bass accelerates the phase across five ratios. |
| <img src="Pictures/100000000000007800000078C34BE262.png" style="width:40px;height:auto;max-width:none" /> | Orbit Collider | Eight bright points orbiting an invisible circle with lossless elastic collisions; bass bins drive the circle radius. |
| <img src="Pictures/1000000000000078000000781B744169.png" style="width:40px;height:auto;max-width:none" /> | Tunnel | Concentric hexagonal rings flying toward the viewer for a warp-tunnel effect; each ring's colour follows its FFT band, bass sets speed. |
| <img src="Pictures/10000000000000780000007878ADF237.png" style="width:40px;height:auto;max-width:none" /> | Arc Carousel | Three concentric rings of arc segments spinning in alternating directions; bass expands radii, treble cycles hue. |
| <img src="Pictures/1000000000000078000000785D15ACFB.png" style="width:40px;height:auto;max-width:none" /> | Orbital Chain | Eight dots on a closed chain morphing circle -\> ellipse -\> figure-8 with audio, traced by a thin connecting line. |
| <img src="Pictures/10000000000000780000007834D0F7F8.png" style="width:40px;height:auto;max-width:none" /> | Phasor Grid | A 3x3 grid of little rotating radial phasors, phase-offset by cell so they read as a propagating wave when energetic. |
| <img src="Pictures/10000000000000780000007872AA5B4C.png" style="width:40px;height:auto;max-width:none" /> | Radial Wedges | Pie-slice wedges fanning from centre, their widths and tip radii breathing unevenly with the audio bands. |
| <img src="Pictures/10000000000000780000007857919CBF.png" style="width:40px;height:auto;max-width:none" /> | Ripple Grid | A coarse grid of horizontal curves poked by a moving radial ripple from an orbiting source; amplitude pulses with bass. |
| <img src="Pictures/10000000000000780000007894F31D81.png" style="width:40px;height:auto;max-width:none" /> | Pulse Chevron | A vertical stack of chevrons sliding upward and wrapping; width and tilt breathe with the FFT bands. |
| <img src="Pictures/100000000000007800000078B940921C.png" style="width:40px;height:auto;max-width:none" /> | Kaleido Dots | A 3-fold kaleidoscope of always-on drifting dots; bass swells radii, mid widens the sway, treble cycles hue. |
| <img src="Pictures/100000000000007800000078B0C855AD.png" style="width:40px;height:auto;max-width:none" /> | Kaleido Lines | A 10-fold kaleidoscope traced as one continuous mirrored polyline through five reflection axes. |
| <img src="Pictures/1000000000000078000000788A1E3A09.png" style="width:40px;height:auto;max-width:none" /> | Bell Pulse | Four bell-shaped silhouettes on the cardinal axes, their width breathing with bass and hue pushed by treble. |
| <img src="Pictures/100000000000007800000078EBADEEA8.png" style="width:40px;height:auto;max-width:none" /> | Phase Swirl | A 3:2 Lissajous with a continuously drifting, bass-driven phase, walking the figure through every shape in the family. |
| <img src="Pictures/1000000000000078000000785D1F4E27.png" style="width:40px;height:auto;max-width:none" /> | Red Hot | Eight rectangular arms forming an asterisk; each FFT band shortens an opposing arm pair, staying symmetric across centre. |
| <img src="Pictures/1000000000000078000000781773D9A1.png" style="width:40px;height:auto;max-width:none" /> | Damped Swirl | A harmonograph - one long damped Lissajous curve whose parameters drift so the figure morphs without ever resetting. |
| <img src="Pictures/100000000000007800000078AD307410.png" style="width:40px;height:auto;max-width:none" /> | Fractal | Recursive 5-branch fractal subdivision on triangle / square / line bases that morph on audio peaks, with a depth-based hue gradient (port of ldFractal4). |
| <img src="Pictures/10000000000000780000007872EDF9A3.png" style="width:40px;height:auto;max-width:none" /> | Sine Grid | Phase-offset strands weaving through each other with a corkscrew twist; bass drives scroll and rotation, peaks flip direction. |
| <img src="Pictures/100000000000007800000078C0FAB105.png" style="width:40px;height:auto;max-width:none" /> | Sonar Ping | Concentric expanding wavefronts drawn as isolated radial tick-marks pinging outward, like a sonar sweep. |
| <img src="Pictures/1000000000000078000000787E3CC1EC.png" style="width:40px;height:auto;max-width:none" /> | Quasar Braid | Six strands twisted into one left-to-right braid; each strand's FFT bin drives its sway, bass tightens the corkscrew twist. |
| <img src="Pictures/10000000000000780000007812A3877F.png" style="width:40px;height:auto;max-width:none" /> | Spiral Fill | A space-filling Archimedean spiral with four colour modes (helix, bands, tri-helix, vertical bands) cycling every bar. |
| <img src="Pictures/1000000000000078000000780835EBC6.png" style="width:40px;height:auto;max-width:none" /> | Hypocycloid R | A single hypocycloid rosette whose inner-radius ratio sweeps each bar to morph cusp counts; treble runs hue, bass sharpens cusps. |
| <img src="Pictures/100000000000007800000078AC3A0208.png" style="width:40px;height:auto;max-width:none" /> | Pie Beam | Two rotating pie cones of stratified rays sweeping the frame; bass opens the cone angle, modes cycle each bar. |
| <img src="Pictures/1000000000000078000000781CC2637D.png" style="width:40px;height:auto;max-width:none" /> | Cissoid Flick | A mirrored pair of parametric cissoid cusps rotating with tempo; bass peaks flick the cusps to a new shape then settle. |

Beams, Lines & Mirrors (14)

|  |  |  |
|----|----|----|
| <img src="Pictures/100000000000007800000078592D7B87.png" style="width:40px;height:auto;max-width:none" /> | Crossed Lines | Beams drawn as crossing lines sweeping the frame (port of ldBeamCrossedLines). |
| <img src="Pictures/100000000000007800000078CC9ECA4B.png" style="width:40px;height:auto;max-width:none" /> | Solaris 1 | A sun-flare beam burst radiating from centre (style 1). |
| <img src="Pictures/100000000000007800000078A89957E9.png" style="width:40px;height:auto;max-width:none" /> | Solaris 2 | A sun-flare beam burst radiating from centre (style 2). |
| <img src="Pictures/1000000000000078000000781DC56891.png" style="width:40px;height:auto;max-width:none" /> | Rage Bass 1 | A high-energy beam pattern that slams with the bass. |
| <img src="Pictures/100000000000007800000078F3F6A2B6.png" style="width:40px;height:auto;max-width:none" /> | Dashed Lines | Dashed beam lines animated to the music. |
| <img src="Pictures/1000000000000078000000783E936358.png" style="width:40px;height:auto;max-width:none" /> | Spotlights C | Circular spotlights sweeping across the frame to the beat. |
| <img src="Pictures/1000000000000078000000782E00C929.png" style="width:40px;height:auto;max-width:none" /> | Spotlights T | Triangular spotlights sweeping across the frame to the beat. |
| <img src="Pictures/100000000000007800000078D9E97D78.png" style="width:40px;height:auto;max-width:none" /> | Linear C | A circle base shape animated with linear beam sweeps. |
| <img src="Pictures/1000000000000078000000781543D2B6.png" style="width:40px;height:auto;max-width:none" /> | Linear L | A line base shape animated with linear beam sweeps. |
| <img src="Pictures/10000000000000780000007862085EEF.png" style="width:40px;height:auto;max-width:none" /> | Linear S | A square base shape animated with linear beam sweeps. |
| <img src="Pictures/100000000000007800000078A949923C.png" style="width:40px;height:auto;max-width:none" /> | Mirror Curves | Symmetric mirrored curves reflected across the frame's axes. |
| <img src="Pictures/100000000000007800000078FEC8D201.png" style="width:40px;height:auto;max-width:none" /> | Mirror Lines 1 | A mirror-symmetric straight-line beam pattern (style 1). |
| <img src="Pictures/1000000000000078000000784B6BE94F.png" style="width:40px;height:auto;max-width:none" /> | Mirror Lines 2 | A mirror-symmetric straight-line beam pattern (style 2). |
| <img src="Pictures/100000000000007800000078F62A914C.png" style="width:40px;height:auto;max-width:none" /> | Mirror Rays | Rays radiating with mirror symmetry across the frame. |

Characters & Novelty (4)

|  |  |  |
|----|----|----|
| <img src="Pictures/100000000000007800000078407E8B5D.png" style="width:40px;height:auto;max-width:none" /> | Disco Stu | A dancing stick figure that performs shuffled dance moves to the music, ending each on a bass kick with crossfaded poses. |
| <img src="Pictures/100000000000007800000078731B4095.png" style="width:40px;height:auto;max-width:none" /> | Sunflower | A potted sunflower that dances to the music, using the same move-sequencing engine as Disco Stu. |
| <img src="Pictures/10000000000000780000007892174A4D.png" style="width:40px;height:auto;max-width:none" /> | Cactus | A potted saguaro cactus that dances to the music, sharing the dancing-figure engine. |
| <img src="Pictures/1000000000000078000000788DC3449F.png" style="width:40px;height:auto;max-width:none" /> | Lazer Lips | Two animated lip curves whose openness, spread and sibilance follow the audio - a lip-sync mouth. |

The Visualizers can also have additional audio reactive image/colour
effects added to them, configured from the Effects menu.

See the effects page here: <a href="#anchor-108">Effects</a>
or the online wiki for more info on the built in effects, and also the
<a href="#anchor-79">tempo</a> menu which will affect the
speed of some BPM based effects.

<div class="row g-3 align-items-start">
  <div class="col">
    {{< img src="Pictures/10000000000000F0000001404619E973.bmp" formats="webp jpeg" >}}
  </div>
  <div class="col">
    {{< img src="Pictures/10000000000000F0000001408A45449E.bmp" formats="webp jpeg" >}}
  </div>
</div>

Select an effect to configure from the “effect config” drop-down list,
or list the currently active effects using the “Active Effects” button.

<div class="row g-3 align-items-start">
  <div class="col">
    {{< img src="Pictures/10000000000000F000000140B8AA6F7B.bmp" formats="webp jpeg" >}}
  </div>
  <div class="col">
    {{< img src="Pictures/10000000000000F0000001404AA68E4D.png" formats="webp jpeg" >}}
  </div>
</div>

Color Cycle Effect adjustments

<div class="row g-3 align-items-start">
  <div class="col">
    {{< img src="Pictures/10000000000000F0000001405EC5A5CA.png" formats="webp jpeg" >}}
  </div>
  <div class="col">
    {{< img src="Pictures/10000000000000F000000140BF79E124.png" formats="webp jpeg" >}}
  </div>
</div>

Zoom Effect adjustments

<div class="row g-3 align-items-start">
  <div class="col">
    {{< img src="Pictures/10000000000000F000000140DA97991A.png" formats="webp jpeg" >}}
  </div>
  <div class="col">
    {{< img src="Pictures/10000000000000F000000140F2A692E3.png" formats="webp jpeg" >}}
  </div>
</div>

Hue Effect adjustments

<div class="row g-3 align-items-start">
  <div class="col">
    {{< img src="Pictures/10000000000000F0000001408225B272.png" formats="webp jpeg" >}}
  </div>
  <div class="col">
    {{< img src="Pictures/10000000000000F000000140D1F0817E.png" formats="webp jpeg" >}}
  </div>
</div>

Colorize Effect Flash Effect Strobe Effect

<div class="row g-3 align-items-start">
  <div class="col">
    {{< img src="Pictures/10000000000000F0000001401FBB4D16.png" formats="webp jpeg" >}}
  </div>
  <div class="col">
    {{< img src="Pictures/10000000000000F0000001404818DEAE.png" formats="webp jpeg" >}}
  </div>
  <div class="col">
    {{< img src="Pictures/10000000000000F000000140B0C599C8.png" formats="webp jpeg" >}}
  </div>
</div>

Note: There are currently over 70 effects to choose from, each with
their own adjustments, and the above are only an example of some of
these effects.

## <span id="anchor-47"></span>Visualizer Web App

The visualizer control mode also has a built in web server, allowing
control of the visualizer player and audio reactive image/colour
effects, all from your mobile or desktop web browser.

<img src="Pictures/10000001000004940000072AE57E9A29.png" style="width:268px;height:auto" /> <img src="Pictures/10000001000004940000072CF8C07777.png" style="width:268px;height:auto" />

Playlists can be selected from the top right corner (or select “all” for
the entire built in list), and also new playlists can be created by long
pressing on a visualizer, then adding that visualizer to a new playlist,
or adding it to an existing playlist. You can also assign a pad colour
for the playlist item when using a MIDI APC40 MK2 or APC mini MK2. Items
can be removed from a playlist by a long press, then select “remove”
option. The playlist order can also be changed by selecting a
visualizer, then hold and drag the item horizontally, then move the item
to anywhere in the playlist.

Entire playlists can be deleted (except for the built in “All” and
“Classics” playlists) by using the bin icon to the right of the playlist
selection drop down.

Image and colour effects can also be added using the quick effect menu
(3<sup>rd</sup> icon from the bottom left). See the playlist web server
section of this manual on the effects popup, and also check out the
effects section to see all the available effects.

Note: Ensure you have the latest SD card image from our GitHub, or the
preview images for the visualizers and effects will not be displayed,
and will instead be shown as blank grid items.

## <span id="anchor-48"></span>ArtNet Control Mode

### <span id="anchor-49"></span>Setting the control mode to ArtNet

The ArtNet mode can be selected by going into Control Mode and selecting
it

{{< img src="Pictures/10000000000000F0000001401D889BC7.bmp" formats="webp jpeg" >}}

Once selected the device will restart into ArtNet mode, and the ArtNet
settings will now be available from the top level menu as shown below:

{{< img src="Pictures/10000000000000F00000014006D180CC.bmp" formats="webp jpeg" >}}

### <span id="anchor-50"></span>ArtNet settings Menu

#### <span id="anchor-51"></span>ArtNet Universe

This sets which universe the laser cube will respond to on the network.

{{< img src="Pictures/10000000000000F0000001404C7CD495.bmp" formats="webp jpeg" >}}

#### <span id="anchor-52"></span>ArtNet Start Address

The start address can be changed (default is address 1) in order to move
the 16 channel profile start address within the ArtNet/DMX address range
of 1-512.

{{< img src="Pictures/10000000000000F0000001405100285C.bmp" formats="webp jpeg" >}}

#### <span id="anchor-53"></span>Fixture Profile

The Fixture profile can be changed using the fixture profile drop-down.
Currently there is only one profile available which occupies 16 channels
of the ArtNet/DMX address range.

A profile determines which ArtNet/DMX channels control what feature of
the laser cube. The default 16 channel map is available here: <a href="#anchor-65">DMX Channel Map</a> or the
wiki (or PDF supplied on the factory SD card).

{{< img src="Pictures/10000000000000F000000140C058A64E.bmp" formats="webp jpeg" >}}

Note: The default profile is compatible with the FB3/FB4 16 channel
profile, so any DMX/ArtNet capable lighting controller with FB3/4
support should also work with the laser cube.

#### <span id="anchor-54"></span>CUE Selection

This drop-down will allow you to select a playlist from the SD card to
use when a CUE index is selected over ArtNet. You will need to export a
playlist from LaserOS, or use one of the provided playlists on the SD
card shipped with the unit.

The CUE selection is based on the order of items within the chosen
Playlist, so the first CUE selected over ArtNet using the CUE/Page
channel will project the first item in the playlist.

{{< img src="Pictures/10000000000000F000000140FDBA0F7B.bmp" formats="webp jpeg" >}}

#### <span id="anchor-55"></span>Defaults

This button will reset all items within the DMX menu to their factory
defaults.

{{< img src="Pictures/10000000000000F000000140A4C818FC.bmp" formats="webp jpeg" >}}

### <span id="anchor-56"></span>ArtNet Status

The status of the ArtNet connection is shown in the status bar at the
bottom right of the LCD.

When the laser cube is connected to a valid ethernet network and ArtNet
packets are being received on the correct ArtNet Universe then the
status bar will show a green tick to the right of the DMX label and a
valid IP address will be shown below it.

If ArtNet data is not being correctly received then the status bar will
show a red cross instead of a green tick.

If the status shows as not connected when you have an ethernet cable
attached to your network which also has the ArtNet controller present,
then please check for a network issue first like no IP address being
shown in the status bar, and also check you are on the correct ArtNet
universe.

## <span id="anchor-57"></span>DMX Control Mode

### <span id="anchor-58"></span>Setting the control mode to DMX

The DMX mode can be selected by going into Control Mode and selecting
DMX-512

{{< img src="Pictures/10000000000000F000000140609817E0.bmp" formats="webp jpeg" >}}

Once selected the device will restart into DMX-512 mode, and the DMX
settings will now be available from the top level menu as shown below:

{{< img src="Pictures/10000000000000F000000140E9E37788.bmp" formats="webp jpeg" >}}

### <span id="anchor-59"></span>DMX settings Menu

#### <span id="anchor-60"></span>DMX start Address

{{< img src="Pictures/10000000000000F0000001407F256315.bmp" formats="webp jpeg" >}}

The DMX start address can be changed (default is DMX address 1) in order
to move the 16 channel profile start address within the DMX address
range of 1-512.

#### <span id="anchor-61"></span>Fixture Profile

The Fixture profile can be changed using the fixture profile drop-down.
Currently there is only one profile available which occupies 16 channels
of the DMX address range.

A profile determines which DMX channels control what feature of the
laser cube. The default 16 channel map is available here: <a href="#anchor-65">DMX Channel Map</a> or on
the wiki (or PDF on the factory supplied SD card).

{{< img src="Pictures/10000000000000F0000001408AB0792E.bmp" formats="webp jpeg" >}}

Note: The default profile is compatible with the FB3/FB4 16 channel
profile, so any DMX lighting controller with FB3/4 support should also
work with the laser cube.

#### <span id="anchor-62"></span>CUE Selection

This drop-down will allow you to select a playlist from the SD card to
use when a CUE index is selected using the DMX Page/CUE channel. You
will need to export a playlist from LaserOS, or use one of the provided
playlists on the SD card shipped with the unit.

The CUE selection is based on the order of items within the chosen
Playlist, so the first CUE selected over DMX using the CUE/Page channel
will project the first item in the playlist.

{{< img src="Pictures/10000000000000F0000001400ED515E4.bmp" formats="webp jpeg" >}}

#### <span id="anchor-63"></span>Defaults

This button will reset all items within the DMX menu to their factory
defaults.

{{< img src="Pictures/10000000000000F000000140C60A1F96.bmp" formats="webp jpeg" >}}

### <span id="anchor-64"></span>DMX Status

The status of the DMX is shown in the status bar at the bottom right of
the LCD.

When the laser cube is connected to DMX and receiving the 512 channels
via the DMX In connector, the status bar will show a green tick to the
right of the DMX label as shown below.

{{< img src="Pictures/10000000000000F000000140230AEACB.bmp" formats="webp jpeg" >}}

If DMX is not being received then the status bar will show a red cross.

If the status shows as not connected when you have a cable connected and
are running DMX from a controller, then please check cabling and also
check that the DMX is correctly terminated.

## <span id="anchor-65"></span>DMX/ArtNet Default Fixture Channel Allocation

### <span id="anchor-66"></span>Overview

The default DMX/ArtNet fixture uses from 4 to 16 channels depending on
the Access Mode.

### <span id="anchor-67"></span>DMX Channels NOT Implemented in the default fixture implementation

• DMX CH 12 Reserved for future use.

• DMX CH 14 Reserved for future use.

• DMX CH 16 Reserved for future use.

### <span id="anchor-68"></span>DMX/Art-Net Channel Layout

|             |          |            |               |                |            |
|-------------|----------|------------|---------------|----------------|------------|
| Channel 1   | 0-31     | 33-95      | 97-159        | 161-223        | 225-255    |
| Access Mode | Blackout | Basic 4 CH | Standard 8 CH | Extended 12 CH | Full 16 CH |

Note:

• Invalid values (32,96,160,224) do not change the access mode from its
previous value.

• Access mode Basic (CH 1-4 interpreted, CH 5-16 default values).

• Access mode Standard (CH 1-8 interpreted, CH 9-16 default values).

• Access mode Extended (CH 1-12 interpreted, CH 13-16 default values).

• Access mode Full (all channels interpreted).

<span id="anchor-69"></span>

DMX CH 2 (Page): Used as an offset into the cue playlist.

Example:

• Page 2 plays cues from index 48 onwards.

• Page 3 plays cues from index 96 onwards, etc.

• Allows up to 432 cues per playlist (9 \* 48).

|           |      |       |       |       |       |       |        |         |         |
|-----------|------|-------|-------|-------|-------|-------|--------|---------|---------|
| Channel 2 | 0-15 | 17-31 | 33-47 | 49-63 | 65-79 | 81-95 | 97-111 | 113-127 | 129-255 |
| Page      | 1    | 2     | 3     | 4     | 5     | 6     | 7      | 8       | 9       |

Note:

• Cue selection is based on Page & Cue DMX channels.

• Page 1 = Cues 1-48, Page 2 = Cues 49-96, etc.

• Maximum of 432 cues (48 cues per page \* 9 pages).

|            |          |       |       |     |         |
|------------|----------|-------|-------|-----|---------|
| Channel 3  | 0-31     | 33-35 | 37-39 | ... | 221-223 |
| Cue Select | Blackout | Cue 1 | Cue 2 | ... | Cue 48  |

Note: Used in conjunction with channel 2 (page) in order to select cues
from the currently selected playlist.

|           |      |       |                               |
|-----------|------|-------|-------------------------------|
| Channel 4 | 0-15 | 17-31 | 33 ... 64 ... 128 ... 255     |
| Speed     | 100% | Pause | 25% ... 50% ... 100% ... 200% |

|           |                           |
|-----------|---------------------------|
| Channel 5 | 0-255                     |
| Fader     | Black ... Full Brightness |

Note: If access mode is below Standard, fade is fixed at 100%.

|           |                         |
|-----------|-------------------------|
| Channel 6 | 0-255                   |
| Scale     | Zero Size ... Full Size |

Note: If access mode is below Standard, scale is fixed at 100%.

|           |                                                         |
|-----------|---------------------------------------------------------|
| Channel 7 | 0 ... 128 ... 255                                       |
| X Size    | Negative Full Size ... Zero Size ... Positive Full Size |

Note: Negative full size = Horizontally mirrored from original.

|           |                                                         |
|-----------|---------------------------------------------------------|
| Channel 8 | 0 ... 128 ... 255                                       |
| Y Size    | Negative Full Size ... Zero Size ... Positive Full Size |

Note: Negative full size = Vertically flipped from original.

|           |                           |
|-----------|---------------------------|
| Channel 9 | 0 ... 255                 |
| Rotation  | 0 degrees ... 360 degrees |

Note: If access mode is below Extended, no rotation will occur.

|            |                           |
|------------|---------------------------|
| Channel 10 | 0 ... 128 ... 255         |
| X Position | Left ... Center ... Right |

Note: If access mode is below Extended, X Position is fixed at 128
(center).

|            |                        |
|------------|------------------------|
| Channel 11 | 0 ... 128 ... 255      |
| Y Position | Down ... Center ... Up |

Note: If access mode is below Extended, Y Position is fixed at 128
(center).

|            |                 |
|------------|-----------------|
| Channel 12 | 0 ... 255       |
| Reserved   | NOT IMPLEMENTED |

|            |                   |            |         |
|------------|-------------------|------------|---------|
| Channel 13 | 0-31              | 33-223     | 225-255 |
| Scan Rate  | Default (35K pps) | 6K-29K pps | 30K pps |

Note: If access mode is below Full, scan rate defaults to 35K pps.

|            |                 |
|------------|-----------------|
| Channel 14 | 0 ... 255       |
| Reserved   | NOT IMPLEMENTED |

|  |  |  |  |
|----|----|----|----|
| Channel 15 | 0-31 | 33-223 | 225-255 |
| Recolor | Default | RED - ORANGE - YELLOW - LIME - GREEN - CYAN - BLUE - PURPLE - PINK - RED | White |

Note: If access mode is below Full, no re-colour occurs.

• Values 33-223 re-colour the CUE linearly through the HSV colour space,

with values 225-255 re-colouring the cue to full white.

• The values 33-223 adjust the hue range between 0 and 360 degrees with
full saturation (S = 1.0, V = 1.0).

• If access mode is below Full, no re-colour will occur.

|            |                 |
|------------|-----------------|
| Channel 16 | 0 ... 255       |
| Reserved   | NOT IMPLEMENTED |

# <span id="anchor-70"></span>Settings

## <span id="anchor-71"></span>Projection Settings

> When in LaserOS control mode, the Image Setup, Colour Balance and
> Safety Zone settings are handled by LaserOS, so their CubeOS entries
> remain greyed out.

> Test Patterns are still accessible though.

<div class="row g-3 align-items-start">
  <div class="col">
    {{< img src="Pictures/10000000000000F000000140BF6CEEE1.bmp" formats="webp jpeg" >}}
  </div>
  <div class="col">
    {{< img src="Pictures/10000000000000F00000014094518054.bmp" formats="webp jpeg" >}}
  </div>
  <div class="col">
    {{< img src="Pictures/10000000000000F0000001408C843B37.bmp" formats="webp jpeg" >}}
  </div>
</div>

> By selecting one of the other control modes, such as Visualizer, the
> CubeOS stand-alone image settings are made available:

{{< img src="Pictures/10000000000000F00000014030C31327.bmp" formats="webp jpeg" >}}

### <span id="anchor-72"></span><span id="anchor-73"></span><span id="anchor-74"></span><span id="anchor-75"></span>Image Setup

<div class="row g-3 align-items-start">
  <div class="col">
    {{< img src="Pictures/10000000000000F000000140160D7C1D.png" formats="webp jpeg" >}}
  </div>
  <div class="col">
    {{< img src="Pictures/10000000000000F000000140A41929A1.png" formats="webp jpeg" >}}
  </div>
  <div class="col">
    {{< img src="Pictures/10000000000000F000000140A6D29B68.png" formats="webp jpeg" >}}
  </div>
</div>

> Image power, rotation, X-size, Y-size, X-Flip, Y-Flip, X-Position and
> Y-Position are configurable. When X and Y size are at 100%, the
> position sliders have no effect as they cannot move the full-size
> image beyond the full-size projection area.

> The X and Y position sliders have a range of -128 to +128

> If the X and Y image size are reduced to 50%, then the X and Y
> position sliders will move the image with settings between -64 and +64

> A good way to get a feel for how the image size affects the amount of
> positional movement available, is to enable the RGB-THold test pattern
> (see Test Patterns below) then adjust image size and position in the
> Image Setup menu.

> 

### <span id="anchor-76"></span>Colour Balance

<div class="row g-3 align-items-start">
  <div class="col">
    {{< img src="Pictures/10000000000000F0000001404EE66917.png" formats="webp jpeg" >}}
  </div>
  <div class="col">
    {{< img src="Pictures/10000000000000F000000140EED9CFB7.png" formats="webp jpeg" >}}
  </div>
  <div class="col">
    {{< img src="Pictures/10000000000000F000000140470661B3.png" formats="webp jpeg" >}}
  </div>
</div>

> Colour balance settings allow for fine adjustments of maximum and
> minimum outputs for each colour laser, plus the gamma curve for each.
> The default values should be adequate for most situations, but
> adjustments are available to allow for precise colour matching of
> multiple projectors.

### <span id="anchor-77"></span>Safety Zone

<div class="row g-3 align-items-start">
  <div class="col">
    {{< img src="Pictures/10000000000000F00000014030BCDA75.png" formats="webp jpeg" >}}
  </div>
  <div class="col">
    {{< img src="Pictures/10000000000000F000000140D7317285.png" formats="webp jpeg" >}}
  </div>
  <div class="col">
    {{< img src="Pictures/10000000000000F000000140FCFB2D8B.png" formats="webp jpeg" >}}
  </div>
</div>

<div class="row g-3 align-items-start">
  <div class="col">
    {{< img src="Pictures/10000000000000F00000014016743A27.png" formats="webp jpeg" >}}
  </div>
  <div class="col">
    {{< img src="Pictures/10000000000000F000000140C6CCE962.png" formats="webp jpeg" >}}
  </div>
</div>

The Safety Zone setting, when enabled allows a basic shape to be created
for a keep within or keep out zone. The preview toggle (with Laser
Interlock Enabled) will project the outline of the safety zone.

By default, it is a keep-within zone and the projected preview colour is
green.

By setting the invert toggle, it becomes a keep-out zone and the
projected preview colour is red.

Whilst outside of a keep-within, or inside of a keep-out zone, the laser
power is reduced according to the attenuation setting. 100% attenuation
means that the out of zone beams are fully blanked. A 90% attenuation
would mean that the out of zone beams are reduced to 10% of their normal
power.

The Zone shape is selectable between Rectangle, Circle or Ellipse.

The size and position of the zone shape is adjustable using the
respective sliders.

The keep-within zone may be useful for defining a target area where the
beam may be safely terminated. The keep out zone may be useful for
excluding beams from an area when a camera or digital projector is
located.

Keep Within Safety Zone

<img src="Pictures/1000000000000526000001B755B18CD7.jpg" style="width:574px;height:auto" />

Keep Out Safety Zone

<img src="Pictures/1000000000000525000001DC82110C19.jpg" style="width:575px;height:auto" />

### <span id="anchor-78"></span>Test Patterns

<div class="row g-3 align-items-start">
  <div class="col">
    {{< img src="Pictures/10000000000000F0000001403BECC7E5.png" formats="webp jpeg" >}}
  </div>
  <div class="col">
    {{< img src="Pictures/10000000000000F000000140BE68634B.png" formats="webp jpeg" >}}
  </div>
</div>

> The built-in test patterns are provided to verify correct operation of
> the lasers and the scanning system. The RGB Thold pattern is a low
> brightness one, used for factory setting of the internal laser diode
> driver. It can also be useful for setting up projectors on site as it
> has a border that shows the projected image size. Note that this is
> affected by the rotation, X-size, Y-size, X-Position and Y-Position
> sliders in Image Setup.

> 

> Example test patterns available

<div class="row g-3 align-items-start">
  <div class="col">
    {{< img src="Pictures/10000000000000F000000140915B6BD7.bmp" formats="webp jpeg" >}}
  </div>
  <div class="col">
    {{< img src="Pictures/10000000000000F000000140146609EE.bmp" formats="webp jpeg" >}}
  </div>
  <div class="col">
    {{< img src="Pictures/10000000000000F000000140CE915F53.bmp" formats="webp jpeg" >}}
  </div>
</div>

<div class="row g-3 align-items-start">
  <div class="col">
    {{< img src="Pictures/10000000000000F0000001401E94440F.bmp" formats="webp jpeg" >}}
  </div>
</div>

## <span id="anchor-79"></span>Tempo Settings

The tempo settings are used to control the speed of any enabled effects
applied to the projection (see device effects wiki or in this guide
here: <a href="#anchor-108">Effects</a>), e.g. The strobe
effect will flash faster as you increase the BPM slider in the tempo
menu, and flash slower when reducing the BPM slider.

The purpose of the tempo menu is mainly for live DJ effects while a
music track is playing.

In order for the supplied effects to work to the beat of a music track,
you must first set the correct BPM, preferably using the tap BPM
feature, then use the sync button to mark which beat is the first beat
of a bar. Once this is done the effects will then be in sync with any
music that is playing allowing the user (with the aid of an APC40 MK2
MIDI controller) to perform live adjustments to the projection using
effects assigned to dials/faders on a MIDI controller.

The tempo menu can be accessed by going to Settings→Tempo when in either
playlist or visualizer control mode.

<div class="row g-3 align-items-start">
  <div class="col">
    {{< img src="Pictures/10000000000000F00000014015A60A98.bmp" formats="webp jpeg" >}}
  </div>
  <div class="col">
    {{< img src="Pictures/10000000000000F000000140F678F662.bmp" formats="webp jpeg" >}}
  </div>
</div>

The tempo can be set using the BPM slider, or can be set using the “Tap
BPM” button.

Continuously pressing the “Tap BPM” button to the beat of any externally
playing music track will allow the laser cube to calculate the actual
BPM of the music.

The “Sync Beat” button will synchronize the beat to beat 1 of a 4 beat
bar.

The tempo parameters also also MIDI mapped to the dedicated tempo
buttons on an APC40 MK2 if using the factory supplied MIDI mappings.

Note: MK2 menu items in yellow (as shown in image above) mean they have
been MIDI mapped to a dial/fader on an external MIDI controller. They
will only show in yellow when a compatible MIDI controller is
conn<img src="Pictures/100000010000021A000001529F4FC536.png" style="width:321px;height:auto" />ected to the USB port of the
laser cube.

## <span id="anchor-80"></span>Audio Settings

Audio settings can be adjusted by going into Settings-\>Audio as shown
below:

{{< img src="Pictures/10000000000000F00000014074CAE41D.bmp" formats="webp jpeg" >}}

The audio settings allow changes to the audio output volume, audio
output delay, audio input selection, and input gain controls.

### <span id="anchor-81"></span>Audio Output Volume

The audio output volume can be adjusted from 0 to 100%. This control
will adjust the current volume while a laser show is playing, and this
slider can be midi mapped to an APC MIDI controller.

This control will directly affect the audio coming out of the 3.5mm
audio connector on the rear of the device, and is labelled A-OUT (green
connector)

Press on the menu knob to edit the slider and make adjustments, then
press again on the knob to exit and save this value (preserved through
power cycle).

{{< img src="Pictures/10000000000000F00000014018E1179F.bmp" formats="webp jpeg" >}}

To map the audio volume output slider to a MIDI controller then ensure
USB MIDI is enabled in settings-\>USB MIDI and a compatible APC MIDI
device is connected, then single press the menu knob to enter slider
edit mode (slider bar turns orange), then long press again on the knob
and a context menu will appear allowing you to link this slider to a
dial or fader over MIDI, or unlink from an existing MIDI fader, or reset
the slider to its default value.

Note: The audio output volume slider comes pre-configured to a MIDI dial
on an APC40 MK2 if using the factory supplied SD card.

### <span id="anchor-82"></span>Audio Output Delay

This slider allows the audio output to be either delayed, or started
earlier (with respect to a projection, like when using the laser cube in
laser show mode) in order to compensate for any audio processing delay
due any extra audio processing present on the device connected to the
line output port of the device.

{{< img src="Pictures/10000000000000F0000001405D42114F.bmp" formats="webp jpeg" >}}

Example: Some portable amplified speakers have a DSP in order to provide
audio reactive light effects etc, and this can cause the audio going
into the unit to be delayed by as much as 300 milliseconds. This would
cause laser shows played on the device to be completely out of sync with
the audio, so adjusting the out delay slider can compensate for this.

Note: Once a laser show on the device has started, this slider will have
no affect on the audio output delay until you stop and start the laser
show again.

The audio settings also have no effect when using the device in LaserOS
mode, as all audio is handled by LaserOS in this case.

### <span id="anchor-83"></span>Audio Input Selection

This dropdown is used to change the audio input source used by the
device, and can be set to either the built in microphone or the stereo
line input connector.

{{< img src="Pictures/10000000000000F0000001409C19DB74.bmp" formats="webp jpeg" >}}

The audio reactive visualizers and effects built into the device will be
affected by this setting.

When line input is selected as the audio input source, you will need to
apply audio from a PC or other analog audio capable device via the 3.5mm
stereo jack to the rear of the unit labelled A-IN (pink connector).

### <span id="anchor-84"></span>Max Line Gain / MAX MIC Gain

This dropdown allows the user to change the amount of gain that is
applied to the audio input source. Setting the gain too low here will
result in some audio reactive visualizers showing very little change.
Equally setting a too high gain will result in over driven visualizers.
Both inputs can have their gain adjusted from 0dB to 50dB in 5dB steps.

<div class="row g-3 align-items-start">
  <div class="col">
    {{< img src="Pictures/10000000000000F000000140004C5F6B.bmp" formats="webp jpeg" >}}
  </div>
  <div class="col">
    {{< img src="Pictures/10000000000000F0000001409352A0C4.bmp" formats="webp jpeg" >}}
  </div>
</div>

### <span id="anchor-85"></span>Audio Defaults

The entire audio settings can be reset to factory default values by
clicking this button and accepting the pop-up message box asking to
reset the values.

{{< img src="Pictures/10000000000000F000000140F8F9E926.bmp" formats="webp jpeg" >}}

## <span id="anchor-86"></span>Connection Settings

<div class="row g-3 align-items-start">
  <div class="col">
    {{< img src="Pictures/10000000000000F00000014066AA589C.bmp" formats="webp jpeg" >}}
  </div>
  <div class="col">
    {{< img src="Pictures/10000000000000F0000001407A909C8A.png" formats="webp jpeg" >}}
  </div>
  <div class="col">
    {{< img src="Pictures/10000000000000F0000001409D49F71D.bmp" formats="webp jpeg" >}}
  </div>
</div>

Note: If the connection mode is changed, the laser cube will need to
restart.

Move the red cursor to highlight “Yes” and push the rotary knob to
confirm.

Select the connection type (required for network control via LaserOS,
ArtNet or Liberation etc.)

For multiple laser cubes, and especially in areas where local WiFi may
be congested, we recommend using an Ethernet cable in LAN client mode.
When set to LAN client mode on a network without a DHCP server, the
Laser cubes will self-assign an APIPA address.

{{< img src="Pictures/10000000000000F0000001406C3D4B5F.bmp" formats="webp jpeg" >}}

The tick by LAN-C indicates that the laser cube has connected in LAN
Client Mode.

The A-IP indicates that the IP address shown – 169.254.129.54 is an
AIPIPA one.

The Network settings can be customized under the [*Network
menu*](http://wiki.laseros.com/index.php/UltraMk2Network).

<div class="row g-3 align-items-start">
  <div class="col">
    {{< img src="Pictures/10000000000000F000000140210BB151.bmp" formats="webp jpeg" >}}
  </div>
  <div class="col">
    {{< img src="Pictures/10000000000000F00000014022BCAF89.bmp" formats="webp jpeg" >}}
  </div>
</div>

#### <span id="anchor-87"></span>APIPA mode explained

<img src="Pictures/10000000000009B00000036D8CE24CA2.png" style="width:642px;height:auto" />

When using LAN client mode, the laser cube will try to obtain an IP
address from a DHCP server on your network. If you have connected the
laser cube directly to your home router, or via an ethernet switch to
your home router then you will see that the laser cube will be given an
IP address according to your network (e.g. 192.168.x.x).

If you are not connecting the cube via a home router or DHCP server (due
to connecting a cable directly between PC/Mac/iOS and the laser cube)
then the cube will self assign itself an IP address using the Auto IP
protocol after around 20 seconds.

APIPA addresses start with 169.254.x.x.

If you are using Windows or an Apple MacBook then the following should
be done in order to connect with our LaserOS software using APIPA:

1.  Temporarily turn off WiFi on your PC/MacBook
2.  ensure LaserOS is not running, and close it if it is.
3.  Turn on your laser cube and connect an ethernet cable from the LAN
    port on the cube to the LAN port on your PC/macBook.
4.  Wait until the laser cube self assign’s an APIPA address.
5.  Start LaserOS on your macBook and check that the device is detected
    (Laser ON button in the top right corner of LaserOS software should
    NOT be greyed out).
6.  Turn your PC/MacBook WiFi back on if you need internet access.

## <span id="anchor-88"></span>Network Settings

<div class="row g-3 align-items-start">
  <div class="col">
    {{< img src="Pictures/10000000000000F0000001402AC8A7FC.bmp" formats="webp jpeg" >}}
  </div>
  <div class="col">
    {{< img src="Pictures/10000000000000F000000140BF6CEEE1.bmp" formats="webp jpeg" >}}
  </div>
  <div class="col">
    {{< img src="Pictures/10000000000000F000000140F5195DE3.bmp" formats="webp jpeg" >}}
  </div>
</div>

### <span id="anchor-89"></span><span id="anchor-90"></span><span id="anchor-91"></span>LAN Client Mode

For multiple laser cubes, and especially in areas where local WiFi may
be congested, this is the recommended connection mode. When connected to
a network without a DHCP server, the Laser cubes will self-assign APIPA
addresses, otherwise your home router (or network switch connected to
your home router) will provide the IP address automatically.

#### <span id="anchor-92"></span>LAN Client Mode Customisations

IP (Address) Mode - Auto IP / Static IP

Auto mode. Uses DHCP server if present, or AIPIPA.

Static IP. Manual configuration of IP Address, Net Mask and Gateway

<div class="row g-3 align-items-start">
  <div class="col">
    {{< img src="Pictures/10000000000000F000000140A6F2D637.png" formats="webp jpeg" >}}
  </div>
  <div class="col">
    {{< img src="Pictures/10000000000000F00000014062E83824.png" formats="webp jpeg" >}}
  </div>
  <div class="col">
    {{< img src="Pictures/10000000000000F00000014035799B1B.png" formats="webp jpeg" >}}
  </div>
</div>

<div class="row g-3 align-items-start">
  <div class="col">
    {{< img src="Pictures/10000000000000F00000014076342E69.png" formats="webp jpeg" >}}
  </div>
</div>

To enter the IP address, short press with the entry box highlighted.

The gateway IP address and subnet mask can be edited in the same way
(Gateway IP is the IP address of your home router / DHCP server)

<div class="row g-3 align-items-start">
  <div class="col">
    {{< img src="Pictures/10000000000000F00000014070E1086E.png" formats="webp jpeg" >}}
  </div>
  <div class="col">
    {{< img src="Pictures/10000000000000F0000001409102BA06.png" formats="webp jpeg" >}}
  </div>
</div>

### <span id="anchor-93"></span>LAN Server Mode

This is recommended if you want to use a direct wired connection to a
single device like a MacBook or Laptop, or mobile device with the
provided USB→LAN adapter.

#### <span id="anchor-94"></span><span id="anchor-95"></span>LAN Server Mode Customisations

Manual configuration of the laser cube device IP Address and Net Mask

{{< img src="Pictures/10000000000000F000000140F364BFDD.bmp" formats="webp jpeg" >}}

### <span id="anchor-96"></span><span id="anchor-97"></span>WiFi Server Mode

Useful for cable free, single cube LaserOS operation in areas with no
WiFi congestion.

Note: Make sure you connect the provided WiFi Antenna before using any
wireless modes.

It is preferable to leave the WiFI channel set to Auto, which will make
the device scan for the quietest WiFI channel to use at each power on of
the device.

#### <span id="anchor-98"></span>WiFi Server Mode Customisations

SSID, Password, Channel (including Auto), Bandwidth, IP Address, Net
Mask

<div class="row g-3 align-items-start">
  <div class="col">
    {{< img src="Pictures/10000000000000F0000001400A98068C.png" formats="webp jpeg" >}}
  </div>
  <div class="col">
    {{< img src="Pictures/10000000000000F000000140C81B5C7A.png" formats="webp jpeg" >}}
  </div>
  <div class="col">
    {{< img src="Pictures/10000000000000F00000014057171006.png" formats="webp jpeg" >}}
  </div>
</div>

The example images below show the manual WiFi server IP address and net
mask entry

<div class="row g-3 align-items-start">
  <div class="col">
    {{< img src="Pictures/10000000000000F000000140E4904C62.png" formats="webp jpeg" >}}
  </div>
  <div class="col">
    {{< img src="Pictures/10000000000000F0000001402613E951.png" formats="webp jpeg" >}}
  </div>
</div>

The WiFi server page also has a “WiFi Scan” button, which when pressed
will display a channel list showing other devices using the current
2.4GHz wireless channel range, and also automatically choose the
quietest channel after the channel scan completes.

If the channel list is mostly red then your location is congested due
too many other 2.4GHz devices in operation (like in an apartment /
building complex), and you should consider using the provided USB→LAN
adapter as a wired connection instead, thus avoiding projection break-up
due to potential network packet loss.

This is only important when using LaserOS control mode since this mode
streams UDP DAC sample data at a high data rate over the wireless
network, but for other modes like playlist/visualizer mode then this
should have no impact on projection quality, since these modes render
content locally from SD card rather than over the network.

Example images of the WiFi server scan button and popup channel list
page

<div class="row g-3 align-items-start">
  <div class="col">
    {{< img src="Pictures/10000000000000F0000001407743B4A1.bmp" formats="webp jpeg" >}}
  </div>
  <div class="col">
    {{< img src="Pictures/10000000000000F000000140761019F4.bmp" formats="webp jpeg" >}}
  </div>
  <div class="col">
    {{< img src="Pictures/10000000000000F000000140A5EF5ED7.bmp" formats="webp jpeg" >}}
  </div>
</div>

Note: The “WiFi Scan” button will be greyed out if you are not currently
in WiFi server network connection mode.

### <span id="anchor-99"></span>WiFi Client Mode

For connecting to an existing WiFi router. Performance may vary
depending on the quality of the router, amount of WiFi congestion and
the amount of existing network traffic.

Note: Make sure you connect the provided WiFi Antenna before using any
wireless modes.

#### <span id="anchor-100"></span>WiFi Client Mode Customisations

SSID, Password, IP Mode - Auto / Static (IP Address, Gateway, Net Mask)

<div class="row g-3 align-items-start">
  <div class="col">
    {{< img src="Pictures/10000000000000F0000001406671C9A9.png" formats="webp jpeg" >}}
  </div>
  <div class="col">
    {{< img src="Pictures/10000000000000F000000140599E2C16.png" formats="webp jpeg" >}}
  </div>
  <div class="col">
    {{< img src="Pictures/10000000000000F000000140990D5DCC.png" formats="webp jpeg" >}}
  </div>
</div>

<div class="row g-3 align-items-start">
  <div class="col">
    {{< img src="Pictures/10000000000000F000000140C6A3EA71.png" formats="webp jpeg" >}}
  </div>
  <div class="col">
    {{< img src="Pictures/10000000000000F000000140996CEBE9.png" formats="webp jpeg" >}}
  </div>
  <div class="col">
    {{< img src="Pictures/10000000000000F0000001400772B2B8.png" formats="webp jpeg" >}}
  </div>
</div>

To enter the IP address, short press with the entry box highlighted.

Select the tick button to close the entry box.

### <span id="anchor-101"></span>Cube Link Mode

Wireless Cube Link (only available when connection mode is not set to
WiFi) is a method of synchronising playback of content across multiple
laser cubes. Cube Link does not require a WiFI network to be present as
it creates its own wireless network to communicate between master and
slave devices within ~20-40m line-of-sight range using a low data rate
communication protocol.

Note: Make sure you connect the provided WiFi Antenna before using any
wireless modes.

In order to set up a Cube Link network, it must be enabled on each laser
cube, then one laser cube must be set to Master, and the other laser
cubes as slaves. To exist on the same Cube Link Network, they must all
share the same Link Channel and Link Pin. The Group determines what
content that particular laser cube will project. For a 2 projector Laser
show, the first projector content will be shown on all laser cubes set
to Group 1 and the second projector content will be shown on all laser
cubes set to group 2.

Slave devices that are in range of a Master that have a matching channel
and pin configuration will be indicated by the status bar background on
each slave turning from black to purple.

{{< img src="Pictures/10000000000000F0000001406EE4C13E.png" formats="webp jpeg" >}}

#### <span id="anchor-102"></span>Cube Link Mode Customisations

Enable, Master/Slave, Link Channel, PIN, Group

<div class="row g-3 align-items-start">
  <div class="col">
    {{< img src="Pictures/10000000000000F000000140D1E60984.png" formats="webp jpeg" >}}
  </div>
  <div class="col">
    {{< img src="Pictures/10000000000000F00000014069617B4B.png" formats="webp jpeg" >}}
  </div>
  <div class="col">
    {{< img src="Pictures/10000000000000F0000001408A34D6F2.png" formats="webp jpeg" >}}
  </div>
</div>

<div class="row g-3 align-items-start">
  <div class="col">
    {{< img src="Pictures/10000000000000F0000001409B4CCD0F.png" formats="webp jpeg" >}}
  </div>
</div>

> 

> 

> To set the PIN, either use the + and – buttons to increase / decrease
> the selected digit, highlighted in blue, or short press with the PIN
> entry box highlighted.

> 

> When in the PIN entry box:

>  Short press to change the highlighted digit.

>  Rotate the knob to increase/decrease the highlighted digit

>  Long press to exit the PIN entry box.

{{< img src="Pictures/10000000000000F00000014055370281.png" formats="webp jpeg" >}}

## <span id="anchor-103"></span>USB MIDI Settings

In order to use any of these MIDI devices, the USB must be enabled by
going to the Settings -\>USB MIDI menu.

<div class="row g-3 align-items-start">
  <div class="col">
    {{< img src="Pictures/10000000000000F0000001408894CF71.bmp" formats="webp jpeg" >}}
  </div>
  <div class="col">
    {{< img src="Pictures/10000000000000F0000001404EE58297.bmp" formats="webp jpeg" >}}
  </div>
  <div class="col">
    {{< img src="Pictures/10000000000000F000000140D1E6FA2F.bmp" formats="webp jpeg" >}}
  </div>
</div>

Note: USB MIDI does **NOT** operate when the unit is in LaserOS / ArtNet
/ DMX / IDN / Ether-Dream control modes, as these modes are controlled
using alternate communication protocols.

<div class="row g-3 align-items-start">
  <div class="col">
    {{< img src="Pictures/10000000000000F0000001403852FCAE.bmp" formats="webp jpeg" >}}
  </div>
  <div class="col">
    {{< img src="Pictures/10000000000000F000000140A9A20B7D.bmp" formats="webp jpeg" >}}
  </div>
</div>

If a compatible device is detected on the laser cube’s USB port, then
the status bar will briefly show an updated connected status, and
unplugging a device will show the disconnected status as shown above.
The status bar will also show a green tick or a cross next to the MIDI
label on the RHS of the status bar.

## <span id="anchor-104"></span>Playback Speed Settings

The user can adjust the playback speed of any CUE being projected while
in the playlist control mode. This can be done using the
Settings→Playback Speed menu

<div class="row g-3 align-items-start">
  <div class="col">
    {{< img src="Pictures/10000000000000F0000001402F2A03BB.bmp" formats="webp jpeg" >}}
  </div>
  <div class="col">
    {{< img src="Pictures/10000000000000F000000140ED7194DC.bmp" formats="webp jpeg" >}}
  </div>
</div>

The playback speed slider can also be assigned to a MIDI knob or fader
if using an APC40 MK2 or APC mini MK2 (see <a href="#anchor-133">MIDI Mapping</a>
in this guide, or the online wiki).

## <span id="anchor-105"></span>General Settings

This menu has options to change the LCD brightness, enable backward
compatibility with original WiFi cubes, battery percent display, and
preview mode style.

When the battery percentage option is enabled, the battery gauge in the
status bar will periodically display the actual percent remaining in
addition to the simple battery guage.

The preview mode style can also be set to 2D or 3D, which will affect
the preview screen when it is opened from the main menu.

<div class="row g-3 align-items-start">
  <div class="col">
    {{< img src="Pictures/10000000000000F000000140C8349908.bmp" formats="webp jpeg" >}}
  </div>
  <div class="col">
    {{< img src="Pictures/10000000000000F000000140DD055768.bmp" formats="webp jpeg" >}}
  </div>
  <div class="col">
    {{< img src="Pictures/10000000000000F00000014004AB72D8.bmp" formats="webp jpeg" >}}
  </div>
</div>

<div class="row g-3 align-items-start">
  <div class="col">
    {{< img src="Pictures/10000000000000F000000140EF56F9D5.bmp" formats="webp jpeg" >}}
  </div>
</div>

Note: The backward compatibility option will only need to be enabled if
you intend to use a mix of old WiFi cubes and new Ultra MK2 / Evo laser
cubes on the same network with our LaserOS software (you will also need
LaserOS version \>= v0.17.7).

## <span id="anchor-106"></span>ILDA Input Config Settings

The parameters set in the ILDA Input Configuration menu are valid when
an external DAC is connected to the ILDA input connector on the back of
the device. With no ILDA cable is connected, this item will be greyed
out on the LCD menu UI.

<div class="row g-3 align-items-start">
  <div class="col">
    {{< img src="Pictures/10000000000000F0000001407DF9851A.png" formats="webp jpeg" >}}
  </div>
  <div class="col">
    {{< img src="Pictures/10000000000000F000000140100AD2C1.png" formats="webp jpeg" >}}
  </div>
</div>

When an external DAC is connected via the ILDA input connector, an
additional menu item is available under Settings – ILDA Input Cfg.

This is for digitally tuning the Laser Diode Driver to compensate for
any errors in the third-party DAC hardware. One common problem is “ghost
beams” where one or more channels of the ILDA colour signals have a
small voltage present on the output pins when those channels are meant
to be off (blanked).

The In Mute R, G and B levels allow a threshold to be set, below which
the beams are forced to be off. For example, a DAC with a higher than
normal “zero output voltage” on the green channel could cause a faint
green beam to always be emitted, regardless of any master brightness
setting in the controller software for that DAC. The ILDA Input Cfg -\>
“In Mute G” level could be raised until the green ghost beam is
extinguished.

There being an increased offset on the green channel would also affect
the colour balance at low intensities. To compensate, the ILDA Input Cfg
–\> “Diode th G” could be reduced until the correct colour balance is
restored. This allows errors from external DACs to be tuned out.

<div class="row g-3 align-items-start">
  <div class="col">
    {{< img src="Pictures/10000000000000F000000140599B8C82.png" formats="webp jpeg" >}}
  </div>
  <div class="col">
    {{< img src="Pictures/10000000000000F000000140696B6717.png" formats="webp jpeg" >}}
  </div>
</div>

## <span id="anchor-107"></span>Menu Language Settings

The LCD menu can be set into any one of 12 available languages (default
is English).

The device needs to restart when the language chosen differs from the
current menu UI language.

<div class="row g-3 align-items-start">
  <div class="col">
    {{< img src="Pictures/10000000000000F0000001401F2D5CD1.bmp" formats="webp jpeg" >}}
  </div>
  <div class="col">
    {{< img src="Pictures/10000000000000F0000001402CF7BC97.bmp" formats="webp jpeg" >}}
  </div>
  <div class="col">
    {{< img src="Pictures/10000000000000F00000014079B6AEBC.bmp" formats="webp jpeg" >}}
  </div>
</div>

<div class="row g-3 align-items-start">
  <div class="col">
    {{< img src="Pictures/10000000000000F000000140E9766761.bmp" formats="webp jpeg" >}}
  </div>
</div>

Note: In order for the UI labels to fit within the screen width without
horizontal scrolling, some UI labels have had to be shortened, so they
may not be the most suitable word(s) available in each language.

# <span id="anchor-108"></span>Built in Effects

The effects menu will be available on the top level menu of the laser
cube when it is in any mode that allows additional audio reactive
effects to be used.

The effects can be used to warp or re-colour the currently projected
image, and each effect can contain either an audio reactive element, or
tempo based modifier.

If an effect is dependant on the current setting of the tempo, then this
can be accessed from settings→tempo, or set using tap tempo on an APC40
MK2 device (see wiki section on
<a href="#anchor-79">tempo</a>).

Any of the effect parameters can be MIDI mapped to an APC40 MK2 or APC
mini MK2 in order to allow live modification of the effects (see our
DEMO APC40 MK2 MIDI mapping on the SD card provided with the laser
cube).

Note: Some effect parameters like “Force On” are intended to be MIDI
mapped only, and are used for live effect activation using an APC40 MK2
/ APC mini MK2 MIDI device.

The Effects menu can be accessed from the top level menu when the device
is in playlist or visualizer control mode as shown in the image below:

{{< img src="Pictures/10000000000000F0000001404619E973.bmp" formats="webp jpeg" >}}

In order to be able to use the effects they must be enabled. If no
effects are required then it is recommended to have the effects disabled
to prevent unintentional changes to the projection.

{{< img src="Pictures/10000000000000F000000140603C49F4.bmp" formats="webp jpeg" >}}

Any of the effect parameters changed via the LCD menu UI will be
preserved through a power cycle. This is to allow the unit to start up
with any effect chosen by the user without any additional actions which
is perfect for when the device just needs to be powered on and interlock
activated.

### <span id="anchor-109"></span>Available Effects

There are currently 78 effects that can be applied to the currently
projected image, and each effect has its own set of user adjustable
parameters depending on the chosen effect.

Movement & 3D (17)

|  |  |  |
|----|----|----|
| <img src="Pictures/10000000000000780000007895F940A4.png" style="width:40px;height:auto;max-width:none" /> | Zoom Effect | Scales the whole image in and out with an eased sweep, locked to the tap tempo. A Linear switch gives constant-rate zoom. |
| <img src="Pictures/10000000000000780000007834B33CB9.png" style="width:40px;height:auto;max-width:none" /> | 3D Spin | Spins the image about the vertical axis in an eased forward / rest / reverse / rest cycle, synced to tempo. |
| <img src="Pictures/10000000000000780000007829D68EA3.png" style="width:40px;height:auto;max-width:none" /> | 3D Column | Wraps the image around a rotating vertical cylinder whose radius slowly breathes in and out, with perspective depth. |
| <img src="Pictures/100000000000007800000078234C5CCD.png" style="width:40px;height:auto;max-width:none" /> | 3D Globe A | Re-interprets each point as yaw/pitch on a rotating sphere, projected back to 2D with a perspective depth fade. |
| <img src="Pictures/100000000000007800000078780DFD07.png" style="width:40px;height:auto;max-width:none" /> | 3D Globe B | Globe spin at half speed and reversed, sitting closer to the camera with a quadratic radius depth fade. |
| <img src="Pictures/1000000000000078000000782998557C.png" style="width:40px;height:auto;max-width:none" /> | 3D Gyro A | Tumbles in 3D on three spinning axes; each tempo tick starts or stops a random axis. Telephoto perspective. |
| <img src="Pictures/1000000000000078000000787805E037.png" style="width:40px;height:auto;max-width:none" /> | 3D Gyro B | Gyro that swaps axes twice as often, spins faster, and uses the closer perspective with a radius fade. |
| <img src="Pictures/1000000000000078000000784FCEAF95.png" style="width:40px;height:auto;max-width:none" /> | 3D Flip A | Performs one full revolution per cycle around a random in-plane axis with a telephoto perspective, tempo-synced. |
| <img src="Pictures/100000000000007800000078981472F1.png" style="width:40px;height:auto;max-width:none" /> | 3D Flip B | Flip with an added out-of-plane tilt and a close-up perspective with radius fade. |
| <img src="Pictures/100000000000007800000078A4E5A11A.png" style="width:40px;height:auto;max-width:none" /> | 3D Twist A | Rotates about the horizontal axis with the angle offset by x, twisting the image like a ribbon that rolls continuously. |
| <img src="Pictures/1000000000000078000000783986E573.png" style="width:40px;height:auto;max-width:none" /> | 3D Twist B | Ribbon twist that eases back and forth in a raised-cosine wobble instead of rolling all the way round. |
| <img src="Pictures/100000000000007800000078EDB914C8.png" style="width:40px;height:auto;max-width:none" /> | 3D Twist C | Corkscrew wobble about the vertical axis, blending sine and cosine oscillation from the bottom to the top of the frame. |
| <img src="Pictures/100000000000007800000078C6FB2A3B.png" style="width:40px;height:auto;max-width:none" /> | 3D Tumble A | Tumbles end-over-end around the horizontal axis, with lit strokes pushed out in front of the image plane. |
| <img src="Pictures/1000000000000078000000789C925612.png" style="width:40px;height:auto;max-width:none" /> | 3D Tumble B | Tumble where each stroke gets a random depth offset whose strength rides a bass x treble audio energy gate. |
| <img src="Pictures/100000000000007800000078046355ED.png" style="width:40px;height:auto;max-width:none" /> | 3D Flag | Drapes the image onto a rippling flag surface with a drifting wave phase and two slow sways around the pole. |
| <img src="Pictures/100000000000007800000078426EC9AC.png" style="width:40px;height:auto;max-width:none" /> | 3D Jellyfish | Ripples the image radially through a damped-sine bell while five slow oscillators wobble it around in 3D. |
| <img src="Pictures/100000000000007800000078817537DF.png" style="width:40px;height:auto;max-width:none" /> | Spiral | Twists the image into a spiral (rotation grows with radius); the twist steps through quarter/half turns on tempo. |

Warps & Distortion (19)

|  |  |  |
|----|----|----|
| <img src="Pictures/1000000000000078000000782D1C0E07.png" style="width:40px;height:auto;max-width:none" /> | Warp Circle | Radial remap using a chebyshev/euclidean ratio so square framings bulge outward into circles. |
| <img src="Pictures/100000000000007800000078330FC6BD.png" style="width:40px;height:auto;max-width:none" /> | Warp Square | The inverse remap - circular framings squash inward into squares. |
| <img src="Pictures/100000000000007800000078AD52FE03.png" style="width:40px;height:auto;max-width:none" /> | Warp Clover | Manhattan-distance ratio pinches the image into a four-lobed clover-leaf shape. |
| <img src="Pictures/10000000000000780000007884C88CE3.png" style="width:40px;height:auto;max-width:none" /> | Warp Diamond | The inverse of Clover, stretching the image out into a diamond. |
| <img src="Pictures/1000000000000078000000781C1C42EC.png" style="width:40px;height:auto;max-width:none" /> | Warp Orbital | Circle warp without the square root - a double-strength radial bulge. |
| <img src="Pictures/100000000000007800000078B981D8A6.png" style="width:40px;height:auto;max-width:none" /> | Warp Bubble | Magnifies the centre up to 1.68x inside a fixed ring, like looking through a bubble lens. |
| <img src="Pictures/100000000000007800000078FDC16488.png" style="width:40px;height:auto;max-width:none" /> | Telescope | Fisheye radial zoom - magnifies the centre, compresses the edges, clipped to a clean circular rim. |
| <img src="Pictures/100000000000007800000078846EA3C6.png" style="width:40px;height:auto;max-width:none" /> | Ripple A | A travelling pond ripple: a radial wave scales each point's distance from centre. Plain speed slider. |
| <img src="Pictures/100000000000007800000078AECFC14C.png" style="width:40px;height:auto;max-width:none" /> | Ripple B | The same ripple, but its position rides the tap-tempo phase. |
| <img src="Pictures/100000000000007800000078B0FB154E.png" style="width:40px;height:auto;max-width:none" /> | Gong A | A wave crashes outward from the centre on each tap-tempo beat. |
| <img src="Pictures/1000000000000078000000788F75C80C.png" style="width:40px;height:auto;max-width:none" /> | Gong B | A standing radial wave pumped by the audio reactor's fast bass spin (music aware). |
| <img src="Pictures/10000000000000780000007847818BD5.png" style="width:40px;height:auto;max-width:none" /> | Wavy | A three-octave sine ripple displaces the image horizontally; amplitude rides the bass, the pattern scrolls on tempo. |
| <img src="Pictures/100000000000007800000078D841C3BA.png" style="width:40px;height:auto;max-width:none" /> | Jelly A | Squashes the image on two oscillating axes so it wobbles like jelly, driven by slow bass and treble walkers. |
| <img src="Pictures/100000000000007800000078903762D6.png" style="width:40px;height:auto;max-width:none" /> | Jelly B | Beat-locked jelly wobble: x squashes at double the beat rate, y on the beat. |
| <img src="Pictures/100000000000007800000078DC863E9F.png" style="width:40px;height:auto;max-width:none" /> | Jelly C | Beat-locked jelly wobble: x squashes per beat, y per bar. |
| <img src="Pictures/1000000000000078000000780C0D7B49.png" style="width:40px;height:auto;max-width:none" /> | Squiggle | Adds a continuously rotating circular offset so straight lines are drawn as tight corkscrew squiggles. |
| <img src="Pictures/1000000000000078000000780827E7DB.png" style="width:40px;height:auto;max-width:none" /> | Scramble | Squiggle's alt: the offset circle reverses each revolution, scribbling instead of corkscrewing. |
| <img src="Pictures/1000000000000078000000788D7FC54B.png" style="width:40px;height:auto;max-width:none" /> | Shake | Jolts the whole image along a circular path on each beat onset - still between hits, alternating direction. |
| <img src="Pictures/1000000000000078000000782634C4BB.png" style="width:40px;height:auto;max-width:none" /> | Diffract | Displaces points sideways by an amount taken from their hue, so differently coloured strokes separate like a prism. |

Colour & Recolour (31)

|  |  |  |
|----|----|----|
| <img src="Pictures/100000000000007800000078411344C4.png" style="width:40px;height:auto;max-width:none" /> | Colorize Effect | Recolours the image with a single hue that sweeps over it, cycling on a speed slider. |
| <img src="Pictures/100000000000007800000078DD1B9DDE.png" style="width:40px;height:auto;max-width:none" /> | Colour Cycle Effect | Smoothly cycles the whole image through the colour spectrum over time, with a +White exclude option. |
| <img src="Pictures/100000000000007800000078420D53F6.png" style="width:40px;height:auto;max-width:none" /> | Hue Effect | Fades every colour toward one fixed hue and saturation; intensity blends, with an optional +White exclude. |
| <img src="Pictures/10000000000000780000007861460779.png" style="width:40px;height:auto;max-width:none" /> | Hue Shift | Rotates every colour's hue by a set angle (an RGB rotation about the grey axis); greys and white pass through. |
| <img src="Pictures/1000000000000078000000786CDF0529.png" style="width:40px;height:auto;max-width:none" /> | Shimmer A | Wobbles the whole image's hue sinusoidally around its original value, two wobbles per beat. |
| <img src="Pictures/10000000000000780000007836163EBE.png" style="width:40px;height:auto;max-width:none" /> | Shimmer B | The hue jumps to random offsets on strong audio events, scaled by the current level (music aware). |
| <img src="Pictures/100000000000007800000078F5D71ADF.png" style="width:40px;height:auto;max-width:none" /> | Colorize Acid A | A drifting acid-wash colour field from four crossfading, zooming plasma grids, mapped over the full hue wheel. |
| <img src="Pictures/10000000000000780000007809195215.png" style="width:40px;height:auto;max-width:none" /> | Colorize Acid B | Acid wash mapped through a black-primary-secondary-white ramp that permutes its channels once per bar. |
| <img src="Pictures/10000000000000780000007823E82EB1.png" style="width:40px;height:auto;max-width:none" /> | Colorize Aura A | A glowing aura colour wash - noise grids plus a radial centre glow, with a brightness floor so it never goes dark. |
| <img src="Pictures/1000000000000078000000785C3CB92A.png" style="width:40px;height:auto;max-width:none" /> | Colorize Aura B | Aura with a rotating channel permutation each bar and deeper, sub-white colours. |
| <img src="Pictures/1000000000000078000000782733B875.png" style="width:40px;height:auto;max-width:none" /> | Colorize Scroll A | Horizontal scrolling bands of hue sweep across the image at a fixed speed, keeping the original brightness. |
| <img src="Pictures/1000000000000078000000786B7F1B40.png" style="width:40px;height:auto;max-width:none" /> | Colorize Scroll B | Vertical hue bands whose scroll speed rides the bass, with the band curve warped by it. |
| <img src="Pictures/100000000000007800000078AF0784F7.png" style="width:40px;height:auto;max-width:none" /> | Colorize Scroll C | Horizontal S-curved hue bands with a saturation dip and hue drift driven by the treble. |
| <img src="Pictures/10000000000000780000007850A8C2DF.png" style="width:40px;height:auto;max-width:none" /> | Colorize Panel | A 5x5 grid of hue panels flood-fills to new colours with hard edges, drops fired by bass onsets. |
| <img src="Pictures/10000000000000780000007815785390.png" style="width:40px;height:auto;max-width:none" /> | Colorize Crumble | A 12x12 bilinear-smoothed hue grid crumbling to new colours, free-running. |
| <img src="Pictures/1000000000000078000000789E1CBEC7.png" style="width:40px;height:auto;max-width:none" /> | Colorize Rainbeam | Broad curved rainbow bands radiate from an orbiting far-off centre; the hue scrolls and troughs flash white. |
| <img src="Pictures/100000000000007800000078F6141D2F.png" style="width:40px;height:auto;max-width:none" /> | Colorize Flames | Audio-reactive fire recolour - a rippling flame edge licks up from the bottom; bass raises it, beats flare. |
| <img src="Pictures/100000000000007800000078139C2565.png" style="width:40px;height:auto;max-width:none" /> | Color Prism | Colours each segment by its direction: angle picks the hue, beam speed picks saturation. A stained-glass look. |
| <img src="Pictures/1000000000000078000000788119FC21.png" style="width:40px;height:auto;max-width:none" /> | Color Beat Prism | Prism colouring that rides the audio onset envelope, fading back to the original colours between beats. |
| <img src="Pictures/10000000000000780000007838C2186B.png" style="width:40px;height:auto;max-width:none" /> | Color Blobs A | 48 soft colour blobs drift outward on a polar plane while the whole palette slowly rotates the hue wheel. |
| <img src="Pictures/10000000000000780000007848F20F7A.png" style="width:40px;height:auto;max-width:none" /> | Color Blobs B | Harder-edged blobs at 4x drift speed with a constant red floor. |
| <img src="Pictures/100000000000007800000078BAFE72C7.png" style="width:40px;height:auto;max-width:none" /> | Color Blobs C | Double-size blobs over three channels, colourised through the tempo/beat palette (music aware). |
| <img src="Pictures/100000000000007800000078AA837099.png" style="width:40px;height:auto;max-width:none" /> | Color Volt A | Electric recolour through a black-\>primary-\>secondary-\>white ramp keyed to each point's original hue sector. |
| <img src="Pictures/1000000000000078000000785577AB9B.png" style="width:40px;height:auto;max-width:none" /> | Color Volt B | Hue sweeps with brightness, pushed further up the spectrum by the bass level (music aware). |
| <img src="Pictures/100000000000007800000078C75C9704.png" style="width:40px;height:auto;max-width:none" /> | Color Shiny A | Concentric white specular shine bands sweep in from the corners, breathing with the bass level. |
| <img src="Pictures/100000000000007800000078935C7F46.png" style="width:40px;height:auto;max-width:none" /> | Color Shiny B | Shine bands run from the centre outward on volume, darkening between bands with a colour sparkle. |
| <img src="Pictures/100000000000007800000078FF9BD82D.png" style="width:40px;height:auto;max-width:none" /> | Color Freq A | Colours the image like a spectrum analyser from the live FFT - below the level green, above red, on it white. |
| <img src="Pictures/100000000000007800000078A0C28744.png" style="width:40px;height:auto;max-width:none" /> | Color Freq B | Spectrum colouring mirrored around centre from bass/mid/high meters, slowly rotating the hue. |
| <img src="Pictures/100000000000007800000078B9594A52.png" style="width:40px;height:auto;max-width:none" /> | Color Freq C | Spectrum-analyser colouring like A/B, but the meter is recoloured through the tempo/beat palette. |
| <img src="Pictures/1000000000000078000000788247D910.png" style="width:40px;height:auto;max-width:none" /> | Color Beat Saturate A | Colour purity pumps with the music - colours over-saturate on hits. |
| <img src="Pictures/100000000000007800000078A14935A1.png" style="width:40px;height:auto;max-width:none" /> | Color Beat Saturate B | Inverted and snappier - colours wash toward white on hits. |

Beat, Texture & Flash (11)

|  |  |  |
|----|----|----|
| <img src="Pictures/10000000000000780000007839732987.png" style="width:40px;height:auto;max-width:none" /> | Beat Ring | Each beat radiates outward as an expanding ring of brightness, mixing the tap tempo with live audio onsets. |
| <img src="Pictures/10000000000000780000007869628BF3.png" style="width:40px;height:auto;max-width:none" /> | Cross A | A rotating cross orbits over the image, whitening everything inside its arms and fading the rest toward black. |
| <img src="Pictures/100000000000007800000078A2DE20D7.png" style="width:40px;height:auto;max-width:none" /> | Cross B | Draws only the white outline band of the orbiting cross, its centre breathing in and out on the bass. |
| <img src="Pictures/100000000000007800000078B2CF7242.png" style="width:40px;height:auto;max-width:none" /> | Stripe | Uses the same orbiting, rotating frame as Cross but paints three red / green / blue colour bands across it. |
| <img src="Pictures/10000000000000780000007887A25D60.png" style="width:40px;height:auto;max-width:none" /> | Dots | Chops the beam into regular on/off dots, blanking the gaps so it burns points instead of streaks. |
| <img src="Pictures/1000000000000078000000783B86AA2C.png" style="width:40px;height:auto;max-width:none" /> | Dashes | Randomised chop lengths give irregular dashes. |
| <img src="Pictures/100000000000007800000078C60DE078.png" style="width:40px;height:auto;max-width:none" /> | Dots Bright | Dot chop where the gaps get a 180-degree hue flip instead of being blanked. |
| <img src="Pictures/1000000000000078000000789FF480C1.png" style="width:40px;height:auto;max-width:none" /> | Dashes Bright | Randomised dash chop with the hue-flip gaps. |
| <img src="Pictures/100000000000007800000078BD6D327C.png" style="width:40px;height:auto;max-width:none" /> | Flash Effect | Flashes the whole image bright then decays on each beat - a tempo-synced brightness pulse. |
| <img src="Pictures/100000000000007800000078F7B3C8FE.png" style="width:40px;height:auto;max-width:none" /> | Strobe Effect | Blanks the image on and off in time with the tempo; intensity sets the blackout depth. |
| <img src="Pictures/1000000000000078000000785982DB11.png" style="width:40px;height:auto;max-width:none" /> | Vignette | Fades brightness toward all four edges so the frame darkens to black at the borders. |

More effects will be added with each firmware release for the Ultra MK2
/ Evo product range, allowing for more varied live projection
modifications.

#### <span id="anchor-110"></span>Master Effect slider

The intensity applied to the projection from any of the available
effects are controlled by a master intensity slider. This is set to 100%
by default, and can be changed via the menu UI or MIDI mapped to a
dial/fader. With this slider at 0% then none of the effects will be
applied to the projection.

Note: The default MIDI mapping provided with the factory SD card for an
APC40 MK2 has the main effect intensity slider mapped to the APC40 MK2
Master fader, and must be moved to a value \>0% for any effects to be
applied,

#### <span id="anchor-111"></span>Effect Config drop down

In order adjust one of the many built-in effects, the user can use the
effect config drop down followed by selecting the effect you wish to
adjust.

{{< img src="Pictures/10000000000000F000000140DE9DD66E.bmp" formats="webp jpeg" >}}

### <span id="anchor-112"></span>Colour Cycle effect

This effect will cycle through a series of primary colours to the
current beat or multiple of the beat based on the current tempo and
effect speed setting (tempo can be set via settings→tempo menu).

The colour sequence is currently fixed to the following:

<img src="Pictures/100000010000014400000112FAB7EC74.png" style="width:107px;height:auto" />Blue → Green → Cyan → Red →
Magenta → Yellow

<img src="Pictures/1000000100000145000001100760404E.png" style="width:107px;height:auto" /><img src="Pictures/100000010000014100000112F6AB42AE.png" style="width:107px;height:auto" /><img src="Pictures/100000010000014400000105727FD791.png" style="width:107px;height:auto" /><img src="Pictures/100000010000014500000114D89F73DA.png" style="width:107px;height:auto" /><img src="Pictures/1000000100000143000001112C285928.png" style="width:107px;height:auto" />The above images show the colour
cycle effect colours when +White parameter is OFF.

#### <span id="anchor-113"></span>Colour cycle effect parameters

<div class="row g-3 align-items-start">
  <div class="col">
    {{< img src="Pictures/10000000000000F000000140F87AA280.bmp" formats="webp jpeg" >}}
  </div>
  <div class="col">
    {{< img src="Pictures/10000000000000F00000014086551E1B.bmp" formats="webp jpeg" >}}
  </div>
  <div class="col">
    {{< img src="Pictures/10000000000000F000000140AC8DCE4C.bmp" formats="webp jpeg" >}}
  </div>
</div>

The adjustable parameters for the colour cycle effect are Intensity,
Speed, and Include White (+white).

Intensity parameter is used to select how much of the original CUE
colour is modified by this effect. e.g. 50% intensity will equally mix
the original CUE colour with the cycle effect colour, and 100% will
completely replace the original CUE colours with the colour from this
effect.

These parameters can be MIDI mapped to a dial/fader when using an APC
MIDI device.

Speed parameter is used to control how often the colour cycle occurs.
With a speed of 1, the colour will change on every beat, and a speed of
2 will change on every other beat etc.

The “Force On” button is only present so it can be assigned to an APC
MIDI button in order to live trigger the effect, overriding the
intensity slider. Pressing an APC button mapped to this button will
cause the intensity to be briefly set to 100% while the button is held
down.

The +White parameter is used to control whether any parts of the
currently projected CUE which contains full white will be overridden by
the cycle colour.

The +White parameter is useful when using fan beam patterns as shown
below.

<div class="row g-3 align-items-start">
  <div class="col">
    {{< img src="Pictures/1000000100000145000001035A2DF249.png" formats="webp jpeg" >}}
  </div>
  <div class="col">
    {{< img src="Pictures/10000001000001440000010303DD7723.png" formats="webp jpeg" >}}
  </div>
</div>

With +White off, only non white parts of the beam pattern will be
replaced by the cycle effect colour. With +White On, the whole beam
pattern will be re-coloured.

#### <span id="anchor-114"></span>Default APC40 MK2 Colour Cycle Effect MIDI mapping

The image below shows how this effect is mapped to an APC40 MK2 when
using our default MIDI mapping provided on the SD card shipped with the
laser cube.

<img src="Pictures/10000000000003FC0000027EAE4B5252.png" style="width:643px;height:auto" />

### <span id="anchor-115"></span>Zoom Effect

This effect will zoom the projection in/out in sync with the beat based
on the current tempo (see <a href="#anchor-79">tempo</a> in
the wiki).

#### <span id="anchor-116"></span>Zoom effect parameters

The zoom effect has several parameters that can be adjusted by the user,
including intensity, speed, and zoom type.

The intensity slider adjusts how much of the zoom in/out effect is
applied to the current projection between 0% and 100%.

The Speed slider allows the rate of zoom in/out to be adjusted. This
parameter is based on the current tempo, and can be adjusted between
fractions of the current beat to multiples of the beat.

The Linear parameter changes whether the zoom in/out is done in a linear
fashion or a logarithmic one.

The “Force On” button is intended to be MIDI mapped to an APC button for
live activation of the effect. When this button is activated, the
intensity slider is briefly changed to 100% while the button is held
down, and then returns to its previous value once released.

#### <span id="anchor-117"></span>Default APC40 MK2 Zoom Effect MIDI mapping

The image below shows how this effect is mapped to an APC40 MK2 when
using our default MIDI mapping provided on the SD card shipped with the
MK2.

<img src="Pictures/100000000000047F000002CAE2A1C79A.png" style="width:643px;height:auto" />

### <span id="anchor-118"></span>Hue Effect

This effect will re-colour the current projection to a user selected
colour based on the hue, saturation, and intensity parameter
adjustments.

#### <span id="anchor-119"></span>Hue effect parameters

The images below show the available user parameters for the hue effect.

<div class="row g-3 align-items-start">
  <div class="col">
    {{< img src="Pictures/10000000000000F000000140D95EEE7D.bmp" formats="webp jpeg" >}}
  </div>
  <div class="col">
    {{< img src="Pictures/10000000000000F00000014096A56829.bmp" formats="webp jpeg" >}}
  </div>
  <div class="col">
    {{< img src="Pictures/10000000000000F000000140322236BB.bmp" formats="webp jpeg" >}}
  </div>
</div>

The “+White” works the same as described in the Colour cycle effect
documented previously, and determines whether white portions of the
projection will include the colour override or not.

The intensity slider determines how much of the selected hue colour will
be applied to the projection.

The saturation slider will set how vivid the colour will be, so a low
saturation level will result in pastel colours, and a high saturation
will give the most vivid colours.

The hue slider allows a colour to be selected within the hue range of 0
to 360 degrees as shown in the image below.

<img src="Pictures/10000001000001410000002F68B1AB08.png" style="width:415px;height:auto" />

The “Force On” button is intended to be MIDI mapped to an APC button for
live activation of the effect. When this button is activated, the
intensity slider is briefly changed to 100% while the button is held
down (fully activating the hue effect), and then returns to its previous
value once released.

Note: Any effect parameters adjusted via the MK2 LCD menu UI will be
preserved through a power cycle, but any adjustments made via a
connected APC MIDI device will not. If an APC40 Mk2 is attached to the
MK2 then any dials assigned to an effect or other device setting will
indicate the current power on value using the associated APC LED ring.
Absolute faders will always override any effect slider value set in the
menu UI, since Faders have a finite start and end position.

#### <span id="anchor-120"></span>Default APC40 MK2 Hue Effect MIDI mapping

The image below shows how the hue effect is mapped to an APC40 MK2 when
using our default MIDI mapping provided on the SD card shipped with the
MK2.

<img src="Pictures/100000000000047F000002CAB3C2811B.png" style="width:643px;height:auto" />

### <span id="anchor-121"></span>Colourize Effect

This effect will apply a rotating colour hue on the projection.

<img src="Pictures/10000001000001440000012D467B9A06.png" style="width:221px;height:auto" />The left image is without the
effect applied, and the right with the effect applied.

{{< img src="Pictures/100000010000013E00000129B46BE63F.png" formats="webp jpeg" >}}

#### <span id="anchor-122"></span>Colourize effect parameters

<div class="row g-3 align-items-start">
  <div class="col">
    {{< img src="Pictures/10000000000000F000000140ECC676EF.bmp" formats="webp jpeg" >}}
  </div>
  <div class="col">
    {{< img src="Pictures/10000000000000F000000140EB88E597.bmp" formats="webp jpeg" >}}
  </div>
  <div class="col">
    {{< img src="Pictures/10000000000000F0000001404888522A.bmp" formats="webp jpeg" >}}
  </div>
</div>

The intensity parameter determines how much of the colour effect will be
applied to the projection between 0% and 100%.

The speed parameter changes the rate at which the colour moves, and is
not related to the current tempo setting.

The “Force On” button is intended to be MIDI mapped to an APC button for
live activation of the effect. When this button is activated, the
intensity slider is briefly changed to 100% while the button is held
down (fully activating the colourize effect), and then returns to its
previous value once released.

#### <span id="anchor-123"></span>Default APC40 MK2 Colourize Effect MIDI mapping

The image below shows how the colourize effect is mapped to an APC40 MK2
when using our default MIDI mapping provided on the SD card shipped with
the MK2.

<img src="Pictures/100000000000047F000002CA77306356.png" style="width:643px;height:auto" />

### <span id="anchor-124"></span>Flash Effect

The flash effect will fade the current projection in/out to the beat or
multiple of the current beat, based on the current tempo.

#### <span id="anchor-125"></span>Flash effect parameters

<div class="row g-3 align-items-start">
  <div class="col">
    {{< img src="Pictures/10000000000000F000000140F8533FB0.bmp" formats="webp jpeg" >}}
  </div>
  <div class="col">
    {{< img src="Pictures/10000000000000F0000001404AE7D36B.bmp" formats="webp jpeg" >}}
  </div>
</div>

The intensity parameter determines how much of the projection will have
the flash fade applied, and is between 0% and 100%.

The speed parameter changes the rate at which the projection is faded
in/out, and is linked to the current tempo, and synced to the beat.

The “Force On” button is intended to be MIDI mapped to an APC button for
live activation of the effect. When this button is activated, the
intensity slider is briefly changed to 100% while the button is held
down (fully activating the flash effect), and then returns to its
previous value once released.

#### <span id="anchor-126"></span>Default APC40 MK2 Flash Effect MIDI mapping

The image below shows how the flash effect is mapped to an APC40 MK2
when using our default MIDI mapping provided on the SD card shipped with
the MK2.

<img src="Pictures/100000000000047F000002CA08A94F85.png" style="width:643px;height:auto" />

### <span id="anchor-127"></span>Strobe Effect

The strobe effect will strobe the current projection on/off to the beat,
fraction of the beat, or multiple of the current beat, based on the
current tempo (see wiki for <a href="#anchor-79">tempo</a>
menu).

#### <span id="anchor-128"></span>Strobe effect parameters

<div class="row g-3 align-items-start">
  <div class="col">
    {{< img src="Pictures/10000000000000F000000140F8533FB0.bmp" formats="webp jpeg" >}}
  </div>
  <div class="col">
    {{< img src="Pictures/10000000000000F00000014060CC21E1.bmp" formats="webp jpeg" >}}
  </div>
</div>

The intensity parameter determines the amount the projection will have
the strobe applied, and is between 0% and 100%.

The speed parameter changes the rate at which the projection is strobed,
and is linked to the current tempo, and synced to the beat.

The “Force On” button is intended to be MIDI mapped to an APC button for
live activation of the effect. When this button is activated, the
intensity slider is briefly changed to 100% while the button is held
down (fully activating the strobe effect), and then returns to its
previous value once released.

#### <span id="anchor-129"></span>Default APC40 MK2 Strobe Effect MIDI mapping

The image below shows how the strobe effect is mapped to an APC40 MK2
when using our default MIDI mapping provided on the SD card shipped with
the MK2.

<img src="Pictures/100000000000047F000002CAD9A69EAB.png" style="width:643px;height:auto" />

# <span id="anchor-130"></span>Status Info Page

The Status Information menu provides info about the current
hardware/network status. It is useful when info like SD card free status
or buffering status need to be checked by the user.

<div class="row g-3 align-items-start">
  <div class="col">
    {{< img src="Pictures/10000000000000F00000014099840464.bmp" formats="webp jpeg" >}}
  </div>
  <div class="col">
    {{< img src="Pictures/10000000000000F000000140339221B3.bmp" formats="webp jpeg" >}}
  </div>
  <div class="col">
    {{< img src="Pictures/10000000000000F000000140FAA77239.bmp" formats="webp jpeg" >}}
  </div>
</div>

<div class="row g-3 align-items-start">
  <div class="col">
    {{< img src="Pictures/10000000000000F00000014096C77EA5.png" formats="webp jpeg" >}}
  </div>
  <div class="col">
    {{< img src="Pictures/10000000000000F00000014087A2819E.png" formats="webp jpeg" >}}
  </div>
  <div class="col">
    {{< img src="Pictures/10000000000000F000000140312215D0.png" formats="webp jpeg" >}}
  </div>
</div>

<div class="row g-3 align-items-start">
  <div class="col">
    {{< img src="Pictures/10000000000000F000000140F908991A.png" formats="webp jpeg" >}}
  </div>
</div>

> **Battery:** The Battery gauge shows an estimation of battery state of
> charge, based on measuring its voltage. If projecting, the reading
> will move around under load, showing a slightly lower reading as the
> scan complexity / output power varies.

Whilst charging, the battery state of charge cannot be measured.

**Remote Slaves:** If using Cube Link, gives the number of connected
slave devices.

**Buffer Free:** displays the current buffer space available.

**Buffer Size:** displays the maximum buffer level.

**SD Card Capacity:** shows the reported capacity of the SD Card in
Gigabytes

**SD Card Free:** shows the remaining capacity of the SD Card in
Gigabytes

> **PKT RX Events:** shows the number of received packets. When in
> LaserOS Control Mode, this will increase rapidly as each packet of
> projection data is received.

> <span id="anchor-131"></span>Clicking on this entry will reset the
> count to zero.

> 

> <img src="Pictures/10000000000000F000000140A08DC84B.png"
> style="width:3.649cm;height:4.867cm" />
> <img src="Pictures/10000000000000F000000140E7CC16F7.png"
> style="width:3.634cm;height:4.845cm" />

> 

> <span id="anchor-132"></span>**DAC Empty Events:** displays the number
> of buffer under-run events.

> This can happen due to lost packets, disabling the interlock or
> selecting the test patterns. Clicking on this entry will reset the
> count to zero.

> 

> **DAC Full Events:** displays the number of buffer overflow events.

> Clicking on this entry will reset the count to zero.

> 

> **PKT Loss Events:** displays the number of lost packets. Lost UDP
> packets are common when using WiFi, especially in “congested” areas
> with many competing devices. Lost packets will be give the symptom of
> brief and intermittent drop-outs of the projection.

> Moving away from the WiFi congested area, or preferably using a wired
> Ethernet connection will minimize this. Clicking on this entry will
> reset the count to zero.

> 

> **MAC Address:** MAC Address, unique to each Ultra Mk2 / Evo laser
> cube.

> 

# <span id="anchor-133"></span>MIDI Mapping using an APC40 MK II or APC Mini MK II

The Ultra MK2 / Evo is capable of being controlled directly using an APC
40 MK2 or an APC mini MK2 (others will be added TBD.) connected to the
USB port on the rear of the unit.

In order for any MIDI mapping to be saved, an SD card must be inserted
with the correct path to the settings folder present on the card. The
MIDI mapping files saved to the card are located here:
***/Lasercube/settings***

Separate mapping files are saved for each MIDI device type, and also for
each control mode.

The MIDI mapping files are also saved in JSON file format which is human
readable text, so the user can also edit these files manually using a
text editor if required.

### <span id="anchor-134"></span>Enabling USB MIDI

In order to use any of these MIDI devices, the USB must be enabled by
going to the Settings -\>USB MIDI menu.

<div class="row g-3 align-items-start">
  <div class="col">
    {{< img src="Pictures/10000000000000F0000001407F27FF45.bmp" formats="webp jpeg" >}}
  </div>
  <div class="col">
    {{< img src="Pictures/10000000000000F000000140FB4F133A.bmp" formats="webp jpeg" >}}
  </div>
  <div class="col">
    {{< img src="Pictures/10000000000000F000000140A78D5750.bmp" formats="webp jpeg" >}}
  </div>
</div>

Note: USB MIDI does **NOT** operate when the unit is in LaserOS / ArtNet
/ DMX control modes, as these modes
ar<img src="Pictures/10000000000000F000000140A9A20B7D.bmp" style="width:151px;height:auto" />e controlled using alternate
communication protocols.

{{< img src="Pictures/10000000000000F0000001403852FCAE.bmp" formats="webp jpeg" >}}

If a compatible device is detected on the USB port then the status bar
will briefly show an updated connected status, and unplugging a device
will show the disconnected status as shown above. The status bar will
also show a green tick or a cross next to the MIDI label on the RHS of
the status bar.

### <span id="anchor-135"></span>MIDI Mapping a Slider Control

To map a slider in the menu to an APC dial or fader control, single
press on a slider to enter edit mode, then long press to bring up the
context menu, and then select “Link MIDI Knob” as shown below.

<div class="row g-3 align-items-start">
  <div class="col">
    {{< img src="Pictures/10000000000000F0000001400032D2C4.bmp" formats="webp jpeg" >}}
  </div>
  <div class="col">
    {{< img src="Pictures/10000000000000F00000014090228FA2.bmp" formats="webp jpeg" >}}
  </div>
  <div class="col">
    {{< img src="Pictures/10000000000000F000000140D6DB1305.bmp" formats="webp jpeg" >}}
  </div>
</div>

Once “Link MIDI knob” is selected, the device will wait for the user to
turn or move a control on the APC. Once a control is moved then the
associated MIDI channel and CC number will be captured.

If the MIDI channel and CC chosen by the user is already assigned to
another control then the MIDI info will be shown in orange instead of
green.

{{< img src="Pictures/10000000000000F0000001404281142B.bmp" formats="webp jpeg" >}}

If the user accepts this APC control while the MIDI status is orange,
the previous function will be un-mapped and re-assigned to the current
UI slider.

Almost all sliders in the laser cube’s menu UI can be assigned to an
external APC Dial or Fader.

Note: Faders on an APC40 are absolute controls and will always override
the slider value when moved, unlike APC dials which are relative
adjustment control with no physical end stops.

Once a slider from the laser cube’s menu UI has been assigned to an APC
control, the menu UI will update its slider to a yellow colour instead
of blue as shown in the image below. Any movement of the assigned APC
control will now also move the slider on the LCD menu UI.

If the slider was assigned to a dial on the APC40 MK2 then the LED ring
on the APC dial will also reflect the slider’s current value, and
editing the slider on the LCD menu UI will also update the APC’s led
ring as they are always kept in sync with each other.

{{< img src="Pictures/10000000000000F000000140501207D3.bmp" formats="webp jpeg" >}}

The image below shows how an APC dial will look once mapped to a UI
slider element.

<img src="Pictures/1000000000000300000004001B84800D.jpg" style="width:246px;height:auto" />

Note: When an APC dial is un-linked from a UI element, the LED ring will
go off.

### <span id="anchor-136"></span>Un-mapping a Slider Control

To remove a previous MIDI mapping from a slider in the menu UI, edit the
control by short press on the slider to enter edit mode, then long press
to bring up the context menu, then select “unlink MIDI Knob” option.

<div class="row g-3 align-items-start">
  <div class="col">
    {{< img src="Pictures/10000000000000F000000140567C66A0.bmp" formats="webp jpeg" >}}
  </div>
  <div class="col">
    {{< img src="Pictures/10000000000000F00000014081122E39.bmp" formats="webp jpeg" >}}
  </div>
  <div class="col">
    {{< img src="Pictures/10000000000000F0000001405B010FD2.bmp" formats="webp jpeg" >}}
  </div>
</div>

The images above show all the options available on the slider pop-up
context menu, including the un-link option. The “Default Val” button
will return the currently edited slider to its factory power-on default
value, and the “Exit” button closes the context menu without performing
any other actions.

Once the unlink option has been selected on the context menu, the
control will return back to a blue colour indicating that it is no
longer associated with any external MIDI control.

### <span id="anchor-137"></span>MIDI Mapping a Button Control or Switch

Buttons and Switch elements in the menu UI can also be mapped to an APC
button by highlighting the element in the LCD menu UI, and then long
pressing to activate the context menu. Once the context menu is
activated you can select the “Link MIDI note” option, then press a
control on the connected APC, and then assign a LED colour using the
colour drop down. Un-Linking is done by long pressing on a UI element
and selecting “Unlink” from the context menu.

MIDI mapped buttons / switches will also show in yellow on the LCD
instead of a blue colour.

The images below show the device in playlist control mode with it’s play
button MIDI mapped to an APC button. If the APC button selected has an
RGB LED associated with it then the button will
l<img src="Pictures/10000000000000F000000140E696B544.bmp" style="width:151px;height:auto" />ight up on the APC with the
colour selected from the colour dropdown.

<div class="row g-3 align-items-start">
  <div class="col">
    {{< img src="Pictures/10000000000000F000000140BD52F4E2.bmp" formats="webp jpeg" >}}
  </div>
  <div class="col">
    {{< img src="Pictures/10000000000000F00000014029E7DFBB.bmp" formats="webp jpeg" >}}
  </div>
  <div class="col">
    {{< img src="Pictures/10000000000000F00000014047BDCCAD.bmp" formats="webp jpeg" >}}
  </div>
</div>

### <span id="anchor-138"></span>MIDI Mapping a Drop Down control

Most of the drop down UI controls within the LCD menu UI can be linked
to a button on a connected APC MIDI controller. These include the
currently selected playlist drop down, and also the laser show drop down
when in laser show control mode.

To MIDI map a drop down you will firstly need to select an item from the
drop down that you wish to assign to an APC button, then long press on
the drop down in order to bring up the context menu.

Once the context menu is visible you will be able to assign the
currently selected item from the drop down to a button on the APC using
the “Link MIDI Note” button. Previously linked items can also be
un-linked using the same procedure of selecting the drop down item and
then long pressing to bring up the context menu, followed by selecting
the “UnLink MIDI Note” option.

With an APC40 or APC Mini connected, there are a total of 15 different
colours selectable during the MIDI mapping process.

Note: Some APC buttons do not contain an RGB LED, so consult the
relevant documentation for your APC device to determine which APC
buttons can have an RGB colour assigned. If an APC button only has a
single LED colour, then only select the first colour from the colour
drop down.

<div class="row g-3 align-items-start">
  <div class="col">
    {{< img src="Pictures/10000000000000F00000014017CC487F.bmp" formats="webp jpeg" >}}
  </div>
  <div class="col">
    {{< img src="Pictures/10000000000000F0000001401C17C152.bmp" formats="webp jpeg" >}}
  </div>
  <div class="col">
    {{< img src="Pictures/10000000000000F00000014023581B81.bmp" formats="webp jpeg" >}}
  </div>
</div>

<div class="row g-3 align-items-start">
  <div class="col">
    {{< img src="Pictures/10000000000000F000000140E696B544.bmp" formats="webp jpeg" >}}
  </div>
</div>

The drop down UI element will now be shown in yellow, indicating a
mapping to an APC button, and the APC button (top right) will change to
the selected colour (Magenta in this example).

<img src="Pictures/1000000000000400000003005306EF8D.jpg" style="width:328px;height:auto" />

### <span id="anchor-139"></span>Default APC40 MK2 MIDI mapping

The default MIDI mapping for an APC40 MK2 is shown below, and is
provided with the factory SD card image.

This mapping can be changed by the user if required using this guide.

Items in blue are relevant when in playlist control mode, and items in
red are part of the effects provided when in playlist or visualizer
control mode, and items in yellow are global device adjustments linked
to items within Settings→Projection→Image Setup.

<img src="Pictures/100000000000047F000002CAD2A81B96.png" style="width:698px;height:auto" />

> 

# <span id="anchor-140"></span>LaserCube Web Admin Page

The Laser cube has a legacy Web Admin Page for adjusting some of the
devices network based configuration settings, and also performing remote
firmware updates.

1\. Note the IP address from the bottom right corner of the LCD.

<img src="Pictures/10000001000002BC0000017337C5089F.png" style="width:489px;height:auto" />

2\. Open a web browser and type in that same IP address.

Log in using the following credentials:

User Name: **LaserCubeUser**

Password: **Laser2020**

The Web Admin Page has 3 Menu sections:

- [**H**](#_y7yarf9ho2l)**ome Menu**, showing general info.
- **Config Menu**, for Network and mode settings.
- **Update Menu**[, for performing remote firmware
  update](#_sortqr24vwrb)s.

## <span id="anchor-141"></span>Home Menu

The Home Menu shows the Model Name, Interlock type, firmware version and
Firmware Active Partition. There are 2 partitions to allow fall back to
a good working state should an update fail or be interrupted.

<img src="Pictures/10000000000003620000036DD608080D.jpg" style="width:452px;height:auto" />

## <span id="anchor-142"></span><span id="anchor-143"></span>Config Menu

The Config Menu has 3 tabs, for network set-up and mode selection:

- **WiFi Tab**, for Wireless ConnectionSettings
- **LAN Tab**, for Wired Connection Settings
- **General Tab**, for Connection Mode Selection

### <span id="anchor-144"></span><span id="anchor-145"></span>WiFi Tab

<img src="Pictures/10000000000003400000035CF6EE9CD3.jpg" style="width:498px;height:auto" />

Where WiFi interference is present, the LaserCubeWiFi channel can be
changed.

The IP address and Subnet can be set for when the LaserCube is operating
in WiFi Server mode, where it provides a DHCP service.

The WiFi Server mode default SSID and Password can also be changed.

If connecting to a router in WiFi Client mode, the SSID and WiFi
password can be entered directly. This is useful if the router does not
support WPS.

### <span id="anchor-146"></span><span id="anchor-147"></span>LAN Tab

<img src="Pictures/10000000000003500000020A32B4D081.jpg" style="width:527px;height:auto" />

The IP address and subnet can be set for when the LaserCube is operating
in LAN Server mode, where it provides a DHCP service. LAN Client (with
APIPA is preferred though.)

### <span id="anchor-148"></span><span id="anchor-149"></span>General Tab

<img src="Pictures/1000000000000345000001D9BEE39301.jpg" style="width:571px;height:auto" />

The network operating mode can be set from the drop down tab.

The LaserCube will reboot after changing the mode.

## <span id="anchor-150"></span>Firmware Update

1\. Via SD Card. This is the preferred update method. If the SD Card has
a more recent firmware on it, you will be prompted to allow a firmware
update.

2\. Via LaserOS. If LaserOS detects a more recent version of firmware is
available, it will prompt to allow a firmware upgrade.

3\. Manually:

Visit **https://github.com/Wickedlasers/mk2SDContent** to obtain the
most recent OTA update binary from the **Lasercube/Firmware** folder.

Connect to the LaserCube in WiFi Server mode, as described in [Initial
Setup](#_418t1fsev28h).

Browse to 192.168.4.1 and log in using the following credentials:

User Name: **LaserCubeUser**

Password: **Laser2020**

Go to the Update Tab. Click Choose File and select the update binary.

Click Upload.

Wait for the update to complete and the LaserCube reboot.

<img src="Pictures/1000000000000340000001B1F4A671DB.jpg" style="width:467px;height:auto" />

# <span id="anchor-151"></span>Factory Reset Procedure

If you need to reset the laser cube back to its factory firmware
defaults, you can perform the factory reset as shown below. This should
only be done if absolutely necessary.

<img src="Pictures/10000001000001AA000002126D77E36C.png" style="width:290px;height:auto" />

To Factory reset the device, firstly ensure the unit is powered OFF.

Hold the rotary encoder button down (1) and then while continuing to
hold the rotary encoder down, power on the unit using the power switch
(2). Keep holding the encoder down for at least 8 seconds and then
release the encoder button.

The unit will return to its factory firmware version and all settings
will also return to their defaults.

If an SD card is inserted and contains firmware that is newer than the
factory version, the unit will offer to immediately update to the latest
version. This should be done to ensure the latest firmware is running in
your device.

# <span id="anchor-152"></span>SD Card Information

The Ultra MK2 / Evo laser cube is supplied with a pre-loaded micro SD
card containing all demo laser shows, Playlists, and MIDI mappings for
APC40 MK2 and APC mini MK2.

If you need additional SD cards then these can be obtained from places
like Amazon.

The card which we have tested and guarantee to work with the device is
the Lexar A2 Silver Plus 64Gb micro SD card
(<https://americas.lexar.com/product/lexar-professional-silver-plus-microsdxc-uhs-i-card/>).

The laser cube supports this range of cards up to 2Tb.

Note: Please make sure you do not purchase inferior / cheaper micro SD
cards, as these could fail to correctly stream the laser shows which
require low latency and high throughput in order to stream simultaneous
audio and projection data.

The micro SD cards usually come pre-formatted in the Ex-FAT filesystem
format, and this is the preferred format in order to take advantage of
\>32Gb space compared to FAT32.

If you need to format a card manually then please use Ex-FAT with
default settings offered by your operating system.

If you need to obtain the most up to date files that are provided on the
factory micro SD card then these are available from here:
<https://github.com/Wickedlasers/mk2SDContent>

<img src="Pictures/1000000100000449000002EE84CC2053.png" style="width:482px;height:auto" />

You will need to unzip the downloaded file before copying the
“Lasercube” folder into the root of your new micro SD card. If you are
using a card with the “Lasercube” folder already present then you can
either rename the old folder, or delete the folder before copying the
new folder you just downloaded. If you delete the folder then you will
**lose any custom playlists or MIDI mappings**.

Note: Please also rename the SD card volume name to “WL” without the
quotes in order for LaserOS to see it when exporting custom playlists to
the SD card.