ofono发送GSM短信流程

以下为阅读ofono发送gsm短信流程笔记

1，上层通过DBus调用ofono的sms.c::sms_send_message

1）这一步传入参数：

• DBusConncetion conn
• DBusMessage *msg
  
  • to 收件人地址
  • text 短信内容
• void *data
  
  • ofono_sms *sms

2）从DBusMessage中取出text和to，验证to合法之后调用sms_text_prepare_with_alphabet,传入参数（to,text,sms->ref,flase,sms->use_delivery_reports,sms->alphabet）

2， 调用sms_text_prepare_with_alphabet

1）参数列表

• to : char*收件人地址
• utf8 : char* 短信内容
• ref : guint16 一个guint类型的值
• use_16bit : bool 为false
• use_delivery_reports : bool是否需要发送报告
• alphabet : sms_alphabet 枚举类型的字符表值

2）处理流程：

• 1)申请如下数据结构成员：
  
  • template sms的数据结构，包含userData，smsAddress
  • gsm_encoded char*经过gsm编码过后的数据
  • ucs2_encoded char*经过usc2编码的数据
  • seq
  • used_locking/used_single gsm编码用到的字符表
• 2)初始化sms：
  
  • type设为sms_type_submit
  • rd为false
  • vpf 为 sms_validity_period_format_relative
  • rp 为false
  • srr 为 use_delivery_reports
  • mr 为0
  • vp.relative 为 0xA7 24小时制
  • 调用sms_address_from_string将收件人地址to编码到submit.addr里面
• 3)调用convert_utf8_to_gsm_best_lang,传入参数：（utf8, -1, NULL, &written, 0, alphabet, &used_locking, &used_single）

3，调用convert_utf8_to_gsm_best_lang

1)参数列表：

• utf8 : char* utf8格式编码的源数据
• len ：long 长度，传入为-1
• items_read ：long* 返回值，读取数据
• items_written : long* 返回值，写入数据数量
• terminator : char 结束符
• hint ： gsm_dialect,这个结构体只代表字符表的名称，default，西班牙，土耳其等等.这里代表指定的字符表值
• used_locking : gsm_dialect* 返回值，字符表
• used_single : gsm_dialect* 返回值，字符表

2)声明本地变量 encoded : char*，然后调用convert_utf8_to_gsm_with_lang(utf8, len, items_read, items_written, terminator, locking, single)//字符表全是default

3.1，调用convert_utf8_to_gsm_with_lang

1)参数列表:

• text : char* utf8编码的字符串
• len ： long 长度这里还是-1
• items_read /items_written : long* 返回值，分别表示读了多少，写了多少
• terminator : char 结束符号
• locking_lang/single_lang : gsm_dialect 字符表

2)处理流程

• 1）声明conversion_table t,用于保存转换表，调用conversion_table_init方法通过传入的字符表值初始化转换表。
• 2）开始处理字符，因为len是-1，所以在in不为0的时候回一直在循环里面。调用g_utf8_get_char_validated(in, max)//in为输入数据，max为6，返回gunichar,这个gunichar是从in里面读取max个字符组成的大unicodechar，
  
  • 如果大于0xFFFF的值则表明非法跳转到err_out
  • 调用unicode_locking_shift_lookup,使用得到的unicode char作为key去unicodeToGsm字符表中查找value，查不到返回0xFFFF
  • 上一步查找失败的话再去扩展字符表查找，查不到返回0xFFFF，还是查不到的话就去goto err_out
  • 如果查到的话，0x1b开头的话表示双字节gsm字符，否则表示单字节gsm字符（都是GSMAlphabet字符表定义的）
  • in跳转到下一个unicode字符的开端（宏定义实现的），nchars+1，unicode的字符数量+1
  • 这样往复循环，有一个查不到的unicode字符就转到err_out
• 3)得到了unicode字符数，也得到了gsm字符数，把传入的utf8字符转成gsm，循环结束，返回结果。
• 4）错误处理：返回读取字符的数目，读了多少就返回多少
• 5）返回res，如果不成功的话基本上就是返回NULL

3）如果3.1中编码成功就返回，如果编码不成功，切传入的hint指定字符表为GSM-Default,说明无法编码数据，返回NULL，否则使用hint指定的字符集名称作为扩展表再次尝试编码。
4）如果仅仅拿来作为扩展表编码失败就用hint作为主表再次尝试编码（GSM_DIALECT_SPANISH主表就是默认的不用再次尝试），如果主表和扩展表全用hint还是无法编码就返回null，否则返回编码的数据
5）如果编码成功，将编码所用的字符表名称通过两个返回值，返回给调用者。

4, 继续sms_text_prepare_with_alphabet

1） 调用g_convert方法将utf8的字符串转换成USC2
2）如果转换的gsmencoded和usc2_encoded均为NULL就返回结果NULL
3）如果不都为NULL就通过template.submit.dcs记录编码方式

    0x00对应7bit gsm
    0x08对应UCS2

4)如果编码结果是gsm，将编码使用的字符表的名称写入到template.submit.ud中
5）如果是单条短信，直接调用pack_7bit_own_buf方法吧编码好的gsm加到template.submit.ud里面或者如果编码结果是ucs2的数据，直接加到template.submit.ud后面就可以。最后调用sms_list_append加入list然后返回。
6）对于长短信每次从编码好的数据中取出一个chunk（msgSize - headSize）大小的数据放到sms中并append到list中。最后返回list

 鉴于MarkDown流程图超宽无法显示，流程图原始文字贴出来如下：
sms.c->common.c:valid_phone_number_format
common.c-->sms.c:true(valid)or not
Note left of sms.c:if false\n will terminal
sms.c->smsutils.c:sms_text_prepare_with_alphabet
smsutils.c->util.c:convert_utf8_to_gsm_best_lang
util.c->util.c:convert_utf8_to_gsm_with_lang
util.c->gutf8.c:g_utf8_get_char_validated
gutf8.c->gutf8.c:g_utf8_get_char_extended
Note right of gutf8.c:will return \nthe unicodechar
gutf8.c-->util.c:return the \nvalid unicodechar
util.c-->smsutils.c:return the\n encodeed text
smsutils.c-->sms.c:return the list \n of messages
Note right of sms.c:this message list\n will be sent to modem with debus