SharpKey Multi-HID Interface ユーザーマニュアル

SharpKeyとは

SharpKeyという名称はSharpコンピュータのKeyボードインターフェースに由来しており、オリジナルのmz25key Sharp MZ-2500/MZ-2800 PS/2キーボードインターフェースをベースにしています。
SharpKey Multi-HIDインターフェースは、PS/2またはBluetoothを介してキーボードやマウスをヴィンテージのSharpおよびNECコンピュータに接続できるデバイスです。ホストコンソールの色に合わせた小型のKM-24ブラックまたはライトグレーケースに収められており、追加スペースを最小限に抑えます。2つの外部ポートを持ち、一方はPS/2キーボードまたはマウス用、もう一方はホストのキーボードまたはマウス入力ソケットに接続するためのケーブル用です。Bluetoothを使用する場合はPS/2ポートは使用されず、ホストポートからのホストケーブルのみが必要です。
使用時、SharpKeyはホストから電力を得るため、ホストコンピュータの電源への追加負荷は僅かです。インターフェースモードでのアクティブ時には通常30mAを消費し、IoT Webインターフェースが有効な場合は150mAに上昇します。WiFiの起動時のピーク瞬間電流は250mAになる場合があります。
このセクションでは、SharpKeyのポート、インターフェース、ボタン、LEDについて説明します。

ポート

SharpKeyには2つのミニDINメスポート、LED、オンボードWiFi IoT Webインターフェースの有効化とBluetoothデバイスのペアリングを行うための設定スイッチが装備されています。以下の画像に配置を示します。

左側はHOSTコネクタで、8ピンミニDINメスソケットです。ここにホスト固有のケーブルを接続します。このケーブルはSharpKeyを特定のホスト(例:Sharp MZ-2800)のマウスまたはキーボードポートに接続します。
右側はPS/2コネクタで、6ピンミニDINメスソケットです。PS/2キーボードまたはPS/2マウスを接続します。このソケットはホットスワップ対応なので、インターフェースの電源が入った状態でデバイスを抜き差しできます。同じ種類の別のデバイスへの交換は可能ですが、キーボードからマウスへの変更(またはその逆)は不可能です。HOSTケーブルも同時に変更する必要があるためです。
内部には8ピン2mmヘッダコネクタがあります。これはOTAファームウェアアップグレードが失敗した場合(例:ブリック状態)または新機能の開発・デバッグに使用します。このコネクタの詳細についてはテクニカルドキュメントを参照してください。

LED

青色アクティビティLEDはデバイスの動作状態とエラーまたはデバイス状態の警告を示すために使用されます。
通常動作中、アクティビティLEDはインターフェースの電源投入時に1秒間点灯してから消灯します。PS/2デバイスが接続されていない場合、PS/2デバイスが接続されるまで(またはBluetoothが有効になってデバイスがSharpKeyとペアリングするまで)LEDは常時点灯します。キーボードアクティビティ中、LEDはキー押下ごとにパルス点灯します。マウスアクティビティ中、「第3ホイールボタン」が押されてマウスが設定モードに入った場合にのみLEDが点灯します。
LED状態 発生タイミング 説明
点灯 電源投入中 1秒間点灯後に消灯。正常な電源投入と初期化成功を示します。
  通常使用 PS/2キーボードまたはマウスが未接続、Bluetoothデバイスが未ペアリング。
消灯 電源投入中 デバイス障害。
  通常使用 デバイスは正常動作中。
点滅 通常使用 キーボードキー押下ごとにLEDが一時的に点灯。
  WiFi選択 WiFiキーが2秒以上押されると0.5秒に1回点滅し、SharpKeyが設定済みWiFiクライアント/アクセスポイントモードを選択したことを示します。
    WiFiキーが5秒以上押されると0.25秒に1回点滅し、デフォルトパラメータのアクセスポイントモードを選択したことを示します。
  Bluetoothペアリング WiFiキーが10秒以上押されると0.125秒に1回点滅し、Bluetoothペアリングモードが選択されたことを示します。
  NVSリセット WiFiキーが15秒以上押されると1秒に1回長く点滅し、NVSリセットが選択されたことを示します。

スイッチ

