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

<root>
  <func>


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



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



    <!-- 解説 -->
    <doc>
        <cmn>
            <p>datanoで指定された番号、typeで指定された軸(軸型のパラメータのみ)のパラメータを書き換えます。<br/>データ形式は各パラメータによりますが、バイト/ワード/2ワード型のパラメータは一般に符号付のバイナリ形式です。</p>

            <p>typeにALL_AXESを指定することにより全軸の書き換えを一度に行うことができます。その際、各軸のパラメータはIODBPSD内の各配列に格納されます。</p>

            <p>パラメータには型と軸の属性により以下のような種類があり、パラメータ番号ごとに異なります。<a href="ncdata/cnc_rdparainfo.htm" target="_parent">cnc_rdparainfo</a>関数により、これらの属性情報をリードできます。</p>

            <table class="dd" border="1">
                <colgroup valign="top"/>
                <colgroup valign="top"/>
                <colgroup valign="top"/>
                <tr>
                    <th>パラメータの種類</th>
                    <th>目的</th>
                    <th>バイトサイズ</th>
                </tr>
                <tr>
                    <td>ビット型パラメータ</td>
                    <td>1ビットごとに意味を持つ</td>
                    <td>1</td>
                </tr>
                <tr>
                    <td>ビット型パラメータ</td>
                    <td>1ビットごとに意味を持つ(軸毎)</td>
                    <td>1</td>
                </tr>
                <tr>
                    <td>バイト型パラメータ</td>
                    <td>1バイト長のデータを記憶</td>
                    <td>1</td>
                </tr>
                <tr>
                    <td>バイト軸型パラメータ</td>
                    <td>1バイト長のデータを記憶(軸毎)</td>
                    <td>1</td>
                </tr>
                <tr>
                    <td>ワード型パラメータ</td>
                    <td>2バイト長のデータを記憶</td>
                    <td>2</td>
                </tr>
                <tr>
                    <td>ワード軸型パラメータ</td>
                    <td>2バイト長のデータを記憶(軸毎)</td>
                    <td>2</td>
                </tr>
                <tr>
                    <td>2ワード型パラメータ</td>
                    <td>4バイト長のデータを記憶</td>
                    <td>4</td>
                </tr>
                <tr>
                    <td>2ワード軸型パラメータ</td>
                    <td>4バイト長のデータを記憶(軸毎)</td>
                    <td>4</td>
                </tr>
                <tr>
                    <td>実数型パラメータ<span class="xis"><br/>(Series 150i, 300i)</span></td>
                    <td>4バイト長のデータ部+4バイト長の小数点以下桁数部を記憶</td>
                    <td>8</td>
                </tr>
                <tr>
                    <td>実数軸型パラメータ<span class="xis"><br/>(Series 150i, 300i)</span></td>
                    <td>4バイト長のデータ部+4バイト長の小数点以下桁数部を記憶(軸毎)</td>
                    <td>8</td>
                </tr>
            </table>

            <p>ただし、ビット型パラメータを1ビット単位で読み出すことはできません。同一のパラメータ番号に属する8ビット(つまり1バイト)をまとめて読み出し、目的のビットを変更してから8ビット単位で書き換えることになります。</p>

            <span class="xis">
            <p>パラメータによってはデータを書き換えた時に<br/>
                『PW000アラーム(Series150, 150i, 300i)、<br/>
                 PS000アラーム(Series 160/180/210, 160i/180i/210i, 0i, Power Mate i)：電源を１度落とさなければなりません』<br/>になる場合があります。</p>
            <p>Series 150, 150i, 300i では、9000番台のパラメータ等、書き換え禁止のパラメータを書き換えようとした場合、エラーが返ります(戻り値:EW_PROT)。</p>
            </span>

            <span class="ois">
            <p>パラメータによってはデータを書き換えた時に『PW000アラーム：電源を１度落とさなければなりません』になる場合があります。</p>
            <p>9000番台のパラメータ等、書き換え禁止のパラメータを書き換えようとした場合、エラーが返ります(戻り値:EW_PROT)。</p>
            </span>

            <p>各パラメータの詳細については CNCのパラメータ説明書を参照して下さい。</p>

        </cmn>
    </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>length</name>
                    <type>in</type>
                    <content>
                        <p>データブロック長(IODBPSD構造体のサイズ)を指定します。</p>
                        <p class="dd">4+(パラメータのバイトサイズ)×(書き換える軸数)</p>
                        <p>下図はパラメータのサイズが4バイトの場合です。<br/>パラメータのサイズが 1,2,8バイトの場合は、1個(1軸)あたりのデータ部のサイズがそれぞれ 1,2,8バイトになります。</p>
                        <p><b>IODBPSD</b></p>
                        <table>
                            <colgroup align="left" valign="top">
                            <colgroup align="left" valign="top">
                            <colgroup align="left" valign="top">
                            <tr>
                                <th>軸なし/1軸指定</th>
                                <th>全軸指定</th>
                            </tr>
                            <tr>
                                <td valign="top"><img src="ncdata/prm.gif"/></td>
                                <td valign="top"><img src="ncdata/prma.gif"/></td>
                            </tr>
                            </colgroup>
                            </colgroup>
                            </colgroup>
                        </table>
                        <ul>
                            <li>Series 150, 150i, 300i</li><p/>
                            <p>
                                n = 最大制御軸数(有効データは制御軸数分)
                            </p>
                        </ul>
                        <ul>
                            <li>Series 160/180/210, 160i/180i/210i, 0i, Power Mate i</li><p/>
                            <p>
                                n = 制御軸数
                            </p>
                        </ul>

                        <p class="info">
                        なお、スピンドル関係パラメータは軸型として扱われます。有効データはスピンドルの個数分となります。</p>

                    </content>
                </item>
                <item>
                    <name>param</name>
                    <type>in</type>
                    <content>
                        <p>書き換えるパラメータを指定するIODBPSD構造体へのポインタです。IODBPSD構造体は次の通りです。</p>
