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


        <!-- 関数名 -->
        <title>cnc_rddiag_ext</title>



        <!-- 関数宣言 -->
        <declare>
            <!-- Visual C++の宣言 -->
            <vc>
                <include>#include "fwlib32.h"</include>
                <prottype>FWLIBAPI short WINAPI cnc_rddiag_ext(unsigned short FlibHndl, long *prm_no, short num, IODBPRM *param);</prottype>
            </vc>
        </declare>



        <!-- 解説 -->
        <doc>
            <cmn>
                <p>
                    非連続な番号のダイアグノーズデータをリードします。リードするダイアグノーズデータ番号は、longの配列(prm_no[])にて指定します。
                    その配列の個数は引数numにて指定します。
                </p>
                <p>
                    リードしたダイアグノーズデータに関する情報は、IODBPRM構造体の配列に格納されます。
                    存在しないダイアグノーズデータ番号が指定された場合は、IODBPRM構造体の<b>type</b>に<b>-1</b>が格納されます。
                    軸型でないダイアグノーズデータの値は、IODBPRM構造体の<b>data[0]</b>に格納されます。
                    軸型の場合は、IODBPRM構造体の<b>data配列</b>に格納されます。
                </p>
                <p>
                    ダイアグノーズデータの値は全てlongで格納されていますので、型情報に応じてアプリケーションでキャストを行う必要があります。
                </p>
                <p>
                    各ダイアグノーズデータの詳細については CNCの保守説明書を参照して下さい。
                </p>
            </cmn>
            <!-- 300is -->
            <is>
                <cmn>
                    <p>
                        非連続な番号のダイアグノーズデータをリードします。
                        リードするダイアグノーズデータ番号は、longの配列(prm_no[])にて指定します。その配列の個数は引数numにて指定します。
                    </p>
                    <p>
                        リードしたダイアグノーズデータに関する情報は、IODBPRM構造体の配列に格納されます。
                        存在しないダイアグノーズデータ番号が指定された場合は、IODBPRM構造体の<b>type</b>に<b>-1</b>が格納されます。
                        軸型でないダイアグノーズデータの値は、IODBPRM構造体の<b>data[0]</b>に格納されます。
                        軸型の場合は、IODBPRM構造体の<b>data配列</b>に格納されます。
                    </p>
                    <p>
                        ダイアグノーズデータの値は全てlongで格納されていますので、型情報に応じてアプリケーションでキャストを行う必要があります。
                    </p>
                    <p>
                        各ダイアグノーズデータの詳細については CNCの保守説明書を参照して下さい。
                    </p>
                </cmn>
            </is>
        </doc>



        <!-- 引数 -->
        <argument>
            <common>
                <vc>
                    <item>
                        <name>FlibHndl</name>
                        <type>in</type>
                        <content>
                            <p>
                                ライブラリハンドルです。詳細は、「<a href="handle.htm" target="_parent">ライブラリハンドル</a>」を参照して下さい。
                            </p>
                        </content>
                    </item>
                    <item>
                        <name>prm_no</name>
                        <type>in</type>
                        <content>
                            <p>
                                リードするダイアグノーズデータ番号を指定した配列へのポインタです。
                            </p>
                            <p>
                                指定可能なダイアグノーズデータ番号は CNCの保守説明書を参照してください。
                                また、<a href="misc/cnc_rddiagnum.htm" target="_parent">cnc_rddiagnum</a>関数、
                                及び<a href="misc/cnc_rddiaginfo.htm" target="_parent">cnc_rddiaginfo</a>関数でも取得できます。 
                            </p>
                        </content>
                    </item>
                    <item>
                        <name>num</name>
                        <type>in</type>
                        <content>
                            <p>
                                リードするダイアグノーズデータの個数を指定します。 
                            </p>
                        </content>
                    </item>
                    <item>
                        <name>param</name>
                        <type>out</type>
                        <content>
                            <p>
                                リードしたダイアグノーズデータを格納する IODBPRM構造体の配列へのポインタです。
                                この配列はnumで指定した数分必要です。IODBPRM構造体は次の通りです。
                            </p>