WiFi/Bluetooth設定スイッチはSharpKeyケースの内部にあり、LED横のケーストップのピンホールからアクセスします。非導電性のロッドを使用し、ピンホールに挿入して内部スイッチを押し込みます。
スイッチを押し続ける時間によって、ユーザーがアクセスしたい機能が決まります。
スイッチ押下時間 LED 機能
1秒 消灯 選択した機能(WiFiモードやBluetoothペアリングなど)をキャンセル。
1秒間に2回押す SharpKeyが再起動し、キーを押すかマウスを動かすまでLEDが点灯 SharpKeyを再起動。例えばPS/2デバイスを切断した後Bluetoothに切り替えるなど、SharpKeyを再起動する必要がある場合に使用。
2〜4秒 1秒間に2回点滅 設定済みWiFiモード(アクセスポイントまたはクライアント)を選択。
5〜9秒 1秒間に4回点滅 デフォルトパラメータWiFiアクセスポイントモードを選択。
10〜14秒 1秒間に8回点滅 Bluetoothペアリングモードを選択。
15〜19秒 1秒間に1回長いパルス点滅 NVSリセットモードを選択(すべての設定をクリアしてファクトリーモードに戻す)。

各機能の詳細については関連セクションを参照してください。

ケーブル

各ホスト機はキーボードとマウス入力に異なる電気的および機械的仕様を持っています。SharpKeyは電気的およびプロトコル要件を管理できますが、機械的要件は物理的なケーブルで満たす必要があります。
つまり、各ホスト機のキーボードとマウス入力ポートには、SharpKeyからホストのキーボードまたはマウスポートへの固有のケーブルが必要です。Sharpマシンでは、マウスポートは共通なので、SharpKeyを任意のSharpマウスポートに接続するためのケーブルは1本で済みます。異なるケーブルは以下に示します。
各ケーブルには8ピンミニDINコネクタが取り付けられており(MZ-2500には2つあるのでどちら側のコネクタでも使用可能)、SharpKeyに接続します。ケーブルの反対側はホストのキーボードまたはマウスポートに接続します。

SharpKeyの接続

SharpKeyの接続は、ホスト機に合ったケーブル(キーボードまたはマウス用)を入手し、8ピンミニDIN端をSharpKeyに差し込み、反対端をホスト機のキーボードまたはマウスポートに差し込むだけです。
PS/2キーボードまたはPS/2マウスを使用する場合は、キーボード/マウスの6ピンミニDINコネクタをSharpKeyの反対側の端に差し込みます。Bluetoothを使用する場合は、SharpKeyのPS/2ポートへの接続は不要です。

注意:PS/2デバイスが接続されていない場合にのみBluetoothが有効になります。

ケーブルを接続したら、マシンの電源を入れて、PS/2キーボード/マウスまたはBluetoothキーボード/マウスを通常通り使用してください。キーボードのキーがホストのキーに正しくマッピングされない場合は、IoT Webインターフェースを使用して必要なキーマッピングを追加できます。

注意:Bluetoothデバイスはペアリングが必要で、ペアリング後、電源投入時に接続するまでに数秒かかる場合があります。起動時にBluetoothを使用する場合は、Shiftキーを繰り返し押すかマウスを振ってBluetoothデバイスを起動させてください。デバイスがスリープモードになっているとSharpKeyが接続できません。

Bluetoothペアリング

PS/2 HIDデバイスに加えて、BluetoothワイヤレスデバイスもSharpKeyに接続できます。
Bluetoothを使用するには、SharpKeyにPS/2デバイスを接続しないでください。SharpKeyが起動時にPS/2デバイスを検出するとBluetoothを有効にしません。ESP32のBluetoothトランシーバはそれほど強力ではないため、デバイスは1m以内の範囲に置く必要があります(マウスなど一部のデバイスは通常よりもはるかに長い距離で動作します)。
受け取り時、ファクトリーデフォルトモードまたはNVSクリア機能の後、SharpKeyは近くにあってペアリングモードになっているデバイスのBluetoothスキャンを実行します。キーボードまたはマウスデバイスのペアリングボタンを押すだけで、5〜10秒以内にペアリングPINなしで接続されます。
SharpKeyに最大5つの追加デバイスをペアリングできます(5つのデバイスがすべて接続されている場合は同時に動作します)。ペアリングモードに入るには、Wifi/設定有効スイッチを10〜15秒間押します。キーを押し続けると青色LEDのパターンが変化します:
  • 2〜5秒:スイッチを離すとWiFi有効モードが選択されることを示す1秒間に2回の点滅。
  • 5〜10秒:スイッチを離すとデフォルトWiFiモードが選択されることを示す1秒間に4回の点滅。
  • 10〜15秒:スイッチを離すとBluetoothペアリングモードが選択されることを示す1秒間に8回の点滅。
