Savi STREAM.ONE User manual

STREAM.ONE
USER GUIDE
www.hellosavi.com

STREAM.ONE
Page 1 hellosavi.com © 2023 SAVI Controls
Rev 06/13/23
TABLE OF CONTENTS
1.About This Guide .......................................................................................................................................................2
1.1.Product Description............................................................................................................................................2
1.2.Power Over Ethernet...........................................................................................................................................2
1.3.Revisions.............................................................................................................................................................2
2.Parts List ....................................................................................................................................................................3
3.Physical Layout..........................................................................................................................................................4
3.1.Front Panel..........................................................................................................................................................4
3.2.Rear Panel...........................................................................................................................................................4
3.3.Front Panel Button Shortcuts ............................................................................................................................5
3.4.Rack Mount System (Chassis Accessory)........................................................................................................5
4.Getting Started...........................................................................................................................................................6
4.1.Physical Connections.........................................................................................................................................6
4.2.Computer Setup..................................................................................................................................................6
4.2.1.Windows 10 and 11 LAN setup ..................................................................................................................6
4.2.2.Mac LAN setup............................................................................................................................................9
4.2.3.IP address and channel settings............................................................................................................. 10
5.Using with SAVI....................................................................................................................................................... 11
6.Setting up a STREAM.One...................................................................................................................................... 12
6.1.Connections..................................................................................................................................................... 12
6.2.Logging into the Web UI.................................................................................................................................. 12
6.3.Web UI Overview.............................................................................................................................................. 13
6.3.1.Informational and Diagnostics................................................................................................................ 13
6.3.2.Transport Controls ................................................................................................................................... 14
6.3.3.Encoder..................................................................................................................................................... 15
6.3.4.Network..................................................................................................................................................... 19
6.3.5.Admin........................................................................................................................................................ 19
6.3.6.System ...................................................................................................................................................... 20
6.3.7.EDID........................................................................................................................................................... 21
6.3.8.Image Capture .......................................................................................................................................... 22
6.3.9.Device Discovery ...................................................................................................................................... 22
7.Diagnostics ............................................................................................................................................................. 23
8.Application Programming Interface (API)............................................................................................................. 24
8.1.Version 1.10.10................................................................................................................................................ 25

STREAM.ONE
Page 2 hellosavi.com © 2023 SAVI Controls
Rev 06/13/23
1. ABOUT THIS GUIDE
This guide specically pertains to the SAVI STREAM.One Version 1.10.10 and later. These devices utilize a
different chipset than previous versions and have additional UI elements and controls. This guide also covers
both the 2K and 4K editions, features only available to one of those are marked as such.
If you have any further questions, please contact SAVI support at: 214-785-6510 or suppor[email protected]
Data Sheet Version Date Revised Description
1.0 2023-04-10 TN Initial release
1.1 2023-06-05 TN Updated Phoenix Connector
1.1. PRODUCT DESCRIPTION
The STREAM.One comes in either the 4K or 2K editions. The 4K edition provides input support of up to 2160P60
resolutions and HDCP 1.3 while the 2K edition provides input support of up to 1080P60 resolutions and HDCP
1.3. The 2K edition outputs four stream types: Video and audio encoded to H.264 via TS (Transport Stream)
Multicast, RTSP (Real Time Stream Protocol) Unicast, or RTSP Multicast, and audio only encoded to PCM via
RTP (Real-time Transport Protocol) with SDP (Session Description Protocol). The 4K edition has an additional
three stream types: Video and audio encoded H.265 via TS Multicast, RTSP Unicast, or RTSP Multicast.
Both products also output two channel unbalanced audio with adjustable time delay and a JPEG screenshot
of the source video that is updated roughly ve times per second. The STREAM.One can be powered by PoE
802.3af, or the optional power adapter.
1.2. POWER OVER ETHERNET
1.3. REVISIONS
The STREAM.One encoders are compliant within the 802.3af PoE specication. Please ensure that any network
switch complies with this specication and make certain which ports on the switch provide PoE as some
switches do not provide PoE on every port. Many network PoE switches have settings to enable PoE and can
also set/schedule PoE power. Please ensure these are set as needed.

