COObjRdBufStart

COObjRdBufStart

Description

This function starts the read operation at the beginning of the byte stream from the given object directory entry into the given destination buffer.

Prototype

CPU_INT16S COObjRdBufStart(CO_OBJ     *obj ,
                           void       *buffer,
                           CPU_INT08U  len);

Returned Value

 = CO_ERR.NONE   Successful operation

!= CO_ERR.NONE  An error is detected (see section "Error Identification")

Example

The following example reads the byte-stream of the hypothetical application specific object entry "[1234:56]" within the object directory of the CANopen node AppNode.

    CPU_INT08U  buffer[10];
    CPU_INT16S  err;
    CO_OBJ     *entry;
    :
    entry = CODirFind      (&(AppNode.Dir), CO_DEV(0x1234,0x56));
    err   = COObjRdBufStart(entry, buffer, 10);
    if (err == CO_ERR_NONE) {
        do {
            /* read all packages from stream */
            err = COObjRdBufCont(entry, buffer, 10);
        } while (err == CO_ERR_NONE);
    } else {
        /* error during reading */
    }
    :