こちらから - インタフェース

IFHNL(PCI/C-PCI) 

GPG-8826 

光メモリンクインタフェースモジュール用 Linux ドライバ 

Help for Linux 

www.interface.co.jp

GPG-8826 Help for Linux 

目次 

第 1 章はじめに 3 

1.1 概要 ...........................................................................3 

1.2 特長 ...........................................................................3 

1.3 用語解説 .......................................................................4 

1.4 共有メモリとは .................................................................4 

1.5 ウィンドウとは .................................................................9 

1.6 「PCI Express Native」環境でご使用の方へ ......................................11 

第 2 章製品仕様 12 

2.1 動作環境 ......................................................................12 

2.2 基本仕様 ......................................................................13 

第 3 章実行手順 14 

3.1 デバイスを動かすまで ..........................................................14 

3.2 制御手順 ......................................................................19 

3.3 メモリ共有できない接続方法 ....................................................22 

3.4 インタフェースモジュールのスレーブからマスタへの切替方法 ......................22 

第 4 章リファレンス 23 

4.1 関数一覧 ......................................................................23 

4.2 関数個別説明 ..................................................................24 

4.3 イベントについて ..............................................................41 

4.4 構造体説明 ....................................................................42 

4.5 戻り値一覧 ....................................................................44 

第 5 章サンプルプログラム 45 

5.1 WriteFile .....................................................................45 

5.2 ReadFile ......................................................................46 

5.3 SIMD 拡張命令を利用したデータ転送 ..............................................47 

第 6 章ユーティリティ 48 

6.1 設定ユーティリティ(IFHNLSet) ..................................................48 

第 7 章重要な情報 54 

© 2012, 2013 Interface Corporation. All rights reserved. 

2


第 1 章はじめに 

1.1 概要 

本ソフトウェアは、Linux アプリケーションから、弊社製品の制御を行うためのソフトウェア 

です。GPG-8826 は、弊社光メモリンク製品を Linux アプリケーションから Lib をリンクし関数を 

コールすることにより制御します。 

本ドキュメントは、Linux 上で GPG-8826 を使用するための情報を掲載しています。 

1.2 特長 

● 通常のメモリアクセス処理と同等の処理で共有メモリへのアクセス処理ができます。 

その使い方もメモリアクセス処理と同等の処理でできます。 

● ファイル形式でのメモリ共有による入出力による割り込み要求、イベント取得を行うサンプル 

プログラムを付属しています。 

ソースを公開していますので、自由にプログラムを拡張することができます。 

● 光メモリンクネットワーク上でメモリ共有するための設定ユーティリティを準備しています。 

デバイスの状態を表示して設定を簡単に行うことができます。 

● 画面上で機能や使い方を説明する Help をサポートしていますので、開発中に関数の詳細説明 

など、簡単に参照することができます。 


3


1.3 用語解説 

用語 

説明 

マスタデバイス 

光メモリンクのマスタとして設定を行ったデバイス 

スレーブデバイス 

光メモリンクのスレーブとして設定を行ったデバイス 

光メモリンクネットワーク光メモリンクのネットワークのこと。一つのマスタコンピュータに対 

して構成されているネットワーク。 

ノード光メモリンクネットワークの要素。 

マスタデバイスとスレーブデバイスで一つのノードを構成します。 

共有メモリ 

共有メモリとはコンピュータに搭載されているRAMを光メモリンク用に確 

保したメモリ。詳しくは「1.4 共有メモリとは」を参照してください。 

マスタコンピュータマスタデバイスを搭載したコンピュータ 

スレーブコンピュータスレーブデバイスを搭載したコンピュータ 

Virtual ウィンドウスレーブからマスタにアクセスするためのウィンドウ 

詳しくは「1.5 ウィンドウとは」を参照してください。 

Link ウィンドウ 

マスタからスレーブにアクセスするためのウィンドウ 

詳しくは「1.5 ウィンドウとは」を参照してください。 

1.4 共有メモリとは 

共有メモリとはコンピュータに搭載されている RAM を光メモリンク用に確保したメモリです。 

確保の際、OS が使用する RAM 容量を制限します。 

RAM 容量を制限するため、下記のように Linux の起動時に、コマンド行オプションを渡します。 

設定ユーティリティにてご使用のコンピュータに搭載されている RAM の容量 , 確保したいメモリのサ 

イズを入力し、設定を行うと共に、コマンドオプションに渡す値を取得してください。 

例 )Debian 5.0 での例 

設定ユーティリティで取得した値が、510 だった場合、『mem=510M』を指定します。 

Kernel /boot/vmlinuz-2.6.26-2-686 root=/dev/hda1 ro quiet mem=510M 

※ 設定した値、ご使用される環境により、Linuxが起動できなくなる、フリーズやカーネルパニック 

といった予期しない動作が発生することがあります。 

共有メモリとして使用可能なメモリ領域については「1.4.2 共有メモリとして使用可能なメモリ領 

域について」を参照してください。 

※ 本設定以外で RAM 容量を制限し、使用されている場合、使用する RAM が競合する可能性があります。 

再起動後、手動での指定を行わずに制限を掛けた状態で使用する場合にはブートローダの編集を 

行ってください。編集方法については使用されているブートローダの説明をご覧下さい。 

RAM の増設などの理由で後から同オプションを変更したい場合は、下記の手順で 

変更を行ってください。 

下記の手順をとらず変更した場合は、本ソフトウェアの正常動作は保証いたしかねます。 

1. 設定ユーティリティ(IFHNLSet)にてデバイスのリフレッシュ、共有メモリのリフレッシュをする。 

※ブートローダの編集を行った場合、元に戻してください。 

2. 設定ユーティリティ(IFHNLSet)にて再度設定をする。 


4


1.4.1 復旧方法 

共有メモリの設定を行ったことにより、OS が動作しなくなった場合の復旧方法について説明します。 

OS が動作しなくなった場合には、下記の方法を実行し、OS の使用可能な RAM 容量の制限を解除して 

ください。 

1.Linux の起動時に、コマンド行オプションを編集し、Linux を起動してください。 

例 )Debian 5.0 での例 

Kernel /boot/vmlinuz-2.6.26-2-686 root=/dev/hda1 ro quiet mem=○○M 

「mem=○○M」を削除し、Linux を起動させてください。(○○は OS の使用可能な RAM 容量が入っています。) 

2. 起動後、ブートローダの編集を行い、制限を解除してください。 

編集方法については使用されているブートローダの説明をご覧下さい。 


5


1.4.2 共有メモリとして使用可能なメモリ領域について 

共有メモリはPCに搭載されているRAMの領域を使用します。 

そのため、共有メモリとして使用する領域がシステムの使用する領域と重複してしまった場合、コン 

ピュータが起動しなくなる、フリーズやカーネルパニックといった予期しない動作が発生する恐れが 

あります。 

上記状態を回避するため、共有メモリサイズ設定時、共有メモリへのアクセス時にはシステムやOS 

によって使用されていない領域を確認し、設定、アクセスを行う必要があります。 

下記の情報を確認することで、共有メモリとして使用可能なメモリ領域を確認します。 

・BIOSが割当てた物理メモリのマップ情報 

BIOSによって割当てられたメモリの配置を確認します。 

この情報から、システムに使用されていない領域を確認します。 

・物理メモリマップ情報 

物理メモリが何に割当てられているかを確認します。 

この情報から、OSが使用している領域を確認します。 

安全に使用することのできるメモリ領域の確認手順を以下に記載いたします。 

※ 本説明では下記、弊社環境での例を元にし、確認方法について記載しております。 

・ディストリビューション:Debian 5.0 (32bit) 

・搭載メモリ:1024MB 

ご使用の環境が異なる場合、ログやファイルのフォーマットや確認方法が異なる場合があります。 

各情報の確認方法についてはご使用のコンピュータまたはディストリビューションの仕様をご確 

認下さい。 

1. 「/var/log/message」のファイルを参照していただき、「BIOS-provided physical RAM map」の 

文字列を見つけます。 

kernel: [0.000000] BIOS-provided physical RAM map: 

kernel: [0.000000] BIOS-e820: 0000000000000000 - 000000000009f800 (usable) 

kernel: [0.000000] BIOS-e820: 000000000009f800 - 00000000000a0000 (reserved) 

kernel: [0.000000] BIOS-e820: 00000000000ce000 - 00000000000d0000 (reserved) 

kernel: [0.000000] BIOS-e820: 00000000000e0000 - 0000000000100000 (reserved) 

kernel: [0.000000] BIOS-e820: 0000000000100000 - 000000003eee0000 (usable) 

kernel: [0.000000] BIOS-e820: 000000003eee0000 - 000000003eeea000 (ACPI data) 

kernel: [0.000000] BIOS-e820: 000000003eeea000 - 000000003ef00000 (ACPI NVS) 

kernel: [0.000000] BIOS-e820: 000000003ef00000 - 0000000040000000 (reserved) 

kernel: [0.000000] BIOS-e820: 00000000fec10000 - 00000000fec20000 (reserved) 

kernel: [0.000000] BIOS-e820: 00000000ff800000 - 00000000ffc00000 (reserved) 

kernel: [0.000000] BIOS-e820: 00000000fffffc00 - 0000000100000000 (reserved) 


6


2. 「BIOS-provided physical RAM map」の文字列以下の「BIOS-e820:」で始まるログの最後が「(usable)」 

となっているメモリ領域を確認します。 

