1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
|
/*
* Copyright (C) 2009 Mamadou Diop.
*
* Contact: Mamadou Diop <diopmamadou(at)doubango.org>
*
* This file is part of Open Source Doubango Framework.
*
* DOUBANGO is free software: you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* DOUBANGO is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with DOUBANGO.
*
*/
/**@file tsms_tpdu_command.h
* @brief SMS TPDU SMS-COMMAND message as per 3GPP TS 23.040 section 9.2.2.4.
*
* @author Mamadou Diop <diopmamadou(at)doubango.org>
*
*/
#ifndef TINYSMS_TSMS_TPDU_COMMAND_H
#define TINYSMS_TSMS_TPDU_COMMAND_H
#include "tinysms_config.h"
#include "tinysms/tsms_common.h"
TSMS_BEGIN_DECLS
/** TP-Command-Type (TP-CT) as per 3GPP TS 23.040 section 9.2.3.19.
* An 8-bit field.
*/
typedef enum tsms_tpdu_cmd_e
{
tsms_tpdu_cmd_rel = 0x00, /**< Enquiry relating to previously submitted short message. */
tsms_tpdu_cmd_cancel = 0x01, /**< Cancel Status Report Request relating to previously submitted short message. */
tsms_tpdu_cmd_delete = 0x02, /**< Delete previously submitted Short Message. */
tsms_tpdu_cmd_enable_status = 0x03, /**< Enable Status Report Request relating to previously submitted short message. */
/* 00000100..00011111 ==> Reserved */
/* 11100000..11111111 ==> Values specific for each SC */
}
tsms_tpdu_cmd_t;
/** SMS TPDU SMS-COMMAND message as per 3GPP TS 23.040 section 9.2.2.4.
*/
typedef struct tsms_tpdu_command_s
{
TSMS_DECLARE_TPDU_MESSAGE;
tsms_address_t* smsc;
/** TP-User-Data-Header-Indication (O - 1b)
* Parameter indicating that the TP-CD field contains a Header. */
unsigned udhi:1;
/** TP Status Report Request (O - 1b)
* Parameter indicating if the SMS Command is requesting a status report. */
unsigned srr:1;
/** TP Message Reference (M - I)
* Parameter identifying the SMS COMMAND. */
uint8_t mr;
/** TP Protocol Identifier (M - o)
* Parameter identifying the above layer protocol, if any. */
//(base)uint8_t pid;
/** TP Command Type (M - o)
* Parameter specifying which operation is to be performed on a SM.
* See section 9.2.3.19 */
tsms_tpdu_cmd_t ct;
/** TP Message Number (M - o)
* Parameter indicating which SM in the SC to operate on.
* See section 9.2.3.18 */
uint8_t mn;
/** TP Destination Address (M - 2-12o)
* Parameter indicating the Destination Address to which the TP Command refers. */
tsms_address_t* da;
/** TP Command Data Length (M - o)
* Parameter indicating the length of the TP-CD field in octets. */
//(base)uint8_t cdl;
/** TP Command Data (O - o)
* Parameter containing user data. */
//(base)uint8_t cd;
}
tsms_tpdu_command_t;
/** cast any pointer to @ref tsms_tpdu_command_t* */
#define TSMS_TPDU_COMMAND(self) ((tsms_tpdu_command_t*)(self))
TINYSMS_API tsms_tpdu_command_t* tsms_tpdu_command_create(uint8_t mr, const tsms_address_string_t smsc, const tsms_address_string_t dest, uint8_t msg_num, tsms_tpdu_cmd_t cmd);
/**@ingroup tsms_tpdu_group
* @def tsms_tpdu_command_serialize
* Serializes a @a SMS-COMMAND message as binary content.
* @param self A pointer to the @a SMS-COMMAND (@ref tsms_tpdu_command_t) message to serialize.
* @param output A pointer to the output buffer. Should be valid.
* @retval Zero if succeed and non-zero error code otherwise.
*
* See For more information, see @ref tsms_tpdu_group_COMMAND "SMS-COMMAND".
*/
/**@ingroup tsms_tpdu_group
* @def tsms_tpdu_command_tohexastring
* Serializes a @a SMS-COMMAND message as hexa-string content.
* @param self A pointer to the @a SMS-COMMAND (@ref tsms_tpdu_command_t) message to serialize.
* @retval A pointer to the hexa-string if succeed and Null otherwise.
*
* See For more information, see @ref tsms_tpdu_group_COMMAND "SMS-COMMAND".
*/
/**@ingroup tsms_tpdu_group
* @def tsms_tpdu_command_set_cmddata
* Sets the content of the @a SMS-COMMAND message.
* @param self A pointer to the @a SMS-COMMAND (@ref tsms_tpdu_command_t).
* @param cdata A pointer to the content.
* @retval Zero if succeed and non-zero error code otherwise.
*
* See For more information, see @ref tsms_tpdu_group_COMMAND "SMS-COMMAND".
*/
#define tsms_tpdu_command_serialize(self, output) tsms_tpdu_message_serialize(TSMS_TPDU_MESSAGE(self), output, tsk_true)
#define tsms_tpdu_command_tostring(self) tsms_tpdu_message_tostring(TSMS_TPDU_MESSAGE(self), tsk_true)
#define tsms_tpdu_command_tohexastring(self) tsms_tpdu_message_tohexastring(TSMS_TPDU_MESSAGE(self), tsk_true)
#define tsms_tpdu_command_set_cmddata(self, cdata) tsms_tpdu_message_set_userdata(TSMS_TPDU_MESSAGE(self), cdata, tsms_alpha_8bit)
TINYSMS_GEXTERN const tsk_object_def_t *tsms_tpdu_command_def_t;
TSMS_END_DECLS
#endif /* TINYSMS_TSMS_TPDU_COMMAND_H */
|