<pre><![CDATA[
typedef struct iodbprm {
        long datano;        /* ダイアグノーズデータ番号 */
        short type;         /* 型情報 */
        short axis;         /* 軸情報 */
        short info;         /* 属性 */
        short unit;         /* 単位 */
        struct {
            long prm_val;   /* ダイアグノーズデータの値 */
            long dec_val;   /* 小数点以下桁数 */
        } data[32];
} IODBPRM;
]]></pre>
                            <dt>datano</dt>
                                <dd>ダイアグノーズデータ番号が格納されます。</dd>
                            <dt>type</dt>
                                <dd>リードしたダイアグノーズデータの属性が格納されます。</dd>
                                <dd><table class="dd">
                                    <tr>    <td>0</td>    <td>:</td>    <td>バイト型</td>                              </tr>
                                    <tr>    <td>1</td>    <td>:</td>    <td>ワード型</td>                              </tr>
                                    <tr>    <td>2</td>    <td>:</td>    <td>2ワード型</td>                             </tr>
                                    <tr>    <td>3</td>    <td>:</td>    <td>ビット型(8 bit)</td>                       </tr>
                                    <tr>    <td>4</td>    <td>:</td>    <td>ビット型(1 bit : Series 150iにはなし)</td> </tr>
                                    <tr>    <td>5</td>    <td>:</td>    <td>実数型(Series 150i, 300i)</td>             </tr>
                                    <tr>    <td>-1</td>   <td>:</td>    <td>存在しないダイアグノーズデータ番号</td>    </tr>
                                </table></dd>
                            <dt>axis</dt>
                                <dd>リードしたダイアグノーズデータの軸情報が格納されます。</dd>
                                <table>
                                    <tr>
                                        <td><dd/><dd/>bit 0</td>    <td>:</td>    <td>軸属性</td>
                                        <table class="dd">
                                            <tr>    <td><dd/><dd/><dd/>0</td>    <td>:</td>    <td>軸なし</td>    </tr>
                                            <tr>    <td><dd/><dd/><dd/>1</td>    <td>:</td>    <td>軸あり</td>    </tr>
                                        </table>
                                    </tr>
                                    <tr>
                                        <td><dd/><dd/>bit 1</td>    <td>:</td>    <td>スピンドルデータ</td>
                                        <table class="dd">
                                            <tr>    <td><dd/><dd/><dd/>0</td>    <td>:</td>    <td>スピンドル以外</td>    </tr>
                                            <tr>    <td><dd/><dd/><dd/>1</td>    <td>:</td>    <td>スピンドル</td>        </tr>
                                        </table>
                                    </tr>
                                    <tr>
                                        <td><dd/><dd/>bit 2〜15</td>    <td>:</td>    <td>(リザーブ)</td>
                                    </tr>
                                </table>
                            <dt>info</dt>
                                <dd>リードしたダイアグノーズデータの属性が格納されます。</dd>
                                <table>
                                    <tr>
                                        <td><dd/><dd/>bit 0</td>    <td>:</td>    <td>符号</td>
                                        <table class="dd">
                                            <tr>    <td><dd/><dd/><dd/>0</td>    <td>:</td>    <td>符号あり</td>    </tr>
                                            <tr>    <td><dd/><dd/><dd/>1</td>    <td>:</td>    <td>符号なし</td>    </tr>
                                        </table>
                                    </tr>
                                    <tr>
                                        <td><dd/><dd/>bit 1〜15</td>    <td>:</td>    <td>(リザーブ)</td>
                                    </tr>
                                </table>
                            <dt>unit</dt>
                                <dd>リードしたダイアグノーズデータの単位が格納されます。</dd>
                                <table>
                                    <tr>
                                        <td><dd/><dd/>bit 0, 1</td>    <td>:</td>    <td>単位</td>
                                        <table class="dd">
                                            <tr>    <td><dd/><dd/><dd/>0</td>    <td>:</td>    <td>無単位</td>        </tr>
                                            <tr>    <td><dd/><dd/><dd/>1</td>    <td>:</td>    <td>%</td>            </tr>
                                            <tr>    <td><dd/><dd/><dd/>2</td>    <td>:</td>    <td>RPM    </td>        </tr>
                                        </table>
                                    </tr>
                                    <tr>
                                        <td><dd/><dd/>bit 2〜15</td>    <td>:</td>    <td>(リザーブ)</td>
                                    </tr>
                                </table>
                            <dt>data</dt>
                                <dd>ダイアグノーズデータの値が格納されます。</dd>
                                <table>
                                    <tr>    <td><dd/><dd/>prm_val</td>    <td>:</td>    <td>ダイアグノーズデータの値</td>        </tr>
                                    <tr>    <td><dd/><dd/>dec_val</td>    <td>:</td>    <td>小数点以下桁数(実数型のみ有効)</td>    </tr>
                                </table>
                        </content>
                    </item>
                </vc>
            </common>

            <!-- 300is -->
            <is>
                <hssb>
                    <vc>
                        <item>
                            <name>FlibHndl</name>
                            <type>in</type>
                            <content>
                                <p>
                                    ライブラリハンドルです。詳細は、「<a href="handle.htm" target="_parent">ライブラリハンドル</a>」を参照して下さい。
                                </p>
                            </content>
                        </item>
                        <item>
                            <name>prm_no</name>
                            <type>in</type>
                            <content>
                                <p>
                                    リードするダイアグノーズデータ番号を指定した配列へのポインタです。
                                </p>
                                <p>
                                    指定可能なダイアグノーズデータ番号は CNCの保守説明書を参照してください。
                                    また、<a href="misc/cnc_rddiagnum.htm" target="_parent">cnc_rddiagnum</a>関数、
                                    及び<a href="misc/cnc_rddiaginfo.htm" target="_parent">cnc_rddiaginfo</a>関数でも取得できます。 
                                </p>
                            </content>
                        </item>
                        <item>
                            <name>num</name>
                            <type>in</type>
                            <content>
                                <p>
                                    リードするダイアグノーズデータの個数を指定します。 
                                </p>
                            </content>
                        </item>
                        <item>
                            <name>param</name>
                            <type>out</type>
                            <content>
                                <p>
                                    リードしたダイアグノーズデータを格納する IODBPRM構造体の配列へのポインタです。
                                    この配列はnumで指定した数分必要です。IODBPRM構造体は次の通りです。
                                </p>
