TCP/IP プロトコルスタック（TINET） サンプルアプリケーション（リリース 1.7）［2017/5/15］ 1. サンプルアプリケーション サンプルとして、以下のアプリケーションを提供している。【】内は【アプ リケーション名、対応するネットワーク層】である。IPv64 はネットワーク層 として IPv6 と IPv4 の両方を使用することを意味しており、 IPv64m は、 IPv4 は IPv6 の IPv4 射影アドレスにより実装している。 (1) IPv6 TCP ECHO サーバ【echos6、IPv6】 ネットワークアプリケーションに必要な各ファイルの設定方法の 参考となる、 TCP エコーサーバ機能のみのシンプルなアプリケーショ ンである。 (2) IPv4 TCP ECHO サーバ【echos4、IPv4】 ネットワークアプリケーションに必要な各ファイルの設定方法の 参考となる、 TCP エコーサーバ機能のみのシンプルなアプリケーショ ンである。 (3) IPv6 UDP ECHO サーバ【usrv6、IPv6】 ネットワークアプリケーションに必要な各ファイルの設定方法の 参考となる、 UDP エコーサーバ機能のみのシンプルなアプリケーショ ンである。 (4) IPv4 UDP ECHO サーバ【usrv4、IPv4】 ネットワークアプリケーションに必要な各ファイルの設定方法の 参考となる、 UDP エコーサーバ機能のみのシンプルなアプリケーショ ンである。 (5) クライアントサーバ・セット【nserv、IPv64/IPv6/IPv64m/IPv4】 以下に示すサーバが提供されており、 必要に応じて組み込むサー バを選択できる。 [1] WWW サーバ [2] TCP エコーサーバ [3] UDP エコーサーバ [4] TCP ディスカードサーバ [5] 簡易コンソール また、クライアントとしては以下の機能が提供されており、 必要に 応じて組み込むクライアントを選択できる。 [1] TCP エコークライアント [2] UDP エコークライアント [3] TCP ディスカードクライアント [4] UDP ディスカードクライアント [5] DNS リゾルバー [6] DHCPv6 クライアント [7] DHCPv4 クライアント [8] ping (6) TOPPERS ASP/JSP サンプルプログラム sample1 のネットワーク対応 プログラム【sample1n、IPv6/IPv4】 TOPPERS/ASP と TOPPERS/JSP のサンプルプログラム sample1 の ネットワーク対応プログラムである。telnet で接続すると、シリア ルの入出力を引き継いで実行する。切断すると、 元のシリアルに入 出力を戻す。 (7) 最小構成サーバ【minsv、IPv4】 WWW サーバ・タスクと TCP エコーサーバ・タスクのみからなる最 小構成のサーバである。H8/3069F が内蔵している RAM（16K バイト） と ROM（512K バイト）に収まり、外部メモリは不要である。現在は、 品川通信計装サービス製 NKEV-010H8（TOPPERS/JSP リリース 1.4.2 のみ）と秋月電子通商製 H8/3069F（TOPPERS/JSP リリース 1.4.1 以降と TOPPERS/ASP）のシステムに対応している。 2. サンプルアプリケーションの構築 TINET サンプルアプリケーションの構築は、 TOPPERS/ASP 環境と TOPPERS/JSP 環境におけるのサンプルアプリケーションの構築とほぼ同じであ る。 (1) TINET コンフィギュレーションスクリプトの実行 TINET サンプルアプリケーションの構築用ディレクトリを作成し、 TINET コンフィギュレーションスクリプトを実行する。 [1] TOPPERS/ASP 用 TINET コンフィギュレーションスクリプトの 実行 $ mkdir NETOBJ $ cd NETOBJ $ perl ../tinet/tinet_asp_configure -T akih8_3069f_gcc -A echos6 -i ether -v if_ed -n inet6 -s tcp オプション（-T、-A、-a、-U、-L、-f、-D、-l、-t、-d、 -r、 -p、 -g）は、TOPPERS/ASP コンフィギュレーションスクリプ トと同じである。 TOPPERS/ASP カーネルユーザーズマニュア ル（user.txt）の「 ５．コンフィギュレーションスクリプト の使い方 」を参照すること。その他のオプションについては、 「9.2 TINET コンフィギュレーションスクリプトのオプショ ン 」を参照すること。 アプリケーションとカーネルを別々に構築する方法につい ては、 TOPPERS/ASP 環境におけるサンプルアプリケーション の構築と同じである。 TOPPERS/ASP カーネルユーザーズマニュ アル（user.txt）の「3.5 アプリケーションとカーネルを別 々に構築する方法 」を参照すること。 [2] TOPPERS/JSP 用 TINET コンフィギュレーションスクリプトの実行 $ mkdir NETOBJ $ cd NETOBJ $ perl ../tinet/tinet_jsp_configure -C h8 -S akih8_3069f -A echos6 -i ether -v if_ed -n inet6 -s tcp オプション（-C、 -S、-T、-A、-U、-L、-D、-P、-p、-l）は、 TOPPERS/JSP コンフィギュレーションスクリプトと同じであ る。 TOPPERS/JSP カーネルユーザーズマニュアル（user.txt） の「 7.6 コンフィギュレーションスクリプトの使い方 」を 参照すること。 その他のオプションについては、「TINET コ ンフィギュレーションスクリプトのオプション 」を参照すること。 アプリケーションとカーネルを別々に構築する方法につい ては、 TOPPERS/JSP 環境におけるサンプルアプリケーション の構築と同じである。 TOPPERS/JSP カーネルユーザーズマニュ アル（user.txt）の「7.5 アプリケーションとカーネルを別 々に構築する方法 」を参照すること。 上記の例で、TOPPERS/ASP 環境と TOPPERS/JSP 環境のいずれの場 合も、ディレクトリ NETOBJ に以下のファイルが生成される。 Makefile Makefile echos6.c サンプルプログラム本体 echos6.h サンプルプログラムのヘッダファイル echos6.cfg サンプルプログラム用 ASP コンフィ ギュレーションファイル tinet_echos6.cfg サンプルプログラム用 TINET コンフィ ギュレーションファイル route_cfg.c サンプルプログラム用ルーティング表 tinet_app_config.h サンプルプログラム用コンパイル時指 定コンフィギュレーション 必要であれば、 Makefile を修正する。 修正については、 TOPPERS/ASP 環境では「7.3 アプリケーションの Makefile」、 TOPPERS/JSP 環境では「8.3 アプリケーションの Makefile」を参照 すること。 以下のサンプルアプリケーションでは、構築上の注意がある。 各 章を参照すること。 [1] 「9.3 クライアントサーバ・セット」 [2] 「9.4 TOPPERS ASP/JSP サンプルプログラム sample1 の ネットワーク対応プログラム」 [3] 「9.5 最小構成サーバ」 (2) tinet_app_config.h の設定 IPv4 の場合、 IP アドレス、サブネットマスク、ディフォルトゲー トウェイを指定する。 [1] IPV4_ADDR_LOCAL 自分の IP アドレスを指定する。ただし、 PPP を使用すると き、相手に割当ててもらう場合は 0 を指定すること。なお、 PPP は参考実装である。 [2] IPV4_ADDR_REMOTE 相手の IP アドレスを指定する。 ただし、PPP を使用すると き、相手に割当ててもらう場合は 0 を指定すること。なお、 PPP は参考実装である。 [3] IPV4_ADDR_LOCAL_MASK サブネットマスクを指定する。ただし、 ネットワークインタ フェースがイーサネットのとき有効である。 [4] IPV4_ADDR_DEFAULT_GW ディフォルトゲートウェイを指定する。ただし、 ネットワー クインタフェースがイーサネットのとき有効である。 (3) route_cfg.c の設定 ネットワークインタフェースがイーサネットの場合は、 ルーティ ング表 routing_tbl を設定する。ただし、ディフォルトゲートウェ イのみのシンプルなネットワークでは、 変更する必要はない。 (4) サンプルプログラムのコンパイル・リンク TINET サンプルアプリケーションの構築用ディレクトリで、 サン プルプログラムをコンパイル・リンクする。 コンパイル・リンクの 方法を以下に示す。 $ make depend $ make 3. TINET コンフィギュレーションスクリプトのオプション 3. 1 TOPPERS/APS 用 TINET コンフィギュレーションスクリプトのオプション TOPPERS/ASP 環境では、オプション（-T、-A、-a、-U、-L、-f、-D、-l、-d、 -r、-p、-g）は、TOPPERS/ASP コンフィギュレーションスクリプトと同じであ る。 TOPPERS/ASP 用 TINET コンフィギュレーションスクリプト特有のオプショ ンを以下に示す。 -e TINET のソースの置かれているディレクトリ -i ネットワークインタフェース（必須） には ether、ppp、loop の何れかを 指定する。 -v イーサネット・ディバイスドライバ （ネットワークインタフェースに ether を指 定した場合は必須） -n ネットワーク層プロトコル（必須） に指定できるプロトコルを以下 に示す。 inet6 IPv6 のみ inet4 IPv4 のみ inet6/inet4 IPv6/IPv4 の両方 （デュアルスタック） inet6m IPv6 のみで、 IPv4 射 影アドレス指定可能 inet6m/inet4 IPv6/IPv4 の両方と IPv4 射影アドレス指定可能 -s トランスポート層プロトコル（必須） には tcp、udp、tcp/udp の何 れかを指定する。 -t TINET テンプレートディレクトリ デフォルトは tinet/asp_sample である。 な お、 TOPPERS/ASP の同じオプションのデフォ ルトは sample である。 -m ASP テンプレートディレクトリ デフォルトは sample である。 3. 2 TOPPERS/JPS 用 TINET コンフィギュレーションスクリプトのオプション TOPPERS/JSP 環境では、オプション（-C、-S、-T、-A、-U、-L、-D、-P、-p、 -l）は、 TOPPERS/JSP コンフィギュレーションスクリプトと同じである。 TOPPERS/ASP 用 TINET コンフィギュレーションスクリプト特有のオプション を以下に示す。 -e TINET のソースの置かれているディレクトリ -i ネットワークインタフェース（必須） には ether、ppp、loop の何れかを 指定する。 -v イーサネット・ディバイスドライバ （ネットワークインタフェースに ether を指 定した場合は必須） -n ネットワーク層プロトコル（必須） に指定できるプロトコルを以下 に示す。 inet6 IPv6 のみ inet4 IPv4 のみ inet6/inet4 IPv6/IPv4 の両方 （デュアルスタック） inet6m IPv6 のみで、 IPv4 射 影アドレス指定可能 inet6m/inet4 IPv6/IPv4 の両方と IPv4 射影アドレス指定 可能 -s トランスポート層プロトコル（必須） には tcp、udp、tcp/udp の何 れかを指定する。 -d TINET テンプレートディレクトリ デフォルトは tinet/jsp_sample である。 な お、 TOPPERS/JSP の同じオプションのデフォ ルトは sample である。 -m JSP テンプレートディレクトリ デフォルトは sample である。 4. クライアントサーバ・セットの構築 以下に示すサーバが提供されており、必要に応じて組み込むサーバを選択で きる。（）内は、tinet/netapp 内にあるソースファイル名である。なお、 ディ フォルトで、 ITRON TCP/IP API 仕様の TCP と UDP の拡張機能が組込まれて いるので、「9.3.2 簡易コンソールのコマンド 」の wtw (wtw4)、wte (wte4)、 wue、wtd コマンドで、それぞれのサーバ・タスクを起動する必要がある。 [1] WWW サーバ・タスク（wwws.c） ルートページの他に、ネットワーク統計情報を表示する 2 ページか ら構成され、タスク数は最大 2 である。 [2] TCP エコーサーバ・タスク tcp_echo_srv1.c と tcp_echo_srv2.c のどちらかを選択する。 tcp_echo_srv1.c を選択した場合、省コピー API を使用して、ノン ブロッキングコールを使用しない時は、タスク数を 8 まで指定可能 である。 [3] UDP エコーサーバ・タスク（udp_echo_srv.c） [4] TCP ディスカードサーバ・タスク（tcp_discard_srv.c） [5] 簡易コンソール・タスク（dbg_cons.c） シリアルインタフェースだけでなく、telnet プロトコルを使用して、 ネットワーク経由で利用することも可能である。telnet で接続する と、シリアルの入出力を引き継いで実行する。切断すると、 元のシ リアルに入出力を戻す。 ただし、TCP のノンブロッキングコールを 組込む必要がある。 また、クライアントとしては以下の機能が提供されており、必要に応じて組み 込むクライアントを選択できる。 [1] TCP エコークライアント・タスク（tcp_echo_cli.c） [2] UDP エコークライアント・タスク（udp_echo_cli.c） [3] TCP ディスカードクライアント・タスク（tcp_discard_cli.c） [4] UDP ディスカードクライアント・タスク（udp_discard_cli.c） [5] ping（ping.c） 4. 1 Makefile の設定 (1) 組込む機能の選択 [1] TCP の受信ウィンドバッファの省コピー機能 サンプルアプリケーションで、 TCP の受信ウィンドバッファ の省コピー機能を組込む場合は、 TCP_CFG_RWBUF_CSAVE_ONLY = true または、 TCP_CFG_RWBUF_CSAVE = true を選択する。 TCP_CFG_RWBUF_CSAVE_ONLY を選択すると、TCP 通信端点を生成する静的 API である TCP_CRE_CEP で、 受信 ウィンドバッファ rbuf に、 メモリアドレスを指定しても、 プロトコルスタックは、この指定を無視して、 TCP の受信ウィ ンドバッファの省コピー機能により処理する。 また、 TCP_CFG_RWBUF_CSAVE を選択すると、TCP_CRE_CEP で、 受信 ウィンドバッファ rbuf に、 NADR（NULL）を指定したときの み、プロトコルスタックは TCP の受信ウィンドバッファの省 コピー機能により処理する。 [2] TCP の送信ウィンドバッファの省コピー機能 サンプルアプリケーションで、 TCP の送信ウィンドバッファ の省コピー機能を組込む場合は、 TCP_CFG_SWBUF_CSAVE_ONLY = true または、 TCP_CFG_SWBUF_CSAVE = true を選択する。 TCP_CFG_SWBUF_CSAVE_ONLY を選択すると、TCP 通信端点を生成する静的 API である TCP_CRE_CEP で、 送信 ウィンドバッファ rbuf に、 メモリアドレスを指定しても、 プロトコルスタックは、この指定を無視して、 TCP の送信ウィ ンドバッファの省コピー機能により処理する。 また、 TCP_CFG_SWBUF_CSAVE を選択すると、TCP_CRE_CEP で、 送信 ウィンドバッファ rbuf に、 NADR（NULL）を指定したときの み、プロトコルスタックは TCP の送信ウィンドバッファの省 コピー機能により処理する。 [3] TCP のノンブロッキングコール サンプルアプリケーションで、 TCP のノンブロッキングコー ルを組込む場合は、 TCP_CFG_NON_BLOCKING = true を選択する。 [4] UDP のノンブロッキングコール サンプルアプリケーションで、 UDP のノンブロッキングコー ルを組込む場合は、 UDP_CFG_NON_BLOCKING = true を選択する。 [5] ITRON TCP/IP API 仕様の TCP の拡張機能 サンプルアプリケーションで、 ITRON TCP/IP API 仕様の TCP の拡張機能を組込む場合は、 TCP_CFG_EXTENTIONS = true を選択する。ディフォルトで true に設定されている。 [6] ITRON TCP/IP API 仕様の UDP の拡張機能 サンプルアプリケーションで、 ITRON TCP/IP API 仕様の UDP の拡張機能を組込む場合は、 UDP_CFG_EXTENTIONS = true を選択する。ディフォルトで true に設定されている。 (2) ノンブロッキングコール、ITRON TCP/IP API 仕様の拡張機能と省コ ピー API の選択 [1] TCP のノンブロッキングコール サンプルアプリケーションで、 TCP のノンブロッキングコー ルを使用する場合は、 USE_TCP_NON_BLOCKING = true を選択する。 [2] ITRON TCP/IP API 仕様の TCP の拡張機能 サンプルアプリケーションで、 ITRON TCP/IP API 仕様の TCP の拡張機能を使用する場合は、 USE_TCP_EXTENTIONS = true を選択する。ディフォルトで true に設定されている。 [3] 省コピー API サンプルアプリケーションで、省コピー API を使用する場合は、 USE_COPYSAVE_API = true を選択する。 [4] UDP のノンブロッキングコール サンプルアプリケーションで、 UDP のノンブロッキングコー ルを使用する場合は、 USE_UDP_NON_BLOCKING = true を選択する。 ただし、 コールバックとは同時に使用できない。 [5] ITRON TCP/IP API 仕様の UDP の拡張機能 サンプルアプリケーションで、 ITRON TCP/IP API 仕様の UDP の拡張機能を使用する場合は、 USE_UDP_EXTENTIONS = true を選択する。ディフォルトで true に設定されている。 [6] UDP のコールバック サンプルアプリケーションで、 UDP のコールバックを使用 する場合は、 USE_UDP_CALL_BACK = true を選択する。ただし、 ノンブロッキングコールとは同時に使 用できない。 (3) 共通サーバプログラムの選択 [1] WWW サーバプログラムを使用する場合は、 以下の行を有効にする。 USE_WWW_SRV = ture [2] WWW サーバプログラム（IPv4 優先接続待ち）を使用する場合 は、以下の行を有効にする。 USE_WWW4_SRV = ture [3] UDP エコーサーバプログラムを使用する場合は、 以下の行を 有効にする。 USE_UDP_ECHO_SRV = ture [4] UDP エコーサーバプログラム（IPv4 優先接続待ち）を使用す る場合は、以下の行を有効にする。 USE_UDP4_ECHO_SRV = ture [5] TCP ディスカードサーバプログラムを使用する場合は、 以下 の行を有効にする。 USE_TCP_DISCARD_SRV = ture [6] 送受信タスク同一型の TCP エコーサーバプログラムを使用す る場合は、以下の行を有効にする。 TCP_ECHO_SRV = tcp_echo_srv1 [7] 送受信タスク分離型の TCP エコーサーバプログラムを使用す る場合は、以下の行を有効にする。 TCP_ECHO_SRV = tcp_echo_srv2 [8] TCP エコーサーバプログラム（IPv4 優先接続待ち）を使用す る場合は、以下の行を有効にする。ただし、 送受信タスク同 一型の TCP エコーサーバプログラムを使用する場合のみ有効 である。 USE_TCP4_ECHO_SRV = ture [9] シリアル経由のみコンソール入出力を使用する場合は、 以下 の行を有効にする。 USE_DBG_CONS = true [10] シリアルとネットワーク経由のコンソール入出力を使用する 場合は、以下の行を有効にする。 USE_NET_CONS = true ただし、 ノンブロッキングコールを組込んだ時のみ有効である。 (4) 共通クライアントプログラムの選択 [1] TCP エコークライアントプログラムを使用する場合は、 以下 の行を有効にする。 USE_TCP_ECHO_CLI = ture [2] TCP エコークライアントプログラムで、IPv4 アドレスを指定 した時、tcp_con_cep を呼出し、IPv4 により接続する場合は 以下の行を有効にする。 なお、 ネットワーク層の選択で、 IPv6 と IPv4 の両方を指定した場合、この指定を行わないと tcp_con_cep ではなく、 tcp6_con_cep を呼出す。 従って、 API_CFG_IP4MAPPED_ADDR を指定していないと、E_PAR が返さ れるが、tcp6_con_cep のテストのためであり、問題はない。 USE_TCP4_ECHO_CLI = ture [3] UDP エコークライアントプログラムを使用する場合は、 以下 の行を有効にする。 USE_UDP_ECHO_CLI = ture [4] UDP エコークライアントプログラム（IPv4 優先接続待ち）を 使用する場合は、 以下の行を有効にする。 USE_UDP4_ECHO_CLI = ture [5] TCP ディスカードクライアントプログラムを使用する場合は、 以下の行を有効にする。 USE_TCP_DISCARD_CLI = ture [6] UDP ディスカードクライアントプログラムを使用する場合は、 以下の行を有効にする。 USE_UDP_DISCARD_CLI = ture [7] DHCPv6 クライアントプログラムを使用する場合は、以下の行 を有効にする。 USE_DHCP6_CLI = true [8] DHCPv4 クライアントプログラムを使用する場合は、以下の行 を有効にする。 USE_DHCP4_CLI = true [9] DNS リゾルバーを使用する場合は、以下の行を有効にする。 USE_RESOLVER = true [10] PING クライアントプログラムを使用する場合は、以下の行を 有効にする。 USE_PING = true (5) 共通サーバタスク数の選択 [1] WWW サーバタスク数は以下の行で選択する。ただし最大 2 タ スクである。 CDEFS := $(CDEFS) -DNUM_WWW_SRV_TASKS=2 [2] TCP ECHO サーバタスク数を選択する。ただし以下の条件のと き有効である。 ・tcp_echo_srv1.c を選択した。 ・省コピー API を使用する。 ・ノンブロッキングコールを使用しない。 TCP ECHO サーバタスク数は以下の行で選択する。ただし最大 8 タスクである。 CDEFS := $(CDEFS) -DNUM_TCP_ECHO_SRV_TASKS=8 (6) 予約 ID 数の選択 [1] TCP/IPv4 受付口予約 ID 数は以下の行で選択する。ただし最 大 2 である。 CDEFS := $(CDEFS) -DNUM_VRID_TCP_REPS=2 [2] TCP/IPv4 通信端点予約 ID 数は以下の行で選択する。ただし 最大 4 である。 CDEFS := $(CDEFS) -DNUM_VRID_TCP_CEPS=4 [3] UDP/IPv4 通信端点予約 ID 数は以下の行で選択する。ただし 最大 2 である。 CDEFS := $(CDEFS) -DNUM_VRID_UDP_CEPS=2 [4] TCP/IPv6 受付口予約 ID 数は以下の行で選択する。ただし最 大 2 である。 CDEFS := $(CDEFS) -DNUM_VRID_TCP6_REPS=2 [5] TCP/IPv6 通信端点予約 ID 数は以下の行で選択する。ただし 最大 4 である。 CDEFS := $(CDEFS) -DNUM_VRID_TCP6_CEPS=4 [6] UDP/IPv6 通信端点予約 ID 数は以下の行で選択する。ただし 最大 2 である。 CDEFS := $(CDEFS) -DNUM_VRID_UDP6_CEPS=2 (7) その他 [1] TCP のセグメントサイズを MSS にする場合は、以下の行を有 効にする。 CDEFS := $(CDEFS) -DUSE_TCP_MSS_SEG [2] IPv6 MMTU サイズのネットワークバッファを組込む場合は、 以下の行を有効にする。 CDEFS := $(CDEFS) -DUSE_IPV6_MMTU 4. 2 サンプルアプリケーションのコンパイル時コンフィギュレーション (1) DHCPv6 クライアント [1] DHCP6_CLI_CFG_MODE DHCPv6 クライアントの動作モードを指定する。 ステートレスモードを選択する時は fDHCP6_CLI_CFG_STATELESS、 ステートフルモードを選択する 時は fDHCP6_CLI_CFG_STATEFULL を指定する。 ステートレス モードでは、IPv6 アドレスを取得せず、DNS サーバの情報な どのみ取得する。 [2] DHCP6_CLI_CFG_REQUIRED_OLIST DHCPv6 サーバから取得する必須オプションリストを配列の初 期化形式で指定する。指定例を以下に示す。 #define DHCP6_CLI_CFG_REQUIRED_OLIST { \ DHCP6_OPT_NAME_SERVERS, \ } オプションは tinet/netapp/dhcp6.h を参照すること。 [3] DHCP6_CLI_CFG_REQUEST_OLIST DHCPv6 サーバから取得する必須オプションリストを配列の初 期化形式で指定する。 指定例を以下に示す。 #define DHCP6_CLI_CFG_REQUEST_OLIST { \ DHCP6_OPT_DOMAIN_SEARCH, \ } オプションは tinet/netapp/dhcp6.h を参照すること。 (2) DHCPv4 クライアント [1] DHCP4_CLI_CFG_REQUIRED_OLIST DHCPv4 サーバから取得する必須オプションリストを配列の初 期化形式で指定する。指定例を以下に示す。 #define DHCP4_CLI_CFG_REQUIRED_OLIST { \ DHCP4_OPT_NAME_SERVERS, \ } オプションは tinet/netapp/dhcp4.h を参照すること。 [2] DHCP4_CLI_CFG_REQUEST_OLIST DHCPv4 サーバから取得する必須オプションリストを配列の初 期化形式で指定する。 指定例を以下に示す。 #define DHCP4_CLI_CFG_REQUEST_OLIST { \ DHCP4_OPT_DOMAIN_SEARCH, \ } オプションは tinet/netapp/dhcp6.h を参照すること。 (3) DNS リゾルバー [1] RSLV_CFG_DNS_DOMAIN_NAME_STR ドメイン名の文字列を指定する。DHCPv6 クライアント、また は DHCPv4 クライアントにより取得することも可能である。 [2] IPV6_ADDR_DNS_INIT DNS サーバの IPv6 アドレスを配列の初期化形式で指定する。 DHCPv6 クライアントにより取得することも可能である。 DNS サーバの IPv6 アドレスが、 fd90:cce5:25f6:ff81:201:2ff:fe81:e7c9 の場合の指定例を 以下に示す。 #define IPV6_ADDR_DNS_INIT \ {{{ UINT_C(0xfd), UINT_C(0x90), UINT_C(0xcc), UINT_C(0xe5), \ UINT_C(0x25), UINT_C(0xf6), UINT_C(0xff), UINT_C(0x81), \ UINT_C(0x02), UINT_C(0x01), UINT_C(0x02), UINT_C(0xff), \ UINT_C(0xfe), UINT_C(0x81), UINT_C(0xe7), UINT_C(0xc9) }}} [3] IPV4_ADDR_DNS DNS サーバの IPv4 アドレスを指定する。DHCPv4 クライアン トにより取得することも可能である。 DNS サーバの IPv4 ア ドレスが、172.25.129.140 の場合の指定例を以下に示す。 #define IPV4_ADDR_DNS MAKE_IPV4_ADDR(172,25,129,140) 4. 3 簡易コンソールコマンド インターネットサーバ・セットに組み込まれている簡易コンソールのコマン ドを以下に示す。 cf tinet_app_config.h 等で指定された、コンパイル時 コンフィギュレーションを表示する。 ct [] ペンディングしている TCP 通信端点 の処 理をキャンセルする。キャンセルする処理は で指定する。 を省略した場合は、全ての処理 をキャンセルする。 cu [] ペンディングしている UDP 通信端点 の処 理をキャンセルする。キャンセルする処理は で指定する。 を省略した場合は、全ての処理 をキャンセルする。 dc ネットワークインタフェースが PPP の時、または、 シリアルとネットワーク経由のコンソール入出力を 使用する時に有効であり、 接続を切断する。なお、 PPP は参考実装である。 dh DHCPv6 と DHCPv4 クライアントの情報を出力する。 dh6 DHCPv6 クライアントの情報を出力する。 dh6n IPv6 アドレス情報を解放して、 DHCPv6 サーバから IPv6 アドレス情報を再取得する。 dh6r IPv6 アドレス情報を解放する。 dh4 DHCPv4 クライアントの情報を出力する。 dh4n IPv4 アドレス情報を解放して、 DHCPv4 サーバから IPv4 アドレス情報を再取得する。 dh4r IPv4 アドレス情報を解放する。 dt [ []] TCP ディスカードクライアント・タスクを起動し、 ディスカードサーバ にディスカードパター ンを送信する。 は、ディスカードサーバの ポート番号で、省略時（- を指定する）は 9 である。 は、繰り返し回数で、省略時は 1 である。 dts TCP ディスカードクライアント・タスクの繰り返し 動作を停止する。 du []] ディスカードサーバ にディスカードパター UDP ディスカードクライアント・タスクを起動し、 ンを繰り返し送信する。 は、ディスカード サーバのポート番号で、省略時は 9 である。 dus UDP ディスカードクライアント・タスクの繰り返し 動作を停止する。 et [ []] et4 [ []] et では TCP エコークライアント・タスクを起動す る。et4 では IPv4 専用 TCP エコークライアント・ タスクを起動する。 何れも、 エコーサーバ にエコーパターンを送信する。 は、エコー サーバのポート番号で、 省略時（- を指定する）は 7 である。 は、繰り返し回数で、省略時は 1 である。 ets TCP エコークライアント・タスクの繰り返し動作を 停止する。 ets4 IPv4 専用 TCP エコークライアント・タスクの繰り 返し動作を停止する。 eu [] [ | ] eu4 [] [ | ] eu では UDP エコークライアント・タスクを起動す る。eu4 では IPv4 専用 UDP エコークライアント・ タスクを起動する。 何れも、 エコーサーバ にエコーパターンを送信する。 は、エコー サーバのポート番号で、 省略時（- を指定する）は 7 である。（数字）を指定した場合は、 定 型のメッセージを 回繰り返し送信する。 （数字以外）を指定した場合は、 メッセージ を送信する。 eus UDP エコークライアント・タスクの繰り返し動作を 停止する。 eus4 IPv4 専用 UDP エコークライアント・タスクの繰り 返し動作を停止する。 i ネットワークインタフェースが PPP の時に有効であ る。直接接続の場合は、直ちに LCP を起動して、サー バに接続する。モデム接続の場合は、 コンパイル時 コンフィギュレーションの MODEM_CFG_PHONE_NUMBER パラメータで指定されているサーバに発呼する。 な お、PPP は参考実装である。 if [ ] ネットワークインタフェースが PPP の時は、 IP ア ドレス、 サブネットマスク、ブロードキャストアド レスを出力する。 ネットワークインタフェースがイー サネットで、 ネットワーク層が IPv4 の時は、 [ ] を指定できる。 [ ] を指定しなければ、MAC アドレス、IPv4 アドレス、 サブネットマスク、 ブロードキャストアドレスの出 力のみ行う。 [ ] を指定した時は、 IPv4 アドレスとサブネットマスクを変更した後、 MAC アドレス、IPv4 アドレス、サブネットマスク、 ブロードキャストアドレスを出力する。 は、 IPv4 アドレス、 は、サブネットマスクであ る。なお、PPP は参考実装である。 na ネットワークインタフェースがイーサネットの時に 有効である。IPv6 では近隣アドレスキャッシュの状 態、IPv4 では ARP キャッシュを出力する。 nb ネットワークバッファの統計情報を出力する。 nc ネットワーク統計情報を表示する。 nr [ ] ネットワークインタフェースがイーサネットのとき 有効である。 ネットワーク層が IPv4 の時は、 [ ] を指定でき る。 [ ] を指定 しなければ、 ルーティング表の出力のみ行う。 [ ] を指定した 時は、 ルーティング表を変更した後、ルーティング 表を出力する。 は、 経路エントリのインデッ クス、 は、目標ネットワークの IP アドレ ス、 は、目標ネットワークのサブネットマス ク、 は、ゲートウェイの IP アドレスである。 nrl ネットワークインタフェースがイーサネットで、 ネッ トワーク層が IPv6 の時に有効である。 ディフォル トルータ・リストを出力する。 nrp ネットワークインタフェースがイーサネットで、 ネッ トワーク層が IPv6 の時に有効である。 プレフィッ クスリストを出力する。 ns [|] DNS サーバに正引きでホスト名 、または、逆 引きで IP アドレス のアドレス情報を照会 し出力する。いずれも指定しない時は、 ドメイン名 と DNS サーバの IP アドレスを出力する。 nt TCP 通信端点と TCP 受付口の状態を表示する。 nu UDP 通信端点の状態を表示する。 p [ [] ] ホスト に ICMP パケットを送信する。 はタイムアウト値（単位は秒）で、 省略時（- を指 定する）は 3 秒である。 はデータサイズで、 指定しない場合は 64 オクテットである。 ps タスクの状態を表示する。 r タスク の待ち状態を強制的に解除する。 tt ITRON TCP/IP API の TCP の拡張機能を組込む必要 がある。TCP 受付口 を削除し、対応するサー バを停止する。 tu ITRON TCP/IP API の UDP の拡張機能を組込む必要 がある。UDP 通信端点 を削除し、対応する サーバを停止する。 w タスク を起床する。 wtd ITRON TCP/IP API の TCP の拡張機能を組込む必要 がある。TCP ディスカードサーバ・タスクに TCP 受 付口と TCP 通信端点を割当て、TCP ディスカードサー バ・タスクを起動する。 wte ITRON TCP/IP API の TCP の拡張機能を組込む必要 がある。TCP エコーサーバ・タスクに TCP 受付口と TCP 通信端点を割当て、 TCP エコーサーバ・タスク を起動する。 wte4 ITRON TCP/IP API の TCP の拡張機能を組込む必要 がある。 TCP エコーサーバ・タスクに IPv4 用 TCP 受付口と IPv4 用 TCP 通信端点を割当て、TCP エコー サーバ・タスクを起動する。 wtw4 ITRON TCP/IP API の TCP の拡張機能を組込む必要 がある。WWW サーバ・タスクに IPv4 用 TCP 受付口 と IPv4 用 TCP 通信端点を割当て、WWW サーバ・タ スクを起動する。 wtw ITRON TCP/IP API の TCP の拡張機能を組込む必要 がある。 WWW サーバ・タスクに TCP 受付口と TCP 通信端点を割当て、WWW サーバ・タスクを起動する。 wue ITRON UDP/IP API の UDP の拡張機能を組込む必要 がある。UDP エコーサーバ・タスクに UDP 通信端点 を割当て、UDP エコーサーバ・タスクを起動する。 4. 4 DNSリゾルバーによるホスト名の指定 Makefile の組み込む機能の選択で、 USE_RESOLVER = true を指定して DNS リゾルバーを使用すると、簡易コンソールコマンドの に指定したホスト名を、DNS サーバに照会して IP アドレスを得ることができ る（正引き）。 の書式を以下に示す。 [-[6|4][A|a|Q|q]] 各オプションを以下に示す。 6 ネットワーク層のプロトコルとして IPv6 により DNS サーバに照 会する。 4 ネットワーク層のプロトコルとして IPv4 により DNS サーバに照 会する。 q AAAA レコードのみ照会する。 Q AAAA レコードのみ照会する。 a A レコードのみ照会する。 A A レコードのみ照会する。 6 と 4 のどちらも指定しない時は、まず IPv6 で DNS サーバに照会するが、 応答がない場合は IPv4 にフォールバックして DNS サーバに照会する。 ただ し、ネットワーク層としてどちらか一方のみ組込んだ場合は、このオプション は無視される。 q、 Q、a、A のいずれも指定しない時は、AAAA レコードの次に A レコード の順で DNS サーバに照会する。 5. sample1 のネットワーク対応プログラム（sample1n）の構築 TOPPERS/ASP と TOPPERS/JSP のサンプルプログラム sample1 のネットワー ク対応プログラムである。telnet で接続すると、 シリアルの入出力を引き継 いで実行する。 切断すると、 元のシリアルに入出力を戻す。 以下に構築方法を述べる。 (1) ASP/JSP コンフィギュレーションスクリプトの実行 それぞれの環境におけるコンフィギュレーションスクリプトを実 行する。以下は、 TOPPERS/ASP 環境におけるコンフィギュレーショ ンスクリプトの実行例である。 $ mkdir NETOBJ $ cd NETOBJ $ perl ../configure -T akih8_3069f_gcc (2) TINET コンフィギュレーションスクリプトの実行 それぞれの環境における TINET コンフィギュレーションスクリプ トを実行する。 この時、 アプリケーションプログラム名として sample1n を指定する。 以下は、 TOPPERS/ASP 環境における TINET コンフィギュレーションスクリプトの実行例である。 $ perl ../tinet/tinet_asp_configure -T akih8_3069f_gcc -A sample1n -i ether -v if_ed -n inet6 -s tcp なお、オプション -n に inet6/inet4 を指定しても、 IPv6 でのみ 接続できる。 (3) Makefile の修正 アプリケーション本体（sample1n.c）と TOPPERS/ASP と TOPPERS/JSP の sample1.c を一緒にコンパイル・リンクするため、 Makefile を修正する。 [1] TOPPERS/ASP 環境 Makefile の APPL_COBJS に sample1.o を追加する。 APPL_COBJS = $(APPLNAME).o sample1.o [2] TOPPERS/JSP 環境 Makefile の UTASK_COBJS に sample1.o を追加する。 UTASK_COBJS = $(UNAME).o sample1.o (4) sample1.c の修正 TOPPERS/ASP と TOPPERS/JSP の sample1.c のインクルードファ イルの指定 #include "sample1.h" の前に、 以下のインクルードファイルを追加する。 #include "sample1n.h" (5) tinet_app_config.h の設定 IPv4 の場合、IP アドレス、サブネットマスク、 ディフォルトゲー トウェイを指定する。 6. 最小構成サーバの構築 WWW サーバ・タスクと TCP エコーサーバ・タスクのみからなる最小構成の サーバである。H8/3069F が内蔵している RAM（16K バイト）と ROM（512K バ イト）に収まり、外部メモリは不要である。現在は、品川通信計装サービス製 NKEV-010H8（TOPPERS/JSP リリース 1.4.2 のみ）と秋月電子通商製 H8/3069F （TOPPERS/JSP リリース 1.4.1 以降と TOPPERS/ASP）のシステムに対応して いる。 各システム依存部の Makefile.config の「実行環境の定義」で、 # ROM化 外部RAM未使用 #DBGENV := INMEM_ONLY を有効にして、 コンパイル・リンクする。