<pre>
・Series 150, 160/180/210, 160i/180i/210i, 0i, Power Mate i の場合

typedef struct  iodbpsd {
    short datano;              /* パラメータ番号 */
    short type;                /* 軸番号 */
    union {
        char  cdata;            /* ビット/バイト形パラメータ */
        short idata;            /* ワード形パラメータ */
        long  ldata;            /* 2ワード形パラメータ */
        char  cdatas[MAX_AXIS]; /* ビット/バイト軸形パラメータ */
        short idatas[MAX_AXIS]; /* ワード軸形パラメータ */
        long  ldatas[MAX_AXIS]; /* 2ワード軸形パラメータ */
    } u ;
} IODBPSD ;                   /* MAX_AXIS : 最大制御軸数 */
</pre>
<pre>
・Series 150i, 300i, Ethernet接続 の場合

typedef struct realprm {       /* 実数型パラメータ */
   long prm_val;               /* データ部 */
   long dec_val;               /* 小数点以下桁数部 */
} REALPRM;

typedef struct  iodbpsd {
   short datano;               /* パラメータ番号 */
   short type;                 /* 上位バイト:型属性 */
                               /* 下位バイト:軸番号 */
   union {
      char    cdata;           /* ビット/バイト型パラメータ */
      short   idata;           /* ワード型パラメータ */
      long    ldata;           /* 2ワード型パラメータ */
      REALPRM rdata;           /* 実数型パラメータ */
      char    cdatas[MAX_AXIS];/* ビット/バイト軸型パラメータ*/
      short   idatas[MAX_AXIS];/* ワード軸型パラメータ */
      long    ldatas[MAX_AXIS];/* 2ワード軸型パラメータ */
      REALPRM rdatas[MAX_AXIS];/* 実数軸型パラメータ */
   } u;
} IODBPSD ;                    /* MAX_AXIS : 最大制御軸数 */
</pre>

                        <dl>
                            <dt>datano</dt>
                            <dd>ライトするパラメータ番号を指定します。<br/>
                            指定可能なパラメータ番号は CNCのパラメータ説明書を参照して下さい。
                            また、<a href="ncdata/cnc_rdparanum.htm" target="_parent">cnc_rdparanum</a>関数、及び<a href="ncdata/cnc_rdparainfo.htm" target="_parent">cnc_rdparainfo</a>関数でも取得できます。</dd>
                            <br/>
                            <dt>type</dt>
                            <dd>ライトするパラメータの属性を指定します。
                                <ul>
                                    <br/>
                                    <li>Series 150, 160/180/210, 160i/180i/210i, 0i, 300i, Power Mate i</li>
                                    ライトする軸番号を指定します。
                                    <table class="dd">
                                        <tr>
                                            <td>0</td>
                                            <td>:</td>
                                            <td>軸型でないパラメータ</td>
                                        </tr>
                                        <tr>
                                            <td>1〜m</td>
                                            <td>:</td>
                                            <td>軸型パラメータの1軸指定(m : 最大制御軸数)</td>
                                        </tr>
                                        <tr>
                                            <td>ALL_AXES</td>
                                            <td>:</td>
                                            <td>軸型パラメータの全軸指定(ALL_AXES : -1)</td>
                                        </tr>
                                    </table>
                                    <br/>
                                    <li>Series 150i</li>
                                    上位バイト : 型属性
                                    <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>ワード型</td>
                                        </tr>
                                        <tr>
                                            <td>3</td>
                                            <td>:</td>
                                            <td>2ワード型</td>
                                        </tr>
                                        <tr>
                                            <td>4</td>
                                            <td>:</td>
                                            <td>実数型</td>
                                        </tr>
                                    </table>
                                    下位バイト : 軸番号
                                    <table class="dd">
                                        <tr>
                                            <td>0</td>
                                            <td>:</td>
                                            <td>軸型でないパラメータ</td>
                                        </tr>
                                        <tr>
                                            <td>1〜m</td>
                                            <td>:</td>
                                            <td>軸型パラメータの1軸指定(m : 最大制御軸数)</td>
                                        </tr>
                                        <tr>
                                            <td>ALL_AXES</td>
                                            <td>:</td>
                                            <td>軸型パラメータの全軸指定(ALL_AXES : -1)</td>
                                        </tr>
                                    </table>
                                </ul>
                            </dd>
                            <br/>
                            <dt>rdata, rdatas ( Series 150i, 300i )</dt>
                            <dd>ライトする実数型パラメータを指定します。prm_valにデータを、dec_valに小数点以下桁数を指定します。</dd>
                            <dd>
                                <div class="dd">
                                    <p>実数型パラメータ = prm_val * 10 ** (-dec_val)<br/>
                                    (例) 実数型パラメータ12.345をライトする場合、prm_val = 12345, dec_val = 3 と指定します。</p>
                                </div>
                            </dd>
                        </dl>

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

        <is>
            <hssb>
                <vc>
                    <item>
                        <name>FlibHndl</name>
                        <type>in</type>
                        <content>
                            <p>
                                ライブラリハンドルです。詳細は、「<a href="handle.htm" target="_parent">ライブラリハンドル</a>」を参照して下さい。
                            </p>
                        </content>
                    </item>
                    <item>
                        <name>length</name>
                        <type>in</type>
                        <content>
                            <p>データブロック長(IODBPSD構造体のサイズ)を指定します。</p>
                            <p class="dd">4+(パラメータのバイトサイズ)×(書き換える軸数)</p>
                            <p>下図はパラメータのサイズが4バイトの場合です。<br/>パラメータのサイズが 1,2,8バイトの場合は、1個(1軸)あたりのデータ部のサイズがそれぞれ 1,2,8バイトになります。</p>
                            <p><b>IODBPSD</b></p>
                            <table>
                                <colgroup align="left" valign="top"/>
                                <colgroup align="left" valign="top"/>
                                <tr>
                                    <th>軸なし/1軸指定</th>
                                    <th>全軸指定</th>
                                </tr>
                                <tr>
                                    <td><img src="ncdata/prm.gif"/></td>
                                    <td><img src="ncdata/prma.gif"/></td>
                                </tr>
                                <tr>
                                    <td></td>
                                    <td>n = 最大制御軸数(有効データは制御軸数分)</td>
                                </tr>
                            </table>
                            <p class="info">
                                スピンドル関係パラメータは軸型として扱われます。有効データはスピンドルの個数分となります。
                            </p>
                        </content>
                    </item>
                    <item>
                        <name>param</name>
                        <type>in</type>
                        <content>
                            <p>書き換えるパラメータを指定するIODBPSD構造体へのポインタです。IODBPSD構造体は次の通りです。</p>
