finslib_memory_area_write_sbcd32( sys, start, data, num_sbcd32, type );
Parameters
| Parameter | Type | Description |
|---|---|---|
sys |
struct fins_sys_tp * |
A pointer to a structure with the FINS context |
start |
const char * |
An ASCII string describing the first memory element to write |
data |
const int32_t * |
Pointer to the buffer where the data to be written is located |
num_sbcd32 |
size_t |
The number of signed 32 bit BCD values to write |
type |
int |
The type of signed BCD to be written |
Return Value
| Type | Description |
|---|---|
int |
A return value from the list FINS_RETVAL_... indicating the result of the query |
Description
The function finslib_memory_area_write_sbcd32() can be used to write a block of 32 bit signed BCD values to a memory area in a remote PLC. The connection with the PLC should already be present before this function is called.
Data is transferred unmodified from the caller supplied buffer to the FINS data stream. Existence and filling of the dataspace is the responsibility of the calling function, but finslib_memory_area_write_sbcd32() will return an error if a NULL pointer is provided for data storage.
The start of the memory area is provided as an ASCII string which represents the starting address in human readable format. Example formats are CIO20 and W100.
The number of signed BCD values to be written in one function call is not limited by the amount of data a PLC can send in one FINS packet because finslib_memory_area_write_sbcd16() will automatically use multiple request at the FINS layer if the dataset is too large.
The function supports the following four types of signed BCD formats. Please consult the Omron software manuals for more details about these formats.
| Type | Low | High |
|---|---|---|
FINS_DATA_TYPE_SBCD32_0 |
-9999999 | 9999999 |
FINS_DATA_TYPE_SBCD32_1 |
-79999999 | 79999999 |
FINS_DATA_TYPE_SBCD32_2 |
-9999999 | 99999999 |
FINS_DATA_TYPE_SBCD32_3 |
-19999999 | 99999999 |
The return value is either FINS_RETVAL_SUCCESS when the function succeeded, or one of the other FINS_RETVAL_ values if an eror occurs. In the latter case depending on the error message it is not sure if none, some or all of the data has been written to the PLC and additional processing and communication with the PLC may be necessary to know or set the correct state of the memory contents of the PLC.
See Also
-
FINS_RETVAL...– Libfins function return code list -
FINS_DATA_TYPE...– Libfins data types finslib_bcd_to_int();finslib_int_to_bcd();finslib_memory_area_read_bcd16();finslib_memory_area_read_bcd32();finslib_memory_area_read_sbcd16();finslib_memory_area_read_sbcd32();finslib_memory_area_write_bcd16();finslib_memory_area_write_bcd32();finslib_memory_area_write_sbcd16();finslib_multiple_memory_area_read();