# Touchscreen

{% hint style="success" %}
**📅Update: 2020/05/17**
{% endhint %}

Rotrics 3.5-inch touchscreen can control robot arm motion and module functions. You can also download G-code files into SD card, and use touchscreen to control offline.&#x20;

## User Interface

### Homepage

<div align="left"><img src="https://2132465959-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LtPFIBncU5l4J8tl5Yh%2F-Ly8eIJMHZlZSIVSklp9%2F-LyCOzx1XG33nrWxzA3c%2F%E9%A6%96%E9%A1%B5.png?alt=media&#x26;token=d6912680-3374-4b28-9913-e3e5a609c2fa" alt=""></div>

**Wi-Fi Connection**

Wi-Fi connection status icon, press to check Wi-Fi connection status,

**Return**

The return button, press to return to the previous menu,

**HOME**

The homepage button, press to return to homepage,&#x20;

**Emergency Stop**&#x20;

The emergency stop botton, press to stop robot arm, use only in emergencies,

**Basic**

The basic control interface, to control robot arm movement in X, Y, Z axis, or reset robot arm to origin position,&#x20;

**Laser**

The laser control interface, to control robot arm movement in X, Y, Z axis and power on/off laser, mainly used for adjusting laser focus length,&#x20;

**Draw**

The drawing interface, to select built-in stick figure to draw. It is mainly used to teach children.

**3D Printing**

The 3D printing control interface, to change filaments,

**Air Pick**

The air pump box control interface, to control action of suction cup and softgripper,

**Voice**

The voice recognition function interface, press to start recognize your voice,

**Teach\&Play**

The teaching-playback function interface, to teach robot arm to record and repeat your movement,&#x20;

**SD Card**

The SD card management interface, to choose relevant G-code file and start writing/drawing, laser engraving, 3D printing or picking/placing offline,

**Setting**&#x20;

The setting interface, to choose language, set leveling, adjust pen height, or reset the touchscreen.

### Basic Control

<div align="left"><img src="https://2132465959-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LtPFIBncU5l4J8tl5Yh%2F-M5_wyp3cA9Lpbm6mtfX%2F-M5a8Si1Nr4sjdVTVSYL%2Fimage.png?alt=media&#x26;token=eb119349-375c-4d79-885c-19a0dbe8241d" alt=""></div>

**X±/Y±/Z±**

Control the movement in X, Y, Z axis, click to control movement in relevant direction,

**Home**

Working HOME position button, click to return robot arm to the HOME position,

**Reset**

Robot Arm calibration button, click to re-calibrate the robot arm.

**Motor Disable**

Motor disable button, click to disable the motor, drag the robot arm to the corresponding position.&#x20;

### Laser

<div align="left"><img src="https://2132465959-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LtPFIBncU5l4J8tl5Yh%2F-LyCUvqucmIcDreM6Bmb%2F-LyCWS-Cdv8u4c8z2AHw%2Fimage.png?alt=media&#x26;token=ab12f20b-7ddb-427a-b66c-0df0a6cf65e0" alt=""></div>

Laser ON/OFF

Laser on/off button, click to turn on or turn off the laser. The default setting is to turn on/off laser under the max power. **Wear the Safety Goggles before you set up the laser engraver and throughout the laser engraving process.**

### Draw

<div align="left"><img src="https://2132465959-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LtPFIBncU5l4J8tl5Yh%2F-LyCUvqucmIcDreM6Bmb%2F-LyCXZeBkQ1ID0x5jhKL%2Fimage.png?alt=media&#x26;token=216e9a59-9f98-421a-93b6-baa41a487d43" alt=""></div>

<div align="left"><img src="https://2132465959-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LtPFIBncU5l4J8tl5Yh%2F-LyCUvqucmIcDreM6Bmb%2F-LyCY1x0VSaeQELkviW1%2Fimage.png?alt=media&#x26;token=dc65db9e-02b9-482a-a5f6-fdf9fe026ba7" alt=""></div>

Click the left and right triangle buttons to switch pictures, click "Choose" to select the relevant picture.

**Start / Pause / Stop**

Click the corresponding button to start, pause, stop the current working.

### 3D Printing

<div align="left"><img src="https://2132465959-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LtPFIBncU5l4J8tl5Yh%2F-LyCYCx7j-vLyzyJ-Mhq%2F-LyCYhXy5Z8Nw6_8mOL_%2Fimage.png?alt=media&#x26;token=09c26666-2386-4335-9307-91f0d4215b91" alt=""></div>

**Target Temp**

Target temperature of 3D printing nozzle,

**Current Temp**

Current temperature of 3D pinting nozzle,&#x20;

**Change PLA**

PLA filament change button, click to preheat nozzle to 200℃, after temperature reaches 200℃, you can change the filament,

**Change ABS**

ABS filament change button, click to preheat nozzle to 240℃, after temperature reaches 240℃, you can change the filament,

### Picking/Placing

