gmt_dos-actors 3.0.0

Giant Magellan Telescope Dynamic Optical Simulation Actor Model
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
81
82
83
84
85
86
87
88
89
90
91
92
93

#![allow(irrefutable_let_patterns)]
/*!
# GMT Fast Steering Mirror control clients

The module implements the client interface for the GMT FSM control model from the [m2-ctrl] crate,
it includes:
 - the M2 positionner client
 - the M2 piezostack client
 - the M2 segment tip-tilt controller client

*The 3 clients are enabled with the `fsm` feature.*

# Example

M2 positionner actor:
```
use dos_actors::clients::fsm::*;
use dos_actors::prelude::*;
let mut m2_positionner: Actor<_> = fsm::positionner::Controller::new().into();
```

M2 piezostack actor:
```
# use dos_actors::clients::fsm::*;
# use dos_actors::prelude::*;
let mut m2_piezostack: Actor<_> = fsm::piezostack::Controller::new().into();
```

M2 segment tip-tilt actor:
```
# use dos_actors::clients::fsm::*;
# use dos_actors::prelude::*;
let sim_sampling_frequency: usize = 1000;//Hz
const FSM_RATE: usize = 5;
assert_eq!(sim_sampling_frequency / FSM_RATE, 200);
let mut m2_tiptilt: Actor<_, FSM_RATE, 1> = fsm::tiptilt::Controller::new().into();
```

[m2-ctrl]: https://github.com/rodrigo-romano/m2-ctrl-code/tree/2022-03-update
*/
use crate::{
    impl_read, impl_update, impl_write,
    io::{Data, Read, Write},
    Update,
};
use m2_ctrl::{piezostack, positionner, tiptilt};
use std::{ptr, sync::Arc};
use uid_derive::UID;

/// positionner input
#[derive(UID)]
pub enum M2poscmd {}
/// positionner input
#[derive(UID)]
pub enum M2posFB {}
/// positionner output
#[derive(UID)]
pub enum M2posactF {}
/// piezostack input and tiptilt output
#[derive(UID)]
pub enum PZTcmd {}
/// piezostack input
#[derive(UID)]
pub enum PZTFB {}
/// piezostack output
#[derive(UID)]
pub enum PZTF {}
/// tiptilt input
#[derive(UID)]
pub enum TTSP {}
/// tiptilt output
#[derive(UID)]
pub enum TTFB {}

impl_update! {positionner}
impl_read! {positionner, (M2poscmd, m2_pos_cmd), (M2posFB, m2_pos_fb)}
impl_write! {positionner, (M2posactF,m2_pos_act_f)}
#[cfg(feature = "fem")]
impl_write! {fem::fem_io::MCM2SmHexF, positionner, (M2posactF,m2_pos_act_f)}
#[cfg(feature = "fem")]
impl_read! {fem::fem_io::MCM2SmHexD,positionner, (M2posFB, m2_pos_fb)}

impl_update! {piezostack}
impl_read! {piezostack, (PZTcmd, pzt_cmd), (PZTFB, pzt_fb)}
impl_write! {piezostack, (PZTF, pzt_f)}
#[cfg(feature = "fem")]
impl_read! {fem::fem_io::MCM2PZTD, piezostack, (PZTFB, pzt_fb)}
#[cfg(feature = "fem")]
impl_write! {fem::fem_io::MCM2PZTF,piezostack, (PZTF, pzt_f)}

impl_update! {tiptilt}
impl_read! {tiptilt, (TTSP, tt_sp), (TTFB, tt_fb)}
impl_write! {tiptilt, (PZTcmd, pzt_cmd)}