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

<root>
  <func>


    <title>cnc_wrtool2</title>



    <declare>
      <vc>
        <include>#include "fwlib32.h"</include>
        <prottype>FWLIBAPI short WINAPI cnc_wrtool2(unsigned short FlibHndl,short number, IDBTLM *wrtool); </prottype>
      </vc>
    </declare>



    <doc>
        <cmn>
            <p>
                Writes the individual data on the Tool management data to the specified Tool management data table.
            </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>wrtool</name>
                    <type>in</type>
                    <content>
                        <p>
                            Specify the pointer to IDBTLM structure including the Tool management data to be written.
                            The IDBTLM structure is as follows.
<pre>
typedef struct  idbtlm {
    short data_id;              /* specified data ID */
    union {
        unsigned char data1;    /* 1byte type data */
        short         data2;    /* 2byte type data */
        long          data4;    /* 4byte type data */
    } item;
} IDBTLM;
</pre>
                            <dl>
                                <dt>data_id</dt>
                                <dd>
                                    Identifies the Tool management data to be written.  
                                    The correspondence between the ID and the variable for the data is as follows.
                                </dd>
                                <dd><table border="1" class="dd">
                                    <tr> <th>Name</th><th>data_id</th><th>variable for item</th> </tr>
                                    <tr> <td>Tool number(T)</td><td align="center">1</td><td align="center">data4</td> </tr>
                                    <tr> <td>Tool life counter</td><td align="center">2</td><td align="center">data4</td> </tr>
                                    <tr> <td>Maximum of tool life</td><td align="center">3</td><td align="center">data4</td> </tr>
                                    <tr> <td>Rest of tool life</td><td align="center">4</td><td align="center">data4</td> </tr>
                                    <tr> <td>State of tool life</td><td align="center">5</td><td align="center">data1</td> </tr>
                                    <tr> <td>Customizing data (bit)</td><td align="center">6</td><td align="center">data1</td> </tr>
                                    <tr> <td>Tool information</td><td align="center">7</td><td align="center">data2</td> </tr>
                                    <tr> <td>Tool length compensation number (H)</td><td align="center">8</td><td align="center">data2</td> </tr>
                                    <tr> <td>Cutter compensation number (D)</td><td align="center">9</td><td align="center">data2</td> </tr>
                                    <tr> <td>Spindle speed (S)</td><td align="center">10</td><td align="center">data4</td> </tr>
                                    <tr> <td>Feed rate (F)</td><td align="center">11</td><td align="center">data4</td> </tr>
                                    <tr> <td>Tool geometric compensation number (G)</td><td align="center">12</td><td align="center">data2</td> </tr>
                                    <tr> <td>Tool wear compensation number (W)</td><td align="center">13</td><td align="center">data2</td> </tr>
                                    <tr> <td>Tool geometric number</td><td align="center">14</td><td align="center">data2</td> </tr>
                                    <tr> <td>Edge group number(only 300i/310i/320i)</td><td align="center">15</td><td align="center">data2</td> </tr>
                                    <tr> <td>Edge number(only 300i/310i/320i)</td><td align="center">16</td><td align="center">data2</td> </tr>
                                    <tr> <td>Customizing data 1</td><td align="center">31</td><td align="center">data4</td> </tr>
                                    <tr> <td>Customizing data 2</td><td align="center">32</td><td align="center">data4</td> </tr>
                                    <tr> <td>Customizing data 3</td><td align="center">33</td><td align="center">data4</td> </tr>
                                    <tr> <td>Customizing data 4</td><td align="center">34</td><td align="center">data4</td> </tr>
                                    <tr> <td>Customizing data 5</td><td align="center">35</td><td align="center">data4</td> </tr>
                                    <tr align="center"> <td>:</td><td align="center">:</td><td align="center">:</td> </tr>
                                    <tr> <td>Customizing data 20</td><td align="center">50</td><td align="center">data4</td> </tr>
                                </table></dd>
                            </dl>
                            <table border="0">
                                <tr><td valign="top">(Note)</td>
                                    <td>
                                        Above customizing data(5-20) are available at only "the additional customized data on tool management function option(5-20)".
                                    </td>
                                </tr>
                                <tr><td valign="top">(Note)</td>
                                    <td>
                                        Above customizing data(5-40) are available at only "the additional customized data on tool management function option(5-40)".
                                    </td>
                                </tr>
                            </table>
                        </p>
                    </content>
                </item>
           </vc>
        </common>
    </argument>



    <errcode>
        <item>
            <name>EW_BUSY</name>
            <content>
                Other users(such as PMC) have accessed 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_ATTRIB</name>
            <content>
                The data_id at IDBTLM structure is invalid.
            </content>
        </item>
        <item>
            <name>EW_DATA</name>
            <content>
                The member, item.data1, item.data2, item.data4, in the IDBTLM 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,..,70</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),(5-40).<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),(5-40).<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>
