From e13cc286b2974f7df027dacf6f83a6bc3e882ca2 Mon Sep 17 00:00:00 2001 From: Stephen Lawrence Date: Fri, 22 Mar 2024 18:00:56 +0000 Subject: [PATCH] doc site: improved logical concept desc. Add assets folder Improvements to the logical concept description in the overview. Introduce the assets folder. Signed-off-by: Stephen Lawrence --- .../Logical-Architecture-Overview.drawio.svg | 4 + .../assets/cdsp-logical-concept.drawio.svg | 4 + docs/docs-gen/content/cdsp-logical-concept.md | 165 +++++++++++++----- docs/docs-gen/content/examples/_index.md | 6 +- 4 files changed, 128 insertions(+), 51 deletions(-) create mode 100755 docs/docs-gen/assets/Logical-Architecture-Overview.drawio.svg create mode 100755 docs/docs-gen/assets/cdsp-logical-concept.drawio.svg diff --git a/docs/docs-gen/assets/Logical-Architecture-Overview.drawio.svg b/docs/docs-gen/assets/Logical-Architecture-Overview.drawio.svg new file mode 100755 index 0000000..d3df452 --- /dev/null +++ b/docs/docs-gen/assets/Logical-Architecture-Overview.drawio.svg @@ -0,0 +1,4 @@ + + + +
Cloud2cloud
Cloud2cloud
Data Store
Data Store
HU
HU
Computing
Computing
ADAS
ADAS
TCU
TCU
Zone ECU
Zone ECU
ECU
ECU
ECU
ECU
ECU
ECU
ECU
ECU
wired e.g CAN, LIN, FlexRay
wired e.g CAN, LIN, FlexRay
ECU
ECU
ECU
ECU
ECU
ECU
ECU
ECU
e.g. Classic, QM OSEK
e.g. Classic, QM OSEK
Zone ECU
Zone ECU
ECU
ECU
ECU
ECU
ECU
ECU
ECU
ECU
wired e.g CAN, LIN, FlexRay
wired e.g CAN, LIN, FlexRay
ECU
ECU
ECU
ECU
ECU
ECU
ECU
ECU
e.g. Classic, QM OSEK
e.g. Classic, QM OSEK
Zone ECU
Zone ECU
ECU
ECU
ECU
ECU
ECU
ECU
ECU
ECU
wired e.g CAN, LIN, FlexRay
wired e.g CAN, LIN, FlexRay
ECU
ECU
ECU
ECU
ECU
ECU
ECU
ECU
e.g. Classic, QM OSEK
e.g. Classic, QM OSEK
Zone ECU
Zone ECU
ECU
ECU
ECU
ECU
ECU
ECU
ECU
ECU
wired e.g CAN, LIN, FlexRay
wired e.g CAN, LIN, FlexRay
ECU
ECU
ECU
ECU
ECU
ECU
ECU
ECU
e.g. Classic, QM OSEK
e.g. Classic, QM OSEK
e.g. Adaptive, QM Posix
e.g. Adaptive, QM Posix
e.g. QM Posix
e.g. QM Posix
e.g. Adaptive, QM Posix
e.g. Adaptive, QM Posix
e.g. QM Posix
e.g. QM Posix
COVESA Data Expert Group scope
COVESA Data Expert Group scope

Overview of COVESA Logical Architecture

Focus on functional integration and data architecture.
Diagram v1.1

