Timing Chart Editor — User Guide
Design the signal exchange between devices — PLC, microcontroller, host PC — as a timing chart, and produce the specification, the flowchart and a review text from that same chart.
1. Overview
The Timing Chart Editor is a drawing tool that feels like a spreadsheet: steps (slices of time) run across, signals run down, and you paint the waveform in the grid. BOOL signals are drawn as ON / OFF waveforms; numeric and state signals are drawn as blocks carrying their value (bus notation), and the points where the value changes are drawn as a crossing (><).
It runs entirely in the browser, with no external libraries and no server. What you type is saved automatically inside the browser on this machine only, and is never sent anywhere. A finished chart can be exported as SVG for a specification, as Draw.io or as Markdown, and it can be handed to the Flowchart Editor in the same folder to draft the control flow automatically.
2. Tutorial (your first chart)
- Type the device names into “Master” and “Slave” in the toolbar (for example PLC / Servo). They drive the direction column and the lane names in the flowchart.
- Press “Import…” above the variable list and paste your signal list from Excel. If the first row is a header, the name, type, comment and direction columns are found whatever their order.
- Double-click a variable (or drag it onto the chart) to add a row. Dragging the row number reorders the rows.
- Click or drag sideways on a BOOL row to paint the ON stretch. On a numeric row, double-click to type a value, then drag sideways from a filled cell to extend it.
- Press “Arrow” in the toolbar and drag from the transition of a request signal to the transition of the signal that answers it, to record the cause and effect.
- In “Output → Export…” (Ctrl+E) pick Markdown and press “Copy to clipboard”, then paste it into Notion or GitHub.
“Tutorial” in the Help menu loads the sample and walks you through the same steps, highlighting each part of the screen as it goes.
3. Drawing waveforms
“Edge” in the toolbar decides how a BOOL transition is drawn. “Vertical” gives the ideal logic waveform; “sloped” is closer to a real signal, where rising and falling take time. To change a single row, right-click its label and pick “Edges”.
Numeric and state rows (bus notation) always draw a value change as a crossing (><), as a timing chart should. That does not follow the “Edge” setting, and the width of the crossing follows the step width.
4. Quantities that change continuously
A specification often has to show the condition that makes a discrete signal change — when does “positioning complete” turn ON, above what pressure is “pressurised” reached. The quantity behind that condition — an axis position, a speed, an analogue input — changes continuously, and value blocks cannot draw it. Right-click the row label and pick “Draw as a waveform”, and the values are plotted against the height of the row. “Row display…” also sets the unit (mm, ms, V, rpm and so on) and the scale (the value at the bottom and at the top). Leave the scale empty and it follows the range of that row’s values; give several rows the same scale when you want to compare them.
The values still live in the cells, so pasting from Excel, selecting a range, copying and undo all keep working. Instead of typing every step, select a range and use “Fill with a straight line (ramp)…” (right-click a cell, or the Edit menu) to fill it evenly from a starting value to an ending value. 0 → 100 rises, 100 → 0 falls. For a trapezoid, fill the rising range, the flat range and the falling range one after another.
A waveform row changes value at nearly every step, so the ○ for a cause-and-effect arrow appears only where the movement starts, stops or turns round. That gives you arrows such as “start request ON → the axis begins to move”. The transition list in the Markdown export and the AI review text pick up the same points.
Waveform rows are for display only and are not read when a flowchart is generated. What becomes a step or a wait is the BOOL signal that reacts to the waveform (positioning complete and the like).
Shift+click and the arrow keys select a range, and Space (invert), 1 (ON), 0 (OFF) and Delete (clear) edit the whole selection at once. Ranges can be copied to and pasted from Excel.
5. Cause-and-effect arrows
An arrow records the relation “B changes only after A has changed”. While arrow mode is on (or while Alt is held), a small ○ appears at every transition — one on each of its two corners, High and Low — so grab whichever is nearer. A numeric or state signal has a single ○ at the centre of its crossing. Drag from the ○ of the cause to the ○ of the effect and release; the arrow points at the corner you grabbed. The effect must sit on the same step as the cause or later.
Which corner of a transition an arrow uses, High or Low, is yours to choose. When several arrows meet in one place, spreading them between the two corners keeps the chart readable. The corner is kept in the JSON as level; leave it out and the level after the change is used.
If you repaint a waveform and the transition disappears, the arrow is drawn as a dashed line in the warning colour. Either click it and press Delete, or fix the waveform.
6. How to think about M→S / S→M
Every signal carries a direction that says who drives it. M→S is driven by the master and received by the slave (requests, commands); S→M is driven by the slave and received by the master (responses, status); Internal is used inside one device only. Keeping the directions straight makes it obvious which program has to write what.
The basic handshake has four steps: request ON → response ON → request OFF → response OFF. Changing the next signal only after the other side has answered (the interlock) is what prevents missed signals, double starts and timing-dependent faults.
The arrows make that “confirm, then change” relation explicit on the chart. With the arrows in place, the flowchart is built so that it waits for exactly the input each arrow names before changing the output. Changes with no arrow — a timer, for instance — are simply laid out in step order.
7. Import and export
- Import: all in one place, under “File → Import…” — paste JSON, paste a table of variables, or open a file. Excel pastes, CSV / TSV and the JSON of the Memory Map Editor are all accepted, and address and initial-value columns are kept in the variable list.
- Export: all in one place, under “Output → Export…” (Ctrl+E). Each format says where it is meant to be pasted, so you pick one and press “Copy to clipboard” or “Save to a file”.
- Image (PNG): copy it and paste it straight into Word, Excel, PowerPoint, an e-mail or a chat.
- SVG: a white-background, black-line drawing for a specification. The arrows are drawn too.
- Draw.io: shapes that draw.io can edit. Press “Copy to clipboard”, then Ctrl+V in the draw.io window. A drawing changed in draw.io cannot be loaded back into this editor, so change the waveforms and arrows here and paste again.
- Markdown: a specification containing the signal list, the timing table, the transitions, the cause-and-effect list and a sequence diagram (Mermaid).
- Mermaid: only the sequence diagram, as Mermaid code (.mmd). Signals without a direction (M→S / S→M) become notes. Cases (branches) are written as alt / else, repeated spans as loop and named spans as a frame; time conditions follow the resulting signal.
- AI review text: a tabular text for asking a generative AI to point out contradictions in the logic.
If draw.io pastes it as plain XML text, add a new page with the + at the bottom left and choose Extras → Edit Diagram… on the menu bar (without the menu bar: + → Advanced on the toolbar). The box holds the XML of the current page: select it with Ctrl+A, paste, and press Apply. Apply replaces everything on the page, which is why a new page is used.
8. Keyboard shortcuts
9. Saving and handing over
Your work is saved automatically in the browser and restored the next time you open the tool. To keep it as a file, press Ctrl+S and save the JSON. That JSON carries the schema shared across the platform (variables and triggers), so variables and cause-and-effect relations move between all four tools. Clearing the browser data also clears the automatic save, so always keep important charts as files.
A machine usually has several timing charts, one per handshake. Use the “Chart ▾” list at the top to add, switch, duplicate and remove them. Once there are two or more (or once you receive variables with partitions from the Memory Map), the “This machine” tree appears on the left and takes over the list (click a chart to switch to it; use ⋯ in its header to add, duplicate or remove; click a device or block to show only that partition’s variables). It also lists the system diagram, memory maps and flowcharts of the same machine, and items marked ↗ open in their own tool. The tree and the variable list can be dragged by their headers to the top or bottom of the left or right column, into tabs with another panel, or into a new column beside it (also from ⋯). Once you use the list, New and Open keep the current chart in the list and add another one. “Save the whole list to a machine file…” puts them all in one file, and “Put all into the list” brings them back when you open a machine file.
This is the third of the four design tools; the buttons at the right of the toolbar move you backwards and forwards.
- System Diagram Editor: decide the devices, blocks and networks
- Memory Map Editor: assign the variables and addresses (“← Memory Map” opens it; its “To Timing Chart →” sends the variables here)
- Timing Chart Editor (this tool): decide the movement in time and the cause-and-effect relations
- Flowchart Editor: “To Flowchart →” generates the flow with those relations applied
For the thinking behind this kind of drawing — what belongs on one sheet and the pitfalls seen on site — see the guide How to draw a timing chart (in Japanese). All four editors are listed on the FA Spec Tools home page.
Please send bug reports and feature requests to yk.builds.space@gmail.com. Steps to reproduce the problem — and, if you can, the saved JSON file — make it much quicker to look into.