autocore-std 3.3.30

Standard library for AutoCore control programs - shared memory, IPC, and logging utilities
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80

//! Generic hardware interface for CiA 402 servo drives.
//!
//! [`AxisView`] provides raw PDO field access. The [`Axis`](super::Axis)
//! struct handles all CiA 402 protocol logic (state machine, PP handshake,
//! homing) on top of this, so implementors only need to map PDO fields.

/// Generic hardware interface for a CiA 402 servo drive.
///
/// Maps raw PDO fields. The [`Axis`](super::Axis) struct handles all CiA 402
/// protocol logic (state machine, PP handshake, homing) on top of this.
///
/// # Implementing
///
/// Implementors just map their struct's PDO fields — no CiA 402 protocol
/// knowledge is needed:
///
/// ```ignore
/// impl AxisView for MyDriveView<'_> {
///     fn control_word(&self) -> u16 { *self.control_word }
///     fn set_control_word(&mut self, w: u16) { *self.control_word = w; }
///     fn status_word(&self) -> u16 { *self.status_word }
///     fn set_target_position(&mut self, pos: i32) { *self.target_position = pos; }
///     // ... etc
/// }
/// ```
pub trait AxisView {
    // ── Control word (RxPDO) ──

    /// Read the current control word.
    fn control_word(&self) -> u16;
    /// Write the control word.
    fn set_control_word(&mut self, word: u16);

    // ── Targets (RxPDO) ──

    /// Set the target position in encoder counts.
    fn set_target_position(&mut self, pos: i32);
    /// Set the profile velocity in counts/s.
    fn set_profile_velocity(&mut self, vel: u32);
    /// Set the profile acceleration in counts/s².
    fn set_profile_acceleration(&mut self, accel: u32);
    /// Set the profile deceleration in counts/s².
    fn set_profile_deceleration(&mut self, decel: u32);

    // ── Mode (RxPDO / TxPDO) ──

    /// Write the modes of operation register (0x6060).
    fn set_modes_of_operation(&mut self, mode: i8);
    /// Read the modes of operation display (0x6061).
    fn modes_of_operation_display(&self) -> i8;

    // ── Status (TxPDO) ──

    /// Read the status word.
    fn status_word(&self) -> u16;
    /// Read the actual position in encoder counts.
    fn position_actual(&self) -> i32;
    /// Read the actual velocity in counts/s.
    fn velocity_actual(&self) -> i32;

    // ── Optional: error code from TxPDO (vendor-mapped) ──

    /// Read the drive error code. Returns 0 if not mapped.
    fn error_code(&self) -> u16 { 0 }

    // ── Optional: limit switches and home sensor ──

    /// True when the positive-direction hardware limit switch is active.
    ///
    /// Implement this to wire a physical limit switch input from your
    /// global memory / PDO mapping. If not implemented, returns `false`
    /// (no limit switch).
    fn positive_limit_active(&self) -> bool { false }

    /// True when the negative-direction hardware limit switch is active.
    fn negative_limit_active(&self) -> bool { false }

    /// True when the home reference sensor is active.
    fn home_sensor_active(&self) -> bool { false }
}