「(usable)」となっていないメモリ領域はシステムが使用する領域となります。 

「(usable)」となっているメモリ領域はシステムが使用しない領域でOS、または光メモリンクの 

共有メモリとして使用することのできる領域です。 

kernel: [0.000000] BIOS-provided physical RAM map: 

kernel: [0.000000] BIOS-e820: 0000000000000000 - 000000000009f800 (usable) 

kernel: [0.000000] BIOS-e820: 000000000009f800 - 00000000000a0000 (reserved) 

kernel: [0.000000] BIOS-e820: 00000000000ce000 - 00000000000d0000 (reserved) 

kernel: [0.000000] BIOS-e820: 00000000000e0000 - 0000000000100000 (reserved) 

kernel: [0.000000] BIOS-e820: 0000000000100000 - 000000003eee0000 (usable) 

kernel: [0.000000] BIOS-e820: 000000003eee0000 - 000000003eeea000 (ACPI data) 

kernel: [0.000000] BIOS-e820: 000000003eeea000 - 000000003ef00000 (ACPI NVS) 

kernel: [0.000000] BIOS-e820: 000000003ef00000 - 0000000040000000 (reserved) 

kernel: [0.000000] BIOS-e820: 00000000fec10000 - 00000000fec20000 (reserved) 

kernel: [0.000000] BIOS-e820: 00000000ff800000 - 00000000ffc00000 (reserved) 

kernel: [0.000000] BIOS-e820: 00000000fffffc00 - 0000000100000000 (reserved) 

3. 「/proc/iomem」ファイルを参照していただき、「System RAM」とされている領域を確認します。 

※「System RAM」とされている領域がOSが使用している領域となります。 

「2」、「3」の情報から、現段階ではメモリ領域はシステム領域、OSに全て使用されている状態 

です。 

00000000-0009f7ff : System RAM 

0009f800-0009ffff : reserved 

000a0000-000bffff : Video RAM area 

000c0000-000c7fff : Video ROM 

000ce000-000cffff : reserved 

000f0000-000fffff : System ROM 

00100000-3eedffff : System RAM 

00100000-002baba8 : Kernel code 

002baba9-0037661f : Kernel data 

003bc000-0041f57f : Kernel bss 

: 

: 

4. 設定ユーティリティで共有メモリのサイズを設定し、「mem=xxM」オプションを指定し、OSの使用 

する領域を制限することで、「System RAM」とされている領域を制限します。 

※ 上記例では、OSの使用している領域が3eedffff[h] ≒ 1006MBまでとなっているため、 

「mem=xxM」オプションで指定する値は1006 未満に指定する必要があります。 

コンピュータに搭載されている RAM を 1024MB、確保する共有メモリを 512MB とし設定ユーティリ 

ティで設定を行い、設定ユーティリティでの出力結果「mem=512M」をブートローダで設定した場 

合の「/proc/iomem」ファイルの抜粋を下記に記載します。 

00000000-0009f7ff : System RAM 

0009f800-0009ffff : reserved 

000a0000-000bffff : Video RAM area 


7


000c0000-000c7fff : Video ROM 

000ce000-000cffff : reserved 

000f0000-000fffff : System ROM 

00100000-1fffffff : System RAM 

00100000-002baba8 : Kernel code 

002baba9-0037661f : Kernel data 

003bc000-0041f57f : Kernel bss 

: 

: 

「mem=512M」の指定でOSの使用する領域を512MB = 20000000[h]までに制限したため、「3」の状態 

では3eedffff[h]まであったSystem RAMの領域が1fffffff[h]までとなっています。 

5. 「2.」で確認したメモリ領域のうち、「4.」で確認したSystem RAM 領域以外の部分が光メモリンク 

の共有メモリの領域として使用することができます。 

上記例の場合、20000000[h]~3eedffff[h]までの領域を共有メモリとして使用することができま 

す。 


8


1.5 ウィンドウとは 

他コンピュータ上に割り当てている共有メモリにアクセスを行うためにはウィンドウを使用してそ 

の領域にアクセスを行います。 

つまり、ウィンドウのサイズで共有メモリにアクセスできる最大サイズが変化します。 

光メモリンクには下記の 2 つのウィンドウがあります。 

Virtual ウィンドウスレーブコンピュータからマスタコンピュータにアクセスするためのウ 

ィンドウ 

ウィンドウの指定サイズはマスタコンピュータのデバイスリソースを取 

得します。リソース不足などにならないよう注意してください。 

ウィンドウサイズの設定は「6.1 設定ユーティリティ(IFHNLSet)」で行 

います。最大 4 チャンネルまで指定できます(※) 

Link ウィンドウマスタコンピュータからスレーブコンピュータにアクセスするためのウ 

ィンドウ 

ウィンドウの指定サイズ分はスレーブコンピュータのデバイスリソース 

を取得します。リソース不足などにならないよう注意してください。 

ウィンドウサイズの設定は「6.1 設定ユーティリティ(IFHNLSet)」で行 

います。最大 4 チャンネルまで指定できます(※) 

※ 各ウィンドウのチャンネルは環境により下記のようにチャンネル数が異なります。 

マスタコンピュータまたはスレーブコンピュータが x64 環境の場合 : 同時に 2 チャンネルまで 

マスタコンピュータかつスレーブコンピュータが x86 環境の場合 : 同時に 4 チャンネルまで 

※Virtual ウィンドウ、Link ウィンドウの要求するサイズが大きい場合、コンピュータがメモリ 

リソースを割り当てられず、コンピュータが起動しなくなる可能性があります。 

コンピュータの構成などよく理解した上で設定を行ってください。 

1.5.1 各接続状態でのウィンドウ 

各接続状態でメモリ共有をする場合下記のような構成になります。 

■マスタコンピュータ→スレーブコンピュータ間 

スレーブコンピュータ 

マスタコンピュータ 

メモリ 

物理アドレス領域 

メモリ 


共有メモリ領域 

仮想アドレス領域 


Link ウィンドウ 

マスタコンピュータからスレーブコンピュータの共有メモリにアクセスする場合は Link ウィン 

ドウを介してアクセスします。 


9


■スレーブコンピュータ→マスタコンピュータ間 

スレーブコンピュータ 


メモリ 


メモリ 





Virtual ウィンドウ 

スレーブコンピュータからマスタコンピュータの共有メモリにアクセスする場合は Virtual ウィ 

ンドウを介してアクセスします。 

■スレーブコンピュータ1→スレーブコンピュータ2 間 

スレーブコンピュータ1 


スレーブコンピュータ2 

メモリ 


メモリ 


メモリ 




Virtual ウィンドウ1 


Link ウィンドウ2 


「スレーブコンピュータ1」から「スレーブコンピュータ2」の共有メモリにアクセスする場合、 

アクセスする「スレーブコンピュータ1」⇔「マスタコンピュータ」間のノードの「Virtual ウ 

ィンドウ1」と、共有メモリのある「スレーブコンピュータ2」⇔「マスタコンピュータ」間の 

ノードの「Link ウィンドウ2」を介してアクセスします。 

このとき、マスタコンピュータから共有データ領域はアクセスできません。 


10


1.6 「PCI Express Native」環境でご使用の方へ 

ご使用のコンピュータのBIOSにおいて、「PCI Express Native Support」が有効かつ、「PCI Express 

Native」をサポートしているディストリビューションでは、PCI-882611,CPZ-882611 を使用するこ 

とはできません。 

PCI Express デバイスが、「PCI Express Native」構成かどうかチェックしているディストリビュー 

ションでは、光メモリンクを「PCI Express Native」構成に設定する必要があります。 

光メモリンクを「PCI Express Native」構成に設定するには、「6.1 設定ユーティリティ(IFHNLSet)」 

の「PCI Express Nativeの設定」が必要です。 


11


第 2 章製品仕様 

2.1 動作環境 

対応機種 

ドライバ種別 

組み込み方式 

メジャー番号割り当て 

ソースコードの 

取り扱い 

ビルドサポート 

対応カーネルバージョン 

Help 

弊社製 FA コントローラ 

弊社製 Classembly Devices® 

PC/AT 互換機 

キャラクタ型ドライバ 

モジュール(ダイナミックロード/アンロード) 

自動割り当て 

ドライバモジュール一部公開 

ライブラリソースコード非公開 

共用モジュール公開 

メイクファイル提供 

・IBM PC/AT 互換機 

カーネル 2.6.x 

PDF 形式 


12


2.2 基本仕様 

※4 

最大デバイス数 16 

※5 

最大ノード数 64 

1CPU 内での取得共有メモリ容量 1MB~ (※1) 

ウィンドウチャンネル数 4 または 2 (※2) (※3) 

ウィンドウサイズ 

1MB~1GB(※1) 

Link ウィンドウ合計最大サイズ 1GB(※1) 

Virtual ウィンドウ合計最大サイズ 1GB(※1) 

シェアオープン 

対応 

最大シェアオープン数 255 

※1 最大取得容量は環境に依存します。 

※2 ウィンドウチャンネル数は環境により下記のようにチャンネル数が異なります。 

・マスタコンピュータまたはスレーブコンピュータが x64 環境の場合 : 

同時に 2 チャンネルまで 

・マスタコンピュータかつスレーブコンピュータが.x86 環境の場合 : 

同時に 4 チャンネルまで 

※3 ウィンドウの割り当て先を変更できます。 

※4 最大デバイス数とは 1 台のコンピュータに取り付けることができる光メモリンク製品の数 

