Description
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 follows.
- Local variable (#1,..,#33) The local variables which belong to the macro program just being executed when the application program calls this function are read.
- Common variable (#100,..,#999) See the description of cnc_rdmacroinfo function about the available range of common variables.
- System variable (#1000,..,#9999)
It is possible to exchange the type of macro variable by cnc_setmactype function.
- decimal form floating-point type (data format=M*10**(-E))
- binary form floating-point type (data format=M*2**(-E))
mcr_val | : | value of variable (=M) 4-byte binary data with sign (available range:999999999,..,-999999999) |
dec_val | : | number of places of decimals (=E) 2-byte binary data with sign (available range:-128,..,127) |
mcr_val always returns by nine digits and adjusts the amount with the value of dec_val.
Example: When the variable value is 12.345, mcr_val and dec_val are read as follows.
mcr_val = 123450000
dec_val = 7
mcr_val | : | numerical part of variable (=M) 4-byte binary data with sign (available range:No limitation) |
dec_val | : | exponent part of variable (=E) 2-byte binary data with sign (available range:-128,..,127) |
The value of an undefined variable is called "vacant", and it is expressed as follows both at decimal form floating-point type and at binary form floating-point type.
mcr_val = 0
dec_val = -1
See "OPERATOR'S MANUAL" of CNC for details of the custom macro variable.
Universal Fanuc Driver
Fanuc Focas Library CD
Declaration
Arguments
Specify the library handle. See "Library handle" for details.
Specify the custom macro variable number.
Specify the data block length (size of ODBM structure=10).
ODBM
Pointer to the ODBM structure including the custom macro variable. The ODBM structure is as follows.
typedef struct odbm {
short datano ; /* custom macro variable number */
short dummy ; /* (not used) */
long mcr_val ; /* value of custom macro variable */
short dec_val ; /* number of places of decimals */
} ODBM ;
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 |
---|---|
(2) |
Size of ODBM structure(length) is wrong. |
(3) |
Custom macro variable number(number) is wrong. |
(6) |
This function needs the custom macro option. |
As for the other return codes or the details, see "Return status of Data window function"
CNC option
This function need the following CNC option.
- Series 15/15i, 30i/31i/32i, PMi-A Custom macro
- Series 16/18/21, 16i/18i/21i, 0i-A/B/C/D, Power Mate i Custom macro B
And this function is related to the following CNC option.
- Series 15 Custom macro common variable 200 sets
- Series 15i Custom macro common variable 900 sets
- Series 16/18/21, 16i/18i/21i, 0i-A/B/C/D, Power Mate i, PMi-A Custom macro common variable extension
- Series 0i-F Embedded macro
- Series 30i/31i/32i Custom macro common variable extension
Custom macro common variable 300 sets
Custom macro common variable 600 sets
Embedded macro
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) | |||||||||||||||||
T (Turning) | - | ||||||||||||||||
LC (Loader) | - | - | - | - | - | - | - | - |
0i-D | 0i-F | 16i | 18i | 30i-A | 30i-B | |
---|---|---|---|---|---|---|
P (Punch press) | - | |||||
L (Laser) | - | - | - | - | ||
W (Wire) | - | - |
Power Mate i-D | |
Power Mate i-H | |
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_wrmacro cnc_rdmacror cnc_wrmacror cnc_rdmacror2 cnc_wrmacror2 cnc_rdmacroinfo cnc_getmactype cnc_setmactype
Example(C Language)
The following program reads the custom macro variable data of specified number
and displays it.
#include "fwlib32.h"
/* number is variable number to be read. */
short example( short number )
{
ODBM macro ;
char strbuf[12] ;
short ret ;
ret = cnc_rdmacro( h, number, 10, ¯o ) ;
if ( !ret ) {
sprintf( &strbuf[0], " %09ld", abs(macro.mcr_val) );
strncpy( &strbuf[1], &strbuf[2], 10 - macro.dec_val ) ;
strbuf[10-macro.dec_val] = '.' ;
if(macro.dec_val <= 0) strbuf[strlen(strbuf)-1] = '\0';
if(macro.mcr_val < 0) strbuf[0] = '-';
printf( "%s\n", strbuf ) ;
}
else
printf( "**********\n" ) ;
return ( ret ) ;
}
Example(C#)
The following program reads the custom macro variable data of specified number
and displays it.
class example
{
/* number is variable number to be read. */
public short sample(short number)
{
Focas1.ODBM macro = new Focas1.ODBM();
string strVal;
short ret;
ret = Focas1.cnc_rdmacro(h, number, 10, macro);
if (ret == Focas1.EW_OK) {
strVal = string.Format("{0:d9}", Math.Abs(macro.mcr_val));
if (0 < macro.dec_val) strVal = strVal.Insert(9 - macro.dec_val, ".");
if (macro.mcr_val < 0) strVal = "-" + strVal;
Console.WriteLine("{0}", strVal);
}
else
{
Console.WriteLine("**********");
}
return (ret);
}
}