U10 Camera AT Commands Manual - Quectel Wireless Solutions · WCDMA Module U10 Camera AT Command...

U10 Camera

AT Commands Manual

WCDMA Module Series

Rev. U10_Camera_AT_Commands_Manual_V1.1

Date: 2013-03-14

www.quectel.com

http://www.quectel.com/

WCDMA Module U10 Camera AT Commands Manual

U10_Camera_AT_Commands_Manual Confidential / Released 1 / 26

Our aim is to provide customers with timely and comprehensive service. For any

assistance, please contact our company headquarter:

Quectel Wireless Solutions Co., Ltd.

Room 501, Building 13, No.99, Tianzhou Road, Shanghai, China, 200233

Tel: +86 21 5108 6236

Mail: [email protected]

Or our local office, for more information, please visit:

http://www.quectel.com/quectel_sales_office.html

For technical support, to report documentation errors, please visit:

http://www.quectel.com/tecsupport.aspx

GENERAL NOTES

QUECTEL OFFERS THIS INFORMATION AS A SERVICE TO ITS CUSTOMERS. THE INFORMATION

PROVIDED IS BASED UPON CUSTOMERS’ REQUIREMENTS. QUECTEL MAKES EVERY EFFORT

TO ENSURE THE QUALITY OF THE INFORMATION IT MAKES AVAILABLE. QUECTEL DOES NOT

MAKE ANY WARRANTY AS TO THE INFORMATION CONTAINED HEREIN, AND DOES NOT ACCEPT

ANY LIABILITY FOR ANY INJURY, LOSS OR DAMAGE OF ANY KIND INCURRED BY USE OF OR

RELIANCE UPON THE INFORMATION. ALL INFORMATION SUPPLIED HEREIN ARE SUBJECT TO

CHANGE WITHOUT PRIOR NOTICE.

COPYRIGHT

THIS INFORMATION CONTAINED HERE IS PROPRIETARY TECHNICAL INFORMATION OF

QUECTEL CO., LTD. TRANSMITTABLE, REPRODUCTION, DISSEMINATION AND EDITING OF THIS

DOCUMENT AS WELL AS UTILIZATION OF THIS CONTENTS ARE FORBIDDEN WITHOUT

PERMISSION. OFFENDERS WILL BE HELD LIABLE FOR PAYMENT OF DAMAGES. ALL RIGHTS

ARE RESERVED IN THE EVENT OF A PATENT GRANT OR REGISTRATION OF A UTILITY MODEL

OR DESIGN.

Copyright © Quectel Wireless Solutions Co., Ltd. 2013. All rights reserved.

Quectel

Confidential

mailto:[email protected]

http://www.quectel.com/quectel_sales_office.html

http://www.quectel.com/tecsupport.aspx

WCDMA Module U10 Camera AT Command Set

U10_Camera_AT_Commands_Manual Released/Confidential 2 / 26

About the document

History

Revision Date Author Description

1.0 2012-10-29 Justin WANG Initial

1.1. 2013-03-14 Justin WANG Modified Chapter 3.5.

Quectel

Confidential



Contents

About the document ................................................................................................................................... 2

Contents ....................................................................................................................................................... 3

Table Index ................................................................................................................................................... 4

1 Introduction .......................................................................................................................................... 5

2 Description ........................................................................................................................................... 6

2.1. AT Command syntax ................................................................................................................... 6

2.2. Description of AT Command ....................................................................................................... 6

2.2.1. AT+QCAMON Turn On Camera .................................................................................. 6

2.2.2. AT+QCAMOFF Turn Off Camera .................................................................................. 7

2.2.3. AT+QCAMSIZE Set JPEG Picture or Video Resolution ............................................... 7

2.2.4. AT+QCAMQUA Set Picture Compression Ratio ........................................................... 8

2.2.5. AT+QCAMBRT Set Brightness ...................................................................................... 9

2.2.6. AT+QCAMEFF Set Effect ............................................................................................ 10

2.2.7. AT+QCAMFLIP Set Mirror and Flip ............................................................................. 11

2.2.8. AT+QCAMSOT Capture One JPEG Picture ............................................................... 12

2.2.9. AT+QCAMMSOT Capture Multiple JPEG Pictures ..................................................... 12

2.2.10. AT+QCAMAVI Video Record ....................................................................................... 13