<pre>
typedef struct realprm {       /* 実数型パラメータ */
   long prm_val;               /* データ部 */
   long dec_val;               /* 小数点以下桁数部 */
} REALPRM;

typedef struct  iodbpsd {
   short datano;               /* パラメータ番号 */
   short type;                 /* 上位バイト:型属性 */
                               /* 下位バイト:軸番号 */
   union {
      char    cdata;           /* ビット/バイト型パラメータ */
      short   idata;           /* ワード型パラメータ */
      long    ldata;           /* 2ワード型パラメータ */
      REALPRM rdata;           /* 実数型パラメータ */
      char    cdatas[MAX_AXIS];/* ビット/バイト軸型パラメータ*/
      short   idatas[MAX_AXIS];/* ワード軸型パラメータ */
      long    ldatas[MAX_AXIS];/* 2ワード軸型パラメータ */
      REALPRM rdatas[MAX_AXIS];/* 実数軸型パラメータ */
   } u;
} IODBPSD ;                    /* MAX_AXIS : 最大制御軸数 */
</pre>

                            <dl>
                                <dt>datano</dt>
                                <dd>ライトするパラメータ番号を指定します。<br/>
                                指定可能なパラメータ番号は CNCのパラメータ説明書を参照して下さい。
                                また、<a href="ncdata/cnc_rdparanum.htm" target="_parent">cnc_rdparanum</a>関数、及び<a href="ncdata/cnc_rdparainfo.htm" target="_parent">cnc_rdparainfo</a>関数でも取得できます。</dd>
                                <br/>
                                <dt>type</dt>
                                <dd>ライトするパラメータの属性を指定します。
                                    <table class="dd">
                                        <tr>
                                            <td>0</td>
                                            <td>:</td>
                                            <td>軸型でないパラメータ</td>
                                        </tr>
                                        <tr>
                                            <td>1〜m</td>
                                            <td>:</td>
                                            <td>軸型パラメータの1軸指定(m : 最大制御軸数)</td>
                                        </tr>
                                        <tr>
                                            <td>ALL_AXES</td>
                                            <td>:</td>
                                            <td>軸型パラメータの全軸指定(ALL_AXES : -1)</td>
                                        </tr>
                                    </table>
                                </dd>
                                <br/>
                                <dt>rdata, rdatas</dt>
                                <dd>ライトする実数型パラメータを指定します。prm_valにデータを、dec_valに小数点以下桁数を指定します。</dd>
                                <dd>
                                    <div class="dd">
                                        <p>実数型パラメータ = prm_val * 10 ** (-dec_val)<br/>
                                        (例) 実数型パラメータ12.345をライトする場合、prm_val = 12345, dec_val = 3 と指定します。</p>
                                    </div>
                                </dd>
                            </dl>

                        </content>
                    </item>
                </vc>
            </hssb>
        </is>
    </argument>



    <!-- 戻り値 -->
    <errcode>
        <item>
            <name>EW_LENGTH</name>
            <content>
                データブロック長の誤り<br/>
                IODBPSD構造体のサイズ(length)が不正です。
            </content>
        </item>
        <item>
            <name>EW_NUMBER</name>
            <content>データ番号の誤り<br/>
                パラメータ番号(datano)の指定が不適切です。
            </content>
        </item>
        <item>
            <name>EW_ATTRIB</name>
            <content>データ属性の誤り<br/>
                軸番号(type)の指定が不適切です。
            </content>
        </item>
        <item class="xis">
            <name>EW_NOOPT</name>
            <content>オプションなし<br/>指定されたパラメータを使用するために必要なオプションが付加されていません。<br/>( Series 160/180/210, 160i/180i/210i, 0i, Power Mate i )</content>
        </item>
        <item>
            <name>EW_PROT</name>
            <content>書き込み禁止です。<span class="xis"><br/>( Series 150i, 300i )</span></content>
        </item>
        <item class="xis">
            <name>EW_PASSWD</name>
            <content>指定されたパラメータは保護されているため書き込めません。<br/>( Series 160i/180i/210i, 0i )</content>
        </item>
    </errcode>



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

        <type>
            <li>Series 160/180/210, 160i/180i/210i, 0i, Power Mate i</li>
            特定のオプションで使用するパラメータはそのオプションが必要な場合があります。
        </type>

        <is>
            <hssb>拡張ドライバ/ライブラリ機能が必要です。</hssb>
        </is>
    </option>



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



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



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

        <is>
            <m>
                <fs30is>O</fs30is>
            </m>
            <t>
                <fs30is>O</fs30is>
            </t>
        </is>
    </support>



    <!-- 参照 -->
    <reference>
        <item>
            <name>cnc_rdparam</name>
            <file>ncdata/cnc_rdparam.htm</file>
        </item>
        <item>
            <name>cnc_rdparar</name>
            <file>ncdata/cnc_rdparar.htm</file>
        </item>
        <item>
            <name>cnc_wrparas</name>
            <file>ncdata/cnc_wrparas.htm</file>
        </item>
        <item>
            <name>cnc_rdparam_ext</name>
            <file>ncdata/cnc_rdparam_ext.htm</file>
        </item>
        <item>
            <name>cnc_rdparainfo</name>
            <file>ncdata/cnc_rdparainfo.htm</file>
        </item>
        <item>
            <name>cnc_rdparanum</name>
            <file>ncdata/cnc_rdparanum.htm</file>
        </item>
    </reference>



    <!-- プログラム例 -->
    <example>
<vc>
以下のプログラムは指定された軸のストロークリミットの設定値を書き換えます。

#include "fwlib32.h"

/* axis is axis index. */
/* plus and minus are plus and minus position of stroke limit. */
short example( short axis, long plus, long minus  )
{
    IODBPSD param ;
    short ret ;
    param.datano = 1320 ;
    param.type = axis ;
    param.u.ldata = plus ;
    ret = cnc_wrparam( h, 4+4*1, &#38;param ) ;
    if ( ret ) return ( ret ) ;
    param.datano = 1321 ;
    param.type = axis ;
    param.u.ldata = minus ;
    ret = cnc_wrparam( h, 4+4*1, &#38;param ) ;
    return ( ret ) ;
}
</vc>
    </example>



  </func>
</root>
