8.53 Command screen orientation +CSO

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

Tools: ARFCN - Frequency Conversion for 5G NR/LTE/UMTS/GSM

Table 8.53-1: +CSO parameter command syntax

Command	Possible response(s)
+CSO=<orientation>[,<CurrentTopSide>]	+CME ERROR: <err>
+CSO?	+CSO: <orientation>[,<CurrentTopSide>] +CME ERROR: <err>
+CSO=?	+CSO: (list of supported <orientation>s) +CME ERROR: <err>

Description

This command is used to set or read back the orientation of the screen on the mobile equipment (ME). The ME may override the setting via a key press or touch screen action. In addition to setting portrait mode and landscape mode, the command is used by the TE to set a reference orientation for the screen on the ME. The physical orientation of the ME shall not override this command. If emulation fails with an ME error, +CME ERROR: <err> is returned. Refer clause 9.2 for possible <err> values.

Figure 8.53-1: Labelled ME sides when the ME is in the normal operating mode

This command should be accepted (OK returned) before actually performing the action.

Read command returns the current settings.

Test command returns the list of supported orientations for the mobile equipment as a compound value.

Defined values

<orientation>: integer type

0 Portrait. The device is in portrait mode.

1 Landscape. The device is in landscape mode.

2 Any. The top of the ME’s screen is identified by <CurrentTopSide> parameter, identifying a side of the screen of the ME.

<CurrentTopSide>: integer type, representing the label of the side that is the top of the screen. The default value is manufacturer specific.

0 Top. The ME is in the normal operating mode (see figure 8.53-1).

1 Right side. The side labelled right side is the side that is the top of the screen.

2 Bottom. The side labelled bottom is the side that is the top of the screen.

3 Left side. The side labelled left side is the side that is the top of the screen.

Examples:

Table 8.53-2: Examples of syntax for various actions

Action	Syntax	Description
Get Orientation	AT+CSO?	This will return the current orientation of the screen device.
Set Orientation	AT+CSO=0	This will set the current orientation of the screen device to portrait.
Set Orientation	AT+CSO=2,3	The right side is the current top side (e.g. the top can be determined relative to gravitational forces) and identifies the TE’s reference orientation for the screen on the device.

Implementation

Optional.