STREAM.ONE
Page 3 hellosavi.com © 2023 SAVI Controls
Rev 06/13/23
Category Model Number Description
1 x SSE-02 STREAM.One Encoder
Included 1 x AC to DC Power Adapter
1 x Unbalanced Stereo Phoenix Connector (3-pin)
1 x Chassis Mount Ears
Optional Accessories 1 x SSC-01 STREAM.One Rack Mount Kit
2. PARTS LIST

STREAM.ONE
Page 4 hellosavi.com © 2023 SAVI Controls
Rev 06/13/23
3. PHYSICAL LAYOUT
3.1. FRONT PANEL
3.2. REAR PANEL
A. OLED 2x16 Display
B. Multifunction Menu Button
C. Multifunction Stream Button
D. Network LED / Stream Indicator
E. HDMI LED Input Indicator
F. Power LED Indicator
A. Network (RJ45 Ethernet, 1Gb/s)
B. HDMI Input LED Indicator
C. HDMI Input With Captive Screw
D. HDMI Loop-Output LED Indicator
E. HDMI Loop-Output With Captive Screw
F. 12V DC Power Input
G. Unbalanced 2 Channel Audio Output (Phoenix
Connector)

STREAM.ONE
Page 5 hellosavi.com © 2023 SAVI Controls
Rev 06/13/23
The rack mount system allows four STREAM.One encoders to be installed securely within a 1U space. The
encoders are front loaded and secured using captive thumb screws. Compatible with both 2K and 4K versions.
3.3. FRONT PANEL BUTTON SHORTCUTS
3.4. RACK MOUNT SYSTEM (CHASSIS ACCESSORY)
The STREAM.One offers a handful of shortcuts for performing basic functions. Each of these utilize the physical
buttons on the front of the device. Except for Factory reset, all shortcuts are performed while the STREAM.One is
powered on.
Action Description Shortcut Result
Menu options Displays current information Press Menu repeatedly to cycle
through
• IP Address
• IP Mode
• Subnet Mask
• Gateway
• Software version
• Return to User Label and CH#
Stream Enables or disables stream Hold Stream for 3 sec
• RTP and RTSP stream stops and
shows splash screen
• HDMI pass through unaffected
• MJPEG preview continues
Reboot Forces a power cycle Hold Menu for 10+ sec
• Display blanks
• LEDs turn off
• Boot sequence begins
Factory reset Overwrites all settings with
default values
After power cycle, hold Menu for 10
sec
• Stream button flashes
• Display: “Factory Reset Completed“
• Green power light turns on
• Blue Net light turns on
• Orange HDMI light turns
IP reset Sets IP method to DHCP Hold Menu and Stream for 10 sec
• Display: “IP Reset Applied”
• Overwrites static IP settings
• Ping may delay for up to 1 min
• Decoders will need reassignment

STREAM.ONE
Page 6 hellosavi.com © 2023 SAVI Controls
Rev 06/13/23
4. GETTING STARTED
4.1. PHYSICAL CONNECTIONS
STREAM.One encoders are set at the factory to use DHCP. They can optionally be set to Static mode.
Devices that need to communicate with each other on a network must be in the same IP subnet and not
separated by a VLAN conguration.
Check the current IP address of your STREAM.One by pressing the Menu button on the front of the device once.
You may need to set your computer to be on the same subnet of the device in order to connect to it. While the
interface and steps on achieving this will be different for each Operating System, they all require that you set the
ipv4 settings of your LAN adapter.
Option 1: Right Click on the taskbar icon that looks like a signal strength indicator. Then click on “Open Network
and Internet settings”.
Opening Network Page
Ensure the STREAM.One is properly grounded to protect from electrical surges.
Ensure your switch is congured for streaming to prevent network ooding.
4.2. COMPUTER SETUP
Ensure the following cables are connected to your STREAM.One and the source device is properly congured:
• 12v Power cable (if not using PoE)
• Ethernet network cable
• HDMI cable from source device (plugged into left HDMI port on STREAM.One)
4.2.1. WINDOWS 10 AND 11 LAN SETUP

