13. Configuration Settings - larry-athey/rpi-smart-still GitHub Wiki

Program Editor

Program Name: Not a whole lot of explanation needed here, all programs need a name.

Program Type: This dropdown list is used to select Reflux Mode or Pot Still Mode. You will notice that the lower portion of this form changes between dephlegmator management and column management settings when you change the program type.

ABV Managed: This switch turns the ABV management feature on and off. (LIDAR Hydrometer Reader required)

Target % ABV: In pot still mode, this is the minimum ABV level that you allow the distillate to drop to before the distillation run is stopped. You could choose a value like 40% to keep yourself out of the tails, then switch over to a maximum reflux program to finish stripping out all remaining ethanol to boost your existing take or add to a future run. In reflux mode, this progressively reduces the dephleg overall temperature range by 1C in order to maintain a minimum target ABV.

Flow Managed: This switch turns the flow management feature on and off. (LIDAR Hydrometer Reader required)

Minimum Flow %: This is the minimum flow level that you allow the flow sensor to drop to before the distillation run is stopped. Keep in mind that neither the flow rate nor ABV management routines are functional during a distillation run until the hydrometer begins reading more than zero. It's best to leave your hydrometer out of your proofing parrot until after it begins overflowing.

Condenser Valve %: Once your boiler has reached the minimum operating temperature, your condenser cooling water valve opens. This tells the controller how far to open the valve. You don't necessarily have to run your condenser cooling at 100%. If you run on a pump, you may only want to open it to 50% so it doesn't steal pressure from the dephlegmator.

Dephleg Valve Start %: In a reflux mode run, you want your dephlegmator cooling water valve to start at a point slightly below the average position during an active run. Until your dephlegmator reaches its minimum operating temperature, the temperature management routines don't begin. Let's say that during a manual run, you determined that the target temperature that you aimed for required the valve to be open to 33%, you should set your starting position to 30% or maybe a little lower. This allows the management routines to stabilize before you reach your intended target temperature.

Boilermaker Fallback % or Heating Idle Position: The label for the following field will change based on whether you are using a Boilermaker or stepper motor heating control. When you start a run, your heating starts at 100% (or whatever your Boilermaker startup power is set to). Once your boiler reaches its minimum operating temperature, the power will fall back to an idle position. In the case of a Boilermaker, this is a power percentage. In the case of the stepper motor, this is the step position. (Refer to the Configure Heating section for more details)

Boiler Managed: This switch turns the boiler management routines on and off for this program.

Boiler Low (C) and Boiler High (C): These determine the minimum and maximum boiler temperatures for the current program. Refer to the Configure Tuning section for more details on how the management works.

Column Managed: This switch turns the column management routines on and off for this program (pot still mode).

Column Low (C) and Column High (C): These determine the minimum and maximum column temperatures for the current program (pot still mode). Refer to the Configure Tuning section for more details on how the management works.

Dephleg Managed: This switch turns the dephlegmator management routines on and off for this program (reflux mode).

Dephleg Low (C) and Dephleg High (C): These determine the minimum and maximum dephleg temperatures for the current program (reflux mode). Refer to the Configure Tuning section for more details on how the management works.

Program Notes: Self-explanatory, this notepad isn't visible anywhere else in the system, up to 65K characters allowed.

Configure Sensors

The RPi hat has four screw terminals for DS18B20 digital temperature sensors. One for the dephlegmator, one for the column, and one for the boiler if you are using stepper motor based heating control. An additional terminal is included for custom script usage. For example, a sensor in a chiller tank to control the onboard relays for cooling water temperature management.

In the above screenshot, the frame on the right shows the address and temperature of all active sensors connected to the system. The dropdown lists on the left are used to assign each sensor to a specific function. It's usually easier to connect your sensors one at a time and assign them where you want them. In the case of the screenshot in the above, a Boilermaker is in use so there is no Boiler Sensor Address dropdown list.

If a sensor becomes disconnected or goes bad, it will disappear from the list on the right and its assigned device will show no address. If you notice a sensor on the main dashboard no longer updating, you should look here to see if it's disconnected or has gone bad.

