Skip to content

Conversation

@tigroo
Copy link
Collaborator

@tigroo tigroo commented Jan 27, 2026

No test, we provide a new optional field linked station id.

Signed-off-by: Frédéric Gardes <frederic.gardes@orange.com>
Signed-off-by: Frédéric Gardes <frederic.gardes@orange.com>
Signed-off-by: Frédéric Gardes <frederic.gardes@orange.com>
@tigroo tigroo requested a review from ymorin-orange January 27, 2026 13:55
@tigroo tigroo self-assigned this Jan 27, 2026
@tigroo tigroo added documentation Improvements or additions to documentation Schema JSON schema files labels Jan 27, 2026
@tigroo tigroo moved this to In Progress in its-client Jan 27, 2026
@tigroo tigroo added this to the Sprint 17 milestone Jan 27, 2026
"version": {
"type": "string",
"description": "JSON message format version.",
"const": "2.3.1-dev"
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is a minor, backward compatible evolution, so the minor version should be updated, not the patchlevel, so it should be 2.4.0.

"const": "2.3.1-dev"
},
"linked_station_id": {
"type": "integer",
Copy link
Member

@ymorin-orange ymorin-orange Jan 28, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think it would be better is that were an array rather than a single object. Indeed, there are tractors that may have two (or more!) trailers; for example
image

Also, for platooning, there might be a bunch of following trucks, so the head of the platoon would need to link to all the trucks that follows it (and individual trucks may also want to link to their own followers.

Do we also want to identify the type of link: following or leading?

{
  "linked_station_ids": {
    "type": "array",
    "description": "list of following or leading stations IDs",
    "minItems": 1,
    "items": {
      "type": "object",
      "description": "Linked station",
      "required": ["station_id"],
      "properties": {
        "station_id": {
          "type": "integer",
          "description": "Identifier for a linked ITS-S, as a trailer or a platooning pair.",
          "minimum": 0,
          "maximum": 4294967295,
          "examples": [
            4294967295,
            42
          ]
        },
        "relation": {
          "type": "string",
          "description": "how the linked station relates to this one",
          "enum": [
            "trailer",
            "tractor",
            "platoon"
          ]
        },
        "order": {
          "type": "string",
          "description": "whether the linked station trails or leads this one",
          "enum": [
            "trails",
            "leads",
          ]
        }
      }
    }
  }
}

Copy link
Member

@ymorin-orange ymorin-orange left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

  • change the version to 2.4.0
  • maybe extend the schema to allow for more flexibility in the relationship description, as suggested in the comment

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation Schema JSON schema files

Projects

Status: In Progress

Development

Successfully merging this pull request may close these issues.

2 participants