STREAM.ONE
Page 7 hellosavi.com © 2023 SAVI Controls
Rev 06/13/23
Select Ethernet.
Option 2: Use the search window and type
“Settings”. Select Network & internet from the
list on the left-hand side.
Once you are in the Ethernet properties, click
Edit next to IP assignment.

STREAM.ONE
Page 8 hellosavi.com © 2023 SAVI Controls
Rev 06/13/23
When the Edit IP settings window appears, change the dropdown to Manual and enable IPv4. Enter an IP on the
same subnet as the STREAM.One as well as the subnet itself. A gateway address is optional.
IP information in images are examples.

STREAM.ONE
Page 9 hellosavi.com © 2023 SAVI Controls
Rev 06/13/23
From the top menu bar, you can either click on the network symbol or click on the Apple icon in the upper left,
and the select system preferences:
4.2.2. MAC LAN SETUP
Opening Network Page
Then select Network:
Select the appropriate network adapter from the list in the left pane, and then set the correct IP subnet
parameters.

STREAM.ONE
Page 10 hellosavi.com © 2023 SAVI Controls
Rev 06/13/23
The STREAM.One encoders have two methods of IP addressing.
• DHCP (default)
• Static
Channel settings
Encoders translate multicast IP addresses to channels in order to be more understandable and intuitive to the
user.
Encoders broadcast on channels and must never be set to do so on the same channel as another encoder.
Network switch requirements
The minimum requirements of a network switch for the STREAM.One are:
• 1Gig Port speeds
• IGMP Snooping
• IGMP Querier
• Fast Leave
• Flow Control
Network switch recommendations
While not required to operate the STREAM.One, you may want to utilize the Power over Ethernet feature of the
product. A network switch that supports PoE specication 802.3af is acceptable. However, please carefully
review the full power budget capacity of the switch to make sure it can handle the number of STREAM.One units
that you will populate the switch with.
4.2.3. IP ADDRESS AND CHANNEL SETTINGS
STREAM.Ones consume 15.4 Watts over PoE
It is also recommended from a system design standpoint that you consider VLAN management to isolate the
multicast trac generated by the transmitters from devices other than the receivers.

STREAM.ONE
Page 11 hellosavi.com © 2023 SAVI Controls
Rev 06/13/23
5. USING WITH SAVI
Before getting into the full User Interface, it is important to note that very little conguration is needed when
using the STREAM.One with SAVI. Setting a static IP address is the only setup required on the STREAM.Ones
before adding them to your project with Creator. We reccomend setting all units to consecutive IP addresses to
make use of Creator’s Add Multiple feature.
SAVI will overwrite all settings on the STREAM.One with the Creator values

STREAM.ONE
Page 12 hellosavi.com © 2023 SAVI Controls
Rev 06/13/23
6. SETTING UP A STREAM.ONE
6.1. CONNECTIONS
Power: Each STREAM.One encoder can be powered from a network switch port that provides PoE power
compliant with the 802.3af specication. If you cannot utilize PoE over CAT, or you prefer to use power adapters,
an AC to DC power adapter is included with each device.
Network: The STREAM.One supports standard category RJ45 connectivity. It is recommended to use CAT6a
cabling to ensure best performance.
Video: The STREAM.One accepts HDMI 1.3 video formats up to 1080P60 on 2K units and 2160P60 on 4K units.
Audio Transmitter: The STREAM.One de-embeds the audio present on the HDMI. The included Phoenix
connector may be used to connect this audio to a DSP or Amplier.
6.2. LOGGING INTO THE WEB UI
On the login page you will also see the channel and user label information
To log in to the web UI, you will need the following:
• Encoder IP address
• Username
• Password
The log in screen has a username and password eld.
Username: Admin
Password: admin

