thermferm/README

Sat, 25 Apr 2020 20:31:31 +0200

author
Michiel Broek <mbroek@mbse.eu>
date
Sat, 25 Apr 2020 20:31:31 +0200
changeset 605
e00f8ff4de9a
parent 363
468ec0d96cce
permissions
-rw-r--r--

Version 0.9.8. Added extra path to the fonts for Debian buster. Changed the PID to work on Proportional on Measurement. Added loops so that it looks like the PID is running at 100 mSec intervals.

335
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
1
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
2 1. Introduction.
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
3
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
4 2. Hardware.
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
5
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
6 3. Raspberry GPIO.
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
7
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
8 Most of the hardware is connected via the 8 GPIO pins on the 26p connector.
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
9 Currently the pins are used or reserved for:
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
10
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
11 GPIO0 - out - 433 MHz transmitter module (FS1000A).
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
12 GPIO1 - out - reserved for PWM.
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
13 GPIO2 - out - Frontpanel LED.
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
14 GPIO3 - bus - DHT11 sensor.
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
15 GPIO4 - in - Frontpanel Key Enter.
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
16 GPIO5 - in - Frontpanel Key Down.
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
17 GPIO6 - in - Frontpanel Key Up.
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
18 GPIO7 - bus - 1-Wire bus (Maxim protocol).
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
19
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
20
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
21 4. Keyed menu.
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
22
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
23 Using three buttons the device can be controlled. The menu is entered by
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
24 pressing the Enter key for 2 seconds. With the up and down keys you can step
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
25 through the menu. Press escape to go back, Press enter for 2 seconds to
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
26 set the new value.
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
27 Escape is press both arrow keys together.
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
28 If not in a menu, short touch of the keys activate the LCD display backlight.
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
29 The arrow keys select the current item to display.
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
30
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
31
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
32 General setup
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
33
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
34 Top screen
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
35 Units setup -- Units -- Select mode
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
36 Off mode, toggle heater, cooler, fan.
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
37 Beer/Fridge mode, change temperature.
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
38 Profile mode -- If OFF, select a profile.
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
39 If OFF, allow start profile.
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
40 If RUN, allow pause/abort.
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
41 If PAUSE, allow resume/abort.
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
42 If DONE, allow to go OFF.
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
43 System mode -- Halt
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
44 Reboot
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
45
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
46
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
47
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
48 5. Client/Server protocol.
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
49
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
50
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
51 Commands:
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
52
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
53 ARCHIVE DIR
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
54 ARCHIVE LOG filename (get in LOG format)
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
55 ARCHIVE GET filename (download file)
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
56
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
57 DEVICE ADD type
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
58 DEVICE DEL uuid
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
59 DEVICE LIST
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
60 DEVICE GET uuid
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
61 DEVICE PUT uuid
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
62
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
63 GLOBAL GET
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
64 GLOBAL PUT
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
65
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
66 LIST
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
67 LIST LOG uuid
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
68
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
69 PING
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
70
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
71 PROFILE uuid,name
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
72 PROFILE ADD name
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
73 PROFILE DEL uuid
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
74 PROFILE LIST
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
75 PROFILE GET uuid
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
76 PROFILE PUT uuid
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
77 PROFILE GETS uuid
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
78 PROFILE PUTS uuid
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
79
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
80 SIMULATOR ADD name
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
81 SIMULATOR DEL uuid
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
82 SIMULATOR LIST
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
83 SIMULATOR GET uuid
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
84 SIMULATOR PUT uuid
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
85
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
86 UNIT ADD name
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
87 UNIT DEL uuid
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
88 UNIT LIST
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
89 UNIT GET uuid
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
90 UNIT PUT uuid
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
91
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
92
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
93
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
94 Response codes:
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
95
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
96 100 Help text follows
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
97 101 PONG
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
98 201 Information follows
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
99 211 Device %s added
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
100 211 Device %s deleted
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
101 211 Profile %s added
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
102 211 Profile %s deleted
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
103 211 Unit %s added
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
104 211 Unit %s deleted
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
105 212 Archive directory follows:
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
106 212 Archive file follows:
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
107 212 Devices list follows:
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
108 212 Fermenter list follows:
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
109 212 Logfile list follows:
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
110 212 Profiles list follows:
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
111 213 Device record follows:
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
112 213 Global Settings record follows:
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
113 213 Profile record follows:
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
114 213 Unit listing follows:
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
115 215 Profile steps follow:
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
116 219 Accepted Device record
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
117 219 Accepted Global record
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
118 219 Accepted Profile record
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
119 219 Accepted Profile steps
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
120 219 Accepted Unit record
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
121 403 LCD not available
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
122 440 No such device
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
123 440 No such file
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
124 440 No such profile
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
125 440 No such simulator
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
126 440 No such unit
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
127 441 Maximum simulators reached
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
128 500 Unknown command
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
129 501 Subcommand missing
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
130 502 Parameter missing
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
131 503 Parameter error
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
132 504 Subcommand error
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
133 518 recfrom(): %s
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
134
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
135
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
136
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
137 6. PID adjustments.
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
138
363
468ec0d96cce Back to the old PID algorythm. Version 0.3.1.
Michiel Broek <mbroek@mbse.eu>
parents: 335
diff changeset
139 * Start with pGain, dGain and iGain set to 0.
335
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
140 * Increase Kp until small oscillation.
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
141 * Increase Kd until a little damping.
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
142 * Increase Ki after Kp and Kd are set until longterm convergence.
7ce8e4e15b0b Added the README
Michiel Broek <mbroek@mbse.eu>
parents:
diff changeset
143

mercurial