SIM_DM AT Command Set

AT Command Set

SIM_DM_ATC_V1.07


Document Title: / SIM_DM AT Command Set
Version: / 1.07
Date: / 2018-10-20
Status: / Release
Document ID: / SIM_DM_ATC_V1.07

General Notes

SIMCom offers this information as a service to its customers, to support application and engineering efforts that use the products designed by SIMCom. The information provided is based upon requirements specifically provided to SIMCom by the customers. SIMCom has not undertaken any independent search for additional relevant information, including any information that may be in the customer’s possession. Furthermore, system validation of this product designed by SIMCom within a larger electronic system remains the responsibility of the customer or the customer’s system integrator. All specifications supplied herein are subject to change.

Copyright

This document contains proprietary technical information which is the property of SIMCom Limited., copying of this document and giving it to others and the using or communication of the contents thereof, are forbidden without express authority. Offenders are liable to the payment of damages. All rights reserved in the event of grant of a patent or the registration of a utility model or design. All specification supplied herein are subject to change without notice at any time.

Copyright © Shanghai SIMCom Wireless Solutions Ltd. 2009

1

SIM_DM_ATC_V1.05 10/20/2018

SIM_DM AT Command Set

Version History

Version / Chapter / Comments
V1.00 / New Version
V1.01 / 1.2 AT+FOTARESET / Modify this command
V1.02 / 1.5AT+FOTASERVER
1.6AT+FOTAAPN / Modify this command
Modify this command
V1.03 / 1.5 AT+FOTASERVER / Modify this command
V1.04 / 1.10 AT+FOTAQUERY / Add this command
V1.05 / 1.8 AT+ FOTASETAGENT
1.9 AT+FOTADEF
1.10 AT+FOTAQUERY
1.11 FOTA error result string / Add test command of this command
Add test command of this command
Add test command of this command
Add this section
V1.06 / 1.8 AT+FOTASETAGENT / Modify this command
V1.07 / 1.8 AT+FOTASETAGENT / Modify this command

Contents

Version History

Contents

1SIM DM AT commands

1.1AT+FOTASTART FOTA session start

1.2AT+FOTARESET Module restart

1.3AT+FOTAINITIATOR Set FOTA session initiator parameter

1.4AT+FOTAUIMODE Set FOTA mode

1.5AT+FOTASERVER Set FOTA server

1.6AT+FOTAAPN Set FOTA APN

1.7AT+FOTAVIEW Display FOTA session settings

1.8AT+ FOTASETAGENT Send update result to fota server

1.9AT+ FOTADEF SET DEFAULT SESSION ACTIVE FLAG

1.10AT+ FOTAQUERY Query available update version

1SIM DM AT commands

1.1AT+FOTASTARTFOTA session start

Description

The command is used to start a FOTA session.It will connect FOTA server and download update package,then update new firmware.
SIM PIN / References
YES / Vendor

Syntax

Test Command / Responses
AT+FOTASTART=? / OK
ERROR
Execution Command / Responses
AT+FOTASTART / OK
ERROR
+CME ERROR: <err>
1024“It is in a FOTA session”
1025“It is in a call”
1026“TCPIP is not idle” TCPIP in work,unable to start FOTA
1027“FOTA is not ready” Still initialize FOTA
+FOTA ERROR:fota_result_string

Defined values

None

Examples

AT+FOTASTART=?
OK
AT+FOTASTART
OK

1.2 AT+FOTARESET Module restart

Description

The command is used to restart module after update package downloaded successfully.
SIM PIN / References
NO / Vendor

Syntax

Test Command / Responses
AT+FOTARESET=? / OK
Execution Command / Responses
AT+FOTARESET / OK
+CME ERROR: <err>
1028 “NO Download update file” there is no update package,
thus forbidden to restart
module

Defined values

None

Examples

AT+FOTARESET=?
OK
AT+FOTARESET
OK

1.3 AT+FOTAINITIATOR Set FOTA session initiator parameter

Description

The command is used to set FOTA session initiator parameter.
SIM PIN / References
NO / Vendor

Syntax

Test Command / Responses
AT+FOTAINITIATOR=? / +FOTAINITIATOR: (range of supported <n>s)
OK
Read Command / Responses
AT+FOTAINITIATOR? / +FOTAINITIATOR: n>
OK
Write Command / Responses
AT+FOTAINITIATOR=
<n> / OK
ERROR
+CME ERROR: <err>
765“Invalid input value”
1024 “It is in a FOTA session”
Execution Command / Responses
AT+FOTAINITIATOR / Set default value:
OK

Defined values

