眼鏡店やレンズ加工ラボで「VCA通信」「VCAフォーマット」と呼ばれている、トレーサーや加工機(エッジャー)などの機器と PC の間でデータをやり取りするための規格を、実装する人向けに日本語で解説します。
あわせて、この規格のデータを読み書きできる JavaScript のライブラリと、自作のサンプルファイルを置いています。
前提とした版: The Vision Council Data Communication Standard v3.14(2025 年公開) この記事は規格書の翻訳ではなく、規格を読んだうえで要点を独自にまとめたものです。正確な定義は必ず公式の規格書で確認してください。
- VCA通信とは
- 登場する機器と役割
- 接続方式
- レコードの書き方
- パケットの構造
- 確認応答とタイムアウト
- セッションの流れ
- 玉型(トレース)データ
- 実装の手順
- つまずきやすい点
- このリポジトリの中身
- 参考資料
- 免責とライセンス
同じ規格がいくつもの名前で呼ばれています。
| 呼び方 | 由来 |
|---|---|
| VCA | 規格を管理する団体の旧名 Vision Council of America(2008 年に The Vision Council へ改称)。日本では「VCA通信」「VCAフォーマット」がよく使われる |
| OMA | さらに前の団体名 Optical Manufacturers Association(1999 年に統合されて VCA に)。英語圏ではこの呼び方が主流で、ファイル拡張子も .oma が多い |
| DCS | 正式名 Data Communication Standard の略 |
| OMAV | 規格のバージョンを表すレコード名(例: OMAV=3.14) |
英語で情報を探すときは「VCA」より「OMA」で検索したほうが見つかります(OMA file format、OMA TRCFMT など)。日本語で「OMA ファイル」と検索するとソニーの音声形式(同じ拡張子)が出てくるので注意してください。
- かつては ISO 16284 と ANSI Z80.24 としても出版されていました。v3.14 の前書きによると、どちらも取り下げられ、現在は The Vision Council の DCS が唯一の規格とされています。
- 日本の JIS T 7335:2005(眼鏡レンズ製造システム間の情報交換)は ISO 16284:2001 を基にしています。基本的な仕組みは同じですが、内容は 2000 年代前半のものです。
ネットで手に入る最も古い 3.02(2001 年)から最新の 3.14(2025 年)までの旧版を比べ、版ごとの変更とラベルの追加を docs/history.md にまとめています。
規格では、通信の両端を次のように呼びます。
- ホスト(host): 受注データや加工データを持つコンピュータ。ラボ管理システム(LMS)や店舗の PC。
- デバイス(device): 実際に作業する機械。トレーサー、加工機、カーブジェネレーター、ブロッカー、レンズメーターなど。
最も大事な原則は「セッションは必ずデバイスから始める」ことです。ホストのほうから要求を出すことはありません。デバイスが「このジョブのデータをください」「測定したデータを送ります」と要求し、ホストが応じます。
ただし TCP/IP では、接続そのものはホストからデバイスの待ち受けポートへ張ることがあります(接続方式)。接続をどちらが張るかと、セッションをどちらが始めるかは別で、接続した後に最初のパケットを送るのはやはりデバイスです。
デバイスが何をしたいのかは、要求パケットの REQ レコードの値で表します。主なものは次のとおりです。
| 値 | 意味 | 方向 |
|---|---|---|
INI |
初期化(機器の自己紹介と取り決め) | 双方向 |
TRC |
トレーサーからの玉型送信 | アップロード(デバイス→ホスト) |
EDG |
加工機(エッジャー)へのデータ要求 | ダウンロード(ホスト→デバイス) |
GEN |
カーブジェネレーターへのデータ要求 | ダウンロード |
SBK / FBK |
ブロッカー(表面加工用/加工機用) | ダウンロード |
LMD |
レンズメーター | ダウンロード |
INS |
検査機器からの測定結果 | アップロード |
INF |
作業完了の通知 | アップロード |
UPL / DNL |
汎用のアップロード/ダウンロード | アップロード/ダウンロード |
TIM |
時刻合わせ(JOB なし) |
ダウンロード |
FIL |
ファイルとして保存したデータ | 通信なし |
このほかの種別(穴あけ機の DRL、コマンドの CMD、保守情報の MNT など)は規格書の表 A.3 にあります。
もともとの接続方式です。既定値は 9600 bps・データ 8 ビット・ストップ 1 ビット・パリティなしです。フロー制御を使う場合は RS-232C の制御線で行い、XON/XOFF(ソフトウェア制御)は使いません。
v3.04 から規定されています。通信の中身(セッション)はシリアルと全く同じで、通り道が TCP になるだけです。
| ポート | 用途 |
|---|---|
| 50000(既定) | デバイスが待ち受けるポート。ホストがここへ接続する(ローカル接続) |
| 33511 | オートコネクト用。デバイスが起動時に UDP ブロードキャストで「自分の IP とポート」を知らせる |
| 33512 | ホストが待ち受けるポート。デバイスから接続する(リモート接続) |
TCP で接続してから最初のセッションを始めるまで、デバイスは 3 秒待つ決まりです。後述の CRC は接続方式にかかわらず省略できます(TCP 自体にも誤り検出があります)。
通信せずにファイルでやり取りする方法もあります(3.02 には無く、3.07 にはある。間の版は手に入らないため、どの版で加わったかは分かりません)。中身は後述のパケットとほぼ同じで、次の点だけが違います。
- パケットの開始・終了などの制御文字、
CRC、STATUSは入れない - 1 行目は
REQ=FIL(リムレスのフレームデータはREQ=FRM、面形状定義ファイルはREQ=SDF)、ジョブのデータなら 2 行目はJOB=... - 玉型データは形式 1(ASCII)のみ
「VCA ファイル」「OMA ファイル」と呼ばれるものの多くはこの形式です(機器やソフトによっては独自の拡張があります)。samples/ に例があります。
データは 1 行 1 項目の「レコード」の集まりです。
ラベル=値1;値2
-
ラベルと値の区切りは
=、値どうしの区切りは; -
左右(chiral)レコードは「右眼の値;左眼の値」の順
SPH=-2.25;-2.50 右 -2.25、左 -2.50 SPH=;-2.50 左眼だけの注文 DBL=18.0 左右の区別がない項目は値 1 つ -
左右レコードなのに値が 1 つしかない場合は、両眼に同じ値を使う(受け取る側はこれを許容する)
-
値が不明なときは
?を入れる(例:IPD=?;31.0) -
1 つの値の中に複数の数値を入れるときは
|で区切る(TOLVADD=-0.04|0.06;-0.04|0.06のような min|max など。使えるのは規格の表で決められたレコードだけ) -
ラベルは最大 16 文字。
_で始まるラベルは機器メーカーの試験用 -
1 つの値は最大 255 文字(v3.13 から。それ以前は 80 文字)。limited 型(
JOBなど)は 12 文字まで -
知らないラベルは無視する(エラーにしない)
-
文字は ASCII の 32-127(
;を除く)。文字列の欄だけは、取り決めれば UTF-8 も使える(TXTENCレコード。初期化で、初期化しない場合はセッションごとに取り決める) -
v3.03 より前は文字列を
"で囲むことがあったので、受け取る側は引用符を外せるようにしておく
- 長さは mm、角度は度、屈折力はディオプター
- カーブ(
FRNT・BACKなど)はTINDで指定された屈折率で換算したディオプター(既定は 1.53)。素材の屈折率LINDとは別物です - 凸面は正、凹面は負の値で表します
通信では、レコードを「パケット」にまとめて送ります。制御文字を <FS> のように表記すると、形は次のとおりです。
<FS>REQ=TRC<CR><LF>
JOB=A0001<CR><LF>
DEV=TRC<CR><LF>
<RS>CRC=12345<CR><LF>
<GS>
(CRC=12345 の値は説明用の仮の数字です)
| 文字 | コード | 役割 |
|---|---|---|
| FS | 0x1C | パケットの開始 |
| GS | 0x1D | パケットの終了 |
| RS | 0x1E | CRC レコードの直前に置く(CRC が無ければ GS の直前) |
| CR LF | 0x0D 0x0A | レコードの区切り |
| ACK | 0x06 | 受信成功の返事 |
| NAK | 0x15 | 受信失敗の返事 |
| ESC | 0x1B | バイナリデータ中のエスケープ |
順序の決まりは 3 つだけです。
- 最初のレコードは
REQ(要求)またはANS(応答) - 初期化以外では、2 番目は必ず
JOB(ジョブ番号)。ホストは受け取った形式のまま返す CRCを付けるなら最後(RSの直後)。CRCが無くてもRSはGSの直前に置く
2 の例外として、時刻合わせ(TIM)、保守情報(MNT)、ネットワークの自動接続(CON)には JOB がありません。レンズ情報の要求(LNF)は 2 番目が OPC、コマンド(CMD)は JOB の代わりに LIB か RMT でもかまいません。
REQ の無いパケットを受け取ったホストは、ANS=ERR と STATUS=18 を返します。
CRC は省略できます。付ける場合は CCITT CRC-16(多項式 0x1021、初期値 0。XMODEM と同じ計算)で、FS の次の文字から RS までの全文字を対象に計算し、10 進数で書きます。相手が CRC を付けてきたら、こちらも付けて返すのが推奨です。
// 確認用: "Hello World!" の CRC は 0x0CD3
function crc16(str) {
let crc = 0;
for (const ch of str) {
crc ^= (ch.charCodeAt(0) & 0xff) << 8;
for (let b = 0; b < 8; b++) crc = crc & 0x8000 ? ((crc << 1) ^ 0x1021) & 0xffff : (crc << 1) & 0xffff;
}
return crc;
}パケットを受け取った側は、1 文字の ACK か NAK を必ず返します。
- NAK を受けたら同じパケットを送り直す。再送は 3 回まで(合計 4 回 NAK なら中止して操作者にエラー表示)
- 決められた時間内に返事が来なければ、再送せずにセッションを中止します
| タイムアウト | 既定 | 内容 |
|---|---|---|
| 確認応答 | 6 秒 | パケット送信後、ACK/NAK が来るまで |
| パケット | 12 秒 | ACK を受けてから、相手のパケットが届き始めるまで |
| 文字間 | 5 秒 | パケット受信中、次の文字が来るまで |
この値は初期化時に TIMEOUT レコードで変更できます(2-255 秒)。
1 つのジョブについての一連のやり取りを「セッション」と呼びます。セッションは途中で別のセッションと混ざることはなく、必ず 1 つずつ完結させます。
デバイス ホスト
<FS>REQ=TRC / JOB=A0001 <GS> →
← <ACK>
← <FS>ANS=TRC / JOB=A0001 / STATUS=0 <GS>
<ACK> →
<FS>ANS=TRC / JOB=A0001 /
TRCFMT=... / R=... <GS> →
← <ACK>
← <FS>ANS=TRC / JOB=A0001 / STATUS=0 <GS>
<ACK> →
ホストが返す STATUS が 0 以外なら、そこでセッションは失敗です。
デバイス ホスト
<FS>REQ=EDG / JOB=A0001 <GS> →
← <ACK>
← <FS>ANS=EDG / JOB=A0001 / STATUS=0 /
(加工に必要なレコード一式)<GS>
<ACK> →
電源投入時などに、デバイスが自分の情報(メーカー VEN、機種 MODEL、種別 DEV など)や、対応できる玉型形式(TRCFMT)をホストに伝えるセッションです。必須ではありませんが、強く推奨されています。
- 流れ: デバイスの
REQ=INI→ ホストの応答(STATUS=0なら自動フォーマットとプリセットのどちらでもよい、14ならプリセットのみ、15なら初期化に非対応)→ デバイスのデータパケット(DEV・VEN・MODEL、対応できるTRCFMTなど)→ ホストのデータパケット(要求 ID と、使うTRCFMTを 1 つ)。ホストは少なくともSTATUS=15を返せなければなりません - 自動フォーマット初期化: デバイスが「今後このレコード一式を送ってほしい」というリストを
DEF・D・ENDDEFレコードで送ります。ホストはそのリストに要求 ID(整数)を割り当ててDEF=タグ;要求IDで返し、以後デバイスはREQ=要求IDで要求します。 - プリセット初期化(
DEFを送らない): 規格が決めた種別ごとのレコード一式(プリセットパケット、表 A.5-A.23)を使います。v3.04 から、データを受け取る機器では廃止扱いで、トレーサーのように送るだけの機器で使います。 - ホストが再起動して要求 ID を忘れた場合などは、ホストが
STATUS=5(初期化が必要)を返し、デバイスは初期化をやり直します。 - 初期化しない機器は
REQ=EDGのような決まった種別で要求し、TRCFMTなどの取り決めも要求パケットに入れます(開発・試験・小規模向けの簡易モード)。
| コード | 意味 |
|---|---|
| 0 | 正常 |
| 1 | ジョブが見つからない |
| 3 | 一般エラー(内容は説明欄) |
| 4 | この機器向けには処理できないジョブ |
| 5 | 初期化が必要 |
| 7 | 必要なレコードが不足 |
| 8 | ホストの内部エラー(本文 7.6.2・7.7.2 は、対応しない要求種別にもこの番号を使うと書いている。10 章を参照) |
| 10 | 値が範囲外 |
| 14 / 15 | 自動フォーマット初期化に非対応/初期化に非対応 |
| 16 | 要求の種類が分からない(Invalid request) |
| 17 | 非対応の玉型形式(256・512・1024 を足して、形式・点数・角度モードのどれが合わないかを示すことがある) |
| 18 | 書式エラー(規格どおりに解析できない) |
すべてのコードは規格書の表 A.24 にあります。src/vca-parser.js の STATUS にも日本語の要約を入れています。
フレームの形は、中心からの半径を角度ごとに並べたデータで表します。
玉型データは必ず TRCFMT から始まり、直後に半径の R レコードが続きます。
TRCFMT=形式;点数;角度モード;眼;対象
| 項目 | 値 |
|---|---|
| 形式 | 0 データなし(この場合は項目 1 つだけ)/1 ASCII/2 バイナリ絶対値/3 バイナリ差分/4 パックトバイナリ(5-100 は将来の予約)。すべての機器とホストは形式 1 に対応しなければならない |
| 点数 | 半径の個数(400 や 512 など) |
| 角度モード | E 等角度/U 不等角度(A レコードで角度を送る)/C 自由(角度が戻ってもよい。v3.09 以降) |
| 眼 | R 右/L 左(初期化と要求では B 両眼も可) |
| 対象 | F フレーム/P 型板/D デモレンズ |
両眼分を送るときは、右眼と左眼それぞれに TRCFMT を付けます。
- 形式 1 の半径は 1/100 mm 単位の 4 桁の整数。例:
2479は 24.79 mm - 1 行は 80 文字以内なので、
R=が何行にも分かれます - 角度(
A)も 1/100 度単位の整数で、0-35999 - 立体形状(サグ)は
ZFMTとZ・ZAで同様に送ります。サグを扱えないホストはZFMT=0を返す - 玉型と同じ書式のデータセットに、削り落とし形状(
CRIBFMT)、面の厚み(STHKFMT)、棚(SHLFFMT)があります(docs/records.md)
TRCFMT=1;360;E;R;F
R=2457;2473;2490;2506;2522;2538;2553;2568;2582;2597;2612;2627;2642;2657;2672
R=...
(samples/frame-right.vca の冒頭。0° の半径は 24.57 mm)
- 最初の点は 0°(時計の 3 時の方向)で、反時計回りに並べる
- 検者が装用者を正面から見た向きで表す。このため、右眼のデータは鼻側から、左眼のデータは耳側から始まる
- 右眼用のデータを左眼に使うときは、左右反転(角度 θ → 180° - θ)する
- 半径の基準は玉型の幾何中心(ホストが意図的にずらす場合は
FBFCIN・FBFCUPでずれ量を示す) HBOX(横幅)、VBOX(縦幅)、CIRC(周長)は、送った半径データの形と一致していなければならない
- 形式 2: 半径 1 つを 16 ビット整数(下位バイトが先)で表す
- 形式 3: 最初の半径は 16 ビット、以降は前の値との差を符号付き 1 バイトで表す。差が大きすぎるときは
0x80を置き、続く 2 バイトを絶対値とする - 形式 4: 16 ビット・8 ビット・4 ビットの 3 種類を切り替えて詰め込む、最も効率のよい形式(規格書の附属書 B に完全な例あり)。値の個数(
TRCFMTの点数)が分からないと復号できない - バイナリ中に予約制御文字(FS・GS・RS・CR・LF・ACK・NAK・ESC など)と同じ値のバイトが出たら、ESC を前に置き、そのバイトの最上位ビットを立てて送る(例: 0x0A → 0x1B 0x8A)。受け取る側は逆の処理をする
- CRC はエスケープ後のデータで計算する
玉型データを受け取って使うまでの流れです。
- 受信: FS から GS までをためる。文字間 5 秒を超えたら中止
- 確認応答: CRC があれば検証し、ACK か NAK を返す
- 分解: CR/LF で行に分け、
ラベル=値を取り出す。知らないラベルは読み飛ばす - トレースの復元:
TRCFMTの形式に従って半径(と角度)を取り出す。バイナリ形式ならエスケープを戻してから復号する - 座標に変換: i 番目の点の角度は、等角度なら
i × 360 / 点数。半径 r と角度から x = r cos θ、y = r sin θ。角度は度で与えられるので、プログラムの三角関数に渡すときはラジアン(θ × π / 180)に直す - 眼の向きを合わせる: 必要なら左右反転
このリポジトリの src/vca-parser.js を使うと、3-6 は次のように書けます。
const data = VCA.parse(fileText); // ファイル内容(1 文字 = 1 バイト)
const trace = data.traces.find(t => t.eye === 'R') || data.traces[0];
const points = VCA.tracePoints(trace, 'R'); // 右眼の向きの座標列(mm)
const { hbox, vbox } = VCA.boxOf(points); // 横幅・縦幅
const ipdRight = VCA.number(data, 'IPD', 'R'); // 左右の別は定義表に従うファイルを読むときは、バイナリ形式が壊れないよう UTF-8 として解釈せず、1 バイト = 1 文字で読み込んでください(ブラウザなら file.arrayBuffer() → VCA.bytesToString())。
玉型データが表すのは、箱の中心を基準にした形だけです。眼の位置との関係は、次のような別のレコードで送られます。
MPD: フレーム PD。左右のHBOXの平均にDBLを足した値(ホストが補正を加えることもある)IPD: 片眼の中心間距離(いわゆる片眼 PD)OCHT: 箱の下端から測ったプリズム基準点(PRP)の高さ。光学中心の高さではない点に注意
- データが来ない: 初期化に応答していない、ACK を返していない、通信速度などの設定が違う、のどれかが多い原因です
- 機種によってはバイナリ形式で送ってくる: 初期化で対応形式を伝えるか、機器側の設定で形式 1 に変える
UとCの違い:Uは角度が順に増える、Cは角度が戻ってもよい(鍵穴のような形)。Cは等角度データに変換できない- 左右の値の扱い: 値が 1 つなら両眼、空欄や
?は「不明」 - カーブの符号: 凸面は正、凹面は負。眼鏡レンズの後面は通常凹面なので、
BACKは負の値になる TINDとLIND: カーブはTIND(既定 1.53)基準、素材の屈折率はLINDDBLは左右の区別がない: 値は 1 つ- 引用符: 古い機器は文字列を
"で囲んで送ってくることがある JOBの無いパケット:TIM・MNT・CONなどは 2 番目がJOBでなくて正常(5 章)- 穴あけデータ:
DRILLEは先にDRLFMTで基準(箱中心・縁・外接箱)を取り決めてから使う。古いDRILLは廃止(docs/records.md) - 規格書の誤植: 表 A.1 の
HBOはHBOXのこと(本文・プリセット表・例はすべてHBOX)。表 A.16 のINSSGUPは、同じ表のTOLSGOCUPと対になるINSSGOCUPのこと - 状態コードの食い違い: 対応しない要求種別(
CMD・LNF)に返す値を、本文 7.6.2・7.7.2 はSTATUS=8とするが、表 A.24 では 8 は「ホストの内部エラー」で、「要求の種類が分からない」は 16。相手のホストがどちらを返すかは実装による。知らない要求種別(REQ=XYZ)に返す値は本文に指定が無く、DCS Host Simulator は 18 を返す - 規格書の中の食い違いと、このリポジトリでの扱いは docs/conformance.md にまとめています
README.md この記事
docs/records.md よく使うレコードの一覧と、穴あけ・データセットの説明(日本語)
docs/all-records.md 附属書 A の全 496 ラベルの一覧と日本語の説明
docs/history.md 規格の版の履歴(版ごとの変更とラベルの追加)
docs/conformance.md 規格の節ごとの対応表(実装・テスト・解説・対象外)
docs/requirements.md 規格の義務・推奨・ほかの言い方の義務の文ごとの一覧と、その扱い
docs/conformance-tests.md 対応表の各行・各義務を確かめているテストの一覧(tools/trace.js が作る)
src/vca-records.js 附属書 A の全ラベルの定義表(規格書 PDF から自動生成)
src/vca-parser.js VCA データの読み書きライブラリ
src/vca-session.js 通信の制御(確認応答・タイムアウト・再送・セッションの手順)。デバイス側とホスト側
src/vca-tcp.js vca-session.js を TCP・UDP につなぐ部品(Node.js 専用)
tools/build-records.py vca-records.js を規格書 PDF から作り直すスクリプト
tools/mutate.js 実装をわざと壊してテストが失敗するかを確かめるスクリプト(npm run mutate)
tools/sim-check.js DCS Host Simulator(The Vision Council)につないで照合するスクリプト
tools/trace.js 対応表・義務の一覧とテストを突き合わせ、docs/conformance-tests.md を作るスクリプト(npm run trace)
tests/tests.js パーサーのテスト
tests/session-tests.js 通信の制御のテスト(偽の時計と、メモリ上でつないだデバイスとホスト)
tests/tcp-tests.js TCP・UDP での接続のテスト(Node.js のみ)
tests/run-tests.html テストをブラウザで実行する(開くだけ)
tests/run-node.js テストを Node.js で実行する(npm test)
.github/workflows/ push のたびに GitHub Actions でテストを実行する設定
package.json npm test・npm run mutate・npm run trace の定義(依存パッケージなし)
samples/*.vca 自作のサンプルファイル。どれも鼻側と耳側の形が違うので、左右の向きを見分けられる
_SAMPLE0001.vca 両眼、1440 点(0.25° ごと)
frame-both.vca 両眼、360 点(上の形の 1° ごと)
frame-right.vca 右眼だけ、360 点
frame-uneven.vca 右眼だけ、不等角度の 180 点
データの読み書き(レコード・データセット・パケット)を受け持ちます。通信の制御は次節の vca-session.js です。規格の節ごとの対応は docs/conformance.md にまとめています。
- レコードの解析(左右の値、
?、引用符、_ラベル、|区切りに対応)。データ型の要件(文字の範囲、limited は 12 文字まで、値は 255 文字まで)に合わない値は警告する。ほかにも規格の義務に合わないデータを警告する(左右のレコードの値の数、LTYPEの書き方、XSTATUSとSTATUSの組み合わせ、PROCBLKのブロックの連続、DRILLSの欠かせない欄、機器の状態のMNTに要るレコードなど。一覧は docs/requirements.md) - 附属書 A の全ラベル(表 A.1・A.1a・A.2・A.27、約 500 個)の定義表による判別: 左右か単一か、複数回出現してよいか、廃止されたか(後継ラベル)。測定値の接頭辞(
INS・TOL・TOLV・CK・LD)付きのラベルも判別する - 値の取り出し:
value()・number()(左右の別は定義表に従う)、fieldsOf()・occurrences()(DRILLE・XSTATUS・ENGMARKなどは欄に名前を付けて返す) - データセットの復元: 玉型(
TRCFMT・ZFMT)、削り落とし形状(CRIBFMT)、面の厚み(STHKFMT)、棚(SHLFFMT)は形式 1・2・3・4、角度モード E・U・C に対応。面形状(SURFMT・PASSFMT)、度数分布(PMFMT)、重み(WMFMT)、設計誤差(DDFMT)の表も読む - 形式 4(パックトバイナリ)の符号化と復号。規格 5.4.15.4 の例とバイト単位で一致することをテストで確認
- 穴あけデータ(
DRILLE、廃止されたDRILL)の解釈: 基準(箱中心・縁・外接箱)、穴・長穴・矩形、角度モードの省略時の扱い、グループ、左眼への反転(drillFeatures()・mirrorFeature())。逆向きに、穴の一覧からDRILLEレコードを組み立てる(drillRecords()。穴が無いときはDRILLE=0) - 装置ごとのレコード(
PROC、PROCBLKと1!LABEL=形式のブロック)の取り出し(deviceRecords()) - 初期化: 自動フォーマット定義(
DEF・D・ENDDEF)の取り出し、初期化・要求パケットのTRCFMTなどを「対応形式の候補」として区別し、ホストが使う形式を選んで応答のレコードを作る(negotiate()。玉型・サグ・穴あけの基準・文字コード。使える形式が無ければSTATUS17 と修飾ビット) - プリセットパケット(表 A.5-A.23)の構成と、レコードの不足の確認(
missingPresetRecords()。{ all: true }で必須の印の無いものも含める。附属書 A.3)。自動フォーマット初期化のラベル一覧の不足の確認(missingRecords()) - パケットの組み立てと分解、CRC-16 の計算と検証、レコード順序の確認(ファイルなら
REQ=FILなどの決まりも確認) - 座標への変換、左右反転、デバイスが求める点数と向きへの変換(
resampleTrace())、HBOX・VBOX・周長の計算、データセットの書き出し(形式 1 は 1 行 80 文字以内に分割) - 玉型の中心と大きさの確認(
checkSizing()): 箱の中心のずれ、HBOX・VBOX・CIRCと玉型の食い違い、BSIZとCSIZの両方の指定、片眼の玉型から暗黙に決まるCSIZ、CIRC3DとサグかFCRVから計算した立体の周長(circumference3D())の食い違い - 基準点のずれのラベル(
FBFCINなど)を 2 つの基準点と向きに分ける(referencePoints()) - ステータスコード(修飾ビットを含む)、XSTATUS コード、要求種別、機器の種類の日本語の要約
ブラウザでは vca-records.js、vca-parser.js の順に <script> で読み込むと window.VCA として使えます。Node.js では require('./src/vca-parser.js') で読み込めます(定義表は自動で読み込みます)。定義表が無い場合は、docs/records.md に載せた主なラベルだけを判別します。
接続方式に依存しない通信の制御です。送るバイト列は send で受け取り、届いたバイト列は receive() に渡します。
- 確認応答とタイムアウト(6.1.3): 受け取ったパケットに ACK を返す(CRC が合わなければ NAK)。NAK なら 3 回まで送り直す。CRC の付いたパケットへの応答には、
crcを指定しなくても CRC を付ける(6.1.2.1)。確認応答 6 秒・パケット 12 秒・文字間 5 秒のタイムアウト(TIMEOUTレコードで変更) - 規格に書かれていない乱れへの対処: ACK が化けて相手が同じパケットを送り直してきたら、2 回は処理しない。ACK より先に相手のパケットが届いたら取り置く。順序が崩れたら
STATUS=12(同期ずれ、表 A.24)を送って中止する。切断されたら待ちをすぐclosedで失敗させる。受信中のパケットが上限(既定 1 MiB、maxPacket)を超えたら読み捨てて NAK を返し、GSが抜けても次のFSで読み直す。扱いと理由は docs/conformance.md - デバイス側(
createDevice()): 初期化(自動フォーマット・プリセット)、アップロード(TRC・INS・UPL・CMD)、ダウンロード(EDG・GEN・TIM・LNF・要求 ID など)、通知(INF・MNT)。応答のJOBが要求と同じかを確かめ、セッションを 1 つずつ進める。TCP では接続後 3 秒待つ。初期化の結果のwarningsで、規格の推奨との食い違い(データにDEV・VEN・MODELが無い、ラベル一覧にRやインターフェイスレコードがある)と、ACTを送ったのにホストが返さないことを知らせる。ダウンロードの応答でTRCFMT・ZFMTのあとにデータが続かなければ、応答のwarningsに足す(データが無ければTRCFMT=0・ZFMT=0にする、5.4.1・5.4.5。ホスト側が受け取るアップロードのデータも同じ) - ホスト側(
createHost()): 要求を待ち、種類に合わせて応答する。初期化では要求 ID を割り当て、形式を取り決める(negotiate())。知らない要求 ID にはSTATUS=5、REQ の無いパケットにはANS=ERRとSTATUS=18、応答を作る関数が例外を投げたらSTATUS=8(ホストの内部エラー)と説明文を返す。対応する要求種別はrequestTypesで宣言できる。初期化にACTが来たら、actionsで宣言した操作をACTで返す(7.6.3)。DRLFMTを取り決めた要求 ID には、廃止されたDRILLを送らない(5.5.1.5) - TCP・UDP(
vca-tcp.js、Node.js のみ): ローカル接続(デバイスが 50000 で待つ)、リモート接続(ホストが 33512 で待つ)、オートコネクト(UDP 33511 のREQ=CON)。オートコネクトでは、知らせのIP・PORTの形を確かめ、IPが UDP の送り主と同じ相手にだけつなぐ(allowでつないでよい相手を決められる。断った理由はonIgnoreで分かる)
const T = require('./src/vca-tcp.js');
// ホスト: 33512 で待ち、加工機の要求に加工のデータを返す
await T.listenHost(33512, { onRequest: req => ({ records: [['DO', 'B'], ['HBOX', '52.00', '52.00']] }) });
// デバイス: ホストへつなぎ(3 秒待ってから)、ジョブ 1234 のデータを要求する
const device = await T.connectDevice('192.168.1.10', 33512);
const r = await device.request('EDG', { job: '1234' }); // r.response が受け取ったデータ規格の本文と違う点: 対応しない要求種別(CMD・LNF や requestTypes に無い種別)と、知らない要求種別には STATUS=16 を返します。本文 7.6.2・7.7.2 は対応しない要求種別に STATUS=8 を返すとしていますが、表 A.24 では 8 は「ホストの内部エラー」で、「要求の種類が分からない」は 16 です。このライブラリは番号の意味を定めた表 A.24 に合わせ、本文の 8 は誤記と考えています(推測)。本文どおり 8 にしたいとき、または DCS Host Simulator と同じ 18 にしたいときは、createHost({ statusCodes: { unsupportedRequest: 8, unknownRequest: 18 } }) のように番号を変えられます。理由の詳細は docs/conformance.md にあります。
デバイス側は、0 以外の STATUS を番号によらず失敗として扱い(STATUS=5 なら初期化をやり直す)、結果に番号(status)と説明文(statusText)を入れて返します。相手のホストが 8・16・18 のどれを返しても同じように動きます。
シリアル接続(RS-232C)の部品はありません。シリアルポートのライブラリの受信を receive() に、send を書き込みにつなげば同じように使えます。
実際の機器とつながるかは確かめていません。独立した実装との照合として、The Vision Council の DCS Host Simulator(ホスト役)に createDevice でつなぎ、初期化・ダウンロード(形式 1・4)・アップロード・TIM・INF などが通ることを確かめています(tools/sim-check.js)。照合から対応したことは、Simulator と規格の不整合とあわせて docs/conformance.md にまとめています。
テストは、ブラウザで tests/run-tests.html を開くか、Node.js 18 以上で次のコマンドを実行します。依存パッケージは無いので npm install は要りません。GitHub では push のたびに Node.js 18・20・22 で自動実行されます。samples/ のファイルのテスト(警告が無いこと、左右の向き、どのファイルも同じ形であること)と TCP・UDP のテストは、ファイルやソケットを使うため Node.js でだけ行います。
npm testどのテストが対応表のどの行(規格の節)を確かめているかは、docs/conformance-tests.md で分かります。各テストに確かめる行と確かめ方(正常・異常・境界・規格の例・Simulator)を書いてあり、npm run trace がこの一覧を作ります。GitHub Actions は、対応表で ◎ の行に正常系と異常系(または境界値)の両方のテストがあること(理由を書いて例外にした行を除く)、一覧が古くないことを確かめます。
規格の「しなければならない」「してはならない」(義務)、「するのがよい」(推奨)、ほかの言い方で書かれた義務は、文ごとに docs/requirements.md に一覧にし、このライブラリが確かめるもの・利用者や装置が守るもの・扱わないものに分けてあります。確かめるものにはテストに番号を書いてあり(req: [番号])、GitHub Actions が、テストの無い文が無いことも確かめます。確かめられるのにまだ確かめていない義務があれば、扱いを「未対応」にして、一覧の末尾にまとめます。
テストが本当に処理を確かめているかは、ミューテーションテストで調べられます。実装の一部(境界値・分岐・規格の数値など。壊し方の一覧は tools/mutate.js)を 1 つずつわざと壊してテストを走らせ、壊してもテストが通ってしまうもの(生き残り)を一覧にします。生き残りがあれば、その処理を通る場面をテストが作っていないということです。壊したファイルは毎回元に戻します。数分かかるので、GitHub Actions では動かしていません。一覧に無い壊し方まで検出できる保証ではないので、処理を足したら tools/mutate.js にも壊し方を足してください。
npm run mutatevca-records.js に入っているのは、ラベル・データ型の記法・左右の別・単数/複数・廃止と後継・プリセットの構成といった事実だけで、規格の説明文は含めていません。各ラベルの意味は docs/all-records.md に日本語で書き起こしています。正確な定義は規格書で確認してください。規格書の表 A.1 で HBO となっている行は、本文・プリセット表・例に合わせて HBOX として収録しています。同じように、表 A.16 の INSSGUP は INSSGOCUP として収録し、説明文でだけ廃止とされている CTHK・CKPRHI・CKPRVI・CKTHK にも廃止の印を付けています。
- The Vision Council, Data Communication Standard v3.14(2025): 規格の原文(英語、無料) https://thevisioncouncil.org/sites/default/files/assets/media/DCS_v3.14_Final.pdf
- The Vision Council 技術フォーラム(DCS の Q&A) https://forums.thevisioncouncil.org/
- JIS T 7335:2005 眼鏡レンズ製造システム間の情報交換: 日本産業標準調査会(JISC)の JIS 検索で閲覧できます
- OptiBoard(眼鏡業界の英語フォーラム)の OMA 関連スレッド
- eeng/lens_protocol: Ruby による OMA パーサー
- この記事とコードは個人が規格を読んで作成したもので、The Vision Council や JIS とは関係ありません。規格への準拠を保証するものではありません。実機との接続に使う場合は、機器メーカーの資料と規格の原文で確認してください。
- The Vision Council、VCA、OMA、Data Communication Standard などの名称は、それぞれの権利者に帰属します。このリポジトリは公式のものではなく、権利者から承認や支援を受けたものでもありません。
- 文章(README.md と docs/)は © 2026 Nriv、CC BY 4.0 で提供します。コードは MIT License です。
- これらのライセンスが対象とするのは、このリポジトリの文章とコードだけです。規格そのものの著作権は The Vision Council に帰属し、ここでは許諾していません。