外部メモリの利用

$Date: 2025/07/18 15:32:42 $

• 概要
• 対応機種と利用できる外部メモリ
• 注意事項
• 基本操作
• ファイルの自動検索
• ファイルアクセスの高速化
• コマンド仕様
• 動作表
  • 外部メモリボタンおよびDOWNLOADボタンの動作
  • アラームの鳴動パターン
  • 外部メモリLEDの点灯パターン
  • SYSLOGメッセージ

概要

ルーターに外部メモリ(microSDメモリカード、USBメモリ)を接続して利用する機能には、以下の機能があります。

• ファイルコピー機能
  ルーター内部の設定内容やsyslogを外部メモリにファイルとして出力したり、外部メモリにある情報をルーター内部にコピーします。
  外部メモリからのコピーはボタン操作で行えますので、機器設置導入の作業を簡素化できます。
  
  
• 起動機能
  設定内容ファイルやファームウェアファイルを入れた外部メモリをルーターに接続して電源を入れるだけで、それらの設定内容やファームウェアでルーターを動作させることができます。
  機器設置導入や障害時の復旧作業を大幅に簡素化できます。Rev.10.01系以降のファームウェアで利用できます。
  
  
• バッチファイル実行機能
  コマンドが記述されたバッチファイルで、ボタン操作などによりルーターに任意のタイミングでコマンドを実行することができます。
  コマンド実行の結果も外部メモリに出力されます。
  動作検証の作業を簡単に行うことができます。Rev.10.01系以降のファームウェアで利用できます。
  
  
• リダイレクト機能
  内部情報を出力させるコマンドを実行する際に、出力先をコンソール画面でなく外部メモリを指定することができます。
  メンテナンス時などに内部情報を簡単に保存できます。Rev.10.01系以降のファームウェアで利用できます。
  
  

機能の詳細については各機能の説明資料をご参照ください。
外部メモリの基本的な取り扱いとLEDやブザーの仕様、SYSLOGメッセージなどについて本文書で説明します。

FUNCボタンが搭載された機種を使用する場合は、DOWNLOADボタンをFUNCボタンに読み替えてください。

対応機種と利用できる外部メモリ

利用できる外部メモリは機種によって異なります。

注意事項

• 対応しているファイルフォーマットは以下の通りです。
  • FAT
  • FAT32
    
• 全ての外部メモリの動作を保証するものではありません(動作確認済みUSBメモリ情報)。
• HUB接続等により複数の外部メモリを同時に使用することはできません。
• 外部メモリポート付近にある外部メモリボタンが操作できない形状の外部メモリについては動作保証外です。このような場合、別途延長ケーブル、アダプタ等を使用してください。
• 外部メモリの抜き差しは、必ず基本操作で説明する手順に従ってください。外部メモリ内部のデータが破壊される恐れがあります。
• 本機能関連コマンドで外部メモリ内のファイルを指定する際は、ファイル名として以下の半角文字を使用することができます。
  • 英数字
  • アンダーバー'_'
  • ピリオド'.'
  ただし、大文字／小文字は区別しません。また、ピリオドで終了する名前は指定できません。

また特に、USBメモリに関しては以下の注意点があります。

• 本機能はUSB1.1/2.0に対応しています。ただし、以下の仕様を満たしている必要があります。
  • USBホストコントローラとしてOHCI(USB1.1)、またはEHCI(USB2.0)に対応していること
  • USB Mass Storage Classドライバに対応していること
  • 消費電流が250mA以下のバスパワー供給のみで動作するフラッシュメモリであること
• ルーターに接続したUSBメモリが許容範囲外の電流を消費すると、アラームが4回鳴り、同時にUSB LEDが点滅し続ける状態(USBデバイスエラー状態)となります。このエラー状態のままでは、ルーターに他のUSBメモリを接続し直しても認識はされません。このような状態から本機能を復旧させるには以下の手順を実行します。
  1. ルーターにUSBメモリが接続されている状態ならば、USBメモリを抜く。
  2. 以下のいずれかを行う。
     • USBボタンを押す。
     • usbhost useコマンドをonに再設定する。
       ※offに設定してもエラー状態からの復旧はできます

