| .. | ||
| shields | ||
| README.md | ||
| stir.ino | ||
| stirctl | ||
Dual magnetic stir controller V1
Overview
This is the Arduino sketch to build a double magnetic stirrer based on 2 fans, a 1602 LCD display, a KY-040 encoder and an Arduino (e.g. Uno, Nano, Leonardo, Pro Micro).
In order to put the stirrer into operation you have to change the settings in stir.ino according to your setup.
Reference
This project was created based on an idea from the Hobbybrauer-Forum and would not be possible without the ideas from there.
The forum: https://hobbybrauer.de/
The thread: https://hobbybrauer.de/forum/viewtopic.php?f=21&t=1456
Overview of Functions
All functions are controlled by the KY-040 encoder:
- Short Press: change between menu, stirrer 1 and stirrer 2
- Turn when menu is selected: change between menu items (SPEED, BOOST, BTIME, CATCH, CTIME)
- Long press when menu is selected: lock all functions (unlock also by long press)
- When a stirrer is selected:
- SPEED: turn sets speed, long press switches stirrer on or off.
- BOOST: turn sets boost speed, long press activates/deactivates the boost function (running time is shown in the display).
- BTIME: turn changes the boost time in minutes.
- CATCH: turn activates/deactivates the fishing function
- CTIME: turn changes the interval in minutes for the fish catching function
- RTIME: turn changes speed rise time in seconds (applies to power on, stirrer on, boost on and fish catching)
- OTIME: turn changes switch off time in hours (the timer activates immediately, 0 = switch off disabled)
- RNVAL: random value range (a random values in this range will be added to speed)
- Other menu options:
- BRGHT: LCD brightness
Display Indicators:
- Bottom Left: Menu
- Bottom Center/Right: displays the set values for the stirrers depending on the selected menu item.
- Top Center/Right: displays the current stirrer speed (or 'OFF' or 'CAT' (Fishing)).
- Top Left: shows the remaining time of the boost or switch off function.
Settings (in stir.ino)
| Value | Description |
|---|---|
SPEEDINC |
increment of speed values when turning the encoder |
FANMIN |
fan minimum speed (should be a value at which the fan runs safely) (rpm) |
FANMAX |
maximum speed of the fan (it is important that this is the real maximum value of the fan) (rpm) |
BOFF |
if set boost off will also turn the normal mode off |
BINC |
boost time increment (min) |
CINC |
catch time increment (min) |
RINC |
rise time increment (sec) |
OINC |
off timer increment (hour) |
CATCHSTOP |
stop interval for stir fish catch function (ms) |
PWM0, PWM1 |
PWM output pins for fan speed |
PWM2 |
PWM output pin for LCD brightness control |
I0, I1 |
interrupts for rpm measurement (2 and 3 for Leonardo and ProMicro / 0 and 1 for Uno) |
CLK, DT, SW |
pins for KY-040 encoder |
OFF0, OFF1 |
these pins will be set if the fan is off |
OFFSTATE |
off state (LOW/HIGH) |
RINTERVAL |
regulation interval (ms) |
RDELAY |
extra regulation delay when value changes (ms) |
RTOL |
regulation tolerance (rpm) |
RNDINTERVL |
randon value range change interval (ms) |
SINTERVAL |
speed measurement interval (ms) |
SAVERAGE |
speed measurement average |
SAVETAG |
parameter save identifier |
SAVEDELAY |
delay in seconds before parameter will be saved to EEPROM |
LCDB |
LCD brightness steps (10 values, 0=off, 255=max) |
API commands
Commands are colon separated an can be send via USB/Serial
| Command | Description |
|---|---|
info |
returns a colon separated string with all parameters (see below) |
version |
returns the software version |
on:<0/1> |
switch stirren on |
off:<0/1> |
switch stirren off |
bon:<0/1> |
switch boost mode on |
boff:<0/1> |
switch boost mode off |
speed:<0/1>:<rpm> |
set stirrer speed (FANMIN-FANMAX rpm) |
bspeed:<0/1>:<rpm> |
set stirrer boost speed (speed-FANMAX rpm) |
btime:<0/1>:<min> |
set boost time (0-60) |
con:<0/1> |
switch catch mode on |
coff:<0/1> |
switch catch mode off |
ctime:<0/1>:<min> |
set catch mode interval (60-240 min) |
rtime:<0/1>:<sec> |
set speed rise time (0-240 sec) |
rnval:<0/1>:<rpm> |
set randon value range (0-1000 rpm) |
otime:<0/1>:<hour> |
switch stirrer off after time in hours (1-99 hour, 0 deactivates switch off) |
All commands return a colon separated string with all current parameters:
| Element | Stirrer | Variable in stir.ino | Description |
|---|---|---|---|
| 0 | 0 | F[0] |
state (0=on, 1=off) |
| 1 | 0 | v[0] |
speed (rpm) |
| 2 | 0 | b[0] |
boost speed (rpm) |
| 3 | 0 | rpm[0] |
rpm |
| 4 | 0 | xpm[0] |
averaged rpm |
| 5 | 0 | r[0] |
regulation value |
| 6 | 0 | bstate[0] |
boost state (0=on, 1=off) |
| 7 | 0 | btime[0] |
boost time (min) |
| 8 | 0 | cat[0] |
fish catch mode state (0=on, 1=off) |
| 9 | 0 | ctime[0] |
fish catch time interval (min) |
| 10 | 0 | rtime[0] |
speed rise time (sec) |
| 11 | 0 | otime[0] |
switch off time (hour) |
| 12 | 0 | rnval[0] |
random value range (rpm) |
| 13 | 0 | rnd[0] |
current random value (rpm) |
| 14 | 0 | boost remain (sec) | |
| 15 | 0 | off timer remain (sec) | |
| 16 | 1 | F[1] |
state (0=on, 1=off) |
| 17 | 1 | v[1] |
speed (rpm) |
| 18 | 1 | b[1] |
boost speed (rpm) |
| 19 | 1 | rpm[1] |
rpm |
| 20 | 1 | xpm[1] |
averaged rpm |
| 21 | 1 | r[1] |
regulation value |
| 22 | 1 | bstate[1] |
boost state (0=on, 1=off) |
| 23 | 1 | btime[1] |
boost time (min) |
| 24 | 1 | cat[1] |
fish catch mode state (0=on, 1=off) |
| 25 | 1 | ctime[1] |
fish catch time interval (min) |
| 26 | 1 | rtime[1] |
speed rise time (sec) |
| 27 | 1 | otime[1] |
switch off time (hour) |
| 28 | 1 | rnval[1] |
random value range (rpm) |
| 29 | 1 | rnd[1] |
current random value (rpm) |
| 30 | 1 | boost remain (sec) | |
| 31 | 1 | off timer remain (sec) | |
| 32 | software version | ||
| 33 | uptime (ms) | ||
| 34 | 0=ok, 1=error |
Schematics
