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 safety-writeback-rollback writes and verifies P, then I, then D in sequence, stopping at the first failure – so a partial attempt leaves the 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 history-writeback-audit exists to provide.

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for TuneWriteRow