です。 

※5 最大ノード数とは同一光メモリンクネットワーク上に接続できるノードの数です。 


13


第 3 章実行手順 

3.1 デバイスを動かすまで 

インタフェースモジュールを拡張スロットに実装する前に、下記設定を行って下さい。 

・スレーブデバイスとするインタフェースモジュール:DSW1 の 4 を ON に設定 

・マスタデバイスとするインタフェースモジュール:DSW1 の 4 を OFF に設定 

3.1.1 インストール 

インタフェースモジュールを拡張スロットに実装しコンピュータを起動します。 

インストーラを起動し、Linux ドライバのインストールを行います。 

詳しいインストール方法は、Readme をご参照ください。 

#bash install 

インストーラの指示に従って、インストールを行ってください。 

3.1.2 ドライバモジュールの組み込み 

GPG-8826 の Linux 用ドライバモジュールを組み込みます。 

インストール先がデフォルトの場合、「/usr/src/interface/gpg8826/(アーキテクチャ名 

※)/linux/drivers」ディレクトリにドライバモジュールを組み込むためのシェルスクリプトがコ 

ピーされます。 

※アーキテクチャ名は、i386 または x86_64 になります。 

シェルスクリプト「insifhnl.sh」を実行し、GPG-8826 の Linux 用ドライバモジュールを組み込 

みます。 

#cd /usr/src/interface/gpgxxxx/(アーキテクチャ名 )/linux/drivers 

#sh insifhnl.sh 

3.1.3 インタフェースモジュールの設定 

初期状態では、まずスレーブコンピュータでの設定が必要です。 

次にスレーブコンピュータで「3.1.5 設定ユーティリティ」を行ってください。 

※スレーブコンピュータの設定が完了するまでケーブルの接続を行わないでください。 

マスタデバイスは設定不要です。 

※スレーブデバイスから、マスタデバイスへ変更する場合には、設定ユーティリティ(IFHNLSet)の、 

「デバイスのリフレッシュ」が必要です。 


14


3.1.4 ノード名変更 

光メモリンクネットワーク上にいるノードに対して任意の名前を指定することが出来ます。ノー 

ド名により光メモリンクの制御を行います。 

ドライバモジュールを組み込んだ際、設定ファイルに標準のノード名が設定されます。ノード名 

を変更する場合には設定ファイルに書かれている名前を変更してください。 

設定ファイルは「/etc/interface/」ディレクトリに ifhnl(RSW1 の番号 )のファイル名で保存され 

ています。 

例 )RSW1 の番号を 3 に設定したインタフェースモジュールの場合、 

/etc/interface/ifhnl3 のファイルに書かれている名前を変更します。 

※ 設定ファイルはスレーブコンピュータにしか存在しません。 

※ 光メモリンクネットワーク上で重複した名前を設定しないで下さい。 

指定できる文字列はアルファベット(a~z,A~Z), 数字 (0~9),ハイフン(-), 

アンダーバー(_)です。1~16 文字の中で設定してください。 

ファイル名 ,ファイルのパスは変更しないで下さい。 

※ 変更後、ドライバモジュールを一度解除し、組込み直す必要があります。 

マスタコンピュータとリンクしている状態の場合、マスタコンピュータのドライバモジュール 

も一度解除し、組み込みなおす必要があります。下記手順で行ってください。 

※ 下記実施時は下記の制限事項を守ること。 

・スレーブコンピュータでは光メモリンクのデバイスがオープンがされていないこと。 

・設定ユーティリティ(IfHnlSet)が終了していること。 

・スレーブコンピュータで光メモリンクのデバイスオープン(IFHnlOpen 関数 )、 

設定ユーティリティ(IfHnlSet)の実行を行わないこと。 

1.スレーブコンピュータにある設定ファイルを編集 

2.マスタコンピュータのドライバモジュールを解除 

3.スレーブコンピュータのドライバモジュールを解除 

4.スレーブコンピュータのドライバモジュールを組込み 

5.マスタコンピュータのドライバモジュールを組込み 

3.1.5 設定ユーティリティ 

設定ユーティリティにより、デバイス使用時の物理メモリの確保やウィンドウサイズの確保の設 

定を行います。 

使用方法の詳細は「6.1 設定ユーティリティ(IFHNLSet)」を参照ください。 

必要であればマスタコンピュータの共有メモリの設定を設定ユーティリティで行ってください。 

次に「3.1.6 起動手順」を行ってください。 

※ 設定ユーティリティでの設定を行わないかぎりメモリ共有はできません。 

また、マスタデバイスはデバイスとして認識しません。 

※コンピュータの再起動が必要です。( 再起動後は再度モジュールの組込みが必要です。) 

※ 設定ユーティリティの実行にはスーパーユーザ権限が必要です。 


15


3.1.6 起動手順 

マスタコンピュータ、スレーブコンピュータ共に電源が OFF の状態 

1.スレーブコンピュータとマスタコンピュータの光メモリンクを光ケーブルで接続してください。 

2.スレーブコンピュータを起動させてください。 

3.スレーブコンピュータの OS が起動したことを確認してください。 

4.スレーブコンピュータで光メモリンクドライバの組込み 

5.スレーブコンピュータで設定ユーティリティによる光メモリンクの設定 ( 設定が必要な場合 ) 

設定後スレーブコンピュータの再起動を行い「2」に戻ります。 

※これ以降の作業時は下記の制限事項を守ること。 

・スレーブコンピュータでは光メモリンクのデバイスがオープンがされていないこと。 




6.マスタコンピュータを起動させてください。 

7.マスタコンピュータの OS が起動したことを確認してください。 

8.マスタコンピュータで光メモリンクドライバの組込み 

9.マスタコンピュータで設定ユーティリティによる光メモリンクの設定 ( 設定が必要な場合 ) 

Shared Memory Size の値以外を変更する場合は、設定後、マスタコンピュータの電源 OFF、ス 

レーブコンピュータの電源 OFF を実施し、「1」に戻ります。 

Shared Memory Size の値のみ変更した場合は、設定後マスタコンピュータの再起動を行い「7」 

に戻ります。 

※コンピュータ起動時は必ずこの手順で起動させてください。 

上記手順にてマスタコンピュータ、スレーブコンピュータの起動後、 

光メモリンクの使用準備が完了します。 


16


マスタコンピュータ、スレーブコンピュータ共に電源が ON の状態 ( 正常動作時 ) 

・マスタコンピュータの再起動を行う場合 

1.マスタコンピュータ、スレーブコンピュータの両方で下記の終了処理を実行 

・共有メモリのアンマップ(IfHnlMemoryUnmap 関数 )の実行 

※ 共有メモリのマッピング(IfHnlMemoryMap 関数 )を行っていた場合 

・ウィンドウメモリのアンマップ(IfHnlWindowUnmap 関数 )の実行 

※ウィンドウメモリのマッピング(IfHnlWindowMap 関数 )を行っていた場合 

・ウィンドウのクローズ(IfHnlWindowClose)の実行 

※ウィンドウのオープン(IfHnlWindowOpen 関数 )を行っていた場合 

・デバイスのクローズ(IfHnlClose)の実行 

※デバイスのオープン(IfHnlOpen 関数 )を行っていた場合 

※これ以降の作業時は下記の制限事項を守ること。 

・スレーブコンピュータでは光メモリンクのデバイスがオープンされていないこと。 




2.マスタコンピュータの再起動 

3.マスタコンピュータ、スレーブコンピュータ共に電源が OFF の状態」の 

「7」からの処理と同じ。 

・スレーブコンピュータの再起動を行う場合 

※スレーブコンピュータのみの再起動はできません。スレーブコンピュータを再起動する際 

はマスタコンピュータの電源 OFF 後、スレーブコンピュータの再起動を行う必要がありま 

す。下記手順にて実施して下さい。 

1.マスタコンピュータ、スレーブコンピュータの両方で下記の終了処理を実行 

・共有メモリのアンマップ(IfHnlMemoryUnmap 関数 )の実行 

※ 共有メモリのマッピング(IfHnlMemoryMap 関数 )を行っていた場合 

・ウィンドウメモリのアンマップ(IfHnlWindowUnmap 関数 )の実行 

※ウィンドウメモリのマッピング(IfHnlWindowMap 関数 )を行っていた場合 

・ウィンドウのクローズ(IfHnlWindowClose)の実行 

※ウィンドウのオープン(IfHnlWindowOpen 関数 )を行っていた場合 

・デバイスのクローズ(IfHnlClose)の実行 

※デバイスのオープン(IfHnlOpen 関数 )を行っていた場合 

2.マスタコンピュータの電源 OFF 

3.スレーブコンピュータの再起動 

4.「マスタコンピュータ、スレーブコンピュータ共に電源が OFF の状態」の 

「2」からの処理と同じ 


17


3.1.7 コンパイル 

作成したプログラムをコンパイルします。下記のコマンドを実行してください。 

以下はソースファイル名を ifhnltest.c とし、実行ファイル名を ifhnltest とした場合の例です。 

#gcc –o ifhnltest ifhnltest.c –libgpg8826 

3.1.8 実行 

コンパイルすることで実行ファイル ifhnltest ができていますので、 

#./ifhnltest 

と入力し、プログラムを実行してください。 

より詳しいプログラム方法は、『3.2 制御手順』をご参照ください。 


18


3.2 制御手順 

1 つのコンピュータ上で弊社光メモリンク製品を複数枚使用する場合は、インタフェースモジュ 