Configure Heating

The RPi Smart Still controller system can manage the boiler heating anywhere there is a dial to turn it up and down, or wirelessly if you are a Boilermaker owner. Dial control requires a Nema 17 stepper motor, no other size. You will also need a motor mounting bracket and a coupler to connect the two shafts together. If you need more torque, such as in the case of a gas valve on a propane burner, you will need a Nema 17 with a built-in planetary gear box.

- Stepper Motor Control

This screenshot is of the settings for those who are using a stepper motor control an SCR controller with a dial or a natural gas valve. Keep in mind that if you are using an SCR controller with a logarithmic taper potentiometer, 10% of stepper motor movement will not equal 10% difference in the SCR duty cycle, as you can see in the values shown below. You may want to replace the potentiometer with one of the same resistance, but with a linear taper instead.

Heat Management Enabled: This is a master switch that controls all boiler control support whether stepper motor control or Boilermaker control. This also prevents the boiler from starting up using the manual Heat Jump function or the manual position editor.

Boilermaker Enabled: This switch tells the system whether you are using stepper motor heating control or using a Boilermaker. You will need to click the Submit button and come back to this page to use the new setting parameters.

Inverted Stepper Rotation: This swaps the direction that your stepper motor turns. People commonly get the motor coil wires reversed when connecting their stepper motor to the RPi hat. You can just change the rotation direction with this switch instead of rewiring the motor.

Analog Heat Controller: Analog SCR controllers aren't reliable when dialing the power down because of the capacitors in the circuit holding a charge hold that prevents the SCR's duty cycle from accurately tracking changes to the potentiometer position. The only way to dial down to a lower setting is to dial all the way to zero for 1 second and then dial up to the new lower setting. Digital SCR controllers with an encoder knob "usually" don't have this problem.

Total Adjustment Steps: Stepper motors running at their lowest resolution (where the most torque is) have 200 steps per revolution. In this screenshot, you see that it's set to 140 and that's how many steps are required to run the potentiometer on the SCR controller from full off to full on. This value will multiply if you have a Nema 17 with an 8:1 planetary gear box, which will be 1600 steps per revolution and may require 6400 steps to open a gas valve.

10% - 90% Position: These are values that you will have to work out and are used by the Heat Jump function in the Management menu. These aren't an absolute requirement, you don't have to use that feature and these aren't used anywhere else in the system. These are just provided as a convenience so you can easily preheat your boiler at a specific power level.

- Boilermaker Control

If you are a Boilermaker owner, all you need to know is the IP address of the device on your network. This guide assumes that you have already tuned the Boilermaker's PWM duty time to suit your boiler's wattage and volume. Refer to this page for information on configuring the settings shown in the screenshot below.

Configure Tuning

Fields in this page are used to configure the logic timing parameters that are used in the logic-processor.php undercarriage script. Such as the various watchdog timers and the dephlegmator microstep/largestep pulse times. The defaults should work for most stills, but there will always be an outlier that just needs more hand-holding. All watchdog timers have a minimum limit of 30 seconds to prevent CPU overloading.

Boiler Watch: Boiler watchdog timer, default is 900 seconds (15 minutes). This timer watches the boiler during an active run to keep it within the upper and lower temperature limits defined by the current program. This controls how much time there is between correction adjustments, unless you are using a Boilermaker running its own internal temperature management routines. This only applies to the stepper motor control of an SCR controller or gas valve, or a Boilermaker running in constant power mode.

Column Watch: Column watchdog timer, default is 300 seconds (5 minutes). This timer watches the column during an active pot still run to keep it within the upper and lower temperature limits defined by the current program. In a pot still run, this will adjust the boiler power by 1 point up or down if the column temperature is out of range. This controls how much time there is between correction adjustments.

Dephleg Watch: Dephlegmator watchdog timer, default is 120 seconds (2 minutes). This timer watches the dephlegmator during an active reflux mode run to keep it within the upper and lower temperature limits defined by the current program. In a reflux mode run, cooling water flow is adjusted either by microsteps or large steps depending on how far off it is from the temperature range center. This controls how much time there is between correction adjustments.

