News CNCnetPDM About us Support  
       
  

CNC_RDPARAM3 | NCDATA

Description

Reads the parameter specified by "number","axis"(only for the parameter with axis).
In this function, the acquired information can specify a relative axis or an absolute axis by argument("absolute").
The relative axis means the current path and the absolute axis means all CNC paths.
The data format depends on each parameter. The format of Byte/Word/2-Word parameter is generally signed binary format.

Reads the parameter for all axes once by specifying 'ALL_AXES' in 'axis'.
The parameter for each axis is stored in each array of "IODBPSD".

The attribute of CNC parameter depends on the type and axis, and it is different for each parameter.
It is as follows, and can be got by cnc_rdparainfo function.

Parameter type Meaning Byte size
Bit parameter Every bits have each definition. 1
Bit parameter with axis Every bits have each definition. (each axis) 1
Byte parameter 1-byte data is stored. 1
Byte parameter with axis 1-byte data is stored. (each axis) 1
Word parameter 2-byte data is stored. 2
Word parameter with axis 2-byte data is stored. (each axis) 2
2-Word parameter 4-byte data is stored. 4
2-Word parameter with axis 4-byte data is stored. (each axis) 4
Real parameter 4-byte data which indicates value of variable and 4-byte data which indicates number of places of decimals are stored. 8
Real parameter with axis 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 parameter bit by bit. 8 bits(i.e. 1 byte) which belong to the same parameter number are read at the same time.

See the "PARAMETER MANUAL" of CNC for details of each parameter.

MTConnect Fanuc Adapter

Universal Fanuc Driver

Fanuc Focas Library CD

Declaration

#include "fwlib32.h" or "fwlib64.h"

FWLIBAPI short WINAPI cnc_rdparam3(unsigned short FlibHndl, short number, short axis, short length, short absolute, IODBPSD *param);

Arguments

FlibHndl   [ in ]

Specify the library handle. See "Library handle" for details.

number   [ in ]

Specify the parameter number.
See the "PARAMETER MANUAL" of CNC about available parameter 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 parameter)*(number of axis))

In case that the size of parameter 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 parameter or 1 axis is 1, 2, or 8 byte.

IODBPSD

no axis/1 axis all axes

    n = Maximum controlled axes

The spindle parameters have an axis attribute, and the data for number of spindle are valid.

absolute   [ in ]

Specify whether to acquire by a relative axis or an absolute axis at the parameter read.

0:Relative axis
1:Absolute axis
param   [ out ]

Pointer to the IODBPSD structure including the parameter. The IODBPSD structure is as follows.

typedef struct realprm {     /* real parameter */
   long prm_val;             /* value of variable */
   long dec_val;             /* number of places of decimals */
} REALPRM;

typedef struct  iodbpsd {
   short datano;               /* parameter number */
   short type;                 /* upper byte:type */
                               /* lower byte:axis */
   union {
      char    cdata;           /* bit/byte parameter */
      short   idata;           /* word parameter */
      long    ldata;           /* 2-word parameter */
      REALPRM rdata;           /* real parameter */
      char    cdatas[MAX_AXIS];/*bit/byte parameter with axis*/
      short   idatas[MAX_AXIS];/* word parameter with axis */
      long    ldatas[MAX_AXIS];/* 2-word parameter with axis */
      REALPRM rdatas[MAX_AXIS];/* real parameter with axis */
   } u;
} IODBPSD ;               /* MAX_AXIS : max. controlled axes */
datano
Parameter number which was read is stored.
type
Attribute of parameter which was read is stored.
Upper byte:type
0:bit type
1:byte type
2:word type
3:2-word type
4:real type
Lower byte:axis
0 :no axis
1,..,m :1 axis(m=max. controlled axes)
ALL_AXES:all axes(ALL_AXES=-1)
rdata, rdatas
Real parameter is stored.
The value of variable is stored in prm_val, and the number of places of decimals is stored in dec_val.

Real parameter = prm_val * 10 ** (-dec_val)

(Example) When the value of real parameter 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
Parameter 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,

    The extended driver/library function is necessary.

For Ethernet connection,

    The Ethernet function and the extended driver/library function are necessary.

    However, in case of Series 0i-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)X X O O X X X X X X X X X X X O O
T (Turning) X X O O X - X X X X X X X X X O O
LC (Loader) - - - - - - X X X X X X X X X - -

0i-D0i-F16i18i30i-A30i-B
P (Punch press)O O X X - O
L (Laser) - - X - - O
W (Wire) - - X X O O


Power Mate i-DX
Power Mate i-HX
Power Motion i-AO

"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_wrparam   cnc_rdparar   cnc_wrparas   cnc_rdparam_ext   cnc_rdparainfo   cnc_rdparanum  

Privacy notice

This website uses cookies. By continuing to use it you agree to our privacy policy. 

https://www.inventcom.net/fanuc-focas-library/ncdata/cnc_rdparam3

Fanuc Focas Library | Ncdata | cnc_getmactype

Gets the type of custom macro variable which is used by... [read more]
cnc_getmactype

Fanuc Focas Library | Ncdata | cnc_getpmactype

Gets the type of P code macro variable which is used by... [read more]
cnc_getpmactype