<div align="left"><img src="https://2132465959-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LtPFIBncU5l4J8tl5Yh%2F-LyCYCx7j-vLyzyJ-Mhq%2F-LyC_1hxtt3yVmj_sZBE%2Fimage.png?alt=media&#x26;token=2c19d619-5a58-40d2-9a39-9d8169626c4d" alt=""></div>

**Pick/Place**

Pick and place button, click to control suction cup or softgripper to pick/place items,

**Stop**&#x20;

Click to stop air pump box,

### Voice

<div align="left"><img src="https://2132465959-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LtPFIBncU5l4J8tl5Yh%2F-LyCbTlH1kc9lU25Yezu%2F-LyCbb0RO4BDzwz9Y3-z%2Fimage.png?alt=media&#x26;token=cd143cf2-dee3-4c2c-a2ba-9415f324777c" alt=""></div>

Voice recognition button, Wi-Fi connection required, support multi-language. Click to recognize voice content, and then command robot arm to complete relevant tasks. Currently, only the built-in picture drawing functions are available.&#x20;

### Teach\&Play

<div align="left"><img src="https://2132465959-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LtPFIBncU5l4J8tl5Yh%2F-LyCbTlH1kc9lU25Yezu%2F-LyCcDA3XbxoPjMcu0WK%2Fimage.png?alt=media&#x26;token=57469cdb-aaa8-4a20-9db9-e43840dd84be" alt=""></div>

### SD Card

<div align="left"><img src="https://2132465959-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LtPFIBncU5l4J8tl5Yh%2F-LyCdeD6zjbkG-eJT49T%2F-LyCeK_rqYfn3W1aKQUJ%2Fimage.png?alt=media&#x26;token=259cf9b5-38db-4c94-ac11-9fc2cf5f26cf" alt=""></div>

The G-code excution interface, click to choose relevant G-code and start working.

### Setting

<div align="left"><img src="https://2132465959-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LtPFIBncU5l4J8tl5Yh%2F-M5ZnveV8vdnKBc6LWPJ%2F-M5_6TLp5pBe_LYGfIih%2Fimage.png?alt=media&#x26;token=ac1b125e-7f66-44af-8f3a-95c54c7631d7" alt=""></div>

Setting interface of the touchscreen, click to adjust pen height, set 3D printing leveling, connect to Wi-Fi, change language, reset the touchscreen.

## Connect with DexArm

Use dual Type-C cable to connect robot arm and the touchscreen.

Click the following link to learn how to use touchscreen to adjust laser focal length, change 3D printing filament, leveling:

* adjust laser focal length
* 3D printing work origin position setting
* leveling
* 3D printing filament change
* control pneumatic module
* control teach\&play

## Control DexArm's Movement

1\. connect touchscreen to the robot arm

2\. Click `Basic`

3\. Click `Home`to move robot arm to HOME position

4\. Click X, Y, Z button to control robot arm movement.&#x20;

## Use SD card to work offline

1\. Copy the G-code file into SD card

2\. Set paremeters before run the G-code file

* For laser engraving, maker sure you have adjusted the focal length and set the origin position
* For writing/drawing, make sure you have set the start height value
* For 3D printing, make sure you have set the start height

3\. Click SD card

4\. Choose your G-code file

5\. Click `Start`to work offline

## Touchscreen Recalibration

Touchscreen recalibration is added in Touchscreen firmware V1.1.0 or above. Please confirm your touchscreen firmware version before recalibration.

Method 1: Touchscreen > Setting > Factory Reset > Touchscreen Recalibration&#x20;

Method 2： Add an empty file named "touchscreen\_recalibration.conf" to the directory: sdcard\firmware. If the Touchscreen reads this file during startup, it will enter the recalibration.

## SetWorkOrigin & SetWorkHeight Difference

For G-code generated by Rotrics Studio, the working start point is X0 Y300. So when 3D printing with the touchscreen, you need to set G92 Z0 E0 (Set WorkHeight).&#x20;

<div align="left"><img src="https://2132465959-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LtPFIBncU5l4J8tl5Yh%2F-MKhKqvZeXQfAfTT6cvH%2F-MKhsN4FrAPdpYdcyyQM%2Fimage%20(1).png?alt=media&#x26;token=f73bc509-4bd1-44d5-a5d2-9898b70787fb" alt=""></div>

For G-code generated by third-party software, like Cura, the working start point is X0 Y0. So when 3D printing with the touchscreen, you need to set G92 X0 Y0 Z0 E0 (Set WorkOrigin/ Set Origin).

<div align="left"><img src="https://2132465959-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LtPFIBncU5l4J8tl5Yh%2F-MKhKqvZeXQfAfTT6cvH%2F-MKhsCSEgM-JGF0QxIpE%2Fimage.png?alt=media&#x26;token=b2e3bb77-c29c-422f-8700-25ad64c38827" alt=""></div>

Note: if you set the working start point wrongly, the Arm movement will beyond limits, or when you click start to start printing, only the filament squeezes out, the Arm won't move.&#x20;
