Keil Studio Cloud
Mistake on this page?
Report an issue in GitHub or email us
AT_CellularSMS.h
1 /*
2  * Copyright (c) 2017, Arm Limited and affiliates.
3  * SPDX-License-Identifier: Apache-2.0
4  *
5  * Licensed under the Apache License, Version 2.0 (the "License");
6  * you may not use this file except in compliance with the License.
7  * You may obtain a copy of the License at
8  *
9  * http://www.apache.org/licenses/LICENSE-2.0
10  *
11  * Unless required by applicable law or agreed to in writing, software
12  * distributed under the License is distributed on an "AS IS" BASIS,
13  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14  * See the License for the specific language governing permissions and
15  * limitations under the License.
16  */
17 
18 #ifndef AT_CELLULAR_SMS_H_
19 #define AT_CELLULAR_SMS_H_
20 
21 #if MBED_CONF_CELLULAR_USE_SMS
22 
23 #include "CellularSMS.h"
24 #include "AT_CellularBase.h"
25 #include "Callback.h"
26 #include <time.h>
27 
28 namespace mbed {
29 
30 /**
31  * Class AT_CellularSMS
32  *
33  * Class for SMS sending, reading and deleting.
34  */
35 class AT_CellularSMS: public CellularSMS, public AT_CellularBase {
36 
37 public:
38  AT_CellularSMS(ATHandler &atHandler);
39  virtual ~AT_CellularSMS();
40 
41 public:
42  // from CellularSMS
43 
44  virtual nsapi_error_t initialize(CellularSMSMmode mode,
45  CellularSMSEncoding encoding = CellularSMSEncoding7Bit);
46 
47  virtual nsapi_size_or_error_t send_sms(const char *phone_number, const char *message, int msg_len);
48 
49  virtual nsapi_size_or_error_t get_sms(char *buf, uint16_t buf_len, char *phone_num, uint16_t phone_len,
50  char *time_stamp, uint16_t time_len, int *buf_size);
51 
52  virtual void set_sms_callback(Callback<void()> func);
53 
54  virtual nsapi_error_t set_cpms(const char *memr, const char *memw, const char *mems);
55 
56  virtual nsapi_error_t set_csca(const char *sca, int type);
57 
58  virtual nsapi_size_or_error_t set_cscs(const char *chr_set);
59 
60  virtual nsapi_error_t delete_all_messages();
61 
62  virtual void set_extra_sim_wait_time(int sim_wait_time);
63 
64 private:
65 
66  struct sms_info_t {
67  char date[SMS_MAX_TIME_STAMP_SIZE];
68  uint16_t msg_index[50]; // can hold up to 50 concatenated msg parts, indexes are in correct order. So max sms size is 50*140 = 7kb
69  uint16_t msg_size;
70  uint8_t parts;
71  uint8_t parts_added;
72  uint16_t msg_ref_number;
73  struct sms_info_t *next_info;
74  sms_info_t() : msg_size(0), parts(1), parts_added(1), msg_ref_number(0), next_info(0) {};
75  };
76 
77  // application callback function for received sms
78  Callback<void()> _cb;
79  CellularSMSMmode _mode;
80  bool _use_8bit_encoding;
81  uint32_t _sim_wait_time;
82  uint16_t _sms_message_ref_number;
83  sms_info_t *_sms_info;
84 
85  // SMS urc's
86  void cmt_urc();
87  void cmti_urc();
88 
89  /** Set command selects the format of messages used with send, list, read and write commands.
90  *
91  * @param msg_format 0 PDU mode, 1 text mode
92  * @return zero for success
93  */
94  nsapi_error_t set_cmgf(int msg_format);
95 
96  /** Set how receiving of new messages from the network is indicated to the TE.
97  *
98  * @return zero for success
99  */
100  nsapi_error_t set_cnmi();
101 
102  /** Set Text Mode Parameters
103  *
104  * @param fo See more from 3GPP TS 27.005 for all params.
105  * @param vp
106  * @param pid
107  * @param dcs
108  * @return zero for success
109  */
110  nsapi_error_t set_csmp(int fo, int vp, int pid, int dcs);
111 
112  /** CSDH - Set command controls whether detailed header information is shown in text mode (AT+CMGF=1) result codes.
113  *
114  * @param show_header 1 to show detailed header in text mode, 0 for not showing.
115  * @return zero for success
116  */
117  nsapi_error_t set_csdh(int show_header);
118 
119  /** Delete SMS in the given message position(s) in the storage
120  *
121  * @param sms struct containing index array to delete
122  * @return zero for success
123  */
124  nsapi_error_t delete_sms(sms_info_t *sms);
125 
126  /**
127  * Internal helper methods
128  */
129  nsapi_error_t list_messages();
130  int read_sms_params(char *, char *);
131  void free_linked_list();
132  void add_info(sms_info_t *info, int index, int part_number);
133  int read_udh_from_pdu(const char *pdu, sms_info_t *info, int &part_number, int &padding_bits);
134  nsapi_size_or_error_t get_data_from_pdu(const char *pdu, sms_info_t *info, int *part_number,
135  char *phone_number = NULL, char *msg = NULL);
136  nsapi_size_or_error_t read_pdu_payload(const char *pdu, int msg_len, int scheme, char *msg, int padding_bits);
137  sms_info_t *get_oldest_sms_index();
138  bool create_time(const char *time_string, time_t *time);
139  int compare_time_strings(const char *time_string_1, const char *time_string_2);
140  char *create_pdu(const char *phone_number, const char *message, uint8_t message_length, uint8_t msg_parts,
141  uint8_t msg_part_number, uint8_t &header_size);
142  nsapi_size_or_error_t read_sms_from_index(int msg_index, char *buf, uint16_t len, char *phone_num,
143  char *time_stamp);
144  nsapi_size_or_error_t read_sms(sms_info_t *sms, char *buf, char *phone_num, char *time_stamp);
145 
146  /** Packs the given str from ascii to 7bit gsm format and converts it to hex to the given buf.
147  *
148  * @param str string that is to be converted
149  * @param len length of the str buffer
150  * @param buf preallocated buffer that holds the converted string in hex format after successful call
151  * @param number_of_padding_bit padding bits needed to keep the octet boundary
152  * @return length of buffer buf or zero on failure
153  */
154  uint16_t pack_7_bit_gsm_and_hex(const char *str, uint16_t len, char *buf, int number_of_padding_bit);
155 
156  /** Unpacks the given hex- and 7-bit gsm encoded str to ascii string
157  *
158  * @param str string to convert to ascii string and write to buf
159  * @param len length of the str divided by two as str is hexencoded
160  * @param buf preallocated destination buffer
161  * @param padding_bits number of padding bits needed to hold the octet boundary
162  * @param msg_len Length of the received message, which is coded in str
163  * @return length of the destination buffer buf
164  *
165  */
166  uint16_t unpack_7_bit_gsm_to_str(const char *str, int len, char *buf, int padding_bits,
167  int msg_len);
168 };
169 
170 } // namespace mbed
171 
172 #endif //MBED_CONF_CELLULAR_USE_SMS
173 
174 #endif // AT_CELLULAR_SMS_H_
info
The key size.
Definition: kvstore_global_api.h:38
nsapi_error_t
signed int nsapi_error_t
Type used to represent error codes.
Definition: nsapi_types.h:95
nsapi_size_or_error_t
signed int nsapi_size_or_error_t
Type used to represent either a size or error passed through sockets.
Definition: nsapi_types.h:106
Important Information for this Arm website

This site uses cookies to store information on your computer. By continuing to use our site, you consent to our cookies. If you are not happy with the use of these cookies, please review our Cookie Policy to learn how they can be disabled. By disabling cookies, some features of the site will not work.