Camera cooling

The goal: get the sensor to a stable known temperature before exposing, so calibration frames stay valid across the night.

Settings (Settings → Cooling)

The most important:

Slow ramp

Rather than slamming the setpoint and letting the camera's firmware absorb the shock, Starship can walk the setpoint to the target linearly over a set time — gentler on the TEC.

The same ramp is used going both ways: a cool-down to a colder setpoint and a warm-up toward ambient both ramp when a ramp time is configured.

Console widget

Folded into the Camera card, shown only when a camera with temperature control is connected. Live readout: sensor temp, setpoint, Δ from setpoint (green = settled, amber = ramping), power %, state pill. Manual controls: a Set target box with an optional Ramp (min) field next to it, Apply target, Cooler ON, Cooler OFF, and Warm up.

Enter a target and press Apply target to command the setpoint. Leave Ramp blank to use the configured ramp time, enter 0 to slam straight to the target, or enter a number of minutes to ramp over that time regardless of the config default. Warm up ramps back toward the warm-up target (or straight to it if no ramp is set), then switches the cooler off.

Power % at 100% means the cooler is maxed out — you're asking for a setpoint it can't reach. The widget colors this red.

The state pill reads cooler off, cooling, settled, or idle / at ambient — the last one covers the common case of a camera that reports its cooler "on" the moment it connects but isn't actually pulling any power.

A cooler that reads on but draws nothing

Some drivers report the cooler on while it draws 0 % and the sensor drifts up to ambient (rig 1's ToupTek); writing "on" again changes nothing, switching it off and on does. Starship watches for it after Apply target and Cooler ON, at a plan's cooling start, in every cool-down through a blockscript cool to or a ramp, and before every sub of a run. A cooler that shows no power while the sensor does not fall (for a minute after a new target, or two subs in a row during a run) is switched off and on once and its setpoint sent again - during a ramp that is the ramp's current setpoint, and the ramp waits meanwhile. If it still draws nothing you get a warning: check the camera's 12 V supply. The check after a new target stands down when anything else switches the cooler off (a warm-up, a shutdown, the Cooler OFF button), so it never turns a cooler back on behind you. A camera that does not report its cooler power is not checked during a cool to or a ramp.

Sequencer integration

The Cooling tab on the sequence editor:

If cooling is requested with wait-for-settle and it fails (timeout, unable to reach), the sequence aborts. There's no point capturing at uncontrolled temperatures.

If a ramp time is configured, the cool-on-start and the warm-up-at-end both ramp the setpoint gently rather than slamming it — the settle wait still gates until the sensor reaches and holds the target.

Cool camera as a step action

You can also cool (or re-cool) mid-sequence by dropping a Cool camera action into the steps: it takes an optional setpoint (blank turns the cooler on at the current/default target), an over min ramp qualifier (ramp to the setpoint over that many minutes instead of slamming it), and a wait settle toggle. This gives you a per-step temperature override without touching the global setpoint, and is available in the on-start and on-resume action lists too.

Blockscript

Unattended blockscripts have matching cooling verbs for the startup/shutdown states: cool to (target °C over an optional number of minutes) and warm cooler. Warm cooler with a target_c and minutes ramps the setpoint up to the target over that many minutes, waits for the sensor (at most minutes + warm_up_timeout_min; a night colder than the target just times out), then switches the cooler off — it waits until that is done. With no target it keeps the old behaviour (the warm-up target above, else straight off). The typical startup cools to −10 over 5 minutes; the typical shutdown warms to 15 °C over 10 minutes before closing up and powering down.

What's not built yet

Auto-scale fallback (try −25 if −30 fails) for marginal coolers in summer is not built, and the Settings field for it was removed in v23 because nothing read it. Everything else that used to live here has shipped: the slow ramp now runs on cool-down, warm-up, the console widget, sequence steps, and blockscripts; per-event setpoint overrides are handled by the Cool camera step action and the blockscript cool-to verb.

Astroworx Starship v23.1.2 · this page is the in-app help of that buildDownload · HTTP API