EtherCAT主站SOEM函数详解----SDO读写函数

  • ethercatcoe.h头文件
  • SDO读写函数
    • SDO读取函数
    • SDO写函数

获取SOEM主站或了解文件分布,可以读取我以前写的博客SOEM主站软件包及函数头文件介绍,本篇ethercatcoe文件相关的函数,COE的全称是CanOpen over EtherCAT, 采用CanOpen的相关协议开发了EtherCAT的运用层,核心是对象字典,想了解PDO相关知识,可以读CanOpen通信----PDO与SDO。对于报文结构体相关知识,可以参照EtherCAT数据帧及SOEM报文数据结构介绍,对下文的理解有一定帮组。

ethercatcoe.h头文件

为了比较全面的了解COE, 本文将先给出ethercatcoe.h的头文件,如下所示,其中核心的是读写函数。

/** Licensed under the GNU General Public License version 2 with exceptions. See* LICENSE file in the project root for full license information*//** \file* \brief* Headerfile for ethercatcoe.c*/#ifndef _ethercatcoe_
#define _ethercatcoe_#ifdef __cplusplus
extern "C"
{#endif/** max entries in Object Description list */
#define EC_MAXODLIST   1024/** max entries in Object Entry list */
#define EC_MAXOELIST   256/* Storage for object description list */
typedef struct
{/** slave number */uint16  Slave;/** number of entries in list */uint16  Entries;/** array of indexes */uint16  Index[EC_MAXODLIST];/** array of datatypes, see EtherCAT specification */uint16  DataType[EC_MAXODLIST];/** array of object codes, see EtherCAT specification */uint8   ObjectCode[EC_MAXODLIST];/** number of subindexes for each index */uint8   MaxSub[EC_MAXODLIST];/** textual description of each index */char    Name[EC_MAXODLIST][EC_MAXNAME+1];
} ec_ODlistt;/* storage for object list entry information */
typedef struct
{/** number of entries in list */uint16 Entries;/** array of value infos, see EtherCAT specification */uint8  ValueInfo[EC_MAXOELIST];/** array of value infos, see EtherCAT specification */uint16 DataType[EC_MAXOELIST];/** array of bit lengths, see EtherCAT specification */uint16 BitLength[EC_MAXOELIST];/** array of object access bits, see EtherCAT specification */uint16 ObjAccess[EC_MAXOELIST];/** textual description of each index */char   Name[EC_MAXOELIST][EC_MAXNAME+1];
} ec_OElistt;#ifdef EC_VER1
void ec_SDOerror(uint16 Slave, uint16 Index, uint8 SubIdx, int32 AbortCode);
int ec_SDOread(uint16 slave, uint16 index, uint8 subindex,boolean CA, int *psize, void *p, int timeout);
int ec_SDOwrite(uint16 Slave, uint16 Index, uint8 SubIndex,boolean CA, int psize, void *p, int Timeout);
int ec_RxPDO(uint16 Slave, uint16 RxPDOnumber , int psize, void *p);
int ec_TxPDO(uint16 slave, uint16 TxPDOnumber , int *psize, void *p, int timeout);
int ec_readPDOmap(uint16 Slave, int *Osize, int *Isize);
int ec_readPDOmapCA(uint16 Slave, int Thread_n, int *Osize, int *Isize);
int ec_readODlist(uint16 Slave, ec_ODlistt *pODlist);
int ec_readODdescription(uint16 Item, ec_ODlistt *pODlist);
int ec_readOEsingle(uint16 Item, uint8 SubI, ec_ODlistt *pODlist, ec_OElistt *pOElist);
int ec_readOE(uint16 Item, ec_ODlistt *pODlist, ec_OElistt *pOElist);
#endifvoid ecx_SDOerror(ecx_contextt *context, uint16 Slave, uint16 Index, uint8 SubIdx, int32 AbortCode);
int ecx_SDOread(ecx_contextt *context, uint16 slave, uint16 index, uint8 subindex,boolean CA, int *psize, void *p, int timeout);
int ecx_SDOwrite(ecx_contextt *context, uint16 Slave, uint16 Index, uint8 SubIndex,boolean CA, int psize, void *p, int Timeout);
int ecx_RxPDO(ecx_contextt *context, uint16 Slave, uint16 RxPDOnumber , int psize, void *p);
int ecx_TxPDO(ecx_contextt *context, uint16 slave, uint16 TxPDOnumber , int *psize, void *p, int timeout);
int ecx_readPDOmap(ecx_contextt *context, uint16 Slave, int *Osize, int *Isize);
int ecx_readPDOmapCA(ecx_contextt *context, uint16 Slave, int Thread_n, int *Osize, int *Isize);
int ecx_readODlist(ecx_contextt *context, uint16 Slave, ec_ODlistt *pODlist);
int ecx_readODdescription(ecx_contextt *context, uint16 Item, ec_ODlistt *pODlist);
int ecx_readOEsingle(ecx_contextt *context, uint16 Item, uint8 SubI, ec_ODlistt *pODlist, ec_OElistt *pOElist);
int ecx_readOE(ecx_contextt *context, uint16 Item, ec_ODlistt *pODlist, ec_OElistt *pOElist);#ifdef __cplusplus
}
#endif#endif

