sat-rs/satrs/tests/mode_tree.rs

1731 lines
57 KiB
Rust
Raw Normal View History

use core::cell::Cell;
2024-12-02 16:37:28 +01:00
use satrs::mode::{
Mode, ModeError, ModeProvider, ModeReplyReceiver, ModeReplySender, ModeRequestHandler,
2024-12-03 21:08:26 +01:00
ModeRequestHandlerMpscBounded, ModeRequestReceiver, ModeRequestSender,
2024-12-09 17:28:28 +01:00
ModeRequestorAndHandlerMpscBounded, ModeRequestorOneChildBoundedMpsc, INVALID_MODE,
UNKNOWN_MODE,
2024-12-02 16:37:28 +01:00
};
2024-11-28 12:36:43 +01:00
use satrs::mode_tree::{
2024-12-02 16:37:28 +01:00
connect_mode_nodes, ModeChild, ModeNode, ModeParent, ModeStoreProvider, SequenceTableEntry,
2024-12-03 21:08:26 +01:00
SequenceTableMapTable, TargetNotInModeStoreError, TargetTableEntry,
2024-11-26 10:25:56 +01:00
};
2024-11-28 12:36:43 +01:00
use satrs::mode_tree::{
ModeStoreVec, SequenceModeTables, SequenceTablesMapValue, TargetModeTables,
TargetTablesMapValue,
};
2025-01-16 13:56:49 +01:00
use satrs::request::{MessageMetadata, RequestId};
2025-01-16 16:49:35 +01:00
use satrs::res_code::ResultU16;
2025-01-16 13:56:49 +01:00
use satrs::subsystem::{
2025-01-17 14:18:16 +01:00
ModeCommandingResult, ModeDoesNotExistError, SequenceExecutionHelper, TargetKeepingResult,
2025-01-16 13:56:49 +01:00
};
use satrs::{
mode::{ModeAndSubmode, ModeReply, ModeRequest},
queue::GenericTargetedMessagingError,
request::GenericMessage,
ComponentId,
};
2025-01-16 16:49:35 +01:00
use std::borrow::Borrow;
2024-11-26 18:11:00 +01:00
use std::cell::RefCell;
use std::collections::VecDeque;
use std::convert::Infallible;
use std::{println, sync::mpsc};
2024-11-28 12:36:43 +01:00
pub enum DefaultMode {
OFF = 0,
ON = 1,
NORMAL = 2,
}
2024-11-26 18:11:00 +01:00
#[derive(Debug)]
pub enum AcsMode {
OFF = 0,
SAFE = 1,
2024-11-28 12:36:43 +01:00
IDLE = 2,
2024-11-26 18:11:00 +01:00
}
2024-11-26 10:25:56 +01:00
pub enum TestComponentId {
2024-11-28 12:36:43 +01:00
MagnetometerDevice0 = 1,
MagnetometerDevice1 = 2,
MagnetorquerDevice = 5,
ReactionWheelDevice = 6,
StartrackerDevice = 7,
MgtDevManager = 8,
ReactionWheelAssembly = 10,
MagnetometerAssembly = 11,
2024-11-26 10:25:56 +01:00
AcsController = 14,
AcsSubsystem = 15,
PusModeService = 16,
}
pub type RequestSenderType = mpsc::SyncSender<GenericMessage<ModeRequest>>;
pub type ReplySenderType = mpsc::SyncSender<GenericMessage<ModeReply>>;
2025-01-16 16:49:35 +01:00
#[derive(Debug, Default, PartialEq, Eq)]
2024-12-04 16:59:09 +01:00
pub enum ModeTreeHelperState {
2024-12-09 17:28:28 +01:00
#[default]
2024-12-04 16:59:09 +01:00
Idle,
TargetKeeping = 1,
2025-01-17 14:18:16 +01:00
ModeCommanding = 2,
2024-12-04 16:59:09 +01:00
}
2025-01-17 14:18:16 +01:00
#[derive(Debug, Default)]
pub enum AssemblyHelperResult {
#[default]
Idle,
TargetKeepingViolation(ComponentId),
ModeCommandingDone,
}
#[derive(Debug, Default)]
pub enum SubsystemHelperResult {
#[default]
2024-12-04 16:59:09 +01:00
Idle,
2024-12-09 17:28:28 +01:00
TargetKeeping(TargetKeepingResult),
2025-01-17 14:18:16 +01:00
ModeCommanding(ModeCommandingResult),
2024-12-04 16:59:09 +01:00
}
2025-01-17 14:18:16 +01:00
impl From<TargetKeepingResult> for SubsystemHelperResult {
2024-12-09 17:28:28 +01:00
fn from(value: TargetKeepingResult) -> Self {
Self::TargetKeeping(value)
}
}
2025-01-17 14:18:16 +01:00
impl From<ModeCommandingResult> for SubsystemHelperResult {
fn from(value: ModeCommandingResult) -> Self {
Self::ModeCommanding(value)
2024-12-04 16:59:09 +01:00
}
}
#[derive(Debug, thiserror::Error)]
pub enum ModeTreeHelperError {
#[error("generic targeted messaging error: {0}")]
Message(#[from] GenericTargetedMessagingError),
2024-12-09 17:28:28 +01:00
#[error("current mode {0} is not contained in target table")]
CurrentModeNotInTargetTable(Mode),
2024-12-04 16:59:09 +01:00
}
2024-12-09 17:28:28 +01:00
2025-01-16 16:49:35 +01:00
pub struct SubsystemCommandingHelper {
2024-12-09 17:28:28 +01:00
pub current_mode: ModeAndSubmode,
2024-12-04 16:59:09 +01:00
pub state: ModeTreeHelperState,
2024-11-28 12:36:43 +01:00
pub children_mode_store: ModeStoreVec,
2025-01-17 14:39:28 +01:00
pub active_request_id: Option<RequestId>,
2024-11-28 12:36:43 +01:00
pub target_tables: TargetModeTables,
pub sequence_tables: SequenceModeTables,
2024-12-03 17:37:17 +01:00
pub helper: SequenceExecutionHelper,
2024-11-28 12:36:43 +01:00
}
2024-12-04 16:59:09 +01:00
2025-01-16 16:49:35 +01:00
impl Default for SubsystemCommandingHelper {
2024-12-09 17:28:28 +01:00
fn default() -> Self {
Self {
current_mode: UNKNOWN_MODE,
state: Default::default(),
children_mode_store: Default::default(),
2025-01-17 14:39:28 +01:00
active_request_id: None,
2024-12-09 17:28:28 +01:00
target_tables: Default::default(),
sequence_tables: Default::default(),
helper: Default::default(),
}
}
}
2025-01-16 16:49:35 +01:00
impl SubsystemCommandingHelper {
2024-12-03 17:37:17 +01:00
pub fn new(
children_mode_store: ModeStoreVec,
target_tables: TargetModeTables,
sequence_tables: SequenceModeTables,
2024-12-03 21:08:26 +01:00
) -> Self {
2024-12-03 17:37:17 +01:00
Self {
2024-12-09 17:28:28 +01:00
current_mode: UNKNOWN_MODE,
2024-12-04 16:59:09 +01:00
state: ModeTreeHelperState::Idle,
2024-12-03 17:37:17 +01:00
children_mode_store,
2025-01-17 14:39:28 +01:00
active_request_id: None,
2024-12-03 17:37:17 +01:00
target_tables,
sequence_tables,
helper: Default::default(),
}
}
2025-01-20 11:51:12 +01:00
pub fn add_mode_child(&mut self, child: ComponentId, mode: ModeAndSubmode) {
self.children_mode_store.add_component(child, mode);
}
2025-01-16 13:56:49 +01:00
pub fn start_command_sequence(
&mut self,
mode: Mode,
request_id: RequestId,
) -> Result<(), ModeDoesNotExistError> {
self.helper.load(mode, request_id, &self.sequence_tables)?;
2025-01-17 14:18:16 +01:00
self.state = ModeTreeHelperState::ModeCommanding;
2025-01-16 13:56:49 +01:00
Ok(())
}
2024-12-04 16:59:09 +01:00
pub fn state_machine(
2024-12-03 21:08:26 +01:00
&mut self,
2025-01-16 13:56:49 +01:00
opt_reply: Option<GenericMessage<ModeReply>>,
2024-12-03 21:08:26 +01:00
req_sender: &impl ModeRequestSender,
2025-01-17 14:18:16 +01:00
) -> Result<SubsystemHelperResult, ModeTreeHelperError> {
2024-12-04 16:59:09 +01:00
if let Some(reply) = opt_reply {
2025-01-16 13:56:49 +01:00
self.handle_mode_reply(&reply);
2024-12-04 16:59:09 +01:00
}
match self.state {
2025-01-17 14:18:16 +01:00
ModeTreeHelperState::Idle => Ok(SubsystemHelperResult::Idle),
2024-12-04 16:59:09 +01:00
ModeTreeHelperState::TargetKeeping => {
2024-12-09 17:28:28 +01:00
// We check whether the current mode is modelled by a target table first.
if let Some(target_table) = self.target_tables.0.get(&self.current_mode.mode()) {
for entry in &target_table.entries {
if !entry.monitor_state {
continue;
}
let mut target_mode_violated = false;
self.children_mode_store.0.iter().for_each(|val| {
if val.id() == entry.common.target_id {
target_mode_violated = if let Some(allowed_submode_mask) =
entry.allowed_submode_mask()
{
let fixed_bits = !allowed_submode_mask;
(val.mode_and_submode().mode()
!= entry.common.mode_submode.mode())
&& (val.mode_and_submode().submode() & fixed_bits
!= entry.common.mode_submode.submode() & fixed_bits)
} else {
val.mode_and_submode() != entry.common.mode_submode
};
}
})
}
// Target keeping violated. Report violation and fallback mode to user.
return Ok(TargetKeepingResult::Violated {
fallback_mode: None,
}
.into());
}
2025-01-17 14:18:16 +01:00
Ok(SubsystemHelperResult::TargetKeeping(
TargetKeepingResult::Ok,
))
2024-12-04 16:59:09 +01:00
}
2025-01-17 14:18:16 +01:00
ModeTreeHelperState::ModeCommanding => {
2025-01-16 16:49:35 +01:00
let result = self.helper.run(
2024-12-09 17:28:28 +01:00
&self.sequence_tables,
req_sender,
&mut self.children_mode_store,
2025-01-16 16:49:35 +01:00
)?;
// By default, the helper will automatically transition into the target keeping
// mode after an executed sequence.
2025-01-17 14:18:16 +01:00
if let ModeCommandingResult::CommandingDone = result {
2025-01-16 16:49:35 +01:00
self.state = ModeTreeHelperState::TargetKeeping;
2025-01-17 14:39:28 +01:00
self.active_request_id = None;
2025-01-16 16:49:35 +01:00
self.current_mode = ModeAndSubmode::new(self.helper.target_mode().unwrap(), 0);
}
Ok(result.into())
}
2024-12-04 16:59:09 +01:00
}
2024-12-03 21:08:26 +01:00
}
2025-01-16 16:49:35 +01:00
2025-01-17 14:18:16 +01:00
pub fn handle_mode_reply(&mut self, reply: &GenericMessage<ModeReply>) {
if !self.children_mode_store.has_component(reply.sender_id()) {
return;
}
let mut generic_mode_reply_handler =
|sender_id, mode_and_submode: Option<ModeAndSubmode>| {
2025-01-17 14:39:28 +01:00
// Tying the reply awaition to the request ID ensures that something like replies
// belonging to older requests do not interfere with the completion handling of
// the mode commanding. This is important for forced mode commands.
let mut handle_awaition = false;
if self.state == ModeTreeHelperState::ModeCommanding
&& self.active_request_id.is_some()
&& reply.request_id() == self.active_request_id.unwrap()
{
handle_awaition = true;
}
let still_awating_replies = self.children_mode_store.generic_reply_handler(
sender_id,
mode_and_submode,
handle_awaition,
);
2025-01-17 14:18:16 +01:00
if self.state == ModeTreeHelperState::ModeCommanding && !still_awating_replies {
self.helper.confirm_sequence_done();
}
};
match reply.message {
ModeReply::ModeInfo(mode_and_submode) => {
generic_mode_reply_handler(reply.sender_id(), Some(mode_and_submode));
}
ModeReply::ModeReply(mode_and_submode) => {
generic_mode_reply_handler(reply.sender_id(), Some(mode_and_submode));
}
ModeReply::CantReachMode(_) => {
generic_mode_reply_handler(reply.sender_id(), None);
}
ModeReply::WrongMode { reached, .. } => {
generic_mode_reply_handler(reply.sender_id(), Some(reached));
}
};
}
2025-01-16 16:49:35 +01:00
pub fn add_target_and_sequence_table(
&mut self,
mode: Mode,
target_table_val: TargetTablesMapValue,
sequence_table_val: SequenceTablesMapValue,
) {
self.target_tables.0.insert(mode, target_table_val);
self.sequence_tables.0.insert(mode, sequence_table_val);
}
pub fn update_child_mode(
&mut self,
child: ComponentId,
mode: ModeAndSubmode,
) -> Result<(), TargetNotInModeStoreError> {
self.children_mode_store.set_mode(child, mode)
}
2024-11-28 12:36:43 +01:00
}
2024-11-26 18:11:00 +01:00
#[derive(Default, Debug)]
pub struct ModeRequestHandlerMock {
2025-01-16 16:49:35 +01:00
get_mode_calls: RefCell<usize>,
2024-11-26 18:11:00 +01:00
start_transition_calls: VecDeque<(MessageMetadata, ModeAndSubmode)>,
announce_mode_calls: RefCell<VecDeque<AnnounceModeInfo>>,
handle_mode_info_calls: VecDeque<(MessageMetadata, ModeAndSubmode)>,
handle_mode_reached_calls: RefCell<VecDeque<Option<MessageMetadata>>>,
send_mode_reply_calls: RefCell<VecDeque<(MessageMetadata, ModeReply)>>,
}
impl ModeRequestHandlerMock {
pub fn clear(&mut self) {
self.get_mode_calls.replace(0);
self.start_transition_calls.clear();
self.announce_mode_calls.borrow_mut().clear();
self.handle_mode_reached_calls.borrow_mut().clear();
self.handle_mode_info_calls.clear();
self.send_mode_reply_calls.borrow_mut().clear();
}
2025-01-16 16:49:35 +01:00
pub fn mode_messages_received(&self) -> usize {
*self.get_mode_calls.borrow()
+ self.start_transition_calls.borrow().len()
+ self.announce_mode_calls.borrow().len()
+ self.handle_mode_info_calls.borrow().len()
+ self.handle_mode_reached_calls.borrow().len()
+ self.send_mode_reply_calls.borrow().len()
}
2024-11-26 18:11:00 +01:00
}
impl ModeProvider for ModeRequestHandlerMock {
fn mode_and_submode(&self) -> ModeAndSubmode {
*self.get_mode_calls.borrow_mut() += 1;
INVALID_MODE
}
}
impl ModeRequestHandler for ModeRequestHandlerMock {
type Error = Infallible;
fn start_transition(
&mut self,
requestor: MessageMetadata,
mode_and_submode: ModeAndSubmode,
2025-01-16 13:56:49 +01:00
_forced: bool,
2024-11-26 18:11:00 +01:00
) -> Result<(), Self::Error> {
self.start_transition_calls
.push_back((requestor, mode_and_submode));
Ok(())
}
fn announce_mode(&self, requestor_info: Option<MessageMetadata>, recursive: bool) {
self.announce_mode_calls
.borrow_mut()
.push_back(AnnounceModeInfo {
requestor: requestor_info,
recursive,
});
}
fn handle_mode_reached(
&mut self,
requestor_info: Option<MessageMetadata>,
) -> Result<(), Self::Error> {
self.handle_mode_reached_calls
.borrow_mut()
.push_back(requestor_info);
Ok(())
}
fn handle_mode_info(
&mut self,
requestor_info: MessageMetadata,
info: ModeAndSubmode,
) -> Result<(), Self::Error> {
self.handle_mode_info_calls
.push_back((requestor_info, info));
todo!()
}
fn send_mode_reply(
&self,
requestor_info: MessageMetadata,
reply: ModeReply,
) -> Result<(), Self::Error> {
self.send_mode_reply_calls
.borrow_mut()
.push_back((requestor_info, reply));
Ok(())
}
}
2024-12-09 17:28:28 +01:00
#[derive(Default, Debug)]
2025-01-16 16:49:35 +01:00
pub struct ModeReplyHandlerMock {
mode_info_messages: VecDeque<(MessageMetadata, ModeAndSubmode)>,
mode_reply_messages: VecDeque<(MessageMetadata, ModeAndSubmode)>,
cant_reach_mode_messages: VecDeque<(MessageMetadata, ResultU16)>,
wrong_mode_messages: VecDeque<(MessageMetadata, ModeAndSubmode, ModeAndSubmode)>,
}
impl ModeReplyHandlerMock {
pub fn handle_mode_reply(&mut self, request: &GenericMessage<ModeReply>) {
match request.message {
ModeReply::ModeInfo(mode_and_submode) => {
self.mode_info_messages
.push_back((request.requestor_info, mode_and_submode));
}
ModeReply::ModeReply(mode_and_submode) => {
self.mode_reply_messages
.push_back((request.requestor_info, mode_and_submode));
}
ModeReply::CantReachMode(result_u16) => {
self.cant_reach_mode_messages
.push_back((request.requestor_info, result_u16));
}
ModeReply::WrongMode { expected, reached } => {
self.wrong_mode_messages
.push_back((request.requestor_info, expected, reached));
}
}
}
}
2024-12-09 17:28:28 +01:00
struct PusModeService {
pub request_id_counter: Cell<u32>,
2024-11-29 13:36:53 +01:00
pub mode_node: ModeRequestorOneChildBoundedMpsc,
}
impl PusModeService {
2024-11-26 18:11:00 +01:00
pub fn announce_modes_recursively(&self) {
self.mode_node
.send_mode_request(
self.request_id_counter.get(),
2024-11-26 10:25:56 +01:00
TestComponentId::AcsSubsystem as ComponentId,
ModeRequest::AnnounceModeRecursive,
)
.unwrap();
self.request_id_counter
.replace(self.request_id_counter.get() + 1);
}
2025-01-16 13:56:49 +01:00
pub fn send_mode_cmd(&self, mode: ModeAndSubmode) {
self.mode_node
.send_mode_request(
self.request_id_counter.get(),
TestComponentId::AcsSubsystem as ComponentId,
ModeRequest::SetMode {
mode_and_submode: mode,
forced: false,
},
)
.unwrap();
self.request_id_counter
.replace(self.request_id_counter.get() + 1);
}
}
2024-11-28 12:36:43 +01:00
impl ModeNode for PusModeService {
2024-11-26 10:25:56 +01:00
fn id(&self) -> ComponentId {
TestComponentId::PusModeService as ComponentId
}
2024-11-28 12:36:43 +01:00
}
impl ModeParent for PusModeService {
type Sender = RequestSenderType;
2024-11-26 10:25:56 +01:00
2024-11-26 18:11:00 +01:00
fn add_mode_child(&mut self, id: ComponentId, request_sender: Self::Sender) {
2024-11-26 10:25:56 +01:00
self.mode_node.add_message_target(id, request_sender);
}
}
struct AcsSubsystem {
2024-12-02 16:37:28 +01:00
pub mode_node: ModeRequestorAndHandlerMpscBounded,
2024-11-21 18:35:16 +01:00
pub mode_requestor_info: Option<MessageMetadata>,
pub target_mode_and_submode: Option<ModeAndSubmode>,
2025-01-16 16:49:35 +01:00
pub subsystem_helper: SubsystemCommandingHelper,
2024-11-26 18:11:00 +01:00
pub mode_req_handler_mock: ModeRequestHandlerMock,
}
2024-11-26 10:25:56 +01:00
impl AcsSubsystem {
2024-12-02 16:37:28 +01:00
pub fn new(mode_node: ModeRequestorAndHandlerMpscBounded) -> Self {
2024-11-28 12:36:43 +01:00
Self {
mode_node,
mode_requestor_info: None,
target_mode_and_submode: None,
2025-01-16 16:49:35 +01:00
subsystem_helper: SubsystemCommandingHelper::default(),
2024-11-28 12:36:43 +01:00
mode_req_handler_mock: Default::default(),
}
}
2024-11-29 13:36:53 +01:00
2025-01-20 10:53:51 +01:00
pub fn get_num_mode_requests(&mut self) -> usize {
self.mode_req_handler_mock.mode_messages_received()
2024-11-29 13:36:53 +01:00
}
2024-11-26 18:11:00 +01:00
pub fn run(&mut self) {
2025-01-20 10:53:51 +01:00
while let Some(request) = self.mode_node.try_recv_mode_request().unwrap() {
2024-11-26 18:11:00 +01:00
self.handle_mode_request(request)
.expect("mode messaging error");
}
2025-01-20 10:53:51 +01:00
let mut received_reply = false;
while let Some(mode_reply) = self.mode_node.try_recv_mode_reply().unwrap() {
received_reply = true;
match self
.subsystem_helper
.state_machine(Some(mode_reply), &self.mode_node)
{
Ok(result) => {
if let SubsystemHelperResult::TargetKeeping(target_keeping_result) = result {
match target_keeping_result {
TargetKeepingResult::Ok => (),
TargetKeepingResult::Violated { fallback_mode } => {
if let Some(fallback_mode) = fallback_mode {
self.subsystem_helper
.start_command_sequence(fallback_mode, 0)
.unwrap();
}
2025-01-16 16:49:35 +01:00
}
}
}
}
2025-01-20 10:53:51 +01:00
Err(error) => match error {
ModeTreeHelperError::Message(_generic_targeted_messaging_error) => {
panic!("messaging error")
2025-01-16 16:49:35 +01:00
}
2025-01-20 10:53:51 +01:00
ModeTreeHelperError::CurrentModeNotInTargetTable(_) => panic!("mode not found"),
},
}
}
if !received_reply {
self.subsystem_helper
.state_machine(None, &self.mode_node)
.expect("subsystem helper error");
2024-11-29 13:36:53 +01:00
}
2024-11-26 18:11:00 +01:00
}
2024-11-26 10:25:56 +01:00
pub fn add_target_and_sequence_table(
&mut self,
mode: Mode,
2024-11-28 12:36:43 +01:00
target_table_val: TargetTablesMapValue,
sequence_table_val: SequenceTablesMapValue,
2024-11-26 10:25:56 +01:00
) {
2024-11-28 12:36:43 +01:00
self.subsystem_helper.add_target_and_sequence_table(
mode,
target_table_val,
sequence_table_val,
);
2024-11-26 10:25:56 +01:00
}
}
2024-11-28 12:36:43 +01:00
impl ModeNode for AcsSubsystem {
2024-11-26 10:25:56 +01:00
fn id(&self) -> ComponentId {
2024-11-28 12:36:43 +01:00
TestComponentId::AcsSubsystem as ComponentId
2024-11-26 10:25:56 +01:00
}
2024-11-28 12:36:43 +01:00
}
impl ModeParent for AcsSubsystem {
type Sender = RequestSenderType;
2024-11-26 10:25:56 +01:00
fn add_mode_child(&mut self, id: ComponentId, request_sender: RequestSenderType) {
2025-01-20 11:51:12 +01:00
self.subsystem_helper.add_mode_child(id, UNKNOWN_MODE);
2024-11-26 10:25:56 +01:00
self.mode_node.add_request_target(id, request_sender);
}
}
impl ModeChild for AcsSubsystem {
type Sender = ReplySenderType;
fn add_mode_parent(&mut self, id: ComponentId, reply_sender: ReplySenderType) {
self.mode_node.add_reply_target(id, reply_sender);
}
}
impl ModeProvider for AcsSubsystem {
fn mode_and_submode(&self) -> ModeAndSubmode {
2025-01-16 16:49:35 +01:00
self.subsystem_helper.current_mode
}
}
2025-01-16 16:49:35 +01:00
#[derive(Debug, thiserror::Error)]
2025-01-17 14:18:16 +01:00
pub enum SubsystemModeError {
#[error("messaging error: {0:?}")]
2025-01-16 16:49:35 +01:00
Mode(#[from] ModeError),
#[error("mode does not exist: {0}")]
ModeDoesNotExist(#[from] ModeDoesNotExistError),
}
2024-11-26 10:25:56 +01:00
impl ModeRequestHandler for AcsSubsystem {
2025-01-17 14:18:16 +01:00
type Error = SubsystemModeError;
fn start_transition(
&mut self,
requestor: MessageMetadata,
mode_and_submode: ModeAndSubmode,
2025-01-16 13:56:49 +01:00
forced: bool,
2024-11-21 18:35:16 +01:00
) -> Result<(), Self::Error> {
2025-01-17 14:18:16 +01:00
if !forced && self.subsystem_helper.state == ModeTreeHelperState::ModeCommanding {
return Err(ModeError::Busy.into());
2025-01-16 16:49:35 +01:00
}
2024-11-21 18:35:16 +01:00
self.mode_requestor_info = Some(requestor);
self.target_mode_and_submode = Some(mode_and_submode);
2024-11-26 18:11:00 +01:00
self.mode_req_handler_mock
2025-01-16 13:56:49 +01:00
.start_transition(requestor, mode_and_submode, forced)
2024-11-26 18:11:00 +01:00
.unwrap();
2025-01-16 13:56:49 +01:00
self.subsystem_helper
2025-01-16 16:49:35 +01:00
.start_command_sequence(mode_and_submode.mode(), requestor.request_id())?;
Ok(())
}
2024-11-21 18:35:16 +01:00
fn announce_mode(&self, requestor_info: Option<MessageMetadata>, recursive: bool) {
println!(
2024-11-21 18:35:16 +01:00
"TestAssembly: Announcing mode (recursively: {}): {:?}",
2025-01-16 16:49:35 +01:00
recursive, self.subsystem_helper.current_mode
);
2024-11-21 18:35:16 +01:00
let mut mode_request = ModeRequest::AnnounceMode;
if recursive {
mode_request = ModeRequest::AnnounceModeRecursive;
}
let request_id = requestor_info.map_or(0, |info| info.request_id());
self.mode_node
2024-12-02 16:37:28 +01:00
.request_sender_store
2024-11-21 18:35:16 +01:00
.0
.iter()
.for_each(|(_, sender)| {
sender
.send(GenericMessage::new(
MessageMetadata::new(request_id, self.mode_node.local_channel_id_generic()),
mode_request,
))
.expect("sending mode request failed");
});
2024-11-26 18:11:00 +01:00
self.mode_req_handler_mock
.announce_mode(requestor_info, recursive);
}
2024-11-21 18:35:16 +01:00
fn handle_mode_reached(
&mut self,
requestor_info: Option<MessageMetadata>,
) -> Result<(), Self::Error> {
if let Some(requestor) = requestor_info {
2025-01-16 16:49:35 +01:00
self.send_mode_reply(
requestor,
ModeReply::ModeReply(self.subsystem_helper.current_mode),
)?;
}
2024-11-26 18:11:00 +01:00
self.mode_req_handler_mock
.handle_mode_reached(requestor_info)
.unwrap();
Ok(())
}
fn handle_mode_info(
&mut self,
requestor_info: MessageMetadata,
info: ModeAndSubmode,
2024-11-21 18:35:16 +01:00
) -> Result<(), Self::Error> {
2024-11-26 18:11:00 +01:00
self.mode_req_handler_mock
.handle_mode_info(requestor_info, info)
.unwrap();
2024-11-21 18:35:16 +01:00
// TODO: Need to check whether mode table execution is finished.
// This works by checking the children modes received through replies against the
// mode table after all transition tables were executed.
Ok(())
}
fn send_mode_reply(
&self,
requestor_info: MessageMetadata,
reply: ModeReply,
) -> Result<(), Self::Error> {
2024-11-26 18:11:00 +01:00
self.mode_req_handler_mock
.send_mode_reply(requestor_info, reply)
.unwrap();
2025-01-16 16:49:35 +01:00
self.mode_node
.send_mode_reply(requestor_info, reply)
.map_err(ModeError::Messaging)?;
Ok(())
}
}
2025-01-17 14:18:16 +01:00
#[derive(Debug, Default)]
2025-01-20 11:51:12 +01:00
pub struct DevManagerCommandingHelper {
2025-01-17 14:18:16 +01:00
/// The IDs, modes and reply awaition status of all children are tracked in this data
/// structure.
pub children_mode_store: ModeStoreVec,
/// Target mode used for mode commanding.
pub target_mode: Option<ModeAndSubmode>,
2025-01-17 14:39:28 +01:00
/// Request ID of active mode commanding request.
pub active_request_id: Option<RequestId>,
2025-01-17 14:18:16 +01:00
pub state: ModeTreeHelperState,
}
2025-01-20 11:51:12 +01:00
impl DevManagerCommandingHelper {
2025-01-17 14:18:16 +01:00
pub fn send_mode_cmd_to_all_children_with_reply_awaition(
&mut self,
request_id: RequestId,
mode_and_submode: ModeAndSubmode,
forced: bool,
mode_req_sender: &impl ModeRequestSender,
) -> Result<(), GenericTargetedMessagingError> {
self.target_mode = Some(mode_and_submode);
for child in self.children_mode_store.0.iter_mut() {
mode_req_sender.send_mode_request(
request_id,
child.id(),
ModeRequest::SetMode {
mode_and_submode,
forced,
},
)?;
child.awaiting_reply = true;
}
2025-01-17 14:39:28 +01:00
self.active_request_id = Some(request_id);
2025-01-20 10:53:51 +01:00
self.state = ModeTreeHelperState::ModeCommanding;
2025-01-17 14:18:16 +01:00
Ok(())
}
2025-01-20 11:51:12 +01:00
pub fn add_mode_child(&mut self, target_id: ComponentId, mode: ModeAndSubmode) {
self.children_mode_store.add_component(target_id, mode);
}
2025-01-17 14:18:16 +01:00
pub fn count_number_of_children_with_target_mode(&self) -> Option<usize> {
self.target_mode?;
let target_mode = self.target_mode.unwrap();
let mut children_in_target_mode = 0;
for child in self.children_mode_store.0.iter() {
if child.mode_and_submode() == target_mode {
children_in_target_mode += 1;
}
}
Some(children_in_target_mode)
}
pub fn handle_mode_reply(
&mut self,
mode_reply: &GenericMessage<ModeReply>,
) -> AssemblyHelperResult {
if !self
.children_mode_store
.has_component(mode_reply.sender_id())
{
return AssemblyHelperResult::Idle;
}
let mut generic_mode_reply_handler = |mode_and_submode: Option<ModeAndSubmode>| {
2025-01-17 14:39:28 +01:00
// Tying the reply awaition to the request ID ensures that something like replies
// belonging to older requests do not interfere with the completion handling of
// the mode commanding. This is important for forced mode commands.
let mut handle_awaition = false;
if self.state == ModeTreeHelperState::ModeCommanding
&& self.active_request_id.is_some()
&& mode_reply.request_id() == self.active_request_id.unwrap()
{
handle_awaition = true;
}
let still_awating_replies = self.children_mode_store.generic_reply_handler(
mode_reply.sender_id(),
mode_and_submode,
handle_awaition,
);
2025-01-17 14:18:16 +01:00
if self.state == ModeTreeHelperState::TargetKeeping
&& mode_and_submode.is_some()
&& self.target_mode.is_some()
&& mode_and_submode.unwrap() != self.target_mode.unwrap()
{
return AssemblyHelperResult::TargetKeepingViolation(mode_reply.sender_id());
}
2025-01-17 14:39:28 +01:00
if self.state == ModeTreeHelperState::ModeCommanding
&& handle_awaition
&& !still_awating_replies
{
2025-01-17 14:18:16 +01:00
self.state = ModeTreeHelperState::TargetKeeping;
2025-01-17 14:39:28 +01:00
self.active_request_id = None;
2025-01-17 14:18:16 +01:00
return AssemblyHelperResult::ModeCommandingDone;
}
AssemblyHelperResult::Idle
};
match mode_reply.message {
ModeReply::ModeInfo(mode_and_submode) | ModeReply::ModeReply(mode_and_submode) => {
generic_mode_reply_handler(Some(mode_and_submode))
}
ModeReply::CantReachMode(_result_u16) => generic_mode_reply_handler(None),
ModeReply::WrongMode {
expected: _,
reached,
} => generic_mode_reply_handler(Some(reached)),
}
}
}
2025-01-16 16:49:35 +01:00
// TODO: This assembly requires some helper component to process commands.. Maybe implement it
// manually first?
2024-11-26 10:25:56 +01:00
struct MgmAssembly {
2024-12-02 16:37:28 +01:00
pub mode_node: ModeRequestorAndHandlerMpscBounded,
pub mode_requestor_info: Option<MessageMetadata>,
pub mode_and_submode: ModeAndSubmode,
2025-01-20 11:51:12 +01:00
pub commanding_helper: DevManagerCommandingHelper,
2024-11-26 18:11:00 +01:00
pub mode_req_mock: ModeRequestHandlerMock,
2025-01-16 16:49:35 +01:00
pub mode_reply_mock: ModeReplyHandlerMock,
}
2024-11-26 10:25:56 +01:00
impl MgmAssembly {
2024-12-02 16:37:28 +01:00
pub fn new(mode_node: ModeRequestorAndHandlerMpscBounded) -> Self {
2024-11-29 13:36:53 +01:00
Self {
mode_node,
mode_requestor_info: None,
mode_and_submode: UNKNOWN_MODE,
2025-01-20 11:51:12 +01:00
commanding_helper: Default::default(),
2024-11-29 13:36:53 +01:00
mode_req_mock: Default::default(),
2025-01-16 16:49:35 +01:00
mode_reply_mock: Default::default(),
2024-11-29 13:36:53 +01:00
}
}
pub fn run(&mut self) {
self.check_mode_requests().expect("mode messaging error");
self.check_mode_replies().expect("mode messaging error");
}
2025-01-17 14:39:28 +01:00
2025-01-16 16:49:35 +01:00
pub fn get_num_mode_requests(&mut self) -> usize {
self.mode_req_mock.mode_messages_received()
2024-11-26 18:11:00 +01:00
}
pub fn check_mode_requests(&mut self) -> Result<(), GenericTargetedMessagingError> {
2025-01-20 10:53:51 +01:00
while let Some(request) = self.mode_node.try_recv_mode_request()? {
2024-11-26 18:11:00 +01:00
self.handle_mode_request(request).unwrap();
}
Ok(())
}
2025-01-17 14:18:16 +01:00
pub fn check_mode_replies(&mut self) -> Result<(), ModeError> {
2025-01-20 10:53:51 +01:00
while let Some(reply_and_id) = self.mode_node.try_recv_mode_reply()? {
2025-01-16 16:49:35 +01:00
self.mode_reply_mock.handle_mode_reply(&reply_and_id);
2025-01-20 11:51:12 +01:00
match self.commanding_helper.handle_mode_reply(&reply_and_id) {
2025-01-17 14:18:16 +01:00
AssemblyHelperResult::Idle => (),
AssemblyHelperResult::TargetKeepingViolation(_id) => {
// TODO: Check whether enough children are available to keep the mode.
// Otherwise, we command everything OFF, because we can not keep the mode.
}
2025-01-17 14:18:16 +01:00
AssemblyHelperResult::ModeCommandingDone => {
2025-01-20 11:51:12 +01:00
if self.commanding_helper.target_mode.is_some() {
2025-01-17 14:18:16 +01:00
// Complete the mode command.
self.handle_mode_reached(self.mode_requestor_info)?;
2025-01-20 11:51:12 +01:00
self.mode_and_submode = self.commanding_helper.target_mode.take().unwrap();
2025-01-17 14:18:16 +01:00
}
}
}
}
Ok(())
}
}
2024-11-28 12:36:43 +01:00
impl ModeNode for MgmAssembly {
2024-11-26 10:25:56 +01:00
fn id(&self) -> ComponentId {
2024-11-29 13:36:53 +01:00
TestComponentId::MagnetometerAssembly as u64
2024-11-26 10:25:56 +01:00
}
2024-11-28 12:36:43 +01:00
}
impl ModeParent for MgmAssembly {
type Sender = RequestSenderType;
2024-11-26 10:25:56 +01:00
fn add_mode_child(&mut self, id: ComponentId, request_sender: RequestSenderType) {
self.mode_node.add_request_target(id, request_sender);
2025-01-20 11:51:12 +01:00
self.commanding_helper.add_mode_child(id, UNKNOWN_MODE);
2024-11-26 10:25:56 +01:00
}
}
impl ModeChild for MgmAssembly {
type Sender = ReplySenderType;
fn add_mode_parent(&mut self, id: ComponentId, reply_sender: ReplySenderType) {
self.mode_node.add_reply_target(id, reply_sender);
}
}
impl ModeProvider for MgmAssembly {
fn mode_and_submode(&self) -> ModeAndSubmode {
self.mode_and_submode
}
}
impl ModeRequestHandler for MgmAssembly {
type Error = ModeError;
fn start_transition(
&mut self,
requestor: MessageMetadata,
mode_and_submode: ModeAndSubmode,
2025-01-16 13:56:49 +01:00
forced: bool,
) -> Result<(), Self::Error> {
2025-01-17 14:18:16 +01:00
// Always accept forced commands and commands to mode OFF.
2025-01-20 11:51:12 +01:00
if self.commanding_helper.target_mode.is_some()
2025-01-17 14:18:16 +01:00
&& !forced
&& mode_and_submode.mode() != DefaultMode::OFF as u32
{
return Err(ModeError::Busy);
}
self.mode_requestor_info = Some(requestor);
2024-11-26 18:11:00 +01:00
self.mode_req_mock
2025-01-16 13:56:49 +01:00
.start_transition(requestor, mode_and_submode, forced)
2024-11-26 18:11:00 +01:00
.unwrap();
2025-01-20 11:51:12 +01:00
self.commanding_helper
2025-01-17 14:18:16 +01:00
.send_mode_cmd_to_all_children_with_reply_awaition(
requestor.request_id(),
mode_and_submode,
forced,
&self.mode_node,
)?;
Ok(())
}
fn announce_mode(&self, requestor_info: Option<MessageMetadata>, recursive: bool) {
println!(
"TestAssembly: Announcing mode (recursively: {}): {:?}",
recursive, self.mode_and_submode
);
let mut mode_request = ModeRequest::AnnounceMode;
if recursive {
mode_request = ModeRequest::AnnounceModeRecursive;
}
let request_id = requestor_info.map_or(0, |info| info.request_id());
self.mode_node
2024-12-02 16:37:28 +01:00
.request_sender_store
.0
.iter()
.for_each(|(_, sender)| {
sender
.send(GenericMessage::new(
MessageMetadata::new(request_id, self.mode_node.local_channel_id_generic()),
mode_request,
))
.expect("sending mode request failed");
});
2024-11-26 18:11:00 +01:00
self.mode_req_mock.announce_mode(requestor_info, recursive);
}
fn handle_mode_reached(
&mut self,
mode_requestor: Option<MessageMetadata>,
) -> Result<(), Self::Error> {
if let Some(requestor) = mode_requestor {
self.send_mode_reply(requestor, ModeReply::ModeReply(self.mode_and_submode))?;
}
2024-11-26 18:11:00 +01:00
self.mode_req_mock
.handle_mode_reached(mode_requestor)
.unwrap();
Ok(())
}
fn handle_mode_info(
&mut self,
2024-11-26 18:11:00 +01:00
requestor_info: MessageMetadata,
info: ModeAndSubmode,
) -> Result<(), Self::Error> {
2024-11-26 18:11:00 +01:00
self.mode_req_mock
.handle_mode_info(requestor_info, info)
.unwrap();
// TODO: A proper assembly must reach to mode changes of its children..
Ok(())
}
2024-11-29 13:36:53 +01:00
fn send_mode_reply(
&self,
requestor: MessageMetadata,
reply: ModeReply,
) -> Result<(), Self::Error> {
self.mode_node.send_mode_reply(requestor, reply)?;
self.mode_req_mock
.send_mode_reply(requestor, reply)
.unwrap();
Ok(())
}
}
2024-11-28 12:36:43 +01:00
struct DeviceManager {
name: &'static str,
pub id: ComponentId,
2025-01-20 11:51:12 +01:00
pub commanding_helper: DevManagerCommandingHelper,
2024-12-02 16:37:28 +01:00
pub mode_node: ModeRequestorAndHandlerMpscBounded,
2025-01-20 11:51:12 +01:00
pub mode_requestor_info: Option<MessageMetadata>,
2024-11-28 12:36:43 +01:00
pub mode_and_submode: ModeAndSubmode,
pub mode_req_mock: ModeRequestHandlerMock,
2025-01-20 11:51:12 +01:00
pub mode_reply_mock: ModeReplyHandlerMock,
2024-11-28 12:36:43 +01:00
}
impl DeviceManager {
pub fn new(
name: &'static str,
id: ComponentId,
2024-12-02 16:37:28 +01:00
mode_node: ModeRequestorAndHandlerMpscBounded,
2024-11-28 12:36:43 +01:00
) -> Self {
Self {
name,
id,
mode_node,
2025-01-20 11:51:12 +01:00
mode_requestor_info: None,
commanding_helper: Default::default(),
2024-11-28 12:36:43 +01:00
mode_and_submode: UNKNOWN_MODE,
mode_req_mock: Default::default(),
2025-01-20 11:51:12 +01:00
mode_reply_mock: Default::default(),
2024-11-29 13:36:53 +01:00
}
}
2025-01-20 11:51:12 +01:00
pub fn get_num_mode_requests(&mut self) -> usize {
self.mode_req_mock.mode_messages_received()
2024-11-29 13:36:53 +01:00
}
pub fn run(&mut self) {
self.check_mode_requests().expect("mode messaging error");
2025-01-20 11:51:12 +01:00
self.check_mode_replies().expect("mode reply error");
2024-11-29 13:36:53 +01:00
}
pub fn check_mode_requests(&mut self) -> Result<(), ModeError> {
2025-01-20 11:51:12 +01:00
while let Some(request) = self.mode_node.try_recv_mode_request()? {
2024-11-29 13:36:53 +01:00
self.handle_mode_request(request)?
2024-11-28 12:36:43 +01:00
}
2024-11-29 13:36:53 +01:00
Ok(())
2024-11-28 12:36:43 +01:00
}
2025-01-20 11:51:12 +01:00
pub fn check_mode_replies(&mut self) -> Result<(), ModeError> {
while let Some(reply) = self.mode_node.try_recv_mode_reply()? {
self.handle_mode_reply(&reply)?;
}
Ok(())
}
pub fn handle_mode_reply(
&mut self,
mode_reply: &GenericMessage<ModeReply>,
) -> Result<(), ModeError> {
self.mode_reply_mock.handle_mode_reply(mode_reply);
match self.commanding_helper.handle_mode_reply(mode_reply) {
AssemblyHelperResult::Idle => (),
AssemblyHelperResult::TargetKeepingViolation(_id) => {
// TODO: Check whether enough children are available to keep the mode.
// Otherwise, we command everything OFF, because we can not keep the mode.
}
AssemblyHelperResult::ModeCommandingDone => {
if self.commanding_helper.target_mode.is_some() {
// Complete the mode command.
self.handle_mode_reached(self.mode_requestor_info)?;
self.mode_and_submode = self.commanding_helper.target_mode.take().unwrap();
}
}
}
Ok(())
}
2024-11-28 12:36:43 +01:00
}
impl ModeNode for DeviceManager {
fn id(&self) -> ComponentId {
self.id
}
}
impl ModeChild for DeviceManager {
type Sender = ReplySenderType;
fn add_mode_parent(&mut self, id: ComponentId, reply_sender: ReplySenderType) {
self.mode_node.add_reply_target(id, reply_sender);
}
}
impl ModeParent for DeviceManager {
type Sender = RequestSenderType;
fn add_mode_child(&mut self, id: ComponentId, request_sender: Self::Sender) {
2025-01-20 11:51:12 +01:00
self.commanding_helper
.children_mode_store
.add_component(id, UNKNOWN_MODE);
2024-11-28 12:36:43 +01:00
self.mode_node.add_request_target(id, request_sender);
}
}
impl ModeProvider for DeviceManager {
fn mode_and_submode(&self) -> ModeAndSubmode {
self.mode_and_submode
}
}
impl ModeRequestHandler for DeviceManager {
type Error = ModeError;
fn start_transition(
&mut self,
requestor: MessageMetadata,
mode_and_submode: ModeAndSubmode,
2025-01-16 13:56:49 +01:00
forced: bool,
2024-11-28 12:36:43 +01:00
) -> Result<(), ModeError> {
self.mode_and_submode = mode_and_submode;
2025-01-20 11:51:12 +01:00
self.mode_requestor_info = Some(requestor);
2024-11-28 12:36:43 +01:00
self.mode_req_mock
2025-01-16 13:56:49 +01:00
.start_transition(requestor, mode_and_submode, forced)
2024-11-28 12:36:43 +01:00
.unwrap();
2025-01-20 11:51:12 +01:00
self.commanding_helper
.send_mode_cmd_to_all_children_with_reply_awaition(
requestor.request_id(),
mode_and_submode,
forced,
&self.mode_node,
)?;
2024-11-28 12:36:43 +01:00
Ok(())
}
fn announce_mode(&self, requestor_info: Option<MessageMetadata>, recursive: bool) {
println!(
"{}: announcing mode: {:?}",
self.name, self.mode_and_submode
);
2024-11-29 13:36:53 +01:00
let mut mode_request = ModeRequest::AnnounceMode;
if recursive {
mode_request = ModeRequest::AnnounceModeRecursive;
}
let request_id = requestor_info.map_or(0, |info| info.request_id());
self.mode_node
2024-12-02 16:37:28 +01:00
.request_sender_store
2024-11-29 13:36:53 +01:00
.0
.iter()
.for_each(|(_, sender)| {
sender
.send(GenericMessage::new(
MessageMetadata::new(request_id, self.mode_node.local_channel_id_generic()),
mode_request,
))
.expect("sending mode request failed");
});
2024-11-28 12:36:43 +01:00
self.mode_req_mock.announce_mode(requestor_info, recursive);
}
fn handle_mode_reached(&mut self, requestor: Option<MessageMetadata>) -> Result<(), ModeError> {
if let Some(requestor) = requestor {
self.send_mode_reply(requestor, ModeReply::ModeReply(self.mode_and_submode))?;
}
self.mode_req_mock.handle_mode_reached(requestor).unwrap();
Ok(())
}
fn handle_mode_info(
&mut self,
requestor_info: MessageMetadata,
info: ModeAndSubmode,
) -> Result<(), ModeError> {
// A device is a leaf in the tree.. so this really should not happen
println!(
"{}: unexpected mode info from {:?} with mode: {:?}",
self.name,
requestor_info.sender_id(),
info
);
self.mode_req_mock
.handle_mode_info(requestor_info, info)
.unwrap();
Ok(())
}
2024-11-29 13:36:53 +01:00
fn send_mode_reply(
&self,
requestor_info: MessageMetadata,
reply: ModeReply,
) -> Result<(), ModeError> {
self.mode_node.send_mode_reply(requestor_info, reply)?;
self.mode_req_mock
.send_mode_reply(requestor_info, reply)
.unwrap();
Ok(())
}
2024-11-28 12:36:43 +01:00
}
2024-11-26 10:25:56 +01:00
struct CommonDevice {
2024-11-28 12:36:43 +01:00
name: &'static str,
2024-11-26 10:25:56 +01:00
pub id: ComponentId,
2024-12-02 16:37:28 +01:00
pub mode_node: ModeRequestHandlerMpscBounded,
2024-11-21 18:35:16 +01:00
pub mode_and_submode: ModeAndSubmode,
2024-11-26 18:11:00 +01:00
pub mode_req_mock: ModeRequestHandlerMock,
2024-11-21 18:35:16 +01:00
}
2024-11-26 10:25:56 +01:00
impl CommonDevice {
2024-11-28 12:36:43 +01:00
pub fn new(
name: &'static str,
id: ComponentId,
2024-12-02 16:37:28 +01:00
mode_node: ModeRequestHandlerMpscBounded,
2024-11-28 12:36:43 +01:00
) -> Self {
2024-11-26 10:25:56 +01:00
Self {
name,
id,
mode_node,
2024-11-28 12:36:43 +01:00
mode_and_submode: UNKNOWN_MODE,
2024-11-26 18:11:00 +01:00
mode_req_mock: Default::default(),
2024-11-26 10:25:56 +01:00
}
}
2024-11-21 18:35:16 +01:00
pub fn run(&mut self) {
self.check_mode_requests().expect("mode messaging error");
}
pub fn check_mode_requests(&mut self) -> Result<(), ModeError> {
if let Some(request) = self.mode_node.try_recv_mode_request()? {
self.handle_mode_request(request)?
}
Ok(())
}
2024-11-29 13:36:53 +01:00
2025-01-20 10:53:51 +01:00
pub fn get_and_clear_num_mode_msgs(&mut self) -> usize {
self.mode_req_mock.mode_messages_received()
2024-11-29 13:36:53 +01:00
}
2024-11-21 18:35:16 +01:00
}
2024-11-28 12:36:43 +01:00
impl ModeNode for CommonDevice {
2024-11-26 10:25:56 +01:00
fn id(&self) -> ComponentId {
self.id
}
2024-11-28 12:36:43 +01:00
}
impl ModeChild for CommonDevice {
type Sender = ReplySenderType;
2024-11-26 10:25:56 +01:00
fn add_mode_parent(&mut self, id: ComponentId, reply_sender: ReplySenderType) {
self.mode_node.add_message_target(id, reply_sender);
}
}
impl ModeProvider for CommonDevice {
2024-11-21 18:35:16 +01:00
fn mode_and_submode(&self) -> ModeAndSubmode {
self.mode_and_submode
}
}
2024-11-26 10:25:56 +01:00
impl ModeRequestHandler for CommonDevice {
2024-11-21 18:35:16 +01:00
type Error = ModeError;
fn start_transition(
&mut self,
requestor: MessageMetadata,
mode_and_submode: ModeAndSubmode,
2025-01-16 13:56:49 +01:00
forced: bool,
2024-11-21 18:35:16 +01:00
) -> Result<(), ModeError> {
self.mode_and_submode = mode_and_submode;
self.handle_mode_reached(Some(requestor))?;
2024-11-26 18:11:00 +01:00
self.mode_req_mock
2025-01-16 13:56:49 +01:00
.start_transition(requestor, mode_and_submode, forced)
2024-11-26 18:11:00 +01:00
.unwrap();
2024-11-21 18:35:16 +01:00
Ok(())
}
2024-11-26 18:11:00 +01:00
fn announce_mode(&self, requestor_info: Option<MessageMetadata>, recursive: bool) {
2024-11-21 18:35:16 +01:00
println!(
"{}: announcing mode: {:?}",
self.name, self.mode_and_submode
);
2024-11-26 18:11:00 +01:00
self.mode_req_mock.announce_mode(requestor_info, recursive);
2024-11-21 18:35:16 +01:00
}
fn handle_mode_reached(&mut self, requestor: Option<MessageMetadata>) -> Result<(), ModeError> {
if let Some(requestor) = requestor {
self.send_mode_reply(requestor, ModeReply::ModeReply(self.mode_and_submode))?;
}
2024-11-26 18:11:00 +01:00
self.mode_req_mock.handle_mode_reached(requestor).unwrap();
2024-11-21 18:35:16 +01:00
Ok(())
}
2025-01-16 16:49:35 +01:00
2024-11-21 18:35:16 +01:00
fn handle_mode_info(
&mut self,
requestor_info: MessageMetadata,
info: ModeAndSubmode,
) -> Result<(), ModeError> {
// A device is a leaf in the tree.. so this really should not happen
println!(
"{}: unexpected mode info from {:?} with mode: {:?}",
self.name,
requestor_info.sender_id(),
info
);
2024-11-26 18:11:00 +01:00
self.mode_req_mock
.handle_mode_info(requestor_info, info)
.unwrap();
2024-11-21 18:35:16 +01:00
Ok(())
}
2024-11-29 13:36:53 +01:00
fn send_mode_reply(
&self,
requestor_info: MessageMetadata,
reply: ModeReply,
) -> Result<(), ModeError> {
self.mode_node.send_mode_reply(requestor_info, reply)?;
self.mode_req_mock
.send_mode_reply(requestor_info, reply)
.unwrap();
Ok(())
}
2024-11-21 18:35:16 +01:00
}
2024-11-26 18:11:00 +01:00
#[derive(Debug, Default)]
pub struct AnnounceModeInfo {
pub requestor: Option<MessageMetadata>,
pub recursive: bool,
}
2024-11-26 10:25:56 +01:00
pub struct AcsController {
2024-12-02 16:37:28 +01:00
pub mode_node: ModeRequestHandlerMpscBounded,
2024-11-26 10:25:56 +01:00
pub mode_and_submode: ModeAndSubmode,
2024-11-26 18:11:00 +01:00
pub announce_mode_queue: RefCell<VecDeque<AnnounceModeInfo>>,
pub mode_req_mock: ModeRequestHandlerMock,
2024-11-26 10:25:56 +01:00
}
impl AcsController {
2025-01-16 16:49:35 +01:00
pub fn new(mode_node: ModeRequestHandlerMpscBounded) -> Self {
Self {
mode_node,
mode_and_submode: UNKNOWN_MODE,
announce_mode_queue: Default::default(),
mode_req_mock: Default::default(),
}
}
2024-11-26 10:25:56 +01:00
pub fn run(&mut self) {
self.check_mode_requests().expect("mode messaging error");
}
pub fn check_mode_requests(&mut self) -> Result<(), ModeError> {
if let Some(request) = self.mode_node.try_recv_mode_request()? {
self.handle_mode_request(request)?
}
Ok(())
}
}
2024-11-28 12:36:43 +01:00
impl ModeNode for AcsController {
2024-11-26 10:25:56 +01:00
fn id(&self) -> ComponentId {
TestComponentId::AcsController as u64
}
2024-11-28 12:36:43 +01:00
}
impl ModeChild for AcsController {
type Sender = ReplySenderType;
2024-11-26 10:25:56 +01:00
fn add_mode_parent(&mut self, id: ComponentId, reply_sender: ReplySenderType) {
self.mode_node.add_message_target(id, reply_sender);
}
}
impl ModeProvider for AcsController {
fn mode_and_submode(&self) -> ModeAndSubmode {
self.mode_and_submode
}
}
impl ModeRequestHandler for AcsController {
type Error = ModeError;
fn start_transition(
&mut self,
requestor: MessageMetadata,
mode_and_submode: ModeAndSubmode,
2025-01-16 13:56:49 +01:00
forced: bool,
2024-11-26 10:25:56 +01:00
) -> Result<(), Self::Error> {
self.mode_and_submode = mode_and_submode;
self.handle_mode_reached(Some(requestor))?;
2024-11-26 18:11:00 +01:00
self.mode_req_mock
2025-01-16 13:56:49 +01:00
.start_transition(requestor, mode_and_submode, forced)
2024-11-26 18:11:00 +01:00
.unwrap();
2024-11-26 10:25:56 +01:00
Ok(())
}
fn announce_mode(&self, requestor_info: Option<MessageMetadata>, recursive: bool) {
2024-11-26 18:11:00 +01:00
self.announce_mode_queue
.borrow_mut()
.push_back(AnnounceModeInfo {
requestor: requestor_info,
recursive,
});
self.mode_req_mock.announce_mode(requestor_info, recursive);
2024-11-26 10:25:56 +01:00
}
fn handle_mode_reached(
&mut self,
requestor_info: Option<MessageMetadata>,
) -> Result<(), Self::Error> {
if let Some(requestor) = requestor_info {
self.send_mode_reply(requestor, ModeReply::ModeReply(self.mode_and_submode))?;
}
2024-11-26 18:11:00 +01:00
self.mode_req_mock
.handle_mode_reached(requestor_info)
.unwrap();
2024-11-26 10:25:56 +01:00
Ok(())
}
fn handle_mode_info(
&mut self,
requestor_info: MessageMetadata,
info: ModeAndSubmode,
) -> Result<(), Self::Error> {
// The controller is a leaf in the tree.. so this really should not happen
println!(
"ACS Controller: unexpected mode info from {:?} with mode: {:?}",
requestor_info.sender_id(),
info
);
2024-11-26 18:11:00 +01:00
self.mode_req_mock
.handle_mode_info(requestor_info, info)
.unwrap();
2024-11-26 10:25:56 +01:00
Ok(())
}
fn send_mode_reply(
&self,
requestor_info: MessageMetadata,
reply: ModeReply,
) -> Result<(), Self::Error> {
self.mode_node.send_mode_reply(requestor_info, reply)?;
2024-11-26 18:11:00 +01:00
self.mode_req_mock
.send_mode_reply(requestor_info, reply)
.unwrap();
2024-11-26 10:25:56 +01:00
Ok(())
}
}
2024-11-26 18:11:00 +01:00
pub struct TreeTestbench {
pus: PusModeService,
subsystem: AcsSubsystem,
ctrl: AcsController,
2024-11-28 12:36:43 +01:00
mgt_manager: DeviceManager,
2024-11-26 18:11:00 +01:00
mgm_assy: MgmAssembly,
2024-11-28 12:36:43 +01:00
mgm_devs: [CommonDevice; 2],
2024-11-26 18:11:00 +01:00
mgt_dev: CommonDevice,
}
impl Default for TreeTestbench {
fn default() -> Self {
Self::new()
}
}
impl TreeTestbench {
pub fn new() -> Self {
// All request channel handles.
2024-11-28 12:36:43 +01:00
let (request_sender_to_mgm_dev_0, request_receiver_mgm_dev_0) = mpsc::sync_channel(10);
let (request_sender_to_mgm_dev_1, request_receiver_mgm_dev_1) = mpsc::sync_channel(10);
2024-11-26 18:11:00 +01:00
let (request_sender_to_mgt_dev, request_receiver_mgt_dev) = mpsc::sync_channel(10);
2024-11-28 12:36:43 +01:00
let (request_sender_to_mgt_man, request_receiver_mgt_man) = mpsc::sync_channel(10);
2024-11-26 18:11:00 +01:00
let (request_sender_to_mgm_assy, request_receiver_mgm_assy) = mpsc::sync_channel(10);
let (request_sender_to_acs_subsystem, request_receiver_acs_subsystem) =
mpsc::sync_channel(10);
let (request_sender_to_acs_ctrl, request_receiver_acs_ctrl) = mpsc::sync_channel(10);
// All reply channel handles.
let (reply_sender_to_mgm_assy, reply_receiver_mgm_assy) = mpsc::sync_channel(10);
let (reply_sender_to_acs_subsystem, reply_receiver_acs_subsystem) = mpsc::sync_channel(10);
let (reply_sender_to_pus, reply_receiver_pus) = mpsc::sync_channel(10);
2024-11-28 12:36:43 +01:00
let (reply_sender_to_mgt_man, reply_receiver_mgt_man) = mpsc::sync_channel(10);
// Mode requestors only.
2024-11-29 13:36:53 +01:00
let mode_node_pus = ModeRequestorOneChildBoundedMpsc::new(
2024-11-28 12:36:43 +01:00
TestComponentId::PusModeService as ComponentId,
reply_receiver_pus,
);
2024-11-26 18:11:00 +01:00
// Mode requestors and handlers.
2024-12-02 16:37:28 +01:00
let mgm_assy_node = ModeRequestorAndHandlerMpscBounded::new(
2024-11-26 18:11:00 +01:00
TestComponentId::MagnetometerAssembly as ComponentId,
request_receiver_mgm_assy,
reply_receiver_mgm_assy,
);
2024-12-02 16:37:28 +01:00
let mgt_dev_mgmt_node = ModeRequestorAndHandlerMpscBounded::new(
2024-11-28 12:36:43 +01:00
TestComponentId::MgtDevManager as ComponentId,
request_receiver_mgt_man,
reply_receiver_mgt_man,
);
2024-12-02 16:37:28 +01:00
let acs_subsystem_node = ModeRequestorAndHandlerMpscBounded::new(
2024-11-26 18:11:00 +01:00
TestComponentId::AcsSubsystem as ComponentId,
request_receiver_acs_subsystem,
reply_receiver_acs_subsystem,
);
// Request handlers only.
2024-12-02 16:37:28 +01:00
let mgm_dev_node_0 = ModeRequestHandlerMpscBounded::new(
2024-11-28 12:36:43 +01:00
TestComponentId::MagnetometerDevice0 as ComponentId,
request_receiver_mgm_dev_0,
);
2024-12-02 16:37:28 +01:00
let mgm_dev_node_1 = ModeRequestHandlerMpscBounded::new(
2024-11-28 12:36:43 +01:00
TestComponentId::MagnetometerDevice1 as ComponentId,
request_receiver_mgm_dev_1,
2024-11-26 18:11:00 +01:00
);
2024-12-02 16:37:28 +01:00
let mgt_dev_node = ModeRequestHandlerMpscBounded::new(
2024-11-26 18:11:00 +01:00
TestComponentId::MagnetorquerDevice as ComponentId,
request_receiver_mgt_dev,
);
2024-12-02 16:37:28 +01:00
let acs_ctrl_node = ModeRequestHandlerMpscBounded::new(
2024-11-26 18:11:00 +01:00
TestComponentId::AcsController as ComponentId,
request_receiver_acs_ctrl,
);
2024-11-28 12:36:43 +01:00
let mut mgm_dev_0 = CommonDevice::new(
"MGM_0",
TestComponentId::MagnetometerDevice0 as u64,
mgm_dev_node_0,
2024-11-26 18:11:00 +01:00
);
2024-11-28 12:36:43 +01:00
let mut mgm_dev_1 = CommonDevice::new(
"MGM_1",
2024-11-29 13:36:53 +01:00
TestComponentId::MagnetometerDevice1 as u64,
2024-11-28 12:36:43 +01:00
mgm_dev_node_1,
2024-11-26 18:11:00 +01:00
);
let mut mgt_dev = CommonDevice::new(
2024-11-28 12:36:43 +01:00
"MGT",
2024-11-26 18:11:00 +01:00
TestComponentId::MagnetorquerDevice as u64,
mgt_dev_node,
);
2024-11-28 12:36:43 +01:00
let mut mgt_manager = DeviceManager::new(
"MGT_MANAGER",
TestComponentId::MgtDevManager as u64,
mgt_dev_mgmt_node,
);
2024-11-29 13:36:53 +01:00
let mut mgm_assy = MgmAssembly::new(mgm_assy_node);
2024-11-28 12:36:43 +01:00
let mut acs_subsystem = AcsSubsystem::new(acs_subsystem_node);
2025-01-16 16:49:35 +01:00
let mut acs_ctrl = AcsController::new(acs_ctrl_node);
2024-11-26 18:11:00 +01:00
let mut pus_service = PusModeService {
request_id_counter: Cell::new(0),
mode_node: mode_node_pus,
};
2024-11-28 12:36:43 +01:00
// ACS subsystem tables
2024-12-09 17:28:28 +01:00
let mut target_table_safe = TargetTablesMapValue::new("SAFE_TARGET_TBL", None);
2024-11-28 12:36:43 +01:00
target_table_safe.add_entry(TargetTableEntry::new(
"CTRL_SAFE",
TestComponentId::AcsController as u64,
ModeAndSubmode::new(AcsMode::SAFE as u32, 0),
// All submodes allowed.
Some(0xffff),
));
target_table_safe.add_entry(TargetTableEntry::new_with_precise_submode(
"MGM_A_NML",
TestComponentId::MagnetometerAssembly as u64,
ModeAndSubmode::new(DefaultMode::NORMAL as u32, 0),
));
2024-12-02 16:37:28 +01:00
target_table_safe.add_entry(TargetTableEntry::new_with_precise_submode(
"MGT_MAN_NML",
TestComponentId::MgtDevManager as u64,
ModeAndSubmode::new(DefaultMode::NORMAL as u32, 0),
));
let mut sequence_tbl_safe_0 = SequenceTableMapTable::new("SAFE_SEQ_0_TBL");
sequence_tbl_safe_0.add_entry(SequenceTableEntry::new(
"SAFE_SEQ_0_MGM_A",
TestComponentId::MagnetometerAssembly as u64,
ModeAndSubmode::new(DefaultMode::NORMAL as Mode, 0),
false,
));
sequence_tbl_safe_0.add_entry(SequenceTableEntry::new(
"SAFE_SEQ_0_MGT_MAN",
TestComponentId::MgtDevManager as u64,
ModeAndSubmode::new(DefaultMode::NORMAL as Mode, 0),
false,
));
let mut sequence_tbl_safe_1 = SequenceTableMapTable::new("SAFE_SEQ_1_TBL");
sequence_tbl_safe_1.add_entry(SequenceTableEntry::new(
"SAFE_SEQ_1_ACS_CTRL",
TestComponentId::AcsController as u64,
2025-01-16 16:49:35 +01:00
ModeAndSubmode::new(AcsMode::SAFE as Mode, 0),
2024-12-02 16:37:28 +01:00
false,
));
let mut sequence_tbl_safe = SequenceTablesMapValue::new("SAFE_SEQ_TBL");
sequence_tbl_safe.add_sequence_table(sequence_tbl_safe_0);
sequence_tbl_safe.add_sequence_table(sequence_tbl_safe_1);
2024-11-28 12:36:43 +01:00
acs_subsystem.add_target_and_sequence_table(
AcsMode::SAFE as u32,
target_table_safe,
sequence_tbl_safe,
);
2024-11-26 18:11:00 +01:00
// Connect the PUS mode service to all mode objects.
connect_mode_nodes(
&mut pus_service,
request_sender_to_acs_subsystem,
&mut acs_subsystem,
reply_sender_to_pus.clone(),
);
connect_mode_nodes(
&mut pus_service,
request_sender_to_acs_ctrl.clone(),
&mut acs_ctrl,
reply_sender_to_pus.clone(),
);
connect_mode_nodes(
&mut pus_service,
2024-11-28 12:36:43 +01:00
request_sender_to_mgm_dev_0.clone(),
&mut mgm_dev_0,
reply_sender_to_pus.clone(),
);
connect_mode_nodes(
&mut pus_service,
request_sender_to_mgm_dev_1.clone(),
&mut mgm_dev_1,
2024-11-26 18:11:00 +01:00
reply_sender_to_pus.clone(),
);
connect_mode_nodes(
&mut pus_service,
request_sender_to_mgm_assy.clone(),
&mut mgm_assy,
reply_sender_to_pus.clone(),
);
2024-11-28 12:36:43 +01:00
connect_mode_nodes(
&mut pus_service,
request_sender_to_mgt_man.clone(),
&mut mgt_manager,
reply_sender_to_pus.clone(),
);
2024-11-26 18:11:00 +01:00
connect_mode_nodes(
&mut pus_service,
request_sender_to_mgt_dev.clone(),
&mut mgt_dev,
reply_sender_to_pus.clone(),
);
// Connect the ACS subsystem to all children.
connect_mode_nodes(
&mut acs_subsystem,
request_sender_to_mgm_assy,
&mut mgm_assy,
reply_sender_to_acs_subsystem.clone(),
);
connect_mode_nodes(
&mut acs_subsystem,
request_sender_to_acs_ctrl,
&mut acs_ctrl,
reply_sender_to_acs_subsystem.clone(),
);
connect_mode_nodes(
&mut acs_subsystem,
2024-11-29 13:36:53 +01:00
request_sender_to_mgt_man.clone(),
&mut mgt_manager,
2024-11-26 18:11:00 +01:00
reply_sender_to_acs_subsystem.clone(),
);
connect_mode_nodes(
&mut mgm_assy,
2024-11-28 12:36:43 +01:00
request_sender_to_mgm_dev_0,
&mut mgm_dev_0,
reply_sender_to_mgm_assy.clone(),
);
connect_mode_nodes(
&mut mgm_assy,
request_sender_to_mgm_dev_1,
&mut mgm_dev_1,
2024-11-26 18:11:00 +01:00
reply_sender_to_mgm_assy,
);
2024-11-29 13:36:53 +01:00
2024-11-28 12:36:43 +01:00
connect_mode_nodes(
&mut mgt_manager,
request_sender_to_mgt_dev,
&mut mgt_dev,
reply_sender_to_mgt_man,
);
2024-11-26 18:11:00 +01:00
Self {
pus: pus_service,
subsystem: acs_subsystem,
ctrl: acs_ctrl,
mgm_assy,
mgt_dev,
2024-11-28 12:36:43 +01:00
mgt_manager,
mgm_devs: [mgm_dev_0, mgm_dev_1],
2024-11-26 18:11:00 +01:00
}
}
2025-01-16 16:49:35 +01:00
pub fn run(&mut self) {
self.subsystem.run();
self.ctrl.run();
self.mgt_manager.run();
self.mgm_assy.run();
self.mgm_devs[0].run();
self.mgm_devs[1].run();
self.mgt_dev.run();
}
2024-11-26 18:11:00 +01:00
}
2024-11-26 10:25:56 +01:00
#[test]
2024-11-26 18:11:00 +01:00
fn announce_recursively() {
let mut tb = TreeTestbench::new();
tb.pus.announce_modes_recursively();
2024-11-29 13:36:53 +01:00
// Run everything twice so the order does not matter.
2025-01-16 16:49:35 +01:00
tb.run();
tb.run();
2025-01-20 10:53:51 +01:00
assert_eq!(tb.subsystem.get_num_mode_requests(), 1);
2024-11-26 18:11:00 +01:00
let mut announces = tb
.subsystem
.mode_req_handler_mock
.announce_mode_calls
.borrow_mut();
assert_eq!(announces.len(), 1);
announces = tb.ctrl.mode_req_mock.announce_mode_calls.borrow_mut();
assert_eq!(tb.ctrl.mode_req_mock.start_transition_calls.len(), 0);
assert_eq!(tb.ctrl.mode_and_submode(), UNKNOWN_MODE);
assert_eq!(announces.len(), 1);
2025-01-16 16:49:35 +01:00
assert_eq!(tb.mgm_assy.get_num_mode_requests(), 1);
2024-11-26 18:11:00 +01:00
announces = tb.mgm_assy.mode_req_mock.announce_mode_calls.borrow_mut();
assert_eq!(tb.mgm_assy.mode_req_mock.start_transition_calls.len(), 0);
2024-11-28 12:36:43 +01:00
assert_eq!(tb.mgm_assy.mode_and_submode(), UNKNOWN_MODE);
2024-11-26 18:11:00 +01:00
assert_eq!(announces.len(), 1);
2024-11-29 13:36:53 +01:00
for mgm_dev in &mut tb.mgm_devs {
assert_eq!(mgm_dev.get_and_clear_num_mode_msgs(), 1);
2024-11-28 12:36:43 +01:00
announces = mgm_dev.mode_req_mock.announce_mode_calls.borrow_mut();
assert_eq!(mgm_dev.mode_req_mock.start_transition_calls.len(), 0);
assert_eq!(mgm_dev.mode_and_submode(), UNKNOWN_MODE);
assert_eq!(announces.len(), 1);
}
2024-11-26 18:11:00 +01:00
assert_eq!(announces.len(), 1);
2024-11-29 13:36:53 +01:00
assert_eq!(tb.mgt_dev.get_and_clear_num_mode_msgs(), 1);
2024-11-26 18:11:00 +01:00
announces = tb.mgt_dev.mode_req_mock.announce_mode_calls.borrow_mut();
assert_eq!(tb.mgt_dev.mode_req_mock.start_transition_calls.len(), 0);
2024-11-28 12:36:43 +01:00
assert_eq!(tb.mgt_dev.mode_and_submode(), UNKNOWN_MODE);
2024-11-26 18:11:00 +01:00
assert_eq!(announces.len(), 1);
2025-01-20 11:51:12 +01:00
assert_eq!(tb.mgt_manager.get_num_mode_requests(), 1);
2024-11-29 13:36:53 +01:00
announces = tb
.mgt_manager
.mode_req_mock
.announce_mode_calls
.borrow_mut();
assert_eq!(tb.mgt_manager.mode_req_mock.start_transition_calls.len(), 0);
assert_eq!(tb.mgt_manager.mode_and_submode(), UNKNOWN_MODE);
assert_eq!(announces.len(), 1);
}
2024-11-28 12:36:43 +01:00
#[test]
fn command_safe_mode() {
let mut tb = TreeTestbench::new();
2025-01-20 10:53:51 +01:00
assert_eq!(tb.ctrl.mode_and_submode(), UNKNOWN_MODE);
assert_eq!(tb.mgm_devs[0].mode_and_submode(), UNKNOWN_MODE);
assert_eq!(tb.mgm_devs[1].mode_and_submode(), UNKNOWN_MODE);
2025-01-16 16:49:35 +01:00
tb.run();
2025-01-16 13:56:49 +01:00
tb.pus
2025-01-16 16:49:35 +01:00
.send_mode_cmd(ModeAndSubmode::new(AcsMode::SAFE as u32, 0));
tb.run();
tb.run();
assert_eq!(
tb.ctrl.mode_and_submode(),
ModeAndSubmode::new(AcsMode::SAFE as u32, 0)
);
2025-01-20 10:53:51 +01:00
assert_eq!(
tb.mgm_devs[0].mode_and_submode(),
ModeAndSubmode::new(DefaultMode::NORMAL as u32, 0)
);
assert_eq!(
tb.mgm_devs[1].mode_and_submode(),
ModeAndSubmode::new(DefaultMode::NORMAL as u32, 0)
);
2025-01-16 16:49:35 +01:00
assert_eq!(
tb.mgm_assy.mode_and_submode(),
ModeAndSubmode::new(DefaultMode::NORMAL as u32, 0)
);
2025-01-20 11:51:12 +01:00
assert_eq!(
tb.mgt_manager.mode_and_submode(),
ModeAndSubmode::new(DefaultMode::NORMAL as u32, 0)
);
assert_eq!(
tb.mgt_dev.mode_and_submode(),
ModeAndSubmode::new(DefaultMode::NORMAL as u32, 0)
);
2024-11-28 12:36:43 +01:00
}