JSON データ構造の仕様
最終更新: 2026-09-23 / 対象: spec-platform/v1
4 つのエディタが保存・読み込みする JSON の構造です。仕様を公開しているので、 エディタを使わずにデータを作っても構いません。
このページは、人が読むためだけでなく AI に読ませるために書いています。 「この仕様に従って JSON を作って」と頼めば、手元の Excel や仕様書から作図できます。 逆に、エディタで作った JSON を貼って「この仕様の意味で矛盾を探して」と頼むこともできます。 実際の手順は AI に仕様書を描かせる にまとめました。
1. 共通の外枠
4 つとも、先頭に「何のファイルか」を書きます。ここを見れば、残りの読み方が決まります。
{
"schema": "spec-platform/v1",
"kind": "timingchart",
"v": 5,
"title": "位置決め起動ハンドシェイク"
}
| 項目 | 型 | 説明 |
|---|---|---|
| schema * | string | 常に "spec-platform/v1"。この文字列がある JSON は、以下の構造に従います。 |
| kind * | string | systemdiagram / addressmap / timingchart / flowchart のいずれか。 |
| v * | number | その kind の中での形式の版(JSON の書き方の版です。図の改訂は revisions)。構成図 1・メモリマップ 3・タイミングチャート 5・フローチャート 1(2026-09 時点)。
読み込み側は、自分より古い版を受け付けます。 |
| title | string | 図や表の題名。空でも構いません。 |
| revisions | array | 図の改訂履歴。古い順に並べ、最後の行が今の版です。エディタの「ファイル → 版と改訂履歴…」で書き、
書き出す図の題名の横と Markdown の見出しに今の版(例 Rev. B(2026-09-29))を出します。空なら書きません。承認の状態は持ちません。 |
id の決まり: 同じファイルの中で重複しない文字列であれば何でも構いません。
エディタは dev_01 や row_ab12x のような値を振りますが、
"PLC" のような読みやすい文字列でも動きます。
他の項目から参照されるので、後から変えないでください。
revisions[] の項目
"revisions": [
{ "rev": "A", "date": "2026-09-01", "author": "山田", "note": "初版" },
{ "rev": "B", "date": "2026-09-29", "author": "山田", "note": "検査完了の信号を追加" }
]
| 項目 | 型 | 説明 |
|---|---|---|
| rev | string | 版の記号(A・B・1・2 など)。「版を上げる」は末尾の英字・数字を 1 つ進めます。 |
| date | string | 改訂した日(YYYY-MM-DD)。保存や書き出しでは変わりません。 |
| author | string | 担当(改訂した人)。 |
| note | string | 改訂の内容。「前の版と比べる」の一覧をコピーして貼れます。 |
2. systemdiagram — システム構成図
機器(devices)と、その間の通信(links)で表します。
| 項目 | 型 | 説明 |
|---|---|---|
| machineId | string | 装置 ID。PLC ごとのメモリマップ・図の一覧・装置ファイルを装置ごとに分けます。エディタが作るので、書かなくて構いません。 |
| devices[] | array | 機器。下の表を参照。 |
| links[] | array | 機器どうしの通信。下の表を参照。 |
| variables[] | array | メモリマップへ受け渡すときに使う。空でも構いません。 |
| triggers[] | array | タイミングチャートへ受け渡すときに使う。空でも構いません。 |
devices[] の項目
| 項目 | 型 | 説明 |
|---|---|---|
| id * | string | この機器の識別子。links から参照されます。 |
| name * | string | 図に出る名前。 |
| kind | string | plc / hmi / pc / servo /
inverter / robot / io / unit / sensor /
net / other。省略すると other。色と形が変わります。
io はリモート I/O、unit は CPU やリモート I/O に連結する I/O ユニット、net は HUB などのネットワーク機器です。 |
| model | string | 型式(例 Q06UDHCPU)。 |
| addr | string | IP アドレスや局番。 |
| comment | string | 備考。 |
| x, y | number | 図の中の位置。省略可。省略したときは「自動整列」で並べてください。 |
| blocks[] | array | 機器の中の機能のまとまり(「指令」「状態」など)。
{ "id", "name", "comment", "varIds": [] }。
メモリマップへ渡したときの変数の入れ物になります。 |
| location | string | 置き場所(制御盤 / 操作盤 / 機上中継 BOX など)。同じ置き場所の機器は、図で名前付きの枠に囲まれます(枠の位置は機器から決まるので、座標は書きません)。
ほかのツールへ渡す機器名には混ぜません。省略可。 |
| safety | boolean | 安全機器(安全 PLC・安全リレー・非常停止・ライトカーテン・安全扉スイッチなど)なら true。図と機器一覧で見分けられます。省略可。 |
| controller | string | 所属先。リモート I/O(io)は入出力として使う PLC(plc)の devices[].id、
I/O ユニット(unit)は連結している PLC かリモート I/O の devices[].id。
リモート I/O・ユニットは PLC の入出力を延ばしたもので、指令を出すのは所属先をたどった先の PLC です。
そこから出る配線には「M:PLC の名前」が付き、メモリマップではその PLC の中のブロック(ユニットはリモート I/O の中)になります。省略可。 |
links[] の項目
| 項目 | 型 | 説明 |
|---|---|---|
| id * | string | この通信の識別子。 |
| from, to * | string | つなぐ機器の devices[].id。 |
| kind | string | ネットワークの種類。EtherCAT / EtherNet/IP / CC-Link IE /
PROFINET / Modbus TCP / Ethernet / RS-232C /
RS-485 / USB など、文字列をそのまま書きます(一覧に無い通信は、その名前をそのまま。例 SLMP)。
フィールドバスは実線、シリアルは破線、配線(デジタル I/O / アナログ I/O / パルス列)は点線、
CPU・ユニットどうしのつながりは ユニット連結(太い実線)です。 |
| label | string | 線に添える文字(例 局番 1)。 |
| fromAddr, toAddr | string | 線の端の番地。from / to の機器の、この線(ポート)での IP アドレス(/24 付きも)か局番(例 "192.168.3.39/24"・"局番 1")。
PLC が 2 つのネットワークに出ているときのように、ネットワークごとの番地を書き分けます。無ければ書きません。
エディタは、同じネットワーク(HUB でつながった同じ種類の線。CC-Link IE Safety / CIP Safety / FSoE / PROFIsafe は、その上を流れる CC-Link IE / EtherNet/IP / EtherCAT / PROFINET と同じ種類とみなします)で番地が重なっているときと、サブネットが分かれているときに警告します。
線に番地が無く、機器の通信の線が 1 本だけなら、機器の addr をその線の番地とみなします。 |
| dir | string | "both"(双方向・既定)か "one"(片方向)。 |
| safety | boolean | 安全の通信・安全配線なら true(二重線で描きます)。kind が
CC-Link IE Safety / FSoE / CIP Safety / PROFIsafe / 安全配線 の線は、書かなくても安全の線です。省略可。 |
| style | string | その他 と、エディタの一覧(EtherCAT / EtherNet/IP / CC-Link IE / CC-Link / PROFINET / Modbus TCP / MECHATROLINK / Ethernet / RS-232C / RS-485 / Modbus RTU / USB / デジタル I/O / アナログ I/O / パルス列 / ユニット連結 / CC-Link IE Safety / FSoE / CIP Safety / PROFIsafe / 安全配線)に無い名前の線の描き方。bus(通信・既定)/ serial(シリアル)/ io(配線)/
power(電源。DC24V など。M / S を持たず、通信のつながりに数えません)。一覧にある種類(その他を除く)の線では書きません。 |
| master | string | マスター側の機器の devices[].id(from か to のどちらか)。
図では端に M / S が付きます。A のスレーブが C のマスターを兼ねるような多段のネットワークは、
線ごとに指定します。省略するとマスター / スレーブの指定なしです。
配線(デジタル I/O / アナログ I/O / パルス列 / 安全配線、style が io / power の線)と ユニット連結 では使いません。
一方が HUB(net)の線は、HUB の先の機器の id も書けます(HUB は素通りとして、その機器がマスター)。
同じ種類の線で数珠つなぎにした先の機器の id も書けます(PLC ─EtherCAT─ X軸 ─EtherCAT─ Y軸 の、X軸 ─ Y軸 の線のマスターは PLC)。
ほかの PLC の先へは続かず、RS-232C / USB は数珠つなぎにしません。M はその機器の側の端に付きます。 |
| waypoints[] | array | 手で整えた線の経路。[{ "x": 260, "y": 180 }, …] の順に通ります。
省略すると機器の位置関係から自動で経路が決まります(ふつうは省略します)。
エディタで線の途中をドラッグしたときに記録されます。 |
3. addressmap — メモリマップ
PLC のデバイス範囲(plc)と、変数の一覧(variables)で表します。 エディタは下の v3 の形で書き出し、v1 / v2 も読みます。すぐ下の 2 つの表は v2 の形です。
| 項目 | 型 | 説明 |
|---|---|---|
| plc | object | メーカーと機種、使えるデバイス範囲。{ "vendor", "model", "bitDev", "wordDev", "devices": [] }。
bitDev / wordDev は自動割付の既定の行き先(例 "M" と "D")。 |
| plc.devices[] | array | デバイスごとの範囲。{ "code": "D", "name": "データレジスタ", "style": "word",
"bits": 16, "radix": 10, "start": 0, "end": 12287 }。停電保持(ラッチ)の範囲があれば "latchStart" / "latchEnd"(番号)。
style は bit(1 点 1 ビット)/ word(1 点 16 ビット)/
chbit(KEYENCE 式。R100 が 1 チャンネル目のビット 0)/ byte(マイコン)/
iec(IEC 61131-3。%MX0.0・%MW10)。
radix は番号の進数(10 か 16。三菱 iQ-F の X / Y は 8)。
"notation": "s7" は Siemens の書き方(%M0.0、%MW10 の 10 はバイト番号)。 |
| devices[] | array | 機器と、その中のブロック。{ "id", "name", "comment", "blocks": [ { "id", "name", "comment", "varIds": [] } ] }。
構成図の devices / blocks と同じ考え方です。 |
| variables[] | array | 変数の一覧。下の表を参照。 |
| settings | object | コード生成の設定。{ "structName", "iecWordIndex" }。 |
variables[] の項目
| 項目 | 型 | 説明 |
|---|---|---|
| id * | string | この変数の識別子。 |
| name * | string | 変数名(例 bStartReq)。 |
| type | string | BOOL / INT / DINT / WORD /
REAL など。IEC 61131-3 の型名をそのまま書きます。 |
| role | string | 向き。"M"(マスター側が出す)/ "S"(スレーブ側が出す)/
"I"(内部)。タイミングチャートの方向欄になります。 |
| address | string | 割り付けた先(例 M0 / D100)。
空にしておくと、エディタ側で自動割付できます。 |
| bit | number / null | ワードデバイスの中のビット番号。使わないときは null。 |
| initialValue | string | 初期値。 |
| comment | string | デバイスコメントになります。 |
| addrText | string | 表示用のアドレス。ビットを 16 進で書くデバイス(例 D100.F)で、address.bit(10 進)と違うときだけ書きます。 |
| peerAddress | string | 相手側の番地(リンクデバイスや相手の機器の番地。例 RX10・DI101・Asm101 +0)。
書き方は自由で、エディタは比べません。無ければ書きません。 |
| unit | string | 工学値の単位(例 MPa・mm/s・%)。無ければ書きません。 |
| engMin, engMax | number | 工学値の下限・上限(例 0〜1 MPa)。生の値が増えると工学値が減る逆作動は、engMin に大きい方を書きます(例 100〜0 %)。 |
| rawMin, rawMax | number | 生の値(PLC のデバイスに入る値)の下限・上限(例 A/D の 0〜32000)。
工学値 = engMin + (生の値 − rawMin) × (engMax − engMin) / (rawMax − rawMin)。
タイミングチャートへ渡すと、行の単位と縦の目盛り(unit / min / max)になります。 |
| retain | boolean | 停電保持の変数なら true(レシピ番号・生産数など)。ブロックの retain も引き継ぎます。
IEC の GVL では VAR_GLOBAL RETAIN に分け(番地付き AT %… の変数は入れず、コメントに[保持]。保持はラッチの設定で決まるため)、デバイスのラッチ範囲の外にあれば警告します。 |
| safety | boolean | 安全プログラム側の信号(非常停止・ライトカーテンなど)なら true。
型が SAFEBOOL などの安全の型なら書かなくても安全の信号です。ブロックの safety も引き継ぎます。 |
| interlock | array | インターロック(この出力が動いてよい条件)。すべての条件が成り立つときだけ動いてよい、の 1 組で、自動・手動・原点復帰で共通です(モードで分けません)。
条件は { "varId": "v_…", "name": "bClampOK", "on": true }(同じメモリマップの変数が ON / OFF)か、{ "text": "圧力 0.4 MPa 以上" }(変数で書けない条件)。
正は varId で、name は表示用です(varId が無ければ名前で探します)。装置の整合チェックで、タイミングチャートの波形と照らし合わせます。無ければ書きません。 |
| deviceId, blockId | string | どの機器・どのブロックに属するか。 |
v3:ブロックは範囲のリストと入れ子
1 つのブロックが X・Y・M・D のようにデバイスをまたいで範囲を持ち、 ブロックの中にブロックを任意の深さで入れられます(例:リフタ > 指令 > 起動)。 前の版のツールへ渡すときは「出力 → 書き出し… → JSON(旧版 v2)」で書き出せます(入れ子と 2 つ目からの範囲は入りません)。
| 項目 | 型 | 説明 |
|---|---|---|
| v | number | 3。 |
| controller | object | このメモリマップの PLC(構成図の PLC の { "id", "name" })。
メモリは PLC ごとにあるので、1 ファイルは PLC 1 台ぶんです。構成図から PLC を選んで渡すと付きます。省略可。 |
| devices[] | array | 機器。{ "id", "name", "comment", "addr" }。ブロックは持ちません(下の blocks[] の deviceId で結びます)。
addr は IP アドレスや局番で、構成図から受け取ると構成図の機器の番地(無ければ線の端の番地)が入ります。 |
| blocks[] | array | ブロックの表。親を先に並べます。下の表を参照。 |
| variables[] | array | v2 と同じ項目。blockId が所属の正で、番地を含むいちばん内側のブロックを指します。
device / block は表示用の名前で、block は「リフタ/指令」のような入れ子の名前です。 |
| layout | object | 見た目だけ。{ "collapsed": [id, …] }(たたんだ機器・ブロック)。無くても図になります。 |
| naming | object | 命名規則。{ "typePrefix": { "BOOL": "b", "INT": "i" }, "maxLen": 32, "forbidden": ["tmp"], "pattern": "^[bidr][A-Z][A-Za-z0-9]*$", "note": "社内規約 第 3 版" }(決めた項目だけ)。
変数の名前が合わなければ確認事項に出し、装置の整合チェックではタイミングチャートだけにある信号の名前も同じ規則で見ます。 |
blocks[] の項目(v3)
| 項目 | 型 | 説明 |
|---|---|---|
| id * | string | このブロックの識別子。タイミングチャートの対象の区画(scope)からも指されます。 |
| deviceId | string | どの機器のブロックか(devices[].id)。 |
| parentId | string / null | 親のブロックの id。null なら機器の最上位。深さの上限はありません。 |
| name * | string | 名前。階層の名前は持たず、表示は「親/子」のパスです。 |
| comment | string | 用途。 |
| owner | string | 書き込む区画(機器かブロックの id)。無ければ親から継承します。 |
| addr | string | 局番や IP アドレス(リモート I/O・ユニットのブロックなど)。 |
| retain, safety | boolean | 中の変数をすべて停電保持・安全の信号にするなら true。入れ子の子のブロックと変数が引き継ぎます。 |
| ranges[] | array | 確保した範囲。デバイスごとに 0 個以上。下の表を参照。 |
ranges[] の項目(v3)
| 項目 | 型 | 説明 |
|---|---|---|
| dev * | string | デバイスの記号(plc.devices[].code)。 |
| from * | string | 先頭の番地(例 "X100")。16 進の X や KEYENCE の書き方は PLC 設定で読み解きます。 |
| to | string | 末尾の番地(例 "X11F")。省略すると from と同じ。 |
| type | string | 行を足したときの型(例 "BOOL" / "INT")。 |
| link | object | リンク側の範囲 { "from", "to" }(この範囲をリフレッシュ先とするリンクデバイス。例 { "from": "RX0", "to": "RX1F" })。
to を省略すると from と同じ。無ければ書きません。
ネットワークが 2 つ以上あるときは J1\RX0・J2\RX0 のように J 番号を付けて書き分けます(J 番号が違う範囲は比べません)。 |
- 子の範囲は、親の同じデバイスの範囲の内側に収めます。同じ親の下のブロックどうし(最上位はプロジェクト全体)の範囲は重ねません。 外れていても保存は止めず、エディタのチェックに注意として出します。
- v1 / v2 のファイルは、どのブロックも「範囲 1 個(area)の最上位のブロック」として読みます。
- リンク側の範囲が RX / RY / RWr / RWw / LB / LW / LX / LY の 16 進の書き方なら、点数(ビットで数える。RWr・RWw・LW は 1 点 16 ビット)がリフレッシュ先の範囲と合うか、
ほかの範囲のリンク側と重ならないかを確かめ、食い違えばチェックに注意として出します。ほかの書き方(
Asm101 +0など)は比べません。 - 変数の番地が、ほかのブロックが確保した範囲の中ならエラー、自分のブロックの確保の外なら注意です。確保の無いデバイスの番地は何も言いません。
ただし、PLC の機器のブロック(入力ユニットなど)の確保と、ほかの機器の変数・確保は比べません(入力ユニットの点に、配線したコンベアの信号が入るのはふつうです)。
PLC がどの機器か分からないマップ(
controllerの無いもの)では、ほかの機器のブロックの確保は比べません。 ワード(WORD / INT など)の変数と、その中の 1 ビットを指す BOOL の変数(例D100とD100.3)は、同じ機器なら重なりのエラーにしません。
4. timingchart — タイミングチャート
行(rows)が信号、列が Step です。波形は values[] の配列で持ちます。
| 項目 | 型 | 説明 |
|---|---|---|
| steps * | number | Step 数(列の数)。 |
| docId | string | 図の ID。装置ファイルにタイミングチャートが何枚もあるとき、保存でどれを差し替えるかを見分けます。エディタが付けるので、書かなくて構いません。 |
| meta | object | { "title", "note", "stepMs", "master", "slave" }。
stepMs は 1 Step の時間[ms]。0 なら Step 番号だけを表示します。
master / slave は機器名で、方向欄とフローチャートのレーン名になります。 |
| rows[] | array | 信号 1 本ぶん。下の表を参照。 |
| triggers[] | array | 因果関係の矢印。{ "from": { "varId": "row_a", "step": 2 },
"to": { "varId": "row_b", "step": 3 } }。
「どの信号の変化が、どの信号の変化を起こしたか」を残します。
フローチャートへ渡すと、待ちと処理の順序になります。矢印の無い変化は、待ちの判断になりません。
端には "level": "high" / "low" を添えられます。変わり目の上下どちらの角に
矢印を付けるかで、見た目だけの指定です。省略すると「変わったあとのレベル側」になります。
"time": { "max": 3000, "min": 200, "note": "超えたら異常" } を添えると、原因の変化から結果の変化までの
時間の条件[ms]になります(同じ信号の変化どうしならパルス幅・保持時間)。描いた遅れが合わなければ警告し、
フローチャートを作るとき上限は待ちの時間切れになります。 |
| stepTimes[] | array | { "step": 5, "ms": 3000 }。その Step だけ、meta.stepMs と違う時間がかかります(3 s の検査を 1 Step に縮めて描くなど)。
時刻・遅れ・全体の時間は、各 Step の時間を先頭から足し上げて出します。stepMs が 0 なら時刻は出しません。 |
| cases[] | array | 分かれ道(ケース)。{ "id", "name": "NG", "at": 5, "rows": [{ "id": "row_a", "values": [...] }], "triggers": [...] }。
S0〜S{at-1} はこの図と同じで、rows[].values は S{at} から最後の Step までの値(長さ steps − at)です。書いていない行は、この図の値のままです。
triggers は、結果の Step が at 以上の矢印です。この図の名前は "caseName": "OK"(省略すると「通常」)。
フローチャートを作るとき、S{at} に多分岐が入り、ケースごとの並びにつながります。 |
| bands[] | array | 区間。{ "id", "from": 3, "to": 9, "name": "検査中" }。目盛りの上に帯で描きます。
"repeat": { "cond": "NG の間", "max": 2 } を添えると、区間の最後まで進んだら区間の初めへ戻ります(max は最大回数で、省略できます)。
フローチャートを作るとき、区間の最後に戻りの判断が入ります。区間の入れ子は構いません。 |
| variables[] | array | チャートの行を、4 ツール共通の形(メモリマップの変数と同じ項目)で並べたもの。
id は rows[].id と同じです。書き出すときに自動で付きます。
rows が無い JSON を読み込んだときは、これを左の変数リストに取り込みます。 |
| library[] | array | 左の変数リスト(チャートに置く前の候補)。{ "id", "name", "type", "comment", "role" }。省略可。
メモリマップから受け取った変数には、どの機器・ブロックのものかを示す
"deviceId" / "device"(機器名)/ "blockId" / "block" が付きます。
"address" / "bit" は割り付けた先で、ビットを 16 進で書くデバイスは表示用の "addrText"(例 D100.F)も付きます。
"mapId" はメモリマップの変数 id で、メモリマップで名前を変えても同じ変数として受け取り直せます。
"unit" / "engMin" / "engMax" / "rawMin" / "rawMax" / "retain" / "safety" はメモリマップの変数と同じで、
行にすると単位と工学値の範囲が行の unit / min / max になり、安全の信号の行には「安全」の印が付きます。 |
| controller | object | このチャートのマスターの PLC(メモリマップの controller と同じ { "id", "name", "machineId" })。
メモリマップから受け取るとき、マスターがその PLC なら付きます。PLC の名前が変わったとき、マスターの名前を合わせるのに使います。省略可。 |
| scope | array | 対象の区画。メモリマップの機器の id(devices[].id)の配列です。省略すると全体の図です。
1 つなら「その区画の図」で、区画が書き込まない信号の方向が "S"(区画からの出力)だとエディタが警告します。
2 つ以上なら区画間のインターフェース図です。区画の名前は library[] の device から引きます。 |
rows[] には、見た目の指定として
"edge"(その行だけの切り替わりの描き方。値は下の edgeMode と同じ)、
"disp": "wave"(値のブロックではなく波形でプロットする)、
"unit"(mm・ms・V など)、"min" / "max"(縦の目盛り)を
添えられます。いずれも省略可で、省略すると値のブロックになり、目盛りはその行の値の範囲に合わせます。 | ||
| showAddr | boolean | true なら信号名の前にアドレス(library[] の address、BOOL はビットも)を出します(画面・SVG・PNG・draw.io)。省略すると出しません。 |
| edgeMode | string | BOOL の切り替わりの描き方。"v"(垂直・既定)/ "s1"(斜め・小)/ "s2"(斜め・大)。
ほかの値は "v" として扱います。数値・状態の値の変わり目は、これにかかわらず交差で描きます。 |
rows[] の項目
| 項目 | 型 | 説明 |
|---|---|---|
| id * | string | この行の識別子。triggers から参照されます。 |
| name * | string | 信号名。 |
| lib | string | この行の変数(library[].id)。行の名前だけを変えても、アドレスはこの変数のものです。省略すると同じ名前の変数を指します。 |
| type | string | BOOL(と SAFEBOOL)なら ON/OFF の波形、それ以外は値を表示するバスになります。 |
| role | string | "M" / "S" / "I"。variables と同じ。 |
| peer | string | この行の相手(PLC・ロボット・カメラのような 3 者以上のやり取り)。省略するとスレーブ(meta.slave)。
role が "M" なら master → peer、"S" なら peer → master の信号です。 |
| comment | string | 信号名の下に小さく出ます。 |
| values[] * | array | 長さは steps と同じ。BOOL は true / false、
数値・状態は文字列("1000" / "RUN")、未設定は null。 |
5. flowchart — フローチャート
記号(nodes)と、その間の線(edges)で表します。
| 項目 | 型 | 説明 |
|---|---|---|
| docId | string | 図の ID(タイミングチャートと同じ)。書かなくて構いません。 |
| nodes[] | array | { "id", "type", "text", "x", "y" }。
type は start / end / process /
decision / switch / fork / join / io / wait /
sub / loopStart / loopEnd / connector /
note / state / anyState(省くと process として読みます)。text の改行は \n で書きます。
switch(多分岐)は "cases": ["1", "2"] の値ごとに出口を持ちます。
fork(並列の始まり)は "branches": 2 本の枝が同時に始まり、
join(並列の終わり)は入ってくる枝が全部終わったら 1 本で出ます(JIS の並列処理の二重線)。
x / y は省略可(「自動整列」で並べられます)。
"refs": [{ "varId": "row_a", "name": "bReq" }] は記号が扱う信号で、元のタイミングチャート(source.docId)の
rows[].id を指します(省略可)。タイミングチャートから作ると付き、名前が記号の文字に無い・チャートで名前が変わった・チャートから消えた、を自動チェックで知らせます。
"step" は固定の工程番号(例 "S10")で、1 つでも書いた図では自動の番号の代わりにこれを出します(図を直しても変わらず、「工程番号を振り直す」でだけ書き換わります。重なっていれば知らせます)。
"device" はその工程に割り付けるデバイス(例 "M110")。
定義済み処理(sub)の "ref": { "docId", "title" } は参照先のフローチャート(原点復帰・異常処理など、同じ装置の別の図)で、記号から開けます。
状態遷移図は "type": "state"(状態)で描きます。"events": ["起動", "停止"] のイベントごとに出口 "c0"・"c1"… があり、
"entry"(入ったときの処理)・"ignore"(受け付けない=何もしないイベント)・"never"(起こりえないイベント)・
"actions": [{ "event", "text" }](状態は変えずに処理だけするイベント)・"ref"(その状態で動かす工程のフロー)を持てます。
どの状態からでも起こる遷移(異常・非常停止など)は "type": "anyState" に "events" と "scope"(対象の状態の id。省略すると全部の状態、空の配列は対象なし)で書きます。
状態のある図は、Markdown と AI 向けテキストに状態 × イベントの表(→ 移る先・文字 処理だけ・/ 受け付けない・× 起こりえない)が付きます。
呼ばれる図には同じ "docId" を書いておきます(書いていない図にはエディタが別の ID を付けるので、結び付きません)。
自動で作った記号には "gen"(鍵)と "gh"(作った時点の指紋)が付き、「作り直す」で手で足した記号・線と手で直した文字を残すのに使います(書かなくて構いません)。 |
| edges[] | array | { "id", "from", "port", "to", "label" }。
label は線の文字で、省略すると出口の文字(YES / NO、switch の値)になります。
state・anyState から出る線の名前はイベントの名前で、label は使いません。
port は "out"(通常の出口)/ "yes" / "no"(判断の分岐) /
"c0"・"c1"…(switch の値ごと、fork の枝ごと、state・anyState のイベントごと)/
"timeout"("timeout": ms を書いた wait・decision の時間切れ)。
判断の no を自分自身に戻すと「成立するまで待つ」ループになります。
1 つの出口から出せる線は 1 本です(記号に無い出口の線・同じ出口の 2 本目は、確認事項で知らせます)。port を省くと、出口が 1 つの記号(処理など)では "out" として読みます。
id を省いた線・ほかの線と重なった線には、読み込むときに新しい id を振ります(links[] も同じ)。
"waypoints": [{ "x", "y" }, …] を添えると、その点を通る経路で描かれます
(省略すると記号を避けて自動で経路が決まります。ふつうは省略します)。 |
| lanes[] | array | 担当の列。{ "id", "role": "M", "name": "PLC" }。
使うときは各 node に "lane": "<lanes[].id>" を持たせます。 |
| links[] | array | レーンをまたぐ信号の受け渡し(点線の矢印)。{ "id", "from", "to", "label" }。
from / to は nodes[].id。 |
| settings | object | { "yesNo": "YES/NO", "yesDir": "down", "stepNo": false, "stepStart": 10, "stepInc": 10 }。
yesDir は YES の出る向き("down" / "right")。stepPerLane は工程番号をレーンごとに振ったなら true。 |
| scope | array | 対象の区画(メモリマップの機器の id の配列)。タイミングチャートと同じ意味です。省略すると全体の図です。 タイミングチャートから作ると引き継ぎます。 |
| partitions[] | array | 区画の名前の表。{ "id", "name" }。scope を名前で見せるためのもので、
区画の分かるタイミングチャートから作ったときに付きます。省略可。 |
| source | object | タイミングチャートから作ったときの元の図。{ "docId", "title", "opt" }。
「作り直す」は、この docId のタイミングチャートから作ります。エディタが付けるので、書かなくて構いません。 |
| controller | object | この図がどの PLC の工程か(タイミングチャート・メモリマップの controller と同じ { "id", "name", "machineId" })。
タイミングチャートから作ると引き継ぎます。装置の整合チェックで、記号の割付デバイス(device)を、その PLC のメモリマップの変数の番地と照らし合わせます。省略可。 |
6. 最小の実例
そのままエディタの「ファイル → 開く…」で読めます。フローチャートの例です。
{
"schema": "spec-platform/v1",
"kind": "flowchart",
"v": 1,
"title": "コンベア運転",
"nodes": [
{ "id": "s", "type": "start", "text": "開始" },
{ "id": "n1", "type": "process", "text": "初期化\nbConvRun ← OFF" },
{ "id": "d1", "type": "decision", "text": "起動ボタン ON ?" },
{ "id": "n2", "type": "process", "text": "bConvRun ← ON" },
{ "id": "e", "type": "end", "text": "終了" }
],
"edges": [
{ "id": "e1", "from": "s", "port": "out", "to": "n1" },
{ "id": "e2", "from": "n1", "port": "out", "to": "d1" },
{ "id": "e3", "from": "d1", "port": "yes", "to": "n2" },
{ "id": "e4", "from": "d1", "port": "no", "to": "d1" },
{ "id": "e5", "from": "n2", "port": "out", "to": "e" }
]
}
x / y を書いていませんが、それで構いません。
座標が無いデータは、読み込んだときに自動で並べます。
位置を自分で決めたいときだけ書いてください。
貼り付けて読み込む
ファイルに保存しなくても構いません。どのエディタでも 「ファイル → 取り込み… → JSON を貼り付ける」から、本文をそのまま貼って読み込めます。 AI が返した JSON も、コピーしてここに貼れば図になります。
7. 読み込み側の決まり
- 知らない項目は無視します。 余分なキーを足しても壊れません。
- 足りない項目は既定値で補います。 上の表で * が付いていない項目は省略できます。
- id の参照が切れている行は読み飛ばします。 存在しない id を指す edge や trigger は捨てられます。
- 座標は無くても構いません。 自動整列で並べ直せます。
- 保存したファイルに配色や表示倍率は含まれません。人に渡しても相手の画面設定は変わりません。
8. 自分のデータを見るには
どのエディタでも 「出力 → 書き出し…」で JSON を選んで「クリップボードにコピー」を押すと、保存するのと同じ中身がクリップボードに入ります。 戻すときは 「ファイル → 取り込み… → JSON を貼り付ける」。ファイルを経由せずに往復できます。 実際の形を見たいときは、サンプルをエディタで開いてから書き出すのが早いです。
9. Schema・検証・例
同じ内容を JSON Schema(draft 2020-12)でも公開しています。
AI に作らせた JSON や、ほかのツールから書き出した JSON を、エディタで開く前に機械で確かめられます。
Schema が決めるのは形だけで、知らない項目は禁止していません(7 章の「知らない項目は無視します」と同じです)。
そのため、省略できる項目の綴り違い(edges の from を source と書くなど)はエラーになりません。図に線が出ないことで気づくことになります。
| ファイル | 中身 |
|---|---|
| common.schema.json | 共通の外枠(1 章)と、id・向き(role)・変数・因果関係の矢印などの部品。4 つの kind の Schema から参照します |
| systemdiagram.schema.json | 2 章 システム構成図 |
| addressmap.schema.json | 3 章 メモリマップ(v1 / v2) |
| addressmap.v3.schema.json | 3 章 メモリマップ v3(範囲のリストと入れ子) |
| timingchart.schema.json | 4 章 タイミングチャート |
| flowchart.schema.json | 5 章 フローチャート |
| machine.schema.json | 10 章 装置ファイル(draft)。中の文書は kind ごとの Schema で確かめます |
| validate.mjs | 検証スクリプト(下を参照) |
| examples/index.json | 例の一覧(下を参照) |
| ai/prompts.md | AI に kind ごとの JSON を作らせる、短い頼み方の例 |
| ai/instructions.md | Claude の Project や GPTs の指示に貼る文。毎回の前置きを省けます |
検証のしかた
Node.js(18 以降。いま入れるなら LTS 版)があれば、ほかに何も入れずに確かめられます。上の Schema 7 つと validate.mjs を同じフォルダに置き、確かめたい JSON を並べて実行します。 ファイルは、リンクを右クリックして保存するか、curl で取れます(Windows 10 以降は標準で入っています)。
curl -O https://fa-spec.com/spec/v1/validate.mjs
node validate.mjs 構成図.json メモリマップ.json
形が合わないところは「エラー」として、場所($.nodes[3].type など)と理由を出します。
形は合っていても、エディタが読み込むときに捨てるもの(存在しない id を指す線・矢印・レーン・ブロックの変数など)と、values の長さが steps と違う行(ケースの行は steps − at)は「注意」として出します。
注意はエラーが無くなってから出るので、エラーを直すと新しく注意が現れることがあります。
終了コードは、エラーがあれば 1、注意だけなら 0 です(JSON として読めないファイルと、使う Schema が同じフォルダに無いファイルも 1)。
場所と理由は日本語で出るので、AI に作らせた JSON なら、出力をそのまま貼って「エラーと注意を直して」と頼めば通じます。
ajv などの汎用の検証器で使うときは、draft 2020-12 に対応した入口を使い、common.schema.json を先に読み込ませてください。
kind ごとの Schema は、共通の部品を common.schema.json#/$defs/… で参照しています。
タイミングチャートの values は型を 3 つ並べて書いているので、ajv では allowUnionTypes を有効にします。
import Ajv2020 from "ajv/dist/2020.js";
const ajv = new Ajv2020({ allowUnionTypes: true });
ajv.addSchema(common); // common.schema.json の中身
const check = ajv.compile(timingchart); // timingchart.schema.json の中身
check(data) || console.log(check.errors);
例
kind ごとに 2 つずつ置いています。どれもエディタの「ファイル → 開く…」で読み込めます。
エディタで書き出したものには、画面の状態を残すための項目(タイミングチャートの stepW・rowH など、この表に無いもの)が入っています。
手で書くときは要りません。AI に雛形として渡すなら、手で書いた JSON のほうを渡してください。
- システム構成図:検査セルの構成(手で書いた JSON・座標なし)/搬送ラインの構成(書き出し)
- メモリマップ:検査のハンドシェイクの変数(手で書いた JSON・アドレスは空)/搬送装置の I/O マップ(書き出し)
- タイミングチャート:検査要求・検査完了のハンドシェイク/エアシリンダの前進・後退(どちらも書き出し)
- フローチャート:コンベアの定位置停止と送り出し(手で書いた JSON・座標なし)/検査のハンドシェイク(タイミングチャートから作成)
設備を 1 つ描いた、説明つきの例はサンプルにあります。各ページから JSON をダウンロードでき、エディタでそのまま開けます。
- エアシリンダの前進・後退のタイミングチャート(サンプル) — 端は「着いた ON」と「離れた OFF」で見る
- 非常停止のあとの PLC の処理と復帰のフローチャート(サンプル) — 止めるのは安全回路、PLC は後始末と復帰の手順
- 移載ユニットの原点復帰のフローチャート(サンプル) — Z を上げてから X を戻す、1 軸ずつ確かめる
10. machine — 装置ファイル(draft)
draft:形が変わることがあります。1 つの装置の文書を 1 つのファイルに束ねます。 中の文書は、ここまでの単一 kind のファイルとまったく同じ形です。
| 項目 | 型 | 説明 |
|---|---|---|
| machineId | string | 装置 ID(構成図と同じ)。ブラウザの中の図の一覧を装置ごとに分けます。書かなくて構いません。 |
| docs * | array | 装置の文書。1 つずつが単一 kind のファイルの中身(schema・kind・v を持つ)です。
同じ kind が 2 つ以上あっても構いません(区画ごとのタイミングチャートなど)。 |
- エディタは、装置ファイルから自分の kind の文書だけを開きます。同じ kind が 2 つ以上あれば、どれを開くかを選びます。
- 保存は開いた形で返します。装置ファイルから開いたら装置ファイルで、単一 kind のファイルから開いたら単一 kind のファイルで保存します。
- ほかの文書は、知らない kind も含めて順序も中身も変えずに書き戻します。保存の直前に保存先のファイルを読み直すので、別のエディタが先に保存した文書も残ります。
- 自分の文書は
docId(メモリマップはcontroller)で見分けて差し替えます。無い前の版は、開いたときの位置か、同じ kind が 1 つだけならそれを差し替えます。 - 装置ファイルは、構成図・メモリマップの「ファイル → 装置ファイルに入れる…」で作れます。チャートとフローチャートは、図の一覧の「一覧の全部を装置ファイルに保存…」で入ります。
4 つのエディタ
- System Diagram Editor —
kind: "systemdiagram" - Memory Map Editor —
kind: "addressmap" - Timing Chart Editor —
kind: "timingchart" - Flowchart Editor —
kind: "flowchart"
関連する記事
yk.builds