STREAM.ONE
Page 13 hellosavi.com © 2023 SAVI Controls
Rev 06/13/23
6.3. WEB UI OVERVIEW
1. Informational and Diagnostics: Displays model,
user label, signal, stream, and equipment status.
2. Transport Controls: Contains video and audio
stream controls.
3. Settings: Advanced settings separated into
several tabbed categories.
A. Incoming Signal Status: Displays incoming
resolution, refresh rate, and audio format (Green =
good signal input, Red = no signal or incompatible
signal).
B. Output Stream Status: Displays activity of the
output stream.
• Main Encoding (Video, Audio on TS)
• Green = Streaming
• Orange = paused, image freeze, no audio
• Red = Stop, no video or audio streaming,
splashscreen displayed
6.3.1. INFORMATIONAL AND DIAGNOSTICS
• 2CH Audio Out (Analog stereo on Phoenix
connector)
• Green = audio present
• Red = audio not present
• Audio Only Encoding (PCM 44.1kHz/48kHz
audio on RTP/SDP)
• Green = Streaming
• Orange = Paused, no audio
• Red = Stop, no audio stream
• Splashcreen Active
• Grey = no splashscreen displays
• Green = splashscreen displayed
C. Equipment Status: Reports main IC operating temperature, and runtime since last power cycle.

STREAM.ONE
Page 14 hellosavi.com © 2023 SAVI Controls
Rev 06/13/23
6.3.2. TRANSPORT CONTROLS
Main Stream*/Video Stream
• Active: Enables streaming
• Pause: Freeze video and audio
• Stop: End video and audio stream,
display splashscreen
Audio Stream
• Active: Enables streaming
• Pause: Freeze audio
• Stop: Disable audio stream
Second Stream (only available on 4K)*
• Active: Enables streaming
• Pause: Freeze video and audio
• Stop: End video and audio stream,
display splashscreen
• Disable: Disable video and audio stream
*On 2K devices, there is only one video stream so it is named Video Stream. However, on the 4K device there are
two video streams so they are named Main Stream and Second Stream respectively.

STREAM.ONE
Page 15 hellosavi.com © 2023 SAVI Controls
Rev 06/13/23
6.3.3. ENCODER
The Settings section is separated into several tabs. The Encoder tab provides video, stream, and audio settings.
The 4K edition also provides settings for the second stream.
Any changes on this tab require a Save function to implement.
• Encoding Resolution: Sets output resolution
• Same as input: Input resolution passed through
• 3840 x 2160*: Input resolution scaled to 3840 x 2160
• 1920 x 1080: Input resolution scaled to 1920 x 1080
• 1280 x 720: Input resolution scaled to 1280 x 720
• 640 x 480: Input resolution scaled to 640 x 480 (input aspect may be distorted)
• Frame Rate(Hz): Adjustable 1 Hz increments, range 5 to 30 on 2K units and 5 to 60 on 4K units. Set to 30
or 60 by default.
• GOP: Adjustable increments of 1, range 5 to 300. Set to 60 by default.
• Bitrate Control
• VBR: Variable Bit Rate (set by default)
• CBR: Constant Bit Rate
• Bitrate(kbit): Adjustable increments of 1, range 32 to 32000. Set to 10000 by default.
• For CBR: Sets the CBR value
• For VBR: Sets the upper limit for VBR
• H.264 Level
• Baseline: Lowest encoding, lowest processing power required
• Main: Higher quality
• High: HD quality
• H.265 Level*
• Main: High quality
Video Settings
*Only available on the 4K edition.