ール上のロータリスイッチ RSW1 の設定値が光メモリンク製品同士で重複しないように設定して 

からスロットに実装し、コンピュータを起動して下さい。 

ロータリスイッチ RSW1 の設定値は弊社光メモリンク製品が複数存在する場合、制御対象を一意に 

識別するための番号となります。重複していた場合、本ソフトウェアの正常動作は保証いたしか 

ねます。 

※ハブ(SIO-882605)はマスタコンピュータのデバイスとして認識します。マスタデバイスのロー 

タリスイッチ(RSW1)の設定値と重複しないように設定してください。 

基本的な制御の手順は以下の通りです( 記述例は C 言語です)。 

3.2.1 デバイス初期化 

デバイスをIfHnlOpen 関数で初期化します。 

初期化が正常終了すると、以後、デバイスへのアクセスが可能となります。 

unsigned long DeviceHandle; 

DeviceHandle = IfHnlOpen (“IFHNL_Device_0”, IFHNL_FLAG_NORMAL); 

3.2.2 ウィンドウ初期化 

相手のコンピュータの共有メモリにアクセスしたい場合は、ウィンドウを使用してアクセスしま 

す。 

ウィンドウをIfHnlWindowOpen 関数で初期化します。 

同時にウィンドウに相手のコンピュータの共有メモリを割り当てます。 

この処理には設定ユーティリティ(IFHNLSet)で設定したVirtualウィンドウの空きチャンネルが 

必要です。スレーブコンピュータ⇔スレーブコンピュータ間でのメモリ共有を行う場合はさらに、 

接続先のノード名、Linkウィンドウの空きチャンネルが必要です。 

また、IfHnlGetInfo 関数でノードの情報の取得ができます。 

初期化が正常終了すると、以後、ウィンドウから指定した共有メモリへのアクセスが可能となり 

ます。 

unsigned long WindowHandle; 

IFHNL_LINKWINDOW Linkinfo; 

sprintf(Linkinfo.NodeName,”Node1”); 

Linkinfo.Ch = 1; 

WindowHandle = IfHnlWindowOpen (DeviceHandle, 1, 1 ,1 , &Linkinfo); 


19


この例では、下記の図ようなスレーブコンピュータ⇔スレーブコンピュータ間接続です。 

スレーブパソコン1 

マスタパソコン 

スレーブパソコン2 

メモリ 

メモリ 

メモリ 

サイズ:1MB 




オフセット:1MB 





Virtual ウィンドウ1 

Link ウィンドウ2 

1 チャンネル 

1 チャンネル 

スレーブコンピュータ1からスレーブコンピュータ2の共有メモリのオフセット 1MB、サイズ 1MB 

の領域へ接続を行っています。自身のノードの Virtual ウィンドウの 1 チャンネルからノード名 

「Node1」の Link ウィンドウの 1 チャンネルを使用してアクセスを行います。 

※Virtualウィンドウ、Linkウィンドウについては「1.5 ウィンドウとは」を参照ください 

3.2.3 ウィンドウのマッピング 

ウィンドウに割り当てた共有メモリをIfHnlWindowMap 関数で仮想メモリへマッピングします。 

仮想メモリへアクセスすることで、相手の共有メモリの情報を取得・設定できるようになります。 

Void* WinMapmem; 

WinMapmem = IfHnlWindowMap(DeviceHandle, WindowHandle); 

(char)(*WinMapmem) = ‘a’; 

printf(“%c\n”, (*((char*)WinMapmem + 0x100))); 

3.2.4 自身のコンピュータの共有メモリへのマッピング 

自身のコンピュータ上の共有メモリをIfHnlMemoryMap 関数で仮想メモリへマッピングします。 

仮想メモリへアクセスすることで、自身のコンピュータ上の共有メモリデータを取得・設定でき 

るようになります。 

Void* PhyMapmem; 

PhyMapmem = IfHnlMemoryMap(DeviceHandle, 0, 1); 

(char)(*PhyMapmem) = ‘a’; 

printf(“%c\n”, (*((char*)PhyMapmem + 0x100))); 

※ 共有メモリについては「1.4 共有メモリとは」を参照ください 


20


3.2.5 割り込み要求 

同期をとるときなどに、ノードに対して割り込みを発生させることができます。 

ノードに対して割り込みをIfHnlInterruptRequest 関数で要求します。 

この処理には設定ユーティリティ(IFHNLSet)で設定したノード名が必要です。また、IfHnlGetInfo 

関数でノードの情報の取得ができます。 

Ret = IfHnlInterruptRequest(DeviceHandle, “Node1”); 

3.2.6 イベント 

ノードからの割り込み要求をコールバックで取得します。 

コールバックはIfHnlSetEvent 関数で設定ができます。 

また、IfHnlKillEvent 関数でイベントの設定を解除できます。 

void EventProc(unsigned long DeviceHandle, void * UserData, char * NodeName) 

{ 

// 割り込みイベントに対応する処理を記述します 

} 

Ret = IfHnlSetEvent (DeviceHandle, 10, EventProc, NULL, 0, 0, 0); 

Ret = IfHnlKillEvent (DeviceHandle); 

3.2.7 アンマップ 

共有メモリを割り当てた仮想メモリをIfHnlMemoryUnmap 関数、IfHnlWindowUnmap 関数で解放しま 

す。 

アプリケーションでは、必ず仮想メモリの解放を行ってから終了してください。 

Ret = IfHnlMemoryUnmap(DeviceHandle, PhyMapmem); 

Ret = IfHnlWindowUnmap(DeviceHandle, WinMapmem); 

3.2.8 ウィンドウの終了処理 

ウィンドウの終了処理をIfHnlWindowClose 関数で行います。 

アプリケーションでは、必ずウィンドウの終了処理を行ってから終了してください。 

Ret = IfHnlWindowClose(WindowHandle); 

3.2.9 終了処理 

IfHnlClose 関数でデバイスの終了処理を行います。 

アプリケーションでは、必ず終了処理を行ってから終了してください。 

Ret = IfHnlClose(DeviceHandle); 


21


3.3 メモリ共有できない接続方法 

下記のようにコンピュータ1のスレーブデバイスから、コンピュータ3の共有メモリには直接ア 

クセスできません。 

コンピュータ1 

スレーブ 


マスタ 

スレーブ 


共有 

メモリ 

マスタ 

× 

コンピュータ1とコンピュータ3でメモリの共有を行いたいのであれば、共有メモリをコンピュータ2に 

設けて共有してください。 


スレーブ 


マスタ 


スレーブ 

マスタ 

○ 

共有 

メモリ 

○ 

3.4 インタフェースモジュールのスレーブからマスタへの切替方法 

「6.1 設定ユーティリティ(IFHNLSet)」の「デバイスのリフレッシュ」を参照してリフレッシュ 

を行ってください。 


22


第 4 章リファレンス 

4.1 関数一覧 

No 関数名機能 

1 IfHnlOpen デバイスをオープンします。 

2 IfHnlClose デバイスをクローズします。 

3 IfHnlGetInfo 光メモリンクネットワーク上のノードの情報を取得します。 

4 IfHnlMemoryMap 共有メモリを仮想メモリに割り当てます。 

5 IfHnlMemoryUnmap 共有メモリから仮想メモリを解放します。 

6 IfHnlWindowOpen ウィンドウをオープンします。 

7 IfHnlWindowClose ウィンドウをクローズします。リンク先のメモリの割り当てを解除します。 

8 IfHnlWindowMap ウィンドウを仮想メモリに割り当てます。 

9 IfHnlWindowUnmap ウィンドウから仮想メモリを解放します。 

10 IfHnlWindowGetHandle すでにオープンしているウィンドウのハンドルを取得します。 

11 IfHnlInterruptRequest 割り込みを発生させます。 

12 IfHnlSetEvent イベントを設定します。 

13 IfHnlKillEvent イベントを解放します。 

14 IfHnlGetLastError エラー情報を取得します。 


23


4.2 関数個別説明 

1. IfHnlOpen 

デバイスのオープンを行い、以後のデバイスへのアクセスを行えるようにします。 

unsigned long IfHnlOpen( 

char* NodeName, // ノード名 

unsigned long Flag // オープンフラグ 

); 

【パラメータ】 

NodeName 

オープンするノード名を指定してください。 

Flag 

オープンフラグを指定してください。 

指定可能な識別子は下記のものから選択します。 

識別子値意味 

IFHNL_FLAG_NORMAL 0 通常のオープン時に使用するフラグです。これを指定する 

と重複してオープンすることはできません。 

IFHNL_FLAG_SHARE 1 1 つのデバイスを複数のプロセス(アプリケーション)か 

ら重複 ( 共有 )して制御することを許可するフラグです。 

【戻り値】 

正常に終了した場合には、INVALID_HANDLE_VALUE(-1) 以外が返されます。 

他の関数は、本関数により取得したデバイスハンドルを使用してデバイスの制御を行います。 

オープンに失敗した場合には、INVALID_HANDLE_VALUE(-1)が返されます。 

拡張エラー情報を取得するには、IfHnlGetLastError 関数を使います。 

拡張エラー情報の内容は『4.5 戻り値一覧』をご参照ください。 

取得出来るエラーコードは、独自のエラーコードとなります。 


24


【備考】 

・IFHNL_FLAG_SHARE の動作について 

本フラグを指定することにより、同じデバイスを 2 つ以上のアプリケーションで共有するこ 

