CODirWrByte
Description
This function writes a 8bit value to the given object directory. The object entry is addressed with the given key.
Prototype
CPU_INT16S CODirWrByte(CO_DIR *cod, CPU_INT32U key, CPU_INT08U val);
Parameter | Meaning |
---|---|
cod | pointer to the CANopen object directory |
key | object entry key; should be generated with the macro CO_DEV() |
value | the source value |
Returned Value
= CO_ERR.NONE
Successful operation
!= CO_ERR.NONE
An error is detected (see section "Error Identification")
Example
The following example writes the value to the hypothetical application specific object entry "[1234:56]" within the object directory of the CANopen node AppNode.
CPU_INT16S err; CPU_INT08U value = 0x30; : err = CODirWrByte (&(AppNode.Dir), CO_DEV(0x1234, 0x56), value); if (err != CO_ERR_NONE) { /* object [1234:56] is missing or error during writing */ } :
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 COObjWrValue()
multiple times.