n>
Integer type.Settings can only be configured when out of FOTA session
0 – FOTA session is initiated by client side
1 – FOTA session is initiated by server side

Examples

AT+FOTAINITIATOR=?
+FOTAINITIATOR: (0-1)
OK
AT+FOTAINITIATOR?
OK
AT+FOTAINITIATOR=1
OK
AT+FOTAINITIATOR
OK

1.4 AT+FOTAUIMODE Set FOTA mode

Description

The command is used to set FOTA session’s UI mode.
SIM PIN / References
NO / Vendor

Syntax

Test Command / Responses
AT+FOTAUIMODE=? / +FOTAUIMODE:(range of supported <n>s)
OK
Read Command / Responses
AT+FOTAUIMODE? / +FOTAUIMODE: n
OK
Write Command / Responses
AT+FOTAUIMODE=<n> / OK
ERROR
+CME ERROR: <err>
765“Invalid input value”
1024 “It is in a FOTA session”
Execution Command / Responses
AT+FOTAUIMODE / Set default value:
OK

Defined values

n
Integer type.
0 – Background Mode.Start FOTA without user interaction.
1 – User interactive mode.Need wait form user confirmation to start FOTA.

Examples

AT+FOATUIMODE=?
+FOTAUIMODE: (0-1)
OK
AT+FOTAUIMODE?
+FOTAUIMODE: 1
OK
AT+FOTAUIMODE=1
OK
AT+FOTAUIMODE
OK

1.5 AT+FOTASERVER Set FOTA server

Description

The command is used to set FOTA server’s IP address and port.
SIM PIN / References
NO / Vendor

Syntax

Test Command / Responses
AT+FOTASERVER=? / +FOTASERVER:<IP_len>,(range of supported <port>s)
OK
Read Command / Responses
AT+FOTASERVER? / +FOTASERVER: <IP>,<port>
OK
Write Command / Responses
AT+FOTASERVER=
IP,[<port>] / OK
ERROR
+CME ERROR: <err>
765“Invalid input value”
1024 “It is in a FOTA session”

Defined values

IP
String type.IP address of FOTA server.
When IPV4 address standard is used,the IP address format consists of 4 octets,separated by decimal
Point: “AAA.BBB.CCC.DDD”.The range of each octet is 0-255.It is also domain name,the domain name can be resolved by a DNS server.
port
Integer type.The port of FOTA server. The default port is 8080
IP_len
Integer type.The max length of <IP>.

Examples

AT+FOTASERVER=?
+FOTASERVER: 50,(0-65535)
OK
AT+FOTASERVER?
+FOTASERVER: “116.228.221.51”,100
OK
AT+FOTASERVER=”116.228.221.51”,100
OK

1.6 AT+FOTAAPN Set FOTA APN

Description

The command is used to set some parameters of FOTA session,These parameters include APN(access point name),user name, password.
SIM PIN / References
NO / Vendor

Syntax

Test Command / Responses
AT+FOTAAPN=? / +FOTAAPN: <apn_len>,<user_len>,<passw_len>
OK
Read Command / Responses
AT+FOTAAPN? / +FOTAAPN:<apn>,<user>,<passw>
OK
Write Command / Responses
AT+FOTAAPN=[<apn>],[<user>],[<passw>] / OK
ERROR
+CME ERROR: <err>
765“Invalid input value”
1024 “It is in a FOTA session”

Defined values

apn
String type.APN for FOTA session.
user
String type.User name for FOTA session.
<passw>
String type.Password for FOTA session.
apn_len
Integer type.The max length of <apn>
<user_len
Integer type.The max length of <user>.
<passw_len
Integer type.The max length of <passw>.

Examples

AT+FOTAAPN=?
+FOTAAPN: 20,16,16
OK
AT+FOTAAPN?
+FOTAAPN: "cmnet","cmcc","1234"
OK
AT+FOTAAPN=”cmnet”,”cmcc”,”1234”
OK

1.7 AT+FOTAVIEW Display FOTA session settings

Description

The command is used to display FOTA session settings.
SIM PIN / References
NO / Vendor

Syntax

Test Command / Responses
AT+FOTAVIEW=? / OK
Execution Command / Responses
AT+FOTAVIEW / +FOTASESSIONID: <session>
+FOTAINITIATOR: <initiator>
+FOTAUIMODE: <ui_mode
+FOTASERVER: <ip>,<port>
+FOTAAPN: <apn>,<user>,<passw>
+FOTADATACLIENT: <imsi>
+FOTADATADEVID: <imei>
+FOTADATAMAN: manufacturer>
+FOTADATAMOD: <model>
+FOTADATASIMCOMDMV: <DM_version>
+FOTADATASWV: <software_version>
OK

