/*****************************************************************************
函 数 名 : mailbox_request_channel
接口类型 : 对外接口
功能描述 : 打开一个邮箱通道，准备开始写或者一封邮件。
根据现有的邮箱通道号，创建一个邮箱操作符号，并根据邮箱头填充邮箱操作符信息
输入参数 : struct mb *mailbox 邮箱控制总句柄
unsigned long mailcode -- 待访问邮件的ID
输出参数 : 无
返 回 值 : 一个邮箱通道的操作符
调用函数 :
被调函数 :
修改历史 :
1.日 期 : 2012年9月27日
作 者 : 莫南 00176101
修改内容 : 新生成函数
*****************************************************************************/
MAILBOX_EXTERN struct mb_buff *mailbox_get_channel_handle(
struct mb *mailbox,
unsigned long mailcode)
{
struct mb_link *link_array = MAILBOX_NULL;
struct mb_buff *mbuff = MAILBOX_NULL;
unsigned long src_id = 0;
unsigned long dst_id = 0;
unsigned long carrier_id = 0;
src_id = mailbox_get_src_id(mailcode);
dst_id = mailbox_get_dst_id(mailcode);
carrier_id = mailbox_get_carrier_id(mailcode);
if (src_id == mailbox->local_id) {
if (dst_id < MAILBOX_CPUID_BUTT) {
link_array = &mailbox->send_tbl[dst_id];
} else {
/*无效目标号，数组越界*/
mailbox_logerro_p1(MAILBOX_ERR_GUT_INVALID_CHANNEL_ID, mailcode);
return MAILBOX_NULL;
}
} else if (dst_id == mailbox->local_id) {
if (src_id < MAILBOX_CPUID_BUTT) {
link_array = &mailbox->recv_tbl[src_id];
} else {
/*无效目标号，数组越界*/
mailbox_logerro_p1(MAILBOX_ERR_GUT_INVALID_CHANNEL_ID, mailcode);
return MAILBOX_NULL;
}
} else {
/*此处已在收发入口判断*/
}
if ((MAILBOX_NULL == link_array) || (0 == link_array->carrier_butt)) {
/*当前两个CPU之间不存在任何邮箱通道*/
mailbox_logerro_p1(MAILBOX_ERR_GUT_INVALID_CPU_LINK, mailcode);
return MAILBOX_NULL;
}
/*获得通道操作句柄*/
if (carrier_id < link_array->carrier_butt) {
mbuff = &link_array->channel_buff[carrier_id];
} else {
/*非法载体号，数组越界*/
mailbox_logerro_p1(MAILBOX_ERR_GUT_INVALID_CARRIER_ID, mailcode);
return MAILBOX_NULL;
}
/*检查mail code中 use ID的合法性*/
if (mailbox_get_use_id(mailcode) >= mailbox_get_use_id(mbuff->config->butt_id)) {
mailbox_logerro_p1(MAILBOX_ERR_GUT_INVALID_USER_ID, mailcode);
#ifndef _DRV_LLT_ /*PC工程允许发送非法use ID，用于测试接收通道代码分支*/
return MAILBOX_NULL;
#endif
}
return mbuff;
}
MAILBOX_EXTERN long mailbox_register_cb(
unsigned long mailcode,
void (*cb)(void *mbuf, void *handle, void *data),
void *usr_handle,
void *usr_data)
{
struct mb_cb *read_cb = MAILBOX_NULL;
struct mb_buff *mbuf = MAILBOX_NULL;
struct mb *mb = MAILBOX_NULL;
unsigned long dst_id;
mb = &g_mailbox_handle;/*有可能在初始化过程中注册*/
/* 允许注册空回调，相当于UnRegister
if (MAILBOX_NULL == pFun)
{
return mailbox_logerro_p1(MAILBOX_ERR_GUT_MAILBOX_NULL_PARAM, mailcode);
}
*/
/*往某个CPU的某个邮箱通道中的某个邮件应用用注册回调函数*/
dst_id = mailbox_get_dst_id(mailcode);
printk("mb->local_id = %ld dst_id = %ld\n", mb->local_id, dst_id);
if (mb->local_id != dst_id) {
return mailbox_logerro_p1(MAILBOX_ERR_GUT_INVALID_TARGET_CPU, mailcode);
}
mbuf = mailbox_get_channel_handle(mb, mailcode);
if (MAILBOX_NULL == mbuf) {
/*找不到，此通道未初始化。*/
return mailbox_logerro_p1(MAILBOX_ERR_GUT_INVALID_CHANNEL_ID, mailcode);
}
/*检查OK, 赋值给回调函数指针*/
read_cb = &mbuf->read_cb[mailbox_get_use_id(mailcode)];
if (MAILBOX_NULL != read_cb->func) {
/*mailbox_logerro_p1(MAILBOX_WARNING_USER_CALLBACK_ALREADY_EXIST, mailcode);*/
}
mailbox_mutex_lock(&mbuf->mutex);
read_cb->handle = usr_handle;
read_cb->data = usr_data;
read_cb->func = cb;
mailbox_mutex_unlock(&mbuf->mutex);
return MAILBOX_OK;
}
/*****************************************************************************
函 数 名 : mailbox_init_all_handle
接口类型 : 对内接口
功能描述 : 初始化邮箱的所有通道句柄
输入参数 : struct mb *mb -- 邮箱总句柄
struct mb_cfg *config -- 邮箱通道的全局配置表。
unsigned long cpu_id -- 注册此通道的CPU号。
输出参数 : 无
返 回 值 : 邮箱操作句柄
调用函数 :
被调函数 :
修改历史 :
1.日 期 : 2012年9月7日
作 者 : 莫南 00176101
修改内容 : 新生成函数
*****************************************************************************/
MAILBOX_LOCAL long mailbox_init_all_handle(
struct mb *mb,
struct mb_cfg *config,
unsigned long cpu_id)
{
struct mb_queue *queue = MAILBOX_NULL;
unsigned long direct= MIALBOX_DIRECTION_INVALID; /*标记当前邮箱通道
是不是本核相关的有效通道*/
unsigned long ret_val = MAILBOX_OK;
struct mb_link *send_link = MAILBOX_NULL;/*指向主结构体的发送通道
数组基地址*/
struct mb_link *recv_link = MAILBOX_NULL; /*指向主结构体的接收通道
数组基地址*/
struct mb_buff *mbuf_prob = &g_mailbox_channel_handle_pool[0];
struct mb_cb *cb_prob = &g_mailbox_user_cb_pool[0];
struct mb_buff *mbuf_cur = MAILBOX_NULL; /*指向正在处理的邮箱通道*/
unsigned long channel_sum = 0;
unsigned long use_sum = 0;
unsigned long src_id = 0;
unsigned long dst_id = 0;
unsigned long carrier_id = 0;
unsigned long use_max = 0;
send_link = mb->send_tbl;
recv_link = mb->recv_tbl;
/*第二次循环对每个通道句柄分配空间,并赋值。(这段代码变量太多，不方便拆开另建函数)*/
/*初始化每个邮箱的控制句柄*/
while (MAILBOX_MAILCODE_INVALID != config->butt_id) {
direct = MIALBOX_DIRECTION_INVALID;
src_id = mailbox_get_src_id(config->butt_id);
dst_id = mailbox_get_dst_id(config->butt_id);
carrier_id = mailbox_get_carrier_id(config->butt_id);
use_max = mailbox_get_use_id(config->butt_id);
/*检查是不是本CPU发送通道*/
if (cpu_id == src_id) {
direct = MIALBOX_DIRECTION_SEND;
/*没有分配空间则分配空间*/
if (MAILBOX_NULL == send_link[dst_id].channel_buff) {
send_link[dst_id].channel_buff = mbuf_prob;
mbuf_prob += (send_link[dst_id].carrier_butt);
channel_sum += (send_link[dst_id].carrier_butt);
if (channel_sum > MAILBOX_CHANNEL_NUM) {
return mailbox_logerro_p1(MAILBOX_CRIT_GUT_INIT_CHANNEL_POOL_TOO_SMALL,
channel_sum);
}
}
mbuf_cur = &send_link[dst_id].channel_buff[carrier_id];
}
/*检查是不是本CPU接收通道*/
if (cpu_id == dst_id) {
direct = MIALBOX_DIRECTION_RECEIVE;
/*没有分配空间则分配空间*/
if (MAILBOX_NULL == recv_link[src_id].channel_buff) {
recv_link[src_id].channel_buff = mbuf_prob;
mbuf_prob += (recv_link[src_id].carrier_butt);
channel_sum += (recv_link[src_id].carrier_butt);
if (channel_sum > MAILBOX_CHANNEL_NUM) {
return mailbox_logerro_p1(MAILBOX_CRIT_GUT_INIT_CHANNEL_POOL_TOO_SMALL,
channel_sum);
}
}
mbuf_cur = &recv_link[src_id].channel_buff[carrier_id];
/*1。为邮件注册回调函数申请空间*/
mbuf_cur->read_cb = cb_prob;
cb_prob += use_max;
use_sum += use_max;
if (use_sum > MAILBOX_USER_NUM) {
return mailbox_logerro_p1(MAILBOX_CRIT_GUT_INIT_USER_POOL_TOO_SMALL, use_sum);
}
/*3.注册邮箱线程回调接口，用于获取共享内存邮箱数据的处理*/
ret_val = mailbox_process_register(mailbox_get_channel_id(config->butt_id),
mailbox_read_channel, mbuf_cur);
/*4.初始化邮箱共享内存，设置标志位。*/
ret_val |= mailbox_init_mem(config);
}
if ((MIALBOX_DIRECTION_INVALID != direct ) && (MAILBOX_NULL != mbuf_cur)) {
/*给控制句柄赋予邮箱ID号*/
mbuf_cur->channel_id = mailbox_get_channel_id(config->butt_id);
mbuf_cur->seq_num = MAILBOX_SEQNUM_START;
#ifdef MAILBOX_OPEN_MNTN
mbuf_cur->mntn.peak_traffic_left = MAILBOX_QUEUE_LEFT_INVALID;
mbuf_cur->mntn.mbuff = mbuf_cur;
#endif
/*给邮箱配置物理资源*/
mbuf_cur->config = config;
/*初始化通道资源*/
queue = &(mbuf_cur->mail_queue);
/*初始化邮箱通道的环形队列控制符，以下两项是初始化以后不会再变化的。*/
queue->length = mbuf_cur->config->data_size -
(MAILBOX_DATA_LEN_PROTECT_NUM * MAILBOX_PROTECT_LEN);
queue->base = mbuf_cur->config->data_addr +
(MAILBOX_DATA_BASE_PROTECT_NUM * MAILBOX_PROTECT_LEN);
/*把此通道注册到具体平台*/
ret_val = mailbox_channel_register(mailbox_get_channel_id(config->butt_id), /*lint !e539*/
config->int_src,
mailbox_get_dst_id(config->butt_id),
direct,
&mbuf_cur->mutex);
}
config++;
}
/*检查内存池大小是否刚好,如果报错，请检查宏设置是否匹配:
这里检查下面三个数组的空间是否适配。
g_mailbox_global_cfg_tbl[];
g_mailbox_channel_handle_pool[MAILBOX_CHANNEL_NUM];
g_mailbox_user_cb_pool[MAILBOX_USER_NUM];
*/
if((unsigned long)MAILBOX_CHANNEL_NUM != channel_sum ) {
ret_val = mailbox_logerro_p1(MAILBOX_ERR_GUT_INIT_CHANNEL_POOL_TOO_LARGE,
(MAILBOX_CHANNEL_NUM<<16) | channel_sum);
}
if(MAILBOX_USER_NUM != use_sum) {
ret_val = mailbox_logerro_p1(MAILBOX_ERR_GUT_INIT_USER_POOL_TOO_LARGE, use_sum);
}
return ret_val;
}
/*****************************************************************************
函 数 名 : mailbox_read_mail
接口类型 : 对内接口
功能描述 : 读取并处理一封邮箱的正文数据内容,接受邮箱数据的数据层入口，
并且调用上层注册的邮件数据处理回调函数
输入参数 : mb_buff* mbuff - 邮箱通道操作符
输出参数 : 无
返 回 值 : 读取的邮件数据长度，包括邮件头，返回0表示失败。
调用函数 :
被调函数 :
修改历史 :
1.日 期 : 2012年9月24日
作 者 : 莫南 00176101
修改内容 : 新生成函数
*****************************************************************************/
MAILBOX_LOCAL long mailbox_read_mail(struct mb_buff *mbuff)
{
struct mb_mail mail;
struct mb_cb *read_cb = MAILBOX_NULL;/*此邮箱通道的功能回调函数队列*/
struct mb_queue tmp_queue;
struct mb_queue *usr_queue = MAILBOX_NULL;
struct mb_queue *m_queue = MAILBOX_NULL;
unsigned long use_id;
unsigned long slice_start;
unsigned long to_bottom;
void *usr_handle;
void *usr_data;
void (*usr_func)(void *mbuf, void *handle, void *data);
m_queue = &(mbuff->mail_queue);
usr_queue = &(mbuff->usr_queue);
mailbox_memcpy((void *) usr_queue, (const void *) m_queue, sizeof(struct mb_queue));
/*保存临时队列状态,交换读写指针。*/
tmp_queue.base = usr_queue->base;
tmp_queue.length = usr_queue->length;
tmp_queue.front = usr_queue->rear;
tmp_queue.rear = usr_queue->front;
/*读取邮件的头信息*/
mailbox_queue_read(usr_queue, (char*)&mail, sizeof(struct mb_mail));
/*1.检查邮件头，判断读到的消息是否存在异常，包括SN号是否连续、消息滞留时间是否过长。
2.填充信息读取时间*/
mailbox_check_mail(mbuff, &mail, m_queue->rear);
/*把读取时间写回邮箱队列*/
mailbox_queue_write(&tmp_queue, (char*)&mail, sizeof(struct mb_mail));
use_id = mailbox_get_use_id(mail.ulMailCode);
/*检查Use ID的有效性*/
if (use_id >= mailbox_get_use_id(mbuff->config->butt_id)) {
mailbox_logerro_p1(MAILBOX_ERR_GUT_INVALID_USER_ID, mail.ulMailCode);
goto EXIT;
}
read_cb = &mbuff->read_cb[use_id];
mailbox_mutex_lock(&mbuff->mutex);
usr_handle = read_cb->handle;
usr_data = read_cb->data;
usr_func = read_cb->func;
mailbox_mutex_unlock(&mbuff->mutex);
if (MAILBOX_NULL != usr_func) {
usr_queue->size = mail.ulMsgLength;
slice_start = mailbox_get_timestamp();
usr_func(mbuff, usr_handle , usr_data);
/*记录可维可测信息*/
#ifdef MAILBOX_OPEN_MNTN
mailbox_record_receive(&mbuff->mntn, mbuff->channel_id, slice_start);
#endif
} else {
mailbox_logerro_p1(MAILBOX_ERR_GUT_READ_CALLBACK_NOT_FIND, mail.ulMailCode);
}
EXIT:
/*不管用户有没有用回调读数据，读了多少数据，邮箱队列的读指针都需要按实际
大小偏移，以保证后面邮件读取的正确性。*/
to_bottom = (m_queue->base + m_queue->length) - m_queue->rear;
if (to_bottom > (mail.ulMsgLength + sizeof(struct mb_mail))) {
m_queue->rear += (mail.ulMsgLength + sizeof(struct mb_mail));
} else {
m_queue->rear = m_queue->base + ((mail.ulMsgLength +
sizeof(struct mb_mail)) - to_bottom);
}
/*读保证指针4字节对齐*/
m_queue->rear = mailbox_align_size(m_queue->rear, MAILBOX_ALIGN);
return (mailbox_align_size(mail.ulMsgLength, MAILBOX_ALIGN)
+ sizeof(struct mb_mail));
}
