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

<root>
  <func>


    <title>cnc_rdsyssoft3</title>



    <declare>
      <vc>
        <include>#include "fwlib32.h"</include>
        <prottype>FWLIBAPI short WINAPI cnc_rdsyssoft3(unsigned short FlibHndl, short s_id, short *read_num, short *all_num, ODBSYSS3 *syssoft3);</prottype>
      </vc>
    </declare>



    <doc>
        <cmn>
Reads the series/version of CNC system software.<p/>
These information are stored in each member of ODBSYSS3.<p/>
This function can read the series/version information of the system software that can be used on the system.<p/>
There is no data depends on the path.
        </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>s_id</name>
                    <type>in</type>
                    <content>
                        <p>
                            Specify starting ID of series/version information that you want to read.<p/>
                            This function gathers IDs from the specified one to larger ones.<p/>
                            When you want to read all series/version information, first specify as "s_id = 0", then repeat the reading by specifying as s_id = (last acquired s_id) + 1"
                        </p>
                    </content>
                </item>
                <item>
                    <name>read_num</name>
                    <type>in/out</type>
                    <content>
                        <p>
                            Specify the pointer for the number of software information to be read.<p/>
                            This function returns the number of data that was read actually.<p/>
                            Valid data range is 1,...,40.<p/>
                            When no data is read, "read_num = 0" is returned.
                        </p>
                    </content>
                </item>
                <item>
                    <name>all_num</name>
                    <type>out</type>
                    <content>
                        <p>
                            Specify the pointer for the number of all software information.
                        </p>
                    </content>
                </item>
                <item>
                    <name>syssoft3</name>
                    <type>out</type>
                    <content>
                        <p>
Pointer to the ODBSYSS3 structure for the data of the series/version of CNC system software.
The number of array must be required so as to store the 'read_num'.
                        </p>
The ODBSYSS3 structure is as follows.
<pre><![CDATA[
typedef struct odbsyss3 {
    short   soft_id ;           /* Software ID      */
    char    soft_series[5] ;    /* Software series  */
    char    soft_edition[5] ;   /* Software version */
} ODBSYSS3 ;
]]></pre>
<dl>
    <dt>soft_id</dt>
        <dd>Software ID</dd>
        <dd>Pointer to the ODBSYSS3 structure for the data of the series/version of CNC system software.</dd>
        <dd>The array of this structure that is specified by (*read_num) is required.</dd>
        <dd><table class="dd">
                   <tr> <td>0101H</td>  <td>:</td> <td>CNC basic software</td> </tr>
                   <tr> <td>0102H</td>  <td>:</td> <td>CNC option software A1</td> </tr>
                   <tr> <td>0103H</td>  <td>:</td> <td>CNC option software A2</td> </tr>
                   <tr> <td>0104H</td>  <td>:</td> <td>CNC option software A3</td> </tr>