2.2.11. AT+QCAMPAU Pause the Video ................................................................................. 15

2.2.12. AT+QCAMRESU Resume the Video .......................................................................... 15

2.2.13. AT+QCAMSTOP Stop the Video Or Multiple Capture ................................................ 15

2.2.14. AT+QCAMSTAT Query the Camera State .................................................................. 16

2.2.15. AT+QCAMCHK Check Current Sensor ID .................................................................. 16

2.2.16. AT+QCAMLST List Sensor Supported ........................................................................ 17

2.2.17. AT+QCAMSEL Select Sensor Configuration ............................................................ 17

3 Example .............................................................................................................................................. 19

3.1. Capture One JPEG Picture ....................................................................................................... 19

3.2. Video Record in SD Card .......................................................................................................... 20

3.3. Video Record in UFS ................................................................................................................ 20

3.4. Shot in RAM, then Move to SD Card ........................................................................................ 21

3.5. Shot in RAM, then Send by FTP Directly.................................................................................. 22

4 Appendix A Reference ....................................................................................................................... 24

5 Appendix B Summary of CME ERROR Codes ................................................................................ 25

Quectel

Confidential



Table Index

TABLE 1: TERMS AND ABBREVIATIONS ........................................................................................................ 24

TABLE 2: DESCRIPTION OF DIFFERENT CODING SCHEME ....................................................................... 25

Quectel

Confidential



1 Introduction

This document presents the camera AT Commands Set for Quectel U10. This document provides

guidance on all AT commands for camera and their responses.

With U10 module, user can take one JPEG picture, multiple JPEG pictures, and the video file via AT

commands. The pictures and videos can be saved in UFS directory of flash, RAM, or Picture directory of

SD card. Files in RAM can be copied or moved into SD card. Besides, these files can be output to UART

by File commands and also can be sent out by the built-in FTP AT commands.

Please note that the parameter range listed in this document is for HI253 only. Different sensor has the

different parameter range. Please check the actual return value of corresponding AT commands. Or you

can confirm them with us.

Quectel

Confidential



2 Description

2.1. AT Command syntax

Test Command AT+<x>=? This command returns the list of parameters and value ranges

set by the corresponding Write Command or internal processes.

Read Command AT+<x>? This command returns the currently set value of the parameter

or parameters.

Write Command AT+<x>=<…> This command sets the user-definable parameter values.

Execution

Command AT+<x>

This command reads non-variable parameters affected by

internal processes in the GSM engine

2.2. Description of AT Command

2.2.1. AT+QCAMON Turn On Camera

AT+QCAMON Turn on Camera

Test Command

AT+QCAMON=?

Response

+QCAMON: (16-1600),(8-1200),(0-13),(0-5)

OK

Write Command

AT+QCAMON=<capwidth>,<capheight

>,<capratio>,<effect mode>

Response

OK

If error is related to ME functionality:

+CME ERROR: <err>

Execution Command

AT+QCAMON

Response

OK

Quectel

Confidential



Parameter:

2.2.2. AT+QCAMOFF Turn Off Camera

2.2.3. AT+QCAMSIZE Set JPEG Picture or Video Resolution


+CME ERROR: <err>

Reference Note:

After the command is executed, SIF and Sensor are

electrified and initialized.

It is recommended that using this AT Command to turn on

camera without any parameter. All the parameters

involved here can be reset via other related AT

Command.

<capwidth> Picture width, the range is form 16 to 1600. Please refer to command

AT+QCAMSIZE.The default value is 640.

<capheight> Picture height, the range is from 8 to 1200. Please refer to command AT+QCAMSIZE.

The default value is 480.

<capratio> Picture compression ratio, the range is from 0 to 13. Please refer to command

AT+QCAMQUA. The default value is 2.

<effect mode> Picture effect mode, the range is from 0 to 5. Please refer to command

AT+QCAMEFF. The default value is 0.

AT+QCAMOFF Turn off Camera

Write Command

AT+QCAMOFF

Response

OK


+CME ERROR: <err>

AT+QCAMSIZE Set JPEG Picture or Video Resolution

Test Command

AT+QCAMSIZE=?

Response

+QCAMSIZE: (16-1600), (8-1200)

OK

Read Command

AT+QCAMSIZE?

Response

