LuatOS/components/sms/include/luat_sms.h

/*
 * Copyright (c) 2022 OpenLuat & AirM2M
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy of
 * this software and associated documentation files (the "Software"), to deal in
 * the Software without restriction, including without limitation the rights to
 * use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
 * the Software, and to permit persons to whom the Software is furnished to do so,
 * subject to the following conditions:
 *
 * The above copyright notice and this permission notice shall be included in all
 * copies or substantial portions of the Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
 * FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
 * COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
 * IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
 * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 */

#ifndef LUAT_SMS_H
#define LUAT_SMS_H

#include "luat_base.h"

#ifndef bool
#define bool    uint8_t
#endif

/**
 * @defgroup LUAT_SMS  SMS接口
 * @{
 */
#define LUAT_MSG_MAX_ADDR_LEN 80
#define LUAT_SMS_MAX_TXT_SIZE 640
#define LUAT_SMS_MAX_PDU_SIZE 180
#define LUAT_SMS_MAX_LENGTH_OF_ADDRESS_VALUE 40
#define LUAT_SMS_MAX_ADDR_STR_MAX_LEN ((LUAT_SMS_MAX_LENGTH_OF_ADDRESS_VALUE + 1) * 4)

#define LUAT_SMS_SHORT_MSG_PDU_SIZE (140)
#define LUAT_SMS_LONG_MSG_PDU_SIZE (134)


#define LUAT_SMS_CODE_7BIT 0
#define LUAT_SMS_CODE_8BIT 4
#define LUAT_SMS_CODE_UCS2 8


typedef void (*luat_sms_handle_recv_cb)(uint8_t event, void* param);
typedef void (*luat_sms_handle_send_cb)(int ret);

typedef enum
{
    SMS_SEND_OK = 0,
    SMS_ME_FAILURE = 300,
    SMS_SERVICE_OF_ME_RESV,
    SMS_OPERATION_NOT_ALLOWED,
    SMS_OPERATION_NOT_SUPPORTED,
    SMS_INVALID_PDU_MODE_PARAMETER,
    SMS_INVALID_TEXT_MODE_PARAMETER,
    SMS_USIM_NOT_INSERTED = 310,
    SMS_USIM_PIN_REQUIRED,
    SMS_PHSIM_PIN_REQUIRED,
    SMS_USIM_FAILURE,
    SMS_USIM_BUSY,
    SMS_USIM_WRONG,
    SMS_USIM_PUK_REQUIRED,
    SMS_USIM_PIN2_REQUIRED,
    SMS_USIM_PUK2_REQUIRED,
    SMS_MEMORY_FAILURE = 320,
    SMS_INVALID_MEM_INDEX,
    SMS_MEM_FULL,
    SMS_SMSC_ADDR_UNKNOWN = 330,
    SMS_NO_NETWORK_SERVICE,
    SMS_NETWORK_TIMEOUT,
    SMS_NO_CNMA_ACK_EXPECTED = 340,
    SMS_UNKNOWN_ERROR = 500,
    SMS_INVALID_DATA  = 550,
    SMS_UNSUPPORT_TEXT_WITH_CHINESE = 555,
    SMS_MAX_ERROR = 0xFFFF
}luat_sms_send_ret_code_e;

typedef struct
{
    luat_sms_handle_recv_cb cb;
    luat_sms_handle_send_cb send_cb;
}luat_sms_cb_cfg_t;

typedef struct
{
    uint8_t   year;
    uint8_t   month;
    uint8_t   day;
    uint8_t   hour;
    uint8_t   minute;
    uint8_t   second;
    uint8_t   tz;         /* time zone */
    uint8_t   tz_sign;     /* '+'/'-' */
}luat_sms_recv_msg_time_t;

typedef struct
{
    uint8_t  type;
    uint8_t  msg_class;
    uint8_t  alpha_bet;
    uint8_t  indication;
    uint8_t  dcs;
}luat_sms_recv_msg_dcs_t;

//接受的短信信息结构体
typedef struct
{
    uint16_t pdu_length;//PDU 长度
    uint16_t sms_length;//TEXT 的长度
    luat_sms_recv_msg_time_t time;//时间
    luat_sms_recv_msg_dcs_t dcs_info;//Data Coding Scheme
    char pdu_data[LUAT_SMS_MAX_TXT_SIZE + 1];//PDU 数据
    uint8_t sms_buffer[LUAT_SMS_MAX_TXT_SIZE + 1];//TEXT 数据
    uint8_t sc_address[LUAT_MSG_MAX_ADDR_LEN + 1];//中心地址
    uint8_t phone_address[LUAT_MSG_MAX_ADDR_LEN + 1];//来电号码
    uint8_t refNum;
    uint8_t maxNum;
    uint8_t seqNum;
}luat_sms_recv_msg_t;


typedef struct 
{
    size_t phone_len;           // 电话号码长度
    size_t payload_len;         // 待组包的短信数据长度
    const char *phone;          // 电话号码
    uint8_t pdu_buf[320];       // 组包后的PDU短信
    uint8_t payload_buf[200];   // 待组包的短信数据
    uint8_t auto_phone;         // 是否自动处理电话号码
    uint8_t maxNum;             // 短信最大条数， 长短信用
    uint8_t seqNum;             // 当前短信序号
    uint8_t refNum;
}luat_sms_pdu_packet_t;

/**
 * @brief 初始化短信
 */
void luat_sms_init(void);

/**
 * @brief 发送短信
 * @param p_input           短信的内容(当 is_pdu = false 时, 只支持英文，数字以及常用符号)
 * @param p_des             接收短信的手机号
 * @param is_pdu            是否是PDU格式的短信(当 false 时, 有效参数为 p_input & pdes, 当 true 时, 有效参数为 p_input & pudLen)
 * @param input_pdu_len     PDU格式短信的长度，注意和p_input长度没有关系
 * @return 0成功,-1失败
 */
int luat_sms_send_msg(uint8_t *p_input, char *p_des, bool is_pdu, int input_pdu_len);

/**
 * @brief 发送PDU短信
 * @param pdu_data          PDU格式的短信
 * @param pdu_len           PDU格式短信的长度
 * @return 0成功,-1失败
 */
int luat_sms_send_msg_v2(uint8_t *pdu_data, size_t pdu_len);

/**
 * @brief 接受短信回调
 * @param callback_fun    回调函数
 */
void luat_sms_recv_msg_register_handler(luat_sms_handle_recv_cb callback_fun);


/**
 * @brief 发送短信回调
 * @param callback_fun    回调函数
 */
void luat_sms_send_msg_register_handler(luat_sms_handle_send_cb callback_fun);

/**
 * @brief 打包pdu数据
 * @param packet    
 */
int luat_sms_pdu_packet(luat_sms_pdu_packet_t *packet);

uint8_t luat_sms_gsm_to_ascii(uint8_t *gsm_data, uint8_t length);

uint16_t luat_sms_decode_7bit_data(uint8_t *src, uint16_t src_len, uint8_t *dst, uint16_t dst_len, uint16_t shift_bits);

void luat_sms_pdu_message_unpack(luat_sms_recv_msg_t *msg_info, uint8_t *pdu_data, int pdu_len);

/**@}*/
#endif