<!--               <tr> <td>0105H</td>  <td>:</td> <td>CNC basic software A4</td> </tr> -->
                   <tr> <td>&#160;</td> <td> </td> <td></td> </tr>
                   <tr> <td>0111H</td>  <td>:</td> <td>CNC language display ROM English (Basic)</td> </tr>
                   <tr> <td>0112H</td>  <td>:</td> <td>CNC language display ROM Japanese</td> </tr>
                   <tr> <td>0113H</td>  <td>:</td> <td>CNC language display ROM German</td> </tr>
                   <tr> <td>0114H</td>  <td>:</td> <td>CNC language display ROM French</td> </tr>
                   <tr> <td>0115H</td>  <td>:</td> <td>CNC language display ROM Traditional Chinese</td> </tr>
                   <tr> <td>0116H</td>  <td>:</td> <td>CNC language display ROM Italian</td> </tr>
                   <tr> <td>0117H</td>  <td>:</td> <td>CNC language display ROM Korean</td> </tr>
                   <tr> <td>0118H</td>  <td>:</td> <td>CNC language display ROM Spanish</td> </tr>
                   <tr> <td>0119H</td>  <td>:</td> <td>CNC language display ROM Dutch</td> </tr>
                   <tr> <td>011AH</td>  <td>:</td> <td>CNC language display ROM Danish</td> </tr>
                   <tr> <td>011BH</td>  <td>:</td> <td>CNC language display ROM Portuguese</td> </tr>
                   <tr> <td>011CH</td>  <td>:</td> <td>CNC language display ROM Polish</td> </tr>
                   <tr> <td>011DH</td>  <td>:</td> <td>CNC language display ROM Hungarian</td> </tr>
                   <tr> <td>011EH</td>  <td>:</td> <td>CNC language display ROM Swedish</td> </tr>
                   <tr> <td>011FH</td>  <td>:</td> <td>CNC language display ROM Czech</td> </tr>
                   <tr> <td>0120H</td>  <td>:</td> <td>CNC language display ROM Simplified Chinese</td> </tr>
                   <tr> <td>&#160;</td> <td> </td> <td></td> </tr>
                   <tr> <td>0123H</td>  <td>:</td> <td>CNC option software A21</td> </tr>
                   <tr> <td>0124H</td>  <td>:</td> <td>CNC option software A22</td> </tr>
                   <tr> <td>&#160;</td> <td> </td> <td></td> </tr>
                   <tr> <td>0141H</td>  <td>:</td> <td>reserve</td> </tr>
                   <tr> <td>&#160;</td> <td> </td> <td></td> </tr>
                   <tr> <td>0151H</td>  <td>:</td> <td>BOOT software</td> </tr>
                   <tr> <td>&#160;</td> <td> </td> <td></td> </tr>
                   <tr> <td>0201H</td>  <td>:</td> <td>PMC system software 1</td> </tr>