とが可能となります。IFHNL_FLAG_SHARE を指定せずにオープンされているデバイスに対して、 

IFHNL_FLAG_SHARE を指定したオープンを実行した場合、オープンは失敗します。 

オープン(IfHnlOpen 関数 )とクローズ(IfHnlClose 関数 )の実行回数は必ず一致しなければ 

なりません。 

また、同時にシェアオープンできる回数は 255 回までです。 

・ノード名について 

オープンするにはノード名を指定します。 

ノード名はデフォルトは「IFHNL_Device_x」(x はスレーブデバイスの RSW1 の値 (0~16))と 

なります。 

各ノード名の確認は、「6.1 設定ユーティリティ(IFHNLSet)」にて確認できます。 

また、ノード名の変更は「3.1.4 ノード名変更」を参照してください。 

本関数で初めてポートをオープンする時にデバイスノードが作成されます。 

そのため最初の実行時にはスーパーユーザ権限が必要になります。 

2 回目以降に同じポートをオープンする場合には、すでにデバイスノードが 

作成されているため、スーパーユーザである必要はありません。 

【使用例】 

付属のサンプルプログラムをご参照ください。 


25


2. IfHnlClose 

デバイスをクローズします。 

デバイスアクセスのために使用されていた各種リソースの解放を行い、以後のデバイスへのア 

クセスを禁止します。 

unsigned long IfHnlClose( 

unsigned long DeviceHandle // デバイスハンドル 

); 


DeviceHandle 

IfHnlOpen 関数で取得したデバイスハンドルを指定してください。 


正常終了した場合は、IFHNL_ERROR_SUCCESSが返されます。 

IFHNL_ERROR_SUCCESS 以外の値が返された場合については、『4.5 戻り値一覧』をご参照くださ 

い。 

【備考】 

・再度、デバイスへのアクセスを行う場合にはオープン処理 (IfHnlOpen 関数 )を呼び出してくだ 

さい。 

・デバイスクローズ後の各種設定はクリアされます。 




26


3. IfHnlGetInfo 

光メモリンクネットワーク上のノードの情報を取得します。 

現在の共有メモリ、ウィンドウの設定状態を取得できます。 

unsigned long IfHnlGetInfo( 

unsigned long DeviceHandle, // デバイスハンドル 

unsigned long Index, // ノードのインデックス番号 

PIFHNL_NODE_INFO Nodeinfo // ノード情報構造体への参照 

); 


DeviceHandle 


Index 

ノードのインデックス番号を指定します。( 値 :0~64) 

複数ノードがある場合は何個目のノードの情報を取得するか指定します。 

自身のノードの情報を取得したい場合は 0 を指定しても取得できます。 

Nodeinfo 

ノード情報を格納する『IFHNL_NODE_INFO 構造体』への参照渡しを指定してください。 




い。 




27


4. IfHnlMemoryMap 

自身のコンピュータで光メモリンクの使用領域として保持している共有メモリを仮想メモリに 

割り当てます。 

※ 共有メモリとして使用可能なメモリ領域外にアクセスを行った場合、フリーズやカーネルパ 

ニックなど、予期しない動作が発生する恐れがあります。 

共有メモリとして使用可能なメモリ領域については、「1.4.2 共有メモリとして使用可能な 

メモリ領域について」を参照してください。 

void* IfHnlMemoryMap( 


unsigned long StartAddr, // オフセット 

unsigned long Size // メモリサイズ 

); 


DeviceHandle 


StartAddr 

割り当て先の共有メモリの先頭アドレスからのオフセット( 単位 :MB)を指定してください。 

Size 

割り当て先のメモリサイズ( 単位 :MB) 


正常に終了した場合には、割り当てられた領域へのポインタを返します。 

割り当てに失敗した場合には、NULL が返されます。 




【備考】 

本関数を実行するには「/dev/mem」へのアクセス権限が必要です。 




28


5. IfHnlMemoryUnmap 

自身のコンピュータで光メモリンクの使用領域として保持している共有メモリをクローズしま 

す。 

メモリアクセスのために使用されていた各種リソースの解放を行い、以後のアクセスを禁止し 

ます。 

unsigned long IfHnlMemoryUnmap( 


void* Pointer // メモリハンドル 

); 


DeviceHandle 


Pointer 

IfHnlMemoryMap 関数で取得したメモリハンドルを指定してください。 




い。 

【備考】 





29


6. IfHnlWindowOpen 

デバイスの保持しているウィンドウのオープンを行い、以後のアクセスを行えるようにします。 

ウィンドウへ別 PC の共有メモリの割り当てを行います。 

※ 共有メモリとして使用可能なメモリ領域外にアクセスを行った場合、フリーズやカーネルパ 

ニックなど、予期しない動作が発生する恐れがあります。 

共有メモリとして使用可能なメモリ領域については、「1.4.2 共有メモリとして使用可能な 

メモリ領域について」を参照してください。 

unsigned long IfHnlWindowOpen( 


unsigned long Ch, // チャンネル 

unsigned long StartAddr, // オフセット 

unsigned long Size, // メモリサイズ 

PIFHNL_LINKWINDOW LinkWindow // Link ウィンドウ情報構造体への参照 

); 


DeviceHandle 


Ch 

オープンする Link ウィンドウまたは Virtual ウィンドウのチャンネルを指定してください。 

※ウィンドウのチャンネルは環境により下記のようにチャンネル数が異なります。 

マスタコンピュータまたはスレーブコンピュータが x64 環境の場合 : 同時に 2 チャンネル 

まで 

マスタコンピュータかつスレーブコンピュータが x86 環境の場合 : 同時に 4 チャンネルま 

で 

StartAddr 

割り当て先の共有メモリの先頭アドレスからのオフセット( 単位 :MB)を指定してください。 

Size 


LinkWindow 

スレーブコンピュータスレーブコンピュータ間の共有メモリの割り当てを行う場合、 

アクセスを行うLinkウィンドウの情報を入力した『IFHNL_LINKWINDOW 構造体』への参照渡 

しを指定します。 

マスタコンピュータスレーブコンピュータ間の共有メモリの割り当てを行う場合、NULLを 

指定します。 


正常に終了した場合には、有効なウィンドウハンドルが返されます。 

他の関数は、本関数により取得したウィンドウハンドルを使用してウィンドウの制御を行いま 

す。 

オープンに失敗した場合には、INVALID_HANDLE_VALUE(-1)が返されます。 


30





【備考】 

・同チャンネルをシェアオープンできません。 

・相手がダウンした際は、戻り値にエラーが返ります。 

・Virtualウィンドウ、Linkウィンドウについては「1.5 ウィンドウとは」を参照ください 




31


7. IfHnlWindowClose 

デバイスの保持しているウィンドウをクローズします。 

メモリアクセスのために使用されていた各種リソースの解放を行い、以後のアクセスを禁止し 

ます。 

unsigned long IfHnlWindowClose( 

unsigned long WindowHandle // ウィンドウハンドル 

); 


WindowHandle 

IfHnlWindowOpen 関数で取得したウィンドウハンドルを指定してください。 




い。 

【備考】 


再度、ウィンドウへのアクセスを行う場合にはオープン処理 (IfHnlWindowOpen 関数 )を呼び出 

してください。 

ウィンドウクローズ後にマッピングされた仮想メモリなどが解放されます。 




32


8. IfHnlWindowMap 

共有メモリを仮想メモリに割り当てます。 

void* IfHnlWindowMap( 


unsigned long WindowHandle // ウィンドウハンドル 

); 


DeviceHandle 


WindowHandle 

割り当てを行うウィンドウのハンドル(IfHnlWindowOpen 関数で取得したハンドル)を指定 

してください。 


・正常終了した場合は、割り当てられた領域へのポインタを返します。 

割り当てに失敗した場合には、NULLが返されます。 




・相手がダウンした際は、メモリから読み取れる値がすべて FFhとなります。 

戻り値は返りませんのでご注意ください。 

【備考】 





33


9. IfHnlWindowUnmap 

IfHnlWindowMap 関数によって割り当てられた仮想メモリを解放します。 

unsigned long IfHnlWindowUnmap( 


void* Pointer // ウィンドウマップへの参照 

); 


DeviceHandle 


Pointer 

IfHnlWindowMap 関数で取得したポインタを指定してください。 




い。 

【備考】 

・IfHnlWindowMap 関数を同じハンドルで複数回実行して取得したポインタは同じポインタのた 

め一回のIfHnlWindowUnmap 関数で解放されます。 

・相手がダウンした際は、メモリから読み取れる値がすべて FFhとなります。 

戻り値は返りませんのでご注意ください。 

・本関数を実行するには「/dev/mem」へのアクセス権限が必要です。 




34


10. IfHnlWindowGetHandle 

【機能】 

IfHnlWindowOpen 関数によって割り当てられたウィンドウのハンドルを取得します。 

ウィンドウをシェアして使う場合に使用してください。 

【書式】 

●C 言語 

Unsigned long IfHnlWindowGetHandle ( 


unsigned long Ch // チャンネル 

); 


DeviceHandle 


Ch 

IfHnlWindowOpen 関数によってオープンしているLinkウィンドウまたはVirtualウィンドウ 

のチャンネルを指定してください。 


正常に終了した場合には、有効なウィンドウハンドルが返されます。 

本関数により取得したウィンドウハンドルを使用してウィンドウの制御を行えます。 

