Details

    • Type: New Feature
    • Status: Closed
    • Priority: Major
    • Resolution: Fixed
    • Affects Version/s: 5
    • Fix Version/s: 5
    • Component/s: core
    • Labels:
      None
    • Resolution:
      Hide

      TC Approved, move to editors.

      Show
      TC Approved, move to editors.

      Description

      This was discussed in MQTT-276 with notes from the F2F meetings and has been tracked in MQTT-256.

      I'm opening a separate, specific issue per Ken's comments - https://issues.oasis-open.org/browse/MQTT-256?focusedCommentId=62192page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel#comment-62192:

      "All of these would be defined in separate JIRAs, but what we should do in this JIRA is to define the mechanism used to pass these values."

        Attachments

          Activity

          Hide
          kdot Konstantin Dotchkoff [X] (Inactive) added a comment -

          Proposal for encoding custom metadata :
          A specific optional field Id is introduced for custom metadata. Unlike other optional fields (which are defined with a specific data type for the value), the custom field Id is followed by two strings in an MQTT packet. The first string represents a custom name for the optional field and the second string is used for the value.
          In an MQTT packet the custom field Id can be repeated, which allows to include multiple custom metadata fields in a single MQTT packet.

          Show
          kdot Konstantin Dotchkoff [X] (Inactive) added a comment - Proposal for encoding custom metadata : A specific optional field Id is introduced for custom metadata. Unlike other optional fields (which are defined with a specific data type for the value), the custom field Id is followed by two strings in an MQTT packet. The first string represents a custom name for the optional field and the second string is used for the value. In an MQTT packet the custom field Id can be repeated, which allows to include multiple custom metadata fields in a single MQTT packet.
          Hide
          levell Jonathan Levell added a comment -

          I like Konstantin's proposal very much.

          Show
          levell Jonathan Levell added a comment - I like Konstantin's proposal very much.
          Hide
          edbriggs Ed Briggs [X] (Inactive) added a comment -

          I have proposed a way of representing this custom data in MQTT-304 (User Defined CONNECT tags) and if we reach agreement in that Jira, I'll cut and paste the agreed format here too (since it is the same data type, just used in a different command packet)

          Show
          edbriggs Ed Briggs [X] (Inactive) added a comment - I have proposed a way of representing this custom data in MQTT-304 (User Defined CONNECT tags) and if we reach agreement in that Jira, I'll cut and paste the agreed format here too (since it is the same data type, just used in a different command packet)
          Hide
          edbriggs Ed Briggs [X] (Inactive) added a comment -

          TC approved on 6/Oct/2016 Resolved, assigned to edit.

          Summary:

          type name: user defined name-value pair = 0xNN (TBD)

          ident : byte = 0xNN

          {TBD}

          length: Variable Byte Integer
          name : UTF-8 encoded string
          value : UTF-8 encoded string

          The user defined name-value pair is an optional value that used in PUBLISH command packets to carry 'application layer' information which is NOT interpreted by MQTT. This is an optional data item, and may appear zero or more times in a PUBLISH command packet.

          A Server receiving this tag MUST check that two string fields contain valid UTF-8 strings. The format, meaning, and uniqueness of the name is not otherwise processed or enforced by MQTT. Servers MUST preserve the order of these tags when processing them.

          I thank the TC for the benefit of their comments and prompt consideration.

          Show
          edbriggs Ed Briggs [X] (Inactive) added a comment - TC approved on 6/Oct/2016 Resolved, assigned to edit. Summary: type name: user defined name-value pair = 0xNN (TBD) ident : byte = 0xNN {TBD} length: Variable Byte Integer name : UTF-8 encoded string value : UTF-8 encoded string The user defined name-value pair is an optional value that used in PUBLISH command packets to carry 'application layer' information which is NOT interpreted by MQTT. This is an optional data item, and may appear zero or more times in a PUBLISH command packet. A Server receiving this tag MUST check that two string fields contain valid UTF-8 strings. The format, meaning, and uniqueness of the name is not otherwise processed or enforced by MQTT. Servers MUST preserve the order of these tags when processing them. I thank the TC for the benefit of their comments and prompt consideration.
          Hide
          edbriggs Ed Briggs [X] (Inactive) added a comment -

          Added to WD07. Closing.

          Show
          edbriggs Ed Briggs [X] (Inactive) added a comment - Added to WD07. Closing.

            People

            • Assignee:
              edbriggs Ed Briggs [X] (Inactive)
              Reporter:
              edbriggs Ed Briggs [X] (Inactive)
            • Watchers:
              3 Start watching this issue

              Dates

              • Due:
                Created:
                Updated:
                Resolved: