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 時点)。 読み込み側は、自分より古い版を受け付けます。
titlestring 図や表の題名。空でも構いません。
revisionsarray 図の改訂履歴。古い順に並べ、最後の行が今の版です。エディタの「ファイル → 版と改訂履歴…」で書き、 書き出す図の題名の横と 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": "検査完了の信号を追加" }
]
項目型説明
revstring版の記号(A・B・1・2 など)。「版を上げる」は末尾の英字・数字を 1 つ進めます。
datestring改訂した日(YYYY-MM-DD)。保存や書き出しでは変わりません。
authorstring担当(改訂した人)。
notestring改訂の内容。「前の版と比べる」の一覧をコピーして貼れます。

2. systemdiagram — システム構成図

機器(devices)と、その間の通信(links)で表します。

項目型説明
machineIdstring装置 ID。PLC ごとのメモリマップ・図の一覧・装置ファイルを装置ごとに分けます。エディタが作るので、書かなくて構いません。
devices[]array機器。下の表を参照。
links[]array機器どうしの通信。下の表を参照。
variables[]arrayメモリマップへ受け渡すときに使う。空でも構いません。
triggers[]arrayタイミングチャートへ受け渡すときに使う。空でも構いません。

devices[] の項目

項目型説明
id *stringこの機器の識別子。links から参照されます。
name *string図に出る名前。
kindstring plc / hmi / pc / servo / inverter / robot / io / unit / sensor / net / other。省略すると other。色と形が変わります。 io はリモート I/O、unit は CPU やリモート I/O に連結する I/O ユニット、net は HUB などのネットワーク機器です。
modelstring型式(例 Q06UDHCPU)。
addrstringIP アドレスや局番。
commentstring備考。
x, ynumber図の中の位置。省略可。省略したときは「自動整列」で並べてください。
blocks[]array 機器の中の機能のまとまり(「指令」「状態」など)。 { "id", "name", "comment", "varIds": [] }。 メモリマップへ渡したときの変数の入れ物になります。
locationstring 置き場所(制御盤 / 操作盤 / 機上中継 BOX など)。同じ置き場所の機器は、図で名前付きの枠に囲まれます(枠の位置は機器から決まるので、座標は書きません)。 ほかのツールへ渡す機器名には混ぜません。省略可。
safetyboolean安全機器(安全 PLC・安全リレー・非常停止・ライトカーテン・安全扉スイッチなど)なら true。図と機器一覧で見分けられます。省略可。
controllerstring 所属先。リモート 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。
kindstring ネットワークの種類。EtherCAT / EtherNet/IP / CC-Link IE / PROFINET / Modbus TCP / Ethernet / RS-232C / RS-485 / USB など、文字列をそのまま書きます(一覧に無い通信は、その名前をそのまま。例 SLMP)。 フィールドバスは実線、シリアルは破線、配線(デジタル I/O / アナログ I/O / パルス列)は点線、 CPU・ユニットどうしのつながりは ユニット連結(太い実線)です。
labelstring線に添える文字(例 局番 1)。
fromAddr, toAddrstring 線の端の番地。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 をその線の番地とみなします。
dirstring"both"(双方向・既定)か "one"(片方向)。
safetyboolean 安全の通信・安全配線なら true(二重線で描きます)。kind が CC-Link IE Safety / FSoE / CIP Safety / PROFIsafe / 安全配線 の線は、書かなくても安全の線です。省略可。
stylestring その他 と、エディタの一覧(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 を持たず、通信のつながりに数えません)。一覧にある種類(その他を除く)の線では書きません。
masterstring マスター側の機器の 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 の形です。

項目型説明
plcobject メーカーと機種、使えるデバイス範囲。{ "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変数の一覧。下の表を参照。
settingsobjectコード生成の設定。{ "structName", "iecWordIndex" }。

variables[] の項目

項目型説明
id *stringこの変数の識別子。
name *string変数名(例 bStartReq)。
typestringBOOL / INT / DINT / WORD / REAL など。IEC 61131-3 の型名をそのまま書きます。
rolestring 向き。"M"(マスター側が出す)/ "S"(スレーブ側が出す)/ "I"(内部)。タイミングチャートの方向欄になります。
addressstring割り付けた先(例 M0 / D100)。 空にしておくと、エディタ側で自動割付できます。
bitnumber / nullワードデバイスの中のビット番号。使わないときは null。
initialValuestring初期値。
commentstringデバイスコメントになります。
addrTextstring表示用のアドレス。ビットを 16 進で書くデバイス(例 D100.F)で、address.bit(10 進)と違うときだけ書きます。
peerAddressstring相手側の番地(リンクデバイスや相手の機器の番地。例 RX10・DI101・Asm101 +0)。 書き方は自由で、エディタは比べません。無ければ書きません。
unitstring工学値の単位(例 MPa・mm/s・%)。無ければ書きません。
engMin, engMaxnumber工学値の下限・上限(例 0〜1 MPa)。生の値が増えると工学値が減る逆作動は、engMin に大きい方を書きます(例 100〜0 %)。
rawMin, rawMaxnumber生の値(PLC のデバイスに入る値)の下限・上限(例 A/D の 0〜32000)。 工学値 = engMin + (生の値 − rawMin) × (engMax − engMin) / (rawMax − rawMin)。 タイミングチャートへ渡すと、行の単位と縦の目盛り(unit / min / max)になります。
retainboolean停電保持の変数なら true(レシピ番号・生産数など)。ブロックの retain も引き継ぎます。 IEC の GVL では VAR_GLOBAL RETAIN に分け(番地付き AT %… の変数は入れず、コメントに[保持]。保持はラッチの設定で決まるため)、デバイスのラッチ範囲の外にあれば警告します。
safetyboolean安全プログラム側の信号(非常停止・ライトカーテンなど)なら true。 型が SAFEBOOL などの安全の型なら書かなくても安全の信号です。ブロックの safety も引き継ぎます。
interlockarrayインターロック(この出力が動いてよい条件)。すべての条件が成り立つときだけ動いてよい、の 1 組で、自動・手動・原点復帰で共通です(モードで分けません)。 条件は { "varId": "v_…", "name": "bClampOK", "on": true }(同じメモリマップの変数が ON / OFF)か、{ "text": "圧力 0.4 MPa 以上" }(変数で書けない条件)。 正は varId で、name は表示用です(varId が無ければ名前で探します)。装置の整合チェックで、タイミングチャートの波形と照らし合わせます。無ければ書きません。
deviceId, blockIdstringどの機器・どのブロックに属するか。

v3:ブロックは範囲のリストと入れ子

1 つのブロックが X・Y・M・D のようにデバイスをまたいで範囲を持ち、 ブロックの中にブロックを任意の深さで入れられます(例:リフタ > 指令 > 起動)。 前の版のツールへ渡すときは「出力 → 書き出し… → JSON(旧版 v2)」で書き出せます(入れ子と 2 つ目からの範囲は入りません)。

項目型説明
vnumber3。
controllerobjectこのメモリマップの PLC(構成図の PLC の { "id", "name" })。 メモリは PLC ごとにあるので、1 ファイルは PLC 1 台ぶんです。構成図から PLC を選んで渡すと付きます。省略可。
devices[]array機器。{ "id", "name", "comment", "addr" }。ブロックは持ちません(下の blocks[] の deviceId で結びます)。 addr は IP アドレスや局番で、構成図から受け取ると構成図の機器の番地(無ければ線の端の番地)が入ります。
blocks[]arrayブロックの表。親を先に並べます。下の表を参照。
variables[]arrayv2 と同じ項目。blockId が所属の正で、番地を含むいちばん内側のブロックを指します。 device / block は表示用の名前で、block は「リフタ/指令」のような入れ子の名前です。
layoutobject見た目だけ。{ "collapsed": [id, …] }(たたんだ機器・ブロック)。無くても図になります。
namingobject 命名規則。{ "typePrefix": { "BOOL": "b", "INT": "i" }, "maxLen": 32, "forbidden": ["tmp"], "pattern": "^[bidr][A-Z][A-Za-z0-9]*$", "note": "社内規約 第 3 版" }(決めた項目だけ)。 変数の名前が合わなければ確認事項に出し、装置の整合チェックではタイミングチャートだけにある信号の名前も同じ規則で見ます。

blocks[] の項目(v3)

項目型説明
id *stringこのブロックの識別子。タイミングチャートの対象の区画(scope)からも指されます。
deviceIdstringどの機器のブロックか(devices[].id)。
parentIdstring / null親のブロックの id。null なら機器の最上位。深さの上限はありません。
name *string名前。階層の名前は持たず、表示は「親/子」のパスです。
commentstring用途。
ownerstring書き込む区画(機器かブロックの id)。無ければ親から継承します。
addrstring局番や IP アドレス(リモート I/O・ユニットのブロックなど)。
retain, safetyboolean中の変数をすべて停電保持・安全の信号にするなら true。入れ子の子のブロックと変数が引き継ぎます。
ranges[]array確保した範囲。デバイスごとに 0 個以上。下の表を参照。

ranges[] の項目(v3)

項目型説明
dev *stringデバイスの記号(plc.devices[].code)。
from *string先頭の番地(例 "X100")。16 進の X や KEYENCE の書き方は PLC 設定で読み解きます。
tostring末尾の番地(例 "X11F")。省略すると from と同じ。
typestring行を足したときの型(例 "BOOL" / "INT")。
linkobjectリンク側の範囲 { "from", "to" }(この範囲をリフレッシュ先とするリンクデバイス。例 { "from": "RX0", "to": "RX1F" })。 to を省略すると from と同じ。無ければ書きません。 ネットワークが 2 つ以上あるときは J1\RX0・J2\RX0 のように J 番号を付けて書き分けます(J 番号が違う範囲は比べません)。

4. timingchart — タイミングチャート

行(rows)が信号、列が Step です。波形は values[] の配列で持ちます。

項目型説明
steps *numberStep 数(列の数)。
docIdstring図の ID。装置ファイルにタイミングチャートが何枚もあるとき、保存でどれを差し替えるかを見分けます。エディタが付けるので、書かなくて構いません。
metaobject { "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 になり、安全の信号の行には「安全」の印が付きます。
controllerobjectこのチャートのマスターの PLC(メモリマップの controller と同じ { "id", "name", "machineId" })。 メモリマップから受け取るとき、マスターがその PLC なら付きます。PLC の名前が変わったとき、マスターの名前を合わせるのに使います。省略可。
scopearray 対象の区画。メモリマップの機器の id(devices[].id)の配列です。省略すると全体の図です。 1 つなら「その区画の図」で、区画が書き込まない信号の方向が "S"(区画からの出力)だとエディタが警告します。 2 つ以上なら区画間のインターフェース図です。区画の名前は library[] の device から引きます。
rows[] には、見た目の指定として "edge"(その行だけの切り替わりの描き方。値は下の edgeMode と同じ)、 "disp": "wave"(値のブロックではなく波形でプロットする)、 "unit"(mm・ms・V など)、"min" / "max"(縦の目盛り)を 添えられます。いずれも省略可で、省略すると値のブロックになり、目盛りはその行の値の範囲に合わせます。
showAddrbooleantrue なら信号名の前にアドレス(library[] の address、BOOL はビットも)を出します(画面・SVG・PNG・draw.io)。省略すると出しません。
edgeModestringBOOL の切り替わりの描き方。"v"(垂直・既定)/ "s1"(斜め・小)/ "s2"(斜め・大)。 ほかの値は "v" として扱います。数値・状態の値の変わり目は、これにかかわらず交差で描きます。

rows[] の項目

項目型説明
id *stringこの行の識別子。triggers から参照されます。
name *string信号名。
libstringこの行の変数(library[].id)。行の名前だけを変えても、アドレスはこの変数のものです。省略すると同じ名前の変数を指します。
typestringBOOL(と SAFEBOOL)なら ON/OFF の波形、それ以外は値を表示するバスになります。
rolestring"M" / "S" / "I"。variables と同じ。
peerstringこの行の相手(PLC・ロボット・カメラのような 3 者以上のやり取り)。省略するとスレーブ(meta.slave)。 role が "M" なら master → peer、"S" なら peer → master の信号です。
commentstring信号名の下に小さく出ます。
values[] *array 長さは steps と同じ。BOOL は true / false、 数値・状態は文字列("1000" / "RUN")、未設定は null。

5. flowchart — フローチャート

記号(nodes)と、その間の線(edges)で表します。

項目型説明
docIdstring図の 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。
settingsobject { "yesNo": "YES/NO", "yesDir": "down", "stepNo": false, "stepStart": 10, "stepInc": 10 }。 yesDir は YES の出る向き("down" / "right")。stepPerLane は工程番号をレーンごとに振ったなら true。
scopearray 対象の区画(メモリマップの機器の id の配列)。タイミングチャートと同じ意味です。省略すると全体の図です。 タイミングチャートから作ると引き継ぎます。
partitions[]array 区画の名前の表。{ "id", "name" }。scope を名前で見せるためのもので、 区画の分かるタイミングチャートから作ったときに付きます。省略可。
sourceobject タイミングチャートから作ったときの元の図。{ "docId", "title", "opt" }。 「作り直す」は、この docId のタイミングチャートから作ります。エディタが付けるので、書かなくて構いません。
controllerobject この図がどの 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. 読み込み側の決まり

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.json2 章 システム構成図
addressmap.schema.json3 章 メモリマップ(v1 / v2)
addressmap.v3.schema.json3 章 メモリマップ v3(範囲のリストと入れ子)
timingchart.schema.json4 章 タイミングチャート
flowchart.schema.json5 章 フローチャート
machine.schema.json10 章 装置ファイル(draft)。中の文書は kind ごとの Schema で確かめます
validate.mjs検証スクリプト(下を参照)
examples/index.json例の一覧(下を参照)
ai/prompts.mdAI に kind ごとの JSON を作らせる、短い頼み方の例
ai/instructions.mdClaude の 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 のほうを渡してください。

設備を 1 つ描いた、説明つきの例はサンプルにあります。各ページから JSON をダウンロードでき、エディタでそのまま開けます。

10. machine — 装置ファイル(draft)

draft:形が変わることがあります。1 つの装置の文書を 1 つのファイルに束ねます。 中の文書は、ここまでの単一 kind のファイルとまったく同じ形です。

項目型説明
machineIdstring装置 ID(構成図と同じ)。ブラウザの中の図の一覧を装置ごとに分けます。書かなくて構いません。
docs *array 装置の文書。1 つずつが単一 kind のファイルの中身(schema・kind・v を持つ)です。 同じ kind が 2 つ以上あっても構いません(区画ごとのタイミングチャートなど)。

4 つのエディタ

関連する記事

yk.builds