Description
This function reads a 8bit value from the given object directory. The object entry is addressed with the given key and the value will be written to the given destination pointer.
Prototype
CPU_INT16S CODirRdByte(CO_DIR *cod, CPU_INT32U key, CPU_INT08U *val);
| Parameter | Description |
|---|---|
cod | pointer to the CANopen object directory |
key | object entry key; should be generated with the macro CO_DEV() |
| val | pointer to the value destination |
Returned Value
= CO_ERR.NONE Successful operation
!= CO_ERR.NONE An error is detected (see section "Error Identification")
Example
The following example reads the current value of the hypothetical application specific object entry "[1234:56]" within the object directory of the CANopen node AppNode.
Note: This function uses CODirFind() on each function call. To improve access performance for multiple accesses to a single object entry, the application may use CODirFind() once and COObjRdValue() multiple times.