Adding a Source - RIST

zen master can receive a source directly from a rist input rist seeks to provide reliable, high performance media transport by using udp at the transport layer to avoid the inefficiencies of tcp, then layering on top forward error correction and retransmits to add the reliability inherently absent from udp zixi broadcaster supports rist streams from any compliant rist device zixi supports the following rist profiles simple profile – (zixi broadcasters v13+) the rist simple profile provides best in class packet protection, as well as support for multi link bonding and seamless switching main profile – (zixi broadcasters v14)the rist main profile builds upon the features of the simple profile to provide backwards compatibility, while opening the door for additional features, including encryption and authentication rist main profile uses industry standard dtls or psk with a variety of available cyphers to ensure the most up to date protection, while being flexible to accommodate local legal regulations support for pre shared keys is also included, which makes rist main profile compatible with one to many environments such as satellite or multicast distribution native tunneling and multiplexing the ability to combine multiple simple profile rist streams into one single connection, optionally with one single encryption and authentication step, using industry standard gre over udp bandwidth optimization by deleting null packets at the source and re inserting them at the destination support for high bit rate streams the rist main profile includes an rtp header extension which increases the sequence number size to 32 bits, and therefore increases the maximum size of retransmission buffers, and thus opens the door for higher bitrate streams, such as lightly compressed (e g jpeg 2000, tico) and uncompressed video contact your zixi representative to learn more about interoperability testing between zixi broadcaster and 3rd party devices more details about rist can be found at http //www rist tv/ the following procedure describes how to add a rist source in zen master in addition, an explanation of each of the configuration parameters is given in the table below to add a rist source in the main navigation, click sources click + add the create new source selection window is displayed create source options click on rist the create new rist source window opens new rist source in the info section, in the name field, enter a unique name to identify this source in the system in the tags field, select one or more of the predefined tags from the drop down list tags are used for access control by selecting a tag, you are relating this source to that tag tags are associated with certain roles (through the users & roles screen), and roles, in turn, are associated with users and user groups if you would like to create a new tag, see docid\ ypm9tw81ap6nq8stkv4rd in the events configuration profile field, select from the dropdown list the profile that you would like to apply to this source by default, the default profile is applied events profiles consist of a series of rules that determine precisely how various types of events are logged and what results they trigger the source's location is used to represent it in the proper position in the map display (see docid\ sfzm6jvorvuigo7x0dnue ) by default, the location is determined automatically based on the source's ip if you would like to manually set the location of the source (optional), use the following procedure click on the edit icon next to the location field a search box is shown below the location field enter identifying info for the location (e g street address, zip code, coordinates) search results are displayed below the search box as you type click on the desired location the selected location populates the location field in the rist configuration section, under profile, select the radio button for the desired profile options are simple (default) or main if you selected simple , then fill in the configuration fields as follows if you would like to join a multicast group, in the multicast address field enter the multicast address note the multicast address should be in the range of 224 0 0 0 239 225 255 255 if you entered a multicast address , then, in the source specific multicast field, you can specify a particular ip from which you will accept data in the port field, specify the port to listen on for the incoming content note this port must be open on all firewalls between the ingest cluster and the input device if you would like to use fec, then select the use forward error correction checkbox note when fec is used, repair packets are sent on additional ports, enabling packet recovery if you selected main , then then fill in the configuration fields as follows under mode , select the mode used for sending the stream options are push or pull in the port field, specify the port to listen on for the incoming content for pull mode, in the remote host field, enter the hostname of the rist server for pull mode, in the remote port field, specify the remote port in the source rist device default 0 (any port) if you would like to use fec, then select the use forward error correction checkbox if you would like to use dtls, select the use datagram transport layer security checkbox in the max bitrate field, select from the drop down list the maximum bitrate for this source make sure that the value is greater than the max bitrate of the input if you are unsure of the max bitrate, set the value to approximately twice the actual (average) bitrate the default is set automatically based on the current bitrate of the input see docid\ ijrn4v8zgysjokxevckhx in the latency field, enter the latency in milliseconds (default 4000 ) in the source configuration section, in the ingest cluster field, select from the drop down list one of the available ingest clusters as the destination for the source in the target broadcaster/s field, select your broadcaster preference either select a specific broadcaster to be used or specify your preference for using primary vs backup broadcasters, options are prefer primary broadcasters, primary broadcasters only, backup broadcasters only or prefer backup broadcasters for managed clusters, it is not recommended to select a specific broadcaster, as the broadcaster’s availability may not remain stable in the input nic field, if you would like to specify which nic is used, then select the ip of that nic from the drop down list by default, any is selected if you would like to apply a pid mapping profile to this source, then in the pid mapping profile field, select the desired profile from the dropdown list using this method creates a single source in zen master with pid mapping applied if you would like to maintain a source with the original pids and create an additional source with pid mapping (e g if you want to create several different pid mapped variations), then use the method described in docid\ gockl3upsd8v14ia2an6g to create a new pid mapping profile, see docid\ gftcayurpl7dinouyd14z select the alert on pid changes checkbox if you would like to generate email notifications whenever a pid change is detected select the log scte 35 checkbox if you would like to log scte 35 markers for this stream to log scte 35 markers, scte 35 needs to be enabled both on the ingest cluster and on the source configuration scte 35 logging is only available for v13 1 40262+ broadcasters if log scte 35 was selected, you can choose to receive alerts for scte 35 markers by selecting the enable scte 35 alerts checkbox in the public output field, if you would like to allow access to the stream directly through a supported player, select the allow checkbox if you selected the allow checkbox, then enter a password in the password field to authenticate access to the stream under content analysis select one of the following options full select this option if you would like to enable full content analysis (cqa), including analysis of the stream's audio and video content, including audio levels, audio silence detection, frozen video detection, and more tr101 only select this option to perform tr101 analysis only (without video and audio content analysis) the analysis can be used to check the integrity of the ts and the most important elements of the stream the analysis includes priority 1 and 2 to learn more about tr101 analysis see https //www etsi org/deliver/etsi tr/101200 101299/101290/01 03 01 60/tr 101290v010301p pdf none no content analysis is enabled it is generally recommended to enable full content analysis unless it is causing technical problems if content analysis is disabled, the system won't detect errors in the video and audio content of the stream and won't generate warnings for such events if you would like to monitor cea 608 closed captions, select monitor cea 608 checkbox monitoring cea 608 closed captions requires using a version 14 4 or newer broadcaster if you would like to monitor cea 708 closed captions, select monitor cea 708 checkbox monitoring cea 708 closed captions requires using a version 14 4 or newer broadcaster if you would like to disable auto pull, select the disable auto pull checkbox disabling auto pull will lock channels using this source to the source's ingest cluster and targets to the source's current active broadcaster this setting only applies to pass through channels if auto pull is enabled , in the auto pull latency \[ms] field, specify the maximum latency for auto pull actions (default 1000 ms) in the webrtc playback section, select the desired playback method webrtc enables you to monitor the stream via web browsers and mobile applications with real time communication (rtc) webrtc needs to be activated independently for each source in zen master (by default it is disabled) select one of the following options disabled users will not be able to view this source using webrtc (default) pass through passes the stream through to webrtc without transcoding this option can only be used if the input stream is already in a webrtc compliant format (video h 264 codec with baseline or main profile and no b frames, audio opus codec) auto zen master automatically transcodes the stream using the optimal profile for each specific user in this option zixi broadcaster will decode the video, transforming it into raw frames, which will be passed to the webrtc library, where it will be re encoded for each individual user best quality however, if monitored by multiple users this can consume extensive resources 1080p/720p/480p/360p zen master transcodes the stream to a webrtc compliant profile with the specified resolution the transcoding is done by zixi broadcaster's transcoder this method requires a zixi broadcaster with x264 or nvidia for transcoding this method allows many users to monitor the stream without encoding separately for each individual user, which saves cpu capacity since there is only one stream version, it is recommended to encode to a low resolution and low bitrate so that the stream will be viewable by all users monitoring the stream additional scte 35 options are available when you expand the scte 35 manipulation section scte 35 manipulation here you can enable scte 35 insertion specify the length of a search window for a null packet for scte 35 intertion set the scte 35 pid remove any existing scte 35 messages from the stream see the parameters table below for an explanation of these options in the initial state section, select the disabled checkbox if you would like to disable this source upon initial configuration select the muted checkbox if you would like to disable error/recovery notifications for this source upon initial configuration you can enable/unmute the source at any time under error concealment, click the enable error concealment checkbox to enable the following error concealment mechanisms that can correct trasnaport stream for downstream irds error concealment options 1\ continuous timeline corrects errors that are related to timeline jumps in the source this mechanism will normalize the timeline by creating a variant of the input (the input is doubled) and normalizing the timeline of the doubled input 2\ replace frames if there are frames with cc errors, it replaces them with skip frames (inserts the last good frame received in place of missing ones) this solves issues such as an ird that lost synchronization when it received broken frames this mechanism also creates a variant of the input (doubling the input) 3\ renumber cc the continuity counter is part of the ts encapsulation when there are cc errors in tr101 analysis it means that the counter has a gap due to the lost frames this mechanism can re write the cc counter for the downstream devices, so they will see a continuous increase of the counter 4\ delay (ms) enter the delay that the error concealment adds to the stream in miliseconds error concealment needs to buffer the stream to analyze it one second is a reasonable value lower values may cause the error concealment to not be able to fix some of the frames 5\ cbr padding enter a value for the rate at which padding will be added to maintain a specific output transport bitrate for example, if you have a video bitrate at 5000 kbps or that varies from 3000 5000 kbps and audio at 64 kbps, total bitrate will be max 5064 kbps or min 3064 kbps with cbr padding set at 6000 kbps, 6000 kbps is being delivered downstream at all times, ensuring a consistent bitrate 6\ pcr interval select the frequency at which program clock reference is inserted into the outputs transport stream this depends on standard used by downstream encoders or decoders options include atsc standard 100 ms dvb standard 40 ms see docid 9 olo1argk 2adoshyfbb for more information if you would like to adjust the advanced settings, click advanced the advanced settings fields are displayed advanced settings if you would like to track usage for this source, enter your billing code details see docid\ lalxj n928tegcpdpbirj in the auto pull mtu field, specify the maximum transmission unit (largest data packet that a network connected device will accept) in bytes for the auto pull to apply input nic selection to the network device, select the apply input nic selection to network device checkbox to set the detection of frozen video, in the frozen video minimal duration field, specify the default minimal duration in seconds of frozen video after which the broadcaster will trigger a frozen video alert default 10 seconds this setting is supported for broadcaster version 16 3 and higher to set the detection of blank video, in the blank video minimal duration field, specify the default minimal duration in seconds of blank video after which the broadcaster will trigger a blank video alert default 10 seconds this setting is supported for broadcaster version 16 3 and higher click save rist source configuration parameters table parameter description info name specify a name for the rist source in zen master tags select one or more of the predefined tags from the drop down list tags are used for access control by selecting an tag, you are relating this source to that tag tags are associated with certain roles (through the users & roles screen), and roles, in turn, are associated with users and user groups if you would like to create a new tag, see docid\ ypm9tw81ap6nq8stkv4rd events configuration profile select from the dropdown list the profile that you would like to apply to this source by default, the default profile is applied note event profiles consist of a series of rules that determine precisely how various types of events are logged and what results they trigger location (optional) the source's location is used to represent it in the proper position in the map display (see docid\ sfzm6jvorvuigo7x0dnue ) by default, the location is determined automatically based on the source's ip enter identifying info for the location (e g street address, zip code, coordinates) and select the desired location from the suggestions that are shown rist configuration profile select the radio button for the desired profile options are simple (default) or main for simple multicast address if you would like to join a multicast group, enter the multicast address the multicast address should be in the range of 224 0 0 0 239 225 255 255 source specific multicast specify a particular ip from which you will accept data port specify the port to listen on for the incoming content this port must be open on all firewalls between the ingest cluster and the input device use forward error connection (fec) if you would like to use fec, then select this checkbox when fec is used, repair packets are sent on additional ports, enabling packet recovery max bitrate in the max bitrate field, select from the drop down list the maximum bitrate for this source latency {ms} select the latency time for the stream (default 4000) for main mode select the mode used for sending the source options are push or pull for push mode port specify the port to listen on for the incoming content this port must be open on all firewalls between the ingest cluster and the input device use forward error correction (fec) if you would like to use fec, then select this checkbox when fec is used, repair packets are sent on additional ports, enabling packet recovery use datagram transport layer security (dtls) if you would like to encrypt the stream dynamically using dtls, select this checkbox max bitrate in the max bitrate field, select from the drop down list the maximum bitrate for this source max bitrate is used by the broadcaster to determine buffer size when processing the transport stream it does not cap the bitrate we recommend setting it to 1 5x or 2x the actual (average) bitrate setting the max bitrate too low may result in dropped frames and other issues latency (ms) select the latency time for the stream (default 4000) for pull mode port specify the port to listen on for the incoming content this port must be open on all firewalls between the ingest cluster and the input device remote host enter the hostname of the rist server remote port specify the remote port in the source rist device default 0 (any port) source configuration ingest cluster select from the drop down list one of the available ingest clusters as the destination for the source target broadcaster/s specify which broadcaster/s within the cluster on which zen master can deploy the source either select a specific broadcaster to be used or specify your preference for using primary vs backup broadcasters options are prefer primary broadcasters, primary broadcasters only , backup broadcasters only or prefer backup broadcasters note for managed clusters, it is not recommended to select a specific broadcaster, as the broadcaster’s availability may not remain stable input nic if you would like to specify which nic is used, select the ip of that nic from the drop down list by default, any is selected pid mapping (optional) if you would like to apply a pid mapping profile to this source, then select the desired profile from the dropdown list to create a new pid mapping profile, see docid\ gftcayurpl7dinouyd14z note using this method creates a single source in zen master with pid mapping applied if you would like to maintain a source with the original pids and create an additional source with pid mapping (e g if you want to create several different pid mapped variations), then use the method described in docid\ gockl3upsd8v14ia2an6g alert on pid changes if you would like to generate email notifications whenever a pid change is detected, select this checkbox log scte 35 select this checkbox if you would like to log scte 35 markers for this stream note to log scte 35 markers, scte 35 needs to be enabled both on the ingest cluster and in the source configuration note scte 35 logging is only available for v13 1 40262+ broadcasters enable scte 35 alerts (for log scte 35) if you would like to receive alerts for scte 35 markers, select this checkbox public output if you would like to allow access to the stream directly through a supported player, select the allow checkbox password (for public output) if you selected allow in the public output field, specify a password in this field to authenticate access to the stream if you would like to generate email notifications whenever a pid change is detected, select this checkbox content analysis select one of the following options full select this option if you would like to enable full content analysis (cqa), including analysis of the stream's audio and video content, including audio levels, audio silence detection, frozen video detection, and more tr101 only select this option to perform tr101 analysis only (without video and audio content analysis) the analysis can be used to check the integrity of the ts and the most important elements of the stream the analysis includes priority 1 and 2 to learn more about tr101 analysis see tr 101 290 technical report none no content analysis is enabled note it is generally recommended to enable full content analysis unless it is causing technical problems if content analysis is disabled, the system won't detect errors in the video and audio content of the stream and won't generate warnings for such events monitor cea 608 closed captions if you would like to monitor cea 608 closed captions, select this checkbox note monitoring cea 608 closed captions requires using a version 14 4 or newer broadcaster monitor cea 708 closed captions if you would like to monitor cea 708 closed captions, select this checkbox note monitoring cea 708 closed captions requires using a version 14 4 or newer broadcaster disable auto pull if you would like to disable auto pull, select this checkbox note disabling auto pull will lock channels using this source to the source's ingest cluster and targets to the source's current active broadcaster this setting only applies to pass through channels auto pull latency \[ms] specify the desired latency for auto pull actions (default 1,000 ms) webrtc playback select the desired playback method note webrtc enables you to monitor the stream via web browsers and mobile applications with real time communication (rtc) webrtc needs to be activated independently for each source in zen master (by default it is disabled) select one of the following options disabled users will not be able to view this source using webrtc (default) pass through passes the stream through to webrtc without transcoding this option can only be used if the input stream is already in a webrtc compliant format (video h 264 codec with baseline or main profile and no b frames, audio opus codec) auto zen master automatically transcodes the stream using the optimal profile for each specific user in this option zixi broadcaster will decode the video, transforming it into raw frames, which will be passed to the webrtc library, where it will be re encoded for each individual user note best quality however, if monitored by multiple users this can consume extensive resources 1080p/720p/480p/360p zen master transcodes the stream to a webrtc compliant profile with the specified resolution the transcoding is done by zixi broadcaster's transcoder note this method requires a zixi broadcaster with x264 or nvidia for transcoding this method allows many users to monitor the stream without encoding separately for each individual user, which saves cpu capacity since there is only one stream resolution, it is recommended to encode to a low resolution and low bitrate so that the stream will be viewable by all users monitoring the stream scte 35 manipulation enable scte 35 manipulation select checkbox to enable scte 35 manipulation scte 35 pid set the scte 35 pid in which the messages will be inserted remove existing scte 35 remove any existing scte 35 messages from the stream null packet search window (ms) look for a null packet to insert scte 35 messages into the stream if the stream is vbr , set the value to 0 scte 35 messages can be inserted anywhere, and do not need a null packet if the stream is cbr , the downstream receiver may need a cbr stream inserting the scte 35 message into a null packet ensures the stream will remain cbr; however, it may delay the insertion of the message up to the length of the search window initial state disabled select this checkbox if you would like to disable this source upon initial configuration muted select this checkbox if you would like to disable error/recovery notifications for this source upon initial configuration error concealment enable error concealment select this checkbox to enable the error concealment mechanisms listed below to correct transport stream for downstream irds delay (ms) enter the delay that the error concealment adds to the stream in miliseconds error concealment needs to buffer the stream to analyze it one second is a reasonable value lower values may cause the error concealment to not be able to fix some of the frames cbr padding (kbps) enter a value for the rate at which padding will be added to maintain a specific output transport bitrate for example, if you have a video bitrate at 5000 kbps or that varies from 3000 5000 kbps and audio at 64 kbps, total bitrate will be max 5064 kbps or min 3064 kbps with cbr padding set at 6000 kbps, 6000 kbps is being delivered downstream at all times, ensuring a consistent bitrate pcr interval (ms) select the frequency at which program clock reference is inserted into the outputs transport stream options include atsc standard 100 ms dvb standard 40 ms advanced billing codes if you would like to track usage for this source, enter your billing code details, see docid\ lalxj n928tegcpdpbirj (supported for broadcasters v14 8+) billing password enter the password that corresponds to this billing code auto pull billing password enter the password that corresponds to this auto pull billing code auto pull billing code specify the maximum transmission unit (largest data packet that a network connected device will accept) in bytes for the auto pull auto pull mtu (bytes) specify the maximum transmission unit (largest data packet that a network connected device will accept) in bytes for the auto pull apply input nic selection to network device select this checkbox to apply input nic selection to the network device frozen video minimal duration (seconds) specify the default minimal duration in seconds of frozen video after which the broadcaster will trigger a frozen video alert default 10 seconds this setting is supported for broadcaster version 16 3 and higher for existing sources, you may need to restart the source blank video minimal duration (seconds) specify the default minimal duration in seconds of blank video after which the broadcaster will trigger a blank video alert default 10 seconds this setting is supported for broadcaster version 16 3 and higher for existing sources, you may need to restart the source ignore monitoring pids ignore pids for empty audio streams to prevent false warnings enter a comma delimited list of pid numbers that should not be monitored for null content