+QCAMSIZE: <capwidth>,<capheight>

Quectel

Confidential



Parameter:

2.2.4. AT+QCAMQUA Set Picture Compression Ratio

OK


+CME ERROR: <err>

Write Command

AT+QCAMSIZE=<capwidth>,<capheig

ht>

Response

OK


+CME ERROR: <err>

Reference Note:

Camera ON status is required before sending this AT

Command.

Supported values of <capwidth> and <capheight> when

taking a picture are as follow:

1600 x 1200 UXGA

1280 x 960 XVGA

640 x 480 VGA (default)

352 x 288 CIF

320 x 240 QVGA

320 x 200 CGA

176 x 144 QCIF

128 x 96 sub-QCIF

Supported values of <capwidth> and <capheight> when

video recording refer to AT+QCAMAVI.

<capwidth> Picture width, the range is form 16 to 1600. Please refer to command AT+QCAMSIZE.


<capheight> Picture height, the range is from 8 to 1200. Please refer to command AT+QCAMSIZE.


AT+QCAMQUA Set Picture Compression Ratio

Test Command

AT+QCAMQUA=?

Response

+QCAMQUA: (0-13)

OK

Read Command Response

Quectel

Confidential



Parameter:

2.2.5. AT+QCAMBRT Set Brightness

AT+QCAMQUA? OK

+QCAMQUA: <capratio>


+CME ERROR: <err>

Write Command

AT+QCAMQUA=<capratio>

Response

OK


+CME ERROR: <err>

Reference Note:


Command.

<capratio> Picture compression ratio, the range from is 0 to 13, the default value is 2.

AT+QCAMBRT Set Brightness

Test Command

AT+QCAMBRT=?

Response

+QCAMBRT: (0-8)

OK

Read Command

AT+QCAMBRT?

Response

OK

+QCAMBRT: <brightness>


+CME ERROR: <err>

Write Command

AT+QCAMBRT=<brightness>

Response

OK

Quectel

Confidential



Parameter:

2.2.6. AT+QCAMEFF Set Effect


+CME ERROR: <err>

Reference Note:


Command.

< brightness> Picture brightness, the range is form 0 to 5. The default value is 4.

AT+QCAMEFF Set Effect

Test Command

AT+QCAMEFF=?

Response

+QCAMEFF: (0-5)

OK

Read Command

AT+QCAMEFF?

Response OK

+QCAMEFF: <effect mode>


+CME ERROR: <err>

Write Command

AT+QCAMEFF=<effect mode>

Response

OK


+CME ERROR: <err>

Reference Note:


Command.

Quectel

Confidential



Parameter:

2.2.7. AT+QCAMFLIP Set Mirror and Flip

Parameter:

< effect mode> Picture effect mode, the range is form 0 to 5. The default value is 0.

AT+QCAMFLIP Set Mirror and Flip

Test Command

AT+QCAMFLIP=?

Response

+QCAMFLIP: (0,1),(0,1)

OK

Read Command

AT+QCAMFLIP?

Response

+QCAMFLIP: <mirror>,<flip>

OK


+CME ERROR: <err>

Write Command

AT+QCAMFLIP=<mirror>,<flip>

Response

OK


+CME ERROR: <err>

Reference Note:


Command.

<mirror> Mirror or not

0 Mirror

1 NORMAL

<flip> Flip or not

0 Flip

1 NORMAL

Quectel

Confidential



2.2.8. AT+QCAMSOT Capture One JPEG Picture

Parameter:

2.2.9. AT+QCAMMSOT Capture Multiple JPEG Pictures

AT+QCAMSOT Capture One JPEG Picture

Test Command

AT+QCAMSOT=?

Response

+QCAMSOT: “file name”

OK

Write Command

AT+QCAMSOT=<file name>

Response

OK


+CME ERROR: <err>

Reference Note:

Camera ON status is required before sending this AT Command.

Execute AT+QCAMSOT=”RAM:pic.jpg”.

The file is saved in RAM.

Execute AT+QCAMSOT=“pic.jpg”.

The file is saved in UFS directory of module’s flash.

Execute AT+QCAMSOT=“SD:pic.jpg”

The file is saved in Picture directory of SD card.

<file name> Picture file name

“file name” JPEG picture is saved in the UFS directory of module’s flash.

“RAM:file name” JPEG picture is saved in RAM.

