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

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

本篇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);
#endif
void 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,用于对比是否正确处理报文。

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

php output详解,PHP输出缓冲控制Output Control系列函数详解，output函数详解
PHP输出缓冲控制Output Control系列函数详解,output函数详解概述以前研究过PHP的输入输出缓冲,不过博客搬家以后,原来文章找不到了,今天看到一篇好文,顺便转载过来. 简介说到 ...
MaxCompute SQL函数详解 ODPS SQL函数详解---之日期相关函数
MaxCompute SQL函数详解 ODPS SQL函数详解日期函数 to_date函数返回类型:datetime 语法:to_date(类型参数1,类型参数2);to_date(strin ...
MaxCompute SQL函数详解 ODPS SQL函数详解---之常用数学运算相关函数
MaxCompute SQL函数详解 ODPS SQL函数详解---之常用数学运算相关函数 MaxCompute/ODPS SQL常用数学运算相关函数 ABS函数-计算绝对值 sql:select A ...
mysqlsum绝对值_MySQL_MySQL笔记之数学函数详解，绝对值函数ABS(x)和圆周率函数P - phpStudy...
MySQL笔记之数学函数详解绝对值函数ABS(x)和圆周率函数PI() mysql> SELECT ABS(0.5), ABS(-0.5), PI(); +----------+------- ...
python自定义函数详解_Python自定义函数
自定义函数使用def定义函数,例如: def my_abs(x) : if x >= 0 : return x else : return -x 函数可以返回多个值,但是这是假象,实际上函数返 ...
c语言函数详解1——自定义函数
这篇文章理论性知识比较多,不过对于初学者对于函数的理解会有更深层次的帮助目录 c语言的函数--子程序自定义函数 c语言的函数--子程序 *是大型程序中的某部分代码,由一个或者多个语句组成,她负责完 ...
c++：内联函数详解和普通函数的区别
文章目录前言 Ⅰ.常规函数 Ⅱ.内联函数 1.语法 2.注意 Ⅲ.选择地使用内联思考? 前言内联函数是c++为了提高程序的运行速度做的改进,它与普通函数区别在于: 编译器如何将它们组合到程序中. ...
php 时间函数详解,PHP时间函数date()详解
html> /* php语言中默认设置的是标准的格林威治时间(即采用的是零时区),与我们本地的时间相差8个小时.所以要获取本地当前时间必须要更改PHP语言中的时区设置,只需在date()函数前加 ...
python的groupby中函数详解_python groupby函数用法
import pandas as pd io = r'C:\Users\Administrator\Desktop\ceshi\ceshi.xlsx' data0 = pd.read_excel(io ...
inline 内联函数详解内联函数与宏定义的区别
一.在C&C++中一.inline 关键字用来定义一个类的内联函数,引入它的主要原因是用它替代C中表达式形式的宏定义. 表达式形式的宏定义一例: #define ExpressionName ...

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