From 8a33793a1c96b11a307d260f245044104832930b Mon Sep 17 00:00:00 2001
From: Jesse Vincent <jesse@keyboard.io>
Date: Thu, 23 Aug 2018 17:56:16 -0700
Subject: [PATCH] Improve the 'port unwritable' error message

---
 bin/kaleidoscope-builder | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/bin/kaleidoscope-builder b/bin/kaleidoscope-builder
index c9e7985b..1642471b 100755
--- a/bin/kaleidoscope-builder
+++ b/bin/kaleidoscope-builder
@@ -325,10 +325,17 @@ EOF
     if ! [ -w "$DEVICE_PORT" ]; then
         cat <<EOF >&2
 
-$DEVICE_PORT is not writable:
+In order to update your keyboard's firmware you need to have permission
+to write to its serial port $DEVICE_PORT. 
+
+It appears that you do not have this permission:
 
   $(ls -l "$DEVICE_PORT")
 
+This may be because you're not in the correct unix group: 
+
+  $(stat -c %G "$DEVICE_PORT").
+
 You are currently in the following groups:
 
   $(id -Gn)