Flow Watch: Flow rate watchdog timer, default is 300 seconds (5 minutes). If your current program uses flow rate management, this timer determines how frequently to check the flow sensor to determine if the flow rate has dropped to an unacceptable level. Three consecutive checks below the defined flow rate level will cause the distillation run to be shut down. These must be consecutive failures, not simply cumulative failures.

ABV Watch: ABV level watchdog timer, default is 300 seconds (5 minutes). If your current program uses ABV management, this timer determines how frequently to check the LIDAR hydrometer reader to determine if the ABV is no longer at an unacceptable level. In a reflux mode run, three consecutive checks above the defined ABV level will cause the dephleg temperature range to be adjusted downward by 1C in order to maintain a minimum targeted ABV. In a pot still run, this determines the minimum ABV that you will allow before the run shuts down. These must be consecutive failures, not simply cumulative failures.

Dephleg Driver: Are you using a Dephleg Driver rather than a motorized ball valve for the dephlegmator? Dephleg drivers use different values for microsteps and large steps and only use whole numbers (you can't use a value like 0.25%). So we need to tell the undercarriage which timing values to use with this switch.

Dephleg Micro Step: In a reflux mode program, you choose a temperature range of 5C (example: 55C to 60C) which makes 57.5C the range center. Micro steps are used to keep the dephlegmator temperature between 57C and 58C in this example. If using a US Solid brand motorized ball valve with a 10-second full open/close travel time, these micro steps should only need to be 1/10th of a percent (100 milliseconds).

Dephleg Large Step: Using the same example range as shown in the Dephleg Micro Step explanation, large steps are used if the temperature is between 55C and 57C, or between 58C and 60C. Since the temperature is further away from the range center, a longer pulse needs to be sent to the motor to open up the water flow further. 2.5 to 3 times the length of a micro step is usually enough, any more than that can result in overshooting the target to an unrecoverable state.

Driver Micro Step: Using the same example range as shown in the Dephleg Micro Step explanation, a dephleg driver uses full 1% steps rather than fractions because it's running a PWM driven peristaltic pump motor and a PWM doesn't do fractions of a percent in duty times. In this example, we use 1% steps to target the range center between 57C and 58C. This is more than adequate for any 2" shotgun style dephlegmator.

Driver Large Step: In keeping with the same example range as shown in the Dephleg Large Step explanation, a dephleg driver would use 3 times the value of a micro step for large steps. Peristaltic pumps move very limited amounts of water, so a 3% jump isn't anywhere near as drastic as you might initially think it is. If you are using a 3" to 8" column with a matching dephlegmator, you may need to add 1% per extra inch in column diameter.

Distillate Temp Watch: The RPi Smart Still and LIDAR Hydrometer Reader allow you to monitor the temperature of your distillate so you can avoid running your condenser too hot and filling the room with combustible ethanol vapors. This setting is for the watchdog that keeps track of the distillate temperature is also uses the same 3-strikes method that are covered in the above watchdog explanations. 300 seconds (5 minutes) is the default.

Distillate Max Temp: The default maximum allowed distillate temperature is 26.6C (80F). If the watchdog's 3-strike rule has triggered, this will increase the condenser cooling water flow by 5% until the distillate temperature falls back down below this limit. Please note that Still Spirits T500 columns are notorious for putting out dangerously hot distillate, even if your condenser cooling valve is cranked all the way open to 100%.

Calibrate Hydrometer

Instructions for using the calibration functions of this page are covered here. As you probably guessed, this requires you to have a LIDAR Hydrometer Reader connected to your RPi Smart Still controller system.

Control Relays

This page is 100% self-explanatory. The RPi hat has two manually controlled relays that can be used to control pumps or other accessories. These are SPDT switches so they have both a normally-on and normally-off terminal. How you choose to wire them and what they switch is completely up to you. Just keep in mind that these are only safe for low-voltage and low-current loads.