本文主要是介绍Contiki协议栈Rime:包属性packetbuf_attr,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!
更多的Contiki协议栈知识,请参考索引目录:
《Contiki协议栈:索引目录》
1 概述
包属性其实属于下一篇博客《Contiki协议栈Rime:缓冲区管理packetbuf management》的一部分,但是它比较难以理解,所以单独抽出一篇博客对它做介绍。
为了兼容其他协议,Rime不定义任何头部格式,而用包属性代替。一种属性是一种头部字段的抽象。当Rime协议栈中的子协议要发送一个包时,会传递一个属性链表下来。属性链表里包含了若干个属性,这些属性最终会被转换成头部的字段。
该部分代码位于:contiki/core/net/packetbuf.[ch]
。
2 相关定义
packetbuf_attrs packetbuf_addrs
Rime中定义了关于包属性的数组:
struct packetbuf_attr packetbuf_attrs[PACKETBUF_NUM_ATTRS];
struct packetbuf_addr packetbuf_addrs[PACKETBUF_NUM_ADDRS];
其中,struct packetbuf_attr和struct packetbuf_addr分别定义为
typedef uint16_t packetbuf_attr_t;struct packetbuf_attr {packetbuf_attr_t val; // 一个16位无符号整型
};
struct packetbuf_addr {linkaddr_t addr; // 上一篇博客介绍的节点地址,16位或者64位
};
数组的大小分别定义为:
#if NETSTACK_CONF_WITH_RIME
#define PACKETBUF_NUM_ADDRS 4
#else /* NETSTACK_CONF_WITH_RIME */
#define PACKETBUF_NUM_ADDRS 2
#endif /* NETSTACK_CONF_WITH_RIME */
#define PACKETBUF_NUM_ATTRS (PACKETBUF_ATTR_MAX - PACKETBUF_NUM_ADDRS)
为什么PACKETBUF_NUM_ATTRS定义为PACKETBUF_ATTR_MAX - PACKETBUF_NUM_ADDRS?
这是因为在定义属性的枚举变量时,将ADDR也当做了一种特殊属性,这样做的好处是可以将ADDR和ATTR统一处理(统一放在属性链表中,当Rime协议栈中的子协议将属性链表传递下来时,统一写到缓冲区packetbuf的头部)。请看下面
enum {PACKETBUF_ATTR_NONE,.../* Scope 2 attributes: used between end-to-end nodes. */
#if NETSTACK_CONF_WITH_RIMEPACKETBUF_ATTR_HOPS,PACKETBUF_ATTR_TTL,PACKETBUF_ATTR_EPACKET_ID,PACKETBUF_ATTR_EPACKET_TYPE,PACKETBUF_ATTR_ERELIABLE, // 其实ATTR在这里就定义完了
#endif /* NETSTACK_CONF_WITH_RIME */ /* These must be last */PACKETBUF_ADDR_SENDER, // 这里是ADDR的定义PACKETBUF_ADDR_RECEIVER,
#if NETSTACK_CONF_WITH_RIMEPACKETBUF_ADDR_ESENDER,PACKETBUF_ADDR_ERECEIVER,
#endif /* NETSTACK_CONF_WITH_RIME */PACKETBUF_ATTR_MAX // 这里才是PACKETBUF_ATTR_MAX,包含ATTR+ADDR,所以ATTR=MAX-ADDR
};
struct packetbuf_attrlist
前面说了,Rime协议栈的子协议在发送包时会传递一个属性链表下来,它的定义为:
struct packetbuf_attrlist {uint8_t type;uint8_t len; // 单位是bit
};
type:属性的类型。它直接对应于属性数组packetbuf_attrs或者packetbuf_addrs的下标
len:该属性的长度。需要注意的是,此处长度的单位是位,而不是字节。属性的类型是packetbuf_attr_t,即uint16_t,因此可以推断,len的取值范围应该是0~16。(本宝宝好厉害呀,居然想到这儿了~~~)
3 相关函数
packetbuf_attr_clear
void packetbuf_attr_clear(void)
{int i;memset(packetbuf_attrs, 0, sizeof(packetbuf_attrs));//其实也可以用memset(packetbuf_addrs, 0, sizeof(packetbuf_addrs))吧?for(i = 0; i < PACKETBUF_NUM_ADDRS; ++i) {linkaddr_copy(&packetbuf_addrs[i].addr, &linkaddr_null);}
}
很简单,清空两个属性数组packetbuf_attrs和packetbuf_addrs。
packetbuf_attr_copyto
void packetbuf_attr_copyto(struct packetbuf_attr *attrs, struct packetbuf_addr *addrs)
{memcpy(attrs, packetbuf_attrs, sizeof(packetbuf_attrs));memcpy(addrs, packetbuf_addrs, sizeof(packetbuf_addrs));
}
很简单,将两个属性数组的内容拷贝给attrs和addrs
packetbuf_attr_copyfrom
void
packetbuf_attr_copyfrom(struct packetbuf_attr *attrs, struct packetbuf_addr *addrs)
{memcpy(packetbuf_attrs, attrs, sizeof(packetbuf_attrs));memcpy(packetbuf_addrs, addrs, sizeof(packetbuf_addrs));
}
很简单,从attrs和addrs拷贝到两个属性数组中。
packetbuf_set_attr
int packetbuf_set_attr(uint8_t type, const packetbuf_attr_t val)
{
packetbuf_attrs[type].val = val;
return 1;
}
很简单,设置属性数组中对应属性的值。
packetbuf_attr
packetbuf_attr_t
packetbuf_attr(uint8_t type)
{return packetbuf_attrs[type].val;
}
很简单,返回属性数组中对于属性的值。
packetbuf_set_addr
int packetbuf_set_addr(uint8_t type, const linkaddr_t *addr)
{linkaddr_copy(&packetbuf_addrs[type - PACKETBUF_ADDR_FIRST].addr, addr);return 1;
}
很简单,设置属性数组中对应属性的值。
packetbuf_addr
const linkaddr_t *packetbuf_addr(uint8_t type)
{return &packetbuf_addrs[type - PACKETBUF_ADDR_FIRST].addr;
}
很简单,返回属性数组中对于属性的值。
4 小结
这么抽象的东西,居然把它给阐释清楚了,我得意的笑~~
但是说实话,初次接触时,难免会有很多地方难以理解,没关系,在继续看完我的后续几篇博客后,整个路就完全通了,然后大家都可以嘚瑟了O(∩_∩)O哈哈~
这篇关于Contiki协议栈Rime:包属性packetbuf_attr的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!