ウィンドウのハンドル取得に失敗した場合には、INVALID_HANDLE_VALUE(-1)が返されます。 




【備考】 

・IfHnlWindowOpen 関数によってオープンしていない場合、ハンドルは取得できません。 

・IfHnlWindowOpen 関数実行時の戻り値でINVALID_HANDLE_VALUE(-1)が返され、 

GetLastError 関数を使い、拡張エラー情報を取得し、IFHNL_ERROR_ALREADY_OPEN(C0000004h) 

が取得できた場合、この関数でのハンドル取得が可能です。 

・IfHnlWindowClose 関数によってクローズしてしまったウィンドウのハンドルでは共有メモリ 

へアクセスできません。ウィンドウのクローズは使用しなくなったときに行ってください。 




35


11. IfHnlInterruptRequest 

割り込みを発生させます。 

unsigned long IfHnlInterruptRequest( 


char * NodeName // ノード名 

); 


DeviceHandle 


NodeName 

割り込みを発生させるノード名を指定してください。 

スレーブコンピュータからマスタコンピュータ、マスタコンピュータからスレーブコンピ 

ュータに対して割り込みを発生させる場合は、自身のノード名を指定してください。 

スレーブコンピュータから他のスレーブコンピュータへ対して割り込みを発生させる場合 

には、割り込み発生先のスレーブコンピュータのノード名を指定してください。 




い。 

【備考】 

・マスタコンピュータを介して割り込みを発生させます。マスタコンピュータのスペックによ 

っては割り込み発生が遅延する可能性があります。また、マスタコンピュータに負荷がかか 

ります。 

・この関数が戻ってくれば、割り込みの発生要求は出し終えていますが、要求先の割り込み処 

理が完了していない可能性があります。 





36


12. IfHnlSetEvent 

イベントを設定します。 

unsigned long IfHnlSetEvent( 


unsigned long EventBuffer, // 内部入力バッファ数 

PIFHNLCALLBACK CallBackProc, // コールバック関数の参照 

void* UserData, // ユーザデータ 

unsigned long CallBackFlag, // コールバック関数呼び出し方法 

int Reserved, // 予約 

unsigned int Reserved // 予約 

); 


DeviceHandle 


EventBuffer 

指定した数分のデバイスのイベントで取得するノード名の内部入力バッファを確保します。 

1 単位につき 16byte の内部入力バッファを取得します。 

CallBackProc 

コールバック関数の参照渡しを指定します。 

UserData 

任意のデータを指定します。 

CallBackFlag 

コールバック関数の呼び出し方法を指定します。 

値説明 

IFHNL_SYNC 0 コールバックを同期実行します。 

※コールバック処理が完了しないと次のコールバック処理が実行 

されません。 

IFHNL_ASYNC 1 コールバックを非同期実行します。 

※ 同時に複数のコールバックが実行されることがあります。 

同期処理など行ってください。 

Reserved 

< 予約 >(0 を指定してください。) 

Reserved 

< 予約 >(0 を指定してください。) 





37


い。 

【備考】 

・登録したイベントは、IfHnlKillEvent 関数にて、削除できます。 

・コールバック関数については「4.3 イベントについて」を参照ください。 




38


13. IfHnlKillEvent 

イベント処理を解放します。 

unsigned long IfHnlKillEvent( 

unsigned long DeviceHandle // デバイスハンドル 

); 


DeviceHandle 





い。 




39


14. IfHnlGetLastError 

エラー情報を取得します。 

unsigned long IfHnlGetLastError( 

void 

); 


各関数のエラー情報を戻り値として取得します。 

本関数を実行する前に実行していた関数が正常終了している場合は、IFHNL_ERROR_SUCCESSが返 

されます。 


い。 

【備考】 

本関数で戻り値の取得が出来るのは以下の関数となります。 

また、取得出来た戻り値は、以下の関数を実行するまでラッチされます。 

関数一覧 

IfHnlOpen 

IfHnlMemoryMap 

IfHnlWindowOpen 

IfHnlWindowMap 

IfHnlWindowGetHandle 




40


4.3 イベントについて 

4.3.1 コールバック関数 

IfHnlSetEvent 関数にて登録し、割り込みイベントが発生した時にコールされるコールバックルー 

チンです。 

【書式】 

コールバックルーチンを使用する場合、下記のように記述します。 

( 下記はコールバックルーチンを EventProc とする場合の例です。) 

●C 言語 

void EventProc(unsigned long DeviceHandle, void * UserData, char * NodeName) 

{ 

// 割り込みイベントに対応する処理を記述します 

} 

コールバックルーチンの関数型 PIFHNLCALLBACK は下記のように定義されます。 

typedef void (*PIFHNLCALLBACK)(unsigned long DeviceHandle, void * UserData, char * NodeName); 


DeviceHandle 

デバイスハンドルが格納されます。 

UserData 

ユーザデータが格納されます。 

NodeName 

割り込み要求先のノード名が格納されます。( 最大 16 文字 ) 


コールバックルーチンに戻り値はありません。 

【備考】 

エラーの場合、NodeNameにNULLが入り、UserDataにエラー情報が入ります。 

エラー内容は『4.5 戻り値一覧』をご参照ください。 




41


4.4 構造体説明 

4.4.1 IFHNL_LINKWINDOW 構造体 

typedef struct{ 

char 

NodeName[16]; 

unsigned long Ch; 

} IFHNL_LINKWINDOW, *PIFHNL_LINKWINDOW; 

メンバ 

説明 

NodeName 割り当て先のノード名 

スレーブコンピュータスレーブコンピュータ間時に設定が必要です。 

Ch 

割り当て先のノードの Link ウィンドウチャンネル 

スレーブコンピュータスレーブコンピュータ間時に設定が必要です。 

※ Link ウィンドウチャンネルはシェアアクセスできません。 

4.4.2 IFHNL_WINDOW_INFO 構造体 

typedef struct{ 

unsigned long WindowSize; 

char 

NodeName[16]; 

unsigned long Ch; 

unsigned long StartAddr; 

unsigned long Size; 

} IFHNL_WINDOW_INFO, *PIFHNL_WINDOW_INFO; 

メンバ 

WindowSize 

NodeName 

Ch 

StartAddr 

Size 

説明 

ウィンドウのサイズ( 単位 :MB) 

ノード名 

Virtual ウィンドウの情報の場合、割り当て先のノード名 

Link ウィンドウの情報の場合、割り当て元のノード名 

ウィンドウチャンネル 

Virtual ウィンドウの情報の場合、割り当て先の Link ウィンドウチャンネル 

Link ウィンドウの情報の場合、割り当て元の Virtual ウィンドウチャンネル 

マスタコンピュータ⇔スレーブコンピュータ間での使用の場合 0 が入りま 

す。 

割り当て先の共有メモリの先頭アドレスからのオフセット( 単位 :MB) 



42


4.4.3 IFHNL_NODE_INFO 構造体 

typedef struct { 

char 

NodeName[16]; 

unsigned long MasterSharedMemSize; 

unsigned long SlaveSharedMemSize; 

IFHNL_WINDOW_INFO VirtualWindowInfo [4]; 

IFHNL_WINDOW_INFO LinkWindowInfo [4]; 

unsigned long MaxChannelNum; 

unsigned long IsMaster; 

unsigned long IsReady; 

} IFHNL_NODE_INFO, *PIFHNL_NODE_INFO; 

メンバ 

説明 

NodeName 

ノード名 (16 文字まで) 

MasterSharedMemSize マスタコンピュータが保有している共有メモリのサイズ。 

SlaveSharedMemSize スレーブコンピュータで保有している共有メモリのサイズ。 

VirtualWindowInfo Virtual ウィンドウの情報。 

値はチャンネル順に入力されます。 

割り当ててない場合は、WindowSize メンバが 0 になります。 

ウィンドウを使用されていない場合は、Size メンバが 0 になります。 

LinkWindowInfo Link ウィンドウの情報。 

値はチャンネル順に入力されます。 

割り当ててない場合は、WindowSize メンバが 0 になります。 

ウィンドウを使用されていない場合は、Size メンバが 0 になります。 

MaxChannelNum ノードが使用できる最大ウィンドウチャンネル数 

IsMaster デバイスハンドルがマスタデバイス・スレーブデバイスの情報。 

自分自身のノード情報を取得するときにのみ有効。 

1 = マスタデバイスから Open しているノード 

0 = スレーブデバイスから Open しているノード 

IsReady 光メモリンクの使用準備状態の情報。 

自分自身のノード情報を取得するときにのみ有効。 

1 = 光メモリンクの使用準備ができています。 

0 = 光メモリンクが使用準備ができていません。 

※ 本パラメータが「0」となっている場合、「3.1.6 起動手順」を参照し、 

起動手順の実施を行って下さい。 


43


4.5 戻り値一覧 

エラー識別子値意味対処方法 

IFHNL_ERROR_SUCCESS 0 正常終了 - 

IFHNL_ERROR_NOT_DEVICE C0000001h ドライバを呼び出せませ 

ん。 

指定したデバイスが見つかりません 

でした。 

指定したデバイス番号が存在するか 

どうかを確認してください。 

IFHNL_ERROR_NOT_OPEN C0000002h ドライバを OPEN できませ 

ん。 

IFHNL_ERROR_INVALID_HANDLE C0000003h デバイスハンドルが正し 

くありません。 

IFHNL_ERROR_ALREADY_OPEN C0000004h すでにオープン済みです。 