10秒後にスイッチを離すと、SharpKeyはペアリングモードに入り、ペアリングモードにある任意のHIDデバイスと接続します。SharpKeyは60秒間ペアリングモードを維持し、その間に見つかった多くのHIDデバイスとペアリングします。
SharpKeyにはペアリングPINを表示する手段がないため、デバイス認証(PIN入力)はプログラム的に無効化されています。この方法はほとんどのBLEおよびBT Classicデバイスでうまく機能しますが、デバイスが無効にできないPINを要求する場合は、約10秒後に青色LEDが1秒ごとに3回の長いパルスで点滅し始めます。このLED点滅が見えたら、キーボードでPINコード「1234」を入力してENTERを押してください。LEDが点滅し続ける場合は、ペアリングが完了してLEDが点滅を停止するまでPIN入力を繰り返してください。
SharpKeyの次の電源投入時には、Bluetoothデバイスを振ったり起動させて再接続する必要があります。キーボードでShiftキーを繰り返し押すか、マウスを動かすことで実現できます。Bluetoothデバイスが起動されないと、SharpKeyはそれを見つけて接続できません。デバイスとSharpKeyの間の距離によっては再接続に1〜10秒かかる場合があります。

IoT Webインターフェースへのアクセス

SharpKeyにはいくつかのプリセットキーボードマップがあり、サポートされているすべてのホスト機でファクトリーデフォルトはUKキーボードレイアウトに設定されています。ホットキー(以下参照)を使用して別のマップを選択できます。
内蔵マップは時間とともにより多くのキーボードをサポートするように進化し、これらのアップデートはファームウェアアップデートとして配布されます。現在サポートされているキーボードレイアウト:
  • Wyse KB-3926 UKレイアウト
  • Generic OADG109 日本語レイアウト
  • Sanwa SKB-L1 日本語レイアウト
  • Perixx Periboard 810 UKレイアウト
  • OMOTON K8508 UKレイアウト
ただし、個々のユーザーがキーが動作しないまたは期待通りに動作しない場合や、地域(国)のキーボードがうまく動作しない場合など、それを修正するにはより実践的な経験を持つユーザーによる対処が必要です。そのため、SharpKeyはPS/2コードまたはコードの組み合わせを、アクティブなホストが期待するキーシーケンスにマッピングするよう設定できます。Bluetoothのスキャンコードは内部的にPS/2スキャンコードにマッピングされるため、すべてのキーボードタイプ(PS/2またはBluetooth)のマッピングはPS/2コードを使用して実行されます。
変更を行うために、SharpKeyにはWiFiテクノロジーを使用した内蔵Webサーバーが搭載されており、アクセスポイントモード(WiFiデバイスをSharpKeyに接続する)またはクライアントモード(SharpKeyが保存された認証情報を使用してホームネットワークルーターに接続する)で設定できます。
Webインターフェースにアクセスするには、SharpKeyがWiFiアクセスポイントまたはクライアントトランシーバを有効にする必要があります。これはWiFi/BT設定スイッチで行います。
WiFiモードには2つあります(アクセスポイントとクライアント):
  • アクセスポイントは、SharpKeyがWiFiルーターとして機能し、コンピュータ/スマートフォンのWiFi設定でネットワーク:sharpkeyを検索してパスワード:sharpkeyで接続する方法です。SSIDとパスワードは設定で変更できますが、変更を忘れた場合はWiFi/BTスイッチを5秒以上押すことで、前述のデフォルト設定でアクセスポイントモードに強制的に入ることができます。
  • クライアントモードはSharpKeyがホームネットワークにWiFiでログインして接続するモードです。詳細は最初にアクセスポイントモードでSharpKeyに入力する必要があります。設定後、WiFiモードを有効にするたびにSharpKeyはルーターに自動接続し、ネットワーク上の割り当てられたIPアドレスまたはWiFiマネージャーメニューで入力した固定IPアドレスでアクセス可能になります。