基本操作

外部メモリを接続する

ルーター側でusbhost useコマンド(USBメモリを使う場合)あるいはsd useコマンド(microSDメモリカードを使う場合)がonになっていることを確認してください（工場出荷状態ではon）。offの場合、外部メモリを接続してもルーター側で認識されません。

• 例：USBメモリを使用するために機能を有効にする

  # usbhost use on
  

外部メモリをルーターに接続します。
アラームが鳴ると同時に外部メモリLEDが点灯して、ルーターで外部メモリが認識できたことを示します。この状態で、各種外部メモリを使う機能を利用することができます。

外部メモリが壊れていて正常に認識できない場合は、アラームは鳴らず、また外部メモリLEDも点灯しません。そのときは外部メモリを抜き、他の正常な外部メモリを使用してください。

アラームが4回鳴りLEDが点滅する場合は、許容範囲外の電流を消費するなどのエラーを検出したことを示します。この場合の復旧手順は注意事項をご参照ください。

外部メモリを抜く

ルーターから外部メモリを抜く前に、外部メモリボタンを2秒間押し続けてください。
外部メモリを安全に抜くための処理がルーター側で行われます。アラームが鳴り、外部メモリLEDが消灯した事を確認したら外部メモリを静かに抜いてください。

外部メモリLEDが点灯している間は決して外部メモリを抜かないでください。

ファイルの自動検索

Rev.10.01系以降のファームウェアでは、外部メモリのディレクトリ下にあるファイルを自動検索することができます。
Rev.9.01系やRev.10.00系のファームウェアでは、ルートディレクトリにあるファイルだけが対象になります。

自動検索の設定

自動検索機能は以下の場合に機能します。

• 外部メモリを接続した状態で起動した時の起動ファイル検索
• 外部メモリボタンとDOWNLOADボタンを同時に3秒以上押してコピーする時のコピー元ファイル検索
• copy execコマンド、copy configコマンドのコピー元ファイル検索
• execute batchコマンド実行時のバッチファイル検索
• DOWNLOADボタンによるバッチファイル実行機能時のバッチファイル検索

ファイルコピー機能や起動機能で利用する場合は、external-memory exec filenameコマンドやexternal-memory config filenameコマンドでファイル名のみを指定します。
バッチファイル実行機能で利用する場合は、external-memory batch filenameコマンドのファイル名設定でファイル名のみを指定します。
これらのコマンドはいずれもデフォルトでファイル名のみが指定されており、自動検索を行うことになります。

copyコマンド実行時には、コピー元ファイル名として外部メモリのファイル名のみを指定した場合に、外部メモリ内にあるファイルを自動検索します。

ファイルを絶対パス('/'で始まる指定)で直接指定すると、自動検索は行われず、指定した位置にあるファイルのみを対象とします。

以下に、external-memory exec filenameコマンドを例にして、指定方法による動作の違いを示します。

• 例1：ファイル名のみを指定する場合

      # external-memory exec filename sd1:rtx1200.bin
      microSDメモリカード内を検索して"rtx1200.bin"を探します
  

• 例2：絶対パスを使ってファイルを指定する場合

      # external-memory exec filename sd1:/rtx1200.bin
      microSDメモリカード内のルートディレクトリから"rtx1200.bin"を探します
  
      # external-memory exec filename sd1:/dir1/rtx1200.bin
      microSDメモリカード内の"dir1"というディレクトリから"rtx1200.bin"を探します
  

• 例3：不要なファイルを検索しない場合

      # external-memory exec filename off
      ファームウェアファイルを検索しません
  

• 例4：エラーとなる設定

      # external-memory exec filename sd1:dir1/rtx1200.bin
      パス指定する場合は絶対パスとなるので先頭にルートディレクトリを示す(/)が必要です。
      この設定の場合、"dir1/rtx1200.bin"がファイル名とみなされ、ファイル名に使用できない文字(/)
      があると判断しエラーとなります。
  

