From 7e2d323c49cf1a3eb08f91a583189155bfe74e9c Mon Sep 17 00:00:00 2001
From: Andrei Stanescu <reydan@gmail.com>
Date: Mon, 7 Sep 2026 18:45:28 -0700
Subject: [PATCH] Update README to include instructions for MacOS

---
 README.md | 14 +++++++++++---
 1 file changed, 11 insertions(+), 3 deletions(-)

diff --git a/README.md b/README.md
index e040f13..fea0966 100644
--- a/README.md
+++ b/README.md
@@ -59,11 +59,19 @@ In the setup press the A key and change the serial device to GRBL.
  ![Minicom Connected](doc/readme/images/minicom_connected.png)
 
 
-### Realtime modifications:
-
-  Now simulates microcontroller peripherals in separate thread.  Runs in *aproximate* realtime.  Emphasis on  * **Approximate** *.  Work is underway to speed it up.
+## Debugging on MacOS
+On MacOS, first install these dependencies
+```
+brew install cmake socat minicom
+```
+Follow the same build instructions as on Linux above, then run using:
+```
+socat -d -d pty,raw,echo=0,link=/tmp/ttyGRBLsim "EXEC:'./grblHAL_sim -n -s step.out -b block.out',pty,raw,echo=0"
+```
 
+## Realtime modifications:
 
+  Now simulates microcontroller peripherals in separate thread.  Runs in *aproximate* realtime.  Emphasis on  * **Approximate** *.  Work is underway to speed it up.
 
 
 ## Validator