SDO读写函数

SDO服务数据,也称为邮箱数据,通常用在驱动器配置阶段,其数据传输是非周期性的。

SDO读取函数

int ecx_SDOread(ecx_contextt *context, uint16 slave, uint16 index, uint8 subindex,boolean CA, int *psize, void *p, int timeout);
/** CoE SDO read, blocking. Single subindex or Complete Access.** Only a "normal" upload request is issued. If the requested parameter is <= 4bytes* then a "expedited" response is returned, otherwise a "normal" response. If a "normal"* response is larger than the mailbox size then the response is segmented. The function* will combine all segments and copy them to the parameter buffer.** @param[in]  context    = context struct* @param[in]  slave      = Slave number* @param[in]  index      = Index to read* @param[in]  subindex   = Subindex to read, must be 0 or 1 if CA is used.* @param[in]  CA         = FALSE = single subindex. TRUE = Complete Access, all subindexes read.* @param[in,out] psize   = Size in bytes of parameter buffer, returns bytes read from SDO.* @param[out] p          = Pointer to parameter buffer* @param[in]  timeout    = Timeout in us, standard is EC_TIMEOUTRXM* @return Workcounter from last slave response*/

参数解释:

  • ecx_contextt *context:报文结构体指针,所有信息都是通过报文传递的,报文中包含了一系列配置信息;
  • uint16 slave :从站编号,有顺序寻址、逻辑寻址等,采用顺序寻址在驱动器配置过程自动扫描分配,与连接顺序有关;
  • uint16 index:对象字典索引,CanOpen相关协议
  • uint8 subindex:对象字典子索引,CanOpen相关协议
  • boolean CA:完全访问(Complete Access),会访问所有子索引,一般填写False,仅访问给定子索引。
  • int *psize: 读取参数字节数
  • void *p:读取参数指针,通过该指针可获取想要的信息
  • int timeout:读取最大超时,单位us(微秒),一般给EC_TIMEOUTRXM,其值为700000
  • @return Workcounter:返回计数wck,用于对比是否正确处理报文。

SDO写函数

