spacepackets/CHANGELOG.md

319 lines
13 KiB
Markdown
Raw Normal View History

2022-06-19 14:37:36 +02:00
Change Log
=======
All notable changes to this project will be documented in this file.
The format is based on [Keep a Changelog](http://keepachangelog.com/)
and this project adheres to [Semantic Versioning](http://semver.org/).
2022-09-03 18:50:21 +02:00
# [unreleased]
2022-06-19 14:37:36 +02:00
2023-09-18 16:59:38 +02:00
## Added
- `PacketId` trait impls: `Ord`, `PartialOrd` and `Hash`
- `SerializablePusPacket` trait: Add `to_vec` method with default implementation.
2023-09-18 16:59:38 +02:00
2023-08-28 18:36:00 +02:00
# [v0.7.0-beta.1] 2023-08-28
2023-08-28 18:54:01 +02:00
- Bump `zerocopy` dependency to v0.7.0
2023-08-16 16:27:10 +02:00
## Changed
- The `Tlv` and `Lv` API return `&[u8]` instead of `Option<&[u8]>`.
2023-08-28 17:00:29 +02:00
- `ByteConversionError` error variants `ToSliceTooSmall` and `FromSliceTooSmall` are struct
variants now. `SizeMissmatch` was removed appropriately.
2023-08-28 17:30:26 +02:00
- `UnsignedByteFieldError` error variants `ValueTooLargeForWidth` and `InvalidWidth` are struct
variants now.
- `TimestampError` error variant `InvalidTimeCode` is struct variant now.
2023-08-16 16:27:10 +02:00
## Added
- Added `raw_data` API for `Tlv` and `Lv` to retrieve the whole `Lv`/`Tlv` slice if the object
was created from a raw bytestream.
2023-08-16 18:01:54 +02:00
- Added `MsgToUserTlv` helper class which wraps a regular `Tlv` and adds some useful functionality.
2023-08-16 18:15:49 +02:00
- `UnsignedByteField` and `GenericUnsignedByteField` `new` methods are `const` now.
2023-08-17 21:22:49 +02:00
- `PduError` variants which contained a tuple variant with multiple fields were converted to a
struct variant.
2023-08-16 18:15:49 +02:00
2023-08-17 20:42:45 +02:00
# Added
- Added `pdu_datafield_len` getter function for `PduHeader`
2023-08-16 16:27:10 +02:00
2023-08-28 17:00:29 +02:00
## Removed
- `SizeMissmatch` because it is not required for the `ByteConversionError` error enumeration
anymore.
2023-08-16 14:00:38 +02:00
# [v0.7.0-beta.0] 2023-08-16
2023-07-09 12:27:44 +02:00
2023-08-11 14:00:46 +02:00
- Moved MSRV from v1.60 to v1.61.
2023-07-09 12:27:44 +02:00
## Changed
2023-07-11 00:03:07 +02:00
- `PusPacket` trait: `user_data` now returns `&[u8]` instead of `Option<&[u8]>`. Empty user data
can simply be an empty slice.
2023-07-09 12:27:44 +02:00
- Moved ECSS TC components from `tc` to `ecss.tc`.
- Moved ECSS TM components from `tm` to `ecss.tm`.
2023-07-10 23:18:09 +02:00
- Converted `PusTc` class to more specialized `PusTcCreator` and `PusTcReader`
classes. The old `PusTc` class is deprecated now.
- Converted `PusTm` class to more specialized `PusTmCreator` and `PusTmReader`
classes. The old `PusTm` class is deprecated now.
2023-07-09 16:46:25 +02:00
- Implement `Display` and `Error` for `StdTimestampError` properly.
2023-07-10 00:37:16 +02:00
- Remove some redundant `Error` suffixes for enum error variants.
2023-08-10 20:22:07 +02:00
- `CommonPduConfig`: `new_with_defaults` replaced by `new_with_byte_fields`.
2023-07-09 12:27:44 +02:00
2023-07-10 23:37:23 +02:00
## Added
2023-07-11 00:03:07 +02:00
- `source_data` and `app_data` API provided for PUS TM and PUS TC reader classes. These simply
call `user_data` but are also in line with the PUS packet standard names for those fields.
2023-07-10 23:37:23 +02:00
- Added new marker trait `IsPusTelemetry` implemented by `PusTmCreator` and `PusTmReader`.
- Added new marker trait `IsPusTelecommand` implemented by `PusTcCreator` and `PusTcReader`.
2023-08-10 18:17:32 +02:00
- `metadata_param` getter method for the `MetadataPdu` object.
2023-08-10 20:03:50 +02:00
- `Default` impl for CFDP `ChecksumType`
2023-08-10 20:22:07 +02:00
- `Default` impl for CFDP `CommonPduConfig`
2023-08-10 18:17:32 +02:00
## Fixed
- All `MetadataGenericParam` fields are now public.
2023-08-10 20:01:13 +02:00
- New setter method `set_source_and_dest_id` for `CommonPduConfig`.
2023-07-10 23:37:23 +02:00
2023-07-06 01:26:53 +02:00
# [v0.6.0] 2023-07-06
2023-05-14 20:10:34 +02:00
## Added
- Added new `util` module which contains the following (new) helper modules:
- `UnsignedEnum` trait as an abstraction for unsigned byte fields with variable lengths. It is
2023-07-02 20:57:50 +02:00
not tied to the ECSS PFC value like the `EcssEnumeration` trait. The method to retrieve
the size of the unsigned enumeration in bytes is now called `size`.
2023-05-14 20:11:31 +02:00
- `GenericUnsignedByteField<TYPE>` and helper typedefs `UnsignedU8`, `UnsignedU16`, `UnsignedU32`
and `UnsignedU64` as helper types implementing `UnsignedEnum`
2023-05-14 20:10:34 +02:00
- `UnsignedByteField` as a type-erased helper.
2023-07-06 01:24:40 +02:00
- Initial CFDP support: Added PDU packet implementation.
2023-07-02 18:38:18 +02:00
- Added `SerializablePusPacket` as a generic abstraction for PUS packets which are
writable.
2023-07-05 19:07:31 +02:00
- Added new `PusTmZeroCopyWriter` class which allows to set fields on a raw TM packet,
which might be more efficient that modification and re-writing a packet with the
`PusTm` object.
2023-05-14 20:10:34 +02:00
## Changed
- The `EcssEnumeration` now requires the `UnsignedEnum` trait and only adds the `pfc` method to it.
2023-07-06 01:24:40 +02:00
- Renamed `byte_width` usages to `size` (part of new `UnsignedEnum` trait)
2023-05-29 13:46:19 +02:00
- Moved `ecss::CRC_CCITT_FALSE` CRC constant to the root module. This CRC type is not just used by
the PUS standard, but by the CCSDS Telecommand standard and the CFDP standard as well.
2023-05-14 20:10:34 +02:00
2023-02-12 17:23:37 +01:00
# [v0.5.4] 2023-02-12
## Added
- `Clone` trait requirement for `time::cds::ProvidesDaysLen` trait.
- Added `Copy` and `Clone` derives for `DaysLen16Bits` and `DaysLen24Bits`.
2023-02-05 23:46:07 +01:00
# [v0.5.3] 2023-02-05
2023-02-04 15:13:59 +01:00
## Added
- `num_enum` dependency to avoid boilerplate code for primtive to enum conversions, for example
for the PUS subservices.
- `ecss.event` module containing a `Subservice` enum.
- `ecss.verification` module containing a `Subservice` enum.
- `ecss.scheduling` module containing a `Subservice` enum and some other helper enumerations.
2023-02-04 15:16:57 +01:00
- `ecss.hk` module containing a `Subservice` enum.
2023-02-04 15:13:59 +01:00
## Changed
- Added missing Service IDs to `ecss.PusServiceId` and marked in `#[non_exhaustive]`.
2023-02-05 18:47:46 +01:00
## Fixed
- `time.UnixTimestamp`: All constructors and `From` conversions now use the `new` constructor,
which should cause a correct conversion of 0 subsecond milliseconds to a `None` value.
2023-01-26 22:03:43 +01:00
# [v0.5.2] 2023-01-26
2023-01-26 19:07:35 +01:00
## Added
- Added `.gitignore`.
## Fixed
- Correct implementation of Trait `PartialEq` for `PusTc` and `PusTm`. The previous auto-derivation
were incorrect because they also compared fields unrelated to the raw byte representation.
2023-01-26 19:07:35 +01:00
2023-01-26 21:31:29 +01:00
## Changed
- Renamed `PusTc` `raw` method to `raw_bytes` and add better docs to avoid confusion.
Deprecate `raw` to avoid breaking change.
- Added `raw_bytes` method to `PusTm`.
2023-01-22 13:06:22 +01:00
# [v0.5.1] 2023-01-22
2023-01-21 01:25:05 +01:00
## Added
- `time::cds::TimeProvider`
- Add `Ord` and `PartialOrd`, use custom `PartialEq` impl to account for precision correctly.
- Add `precision_as_ns` function which converts microsecond and picosecond precision values
into nanoseconds.
- Add conversion trait to convert `cds::TimeProvider<DaysLen16Bits>` into
`cds::TimeProvider<DaysLen24Bits>` and vice-versa.
- `time::UnixTimestamp`
- Add `Ord` and `PartialOrd` implementations.
2023-01-21 13:17:38 +01:00
- Add `Add<Duration>` and `AddAssign<Duration>` implementations.
2023-01-21 01:25:05 +01:00
## Fixed
2023-01-22 13:11:43 +01:00
- `time::cds::TimeProvider`: Fixed a bug where subsecond milliseconds were not accounted for
when the provider has no submillisecond precision.
2023-01-20 19:48:20 +01:00
# [v0.5.0] 2023-01-20
2023-01-16 18:00:23 +01:00
The timestamp of `PusTm` is now optional. See Added and Changed section for details.
2023-01-14 17:15:48 +01:00
## Added
2023-01-16 11:56:25 +01:00
- `PusTmSecondaryHeader`: New `new_simple_no_timestamp` API to create secondary header without
timestamp.
2023-01-16 18:00:23 +01:00
- `PusTm`: Add `new_simple_no_timestamp` method to create TM without timestamp
2023-01-15 21:12:54 +01:00
- New `UnixTimestamp` abstraction which contains the unix seconds as an `i64`
and an optional subsecond millisecond counter (`u16`)
2023-01-15 21:47:35 +01:00
- `MS_PER_DAY` constant.
2023-01-17 01:16:07 +01:00
- CUC: Added `from_date_time` and `from_unix_stamp` constructors for time provider.
- CUC: Add `Add<Duration>` and `AddAssign<Duration>` impl for time provider.
2023-01-16 11:56:25 +01:00
2023-01-15 21:12:54 +01:00
### CDS time module
2023-01-16 11:56:25 +01:00
2023-01-15 21:53:25 +01:00
- Implement `Add<Duration>` and `AddAssign<Duration>` for time providers, which allows
easily adding offsets to the providers.
- Implement `TryFrom<DateTime<Utc>>` for time providers.
- `get_dyn_time_provider_from_bytes`: Requires `alloc` support and returns
the correct `TimeProvider` instance wrapped as a boxed trait object
`Box<DynCdsTimeProvider>` by checking the length of days field.
2023-01-15 21:12:54 +01:00
- Added constructor function to create the time provider
2023-01-14 17:15:48 +01:00
from `chrono::DateTime<Utc>` and a generic UNIX timestamp (`i64` seconds
and subsecond milliseconds).
2023-01-15 20:48:39 +01:00
- `MAX_DAYS_24_BITS` which contains maximum value which can be supplied
to the days field of a CDS time provider with 24 bits days field width.
2023-01-15 21:47:35 +01:00
- New `CdsTimestamp` trait which encapsulates common fields for all CDS time providers.
- `from_unix_secs_with_u24_days` and `from_unix_secs_with_u16_days` which create
the time provider from a `UnixTimestamp` reference.
- `from_dt_with_u16_days`, `from_dt_with_u24_days` and their `..._us_precision` and
`..._ps_precision` variants which allow to create time providers from
a `chrono::DateTime<Utc>`.
- Add `from_bytes_with_u24_days` and `from_bytes_with_u16_days` associated methods
2023-01-15 20:48:39 +01:00
## Changed
2023-01-17 01:16:07 +01:00
- (breaking) `unix_epoch_to_ccsds_epoch`: Expect and return `i64` instead of `u64` now.
- (breaking) `ccsds_epoch_to_unix_epoch`: Expect and return `i64` instead of `u64` now.
- (breaking) `PusTmSecondaryHeader`: Timestamp is optional now, which translates to a
timestamp of size 0.
- (breaking): `PusTm`: Renamed `time_stamp` method to `timestamp`, also returns
`Optional<&'src_data [u8]>` now.
- (breaking): `PusTmSecondaryHeader`: Renamed `time_stamp` field to `timestamp` for consistency.
2023-01-15 21:47:35 +01:00
- (breaking): Renamed `from_now_with_u24_days_and_us_prec` to `from_now_with_u24_days_us_precision`.
Also did the same for the `u16` variant.
- (breaking): Renamed `from_now_with_u24_days_and_ps_prec` to `from_now_with_u24_days_ps_precision`.
Also did the same for the `u16` variant.
2023-01-15 20:48:39 +01:00
- `CcsdsTimeProvider` trait (breaking):
2023-01-15 21:47:35 +01:00
- Add new `unix_stamp` method returning the new `UnixTimeStamp` struct.
- Add new `subsecond_millis` method returning counter `Option<u16>`.
2023-01-15 20:48:39 +01:00
- Default impl for `unix_stamp` which re-uses `subsecond_millis` and
2023-01-15 21:47:35 +01:00
existing `unix_seconds` method.
2023-01-15 20:48:39 +01:00
- `TimestampError` (breaking): Add `DateBeforeCcsdsEpoch` error type
because new CDS API allow supplying invalid date times before CCSDS epoch.
Make `TimestampError` with `#[non_exhaustive]` attribute to prevent
2023-01-15 21:47:35 +01:00
future breakages if new error variants are added.
2023-01-16 11:56:25 +01:00
2023-01-14 17:46:43 +01:00
# [v0.4.2] 14.01.2023
## Fixed
- CDS timestamp: Fixed another small logic error for stamp creation from the current
time with picosecond precision.
2023-01-14 17:47:52 +01:00
PR: https://egit.irs.uni-stuttgart.de/rust/spacepackets/pulls/8
2023-01-14 17:46:43 +01:00
2023-01-14 17:18:02 +01:00
# [v0.4.1] 14.01.2023
## Fixed
- CDS timestamp: The conversion function from the current time were buggy
when specifying picoseconds precision, which could lead to overflow
multiplications and/or incorrect precision fields.
2023-01-14 17:47:52 +01:00
PR: https://egit.irs.uni-stuttgart.de/rust/spacepackets/pulls/7
2023-01-14 17:18:02 +01:00
2023-01-10 00:00:10 +01:00
# [v0.4.0] 10.01.2023
2023-01-09 11:21:07 +01:00
2022-12-21 10:14:58 +01:00
## Fixed
- Remove `Default` derive on CDS time provider. This can lead to uninitialized preamble fields.
2022-12-04 17:11:44 +01:00
## Changed
2022-12-05 09:05:35 +01:00
- `serde` support is now optional and behind the `serde` feature.
2022-12-07 14:42:53 +01:00
- `PusTcSecondaryHeaderT` trait renamed to `GenericPusTcSecondaryHeader`.
2022-12-05 09:05:35 +01:00
- `PusTmSecondaryHeaderT` trait renamed to `GenericPusTmSecondaryHeader`.
2022-12-04 19:57:51 +01:00
- `SpHeader`: Former `tc` and `tm` methods now named `tc_unseg` and `tm_unseg`.
2022-12-05 09:05:35 +01:00
Former `new` method now called `new_from_single_fields`.
- `SpHeader`: Renamed `from_bytes` to `from_be_bytes`.
The function now returns the remaining slice as well.
2022-12-07 14:42:01 +01:00
- All CDS specific functionality was moved into the `cds` submodule of the `time`
module. `CdsShortTimeProvider` was renamed to `TimeProvider`.
2022-12-20 16:27:23 +01:00
PR: https://egit.irs.uni-stuttgart.de/rust/spacepackets/pulls/3
2022-12-04 17:22:51 +01:00
## Added
2023-01-09 11:12:07 +01:00
- `SpHeader` getter function `sp_header` added for `PusTc`
PR: https://egit.irs.uni-stuttgart.de/rust/spacepackets/pulls/6
2022-12-20 16:21:30 +01:00
- Added PFC enumerations: `ecss::UnsignedPfc` and `ecss::RealPfc`.
PR: https://egit.irs.uni-stuttgart.de/rust/spacepackets/pulls/5
2022-12-07 14:42:53 +01:00
- Added `std::error::Error` implementation for all error enumerations if the `std` feature
is enabled.
2022-12-10 18:27:13 +01:00
- CUC timestamp implementation as specified in CCSDS 301.0-B-4 section 3.2.
PR: https://egit.irs.uni-stuttgart.de/rust/spacepackets/pulls/4/files
- ACII timestamps as specified in CCSDS 301.0-B-4 section 3.5.
2022-12-07 19:05:09 +01:00
- Added MSRV in `Cargo.toml` with the `rust-version` field set to Rust 1.60.
2022-12-05 09:05:35 +01:00
- `serde` `Serialize` and `Deserialize` added to all types.
2022-12-04 19:57:51 +01:00
- Added `const` constructors for `PacketId`, `PacketSeqCtrl` and
2022-12-05 09:05:35 +01:00
`SpHeader`.
2022-12-07 14:42:01 +01:00
- Added `PartialEq` and `Eq` `derive`s to `TimeProvider`.
2022-12-05 09:05:35 +01:00
- `SpHeader`: Added serialization function into raw format `write_to_be_bytes`.
2022-12-07 14:42:01 +01:00
- Added 24-bit day field support for CDS short. The bit width is configured at type level
via a generic parameter type passed to the `cds::TimeProvider`
- Added submillisecond precision support for `cds::TimeProvider`
2022-12-04 17:18:10 +01:00
2022-12-03 15:47:18 +01:00
# [v0.3.1] 03.12.2022
- Small fix for faulty docs.rs build
2022-12-01 01:22:19 +01:00
# [v0.3.0] 01.12.2022
2022-11-02 11:10:41 +01:00
## Added
- `EcssEnumerationExt` trait which implements `Debug`, `Copy`, `Clone`,
`PartialEq` and `Eq` in addition to `EcssEnumeration`
## Changed
- `EcssEnumeration` trait: Rename `write_to_bytes`
to `write_to_be_bytes`
2022-09-13 10:18:21 +02:00
# [v0.2.0] 13.09.2022
2022-09-03 18:50:21 +02:00
## Added
- Basic support for ECSS enumeration types for u8, u16, u32 and u64
## Changed
- Better names for generic error enumerations: `PacketError` renamed to `ByteConversionError`
2022-09-13 10:28:20 +02:00
- CCSDS module: `ssc` abbreviations fully replaced by better name `seq_count`
2022-09-13 10:18:21 +02:00
- Time module: `CcsdsTimeProvider::date_time` now has `Option<DateTime<Utc>>` as
a returnvalue instead of `DateTime<Utc>`
2022-09-13 10:28:20 +02:00
- `PusTc` and `PusTm`: `new_from_raw_slice` renamed to simpler `from_bytes`
2022-09-03 18:50:21 +02:00
# [v0.1.0] 16.08.2022
2022-06-19 14:37:36 +02:00
2022-08-16 01:17:10 +02:00
Initial release with CCSDS Space Packet Primary Header implementation and basic PUS TC and TM
implementations.