Fanuc Focas Library | Ncdata | cnc_hpccactfine

Reads fine level for high-speed and high-precision machining.... [read more]
cnc_hpccactfine

Fanuc Focas Library | Ncdata | cnc_hpccatset

Commands CNC to set the setting data for high-speed and high-precision machining automatically.... [read more]
cnc_hpccatset

Fanuc Focas Library | Ncdata | cnc_hpccattune

Commands CNC to tune up the tuning data for high-speed and high-precision machining automatically.... [read more]
cnc_hpccattune

Fanuc Focas Library | Ncdata | cnc_hpccselfine

Selects fine level for high-speed and high-precision machining.... [read more]
cnc_hpccselfine

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]
cnc_rdactfixofs

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]
cnc_rdbaxis

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]
cnc_rdbtofsinfo

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]
cnc_rdbtofsr

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]
cnc_rdexecmcode

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]
cnc_rdfixofs

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]
cnc_rdhpccset

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]
cnc_rdhpcctuac

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]
cnc_rdhpcctupr

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]
cnc_rdhsparam

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]
cnc_rdhsprminfo

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]
cnc_rdintchk

Fanuc Focas Library | Ncdata | cnc_rdintinfo

Reads the available number of interference check data. It is stored in (*intinf) with binary format.... [read more]
cnc_rdintinfo

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]
cnc_rdmacro

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]
cnc_rdmacroinfo

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]
cnc_rdmacror

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]
cnc_rdmacror2

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]
cnc_rdmacror3

Fanuc Focas Library | Ncdata | cnc_rdmgrpdata

Reads specified number of M code group data starting from the specified number.... [read more]
cnc_rdmgrpdata

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]
cnc_rdparainfo

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]
cnc_rdparainfo3

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]
cnc_rdparam

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]
cnc_rdparam_ext

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]
cnc_rdparanum

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]
cnc_rdparar

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]
cnc_rdpitchinfo

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]
cnc_rdpitchr

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]
cnc_rdpmacro

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]
cnc_rdpmacroinfo

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]
cnc_rdpmacroinfo2

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]
cnc_rdpmacror

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]
cnc_rdpmacror2

Fanuc Focas Library | Ncdata | cnc_rdrotvolc

Read the 3-dimensional rotary error compensation data by specified range.... [read more]
cnc_rdrotvolc

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]
cnc_rdrstrmcode

Fanuc Focas Library | Ncdata | cnc_rdset

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... [read more]
cnc_rdset

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]
cnc_rdsetinfo

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]
cnc_rdsetnum

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]
cnc_rdsetr

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]
cnc_rdtofs

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]
cnc_rdtofsinfo

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]
cnc_rdtofsinfo2

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]
cnc_rdtofsr

Fanuc Focas Library | Ncdata | cnc_rdvolc

Reads the 3-dimensional error compensation data by specified range.... [read more]
cnc_rdvolc

Fanuc Focas Library | Ncdata | cnc_rdvolccomp

The compensation amount at the current position of 3-dimensional error compensation axis is acquired.... [read more]
cnc_rdvolccomp

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]
cnc_rdwkcdsfms

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]
cnc_rdwkcdshft

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]
cnc_rdzofs

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]
cnc_rdzofsinfo

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]
cnc_rdzofsr

Fanuc Focas Library | Ncdata | cnc_setmactype

Changes the type of custom macro variable which is used by... [read more]
cnc_setmactype

Fanuc Focas Library | Ncdata | cnc_setpmactype

Changes the type of P code macro variable which is used by... [read more]
cnc_setpmactype

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]
cnc_tofs_rnge

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]
cnc_wksft_rnge

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]
cnc_wrbtofsr

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]
cnc_wrfixofs

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]
cnc_wrhpccset

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]
cnc_wrhpcctuac

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]
cnc_wrhpcctupr

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]
cnc_wrintchk

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]
cnc_wrmacro

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]
cnc_wrmacror

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]
cnc_wrmacror2

Fanuc Focas Library | Ncdata | cnc_wrmgrpdata

Writes specified number of M code group data starting from the specified number.... [read more]
cnc_wrmgrpdata

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]
cnc_wrparam

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]
cnc_wrparas

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]
cnc_wrpitchr

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]
cnc_wrpmacro

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]
cnc_wrpmacror

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]
cnc_wrpmacror2

Fanuc Focas Library | Ncdata | cnc_wrrotvolc

Write the 3-dimensional rotary error compensation data by specified range.... [read more]
cnc_wrrotvolc

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]
cnc_wrset

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]
cnc_wrsets

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]
cnc_wrtofs

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]
cnc_wrtofsr

Fanuc Focas Library | Ncdata | cnc_wrvolc

Writes the 3-dimensional error compensation data by specified range.... [read more]
cnc_wrvolc

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]
cnc_wrwkcdsfms

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]
cnc_wrwkcdshft

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]
cnc_wrzofs

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]
cnc_wrzofsr

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]
cnc_zofs_rnge

Fanuc Focas Library | Ncdata | flist_Ncdata

CNC: Function related to CNC file data... [read more]
flist_Ncdata
Modified: 2018-06-11