IFHNL_ERROR_INSUFFICIENT_BUFFER C0000005h データ領域が小さすぎで 

す。 

デバイスのオープン時、何らかのエラ 

ーが発生しました。 

ドライバ内部のメモリ確保に失敗し 

たなど。 

不正なデバイスハンドルで呼び出し 

を行おうとしました。 

OPEN 関数で返されたデバイスハンド 

ルを使用してください。 

IfhnlWindowOpen 実行時の場合は 

Window のリソースの領域が確保でき 

ていません。Window の再設定を行っ 

てください。 

IFHNL_ERROR_NOT_SUPPORTED C0000007h 未サポートです。 

IFHNL_ERROR_MEMORY_NOTALLOCATED C0000008h メモリ確保に失敗しまし 

た。 

IFHNL_ERROR_INVALID_PARAMETER C0000009h 引数に誤りがあります。 

IFHNL_ERROR_NOT_FOUND_DEVICE C000000Ah デバイスが見つかりませ 

ん。 

IFHNL_ERROR_KEEP_MAP C000000Bh すでにマップ済みです。 

IFHNL_ERROR_NOT_FOUND_NAME C000000Ch ノード名が見つかりませ 

ん。 

IFHNL_ERROR_MEMORY_SIZE_OVER C000000Dh メモリサイズを超えてい 

ます。 

IFHNL_ERROR_NOT_FOUND_TERMINAL C000000Eh 接続先が見つかりません。 

IFHNL_ERROR_NETWORK_RESPONSE C000000Fh リンクできません。マスタデバイスとの接続が切れてい 

る可能性があります。 

IFHNL_ERROR_ALREADY_SET_EVENT C0000011h すでにイベントが登録さ 

れています。 

IFHNL_ERROR_NOT_INITIALIZE C0000012h 初期化されていません。 

IFHNL_ERROR_INVALID_CANNEL C0000013h チャンネルが正しくあり 

ません。 

IFHNL_ERROR_EVENT_THREAD C0000015h イベントスレッドを立ち 

上げることができません。 

IFHNL_ERROR_EVENT_OVER_FLOW C0000016h イベントバッファのオー 

バーフローが発生しまし 

た。 

IfHnlSetEvent 関数のEventBufferに 

十分な大きさを指定してださい。 


44


第 5 章サンプルプログラム 

以下、各サンプルプログラムの概要を説明します。 

サンプルプログラム名 

WriteFile 

ReadFile 

説明 

ファイル出力サンプルプログラム 

ファイル取得サンプルプログラム 

5.1 WriteFile 

【概要】 

ファイル出力を行うサンプルプログラムです。 

1MB 以下のファイルを、共有メモリの 1 チャンネルを使用して Ifhnl.bmp ファイルを出力しま 

す。 

マスタコンピュータスレーブコンピュータ間で動作します。 

ファイルの取得は ReadFile サンプルプログラムで行ってください。 

【実行手順】 

Node 名を IFHNL_Device_0 としてください。 

共有メモリを 1MB 以上設定してください。 

サンプルプログラムには実行形式のファイルが付属していません。 

ソースコードをコンパイルして実行ファイルを生成してから、動作させてください。 

実行方法 

各サンプルプログラムのディレクトリに移動し、make コマンドを実行してください。 

例 )# make 

Make コマンドにより作成された実行ファイルを実行してください。 

例 )# ./WriteFile 

【内容】 

1.ノード(IFHNL_Device_0)をオープンします。 

2. 共有メモリの 1 チャンネルをマップします。 

3.ファイルをバイナリに変換して、共有メモリに書き込みます。 

データは下記のデータ構造で入力されます。 

ファイル名 (0~15byte) 

サイズ(16~19byte) 

ファイルのバイナリデータ(20byte~) 

4.ノード(IFHNL_Device_0)に割り込みを要求します。 

5. 共有メモリをアンマップします。 

6. 共有メモリをクローズします。 

7.ノード(IFHNL_Device_0)をクローズします。 


45


5.2 ReadFile 

【概要】 

ファイル入力を行うサンプルプログラムです。 

1MB 以下のファイルを、共有メモリの 1 チャンネルから入力します。 

マスタコンピュータスレーブコンピュータ間で動作します。 

ファイルの出力は WriteFile サンプルプログラムで行ってください。 

【実行手順】 

Node 名を IFHNL_Device_0 としてください。 

実行するコンピュータがマスタコンピュータの場合、Link ウィンドウの 1 チャンネルに 1MB 以 

上の領域を確保してください。 

実行するコンピュータがスレーブコンピュータの場合、Virtual ウィンドウの 1 チャンネルに 

1MB 以上の領域を確保してください。 

サンプルプログラムには実行形式のファイルが付属していません。 

ソースコードをコンパイルして実行ファイルを生成してから、動作させてください。 

実行方法 

各サンプルプログラムのディレクトリに移動し、make コマンドを実行してください。 

例 )# make 

Make コマンドにより作成された実行ファイルを実行してください。 

例 )# ./ReadFile 

【内容】 

1.ノード(IFHNL_Device_0)をオープンする。 

2.ウィンドウの 1 チャンネルのオープンする。 

3.ウィンドウの 1 チャンネルをマップする。 

4.イベントを登録します。コールバックを登録します。 

5.イベント発生を待機し、もし 10 秒かかってもイベントが発生しなかったら強制終了させてプロ 

グラムを終了します。 

6.イベントが発生すると下記のデータ構造のデータを取り出します。 

ファイル名 (0~15byte) 

サイズ(16~19byte) 

ファイルのバイナリデータ(20byte~) 

7.バイナリをファイルに変換して、実行ファイルと同じフォルダに保存します。 

8.ウィンドウをアンマップします。 

9.ウィンドウをクローズします。 

10. ノード(IFHNL_Device_0)をクローズします。 


46


5.3 SIMD 拡張命令を利用したデータ転送 

【概要】 

SIMD 拡張命令に対応した CPU を使用される場合、長データの一括転送に対応した拡張命令を使 

用することでデータ転送を高速に行うことができる場合があります。※ 


// movdqu を使用した 128bit(16byte) 単位のメモリコピー(32bit) 

void memcpy_dqu(void *dst, void *src, size_t size) 

{ 

asm ( 

"movdqu_cpy: " 

" movdqu (%%esi), %%xmm0; " // src から xmm レジスタへの転送 (128bit) 

" lea 16(%%esi), %%esi; " 

" movdqu %%xmm0, (%%edi); " // xmm レジスタから dst への転送 (128bit) 

" lea 16(%%edi), %%edi; " 

" sub $16, %%eax; " 

" cmp $16, %%eax; " 

" jge movdqu_cpy; " 

} 

" emms " 

:: "a" (size), "S" (src), "D" (dst) 

); 

【内容】 

上記の使用例は SSE2 以降で対応した movdqu 命令を使用して、128bit(16byte) 単位でのデー 

タ転送を行う例となります。 

(movdqu 命令はアライメントが揃っていなくても使用できますが、アライメントを揃えたアド 

レスで使用する方がより高速に動作します。) 

Virtual ウィンドウ/Link ウィンドウに対してデータ転送を行う際に、movdqu 命令等の長デー 

タの一括転送に対応した拡張命令を使用すると、バースト転送が発生しやくなる場合がありま 

す。※ 

【注意事項】 

※ご使用される CPU・ディストリビューション等によっては効果が出ない場合もあります。 

※64bit 環境で実行する場合は、使用するレジスタを 64bit 用のものに変更してください。 

eax → rax 

esi → rsi 

edi → rdi 


47


第 6 章ユーティリティ 

以下、ユーティリティの概要を説明します。 

6.1 設定ユーティリティ(IFHNLSet) 

デバイス使用時の物理メモリの確保やウィンドウサイズの確保などを行います。 

※ 設定ユーティリティはスーパーユーザ権限で実行する必要があります。 

6.1.1 起動方法 

コンソールから次のコマンドを実行してください。 

#IFHNLSet 

起動すると、図 6.1.1-1 のように設定されている共有メモリのサイズ,ノード名 , 自身がマスタ 

(M)かスレーブ(S)か, 各ウィンドウサイズの一覧が表示されます。ここで設定を行う対象を選択 

します。項目の数字 (1~3,99)を入力し、「Enter」キーを押してください。 

******************************************************************** 

IFHNLSet Fiber-Optic memolink configuration utility Version 1.20.03 

Copyright 2013 Interface Corporation. All rights reserved. 

The command allocates the shared memory and window size, 

and configures the node name for Fiber-Optic MEMOLINK device. 

******************************************************************** 

Shared Memory[MB] = 0 

NodeName ||M || LinkWindowSize || VirtualWindowSize || 

|| S|| CH1 | CH2 | CH3 | CH4 || CH1 | CH2 | CH3 | CH4 || 

-------------------------------------------------------------- 

IFHNL_Device_1 || S|| 0 | 0 | 0 | 0 || 0 | 0 | 0 | 0 || 

IFHNL_Device_0 || S|| 0 | 0 | 0 | 0 || 0 | 0 | 0 | 0 || 

-------------------------------------------------------------------------- 

Please Select Setting Target. 

1:Device. 

2:Share Memory. 

3:PCI Express Native Setting. 

99:Exit. 

Mode: 

図 6.1.1-1 

1:Device. 

:デバイスの設定 

(ウィンドウサイズの設定、デバイスのリフレッシュ) 

2:Share Memory. 

