The syntax of the +CMGD AT command

The syntax of the +CMGD AT command is: (Optional parameters are enclosed in square brackets.)


+CMGD=index[,flag]


In the above line, index is an integer specifying the location of the SMS message to be deleted from the message storage area by the +CMGD AT command, and flag is an integer specifying whether to delete SMS messages according to their message status. The SMS specification has defined these flag values: 0, 1, 2, 3 and 4.

0. Meaning: Delete only the SMS message stored at the location index from the message storage area. This is the default value.

1. Meaning: Ignore the value of index and delete all SMS messages whose status is "received read" from the message storage area.

2. Meaning: Ignore the value of index and delete all SMS messages whose status is "received read" or "stored sent" from the message storage area.

3. Meaning: Ignore the value of index and delete all SMS messages whose status is "received read", "stored unsent" or "stored sent" from the message storage area.

4. Meaning: Ignore the value of index and delete all SMS messages from the message storage area.

To find the flag values supported by your GSM/GPRS modem or mobile phone, you can perform a test operation using the +CMGD AT command. See the next section for the details.


24.2. Finding the Supported Indexes and Flag Values

Performing a test operation with the +CMGD AT command allows you to find all indexes that are supported by the index parameter. The test operation may also return all supported values of the flag parameter. Here is the format of the information response returned after the execution of the test command "+CMGD=?": (Optional fields are enclosed in square brackets.)


+CMGD: (list_of_indexes)[,(list_of_flag_values)]


The values inside the first parentheses are the values that are supported by the index parameter of the +CMGD AT command.

The values inside the second parentheses are the values that are supported by the flag parameter of the +CMGD AT command. Note: A GSM/GPRS modem or mobile phone might not provide these values since the SMS specification defines them as optional.

As an example, here is the response returned from my Nokia 6021 mobile phone to Windows' HyperTerminal program after the execution of the test command "+CMGD=?":


AT+CMGD=?
+CMGD: (1-10),(0-4)

OK


From above, we know that the Nokia 6021 mobile phone allows any integer between 1 and 10 to be assigned to the index parameter of the +CMGD AT command. Also, the Nokia 6021 mobile phone supports all of the five flag values defined in the SMS specification.

Do you remember that we described the format of values inside parentheses in the section "Test Command -- Checks Whether a Certain AT Command is Supported"? If not, you may want to go back and have a look. Here are a few examples showing some of the possibilities: "(0-4)", "(0,1,2,3,4)", "(0,2-4)".


24.3. Example Demonstrating How to Use the +CMGD AT Command to Delete SMS Text Messages

Now let's see an example that demonstrates how to use the +CMGD AT command to delete an SMS text message from the message storage area. Suppose you have written an SMS text message to the message storage area by the +CMGW AT command (details about the +CMGW AT command can be found in the earlier section "Writing SMS Messages to Memory / Message Storage (AT+CMGW)" of this SMS tutorial), like this:


AT+CMGW="[phone]"
> A simple demo of SMS text messaging.
+CMGW: 1

OK


The information response of the +CMGW AT command tells us that the SMS text message is stored in the memory location at index 1. To delete the SMS text message, specify 1 to the index parameter of the +CMGD AT command, like this:

(Important note: Make sure you are writing text messages to and deleting text messages from the same message storage area. If not, you may delete the wrong text message. Details about message storage areas can be found in the earlier section "Preferred Message Storage (AT+CPMS)" of this SMS tutorial.)


AT+CMGD=1
OK


The final result code OK indicates the SMS text message "A simple demo of SMS text messaging." was deleted successfully. If the operation fails, the final result code returned will either be ERROR or +CMS ERROR.

Here is another example. Suppose you want to delete all SMS messages stored in the message storage area. To do this, assign 4 to the flags parameter of the +CMGD AT command. The value assigned to the index parameter does not matter since it will be ignored by the GSM/GPRS modem or mobile phone.


AT+CMGD=1,4
OK

Kết quả (Việt) 1:

