v0.4.0 - Practice Questions and Answers

v0.4.0 - Practice Questions and Answers

This release adds beginner-friendly practice questions for all four PLC scan cycle teaching examples.

What's new

• Added practice questions for single_button.
• Added practice questions for start_stop_latch.
• Added practice questions for emergency_stop.
• Added practice questions for ton_timer.
• Added docs/practice_guide.md.
• Updated README with Practice Questions links.
• Updated Chinese documentation and bilingual explanations for learners.

Current examples

• Single button to coil
• Start/stop motor latch
• Emergency stop interlock
• TON on-delay timer

Learning goal

Learners can now predict outputs before checking the answer and explanation. This helps reinforce how current inputs, previous state, program logic, and output updates interact during PLC scan cycles.

中文说明

这个版本新增了练习题模块。学习者可以先预测某个扫描周期的输出，再查看答案和解释，用来巩固 PLC scan cycle、自锁、急停和 TON 定时器概念。

Limitations

This project is still a beginner-friendly teaching tool. It does not implement a full ladder logic editor, full IEC 61131-3 runtime, real PLC communication, or hardware connection.

v0.3.0 - TON Timer Teaching Example

v0.3.0 - TON Timer Teaching Example

这个版本新增了 TON 延时定时器教学示例。用户可以看到 IN=True 后，Q 不会立刻变为 True，而是需要连续扫描周期累计 ET。当 ET 达到 PT 后，Q=True；当 IN=False 时，定时器复位。

This release adds a basic TON on-delay timer teaching example to PLC Scan Cycle Visualizer.

What's new

• Added examples/04_ton_timer.yaml.
• Added fixed teaching logic for ton_timer.
• Added scan cycle logs for TON timer behavior.
• Added timing diagram output for IN, Q, and ET.
• Updated --plot-all to generate four timing diagrams.
• Updated README with TON Timer Preview.
• Updated Chinese documentation for TON timer learning.

Current examples

• Single button to coil
• Start/stop motor latch
• Emergency stop interlock
• TON on-delay timer

How to run

pip install -r requirements.txt
python main.py examples/04_ton_timer.yaml
python main.py examples/04_ton_timer.yaml --plot
python main.py --plot-all

v0.2.0 - Timing Diagram Output

v0.2.0 - Timing Diagram Output

这个版本新增了时序图输出功能。用户不仅可以在终端看到 PLC 扫描周期日志，也可以生成图片来观察 START、STOP、MOTOR 等信号在不同扫描周期中的变化。

This release adds static timing diagram output to PLC Scan Cycle Visualizer.

What's new

• Added timing diagram generation with matplotlib.
• Added --plot for generating a timing diagram for one example.
• Added --plot-all for generating timing diagrams for all MVP examples.
• Added outputs/ images for README preview.
• Updated README with bilingual-friendly explanations for Chinese automation students.
• Added Chinese documentation entry: docs/README.zh-CN.md.

Current examples

• Single button to coil
• Start/stop motor latch
• Emergency stop interlock

How to run

pip install -r requirements.txt
python main.py examples/02_start_stop_latch.yaml
python main.py examples/02_start_stop_latch.yaml --plot
python main.py --plot-all