Defined values

session
Integer type.FOTA session ID.
initiator
Integer type.The initiator of FOTA session.
ui_mode
Integer type.The ui mode of FOTA session.
sys_format
Integer type. The format data section flag of FOTA session.
<ip
String type.IP address or domain name of FOTA server.
port
Integer type.The port of FOTA server.
apn
String type.APN for FOTA session.
user
String type.User name for FOTA session.
passw
String type.Password for FOTA session.
server
String type.The information of FOTA server.
imsi
String type.The IMSI information of module.
imei
String type.The IMEI information of module.
manufacturer
String type.The manufacturer name of module.
model
String type.The model of module.
DM_version
String type.The version of SIM DM.
<software_version>
String type.The software version of module.

Examples

AT+FOTAVIEW=?
OK
AT+FOTAVIEW
+FOTASESSIONID: 1
+FOTAINITIATOR: 1
+FOTAUIMODE: 1
+FOTASERVER: "",8080
+FOTAAPN: "cmnet","cmcc","1234"
+FOTADATACLIENT: 460029005237755
+FOTADATADEVID: 357396012183170
+FOTADATAMAN: SIMCOM INCORPORATED
+FOTADATAMOD: SIMCOM_SIM5218A
+FOTADATASIMCOMDMV: SIMCOM_DM/1.1
+FOTADATASWV: 240150B02SIM5218A
OK

1.8AT+ FOTASETAGENT Send update result to fota server

Description

The command is used to send response message to fota server after updating the delta file, no matter it succeeded or failed.
SIM PIN / References
YES / Vendor

Syntax

Test Command / Responses
AT+ FOTASETAGENT=? / OK
Execution Command / Responses
AT+FOTASETAGENT / +FOTA: <fota_update_result_string>
OK
+FOTA:<fota_result_string>
+FOTA: <fota_update_result_string>
OK
+FOTA ERROR:fota_result_string
+ FOTASETAGENT: <fota_update_result_string>

Defined values

<fota_update_result_string>
Notify user:
If update succeeded: +FOTA: Succeeded to update firmware!
If update failed: +FOTA: Unable to update firmware!
If no update agency：+FOTASETAGENT: No update action!
<fota_result_string>
Notify user the result string.

Examples

AT+ FOTASETAGENT
+FOTA: Succeeded to update firmware!
OK
+FOTA: Succeeded to notify fota server the update result!

1.9 AT+ FOTADEF SET DEFAULT SESSION ACTIVE FLAG

Description

The command is used to set the session active flag as default.
This command is only used when the session is interrupted with unknown reason and can not jump out the session.
SIM PIN / References
NO / Vendor

Syntax

Test Command / Responses
AT+FOTADEF=? / OK
Execution Command / Responses
AT+FOTADEF / OK

Examples

AT+ FOTADEF
OK

1.10AT+ FOTAQUERY Query available update version

Description

The command is used to check whether there is any available update versionfrom fota server
SIM PIN / References
YES / Vendor

Syntax

Test Command / Responses
AT+FOTAQUERY=? / OK
Execution Command / Responses
AT+FOTAQUERY / OK
+FOTA:<fota_result_string>
OK
+FOTA ERROR:<fota_result_string>

Defined values

<fota_result_string>
Notify user:
If find: +FOTA: Find available update version
If in other situation, report the relevant string.

Examples

AT+ FOTAQUERY
OK
+FOTA: Find available update version

1.11FOTA error result string

Fota error result string:

Error reason / Error result string
SOCKETFAIL: / +FOTA ERROR: Connect server failed!
NETWORKDOWN: / +FOTA ERROR: Network down!
READTIMEOUT: / +FOTA ERROR: Read timeout!
HTTPHEADERERROR: / +FOTA ERROR: Http header error!
NOMEMORY: / +FOTA ERROR: No enough memory!
SESSIONERROR: / +FOTA ERROR: Session error!
CONFIGFILEERROR: / +FOTA ERROR: Config file error!
CONFIGPARAMERROR: / +FOTA ERROR: Config parameter error!
USERABORTED: / +FOTA ERROR: User aborted!
MAKEXMLERROR: / +FOTA ERROR: Make xml error!
PARSERXMLERROR: / +FOTA ERROR: Parser xml error!
DMVERSIONMISMATCH: / +FOTA ERROR: No available update version!
SERVERREJECT: / +FOTA ERROR: Server rejected!
DELTAPATHERROR: / +FOTA ERROR: Delta path error!

1

SIM_DM_ATC_V1.05 10/20/2018