Cú pháp của các + CMGD tại lệnh là: (tùy chọn các thông số được đính kèm trong dấu ngoặc vuông.)+ CMGD = chỉ số [, cờ]Ở dòng bên trên, chỉ số là một số nguyên xác định vị trí của tin nhắn SMS bị xóa từ khu vực lưu trữ thư bằng các + CMGD tại lệnh, và flag là một số nguyên xác định liệu để xóa tin nhắn SMS theo tình trạng tin nhắn của họ. Đặc điểm kỹ thuật của tin nhắn SMS đã xác định những giá trị cờ: 0, 1, 2, 3 và 4.0. ý nghĩa: Xóa chỉ có tin nhắn SMS được lưu trữ tại vị trí chỉ mục từ khu vực lưu trữ tin nhắn. Đây là giá trị mặc định.1. ý nghĩa: Bỏ qua các giá trị của index và xóa tất cả tin nhắn SMS có trạng thái là "nhận được đọc" từ khu vực lưu trữ tin nhắn.2. ý nghĩa: Bỏ qua các giá trị của index và xóa tất cả tin nhắn SMS có trạng thái là "nhận được đọc" hoặc "lưu trữ gửi" từ khu vực lưu trữ tin nhắn.3. ý nghĩa: Bỏ qua các giá trị của index và xóa tất cả tin nhắn SMS có trạng thái là "nhận được đọc", "lưu trữ unsent" hoặc "lưu trữ gửi" từ khu vực lưu trữ tin nhắn.4. ý nghĩa: Bỏ qua các giá trị của index và xóa tất cả tin nhắn SMS từ khu vực lưu trữ tin nhắn.Để tìm các giá trị cờ được hỗ trợ bởi modem GSM/GPRS hoặc điện thoại di động của bạn, bạn có thể thực hiện một thử nghiệm hoạt động bằng cách sử dụng các + CMGD tại lệnh. Xem phần tiếp theo cho các chi tiết.24,2. tìm kiếm lập chỉ mục được hỗ trợ và các giá trị cờThực hiện một hoạt động thử nghiệm với các + CMGD tại lệnh cho phép bạn tìm tất cả các chỉ số được hỗ trợ bởi các tham số chỉ số. Các hoạt động thử nghiệm cũng có thể trở lại hỗ trợ tất cả các giá trị của tham số cờ. Đây là định dạng của các phản ứng thông tin trở lại sau khi thực hiện lệnh kiểm tra "+ CMGD =?": (tùy chọn các lĩnh vực được đính kèm trong dấu ngoặc vuông.)+ CMGD: (list_of_indexes)[,(list_of_flag_values)]Các giá trị bên trong dấu ngoặc đơn đầu tiên là các giá trị được hỗ trợ bởi các thông số chỉ số của các + CMGD tại lệnh.Các giá trị bên trong dấu ngoặc đơn thứ hai là các giá trị được hỗ trợ bởi tham số lá cờ của các + CMGD tại lệnh. Lưu ý: Modem GSM/GPRS hoặc điện thoại di động có thể không cung cấp những giá trị kể từ khi các đặc tả SMS xác định chúng như là tùy chọn.Ví dụ, đây là phản ứng trở lại từ điện thoại di động Nokia 6021 của tôi Windows' HyperTerminal chương trình sau thực hiện lệnh kiểm tra "+ CMGD =?":AT + CMGD =?+ CMGD: (1-10),(0-4)OkTừ phía trên, chúng ta biết rằng điện thoại di động Nokia 6021 cho phép bất kỳ số nguyên từ 1 đến 10 được gán cho các tham số chỉ số của các + CMGD tại lệnh. Ngoài ra, các Nokia 6021 điện thoại di động hỗ trợ tất cả các lá cờ năm giá trị được định nghĩa trong đặc điểm kỹ thuật của tin nhắn SMS.Bạn có nhớ chúng tôi mô tả các định dạng của các giá trị bên trong dấu ngoặc đơn trong phần "Kiểm tra lệnh--kiểm tra cho dù một Certain tại lệnh hỗ trợ"? Nếu không, bạn có thể muốn quay trở lại và có một cái nhìn. Dưới đây là một vài ví dụ hiển thị một số các khả năng: "(0-4)", "(0,1,2,3,4)", "(0,2-4)".24,3. ví dụ chứng minh làm thế nào để sử dụng các + CMGD lệnh để xóa tin nhắn văn bản tin nhắn SMSBây giờ hãy xem một ví dụ đó chứng tỏ làm thế nào để sử dụng các + CMGD tại lệnh để xóa một tin nhắn văn bản SMS từ khu vực lưu trữ tin nhắn. Giả sử bạn đã viết một tin nhắn văn bản SMS đến khu vực lưu trữ tin nhắn của các + CMGW tại lệnh (chi tiết về các + CMGW tại lệnh có thể được tìm thấy trong các phần trước đó "văn bản tin nhắn SMS để nhớ / tin nhắn lưu trữ (AT + CMGW)" của hướng dẫn này tin nhắn SMS), như thế này:AT + CMGW = "[phone]"> Một bản demo đơn giản của tin nhắn SMS nhắn tin văn bản.+ CMGW: 1OkCác thông tin phản ứng của các + CMGW AT lệnh cho chúng ta biết rằng tin nhắn văn bản SMS được lưu trữ trong bộ nhớ vị trí tại index 1. Để xóa tin nhắn văn bản tin nhắn SMS, chỉ định 1 để các thông số chỉ số của các + CMGD tại lệnh, như thế này:(Lưu ý quan trọng: Hãy chắc chắn rằng bạn đang viết tin nhắn văn bản đến và xóa các tin nhắn văn bản từ cùng một khu vực lưu trữ tin nhắn. Nếu không, bạn có thể xóa tin nhắn văn bản sai trái. Thông tin chi tiết về khu vực lưu trữ tin nhắn có thể được tìm thấy trong các phần trước đó "Preferred tin nhắn lưu trữ (AT + CPMS) của hướng dẫn này SMS.)AT + CMGD = 1OkKết quả cuối cùng mã OK cho biết tin nhắn văn bản tin nhắn SMS "Một bản demo đơn giản của tin nhắn SMS nhắn tin văn bản." đã được xóa thành công. Nếu chiến dịch thất bại, kết quả cuối cùng mã trả lại hoặc là sẽ có lỗi hoặc + CMS lỗi.Dưới đây là một ví dụ khác. Giả sử bạn muốn xóa tất cả tin nhắn SMS được lưu giữ trong khu vực lưu trữ tin nhắn. Để làm điều này, chỉ định 4 cho tham số lá cờ của các + CMGD tại lệnh. Giá trị được gán cho các tham số chỉ số không quan trọng vì nó sẽ bị bỏ qua bởi modem GSM/GPRS hoặc điện thoại di động.AT + CMGD = 1, 4Ok

