LogicEmu for LiaScript: ASCII Logic Circuits That Actually Run

Most circuit simulation tools require a graphical schematic editor. LogicEmu takes a different approach: logic circuits are written as ASCII art — and they simulate. The LogicEmu template integrates this engine into LiaScript, letting instructors embed runnable circuits directly in course content as plain text.

Quick Start

<!--
import: https://raw.githubusercontent.com/liaTemplates/logicemu/master/README.md
-->

Macro 1: @LogicEmu.run — Static Simulation (in fence header)

Place @LogicEmu.run in the header of a code block. The ASCII circuit renders in an iframe and runs automatically. The code is not shown to the student — only the simulation.

```   @LogicEmu.run
   s s s s s s s s   (input byte)
   * * * * * * * *
   e e e e e e e e   (XOR with carry)
   * * * * * * * *
   l l l l l l l l   (output byte)
```

Try it live — click the s switches and watch the lamp turn on/off:

Macro 2: @LogicEmu.eval — Editable Circuit (end-of-block)

Attach @LogicEmu.eval at the end of a code block to keep the ASCII source visible and editable. Students can modify the circuit and re-run it.

```
   s***>a****>l
```
@LogicEmu.eval

ASCII Circuit Notation

LogicEmu uses a compact ASCII language for circuits. Each character has a specific meaning:

Components

Wires

Example: Switch → AND → Lamp

s****>a***>l
      *
s*****

Two switches feed an AND gate; the output drives a lamp.

Example: Half Adder

s**>a**>l   (sum bit)
s*>e
   *
   *>l       (carry bit)

Example: SR Latch

s*>o*>l
   * *
   * v
   *>o*>l

Try it live — click the switches to Set and Reset the latch; also edit the ASCII circuit and re-run:

Full Template Demo

Use Cases

Computer science fundamentals — Teach combinational logic with tactile, clickable ASCII circuits. No diagram editor, no PNG exports — just code and simulation.

Digital systems textbooks — Embed half-adders, full-adders, multiplexers, and flip-flops directly as running examples, not static images.

Interactive lectures — Use @LogicEmu.eval so students can modify a circuit and observe how the output changes.

Hobbyists and self-learners — Write circuits in the same plain-text style as logicemu.com without leaving LiaScript.

Technical Facts

Try It

Related Templates

• DigiSim — JSON/DSL-based digital logic simulation with full DigitalJS backend
• ExplainGit — animated git repository visualization
• AVR8js — AVR/Arduino simulation for embedded courses