<pre><![CDATA[
typedef struct iodbprm {
        long datano;        /* ダイアグノーズデータ番号 */
        short type;         /* 型情報 */
        short axis;         /* 軸情報 */
        short info;         /* 属性 */
        short unit;         /* 単位 */
        struct {
            long prm_val;   /* ダイアグノーズデータの値 */
            long dec_val;   /* 小数点以下桁数 */
        } data[32];
} IODBPRM;
]]></pre>
                                <dl>
                                <dt>datano</dt>
                                    <dd>ダイアグノーズデータ番号が格納されます。</dd>
                                <dt>type</dt>
                                    <dd>リードしたダイアグノーズデータの属性が格納されます。
                                    <table class="dd">
                                        <tr>    <td>0</td>    <td>:</td>    <td>バイト型</td>                              </tr>
                                        <tr>    <td>1</td>    <td>:</td>    <td>ワード型</td>                              </tr>
                                        <tr>    <td>2</td>    <td>:</td>    <td>2ワード型</td>                             </tr>
                                        <tr>    <td>3</td>    <td>:</td>    <td>ビット型(8 bit)</td>                       </tr>
                                        <tr>    <td>4</td>    <td>:</td>    <td>ビット型</td> </tr>
                                        <tr>    <td>5</td>    <td>:</td>    <td>実数型</td>             </tr>
                                        <tr>    <td>-1</td>   <td>:</td>    <td>存在しないダイアグノーズデータ番号</td>    </tr>
                                        </table></dd>
                                <dt>axis</dt>
                                    <dd>リードしたダイアグノーズデータの配列型タイプが格納されます。
                                    <table class="dd">
                                        <colgroup valign="top"/>
                                        <colgroup valign="top"/>
                                        <colgroup valign="top"/>
                                        <tr>
                                            <td>bit 0</td>    <td>:</td>    <td>軸属性
                                            <table class="dd">
                                                <tr>    <td>0</td>    <td>:</td>    <td>軸なし</td>    </tr>
                                                <tr>    <td>1</td>    <td>:</td>    <td>軸あり</td>    </tr>
                                            </table></td>
                                        </tr>
                                        <tr>
                                            <td>bit 1〜2</td>    <td>:</td>    <td>配列タイプ
                                            <table class="dd">
                                                <tr>    <td>0</td>    <td>:</td>    <td>軸型</td>    </tr>
                                                <tr>    <td>1</td>    <td>:</td>    <td>スピンドル型</td>        </tr>
                                            </table></td>
                                        </tr>
                                        <tr>
                                            <td><dd/><dd/>bit 3〜15</td>    <td>:</td>    <td>(リザーブ)</td>
                                        </tr>
                                        </table></dd>
                                <dt>info</dt>
                                    <dd>リードしたダイアグノーズデータの属性が格納されます。
                                    <table class="dd">
                                        <colgroup valign="top"/>
                                        <colgroup valign="top"/>
                                        <colgroup valign="top"/>
                                        <tr>
                                            <td>bit 0</td>    <td>:</td>    <td>符号
                                            <table class="dd">
                                                <tr>    <td>0</td>    <td>:</td>    <td>符号あり</td>    </tr>
                                                <tr>    <td>1</td>    <td>:</td>    <td>符号なし</td>    </tr>
                                            </table></td>
                                        </tr>
                                        <tr>
                                            <td><dd/><dd/>bit 1〜15</td>    <td>:</td>    <td>(リザーブ)</td>
                                        </tr>
                                        </table></dd>
                                <dt>unit</dt>
                                    <dd>リードしたダイアグノーズデータの単位が格納されます。
                                    <table class="dd">
                                        <colgroup valign="top"/>
                                        <colgroup valign="top"/>
                                        <colgroup valign="top"/>
                                        <tr>
                                            <td>bit 0, 1</td>    <td>:</td>    <td>単位
                                            <table class="dd">
                                                <tr>    <td>0</td>    <td>:</td>    <td>無単位</td>        </tr>
                                                <tr>    <td>1</td>    <td>:</td>    <td>%</td>            </tr>
                                                <tr>    <td>2</td>    <td>:</td>    <td>RPM    </td>        </tr>
                                            </table></td>
                                        </tr>
                                        <tr>
                                            <td><dd/><dd/>bit 2〜15</td>    <td>:</td>    <td>(リザーブ)</td>
                                        </tr>
                                        </table></dd>
                                <dt>data</dt>
                                    <dd>ダイアグノーズデータの値が格納されます。
                                    <table class="dd">
                                        <tr>    <td>prm_val</td>    <td>:</td>    <td>ダイアグノーズデータの値</td>        </tr>
                                        <tr>    <td>dec_val</td>    <td>:</td>    <td>小数点以下桁数(実数型のみ有効)</td>    </tr>
                                        </table></dd>
                                </dl>
                            </content>
                        </item>
                    </vc>
                </hssb>
            </is>
        </argument>



        <!-- 戻り値 -->
        <errcode>
            <item>
                <name>EW_LENGTH</name>
                <content>
                    データブロック長の誤り<br/>
                    ダイアグノーズデータの個数numが0以下です。
                </content>
            </item>
        </errcode>



        <!-- CNCオプション -->
        <option>
            <hssb>拡張ドライバ/ライブラリ機能が必要です。</hssb>
            <ethr><p>イーサネット機能と拡張ドライバ/ライブラリ機能が必要です。</p>
                  <p>但し、Series 160i/180i/210i/0i MODEL B, 300i に関しては次のようになります。</p>
                  <p>組込みイーサネットを使用のとき、</p>
                  <dd>上記２つの機能は必要ありません。</dd>
                  <p>イーサネットボードを使用のとき、</p>
                  <dd>イーサネット機能のみ必要です。</dd>
            </ethr>
        </option>



        <!-- CNCパラメータ -->
        <parameter></parameter>



        <!-- CNCモード -->
        <mode></mode>



        <!-- 対応機種 -->
        <support>
            <!-- M（ミリング） -->
            <m>
                <fs0ia>X</fs0ia>
                <fs0ib>E</fs0ib>
                <fs15>X</fs15>
                <fs15i>E</fs15i>
                <fs16>X</fs16>
                <fs18>X</fs18>
                <fs21>X</fs21>
                <fs16ia>E</fs16ia>
                <fs18ia>E</fs18ia>
                <fs21ia>E</fs21ia>
                <fs16ib>E</fs16ib>
                <fs18ib>E</fs18ib>
                <fs21ib>E</fs21ib>
                <fs30i>O</fs30i>
            </m>
            <!-- T（旋盤） -->
            <t>
                <fs0ia>X</fs0ia>
                <fs0ib>E</fs0ib>
                <fs15>X</fs15>
                <fs15i>X</fs15i>
                <fs16>X</fs16>
                <fs18>X</fs18>
                <fs21>X</fs21>
                <fs16ia>E</fs16ia>
                <fs18ia>E</fs18ia>
                <fs21ia>E</fs21ia>
                <fs16ib>E</fs16ib>
                <fs18ib>E</fs18ib>
                <fs21ib>E</fs21ib>
                <fs30i>O</fs30i>
            </t>
            <!-- LC（ローダ制御） -->
            <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（パンチプレス） -->
            <p>
                <fs16i>E</fs16i>
                <fs18i>E</fs18i>
            </p>
            <!-- L（レーザ） -->
            <l>
                <fs16i>E</fs16i>
                <fs18i>X</fs18i>
            </l>
            <!-- W（ワイヤカット） -->
            <w>
                <fs16i>X</fs16i>
                <fs18i>X</fs18i>
            </w>
            <!-- PM（パワーメート） -->
            <pw>
                <d>E</d>
                <h>E</h>
            </pw>
            <!-- 300is -->
            <is>
                <!-- M（ミリング） -->
                <m>
                    <fs30is>O</fs30is>
                </m>
                <!-- T（旋盤） -->
                <t>
                    <fs30is>O</fs30is>
                </t>
            </is>
        </support>



        <!-- 参照 -->
        <reference>
            <item>
                <name>cnc_diagnoss</name>
                <file>misc/cnc_diagnoss.htm</file>
            </item>
            <item>
                <name>cnc_diagnosr</name>
                <file>misc/cnc_diagnosr.htm</file>
            </item>
            <item>
                <name>cnc_rddiaginfo</name>
                <file>misc/cnc_rddiaginfo.htm</file>
            </item>
            <item>
                <name>cnc_rddiagnum</name>
                <file>misc/cnc_rddiagnum.htm</file>
            </item>
        </reference>



        <!-- プログラム例 -->
        <example>
<vc>
以下のプログラムはダイアグノーズデータNo.300とNo.410を読みだし画面に表示します。
(Series 160i/180i/210i, 0i, Power Mate i)

#include "fwlib32.h"

void example()
{
        IODBPRM prm[2];
        long prmno[2];

        prmno[0] = 300;
        prmno[1] = 410;
        ret = cnc_rddiag_ext( h, prmno, 2, prm ) ;
        if ( !ret ) {
                printf( "No.300:\n" );
                printf( "  1st axis = %d\n", prm[0].data[0].prm_val );
                printf( "  2nd axis = %d\n", prm[0].data[1].prm_val );
                printf( "  3rd axis = %d\n", prm[0].data[2].prm_val );

                printf( "No.410: = %d\n", prm[1].data[0].prm_val );
        }
}</vc>
        </example>



    </func>
</root>