“SD:file name” JPEG picture is saved in Picture directory of SD card.

AT+QCAMMSOT Capture Multiple JPEG Pictures

Test Command

AT+QCAMMSOT=?

Response

+QCAMMSOT: "file name",<max count>

OK

Write Command Response

Quectel

Confidential



Parameter:

2.2.10. AT+QCAMAVI Video Record

AT+QCAMMSOT=<file name>,<max

count>

Start the command successfully:

OK

+QCAMMSOT: <err>

Start the command failed:

+CME ERROR: <err>

The command is not executed completely until it responses

+QCAMMSOT: <err>. <err>=0 indicates that it is successful

to capture pictures. If the operation is failed, <err> (≠0)

presents the error code.

Reference Note:


Command.

Execute AT+QCAMMSOT=”RAM:pic.jpg”,3.

The files are saved in RAM.

Execute AT+QCAMMSOT=“pic.jpg”,3.

The files are saved in UFS directory of module’s flash.

Execute AT+QCAMMSOT=“SD:pic.jpg”,3.

The files are saved in Picture directory of SD card.

<file name> Picture file name

“file name” JPEG picture is saved in the UFS directory of module’s flash

“RAM:file name” JPEG picture is saved in RAM

“SD:file name” JPEG picture is saved in Picture directory of SD card

<max count> Count of JPEG pictures

AT+QCAMAVI Video Record

Test Command

AT+QCAMAVI=?

Response

+QCAMAVI: "file name", <file size>, (12,15,18,24,30)

OK

Quectel

Confidential



Parameter:

Write Command

AT+QCAMAVI=<file name>,<file size>,

<frame rate>

Response

Start the command successfully:

OK

+QCAMAVI: <err>

Start the command failed:

+CME ERROR: <err>

The command is not executed completely until it responses

+QCAMAVI: <err>. <err>=0 indicates that video recording is

executed successfully. If the operation is failed, <err> (≠0)

presents the error code.

Reference Note:


Command.

Supported video resolution are as follow:

640 x 480 VGA (default)

480 x 320 HVGA

400 x 240 WQVGA

352 x 288 CIF

320 x 240 QVGA

176 x 144 QCIF

<file name> File name

“file name” File is saved in UFS.

“SD:file name” File is saved in Picture directory of SD card.

<file size> File size for UFS and SD file. It specifies the file size

<frame rate> Video frame rate

Quectel

Confidential



2.2.11. AT+QCAMPAU Pause the Video

2.2.12. AT+QCAMRESU Resume the Video

2.2.13. AT+QCAMSTOP Stop the Video Or Multiple Capture

AT+QCAMPAU Pause the Video

Execution Command

AT+ QCAMPAU

Response

OK


+CME ERROR: <err>

Reference Note:

This command is used to pause the video.

AT+QCAMRESU Resume the Video

Execution Command

AT+ QCAMRESU

Response

OK


+CME ERROR: <err>

Reference Note:

This command is used to resume the video.

AT+QCAMSTOP Stop the Video or Multiple Capture

Execution Command

AT+ QCAMSTOP

Response

OK


+CME ERROR: <err>

This command is not executed completely until it responds

with +QCAMAVI: <err> or +QCAMMSOT: <err>. <err>=0

indicates that stopping the video has succeeded. If this

operation is failed, <err> (≠0) presents the error code.

Quectel

Confidential



2.2.14. AT+QCAMSTAT Query the Camera State

Parameter:

2.2.15. AT+QCAMCHK Check Current Sensor ID

Reference Note:

When video recording is in progress this command is

used to stop the video and when multiple capture is in

progress this command is used to stop the capture.

AT+QCAMSTAT Query the Camera State

Execution Command

AT+ QCAMSTAT

Response

+QCAMSTAT: <state>

OK


+CME ERROR: <err>

Reference

<state> Camera sate

0 Camera is in idle state.

1 Camera is in powering on state.

2 Camera is in recording state.

3 Camera is in pausing state.

4 Camera is in multi-capture state.

AT+QCAMCHK Check Current Sensor ID

Execution Command

AT+ QCAMCHK

Response

+QCAMCHK: “sensor name”,”sensor ID”

OK


+CME ERROR: <err>

Quectel

Confidential



Parameter:

2.2.16. AT+QCAMLST List Sensor Supported