各モードへのアクセス手順は以下の表に示します。
モード アクセス方法 説明
アクセスポイントモード。
初期セットアップまたはデフォルトモードを強制する場合。
初期ファクトリーセットアップ、WiFiスイッチを5〜10秒押すとWiFiアクセスポイントモードに入ります。設定が悪かった場合やネットワーク変更があった場合は、WiFiスイッチを5〜10秒押してデフォルトパラメータをロードしアクセスポイントモードに入ります。 コンピュータまたはスマートフォンのWiFi設定でネットワーク:sharpkeyを検索します。このネットワークに接続してパスワード:sharpkeyを入力します。接続成功後、Webブラウザを開いてアドレスバーに http://192.168.4.1 を入力すると、SharpKeyにアクセスしてWiFiマネージャーでWiFiを設定できます。
アクセスポイントモード。 SharpKeyが設定済みでWiFiマネージャーでAPモードを選択した後、WiFiスイッチを2〜5秒押すとアクセスポイントモードに入ります。 このモードではWiFiマネージャーメニューのブラウザ設定でアクセスポイントモードを選択しています。ネットワーク名(SSID)、パスワード、IPアドレス範囲を要件に合わせて変更できます。このモードでは常にコンピュータまたはスマートフォンのWiFi設定メニューでそのネットワークに参加し、指定した設定を使用して設定Webページにアクセスします。
クライアント(ステーションとも呼ばれる)モード。 SharpKeyが設定済みでWiFiマネージャーでクライアントモードを選択した後、WiFiスイッチを2〜5秒押すとクライアントモードに入ります。 このモードではSharpKeyがWiFiでルーターにログインしてネットワークに接続します。アクセスポイントモードの初回接続時に、WiFiマネージャーメニューでルーターの認証情報を設定します。設定後、WiFiを有効にするたびにSharpKeyはルーターに接続し、ネットワーク上の割り当てられたIPアドレスまたはWiFiマネージャーメニューで入力した固定IPアドレスでアクセス可能になります。
必要な時間だけWiFi設定スイッチを押した後、デバイスは再起動して要求されたWiFiモードに入ります。青色LEDが点灯し、点灯し続ける場合はエラーが発生しています。数回短く点滅する場合は、希望のWiFi設定が設定・確立されています。
アクセスポイントネットワークに参加するかSharpKeyがネットワークに接続した場合、正しいIPアドレスを入力してブラウザを開くと(例:初期アクセスポイントモードの場合 http://192.168.4.1)、以下のようなステータス画面が表示されます。正しいIPアドレスはWiFiマネージャーで設定したもの、またはDHCPが有効なクライアントモードの場合はルーターによって割り当てられたものです。ルーターの管理ページを確認してください。

アクセスポイントモードの設定

SharpKeyのファクトリー状態では、WiFiが有効になると自動的にアクセスポイントモードで起動します。WiFiはWiFi/BT設定スイッチを2〜5秒押すことで有効になります。デバイスが設定済みでアクセスできない場合(例:ネットワーク変更による)は、WiFi/BT設定スイッチを5〜10秒押すと自動的にデフォルトパラメータでアクセスポイントモードに入ります。
未設定のアクセスポイントモードのデフォルトパラメータは以下の通りです。
パラメータ
SSID(ネットワーク名) sharpkey
パスワード sharpkey
アクセスポイントIPアドレス 192.168.4.1
ルーターアドレス 192.168.4.1
DHCPが割り当てるIPアドレス範囲 192.168.4.2 - 192.168.4.254
SharpKeyをWiFiモードに設定した後、コンピュータまたはスマートフォンのWiFiメニューにアクセスしてsharpkeyネットワークを選択します。パスワードsharpkeyを入力すると、コンピュータまたはスマートフォンがSharpKeyネットワークに参加してWebインターフェースにアクセスできます。
WebブラウザにURL http://192.168.4.1 を入力するとステータス画面が表示されます:

ステータス画面には2つのパネルがあります。WiFi設定パネルにはSharpKeyが使用しているアクティブなWiFi設定が表示され、バージョン情報パネルにはインストールされているファームウェアモジュールのバージョン番号とディスクファイルシステムバージョンが表示されます。この情報は機能確認や障害追跡/サポートチケット発行、アップデートパックが新しいソフトウェアや修正を提供しているかどうかの確認に使用できます。
画面の左側にはサイドバーメニューと呼ばれる、Webインターフェースで表示または設定できる可能なオプションがあります。このドキュメントでは各オプションの詳細を以下で説明します。
左サイドバーメニューのWiFiマネージャーオプションをクリックします。WiFiマネージャー設定画面が起動します:

ここでSharpKeyをアクセスポイントまたはクライアントとして設定できます。アクセスポイントとはSharpKeyがWiFiネットワークを提供し、コンピュータ/スマートフォンがWiFi設定メニューでそれに接続する必要があることを意味します。クライアントモードとはホームネットワークの詳細を入力してSharpKeyが自動的にホームネットワークに接続し、コンピュータやスマートフォンからネットワーク上のデバイスとして見えることを意味します。 アクセスポイントモードを使用する場合は、デフォルトのまま使用するか、下のWiFi設定パネルで変更することができます。

WiFi設定パネルのアクセスポイントモードのオプション:
オプション 説明
WiFiモード 必要なモードタイプを選択します。この場合はアクセスポイントをクリックします。
SSID これはWiFi設定メニューで利用可能なネットワークをスキャンするとコンピュータまたはスマートフォンに表示されるネットワーク名です。デフォルトのままにするか、わかりやすい名前に変更します。
パスワード SSIDで識別されるネットワークに参加する際にコンピュータまたはスマートフォンが要求するパスワードです。
IPアドレス SharpKeyがDHCPサーバーとして使用するIPアドレス範囲です。この値は.1で終わる必要があります。これがSharpKeyに割り当てられ、DHCPサーバーはxxx.xxx.xxx.2〜254を接続クライアントに割り当てます。
ネットマスク IPアドレスのフィルタリングとマスキングに使用するネットワークマスクです。ネットワークに詳しくない場合は常に255.255.255.0に設定してください。
ゲートウェイ コンピュータまたはスマートフォンがネットワークリクエストをルーティングするために必要なゲートウェイです。SharpKeyはルーティングを実行しないため、IPアドレスと同じ値に設定します。
必要な設定を入力したら、保存をクリックするとデータが検証されます。データが正しければ、問題なく再起動を押してくださいという緑色のメッセージが表示されます。赤色のメッセージが表示された場合はエラーを確認して修正し、エラーが修正されたら保存をクリックします。
正常に保存された後、再起動を押すとSharpKeyは再起動し、直ちにWiFiモードに入ります(WiFi/BT設定スイッチを再度押す必要はありません)。数秒待ってから、コンピュータまたはスマートフォンのWiFi設定メニューでSharpKeyネットワークに参加してください。SharpKeyネットワークに接続したら、ブラウザを開いてWiFi設定パネルで選択したIPアドレスを入力するとすぐにSharpKeyステータスメニューに移動します。

クライアントモードの設定

SharpKeyのファクトリー状態では、WiFiが有効になると自動的にアクセスポイントモードで起動します。SharpKeyのステータス画面が表示されるまでアクセスポイントモードの設定に従ってから、以下の手順に従ってください。
左サイドバーメニューの「WiFiマネージャー」オプションをクリックします。WiFiマネージャー設定画面が起動します:

ここでSharpKeyをアクセスポイントとして設定するか(その場合はアクセスポイントモードの設定の手順に従う)、クライアントモードで設定するかを選択できます。
クライアントモードを選択する場合は、クライアントラジオボタンをクリックするとWiFi設定パネルがクライアントパラメータを要求するように更新されます。クライアントモードには2つの動作方式があります。DHCP有効(ルーターがすべてのネットワーク接続情報を提供)とDHCP無効(ネットワークパラメータを手動で指定)です。
WiFi設定パネルで要求される初期パラメータはDHCP有効またはDHCP無効モードの両方で同じです:
オプション 説明
WiFiモード 必要なモードタイプを選択します。この場合はクライアントをクリックします。
SSID SharpKeyがホームネットワークとの接続を確立するために参加するネットワーク名です。
パスワード SharpKeyがルーターへの認証と接続確立のために提供するパスワードです。
DHCPモード ルーターにすべてのネットワーク情報を提供させる(有効)か、手動で提供する(無効)かを指定します。
正常に保存された後、左サイドバーの再起動をクリックするとSharpKeyは再起動します。新しい設定でWiFiモードに入る場合はWiFiスイッチを再度押してください。SharpKeyがネットワークへの参加に失敗した場合はLEDが点灯し続け、成功した場合は数回の短い点滅でWiFi接続を確認します。SharpKeyがWiFiモードに入れない場合(ルーターに接続できない)はLEDが点灯し続け、1分後に再起動します。この場合はWiFi/BT設定スイッチを5〜8秒押すと、デフォルト設定でWiFiアクセスポイントモードに入り、入力した認証情報を再確認できます。

OTAアップデート

SharpKeyには内部ファームウェアまたはディスクファイリングシステムのアップデートを可能にする機能が搭載されています。ファームウェアまたはファイルシステムは新機能のためまたは既知のバグを修正するためにアップグレードできます。
OTAアップデート機能を使用するには、上記のアクセスポイント/クライアント情報を使用してWebインターフェースにアクセスし、ブラウザを開いて初期ステータスページをロードします:

左サイドバーメニューのOTAアップデートオプションをクリックします。OTAアップデート設定画面が起動します:

OTAアップデート画面には4つのパネルがあります:
  • バージョン情報パネル:インストールされているファームウェアモジュールのバージョン番号とディスクファイルシステムバージョンが表示されます。
  • ESP32パーティションパネル:SharpKeyを動かすESP32 SoCのNVSフラッシュRAMのレイアウトを表示します。
  • ファームウェアアップロードパネル:新しいファームウェアファイルを選択してSharpKeyにアップロードできます。
  • ファイルパックアップロードパネル:新しいファイルシステムイメージファイルを選択してSharpKeyにアップロードできます。
ファームウェアをアップグレードするには、ファームウェアアップロードパネルのファイルを選択ボタンをクリックして保存またはダウンロードしたファームウェアイメージを選択します。プログラム前に検証が行われるため、誤ったイメージを選択するとSharpKeyはアップデートを拒否します。バージョンチェックも行われ、選択したバージョンが現在のファームウェアと同じ場合はアップデートをブロックします。選択後、パネルは次のように更新されます:

新しいファームウェアをSharpKeyにアップロードしてフラッシュする準備ができたらアップグレードボタンをクリックし、選択ファイルをクリアするにはキャンセルをクリックします。アップグレードを押すとアップデート手順が開始されます。まずファイルが検証され、有効であればファイルアップロードが行われ、パネルは状態を表示するように変更されます:

アップロード成功後、再起動操作を実行するよう促す緑色の成功メッセージが表示されます。赤色のメッセージが表示された場合はSharpKeyを再起動してファームウェアのアップロードを再試行してください。フェイルセーフメカニズムは現在のファームウェアを上書きしないため、常にSharpKeyを再起動できます。

ファイルパック(キーマッピングイメージとWebサーバーファイルを含むファイルシステム)をアップグレードするには、ファイルパックアップロードパネルのファイルを選択ボタンをクリックして保存またはダウンロードしたファイルパックイメージを選択します。ファイルパックのアップロードが失敗してファイルシステムが破損した場合、Webインターフェースは機能しなくなります。この場合、ファイルシステムを再フラッシュするためにSharpKeyに外部プログラミングプローブを接続する必要があります。アップロード中は常にSharpKeyに電力を供給し続けることを確認してください。

キーマップエディタ

マッピングされていないキーの組み合わせや異なるレイアウトのキーボードに対応するため、SharpKeyはキーボードマップ編集を可能にします。キーマップは内蔵キーマップエディタまたはdhexなどのツールを使用したローカルファイルの保存・編集・アップロード手順で更新できます。
さまざまなサポート対象マシン間の違いのため、キーマップエディタとそのデータはモデルごとに異なります。そのため以下では各マシンに専用のセクションを設けて、マッピングロジックとエディタの使用法について説明します。キーマップはSharpKeyが起動時に検出したアクティブなホストに対してのみ編集できます。ホストが検出されない場合はキーマップ編集オプションは左サイドバーメニューに表示されません。
すべてのサポートホストに共通の基本キーマップエディタは、16進入力テーブルに基づき、マッピング優先度は上から下の順で、テーブルの各エントリが1つのキーマップを指定します。データは16進数または10進数で入力でき、一部の入力フィールドにはSHIFTキーなどの機能を選択するためのポップオーバーボックスがあり、設定プロセスを支援します。
アクティブなホストのキーマップエディタにアクセスするには、上記のアクセスポイント/クライアント情報を使用してWebインターフェースを起動し、ブラウザを開いて初期ステータスページをロードします。

左サイドバーメニューの<HOST> キーマップオプションをクリックします。アクティブなホストのキーマップエディタ画面が起動し、以下の例のように表示されます。

キーマップエディタには2つのパネルがあります。一方はキーマップ値の直接入力と編集用、もう一方はローカルディスクへのキーマップファイルの保存と読み込み用です。後者のオプションはバックアップまたはローカルコンピュータツールを使用した外部編集に使用できます。
キーマップエディタパネルにはレスポンシブテクノロジーに基づいたテーブルが表示され、表示可能なウィンドウに自動的にサイズ調整されます。マウスのスクロールホイールで下にスクロールするか、TAB/カーソルキーで左右にスクロールします。
テーブルのヘッダーはアクティブなホストによって異なり、以下のホストセクションでより詳しく説明します。
エディタはテーブルの右側にある4つのボタンと2つの列を使用して追加、削除、交換、保存変更またはリロードができます:
  • 列を追加するには、緑の+記号をクリックすると、その下の行に空白の行が表示されます。すべての値は無効に設定され、アクティブにするためには完了が必要です。
  • 1行を削除するには、削除したい行の赤い-記号をクリックします。
  • 複数行を削除するには、削除したい各行の右のチェックボックスをクリックします。1つ以上のチェックボックスにチェックが入ると、青い削除ボタンがアクティブになります。削除を押すと行が削除されます。
  • 2行を交換するには、各行の右のチェックボックスをクリックします(2行だけチェックが入るようにします)。2行にチェックが入ると、青い交換ボタンがアクティブになります。交換を押すと行が交換されます。
  • キーマップを保存する(次回再起動時にアクティブにする)には、データ変更を行った後に青い保存ボタンがアクティブになります。クリックして変更を保存します。
  • 変更が行われると、青いリロードボタンがアクティブになります。このボタンをいつでもクリックすると、すべての変更が破棄されてキーマップがリロードされます。
エラーメッセージはボタンのすぐ上にあるステータスボックスに表示されます。
より具体的なキーマップの詳細については以下のセクションを参照してください。

Sharp MZ-2500 / MZ-2800 キーマップ

MZ-2500とMZ-2800モデルは共通のキーマップテーブルを共有しています。他のサポートホスト機と同様に、キーマップは特定のキーボードモデル(例:Wyse KB-3296)と特定のホストバリアント(例:MZ-2500上のMZ-80B)を対象とすることができます。
MZ-2500/MZ-2800マシンは、すべての非アクティブキーがロジック1を見て、アクティブキーがロジック0を見る13x8または14x8のキーマトリクスに基づくキーボードを使用しています。MZ-2500キーボードマトリクスは以下のテーブルと画像およびキーボードレイアウトで可視化できます。
    MZ-2500 キーボードマップ

     行     D7        D6        D5        D4        D3        D2        D1        D0
    ----------------------------------------------------------------------------------
      0      F8        F7        F6        F5        F4        F3        F2        F1
      1      KP -      KP +      KP .      KP ,      KP 9      KP 8      F1O       F9
      2      KP 7      KP 6      KP 5      KP 4      KP 3      KP 2      KP 1      KP 0
      3      BREAK     RIGHT     LEFT      DOWN      UP        RETURN    SPACE     TAB
      4       G         F         E        D         C         B         A         / ?
      5       O         N         M        L         K         J         I         H
      6       W         V         U        T         S         R         Q         P
      7       , <       . >       _        YEN |     ^ '¿      Z ¿       Y         X ¿
      8       7 '       6 &       5 %      4 $       3 #       2 "       1 !       0
      9                 [ {       @ `      - =       ; +       : *       9 )       8 (
     10       KP /      KP *      ESC      BACKSPACE INST/DEL  CLR/HOME  COPY      ] }
     11                                    CTRL      KANA      SHIFT     LOCK      GRAPH
     12                                                                  KJ2       KJ1
     13                                                                  HELP      ARGO

MZ-2800キーボードマトリクスは以下の画像で可視化できます。最初の画像はキーボードレイアウト、2番目はキーボードマトリクスです。

PS/2キー(Bluetoothキーボードは内部でPS/2キーにマッピングされる)は、キーボードマトリクス内の1つ以上の行/列ペアのアクティブ化と、場合によっては別の行/列ペアの非アクティブ化が必要な場合があります。これに対応するため、1つのキーマップごとに14個のパラメータが提供されており、すべてを設定またはデフォルト化する必要があります。
マッピングプロセスはPS/2キーが押されるたびにマッピングテーブルを上から下に走査し、キーが一致した場合、MZ-2500/2800出力マトリクスはメイク行パラメータで指定された行を使用して更新されます。
パラメータ 説明
PS/2 キーコード E0/E1またはBREAKモディファイアを除いた任意のキーの生のPS/2キーボードコード。
PS/2 制御キー PS/2 KeyCodeに対してマッチングするコントロールキー(SHIFT、CTRL、CAPS、ALT、ALTGR、GUI、FUNC、BREAK)。
キーボード対象 このマップがアクティブになる特定のPS/2またはBluetoothキーボードモデルを指定するフラグ。
ホストモデル対象 キーマップがアクティブになるモデルまたはモデルセットを指定するフラグ。
メイク行1 PS/2 KeyCodeが一致したときにアクティブにするMZ-2500/MZ-2800キーボードマトリクスの行。
メイク キー1 一致するPS/2 KeyCodeに対してアクティブになるMZ-2500/MZ-2800キーボードマトリクスの列。
メイク行2 メイク行1と同じ、必要な場合の2番目の行のアクティブ化。0xFF = 無効。
メイク キー2 メイク キー1と同じ。
メイク行3 メイク行1と同じ、必要な場合の3番目の行のアクティブ化。0xFF = 無効。
メイク キー3 メイク キー1と同じ。
ブレイク行1 PS/2 KeyCodeが一致したときに非アクティブにするMZ-2500/MZ-2800キーボードマトリクスの行。
ブレイク キー1 PS/2 KeyCodeが一致したときに非アクティブになるMZ-2500/MZ-2800キーボードマトリクスの列。
ブレイク行2 ブレイク行1と同じ、必要な場合の2番目の行の非アクティブ化。0xFF = 無効。
ブレイク キー2 ブレイク キー1と同じ。
すべてのキーマップパラメータはキーマップエディタでHEX表記で表示されます:

すべてのキーマップ行はテーブルに格納され、表示可能なテーブルサイズはブラウザおよび/またはコンピュータの画面サイズに応じて設定されます。非表示の行を表示するには、マウスのスクロールホイールを使用します。

デフォルトマッピングテーブル

以下のテーブルはデフォルトマップをわかりやすい形式で説明しています。
MZ-2500 キー MZ-2800 キー PS/2 キー 説明 PS/2 キーボード
LOCK LOCK* Caps Lock 大文字/小文字の切り替えとロック。一度押すと大文字にロック(LED点灯)、もう一度押すと解除して小文字に戻ります。 Wyse KB-3926
HELP HELP* F11 HELP機能  
BREAK BREAK* Pause BREAKキー。PS/2は通常CTRL+BREAKでBREAKを生成しますが、MZ-2500はSHIFT+BREAKを必要とします。これはBREAKを生成しないため、SHIFT+PAUSE(BREAKと同じキー)でMZ-2500のBREAKを作成するマッピングが作成されています。  
COPY COPY* F12 COPY機能  
CLR CLR* Shift+Home 画面クリア  
HOME HOME* Home カーソルを0,0位置(HOME)に設定。  
INST INST* Insert カーソル位置に文字を挿入。  
DEL DEL* Delete カーソル位置から文字を削除。  
ARGO ARGO Print Screen ARGO機能。例:BASIC v2でアプレットメニューを表示。  
GRAPH GRAPH Left GUI グラフィック文字入力に変更。  
Yen Yen |\ 円記号を挿入  
KANA KANA Right GUI KANA機能を選択。  
KJ1 Sentence KJ1 Sentence Left ALT KJ1機能  
KJ2 Transform KJ2 Transform Right ALT KJ2機能  
  PREVIOUS* PGDN 前のキー  
  CANCEL* Right CTRL キャンセルキー  

* = MZ-2800では日本語で表記。

その他のキーはPS/2キーボードの記号通りです。Num Lockキーはテンキーを数値とカーソル機能の間で切り替えます。

Sharp X1 キーマップ

Sharp X1シリーズにはX1、X1 Turbo、X1 Turbo Zが含まれます。マッピングはより一般的であり、PS/2スキャンコード(Bluetoothスキャンコードは内部でPS/2スキャンコードにマッピングされる)がX1スキャンコードにマッピングされます。X1は元のモデルに対して8ビットキーコード+8ビット修飾コードが必要です。Turbo/Turbo ZシリーズにはモードA(元の)とモードBがあり、モードBはより高速な24ビット応答を送信してゲームに使用されます。
モードAはすべてのSharp X1モデルで使用され、一般的なキーボード使用に使用されます。各キー押下でASCIIコード+制御修飾キーを<制御ビット><ASCIIキーコード>の形式で送信します。
すべてのキーマップパラメータはキーマップエディタでHEX表記を使用して表示されます。各マシンのより具体的なキーマップの詳細については、ホスト固有のドキュメントを参照してください。

無線規制に関する注意事項

本デバイスは 2.4 GHz ISM バンドで送信する事前認証済み ESP32-S 無線モジュール(AI Thinker)を搭載しており、世界各国の無線周波数規制(米国の FCC Part 15 Subpart C、欧州連合の無線機器指令 2014/53/EU を含む)において意図的放射器に該当します。
ESP32-S モジュールは無改造で使用されており、独自の規制認証(FCC、CE など)を取得しています。ただし、そのモジュールレベルの認証は、モジュールを組み込んだ完成品に自動的に適用されるものではありません。事前認証モジュールの免除規定は、個人の趣味愛好家個人使用、実験、または教育目的で少数のデバイスを製作する場合に、個別の機器認可を取得せずに行うことを許可するものです。
重要な制限事項
  • 組み立てられたデバイスは、完成品が独自にテストされ、該当する管轄区域で機器認可(例:FCC ID、認定機関による CE マーキング評価)を取得しない限り、第三者への販売、販売の申し出、贈与、またはその他の方法での配布を行ってはなりません
  • 個人使用のために少数を製作することは、趣味愛好家および実験使用の規定(例:FCC § 15.23)に基づき、デバイスが有害な干渉を引き起こさない限り、一般的に許可されています。
  • 規制要件は国によって異なります。米国外の製作者は、適用される規則について自国の無線周波数当局に確認してください。
製作者の責任
本設計に基づいて製作されたデバイスが、管轄区域内の適用されるすべての無線周波数規制に準拠することは、製作者の単独の責任です。著者は本設計を個人使用、教育、および趣味愛好家向けに提供しており、本設計から製作されたデバイスが商業的配布の規制要件を満たすことについて、いかなる表明も行いません。