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);

Parameter	Description
`obj`	pointer to the CANopen directory entry
`buffer`	pointer to the destination buffer
len	length of destination buffer

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 */
    }
    :