Kết quả (Việt) 2:

Cú pháp của + CMGD lệnh AT là: (tham số tùy chọn được đặt trong dấu ngoặc vuông.) + CMGD = chỉ số [, cờ] Ở dòng trên, chỉ số là một số nguyên xác định vị trí của tin nhắn SMS bị xóa từ tin nhắn khu vực lưu trữ bởi + CMGD AT lệnh, và lá cờ là một số nguyên xác định xem có nên xóa các tin nhắn SMS theo tình trạng thông điệp của họ. Các đặc điểm kỹ thuật SMS đã xác định những giá trị cờ: 0, 1, 2, 3 và 4. 0. Ý nghĩa: Xóa chỉ nhắn SMS được lưu trữ tại các chỉ số vị trí từ các khu vực lưu trữ tin nhắn. Đây là giá trị mặc ​​định. 1. Ý nghĩa: Bỏ qua các giá trị của chỉ số và xóa tất cả tin nhắn SMS có tình trạng là "nhận đọc" từ khu vực lưu trữ tin nhắn. 2. Ý nghĩa: Bỏ qua các giá trị của chỉ số và xóa tất cả tin nhắn SMS có tình trạng là "nhận đọc" hoặc "được lưu trữ gửi" từ khu vực lưu trữ tin nhắn. 3. Ý nghĩa: Bỏ qua các giá trị của chỉ số và xóa tất cả tin nhắn SMS có tình trạng là "nhận đọc", "lưu trữ chưa gửi" hoặc "được lưu trữ gửi" từ khu vực lưu trữ tin nhắn. 4. Có nghĩa là:. Bỏ qua các giá trị của chỉ số và xóa tất cả tin nhắn SMS từ khu vực lưu trữ nhắn Để tìm các giá trị cờ hỗ trợ GSM / GPRS modem của bạn hoặc điện thoại di động, bạn có thể thực hiện một hoạt động thử nghiệm bằng cách sử dụng + CMGD lệnh AT. Xem phần tiếp theo cho các chi tiết. 24.2. Tìm kiếm các chỉ số hỗ trợ và Cờ Giá trị Thực hiện một hoạt động thử nghiệm với lệnh + CMGD AT cho phép bạn tìm thấy tất cả các chỉ số được hỗ trợ bởi các tham số chỉ mục. Các hoạt động thử nghiệm cũng có thể trả lại tất cả các giá trị được hỗ trợ của các tham số cờ. Dưới đây là định dạng của các phản ứng thông tin trả về sau khi thực hiện các lệnh kiểm tra "+ CMGD =?": (Trường bắt buộc được kèm theo trong dấu ngoặc vuông.) + CMGD: (list_of_indexes) [, (list_of_flag_values)] Các giá trị bên trong đầu tiên ngoặc đơn là giá trị được hỗ trợ bởi các thông số chỉ số của + CMGD lệnh AT. các giá trị bên trong dấu ngoặc đơn thứ hai là các giá trị được hỗ trợ bởi các thông số cờ của lệnh + CMGD AT. Lưu ý: Một GSM / GPRS modem hoặc điện thoại di động có thể không cung cấp các giá trị từ các đặc điểm kỹ thuật SMS định nghĩa chúng như tùy chọn. Như một ví dụ, đây là phản ứng trở lại từ điện thoại di động Nokia 6021 của tôi để chương trình HyperTerminal của Windows sau khi thực hiện các bài kiểm tra lệnh "+ CMGD =?": AT + CMGD =? + CMGD: (1-10), (0-4) OK Từ trên, chúng ta biết rằng Nokia 6021 điện thoại di động cho phép bất kỳ số nguyên từ 1 đến 10 được giao cho các tham số chỉ số của các lệnh + CMGD AT. Ngoài ra, Nokia 6021 điện thoại di động hỗ trợ tất cả các năm giá trị cờ được định nghĩa trong đặc tả SMS. Bạn hãy nhớ rằng chúng tôi mô tả định dạng của giá trị bên trong dấu ngoặc đơn trong phần "Command Test - Kiểm tra Cho dù một số AT Command được hỗ trợ"? Nếu không, bạn có thể muốn quay trở lại và có một cái nhìn. Dưới đây là một vài ví dụ cho thấy một số khả năng: "(0-4)", "(0,1,2,3,4)", "(0,2-4)". 24.3. Ví dụ Chứng minh Làm thế nào để sử dụng + CMGD AT Command để Xoá tin nhắn SMS tin nhắn văn bản Bây giờ chúng ta hãy xem một ví dụ chứng minh làm thế nào để sử dụng + CMGD AT lệnh để xóa một tin nhắn văn bản SMS từ khu vực lưu trữ tin nhắn. Giả sử bạn đã viết một tin nhắn văn bản SMS đến các khu vực lưu trữ thông điệp bằng lệnh + CMGW AT (chi tiết về + CMGW AT lệnh có thể được tìm thấy trong phần trước "Viết tin nhắn SMS đến Memory / tin nhắn lưu trữ (AT + CMGW)" của SMS này hướng dẫn), như thế này: AT + CMGW = "+ 85291234567" > Một bản demo đơn giản của tin nhắn văn bản SMS. + CMGW: 1 OK các phản ứng thông tin của lệnh + CMGW AT cho chúng ta biết rằng các tin nhắn văn bản SMS được lưu trữ trong vị trí bộ nhớ tại chỉ số 1. để xóa các tin nhắn văn bản SMS, chỉ định 1 tới tham số chỉ số của các lệnh + CMGD AT, như thế này: (lưu ý quan trọng: Hãy chắc chắn rằng bạn đang viết tin nhắn văn bản đến và xóa các tin nhắn văn bản từ các lưu trữ cùng một thông điệp khu vực. Nếu không, bạn có thể xóa các tin nhắn văn bản sai. thông tin chi tiết về các khu vực lưu trữ tin nhắn có thể được tìm thấy trong phần trước "Preferred tin nhắn lưu trữ (AT + CPM)" của tin nhắn SMS hướng dẫn này.) AT + CMGD = 1 OK kết quả cuối cùng mã OK chỉ ra các tin nhắn văn bản SMS "Một bản demo đơn giản của tin nhắn văn bản SMS." đã được xóa thành công. Nếu hoạt động không thành, mã kết quả cuối cùng quay trở lại một trong hai sẽ được ERROR hoặc LỖI + CMS. Dưới đây là một ví dụ khác. Giả sử bạn muốn xóa tất cả tin nhắn SMS được lưu trữ trong các khu vực lưu trữ tin nhắn. Để làm điều này, gán 4 cho tham số cờ của lệnh + CMGD AT. Các giá trị được gán cho tham số chỉ số không quan trọng vì nó sẽ bị bỏ qua bởi GSM / GPRS modem hoặc điện thoại di động. AT CMGD = 1,4 OK