Compare commits
5 Commits
c4383e76c9
...
cabb3a19ef
Author | SHA1 | Date | |
---|---|---|---|
cabb3a19ef | |||
5eef376351 | |||
538548b05e | |||
3045a27d8c | |||
c7cf83d468 |
@ -24,6 +24,7 @@ to check all the API changes in the **Changed** chapter.
|
|||||||
- Added basic support conversions to the `time` library. Introduce new `chrono` and `timelib`
|
- Added basic support conversions to the `time` library. Introduce new `chrono` and `timelib`
|
||||||
feature gate.
|
feature gate.
|
||||||
- Added `CcsdsTimeProvider::timelib_date_time`.
|
- Added `CcsdsTimeProvider::timelib_date_time`.
|
||||||
|
- Optional support for `defmt` by adding optional `defmt::Format` derives for common types.
|
||||||
|
|
||||||
## Changed
|
## Changed
|
||||||
|
|
||||||
@ -47,8 +48,14 @@ to check all the API changes in the **Changed** chapter.
|
|||||||
- Error handling for ECSS and time module is more granular now, with a new
|
- Error handling for ECSS and time module is more granular now, with a new
|
||||||
`DateBeforeCcsdsEpochError` error and a `DateBeforeCcsdsEpoch` enum variant for both
|
`DateBeforeCcsdsEpochError` error and a `DateBeforeCcsdsEpoch` enum variant for both
|
||||||
`CdsError` and `CucError`.
|
`CdsError` and `CucError`.
|
||||||
|
- `PusTmCreator` now has two lifetimes: One for the raw source data buffer and one for the
|
||||||
|
raw timestamp.
|
||||||
- Time API `from_now*` API renamed to `now*`.
|
- Time API `from_now*` API renamed to `now*`.
|
||||||
|
|
||||||
|
## Removed
|
||||||
|
|
||||||
|
- Legacy `PusTm` and `PusTc` objects.
|
||||||
|
|
||||||
# [v0.11.0-rc.0] 2024-03-04
|
# [v0.11.0-rc.0] 2024-03-04
|
||||||
|
|
||||||
## Added
|
## Added
|
||||||
|
@ -48,6 +48,10 @@ optional = true
|
|||||||
version = "0.2"
|
version = "0.2"
|
||||||
default-features = false
|
default-features = false
|
||||||
|
|
||||||
|
[dependencies.defmt]
|
||||||
|
version = "0.3"
|
||||||
|
optional = true
|
||||||
|
|
||||||
[dev-dependencies]
|
[dev-dependencies]
|
||||||
postcard = "1"
|
postcard = "1"
|
||||||
chrono = "0.4"
|
chrono = "0.4"
|
||||||
@ -59,6 +63,7 @@ serde = ["dep:serde", "chrono/serde"]
|
|||||||
alloc = ["postcard/alloc", "chrono/alloc"]
|
alloc = ["postcard/alloc", "chrono/alloc"]
|
||||||
chrono = ["dep:chrono"]
|
chrono = ["dep:chrono"]
|
||||||
timelib = ["dep:time"]
|
timelib = ["dep:time"]
|
||||||
|
defmt = ["dep:defmt"]
|
||||||
|
|
||||||
[package.metadata.docs.rs]
|
[package.metadata.docs.rs]
|
||||||
all-features = true
|
all-features = true
|
||||||
|
@ -45,6 +45,8 @@ deserializing them with an appropriate `serde` provider like
|
|||||||
- [`serde`](https://serde.rs/): Adds `serde` support for most types by adding `Serialize` and `Deserialize` `derive`s
|
- [`serde`](https://serde.rs/): Adds `serde` support for most types by adding `Serialize` and `Deserialize` `derive`s
|
||||||
- [`chrono`](https://crates.io/crates/chrono): Add basic support for the `chrono` time library.
|
- [`chrono`](https://crates.io/crates/chrono): Add basic support for the `chrono` time library.
|
||||||
- [`timelib`](https://crates.io/crates/time): Add basic support for the `time` time library.
|
- [`timelib`](https://crates.io/crates/time): Add basic support for the `time` time library.
|
||||||
|
- [`defmt`](https://defmt.ferrous-systems.com/): Add support for the `defmt` by adding the
|
||||||
|
`defmt::Format` derive on many objects.
|
||||||
|
|
||||||
# Examples
|
# Examples
|
||||||
|
|
||||||
|
@ -20,6 +20,7 @@ pub const MIN_LV_LEN: usize = 1;
|
|||||||
/// this will be the lifetime of that data reference.
|
/// this will be the lifetime of that data reference.
|
||||||
#[derive(Debug, Copy, Clone, Eq)]
|
#[derive(Debug, Copy, Clone, Eq)]
|
||||||
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
||||||
|
#[cfg_attr(feature = "defmt", derive(defmt::Format))]
|
||||||
pub struct Lv<'data> {
|
pub struct Lv<'data> {
|
||||||
data: &'data [u8],
|
data: &'data [u8],
|
||||||
// If the LV was generated from a raw bytestream, this will contain the start of the
|
// If the LV was generated from a raw bytestream, this will contain the start of the
|
||||||
|
@ -18,6 +18,7 @@ pub const CFDP_VERSION_2: u8 = 0b001;
|
|||||||
|
|
||||||
#[derive(Debug, Copy, Clone, PartialEq, Eq, TryFromPrimitive, IntoPrimitive)]
|
#[derive(Debug, Copy, Clone, PartialEq, Eq, TryFromPrimitive, IntoPrimitive)]
|
||||||
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
||||||
|
#[cfg_attr(feature = "defmt", derive(defmt::Format))]
|
||||||
#[repr(u8)]
|
#[repr(u8)]
|
||||||
pub enum PduType {
|
pub enum PduType {
|
||||||
FileDirective = 0,
|
FileDirective = 0,
|
||||||
@ -26,6 +27,7 @@ pub enum PduType {
|
|||||||
|
|
||||||
#[derive(Debug, Copy, Clone, PartialEq, Eq, TryFromPrimitive, IntoPrimitive)]
|
#[derive(Debug, Copy, Clone, PartialEq, Eq, TryFromPrimitive, IntoPrimitive)]
|
||||||
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
||||||
|
#[cfg_attr(feature = "defmt", derive(defmt::Format))]
|
||||||
#[repr(u8)]
|
#[repr(u8)]
|
||||||
pub enum Direction {
|
pub enum Direction {
|
||||||
TowardsReceiver = 0,
|
TowardsReceiver = 0,
|
||||||
@ -34,6 +36,7 @@ pub enum Direction {
|
|||||||
|
|
||||||
#[derive(Debug, Copy, Clone, PartialEq, Eq, TryFromPrimitive, IntoPrimitive)]
|
#[derive(Debug, Copy, Clone, PartialEq, Eq, TryFromPrimitive, IntoPrimitive)]
|
||||||
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
||||||
|
#[cfg_attr(feature = "defmt", derive(defmt::Format))]
|
||||||
#[repr(u8)]
|
#[repr(u8)]
|
||||||
pub enum TransmissionMode {
|
pub enum TransmissionMode {
|
||||||
Acknowledged = 0,
|
Acknowledged = 0,
|
||||||
@ -42,6 +45,7 @@ pub enum TransmissionMode {
|
|||||||
|
|
||||||
#[derive(Debug, Copy, Clone, PartialEq, Eq, TryFromPrimitive, IntoPrimitive)]
|
#[derive(Debug, Copy, Clone, PartialEq, Eq, TryFromPrimitive, IntoPrimitive)]
|
||||||
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
||||||
|
#[cfg_attr(feature = "defmt", derive(defmt::Format))]
|
||||||
#[repr(u8)]
|
#[repr(u8)]
|
||||||
pub enum CrcFlag {
|
pub enum CrcFlag {
|
||||||
NoCrc = 0,
|
NoCrc = 0,
|
||||||
@ -69,6 +73,7 @@ impl From<CrcFlag> for bool {
|
|||||||
/// Always 0 and ignored for File Directive PDUs (CCSDS 727.0-B-5 P.75)
|
/// Always 0 and ignored for File Directive PDUs (CCSDS 727.0-B-5 P.75)
|
||||||
#[derive(Debug, Copy, Clone, PartialEq, Eq, TryFromPrimitive, IntoPrimitive)]
|
#[derive(Debug, Copy, Clone, PartialEq, Eq, TryFromPrimitive, IntoPrimitive)]
|
||||||
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
||||||
|
#[cfg_attr(feature = "defmt", derive(defmt::Format))]
|
||||||
#[repr(u8)]
|
#[repr(u8)]
|
||||||
pub enum SegmentMetadataFlag {
|
pub enum SegmentMetadataFlag {
|
||||||
NotPresent = 0,
|
NotPresent = 0,
|
||||||
@ -78,6 +83,7 @@ pub enum SegmentMetadataFlag {
|
|||||||
/// Always 0 and ignored for File Directive PDUs (CCSDS 727.0-B-5 P.75)
|
/// Always 0 and ignored for File Directive PDUs (CCSDS 727.0-B-5 P.75)
|
||||||
#[derive(Debug, Copy, Clone, PartialEq, Eq, TryFromPrimitive, IntoPrimitive)]
|
#[derive(Debug, Copy, Clone, PartialEq, Eq, TryFromPrimitive, IntoPrimitive)]
|
||||||
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
||||||
|
#[cfg_attr(feature = "defmt", derive(defmt::Format))]
|
||||||
#[repr(u8)]
|
#[repr(u8)]
|
||||||
pub enum SegmentationControl {
|
pub enum SegmentationControl {
|
||||||
NoRecordBoundaryPreservation = 0,
|
NoRecordBoundaryPreservation = 0,
|
||||||
@ -86,6 +92,7 @@ pub enum SegmentationControl {
|
|||||||
|
|
||||||
#[derive(Debug, Copy, Clone, PartialEq, Eq, TryFromPrimitive, IntoPrimitive)]
|
#[derive(Debug, Copy, Clone, PartialEq, Eq, TryFromPrimitive, IntoPrimitive)]
|
||||||
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
||||||
|
#[cfg_attr(feature = "defmt", derive(defmt::Format))]
|
||||||
#[repr(u8)]
|
#[repr(u8)]
|
||||||
pub enum FaultHandlerCode {
|
pub enum FaultHandlerCode {
|
||||||
NoticeOfCancellation = 0b0001,
|
NoticeOfCancellation = 0b0001,
|
||||||
@ -96,6 +103,7 @@ pub enum FaultHandlerCode {
|
|||||||
|
|
||||||
#[derive(Debug, Copy, Clone, PartialEq, Eq, TryFromPrimitive, IntoPrimitive)]
|
#[derive(Debug, Copy, Clone, PartialEq, Eq, TryFromPrimitive, IntoPrimitive)]
|
||||||
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
||||||
|
#[cfg_attr(feature = "defmt", derive(defmt::Format))]
|
||||||
#[repr(u8)]
|
#[repr(u8)]
|
||||||
pub enum ConditionCode {
|
pub enum ConditionCode {
|
||||||
/// This is not an error condition for which a faulty handler override can be specified
|
/// This is not an error condition for which a faulty handler override can be specified
|
||||||
@ -118,6 +126,7 @@ pub enum ConditionCode {
|
|||||||
|
|
||||||
#[derive(Debug, Copy, Clone, PartialEq, Eq, TryFromPrimitive, IntoPrimitive)]
|
#[derive(Debug, Copy, Clone, PartialEq, Eq, TryFromPrimitive, IntoPrimitive)]
|
||||||
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
||||||
|
#[cfg_attr(feature = "defmt", derive(defmt::Format))]
|
||||||
#[repr(u8)]
|
#[repr(u8)]
|
||||||
pub enum LargeFileFlag {
|
pub enum LargeFileFlag {
|
||||||
/// 32 bit maximum file size and FSS size
|
/// 32 bit maximum file size and FSS size
|
||||||
@ -129,6 +138,7 @@ pub enum LargeFileFlag {
|
|||||||
/// Transaction status for the ACK PDU field according to chapter 5.2.4 of the CFDP standard.
|
/// Transaction status for the ACK PDU field according to chapter 5.2.4 of the CFDP standard.
|
||||||
#[derive(Debug, Copy, Clone, PartialEq, Eq, TryFromPrimitive, IntoPrimitive)]
|
#[derive(Debug, Copy, Clone, PartialEq, Eq, TryFromPrimitive, IntoPrimitive)]
|
||||||
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
||||||
|
#[cfg_attr(feature = "defmt", derive(defmt::Format))]
|
||||||
#[repr(u8)]
|
#[repr(u8)]
|
||||||
pub enum TransactionStatus {
|
pub enum TransactionStatus {
|
||||||
/// Transaction is not currently active and the CFDP implementation does not retain a
|
/// Transaction is not currently active and the CFDP implementation does not retain a
|
||||||
@ -146,6 +156,7 @@ pub enum TransactionStatus {
|
|||||||
/// [SANA Checksum Types registry](https://sanaregistry.org/r/checksum_identifiers/)
|
/// [SANA Checksum Types registry](https://sanaregistry.org/r/checksum_identifiers/)
|
||||||
#[derive(Debug, Copy, Clone, PartialEq, Eq, TryFromPrimitive, IntoPrimitive)]
|
#[derive(Debug, Copy, Clone, PartialEq, Eq, TryFromPrimitive, IntoPrimitive)]
|
||||||
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
||||||
|
#[cfg_attr(feature = "defmt", derive(defmt::Format))]
|
||||||
#[repr(u8)]
|
#[repr(u8)]
|
||||||
pub enum ChecksumType {
|
pub enum ChecksumType {
|
||||||
/// Modular legacy checksum
|
/// Modular legacy checksum
|
||||||
@ -167,6 +178,7 @@ pub const NULL_CHECKSUM_U32: [u8; 4] = [0; 4];
|
|||||||
|
|
||||||
#[derive(Debug, Copy, Clone, PartialEq, Eq)]
|
#[derive(Debug, Copy, Clone, PartialEq, Eq)]
|
||||||
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
||||||
|
#[cfg_attr(feature = "defmt", derive(defmt::Format))]
|
||||||
pub enum TlvLvError {
|
pub enum TlvLvError {
|
||||||
DataTooLarge(usize),
|
DataTooLarge(usize),
|
||||||
ByteConversion(ByteConversionError),
|
ByteConversion(ByteConversionError),
|
||||||
|
@ -15,6 +15,7 @@ use serde::{Deserialize, Serialize};
|
|||||||
/// For more information, refer to CFDP chapter 5.2.4.
|
/// For more information, refer to CFDP chapter 5.2.4.
|
||||||
#[derive(Debug, Copy, Clone, PartialEq, Eq)]
|
#[derive(Debug, Copy, Clone, PartialEq, Eq)]
|
||||||
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
||||||
|
#[cfg_attr(feature = "defmt", derive(defmt::Format))]
|
||||||
pub struct AckPdu {
|
pub struct AckPdu {
|
||||||
pdu_header: PduHeader,
|
pdu_header: PduHeader,
|
||||||
directive_code_of_acked_pdu: FileDirectiveType,
|
directive_code_of_acked_pdu: FileDirectiveType,
|
||||||
|
@ -15,6 +15,7 @@ use super::{CfdpPdu, WritablePduPacket};
|
|||||||
/// For more information, refer to CFDP chapter 5.2.2.
|
/// For more information, refer to CFDP chapter 5.2.2.
|
||||||
#[derive(Debug, Copy, Clone, PartialEq, Eq)]
|
#[derive(Debug, Copy, Clone, PartialEq, Eq)]
|
||||||
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
||||||
|
#[cfg_attr(feature = "defmt", derive(defmt::Format))]
|
||||||
pub struct EofPdu {
|
pub struct EofPdu {
|
||||||
pdu_header: PduHeader,
|
pdu_header: PduHeader,
|
||||||
condition_code: ConditionCode,
|
condition_code: ConditionCode,
|
||||||
|
@ -14,6 +14,7 @@ use super::{CfdpPdu, WritablePduPacket};
|
|||||||
|
|
||||||
#[derive(Debug, Copy, Clone, PartialEq, Eq, TryFromPrimitive, IntoPrimitive)]
|
#[derive(Debug, Copy, Clone, PartialEq, Eq, TryFromPrimitive, IntoPrimitive)]
|
||||||
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
||||||
|
#[cfg_attr(feature = "defmt", derive(defmt::Format))]
|
||||||
#[repr(u8)]
|
#[repr(u8)]
|
||||||
pub enum DeliveryCode {
|
pub enum DeliveryCode {
|
||||||
Complete = 0,
|
Complete = 0,
|
||||||
@ -22,6 +23,7 @@ pub enum DeliveryCode {
|
|||||||
|
|
||||||
#[derive(Debug, Copy, Clone, PartialEq, Eq, TryFromPrimitive, IntoPrimitive)]
|
#[derive(Debug, Copy, Clone, PartialEq, Eq, TryFromPrimitive, IntoPrimitive)]
|
||||||
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
||||||
|
#[cfg_attr(feature = "defmt", derive(defmt::Format))]
|
||||||
#[repr(u8)]
|
#[repr(u8)]
|
||||||
pub enum FileStatus {
|
pub enum FileStatus {
|
||||||
DiscardDeliberately = 0b00,
|
DiscardDeliberately = 0b00,
|
||||||
@ -34,6 +36,7 @@ pub enum FileStatus {
|
|||||||
///
|
///
|
||||||
/// For more information, refer to CFDP chapter 5.2.3.
|
/// For more information, refer to CFDP chapter 5.2.3.
|
||||||
#[derive(Debug, Copy, Clone, PartialEq, Eq)]
|
#[derive(Debug, Copy, Clone, PartialEq, Eq)]
|
||||||
|
#[cfg_attr(feature = "defmt", derive(defmt::Format))]
|
||||||
pub struct FinishedPduCreator<'fs_responses> {
|
pub struct FinishedPduCreator<'fs_responses> {
|
||||||
pdu_header: PduHeader,
|
pdu_header: PduHeader,
|
||||||
condition_code: ConditionCode,
|
condition_code: ConditionCode,
|
||||||
@ -219,6 +222,7 @@ impl<'buf> Iterator for FilestoreResponseIterator<'buf> {
|
|||||||
|
|
||||||
#[derive(Debug, Copy, Clone, PartialEq, Eq)]
|
#[derive(Debug, Copy, Clone, PartialEq, Eq)]
|
||||||
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
||||||
|
#[cfg_attr(feature = "defmt", derive(defmt::Format))]
|
||||||
pub struct FinishedPduReader<'buf> {
|
pub struct FinishedPduReader<'buf> {
|
||||||
pdu_header: PduHeader,
|
pdu_header: PduHeader,
|
||||||
condition_code: ConditionCode,
|
condition_code: ConditionCode,
|
||||||
|
@ -15,6 +15,7 @@ use super::{CfdpPdu, WritablePduPacket};
|
|||||||
|
|
||||||
#[derive(Default, Debug, Copy, Clone, PartialEq, Eq)]
|
#[derive(Default, Debug, Copy, Clone, PartialEq, Eq)]
|
||||||
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
||||||
|
#[cfg_attr(feature = "defmt", derive(defmt::Format))]
|
||||||
pub struct MetadataGenericParams {
|
pub struct MetadataGenericParams {
|
||||||
pub closure_requested: bool,
|
pub closure_requested: bool,
|
||||||
pub checksum_type: ChecksumType,
|
pub checksum_type: ChecksumType,
|
||||||
@ -55,6 +56,7 @@ pub fn build_metadata_opts_from_vec(
|
|||||||
/// This abstraction exposes a specialized API for creating metadata PDUs as specified in
|
/// This abstraction exposes a specialized API for creating metadata PDUs as specified in
|
||||||
/// CFDP chapter 5.2.5.
|
/// CFDP chapter 5.2.5.
|
||||||
#[derive(Debug, Copy, Clone, PartialEq, Eq)]
|
#[derive(Debug, Copy, Clone, PartialEq, Eq)]
|
||||||
|
#[cfg_attr(feature = "defmt", derive(defmt::Format))]
|
||||||
pub struct MetadataPduCreator<'src_name, 'dest_name, 'opts> {
|
pub struct MetadataPduCreator<'src_name, 'dest_name, 'opts> {
|
||||||
pdu_header: PduHeader,
|
pdu_header: PduHeader,
|
||||||
metadata_params: MetadataGenericParams,
|
metadata_params: MetadataGenericParams,
|
||||||
@ -241,6 +243,7 @@ impl<'opts> Iterator for OptionsIter<'opts> {
|
|||||||
/// involved.
|
/// involved.
|
||||||
#[derive(Debug)]
|
#[derive(Debug)]
|
||||||
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
||||||
|
#[cfg_attr(feature = "defmt", derive(defmt::Format))]
|
||||||
pub struct MetadataPduReader<'buf> {
|
pub struct MetadataPduReader<'buf> {
|
||||||
pdu_header: PduHeader,
|
pdu_header: PduHeader,
|
||||||
metadata_params: MetadataGenericParams,
|
metadata_params: MetadataGenericParams,
|
||||||
|
@ -18,6 +18,7 @@ pub mod nak;
|
|||||||
|
|
||||||
#[derive(Debug, Copy, Clone, PartialEq, Eq, TryFromPrimitive, IntoPrimitive)]
|
#[derive(Debug, Copy, Clone, PartialEq, Eq, TryFromPrimitive, IntoPrimitive)]
|
||||||
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
||||||
|
#[cfg_attr(feature = "defmt", derive(defmt::Format))]
|
||||||
#[repr(u8)]
|
#[repr(u8)]
|
||||||
pub enum FileDirectiveType {
|
pub enum FileDirectiveType {
|
||||||
EofPdu = 0x04,
|
EofPdu = 0x04,
|
||||||
@ -220,6 +221,7 @@ pub trait CfdpPdu {
|
|||||||
/// same.
|
/// same.
|
||||||
#[derive(Debug, Copy, Clone, Eq)]
|
#[derive(Debug, Copy, Clone, Eq)]
|
||||||
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
||||||
|
#[cfg_attr(feature = "defmt", derive(defmt::Format))]
|
||||||
pub struct CommonPduConfig {
|
pub struct CommonPduConfig {
|
||||||
source_entity_id: UnsignedByteField,
|
source_entity_id: UnsignedByteField,
|
||||||
dest_entity_id: UnsignedByteField,
|
dest_entity_id: UnsignedByteField,
|
||||||
@ -358,6 +360,7 @@ pub const FIXED_HEADER_LEN: usize = 4;
|
|||||||
/// For detailed information, refer to chapter 5.1 of the CFDP standard.
|
/// For detailed information, refer to chapter 5.1 of the CFDP standard.
|
||||||
#[derive(Debug, Copy, Clone, PartialEq, Eq)]
|
#[derive(Debug, Copy, Clone, PartialEq, Eq)]
|
||||||
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
||||||
|
#[cfg_attr(feature = "defmt", derive(defmt::Format))]
|
||||||
pub struct PduHeader {
|
pub struct PduHeader {
|
||||||
pdu_type: PduType,
|
pdu_type: PduType,
|
||||||
pdu_conf: CommonPduConfig,
|
pdu_conf: CommonPduConfig,
|
||||||
|
@ -12,6 +12,7 @@ use super::{
|
|||||||
/// Helper type to encapsulate both normal file size segment requests and large file size segment
|
/// Helper type to encapsulate both normal file size segment requests and large file size segment
|
||||||
/// requests.
|
/// requests.
|
||||||
#[derive(Debug, PartialEq, Eq, Clone)]
|
#[derive(Debug, PartialEq, Eq, Clone)]
|
||||||
|
#[cfg_attr(feature = "defmt", derive(defmt::Format))]
|
||||||
pub enum SegmentRequests<'a> {
|
pub enum SegmentRequests<'a> {
|
||||||
U32Pairs(&'a [(u32, u32)]),
|
U32Pairs(&'a [(u32, u32)]),
|
||||||
U64Pairs(&'a [(u64, u64)]),
|
U64Pairs(&'a [(u64, u64)]),
|
||||||
@ -31,6 +32,7 @@ impl SegmentRequests<'_> {
|
|||||||
/// It exposes a specialized API which simplifies to generate these NAK PDUs with the
|
/// It exposes a specialized API which simplifies to generate these NAK PDUs with the
|
||||||
/// format according to CFDP chapter 5.2.6.
|
/// format according to CFDP chapter 5.2.6.
|
||||||
#[derive(Debug, Clone, PartialEq, Eq)]
|
#[derive(Debug, Clone, PartialEq, Eq)]
|
||||||
|
#[cfg_attr(feature = "defmt", derive(defmt::Format))]
|
||||||
pub struct NakPduCreator<'seg_reqs> {
|
pub struct NakPduCreator<'seg_reqs> {
|
||||||
pdu_header: PduHeader,
|
pdu_header: PduHeader,
|
||||||
start_of_scope: u64,
|
start_of_scope: u64,
|
||||||
@ -353,6 +355,7 @@ impl<T: SegReqFromBytes> SegmentRequestIter<'_, T> {
|
|||||||
///
|
///
|
||||||
/// The NAK format is expected to be conforming to CFDP chapter 5.2.6.
|
/// The NAK format is expected to be conforming to CFDP chapter 5.2.6.
|
||||||
#[derive(Debug, PartialEq, Eq)]
|
#[derive(Debug, PartialEq, Eq)]
|
||||||
|
#[cfg_attr(feature = "defmt", derive(defmt::Format))]
|
||||||
pub struct NakPduReader<'seg_reqs> {
|
pub struct NakPduReader<'seg_reqs> {
|
||||||
pdu_header: PduHeader,
|
pdu_header: PduHeader,
|
||||||
start_of_scope: u64,
|
start_of_scope: u64,
|
||||||
|
@ -52,6 +52,7 @@ pub trait WritableTlv {
|
|||||||
|
|
||||||
#[derive(Debug, Copy, Clone, PartialEq, Eq, TryFromPrimitive, IntoPrimitive)]
|
#[derive(Debug, Copy, Clone, PartialEq, Eq, TryFromPrimitive, IntoPrimitive)]
|
||||||
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
||||||
|
#[cfg_attr(feature = "defmt", derive(defmt::Format))]
|
||||||
#[repr(u8)]
|
#[repr(u8)]
|
||||||
pub enum TlvType {
|
pub enum TlvType {
|
||||||
FilestoreRequest = 0x00,
|
FilestoreRequest = 0x00,
|
||||||
@ -64,6 +65,7 @@ pub enum TlvType {
|
|||||||
|
|
||||||
#[derive(Debug, Copy, Clone, PartialEq, Eq)]
|
#[derive(Debug, Copy, Clone, PartialEq, Eq)]
|
||||||
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
||||||
|
#[cfg_attr(feature = "defmt", derive(defmt::Format))]
|
||||||
pub enum TlvTypeField {
|
pub enum TlvTypeField {
|
||||||
Standard(TlvType),
|
Standard(TlvType),
|
||||||
Custom(u8),
|
Custom(u8),
|
||||||
@ -71,6 +73,7 @@ pub enum TlvTypeField {
|
|||||||
|
|
||||||
#[derive(Debug, Copy, Clone, PartialEq, Eq, TryFromPrimitive, IntoPrimitive)]
|
#[derive(Debug, Copy, Clone, PartialEq, Eq, TryFromPrimitive, IntoPrimitive)]
|
||||||
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
||||||
|
#[cfg_attr(feature = "defmt", derive(defmt::Format))]
|
||||||
#[repr(u8)]
|
#[repr(u8)]
|
||||||
pub enum FilestoreActionCode {
|
pub enum FilestoreActionCode {
|
||||||
CreateFile = 0b0000,
|
CreateFile = 0b0000,
|
||||||
@ -118,6 +121,7 @@ impl From<TlvTypeField> for u8 {
|
|||||||
/// this will be the lifetime of that data reference.
|
/// this will be the lifetime of that data reference.
|
||||||
#[derive(Debug, Copy, Clone, PartialEq, Eq)]
|
#[derive(Debug, Copy, Clone, PartialEq, Eq)]
|
||||||
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
||||||
|
#[cfg_attr(feature = "defmt", derive(defmt::Format))]
|
||||||
pub struct Tlv<'data> {
|
pub struct Tlv<'data> {
|
||||||
tlv_type_field: TlvTypeField,
|
tlv_type_field: TlvTypeField,
|
||||||
#[cfg_attr(feature = "serde", serde(borrow))]
|
#[cfg_attr(feature = "serde", serde(borrow))]
|
||||||
@ -224,6 +228,7 @@ pub(crate) fn verify_tlv_type(raw_type: u8, expected_tlv_type: TlvType) -> Resul
|
|||||||
|
|
||||||
#[derive(Debug, Copy, Clone, PartialEq, Eq)]
|
#[derive(Debug, Copy, Clone, PartialEq, Eq)]
|
||||||
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
||||||
|
#[cfg_attr(feature = "defmt", derive(defmt::Format))]
|
||||||
pub struct EntityIdTlv {
|
pub struct EntityIdTlv {
|
||||||
entity_id: UnsignedByteField,
|
entity_id: UnsignedByteField,
|
||||||
}
|
}
|
||||||
@ -348,6 +353,7 @@ pub fn fs_request_has_second_filename(action_code: FilestoreActionCode) -> bool
|
|||||||
|
|
||||||
#[derive(Debug, Copy, Clone, PartialEq, Eq)]
|
#[derive(Debug, Copy, Clone, PartialEq, Eq)]
|
||||||
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
||||||
|
#[cfg_attr(feature = "defmt", derive(defmt::Format))]
|
||||||
struct FilestoreTlvBase<'first_name, 'second_name> {
|
struct FilestoreTlvBase<'first_name, 'second_name> {
|
||||||
pub action_code: FilestoreActionCode,
|
pub action_code: FilestoreActionCode,
|
||||||
#[cfg_attr(feature = "serde", serde(borrow))]
|
#[cfg_attr(feature = "serde", serde(borrow))]
|
||||||
@ -561,6 +567,7 @@ impl GenericTlv for FilestoreRequestTlv<'_, '_> {
|
|||||||
|
|
||||||
#[derive(Debug, Copy, Clone, PartialEq, Eq)]
|
#[derive(Debug, Copy, Clone, PartialEq, Eq)]
|
||||||
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
||||||
|
#[cfg_attr(feature = "defmt", derive(defmt::Format))]
|
||||||
pub struct FilestoreResponseTlv<'first_name, 'second_name, 'fs_msg> {
|
pub struct FilestoreResponseTlv<'first_name, 'second_name, 'fs_msg> {
|
||||||
#[cfg_attr(feature = "serde", serde(borrow))]
|
#[cfg_attr(feature = "serde", serde(borrow))]
|
||||||
base: FilestoreTlvBase<'first_name, 'second_name>,
|
base: FilestoreTlvBase<'first_name, 'second_name>,
|
||||||
|
@ -5,6 +5,7 @@ use serde::{Deserialize, Serialize};
|
|||||||
|
|
||||||
#[derive(Debug, Eq, PartialEq, Copy, Clone, IntoPrimitive, TryFromPrimitive)]
|
#[derive(Debug, Eq, PartialEq, Copy, Clone, IntoPrimitive, TryFromPrimitive)]
|
||||||
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
||||||
|
#[cfg_attr(feature = "defmt", derive(defmt::Format))]
|
||||||
#[repr(u8)]
|
#[repr(u8)]
|
||||||
pub enum Subservice {
|
pub enum Subservice {
|
||||||
// Regular HK
|
// Regular HK
|
||||||
|
@ -74,6 +74,7 @@ pub enum PusServiceId {
|
|||||||
/// All PUS versions. Only PUS C is supported by this library.
|
/// All PUS versions. Only PUS C is supported by this library.
|
||||||
#[derive(PartialEq, Eq, Copy, Clone, Debug)]
|
#[derive(PartialEq, Eq, Copy, Clone, Debug)]
|
||||||
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
||||||
|
#[cfg_attr(feature = "defmt", derive(defmt::Format))]
|
||||||
#[non_exhaustive]
|
#[non_exhaustive]
|
||||||
pub enum PusVersion {
|
pub enum PusVersion {
|
||||||
EsaPus = 0,
|
EsaPus = 0,
|
||||||
@ -150,6 +151,7 @@ pub enum PfcReal {
|
|||||||
|
|
||||||
#[derive(Debug, Copy, Clone, PartialEq, Eq)]
|
#[derive(Debug, Copy, Clone, PartialEq, Eq)]
|
||||||
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
||||||
|
#[cfg_attr(feature = "defmt", derive(defmt::Format))]
|
||||||
pub enum PusError {
|
pub enum PusError {
|
||||||
VersionNotSupported(PusVersion),
|
VersionNotSupported(PusVersion),
|
||||||
ChecksumFailure(u16),
|
ChecksumFailure(u16),
|
||||||
@ -225,24 +227,6 @@ pub(crate) fn calc_pus_crc16(bytes: &[u8]) -> u16 {
|
|||||||
digest.finalize()
|
digest.finalize()
|
||||||
}
|
}
|
||||||
|
|
||||||
pub(crate) fn crc_procedure(
|
|
||||||
calc_on_serialization: bool,
|
|
||||||
cached_crc16: &Option<u16>,
|
|
||||||
start_idx: usize,
|
|
||||||
curr_idx: usize,
|
|
||||||
slice: &[u8],
|
|
||||||
) -> Result<u16, PusError> {
|
|
||||||
let crc16;
|
|
||||||
if calc_on_serialization {
|
|
||||||
crc16 = calc_pus_crc16(&slice[start_idx..curr_idx])
|
|
||||||
} else if cached_crc16.is_none() {
|
|
||||||
return Err(PusError::CrcCalculationMissing);
|
|
||||||
} else {
|
|
||||||
crc16 = cached_crc16.unwrap();
|
|
||||||
}
|
|
||||||
Ok(crc16)
|
|
||||||
}
|
|
||||||
|
|
||||||
pub(crate) fn user_data_from_raw(
|
pub(crate) fn user_data_from_raw(
|
||||||
current_idx: usize,
|
current_idx: usize,
|
||||||
total_len: usize,
|
total_len: usize,
|
||||||
|
341
src/ecss/tc.rs
341
src/ecss/tc.rs
@ -48,8 +48,6 @@ use zerocopy::AsBytes;
|
|||||||
#[cfg(feature = "alloc")]
|
#[cfg(feature = "alloc")]
|
||||||
use alloc::vec::Vec;
|
use alloc::vec::Vec;
|
||||||
|
|
||||||
pub use legacy_tc::*;
|
|
||||||
|
|
||||||
/// PUS C secondary header length is fixed
|
/// PUS C secondary header length is fixed
|
||||||
pub const PUC_TC_SECONDARY_HEADER_LEN: usize = size_of::<zc::PusTcSecondaryHeader>();
|
pub const PUC_TC_SECONDARY_HEADER_LEN: usize = size_of::<zc::PusTcSecondaryHeader>();
|
||||||
pub const PUS_TC_MIN_LEN_WITHOUT_APP_DATA: usize =
|
pub const PUS_TC_MIN_LEN_WITHOUT_APP_DATA: usize =
|
||||||
@ -61,6 +59,7 @@ pub trait IsPusTelecommand {}
|
|||||||
|
|
||||||
#[derive(Debug, Eq, PartialEq, Copy, Clone, IntoPrimitive, TryFromPrimitive)]
|
#[derive(Debug, Eq, PartialEq, Copy, Clone, IntoPrimitive, TryFromPrimitive)]
|
||||||
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
||||||
|
#[cfg_attr(feature = "defmt", derive(defmt::Format))]
|
||||||
#[repr(u8)]
|
#[repr(u8)]
|
||||||
enum AckOpts {
|
enum AckOpts {
|
||||||
Acceptance = 0b1000,
|
Acceptance = 0b1000,
|
||||||
@ -146,6 +145,7 @@ pub mod zc {
|
|||||||
|
|
||||||
#[derive(PartialEq, Eq, Copy, Clone, Debug)]
|
#[derive(PartialEq, Eq, Copy, Clone, Debug)]
|
||||||
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
||||||
|
#[cfg_attr(feature = "defmt", derive(defmt::Format))]
|
||||||
pub struct PusTcSecondaryHeader {
|
pub struct PusTcSecondaryHeader {
|
||||||
pub service: u8,
|
pub service: u8,
|
||||||
pub subservice: u8,
|
pub subservice: u8,
|
||||||
@ -212,332 +212,6 @@ impl PusTcSecondaryHeader {
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
pub mod legacy_tc {
|
|
||||||
use crate::ecss::tc::{
|
|
||||||
zc, GenericPusTcSecondaryHeader, IsPusTelecommand, PusTcSecondaryHeader, ACK_ALL,
|
|
||||||
PUC_TC_SECONDARY_HEADER_LEN, PUS_TC_MIN_LEN_WITHOUT_APP_DATA,
|
|
||||||
};
|
|
||||||
use crate::ecss::{
|
|
||||||
ccsds_impl, crc_from_raw_data, crc_procedure, sp_header_impls,
|
|
||||||
verify_crc16_ccitt_false_from_raw_to_pus_error, PusError, PusPacket, WritablePusPacket,
|
|
||||||
CCSDS_HEADER_LEN,
|
|
||||||
};
|
|
||||||
use crate::ecss::{user_data_from_raw, PusVersion};
|
|
||||||
use crate::SequenceFlags;
|
|
||||||
use crate::{ByteConversionError, CcsdsPacket, PacketType, SpHeader, CRC_CCITT_FALSE};
|
|
||||||
use core::mem::size_of;
|
|
||||||
use delegate::delegate;
|
|
||||||
use zerocopy::AsBytes;
|
|
||||||
|
|
||||||
#[cfg(feature = "alloc")]
|
|
||||||
use alloc::vec::Vec;
|
|
||||||
|
|
||||||
#[cfg(feature = "serde")]
|
|
||||||
use serde::{Deserialize, Serialize};
|
|
||||||
|
|
||||||
/// This class models the PUS C telecommand packet. It is the primary data structure to generate the
|
|
||||||
/// raw byte representation of a PUS telecommand or to deserialize from one from raw bytes.
|
|
||||||
///
|
|
||||||
/// This class also derives the [serde::Serialize] and [serde::Deserialize] trait if the
|
|
||||||
/// [serde] feature is used, which allows to send around TC packets in a raw byte format using a
|
|
||||||
/// serde provider like [postcard](https://docs.rs/postcard/latest/postcard/).
|
|
||||||
///
|
|
||||||
/// There is no spare bytes support yet.
|
|
||||||
///
|
|
||||||
/// # Lifetimes
|
|
||||||
///
|
|
||||||
/// * `'raw_data` - If the TC is not constructed from a raw slice, this will be the life time of
|
|
||||||
/// a buffer where the user provided application data will be serialized into. If it
|
|
||||||
/// is, this is the lifetime of the raw byte slice it is constructed from.
|
|
||||||
#[derive(Eq, Copy, Clone, Debug)]
|
|
||||||
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
|
||||||
pub struct PusTc<'raw_data> {
|
|
||||||
sp_header: SpHeader,
|
|
||||||
pub sec_header: PusTcSecondaryHeader,
|
|
||||||
/// If this is set to false, a manual call to [PusTc::calc_own_crc16] or
|
|
||||||
/// [PusTc::update_packet_fields] is necessary for the serialized or cached CRC16 to be valid.
|
|
||||||
pub calc_crc_on_serialization: bool,
|
|
||||||
#[cfg_attr(feature = "serde", serde(skip))]
|
|
||||||
raw_data: Option<&'raw_data [u8]>,
|
|
||||||
app_data: &'raw_data [u8],
|
|
||||||
crc16: Option<u16>,
|
|
||||||
}
|
|
||||||
|
|
||||||
impl<'raw_data> PusTc<'raw_data> {
|
|
||||||
/// Generates a new struct instance.
|
|
||||||
///
|
|
||||||
/// # Arguments
|
|
||||||
///
|
|
||||||
/// * `sp_header` - Space packet header information. The correct packet type will be set
|
|
||||||
/// automatically
|
|
||||||
/// * `sec_header` - Information contained in the data field header, including the service
|
|
||||||
/// and subservice type
|
|
||||||
/// * `app_data` - Custom application data
|
|
||||||
/// * `set_ccsds_len` - Can be used to automatically update the CCSDS space packet data length
|
|
||||||
/// field. If this is not set to true, [PusTc::update_ccsds_data_len] can be called to set
|
|
||||||
/// the correct value to this field manually
|
|
||||||
#[deprecated(
|
|
||||||
since = "0.7.0",
|
|
||||||
note = "Use specialized PusTcCreator or PusTcReader classes instead"
|
|
||||||
)]
|
|
||||||
pub fn new(
|
|
||||||
sp_header: &mut SpHeader,
|
|
||||||
sec_header: PusTcSecondaryHeader,
|
|
||||||
app_data: Option<&'raw_data [u8]>,
|
|
||||||
set_ccsds_len: bool,
|
|
||||||
) -> Self {
|
|
||||||
sp_header.set_packet_type(PacketType::Tc);
|
|
||||||
sp_header.set_sec_header_flag();
|
|
||||||
let mut pus_tc = Self {
|
|
||||||
sp_header: *sp_header,
|
|
||||||
raw_data: None,
|
|
||||||
app_data: app_data.unwrap_or(&[]),
|
|
||||||
sec_header,
|
|
||||||
calc_crc_on_serialization: true,
|
|
||||||
crc16: None,
|
|
||||||
};
|
|
||||||
if set_ccsds_len {
|
|
||||||
pus_tc.update_ccsds_data_len();
|
|
||||||
}
|
|
||||||
pus_tc
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Simplified version of the [PusTc::new] function which allows to only specify service and
|
|
||||||
/// subservice instead of the full PUS TC secondary header.
|
|
||||||
#[deprecated(
|
|
||||||
since = "0.7.0",
|
|
||||||
note = "Use specialized PusTcCreator or PusTcReader classes instead"
|
|
||||||
)]
|
|
||||||
pub fn new_simple(
|
|
||||||
sph: &mut SpHeader,
|
|
||||||
service: u8,
|
|
||||||
subservice: u8,
|
|
||||||
app_data: Option<&'raw_data [u8]>,
|
|
||||||
set_ccsds_len: bool,
|
|
||||||
) -> Self {
|
|
||||||
#[allow(deprecated)]
|
|
||||||
Self::new(
|
|
||||||
sph,
|
|
||||||
PusTcSecondaryHeader::new(service, subservice, ACK_ALL, 0),
|
|
||||||
app_data,
|
|
||||||
set_ccsds_len,
|
|
||||||
)
|
|
||||||
}
|
|
||||||
|
|
||||||
pub fn sp_header(&self) -> &SpHeader {
|
|
||||||
&self.sp_header
|
|
||||||
}
|
|
||||||
|
|
||||||
pub fn set_ack_field(&mut self, ack: u8) -> bool {
|
|
||||||
if ack > 0b1111 {
|
|
||||||
return false;
|
|
||||||
}
|
|
||||||
self.sec_header.ack = ack & 0b1111;
|
|
||||||
true
|
|
||||||
}
|
|
||||||
|
|
||||||
pub fn set_source_id(&mut self, source_id: u16) {
|
|
||||||
self.sec_header.source_id = source_id;
|
|
||||||
}
|
|
||||||
|
|
||||||
sp_header_impls!();
|
|
||||||
|
|
||||||
/// Calculate the CCSDS space packet data length field and sets it
|
|
||||||
/// This is called automatically if the `set_ccsds_len` argument in the [PusTc::new] call was
|
|
||||||
/// used.
|
|
||||||
/// If this was not done or the application data is set or changed after construction,
|
|
||||||
/// this function needs to be called to ensure that the data length field of the CCSDS header
|
|
||||||
/// is set correctly.
|
|
||||||
pub fn update_ccsds_data_len(&mut self) {
|
|
||||||
self.sp_header.data_len =
|
|
||||||
self.len_written() as u16 - size_of::<crate::zc::SpHeader>() as u16 - 1;
|
|
||||||
}
|
|
||||||
|
|
||||||
/// This function should be called before the TC packet is serialized if
|
|
||||||
/// [PusTc::calc_crc_on_serialization] is set to False. It will calculate and cache the CRC16.
|
|
||||||
pub fn calc_own_crc16(&mut self) {
|
|
||||||
let mut digest = CRC_CCITT_FALSE.digest();
|
|
||||||
let sph_zc = crate::zc::SpHeader::from(self.sp_header);
|
|
||||||
digest.update(sph_zc.as_bytes());
|
|
||||||
let pus_tc_header = zc::PusTcSecondaryHeader::try_from(self.sec_header).unwrap();
|
|
||||||
digest.update(pus_tc_header.as_bytes());
|
|
||||||
if !self.app_data.is_empty() {
|
|
||||||
digest.update(self.app_data);
|
|
||||||
}
|
|
||||||
self.crc16 = Some(digest.finalize())
|
|
||||||
}
|
|
||||||
|
|
||||||
/// This helper function calls both [PusTc::update_ccsds_data_len] and [PusTc::calc_own_crc16].
|
|
||||||
pub fn update_packet_fields(&mut self) {
|
|
||||||
self.update_ccsds_data_len();
|
|
||||||
self.calc_own_crc16();
|
|
||||||
}
|
|
||||||
|
|
||||||
#[cfg(feature = "alloc")]
|
|
||||||
pub fn append_to_vec(&self, vec: &mut Vec<u8>) -> Result<usize, PusError> {
|
|
||||||
let sph_zc = crate::zc::SpHeader::from(self.sp_header);
|
|
||||||
let appended_len = PUS_TC_MIN_LEN_WITHOUT_APP_DATA + self.app_data.len();
|
|
||||||
let start_idx = vec.len();
|
|
||||||
let mut ser_len = 0;
|
|
||||||
vec.extend_from_slice(sph_zc.as_bytes());
|
|
||||||
ser_len += sph_zc.as_bytes().len();
|
|
||||||
// The PUS version is hardcoded to PUS C
|
|
||||||
let pus_tc_header = zc::PusTcSecondaryHeader::try_from(self.sec_header).unwrap();
|
|
||||||
vec.extend_from_slice(pus_tc_header.as_bytes());
|
|
||||||
ser_len += pus_tc_header.as_bytes().len();
|
|
||||||
vec.extend_from_slice(self.app_data);
|
|
||||||
ser_len += self.app_data.len();
|
|
||||||
let crc16 = crc_procedure(
|
|
||||||
self.calc_crc_on_serialization,
|
|
||||||
&self.crc16,
|
|
||||||
start_idx,
|
|
||||||
ser_len,
|
|
||||||
&vec[start_idx..ser_len],
|
|
||||||
)?;
|
|
||||||
vec.extend_from_slice(crc16.to_be_bytes().as_slice());
|
|
||||||
Ok(appended_len)
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Create a [PusTc] instance from a raw slice. On success, it returns a tuple containing
|
|
||||||
/// the instance and the found byte length of the packet.
|
|
||||||
#[deprecated(
|
|
||||||
since = "0.7.0",
|
|
||||||
note = "Use specialized PusTcCreator or PusTcReader classes instead"
|
|
||||||
)]
|
|
||||||
pub fn from_bytes(slice: &'raw_data [u8]) -> Result<(Self, usize), PusError> {
|
|
||||||
let raw_data_len = slice.len();
|
|
||||||
if raw_data_len < PUS_TC_MIN_LEN_WITHOUT_APP_DATA {
|
|
||||||
return Err(ByteConversionError::FromSliceTooSmall {
|
|
||||||
found: raw_data_len,
|
|
||||||
expected: PUS_TC_MIN_LEN_WITHOUT_APP_DATA,
|
|
||||||
}
|
|
||||||
.into());
|
|
||||||
}
|
|
||||||
let mut current_idx = 0;
|
|
||||||
let (sp_header, _) = SpHeader::from_be_bytes(&slice[0..CCSDS_HEADER_LEN])?;
|
|
||||||
current_idx += CCSDS_HEADER_LEN;
|
|
||||||
let total_len = sp_header.total_len();
|
|
||||||
if raw_data_len < total_len || total_len < PUS_TC_MIN_LEN_WITHOUT_APP_DATA {
|
|
||||||
return Err(ByteConversionError::FromSliceTooSmall {
|
|
||||||
found: raw_data_len,
|
|
||||||
expected: total_len,
|
|
||||||
}
|
|
||||||
.into());
|
|
||||||
}
|
|
||||||
let sec_header = zc::PusTcSecondaryHeader::from_bytes(
|
|
||||||
&slice[current_idx..current_idx + PUC_TC_SECONDARY_HEADER_LEN],
|
|
||||||
)
|
|
||||||
.ok_or(ByteConversionError::ZeroCopyFromError)?;
|
|
||||||
current_idx += PUC_TC_SECONDARY_HEADER_LEN;
|
|
||||||
let raw_data = &slice[0..total_len];
|
|
||||||
let pus_tc = Self {
|
|
||||||
sp_header,
|
|
||||||
sec_header: PusTcSecondaryHeader::try_from(sec_header).unwrap(),
|
|
||||||
raw_data: Some(raw_data),
|
|
||||||
app_data: user_data_from_raw(current_idx, total_len, slice)?,
|
|
||||||
calc_crc_on_serialization: false,
|
|
||||||
crc16: Some(crc_from_raw_data(raw_data)?),
|
|
||||||
};
|
|
||||||
verify_crc16_ccitt_false_from_raw_to_pus_error(
|
|
||||||
raw_data,
|
|
||||||
pus_tc.crc16.expect("CRC16 invalid"),
|
|
||||||
)?;
|
|
||||||
Ok((pus_tc, total_len))
|
|
||||||
}
|
|
||||||
|
|
||||||
#[deprecated(since = "0.5.2", note = "use raw_bytes() instead")]
|
|
||||||
pub fn raw(&self) -> Option<&'raw_data [u8]> {
|
|
||||||
self.raw_bytes()
|
|
||||||
}
|
|
||||||
|
|
||||||
/// If [Self] was constructed [Self::from_bytes], this function will return the slice it was
|
|
||||||
/// constructed from. Otherwise, [None] will be returned.
|
|
||||||
pub fn raw_bytes(&self) -> Option<&'raw_data [u8]> {
|
|
||||||
self.raw_data
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
impl WritablePusPacket for PusTc<'_> {
|
|
||||||
fn len_written(&self) -> usize {
|
|
||||||
PUS_TC_MIN_LEN_WITHOUT_APP_DATA + self.app_data.len()
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Write the raw PUS byte representation to a provided buffer.
|
|
||||||
fn write_to_bytes(&self, slice: &mut [u8]) -> Result<usize, PusError> {
|
|
||||||
let mut curr_idx = 0;
|
|
||||||
let tc_header_len = size_of::<zc::PusTcSecondaryHeader>();
|
|
||||||
let total_size = self.len_written();
|
|
||||||
if total_size > slice.len() {
|
|
||||||
return Err(ByteConversionError::ToSliceTooSmall {
|
|
||||||
found: slice.len(),
|
|
||||||
expected: total_size,
|
|
||||||
}
|
|
||||||
.into());
|
|
||||||
}
|
|
||||||
self.sp_header.write_to_be_bytes(slice)?;
|
|
||||||
curr_idx += CCSDS_HEADER_LEN;
|
|
||||||
let sec_header = zc::PusTcSecondaryHeader::try_from(self.sec_header).unwrap();
|
|
||||||
sec_header
|
|
||||||
.write_to_bytes(&mut slice[curr_idx..curr_idx + tc_header_len])
|
|
||||||
.ok_or(ByteConversionError::ZeroCopyToError)?;
|
|
||||||
|
|
||||||
curr_idx += tc_header_len;
|
|
||||||
slice[curr_idx..curr_idx + self.app_data.len()].copy_from_slice(self.app_data);
|
|
||||||
curr_idx += self.app_data.len();
|
|
||||||
let crc16 = crc_procedure(
|
|
||||||
self.calc_crc_on_serialization,
|
|
||||||
&self.crc16,
|
|
||||||
0,
|
|
||||||
curr_idx,
|
|
||||||
slice,
|
|
||||||
)?;
|
|
||||||
slice[curr_idx..curr_idx + 2].copy_from_slice(crc16.to_be_bytes().as_slice());
|
|
||||||
curr_idx += 2;
|
|
||||||
Ok(curr_idx)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
impl PartialEq for PusTc<'_> {
|
|
||||||
fn eq(&self, other: &Self) -> bool {
|
|
||||||
self.sp_header == other.sp_header
|
|
||||||
&& self.sec_header == other.sec_header
|
|
||||||
&& self.app_data == other.app_data
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
impl CcsdsPacket for PusTc<'_> {
|
|
||||||
ccsds_impl!();
|
|
||||||
}
|
|
||||||
|
|
||||||
impl PusPacket for PusTc<'_> {
|
|
||||||
delegate!(to self.sec_header {
|
|
||||||
fn pus_version(&self) -> PusVersion;
|
|
||||||
fn service(&self) -> u8;
|
|
||||||
fn subservice(&self) -> u8;
|
|
||||||
});
|
|
||||||
|
|
||||||
fn user_data(&self) -> &[u8] {
|
|
||||||
self.app_data
|
|
||||||
}
|
|
||||||
|
|
||||||
fn crc16(&self) -> Option<u16> {
|
|
||||||
self.crc16
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
impl GenericPusTcSecondaryHeader for PusTc<'_> {
|
|
||||||
delegate!(to self.sec_header {
|
|
||||||
fn pus_version(&self) -> PusVersion;
|
|
||||||
fn service(&self) -> u8;
|
|
||||||
fn subservice(&self) -> u8;
|
|
||||||
fn source_id(&self) -> u16;
|
|
||||||
fn ack_flags(&self) -> u8;
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
impl IsPusTelecommand for PusTc<'_> {}
|
|
||||||
}
|
|
||||||
|
|
||||||
/// This class can be used to create PUS C telecommand packet. It is the primary data structure to
|
/// This class can be used to create PUS C telecommand packet. It is the primary data structure to
|
||||||
/// generate the raw byte representation of a PUS telecommand.
|
/// generate the raw byte representation of a PUS telecommand.
|
||||||
///
|
///
|
||||||
@ -548,6 +222,7 @@ pub mod legacy_tc {
|
|||||||
/// There is no spare bytes support yet.
|
/// There is no spare bytes support yet.
|
||||||
#[derive(Copy, Clone, Debug, PartialEq, Eq)]
|
#[derive(Copy, Clone, Debug, PartialEq, Eq)]
|
||||||
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
||||||
|
#[cfg_attr(feature = "defmt", derive(defmt::Format))]
|
||||||
pub struct PusTcCreator<'raw_data> {
|
pub struct PusTcCreator<'raw_data> {
|
||||||
sp_header: SpHeader,
|
sp_header: SpHeader,
|
||||||
pub sec_header: PusTcSecondaryHeader,
|
pub sec_header: PusTcSecondaryHeader,
|
||||||
@ -565,7 +240,7 @@ impl<'raw_data> PusTcCreator<'raw_data> {
|
|||||||
/// and subservice type
|
/// and subservice type
|
||||||
/// * `app_data` - Custom application data
|
/// * `app_data` - Custom application data
|
||||||
/// * `set_ccsds_len` - Can be used to automatically update the CCSDS space packet data length
|
/// * `set_ccsds_len` - Can be used to automatically update the CCSDS space packet data length
|
||||||
/// field. If this is not set to true, [PusTc::update_ccsds_data_len] can be called to set
|
/// field. If this is not set to true, [Self::update_ccsds_data_len] can be called to set
|
||||||
/// the correct value to this field manually
|
/// the correct value to this field manually
|
||||||
pub fn new(
|
pub fn new(
|
||||||
sp_header: &mut SpHeader,
|
sp_header: &mut SpHeader,
|
||||||
@ -586,7 +261,7 @@ impl<'raw_data> PusTcCreator<'raw_data> {
|
|||||||
pus_tc
|
pus_tc
|
||||||
}
|
}
|
||||||
|
|
||||||
/// Simplified version of the [PusTcCreator::new] function which allows to only specify service
|
/// Simplified version of the [Self::new] function which allows to only specify service
|
||||||
/// and subservice instead of the full PUS TC secondary header.
|
/// and subservice instead of the full PUS TC secondary header.
|
||||||
pub fn new_simple(
|
pub fn new_simple(
|
||||||
sph: &mut SpHeader,
|
sph: &mut SpHeader,
|
||||||
@ -630,7 +305,7 @@ impl<'raw_data> PusTcCreator<'raw_data> {
|
|||||||
sp_header_impls!();
|
sp_header_impls!();
|
||||||
|
|
||||||
/// Calculate the CCSDS space packet data length field and sets it
|
/// Calculate the CCSDS space packet data length field and sets it
|
||||||
/// This is called automatically if the `set_ccsds_len` argument in the [PusTc::new] call was
|
/// This is called automatically if the `set_ccsds_len` argument in the [Self::new] call was
|
||||||
/// used.
|
/// used.
|
||||||
/// If this was not done or the application data is set or changed after construction,
|
/// If this was not done or the application data is set or changed after construction,
|
||||||
/// this function needs to be called to ensure that the data length field of the CCSDS header
|
/// this function needs to be called to ensure that the data length field of the CCSDS header
|
||||||
@ -640,8 +315,7 @@ impl<'raw_data> PusTcCreator<'raw_data> {
|
|||||||
self.len_written() as u16 - size_of::<crate::zc::SpHeader>() as u16 - 1;
|
self.len_written() as u16 - size_of::<crate::zc::SpHeader>() as u16 - 1;
|
||||||
}
|
}
|
||||||
|
|
||||||
/// This function should be called before the TC packet is serialized if
|
/// This function calculates and returns the CRC16 for the current packet.
|
||||||
/// [PusTc::calc_crc_on_serialization] is set to False. It will calculate and cache the CRC16.
|
|
||||||
pub fn calc_own_crc16(&self) -> u16 {
|
pub fn calc_own_crc16(&self) -> u16 {
|
||||||
let mut digest = CRC_CCITT_FALSE.digest();
|
let mut digest = CRC_CCITT_FALSE.digest();
|
||||||
let sph_zc = crate::zc::SpHeader::from(self.sp_header);
|
let sph_zc = crate::zc::SpHeader::from(self.sp_header);
|
||||||
@ -750,6 +424,7 @@ impl IsPusTelecommand for PusTcCreator<'_> {}
|
|||||||
/// * `'raw_data` - Lifetime of the provided raw slice.
|
/// * `'raw_data` - Lifetime of the provided raw slice.
|
||||||
#[derive(Eq, Copy, Clone, Debug)]
|
#[derive(Eq, Copy, Clone, Debug)]
|
||||||
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
||||||
|
#[cfg_attr(feature = "defmt", derive(defmt::Format))]
|
||||||
pub struct PusTcReader<'raw_data> {
|
pub struct PusTcReader<'raw_data> {
|
||||||
#[cfg_attr(feature = "serde", serde(skip))]
|
#[cfg_attr(feature = "serde", serde(skip))]
|
||||||
raw_data: &'raw_data [u8],
|
raw_data: &'raw_data [u8],
|
||||||
|
377
src/ecss/tm.rs
377
src/ecss/tm.rs
@ -19,7 +19,6 @@ use alloc::vec::Vec;
|
|||||||
use delegate::delegate;
|
use delegate::delegate;
|
||||||
|
|
||||||
use crate::time::{TimeWriter, TimestampError};
|
use crate::time::{TimeWriter, TimestampError};
|
||||||
pub use legacy_tm::*;
|
|
||||||
|
|
||||||
use self::zc::PusTmSecHeaderWithoutTimestamp;
|
use self::zc::PusTmSecHeaderWithoutTimestamp;
|
||||||
|
|
||||||
@ -116,6 +115,7 @@ pub mod zc {
|
|||||||
|
|
||||||
#[derive(PartialEq, Eq, Copy, Clone, Debug)]
|
#[derive(PartialEq, Eq, Copy, Clone, Debug)]
|
||||||
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
||||||
|
#[cfg_attr(feature = "defmt", derive(defmt::Format))]
|
||||||
pub struct PusTmSecondaryHeader<'stamp> {
|
pub struct PusTmSecondaryHeader<'stamp> {
|
||||||
pus_version: PusVersion,
|
pus_version: PusVersion,
|
||||||
pub sc_time_ref_status: u8,
|
pub sc_time_ref_status: u8,
|
||||||
@ -197,334 +197,6 @@ impl<'slice> TryFrom<zc::PusTmSecHeader<'slice>> for PusTmSecondaryHeader<'slice
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
pub mod legacy_tm {
|
|
||||||
use crate::ecss::tm::{
|
|
||||||
zc, GenericPusTmSecondaryHeader, IsPusTelemetry, PusTmSecondaryHeader,
|
|
||||||
PUS_TM_MIN_LEN_WITHOUT_SOURCE_DATA, PUS_TM_MIN_SEC_HEADER_LEN,
|
|
||||||
};
|
|
||||||
use crate::ecss::PusVersion;
|
|
||||||
use crate::ecss::{
|
|
||||||
ccsds_impl, crc_from_raw_data, crc_procedure, sp_header_impls, user_data_from_raw,
|
|
||||||
verify_crc16_ccitt_false_from_raw_to_pus_error, PusError, PusPacket, WritablePusPacket,
|
|
||||||
CCSDS_HEADER_LEN,
|
|
||||||
};
|
|
||||||
use crate::SequenceFlags;
|
|
||||||
use crate::{ByteConversionError, CcsdsPacket, PacketType, SpHeader, CRC_CCITT_FALSE};
|
|
||||||
use core::mem::size_of;
|
|
||||||
use zerocopy::AsBytes;
|
|
||||||
|
|
||||||
#[cfg(feature = "serde")]
|
|
||||||
use serde::{Deserialize, Serialize};
|
|
||||||
|
|
||||||
#[cfg(feature = "alloc")]
|
|
||||||
use alloc::vec::Vec;
|
|
||||||
use delegate::delegate;
|
|
||||||
|
|
||||||
/// This class models the PUS C telemetry packet. It is the primary data structure to generate the
|
|
||||||
/// raw byte representation of PUS telemetry or to deserialize from one from raw bytes.
|
|
||||||
///
|
|
||||||
/// This class also derives the [serde::Serialize] and [serde::Deserialize] trait if the [serde]
|
|
||||||
/// feature is used which allows to send around TM packets in a raw byte format using a serde
|
|
||||||
/// provider like [postcard](https://docs.rs/postcard/latest/postcard/).
|
|
||||||
///
|
|
||||||
/// There is no spare bytes support yet.
|
|
||||||
///
|
|
||||||
/// # Lifetimes
|
|
||||||
///
|
|
||||||
/// * `'raw_data` - If the TM is not constructed from a raw slice, this will be the life time of
|
|
||||||
/// a buffer where the user provided time stamp and source data will be serialized into. If it
|
|
||||||
/// is, this is the lifetime of the raw byte slice it is constructed from.
|
|
||||||
#[derive(Eq, Debug, Copy, Clone)]
|
|
||||||
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
|
||||||
pub struct PusTm<'raw_data> {
|
|
||||||
pub sp_header: SpHeader,
|
|
||||||
pub sec_header: PusTmSecondaryHeader<'raw_data>,
|
|
||||||
/// If this is set to false, a manual call to [PusTm::calc_own_crc16] or
|
|
||||||
/// [PusTm::update_packet_fields] is necessary for the serialized or cached CRC16 to be valid.
|
|
||||||
pub calc_crc_on_serialization: bool,
|
|
||||||
#[cfg_attr(feature = "serde", serde(skip))]
|
|
||||||
raw_data: Option<&'raw_data [u8]>,
|
|
||||||
source_data: &'raw_data [u8],
|
|
||||||
crc16: Option<u16>,
|
|
||||||
}
|
|
||||||
|
|
||||||
impl<'raw_data> PusTm<'raw_data> {
|
|
||||||
/// Generates a new struct instance.
|
|
||||||
///
|
|
||||||
/// # Arguments
|
|
||||||
///
|
|
||||||
/// * `sp_header` - Space packet header information. The correct packet type will be set
|
|
||||||
/// automatically
|
|
||||||
/// * `sec_header` - Information contained in the secondary header, including the service
|
|
||||||
/// and subservice type
|
|
||||||
/// * `app_data` - Custom application data
|
|
||||||
/// * `set_ccsds_len` - Can be used to automatically update the CCSDS space packet data length
|
|
||||||
/// field. If this is not set to true, [PusTm::update_ccsds_data_len] can be called to set
|
|
||||||
/// the correct value to this field manually
|
|
||||||
#[deprecated(
|
|
||||||
since = "0.7.0",
|
|
||||||
note = "Use specialized PusTmCreator or PusTmReader classes instead"
|
|
||||||
)]
|
|
||||||
pub fn new(
|
|
||||||
sp_header: &mut SpHeader,
|
|
||||||
sec_header: PusTmSecondaryHeader<'raw_data>,
|
|
||||||
source_data: Option<&'raw_data [u8]>,
|
|
||||||
set_ccsds_len: bool,
|
|
||||||
) -> Self {
|
|
||||||
sp_header.set_packet_type(PacketType::Tm);
|
|
||||||
sp_header.set_sec_header_flag();
|
|
||||||
let mut pus_tm = PusTm {
|
|
||||||
sp_header: *sp_header,
|
|
||||||
raw_data: None,
|
|
||||||
source_data: source_data.unwrap_or(&[]),
|
|
||||||
sec_header,
|
|
||||||
calc_crc_on_serialization: true,
|
|
||||||
crc16: None,
|
|
||||||
};
|
|
||||||
if set_ccsds_len {
|
|
||||||
pus_tm.update_ccsds_data_len();
|
|
||||||
}
|
|
||||||
pus_tm
|
|
||||||
}
|
|
||||||
|
|
||||||
pub fn timestamp(&self) -> &[u8] {
|
|
||||||
self.sec_header.timestamp
|
|
||||||
}
|
|
||||||
|
|
||||||
pub fn source_data(&self) -> &[u8] {
|
|
||||||
self.source_data
|
|
||||||
}
|
|
||||||
|
|
||||||
pub fn set_dest_id(&mut self, dest_id: u16) {
|
|
||||||
self.sec_header.dest_id = dest_id;
|
|
||||||
}
|
|
||||||
|
|
||||||
pub fn set_msg_counter(&mut self, msg_counter: u16) {
|
|
||||||
self.sec_header.msg_counter = msg_counter
|
|
||||||
}
|
|
||||||
|
|
||||||
pub fn set_sc_time_ref_status(&mut self, sc_time_ref_status: u8) {
|
|
||||||
self.sec_header.sc_time_ref_status = sc_time_ref_status & 0b1111;
|
|
||||||
}
|
|
||||||
|
|
||||||
sp_header_impls!();
|
|
||||||
|
|
||||||
/// This is called automatically if the `set_ccsds_len` argument in the [PusTm::new] call was
|
|
||||||
/// used.
|
|
||||||
/// If this was not done or the time stamp or source data is set or changed after construction,
|
|
||||||
/// this function needs to be called to ensure that the data length field of the CCSDS header
|
|
||||||
/// is set correctly
|
|
||||||
pub fn update_ccsds_data_len(&mut self) {
|
|
||||||
self.sp_header.data_len =
|
|
||||||
self.len_written() as u16 - size_of::<crate::zc::SpHeader>() as u16 - 1;
|
|
||||||
}
|
|
||||||
|
|
||||||
/// This function should be called before the TM packet is serialized if
|
|
||||||
/// [PusTm.calc_crc_on_serialization] is set to False. It will calculate and cache the CRC16.
|
|
||||||
pub fn calc_own_crc16(&mut self) {
|
|
||||||
let mut digest = CRC_CCITT_FALSE.digest();
|
|
||||||
let sph_zc = crate::zc::SpHeader::from(self.sp_header);
|
|
||||||
digest.update(sph_zc.as_bytes());
|
|
||||||
let pus_tc_header =
|
|
||||||
zc::PusTmSecHeaderWithoutTimestamp::try_from(self.sec_header).unwrap();
|
|
||||||
digest.update(pus_tc_header.as_bytes());
|
|
||||||
digest.update(self.sec_header.timestamp);
|
|
||||||
digest.update(self.source_data);
|
|
||||||
self.crc16 = Some(digest.finalize())
|
|
||||||
}
|
|
||||||
|
|
||||||
/// This helper function calls both [PusTm.update_ccsds_data_len] and [PusTm.calc_own_crc16]
|
|
||||||
pub fn update_packet_fields(&mut self) {
|
|
||||||
self.update_ccsds_data_len();
|
|
||||||
self.calc_own_crc16();
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Append the raw PUS byte representation to a provided [alloc::vec::Vec]
|
|
||||||
#[cfg(feature = "alloc")]
|
|
||||||
pub fn append_to_vec(&self, vec: &mut Vec<u8>) -> Result<usize, PusError> {
|
|
||||||
let sph_zc = crate::zc::SpHeader::from(self.sp_header);
|
|
||||||
let mut appended_len = PUS_TM_MIN_LEN_WITHOUT_SOURCE_DATA;
|
|
||||||
appended_len += self.sec_header.timestamp.len();
|
|
||||||
appended_len += self.source_data.len();
|
|
||||||
let start_idx = vec.len();
|
|
||||||
let mut ser_len = 0;
|
|
||||||
vec.extend_from_slice(sph_zc.as_bytes());
|
|
||||||
ser_len += sph_zc.as_bytes().len();
|
|
||||||
// The PUS version is hardcoded to PUS C
|
|
||||||
let sec_header = zc::PusTmSecHeaderWithoutTimestamp::try_from(self.sec_header).unwrap();
|
|
||||||
vec.extend_from_slice(sec_header.as_bytes());
|
|
||||||
ser_len += sec_header.as_bytes().len();
|
|
||||||
ser_len += self.sec_header.timestamp.len();
|
|
||||||
vec.extend_from_slice(self.sec_header.timestamp);
|
|
||||||
vec.extend_from_slice(self.source_data);
|
|
||||||
ser_len += self.source_data.len();
|
|
||||||
let crc16 = crc_procedure(
|
|
||||||
self.calc_crc_on_serialization,
|
|
||||||
&self.crc16,
|
|
||||||
start_idx,
|
|
||||||
ser_len,
|
|
||||||
&vec[start_idx..start_idx + ser_len],
|
|
||||||
)?;
|
|
||||||
vec.extend_from_slice(crc16.to_be_bytes().as_slice());
|
|
||||||
Ok(appended_len)
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Create a [PusTm] instance from a raw slice. On success, it returns a tuple containing
|
|
||||||
/// the instance and the found byte length of the packet. The timestamp length needs to be
|
|
||||||
/// known beforehand.
|
|
||||||
#[deprecated(
|
|
||||||
since = "0.7.0",
|
|
||||||
note = "Use specialized PusTmCreator or PusTmReader classes instead"
|
|
||||||
)]
|
|
||||||
pub fn from_bytes(
|
|
||||||
slice: &'raw_data [u8],
|
|
||||||
timestamp_len: usize,
|
|
||||||
) -> Result<(Self, usize), PusError> {
|
|
||||||
let raw_data_len = slice.len();
|
|
||||||
if raw_data_len < PUS_TM_MIN_LEN_WITHOUT_SOURCE_DATA {
|
|
||||||
return Err(ByteConversionError::FromSliceTooSmall {
|
|
||||||
found: raw_data_len,
|
|
||||||
expected: PUS_TM_MIN_LEN_WITHOUT_SOURCE_DATA,
|
|
||||||
}
|
|
||||||
.into());
|
|
||||||
}
|
|
||||||
let mut current_idx = 0;
|
|
||||||
let (sp_header, _) = SpHeader::from_be_bytes(&slice[0..CCSDS_HEADER_LEN])?;
|
|
||||||
current_idx += 6;
|
|
||||||
let total_len = sp_header.total_len();
|
|
||||||
if raw_data_len < total_len {
|
|
||||||
return Err(ByteConversionError::FromSliceTooSmall {
|
|
||||||
found: raw_data_len,
|
|
||||||
expected: PUS_TM_MIN_LEN_WITHOUT_SOURCE_DATA,
|
|
||||||
}
|
|
||||||
.into());
|
|
||||||
}
|
|
||||||
if total_len < PUS_TM_MIN_LEN_WITHOUT_SOURCE_DATA {
|
|
||||||
return Err(ByteConversionError::FromSliceTooSmall {
|
|
||||||
found: total_len,
|
|
||||||
expected: PUS_TM_MIN_LEN_WITHOUT_SOURCE_DATA,
|
|
||||||
}
|
|
||||||
.into());
|
|
||||||
}
|
|
||||||
let sec_header_zc = zc::PusTmSecHeaderWithoutTimestamp::from_bytes(
|
|
||||||
&slice[current_idx..current_idx + PUS_TM_MIN_SEC_HEADER_LEN],
|
|
||||||
)
|
|
||||||
.ok_or(ByteConversionError::ZeroCopyFromError)?;
|
|
||||||
current_idx += PUS_TM_MIN_SEC_HEADER_LEN;
|
|
||||||
let zc_sec_header_wrapper = zc::PusTmSecHeader {
|
|
||||||
zc_header: sec_header_zc,
|
|
||||||
timestamp: &slice[current_idx..current_idx + timestamp_len],
|
|
||||||
};
|
|
||||||
current_idx += timestamp_len;
|
|
||||||
let raw_data = &slice[0..total_len];
|
|
||||||
let pus_tm = PusTm {
|
|
||||||
sp_header,
|
|
||||||
sec_header: PusTmSecondaryHeader::try_from(zc_sec_header_wrapper).unwrap(),
|
|
||||||
raw_data: Some(&slice[0..total_len]),
|
|
||||||
source_data: user_data_from_raw(current_idx, total_len, slice)?,
|
|
||||||
calc_crc_on_serialization: false,
|
|
||||||
crc16: Some(crc_from_raw_data(raw_data)?),
|
|
||||||
};
|
|
||||||
verify_crc16_ccitt_false_from_raw_to_pus_error(
|
|
||||||
raw_data,
|
|
||||||
pus_tm.crc16.expect("CRC16 invalid"),
|
|
||||||
)?;
|
|
||||||
Ok((pus_tm, total_len))
|
|
||||||
}
|
|
||||||
|
|
||||||
/// If [Self] was constructed [Self::from_bytes], this function will return the slice it was
|
|
||||||
/// constructed from. Otherwise, [None] will be returned.
|
|
||||||
pub fn raw_bytes(&self) -> Option<&'raw_data [u8]> {
|
|
||||||
self.raw_data
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
impl WritablePusPacket for PusTm<'_> {
|
|
||||||
fn len_written(&self) -> usize {
|
|
||||||
PUS_TM_MIN_LEN_WITHOUT_SOURCE_DATA
|
|
||||||
+ self.sec_header.timestamp.len()
|
|
||||||
+ self.source_data.len()
|
|
||||||
}
|
|
||||||
/// Write the raw PUS byte representation to a provided buffer.
|
|
||||||
fn write_to_bytes(&self, slice: &mut [u8]) -> Result<usize, PusError> {
|
|
||||||
let mut curr_idx = 0;
|
|
||||||
let total_size = self.len_written();
|
|
||||||
if total_size > slice.len() {
|
|
||||||
return Err(ByteConversionError::ToSliceTooSmall {
|
|
||||||
found: slice.len(),
|
|
||||||
expected: total_size,
|
|
||||||
}
|
|
||||||
.into());
|
|
||||||
}
|
|
||||||
self.sp_header
|
|
||||||
.write_to_be_bytes(&mut slice[0..CCSDS_HEADER_LEN])?;
|
|
||||||
curr_idx += CCSDS_HEADER_LEN;
|
|
||||||
let sec_header_len = size_of::<zc::PusTmSecHeaderWithoutTimestamp>();
|
|
||||||
let sec_header = zc::PusTmSecHeaderWithoutTimestamp::try_from(self.sec_header).unwrap();
|
|
||||||
sec_header
|
|
||||||
.write_to_bytes(&mut slice[curr_idx..curr_idx + sec_header_len])
|
|
||||||
.ok_or(ByteConversionError::ZeroCopyToError)?;
|
|
||||||
curr_idx += sec_header_len;
|
|
||||||
slice[curr_idx..curr_idx + self.sec_header.timestamp.len()]
|
|
||||||
.copy_from_slice(self.sec_header.timestamp);
|
|
||||||
curr_idx += self.sec_header.timestamp.len();
|
|
||||||
slice[curr_idx..curr_idx + self.source_data.len()].copy_from_slice(self.source_data);
|
|
||||||
curr_idx += self.source_data.len();
|
|
||||||
let crc16 = crc_procedure(
|
|
||||||
self.calc_crc_on_serialization,
|
|
||||||
&self.crc16,
|
|
||||||
0,
|
|
||||||
curr_idx,
|
|
||||||
slice,
|
|
||||||
)?;
|
|
||||||
slice[curr_idx..curr_idx + 2].copy_from_slice(crc16.to_be_bytes().as_slice());
|
|
||||||
curr_idx += 2;
|
|
||||||
Ok(curr_idx)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
impl PartialEq for PusTm<'_> {
|
|
||||||
fn eq(&self, other: &Self) -> bool {
|
|
||||||
self.sp_header == other.sp_header
|
|
||||||
&& self.sec_header == other.sec_header
|
|
||||||
&& self.source_data == other.source_data
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
impl CcsdsPacket for PusTm<'_> {
|
|
||||||
ccsds_impl!();
|
|
||||||
}
|
|
||||||
|
|
||||||
impl PusPacket for PusTm<'_> {
|
|
||||||
delegate!(to self.sec_header {
|
|
||||||
fn pus_version(&self) -> PusVersion;
|
|
||||||
fn service(&self) -> u8;
|
|
||||||
fn subservice(&self) -> u8;
|
|
||||||
});
|
|
||||||
|
|
||||||
fn user_data(&self) -> &[u8] {
|
|
||||||
self.source_data
|
|
||||||
}
|
|
||||||
|
|
||||||
fn crc16(&self) -> Option<u16> {
|
|
||||||
self.crc16
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
impl GenericPusTmSecondaryHeader for PusTm<'_> {
|
|
||||||
delegate!(to self.sec_header {
|
|
||||||
fn pus_version(&self) -> PusVersion;
|
|
||||||
fn service(&self) -> u8;
|
|
||||||
fn subservice(&self) -> u8;
|
|
||||||
fn dest_id(&self) -> u16;
|
|
||||||
fn msg_counter(&self) -> u16;
|
|
||||||
fn sc_time_ref_status(&self) -> u8;
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
impl IsPusTelemetry for PusTm<'_> {}
|
|
||||||
}
|
|
||||||
|
|
||||||
/// This class models the PUS C telemetry packet. It is the primary data structure to generate the
|
/// This class models the PUS C telemetry packet. It is the primary data structure to generate the
|
||||||
/// raw byte representation of PUS telemetry.
|
/// raw byte representation of PUS telemetry.
|
||||||
///
|
///
|
||||||
@ -539,16 +211,18 @@ pub mod legacy_tm {
|
|||||||
/// * `'raw_data` - This is the lifetime of the user provided time stamp and source data.
|
/// * `'raw_data` - This is the lifetime of the user provided time stamp and source data.
|
||||||
#[derive(Eq, Debug, Copy, Clone)]
|
#[derive(Eq, Debug, Copy, Clone)]
|
||||||
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
||||||
pub struct PusTmCreator<'raw_data> {
|
#[cfg_attr(feature = "defmt", derive(defmt::Format))]
|
||||||
|
pub struct PusTmCreator<'time, 'raw_data> {
|
||||||
pub sp_header: SpHeader,
|
pub sp_header: SpHeader,
|
||||||
pub sec_header: PusTmSecondaryHeader<'raw_data>,
|
#[cfg_attr(feature="serde", serde(borrow))]
|
||||||
|
pub sec_header: PusTmSecondaryHeader<'time>,
|
||||||
source_data: &'raw_data [u8],
|
source_data: &'raw_data [u8],
|
||||||
/// If this is set to false, a manual call to [PusTm::calc_own_crc16] or
|
/// If this is set to false, a manual call to [Self::calc_own_crc16] or
|
||||||
/// [PusTm::update_packet_fields] is necessary for the serialized or cached CRC16 to be valid.
|
/// [Self::update_packet_fields] is necessary for the serialized or cached CRC16 to be valid.
|
||||||
pub calc_crc_on_serialization: bool,
|
pub calc_crc_on_serialization: bool,
|
||||||
}
|
}
|
||||||
|
|
||||||
impl<'raw_data> PusTmCreator<'raw_data> {
|
impl<'time, 'raw_data> PusTmCreator<'time, 'raw_data> {
|
||||||
/// Generates a new struct instance.
|
/// Generates a new struct instance.
|
||||||
///
|
///
|
||||||
/// # Arguments
|
/// # Arguments
|
||||||
@ -559,11 +233,11 @@ impl<'raw_data> PusTmCreator<'raw_data> {
|
|||||||
/// and subservice type
|
/// and subservice type
|
||||||
/// * `source_data` - Custom application data
|
/// * `source_data` - Custom application data
|
||||||
/// * `set_ccsds_len` - Can be used to automatically update the CCSDS space packet data length
|
/// * `set_ccsds_len` - Can be used to automatically update the CCSDS space packet data length
|
||||||
/// field. If this is not set to true, [PusTm::update_ccsds_data_len] can be called to set
|
/// field. If this is not set to true, [Self::update_ccsds_data_len] can be called to set
|
||||||
/// the correct value to this field manually
|
/// the correct value to this field manually
|
||||||
pub fn new(
|
pub fn new(
|
||||||
sp_header: &mut SpHeader,
|
sp_header: &mut SpHeader,
|
||||||
sec_header: PusTmSecondaryHeader<'raw_data>,
|
sec_header: PusTmSecondaryHeader<'time>,
|
||||||
source_data: &'raw_data [u8],
|
source_data: &'raw_data [u8],
|
||||||
set_ccsds_len: bool,
|
set_ccsds_len: bool,
|
||||||
) -> Self {
|
) -> Self {
|
||||||
@ -586,7 +260,7 @@ impl<'raw_data> PusTmCreator<'raw_data> {
|
|||||||
service: u8,
|
service: u8,
|
||||||
subservice: u8,
|
subservice: u8,
|
||||||
time_provider: &impl TimeWriter,
|
time_provider: &impl TimeWriter,
|
||||||
stamp_buf: &'raw_data mut [u8],
|
stamp_buf: &'time mut [u8],
|
||||||
source_data: Option<&'raw_data [u8]>,
|
source_data: Option<&'raw_data [u8]>,
|
||||||
set_ccsds_len: bool,
|
set_ccsds_len: bool,
|
||||||
) -> Result<Self, TimestampError> {
|
) -> Result<Self, TimestampError> {
|
||||||
@ -603,7 +277,7 @@ impl<'raw_data> PusTmCreator<'raw_data> {
|
|||||||
|
|
||||||
pub fn new_no_source_data(
|
pub fn new_no_source_data(
|
||||||
sp_header: &mut SpHeader,
|
sp_header: &mut SpHeader,
|
||||||
sec_header: PusTmSecondaryHeader<'raw_data>,
|
sec_header: PusTmSecondaryHeader<'time>,
|
||||||
set_ccsds_len: bool,
|
set_ccsds_len: bool,
|
||||||
) -> Self {
|
) -> Self {
|
||||||
Self::new(sp_header, sec_header, &[], set_ccsds_len)
|
Self::new(sp_header, sec_header, &[], set_ccsds_len)
|
||||||
@ -631,7 +305,7 @@ impl<'raw_data> PusTmCreator<'raw_data> {
|
|||||||
|
|
||||||
sp_header_impls!();
|
sp_header_impls!();
|
||||||
|
|
||||||
/// This is called automatically if the `set_ccsds_len` argument in the [PusTm::new] call was
|
/// This is called automatically if the `set_ccsds_len` argument in the [Self::new] call was
|
||||||
/// used.
|
/// used.
|
||||||
/// If this was not done or the time stamp or source data is set or changed after construction,
|
/// If this was not done or the time stamp or source data is set or changed after construction,
|
||||||
/// this function needs to be called to ensure that the data length field of the CCSDS header
|
/// this function needs to be called to ensure that the data length field of the CCSDS header
|
||||||
@ -642,7 +316,7 @@ impl<'raw_data> PusTmCreator<'raw_data> {
|
|||||||
}
|
}
|
||||||
|
|
||||||
/// This function should be called before the TM packet is serialized if
|
/// This function should be called before the TM packet is serialized if
|
||||||
/// [PusTm.calc_crc_on_serialization] is set to False. It will calculate and cache the CRC16.
|
/// [Self::calc_crc_on_serialization] is set to False. It will calculate and cache the CRC16.
|
||||||
pub fn calc_own_crc16(&self) -> u16 {
|
pub fn calc_own_crc16(&self) -> u16 {
|
||||||
let mut digest = CRC_CCITT_FALSE.digest();
|
let mut digest = CRC_CCITT_FALSE.digest();
|
||||||
let sph_zc = crate::zc::SpHeader::from(self.sp_header);
|
let sph_zc = crate::zc::SpHeader::from(self.sp_header);
|
||||||
@ -654,7 +328,7 @@ impl<'raw_data> PusTmCreator<'raw_data> {
|
|||||||
digest.finalize()
|
digest.finalize()
|
||||||
}
|
}
|
||||||
|
|
||||||
/// This helper function calls both [PusTm.update_ccsds_data_len] and [PusTm.calc_own_crc16]
|
/// This helper function calls both [Self::update_ccsds_data_len] and [Self::calc_own_crc16]
|
||||||
pub fn update_packet_fields(&mut self) {
|
pub fn update_packet_fields(&mut self) {
|
||||||
self.update_ccsds_data_len();
|
self.update_ccsds_data_len();
|
||||||
}
|
}
|
||||||
@ -710,7 +384,7 @@ impl<'raw_data> PusTmCreator<'raw_data> {
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
impl WritablePusPacket for PusTmCreator<'_> {
|
impl WritablePusPacket for PusTmCreator<'_, '_> {
|
||||||
fn len_written(&self) -> usize {
|
fn len_written(&self) -> usize {
|
||||||
PUS_TM_MIN_LEN_WITHOUT_SOURCE_DATA
|
PUS_TM_MIN_LEN_WITHOUT_SOURCE_DATA
|
||||||
+ self.sec_header.timestamp.len()
|
+ self.sec_header.timestamp.len()
|
||||||
@ -722,7 +396,7 @@ impl WritablePusPacket for PusTmCreator<'_> {
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
impl PartialEq for PusTmCreator<'_> {
|
impl PartialEq for PusTmCreator<'_, '_> {
|
||||||
fn eq(&self, other: &Self) -> bool {
|
fn eq(&self, other: &Self) -> bool {
|
||||||
self.sp_header == other.sp_header
|
self.sp_header == other.sp_header
|
||||||
&& self.sec_header == other.sec_header
|
&& self.sec_header == other.sec_header
|
||||||
@ -730,11 +404,11 @@ impl PartialEq for PusTmCreator<'_> {
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
impl CcsdsPacket for PusTmCreator<'_> {
|
impl CcsdsPacket for PusTmCreator<'_, '_> {
|
||||||
ccsds_impl!();
|
ccsds_impl!();
|
||||||
}
|
}
|
||||||
|
|
||||||
impl PusPacket for PusTmCreator<'_> {
|
impl PusPacket for PusTmCreator<'_, '_> {
|
||||||
delegate!(to self.sec_header {
|
delegate!(to self.sec_header {
|
||||||
fn pus_version(&self) -> PusVersion;
|
fn pus_version(&self) -> PusVersion;
|
||||||
fn service(&self) -> u8;
|
fn service(&self) -> u8;
|
||||||
@ -750,7 +424,7 @@ impl PusPacket for PusTmCreator<'_> {
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
impl GenericPusTmSecondaryHeader for PusTmCreator<'_> {
|
impl GenericPusTmSecondaryHeader for PusTmCreator<'_, '_> {
|
||||||
delegate!(to self.sec_header {
|
delegate!(to self.sec_header {
|
||||||
fn pus_version(&self) -> PusVersion;
|
fn pus_version(&self) -> PusVersion;
|
||||||
fn service(&self) -> u8;
|
fn service(&self) -> u8;
|
||||||
@ -761,7 +435,7 @@ impl GenericPusTmSecondaryHeader for PusTmCreator<'_> {
|
|||||||
});
|
});
|
||||||
}
|
}
|
||||||
|
|
||||||
impl IsPusTelemetry for PusTmCreator<'_> {}
|
impl IsPusTelemetry for PusTmCreator<'_, '_> {}
|
||||||
|
|
||||||
/// This class models the PUS C telemetry packet. It is the primary data structure to read
|
/// This class models the PUS C telemetry packet. It is the primary data structure to read
|
||||||
/// a telemetry packet from raw bytes.
|
/// a telemetry packet from raw bytes.
|
||||||
@ -777,6 +451,7 @@ impl IsPusTelemetry for PusTmCreator<'_> {}
|
|||||||
/// * `'raw_data` - Lifetime of the raw slice this class is constructed from.
|
/// * `'raw_data` - Lifetime of the raw slice this class is constructed from.
|
||||||
#[derive(Eq, Debug, Copy, Clone)]
|
#[derive(Eq, Debug, Copy, Clone)]
|
||||||
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
||||||
|
#[cfg_attr(feature = "defmt", derive(defmt::Format))]
|
||||||
pub struct PusTmReader<'raw_data> {
|
pub struct PusTmReader<'raw_data> {
|
||||||
pub sp_header: SpHeader,
|
pub sp_header: SpHeader,
|
||||||
pub sec_header: PusTmSecondaryHeader<'raw_data>,
|
pub sec_header: PusTmSecondaryHeader<'raw_data>,
|
||||||
@ -902,15 +577,15 @@ impl GenericPusTmSecondaryHeader for PusTmReader<'_> {
|
|||||||
|
|
||||||
impl IsPusTelemetry for PusTmReader<'_> {}
|
impl IsPusTelemetry for PusTmReader<'_> {}
|
||||||
|
|
||||||
impl PartialEq<PusTmCreator<'_>> for PusTmReader<'_> {
|
impl PartialEq<PusTmCreator<'_, '_>> for PusTmReader<'_> {
|
||||||
fn eq(&self, other: &PusTmCreator<'_>) -> bool {
|
fn eq(&self, other: &PusTmCreator<'_, '_>) -> bool {
|
||||||
self.sp_header == other.sp_header
|
self.sp_header == other.sp_header
|
||||||
&& self.sec_header == other.sec_header
|
&& self.sec_header == other.sec_header
|
||||||
&& self.source_data == other.source_data
|
&& self.source_data == other.source_data
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
impl PartialEq<PusTmReader<'_>> for PusTmCreator<'_> {
|
impl PartialEq<PusTmReader<'_>> for PusTmCreator<'_, '_> {
|
||||||
fn eq(&self, other: &PusTmReader<'_>) -> bool {
|
fn eq(&self, other: &PusTmReader<'_>) -> bool {
|
||||||
self.sp_header == other.sp_header
|
self.sp_header == other.sp_header
|
||||||
&& self.sec_header == other.sec_header
|
&& self.sec_header == other.sec_header
|
||||||
@ -1122,7 +797,7 @@ mod tests {
|
|||||||
PusTmCreator::new(&mut sph, tm_header, DUMMY_DATA, true)
|
PusTmCreator::new(&mut sph, tm_header, DUMMY_DATA, true)
|
||||||
}
|
}
|
||||||
|
|
||||||
fn base_hk_reply<'a>(timestamp: &'a [u8], src_data: &'a [u8]) -> PusTmCreator<'a> {
|
fn base_hk_reply<'a, 'b>(timestamp: &'a [u8], src_data: &'b [u8]) -> PusTmCreator<'a, 'b> {
|
||||||
let mut sph = SpHeader::tm_unseg(0x123, 0x234, 0).unwrap();
|
let mut sph = SpHeader::tm_unseg(0x123, 0x234, 0).unwrap();
|
||||||
let tc_header = PusTmSecondaryHeader::new_simple(3, 5, timestamp);
|
let tc_header = PusTmSecondaryHeader::new_simple(3, 5, timestamp);
|
||||||
PusTmCreator::new(&mut sph, tc_header, src_data, true)
|
PusTmCreator::new(&mut sph, tc_header, src_data, true)
|
||||||
|
10
src/lib.rs
10
src/lib.rs
@ -93,6 +93,7 @@ pub const MAX_SEQ_COUNT: u16 = 2u16.pow(14) - 1;
|
|||||||
/// Generic error type when converting to and from raw byte slices.
|
/// Generic error type when converting to and from raw byte slices.
|
||||||
#[derive(Debug, Copy, Clone, PartialEq, Eq)]
|
#[derive(Debug, Copy, Clone, PartialEq, Eq)]
|
||||||
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
||||||
|
#[cfg_attr(feature = "defmt", derive(defmt::Format))]
|
||||||
pub enum ByteConversionError {
|
pub enum ByteConversionError {
|
||||||
/// The passed slice is too small. Returns the passed slice length and expected minimum size
|
/// The passed slice is too small. Returns the passed slice length and expected minimum size
|
||||||
ToSliceTooSmall {
|
ToSliceTooSmall {
|
||||||
@ -142,6 +143,7 @@ impl Error for ByteConversionError {}
|
|||||||
/// CCSDS packet type enumeration.
|
/// CCSDS packet type enumeration.
|
||||||
#[derive(Debug, PartialEq, Eq, Copy, Clone)]
|
#[derive(Debug, PartialEq, Eq, Copy, Clone)]
|
||||||
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
||||||
|
#[cfg_attr(feature = "defmt", derive(defmt::Format))]
|
||||||
pub enum PacketType {
|
pub enum PacketType {
|
||||||
Tm = 0,
|
Tm = 0,
|
||||||
Tc = 1,
|
Tc = 1,
|
||||||
@ -165,6 +167,7 @@ pub fn packet_type_in_raw_packet_id(packet_id: u16) -> PacketType {
|
|||||||
|
|
||||||
#[derive(Debug, PartialEq, Eq, Copy, Clone)]
|
#[derive(Debug, PartialEq, Eq, Copy, Clone)]
|
||||||
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
||||||
|
#[cfg_attr(feature = "defmt", derive(defmt::Format))]
|
||||||
pub enum SequenceFlags {
|
pub enum SequenceFlags {
|
||||||
ContinuationSegment = 0b00,
|
ContinuationSegment = 0b00,
|
||||||
FirstSegment = 0b01,
|
FirstSegment = 0b01,
|
||||||
@ -192,6 +195,7 @@ impl TryFrom<u8> for SequenceFlags {
|
|||||||
/// of the first two bytes in the CCSDS primary header.
|
/// of the first two bytes in the CCSDS primary header.
|
||||||
#[derive(Debug, Eq, Copy, Clone)]
|
#[derive(Debug, Eq, Copy, Clone)]
|
||||||
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
||||||
|
#[cfg_attr(feature = "defmt", derive(defmt::Format))]
|
||||||
pub struct PacketId {
|
pub struct PacketId {
|
||||||
pub ptype: PacketType,
|
pub ptype: PacketType,
|
||||||
pub sec_header_flag: bool,
|
pub sec_header_flag: bool,
|
||||||
@ -303,6 +307,7 @@ impl From<u16> for PacketId {
|
|||||||
/// third and the fourth byte in the CCSDS primary header.
|
/// third and the fourth byte in the CCSDS primary header.
|
||||||
#[derive(Debug, PartialEq, Eq, Copy, Clone)]
|
#[derive(Debug, PartialEq, Eq, Copy, Clone)]
|
||||||
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
||||||
|
#[cfg_attr(feature = "defmt", derive(defmt::Format))]
|
||||||
pub struct PacketSequenceCtrl {
|
pub struct PacketSequenceCtrl {
|
||||||
pub seq_flags: SequenceFlags,
|
pub seq_flags: SequenceFlags,
|
||||||
seq_count: u16,
|
seq_count: u16,
|
||||||
@ -463,6 +468,7 @@ pub trait CcsdsPrimaryHeader {
|
|||||||
/// * `data_len` - Data length field occupies the fifth and the sixth byte of the raw header
|
/// * `data_len` - Data length field occupies the fifth and the sixth byte of the raw header
|
||||||
#[derive(Debug, PartialEq, Eq, Copy, Clone)]
|
#[derive(Debug, PartialEq, Eq, Copy, Clone)]
|
||||||
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
||||||
|
#[cfg_attr(feature = "defmt", derive(defmt::Format))]
|
||||||
pub struct SpHeader {
|
pub struct SpHeader {
|
||||||
pub version: u8,
|
pub version: u8,
|
||||||
pub packet_id: PacketId,
|
pub packet_id: PacketId,
|
||||||
@ -798,7 +804,7 @@ pub(crate) mod tests {
|
|||||||
let id_default = PacketId::default();
|
let id_default = PacketId::default();
|
||||||
assert_eq!(id_default.ptype, PacketType::Tm);
|
assert_eq!(id_default.ptype, PacketType::Tm);
|
||||||
assert_eq!(id_default.apid, 0x000);
|
assert_eq!(id_default.apid, 0x000);
|
||||||
assert_eq!(id_default.sec_header_flag, false);
|
assert!(!id_default.sec_header_flag);
|
||||||
}
|
}
|
||||||
|
|
||||||
#[test]
|
#[test]
|
||||||
@ -808,7 +814,7 @@ pub(crate) mod tests {
|
|||||||
let packet_id = packet_id.unwrap();
|
let packet_id = packet_id.unwrap();
|
||||||
assert_eq!(packet_id.apid(), 0x1ff);
|
assert_eq!(packet_id.apid(), 0x1ff);
|
||||||
assert_eq!(packet_id.ptype, PacketType::Tc);
|
assert_eq!(packet_id.ptype, PacketType::Tc);
|
||||||
assert_eq!(packet_id.sec_header_flag, true);
|
assert!(packet_id.sec_header_flag);
|
||||||
let packet_id_tc = PacketId::tc(true, 0x1ff);
|
let packet_id_tc = PacketId::tc(true, 0x1ff);
|
||||||
assert!(packet_id_tc.is_some());
|
assert!(packet_id_tc.is_some());
|
||||||
let packet_id_tc = packet_id_tc.unwrap();
|
let packet_id_tc = packet_id_tc.unwrap();
|
||||||
|
@ -78,6 +78,7 @@ impl ProvidesDaysLength for DaysLen24Bits {
|
|||||||
|
|
||||||
#[derive(Debug, PartialEq, Eq, Copy, Clone)]
|
#[derive(Debug, PartialEq, Eq, Copy, Clone)]
|
||||||
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
||||||
|
#[cfg_attr(feature = "defmt", derive(defmt::Format))]
|
||||||
pub enum LengthOfDaySegment {
|
pub enum LengthOfDaySegment {
|
||||||
Short16Bits = 0,
|
Short16Bits = 0,
|
||||||
Long24Bits = 1,
|
Long24Bits = 1,
|
||||||
@ -94,6 +95,7 @@ pub enum SubmillisPrecision {
|
|||||||
|
|
||||||
#[derive(Debug, PartialEq, Eq, Copy, Clone)]
|
#[derive(Debug, PartialEq, Eq, Copy, Clone)]
|
||||||
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
||||||
|
#[cfg_attr(feature = "defmt", derive(defmt::Format))]
|
||||||
pub enum CdsError {
|
pub enum CdsError {
|
||||||
/// CCSDS days value exceeds maximum allowed size or is negative
|
/// CCSDS days value exceeds maximum allowed size or is negative
|
||||||
InvalidCcsdsDays(i64),
|
InvalidCcsdsDays(i64),
|
||||||
|
@ -37,6 +37,7 @@ pub const MAX_CUC_LEN_SMALL_PREAMBLE: usize = 8;
|
|||||||
|
|
||||||
#[derive(Copy, Clone, PartialEq, Eq, Debug)]
|
#[derive(Copy, Clone, PartialEq, Eq, Debug)]
|
||||||
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
||||||
|
#[cfg_attr(feature = "defmt", derive(defmt::Format))]
|
||||||
pub enum FractionalResolution {
|
pub enum FractionalResolution {
|
||||||
/// No fractional part, only second resolution
|
/// No fractional part, only second resolution
|
||||||
Seconds = 0,
|
Seconds = 0,
|
||||||
@ -105,6 +106,7 @@ pub fn fractional_part_from_subsec_ns(res: FractionalResolution, ns: u64) -> Fra
|
|||||||
|
|
||||||
#[derive(Copy, Clone, PartialEq, Eq, Debug)]
|
#[derive(Copy, Clone, PartialEq, Eq, Debug)]
|
||||||
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
||||||
|
#[cfg_attr(feature = "defmt", derive(defmt::Format))]
|
||||||
pub enum CucError {
|
pub enum CucError {
|
||||||
InvalidCounterWidth(u8),
|
InvalidCounterWidth(u8),
|
||||||
/// Invalid counter supplied.
|
/// Invalid counter supplied.
|
||||||
|
@ -33,6 +33,7 @@ pub const NANOS_PER_SECOND: u32 = 1_000_000_000;
|
|||||||
|
|
||||||
#[derive(Debug, PartialEq, Eq, Copy, Clone)]
|
#[derive(Debug, PartialEq, Eq, Copy, Clone)]
|
||||||
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
||||||
|
#[cfg_attr(feature = "defmt", derive(defmt::Format))]
|
||||||
pub enum CcsdsTimeCode {
|
pub enum CcsdsTimeCode {
|
||||||
CucCcsdsEpoch = 0b001,
|
CucCcsdsEpoch = 0b001,
|
||||||
CucAgencyEpoch = 0b010,
|
CucAgencyEpoch = 0b010,
|
||||||
@ -65,6 +66,7 @@ pub fn ccsds_time_code_from_p_field(pfield: u8) -> Result<CcsdsTimeCode, u8> {
|
|||||||
|
|
||||||
#[derive(Debug, PartialEq, Eq, Copy, Clone)]
|
#[derive(Debug, PartialEq, Eq, Copy, Clone)]
|
||||||
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
||||||
|
#[cfg_attr(feature = "defmt", derive(defmt::Format))]
|
||||||
pub struct DateBeforeCcsdsEpochError(UnixTime);
|
pub struct DateBeforeCcsdsEpochError(UnixTime);
|
||||||
|
|
||||||
impl Display for DateBeforeCcsdsEpochError {
|
impl Display for DateBeforeCcsdsEpochError {
|
||||||
@ -78,6 +80,7 @@ impl Error for DateBeforeCcsdsEpochError {}
|
|||||||
|
|
||||||
#[derive(Debug, PartialEq, Eq, Copy, Clone)]
|
#[derive(Debug, PartialEq, Eq, Copy, Clone)]
|
||||||
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
||||||
|
#[cfg_attr(feature = "defmt", derive(defmt::Format))]
|
||||||
#[non_exhaustive]
|
#[non_exhaustive]
|
||||||
pub enum TimestampError {
|
pub enum TimestampError {
|
||||||
InvalidTimeCode { expected: CcsdsTimeCode, found: u8 },
|
InvalidTimeCode { expected: CcsdsTimeCode, found: u8 },
|
||||||
@ -262,6 +265,7 @@ pub trait CcsdsTimeProvider {
|
|||||||
/// similarly to other common time formats and libraries.
|
/// similarly to other common time formats and libraries.
|
||||||
#[derive(Default, Debug, Copy, Clone, PartialEq, Eq)]
|
#[derive(Default, Debug, Copy, Clone, PartialEq, Eq)]
|
||||||
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
||||||
|
#[cfg_attr(feature = "defmt", derive(defmt::Format))]
|
||||||
pub struct UnixTime {
|
pub struct UnixTime {
|
||||||
secs: i64,
|
secs: i64,
|
||||||
subsec_nanos: u32,
|
subsec_nanos: u32,
|
||||||
|
@ -131,6 +131,7 @@ impl Error for UnsignedByteFieldError {}
|
|||||||
/// Type erased variant.
|
/// Type erased variant.
|
||||||
#[derive(Debug, Copy, Clone, PartialEq, Eq)]
|
#[derive(Debug, Copy, Clone, PartialEq, Eq)]
|
||||||
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
||||||
|
#[cfg_attr(feature = "defmt", derive(defmt::Format))]
|
||||||
pub struct UnsignedByteField {
|
pub struct UnsignedByteField {
|
||||||
width: usize,
|
width: usize,
|
||||||
value: u64,
|
value: u64,
|
||||||
@ -220,6 +221,7 @@ impl UnsignedEnum for UnsignedByteField {
|
|||||||
|
|
||||||
#[derive(Debug, Copy, Clone, Eq, PartialEq)]
|
#[derive(Debug, Copy, Clone, Eq, PartialEq)]
|
||||||
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
|
||||||
|
#[cfg_attr(feature = "defmt", derive(defmt::Format))]
|
||||||
pub struct GenericUnsignedByteField<TYPE: Copy + Into<u64>> {
|
pub struct GenericUnsignedByteField<TYPE: Copy + Into<u64>> {
|
||||||
value: TYPE,
|
value: TYPE,
|
||||||
}
|
}
|
||||||
|
Loading…
Reference in New Issue
Block a user