<?xml version="1.0" encoding="Shift_JIS"?>
<?xml-stylesheet type="text/xsl" href="../Fmethod_xsl/fmethod_he_c.xsl"?>

<root>
  <func>


    <title>cnc_wrtool</title>



    <declare>
      <vc>
        <include>#include "fwlib32.h"</include>
        <prottype>FWLIBAPI short WINAPI cnc_wrtool(unsigned short FlibHndl,short number, IODBTLMNG *tool); </prottype>
      </vc>
    </declare>



    <doc>
        <cmn><p>
                Writes the specified Tool management data to the Tool management data table.
                In case of writing the individual data on the Tool management data,
                use <a href="ToolMng/cnc_wrtool2.htm" target="_parent">cnc_wrtool2</a> function.
             </p>
             <p class="xis">
                Note) This function is only for "Fast Ethernet board" and "Embedded Ethernet". So, this function is not supported at "Ethernet board".
             </p>
        </cmn>
    </doc>



    <argument>
        <common>
            <vc>
                <item>
                    <name>FlibHndl</name>
                    <type>in</type>
                    <content>
                        <p>
                            Specify the library handle. See "<a href="handle.htm" target="_parent">Library handle</a>" for details.
                        </p>
                    </content>
                </item>
                <item>
                    <name>number</name>
                    <type>in</type>
                    <content>
                        <p>
                           Specify the data number at the Tool management data table.
                        </p>
                    </content>
                </item>
                <item>
                    <name>tool</name>
                    <type>in</type>
                    <content>
                        <p>
                            Specify the pointer to IODBTLMNG structure including the Tool management data to be written.  As for the IODBTLMNG structure,
                            refer to the explanation of arguments of <a href="ToolMng/cnc_regtool.htm" target="_parent">cnc_regtool</a> function.
                        </p>
                    </content>
                </item>
           </vc>
        </common>
    </argument>



    <errcode>
        <item>
            <name>EW_BUSY</name>
            <content>
                Other users(such as PMC) have accessed to the same data window.
                Try this function again.
            </content>
        </item>
        <item>
            <name>EW_NUMBER</name>
            <content>
                The data number for the Tool management data table(number) is invalid.
            </content>
        </item>
        <item>
            <name>EW_DATA</name>
            <content>
                The member in the IODBTLMNG structure is invalid.<br/>
                In order to get more information for this err_no return value,
                execute <a href="Misc/cnc_getdtailerr.htm" target="_parent">cnc_getdtailerr</a> function.
                The following detail status will be set onto the member, err_no of OBDERR structure.
                <table border="0">
                    <tr><td>0</td><td>:</td><td>error except EW_DATA</td></tr>
                    <tr><td>1</td><td>:</td><td>error of tool number</td></tr>
                    <tr><td>2</td><td>:</td><td>error of tool life counter</td></tr>
                    <tr><td>3</td><td>:</td><td>error of maximum of tool life</td></tr>
                    <tr><td>4</td><td>:</td><td>error of rest of tool life</td></tr>
                    <tr><td>5</td><td>:</td><td>error of state of tool life</td></tr>
                    <tr><td>7</td><td>:</td><td>error of tool information</td></tr>
                    <tr><td>8</td><td>:</td><td>error of tool length compensation number</td></tr>
                    <tr><td>9</td><td>:</td><td>error of cutter compensation number</td></tr>
                    <tr><td>10</td><td>:</td><td>error of spindle speed</td></tr>
                    <tr><td>11</td><td>:</td><td>error of feed rate</td></tr>
                    <tr><td>12</td><td>:</td><td>error of tool geometric compensation number</td></tr>
                    <tr><td>13</td><td>:</td><td>error of tool wear compensation number</td></tr>
                    <tr><td>14</td><td>:</td><td>error of tool geometric number</td></tr>
                    <tr><td>15</td><td>:</td><td>error of edge group number(only 300i/310i/320i)</td></tr>
                    <tr><td>16</td><td>:</td><td>error of edge number(only 300i/310i/320i)</td></tr>
                    <tr><td>31,..,50</td><td>:</td><td>error of customizing data</td></tr>
                </table>
            </content>
        </item>
        <item>
            <name>EW_NOOPT</name>
            <content>
                No option<br/>
                The Tool management function 64 pairs, or the Tool management function 240 pairs, or the Tool management function 1000 pairs.
            </content>
        </item>
        <item>
            <name>EW_PROT</name>
            <content>
                Write protection<br/>
                The Tool management data table is write protected.
            </content>
        </item>
        <item>
            <name>EW_REJECT</name>
            <content>
                Interference with other tool.
            </content>
        </item>
        <item>
            <name>EW_OVRFLOW</name>
            <content>
                Data of multi edge tool has a part of inconsistency on tool management funcion. (only 300i/310i/320i)
            </content>
        </item>
    </errcode>



    <option>
        <hssb>
            <p>The extended driver/library function are necessary.</p>
        </hssb>

        <ethr>
            <p>The Ethernet function and the extended driver/library function are necessary.</p>
            <p>However, in case of Series 160i/180i/210i/0i MODEL B and 300i/310i/320i, the required CNC option is as follows.</p>
            <p>When Embedded Ethernet is used,</p>
            <p><ul>above two optional functions are not required.</ul></p>
            <p>When Ethernet board is used,</p>
            <p><ul>only Ethernet function is required.</ul></p>
        </ethr>
        <need>
            The Tool management function 64 pairs, or the Tool management function 240 pairs, or the Tool management function 1000 pairs.
        </need>
        <type>
            <p>
                <li>Series 160i/180i/210i</li>
                    This function is influenced by the additional customized data on tool management function option.<br/>
                <li>Series 300i/310i/320i</li>
                    This function is influenced by the additional customized data on tool management function option(5-20).<br/>
            </p>
        </type>

        <is>
            <hssb>
                <p>The extended driver/library function are necessary.</p>
            </hssb>
            <need>
                The Tool management function 64 pairs, or the Tool management function 240 pairs, or the Tool management function 1000 pairs.
            </need>
            <type>
                This function is influenced by the additional customized data on tool management function option(5-20).<br/>
            </type>
        </is>
    </option>



    <parameter>
        <type>
            <ul type="disc">
                <li>Series 160i/180i/210i</li>
                    13220 (valid number of Tool management data)<br/>
                <li>Series 300i/310i/320i<br/>
                    13220 (valid number of Tool management data)<br/>
                    13201#3 (It is necessary to use multi edge tool on tool management function.)
                </li>
            </ul>
        </type>
    </parameter>

    <is_parameter>
        <type>
            <ul>
                13220 (valid number of Tool management data)<br/>
                13201#3 (It is necessary to use multi edge tool on tool management function.)
            </ul>
        </type>
    </is_parameter>


    <mode>
    </mode>



    <support>
        <m>
            <fs0ia>X</fs0ia>
            <fs0ib>X</fs0ib>
            <fs15>X</fs15>
            <fs15i>X</fs15i>
            <fs16>X</fs16>
            <fs18>X</fs18>
            <fs21>X</fs21>
            <fs16ia>O</fs16ia>
            <fs18ia>O</fs18ia>
            <fs21ia>O</fs21ia>
            <fs16ib>O</fs16ib>
            <fs18ib>O</fs18ib>
            <fs21ib>O</fs21ib>
            <fs30i>O</fs30i>
        </m>
        <t>
            <fs0ia>X</fs0ia>
            <fs0ib>X</fs0ib>
            <fs15>X</fs15>
            <fs15i>X</fs15i>
            <fs16>X</fs16>
            <fs18>X</fs18>
            <fs21>X</fs21>
            <fs16ia>X</fs16ia>
            <fs18ia>X</fs18ia>
            <fs21ia>X</fs21ia>
            <fs16ib>O</fs16ib>
            <fs18ib>O</fs18ib>
            <fs21ib>O</fs21ib>
            <fs30i>O</fs30i>
        </t>
        <lc>
            <fs0ia>X</fs0ia>
            <fs0ib>X</fs0ib>
            <fs15>X</fs15>
            <fs15i>X</fs15i>
            <fs16>X</fs16>
            <fs18>X</fs18>
            <fs21>X</fs21>
            <fs16ia>X</fs16ia>
            <fs18ia>X</fs18ia>
            <fs21ia>X</fs21ia>
            <fs16ib>X</fs16ib>
            <fs18ib>X</fs18ib>
            <fs21ib>X</fs21ib>
            <fs30i>X</fs30i>
        </lc>
        <p>
            <fs16i>X</fs16i>
            <fs18i>X</fs18i>
        </p>
        <l>
            <fs16i>X</fs16i>
            <fs18i>X</fs18i>
        </l>
        <w>
            <fs16i>X</fs16i>
            <fs18i>X</fs18i>
        </w>
        <pw>
            <d>X</d>
            <h>X</h>
        </pw>
        <is>
            <m>
                <fs30is>O</fs30is>
            </m>
            <t>
                <fs30is>O</fs30is>
            </t>
        </is>
    </support>



    <reference>
        <item>
            <name>cnc_regtool</name>
            <file>ToolMng/cnc_regtool.htm</file>
        </item>
        <item>
            <name>cnc_regtool_f2</name>
            <file>ToolMng/cnc_regtool_f2.htm</file>
        </item>
        <item>
            <name>cnc_deltool</name>
            <file>ToolMng/cnc_deltool.htm</file>
        </item>
        <item>
            <name>cnc_rdtool</name>
            <file>ToolMng/cnc_rdtool.htm</file>
        </item>
        <item>
            <name>cnc_rdtool_f2</name>
            <file>ToolMng/cnc_rdtool_f2.htm</file>
        </item>
<!--
        <item>
            <name>cnc_wrtool</name>
            <file>ToolMng/cnc_wrtool.htm</file>
        </item>
-->
        <item>
            <name>cnc_wrtool_f2</name>
            <file>ToolMng/cnc_wrtool_f2.htm</file>
        </item>
        <item>
            <name>cnc_wrtool2</name>
            <file>ToolMng/cnc_wrtool2.htm</file>
        </item>
    </reference>



    <example>
    </example>



  </func>
</root>
