8.52 Command touch screen action +CTSA

27.0073GPPAT command set for User Equipment (UE)Release 18TS

Table 8.52-1: +CTSA action command syntax

Command

Possible response(s)

+CTSA=<action>,<x>,<y>,<id>[,<duration>]

+CME ERROR: <err>

+CTSA=?

+CTSA: (list of supported <action>s)

Description:

This command is used to emulate a touch screen action on the mobile equipment (ME). If emulation fails with an ME error, +CME ERROR: <err> is returned. Refer clause 9.2 for possible <err> values.

This command should be accepted (OK returned) before actually emulating the touch screen action.

Test command returns the list of supported actions for the mobile equipment.

The top left corner of the touch screen is defined as the 0, 0 point, see figure 8.52-1. This coordinate does not change regardless of the display mode (portrait or landscape). All coordinate values are non-negative integers.

Figure 8.52-1: ME screen outline

Defined values

<action>: integer type

0 Release. Emulates the user releasing the touch screen at the <x>, <y> coordinates.

1 Depress. Emulates the user depressing the touch screen at location <x>, <y>.

NOTE 1: Consecutive Depress actions will emulate dragging a stylus on the touch device to the new location.

2 Single Tap. Emulates the user performing a single tap action at the <x>, <y> location. The timing required to emulate a single tap shall be handled by the mobile equipment.

3 Double Tap. Emulates the user performing a double tap action at the <x>, <y> location. The timing required to emulate a double tap shall be handled by the mobile equipment.

<x>: integer type. The horizontal x coordinate location of the action performed on the touch screen.

<y>: integer type. The vertical y coordinate location of the action performed on the touch screen.

<id>: integer type. A positive integer value. If id is a non-zero integer value N, then it represents, or correlates with, the Nth simultaneous touch action performed on the touch screen. If id is 0 then the touch screen action is an initial touch screen action or the touch screen action is correlated with the initial touch action.

NOTE 2: The number of possible simultaneous touch actions is implementation specific.

<duration>: integer type (the value range is in milliseconds from 1 to 65535). Emulates the user releasing the touch screen at the <x>, <y> coordinates after duration milliseconds. If the value is set to 0, then a duration is not indicated.

Examples:

Table 8.52-2: Examples of syntax for various user actions

User Action

Syntax

Description

Depress

AT+CTSA=1,25,45

This will emulate a user pressing down on the ME touch screen at the 25, 45 coordinates.

Release

AT+CTSA=0,25,45

This will emulate a user releasing the touch screen at the 25, 45 coordinates.

Single Tap

AT+CTSA=2,25,45

This will emulate a user single tapping the touch screen at the 25, 45 coordinates.

Double Tap

AT+CTSA=3,25,45

This will emulate a user double tapping the touch screen at the 25, 45 coordinates.

Drag

AT+CTSA=1,10,10;

+CTSA=0,50,50

This will emulate a user touching at 10,10, dragging to 50,50, and releasing.

Draw

AT+CTSA=1,10,10;

+CTSA=1,50,50;

+CTSA=0,100,100

This will emulate a user touching at 10,10, then dragging to 50,50, then dragging to 100,100 and finally releasing the touch screen at 100,100.

Multi Touch

AT+CTSA=1,10,10,0;

+CTSA=1,50,50,1;

+CTSA=0,60,60,1;

+CTSA=0,100,100,0

This will emulate a user initiating a first gesture touching at 10,10, then simultaneously initiating a second gesture at 50,50, then dragging the second gesture from 50, 50 to 60,60. The user releases the second gesture at 60. 60 while simultaneously dragging the first gesture from 10,10 to 100,100 and finally releasing the touch screen at 100,100.

Long Depress

AT+CTSA=1,10,10,0;

+CTSA=0,10,10,0,3000

This will emulate a user touching at coordinates 10,10, and releasing the touch screen at coordinates 10, 10, after 3 seconds.

Implementation

Optional.