/*****************************************************************************
函 数 名 : mailbox_read_channel
接口类型 : 对内接口
功能描述 : 邮箱共享内存通道接受到新数据的处理回调函数.
输入参数 : unsigned long channel_id -- 邮箱通道号
输出参数 : 无
返 回 值 : 无
调用函数 : mailbox_receive_all_mails()
被调函数 :
修改历史 :
1.日 期 : 2012年9月24日
作 者 : 莫南 00176101
修改内容 : 新生成函数
*****************************************************************************/
MAILBOX_LOCAL long mailbox_read_channel(unsigned long channel_id)
{
struct mb_buff *mbuf = MAILBOX_NULL; /*邮箱操作句柄*/
struct mb *mb = MAILBOX_NULL;
unsigned long ret_val = MAILBOX_OK;
mb = mailbox_get_mb();
if (MAILBOX_NULL == mb) {
return (unsigned long)MAILBOX_ERRO;
}
/*判断方向是否正确,是否为接收通道*/
if (mb->local_id != mailbox_get_dst_id(channel_id)) {
return mailbox_logerro_p1(MAILBOX_ERR_GUT_INVALID_TARGET_CPU, channel_id);
}
/*打开此邮箱通道*/
ret_val = mailbox_request_channel(mb, &mbuf, channel_id);
if (MAILBOX_OK != ret_val) {
return ret_val;
}
/*接收此邮箱通道的所有邮件*/
ret_val = mailbox_receive_all_mails(mbuf);
mailbox_flush_buff(mbuf); /*把邮箱通道操作符的信息写回邮箱头。*/
/*接收完成，关闭邮箱*/
if (MAILBOX_OK != mailbox_release_channel(mb, mbuf)) {
return mailbox_logerro_p1(MAILBOX_ERR_GUT_RELEASE_CHANNEL, channel_id);
}
return ret_val;
}
/*****************************************************************************
函 数 名 : 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_calculate_space
接口类型 : 对内接口
功能描述 : 统计通道信息，计算需要分配的内存空间
输入参数 : struct mb *mb -- 邮箱总句柄
struct mb_cfg *config -- 邮箱通道的全局配置表。
unsigned long CpuID -- 注册此通道的CPU号。
输出参数 : 无
返 回 值 : 邮箱操作句柄
调用函数 :
被调函数 :
修改历史 :
1.日 期 : 2012年9月7日
作 者 : 莫南 00176101
修改内容 : 新生成函数
*****************************************************************************/
MAILBOX_LOCAL long mailbox_calculate_space(
struct mb *mb,
struct mb_cfg *config,
unsigned long cpu_id)
{
struct mb_link *send_link = MAILBOX_NULL;/*指向主结构体的发送通道数组基地址*/
struct mb_link *recev_link = MAILBOX_NULL;/*指向主结构体的接收通道数组基地址*/
unsigned long ret_val = MAILBOX_OK;
unsigned long src_id = 0;
unsigned long dst_id = 0;
unsigned long carrier_id = 0;
send_link = mb->send_tbl;
recev_link = mb->recv_tbl;
while (MAILBOX_MAILCODE_INVALID != config->butt_id) {
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);
/*检查是不是本CPU发送通道*/
if (cpu_id == src_id) {
/*检查目的CPU的有效性*/
if (dst_id < MAILBOX_CPUID_BUTT) {
/*记录此CPU连接的最大通道*/
if ((carrier_id + 1) > send_link[dst_id].carrier_butt) {
send_link[dst_id].carrier_butt = (carrier_id + 1);
} else {
/*不记录*/
}
} else {
/*数组越界*/
ret_val = mailbox_logerro_p1(MAILBOX_ERR_GUT_INVALID_CHANNEL_ID,
config->butt_id);
}
}
/*检查是不是本CPU接收通道*/
if (cpu_id == dst_id) {
/*检查发送CPU的有效性*/
if (src_id < MAILBOX_CPUID_BUTT) {
/*记录此CPU连接的最大通道*/
if ((carrier_id + 1) > recev_link[src_id].carrier_butt) {
recev_link[src_id].carrier_butt = (carrier_id + 1);
} else {
/*不记录*/
}
} else {
/*数组越界*/
ret_val = mailbox_logerro_p1(MAILBOX_ERR_GUT_INVALID_CHANNEL_ID,
config->butt_id);
}
}
config++;
}
return ret_val;
}
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_EXTERN unsigned long mailbox_send_msg(
unsigned long mailcode,
void *data,
unsigned long length)
{
unsigned long ret_val;
unsigned long try_go_on = MAILBOX_TRUE;
unsigned long try_times = 0;
extern bool hifi_is_loaded(void);
if (!hifi_is_loaded()) {
return MAILBOX_TARGET_NOT_READY;
}
ret_val= BSP_CPU_StateGet(mailbox_get_dst_id(mailcode));
if(!ret_val) {
return MAILBOX_TARGET_NOT_READY;
}
ret_val = mailbox_try_send_msg(mailcode, data, length);
if (MAILBOX_FALSE == mailbox_int_context()) {
/*发送满等待轮询尝试*/
while (MAILBOX_FULL == ret_val) {
mailbox_delivery(mailbox_get_channel_id(mailcode));
try_go_on = mailbox_scene_delay(MAILBOX_DELAY_SCENE_MSG_FULL, &try_times);
if (MAILBOX_TRUE == try_go_on) {
ret_val = mailbox_try_send_msg(mailcode, data, length);
} else {
break;
}
}
}
if (MAILBOX_OK != ret_val) {
mailbox_show(mailcode,0);
mailbox_assert(ret_val);
if (MAILBOX_FULL != ret_val) {
ret_val = MAILBOX_ERRO;
}
return ret_val;
}
return ret_val;
}
/*****************************************************************************
函 数 名 : mailbox_send_msg
功能描述 : 提供给各模块进行核间数据发送的接口。
输入参数 :
unsigned int mailcode -- 邮件的id号, 逻辑通道号。
unsigned char *data -- 指向邮件数据的指针。
unsigned int length/byte -- 数据或者消息总长度 字节为单位。
输出参数 : 无
返 回 值 : unsigned int
成功OK, 异常返回值
调用函数 :
被调函数 :
修改历史 :
1.日 期 : 2012年9月28日
作 者 : 莫南 00176101
修改内容 : 新生成函数
*****************************************************************************/
MAILBOX_EXTERN unsigned int mailbox_send_msg(
unsigned int mailcode,
void *data,
unsigned int length)
{
int ret_val = MAILBOX_OK;
unsigned int try_go_on = MAILBOX_TRUE;
int try_times = 0;
ret_val= BSP_CPU_StateGet(mailbox_get_dst_id(mailcode));
if(!ret_val)
{
return MAILBOX_TARGET_NOT_READY;
}
ret_val = (int)mailbox_try_send_msg(mailcode, data, length);
if (MAILBOX_FALSE == mailbox_int_context()) {
/*发送满等待轮询尝试*/
while ((int)MAILBOX_FULL == ret_val) {
mailbox_delivery(mailbox_get_channel_id(mailcode));
try_go_on = (unsigned int)mailbox_scene_delay(MAILBOX_DELAY_SCENE_MSG_FULL, &try_times);
if (MAILBOX_TRUE == try_go_on) {
ret_val = (int)mailbox_try_send_msg(mailcode, data, length);
} else {
break;
}
}
}
if (MAILBOX_OK != ret_val) {
/*mailbox_show(mailcode,0);*/
/*mailbox_assert(ret_val);*/
if ((int)MAILBOX_FULL != ret_val) {
ret_val = (int)MAILBOX_ERRO;
}
return (unsigned int)ret_val;
}
return (unsigned int)ret_val;
}
/*****************************************************************************
函 数 名 : mailbox_flush_buff
接口类型 : 对内接口
功能描述 : 把邮箱消息队列的头尾指针写入邮箱头
输入参数 : mb_buff* mbuff - 邮箱通道操作符
输出参数 : 无
返 回 值 : MAILBOX_OK
调用函数 :
被调函数 :
修改历史 :
1.日 期 : 2013年5月08日
作 者 : 莫南 00176101
修改内容 : 新生成函数
*****************************************************************************/
MAILBOX_EXTERN long mailbox_flush_buff( struct mb_buff *mbuff)
{
struct mb_head *head = MAILBOX_NULL;
struct mb_queue *queue = MAILBOX_NULL;
unsigned long channel_id = mbuff->channel_id;
struct mb *mb = mbuff->mb;
/*把邮箱通道操作符的信息写回邮箱头。*/
head = (struct mb_head*)mbuff->config->head_addr;
queue = &mbuff->mail_queue;
/*需要区分是读还是写*/
if (mb->local_id == mailbox_get_src_id(channel_id)) {
/*写关闭，更新邮箱头写指针,同时释放邮箱资源*/
head->ulFront = (queue->front - queue->base ) / sizeof(unsigned long) ;
head->ulFrontslice = mailbox_get_timestamp();
} else if (mb->local_id == mailbox_get_dst_id(channel_id)) {
/*读关闭，只更新邮箱头读指针*/
head->ulRear = (queue->rear - queue->base ) / sizeof(unsigned long);
head->ulRearslice = mailbox_get_timestamp();
}
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;
}