Parameter:

2.2.17. AT+QCAMSEL Select Sensor Configuration

Reference

<sensor name> The sensor name currently connected.

<sensor ID> The identification of the sensor.

AT+QCAMLST List Sensor Supported

Execution Command

AT+ QCAMLIST

Response

+QCAMLST: “sensor name”[,<1>]

OK


+CME ERROR: <err>

Reference

<sensor name> The sensor name that has already supported

[,<1>] “1” indicates current sensor connected.

AT+QCAMSEL Select Sensor Configuration

Test Command

AT+QCAMSEL=?

Response

+QCAMSEL: “config name”

OK

Read Command

AT+QCAMSEL?

Response

Return the current configuration name:

+QCAMSEL: “config name”

Quectel

Confidential



Parameter:

OK


+CME ERROR: <err>

Parameter

See Write Command

Write Command

AT+QCAMSEL=<config name>

Response

OK


+CME ERROR: <err>

Reference

<config name> The name of the sensor that is ready to work.

Quectel

Confidential



3 Example

The pictures or videos can be saved in UFS directory of flash, RAM, or Picture directory of SD card. The

file is distinguished from each other by prefix in the file name: prefix “RAM:” stands for RAM file, “SD:”

stands for SD file, and no prefix stands for UFS file. For example, read file from UART by command

AT+QFDWL:

AT+QFDWL="pic.jpg" // Download “pic.jpg” in UFS directory of module’s flash

AT+QFDWL="RAM:pic.jpg" // Download “pic.jpg” in RAM

AT+QFDWL="SD:pic.jpg" // Download “pic.jpg” in Picture directory of SD card

List some examples as follows.

The blue bold texts are commands input by the user. The black bold texts are output from the module.

Use ATE0 to shut down Echo mode before running the examples as below:

3.1. Capture One JPEG Picture

AT+QCAMON // Turn on camera.

OK

AT+QCAMSIZE=640,480 // Set picture size as 640*480.

OK

//Mark A

AT+QCAMSOT="RAM:pic.jpg" // Shot one JPEG picture, file is saved in

RAM. If there has already been one file

named “pic.jpg” in RAM, the new picture

will overwrite the old one.

OK

NOTE

Quectel

Confidential



// User can handle this JPEG picture. Download

it by AT+QFDWL="RAM:pic.jpg", or move it to

SD card.

AT+QFLST="RAM:pic.jpg" // List file information of “RAM:pic.jpg”.

+QFLST: "RAM:pic.jpg",61248, 61248 // The actual size of “RAM:pic.jpg” is 61248

Bytes.

AT+QFDEL="RAM:pic.jpg" // It is recommended to delete this file in

order to release the memory size after

handling this file.

OK .

// Execute commands after Mark A repeats.

AT+QCAMOFF // Turn off camera.

OK

3.2. Video Record in SD Card


OK

//Mark B

AT+QCAMAVI="SD:record.avi", 1024000,12 // Take video as frame rate of 12 frames

OK per second. File is saved to Picture

directory of SD card, and the file size

+QCAMAVI: 0 is about 1,024,000bytes.

// Video finished. Generate file “record.avi” in

Picture directory of SD card. Execute

commands after +QCAMAVI: 0 is received,

and file name can be modified as needed.


OK

3.3. Video Record in UFS


OK

//Mark C

AT+QCAMAVI="record.avi",1024000,12 // Take video as frame rate of 12 frames

Quectel

Confidential



OK per second. File is saved to UFS, and the file

size is about 1,024,000 bytes.

+QCAMAVI: 0 // Video finished. Generate file “record.avi” in

UFS. Execute commands after +QCAMAVI: 0

is received and file name can be modified as

needed.


OK

3.4. Shot in RAM, then Move to SD Card


OK

//Mark D

// Do capturing in RAM and move to SD

card as follows. Operations can be done

repeatedly.

AT+QCAMSOT="RAM:pic.jpg" // Capture one JPEG picture in RAM.

OK

AT+QFMOV="RAM:pic.jpg","SD:pic1.jpg",0,1 // Move picture to SD card, and rename it

OK as “pic1.jpg”, delete source file in RAM

at the same time.

// Execute commands after Mark D repeats.


OK

AT+QFMOV="RAM:*","SD:*",0,1 // Move all files in RAM to SD card, and