Overview of COVESA Logical Architecture...
Wired, e.g ETH
Wired, e.g ETH
Internet
Internet
Internet
Internet
Wireless,e.g. BLE, Wifi
Wireless,e.g. BLE, Wifi
Wireless,e.g. 4G, 5G
Wireless,e.g. 4G, 5GText is not SVG - cannot display \ No newline at end of file diff --git a/docs/docs-gen/assets/cdsp-logical-concept.drawio.svg b/docs/docs-gen/assets/cdsp-logical-concept.drawio.svg new file mode 100755 index 0000000..283688c --- /dev/null +++ b/docs/docs-gen/assets/cdsp-logical-concept.drawio.svg @@ -0,0 +1,4 @@ + + + +
Central Data Service Playground
Central Data Service Playground
Persistence
(history of model, signals etc)
Persistence...
Data Models
(live data models, VSS, ..)
Data Models...
Application Logic / APIs
(VISS, Native API etc.)
Application Logic / APIs...Text is not SVG - cannot display \ No newline at end of file diff --git a/docs/docs-gen/content/cdsp-logical-concept.md b/docs/docs-gen/content/cdsp-logical-concept.md index a460e50..2a104a7 100644 --- a/docs/docs-gen/content/cdsp-logical-concept.md +++ b/docs/docs-gen/content/cdsp-logical-concept.md @@ -2,76 +2,145 @@ title: "Playground logical concept" --- -{{% notice warning %}} -This placeholder text comes from the Playground Proposal and will be replaced with a fuller discussion of the logical concept -{{% /notice %}} +## Importance of maintaining a logical concept +COVESA is a grass roots OSS automotive alliance. From a communication and community perspective it is important to maintain descriptions of the logical concepts. Discussion at a logical level allows different parties to collaborate on common concepts, whilst making different implementation decisions, e.g. in product/technology selection or system architecture for example. That however does not mean we need spend months in philosophical discussions before moving to implementation. Instead logical concepts (why, what) can be developed alongside implementation. -Logical Concepts +The Data Architecture team therefore intends to maintain concepts for both logical and implementation alongside each other for their projects using the playground. -From a communication and community perspective it is important to maintain descriptions of the logical concepts. Discussion at a logical level allows different parties to collaborate on common concepts, whilst making different implementation decisions, e.g. in product/technology selection or system architecture for example. That however does not mean we need spend months in philosophical discussions before moving to implementation. Instead logical concepts (why, what) can be developed alongside implementation. +Of course it is perfectly normal that in _using_ the playground to develop an idea, example or pattern, that an architecture and components are chosen as part of the design. -It is therefore proposed that the project maintain concepts for both logical and implementation alongside each other. +## Why _Central Data Service Playground_ ? -There is a parallel proposal within the Data Architecture group for documenting Covesa design patterns, architectures and Howtos, that could be used to publish such documents that result from work on this proposal. -Central Data Service Playground (Why, What, How) +### Problem +OEMs have presented various open questions and requirements in tackling growing software complexity. One representative list appears below. -Why Central Data Service? +Key questions for a End-to-End Data Architecture: +- How data can be shared between all touchpoints? +- How different domains of data share same tech +stack? +- How should a bidirectional sync work? +- Who is responsible for conflict management? +- Who takes care about permissions, roles, rights +and privacy? +- How the data model can be updated and synced? +- How subscriptions can be handled? +- How to handle historized and time series data ... +- ...on different touchpoints? +- How to handle multiple sync endpoints? +- How to handle unidirectional data streams? +- How (new) knowledge ... +- ... can be shared with others? - A repeating pattern of discussion in the Data Architecture pillar is the combination of VSS Data Server and VSS Data Store and their connection southbound to feeders/native data and northbound to clients and off-board. Hence Data Service. - VSS is a mechanism of abstraction. The logical architecture for the Data Expert Group and VSS places operation in the zonal ECUs and above. Discussion of next-gen and data-centric architectures suggests investigation into data services in zone, domain and HPC controller scenarios and the cooperation between them. Hence Central. - The name Central Data Service is not an attempt to introduce a new category of component. It is used here simply as a useful synonym for what otherwise would be a longer descriptive phrase explaining combinations of VSS centric Data Server and Store and their location in the vehicle. +Source: [_"Building Bridges with a common Data Middleware"_, BMW AG, COVESA Autumn 2023 AMM](https://wiki.covesa.global/download/attachments/78840403/COVESA_DataMiddleware-PoC-Status_v2.pdf?version=1&modificationDate=1698737955726&api=v2) - Why playground? Why not PoC? +At the same time there has been a realization that some problems require open collaboration. - A PoC is often a snapshot in time and often specific in scope. Playground suggests greater flexibility. The central service, the Lego building block, is intended to be flexible and evolving. Similarly with what it is combined with to illustrate Covesa concepts and technology. - The Playground could certainly be used to implement a PoC. - Patterns such as view/controller, out of the box data servers, data stores linked to applications (e.g. SQLite) etc are well known. The Service could in part be defined by what's not known, by open questions in next-gen architectures such as data-centric architectures, that needs to be tackled down. The Playground is the means to doing that and illustrating the results. +### Goal +The playground was first conceived by the COVESA Data Architecture team to meet their needs in addressing these problems. They also recognized similar needs in the wider community inside and outside COVESA. For example, for COVESA to demonstrate how VSS data can be used with its eco-system for newcomers. -How? +The playground goals from the introductory overview: - Address two high level implementation needs, keeping in mind a path towards production where possible: - Easy to develop: make it easy to build, modify and trial by providing an instance running on a host, e.g. using Docker container(s). - Closer to production: the same base code should be deployable to systems closer to production, including on automotive hardware (or its simulation), e.g. Yocto, container orchestration, SOA etc. - A path towards production can be supported by using production components, rather than overly simple substitutes, where it makes sense. For instance a particular scenario may use Kafka in a cloud connection. The point is not to pick a winning product in a particular category, but to recognise that using a production tool can represent a category that is known to scale. Detailed requirements for a specific production project and product selection for it, is rightly left to that project. - A generic code base for the basic building block should allow flexible compilation to meet those needs on x86 and ARM. The target for how it is used being a matter of deployment at a high level. - Follow the OSS mantra of adopt where you can, extend if needed, create where necessary. +_The Central Data Service Playground (CDSP) serves as a neutral, open playground for data services both within and outside the vehicle in the context of data-centric architectures. It enables investigation into the internals of these services and how they can be combined. Furthermore, the playground provides a means to publish and collaborate on such work in the open._ -What? +The following sections address the Why, What and How in more detail. - At its core the service has requirements in three key areas: +### Why _Central Data Service_? - Data Models: the live data models - VSS as the abstracted view of the vehicle, along with other adjacent data models such as personal data. - Persistence: history of the model and signals etc - historical and cached timeseries data. - Application logic / APIs: for accessing the data such as VISS or GraphQL. ++ VSS is a mechanism of abstraction. The COVESA logical architecture for the VSS eco-system shown below places operation in the 'big ECUs', in zonal ECUs and above. Discussion of next-gen and data-centric architectures suggests investigation into data services in zone, domain and HPC controller scenarios and the cooperation between them. Hence _Central_. - It is recognised that additional features, such as synchronisation are absolutely desirable and have been a part of discussions in the Data Architecture group. For this proposal a base feature set is described to help readers quickly grasp the concept. If the proposal proceeds then additional details will be created collectively based on interest and participation. +{{< figure src="Logical-Architecture-Overview.drawio.svg" title="The COVESA Logical Architecture" width=50pc >}} ++ A repeating pattern of discussion in the COVESA Data Architecture team is the combination of VSS Data Server and VSS Data Store with advanced features and their connection southbound to feeders/native data and northbound to clients and off-board. Hence _Data Service_. - As a starting point it is suggested that the Service could be realised as a basic building block combining VISS Data Protocol Server with highly functional VSS Data Store. - As well as the mentioned flexibility in implementation, flexibility in use is also intended: - With some supporting documentation it could help meet the ongoing request from newcomers to the VSS eco-system as to how VSS can be used. - The Data Architecture group for instance has various topics it wishes to investigate related to data-centric architectures. - The playground can be used to investigate internals of such a service. For example, connecting VISS to medium and high speed data, or adding a protocol. - External connections with other systems may also be a focus. For example, combining the Service with other components to implement a particular touchpoint such as mobile. - Further details can be found in the following sections. ++ The name Central Data Service is not an attempt to introduce a new category of component. It is used here simply as a useful synonym for what otherwise would be a longer descriptive phrase explaining combinations of VSS centric Data Server and Store and their location in the vehicle. -The Service in context + ### Why _Playground_? Why not PoC? -To help understand its use lets quickly place the service in context. ++ A PoC is often a snapshot in time and often specific in scope. Playground suggests greater flexibility. The central service, the Lego building block, is intended to be flexible and evolving. Similarly with what it is combined with to illustrate COVESA concepts and technology. -Big picture: The logical architecture for the Data Expert Group places the scope of the work as Zonal ECUs and above as shown in the following diagram: ++ The Playground could certainly be used to implement a PoC. -It is assumed that the service would likely be deployed on a Zone, Domain or Central controller, with corresponding h/w capabilities. ++ Patterns such as view/controller, out of the box data servers, data stores linked to applications (e.g. SQLite) etc are well known. The Service could in part be defined by what's not known, by open questions in next-gen architectures such as data-centric architectures, that needs to be tackled down. The Playground is the means to doing that and illustrating the results. -Interaction between Large ECU: In the Data Architecture group it is recognised that zone/domain specific data services will need to synchronise and cooperate between themselves and/or with a central vehicle computer, e.g. Inter-controller sync/cooperation: +## What? -In-vehicle southbound: The service will integrate southbound to lower parts of the vehicle and its native data, through data feeders and connectors. This will include making connections to other systems such as Autosar etc. +### Requirements -Northbound: connections will be made to clients, mobile, cloud and major in-vehicle domains such as IVI running Android/Apple etc. +{{< figure src="cdsp-logical-concept.drawio.svg" title="The data service core requirements" >}} -Logical domains: Connections may also be made to other logical data domains. For example, there is knowledge layer proposal made in the Data Architecture Group that discusses the separation of concerns and interaction between knowledge, information and raw data layers. The Service described here could be used to provide the data layer services in its investigation. -Success Factors +At its core the service has requirements in three key areas: - Newcomers to Covesa technology use the playground to accelerate their understanding of how the technology can be used. That could be a looking at a simple instance of how a VSS data server is combined with a VSS data store and queried using VISS. It could also be a more complex instance that combines components to illustrate a longer specific end to end use case, e.g. mobile to vehicle connection. - Internal groups within Covesa naturally use the logical concepts and the playground implementation in combination with other components to develop and disseminate ideas. This especially applies to the Data Architecture and Infrastructure pillar. - Supporting materials such as patterns, diagrams, cookbooks etc are adopted as useful assets within and outside Covesa, which in turn helps socialisation. \ No newline at end of file +1. Data Models: the live data models - VSS as the abstracted view of the vehicle, along with other adjacent data models such as personal data. + +2. Persistence: history of the model and signals etc - historical and cached timeseries data. + +3. Application logic / APIs: standardized APIs for accessing the data such as the [Vehicle Information Service Specification (VISS)](https://github.com/COVESA/vehicle-information-service-specification) + or GraphQL. + +_Additional requirements:_ It is recognized that additional features, such as synchronization are absolutely desirable and have been a part of discussions in the Data Architecture team. Such features may also already be part of the feature set of the playground components. For example, both the Apache IoTDB and MongoDB Realm databases have sync capabilities. A base feature set is described as a starting point to help readers quickly grasp the concept. Additional features will be created or illustrated collectively based on interest and participation. + +### Components + +As a starting point the playground has been realized as a 'project of projects' to create the basic building block data service. Achieved by combining a VISS Data Protocol Server with highly functional VSS Data Stores. + +The VISS Protocol Server principally provides northbound get/set/sub application logic using the VISS protocol. Along with the secondary benefit of any additional features provided by the server. + +'Highly functional' in the context of the VSS Data Store means the flexible means to store, query, process and analysis timeseries data. An archetype would be a database server that can operate in-vehicle and the cloud. Such a component provides the possibility of using a variety of different architecture patterns, such as both client-server and event-driven, or data processing approaches. + +### Flexibility in use + +As well as the mentioned flexibility in implementation, flexibility in use is also intended: + ++ With some supporting documentation it can help meet the ongoing request from newcomers to the VSS eco-system as to how VSS can be used. + ++ The Data Architecture group has various topics it wishes to investigate related to data-centric architectures. Data layer topics such as sync, data reduction and data quality. Also separation of concerns and cooperation between data and knowledge layers. + ++ The playground can be used to investigate internals of data services. For example, connecting to medium and high speed data, or adding a protocol. + ++ External connections with other systems may also be a focus. For example, combining the service with other components to implement a particular touchpoint such as mobile. + +Further details can be found in the following sections. + +### The Playground in context + +To help understand its use lets quickly place the playground in context. + +**Big picture**: As stated above the COVESA logical architecture places its scope at Zonal ECUs and above as shown in the diagram. It is assumed that the playground would likely be deployed on a Zone, Domain or Central controller, with corresponding h/w capabilities. + +**Interaction between 'Large ECU'**: In the COVESA Data Architecture team it is recognized that zone/domain specific data services will need to synchronize and cooperate between themselves and/or with a central vehicle computer, e.g. Inter-controller sync/cooperation: + +![Cooperation between zonal data stores and central data service/store](https://raw.githubusercontent.com/slawr/vss-otaku/master/in-vehicle-storage/apache-iotdb/doc/zonal-vss-store-cooperation.drawio.svg "Cooperation between zonal data stores") +Source: [vss-otaku](https://github.com/slawr/vss-otaku) + +**In-vehicle southbound**: The playground can be integrated southbound to lower parts of the vehicle and its native data, through data feeders and connectors. This can include making connections to other systems such as Autosar etc. + +**Northbound**: connections will be made to clients, mobile, cloud and major in-vehicle domains such as IVI running Android/Apple etc. + +**Logical domains**: Connections may also be made to other logical data domains. For example, there is an [knowledge layer proposal](https://wiki.covesa.global/x/cYI8B) made in the COVESA Data Architecture team that discusses the separation of concerns and interaction between knowledge, information and raw data layers as illustrated below. The Playground here could be used to provide the data/information layer services in its investigation. + +![Knowledge layer proposal](https://wiki.covesa.global/download/attachments/71074417/Knowledge-Layer-v3.png?api=v2?width=50pc "Deployment illustration from the proposal") + Source: [knowledge layer proposal](https://wiki.covesa.global/x/cYI8B) + +### Project success factors + +1. Newcomers to COVESA technology use the playground to accelerate their understanding of how the technology can be used. That could be a looking at a simple instance of how a VSS data server is combined with a VSS data store and queried using VISS. It could also be a more complex instance that combines components to illustrate a longer specific end to end use case, e.g. mobile to vehicle connection. + +2. Internal groups within COVESA naturally use the logical concepts and the playground implementation in combination with other components to develop and disseminate ideas. This especially applies to the Data Architecture and Infrastructure pillar. + +3. Supporting materials such as patterns, diagrams, cookbooks etc are adopted as useful assets within and outside COVESA, which in turn helps socialization. + +## How? + ++ Address two high level implementation needs, keeping in mind a path towards production where possible: + + - Easy to develop: make it easy to build, modify and trial by providing an instance running on a host, e.g. using Docker container(s). + + - Closer to production: the same base code should be deployable to systems closer to production, including on automotive hardware (or its simulation), e.g. Yocto, container orchestration, SOA etc. + ++ A path towards production can be supported by using production components, rather than overly simple substitutes, where it makes sense. For instance a particular scenario may use Kafka in a cloud connection. The point is not to pick a winning product in a particular category, but to recognize that using a production tool can represent a category that is known to scale. Detailed requirements for a specific production project and product selection for it, is rightly left to that project. + ++ A generic code base for the basic building blocks should allow flexible compilation to meet those needs on multiple architectures, e.g. x86, ARM and RISC-V. The target for how it is used being a matter of deployment at a high level. + ++ Follow the OSS mantra of adopt where you can, extend if needed, create where necessary. + ++ Promote flexible reconfiguration of components by favouring loose coupling over tight coupling. \ No newline at end of file diff --git a/docs/docs-gen/content/examples/_index.md b/docs/docs-gen/content/examples/_index.md index 479709b..3b64ba1 100644 --- a/docs/docs-gen/content/examples/_index.md +++ b/docs/docs-gen/content/examples/_index.md @@ -4,16 +4,16 @@ title: "Playground examples" Learn how to use the playground by stepping through examples. -Note: If you are wondering why there is not a section for the VSS data model it is because the vast majority of the examples will be making use of it. +Note: There is not a seperate section for the VSS data model because the vast majority of the examples will be making use of it. ## Getting started [Docker sanity test](https://github.com/COVESA/cdsp/blob/main/docker/README.md) \| [Hello-world](https://github.com/COVESA/cdsp/tree/main/examples/cdsp-hello-world) -## Data Layer and Data Manipulation +## Data Layer and Data Processing / Analysis Data Reduction \| Data Quality \| Events \| Data Streams etc. ## Knowledge Layer, Reasoning and Data Models -[Data Layer Connector](https://wiki.covesa.global/display/WIK4/Artifact+JSON-RDF+Converter) \| A \| B \| C etc. +Data Layer Connector \| A \| B \| C etc. ## Feeders RemotiveLabs \| WAII VISS \| etc.