CNC_RDSET | NCDATA Top
Description
Reads the setting data specified by "number","axis"(only for the setting data with axis). The data format depends on each setting data. The format of Byte/Word/2-Word setting data is generally signed binary.
Reads the setting data for all axes once by specifying 'ALL_AXES' in 'axis'. The setting data for each axis is stored in each array of "IODBPSD".
The attribute of setting data depends on the type and axis, and it is different for each setting data. It is as follows, and can be got by cnc_rdsetinfo function.
Setting data type
Meaning
Byte size
Bit setting data
Every bits have each definition.
1
Bit setting data with axis
Every bits have each definition. (each axis)
1
Byte setting data
1-byte data is stored.
1
Byte setting data with axis
1-byte data is stored. (each axis)
1
Word setting data
2-byte data is stored.
2
Word setting data with axis
2-byte data is stored. (each axis)
2
2-Word setting data
4-byte data is stored.
4
2-Word setting data with axis
4-byte data is stored. (each axis)
4
Real setting data (Series 15i, 30i, 0i-D/F, PMi-A)
4-byte data which indicates value of variable and 4-byte data which indicates number of places of decimals are stored.
8
Real setting data with axis (Series 15i, 30i, 0i-D/F, PMi-A)
4-byte data which indicates value of variable and 4-byte data which indicates number of places of decimals are stored. (each axis)
8
It is impossible to read any bit setting data bit by bit. 8 bits(i.e. 1 byte) which belong to the same setting data number are read at the same time.
This function is the same as cnc_rdparam function except that it cannot read the parameter without setting attribute.
See the "PARAMETER MANUAL" of CNC for details of each setting data.
MTConnect Fanuc Adapter Universal Fanuc Driver Fanuc Focas Library CD Declaration
#include "fwlib32.h" or "fwlib64.h"
FWLIBAPI short WINAPI cnc_rdset(unsigned short FlibHndl, short number, short axis, short length, IODBPSD *set); Arguments
FlibHndl
[ in ]
number
[ in ]
Specify the setting data number.
See the "PARAMETER MANUAL" of CNC about available setting data number.
It can be got by cnc_rdparanum function and cnc_rdparainfo function.
axis
[ in ]
Specify the axis number.
0
:
assigns no axis
1,..,m
:
assigns 1 axis(m=max. controlled axes)
ALL_AXES
:
assigns all axes(ALL_AXES=-1)
length
[ in ]
Specify the data block length(size of IODBPSD structure).
4+(byte size of setting data)*(number of axis)
In case that the size of setting data is 4 byte, the IODBPSD
structure is as follows. In case that its size is 1, 2, or 8
byte, the size of data part per 1 setting data or 1 axis is 1,
2, or 8 byte.
IODBPSD
no axis/1 axis
all axes
In case of Series 15i, 16/18/21, 16i/18i/21i, 0i, 30i, Power Mate i and PMi-A, the
spindle setting data has an axis attribute, and the data for
number of spindle are valid.
set
[ out ]
Pointer to the IODBPSD structure including the setting data. The IODBPSD structure is as follows.
Series 15, 16/18/21, 16i/18i/21i, 0i-A/B and Power Mate i
typedef struct iodbpsd {
short datano; /* setting data number */
short type; /* upper byte:type */
/* lower byte:axis */
union {
char cdata; /* bit/byte setting data */
short idata; /* word setting data */
long ldata; /* 2-word setting data */
char cdatas[MAX_AXIS]; /* bit/byte set. data with axis*/
short idatas[MAX_AXIS]; /* word setting data with axis */
long ldatas[MAX_AXIS]; /* 2-word set. data with axis */
} u ;
} IODBPSD ; /* MAX_AXIS : max. controlled axes */
Series 15i, 30i, 0i-D/F, PMi-A and Ethernet connection
typedef struct realprm { /* real setteing data */
long prm_val; /* value of variable */
long dec_val; /* number of places of decimals */
} REALPRM;
typedef struct iodbpsd {
short datano; /* setting data number */
short type; /* upper byte:type */
/* lower byte:axis */
union {
char cdata; /* bit/byte setting data */
short idata; /* word setting data */
long ldata; /* 2-word setting data */
REALPRM rdata; /* real setting data */
char cdatas[MAX_AXIS];/*bit/byte set. data with axis*/
short idatas[MAX_AXIS];/* word set. data with axis */
long ldatas[MAX_AXIS];/* 2-word set. data with axis */
REALPRM rdatas[MAX_AXIS];/* real set. data with axis */
} u;
} IODBPSD ; /* MAX_AXIS : max. controlled axes */
datano
Setting data number which was read is stored.
type
Attribute of setting data which was read is stored.
Upper byte:type(only Series 15/15i)
0
:
bit type
1
:
byte type
2
:
word type
3
:
2-word type
4
:
real type (only Series 15i)
Lower byte:axis
0
:
no axis
1,..,m
:
1 axis(m=max. controlled axes)
ALL_AXES
:
all axes(ALL_AXES=-1)
rdata, rdatas ( Series 15i, 30i, 0i-D/F, PMi-A )
Real setting data is stored. The value of variable is stored in prm_val, and the number of places of decimals is stored in dec_val.
Real setting data = prm_val * 10 ** (-dec_val)
(Example) When the value of real setting data is 12.345, prm_val and dec_val are read as follows.
prm_val = 12345 dec_val = 3
Return
EW_OK is returned on successful completion, otherwise any value except EW_OK is returned.
The major error codes are as follows.
Return code
Meaning/Error handling
EW_LENGTH (2)
Data block length error
Size of IODBPSD structure(length) is wrong.
EW_NUMBER (3)
Data number error Setting data number(number) is wrong.
EW_ATTRIB (4)
Data attribute error Axis number(axis) is wrong.
As for the other return codes or the details, see
"Return status of Data window function "
CNC option
For HSSB connection,
For Ethernet connection,
The Ethernet function and the extended driver/library function are necessary.
However, in case of Series 16i/18i/21i-B, 0i-B/C/D/F, Series 30i and PMi-A, the required CNC option is as follows.
When Embedded Ethernet is used,
above two optional functions are not required.
When Ethernet board is used,
only Ethernet function is required.
CNC parameter
This function is not related to CNC parameter.
CNC mode
This function can be used in any CNC mode.
Available CNC
0i-A
0i-B/C(Note)
0i-D
0i-F
15
15i
16
18
21
16i-A
18i-A
21i-A
16i-B
18i-B
21i-B
30i-A
30i-B
M (Machining) H
O
O
O
H
O
H
H
H
O
O
O
O
O
O
O
O
T (Turning) H
O
O
O
H
-
H
H
H
O
O
O
O
O
O
O
O
LC (Loader)
-
-
-
-
-
-
H
H
H
H
H
H
H
H
H
-
-
0i-D 0i-F 16i 18i 30i-A 30i-B
P (Punch press) O
O
O
O
-
O
L (Laser)
-
-
O
-
-
O
W (Wire)
-
-
X
X
O
O
Power Mate i-D O
Power Mate i-H O
Power Motion i-A O
"O"
:
Both Ethernet and HSSB
"E"
:
Ethernet
"H"
:
HSSB
"X"
:
Cannot be used
"-"
:
None
Note) 0i-C does not support the HSSB function.
See Also
cnc_wrset
cnc_rdsetr
cnc_wrsets
cnc_rdsetinfo
cnc_rdsetnum
Fanuc Focas Library | Ncdata | cnc_getmactype Gets the type of custom macro variable which is used by... [read more]Fanuc Focas Library | Ncdata | cnc_getpmactype Gets the type of P code macro variable which is used by... [read more]Fanuc Focas Library | Ncdata | cnc_hpccactfine Reads fine level for high-speed and high-precision machining.... [read more]Fanuc Focas Library | Ncdata | cnc_hpccatset Commands CNC to set the setting data for high-speed and high-precision machining automatically.... [read more]Fanuc Focas Library | Ncdata | cnc_hpccattune Commands CNC to tune up the tuning data for high-speed and high-precision machining automatically.... [read more]Fanuc Focas Library | Ncdata | cnc_hpccselfine Selects fine level for high-speed and high-precision machining.... [read more]Fanuc Focas Library | Ncdata | cnc_rdactfixofs Reads the active fixture offset number and the active fixture offset value specified by axis. The offset number is stored in type of IODBZOFS with binary... [read more]Fanuc Focas Library | Ncdata | cnc_rdbaxis Reads the command data for B axis(current command, next command). The unit of command data is as follows. Series 16/18/21, 16i/18i/21i... [read more]Fanuc Focas Library | Ncdata | cnc_rdbtofsinfo Reads the memory type of tool offset for B axis, the available number and the auxiliary function number which means offset cancel.... [read more]Fanuc Focas Library | Ncdata | cnc_rdbtofsr Reads the tool offset value for B axis specified by s_number, e_number, type. The offset value is stored in IODBBTO with signed binary format.... [read more]Fanuc Focas Library | Ncdata | cnc_rdexecmcode Reads specified number of executing or executed M codes, starting from the M code group with specified number.... [read more]Fanuc Focas Library | Ncdata | cnc_rdfixofs Reads the fixture offset value specified by s_number, e_number, axis. The offset value is stored in data array of IODBZOR with signed binary format.... [read more]Fanuc Focas Library | Ncdata | cnc_rdhpccset Reads setting data for High-speed and high-precision machining. The data is stored in each member of IODBHPST. This function is not... [read more]Fanuc Focas Library | Ncdata | cnc_rdhpcctuac Reads tuning data(acc./dec. input) for high-speed and high-precision machining. The data is stored in each member of IODBHPAC. This... [read more]Fanuc Focas Library | Ncdata | cnc_rdhpcctupr Reads tuning data(parameter input) for high-speed and high-precision machining. The data is stored in each member of IODBHPPR. This function is not... [read more]Fanuc Focas Library | Ncdata | cnc_rdhsparam The CNC parameter shown by parameter information is read at high speed. The parameter can be read according to parameter information acquired... [read more]Fanuc Focas Library | Ncdata | cnc_rdhsprminfo Get information for high-speed read of parameter. Got parameter information is effective until the reboot of CNC. Moreover, got... [read more]Fanuc Focas Library | Ncdata | cnc_rdintchk Reads the coordinate value of interference check area specified by s_number, e_number, type. The coordinate value is stored in data... [read more]Fanuc Focas Library | Ncdata | cnc_rdintinfo Reads the available number of interference check data. It is stored in (*intinf) with binary format.... [read more]Fanuc Focas Library | Ncdata | cnc_rdmacro Reads the custom macro variable specified by number. The data is stored in ODBM with signed binary format. The kinds of custom macro variable are as... [read more]Fanuc Focas Library | Ncdata | cnc_rdmacroinfo Reads the available number of the local macro variable and the common macro variable. Those are stored in use_no1, use_no2 of ODBMVINF with signed binary... [read more]Fanuc Focas Library | Ncdata | cnc_rdmacror Reads the custom macro variable specified by datano_s, datano_e. The data is stored in IODBMR with signed binary format. The kinds of custom macro... [read more]Fanuc Focas Library | Ncdata | cnc_rdmacror2 Reads the custom macro variables specified by the starting number, s_no, and number of variables, *num. The data is stored in data with double format. It... [read more]Fanuc Focas Library | Ncdata | cnc_rdmacror3 Reads the custom macro variables specified by the starting number, s_no, and number of variables, *num. In this function, when you read the... [read more]Fanuc Focas Library | Ncdata | cnc_rdmgrpdata Reads specified number of M code group data starting from the specified number.... [read more]Fanuc Focas Library | Ncdata | cnc_rdparainfo Reads the CNC parameter information specified by s_number and read_no. The CNC parameter is basically non-continuous, and the attribute like the... [read more]Fanuc Focas Library | Ncdata | cnc_rdparainfo3 Reads the CNC parameter information specified by s_number and *read_no. The CNC parameter is basically non-continuous, and the attribute like the... [read more]Fanuc Focas Library | Ncdata | cnc_rdparam Reads the parameter specified by number,axis(only for the parameter with axis). The data format depends on each parameter. The format of... [read more]Fanuc Focas Library | Ncdata | cnc_rdparam3 Reads the parameter specified by number,axis(only for the parameter with axis). In this function, the acquired... [read more]Fanuc Focas Library | Ncdata | cnc_rdparam_ext Reads the random number parameters. The parameter numbers are specified by the array of long type (prm_no[]). And the number of the array is specified by... [read more]Fanuc Focas Library | Ncdata | cnc_rdparanum Reads minimum, maximum, total number of the CNC parameter. The distribution of the parameter is different in each CNC model, and the new parameter may be... [read more]Fanuc Focas Library | Ncdata | cnc_rdparar Reads the parameter specified by *s_number,*e_number,axis(only for the parameter with axis). The data format depends on each parameter. The format of... [read more]Fanuc Focas Library | Ncdata | cnc_rdpitchinfo Reads the available number of pitch error compensation data. It is stored in *use_no with signed binary format. In case of Series 16i/18i-W, the data... [read more]Fanuc Focas Library | Ncdata | cnc_rdpitchr Reads the pitch error compensation data specified by s_number, e_number. The data is stored in data array of IODBPI with signed binary format.... [read more]Fanuc Focas Library | Ncdata | cnc_rdpmacro Reads the P code macro variable (variable for the macro-executor) specified by number. The data is stored in ODBPM with signed binary format. It is... [read more]Fanuc Focas Library | Ncdata | cnc_rdpmacroinfo Reads the available number of the P code macro variables (variable for the macro-executor) and the type of it. Those are stored in ODBPMINF with signed binary... [read more]Fanuc Focas Library | Ncdata | cnc_rdpmacroinfo2 Reads the available number of the P code macro variables (variable for the macro-executor) and the type of it. Those are stored in ODBPMINF2 with signed binary... [read more]Fanuc Focas Library | Ncdata | cnc_rdpmacror Reads the P code macro variables(variable for the macro-executor) specified by s_number, e_number. The data is stored in IODBPR... [read more]Fanuc Focas Library | Ncdata | cnc_rdpmacror2 Reads the P code macro variables(variables for the macro-executor) specified by the starting number, stnum, and number of variables, *num. The data is... [read more]Fanuc Focas Library | Ncdata | cnc_rdrotvolc Read the 3-dimensional rotary error compensation data by specified range.... [read more]Fanuc Focas Library | Ncdata | cnc_rdrstrmcode Reads specified number of executing or executed M codes, starting from the M code group with specified number.... [read more]Fanuc Focas Library | Ncdata | cnc_rdsetinfo Reads the CNC setting data information specified by s_number and read_no. The CNC setting data is basically non-continuous, and the attribute like... [read more]Fanuc Focas Library | Ncdata | cnc_rdsetnum Reads minimum, maximum, total number of the CNC setting data. The distribution of the setting data is different in each CNC model, and the new setting... [read more]Fanuc Focas Library | Ncdata | cnc_rdsetr Reads the setting data specified by s_number,e_number,axis(only for the setting data with axis). The data format depends on each... [read more]Fanuc Focas Library | Ncdata | cnc_rdtofs Reads the tool offset value specified by number, type. The offset value is stored in data of ODBTOFS with signed binary format.... [read more]Fanuc Focas Library | Ncdata | cnc_rdtofsinfo Reads the memory type of tool offset, and the available number of it. Those are stored in ofs_type and use_no of ODBTLINF with signed binary format.... [read more]Fanuc Focas Library | Ncdata | cnc_rdtofsinfo2 Reads the memory type of tool offset, the available number of it and available type of tool offset. Those are stored in ofs_type, use_no and... [read more]Fanuc Focas Library | Ncdata | cnc_rdtofsr Reads the tool offset value specified by s_number,e_number,type. The offset value is stored in IODBTO with signed binary format.... [read more]Fanuc Focas Library | Ncdata | cnc_rdvolc Reads the 3-dimensional error compensation data by specified range.... [read more]Fanuc Focas Library | Ncdata | cnc_rdvolccomp The compensation amount at the current position of 3-dimensional error compensation axis is acquired.... [read more]Fanuc Focas Library | Ncdata | cnc_rdwkcdsfms Reads the work coordinate shift measured value specified by axis. The work coordinate shift measured value are stored in data array of IODBWCSF with signed... [read more]Fanuc Focas Library | Ncdata | cnc_rdwkcdshft Reads the work coordinate shift value specified by axis. The work coordinate shift value are stored in data array of IODBWCSF with signed binary format.... [read more]Fanuc Focas Library | Ncdata | cnc_rdzofs Reads the work zero offset value specified by number, axis. The offset value is stored in data[0] of IODBZOFS with signed binary... [read more]Fanuc Focas Library | Ncdata | cnc_rdzofsinfo Reads the available number of work zero offset. It is stored in *use_no with signed binary format.... [read more]Fanuc Focas Library | Ncdata | cnc_rdzofsr Reads the work zero offset value specified by s_number, e_number, axis. The offset value is stored in data array of IODBZOR with signed binary... [read more]Fanuc Focas Library | Ncdata | cnc_setmactype Changes the type of custom macro variable which is used by... [read more]Fanuc Focas Library | Ncdata | cnc_setpmactype Changes the type of P code macro variable which is used by... [read more]Fanuc Focas Library | Ncdata | cnc_tofs_rnge Reads the effective setting range of tool offset value specified by number, type. The effective setting range is stored in... [read more]Fanuc Focas Library | Ncdata | cnc_wksft_rnge Reads the effective setting range of work coordinate shift value specified by axis. The effective setting range is stored in data_min, data_max... [read more]Fanuc Focas Library | Ncdata | cnc_wrbtofsr Writes the tool offset value for B axis specified by datano_s, datano_e,type. The offset value must be stored in IODBBTO with signed binary format.... [read more]Fanuc Focas Library | Ncdata | cnc_wrfixofs Writes the fixture offset value specified by datano_s, datano_e, type. The offset value must be stored in data array of IODBZOR... [read more]Fanuc Focas Library | Ncdata | cnc_wrhpccset Writes setting data for high-speed and high-precision machining. This function is not supported on Series 15i. The function which writes CNC... [read more]Fanuc Focas Library | Ncdata | cnc_wrhpcctuac Writes tuning data(acc./dec. input) for high-speed and high-precision machining. This function is not supported on Series 15i. The function which writes... [read more]Fanuc Focas Library | Ncdata | cnc_wrhpcctupr Writes tuning data(parameter input) for high-speed and high-precision machining. This function is not supported on Series 15i. The function... [read more]Fanuc Focas Library | Ncdata | cnc_wrintchk Writes the coordinate value of interference check area specified by datano_s,datano_e,type. The coordinate value... [read more]Fanuc Focas Library | Ncdata | cnc_wrmacro Writes the custom macro variable specified by number. The data must be stored in mcr_val, dec_val with signed binary format. The kind of custom... [read more]Fanuc Focas Library | Ncdata | cnc_wrmacror Writes the custom macro variable specified by datano_s, datano_e. The data must be stored in IODBMR with signed binary format. The kind of custom... [read more]Fanuc Focas Library | Ncdata | cnc_wrmacror2 Writes the custom macro variables specified by the starting number, s_no, and number of variables, *num. The data is stored in data with double format. It... [read more]Fanuc Focas Library | Ncdata | cnc_wrmgrpdata Writes specified number of M code group data starting from the specified number.... [read more]Fanuc Focas Library | Ncdata | cnc_wrparam Writes the parameter specified by datano,type(only for the parameter with axis). The data format depends on each parameter. The format of Byte/Word/2-Word... [read more]Fanuc Focas Library | Ncdata | cnc_wrparas Writes all parameters stored in param. The data format depends on each parameter. The format of Byte/Word/2-Word parameter is generally signed binary.... [read more]Fanuc Focas Library | Ncdata | cnc_wrpitchr Writes the pitch error compensation data specified by datano_s, datano_e. The data must be stored in data array of IODBPI with signed binary format.... [read more]Fanuc Focas Library | Ncdata | cnc_wrpmacro Writes the P code macro variable (variable for the macro-executor) specified by number. The data must be stored in mcr_val,dec_val with signed binary... [read more]Fanuc Focas Library | Ncdata | cnc_wrpmacror Writes the P code macro variable (variable for the macro-executor) specified by datano_s, datano_e. The data must be stored in IODBPR with signed binary... [read more]Fanuc Focas Library | Ncdata | cnc_wrpmacror2 Writes the P code macro variables(variables for the macro-executor) specified by the starting number, stnum, and number of variables, *num. The data is... [read more]Fanuc Focas Library | Ncdata | cnc_wrrotvolc Write the 3-dimensional rotary error compensation data by specified range.... [read more]Fanuc Focas Library | Ncdata | cnc_wrset Writes the setting data specified by datano,type(only for the setting data with axis). The data format depends on each setting data. The format of... [read more]Fanuc Focas Library | Ncdata | cnc_wrsets Writes all setting data stored in set. The data format depends on each setting data. The format of Byte/Word/2-Word setting data is generally signed binary.... [read more]Fanuc Focas Library | Ncdata | cnc_wrtofs Writes the tool offset value specified by number, type. The offset value must be stored in data with signed binary format. The unit of offset... [read more]Fanuc Focas Library | Ncdata | cnc_wrtofsr Writes the tool offset value specified by datano_s,datano_e,type. The offset value must be stored in IODBTO with signed binary format.... [read more]Fanuc Focas Library | Ncdata | cnc_wrvolc Writes the 3-dimensional error compensation data by specified range.... [read more]Fanuc Focas Library | Ncdata | cnc_wrwkcdsfms Writes the work coordinate shift measured value specified by type. The work coordinate shift measured value must be stored in data... [read more]Fanuc Focas Library | Ncdata | cnc_wrwkcdshft Writes the work coordinate shift value specified by type. The work coordinate shift value must be stored in data array of... [read more]Fanuc Focas Library | Ncdata | cnc_wrzofs Writes the work zero offset value specified by datano, type. The offset value must be stored in data[0] of IODBZOFS with signed binary format.... [read more]Fanuc Focas Library | Ncdata | cnc_wrzofsr Writes the work zero offset value specified by datano_s, datano_e, type. The offset value must be stored in data array of IODBZOR... [read more]Fanuc Focas Library | Ncdata | cnc_zofs_rnge Reads the effective setting range of work zero offset value specified by number, axis. The effective setting range is stored in... [read more]Fanuc Focas Library | Ncdata | flist_Ncdata CNC: Function related to CNC file data... [read more]Modified: 2023-12-05