1506 lines
55 KiB
C
1506 lines
55 KiB
C
/*
|
|
* Licensed under the GNU General Public License version 2 with exceptions. See
|
|
* LICENSE file in the project root for full license information
|
|
*/
|
|
|
|
/** \file
|
|
* \brief
|
|
* CAN over EtherCAT (CoE) module.
|
|
*
|
|
* SDO read / write and SDO service functions
|
|
*/
|
|
|
|
#include <stdio.h>
|
|
#include <string.h>
|
|
#include "osal.h"
|
|
#include "oshw.h"
|
|
#include "ethercattype.h"
|
|
#include "ethercatbase.h"
|
|
#include "ethercatmain.h"
|
|
#include "ethercatcoe.h"
|
|
|
|
/** SDO structure, not to be confused with EcSDOserviceT */
|
|
PACKED_BEGIN
|
|
typedef struct PACKED
|
|
{
|
|
ec_mbxheadert MbxHeader;
|
|
uint16 CANOpen;
|
|
uint8 Command;
|
|
uint16 Index;
|
|
uint8 SubIndex;
|
|
union
|
|
{
|
|
uint8 bdata[0x200]; /* variants for easy data access */
|
|
uint16 wdata[0x100];
|
|
uint32 ldata[0x80];
|
|
};
|
|
} ec_SDOt;
|
|
PACKED_END
|
|
|
|
/** SDO service structure */
|
|
PACKED_BEGIN
|
|
typedef struct PACKED
|
|
{
|
|
ec_mbxheadert MbxHeader;
|
|
uint16 CANOpen;
|
|
uint8 Opcode;
|
|
uint8 Reserved;
|
|
uint16 Fragments;
|
|
union
|
|
{
|
|
uint8 bdata[0x200]; /* variants for easy data access */
|
|
uint16 wdata[0x100];
|
|
uint32 ldata[0x80];
|
|
};
|
|
} ec_SDOservicet;
|
|
PACKED_END
|
|
|
|
/** Report SDO error.
|
|
*
|
|
* @param[in] context = context struct
|
|
* @param[in] Slave = Slave number
|
|
* @param[in] Index = Index that generated error
|
|
* @param[in] SubIdx = Subindex that generated error
|
|
* @param[in] AbortCode = Abortcode, see EtherCAT documentation for list
|
|
*/
|
|
void ecx_SDOerror(ecx_contextt *context, uint16 Slave, uint16 Index, uint8 SubIdx, int32 AbortCode)
|
|
{
|
|
ec_errort Ec;
|
|
|
|
memset(&Ec, 0, sizeof(Ec));
|
|
Ec.Time = osal_current_time();
|
|
Ec.Slave = Slave;
|
|
Ec.Index = Index;
|
|
Ec.SubIdx = SubIdx;
|
|
*(context->ecaterror) = TRUE;
|
|
Ec.Etype = EC_ERR_TYPE_SDO_ERROR;
|
|
Ec.AbortCode = AbortCode;
|
|
ecx_pusherror(context, &Ec);
|
|
}
|
|
|
|
/** Report SDO info error
|
|
*
|
|
* @param[in] context = context struct
|
|
* @param[in] Slave = Slave number
|
|
* @param[in] Index = Index that generated error
|
|
* @param[in] SubIdx = Subindex that generated error
|
|
* @param[in] AbortCode = Abortcode, see EtherCAT documentation for list
|
|
*/
|
|
static void ecx_SDOinfoerror(ecx_contextt *context, uint16 Slave, uint16 Index, uint8 SubIdx, int32 AbortCode)
|
|
{
|
|
ec_errort Ec;
|
|
|
|
memset(&Ec, 0, sizeof(Ec));
|
|
Ec.Slave = Slave;
|
|
Ec.Index = Index;
|
|
Ec.SubIdx = SubIdx;
|
|
*(context->ecaterror) = TRUE;
|
|
Ec.Etype = EC_ERR_TYPE_SDOINFO_ERROR;
|
|
Ec.AbortCode = AbortCode;
|
|
ecx_pusherror(context, &Ec);
|
|
}
|
|
|
|
/** 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
|
|
*/
|
|
int ecx_SDOread(ecx_contextt *context, uint16 slave, uint16 index, uint8 subindex,
|
|
boolean CA, int *psize, void *p, int timeout)
|
|
{
|
|
ec_SDOt *SDOp, *aSDOp;
|
|
uint16 bytesize, Framedatasize;
|
|
int wkc;
|
|
int32 SDOlen;
|
|
uint8 *bp;
|
|
uint8 *hp;
|
|
ec_mbxbuft MbxIn, MbxOut;
|
|
uint8 cnt, toggle;
|
|
boolean NotLast;
|
|
|
|
ec_clearmbx(&MbxIn);
|
|
/* Empty slave out mailbox if something is in. Timout set to 0 */
|
|
wkc = ecx_mbxreceive(context, slave, (ec_mbxbuft *)&MbxIn, 0);
|
|
ec_clearmbx(&MbxOut);
|
|
aSDOp = (ec_SDOt *)&MbxIn;
|
|
SDOp = (ec_SDOt *)&MbxOut;
|
|
SDOp->MbxHeader.length = htoes(0x000a);
|
|
SDOp->MbxHeader.address = htoes(0x0000);
|
|
SDOp->MbxHeader.priority = 0x00;
|
|
/* get new mailbox count value, used as session handle */
|
|
cnt = ec_nextmbxcnt(context->slavelist[slave].mbx_cnt);
|
|
context->slavelist[slave].mbx_cnt = cnt;
|
|
SDOp->MbxHeader.mbxtype = ECT_MBXT_COE + (cnt << 4); /* CoE */
|
|
SDOp->CANOpen = htoes(0x000 + (ECT_COES_SDOREQ << 12)); /* number 9bits service upper 4 bits (SDO request) */
|
|
if (CA)
|
|
{
|
|
SDOp->Command = ECT_SDO_UP_REQ_CA; /* upload request complete access */
|
|
}
|
|
else
|
|
{
|
|
SDOp->Command = ECT_SDO_UP_REQ; /* upload request normal */
|
|
}
|
|
SDOp->Index = htoes(index);
|
|
if (CA && (subindex > 1))
|
|
{
|
|
subindex = 1;
|
|
}
|
|
SDOp->SubIndex = subindex;
|
|
SDOp->ldata[0] = 0;
|
|
/* send CoE request to slave */
|
|
wkc = ecx_mbxsend(context, slave, (ec_mbxbuft *)&MbxOut, EC_TIMEOUTTXM);
|
|
if (wkc > 0) /* succeeded to place mailbox in slave ? */
|
|
{
|
|
/* clean mailboxbuffer */
|
|
ec_clearmbx(&MbxIn);
|
|
/* read slave response */
|
|
wkc = ecx_mbxreceive(context, slave, (ec_mbxbuft *)&MbxIn, timeout);
|
|
if (wkc > 0) /* succeeded to read slave response ? */
|
|
{
|
|
/* slave response should be CoE, SDO response and the correct index */
|
|
if (((aSDOp->MbxHeader.mbxtype & 0x0f) == ECT_MBXT_COE) &&
|
|
((etohs(aSDOp->CANOpen) >> 12) == ECT_COES_SDORES) &&
|
|
(aSDOp->Index == SDOp->Index))
|
|
{
|
|
if ((aSDOp->Command & 0x02) > 0)
|
|
{
|
|
/* expedited frame response */
|
|
bytesize = 4 - ((aSDOp->Command >> 2) & 0x03);
|
|
if (*psize >= bytesize) /* parameter buffer big enough ? */
|
|
{
|
|
/* copy parameter in parameter buffer */
|
|
memcpy(p, &aSDOp->ldata[0], bytesize);
|
|
/* return the real parameter size */
|
|
*psize = bytesize;
|
|
}
|
|
else
|
|
{
|
|
wkc = 0;
|
|
ecx_packeterror(context, slave, index, subindex, 3); /* data container too small for type */
|
|
}
|
|
}
|
|
else
|
|
{ /* normal frame response */
|
|
SDOlen = etohl(aSDOp->ldata[0]);
|
|
/* Does parameter fit in parameter buffer ? */
|
|
if (SDOlen <= *psize)
|
|
{
|
|
bp = p;
|
|
hp = p;
|
|
/* calculate mailbox transfer size */
|
|
Framedatasize = (etohs(aSDOp->MbxHeader.length) - 10);
|
|
if (Framedatasize < SDOlen) /* transfer in segments? */
|
|
{
|
|
/* copy parameter data in parameter buffer */
|
|
memcpy(hp, &aSDOp->ldata[1], Framedatasize);
|
|
/* increment buffer pointer */
|
|
hp += Framedatasize;
|
|
*psize = Framedatasize;
|
|
NotLast = TRUE;
|
|
toggle= 0x00;
|
|
while (NotLast) /* segmented transfer */
|
|
{
|
|
SDOp = (ec_SDOt *)&MbxOut;
|
|
SDOp->MbxHeader.length = htoes(0x000a);
|
|
SDOp->MbxHeader.address = htoes(0x0000);
|
|
SDOp->MbxHeader.priority = 0x00;
|
|
cnt = ec_nextmbxcnt(context->slavelist[slave].mbx_cnt);
|
|
context->slavelist[slave].mbx_cnt = cnt;
|
|
SDOp->MbxHeader.mbxtype = ECT_MBXT_COE + (cnt << 4); /* CoE */
|
|
SDOp->CANOpen = htoes(0x000 + (ECT_COES_SDOREQ << 12)); /* number 9bits service upper 4 bits (SDO request) */
|
|
SDOp->Command = ECT_SDO_SEG_UP_REQ + toggle; /* segment upload request */
|
|
SDOp->Index = htoes(index);
|
|
SDOp->SubIndex = subindex;
|
|
SDOp->ldata[0] = 0;
|
|
/* send segmented upload request to slave */
|
|
wkc = ecx_mbxsend(context, slave, (ec_mbxbuft *)&MbxOut, EC_TIMEOUTTXM);
|
|
/* is mailbox transfered to slave ? */
|
|
if (wkc > 0)
|
|
{
|
|
ec_clearmbx(&MbxIn);
|
|
/* read slave response */
|
|
wkc = ecx_mbxreceive(context, slave, (ec_mbxbuft *)&MbxIn, timeout);
|
|
/* has slave responded ? */
|
|
if (wkc > 0)
|
|
{
|
|
/* slave response should be CoE, SDO response */
|
|
if ((((aSDOp->MbxHeader.mbxtype & 0x0f) == ECT_MBXT_COE) &&
|
|
((etohs(aSDOp->CANOpen) >> 12) == ECT_COES_SDORES) &&
|
|
((aSDOp->Command & 0xe0) == 0x00)))
|
|
{
|
|
/* calculate mailbox transfer size */
|
|
Framedatasize = etohs(aSDOp->MbxHeader.length) - 3;
|
|
if ((aSDOp->Command & 0x01) > 0)
|
|
{ /* last segment */
|
|
NotLast = FALSE;
|
|
if (Framedatasize == 7)
|
|
/* substract unused bytes from frame */
|
|
Framedatasize = Framedatasize - ((aSDOp->Command & 0x0e) >> 1);
|
|
/* copy to parameter buffer */
|
|
memcpy(hp, &(aSDOp->Index), Framedatasize);
|
|
}
|
|
else /* segments follow */
|
|
{
|
|
/* copy to parameter buffer */
|
|
memcpy(hp, &(aSDOp->Index), Framedatasize);
|
|
/* increment buffer pointer */
|
|
hp += Framedatasize;
|
|
}
|
|
/* update parametersize */
|
|
*psize += Framedatasize;
|
|
}
|
|
/* unexpected frame returned from slave */
|
|
else
|
|
{
|
|
NotLast = FALSE;
|
|
if ((aSDOp->Command) == ECT_SDO_ABORT) /* SDO abort frame received */
|
|
ecx_SDOerror(context, slave, index, subindex, etohl(aSDOp->ldata[0]));
|
|
else
|
|
ecx_packeterror(context, slave, index, subindex, 1); /* Unexpected frame returned */
|
|
wkc = 0;
|
|
}
|
|
}
|
|
}
|
|
toggle = toggle ^ 0x10; /* toggle bit for segment request */
|
|
}
|
|
}
|
|
/* non segmented transfer */
|
|
else
|
|
{
|
|
/* copy to parameter buffer */
|
|
memcpy(bp, &aSDOp->ldata[1], SDOlen);
|
|
*psize = SDOlen;
|
|
}
|
|
}
|
|
/* parameter buffer too small */
|
|
else
|
|
{
|
|
wkc = 0;
|
|
ecx_packeterror(context, slave, index, subindex, 3); /* data container too small for type */
|
|
}
|
|
}
|
|
}
|
|
/* other slave response */
|
|
else
|
|
{
|
|
if ((aSDOp->Command) == ECT_SDO_ABORT) /* SDO abort frame received */
|
|
{
|
|
ecx_SDOerror(context, slave, index, subindex, etohl(aSDOp->ldata[0]));
|
|
}
|
|
else
|
|
{
|
|
ecx_packeterror(context, slave, index, subindex, 1); /* Unexpected frame returned */
|
|
}
|
|
wkc = 0;
|
|
}
|
|
}
|
|
}
|
|
return wkc;
|
|
}
|
|
|
|
/** 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
|
|
*/
|
|
int ecx_SDOwrite(ecx_contextt *context, uint16 Slave, uint16 Index, uint8 SubIndex,
|
|
boolean CA, int psize, void *p, int Timeout)
|
|
{
|
|
ec_SDOt *SDOp, *aSDOp;
|
|
int wkc, maxdata;
|
|
ec_mbxbuft MbxIn, MbxOut;
|
|
uint8 cnt, toggle;
|
|
uint16 framedatasize;
|
|
boolean NotLast;
|
|
uint8 *hp;
|
|
|
|
ec_clearmbx(&MbxIn);
|
|
/* Empty slave out mailbox if something is in. Timout set to 0 */
|
|
wkc = ecx_mbxreceive(context, Slave, (ec_mbxbuft *)&MbxIn, 0);
|
|
ec_clearmbx(&MbxOut);
|
|
aSDOp = (ec_SDOt *)&MbxIn;
|
|
SDOp = (ec_SDOt *)&MbxOut;
|
|
maxdata = context->slavelist[Slave].mbx_l - 0x10; /* data section=mailbox size - 6 mbx - 2 CoE - 8 sdo req */
|
|
/* if small data use expedited transfer */
|
|
if ((psize <= 4) && !CA)
|
|
{
|
|
SDOp->MbxHeader.length = htoes(0x000a);
|
|
SDOp->MbxHeader.address = htoes(0x0000);
|
|
SDOp->MbxHeader.priority = 0x00;
|
|
/* get new mailbox counter, used for session handle */
|
|
cnt = ec_nextmbxcnt(context->slavelist[Slave].mbx_cnt);
|
|
context->slavelist[Slave].mbx_cnt = cnt;
|
|
SDOp->MbxHeader.mbxtype = ECT_MBXT_COE + (cnt << 4); /* CoE */
|
|
SDOp->CANOpen = htoes(0x000 + (ECT_COES_SDOREQ << 12)); /* number 9bits service upper 4 bits */
|
|
SDOp->Command = ECT_SDO_DOWN_EXP | (((4 - psize) << 2) & 0x0c); /* expedited SDO download transfer */
|
|
SDOp->Index = htoes(Index);
|
|
SDOp->SubIndex = SubIndex;
|
|
hp = p;
|
|
/* copy parameter data to mailbox */
|
|
memcpy(&SDOp->ldata[0], hp, psize);
|
|
/* send mailbox SDO download request to slave */
|
|
wkc = ecx_mbxsend(context, Slave, (ec_mbxbuft *)&MbxOut, EC_TIMEOUTTXM);
|
|
if (wkc > 0)
|
|
{
|
|
ec_clearmbx(&MbxIn);
|
|
/* read slave response */
|
|
wkc = ecx_mbxreceive(context, Slave, (ec_mbxbuft *)&MbxIn, Timeout);
|
|
if (wkc > 0)
|
|
{
|
|
/* response should be CoE, SDO response, correct index and subindex */
|
|
if (((aSDOp->MbxHeader.mbxtype & 0x0f) == ECT_MBXT_COE) &&
|
|
((etohs(aSDOp->CANOpen) >> 12) == ECT_COES_SDORES) &&
|
|
(aSDOp->Index == SDOp->Index) &&
|
|
(aSDOp->SubIndex == SDOp->SubIndex))
|
|
{
|
|
/* all OK */
|
|
}
|
|
/* unexpected response from slave */
|
|
else
|
|
{
|
|
if (aSDOp->Command == ECT_SDO_ABORT) /* SDO abort frame received */
|
|
{
|
|
ecx_SDOerror(context, Slave, Index, SubIndex, etohl(aSDOp->ldata[0]));
|
|
}
|
|
else
|
|
{
|
|
ecx_packeterror(context, Slave, Index, SubIndex, 1); /* Unexpected frame returned */
|
|
}
|
|
wkc = 0;
|
|
}
|
|
}
|
|
}
|
|
}
|
|
else
|
|
{
|
|
framedatasize = psize;
|
|
NotLast = FALSE;
|
|
if (framedatasize > maxdata)
|
|
{
|
|
framedatasize = maxdata; /* segmented transfer needed */
|
|
NotLast = TRUE;
|
|
}
|
|
SDOp->MbxHeader.length = htoes(0x0a + framedatasize);
|
|
SDOp->MbxHeader.address = htoes(0x0000);
|
|
SDOp->MbxHeader.priority = 0x00;
|
|
/* get new mailbox counter, used for session handle */
|
|
cnt = ec_nextmbxcnt(context->slavelist[Slave].mbx_cnt);
|
|
context->slavelist[Slave].mbx_cnt = cnt;
|
|
SDOp->MbxHeader.mbxtype = ECT_MBXT_COE + (cnt << 4); /* CoE */
|
|
SDOp->CANOpen = htoes(0x000 + (ECT_COES_SDOREQ << 12)); /* number 9bits service upper 4 bits */
|
|
if (CA)
|
|
{
|
|
SDOp->Command = ECT_SDO_DOWN_INIT_CA; /* Complete Access, normal SDO init download transfer */
|
|
}
|
|
else
|
|
{
|
|
SDOp->Command = ECT_SDO_DOWN_INIT; /* normal SDO init download transfer */
|
|
}
|
|
SDOp->Index = htoes(Index);
|
|
SDOp->SubIndex = SubIndex;
|
|
if (CA && (SubIndex > 1))
|
|
{
|
|
SDOp->SubIndex = 1;
|
|
}
|
|
SDOp->ldata[0] = htoel(psize);
|
|
hp = p;
|
|
/* copy parameter data to mailbox */
|
|
memcpy(&SDOp->ldata[1], hp, framedatasize);
|
|
hp += framedatasize;
|
|
psize -= framedatasize;
|
|
/* send mailbox SDO download request to slave */
|
|
wkc = ecx_mbxsend(context, Slave, (ec_mbxbuft *)&MbxOut, EC_TIMEOUTTXM);
|
|
if (wkc > 0)
|
|
{
|
|
ec_clearmbx(&MbxIn);
|
|
/* read slave response */
|
|
wkc = ecx_mbxreceive(context, Slave, (ec_mbxbuft *)&MbxIn, Timeout);
|
|
if (wkc > 0)
|
|
{
|
|
/* response should be CoE, SDO response, correct index and subindex */
|
|
if (((aSDOp->MbxHeader.mbxtype & 0x0f) == ECT_MBXT_COE) &&
|
|
((etohs(aSDOp->CANOpen) >> 12) == ECT_COES_SDORES) &&
|
|
(aSDOp->Index == SDOp->Index) &&
|
|
(aSDOp->SubIndex == SDOp->SubIndex))
|
|
{
|
|
/* all ok */
|
|
maxdata += 7;
|
|
toggle = 0;
|
|
/* repeat while segments left */
|
|
while (NotLast)
|
|
{
|
|
SDOp = (ec_SDOt *)&MbxOut;
|
|
framedatasize = psize;
|
|
NotLast = FALSE;
|
|
SDOp->Command = 0x01; /* last segment */
|
|
if (framedatasize > maxdata)
|
|
{
|
|
framedatasize = maxdata; /* more segments needed */
|
|
NotLast = TRUE;
|
|
SDOp->Command = 0x00; /* segments follow */
|
|
}
|
|
if (!NotLast && (framedatasize < 7))
|
|
{
|
|
SDOp->MbxHeader.length = htoes(0x0a); /* minimum size */
|
|
SDOp->Command = 0x01 + ((7 - framedatasize) << 1); /* last segment reduced octets */
|
|
}
|
|
else
|
|
{
|
|
SDOp->MbxHeader.length = htoes(framedatasize + 3); /* data + 2 CoE + 1 SDO */
|
|
}
|
|
SDOp->MbxHeader.address = htoes(0x0000);
|
|
SDOp->MbxHeader.priority = 0x00;
|
|
/* get new mailbox counter value */
|
|
cnt = ec_nextmbxcnt(context->slavelist[Slave].mbx_cnt);
|
|
context->slavelist[Slave].mbx_cnt = cnt;
|
|
SDOp->MbxHeader.mbxtype = ECT_MBXT_COE + (cnt << 4); /* CoE */
|
|
SDOp->CANOpen = htoes(0x000 + (ECT_COES_SDOREQ << 12)); /* number 9bits service upper 4 bits (SDO request) */
|
|
SDOp->Command = SDOp->Command + toggle; /* add toggle bit to command byte */
|
|
/* copy parameter data to mailbox */
|
|
memcpy(&SDOp->Index, hp, framedatasize);
|
|
/* update parameter buffer pointer */
|
|
hp += framedatasize;
|
|
psize -= framedatasize;
|
|
/* send SDO download request */
|
|
wkc = ecx_mbxsend(context, Slave, (ec_mbxbuft *)&MbxOut, EC_TIMEOUTTXM);
|
|
if (wkc > 0)
|
|
{
|
|
ec_clearmbx(&MbxIn);
|
|
/* read slave response */
|
|
wkc = ecx_mbxreceive(context, Slave, (ec_mbxbuft *)&MbxIn, Timeout);
|
|
if (wkc > 0)
|
|
{
|
|
if (((aSDOp->MbxHeader.mbxtype & 0x0f) == ECT_MBXT_COE) &&
|
|
((etohs(aSDOp->CANOpen) >> 12) == ECT_COES_SDORES) &&
|
|
((aSDOp->Command & 0xe0) == 0x20))
|
|
{
|
|
/* all OK, nothing to do */
|
|
}
|
|
else
|
|
{
|
|
if (aSDOp->Command == ECT_SDO_ABORT) /* SDO abort frame received */
|
|
{
|
|
ecx_SDOerror(context, Slave, Index, SubIndex, etohl(aSDOp->ldata[0]));
|
|
}
|
|
else
|
|
{
|
|
ecx_packeterror(context, Slave, Index, SubIndex, 1); /* Unexpected frame returned */
|
|
}
|
|
wkc = 0;
|
|
NotLast = FALSE;
|
|
}
|
|
}
|
|
}
|
|
toggle = toggle ^ 0x10; /* toggle bit for segment request */
|
|
}
|
|
}
|
|
/* unexpected response from slave */
|
|
else
|
|
{
|
|
if (aSDOp->Command == ECT_SDO_ABORT) /* SDO abort frame received */
|
|
{
|
|
ecx_SDOerror(context, Slave, Index, SubIndex, etohl(aSDOp->ldata[0]));
|
|
}
|
|
else
|
|
{
|
|
ecx_packeterror(context, Slave, Index, SubIndex, 1); /* Unexpected frame returned */
|
|
}
|
|
wkc = 0;
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
return wkc;
|
|
}
|
|
|
|
/** CoE RxPDO write, blocking.
|
|
*
|
|
* A RxPDO download request is issued.
|
|
*
|
|
* @param[in] context = context struct
|
|
* @param[in] Slave = Slave number
|
|
* @param[in] RxPDOnumber = Related RxPDO number
|
|
* @param[in] psize = Size in bytes of PDO buffer.
|
|
* @param[out] p = Pointer to PDO buffer
|
|
* @return Workcounter from last slave response
|
|
*/
|
|
int ecx_RxPDO(ecx_contextt *context, uint16 Slave, uint16 RxPDOnumber, int psize, void *p)
|
|
{
|
|
ec_SDOt *SDOp;
|
|
int wkc, maxdata;
|
|
ec_mbxbuft MbxIn, MbxOut;
|
|
uint8 cnt;
|
|
uint16 framedatasize;
|
|
|
|
ec_clearmbx(&MbxIn);
|
|
/* Empty slave out mailbox if something is in. Timout set to 0 */
|
|
wkc = ecx_mbxreceive(context, Slave, (ec_mbxbuft *)&MbxIn, 0);
|
|
ec_clearmbx(&MbxOut);
|
|
SDOp = (ec_SDOt *)&MbxOut;
|
|
maxdata = context->slavelist[Slave].mbx_l - 0x08; /* data section=mailbox size - 6 mbx - 2 CoE */
|
|
framedatasize = psize;
|
|
if (framedatasize > maxdata)
|
|
{
|
|
framedatasize = maxdata; /* limit transfer */
|
|
}
|
|
SDOp->MbxHeader.length = htoes(0x02 + framedatasize);
|
|
SDOp->MbxHeader.address = htoes(0x0000);
|
|
SDOp->MbxHeader.priority = 0x00;
|
|
/* get new mailbox counter, used for session handle */
|
|
cnt = ec_nextmbxcnt(context->slavelist[Slave].mbx_cnt);
|
|
context->slavelist[Slave].mbx_cnt = cnt;
|
|
SDOp->MbxHeader.mbxtype = ECT_MBXT_COE + (cnt << 4); /* CoE */
|
|
SDOp->CANOpen = htoes((RxPDOnumber & 0x01ff) + (ECT_COES_RXPDO << 12)); /* number 9bits service upper 4 bits */
|
|
/* copy PDO data to mailbox */
|
|
memcpy(&SDOp->Command, p, framedatasize);
|
|
/* send mailbox RxPDO request to slave */
|
|
wkc = ecx_mbxsend(context, Slave, (ec_mbxbuft *)&MbxOut, EC_TIMEOUTTXM);
|
|
|
|
return wkc;
|
|
}
|
|
|
|
/** CoE TxPDO read remote request, blocking.
|
|
*
|
|
* A RxPDO download request is issued.
|
|
*
|
|
* @param[in] context = context struct
|
|
* @param[in] slave = Slave number
|
|
* @param[in] TxPDOnumber = Related TxPDO number
|
|
* @param[in,out] psize = Size in bytes of PDO buffer, returns bytes read from PDO.
|
|
* @param[out] p = Pointer to PDO buffer
|
|
* @param[in] timeout = Timeout in us, standard is EC_TIMEOUTRXM
|
|
* @return Workcounter from last slave response
|
|
*/
|
|
int ecx_TxPDO(ecx_contextt *context, uint16 slave, uint16 TxPDOnumber , int *psize, void *p, int timeout)
|
|
{
|
|
ec_SDOt *SDOp, *aSDOp;
|
|
int wkc;
|
|
ec_mbxbuft MbxIn, MbxOut;
|
|
uint8 cnt;
|
|
uint16 framedatasize;
|
|
|
|
ec_clearmbx(&MbxIn);
|
|
/* Empty slave out mailbox if something is in. Timout set to 0 */
|
|
wkc = ecx_mbxreceive(context, slave, (ec_mbxbuft *)&MbxIn, 0);
|
|
ec_clearmbx(&MbxOut);
|
|
aSDOp = (ec_SDOt *)&MbxIn;
|
|
SDOp = (ec_SDOt *)&MbxOut;
|
|
SDOp->MbxHeader.length = htoes(0x02);
|
|
SDOp->MbxHeader.address = htoes(0x0000);
|
|
SDOp->MbxHeader.priority = 0x00;
|
|
/* get new mailbox counter, used for session handle */
|
|
cnt = ec_nextmbxcnt(context->slavelist[slave].mbx_cnt);
|
|
context->slavelist[slave].mbx_cnt = cnt;
|
|
SDOp->MbxHeader.mbxtype = ECT_MBXT_COE + (cnt << 4); /* CoE */
|
|
SDOp->CANOpen = htoes((TxPDOnumber & 0x01ff) + (ECT_COES_TXPDO_RR << 12)); /* number 9bits service upper 4 bits */
|
|
wkc = ecx_mbxsend(context, slave, (ec_mbxbuft *)&MbxOut, EC_TIMEOUTTXM);
|
|
if (wkc > 0)
|
|
{
|
|
/* clean mailboxbuffer */
|
|
ec_clearmbx(&MbxIn);
|
|
/* read slave response */
|
|
wkc = ecx_mbxreceive(context, slave, (ec_mbxbuft *)&MbxIn, timeout);
|
|
if (wkc > 0) /* succeeded to read slave response ? */
|
|
{
|
|
/* slave response should be CoE, TxPDO */
|
|
if (((aSDOp->MbxHeader.mbxtype & 0x0f) == ECT_MBXT_COE) &&
|
|
((etohs(aSDOp->CANOpen) >> 12) == ECT_COES_TXPDO))
|
|
{
|
|
/* TxPDO response */
|
|
framedatasize = (aSDOp->MbxHeader.length - 2);
|
|
if (*psize >= framedatasize) /* parameter buffer big enough ? */
|
|
{
|
|
/* copy parameter in parameter buffer */
|
|
memcpy(p, &aSDOp->Command, framedatasize);
|
|
/* return the real parameter size */
|
|
*psize = framedatasize;
|
|
}
|
|
/* parameter buffer too small */
|
|
else
|
|
{
|
|
wkc = 0;
|
|
ecx_packeterror(context, slave, 0, 0, 3); /* data container too small for type */
|
|
}
|
|
}
|
|
/* other slave response */
|
|
else
|
|
{
|
|
if ((aSDOp->Command) == ECT_SDO_ABORT) /* SDO abort frame received */
|
|
{
|
|
ecx_SDOerror(context, slave, 0, 0, etohl(aSDOp->ldata[0]));
|
|
}
|
|
else
|
|
{
|
|
ecx_packeterror(context, slave, 0, 0, 1); /* Unexpected frame returned */
|
|
}
|
|
wkc = 0;
|
|
}
|
|
}
|
|
}
|
|
|
|
return wkc;
|
|
}
|
|
|
|
/** Read PDO assign structure
|
|
* @param[in] context = context struct
|
|
* @param[in] Slave = Slave number
|
|
* @param[in] PDOassign = PDO assign object
|
|
* @return total bitlength of PDO assign
|
|
*/
|
|
int ecx_readPDOassign(ecx_contextt *context, uint16 Slave, uint16 PDOassign)
|
|
{
|
|
uint16 idxloop, nidx, subidxloop, rdat, idx, subidx;
|
|
uint8 subcnt;
|
|
int wkc, bsize = 0, rdl;
|
|
int32 rdat2;
|
|
|
|
rdl = sizeof(rdat); rdat = 0;
|
|
/* read PDO assign subindex 0 ( = number of PDO's) */
|
|
wkc = ecx_SDOread(context, Slave, PDOassign, 0x00, FALSE, &rdl, &rdat, EC_TIMEOUTRXM);
|
|
rdat = etohs(rdat);
|
|
/* positive result from slave ? */
|
|
if ((wkc > 0) && (rdat > 0))
|
|
{
|
|
/* number of available sub indexes */
|
|
nidx = rdat;
|
|
bsize = 0;
|
|
/* read all PDO's */
|
|
for (idxloop = 1; idxloop <= nidx; idxloop++)
|
|
{
|
|
rdl = sizeof(rdat); rdat = 0;
|
|
/* read PDO assign */
|
|
wkc = ecx_SDOread(context, Slave, PDOassign, (uint8)idxloop, FALSE, &rdl, &rdat, EC_TIMEOUTRXM);
|
|
/* result is index of PDO */
|
|
idx = etohl(rdat);
|
|
if (idx > 0)
|
|
{
|
|
rdl = sizeof(subcnt); subcnt = 0;
|
|
/* read number of subindexes of PDO */
|
|
wkc = ecx_SDOread(context, Slave,idx, 0x00, FALSE, &rdl, &subcnt, EC_TIMEOUTRXM);
|
|
subidx = subcnt;
|
|
/* for each subindex */
|
|
for (subidxloop = 1; subidxloop <= subidx; subidxloop++)
|
|
{
|
|
rdl = sizeof(rdat2); rdat2 = 0;
|
|
/* read SDO that is mapped in PDO */
|
|
wkc = ecx_SDOread(context, Slave, idx, (uint8)subidxloop, FALSE, &rdl, &rdat2, EC_TIMEOUTRXM);
|
|
rdat2 = etohl(rdat2);
|
|
/* extract bitlength of SDO */
|
|
if (LO_BYTE(rdat2) < 0xff)
|
|
{
|
|
bsize += LO_BYTE(rdat2);
|
|
}
|
|
else
|
|
{
|
|
rdl = sizeof(rdat); rdat = htoes(0xff);
|
|
/* read Object Entry in Object database */
|
|
// wkc = ec_readOEsingle(idx, (uint8)SubCount, pODlist, pOElist);
|
|
bsize += etohs(rdat);
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
/* return total found bitlength (PDO) */
|
|
return bsize;
|
|
}
|
|
|
|
/** Read PDO assign structure in Complete Access mode
|
|
* @param[in] context = context struct
|
|
* @param[in] Slave = Slave number
|
|
* @param[in] Thread_n = Calling thread index
|
|
* @param[in] PDOassign = PDO assign object
|
|
* @return total bitlength of PDO assign
|
|
*/
|
|
int ecx_readPDOassignCA(ecx_contextt *context, uint16 Slave, int Thread_n,
|
|
uint16 PDOassign)
|
|
{
|
|
uint16 idxloop, nidx, subidxloop, idx, subidx;
|
|
int wkc, bsize = 0, rdl;
|
|
|
|
/* find maximum size of PDOassign buffer */
|
|
rdl = sizeof(ec_PDOassignt);
|
|
context->PDOassign[Thread_n].n=0;
|
|
/* read rxPDOassign in CA mode, all subindexes are read in one struct */
|
|
wkc = ecx_SDOread(context, Slave, PDOassign, 0x00, TRUE, &rdl,
|
|
&(context->PDOassign[Thread_n]), EC_TIMEOUTRXM);
|
|
/* positive result from slave ? */
|
|
if ((wkc > 0) && (context->PDOassign[Thread_n].n > 0))
|
|
{
|
|
nidx = context->PDOassign[Thread_n].n;
|
|
bsize = 0;
|
|
/* for each PDO do */
|
|
for (idxloop = 1; idxloop <= nidx; idxloop++)
|
|
{
|
|
/* get index from PDOassign struct */
|
|
idx = etohs(context->PDOassign[Thread_n].index[idxloop - 1]);
|
|
if (idx > 0)
|
|
{
|
|
rdl = sizeof(ec_PDOdesct); context->PDOdesc[Thread_n].n = 0;
|
|
/* read SDO's that are mapped in PDO, CA mode */
|
|
wkc = ecx_SDOread(context, Slave,idx, 0x00, TRUE, &rdl,
|
|
&(context->PDOdesc[Thread_n]), EC_TIMEOUTRXM);
|
|
subidx = context->PDOdesc[Thread_n].n;
|
|
/* extract all bitlengths of SDO's */
|
|
for (subidxloop = 1; subidxloop <= subidx; subidxloop++)
|
|
{
|
|
bsize += LO_BYTE(etohl(context->PDOdesc[Thread_n].PDO[subidxloop -1]));
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
/* return total found bitlength (PDO) */
|
|
return bsize;
|
|
}
|
|
|
|
/** CoE read PDO mapping.
|
|
*
|
|
* CANopen has standard indexes defined for PDO mapping. This function
|
|
* tries to read them and collect a full input and output mapping size
|
|
* of designated slave.
|
|
*
|
|
* Principal structure in slave:\n
|
|
* 1C00:00 is number of SM defined\n
|
|
* 1C00:01 SM0 type -> 1C10\n
|
|
* 1C00:02 SM1 type -> 1C11\n
|
|
* 1C00:03 SM2 type -> 1C12\n
|
|
* 1C00:04 SM3 type -> 1C13\n
|
|
* Type 0 = unused, 1 = mailbox in, 2 = mailbox out,
|
|
* 3 = outputs (RxPDO), 4 = inputs (TxPDO).
|
|
*
|
|
* 1C12:00 is number of PDO's defined for SM2\n
|
|
* 1C12:01 PDO assign SDO #1 -> f.e. 1A00\n
|
|
* 1C12:02 PDO assign SDO #2 -> f.e. 1A04\
|
|
*
|
|
* 1A00:00 is number of object defined for this PDO\n
|
|
* 1A00:01 object mapping #1, f.e. 60100710 (SDO 6010 SI 07 bitlength 0x10)
|
|
*
|
|
* @param[in] context = context struct
|
|
* @param[in] Slave = Slave number
|
|
* @param[out] Osize = Size in bits of output mapping (rxPDO) found
|
|
* @param[out] Isize = Size in bits of input mapping (txPDO) found
|
|
* @return >0 if mapping succesful.
|
|
*/
|
|
int ecx_readPDOmap(ecx_contextt *context, uint16 Slave, int *Osize, int *Isize)
|
|
{
|
|
int wkc, rdl;
|
|
int retVal = 0;
|
|
uint8 nSM, iSM, tSM;
|
|
int Tsize;
|
|
uint8 SMt_bug_add;
|
|
|
|
*Isize = 0;
|
|
*Osize = 0;
|
|
SMt_bug_add = 0;
|
|
rdl = sizeof(nSM); nSM = 0;
|
|
/* read SyncManager Communication Type object count */
|
|
wkc = ecx_SDOread(context, Slave, ECT_SDO_SMCOMMTYPE, 0x00, FALSE, &rdl, &nSM, EC_TIMEOUTRXM);
|
|
/* positive result from slave ? */
|
|
if ((wkc > 0) && (nSM > 2))
|
|
{
|
|
/* limit to maximum number of SM defined, if true the slave can't be configured */
|
|
if (nSM > EC_MAXSM)
|
|
nSM = EC_MAXSM;
|
|
/* iterate for every SM type defined */
|
|
for (iSM = 2 ; iSM < nSM ; iSM++)
|
|
{
|
|
rdl = sizeof(tSM); tSM = 0;
|
|
/* read SyncManager Communication Type */
|
|
wkc = ecx_SDOread(context, Slave, ECT_SDO_SMCOMMTYPE, iSM + 1, FALSE, &rdl, &tSM, EC_TIMEOUTRXM);
|
|
if (wkc > 0)
|
|
{
|
|
// start slave bug prevention code, remove if possible
|
|
if((iSM == 2) && (tSM == 2)) // SM2 has type 2 == mailbox out, this is a bug in the slave!
|
|
{
|
|
SMt_bug_add = 1; // try to correct, this works if the types are 0 1 2 3 and should be 1 2 3 4
|
|
}
|
|
if(tSM)
|
|
{
|
|
tSM += SMt_bug_add; // only add if SMt > 0
|
|
}
|
|
if((iSM == 2) && (tSM == 0)) // SM2 has type 0, this is a bug in the slave!
|
|
{
|
|
tSM = 3;
|
|
}
|
|
if((iSM == 3) && (tSM == 0)) // SM3 has type 0, this is a bug in the slave!
|
|
{
|
|
tSM = 4;
|
|
}
|
|
// end slave bug prevention code
|
|
|
|
context->slavelist[Slave].SMtype[iSM] = tSM;
|
|
/* check if SM is unused -> clear enable flag */
|
|
if (tSM == 0)
|
|
{
|
|
context->slavelist[Slave].SM[iSM].SMflags =
|
|
htoel( etohl(context->slavelist[Slave].SM[iSM].SMflags) & EC_SMENABLEMASK);
|
|
}
|
|
if ((tSM == 3) || (tSM == 4))
|
|
{
|
|
/* read the assign PDO */
|
|
Tsize = ecx_readPDOassign(context, Slave, ECT_SDO_PDOASSIGN + iSM );
|
|
/* if a mapping is found */
|
|
if (Tsize)
|
|
{
|
|
context->slavelist[Slave].SM[iSM].SMlength = htoes((Tsize + 7) / 8);
|
|
if (tSM == 3)
|
|
{
|
|
/* we are doing outputs */
|
|
*Osize += Tsize;
|
|
}
|
|
else
|
|
{
|
|
/* we are doing inputs */
|
|
*Isize += Tsize;
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
/* found some I/O bits ? */
|
|
if ((*Isize > 0) || (*Osize > 0))
|
|
{
|
|
retVal = 1;
|
|
}
|
|
|
|
return retVal;
|
|
}
|
|
|
|
/** CoE read PDO mapping in Complete Access mode (CA).
|
|
*
|
|
* CANopen has standard indexes defined for PDO mapping. This function
|
|
* tries to read them and collect a full input and output mapping size
|
|
* of designated slave. Slave has to support CA, otherwise use ec_readPDOmap().
|
|
*
|
|
* @param[in] context = context struct
|
|
* @param[in] Slave = Slave number
|
|
* @param[in] Thread_n = Calling thread index
|
|
* @param[out] Osize = Size in bits of output mapping (rxPDO) found
|
|
* @param[out] Isize = Size in bits of input mapping (txPDO) found
|
|
* @return >0 if mapping succesful.
|
|
*/
|
|
int ecx_readPDOmapCA(ecx_contextt *context, uint16 Slave, int Thread_n, int *Osize, int *Isize)
|
|
{
|
|
int wkc, rdl;
|
|
int retVal = 0;
|
|
uint8 nSM, iSM, tSM;
|
|
int Tsize;
|
|
uint8 SMt_bug_add;
|
|
|
|
*Isize = 0;
|
|
*Osize = 0;
|
|
SMt_bug_add = 0;
|
|
rdl = sizeof(ec_SMcommtypet);
|
|
context->SMcommtype[Thread_n].n = 0;
|
|
/* read SyncManager Communication Type object count Complete Access*/
|
|
wkc = ecx_SDOread(context, Slave, ECT_SDO_SMCOMMTYPE, 0x00, TRUE, &rdl,
|
|
&(context->SMcommtype[Thread_n]), EC_TIMEOUTRXM);
|
|
/* positive result from slave ? */
|
|
if ((wkc > 0) && (context->SMcommtype[Thread_n].n > 2))
|
|
{
|
|
nSM = context->SMcommtype[Thread_n].n;
|
|
/* limit to maximum number of SM defined, if true the slave can't be configured */
|
|
if (nSM > EC_MAXSM)
|
|
{
|
|
nSM = EC_MAXSM;
|
|
ecx_packeterror(context, Slave, 0, 0, 10); /* #SM larger than EC_MAXSM */
|
|
}
|
|
/* iterate for every SM type defined */
|
|
for (iSM = 2 ; iSM < nSM ; iSM++)
|
|
{
|
|
tSM = context->SMcommtype[Thread_n].SMtype[iSM];
|
|
|
|
// start slave bug prevention code, remove if possible
|
|
if((iSM == 2) && (tSM == 2)) // SM2 has type 2 == mailbox out, this is a bug in the slave!
|
|
{
|
|
SMt_bug_add = 1; // try to correct, this works if the types are 0 1 2 3 and should be 1 2 3 4
|
|
}
|
|
if(tSM)
|
|
{
|
|
tSM += SMt_bug_add; // only add if SMt > 0
|
|
}
|
|
// end slave bug prevention code
|
|
|
|
context->slavelist[Slave].SMtype[iSM] = tSM;
|
|
/* check if SM is unused -> clear enable flag */
|
|
if (tSM == 0)
|
|
{
|
|
context->slavelist[Slave].SM[iSM].SMflags =
|
|
htoel( etohl(context->slavelist[Slave].SM[iSM].SMflags) & EC_SMENABLEMASK);
|
|
}
|
|
if ((tSM == 3) || (tSM == 4))
|
|
{
|
|
/* read the assign PDO */
|
|
Tsize = ecx_readPDOassignCA(context, Slave, Thread_n,
|
|
ECT_SDO_PDOASSIGN + iSM );
|
|
/* if a mapping is found */
|
|
if (Tsize)
|
|
{
|
|
context->slavelist[Slave].SM[iSM].SMlength = htoes((Tsize + 7) / 8);
|
|
if (tSM == 3)
|
|
{
|
|
/* we are doing outputs */
|
|
*Osize += Tsize;
|
|
}
|
|
else
|
|
{
|
|
/* we are doing inputs */
|
|
*Isize += Tsize;
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
/* found some I/O bits ? */
|
|
if ((*Isize > 0) || (*Osize > 0))
|
|
{
|
|
retVal = 1;
|
|
}
|
|
return retVal;
|
|
}
|
|
|
|
/** CoE read Object Description List.
|
|
*
|
|
* @param[in] context = context struct
|
|
* @param[in] Slave = Slave number.
|
|
* @param[out] pODlist = resulting Object Description list.
|
|
* @return Workcounter of slave response.
|
|
*/
|
|
int ecx_readODlist(ecx_contextt *context, uint16 Slave, ec_ODlistt *pODlist)
|
|
{
|
|
ec_SDOservicet *SDOp, *aSDOp;
|
|
ec_mbxbuft MbxIn, MbxOut;
|
|
int wkc;
|
|
uint16 x, n, i, sp, offset;
|
|
boolean stop;
|
|
uint8 cnt;
|
|
boolean First;
|
|
|
|
pODlist->Slave = Slave;
|
|
pODlist->Entries = 0;
|
|
ec_clearmbx(&MbxIn);
|
|
/* clear pending out mailbox in slave if available. Timeout is set to 0 */
|
|
wkc = ecx_mbxreceive(context, Slave, &MbxIn, 0);
|
|
ec_clearmbx(&MbxOut);
|
|
aSDOp = (ec_SDOservicet*)&MbxIn;
|
|
SDOp = (ec_SDOservicet*)&MbxOut;
|
|
SDOp->MbxHeader.length = htoes(0x0008);
|
|
SDOp->MbxHeader.address = htoes(0x0000);
|
|
SDOp->MbxHeader.priority = 0x00;
|
|
/* Get new mailbox counter value */
|
|
cnt = ec_nextmbxcnt(context->slavelist[Slave].mbx_cnt);
|
|
context->slavelist[Slave].mbx_cnt = cnt;
|
|
SDOp->MbxHeader.mbxtype = ECT_MBXT_COE + (cnt << 4); /* CoE */
|
|
SDOp->CANOpen = htoes(0x000 + (ECT_COES_SDOINFO << 12)); /* number 9bits service upper 4 bits */
|
|
SDOp->Opcode = ECT_GET_ODLIST_REQ; /* get object description list request */
|
|
SDOp->Reserved = 0;
|
|
SDOp->Fragments = 0; /* fragments left */
|
|
SDOp->wdata[0] = htoes(0x01); /* all objects */
|
|
/* send get object description list request to slave */
|
|
wkc = ecx_mbxsend(context, Slave, &MbxOut, EC_TIMEOUTTXM);
|
|
/* mailbox placed in slave ? */
|
|
if (wkc > 0)
|
|
{
|
|
x = 0;
|
|
sp = 0;
|
|
First = TRUE;
|
|
offset = 1; /* offset to skip info header in first frame, otherwise set to 0 */
|
|
do
|
|
{
|
|
stop = TRUE; /* assume this is last iteration */
|
|
ec_clearmbx(&MbxIn);
|
|
/* read slave response */
|
|
wkc = ecx_mbxreceive(context, Slave, &MbxIn, EC_TIMEOUTRXM);
|
|
/* got response ? */
|
|
if (wkc > 0)
|
|
{
|
|
/* response should be CoE and "get object description list response" */
|
|
if (((aSDOp->MbxHeader.mbxtype & 0x0f) == ECT_MBXT_COE) &&
|
|
((aSDOp->Opcode & 0x7f) == ECT_GET_ODLIST_RES))
|
|
{
|
|
if (First)
|
|
{
|
|
/* extract number of indexes from mailbox data size */
|
|
n = (etohs(aSDOp->MbxHeader.length) - (6 + 2)) / 2;
|
|
}
|
|
else
|
|
{
|
|
/* extract number of indexes from mailbox data size */
|
|
n = (etohs(aSDOp->MbxHeader.length) - 6) / 2;
|
|
}
|
|
/* check if indexes fit in buffer structure */
|
|
if ((sp + n) > EC_MAXODLIST)
|
|
{
|
|
n = EC_MAXODLIST + 1 - sp;
|
|
ecx_SDOinfoerror(context, Slave, 0, 0, 0xf000000); /* Too many entries for master buffer */
|
|
stop = TRUE;
|
|
}
|
|
/* trim to maximum number of ODlist entries defined */
|
|
if ((pODlist->Entries + n) > EC_MAXODLIST)
|
|
{
|
|
n = EC_MAXODLIST - pODlist->Entries;
|
|
}
|
|
pODlist->Entries += n;
|
|
/* extract indexes one by one */
|
|
for (i = 0; i < n; i++)
|
|
{
|
|
pODlist->Index[sp + i] = etohs(aSDOp->wdata[i + offset]);
|
|
}
|
|
sp += n;
|
|
/* check if more fragments will follow */
|
|
if (aSDOp->Fragments > 0)
|
|
{
|
|
stop = FALSE;
|
|
}
|
|
First = FALSE;
|
|
offset = 0;
|
|
}
|
|
/* got unexpected response from slave */
|
|
else
|
|
{
|
|
if ((aSDOp->Opcode & 0x7f) == ECT_SDOINFO_ERROR) /* SDO info error received */
|
|
{
|
|
ecx_SDOinfoerror(context, Slave, 0, 0, etohl(aSDOp->ldata[0]));
|
|
stop = TRUE;
|
|
}
|
|
else
|
|
{
|
|
ecx_packeterror(context, Slave, 0, 0, 1); /* Unexpected frame returned */
|
|
}
|
|
wkc = 0;
|
|
x += 20;
|
|
}
|
|
}
|
|
x++;
|
|
}
|
|
while ((x <= 128) && !stop);
|
|
}
|
|
return wkc;
|
|
}
|
|
|
|
/** CoE read Object Description. Adds textual description to object indexes.
|
|
*
|
|
* @param[in] context = context struct
|
|
* @param[in] Item = Item number in ODlist.
|
|
* @param[in,out] pODlist = referencing Object Description list.
|
|
* @return Workcounter of slave response.
|
|
*/
|
|
int ecx_readODdescription(ecx_contextt *context, uint16 Item, ec_ODlistt *pODlist)
|
|
{
|
|
ec_SDOservicet *SDOp, *aSDOp;
|
|
int wkc;
|
|
uint16 n, Slave;
|
|
ec_mbxbuft MbxIn, MbxOut;
|
|
uint8 cnt;
|
|
|
|
Slave = pODlist->Slave;
|
|
pODlist->DataType[Item] = 0;
|
|
pODlist->ObjectCode[Item] = 0;
|
|
pODlist->MaxSub[Item] = 0;
|
|
pODlist->Name[Item][0] = 0;
|
|
ec_clearmbx(&MbxIn);
|
|
/* clear pending out mailbox in slave if available. Timeout is set to 0 */
|
|
wkc = ecx_mbxreceive(context, Slave, &MbxIn, 0);
|
|
ec_clearmbx(&MbxOut);
|
|
aSDOp = (ec_SDOservicet*)&MbxIn;
|
|
SDOp = (ec_SDOservicet*)&MbxOut;
|
|
SDOp->MbxHeader.length = htoes(0x0008);
|
|
SDOp->MbxHeader.address = htoes(0x0000);
|
|
SDOp->MbxHeader.priority = 0x00;
|
|
/* Get new mailbox counter value */
|
|
cnt = ec_nextmbxcnt(context->slavelist[Slave].mbx_cnt);
|
|
context->slavelist[Slave].mbx_cnt = cnt;
|
|
SDOp->MbxHeader.mbxtype = ECT_MBXT_COE + (cnt << 4); /* CoE */
|
|
SDOp->CANOpen = htoes(0x000 + (ECT_COES_SDOINFO << 12)); /* number 9bits service upper 4 bits */
|
|
SDOp->Opcode = ECT_GET_OD_REQ; /* get object description request */
|
|
SDOp->Reserved = 0;
|
|
SDOp->Fragments = 0; /* fragments left */
|
|
SDOp->wdata[0] = htoes(pODlist->Index[Item]); /* Data of Index */
|
|
/* send get object description request to slave */
|
|
wkc = ecx_mbxsend(context, Slave, &MbxOut, EC_TIMEOUTTXM);
|
|
/* mailbox placed in slave ? */
|
|
if (wkc > 0)
|
|
{
|
|
ec_clearmbx(&MbxIn);
|
|
/* read slave response */
|
|
wkc = ecx_mbxreceive(context, Slave, &MbxIn, EC_TIMEOUTRXM);
|
|
/* got response ? */
|
|
if (wkc > 0)
|
|
{
|
|
if (((aSDOp->MbxHeader.mbxtype & 0x0f) == ECT_MBXT_COE) &&
|
|
((aSDOp->Opcode & 0x7f) == ECT_GET_OD_RES))
|
|
{
|
|
n = (etohs(aSDOp->MbxHeader.length) - 12); /* length of string(name of object) */
|
|
if (n > EC_MAXNAME)
|
|
{
|
|
n = EC_MAXNAME; /* max chars */
|
|
}
|
|
pODlist->DataType[Item] = etohs(aSDOp->wdata[1]);
|
|
pODlist->ObjectCode[Item] = aSDOp->bdata[5];
|
|
pODlist->MaxSub[Item] = aSDOp->bdata[4];
|
|
|
|
strncpy(pODlist->Name[Item] , (char *)&aSDOp->bdata[6], n);
|
|
pODlist->Name[Item][n] = 0x00; /* String terminator */
|
|
}
|
|
/* got unexpected response from slave */
|
|
else
|
|
{
|
|
if (((aSDOp->Opcode & 0x7f) == ECT_SDOINFO_ERROR)) /* SDO info error received */
|
|
{
|
|
ecx_SDOinfoerror(context, Slave,pODlist->Index[Item], 0, etohl(aSDOp->ldata[0]));
|
|
}
|
|
else
|
|
{
|
|
ecx_packeterror(context, Slave,pODlist->Index[Item], 0, 1); /* Unexpected frame returned */
|
|
}
|
|
wkc = 0;
|
|
}
|
|
}
|
|
}
|
|
|
|
return wkc;
|
|
}
|
|
|
|
/** CoE read SDO service object entry, single subindex.
|
|
* Used in ec_readOE().
|
|
*
|
|
* @param[in] context = context struct
|
|
* @param[in] Item = Item in ODlist.
|
|
* @param[in] SubI = Subindex of item in ODlist.
|
|
* @param[in] pODlist = Object description list for reference.
|
|
* @param[out] pOElist = resulting object entry structure.
|
|
* @return Workcounter of slave response.
|
|
*/
|
|
int ecx_readOEsingle(ecx_contextt *context, uint16 Item, uint8 SubI, ec_ODlistt *pODlist, ec_OElistt *pOElist)
|
|
{
|
|
ec_SDOservicet *SDOp, *aSDOp;
|
|
int wkc;
|
|
uint16 Index, Slave;
|
|
int16 n;
|
|
ec_mbxbuft MbxIn, MbxOut;
|
|
uint8 cnt;
|
|
|
|
wkc = 0;
|
|
Slave = pODlist->Slave;
|
|
Index = pODlist->Index[Item];
|
|
ec_clearmbx(&MbxIn);
|
|
/* clear pending out mailbox in slave if available. Timeout is set to 0 */
|
|
wkc = ecx_mbxreceive(context, Slave, &MbxIn, 0);
|
|
ec_clearmbx(&MbxOut);
|
|
aSDOp = (ec_SDOservicet*)&MbxIn;
|
|
SDOp = (ec_SDOservicet*)&MbxOut;
|
|
SDOp->MbxHeader.length = htoes(0x000a);
|
|
SDOp->MbxHeader.address = htoes(0x0000);
|
|
SDOp->MbxHeader.priority = 0x00;
|
|
/* Get new mailbox counter value */
|
|
cnt = ec_nextmbxcnt(context->slavelist[Slave].mbx_cnt);
|
|
context->slavelist[Slave].mbx_cnt = cnt;
|
|
SDOp->MbxHeader.mbxtype = ECT_MBXT_COE + (cnt << 4); /* CoE */
|
|
SDOp->CANOpen = htoes(0x000 + (ECT_COES_SDOINFO << 12)); /* number 9bits service upper 4 bits */
|
|
SDOp->Opcode = ECT_GET_OE_REQ; /* get object entry description request */
|
|
SDOp->Reserved = 0;
|
|
SDOp->Fragments = 0; /* fragments left */
|
|
SDOp->wdata[0] = htoes(Index); /* Index */
|
|
SDOp->bdata[2] = SubI; /* SubIndex */
|
|
SDOp->bdata[3] = 1 + 2 + 4; /* get access rights, object category, PDO */
|
|
/* send get object entry description request to slave */
|
|
wkc = ecx_mbxsend(context, Slave, &MbxOut, EC_TIMEOUTTXM);
|
|
/* mailbox placed in slave ? */
|
|
if (wkc > 0)
|
|
{
|
|
ec_clearmbx(&MbxIn);
|
|
/* read slave response */
|
|
wkc = ecx_mbxreceive(context, Slave, &MbxIn, EC_TIMEOUTRXM);
|
|
/* got response ? */
|
|
if (wkc > 0)
|
|
{
|
|
if (((aSDOp->MbxHeader.mbxtype & 0x0f) == ECT_MBXT_COE) &&
|
|
((aSDOp->Opcode & 0x7f) == ECT_GET_OE_RES))
|
|
{
|
|
pOElist->Entries++;
|
|
n = (etohs(aSDOp->MbxHeader.length) - 16); /* length of string(name of object) */
|
|
if (n > EC_MAXNAME)
|
|
{
|
|
n = EC_MAXNAME; /* max string length */
|
|
}
|
|
if (n < 0 )
|
|
{
|
|
n = 0;
|
|
}
|
|
pOElist->ValueInfo[SubI] = aSDOp->bdata[3];
|
|
pOElist->DataType[SubI] = etohs(aSDOp->wdata[2]);
|
|
pOElist->BitLength[SubI] = etohs(aSDOp->wdata[3]);
|
|
pOElist->ObjAccess[SubI] = etohs(aSDOp->wdata[4]);
|
|
|
|
strncpy(pOElist->Name[SubI] , (char *)&aSDOp->wdata[5], n);
|
|
pOElist->Name[SubI][n] = 0x00; /* string terminator */
|
|
}
|
|
/* got unexpected response from slave */
|
|
else
|
|
{
|
|
if (((aSDOp->Opcode & 0x7f) == ECT_SDOINFO_ERROR)) /* SDO info error received */
|
|
{
|
|
ecx_SDOinfoerror(context, Slave, Index, SubI, etohl(aSDOp->ldata[0]));
|
|
}
|
|
else
|
|
{
|
|
ecx_packeterror(context, Slave, Index, SubI, 1); /* Unexpected frame returned */
|
|
}
|
|
wkc = 0;
|
|
}
|
|
}
|
|
}
|
|
|
|
return wkc;
|
|
}
|
|
|
|
/** CoE read SDO service object entry.
|
|
*
|
|
* @param[in] context = context struct
|
|
* @param[in] Item = Item in ODlist.
|
|
* @param[in] pODlist = Object description list for reference.
|
|
* @param[out] pOElist = resulting object entry structure.
|
|
* @return Workcounter of slave response.
|
|
*/
|
|
int ecx_readOE(ecx_contextt *context, uint16 Item, ec_ODlistt *pODlist, ec_OElistt *pOElist)
|
|
{
|
|
uint16 SubCount;
|
|
int wkc;
|
|
uint8 SubI;
|
|
|
|
wkc = 0;
|
|
pOElist->Entries = 0;
|
|
SubI = pODlist->MaxSub[Item];
|
|
/* for each entry found in ODlist */
|
|
for (SubCount = 0; SubCount <= SubI; SubCount++)
|
|
{
|
|
/* read subindex of entry */
|
|
wkc = ecx_readOEsingle(context, Item, (uint8)SubCount, pODlist, pOElist);
|
|
}
|
|
|
|
return wkc;
|
|
}
|
|
|
|
#ifdef EC_VER1
|
|
/** Report SDO error.
|
|
*
|
|
* @param[in] Slave = Slave number
|
|
* @param[in] Index = Index that generated error
|
|
* @param[in] SubIdx = Subindex that generated error
|
|
* @param[in] AbortCode = Abortcode, see EtherCAT documentation for list
|
|
* @see ecx_SDOerror
|
|
*/
|
|
void ec_SDOerror(uint16 Slave, uint16 Index, uint8 SubIdx, int32 AbortCode)
|
|
{
|
|
ecx_SDOerror(&ecx_context, Slave, Index, SubIdx, AbortCode);
|
|
}
|
|
|
|
/** 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] 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
|
|
* @see ecx_SDOread
|
|
*/
|
|
int ec_SDOread(uint16 slave, uint16 index, uint8 subindex,
|
|
boolean CA, int *psize, void *p, int timeout)
|
|
{
|
|
return ecx_SDOread(&ecx_context, slave, index, subindex, CA, psize, p, 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] 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
|
|
* @see ecx_SDOwrite
|
|
*/
|
|
int ec_SDOwrite(uint16 Slave, uint16 Index, uint8 SubIndex,
|
|
boolean CA, int psize, void *p, int Timeout)
|
|
{
|
|
return ecx_SDOwrite(&ecx_context, Slave, Index, SubIndex, CA, psize, p, Timeout);
|
|
}
|
|
|
|
/** CoE RxPDO write, blocking.
|
|
*
|
|
* A RxPDO download request is issued.
|
|
*
|
|
* @param[in] Slave = Slave number
|
|
* @param[in] RxPDOnumber = Related RxPDO number
|
|
* @param[in] psize = Size in bytes of PDO buffer.
|
|
* @param[out] p = Pointer to PDO buffer
|
|
* @return Workcounter from last slave response
|
|
* @see ecx_RxPDO
|
|
*/
|
|
int ec_RxPDO(uint16 Slave, uint16 RxPDOnumber, int psize, void *p)
|
|
{
|
|
return ecx_RxPDO(&ecx_context, Slave, RxPDOnumber, psize, p);
|
|
}
|
|
|
|
/** CoE TxPDO read remote request, blocking.
|
|
*
|
|
* A RxPDO download request is issued.
|
|
*
|
|
* @param[in] slave = Slave number
|
|
* @param[in] TxPDOnumber = Related TxPDO number
|
|
* @param[in,out] psize = Size in bytes of PDO buffer, returns bytes read from PDO.
|
|
* @param[out] p = Pointer to PDO buffer
|
|
* @param[in] timeout = Timeout in us, standard is EC_TIMEOUTRXM
|
|
* @return Workcounter from last slave response
|
|
* @see ecx_TxPDO
|
|
*/
|
|
int ec_TxPDO(uint16 slave, uint16 TxPDOnumber , int *psize, void *p, int timeout)
|
|
{
|
|
return ecx_TxPDO(&ecx_context, slave, TxPDOnumber, psize, p, timeout);
|
|
}
|
|
|
|
/** Read PDO assign structure
|
|
* @param[in] Slave = Slave number
|
|
* @param[in] PDOassign = PDO assign object
|
|
* @return total bitlength of PDO assign
|
|
*/
|
|
int ec_readPDOassign(uint16 Slave, uint16 PDOassign)
|
|
{
|
|
return ecx_readPDOassign(&ecx_context, Slave, PDOassign);
|
|
}
|
|
|
|
/** Read PDO assign structure in Complete Access mode
|
|
* @param[in] Slave = Slave number
|
|
* @param[in] PDOassign = PDO assign object
|
|
* @param[in] Thread_n = Calling thread index
|
|
* @return total bitlength of PDO assign
|
|
* @see ecx_readPDOmap
|
|
*/
|
|
int ec_readPDOassignCA(uint16 Slave, uint16 PDOassign, int Thread_n)
|
|
{
|
|
return ecx_readPDOassignCA(&ecx_context, Slave, Thread_n, PDOassign);
|
|
}
|
|
|
|
/** CoE read PDO mapping.
|
|
*
|
|
* CANopen has standard indexes defined for PDO mapping. This function
|
|
* tries to read them and collect a full input and output mapping size
|
|
* of designated slave.
|
|
*
|
|
* For details, see #ecx_readPDOmap
|
|
*
|
|
* @param[in] Slave = Slave number
|
|
* @param[out] Osize = Size in bits of output mapping (rxPDO) found
|
|
* @param[out] Isize = Size in bits of input mapping (txPDO) found
|
|
* @return >0 if mapping succesful.
|
|
*/
|
|
int ec_readPDOmap(uint16 Slave, int *Osize, int *Isize)
|
|
{
|
|
return ecx_readPDOmap(&ecx_context, Slave, Osize, Isize);
|
|
}
|
|
|
|
/** CoE read PDO mapping in Complete Access mode (CA).
|
|
*
|
|
* CANopen has standard indexes defined for PDO mapping. This function
|
|
* tries to read them and collect a full input and output mapping size
|
|
* of designated slave. Slave has to support CA, otherwise use ec_readPDOmap().
|
|
*
|
|
* @param[in] Slave = Slave number
|
|
* @param[in] Thread_n = Calling thread index
|
|
* @param[out] Osize = Size in bits of output mapping (rxPDO) found
|
|
* @param[out] Isize = Size in bits of input mapping (txPDO) found
|
|
* @return >0 if mapping succesful.
|
|
* @see ecx_readPDOmap ec_readPDOmapCA
|
|
*/
|
|
int ec_readPDOmapCA(uint16 Slave, int Thread_n, int *Osize, int *Isize)
|
|
{
|
|
return ecx_readPDOmapCA(&ecx_context, Slave, Thread_n, Osize, Isize);
|
|
}
|
|
|
|
/** CoE read Object Description List.
|
|
*
|
|
* @param[in] Slave = Slave number.
|
|
* @param[out] pODlist = resulting Object Description list.
|
|
* @return Workcounter of slave response.
|
|
* @see ecx_readODlist
|
|
*/
|
|
int ec_readODlist(uint16 Slave, ec_ODlistt *pODlist)
|
|
{
|
|
return ecx_readODlist(&ecx_context, Slave, pODlist);
|
|
}
|
|
|
|
/** CoE read Object Description. Adds textual description to object indexes.
|
|
*
|
|
* @param[in] Item = Item number in ODlist.
|
|
* @param[in,out] pODlist = referencing Object Description list.
|
|
* @return Workcounter of slave response.
|
|
* @see ecx_readODdescription
|
|
*/
|
|
int ec_readODdescription(uint16 Item, ec_ODlistt *pODlist)
|
|
{
|
|
return ecx_readODdescription(&ecx_context, Item, pODlist);
|
|
}
|
|
|
|
int ec_readOEsingle(uint16 Item, uint8 SubI, ec_ODlistt *pODlist, ec_OElistt *pOElist)
|
|
{
|
|
return ecx_readOEsingle(&ecx_context, Item, SubI, pODlist, pOElist);
|
|
}
|
|
|
|
/** CoE read SDO service object entry.
|
|
*
|
|
* @param[in] Item = Item in ODlist.
|
|
* @param[in] pODlist = Object description list for reference.
|
|
* @param[out] pOElist = resulting object entry structure.
|
|
* @return Workcounter of slave response.
|
|
* @see ecx_readOE
|
|
*/
|
|
int ec_readOE(uint16 Item, ec_ODlistt *pODlist, ec_OElistt *pOElist)
|
|
{
|
|
return ecx_readOE(&ecx_context, Item, pODlist, pOElist);
|
|
}
|
|
#endif
|