STREAM.ONE
Page 16 hellosavi.com © 2023 SAVI Controls
Rev 06/13/23
Stream Settings (4K)
• Second Stream (H.264) TS Multicast Address: URL of the Transport Stream (RTP).
• Audio Only Multicast Address (Audio): URL of the audio only stream.
• Second Stream (H.264) RTSP Multicast Address: URL of the RTSP stream.
• Main Stream (H.265) TS Multicast Address: URL of the 4K Transport Stream (RTP).
• Main Stream (H.265) RTSP Multicast Address: URL of the 4K RTSP stream.
• TS Multicast Port: Port for the Transport Stream. Set to 5004 by default.
• RTSP Video Multicast Port: Port for the RTSP stream. Set to 5008 by default.
• Audio Only Multicast Port: Port for the audio only stream. Set to 5006 by default.
• Main Stream (H.265) TS Multicast: Full RTP stream address. Enabled by default.
• Second Stream (H.264) TS Multicast: Full RTP stream address. Enabled by default.
• Main Stream (H.265) RTSP Unicast: Full RTSP stream address. Disabled by default.
• Second Stream (H.264) RTSP Unicast: Full RTSP stream address. Disabled by default.
• Main Stream (H.265) RTSP Multicast: Full RTSP stream address. Disabled by default.
• Second Stream (H.264) RTSP Multicast: Full RTSP stream address. Disabled by default.
• Audio Only Multicast: Full RTP audio only stream address. Disabled by default
Ensure each Port is unique.
Unicast should only be used when
streaming to a single endpoint.

STREAM.ONE
Page 17 hellosavi.com © 2023 SAVI Controls
Rev 06/13/23
Stream Settings (2K)
• TS Multicast Address: URL of the Transport Stream (RTP).
• Audio Multicast Address: URL of the audio only stream.
• RTSP Video Multicast Address: URL of the RTSP stream.
• TS Multicast Port: Port for the Transport Stream. Set to 5004 by default.
• RTSP Video Multicast Port: Port for the RTSP stream. Set to 5008 by default.
• Audio Only Multicast Port: Port for the audio only stream. Set to 5006 by default.
• TS Multicast: Full RTP stream address. Enabled by default.
• RTSP Unicast: Full RTSP stream address. Disabled by default.
• RTSP Multicast: Full RTSP stream address. Disabled by default.
• Audio Only Multicast: Full RTP audio only stream address. Disabled by default
Ensure each Port is unique.
Unicast should only be used when
streaming to a single endpoint.

STREAM.ONE
Page 18 hellosavi.com © 2023 SAVI Controls
Rev 06/13/23
• Select Broadcast Channel: Range 0 to 999, impacts Main and Audio addresses
• For simplicity, the STREAM.One encoder provides intuitive ‘channel’ selections, making it easy to set
many encoders quickly. The ‘channel’ number translates to a specic IP address for the Main Video/
Audio Transport Stream (TS), and a different specic IP address for the Audio Only RTP/SDP PCM
stream.
• No Conict LED
• Green: No address conict
• Red: Conict with another encoder
Set Broadcast Channel
Audio Settings
• Audio Encoding: Fixed at PCM
• Sample Frequency(kHz): Fixed at 44.1kHz or 48kHz depending on the source
• Audio Delay: Adjustable in 20mS increments, range 0 to 1500
Ensure you SAVE your settings.

STREAM.ONE
Page 19 hellosavi.com © 2023 SAVI Controls
Rev 06/13/23
6.3.4. NETWORK
• IP Mode: Static or DHCP. Set to DHCP by default.
• IP Address: Congurable when IP Mode = Static
• Gateway: Congurable when IP Mode = Static
• Subnet Mask: Congurable when IP Mode =
Static
• Preferred DNS: Congurable when IP Mode =
Static
• Alternate DNS: Congurable when IP Mode =
Static
• MAC Address: Fixed
Ensure you SAVE your settings.
• NTP Server: Set to pool.ntp.org by default.
• NTP Port: Port for NTP server, range 1 to 65535.
• NTP Status LED
• Green: Connected
• Red: Not connected
• Username: Select User or Admin
• Old Password: The old password is required
when changing the password
• New Password: Enter new password
• Conrm Password: Conrm new password
6.3.5. ADMIN