int ecx_SDOwrite(ecx_contextt *context, uint16 Slave, uint16 Index, uint8 SubIndex,boolean CA, int psize, void *p, int Timeout);
/** CoE SDO write, blocking. Single subindex or Complete Access.** A "normal" download request is issued, unless we have* small data, then a "expedited" transfer is used. If the parameter is larger than* the mailbox size then the download is segmented. The function will split the* parameter data in segments and send them to the slave one by one.** @param[in]  context    = context struct* @param[in]  Slave      = Slave number* @param[in]  Index      = Index to write* @param[in]  SubIndex   = Subindex to write, must be 0 or 1 if CA is used.* @param[in]  CA         = FALSE = single subindex. TRUE = Complete Access, all subindexes written.* @param[in]  psize      = Size in bytes of parameter buffer.* @param[out] p          = Pointer to parameter buffer* @param[in]  Timeout    = Timeout in us, standard is EC_TIMEOUTRXM* @return Workcounter from last slave response

参数解释:

  • ecx_contextt *context:报文结构体指针,所有信息都是通过报文传递的,报文中包含了一系列配置信息;
  • uint16 slave :从站编号,有顺序寻址、逻辑寻址等,采用顺序寻址在驱动器配置过程自动扫描分配,与连接顺序有关;
  • uint16 index:对象字典索引,CanOpen相关协议
  • uint8 subindex:对象字典子索引,CanOpen相关协议
  • boolean CA:完全访问(Complete Access),会访问所有子索引,一般填写False,仅访问给定子索引。
  • int psize: 需要写入参数字节数
  • void *p:写入参数指针,通过该指针可获修改对应从站数据
  • int timeout:写入最大超时,单位us(微秒),一般给EC_TIMEOUTRXM,其值为700000
  • @return Workcounter:返回计数wck,用于对比是否正确处理报文。

EtherCAT主站SOEM函数详解----SDO读写函数相关推荐

  1. php output详解,PHP输出缓冲控制Output Control系列函数详解,output函数详解

    PHP输出缓冲控制Output Control系列函数详解,output函数详解 概述 以前研究过PHP的输入输出缓冲,不过博客搬家以后,原来文章找不到了,今天看到一篇好文,顺便转载过来. 简介 说到 ...

  2. MaxCompute SQL函数详解 ODPS SQL函数详解---之日期相关函数

    MaxCompute SQL函数详解 ODPS SQL函数详解 日期函数 to_date函数 返回类型:datetime 语法:to_date(类型 参数1,类型 参数2);to_date(strin ...

  3. MaxCompute SQL函数详解 ODPS SQL函数详解---之常用数学运算相关函数

    MaxCompute SQL函数详解 ODPS SQL函数详解---之常用数学运算相关函数 MaxCompute/ODPS SQL常用数学运算相关函数 ABS函数-计算绝对值 sql:select A ...

  4. mysqlsum绝对值_MySQL_MySQL笔记之数学函数详解,绝对值函数ABS(x)和圆周率函数P - phpStudy...

    MySQL笔记之数学函数详解 绝对值函数ABS(x)和圆周率函数PI() mysql> SELECT ABS(0.5), ABS(-0.5), PI(); +----------+------- ...

  5. python自定义函数详解_Python自定义函数

    自定义函数 使用def定义函数,例如: def my_abs(x) : if x >= 0 : return x else : return -x 函数可以返回多个值,但是这是假象,实际上函数返 ...

  6. c语言函数详解1——自定义函数

    这篇文章理论性知识比较多,不过对于初学者对于函数的理解会有更深层次的帮助 目录 c语言的函数--子程序 自定义函数 c语言的函数--子程序 *是大型程序中的某部分代码,由一个或者多个语句组成,她负责完 ...

  7. c++:内联函数详解和普通函数的区别

    文章目录 前言 Ⅰ.常规函数 Ⅱ.内联函数 1.语法 2.注意 Ⅲ.选择地使用内联 思考? 前言 内联函数是c++为了提高程序的运行速度做的改进,它与普通函数区别在于: 编译器如何将它们组合到程序中. ...

  8. php 时间函数详解,PHP时间函数date()详解

    html> /* php语言中默认设置的是标准的格林威治时间(即采用的是零时区),与我们本地的时间相差8个小时.所以要获取本地当前时间必须要更改PHP语言中的时区设置,只需在date()函数前加 ...

  9. python的groupby中函数详解_python groupby函数用法

    import pandas as pd io = r'C:\Users\Administrator\Desktop\ceshi\ceshi.xlsx' data0 = pd.read_excel(io ...

  10. inline 内联函数详解 内联函数与宏定义的区别

    一.在C&C++中 一.inline 关键字用来定义一个类的内联函数,引入它的主要原因是用它替代C中表达式形式的宏定义. 表达式形式的宏定义一例: #define ExpressionName ...

最新文章

  1. 从小到大排列的数组中查找x,若x存在则删除,若不存在则添加,修改后的数组仍然有序
  2. Windows8应用生命周期 Metro Style Apps Lifecycle
  3. python中可变参数和关键字参数_python的可变参数和关键字参数(*args **kw)
  4. 下运行maven命令_实话实说 | 这些maven命令,你会几个?
  5. kafka基础之核心概念
  6. VMware SDS 什么是VSAN?? VSAN的体系结构 (含VSAN 6.0、6.1版的新内容)
  7. Modules:PETCTFusion-Documentation-3.6
  8. 数据结构:列表(双向链表)的了解与示例
  9. java随机加法题_Java简单随机加法算式
  10. 探讨e.target与e.currentTarget
  11. 帷幕的帷是什么意思_美术生每天坚持练习|但越画越差的原因是什么?
  12. python 12306抢票脚本_Python 12306抢火车票脚本
  13. 美学心得(第二百二十五集)罗国正
  14. golang构建htpp服务
  15. 实验5-11 空心的数字金字塔
  16. ~3 ccf 2022-03-2 出行计划
  17. xmm1是什么器件_电路基础9第九章.ppt
  18. nss什么意思计算机网络用语,nss是什么意思 网络语nss是什么意思
  19. 畜生,想你了*_*发信站: BBS 哈工大紫丁香站
  20. C/C++语言问题——某年某月的天数是多少?

热门文章

  1. 三菱plc编程软件gx-developer在win10中无法使用及工程无法建立解决方法
  2. Visual SourceSafe 2005(Vss2005)使用经验总结
  3. jenkins - publish over ssh 学习+踩坑记
  4. CRM客户关系管理系统商业项目视频课程-赖国荣-专题视频课程
  5. JAVA电影院售票系统毕业设计 开题报告
  6. Ubuntu 定时锁屏3.0
  7. 黑客编程入门书籍推荐——《WINDOWS黑客编程技术详解》
  8. sqlserver 2012 MSSQLSERVER服务显示正在挂起更改且无法启动
  9. 电脑桌面上怎么找计算机,xp桌面上我的电脑图标不见了怎么找回来
  10. word2007导出pdf带书签