X-Git-Url: https://git.realraum.at/?p=svn42.git;a=blobdiff_plain;f=firmware-messages.txt;fp=firmware-messages.txt;h=e056a29e03eefc730cfbe9a57a934aecaff4be28;hp=0000000000000000000000000000000000000000;hb=a5e721c8dbf397c6a5aa5131a9b6cf9f15cc6f7b;hpb=8eb667a015ede707f676850a7561571291b4fc9d

diff --git a/firmware-messages.txt b/firmware-messages.txt
new file mode 100644
index 0000000..e056a29
--- /dev/null
+++ b/firmware-messages.txt
@@ -0,0 +1,44 @@
+###############################################################
+/dev/ttyUSB0: door key printer
+
+
+ Messages:
+
+  manual open key pressed:
+   open forced manually
+
+  manual close key pressed:
+   close forced manually
+
+  closing or opening finished
+   Status: closed|opened, idle
+
+  closing or opening timeout:
+   Error: open/close took too long!
+
+ commands:
+  c ... close
+   response: "Ok", "Already closed", "Error: .*"
+  o ... open
+   response: "Ok", "Already opened", "Error: .*"
+  s ... status
+   response: "Status: closed|opened|<->, opening|waiting|closing|idle"
+         or  "Error: .*"
+  r ... reset
+   "Ok, closing now" or "Error: .*"
+  * ... everything else
+   Error: unknown command
+
+ open/close  will only be accepted if Status: ..., idle
+             otherwise response: Error: Operation in progress
+
+ unless error case s will always be accepted
+
+ Reset overrules all other operations in progress
+
+ if an error occured every command besides r gets ingnored and
+   Error: last open/close operation took too long!
+ is sent in response
+
+###############################################################
+