: 共有メモリの設定 

( 共有メモリの設定、共有メモリのリフレッシュ) 

3:PCI Express Native Setting :PCI Express Nativeの設定 

99:Exit. 

: 設定ユーティリティの終了 


48


6.1.2 デバイスの設定 

※ 本項目の設定はスレーブのみの設定となります。マスタでは設定できません。ご注意ください。 

デバイスの設定を選択すると、図 6.1.2-1のように表示されます。 

設定を行うデバイスのノード名を入力してください。 

Mode:1 

NodeName: 

図 6.1.2-1 

32bit の環境でスレーブコンピュータで実行した場合はマスタコンピュータの OS の確認が表示さ 

れます。OS の情報を選択してください。選択する数字 (0~1)を入力し、「Enter」キーを押して 

ください。 

ノード名の入力が完了すると、図 6.1.2-2 のように設定する項目が表示されます。 

設定する項目の数字 (1~2,99)を入力し、「Enter」キーを押してください。 

Please Select Mode. 

1:Set Window Size. 

2:Device Refresh. 

99:Exit. 

図 6.1.2-2 

1:Set Window Size. 

2:Device Refresh. 

99:Exit. 

:ウィンドウサイズの設定 

:デバイスのリフレッシュ 



49


ウィンドウサイズの設定 

各ウィンドウのサイズを設定してください。 

最大 4 チャンネル設定することができます。値は 2 n で設定できます( 単位 :MB) 

※ 指定サイズはコンピュータのメモリリソースを要求します。 

リソース不足などにならないよう注意してください。 

Virtualウィンドウ,Linkウィンドウについては「1.5 ウィンドウとは」を参照してください。 

下記設定を行った場合の図 6.1.2-3 のようになります。入力した項目は赤字で表示しています。 

64bit 環境 

Virtual ウィンドウ :CH1 32MB 

:CH2 16MB 

Link ウィンドウ :CH1 8MB 

:CH2 4MB 

Set VirtualWindow Size 

VirtualWindow(CH1):32 

VirtualWindow(CH2):16 

Set LinkWindow Size 

LinkWindow(CH1):8 

LinkWindow(CH2):4 

Restart the computer to enable settings. Do you want to restart now 

Select(y/n): 

図 6.1.2-3 

設定を有効にする場合には y を選択し、再起動を行ってください。 

再起動を行わない場合には n を選択してください。 

デバイスのリフレッシュ 

インタフェースモジュールのスレーブデバイスをマスタデバイスに戻す場合は、 

この項目での設定が必要です。 

項目を選択すると、デバイスのリフレッシュが行われ、図 6.1.2-4のようなコメントが 

表示されます。 

Turn off your computer, remove the device, and set position 4 of DSW1 to OFF. Do you want 

to shut down the computer. 

Select(y/n): 

図 6.1.2-4 

マスタデバイスに切り替えたい場合は、yを選択し、コンピュータの電源を切り、 

コンピュータからデバイスを抜き、DSW1 の4 をOFF に設定してください。 


50


6.1.3 共有メモリの設定 

共有メモリの設定を選択すると、図 6.1.3-1 のように設定する項目が表示されます。 



1:Set Share Memory Size. 

2:Share Memory Refresh. 

99:Exit. 

図 6.1.3-1 

1:Set Share Memory Size. 

2:Share Memory Refresh. 

99:Exit. 

: 共有メモリの確保 

: 共有メモリのリフレッシュ 


共有メモリの確保 

確保する共有メモリのサイズを設定します。 

ご使用のコンピュータに搭載されている RAM 容量 ( 単位 :MB)と、 

確保するメモリサイズ( 単位 :MB)を入力してください。値は 2 n で設定できます( 単位 :MB) 

下記設定を行った場合の図 6.1.3-2 のようになります。入力した項目は赤字で表示しています。 

コンピュータに搭載されている RAM 2048MB 

確保する共有メモリ 

64MB 

Mode: 

Please input the size of RAM on your computer. 

Size:2048 

Please input the size of Share Memory. 

Size:64 

Please Edit BootLoader. 

mem=1984M 

-----------------Cautions---------------- 

The OS may not operate normally 

if the RAM capacity available to the OS runs short. 

Confirm the recovery method in Help 

beforehand in case the OS does not operate. 

---------------------------------------- 


Select(y/n): 

図 6.1.3-2 


設定後、出力される値 ( 上記例では mem=1984M)を Linux の起動時に 

コマンド行オプションにて指定してください。※ 

詳しくはHelpの「1.4 共有メモリとは」を参照してください。 



51


※ここで出力される値にはOSが動作するために必要な領域、システムの使用する領域は考慮され 

ておりません。 

OS が動作するために必要な容量を下回る値を設定した場合、OS が動作しなくなる可能性があ 

ります。 

ブートローダの設定を行う前に、コマンド行オプションにて一度 OSの動作を確認することを推 

奨いたします。 

出力された値がOSが動作するために必要な容量を下回る場合、確保する共有メモリの値を少 

なくし、再度設定を行ってください。 

OSが動作しなくなった場合の復旧方法は「1.4.1 復旧方法」を参照ください。 

また、共有メモリとして使用可能なメモリ領域外にアクセスを行った場合、フリーズやカーネ 

ルパニックなど、予期しない動作が発生する恐れがあります。 

共有メモリとして使用可能なメモリ領域については、「1.4.2 共有メモリとして使用可能なメ 

モリ領域について」を参照してください。 

共有メモリのリフレッシュ 

確保した共有メモリのクリアを行います。コマンド行オプションにて指定した値はクリアされま 

せんので、再起動、または設定後、ブートローダの値を元に戻してください。 

詳しくはHelpの「1.4 共有メモリとは」を参照してください。 

項目を選択すると、デバイスのリフレッシュが行われ、図 6.1.3-3 のようなコメントが 

表示されます。 

Mode:Please Edit BootLoader. 


Select(y/n): 

図 6.1.3-3 




52


6.1.4 PCI Express Native の設定 

PCI Express Native の設定を選択すると、図 6.1.4-1 のように設定する項目が表示されます。 



1:Enable. 

2:Disable. 

99:Exit. 

図 6.1.4-1 

1:Enable. 

2:Disable. 

99:Exit. 

:「PCI Express Native」構成に設定します 

:「PCI Express Native」構成に設定しません 


※PCI Express デバイスが、「PCI Express Native」構成かどうかチェックしているディストリビ 

ューションでは、上記設定を「Enable」に設定することで光メモリンクを使用することができ 

ます。 

※ 設定を実行したコンピュータのスレーブデバイスに対して設定が行われます 

項目を選択し、設定が行われると、図 6.1.4-2 のようなコメントが表示されます。 


Select(y/n): 

図 6.1.4-2 




53


第 7 章重要な情報 

保証の内容と制限 

弊社は本ドキュメントに含まれるソースプログラムの実行が中断しないこと、またはその実行に 

誤りが無いことを保証していません。 

本製品の品質や使用に起因する、性能に起因するいかなるリスクも使用者が負うものとします。 

弊社はドキュメント内の情報の正確さに万全を期しています。万一、誤記または誤植などがあっ 

た場合、弊社は予告無く改訂する場合があります。ドキュメントまたはドキュメント内の情報に 

起因するいかなる損害に対しても弊社は責任を負いません。 

ドキュメント内の図や表は説明のためであり、ユーザ個別の応用事例により変化する場合があり 

ます。 

著作権、知的所有権 

弊社は本製品に含まれるおよび本製品に対する権利や知的所有権を保持しています。 

本製品はコンピュータソフトウェア、映像 / 音声 ( 例えば図、文章、写真など)を含んでいます。 

医療機器 / 器具への適用における注意 

弊社の製品は人命に関わるような状況下で使用される機器に用いられる事を目的として設計、製 

造された物では有りません。 

弊社の製品は人体の検査などに使用するに適する信頼性を確保する事を意図された部品や検査機 

器と共に設計された物では有りません。 

医療機器、治療器具などの本製品の適用により、製品の故障、ユーザ、設計者の過失などにより、 

損傷 / 損害を引き起こす場合が有ります。 

複製の禁止 

弊社の許可なく、本ドキュメントの全て、または一部に関わらず、複製、改変などを行うことは 

できません。 

責任の制限 

弊社は、弊社または再販売者の予見の有無にかかわらず発生したいかなる特別損害、偶発的損害、 

間接的な損害、重大な損害について、責任を負いません。 

本製品 (ハードウェア,ソフトウェア)のシステム組み込み、使用、ならびに本製品から得られる 

結果に関する一切のリスクについては、本製品の使用者に帰属するものとします。 

本製品に含まれるバグ、あるいは本製品の供給 ( 納期遅延 )、性能もしくは使用に起因する付帯的 

損害もしくは間接的損害に対して、弊社に全面的に責がある場合でも、弊社はその製品に対する 

改良 ( 正常に動作する)、代品交換までとし、金銭面での賠償の責任は負わないものとしますので、 

予めご了承ください。 

本製品 (ソフトウェアを含む)は、日本国内仕様です。本製品を日本国外で使用された場合、弊 

社は一切責任を負いかねます。また、弊社は本製品に関し、海外での保守サービスおよび技術サ 

ポート等は行っておりません。 

商標 / 登録商標 

本書に掲載されている会社名、製品名は、それぞれ各社の商標または登録商標です。 


54

こちらから - インタフェース

Create successful ePaper yourself

Delete template?

Save as template?