Skip to content

Commit ccd04ef

Browse files
author
Alain Bouchard
committed
proposed modifications after the meeting of october 9
1 parent da37dcc commit ccd04ef

File tree

2 files changed

+8
-2
lines changed

2 files changed

+8
-2
lines changed

README.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,7 @@ This repository holds the source for this Specification, part of the family of [
99

1010
### What does it do?
1111

12+
- Establishes a new IS-05 transport for NMOS Senders and Receivers implementing USB over IP and allows Controllers to establish compatible connections.
1213
- Establishes a standardized mechanism for NMOS Senders and Receivers to declare support for USB over IP transport streams using IPMX/USB (VSF TR-10-14).
1314

1415
### Why does it matter?

docs/NMOS-With-IPMX-USB.md

Lines changed: 7 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -45,6 +45,8 @@ A `usb_device` object is defined as:
4545
```
4646
A USB Source MAY include a `usb_devices` attribute, which is an array of `usb_device` objects. This attribute describes the USB devices accessible to a Receiver via the USB data stream. Inclusion of this information is optional.
4747

48+
The `ipmx_bus_id` attribute is represented as an array of 64 bytes as in the messages defined by [TR-10-14][]. A Controller MAY present this attribute to a User as a string made of the UTF-8 character codes stored in the `ipmx_bus_id` array. The `ipmx_bus_id` array stores the original bytes of the messages to prevent issues arising from string representations that differ from the real values within the IPMX/USB stream.
49+
4850
Examples of Source resources are provided in [Examples](./examples).
4951

5052
### Flows
@@ -63,7 +65,7 @@ The Sender MUST express its limitations or preferences regarding the USB streams
6365

6466
The `constraint_sets` parameter within the `caps` object MUST be used to describe combinations of parameters the Sender can support, using the parameter constraints defined in the [Capabilities Register](https://specs.amwa.tv/nmos-parameter-registers/branches/main/capabilities/) of the NMOS Parameter Registers.
6567

66-
A Sender SHOULD provide the `urn:x-nmos:cap:transport:usb_class` capability to indicate the USB classes (integers in the range 0 to 255) supported by the Sender. See [USB](https://www.usb.org) for class code definitions.
68+
A Sender SHOULD provide the `urn:x-nmos:cap:transport:usb_class` capability to indicate the USB classes (integers in the range 0 to 255) supported by the Sender. See [USB Class Codes](https://www.usb.org/defined-class-codes) for class code definitions.
6769

6870
A USB Sender operates as a TCP/IP server and accepts connections from USB Receivers. The underlying transport protocol for `urn:x-nmos:transport:usb` is TCP, optionally using MPTCP (MultiPath TCP) for redundancy.
6971

@@ -95,7 +97,7 @@ The Receiver MUST express its limitations or preferences regarding the USB strea
9597

9698
The `constraint_sets` parameter within the `caps` object MUST be used to describe combinations of parameters that the Receiver can support, using the parameter constraints defined in the [Capabilities Register](https://specs.amwa.tv/nmos-parameter-registers/branches/main/capabilities/) of the NMOS Parameter Registers.
9799

98-
A USB Receiver SHOULD provide the `urn:x-nmos:cap:transport:usb_class` capability to indicate the USB classes (integers in the range 0 to 255) supported by the Receiver. See [USB](https://www.usb.org) for class code definitions.
100+
A USB Receiver SHOULD provide the `urn:x-nmos:cap:transport:usb_class` capability to indicate the USB classes (integers in the range 0 to 255) supported by the Receiver. See [USB Class Codes](https://www.usb.org/defined-class-codes) for class code definitions.
99101

100102
A USB Receiver operates as a TCP/IP client. A USB Sender accepts connections from Receivers. The underlying transport protocol for `urn:x-nmos:transport:usb` is TCP, optionally using MPTCP (MultiPath TCP) for redundancy.
101103

@@ -165,6 +167,9 @@ A Controller SHOULD use a Sender's `urn:x-nmos:cap:transport:usb_class` capabili
165167

166168
> Note: There is no `usb_class` Sender attribute, as might typically be expected, because a USB stream is composed of multiple sub-streams, each of which can be associated with multiple USB classes. The set of classes present in a given USB stream often changes dynamically.
167169
170+
A Controller SHOULD NOT use the optional `usb_devices` attribute of a USB Source to establish compatibility for the `urn:x-nmos:cap:transport:usb_class` capability but it MAY use it to provide feedback to a User about the USB devices that would be ignored by a Receiver.
171+
172+
168173
[RFC-2119]: https://tools.ietf.org/html/rfc2119 "Key words for use in RFCs"
169174
[IS-11]: https://specs.amwa.tv/is-11/ "AMWA IS-11 NMOS Stream Compatibility Management Specification"
170175
[BCP-004-01]: https://specs.amwa.tv/bcp-004-01/ "AMWA BCP-004-01 NMOS Receiver Capabilities"

0 commit comments

Comments
 (0)