<!--               <tr> <td>0202H</td>  <td>:</td> <td>PMC system software 2</td> </tr> -->
<!--               <tr> <td>0203H</td>  <td>:</td> <td>PMC system software 3</td> </tr> -->
<!--               <tr> <td>0204H</td>  <td>:</td> <td>PMC system software 4</td> </tr> -->
                   <tr> <td>0211H</td>  <td>:</td> <td>PPMC ladder 1 (first ladder)</td> </tr>
                   <tr> <td>0212H</td>  <td>:</td> <td>PPMC ladder 2 (second ladder)</td> </tr>
                   <tr> <td>0213H</td>  <td>:</td> <td>PPMC ladder 3 (third ladder)</td> </tr>
                   <tr> <td>0214H</td>  <td>:</td> <td>PMC ladder 4 (ladder for DUAL CHECK)</td> </tr>
                   <tr> <td>&#160;</td> <td> </td> <td></td> </tr>
                   <tr> <td>0221H</td>  <td>:</td> <td>C language board system software</td> </tr>
                   <tr> <td>0222H</td>  <td>:</td> <td>C language board user software</td> </tr>
                   <tr> <td>&#160;</td> <td> </td> <td></td> </tr>
                   <tr> <td>0301H</td>  <td>:</td> <td>Servo software 1</td> </tr>
                   <tr> <td>0302H</td>  <td>:</td> <td>Servo software 2</td> </tr>
                   <tr> <td>0303H</td>  <td>:</td> <td>Servo software 3</td> </tr>
                   <tr> <td>0304H</td>  <td>:</td> <td>Servo software 4</td> </tr>
                   <tr> <td>0305H</td>  <td>:</td> <td>Servo software 5</td> </tr>
                   <tr> <td>0306H</td>  <td>:</td> <td>Servo software 6</td> </tr>
                   <tr> <td>0307H</td>  <td>:</td> <td>Servo software 7</td> </tr>
                   <tr> <td>0308H</td>  <td>:</td> <td>Servo software 8</td> </tr>
                   <tr> <td>0309H</td>  <td>:</td> <td>Servo software 9</td> </tr>
                   <tr> <td>030AH</td>  <td>:</td> <td>Servo software 10</td> </tr>
                   <tr> <td>&#160;</td> <td> </td> <td></td> </tr>
                   <tr> <td>0501H</td>  <td>:</td> <td>1st spindle software</td> </tr>
                   <tr> <td>0502H</td>  <td>:</td> <td>2nd spindle software</td> </tr>
                   <tr> <td>0503H</td>  <td>:</td> <td>3rd spindle software</td> </tr>
                   <tr> <td>0504H</td>  <td>:</td> <td>4th spindle software</td> </tr>
                   <tr> <td>0505H</td>  <td>:</td> <td>5th spindle software</td> </tr>
                   <tr> <td>0506H</td>  <td>:</td> <td>6th spindle software</td> </tr>
                   <tr> <td>0507H</td>  <td>:</td> <td>7th spindle software</td> </tr>
                   <tr> <td>0508H</td>  <td>:</td> <td>8th spindle software</td> </tr>
                   <tr> <td>0509H</td>  <td>:</td> <td>9th spindle software</td> </tr>
                   <tr> <td>050AH</td>  <td>:</td> <td>10th spindle software</td> </tr>
                   <tr> <td>050BH</td>  <td>:</td> <td>11th spindle software</td> </tr>
                   <tr> <td>050CH</td>  <td>:</td> <td>12th spindle software</td> </tr>
                   <tr> <td>050DH</td>  <td>:</td> <td>13th spindle software</td> </tr>
                   <tr> <td>050EH</td>  <td>:</td> <td>14th spindle software</td> </tr>
                   <tr> <td>050FH</td>  <td>:</td> <td>15th spindle software</td> </tr>
                   <tr> <td>0510H</td>  <td>:</td> <td>16th spindle software</td> </tr>
                   <tr> <td>&#160;</td> <td> </td> <td></td> </tr>
                   <tr> <td>0601H</td>  <td>:</td> <td>Graphic software 1</td> </tr>
                   <tr> <td>0602H</td>  <td>:</td> <td>Graphic software 2</td> </tr>
                   <tr> <td>0603H</td>  <td>:</td> <td>Graphic software 3</td> </tr>
                   <tr> <td>0604H</td>  <td>:</td> <td>Graphic software 4 (font dat)</td> </tr>
                   <tr> <td>&#160;</td> <td> </td> <td></td> </tr>
                   <tr> <td>0701H</td>  <td>:</td> <td>Macro executor 1</td> </tr>
                   <tr> <td>0702H</td>  <td>:</td> <td>Macro executor 2</td> </tr>
                   <tr> <td>0703H</td>  <td>:</td> <td>Macro executor 3</td> </tr>
                   <tr> <td>0704H</td>  <td>:</td> <td>Macro executor 4</td> </tr>
                   <tr> <td>0705H</td>  <td>:</td> <td>Macro executor 5</td> </tr>
                   <tr> <td>0706H</td>  <td>:</td> <td>Macro executor 6</td> </tr>
                   <tr> <td>0707H</td>  <td>:</td> <td>Macro executor 7</td> </tr>
                   <tr> <td>0708H</td>  <td>:</td> <td>Macro executor 8</td> </tr>
                   <tr> <td>0709H</td>  <td>:</td> <td>Macro executor 9</td> </tr>
                   <tr> <td>070AH</td>  <td>:</td> <td>Macro executor 10</td> </tr>
                   <tr> <td>070BH</td>  <td>:</td> <td>Macro executor 11</td> </tr>
                   <tr> <td>070CH</td>  <td>:</td> <td>Macro executor 12</td> </tr>
                   <tr> <td>070DH</td>  <td>:</td> <td>Macro executor 13</td> </tr>
                   <tr> <td>070EH</td>  <td>:</td> <td>Macro executor 14</td> </tr>
                   <tr> <td>070FH</td>  <td>:</td> <td>Macro executor 15</td> </tr>
                   <tr> <td>0710H</td>  <td>:</td> <td>Macro executor 16</td> </tr>
                   <tr> <td>0711H</td>  <td>:</td> <td>Macro executor 17</td> </tr>
                   <tr> <td>0712H</td>  <td>:</td> <td>Macro executor 18</td> </tr>
                   <tr> <td>0713H</td>  <td>:</td> <td>Macro executor 19</td> </tr>
                   <tr> <td>0714H</td>  <td>:</td> <td>Macro executor 20</td> </tr>
                   <tr> <td>075AH</td>  <td>:</td> <td>Manual Guide i (Macro executor for Milling system)</td> </tr>
                   <tr> <td>075BH</td>  <td>:</td> <td>Manual Guide i (Macro executor for Lathe system)</td> </tr>
                   <tr> <td>&#160;</td> <td> </td> <td></td> </tr>
                   <tr> <td>0801H</td>  <td>:</td> <td>C language executor library</td> </tr>
                   <tr> <td>0802H</td>  <td>:</td> <td>C language executor application</td> </tr>
                   <tr> <td>0811H</td>  <td>:</td> <td>Manual Guide i library</td> </tr>
                   <tr> <td>0812H</td>  <td>:</td> <td>Manual Guide i application</td> </tr>
                   <tr> <td>&#160;</td> <td> </td> <td></td> </tr>
                   <tr> <td>0901H</td>  <td>:</td> <td>Network management</td> </tr>
                   <tr> <td>0911H</td>  <td>:</td> <td>Embedded Ethernet</td> </tr>
                   <tr> <td>0912H</td>  <td>:</td> <td>Ethernet display function</td> </tr>
                   <tr> <td>0921H</td>  <td>:</td> <td>Profibus 1</td> </tr>
                   <tr> <td>0922H</td>  <td>:</td> <td>Profibus 2</td> </tr>
                   <tr> <td>0923H</td>  <td>:</td> <td>Device-net 1</td> </tr>
                   <tr> <td>0924H</td>  <td>:</td> <td>Device-net 2</td> </tr>
                   <tr> <td>0925H</td>  <td>:</td> <td>FL-net 1</td> </tr>
                   <tr> <td>0926H</td>  <td>:</td> <td>FL-net 2</td> </tr>
                   <tr> <td>0927H</td>  <td>:</td> <td>Profibus 3</td> </tr>
                   <tr> <td>0931H</td>  <td>:</td> <td>Data server</td> </tr>
                   <tr> <td>&#160;</td> <td> </td> <td></td> </tr>
                   <tr> <td>0A01H</td>  <td>:</td> <td>Customer's board Syatem</td> </tr>
                   <tr> <td>0A02H</td>  <td>:</td> <td>Customer's board User</td> </tr>
            </table></dd>

    <dt>soft_series</dt>
        <dd>Software series</dd>
        <dd>Software series information is stored in ASCII code in order of its position (4 byte + 'NULL').</dd>

    <dt>soft_edition</dt>
        <dd>Software version</dd>
        <dd>Software series information is stored in ASCII code in order of its position (4 byte + 'NULL').</dd>

</dl>

                    </content>
                </item>
            </vc>
        </common>
    </argument>



    <errcode>
        <add></add>
    </errcode>



    <option>
        <hssb>The extended driver/library function is necessary.</hssb>
        <ethr><p>The Ethernet function and the extended driver/library function are necessary.</p>
              <p>However, in case of Series 300i, 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>
        <add></add>
    </option>



    <parameter></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>X</fs16ia>
           <fs18ia>X</fs18ia>
           <fs21ia>X</fs21ia>
           <fs16ib>X</fs16ib>
           <fs18ib>X</fs18ib>
           <fs21ib>X</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>X</fs16ib>
           <fs18ib>X</fs18ib>
           <fs21ib>X</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>
        <add><b></b></add>
    </support>



    <reference>
        <item>
            <name>cnc_rdsyssoft</name>
            <file>misc/cnc_rdsyssoft.htm</file>
        </item>
        <item>
            <name>cnc_rdsyssoft2</name>
            <file>misc/cnc_rdsyssoft2.htm</file>
        </item>
    </reference>



    <example></example>



  </func>
</root>
