CommsDSL Specification
  • Introduction
  • Version
  • Schema Definition
  • Multiple Files
  • Namespaces
  • Platforms
  • References
  • Properties
  • Numeric Values
  • Boolean Values
  • Names
  • Protocol Versioning
  • Schema
  • Fields
    • Common Properties of Fields
    • enum Field
    • int Field
    • set Field
    • bitfield Field
    • bundle Field
    • string Field
    • data Field
    • list Field
    • float Field
    • ref Field
    • optional Field
    • variant Field
    • Referencing Values of Other Fields
  • Messages
  • Interfaces
  • Aliases
  • Frames
    • Common Properties of Layers
    • payload Layer
    • id Layer
    • size Layer
    • sync Layer
    • checksum Layer
    • value Layer
    • custom Layer
  • Protocol Versioning Summary
  • Appendix
    • Properties of schema
    • Common Properties of Fields
    • Properties of enum Field
    • Properties of int Field
    • Properties of set Field
    • Properties of bitfield Field
    • Properties of bundle Field
    • Properties of string Field
    • Properties of data Field
    • Properties of list Field
    • Properties of float Field
    • Properties of ref Field
    • Properties of optional Field
    • Properties of variant Field
    • Units
    • Properties of message
    • Properties of interface
    • Properties of alias
    • Properties of frame
    • Common Properties of Layers
    • Properties of checksum Layer
    • Properties of value Layer
    • Properties of custom Layer
Powered by GitBook
On this page

Was this helpful?

  1. Appendix

Properties of message

PreviousUnitsNextProperties of interface

Last updated 5 years ago

Was this helpful?

Refer to chapter for detailed description.

Property Name

Allowed type / value

DSL Version

Required

Default Value

Description

name

string

1

yes

Name of the message.

id

1

yes

Numeric ID of the message.

description

string

1

no

Human readable description of the message.

displayName

string

1

no

Name of the message to display. If empty, the code generator must use value of property name instead.

copyFieldsFrom

string

1

no

Message definition from which fields need to be copied.

order

1

no

0

Relative order of the messages with the same id.

sinceVersion

1

no

0

Version of the protocol in which message was introduced.

deprecated

1

no

max unsigned

Version of the protocol in which message was deprecated. Must be greater than value of sinceVersion.

removed

1

no

false

Indicates whether deprecated message has been removed from being supported.

sender

"both", "client", "server"

1

no

both

Endpoint that sends the message.

customizable

1

no

false

Mark the message to allow compile time customization regardless of code generator's level of customization.

copyFieldsAliases

3

no

true

Control copy of the defined when copyFieldsFrom property is used to copy fields from the other .

Extra child XML elements allowed:

XML Element

DSL Version

Description

<fields>

1

Wraps member fields.

<alias>

3

Alias names for other member fields. See for more info.

Messages
name
numeric
reference
numeric
unsigned
unsigned
bool
bool
bool
aliases
<message>
Aliases