From 585d36efcf2ff342b4c8ad9118c00fa34a5f8b5a Mon Sep 17 00:00:00 2001 From: dmccoystephenson Date: Mon, 20 Jan 2025 11:02:10 -0700 Subject: [PATCH 1/7] Updated 2025 Q1 release notes to include details on partial compatibility with J2735 2024 Signed-off-by: dmccoystephenson --- docs/Release_notes.md | 17 ++++++++++++----- 1 file changed, 12 insertions(+), 5 deletions(-) diff --git a/docs/Release_notes.md b/docs/Release_notes.md index 90bd4b89b..725091f67 100644 --- a/docs/Release_notes.md +++ b/docs/Release_notes.md @@ -13,8 +13,14 @@ Key highlights include: - Updates to TIM schemas and JSON annotations for more J2735-accurate ODE processing Significant strides have been made in optimizing configurations through enhancements like the extraction of Kafka properties, -environment variables, and Kafka topics into more streamlined Spring Configuration properties. Additionally, schema -updates have been made to increment the version for output messages and ensure compatibility with J2735 2024. +environment variables, and Kafka topics into more streamlined Spring Configuration properties. + +Schema updates have been implemented to increment the version of output messages and provide partial compatibility with +J2735 2024. However, some limitations remain. Due to a bug in the ASN.1 Compiler, the VehicleEventFlags bitstring has +been reverted to its 2020 version, excluding the eventJackKnife bit introduced in the 2024 revision. As a result, this +bit will not appear in output BSMs until the issue is resolved. Additionally, certain fields added to BSM-related +structures in J2735 2024 are not yet supported in the ODE. These fields will be incorporated in a future release. + Developer-focused changes include revisions to the README, Makefile, and devcontainer to support smoother onboarding and ease of use. Other vital updates encompass new entries in the submodule compatibility guide, version upgrades, and bug fixes related to Kafka configurations and message handling. @@ -66,12 +72,13 @@ Enhancements in this release: - [CDOT PR 158](https://github.com/CDOT-CV/jpo-ode/pull/158): Release/PSM schema fix Breaking changes: -- The major version was incremented due to breaking changes in the 2024 revision of J2735. +- The major version was incremented to reflect breaking changes related to TIM XER encoding introduced in the 2024 revision of J2735. Known Issues: -- No known issues at this time. +- **VehicleEventFlags Bitstring Bug**: A bug in the ASN.1 Compiler has necessitated reverting the VehicleEventFlags bitstring to its 2020 version, which excludes the eventJackKnife bit added in the 2024 revision. As a result, this bit will not appear in output BSMs until the bug is fixed. +- **Unsupported BSM Fields**: New fields introduced in BSM-related structures by the 2024 revision of J2735 are currently not supported in the ODE. These fields will be implemented in a future release. -Version 3.0.0, released September 2024 +- Version 3.0.0, released September 2024 ---------------------------------------- ### **Summary** The updates for the jpo-ode 3.0.0 release include several key improvements and cleanups. Outdated 'deposit over WebSocket to SDX' code was removed and the ppm_tim service was eliminated from Docker compose files. Additionally, the jpo-s3-deposit submodule was replaced with the jpo-utils submodule. Error handling was enhanced, particularly in interpreting "SNMP Error Code 10" from RSUs and stack traces for bad encoded data from ACM are now printed only when debug logging is enabled. Documentation updates provide more granular project references and mapfile references in ppm*.properties files were updated. Build and deployment improvements include resolving a UID conflict for container builds and adding Maven JAR publishing to GitHub Maven Central via GitHub Actions. Lastly, a Docker startup script was introduced for log offloading via SSH/SCP and source ASN1 bytes payload support was added for IMP depositors. From fa102d9264584c68562d0c6d2d2484f871b4ed1c Mon Sep 17 00:00:00 2001 From: dmccoystephenson Date: Mon, 20 Jan 2025 11:10:28 -0700 Subject: [PATCH 2/7] Reverted change to header for v3 release notes Signed-off-by: dmccoystephenson --- docs/Release_notes.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/Release_notes.md b/docs/Release_notes.md index 725091f67..64fbac49e 100644 --- a/docs/Release_notes.md +++ b/docs/Release_notes.md @@ -78,7 +78,7 @@ Known Issues: - **VehicleEventFlags Bitstring Bug**: A bug in the ASN.1 Compiler has necessitated reverting the VehicleEventFlags bitstring to its 2020 version, which excludes the eventJackKnife bit added in the 2024 revision. As a result, this bit will not appear in output BSMs until the bug is fixed. - **Unsupported BSM Fields**: New fields introduced in BSM-related structures by the 2024 revision of J2735 are currently not supported in the ODE. These fields will be implemented in a future release. -- Version 3.0.0, released September 2024 +Version 3.0.0, released September 2024 ---------------------------------------- ### **Summary** The updates for the jpo-ode 3.0.0 release include several key improvements and cleanups. Outdated 'deposit over WebSocket to SDX' code was removed and the ppm_tim service was eliminated from Docker compose files. Additionally, the jpo-s3-deposit submodule was replaced with the jpo-utils submodule. Error handling was enhanced, particularly in interpreting "SNMP Error Code 10" from RSUs and stack traces for bad encoded data from ACM are now printed only when debug logging is enabled. Documentation updates provide more granular project references and mapfile references in ppm*.properties files were updated. Build and deployment improvements include resolving a UID conflict for container builds and adding Maven JAR publishing to GitHub Maven Central via GitHub Actions. Lastly, a Docker startup script was introduced for log offloading via SSH/SCP and source ASN1 bytes payload support was added for IMP depositors. From 14efc44eb2162c348095ac241ea5ca8167801805 Mon Sep 17 00:00:00 2001 From: dmccoystephenson Date: Tue, 21 Jan 2025 08:59:09 -0700 Subject: [PATCH 3/7] Added CDOT PR 160 to 2025 Q1 release notes Signed-off-by: dmccoystephenson --- docs/Release_notes.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/docs/Release_notes.md b/docs/Release_notes.md index 64fbac49e..44fe2cd84 100644 --- a/docs/Release_notes.md +++ b/docs/Release_notes.md @@ -67,9 +67,10 @@ Enhancements in this release: - [CDOT PR 152](https://github.com/CDOT-CV/jpo-ode/pull/152): TIM and Map Schema Fixes - [CDOT PR 153](https://github.com/CDOT-CV/jpo-ode/pull/153): Fix: producer failures - [CDOT PR 154](https://github.com/CDOT-CV/jpo-ode/pull/154): Fix: Use odeKafkaProperties env vars to drive producer retries +- [CDOT PR 158](https://github.com/CDOT-CV/jpo-ode/pull/158): Release/PSM schema fix +- [CDOT PR 160](https://github.com/CDOT-CV/jpo-ode/pull/160): Support Renamed Fields in J2735 2024 BSM Structures - [USDOT PR 559](https://github.com/usdot-jpo-ode/jpo-ode/pull/559): Update GitHub Actions Third-Party Action Versions - [USDOT PR 561](https://github.com/usdot-jpo-ode/jpo-ode/pull/561): Bump ch.qos.logback:logback-core from 1.4.14 to 1.5.13 in /jpo-ode-plugins -- [CDOT PR 158](https://github.com/CDOT-CV/jpo-ode/pull/158): Release/PSM schema fix Breaking changes: - The major version was incremented to reflect breaking changes related to TIM XER encoding introduced in the 2024 revision of J2735. From 2da8ff11bf9d59bde66257881e7bbefdfb27bd8d Mon Sep 17 00:00:00 2001 From: dmccoystephenson Date: Tue, 21 Jan 2025 09:45:41 -0700 Subject: [PATCH 4/7] Updated wording in 2025 Q1 release notes Signed-off-by: dmccoystephenson --- docs/Release_notes.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/Release_notes.md b/docs/Release_notes.md index 44fe2cd84..3e6269f87 100644 --- a/docs/Release_notes.md +++ b/docs/Release_notes.md @@ -18,7 +18,7 @@ environment variables, and Kafka topics into more streamlined Spring Configurati Schema updates have been implemented to increment the version of output messages and provide partial compatibility with J2735 2024. However, some limitations remain. Due to a bug in the ASN.1 Compiler, the VehicleEventFlags bitstring has been reverted to its 2020 version, excluding the eventJackKnife bit introduced in the 2024 revision. As a result, this -bit will not appear in output BSMs until the issue is resolved. Additionally, certain fields added to BSM-related +bit will not appear in output BSMs until the issue is resolved. Additional fields added to BSM-related structures in J2735 2024 are not yet supported in the ODE. These fields will be incorporated in a future release. Developer-focused changes include revisions to the README, Makefile, and devcontainer to support smoother onboarding and From f7fe9a12555c271deaa995bcbc0cb86b47e9f299 Mon Sep 17 00:00:00 2001 From: dmccoystephenson Date: Tue, 21 Jan 2025 09:56:22 -0700 Subject: [PATCH 5/7] Added link to usdot-asn1c github issue Signed-off-by: dmccoystephenson --- docs/Release_notes.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/Release_notes.md b/docs/Release_notes.md index 3e6269f87..fe695ff20 100644 --- a/docs/Release_notes.md +++ b/docs/Release_notes.md @@ -16,7 +16,7 @@ Significant strides have been made in optimizing configurations through enhancem environment variables, and Kafka topics into more streamlined Spring Configuration properties. Schema updates have been implemented to increment the version of output messages and provide partial compatibility with -J2735 2024. However, some limitations remain. Due to a bug in the ASN.1 Compiler, the VehicleEventFlags bitstring has +J2735 2024. However, some limitations remain. Due to [a bug in the ASN.1 Compiler](https://github.com/usdot-fhwa-stol/usdot-asn1c/issues/2), the VehicleEventFlags bitstring has been reverted to its 2020 version, excluding the eventJackKnife bit introduced in the 2024 revision. As a result, this bit will not appear in output BSMs until the issue is resolved. Additional fields added to BSM-related structures in J2735 2024 are not yet supported in the ODE. These fields will be incorporated in a future release. From 13dbb002f440f363fd8d2d7867d72d25122df18c Mon Sep 17 00:00:00 2001 From: dmccoystephenson Date: Tue, 21 Jan 2025 12:47:10 -0700 Subject: [PATCH 6/7] Updated 2025 Q1 release notes to include specific unsupported fields Signed-off-by: dmccoystephenson --- docs/Release_notes.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/docs/Release_notes.md b/docs/Release_notes.md index fe695ff20..daf890212 100644 --- a/docs/Release_notes.md +++ b/docs/Release_notes.md @@ -18,8 +18,10 @@ environment variables, and Kafka topics into more streamlined Spring Configurati Schema updates have been implemented to increment the version of output messages and provide partial compatibility with J2735 2024. However, some limitations remain. Due to [a bug in the ASN.1 Compiler](https://github.com/usdot-fhwa-stol/usdot-asn1c/issues/2), the VehicleEventFlags bitstring has been reverted to its 2020 version, excluding the eventJackKnife bit introduced in the 2024 revision. As a result, this -bit will not appear in output BSMs until the issue is resolved. Additional fields added to BSM-related -structures in J2735 2024 are not yet supported in the ODE. These fields will be incorporated in a future release. +bit will not appear in output BSMs until the issue is resolved. Additionally, new fields added to BSM-related structures in +J2735 2024 are not yet supported in the ODE. These fields—such as fhwaVehicleClass, trailers, and schoolBus for +SupplementalVehicleExtensions, as well as trailerPresent, pivotPoint, axles, and leanAngle for VehicleData—will be +incorporated in a future release. Developer-focused changes include revisions to the README, Makefile, and devcontainer to support smoother onboarding and ease of use. Other vital updates encompass new entries in the submodule compatibility guide, version upgrades, and From cfbd4d74bbfa4a009733855ae51bfcb40dcc8ac5 Mon Sep 17 00:00:00 2001 From: dmccoystephenson Date: Tue, 21 Jan 2025 14:03:00 -0700 Subject: [PATCH 7/7] Updated 2025 Q1 release notes to include unsupported new fields for SPATs, MAPs & TIMs Signed-off-by: dmccoystephenson --- docs/Release_notes.md | 18 +++++++++++------- 1 file changed, 11 insertions(+), 7 deletions(-) diff --git a/docs/Release_notes.md b/docs/Release_notes.md index daf890212..2aee26cb0 100644 --- a/docs/Release_notes.md +++ b/docs/Release_notes.md @@ -15,13 +15,17 @@ Key highlights include: Significant strides have been made in optimizing configurations through enhancements like the extraction of Kafka properties, environment variables, and Kafka topics into more streamlined Spring Configuration properties. -Schema updates have been implemented to increment the version of output messages and provide partial compatibility with -J2735 2024. However, some limitations remain. Due to [a bug in the ASN.1 Compiler](https://github.com/usdot-fhwa-stol/usdot-asn1c/issues/2), the VehicleEventFlags bitstring has -been reverted to its 2020 version, excluding the eventJackKnife bit introduced in the 2024 revision. As a result, this -bit will not appear in output BSMs until the issue is resolved. Additionally, new fields added to BSM-related structures in -J2735 2024 are not yet supported in the ODE. These fields—such as fhwaVehicleClass, trailers, and schoolBus for -SupplementalVehicleExtensions, as well as trailerPresent, pivotPoint, axles, and leanAngle for VehicleData—will be -incorporated in a future release. +Schema updates have been applied to increment the version of output messages and provide partial compatibility with J2735 2024. +However, several limitations remain. +- Due to [a bug in the ASN.1 Compiler](https://github.com/usdot-fhwa-stol/usdot-asn1c/issues/2), the VehicleEventFlags bitstring has been reverted to + its 2020 version. This excludes the eventJackKnife bit introduced in the 2024 revision, which will not appear in output BSMs + until the issue is resolved. +- Additionally, fields newly added in J2735 2024 to BSM-related structures are not yet supported in the ODE. These include + fhwaVehicleClass, trailers, and schoolBus under SupplementalVehicleExtensions, as well as trailerPresent, pivotPoint, axles, + and leanAngle under VehicleData. +- Similarly, new fields introduced for MAPs, SPATs, and TIMs, such as roadAuthorityId and contentNew, are not currently supported + in the ODE. +- These limitations will be addressed in future updates. Developer-focused changes include revisions to the README, Makefile, and devcontainer to support smoother onboarding and ease of use. Other vital updates encompass new entries in the submodule compatibility guide, version upgrades, and