Struct TuneWriteRow 

pub struct TuneWriteRow {

    pub id: i64,
    pub run_id: i64,
    pub response_level: ResponseLevel,
    pub written_at: DateTime<Utc>,
    pub kind: WriteKind,
    pub allow_uncertain_quality: bool,
    pub previous: Option<WriteReadback>,
    pub proportional_written: Option<f32>,
    pub integral_written: Option<f32>,
    pub derivative_written: Option<f32>,
    pub proportional_readback: Option<f32>,
    pub integral_readback: Option<f32>,
    pub derivative_readback: Option<f32>,
    pub success: bool,
    pub error_message: Option<String>,
    pub rollback_state: Option<RollbackState>,
    pub rollback_error: Option<String>,
}

One row of tune_writes: an audit record of PID constants actually written back to the DCS for one [ResponseLevel] of one run, distinct from what was merely calculated (TuneResultRow). Flattened for the same reason as TuneResultRow.

*_written/*_readback are independently nullable (not all-or-nothing like previous) because the operation writes and verifies P, then I, then D in sequence, stopping at the first failure. A partial attempt leaves constants after the failure point at None rather than 0, distinguishing “never attempted” from “attempted and confirmed zero”.

Fields

id: i64

run_id: i64

response_level: ResponseLevel

written_at: DateTime<Utc>

kind: WriteKind

Whether this row is a normal write-back or bhtune history revert undoing one. See WriteKind.

allow_uncertain_quality: bool

Whether this operation allowed Quality::Uncertain readings. This is the explicit per-operation policy supplied at insertion time; it is independent of TuneRunRow::allow_uncertain_quality.

previous: Option<WriteReadback>

The P/I/D values read from the driver before any write was attempted. None only when the pre-read itself failed – a hard stop before any write, so nothing else on this row was ever attempted either (success = false, every other field below None).

proportional_written: Option<f32>

integral_written: Option<f32>

derivative_written: Option<f32>

proportional_readback: Option<f32>

Read back immediately after writing to confirm the DCS accepted the value within tolerance. None whenever the corresponding *_written field is None, or when the write was sent but the readback attempt itself failed.

integral_readback: Option<f32>

derivative_readback: Option<f32>

success: bool

error_message: Option<String>

rollback_state: Option<RollbackState>

Set only when success = false and at least one constant had already been written before the failure, so a best-effort rollback to previous was attempted. None means rollback did not apply – either every constant wrote successfully (success = true) or the pre-read failed before any write was attempted. Always None for a kind = Revert row.

rollback_error: Option<String>

Implementations

impl TuneWriteRow

pub async fn insert( pool: &SqlitePool, run_id: i64, new: NewTuneWrite, ) -> DbResult<TuneWriteRow>

Records one write-back attempt exactly as new describes it – see NewTuneWrite.

pub async fn list_for_run( pool: &SqlitePool, run_id: i64, ) -> DbResult<Vec<TuneWriteRow>>

Lists every write-back attempt for run_id, oldest first — the full “who changed this loop and when” audit trail.

Trait Implementations

impl Clone for TuneWriteRow

fn clone(&self) -> TuneWriteRow

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for TuneWriteRow

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl PartialEq for TuneWriteRow

fn eq(&self, other: &TuneWriteRow) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for TuneWriteRow