OK delete all source files.

// Execute commands after Mark D repeats.


OK

Quectel

Confidential



3.5. Shot in RAM, then Send by FTP Directly

//Open FTP service

AT+QIFGCNT=0 // Set front context.

OK

AT+QFTPUSER=”test” // Set the user name as “test”.

OK

AT+QFTPPASS=”test” // Set the password as “test”.

OK

AT+QFLST=”RAM:pic.jpg” // Query the size of picture file.

+QFLST:”RAM:pic.jpg”, 60112,60112

OK

AT+QFTPCFG=4,”/RAM/” // Set the local position as RAM.

OK

+QFTPCFG:0 // Successfully set the local position.

//Open FTP service

AT+QIFGCNT=0 // Set front context.

OK

AT+QFTPUSER=”test” // Set the user name as “test”.

OK

AT+QFTPPASS=”test” // Set the password as “test”.

OK

+QFTPOPEN:0 // Successfully open the FTP service.


OK

AT+QCAMSIZE=640,480 // Set picture size as 640*480.

OK

//Mark E

// Capture and send by FTP as follows.

Operations can be done repeatedly.

AT+QCAMSOT=”RAM:pic.jpg” // Capture JPEG picture in RAM.

OK

Quectel

Confidential



AT+QFTPPATH=”/” // Set the path to upload file as “/”.

OK

+QFTPPATH:0 // Successfully set the path.

AT+QFTPOPEN=“quectel.3322.org”,21 // Visit the FTP server.

OK

+QFTPOPEN:0

AT+QFTPPUT=”pic.jpg”,60112,200 // Upload the file “pic.jpg” in RAM

(local position), and the size expected

to input is 60112.If the real size of the file

“pic.jpg” is less than 60112 as this example,

it will upload file with the real size. The

maximum time to read file data is 200

seconds.

OK

+QFTPPUT: 60112 // Successfully upload the file “pic.jpg”

to the FTP server. The size of the data

successfully uploaded is 60112.

AT+QFTPCLOSE // Close the FTP service.

OK

+QFTPCLOSE: 0 // Successfully close the FTP service.

Quectel

Confidential



4 Appendix A Reference

Table 1: Terms and Abbreviations

Abbreviation Description

3GP One format of video file. U10 uses 3GP as video format, and the

compression ratio format is optional.

Sensor Camera’s image sensor.

SIF Sensor interface for the module. It includes image processing functions and

sensor interface.

UFS User File Storage. File saved in UFS directory in module’s flash.

RAM file File saved in RAM memory, and the names of files in it start with “RAM:”.

SD file File saved in Picture directory of SD card, and the names of files in it start

with “SD:”.

Quectel

Confidential



5 Appendix B Summary of CME ERR

OR Codes

Table 2: Description of Different Coding Scheme

Code of <err> Meaning

6001 No sensor is connected or sensor ID cannot be read.

6002 Camera has already opened.

6003 Camera has not been opened.

6004 No Sensor has been selected.

6005 Sensor name selected is invalid.

6006 Camera is busy.

6007 Contrast for capture is out of range.

6008 Brightness for capture is out of range.

6009 Quality for capture is out of range.

6010 Flip for capture is out of range.

6011 Effect for capture is out of range.

6012 Resolution for capture is out of range.

6013 Memory for capture is not enough.

6014 Multi-capture has already stopped.

6015 Creating file failed when taking a picture.

6016 File name is too long.

6017 No SD card has been inserted.

Quectel

Confidential



6018 Input parameter format is incorrect.

6019 Memory for video is not enough.

6020 Video is not allowed in RAM.

6021 Camera is not in video recording status. 6022 Camera is not in video pausing status. 6023 Video recording has already finished. 6024 File size is too small for the video.

6025 Resolution for video is out of range. 6026 Quality for video is out of range. 6027 Effect for video is out of range. 6028 Contrast for video is out of range. 6029 Brightness for video is out of range. 6030 Flip for video is out of range. 6031 Video frame rate is out of range. Quectel

Confidential

U10 Camera AT Commands Manual - Quectel Wireless Solutions · WCDMA Module U10 Camera AT Command...

Documents

Transcript of U10 Camera AT Commands Manual - Quectel Wireless Solutions · WCDMA Module U10 Camera AT Command...