From a59a1fae2614bdcd1b0b7d0809c0b85b898e9484 Mon Sep 17 00:00:00 2001
From: Adeeb Shihadeh <adeebshihadeh@gmail.com>
Date: Wed, 18 Aug 2021 15:00:51 -0700
Subject: [PATCH] add comma serial to tools

old-commit-hash: 29499463375c659e8c830bf06996a9964c7aaf79
---
 tools/serial/README.md  | 18 ++++++++++++++++++
 tools/serial/connect.sh |  8 ++++++++
 2 files changed, 26 insertions(+)
 create mode 100644 tools/serial/README.md
 create mode 100755 tools/serial/connect.sh

diff --git a/tools/serial/README.md b/tools/serial/README.md
new file mode 100644
index 0000000000..5e966b5708
--- /dev/null
+++ b/tools/serial/README.md
@@ -0,0 +1,18 @@
+# comma serial
+
+The comma serial gets you access to a low level serial console on your comma three, while providing astable 12V to power the device.
+
+The serial is available on the [comma shop](https://comma.ai/shop/products/comma-serial).
+
+## setup
+
+* Connect all three cables to the serial
+* Connect the USB A to your computer
+* Connect the USB-C to the OBD-C port on your comma three
+
+## usage
+
+```
+sudo screen /dev/ttyUSB0 115200
+```
+or use `connect.sh` to run the previous command in a loop
diff --git a/tools/serial/connect.sh b/tools/serial/connect.sh
new file mode 100755
index 0000000000..2354a174f3
--- /dev/null
+++ b/tools/serial/connect.sh
@@ -0,0 +1,8 @@
+#!/bin/bash
+
+while true; do
+  if ls /dev/ttyUSB* 2> /dev/null; then
+    sudo screen /dev/ttyUSB* 115200
+  fi
+  sleep 0.1
+done