外部メモリに格納されているファイルやディレクトリの数、構成によっては、ファイルの自動検索に長い時間を要する場合があります。
検索時間を短くするためには、階層の深いディレクトリの作成は避けてルートに近い位置にファイルを格納したり、ファイルを絶対パス('/'で始まる指定)で直接指定してください。
検索対象ファイルが存在しない場合にも全ディレクトリを検索して時間がかかることになりますので、検索の不要なファイルはファイル名を指定する上記コマンドでoffを設定しておくとよいでしょう。

自動検索のルール

検索は以下のルールに従って行います。

• 外部メモリに"*:"を指定している時は、最初にmicroSDメモリカード、次にUSBメモリの順で検索します。
  その場合、microSDメモリカードに対象ファイルが見つかるとUSBメモリの検索はしません。
• ルートディレクトリに対象ファイルが存在する場合には、そのファイルを選択します。
• ルートディレクトリより下層のディレクトリを検索します。
  最大16階層下のディレクトリまでが検索対象になります。
• ルートディレクトリに最も近いディレクトリ階層にある対象ファイルを選択します。
• 階層数が同一のディレクトリにあるファイルは、文字コードの小さいディレクトリ階層にある対象ファイルを選択します。
  ディレクトリの検索順は、GUI画面で表示されるファイルの一覧表示(「保守」の「設定ファイルのコピー」の設定画面の「参照」など)の順に従います。
• 自動検索が制限時間に達すると自動検索を終了し、それまでのファイルは見つからなかったものとして扱います。
• 指定したファイルが片方しか存在しない場合は、存在するファイルのみを対象とします。
• オペレーティングシステム管理用ディレクトリ (Recycled, System Volume Information など) は検索対象外になります。

自動検索のキャンセル

検索に時間がかかる場合は、以下の設定、操作により検索を中止させることができます。

• 検索開始からexternal-memory auto-search timeコマンドで設定された時間(初期値は300秒)が経過すると、タイムアウトとして検索を終了します
• copy execコマンド、copy configコマンド、execute batchコマンド実行時は、ファイル検索中に Ctrl＋C を押すことで、検索を中止させることができます
• 外部メモリボタン＋DOWNLOADボタンを押してファイルコピーをする場合、ファイル検索中にDOWNLOADボタンを1秒間押すことで、検索を中止させることができます
• DOWNLOADボタンを押してバッチファイルを実行する場合、ファイル検索中にDOWNLOADボタンを1秒間押すことで、検索を中止させることができます
• DOWNLOADボタンを１秒押して検索を中止した場合は、検索中止を知らせるブザーがなったらボタンを離して下さい。DOWNLOADボタンを3秒間以上押すとDOWNLOADボタン機能が実行されます。外部メモリボタンおよびDOWNLOADボタンの動作もあわせて参照して下さい。
  
• 検索を中止する方法と、中止したときの動作は以下になります。
  なお、ファイル検索中に外部メモリボタンを2秒間押すことで、ボタンを押した外部メモリは未接続状態(DETACH)状態となります。
  

  操作	タイムアウト	DOWNLOADボタン1秒押し	Ctrl＋C
  外部メモリから起動	全ての外部メモリはDETACH	―	―
  copy execコマンド copy configコマンド	検索中止	―	検索中止
  外部メモリボタン ＋ DOWNLOADボタン (ファイルコピー)	検索中止 "ププププ"とブザーが鳴る	検索中止 "ププププ"とブザーが鳴る	―
  execute batchコマンド	検索中止	―	検索中止
  DOWNLOADボタン (バッチファイルの実行)	検索中止 "ププププ"とブザーが鳴る	検索中止 "ププププ"とブザーが鳴る	―

ファイルアクセスの高速化

まず、本機能を使用するには、external-memory accelerator cache size コマンドで、ファイルアクセス高速化機構を有効にしてください（初期値は有効)。off 以外の設定で、ファイルアクセス高速化機構が有効になります。

例）usb1 インタフェースに接続される外部メモリへのファイルアクセスに使用するキャッシュメモリのサイズを "1" に設定する。
   # external-memory accelerator cache size usb1 1

• 高速化機構が有効の設定になっていること（初期値は有効)
• 対象となるファイルまたはディレクトリが格納される当該ディレクトリ内のファイルおよびディレクトリの総数が100個以上であること
• 対象となるファイルまたはディレクトリの管理情報がキャッシュされていること

上記で説明した通り、高速アクセスが適用されるためには、対象となるファイルまたはディレクトリの管理情報がキャッシュされている必要があります。これらは通常、外部メモリが接続されたときにキャッシュされます。また、ファイルやディレクトリを作成したときにディレクトリ内の総数が 100個以上になったときにもキャッシュされます。逆にファイルやディレクトリを削除したときに総数が 100個未満になったときにはキャッシュがクリアされます。アクセス性能が向上しない場合は、キャッシュメモリが不足し、対象となるファイルまたはディレクトリの管理情報がキャッシュされていない可能性がありますので、external-memory accelerator cache size コマンドで使用するキャッシュメモリのサイズを大きくしてください。ただし、サイズを大きくすると、外部メモリ内のディレクトリ・ファイル構成によっては、外部メモリを接続してから使用可能になるまでの時間が長くなることがあります。
詳しくは、external-memory accelerator cache size コマンド の説明をご参照ください。

※注意事項

• 本機能は、外部メモリ内のすべてのファイルやディレクトリに対するアクセス性能を改善するものではありません。
• 外部メモリ内に適用条件に記述されるディレクトリが全く存在しない場合には、従来と同じ動作（高速化機構無効）となります。
• 外部メモリ内に適用条件に記述されるディレクトリが多数存在する場合には、管理情報のキャッシュ生成に時間がかかる場合があります。
• 外部メモリ内のディレクトリ・ファイル構成によっては、キャッシュメモリのサイズを最大値に設定してもキャッシュメモリの不足により、通常アクセス（従来と同じ動作）となることがあります。このような場合には、外部メモリ内のファイルやディレクトリ数を削除して調整する必要があります。
• 外部メモリの用途として設定ファイルのコピーやログの保存などを行う場合、使用する外部メモリ内に大量のディレクトリやファイルが存在しても、操作の対象となるディレクトリ内のファイル数を少なくしておくことで、高速化機構を無効(off) にした状態でも使用することができます。

コマンド仕様

動作表

外部メモリボタンおよびDOWNLOADボタンの動作

外部メモリボタンおよびDOWNLOADボタンの各押下時間の組み合わせによる動作の一覧を以下に示します。

※1. ボタン実行による自動検索中の場合は、自動検索中断
※2. 過電流によるUSBデバイスエラー状態の場合は、ボタンを押して離した時点でエラー状態解除
※3. 過電流によるUSBデバイスエラー状態の場合は動作しない
※4. DOWNLOADボタン機能はHTTPリビジョンアップである。
Rev.10.01系以降ではDOWNLOADボタン押下時の動作をoperation button function download コマンドによって変更できる。詳細はバッチファイル実行機能の資料を参照のこと。

アラームの鳴動パターン

各状況におけるアラーム鳴動パターンの一覧を以下に示します。なお、以下に挙げるアラームはalarm usbhostコマンド及びalarm sdコマンドで鳴らす／鳴らさないを制御することができます。

外部メモリLEDの点灯パターン

外部メモリを利用する機能に関する外部メモリLEDの点灯（消灯）パターンの一覧を以下に示します。

※1. ルーター本体のLEDが左から右へ流れるように順次点灯。これを内蔵フラッシュROMへの書き込みが終了するまで繰り返す。

SYSLOGメッセージ

外部メモリを利用する機能において出力されるSYSLOGメッセージについて、例を以下に示します。実際に出力される各メッセージの先頭には"[SD]"や"[USB_HOST]"というプレフィックスが付与されます。
外部メモリ起動機能に関わるログには"[EXTMEMBOOT]"というプレフィックスが付与されます。