epiphan Pearl Mini User Manual Download Page 411

Page: 411 / 447

Pearl Mini User Guide

Controlling Pearl Mini using

HTTP/HTTPS commands

To "get" a list of

all

variables saved to Pearl Mini:

http://<address>/admin/get_variables.cgi

Example

: "http://192.168.0.129/admin/get_variables.cgi"

returns:

"gpsvar1=N103 68201 W765 29712

gpsvar2=S490 18731 E756 19890

gpsvar3=N123 46891 W345 65431

gpsvar4=S767 33410 E770 04513"

To learn how to use global variables as text overlays in custom channels, see

Add a text overlay

399

Summary of Contents for Pearl Mini

Page 1: ...Epiphan Pearl Mini User Guide Release 4 8 0 April 22 2019 UG122 06 and 2019 Epiphan Systems Inc ...

Page 2: ...URATE AT TIME OF WRITING BUT ARE PRESENTED WITHOUT WARRANTY OF ANY KIND EXPRESS OR IMPLIED USERS MUST TAKE FULL RESPONSIBILITY FOR THEIR APPLICATION OF ANY PRODUCTS LIMITATION OF LIABILITY UNDER NO CIRCUMSTANCES SHALL EPIPHAN BE LIABLE FOR ANY INCIDENTAL SPECIAL CONSEQUENTIAL EXEMPLARY OR OTHER INDIRECT DAMAGES THAT RESULT FROM THE USE OF OR THE INABILITY TO USE THIS PRODUCT OR THE INFORMATION CON...

Page 3: ...om the date of purchase Technical support Epiphan s products are backed by our professional support team You can reach our team several ways l Email support epiphan com l Live chat from our support site https www epiphan com support l Phone toll free at 1 877 599 6581 or call 1 613 599 6581 Gather as much information about your problem as you can before you contact us so we can help you better inc...

Page 4: ...d by default when you add a new RTSP input to Pearl Mini Live switching improvement The switching behavior has been improved when using the touch screen or Epiphan Live to switch between different sources and layouts When the standby feed is switched to go live the feed that was live switches to standby Audio inputs as playback audio sources for HDMI outputs Now you can select an audio input as th...

Page 5: ...d streaming presets Integrated streaming presets for Original Livestream and the Wowza Cloud have been removed What s fixed Switching performance improvement The speed of switching layouts using the touch screen on Pearl Mini was improved ...

Page 6: ... and remote access 28 The touch screen 29 About the touch screen 29 The Channel view 31 Record a channel using the touch screen 33 Stream a channel using the touch screen 33 Switching mixing using the touch screen 34 One Touch streaming and recording control 37 Configure the touch screen 44 The Admin panel 52 About the Admin panel 52 Connect to the Admin panel 54 Connect using the Epiphan discover...

Page 7: ...wnload AV Studio recordings locally 89 Configure channel encoding using AV Studio 91 PART 1 Setup 93 Configure network settings 94 Network ports used by Pearl Mini 94 Verify IP address and MAC address of Pearl Mini 96 Configure a static IP address 97 Configure DHCP 100 Change the HTTP HTTPS port values 102 Perform network diagnostics 103 Disable the network discovery utility 104 Configure network ...

Page 8: ...assign a registered resource 142 User administration 144 User types and privileges 144 Set or change user passwords 148 Remove user passwords 149 Overcome lost passwords 150 Configure LDAP user authentication 151 Change the logged in user 153 Restrict viewers by IP address 153 IP restriction examples 155 Configuration presets 158 About configuration presets 158 Configuration preset considerations ...

Page 9: ...configuration 221 About the custom layout editor 221 Resize and position items using percents or pixels 225 Open the custom layout editor for a channel 231 Add or edit a custom layout 232 Rename a layout 234 Delete move or duplicate a layout 235 Set the background color 237 Add an image to a layout 238 Upload or remove an image using the Media page 240 Add a text overlay 242 Custom system variable...

Page 10: ...treaming port values 277 Disable and enable direct channel streaming 279 Streaming to a server 280 Stream to a CDN 281 Start and stop streaming to a CDN 282 Set up a stream using RTMP or RTMPS push 284 Set up a stream using RTSP announce 285 Stream to a CDN using an XML profile 286 Stream using multicast 288 MPEG TS streams using RTP UDP push 288 MPEG TS streams using UDP push 290 Multicast stream...

Page 11: ...scheduled VOD events 327 Manually start stop an ad hoc event 329 Manage recorded files 332 View list of recorded files 332 Download recorded files manually 333 Join recorded files together 334 Extract tracks from a recording 335 Rename recorded files 337 Delete recorded files 337 FTP and automatic file transfers 339 About Automatic File Upload AFU 339 Choose files to include in AFU 340 Enable AFU ...

Page 12: ...age the AFU queue 364 Local FTP server 366 PART 5 Maintenance 370 Power down and system restart 371 Backup your Pearl Mini setup 373 Perform a factory reset 374 Firmware upgrade 375 Support 380 Storage space maintenance 384 Third party integration 387 Controlling Pearl Mini using RS 232 serial port 388 Controlling Pearl Mini using HTTP HTTPS commands 394 Configuration keys for third party APIs 400...

Page 13: ...ow you want it so you can take advantage of the many advanced features About this Guide After the introductory section and quick start the next chapter describes the main user interfaces that are used to operate and configure Pearl Mini You ll find everything that you need to use these interfaces and to successfully access Pearl Mini locally as well as remotely l Touch screen l Admin Panel l Epiph...

Page 14: ...ith multiple video sources for live switching You can do all that using Pearl Mini Easily watch live streams using your favorite web browser or media player on mobile devices and computers connected to the same private network as Pearl Mini or using Content Distribution Networks CDNs Recorded files can be downloaded via FTP or set to automatically upload over FTP RSYNC or CIFS and can be integrate...

Page 15: ...Pearl Mini User Guide What is Pearl Mini Pearl Mini does not capture from HDCP encrypted sources Pearl Mini supports up to three video inputs with certain conditions see AV inputs 3 ...

Page 16: ...ther stopped or won t start Touch screen front panel display Used for confidence monitoring and simple configuration obtaining system information and starting stopping recordings and streams SD card slot Used to store up to 512 GB of recordings and user uploaded media files For recommendations see Tech specs USB 3 0 port For connection of external hard drives or flash drives for copying data to a ...

Page 17: ...oggle switch is in the on position double press the power button to turn on Pearl Mini Power jack Plug the power supply in here The port requires a 12 V DC power source center positive Always use the provided power supply USB 3 0 ports For connection of external hard drives flash drives USB web cameras USB microphones or control interfaces see AFU or copy to USB HDMI output port See Video output p...

Page 18: ... to both XLR audio input ports when enabled See Enable or disable phantom power WARNING Connecting devices that are not designed for phantom power when phantom power is enabled for the two XLR ports can seriously damage those devices Always check the phantom power LED before connecting devices to the XLR ports SD card installation and file management Pearl Mini comes with a standard SD card slot o...

Page 19: ...orrupt the SD card The SD card must be EXT4 formatted for the Ubuntu operating system You can format the SD card using the Admin panel see Format the SD card The Ubuntu formatted SD card cannot be used to transfer files to iOS or Windows systems Any content that s contained on the SD card is lost when the SD card is formatted For important considerations when setting the maximum file size limit an...

Page 20: ...rd that is at least a class 10 with up to 512 GB of capacity The SD card must be EXT4 formatted see SD card installation and file management Starting up Pearl Mini is pre configured with two channels HDMI A and HDMI B The HDMI A video input port on Pearl Mini is assigned to the HDMI A channel and the HDMI B video input source is assigned to the HDMI B channel by default When you first start your P...

Page 21: ...l view you can do things like stop and start recording for the channel 7 Optional Plug speakers or headphones into the 3 5 mm headphone jack at the front of Pearl Mini For more about monitoring audio see Monitoring audio My network IP address and channel monitoring You can get the network IP address of your Pearl Mini from the touch screen so that you can do things like view the channels using a w...

Page 22: ...ult If a password has been set consult with your system administrator for the login credentials see User types and privileges For Admin panel login details see Connect to the Admin panel Install a formatted SD card to record a channel An SD card must be installed and formatted before you can record video using Pearl Mini You ll need to log in to the Admin panel using the IP address of your Pearl M...

Page 23: ...l recording using the Admin panel or Epiphan Live For more information about using Epiphan Live see About Epiphan Live To format an SD card and control recording using the Admin panel 1 Insert the SD card into the SD card slot on Pearl Mini 2 Using a web browser on the admin computer go to the IP address of your Pearl Mini and log in see Connect to the Admin panel 3 From the Configuration menu cli...

Page 24: ...ine tune the system to your exact requirements Take a look at topics such as l Live video mixing switching l Selecting an audio source l Video output ports l FTP and automatic file transfers l Custom layout configuration l What is streaming For higher security we recommend setting admin operator and viewer level passwords on Pearl Mini see Set or change user passwords When you re done setting up y...

Page 25: ...l Mini up to date and get all the latest features and firmware updates Registering your Pearl Mini is free and only needs to be done once You can register anytime from the Firmware update page using the Admin panel see Register Pearl Mini or register online at www Epiphan com register 13 ...

Page 26: ...amera and slides then easily switch between layouts with either a tap on the touch screen using Epiphan Live on a mobile device or from the Admin panel Your program stream with switched layouts could look like this To create a program channel with custom layouts using the custom layout editor that you can switch see What is a channel For instructions on how to live switch see l Switching mixing us...

Page 27: ...st the volume Tap the headphones icon on the touch screen to adjust the volume Each tap increases the volume by 25 to a maximum volume of 100 Tapping the headphones icon when the volume is at 100 mutes the volume You can also long press the headphones icon to mute and unmute the volume Volume is muted 25 volume 50 volume 75 volume 100 volume At 75 volume what you hear corresponds to the nominal au...

Page 28: ... bars The top bar is the left audio channel and the bottom bar is the right audio channel VU meter mono VU meter stereo Table 3 Audio VU meter levels Color Decibel range Red 0 to 9 dBFS Yellow 9 to 18 dBFS Green 18 dBFS and lower The VU meter appears in several different places so you can visually check audio levels l Touch screen On the individual channel view and the grid view If the audio meter...

Page 29: ...rts are l Two XLR TRS combo jacks l XLR mic level input balanced supports 48 V phantom power l TRS professional line level input 4 0 dBu up to 12 3 V RMS 24 dBu balanced unbalanced l One 3 5 mm stereo mic level input for electret microphones unbalanced l One stereo pair RCA consumer line level input 10 dBV The XLR and TRS combo jacks are configured as a left right stereo pair by default see Config...

Page 30: ...ut port RCA Nominal Professional mixer TRS Nominal RCA Not recommended USB microphone USB Nominal Connecting devices that are not designed for phantom power when phantom power is enabled for the two XLR ports can seriously damage those devices Always check the phantom power LED before connecting devices to the XLR ports To choose a different audio device for the channel 1 Using a web browser on th...

Page 31: ...ptional Adjust the gain for an audio input source select the input port from the Inputs menu and adjust the amount of gain on the configuration page for the audio input port Click Save when you re done For more details see Adjust audio gain and delay 19 ...

Page 32: ... sources or a channel as a source The switched program can have up to three layouts two that are picture in picture that includes your main camera and one other video source such as a document camera or a laptop with slides and a third layout of your main camera One of the video sources you connect can be either a USB or an RTSP source however you cannot connect both at the same time Pearl Mini su...

Page 33: ... Mic level balanced inputs supply optional 48 V phantom power across both XLR ports See Enable or disable phantom power Connecting devices that are not designed for phantom power when phantom power is enabled on the XLR ports can seriously damage those devices Always check the phantom power LED before connecting devices to the XLR ports A direct box can be used to provide the correct mic level sig...

Page 34: ...ut connectors are listed for Pearl Mini For the most up to date product specifications and information go to www epiphan com pearl mini Table 6 Specifications for Pearl Mini Video inputs Connectors 1 3G SDI 2 HDMI 1 USB1 Ethernet 1 RTSP1 Resolutions Most common and custom SDI HDMI modes up to 1920 1200 Video formats 3G SDI HD SDI SD SDI HDMI USB video through USB Webcamera or UVC AV io video grabb...

Page 35: ...d simple switching streaming and recording control Audio output 3 5 mm audio Front mounted headphone jack for confidence monitoring Video encoding Video codecs H 264 Motion JPEG Video bitrates 1 50 Mb s Key frame intervals Programmable Color resolution 4 2 0 Output frame size Configurable up to 1920 1200 Encoded programs Two simultaneous 1920 1080 programs capturing and streaming at 30 fps with up...

Page 36: ...k storage FTP server and FTP client capabilities SFTP SCP RSYNC CIFS AWS or WebDav servers Playback and recorded formats Download recorded videos AVI MOV MP4 or MPEG TS Administration Web UI for full administration On screen display and mobile UI for confidence monitoring simple administration and control Multiple user accounts passwords HTTPS for secure Admin panel and Epiphan Live access as well...

Page 37: ... device to manually transfer files instead Optimum CPU performance Pearl Mini is a powerful live video production system however there s a limit to the number of concurrent tasks the onboard CPU can perform efficiently The number of concurrent tasks depends on many factors like how many channels you have how many layouts you have per channel how often you switch layouts is the system resizing scal...

Page 38: ...sed l Remove unused channels or layouts l Reduce the number of channels created l Ensure video sources come in at the right resolution so that Pearl Mini doesn t have to up scale or down scale the video source Vesa mounting the device The rear panel of Pearl Mini has vesa mounting holes to fit a standard 75mm 75mm vesa mount Use four M4 screws with a maximum length of 5mm to mount the plate to the...

Page 39: ...Pearl Mini User Guide Vesa mounting the device Do not insert screws longer than the recommended 5mm Using longer screws can damage the device 27 ...

Page 40: ...that s primarily used for confidence monitoring statistics live switching and recording control see Epiphan Live You can remotely login and access your Pearl Mini using cloud versions of the Admin panel and Epiphan Live Start and stop recording perform rescue troubleshooting and more over the Internet when you use the cloud versions All you need is a free AV Studio account to start remotely access...

Page 41: ...able recording streaming and switching from the touch screen l Set the touch screen timeout l Set a 4 digit PIN security code To view system information using the touch screen see View system information using the touch screen About the touch screen Pearl Mini s front panel includes a touch screen display that s used for confidence monitoring basic configuration and one touch streaming and recordi...

Page 42: ...You can tap the grid icon to return to the grid view Tap the gear icon at any time to go to system settings Grid icon By default the touch screen and all features except viewing the CMS Events screen are enabled You can disable the touch screen and define which features are enabled on the touch screen If the touch screen is configured to not show channel previews tap anywhere on the screen to go t...

Page 43: ... view opens you can select a channel and open the channel view Just tap the channel you want in the grid view and the channel view opens Table 7 Parts of the touch screen for the individual channel view Item Description 1 Channel name 2 Streaming status Gray means streaming is stopped flashing blue means streaming is in progress 3 The streaming timer shows the length of time that streaming 31 ...

Page 44: ...d is displayed using colored bars l RED 0 to 9 dBFS l Yellow 9 to 18 dBFS l Green 18 dBFS and lower 9 Audio monitoring volume control icon Tap to change volume level See Monitoring audio for more information 10 Live Switcher view icon Tap to view the live switcher which lets you live switch between different custom layouts that are configured for the channel 11 CMS Events screen icon Tap to view t...

Page 45: ... The channel view opens If necessary tap the screen once to display the controls 2 Tap the red Record icon at the top right of the screen to start recording The red dot flashes and the record timer increments when recording is in progress 3 Tap the red Record icon again to stop recording The dot stops flashing and the record timer resets to 00 00 00 Pearl Mini also features One Touch which lets yo...

Page 46: ...nd the timer resets to 00 00 00 If an error occurs when you start streaming a yellow circle with an exclamation mark appears in the left top corner of the touch screen Check your networking and streaming settings Pearl Mini also features One Touch which lets you control recording and streaming of multiple channels and recorders at the same time with the touch of a button See One Touch streaming an...

Page 47: ... to accurately reflect the current live switching layout information If the live switching controls don t appear on the touch screen they may have been disabled see Disable or enable recording streaming and switching from the touch screen To switch custom layouts for a channel using the touch screen 1 Tap the Live Switcher icon to open the live switcher view for the channel If the control icons ar...

Page 48: ...t in to the Preview panel 4 Tap Apply or double tap inside the Preview panel to switch that layout to the Live panel The layout that was in the Live panel moves to the Preview panel so that it s ready for the next time you switch 5 To load a different layout into the Preview panel tap another layout in the carousel 36 ...

Page 49: ... recorders for One Touch recording l Specify channels for One Touch streaming l Customize the One Touch control display About One Touch streaming and recording The One Touch feature lets you control the recording and streaming of multiple channels and recorders with the touch of a single button on the touch screen of Pearl Mini You simply specify which channels and recorders to include for One Tou...

Page 50: ...the total number of channels that are configured for One Touch recording the second number 3 The number of channels that are actively streaming the first number over the total number of channels that are configured for One Touch streaming the second number When you press the start button to activate One Touch recording and streaming a blue Stop button appears the Recording values update to show th...

Page 51: ...tion page using the Admin panel and identify which channel isn t streaming Then correct any streaming configuration errors See Specify channels for One Touch streaming and Specify channels and recorders for One Touch recording for more information about configuring channels and recorders for One Touch control Customize the One Touch control display You can use the Admin panel to customize how One ...

Page 52: ...y If you chose Start Screen or Locked the touch screen automatically refreshes to display the One Touch control screen Specify channels and recorders for One Touch recording All channels and recorders are enabled for One Touch recording by default You can enable and disable One Touch recording control for individual channels and recorders using the Admin panel 1 Login to the Admin panel as admin s...

Page 53: ...ck change and then check Single touch control on the options page to enable the channel for One Touch control Uncheck the check box if you don t want to include that channel for One Touch control c Click Apply 3 To enable or disable Single touch control for a recorder 41 ...

Page 54: ...pens b Click change and then check Single touch control on the options page to enable the recorder for One Touch control Uncheck Single touch control if you don t want to include that recorder for One Touch control c Click Apply To learn how to configure your channels for recording see Record To learn how to configure recorders see Recorders 42 ...

Page 55: ...To specify channels for One Touch streaming 1 Login to the Admin panel as admin see Connect to the Admin panel 2 From the Channels menu select the channel you want and click Streaming The Streaming page opens 3 Click New stream and select a publishing method for example RTMP push 4 Check Single touch control to enable this channel s stream for One Touch control Uncheck Single touch control if you ...

Page 56: ...or some of its features using the Admin panel For information about how to connect to and use the Admin panel see The Admin panel Topics include l Disable or enable the touch screen l Hide or show channel previews on the touch screen l Disable or enable the system status screen l Disable or enable configuration using the touch screen l Disable or enable recording streaming and switching from the t...

Page 57: ...uch screen configuration page opens 3 Uncheck Enable display to disable the touch screen display Check Enable display if you want the touch screen display enabled 4 Click Apply Hide or show channel previews on the touch screen Previews of your configured channels display on the touch screen of Pearl Mini by default You can disable channel previews using the Admin panel A message displays on the to...

Page 58: ...ant to enable channel previews on the touch screen 4 Click Apply Disable or enable the system status screen The system status screen displays network and system related information such as the IP address needed to access Pearl Mini You may not want this information visible on the touch screen after you ve configured Pearl Mini You can use the Admin panel to disable the system status screen from di...

Page 59: ...g the touch screen You can apply configuration presets and configure network settings using the touch screen on Pearl Mini by default You can disable this ability using the Admin panel If configuration is blocked and system status is permitted touch screen users see an i icon instead of the configuration gears icon in the lower right corner of the touch screen To disable or enable configuration us...

Page 60: ... Pearl Mini is enabled by default You can disable this function using the Admin panel to stop users from switching layouts and from starting or stopping live streams and recordings Channel preview must be enabled for the touch screen for recording streaming and live switching control to work See Hide or show channel previews on the touch screen To disable or enable recording streaming and switchin...

Page 61: ...pply Set the touch screen timeout Initially the touch screen is always on for easy monitoring However you can set the touch screen to shut off after a given amount of time To re enable the touch screen after it times out and shuts off simply tap anywhere on the screen To set a timeout for the touch screen 1 Login to the Admin panel as admin see Connect to the Admin panel 2 From the Configuration m...

Page 62: ...digit PIN security code You can set a 4 digit PIN code to protect the touch screen of Pearl Mini from unauthorized access By default the PIN is not set If a PIN is configured users are prompted to enter the PIN code whenever l When you power on or restart Pearl Mini l When Pearl Mini recovers from timeout mode see Set the touch screen timeout To configure a 4 digit PIN code 1 Login to the Admin pa...

Page 63: ...onfiguration menu click Touch Screen The touch screen configuration page opens 3 Enter a 4 digit PIN code in the PIN field Record the PIN code in a safe location for future reference You need this PIN to access the touch screen of your Pearl Mini 4 Click Apply 51 ...

Page 64: ...ics include l About the Admin panel l Connect to the Admin panel l Connect using a DNS based service discovery l Connect using the Epiphan discovery utility l Connect using persistent static IP address For information about remote access to the cloud version of the Admin panel see Access cloud versions of the Admin panel and Epiphan Live About the Admin panel The Admin panel is a web based user in...

Page 65: ... current configuration of your Pearl Mini are listed Select a channel to access the drop down list of options that are available to configure channel encoding add video and audio source create layouts perform confidence monitoring record the channel and more 2 Recorders menu Recorders you add to your Pearl Mini are listed Select a recorder to 53 ...

Page 66: ...m information menu System details are displayed in this area such as the total amount of internal storage how much space is currently used and how much free space is available 8 Main panel The main panel is where the all the related information displays What gets displayed in the main panel depends on which menu item you select 9 Link to Epiphan Live Click to open Epiphan Live in a new tab 10 Log ...

Page 67: ...r the following into the address bar of your web browser to launch the Admin panel http IP Address of Pearl Mini admin If HTTPS is enabled on Pearl Mini replace http with https in the URL 4 Enter your user name and password when prompted The administrative user name is admin Initially no password is set so you can leave that blank and click OK We recommend setting an admin password for higher secu...

Page 68: ...ing the Epiphan discovery utility 1 Launch the discovery utility 2 Click Search to find all the Epiphan systems on the network A list similar to the following appears If more than one Pearl Mini appears select the one you want using the serial number that s listed 3 Optional Record the IP Address shown in the stream properties for future reference 4 Click Web config Your browser opens and points t...

Page 69: ...rompts to download and install the application Mac OS X The Bonjour software used for service discovery is built into the Mac OS No special actions are needed Linux The Avahi implementation used for DNS based discovery is shipped with most Linux distributions If necessary check with your administrator to ensure you have the Avahi package installed To access the Admin panel of Pearl Mini using DNS ...

Page 70: ... page Connect using persistent static IP address Pearl Mini has a default persistent static IP address also known as the recovery IP address If ever you need to set up Pearl Mini on a network that does not support DHCP or you need to recover from a previous static IP address setting you can use this procedure to connect directly to the system for configuration A workstation computer with access ri...

Page 71: ...er the admin password by default there is no password assigned The Admin panel opens 6 From the Configuration menu click Networking 7 Click use a static address and enter a static IP address and network settings you want for Pearl Mini For more information see Configure network settings 8 Restore the previously saved network configurations on the workstation Switching mixing using the Admin panel ...

Page 72: ... layout editor page opens 3 In the layouts list the layout with the big red circle beside it is the currently chosen live layout 4 To switch to a different layout as the active live layout click the gray circle beside the layout you want to make go live The circle turns red to indicate that it s now the active live layout 60 ...

Page 73: ...an Live l Your recordings For information about remote access to the cloud version of Epiphan Live see Access cloud versions of the Admin panel and Epiphan Live About Epiphan Live The Epiphan Live interface lets you easily operate your Pearl Mini using a computer or mobile device such as a tablet You can l Control streaming and recording of channels and recorders l Do live switching between source...

Page 74: ...ogle Chrome iPhone or iPad l Google Chrome l Safari Most instructions assume that a touch screen device is used however you can tap or click depending on your device Text scaling using Google Chrome for Android is not supported The Dashboard interface The Dashboard interface is the first page you see when you open Epiphan Live You ll find helpful tools for confidence monitoring as well as streamin...

Page 75: ...rd header icons l Warning This icon displays only if there are any configuration errors in your channels sources streams or recordings Clicking the icon displays more detail about the errors l Save Save the current Dashboard layout Tap Save to preserve the current layout Logged in operators and administrators will see the 63 ...

Page 76: ...rd panels per set to 4 5 Video inputs Displays a list of your video inputs configured in the Admin panel and includes basic status information for each input 6 Channels Displays a list of your channels configured in the Admin panel and includes streaming and recording control buttons for each channel as well as individual control buttons for each stream when you set up multiple streams in a channe...

Page 77: ...you update the security certificate Use a different web browser such as Firefox or update the version of your web browser then add the security certificate for the website to the exceptions list Access Epiphan Live from the Admin panel You need the IP address of your Pearl Mini to log in to the Admin panel for this procedure see Connect to the Admin panel 1 Log in to the Admin panel using your cre...

Page 78: ... port source and audio l Control streaming and recording Configure Dashboard panels You can customize each Dashboard panel to display a specific channel input source or video output for live confidence monitoring Panels can also be set up to display system information l CPU load l Quantity of streaming connections l The current streaming bandwidth bitrate l Automatic file upload status enabled or ...

Page 79: ...bs at the same time To configure Dashboard panels 1 Log in to Epiphan Live see Access Epiphan Live using a web browser or mobile device 2 Tap the drop down menu that appears below the panel and select the channel source or output to display The label says None if the panel is not yet configured When a channel is selected streaming and recording control buttons appear below the panel You can contro...

Page 80: ...ists all inputs configured on your Pearl Mini and displays the video resolution l A green dot means that the video source is connected and a signal is received l A yellow dot means that a signal is not being receiving from the source l A triangular warning icon means there is a source configuration issue that needs attention Tap the name of a video input to open the source details in a thumbnail v...

Page 81: ...allistics with samples averaged every 10 ms The maximum average in each 100 ms period is displayed as a series of colored bars The following table describes the levels at which the meter changes from green to yellow and red Table 12 Audio VU meter levels Color Decibel range Red 0 to 9 dBFS Yellow 9 to 18 dBFS Green 18 dBFS and lower Show or hide video inputs in the list You can pick which video in...

Page 82: ...and frame rate You can enable and disable a video output port as well as choose if you want to display a channel or a video source You can also enable or disable the audio volume for the output port However you cannot hide video output ports from displaying on the Dashboard To configure the output port audio using the Admin panel see Disable or enable audio and output port volume l Green text mean...

Page 83: ...y don t include the audio VU meter You can change these defaults in the Admin panel See Video output ports to learn more about advanced level video output configuration using the Admin panel To configure a video output port and enable or disable the audio 1 Tap Video outputs to display the video output configuration menu 2 Tap the text field beside the output port and select a channel or source fr...

Page 84: ...ing for channels using the buttons in the Channels section When a channel is not currently streaming or recording the buttons are gray and their respective timers are set to 00 00 00 If streaming isn t configured for a channel the streaming button displays as Not set See Streaming a channel directly to viewers to learn how to configure streaming for a channel using the Admin panel l The left most ...

Page 85: ...he streaming button turns blue when the channel is streaming and the timer s clock increments l The recording button turns red when the channel is recording and the timer s clock increments Streaming and recording control buttons also appear below the Dashboard monitoring panels when they re configure to display a channel You can use those control buttons to start and stop streaming or recording f...

Page 86: ...n panel To start recording simply tap the recording control button for that multi track recorder The button turns red when the multi track recorder is recording and the timer s counter increments Tap the button a second time to stop recording Switching mixing using Epiphan Live The Live Switcher view in Epiphan Live is a simple interface that lets you live switch between layouts while streaming an...

Page 87: ...w and the Admin panel when clicked 3 Preview panel Displays a preview of a selected layout which is outlined with a green border When you click the Switch button this preview layout becomes the live layout See Switching while live streaming and recording using Epiphan Live for more information 4 Live view panel Displays the active live layout that is currently being streamed or recorded The live l...

Page 88: ...iphan Live The Switcher interface lets you easily live switch between custom layouts with the simple press of a button To switch layouts while live streaming and recording 1 Log in to Epiphan Live The Dashboard view opens by default See Access Epiphan Live using a web browser or mobile device 2 Tap the Menu icon in the upper right corner of the Dashboard screen and tap Switcher to open the Switche...

Page 89: ...el are displayed in a carousel along the bottom of the screen The layout that is live is displayed in the Live panel on the right side of the interface see About the Switcher interface 4 In the carousel tap the layout that you want to switch to next That layout is loaded into the Preview panel 77 ...

Page 90: ...anel to the Live panel The layout that was in the Live panel moves to the Preview panel so that it s ready for the next time you switch 6 To load a different layout into the Preview panel tap another layout in the carousel Your recordings All recordings made using Epiphan Live are saved to the Your recordings panel 78 ...

Page 91: ...e file selects it so that it can be managed through the other tools on the page You may also download or delete an individual file by using the action items at the end of the file line Tap the file name to rename the file 4 Page indicators The page number indicates which page of results you are currently viewing and how many pages of results are there The buttons allow you to move between pages on...

Page 92: ...phan Live See The Admin panel and Epiphan Live for details about how to use these interfaces and how to access the local web versions About remote login and control Perform secure remote rescue troubleshooting channel configuration and more when you pair Pearl Mini to your free AV Studio account Remote login access to your Pearl Mini is available as soon as you pair Pearl Mini to AV Studio see Pai...

Page 93: ...s Pearl Mini s encoder entry in AV Studio to permanently go offline For information about how to use AV Studio and perform quick low touch video editing and deliver the rendered recordings conveniently from the cloud see Using AV Studio to control Pearl Mini Enable or disable AV Studio for remote login Pairing Pearl Mini to your AV Studio account for remote login and control is enabled by default ...

Page 94: ...t time you pair Pearl Mini For more information see Using AV Studio to control Pearl Mini You can pair Pearl Mini directly using the Admin panel or you can add Pearl Mini as an encoder manually from within AV Studio by entering Pearl Mini s device ID paring code To add Pearl Mini as an encoder manually in AV Studio go to the AV Studio online user guide You can unpair Pearl Mini using either the Ad...

Page 95: ...line in AV Studio To pair and unpair Pearl Mini 1 Login to the Admin panel as admin see Connect to the Admin panel 2 From the Configuration menu select AV Studio The AV Studio status page opens The pairing code device ID for Pearl Mini is shown as well as a link to pair the device 3 Select Click to pair The AV Studio login page opens in a new tab https go avstudio com 4 Login to your existing AV S...

Page 96: ...nel It s really convenient to remotely control live switching recording and streaming from anywhere using the cloud versions of Epiphan Live and the Admin panel You can access the cloud versions of the Admin panel and Epiphan Live from any location that has access to the Internet after you ve paired Pearl Mini to AV Studio see Pair and unpair Pearl Mini from AV Studio After you ve logged in to the...

Page 97: ...s in your browser 4 Enter your Admin panel login credentials to log in to the cloud version of the Admin panel The default administrator username is admin 5 Click Epiphan Live in the upper right corner The Epiphan Live dashboard opens in a new tab See The Admin panel and Epiphan Live for details about how to use these interfaces or how to access the local web versions Using AV Studio to control Pe...

Page 98: ...cloud l Change video and audio encoding settings for a channel l Access cloud versions of the Admin panel and Epiphan Live for remote login and control see Access cloud versions of the Admin panel and Epiphan Live For more information about AV Studio see the AV Studio online user guide Important considerations l Channels that you record directly using AV Studio are not saved to the same location a...

Page 99: ... control When Pearl Mini is paired to AV Studio up to four channels configured on Pearl Mini are automatically listed on the AV Studio status page in the Admin panel The listed channels can be remotely controlled from AV Studio just like separate encoders for as long as Pearl Mini is paired You can easily change which channels are listed and deselect channels to prevent them from being remotely co...

Page 100: ...sing AV Studio Once uploading is enabled recordings continue to upload automatically until you select stop uploading l Some costs are incurred when uploading recordings to a pay as you go AV Studio account l If you use the Admin panel to delete a selected channel while Pearl is paired no channel appears selected However you can still access any recordings or scenes that were created with that chan...

Page 101: ...ck Start recording to remotely start recording the channel on Pearl Mini The button changes to Stop recording When you re ready to stop recording the channel click Stop recording View and download AV Studio recordings locally Channels that you record directly using AV Studio are not saved to the same location as recordings you make for the channel using the Admin panel or Epiphan Live A different ...

Page 102: ... do not automatically upload to AV Studio by default You can manually start uploading using AV Studio Once uploading is enabled recordings continue to upload automatically until you select stop uploading l After recordings are uploaded to AV Studio the local copy on Pearl Mini is permanently removed l Some costs are incurred when uploading recordings to a pay as you go AV Studio account l If you u...

Page 103: ...y by increasing or decreasing the channel s Bitrate value Video with a high level of motion and high resolution such as sporting events requires a higher bitrate l Frame rate Enter a specific video frame rate for your channel The default is 30 fps l Enable audio Select to include audio from this channel l Audio preset Choose the audio encoding for the channel The default encoding is AAC 48 kHz l A...

Page 104: ...e three dots and choose Details The Encoder Status page for that channel opens 4 Select the Settings tab to configure the encoder settings for the channel The channel settings on Pearl Mini change automatically after you select the new values here The amount of time it takes for the selected option to update on the Settings tab depends on the speed of your Internet connection and how often your co...

Page 105: ...uration and covers how to access status information and monitor the performance of your Pearl Mini Topics include l Configure network settings l Configure network security l Tether to a mobile network l Configure date and time l Format the SD card l Audio input ports l Video output ports l Set up Kaltura CMS integration l Configuration presets l User administration l Status and monitoring ...

Page 106: ...n these ports Blocking a port will cause the service that uses that port to fail It is possible to use the Admin panel to change the default ports that are used for some services Table 14 Default incoming network ports for Pearl Mini Port or range Protocol Description 21 TCP FTP server if enabled See Local FTP server 22 TCP SSH for remote support See Configure remote support 80 TCP HTTP HTTPS for ...

Page 107: ...00 to 65000 TCP UPnP media server if enabled Each time the UPnP server is started a random TCP port in this range is used to enable connections with other UPnP devices 5353 UDP For multicast DNS discovery See Connect using a DNS based service discovery 8000 to 8000 x 1 TCP For Flash FLV live stream and MPEG TS streaming on your network where x is the number of channels configured The number of por...

Page 108: ...t be changed You may need to share this value with your system administrator Current IP Address Reflects the current internet protocol address IP address of the system This value is either obtained from the DHCP server if using DHCP or is the configured static IP address Pearl Mini supports IPv4 addresses It does not support IPv6 addresses To view network information using the Admin panel 1 Login ...

Page 109: ...tion Configure a static IP address There are two ways you can set up Pearl Mini to use a static IP address l From the Network configuration page using the Admin panel l From the Settings menu using the touch screen on Pearl Mini TIP Using the touch screen you can choose to apply a configuration preset that contains a static network IP See Configuration presets Only IPv4 addresses are supported Pea...

Page 110: ...Pv6 addresses Network Mask Also called the subnet mask this value denotes a range of IP addresses Obtain this from your network administrator from another computer on the same subnet or calculate the value using an online subnet calculator Default gateway The network node that serves as an access point to the rest of the network This value cannot be blank unless you are using DCHP Specify the syst...

Page 111: ...ic IP address in those fields 4 Reboot Pearl Mini when prompted From the Configuration menu select Maintenance and click Reboot Now on the Maintenance page 5 After the system has finished rebooting use the new IP address to log back in to the Admin panel as admin and verify that all changes were applied To configure a static IP address using the touch screen 1 Tap the gear icon to open the System ...

Page 112: ...th DHCP you can do this three different ways l Restore factory settings which clear all your custom settings See Perform a factory reset l Load a configuration preset file that uses DHCP networking See Apply a configuration preset using the Admin panel or Apply a configuration preset using the touch screen l Change the network settings manually using either the touch screen or the Admin panel To m...

Page 113: ... the Use DHCP drop down and change the MTU Size if needed then click Apply Table 17 DHCP Fields Label Description Options Use DHCP Select this option to dynamically obtain an IP address at boot up using DHCP Use static address Only select this option if you ant to use the configured static IP address instead MTU Size The maximum transmission unit MTU specifies the maximum packet size for transfer ...

Page 114: ...lues On Pearl Mini the default HTTP port is 80 and the default HTTPS port is 443 If the default ports used by Pearl Mini are not available on your network you can change them using the Admin panel Consult your system administrator for the correct port values to use for HTTP and HTTPS traffic Ensure that the port value you choose is unique and is not currently assigned on Pearl Mini see Network por...

Page 115: ...Mini and try to ping the IP address or use traceroute to determine the path taken to the IP address However note that not all networks support ping and traceroute If you are unable to resolve your networking issues contact your network administrator and provide them with the IP address and MAC address of your Pearl Mini otherwise contact Epiphan Video support for assistance To ping or traceroute a...

Page 116: ...557 to discover the Pearl Mini devices on your network You can disable Pearl Mini port 5557 using the Admin panel so that your Pearl Mini is not discoverable on that port To disable the discovery utility port 5557 using the Admin panel 1 Login to the Admin panel as admin see Connect to the Admin panel 2 From the Configuration menu select Network The Network configuration page opens 3 Uncheck Make ...

Page 117: ...Pearl Mini User Guide Disable the network discovery utility 105 ...

Page 118: ... l EAP TLS l EAP TTLS Important considerations l If TLS authentication is used on the network then you need to get a user certificate and a user private key from the network administrator and upload those to Pearl Mini as part of this procedure l Before you proceed with this setup check that the network server s signed CA certificate appears in the list of CA certificates on Pearl Mini and is vali...

Page 119: ...cted if PEAP or EAP TLS is the EAP method Table 18 Authentication methods EAP method Authentication method PEAP EAP MSCHAPv2 EAP TLS TLS EAP TTLS EAP MSCHAPv2 TLS PAP 6 Enter the network access User name and Password to use for this device Available fields depend on the EAP method that is selected 7 If TLS is chosen as the Authentication method upload a user certificate and a user private key You ...

Page 120: ...security and manage user certificates You can add more CA signed and self signed certificates using the Admin panel as well as delete any certificates that you ve uploaded You cannot delete any of the built in CA certificates that came preloaded on Pearl Mini To manage CA and self signed certificates on Pearl Mini using the Admin panel 1 Login to the Admin panel as admin see Connect to the Admin p...

Page 121: ... Epiphan Video comes preloaded on Pearl Mini You can upload your own certificate and private key and use those as well as delete them However you cannot delete the default self signed certificate that comes preloaded onPearl Mini If you attempt to access the web based Admin panel using a web browser and the required security certificate isn t found in the list of certificates loaded on Pearl Mini ...

Page 122: ...i when you try and connect to Pearl Mini using a web browser you ll receive a warning that the device isn t trusted 6 Click Apply when you re done 7 Reboot Pearl Mini when prompted After the system has finished rebooting log back in to the Admin panel as admin and verify that all changes were applied If you need to delete the certificate you uploaded and the private key click Delete certificate or...

Page 123: ...By contrast actively published streams to CDNs are closed and reconnected via the secondary network mobile or Ethernet automatically as long as the publishing server is accessible from the new network However be aware that some publishing servers such as Facebook and YouTube will end the live streaming session if the stream drops AFU to a connected USB memory device does not copy recorded files to...

Page 124: ...terruptions mobile data will continue to be used until the mobile network is down or publishing is restarted Prefer tethering When chosen the system tries to use the mobile network tethering first It switches to use Ethernet hard wired when the mobile network is no longer available To prevent viewer interruptions Ethernet data will continue to be used until the Ethernet network is down or publishi...

Page 125: ...l Manually set the date time and zone View the current date and time settings There are two ways to view the current date and time settings of Pearl Mini l From the Date and Time page using the Admin panel l From the Settings menu using the touch screen on Pearl Mini You can manually set the date and time change the time zone and set up for a local Network Time Protocol NTP server from the Date an...

Page 126: ...ime is set manually If time is not being set manually a time synchronization protocol is used Date The current date This is the current date even if the radio button Set time manually is not selected Time The current time This is the current time even if the radio button Set time manually is not selected To view the current date and time using the touch screen 1 Tap the gear icon to open the Syste...

Page 127: ... time synchronization source for Pearl Mini For more information about NTP and to find NTP servers refer to http support ntp org bin view Servers WebHome RDATE RDATE is a tool for querying the current time from the network It is generally considered obsolete and has been replaced by NTP It s offered here for backwards compatibility purposes PTP v1 The Precision Time Protocol PTP is used for clock ...

Page 128: ...cast address 224 0 1 132 5 Click Apply Manually set the date time and zone Pearl Mini uses NTP for time synchronization by default However you can manually set the date and time for Pearl Mini using the Admin panel You can also set the time zone Pearl Mini uses the Eastern Canada time zone by default To manually set the date time and zone 1 Login to the Admin panel as admin see Connect to the Admi...

Page 129: ... see Connect to the Admin panel 3 From the Configuration menu click SD Card The SD Card configuration page opens 4 Select either quick disk format or the full disk format then click Format A full disk format checks for bad blocks on SD card and marks any that are found on the ext4 partition You must wait for the formatting to finish before removing or recording to the SD card The amount of time it...

Page 130: ...tom power for the two XLR ports Topics include l Enable or disable phantom power l Configure audio ports for stereo or mono l Assign audio sources to an input l Adjust audio gain and delay l Mute audio For details about the audio inputs see AV inputs Enable or disable phantom power Phantom power is not enabled on the XLR audio input ports by default on Pearl Mini You can enable 48 V Phantom power ...

Page 131: ... XLR TRS Audio The XLR TRS Audio page opens 3 Check Phantom power 48V then click Apply Configure audio ports for stereo or mono The two combo XLR TRS audio input ports on Pearl Mini ports are configured to work together as a stereo pair by default l XLR TRS 1 left l XLR TRS 2 right Using the Admin panel you can configure these ports to function as a stereo pair left right or as separate mono ports...

Page 132: ... to an input Some audio input ports share internal audio processing resources in Pearl Mini These shared audio sources appear in the same configuration menus in the Admin panel and appear under the same audio input label in the user interfaces The audio sources that share resources are l RCA left and right ports l 3 5 mm stereo port Both the RCA and 3 5 mm audio sources appear under the label RCA ...

Page 133: ...uipment The audio delay feature helps you adjust audio coming from external sources so that your video and audio sources are synchronized when captured streamed and recorded By default there s 0 ms of delay applied to your audio sources You can set the amount of delay for any audio source using the Admin panel and apply from 300 ms and 300 ms of delay Adjusting the Input Gain for an analog audio s...

Page 134: ...dB gain to the audio input port 3 5 mm Add 6 to 12 dB gain to the audio input port Condenser microphone with phantom power XLR Add 40 to 60 dB gain to the audio input port Mobile phone or other consumer line level device TRS Add 6 to 12 dB gain to the audio input port XLR Add 6 to 12 dB gain to the audio input port RCA1 Nominal Professional mixer TRS Nominal XLR Nominal RCA Not recommended 1 To av...

Page 135: ...puts you can mute each port separately Some audio input ports share internal audio processing resources in Pearl Mini Muting an audio input that shares internal resources mutes all the associated audio sources The following table lists the audio input ports that share internal processing and the results of applying mute Table 24 Muting audio inputs that share resources Audio input Admin panel Shar...

Page 136: ...he XLR 1 left and TRS 1 left ports are not muted RCA 3 5 mm Audio RCA left right 3 5 mm left right Both RCA ports left and right are muted Both 3 5 mm ports left and right are muted To mute an audio source 1 Login to the Admin panel as admin see Connect to the Admin panel 2 From the Inputs menu select an audio source The audio configuration page for the audio source opens 3 Check Mute to mute the ...

Page 137: ...Pearl Mini User Guide Mute audio 4 Click Apply 125 ...

Page 138: ...he output port l Preview the video output port l Disable the video output port l Disable or enable audio and output port volume l Display and reposition the audio VU meter l Rename a video output port l Mirror the video output port display About video output ports An HDMI video output port is located on the rear panel of Pearl Mini The output port is set to display HDMI A input port by default but...

Page 139: ... using the video output port for confidence monitoring some delay can be expected For a 1080p video source the average delay on the video output port is approximately 100 ms For a 1080p channel the average delay on the video output port is approximately 300 ms The actual amount can vary depending on the setup l When the output port settings are changed or when an external monitor is connected or d...

Page 140: ...deo output port For channels with audio you can configure whether or not audio is included and adjust the volume You can also choose to include the audio meter The audio meter is set to a fixed size of 15 of the width or height if displayed horizontally of the display Audio is not supported when sending a video source to the video output port To set up the video output port using Epiphan Live see ...

Page 141: ...ch display has a preferred resolution and when you choose this setting the video output port will use the display s default resolution 640 360 640 480 960 540 1024 768 1280 720 1280 960 1360 768 1400 1050 1920 1080 1920 1200 2560 1440 Choose a specific resolution for the output port For an explanation of the different choices see Show a channel or video source on the output port 5 Do one of the fo...

Page 142: ...on drop down to change the orientation of the displayed audio meter 8 For input sources do the following a Select an Audio source from the drop down list b Optional Adjust the volume Enter a value from 0 to 100 percent in the Audio volume field c Optional Choose whether or not to display the audio meter from the Audio meter drop down d If displaying the audio meter select horizontal or vertical fr...

Page 143: ... to a black screen You can also preview video output ports using the Epiphan Live control interface See Monitor and setup the output port source and audio for more information Disable the video output port You can use the Admin panel to disable a video output port so that even if a display is connected nothing is shown To disable video output ports using the Epiphan Live see Monitor and setup the ...

Page 144: ... is taken from the video input source you ve selected for the video output port by default Decoupled audio sources appear as a single stereo audio source You cannot select individually decoupled audio sources To disable the audio for a channel on the video output port and adjust the volume using the Admin panel 1 Login to the Admin panel as admin see Connect to the Admin panel 2 From the Outputs m...

Page 145: ... down to change the orientation of the displayed audio meter 4 For input sources do the following a Select an Audio source from the drop down list b Optional Adjust the volume Enter a value from 0 to 100 percent in the Audio volume field c Optional Choose whether or not to display the audio meter from the Audio meter drop down d If displaying the audio meter select horizontal or vertical from the ...

Page 146: ...se whether or not to display the audio VU meter using the Admin panel You can also determine the position and orientation of the audio meter Audio pass through adjusting the volume and displaying an audio meter are only supported when a channel is the selected video source To configure the audio meter for the video output port 1 Login to the Admin panel as admin see Connect to the Admin panel 2 Fr...

Page 147: ...ter you can also select an orientation horizontal or vertical in the Audio meter orientation field 5 Click Apply Rename a video output port Using the Admin panel or Epiphan Live you can easily change the video output port default name from HDMI 1 to something more suitable For example Projector Output or Confidence Monitor To change a video output port name 1 Login to the Admin panel as admin see ...

Page 148: ...ginal video source on the output port so that it appears reversed on the connected display To mirror the video source on the video output port 1 Login to the Admin panel as admin see Connect to the Admin panel 2 From the Outputs menu click the output port you want to mirror The video output port configuration page opens 3 Check Mirrored to flip the video source s orientation on the display port Un...

Page 149: ...Pearl Mini User Guide Mirror the video output port display 137 ...

Page 150: ...duled webcasting live streaming events Once enabled you can register Pearl Mini as a resource and assign it a unique name It may take some time for Kaltura to display a newly registered resource depending on how busy the Kaltura system is when you register The resource name you assign to Pearl Mini should be unique A default resource name that includes the serial number of your Pearl Mini helps to...

Page 151: ...r in Kaltura for this device The default resource name includes the serial number of your Pearl Mini 6 Click Register device If you get the error Unable to register device Error while starting session for partner ensure that you ve entered the correct Kaltura administrator secret and try registering Pearl Mini again What s next Choose which Pearl Mini channels to record for this resource see Selec...

Page 152: ...MediaSpace Important considerations l You can not start ad hoc manual Kaltura events when CMS is disabled or when Pearl Mini has been deregistered l When CMS is disabled or Pearl Mini is deregistered existing scheduled events that are associated with the device do not record or stream l If Pearl Mini is deregistered existing events associated with that device lose the association You must select a...

Page 153: ...tura a warning message appears when you try to apply the new resource name to Pearl Mini l If there s only one other registered resource with that name you re prompted to choose whether or not to take over the events for that other resource If you do take them over Kaltura transfers all scheduled events from that other device over to Pearl Mini l If more than two other resources are already regist...

Page 154: ... If you do take them over Kaltura transfers all scheduled events from that other device l If more than two other resources are already registered with the same resource name in Kaltura registration fails You re prompted to choose a different resource name and to try registering Pearl Mini again This works well when you want to change the encoder in a room but retain all the existing schedules and ...

Page 155: ...Access to the Kaltura Management Console KMC l Your Kaltura partner ID l Your Kaltura administrator secret l Your Kaltura user ID To enable Pearl Mini as a resource and register with an existing resource name using the Admin panel 1 Login to the Admin panel as admin see Connect to the Admin panel 2 From the Configuration menu click CMS The Content management system configuration menu opens 3 From ...

Page 156: ...e are three Pearl Mini user levels l Administrator l Operator l Viewer No password is assigned to these user levels by default and you cannot change the default user names or disable these user levels When you log in to Pearl Mini you must log in as one of these three user levels Private profiles with individually set passwords are not used You can set an access password for each user level using ...

Page 157: ... limited Pearl Mini configuration control The default user name used to log in to Pearl Mini is operator Operators can to do the following l Configure inputs l Control recordings start and stop l Rename download and delete recordings l Switch layouts while live streaming l Perform network diagnostics If an operator does not have the privileges to apply a particular configuration in the Admin panel...

Page 158: ... that overrides the global value see Restrict viewer access to channel streams User privileges The following table outlines the privileges for each user level Table 25 User privileges in the Admin panel Action or Menu Option viewer operator admin View Channel Output ü ü ü Channel Operations View Channel Configuration ü ü Rename a Channel ü Configure Stream Channel ü Configure Stream Sources ü Publ...

Page 159: ...Operations Enable CMS and register ü Start stop scheduled events ü ü Start stop ad hoc events ü ü View the Events page ü ü System Configuration Operations View System Configuration ü ü Configure Automatic File Upload ü Select External USB Drive Behavior ü Configure FTP Server ü Configure UPnP Sharing ü Configure Network Address ü Configure USB Tethering ü Perform Network Diagnostics ü ü Configure ...

Page 160: ...Time Until Next Disk Check ü Perform Disk Check ü View Disk Information ü ü Enable disable AV Studio feature ü Upgrade Firmware ü View System Information ü ü Set or change user passwords The admin operator and viewer level users have no assigned password by default For higher security we recommend that you assign a password for at least the admin and operator level viewers as soon as possible Admi...

Page 161: ... to the Admin panel as admin see Connect to the Admin panel 2 From the Configuration menu select Security The Security configuration page opens 3 Highlight and delete the current password for your selected user Eight dots mask the password regardless of the password s actual length and appears even if no password is set 4 Highlight and delete the confirmation password for the selected user 5 Selec...

Page 162: ... the user whose password you just cleared you are logged out and must log back in without a password If you cleared the viewer s password all viewer streams will pause until they log in without a password To clear a user s password on a specific channel 1 Login to the Admin panel as admin see Connect to the Admin panel 2 From the Channel menu select a channel and click Streaming The channel s Stre...

Page 163: ...admin operator or viewer using the passwords for those accounts LDAP replaces the local viewer account instead of working side by side with it when LDAP is enabled and the viewer account has no password either there is no global viewer password configured or the channel overrides the global password with a blank password In this case the viewer must authenticate with LDAP and cannot use the defaul...

Page 164: ...h for entries The system will search this object and the whole subtree starting at the base DN 8 Optional By default the search attribute is uid which is suitable for a unix environment You can specify a different value in the Search attribute field if needed For Active Directory environments specify userPrincipalName The value of this attribute must be unique in the Base DN 9 In the Administrator...

Page 165: ...t to log in to the system the system name is shown and a second time to log in to the channel the channel name is shown Change the logged in user After you log in to the Admin panel as an Administrator or Operator your browser remembers this configuration and automatically logs you in using the same user account the next time you log in to Pearl Mini To log in using a different user account 1 In t...

Page 166: ...ermitted IP address and must also supply the user name viewer and password before they can view the broadcast To restrict access by IP address you need to know the IP addresses or range of addresses for your viewers By default all IP addresses are allowed to connect to the broadcast If a user attempts to connect to the stream from a disallowed IP address access is denied If there s an attempt to c...

Page 167: ...ple Description Allow list with distinct IP addresses The simplest allow deny list is to use the list of known IP addresses to craft a list of allowed IP addresses All other addresses are denied access to the broadcast For example if your system is accessible on your local area network LAN and you want to make sure only the CEO s specific desktop laptop and tablet computers with IP Addresses 192 1...

Page 168: ...e Add these IP addresses to the list as follows Allow 192 168 1 200 192 168 1 250 192 168 1 50 192 168 1 51 192 168 1 75 Your list can have multiple ranges and multiple distinct IP addresses provided they are separated by commas Allow list with a range of IP addresses distinct IP addresses and an exception Building on the previous examples consider a situation where you want the CEO s computers 19...

Page 169: ...eny list can specify a range of IP addresses and can specify multiple ranges or distinct IP addresses in a comma separated list Deny list with a range of IP addresses Consider a situation where you want every computer on the network to access the broadcast with the exception of the CEO s desktop laptop and tablet computers Additionally boardroom computers should not be permitted with the exception...

Page 170: ...onfiguration presets Configuration presets are groups of settings that get applied to the system leaving other important settings intact They make it easy to manage multiple Pearl Mini systems and shared spaces like a studio a breeze to set up and maintain a consistent setup each time you go to use your Pearl Mini Configuration presets let you quickly apply settings to your Pearl Mini so you can r...

Page 171: ... and create custom channel configuration presets for several different keynote speakers each with a different setup and then apply them later when you need them For example you could create two configuration presets called Session 1 and Session 2 Each session could include things like custom backgrounds images and logos channels and layouts metadata streaming settings network settings and automati...

Page 172: ...ew configuration preset is applied if AFU is not yet complete but the channels reflect the newly loaded session s background file name and presenter name Configuration preset considerations There are important considerations that you should know before you start using configuration presets including l Access to presets and privacy considerations l The potential to lock the touch screen l Channel a...

Page 173: ...media or recordings that belong to other users Media files that you ve uploaded to Pearl Mini logos background images etc are included in the configuration preset and must be present on the system when creating a preset that includes the Channels group otherwise a failure is reported Locking out the touch screen The touch screen configuration group includes all the security settings for the touch ...

Page 174: ...ved when channels or recorders are not recording or streaming those channels and recorders will not be recording streaming when the preset is applied This means a channel or recorder may stop recording or streaming as a result of applying the preset For example when applying a preset with channel 3 set to record the same example applies for streaming l If channel 3 exists prior to applying the pre...

Page 175: ...e files Using our previous example if you delete one of the five recordings from channel index 1 you ll find that even after applying different presets channel 1 will have only four recorded files Deleting channels and recordings Recorded files are stored on the system based on their channel or recorder number All files saved for channel index 1 are in one folder and all files for recorder index 2...

Page 176: ...source However you risk having two active Pearl Mini resources with the same identity which can effect recording and the content that s uploaded to Kaltura for scheduled events To remove the risk of having two active devices with the same registered resource identity in Kaltura we recommend powering down one of the Pearl Mini resources then disconnect it from the network and consider performing a ...

Page 177: ...P SCP private keys are included in encrypted format in the automatic file upload preset EDID EDID settings for sources Applying configuration presets with this group automatically applies the included EDIDs This process can take a while Output ports All configuration settings for the output ports Touch screen Permitted touch screen use settings CMS Include CMS settings for Kaltura The Factory defa...

Page 178: ...ted configuration presets ü Removes Kaltura CMS registration information ü ü Removes records for all scheduled and completed CMS events ü ü Deletes all branding files ü Resets all Source settings ü ü Resets EDID to factory ü ü Deletes all SCP SFTP identities ü ü Deletes all LDAP settings ü ü Deletes all Automatic file upload settings ü ü Returning Pearl Mini to the factory defaults or performing a...

Page 179: ...tion groups for which settings are included in each group After you re finished configuring your Pearl Mini it s good practice to save a full backup with all groups selected so that you can restore your full configuration at a later date Configuration presets that include network or system settings require a system reboot when applied Important considerations l If you try to save a configuration p...

Page 180: ...uter and then import it to another Pearl Mini see Export and import configuration presets and you can Apply a configuration preset using the Admin panel Apply a configuration preset using the Admin panel When you apply a configuration preset the system settings for all included configuration groups are updated Other settings on the system are not affected For example if you apply a preset that inc...

Page 181: ...configuration preset name The term all means all groups are included Otherwise groups are listed individually You may apply multiple presets one after another If you apply two or more configuration presets that include a particular configuration group the settings for that group from the last applied preset are the active settings In short last in wins To apply a configuration preset using the Adm...

Page 182: ...ntain the network configuration group can also be applied using an alternative method which is described at the end of this topic To apply a configuration preset using the touch screen 1 Tap the gear icon to open the System settings screen If the control icons aren t showing tap anywhere on the touch screen 2 Tap Configuration Presets A list of all the saved presets appears The configuration prese...

Page 183: ...resets to display the list of saved configuration presets that you can choose from Configuration presets that contain only the network configuration group are listed when you use this method Export and import configuration presets You can download configuration presets to your local computer then upload and apply the preset to other Pearl Mini systems or save the configuration preset as a backup o...

Page 184: ...n presets section click the Download button next to the configuration preset you want to export The configuration preset file with extension preset is saved to your admin workstation in your browser s download folder Import a configuration preset To import a configuration a preset 1 Login to the Admin panel as admin see Connect to the Admin panel 2 From the Configuration menu click Maintenance The...

Page 185: ... configuration preset using the Admin panel or Apply a configuration preset using the touch screen Update a configuration preset To update a configuration preset and add or remove different configuration groups using the Admin panel you simply creating a new configuration preset with the same name so that it overwrites the existing one To update a configuration preset 1 Login to the Admin panel as...

Page 186: ... You can delete all configuration presets at once by doing a factory reset or you can delete individual configuration presets from the Maintenance page You cannot delete the Factory default configuration preset To delete a configuration preset 1 Login to the Admin panel as admin see Connect to the Admin panel 2 From the Configuration menu select Maintenance The maintenance page opens 3 Click Delet...

Page 187: ...Pearl Mini User Guide Delete a configuration preset 175 ...

Page 188: ...onitoring audio and VU sensitivity You can connect headphones or external speakers to the 3 5 mm audio jack on the front panel of Pearl Mini To monitor the audio for a specific channel just select the channel using the touch screen The audio you hear depends on which layout is currently live because different layouts can have different audio sources configured To adjust the volume tap the headphon...

Page 189: ... default when you turn on Pearl Mini If necessary tap the touch screen once to turn it on and tap again to display the controls Table 32 Grid view indicators Item Description Streaming and recording indicators Streaming left and recording right indicators appear in the top right corner for each channel no dots Streaming is disabled and recording is stopped Streaming is stopped and recording is sto...

Page 190: ...p and start recording from the individual channel view Audio VU meter Each channel has an audio VU meter that uses quasi peak ballistics with samples averaged every 10 ms The maximum average audio level in each 100 ms period is displayed using colored bars l RED 0 to 9 dBFS l Yellow 9 to 18 dBFS l Green 18 dBFS and lower You can do more monitoring for a specific channel when you select a channel f...

Page 191: ...recording is stopped Flashing red means recording is in progress Recording has an error Recording timer The recording timer shows the length of time that recording has been in progress Audio VU meter Audio VU meter for the channel uses quasi peak ballistics with samples averaged every 10 ms The maximum average audio level in each 100 ms period is displayed using colored bars l RED 0 to 9 dBFS l Ye...

Page 192: ...reen using the touch screen The System Status screen displays basic system information that s useful when first setting up your Pearl Mini Label Description Device Information l Serial number l Video grabber number l Firmware version Network Information l IP Address l MAC Address Device Status l System date l System time l Uptime l Temperature in degrees Celsius Storage Information when available ...

Page 193: ...f the control icons aren t showing tap anywhere on the touch screen 2 Tap System Status to see the System Status page 3 Tap Back to return to the System Settings screen or the Home icon to return to the channel view If the system settings control icon won t appear when you tap the touch screen it may be disabled See Configure the touch screen to enable system information 181 ...

Page 194: ...l 2 From the Configuration menu click Info The system information page opens View 802 1x network connection status messages When you first connect your Pearl Mini to a network the status of the connection is displayed on the System Status touch screen see View system information using the touch screen You can also check the network status from the Network menu using the Admin panel Network status ...

Page 195: ... on the 802 1x network failed If you attempt to connect to a network that isn t 802 1x enabled when 802 1x is configured on Pearl Mini a consistent 802 1x FAILED status message appears on the Network Configuration page in the Admin panel View the video output port status The current status of the video output port and attached video display appears at the top of the video output port configuration...

Page 196: ...t functioning Source is currently unavailable The video output port is configured to display a channel that no longer exists Change the source See View the video output port status Starting The video output port is configuring the display and will shortly output the first frame Running at w h The video output port is functioning at the specified resolution You can also view video output status usi...

Page 197: ...isabled l In Progress files are in queue to be transmitted for upload according to specified time interval within the next 6 12 or 24 hours See Enable AFU and set parameters l Error an error has occurred with the AFU 2 Protocol Provides the configured AFU protocol l FTP l RSYNC l CIFS l SCP l SFTP l AWS S3 Client l WebDav l External USB drive 3 Queue Displays the number of files currently in the A...

Page 198: ...sible on the touch screen tap the screen once to activate the control buttons If the system settings button is still not visible it is disabled in the system s touch screen configuration See Configure the touch screen to enable system information 2 Tap the arrow icon in the lower right corner of the screen to go to the second Settings page 3 Tap Automatic File Upload to display the AFU Status page...

Page 199: ... menu to see up to 90 days of upcoming scheduled events and up to 90 days of ongoing and completed events for this Pearl Mini resource Click the page arrows at the bottom of each list to navigate through multiple pages The Events page updates to show new Kaltura events every hour Click Refresh schedule at any time to manually update the Events page The Events page only displays when CMS is enabled...

Page 200: ...lay the Events screen The icon only appears when Kaltura CMS is enabled on Pearl Mini The Events screen displays automatically on the touch screen of Pearl Mini about five minutes before a scheduled event starts For events with more channels than can be previewed at the same time on the touch screen an arrow appears so you can scroll through a carousel of channel previews The Events touch screen d...

Page 201: ...recording This section covers how to create channels and add custom layouts so that you can capture stream and record exactly what you want how you want Whether that s a simple channel with a single video and audio source or channels that have multiple video and audio sources and custom layouts like picture in picture Topics include l What is a channel l Channel layout examples l Channel configura...

Page 202: ...rces to the same layout for picture in picture or side by side layouts using the convenient custom layout editor You can add text overlays and effects like transparent logos and lower thirds Customize your channels with images company information corporate colors and time stamps just to name a few possibilities When you use the custom layout editor to create multiple layouts in a channel you can l...

Page 203: ...cording then recording is stopped and a new file is started If you delete all the layouts in a channel until there is only one layout left and that layout has only one video source assigned then the channel name changes back to the name of the video source For example Channel 1 changes to HDMI A To avoid channel name changes we recommend that you rename the channel to a custom name Changing the ch...

Page 204: ...ottom left corner To get this look Upload an image with transparency Using the custom layout editor add one video source to the layout select keep aspect ratio and stretch to fill the entire layout area Then add the image to the layout and drag it where you want it to appear on screen One source with a text overlay in the bottom right corner To get this look Using the custom layout editor add one ...

Page 205: ...he entire layout area Then add your two video sources to the layout adjusting their size and position as needed Lastly add the logo to the layout and move it in to position For the second video source use the Crop tool to crop the second source to a square aspect ratio Examples including a 4x3 video source Layout example Description One 4x3 video source at the full size of the channel To get this ...

Page 206: ...eo source to the layout and stretch to the full height of the screen leaving the background matte visible One 4x3 video source and a cropped 16x9 video source together with a background image Make sure the background image has the correct aspect ratio To get this look Upload your background image you can do this from the Media page or the Layouts page for the channel Follow the steps from the firs...

Page 207: ...ting automatically sets the channel frame size to match the frame size of the video source Changing the frame size to a fixed value ensures that you don t experience any stream interruptions if the frame size of the video source changes like when switching between different layouts that contain a single video source with different frame sizes Topics include l Create a channel l Add video sources o...

Page 208: ...els when configuration presets are used see Configuration preset considerations It s possible to create a third channel and adjust the encoding settings of your channels to economize the CPU processing but we don t guarantee optimum performance from your Pearl Mini with three channels To optimize the performance of your Pearl Mini if you have more than two channels configured consider deleting unu...

Page 209: ...Pearl Mini User Guide Create a channel 3 Click Add new item and select Video Source 4 From the Source settings select a video source in the Source drop down 197 ...

Page 210: ...lick and drag the red and white handles on the corners of the source to re size it in the layout editor area For a single source channel it should fill the entire layout area Alternatively you could enter a value in the percentage boxes that are along the side and bottom of the layout editor area to resize the video source 6 Select an audio source from the list of audio sources 198 ...

Page 211: ...l as a source You can add one or multiple video sources to any of the layouts for your channel using the custom layout editor You can even add the output from another channel as a video input source When you add a channel as a video source in another channel whatever is displaying live in that channel also displays in the other channel This is useful when you need to stream the same switched progr...

Page 212: ...witching between multiple layouts if the different layouts happen to have different video sources with different resolutions see Configure encoding To add a video source or a channel as a source 1 Login to the Admin panel as admin see Connect to the Admin panel 2 From the Channel menu select a channel and click Layouts The custom layout editor opens 3 In the Layouts list that appears at the top of...

Page 213: ...nd white handles on the corners of the source to re size it in the layout editor area Alternatively enter a value in the fields along the side and bottom of the layout editing area to resize the selected item For a channel with only a single video source it should fill the entire layout area For a layout that includes multiple video sources you can move resize or crop each video source to exactly ...

Page 214: ...em Click and drag the round red and white handles to resize an image or video source for text overlays just use the padding settings Using this method you can make quick changes that are in increments of approximately 5 of the width or height of your layout area For more refined movements press the Ctrl key on your keyboard while dragging the item with the mouse To use the keyboard Use the arrow k...

Page 215: ... corresponding audio for that channel is added automatically l You can add multiple audio sources to the same layout However if the two audio sources share all or some of the same audio signals such as when two in phase microphones are placed in close proximity to each other then the common audio signals are amplified l Selecting multiple loud audio sources in the same layout may cause audio clipp...

Page 216: ... to use for the layout and click Save What s Next You can check the audio encoding settings for your channel and ensure that audio is enabled see Configure encoding To adjust the gain for an audio input source see Adjust audio gain and delay Duplicate a channel You can duplicate any channel you ve created All settings in the channel you duplicate are recreated To duplicate a channel 1 Login to the...

Page 217: ...annel X where X is the index number for the channel To stop a channel name from automatically changing you should assign the channel a custom name using the Admin panel You can change a channel s name from any of the channel configuration pages or using the custom layout editor To rename a channel 1 Login to the Admin panel as admin see Connect to the Admin panel 2 From the Channels menu select a ...

Page 218: ...leted We recommend that you stop recording or streaming for the channel before deleting the channel If you have multiple configuration presets deleting a channel removes all recorded files that are related to that channel across all presets For important information about how channels are indexed in Pearl Mini and how that affects deleting channels when configuration presets are used see Configura...

Page 219: ... Info page l Preview a channel from the Status page l Preview all channels at the same time You can also preview channels using Epiphan Live see Configure Dashboard panels for more information Important considerations l Some web browsers disable auto playback of videos with audio In those cases the audio for the channel being previewed is muted by default l HTML5 does not support PCM audio encodin...

Page 220: ... to preview A preview window opens Preview a channel from the Status page You can use the Admin panel to open a preview link for a channel from the Status page The Live broadcast preview can be viewed using web browsers that support HTML5 or Flash You can also see a preview of the channel directly from the Status page itself The Status page lists information about the channel including stream info...

Page 221: ... out and Ctrl control plus to zoom in To preview all channels at the same time 1 Open a new tab in your web browser on the Admin computer 2 Go to the following URL to open the preview web page for your Pearl Mini where ip address is the IP address of Pearl Mini To find the IP address of your system see View system information using the Admin panel or View system information using the touch screen ...

Page 222: ...chedule How metadata is displayed depends largely on the media player For example VLC stores the metadata in a media information file while other media players scroll the text horizontally from right to left across the bottom of the media player window To add or remove channel meta data 1 Login to the Admin panel as admin see Connect to the Admin panel 2 From the Channels menu select a channel and...

Page 223: ...igh quality video while using low bandwidth and is the preferred codec to use with the system Motion JPEG Motion JPEG is suitable for live streaming and video however you can experience low quality images while using high bandwidth Motion JPEG does not support audio Table 38 Supported audio codecs and bitrate guidance Value Description AAC AAC is comparable to MP3 and may even provide better sound...

Page 224: ...a standard for digital audio in computer and other devices such as digital telephone systems Setting the level to match the audio source s level provides the best sound quality and avoids audio resampling Most digital signals HDMI or SDI sources use 48 kHz audio For analog signals 44 kHz provides a good quality audio sample The Flash FLV plugin must be installed for your web browser to play back a...

Page 225: ...each channel using the Admin panel Video encoding settings include l Video codec The video codec determines the type of compression and decompression and also affects the video quality Options are H 264 default and Motion JPEG l Hardware or software encoding Hardware encoding is the default setting and is the recommended encoding for use with Pearl Mini l Encoding level This can be set to High Mai...

Page 226: ...e channel at the lower frame size using less bandwidth and producing smaller recorded files You can also add black bars around your video source by adjusting the frame size For example if your video source has a 16 9 widescreen HD format but you need a 4 3 frame size on your output Pearl Mini automatically adds black bars to the top and bottom of the frame if you choose a frame size for the channe...

Page 227: ...ep the interval between 2 to 3 seconds and decrease the key frame interval as the motion increases Try different settings and note changes in the video quality If your video quality is poor and jittery you may need to decrease the interval between key frames If you have unlimited bandwidth and system resources you can choose an option to stream key frames only Frame rate Frame rate reflects the nu...

Page 228: ...ng configuration page opens 2 Select a video Codec and do one of the following a If JPEG is selected click Page refresh time and enter a time in seconds b If H 264 is selected select a Video encoding preset and a Video encoding profile Item Options Video encoding preset Hardware Accelerated This is the default H 264 encoding preset Choose this setting for best performance Software This matches the...

Page 229: ...y An unstable cable or other disturbance that causes the resolution of the video input signal to change during a live stream can cause the stream to drop Unchecking this feature helps prevent that b Select a Frame size from the list of options or enter a custom frame size in pixels 4 Change the Limit frame rate The default should be adequate in most applications While decreasing the limit may impr...

Page 230: ...ported Note that lower bitrates e g 32 kbps with a 44 kHz signal may result in distorted audio MP3 MP3 provides a common audio format for audio storage Supported values are 22 kHz 44 kHz and 48 kHz Most digital signals HDMI or SDI sources use 48 kHz audio Matching the encoded level with the source level provides the best sound quality by avoiding audio resampling For analog signals 44 kHz provides...

Page 231: ...hrough both the left and right channels 6 From the Audio bitrate drop down choose a birtrate For guidance see audio bitrates For stereo audio we recommend 256 kbps or 320 kbps 7 Click Apply Multi encoding and channel as a source Pearl Mini lets you easily do multi encoding so you can record and stream the same content at different encoding settings This is useful when you want to l Record a video ...

Page 232: ...ntical program All you need to do now is configure each channel for the encoding settings you want Follow these steps 1 Login to the Admin panel as admin see Connect to the Admin panel 2 Create Channel 1 with your video and audio inputs Add all your live switching layouts 3 Set the encoding and streaming settings for channel 1 4 Create Channel 2 for your recording with just one layout and add Chan...

Page 233: ...t you add to your channel adds overhead to Pearl Mini and more complex layouts consume more of the system s resources So it s a good idea to delete any layouts you re not using Topics include l About the custom layout editor l Add or edit a custom layout l Upload or remove an image using the Media page l Add an image to a layout l Crop a video source l Add a text overlay l Custom system variables ...

Page 234: ...reate and delete layouts duplicate layouts choose which layout to preview and edit and select the active live layout for live switching Layout editing Below the layout list is the layout editing area where you can add images add and edit video sources and add text overlays to your layout You can also choose the background matte as well as crop the images and video 222 ...

Page 235: ...n the aspect ratio when resizing an item make sure you ve checked the Keep aspect ratio when scaling box for that item A note about item positioning and sizing There are four ways to position and size items in the layout area 1 using the mouse 2 using the keyboard 3 using the manual positioning values with percents 4 using the manual positioning values with pixels To use the mouse Click and drag t...

Page 236: ...k to percents by typing a percent See Resize and position items using percents or pixels for more information Audio source selection and saving edits Select audio source s for your channel by adding them to your layouts The bottom section of the custom layout editor is where you select the audio source for the currently selected layout It s also where you ll find the Save button If a layout doesn ...

Page 237: ...yout editor See Resize layout items and Position layout items There are 3 adjustment boxes along your layout s horizontal axis and another 3 boxes along the vertical axis You can enter percent or pixel values into checked adjustment boxes bordered with red to position and resize your item s Percent values are used in adjustment boxes by default and can be converted to pixels by simply overwriting ...

Page 238: ...our layout item The 4 red white dots represent the boundaries of your layout item There may be some black space between your item and its boundaries if Keep aspect ratio when scaling is enabled see Add an image to a layout 2 The percentage of blank space or number of pixels from left to right on the layout s horizontal axis I e the item is displaced 20 or 200px to the right 3 If using percents thi...

Page 239: ...tal height on the layout s vertical axis I e the item takes up 80 of the layout s height represented by a thin red bar to the left of the percent box If using pixels this value is the item s height in pixels with a maximum pixel width i e frame size identified in your channel s encoding settings Configure encoding 7 The percentage of blank space or number of pixels from the top downward on the lay...

Page 240: ...ou originally set the width of an item to 50 of the layout area or 960 pixels assuming your item has a maximum width of 1920 pixels in this example with no values entered in the left and right adjustment boxes i e the left and right boxes are deselected the item automatically centers itself in the layout area with the left and right percents at 25 each remember percents are used by default in the ...

Page 241: ...or pixels of the layout s width or height Alternatively you can position your layout items using the keyboard by selecting the item with your mouse cursor and pressing the arrow keys to move the selected item by 5 in any direction You can also position your item with additional keyboard precision by holding Ctrl and pressing the arrow keys to nudge your item by a very small fraction in the directi...

Page 242: ... axis any further Alternatively you could reposition the image in the exact same way by instead setting the right percent box to 0 Example 2 vertical positioning using pixels To position your layout item along the vertical axis enter a percent or pixel value into either the top or the bottom adjustment box to shift your layout item downward or upward respectively For example using pixels to move a...

Page 243: ...om look that you want using percents pixels your keyboard or any combination Here s an example of using pixels and percents to created a custom layout with two video sources and a background image Open the custom layout editor for a channel 1 Login to the Admin panel as admin see Connect to the Admin panel 231 ...

Page 244: ...g more intuitive rather than using the default names see Rename a channel and Rename a layout Creating layouts gives you full control over what s presented to your viewers You can do things like change the size and position of images add custom backgrounds up scale and downscale your video sources add multiple audio source and text overlays to mention just a few Important considerations If you re ...

Page 245: ...e custom layout editor page opens 3 Select a layout from the layout list or click Add Layout to create a new layout If this is a new channel or layout the layout area is empty and you see a black background matte See Add video sources or a channel as a source 4 Click and drag the red and white handles on the corners of the video source to re size it in the layout editor area 233 ...

Page 246: ...called Default You can the name using the custom layout editor If you re using the touch screen for live switching consider using shortened names for layouts Long names get truncated on the touch screen To rename a layout 1 Login to the Admin panel as admin see Connect to the Admin panel 2 From the Channels menu select a channel and click Layouts The custom layout editor opens 3 From the layout li...

Page 247: ... Channels menu select a channel and click Layouts The custom layout editor opens 3 In the layouts list click and drag the icon with the three horizontal bars at the left side of the row to rearrange the order of your layouts Delete layouts You can delete any layout except the currently active layout To delete a layout 1 Login to the Admin panel as admin see Connect to the Admin panel 2 From the Ch...

Page 248: ...k the double folder icon at the right side of the row for the layout you want to duplicate A duplicate of the layout is added at the bottom of the list 4 Click OK Important note for channels with multiple layouts The two default channels are named HDMI A and HDMI B Each has a default layout with the corresponding HDMI A or HDMI B video and audio sources already assigned By default when a channel i...

Page 249: ... custom name ensures that no automatic channel renaming happens see Rename a channel Set the background color You can select the background color to fill any unused space in a layout using the custom layout editor For example you can add a color from your corporate color scheme To set a background color matte for a layout 1 Login to the Admin panel as admin see Connect to the Admin panel 2 From th...

Page 250: ... to upload an image using the custom layout editor Note that no warning is displayed if the image is too large or if an image exists with the same name using drag and drop The file will be replaced with the new image you upload If your uploaded image does not appear in the list ensure it doesn t exceed the maximum image size of 4096 4096 To add an image to your layout 1 Login to the Admin panel as...

Page 251: ...5 Your picture appears in the Picture settings preview and is added to the layout area 6 In the layout area use the mouse the keyboard or the manual position value fields to position and resize your image For background images click and drag to fill the full layout area For more details see About the custom layout editor 239 ...

Page 252: ...Add new item and change their order Items that are higher up the list appear over top items that are lower down the list 8 Click Save Upload or remove an image using the Media page You can customize your channels by adding pictures as backgrounds overlays or transparent overlays Image files formats supported include PNG and JPEG The maximum supported image size is 3840 2160 No warning or error mes...

Page 253: ...isting image Important considerations l Media file names should not include special characters slashes or spaces To upload or remove an image using the Media page 1 Login to the Admin panel as admin see Connect to the Admin panel 2 From the Configuration menu click Media The Media page opens 3 To upload a file click Choose File and browse to select the file to upload then click Upload 4 To remove ...

Page 254: ... 2012 01 26 year G 2012 month 01 m 01 month Jan b Jan month January B January day of the month d 26 weekday Thu a Thu weekday Thursday A Thursday time T 08 40 45 hour k 08 minute M 40 second S 45 millisecond m 378 channel name c Camera Feed 1 If you use a non monospaced font the size of the text overlay changes as the letters numbers and the length of words change Use a monospaced font to maintain...

Page 255: ... the order in which items appear on the layout editing area by re arranging the order the items appear in the list beneath Add new item Items at the top of the list appear in front and items lower down the list appear behind 4 In the Text field type what you want to appear in the text overlay Include Overlay text shortcut codes as needed Press Tab or click outside the text field to refresh the pre...

Page 256: ...d the frame size Do not enter negative padding values 6 Resize the overlay text box using the padding settings The handles on the corner of the overlay text box are not click and drag and do not resize the text box To resize the text box use the padding fields to add space above below and on either side of the text 7 In the layout editing area click and drag to move the overlay text box or enter v...

Page 257: ... variables in a single set command After issuing a set command all channels using the specified variables are updated System variables are considered volatile and are deleted when the system reboots See Controlling Pearl Mini using HTTP HTTPS commands to learn more about global variable HTTP command syntax for custom layouts If you use a non monospaced font the size of the text overlay changes dep...

Page 258: ...he Admin panel as admin see Connect to the Admin panel 2 From the Channels menu select a channel and click Layouts The custom layout editor opens 3 Select a video source from the items list The Source settings appears 4 Click Crop Your video source appears in a pop up editing window 246 ...

Page 259: ...distance from the edge that line is drawn You can also erase the px after the number and type in to manipulate the box using percentages For more details on how these boxes work see Resize and position items using percents or pixels l To create a crop with a specific resolution choose a Size from the available list This creates a box with that exact resolution Click and drag the box to move it int...

Page 260: ...creen an imported image in Pearl Mini or a device that provides a video input signal with audio Video sources are also displayed on the Epiphan Live control interface See Monitor video and audio input sources for more information Topics include l About connecting video and audio sources l Tested RTSP based IP cameras l Supported web cameras l Connect an RTSP source l Preview a video source using t...

Page 261: ...al is configurable Generally no further configuration is needed however you can fine tune some settings using the Admin panel If no video source is connected to an input port or no input stream is being transmitted from a connected RTSP source No Signal displays wherever that input is used in your channels and layouts You can change that to display the default No Signal image for Pearl Mini or cre...

Page 262: ...n connecting an audio source see Tech specs and Selecting an audio source Connect an RTSP source You can connect a single RTSP source such as an IP camera or another Pearl Mini system to your Pearl Mini over a network using the Admin panel For a list of tested cameras and their URL syntax see List of tested RTSP based IP cameras RTSP video encoding is supported with H 264 video codec and MP3 or AA...

Page 263: ...es To connect an RTSP source to Pearl Mini 1 Login to the Admin panel as admin see Connect to the Admin panel 2 From the Inputs menu click Add RTSP input The RTSP input page opens 3 Enter the Input URL Username and Password for your RTSP source and select either UDP or TCP as the Preferred transport If you re using another Pearl Mini as an RTSP source see Stream content using HTTP HTTPS or RTSP 4 ...

Page 264: ...eam are also displayed on this page Alternatively you can view stream connection information when you click check at the bottom of the page Preview a video source using the Admin Panel You can preview the images captured from your video sources in the Admin panel You can also preview your sources using the Epiphan Live control interface see Monitor video and audio input sources To preview an input...

Page 265: ... to channels A channel that has only one source is automatically assigned the same name as the input source by default If you change the name of the input source the channel name will update automatically to match Sometimes it s helpful to configure the input port name to match the data it s capturing so that it s clear what the channel is capturing Alternately you can change the channel s name se...

Page 266: ...eyboard to save the new name Configure a video input source The captured video source doesn t usually need configuration but you can change some of the settings using Admin panel To open the configuration page for an input source 1 Login to the Admin panel as admin see Connect to the Admin panel 2 Ensure a source is connected to the input port see About connecting video and audio sources 3 From th...

Page 267: ...e drop down list gives you the option to choose the default image or any image you have uploaded through the Add a custom No Signal image Timeout The timeout represents the number of seconds after losing the signal that the no signal is displayed You may change this number to adjust how soon you wish the no signal image to appear after the signal disappears SDI signals The following options are av...

Page 268: ...No Signal image Timeout The timeout represents the number of seconds after losing the signal that the no signal is displayed You may change this number to adjust how soon you wish the no signal image to appear after the signal disappears USB signals The following options are all potentially available for signals via the USB port However some apply only to certain types or brands of camera and not ...

Page 269: ... fps at which the camera is captured The drop down list of available resolutions and frame rates changes depending on the attributes of the connected device Brightness The brightness of the video can be adjusted by entering a numerical value from 0 to 100 Estimate values and view the result in the preview area until desired result 257 ...

Page 270: ...cal value from 0 to 100 Estimate values and view the result in the preview area until desired result is achieved Powerline frequency The powerline frequency of the video can be adjusted by selecting the desired output from a drop down list of frequencies available to your source Image This menu allows you to choose a custom no signal image for the channel The drop down list gives you the option to...

Page 271: ...ifferent message to your viewers For example if a viewer logs in early or if you are experiencing delays you could indicate the start time or expected resolution time using the no signal image Before you can specify a custom No Signal image for an input port on Pearl Mini you must upload it see Upload or remove an image using the Media page To set the no signal image for an input port 1 Login to t...

Page 272: ...rl Mini User Guide Add a custom No Signal image 6 Test that the No Signal image is correctly applied by disconnecting your source and previewing the channel s containing said source see Preview channel 260 ...

Page 273: ...earl Mini is flexible easy to setup and supports all the standard codecs as well as the most common media players Streaming options include unicast multicast CDN SAP UPnP streaming scheduled webcasting events to the Kaltura Content Management System and more Topics include l What is streaming l View supported streaming formats l Directly share stream URLs with viewers l Stream settings for video a...

Page 274: ...g UPnP HTTP for FLV and MPEG TS and RTSP At the same time Pearl Mini can stream to a server such as a multicast server or CDN You can easily start and stop streaming using One touch control from the touch screen on Pearl Mini see Specify channels for One Touch streaming or control streaming from the Admin panel You can even control your live stream using Epiphan Live see Control streaming and reco...

Page 275: ...mizing system resource usage when streaming video content from your Pearl Mini Table 46 Suggested stream settings for video Option Setting Codec H 264 Video encoding preset Hardware accelerated Video encoding profile High Key frame interval 2 sec Limit frame rate 30 Bitrate 4000 kbps for HD 6000 kbps for Full HD 4000 kbps for HD 6000 kbps for Full HD Mac Audio format AAC 22 KHz The following table...

Page 276: ...ic to the selected audio and video codecs that you configured for your channel You can view the available streaming formats from the channel status page using the Admin panel To view the video formats and standards that are specific to your selected codec 1 Login to the Admin panel as admin see Connect to the Admin panel 2 From the Channels menu select a channel and click Status The status menu op...

Page 277: ... media player to watch the stream on the local network They just need the URL for any of the other supported streaming methods like FLV or MPEG TS to watch using their media player Use these direct streaming methods for only a small number of viewers because each viewer uses the full stream bandwidth and consumes resources on Pearl Mini For more information about using an HTTP stream see Stream co...

Page 278: ... Consult with your network administrator Table 49 URL options Access Method URL Format serial discovery http serial local preview cgi channel channel number https serial local preview cgi channel channel number rtsp serial local port stream sdp Where serial is the serial number of the system the port number for the channel is found on the Info page and the channel number is provided from the Admin...

Page 279: ...URLs with viewers Participants can view a channel s stream directly from Pearl Mini when you provide them the channel s stream URL and log in credentials You can provide separate URLs for streams coming from each channel or one URL that includes all the streams for the channel Choose the right type of URL for the type of device the participant will use to view the stream For more information on co...

Page 280: ...eb browser and View the streaming URL using a media player HTTP only is used for MPEG TS and FLV streaming HTTPS is not supported View the live broadcast URL using a web browser You can share a channel s live broadcast URL with viewers so they can watch your live stream using their favorite web browser Your viewers must be on the same network as Pearl Mini to watch a live broadcast using the chann...

Page 281: ...vide participants with the password to log in along with the URL of the stream To set a viewer password see Set or change user passwords If HTTPS is enabled on Pearl Mini replace http with https in the URL of the stream To share the live broadcast URL with viewers 1 Login to the Admin panel as admin or operator see Connect to the Admin panel 2 Open the channel s status page and copy the live broad...

Page 282: ...nnel number 2 Enter viewer as the user name and the password when prompted and press Enter The stream plays in a new tab in your web browser View the streaming URL using a media player You can share a channel s streaming URL with viewers so they can watch your live stream using their favorite media player like VLC Your viewers must be on the same network as Pearl Mini to watch a channel stream usi...

Page 283: ...or change user passwords To share the channel s stream URL with viewers 1 Login to the Admin panel as admin or operator see Connect to the Admin panel 2 Open the channel s status page and copy the channel s stream URL From the Channels menu select a channel and click Status You can copy the Live broadcast URL and share that with your viewers To view the channel s stream URL using a VLC 1 Launch a ...

Page 284: ...figured for viewer authentication the viewer must pass global autentication using LDAP credentials or the viewer global password if there is one and must meet the local channel settings come from an allowed IP address See Configure LDAP user authentication for more information on LDAP configuration To restrict viewers for a channel 1 Login to the Admin panel as admin see Connect to the Admin panel...

Page 285: ...nel by selecting Use these settings and leaving all the fields blank 6 Optional Enter the allow and deny IP addresses for viewers of this channel See Restrict viewers by IP address for details about allow and deny lists 7 Click Apply Restrict viewers by IP address Pearl Mini permits you to restrict which computers can access broadcasts by building a list of allowed and denied IP addresses You can ...

Page 286: ...nge of addresses for your viewers By default all IP addresses are allowed to connect to the broadcast If a user attempts to connect to the stream from a disallowed IP address access is denied If there s an attempt to connect using a web browser the message IP address rejected is displayed Table 50 IP Based Restriction Options If you re not familiar with creating allow deny lists see IP restriction...

Page 287: ...of known IP addresses to craft a list of allowed IP addresses All other addresses are denied access to the broadcast For example if your system is accessible on your local area network LAN and you want to make sure only the CEO s specific desktop laptop and tablet computers with IP Addresses 192 168 1 50 192 168 1 51 and 192 165 1 75 respectively can connect to the broadcast construct the followin...

Page 288: ...o the list as follows Allow 192 168 1 200 192 168 1 250 192 168 1 50 192 168 1 51 192 168 1 75 Your list can have multiple ranges and multiple distinct IP addresses provided they are separated by commas Allow list with a range of IP addresses distinct IP addresses and an exception Building on the previous examples consider a situation where you want the CEO s computers 192 168 1 50 192 168 1 51 19...

Page 289: ...ider a situation where you want every computer on the network to access the broadcast with the exception of the CEO s desktop laptop and tablet computers Additionally boardroom computers should not be permitted with the exception of the cafeteria computer IP address 192 168 1 222 The deny list is an exception list for the allow list So to craft the rule described above we need to allow all the com...

Page 290: ...min see Connect to the Admin panel 2 From the Channels menu select a channel and click Streaming The Streaming page opens 3 Set the HTTP Streaming port to specify the port used to stream the HTTP broadcast This value along with the URL is used by viewers to access the FLV and MPEG TS streams The port number must be higher than 500 for HTTP In the case of RTSP streaming this value is ignored 4 Set ...

Page 291: ...nel Disabling channel streaming for viewers using their web browser or media player does not disable live streaming to a CDN Disabling streams for viewers does disable all viewer formats including HTTP HTTPS RTSP HLS and UPnP To disable or enable the channel streaming URLs 1 Login to the Admin panel as admin see Connect to the Admin panel 2 From the Channels menu select a channel and click Streami...

Page 292: ... one or more CDNs to stream live content allows you to reach a large geographically diverse audience and because CDNs perform format conversion the stream is platform independent You can control when streaming to a CDN is enabled by using the Admin panel or the touch screen see Start and stop streaming to a CDN For more information about streaming to a CDN see Stream to a CDN Multicast Streaming S...

Page 293: ...rvers support both formats Choose the streaming format that your CDN or media server supports Epiphan has tested with the CDN providers listed here https www epiphan com partners cdn partners Contact your CDN for a list of supported audio codecs and ensure your Encoding configuration uses one of the supported codecs To publish content to a CDN provider ensure you have l a path to the mount point o...

Page 294: ...to the Admin panel as admin see Connect to the Admin panel 2 From the Channels menu select a channel and click Streaming The Streaming configuration page opens To set up a stream using the Admin panel click New stream and follow the instructions for how to Stream to a CDN 3 Click Start at the top right corner to start that stream or click Start all at the top of the page to start streaming all str...

Page 295: ... the channel is currently streaming l A yellow dot with an exclamation mark means a problem with streaming occurred that requires attention For details to start and stop streaming using the touch screen see Stream a channel using the touch screen For details to start and stop streaming using Epiphan Live see Control streaming and recording To learn how to use One Touch feature to control your reco...

Page 296: ...Pearl Mini has the CA certificates for many of the major CDNs already installed For RTMPS streaming to work for your particular CDN or if you re using a proprietary RTMPS server ensure that your streaming server s CA certificate is uploaded to Pearl Mini see Manage CA and self signed certificates To stream using RTMP or RTMPS 1 Login to the Admin panel as admin see Connect to the Admin panel 2 Fro...

Page 297: ...u to enter your log in credentials here 9 Optional Rename the stream Click the current name and enter a different name then press Enter 10 Click Apply 11 To start streaming click Start or click Start all to simultaneously start this stream and any other streams you have configured for this channel 12 Click Delete this stream at any time to delete the stream See Start and stop streaming to a CDN fo...

Page 298: ... CDN provider to find out which transport protocols the CDN supports l The CDN User name and Password if required The CDN provider assigns a user name and password to authenticate the publisher Contact the CDN provider for your log in credentials 8 Click Apply 9 To start streaming click Start or click Start all to simultaneously start this stream and any other streams you have configured for this ...

Page 299: ... and click Streaming The Streaming configuration page opens 3 Click New stream and select Use profile XML 4 Select the XML file that was provided by your CDN provider then click OK The new stream is created using the default name Stream 1 and the configuration from the XML file is applied 5 Click Apply 6 To start streaming click Start or click Start all to simultaneously start this stream and any ...

Page 300: ...Note that only one multicast network may be used simultaneously So if you select MPEG TS UDP push MPEG TS RTP UDP push or RTP UDP push you are not able to select any of the others and you must delete the stream to select a different multicast network Adding removing or changing the settings for any of these three multicast publishers stops any current streaming or recording session Topics include ...

Page 301: ... is displayed in the playlist of the local media player b Enter a multicast IP address in the SAP announcement IP field If your media player is configured to receive multicast streams from an IP address that is different from the default address 224 2 127 254 you may need to contact your system administrator for a specific multicast IP address c Enter a channel number in the Channel number field t...

Page 302: ...tp 226 10 24 32 7000 To view the stream when SAP announce has been set and the stream is advertised on a media player set top box or Smart TV refer to Viewing with Session Announcement Protocol SAP MPEG TS streams using UDP push Before configuring your channel for MPEG TS streaming ensure the following codecs are configured in the encoding section l Video H 264 l Audio MP3 or AAC if audio is confi...

Page 303: ...s displayed in the playlist of the local media player b Enter a multicast IP address in the SAP announcement IP field If your media player is configured to receive multicast streams from an IP address that is different from the default address 224 2 127 254 you may need to contact your system administrator for a specific multicast IP address c Enter a channel number in the Channel number field to ...

Page 304: ...en set and the stream is advertised from a media player set top box or Smart TV refer to Viewing with Session Announcement Protocol SAP Multicast streaming using RTP UDP 1 Login to the Admin panel as admin see Connect to the Admin panel 3 From the Channels menu select a channel and click Streaming The Streaming configuration page opens 4 Click New stream and select RTP UDP push 5 Enter the followi...

Page 305: ... metadata refer to Add or remove channel metadata When browsing from a VLC media player streams are advertised by their channel identifier and are organized by the group name When browsing from an XBMC media player streams are advertised by the stream s metadata title if configured otherwise streams are advertised by their channel identifier 1 Ensure the stream has SAP announcement enabled otherwi...

Page 306: ...t to Pearl Mini When the event is scheduled to start the ingestion settings are applied automatically to Pearl Mini Only the primary URL from Kaltura is used by default but you can enable the secondary backup stream URL Ensure that you have selected the channel on Pearl Mini that you want to use for your scheduled webcasting event well in advanced of the event start time The first channel on Pearl...

Page 307: ...from the Events touch screen see View Kaltura events Important considerations l The streamed content for a channel won t upload to Kaltura if AFU is disabled for that channel If a new channel is created when CMS is enabled on Pearl Mini AFU is disabled by default for that channel You must manually enable AFU for the new channel before it can be used for a webcasting event l Ensure that the same au...

Page 308: ...L associated with the webcasting event or to both the primary URL and the secondary backup URL if you ve enabled the backup stream see Set up a channel for a scheduled webcasting event You can configure Pearl Mini to send an RTMPS stream instead using the Admin panel To configure Pearl Mini to send an RTMPS stream using the Admin panel 1 Login to the Admin panel as admin see Connect to the Admin p...

Page 309: ...Pearl Mini User Guide Use RTMPS for a Kaltura webcasting event 297 ...

Page 310: ...ream video outside of your LAN use a CDN or configure port forwarding on your router Refer to your Network Administrator network configuration is beyond the scope of this guide Stream using UPnP Using the Universal Plug and Play UPnP networking protocol your Pearl Mini can be discovered and can stream to software and hardware media players set top boxes and Smart TVs with ease If UPnP is enabled t...

Page 311: ...s to enable UPnP on Pearl Mini l Enable UPnP at the device level including setting a share name l Enable UPnP for channels and recorders Streams and MPEG TS recorded files must use the supported codecs H 264 with MP3 or AAC audio Having a viewer password could prevent the ability to use UPnP Enable UPnP for the device To enable UPnP sharing for the device 1 Login to the Admin panel as admin see Co...

Page 312: ... down list of what can be streamed Enable UPnP for channels and recorders After you enable UPnP for the device to allow live stream and recorded file sharing you need to enable sharing for each channel and recorder you want to share To enable UPnP sharing for channels and recorders 1 For channels live streaming a Click Streaming for the channel The Streaming configuration page opens b Check Share ...

Page 313: ...he channel s recording page opens b Click change under Recorder Setup The recording setup options opens c Check Share via UPnP and click Apply If you have not already enabled UPnP for the device the message UPnP live video sharing is not enabled with this device to fix it click here appears Click to fix it click here The UPnP service will start when you click Apply 3 For recorders a Click Recordin...

Page 314: ...le for the device and for each channels and recorder If you enabled UPnP sharing it for a particular broadcast you may want to disable UPnP sharing after the broadcast is complete You can choose to disable access to live streams recorded files or to the whole system To disable UPnP for a channel or recorder 1 For channels a Click Streaming for the channel The Streaming configuration page opens b U...

Page 315: ...a player you can browse for files or streams with Universal Plug and Play UPnP UPnP uses MPEG TS over HTTP with the H 264 codec and MP3 or AAC audio encoding or no audio You can only access live streams or recordings that meet these requirements For security reasons UPnP access to live streams and recorded files is disabled by default To enable UPnP see Enable UPnP Some players cannot access the s...

Page 316: ...ess Play to start the stream Using your digital media player select a live stream and press play Recorded files Recorded files are shown in the Recorded Files folder Files are organized by the channel or recorder from which they were recorded Windows Media Player shows the recorder files side by side with the channels and other digital media players show the recorded files in a file tree format se...

Page 317: ...want to play and click on the Play To icon for the file A list of visible digital media players is displayed 5 Select a media player The recording plays on the screen that is connected to the media player Auto restart playback to a UPnP device In unmanned situations such as industrial applications and digital signs it is useful to automatically have a stream played to a digital media player even i...

Page 318: ...ield blank when enabling UPnP the server name is the system s serial number To change the UPnP server name 1 Login to the Admin panel as admin see Connect to the Admin panel 3 From the Configuration menu click UPnP The UPnP configuration page opens 4 Highlight and delete the text in the Server name field if any 5 Type a new server name Use characters A Z a z 0 9 _ 6 Click Apply 306 ...

Page 319: ...0 at 4 Mbps There are different ways to download recordings like automatically downloading recordings to a USB memory device For Pearl Mini an SD card must be installed to record content using Pearl Mini see SD card installation and file management Topics include l About recording l Record a channel l Record using One Touch control l Configure recording file size and type l Restart recording l Rec...

Page 320: ...l Mini comes with APIs so you can setup third party tools to control recording see Controlling Pearl Mini using HTTP HTTPS commands and Controlling Pearl Mini using RS 232 serial port Each channel or recorder has a maximum time or file size limit setting that you can configure using the Admin panel The default recording limits are set to 30 minutes or 500 MB whichever comes first When the time or ...

Page 321: ...nload recordings see Manage recorded files Epiphan has tested recordings with the following players See Troubleshooting Quick Reference for known player issues Table 53 Tested Media Players Operating System Tested Players Mac OS l QuickTime 10 3 l QuickTime 7 6 6 l VLC 2 2 4 l Playback Pro 2 3 2 l Final Cut Pro 10 3 2 l Adobe Premiere Pro CC 2017 Windows l QuickTime 7 6 6 l VLC 2 2 6 l Windows Med...

Page 322: ...ee Record a channel using the touch screen and using Epiphan Live see Control streaming and recording The channel number turns red to indicate it is recording If the system runs out of storage space the oldest recorded file is deleted to make room for the new recording To start and stop channel recording using the Admin panel 1 Login to the Admin panel as admin or operator see Connect to the Admin...

Page 323: ...g control allows you to control your recording and streaming across any number of channels and recorders with a single tap on the touch screen Channels and recorders are enabled for One Touch recording by default For more information see One Touch streaming and recording control To control recording using One Touch control 1 Login to the Admin panel as admin or operator see Connect to the Admin pa...

Page 324: ...trol icons are still not visible they are disabled See Configure the touch screen 4 From the One Touch control screen tap Start to begin recording and tap Stop to end recording Configure recording settings file size and type Recordings are saved as AVI files by default Each channel and recorder also has a file size limit set to 500 MB and the maximum file length set to 30 minutes by default 312 ...

Page 325: ... the SD card will be corrupted if the total of the file size limits for each recorder exceeds the size of the SD card l Newer recordings overwrite oldest recordings when the amount of free space on the SD card is less than the configured recording file size limit l You cannot change the recording settings file size and type for channels used with Kaltura events l The file recording type for a chan...

Page 326: ...e version of MOV Generally used for playback on Mac OS This type of MOV has the best compatibility with video players and editors Filename prefix Specifies how the recordings are named Recording files start with the given prefix followed by the date and time The channel or recorder name is used if no prefix is given Allowed characters A Z a z 0 9 _ Avoid using spaces in recording file names Use un...

Page 327: ...nnel or recorder from automatic file uploads see FTP and automatic file transfers 7 Click Apply Restart recording Recordings are automatically saved to a file and a new recording is started when l The recording reaches the configured time or size limit l The channel or recorder name is changed l Changes are made to the stream You can manually force a recording that s in progress to save to a file ...

Page 328: ...Pearl Mini User Guide Restart recording 3 Click Reset to stop the current recording and start a new recording 4 Refresh the page to see the updated list of recordings 316 ...

Page 329: ...ra CMS Topics include l Add a recorder l Select channels to record l Rename a recorder l Duplicate a recorder l Delete a recorder To change recording settings such as the file size limit type or to add a custom prefix to the file name see Configure recording settings file size and type You only need to create recorders for multi track recordings For single channel recordings see Record a channel A...

Page 330: ...ini in the single multi track file by default If you create new channels they are automatically added to the recorder You can choose which channels the recorder includes in the multi track file using the Admin panel To change the channels recorded by a recorder 1 Login to the Admin panel as admin see Connect to the Admin panel 2 From the Recorders menu select a recorder The recorder configuration ...

Page 331: ...rt and stop a recorder You can start and stop recorders from the recorder s configuration page using the Admin panel You can also start and stop recorders using the One Touch control feature see Record using One Touch control and using Epiphan Live see Record a channel using the touch screen The recorder number turns red to indicate it is recording If the system runs out of storage space the oldes...

Page 332: ... Admin panel 1 Login to the Admin panel as admin or operator see Connect to the Admin panel 2 From the Recorders menu select a recorder The recorder configuration page opens 3 Click Start to begin recording and click Stop to end recording You can navigate away from the page without affecting the recording Rename a recorder To rename a recorder 1 Login to the Admin panel as admin see Connect to the...

Page 333: ...der you ve created All settings in the recorder you duplicate are recreated To duplicate a recorder 1 Login to the Admin panel as admin see Connect to the Admin panel 2 From the Recorders menu select a recorder The recorder configuration page opens 3 Click Duplicate this recorder The duplicate recorder is created and assigned the next recorder number in your list of recorders 321 ...

Page 334: ...ll the recorded files for the recorder Be sure you have a copy of any important recorded files before proceeding To delete a recorder 1 Login to the Admin panel as admin see Connect to the Admin panel 2 From the Recorders menu select a recorder The recorder configuration page opens 3 Click Delete this recorder and click OK when prompted 322 ...

Page 335: ...pics include l About recording to Kaltura CMS l Select channels for VOD event views l Manually start stop scheduled VOD events l Manually start stop an ad hoc event About recording to Kaltura CMS Pearl Mini can be used to record scheduled VOD events with multiple audio and video sources as well as for manual ad hoc events Once you ve registered Pearl Mini with Kaltura you can simply assign Pearl M...

Page 336: ...ase more than the limit of 5 files could be uploaded for one scheduled event l If Pearl Mini was unavailable on the network or powered down and misses a scheduled event the status of that event appears as Skipped on the Events page in the Admin panel l If the time and zone settings of Pearl Mini are out of synchronization with Kaltura s scheduling server an error appears on the Events page and you...

Page 337: ...ed to the VOD after it has uploaded For scheduled VOD events with multiple sources the recording for each source is uploaded to Kaltura and appears as a single multi view entry in your Kaltura media list with each source i e view listed as a separate child sub entry You can choose which source to use as the main entry using the Admin panel on Pearl Mini The channel selected as the main entry becom...

Page 338: ... control Select channels for VOD event views You can select which channels you want recorded using the Admin panel Each channel you configure on Pearl Mini is treated as a separate video source for your Kaltura event Using multiple channels is how you record multiple views for a scheduled VOD event For example if you have a main camera and a presentation laptop that you want to capture as a multi ...

Page 339: ...with Kaltura and you ve selected the channels you want recorded for this resource you re ready to start recording scheduled events When it s time for a scheduled VOD event to start Pearl Mini starts recording the selected channels automatically However you can start a scheduled VOD event 30 minutes earlier than the scheduled time using any of these methods l the touchscreen on Pearl Mini l the Adm...

Page 340: ...event using the Events touch screen Or you can tap the Scheduled events icon at any time to display the Events screen The icon only appears when Kaltura CMS is enabled on Pearl Mini To manually start a scheduled event that hasn t started yet using the Admin panel click Start beside the scheduled event from the Events menu 328 ...

Page 341: ...ate the events listed on the Events page After the event ends it may take a while for content to show up in Kaltura s media lists depending on how busy the Kaltura CMS system is at that time Manually start stop an ad hoc event To record ad hoc events manually you just need to start recording on Pearl Mini when CMS is enabled and Pearl Mini is registered with Kaltura Whatever channels you start rec...

Page 342: ... l Tags Assign tags to the uploaded media for use by Kaltura l Category Assign a Kaltura category to the uploaded media l Owner The name you enter is the owner name that appears in Katura CMS for the uploaded media Important considerations l Before you start recording we recommend that you enter the metadata you want associated with the ad hoc event using the Admin panel However you can add this m...

Page 343: ...s 3 Under Metadata enter the information you want associated with this ad hoc event and click Apply What s Next When you re ready to record you can start recording the channel from the recording tab in the Admin UI from Epiphan Live or using One Touch control see l Record a channel l Control streaming and recording l Record using One Touch control 331 ...

Page 344: ...etting up Pearl Mini as a local FTP server so you can manually or automatically connect to the system and download recordings see FTP and automatic file transfers View list of recorded files Recordings for Pearl Mini are stored for each channel and each recorder separately You can view all the recordings for a channel or recorder using the Admin panel You can also view the list of recordings using...

Page 345: ...no recordings a message indicates there are no recorded files for this channel or recorder Download recorded files manually You can manually download recordings using the Admin panel Files you download are saved to your connected admin computer To free up space for new recordings consider deleting recordings off of Pearl Mini see Delete recorded files To download recordings to your admin computer ...

Page 346: ... you can join two or more files together This is useful when a recording exceeds the maximum recording time limit and the recording is split in to multiple files You can use the third party tool called ffmpeg to join the files Download ffmpeg from the Internet if necessary to join recorded files 1 Download the files that you need from Pearl Mini and make sure you have the right paths and file name...

Page 347: ...ou can this process to join multiple files however the more files you join the greater the chance that some audio desychronization can occur between the clips Extract tracks from a recording Recorders combine multiple channels and audio sources together in a single multi track file You can create a copy of a recording using only select tracks This feature is supported for AVI MP4 and MOV recording...

Page 348: ...p track then hold SHIFT and click the check box for the bottom track 5 Click Extract tracks A copy of the recording is created with only the selected tracks Only one copy is saved per original recording If you create a second copy it will overwrite the previous one Download the extracted copy of the recording with your chosen tracks to preserve it 336 ...

Page 349: ... View list of recorded files 3 Select the edit icon next to the file name you wish to change 4 Type the new file name and press Enter using your keyboard The Admin panel keeps track of the filename extension i e avi so you do not need to include it when renaming the file Delete recorded files You can delete recordings using the Admin panel You can delete one file at a time select multiple files fo...

Page 350: ...elete multiple recordings check the check box beside the recordings you want to delete and click OK when prompted c To delete all recordings for the selected channel or recorder click Delete Selected and click OK when prompted The list may not update immediately You can refresh the list by reloading the Recording page for channels or the recorder settings page for recorders 338 ...

Page 351: ... Configure AFU to RSync server parameters l Configure AFU to CIFS server parameters l Configure AFU to SCP client parameters l Configure AFU to SFTP server parameters l Configure AFU to AWS S3 parameters l Configure AFU to WebDav server parameters l AFU or copy to USB l Local FTP server To view file upload logs and manage the AFU queue l View the AFU log l View AFU status via Pearl Mini s touch sc...

Page 352: ...r channels that are configured as part of a scheduled VOD event As well AFU is disabled for all new channels that are created while CMS is enabled on Pearl Mini l Files are automatically uploaded only once New recordings created during later sessions do not overwrite files that were previously uploaded A new file is uploaded l If the connection is lost during the transfer the transfer automaticall...

Page 353: ...admin see Connect to the Admin panel 2 Do one of the following a To add a channel select the channel from the Channels menu and click Recording The Recording page opens b To add a recorder select the recorder from the Recorders menu The recorder configuration page opens 3 Click change under Recorder Setup The recorder setup opens 341 ...

Page 354: ...U schedule you must enable AFU and configure the frequency of file transfers The first transfer takes place when the configured frequency is reached All recorded files that complete during that time period are included in the transfer Currently recording files are not included in an AFU transfer until the recording has ended Files saved before you complete automatic file upload configuration are n...

Page 355: ...ure recording settings file size and type Every hour The system uploads completed recordings every hour Every 6 hours The system uploads completed recordings every six hours Every 12 hours The system uploads completed recordings every 12 hours Every 24 hours The system uploads completed recordings every 24 hours To set up the frequency of automatic file uploads 1 Login to the Admin panel as admin ...

Page 356: ...le Upload 4 Select how often automatic updates take place 5 Optional Enter the remote path If no path is specified the files are copied to the root folder of the destination file system If AFU to your server fails check the server configuration and permissions 6 Optional Set optional parameters l Check Remove after upload to have the files deleted from local storage on Pearl Mini when the upload c...

Page 357: ...onfigure AFU to SCP client parameters l Configure AFU to SFTP server parameters l Configure AFU to AWS S3 parameters l Configure AFU to WebDav server parameters l AFU or copy to USB Configure AFU to FTP server parameters You can automatically upload recordings to an FTP server when you select FTP as the AFU protocol transfer type using the Admin panel The following table describes the parameters t...

Page 358: ...e DHCP you can use the server s fully qualified domain name instead of the IP address 3 Specify the Server Port used for the target FTP server The standard port is 21 4 Enter the FTP account username in the Login field 5 Enter the FTP account password in the Password field The characters are masked with dots 6 Select Use temp file to name files with a temporary filename extension part on the serve...

Page 359: ...iability of the transfer Prerequisites l Channels and recorders are already added for AFU see Choose files to include in AFU l AFU is enabled and the parameters configured see Enable AFU and set parameters To configure upload using RSync 1 From the Automatic File Upload configuration page select RSync Client as the protocol transfer type 2 Specify the target Server address If your system is config...

Page 360: ...on Server Port The CIFS server port Leave blank to use the default port or enter the port used for your CIFS server Server address The IP address or fully qualified domain name of the CIFS server Server share The name of the shared folder on the CIFS server Domain The CIFS server s Windows domain or Work Group name Needed if the server is part of Active Directory or a Domain Controller Login Usern...

Page 361: ...ork administrator 5 If the system is in a different domain than the server or if it is part of Active Directory enter the Domain name of the CIFS server 6 Specify a username for the CIFS Server in the Login field The user must have write permissions for the share folder 7 Specify the password for the user in the Password field the value is masked by dots 8 Select Use temp file to name files with a...

Page 362: ...red see Enable AFU and set parameters To configure upload to an SCP client 1 From the Automatic File Upload configuration page select SCP Client as the protocol transfer type 2 Specify the target Server address If your system is configured with DHCP or has a valid DNS configuration see Configure DHCP you can use the server s fully qualified domain name instead of the IP address 3 Specify the Serve...

Page 363: ... a Click Choose File and navigate to select the private key file from your hard drive then click Open b Click Upload to upload the file The system accepts RSA keys for SSH 1 DSA ECDSA EC25519 and RSA for SSH 2 Keys must be in OpenSSH format c Optional Use the Test your key field to test your uploaded key against the secure server 7 Click Apply Configure AFU to SFTP server parameters You can automa...

Page 364: ...s the file is renamed to the appropriate extension mov mp4 or avi Prerequisites l Channels and recorders are already added for AFU see Choose files to include in AFU l AFU is enabled and the parameters configured see Enable AFU and set parameters To configure upload to an SFTP server 1 From the Automatic File Upload configuration page select SFTP Client as the protocol transfer type 2 Specify the ...

Page 365: ... identity for your Pearl Mini This key must be trusted by the destination server Details for generating the key and setting up this trust are beyond the scope of this document 7 Optional Set up SSH identity for SCP and SFTP clients If no identity is uploaded or to upload a new identity overwrites the old identity a Click Choose File and navigate to select the private key file from your hard drive ...

Page 366: ...e streaming files Access Key Id The Access Key Id is part of your access key for your AWS account i e GAKSOSIFDONN2EXAMPLE Secret Access Key The secret access key is part of your access key for your AWS account i e bHaprXUenFEMI K6MANVG cPxDfiBYEXAMPLEKEY Session Token The temporary security token provided by the AWS Security Token Service STS that allows access to your AWS account for authorized ...

Page 367: ...ameters You can automatically upload recordings to a WebDav server when you select WebDav as the AFU protocol transfer type using the Admin panel The following table describes the parameters to configure AFU to a WebDav server Table 62 WebDav Automatic Upload Configuration Options Name Description Options Server address The IP address or fully qualified domain name of the FTP server Server port Th...

Page 368: ...e Automatic File Upload configuration page select WebDav Client as the protocol transfer type 2 Specify the target Server address If your system is configured with DHCP or has a valid DNS configuration see Configure DHCP you can use the server s fully qualified domain name instead of the IP address 3 Specify the Server Port used for the target WebDav server The standard port is 21 4 Enter the FTP ...

Page 369: ...s to USB storage device We recommend you only connect one USB device to Pearl Mini at a time Only one copy or move to USB operation is permitted at a time even though the UI may appear to let you start a second one Please wait until the first is complete before starting a new operation AFU to a USB storage device You can transfer recordings to a USB storage device automatically when you select an ...

Page 370: ...AFU settings 2 Select Create a subfolder for each channel to have recordings organized by channel 3 Click Apply Do a one time copy move all recordings to USB storage device When one time move copy of files is configured Pearl Mini automatically starts copying files as soon as you connect a USB storage device to one of the USB ports Newest recordings are copied first Files continue copying over unt...

Page 371: ...ve Checking this box makes the transfer a move instead of a copy mark file as downloaded If checked the files that are downloaded are marked with a downloaded icon when viewing file lists This has no effect if remove after copying is checked ignore already downloaded files If checked files that were previously downloaded or marked as downloaded are not included in subsequent downloads If your USB ...

Page 372: ...ivity indicators a Check the Recording list for each channel and the Recorded Files list for each recorder to verify if there are files that have yet to be copied b Safely eject USB storage device when you are satisfied all files have been copied or if you notice the USB storage device is out of space see View available USB storage space Manually copy recordings to USB storage device You can manua...

Page 373: ... the following a To download files for a specific channel click Recording from the Channels menu b To download files for a recorder select a recorder from the Recorders menu 5 Check the files you want to download and do one of the following a Click Copy Selected to external drive to copy the files to the USB drive b Click Move Selected to external drive to move the files and delete them off of Pea...

Page 374: ... Admin panel When you insert your USB storage device into an available USB port an External storage usage information tab appears at the bottom of the menus panel Safely eject USB storage device When you re done saving recordings to the USB storage device you can safely eject it using the link at the bottom of the Admin panel page To safely eject the USB drive 1 Login to the Admin panel as admin s...

Page 375: ... If you want to view the AFU status see View AFU status To view the AFU log 1 Login to the Admin panel as admin see Connect to the Admin panel 2 From the Configuration menu select Automatic File Upload The Automatic File Upload configuration page opens 3 Click Show log of automatic file upload The log page opens If no logs are present the page is blank 4 Click the browser s back button when you ar...

Page 376: ...ueue 1 Login to the Admin panel as admin see Connect to the Admin panel 2 From the Configuration menu click Automatic File Upload If there are files to be uploaded they are displayed under the Upload Queue header Change how the AFU queue displays You can change how the AFU queued content is displayed using the Admin panel To change how the AFU queued content is displayed 1 Navigate to the bottom o...

Page 377: ...Files can be deleted from the upload queue either individually or as a group To delete content from the upload queue 1 Navigate to the bottom of the upload queue and click Empty Queue to delete the entire upload queue or click the red X icon at the end of each row to remove files individually There is no confirmation prompt after clicking Empty Queue The queue is immediately deleted You cannot res...

Page 378: ...Configure the local FTP server You can setup the local FTP server on Pearl Mini using the Admin panel The following table describes the configuration parameters to setup Pearl Mini s local FTP server Table 65 FTP Server Configuration Parameters Name Description Enable FTP access The check box controls whether or not the system acts as an FTP server By default this is disabled FTP user name Select ...

Page 379: ...FTP DELETE command and click Apply to allow users to delete files Any currently logged in ftp users must log out and back in again to have access to the command b Uncheck Enable FTP DELETE command and click Apply to disable file deletion by FTP Any currently logged in users will continue to have access to the delete command until they log out and log in again Using the local FTP server Once you ha...

Page 380: ...Mini is 192 168 1 210 the username is admin there is no password and the Windows command line ftp utility is used To connect to the FTP server 1 Open a command window on Windows alternatively open a terminal window on Linux Mac or open your FTP utility of choice 2 Establish an ftp connection using the command ftp 192 168 1 210 3 Provide the username admin provide the username of your FTP user 4 Pr...

Page 381: ...bled in the FTP configuration page delete the file after downloading it by issuing the delete command or using your tool s delete mechanism If the delete command is not enabled attempting to delete a file will result in an Unknown Command error 369 ...

Page 382: ... the maintenance features of Epiphan Live and different ways you can configure and operate Pearl Mini using third party tools over HTTP HTTPS or RS 232 Topics include l Power down and system restart l Perform a factory reset l Firmware upgrade l Support l Storage space maintenance l Third party integration ...

Page 383: ... off the device using the Admin panel You can use the Admin panel to power off Pearl Mini The power button on Pearl Mini is a toggle switch If you power off the device using the Admin panel the power switch remains in the on state To power back on you must double press the power button To power off Pearl Mini using the Admin panel 1 Login to the Admin panel as admin see Connect to the Admin panel ...

Page 384: ...Pearl Mini User Guide Power down and system restart To power off Pearl Mini manually press the power button on the rear panel once 372 ...

Page 385: ...on presets are the perfect way to backup your Pearl Mini setup so that you can reapply it later without worrying if someone changes your settings or does a factory reset You can create a configuration preset from the Configuration menu when you select Maintenance see Configuration presets 373 ...

Page 386: ...a files and recordings from Pearl Mini Consider applying a factory default configuration preset instead if you want to preserve the uploaded media files configuration presets and channel recordings see Configuration presets To perform a factory reset 1 Login to the Admin panel as admin see Connect to the Admin panel 2 From the Configuration menu select Maintenance The maintenance page opens 3 Clic...

Page 387: ...Mini automatically checks for firmware updates if the Enable connection to maintenance server option is checked on the Maintenance page of the Admin panel You can also manually check for updates If your Pearl Mini has internet access When Enable connection to maintenance server is checked the built in firmware update mechanism checks for updates for your specific product and hardware version autom...

Page 388: ...pgrade is complete Installing new firmware takes a few minutes after which the system reboots Depending on the upgrade a disk rebuild may be required causing the restart process to take more time Please be patient and wait for the system to finish rebooting Do not interrupt power to the system during a firmware upgrade To perform a firmware update 1 Login to the Admin panel as admin see Connect to...

Page 389: ... if known and the new firmware version and contact info epiphan com BIOS update If Pearl Mini requires a BIOS update a BIOS Upgrade section appears on the Firmware update page in the Admin panel We recommend performing the BIOS update whenever they become available to ensure optimum performance of your device The BIOS Upgrade section appears on the Firmware Update page only when your Pearl Mini sy...

Page 390: ... know that Pearl Mini is going to reboot Wait for the system to restart 6 After the system reinitializes go to the settings for your web browser and clear your web browser s cache 7 Connect to the Admin panel and login as admin see Connect to the Admin panel 8 From the Configuration menu select Info and confirm that the date of the BIOS has updated 378 ...

Page 391: ...Mini User Guide Firmware upgrade You can also confirm that the latest BIOS is installed on Pearl Mini when the section called BIOS Upgrade no longer appears on the Firmware Upgrade page in the Admin panel 379 ...

Page 392: ...er during a remote session For more information about service plans see www epiphan com supportplan To contact Epiphan support l Email support epiphan com l Online chat www epiphan com support Monday to Friday between 9am and 5pm Eastern l Call 1 877 599 6581 613 599 6581 From time to time Epiphan support may ask you for logs from your system Follow the instructions in this section to download the...

Page 393: ...o remotely access Pearl Mini to help you troubleshoot issues and reset lost admin passwords Your network must allow access to the Epiphan maintenance server which has the domain name epiphany epiphan com Pearl Mini must be able to resolve this domain name to connect to the Epiphan maintenance server for remote support Remote support uses ports 22 and 30 Ensure that these ports are opened to allow ...

Page 394: ...nnection to maintenance server to enable outgoing links to the Epiphan maintenance server epiphany epiphan com 5 Click Apply 6 Test that Pearl Mini can access the maintenance server a From the Configuration menu click Network b In Network Diagnostics enter epiphany epiphan com and click ping c The result of the ping should show an IP address for epiphany epiphan com Report any packet losses to Epi...

Page 395: ...han to reset a lost admin password on your Pearl Mini If you forget the admin password and remote support feature is off you will need to return the system to Epiphan for reprogramming To disable remote support for your Pearl Mini 1 Login to the Admin panel as admin see Connect to the Admin panel 2 From the Configuration menu click Maintenance The maintenance page opens 3 Uncheck Enable remote sup...

Page 396: ...the bottom of the menu panel and on the SD card configuration page You can also check the capacity of the SD card using the touch screen on Pearl Mini The total amount of storage capacity depends on the size of SD card you installed To check the SD card capacity using Epiphan Live see Configure Dashboard panels It s good practice to check how much storage space you have available If the amount of ...

Page 397: ...ernal storage that s allocated for uploaded media like image files that you add to your channel layouts You can see how much space you have for media files using the Admin panel To check media storage capacity 1 Login to the Admin panel as admin or operator see Connect to the Admin panel 2 From the Configuration menu click Media The Media configuration page opens with the amount of capacity listed...

Page 398: ...User Guide Storage space maintenance Read data from the SD card Pearl Mini has support for removable SD cards which are formatted to use the ext4 file system and can only be read with a computer running Linux 386 ...

Page 399: ...HTTP HTTPS or RS 232 commands to configure your system exactly how you need it You can start and stop recordings configure meta data on a channel or even change a channel s frame size and encoding settings using the API Topics include l Controlling Pearl Mini using RS 232 serial port l Controlling Pearl Mini using HTTP HTTPS commands l Configuration keys for third party APIs 387 ...

Page 400: ...lways follow a SET command in RS 232 with the SAVECFG command Otherwise the new configuration setting s will not take effect See the SET examples that follow For a complete list of supported SET and GET parameters see Configuration keys for third party APIs To connect the RS 232 cable and configure RS 232 on Pearl Mini see Connect and configure the RS 232 port The following examples show how to us...

Page 401: ...ial adapter to the null modem cable 3 Connect the USB to RS 232 serial adapter to one of the system s USB ports The only configuration available for the serial port is flow control Flow control changes the rate of data transfer over the cable Some communication settings are static and cannot be changed The static settings are l Baud rate set at 19200 l Parity set to none l Stop bits set to one To ...

Page 402: ...rtain parameters Each command sent to Pearl Mini over RS 232 must be terminated with a line feed LF character ASCII code 10 Make sure that your software adds the line feed to each command Some commands require a channel or recorder name as an argument In those commands the channel or recorder name is separated from the command name by a period The channel name value can be either the name or the i...

Page 403: ...ecorders There is no RS 232 command to restart recording If recording is already active when the start command is issued the recording continues STOP channel STOP recorder Stops recording for the provided channel or recorder This can alternatively be accomplished with the following set commands SET channel rec_enabled SAVECFG STOP Stops recording for all channels and recorders SNAPSHOT channel Tak...

Page 404: ...eports the recording status of the specified channel or recorder Status is one of l RUNNING l STOPPED l UNINITIALIZED STATUS Reports the recording status of each channel and recorder Status is one of l RUNNING l STOPPED l UNINITIALIZED FREESPACE Reports the free storage space in bytes RECTIME channel RECTIME recorder Reports the elapsed recording time in seconds for the current file on the specifi...

Page 405: ...Mini User Guide Controlling Pearl Mini using RS 232 serial port Command Name Description l Uninitialized The Uninitialized status is sent when there is an internal error Check the system for more details 393 ...

Page 406: ...m Some commands require a channel or recorder name as an argument A channel s index is found by looking at the Channels list in the Admin panel In the following example the channel with index 1 is currently recording its index number is red To address this channel using http commands use the index channel1 For recorders combine the recorder s number with the prefix m as in channelm In the followin...

Page 407: ...the configuration key for the item being checked or changed see Configuration keys for third party APIs and value is the value to set for the configuration item The following examples show how to use wget to exercise some of the supported HTTP HTTPS commands You can substitute https for http in the urls For values with spaces encode space as 20 i e set_params cgi framesize 640 20x 20480 The exampl...

Page 408: ...y value pairs in a single command by separating the statements with For example the key for product name is product_name and the key for firmware version is firmware_version The command to request both the product name and the firmware version is http address admin channel1 get_params cgi product_name firmware_version To turn off publishing i e set to 0 and set the bitrate vbitrate to 256 000 http...

Page 409: ...d in custom layout as responsive text overlay elements See Add a text overlay for information about adding a global variable into a custom layout You cannot substitute https for http in the global variable HTTP commands Important considerations for global custom layout variables l Each system variable must have its own unique name l System variable names and variable values are case sensitive l Ea...

Page 410: ... i e set_variables cgi name1 640 20x 20480 To erase a previously set variable simply set the variable s name with an empty space Example http 192 168 0 129 admin set_ variables cgi gpsvar1 N103 2068201 20W765 2029712 gpsvar2 S490 2018731 20E756 2019890 gpsvar3 N123 2046891 20W345 2065431 gpsvar4 S767 2033410 20E770 2004513 sets gpsvar1 to N103 68201 W765 29712 gpsvar2 to S490 18731 E756 19890 gpsv...

Page 411: ...ini http address admin get_variables cgi Example http 192 168 0 129 admin get_variables cgi returns gpsvar1 N103 68201 W765 29712 gpsvar2 S490 18731 E756 19890 gpsvar3 N123 46891 W345 65431 gpsvar4 S767 33410 E770 04513 To learn how to use global variables as text overlays in custom channels see Add a text overlay 399 ...

Page 412: ...mesize 640 x 480 For HTTP HTTPS encode each space 20 set_params cgi framesize 640 20x 20480 The following categories of API keys are supported l System level settings keys read only l System level settings keys read write l System level custom layout keys read write l Touch screen settings keys read write l Recording configuration keys l HTTP server configuration keys l IP based access control con...

Page 413: ...upported Read Only System level Settings configuration keys Key Values Description firmware_version String including the text FIRMWARE_ VERSION The system s firmware version The value is read only mac_address String The system s mac address Useful for debugging The value is read only product_name String The product s name Useful to confirm you are communicating with the right product or for debugg...

Page 414: ...rs digits and underscore characters A Za z_0 9 0 32 to a limit of 32 total characters Each unique name key contains a variable value Used for dynamic overlay text in custom layouts see Controlling Pearl Mini using HTTP HTTPS commands and Add a text overlay Touch screen settings keys read write The following configuration keys are supported for modifying the touch screen configuration The channel n...

Page 415: ...o an empty string touchscreen_settings on empty string Enables or disables settings changes from the touch screen To enable settings changes from the touch screen set to on To disable settings changes from the touch screen set to an empty string touchscreen_timeout integer Specify the time in seconds before the touchsreen times out For no timeout use 0 Recording configuration keys The following re...

Page 416: ...Specifies the HTTP server port http_sport integer Specifies the HTTP server SSL port HTTPS port http_usessl on empty string Enables or disables HTTPS SSL Server To enable SSL set to on To disable SSL set to an empty string IP based access control configuration keys The following settings are supported for configuring allowed and denied IP addresses for Pearl Mini only not for individual channels S...

Page 417: ...g share_livestreams on empty string Enables sharing of the live stream via UPnP To enable stream sharing over UPnP set to on To disable stream sharing over UPnP set to an empty string server_name string Specifies the UPnP server name To use the system name set to an empty string Broadcast configuration keys The following settings for streaming to viewers broadcasting are supported including stream...

Page 418: ... streams Channel encoder configuration keys The following encoder settings are supported for each channel For more information on individual items listed see Configure encoding Table 78 Supported channel encoder configuration keys Key Values Description autoframesize on empty string Enables or disables use of the current signal s resolution as the frame size Is switched to off if a frame size is m...

Page 419: ...ftware 5 Hardware Accelerated Specifies a video encoding preset For software set to 0 For hardware acceleration recommended set to 5 vkeyframeinterval integer Interval time in seconds between key frames in the encoded stream vprofile 66 77 100 Specifies the h 264 video profiles For Baseline profile select 66 For Main profile select 77 For High profile select 100 qvalue 0 100 Specifies quality for ...

Page 420: ...e 80 Supported Audio configuration keys Key Values Description audio on empty string Enables or disables audio for the stream To enable audio set to on To disable audio set to an empty string audiobitrate 32 64 96 112 128 160 192 Specifies the audio bitrate for the stream Not applicable for PCM audio codecs audiochannels 1 mono 2 stereo Specifies the number of audio channels For mono set to 1 For ...

Page 421: ...icast RTP UDP 4 multicast MPEG TS over UDP 5 multicast MPEG TS over RTP UDP 6 RTMP push Specifies the type of stream publishing if any RTSP Announce configuration keys Publish type 2 The following settings are supported when the publish type is set to RTSP Announce For more information on RTSP and these settings seeSet up a stream using RTSP announceWhat is streaming Table 82 Supported RTSP Announ...

Page 422: ...or streaming MPEG TS configuration keys Publish types 4 and 5 The following settings are supported when the publish type is set to MPEG TS and for associated SAP distribution For more information on MPEG TS and these settings see What is streaming Viewing with Session Announcement Protocol SAP Table 84 Supported MPEG TS and SAP configuration keys Key Values Description unicast_address string IP ad...

Page 423: ...tadata configuration keys The following keys are available for configuration of the content s metadata Table 86 Supported Content Metadata Configuration Keys Key Values Description author string Specifies the name of the author for the stream recording Refer to description above on handling white space spaces in the string comment string Specifies a comment for the stream recording Refer to descri...

Page 424: ...e when you must fine tune the video input source It s good practice to backup your configuration settings so that you can revert back to a good configuration if the changes you made are not desirable see Configuration presets Topics include l Troubleshooting Quick Reference l Remove black bars matte from the video l Use a specific EDID for the video input port l Unstretch the output video l Remove...

Page 425: ...heck the audio meter from the Dashboard view in Epiphan Live see Monitor video and audio input sources OR Check the touchscreen interface for audio monitoring or use the 3 5 mm audio jack on the front of Pearl Mini to verify audio see About the touch screen Captured SDI audio contains audible clicking sound or other audio distortions upon playback Ensure audio sample rate is set to 48 kHz Lower sa...

Page 426: ...vert the clip to progressive mp4 format Run the file through ffmpeg or a third party software such as Handbrake to preserve both audio and video output I can t preview my channels using the Epiphan Live Dashboard on Chrome even after I updated the security certificate for my website Some versions of Chrome and Microsoft Edge don t display channel previews from the Dashboard if you re on an HTTPs n...

Page 427: ...ts or the image breaks up The following tips can help diagnose image problems 1 Ensure the source resolution is used as the output or recorded resolution Up scaling and down scaling can affect picture quality See Configure encoding 2 Increase the Bitrate value and or decrease the Limit frame rate value in the Encoding menu See Configure encoding 3 Check network settings including filters routers a...

Page 428: ...Ensure there are no USB sticks inserted into the USB ports during power up They may be conflicting with the internal hard drive causing unexpected behavior I can t register my Pearl Mini with Kaltura using the same device name that I just deregistered If you deregister Pearl Mini from Kaltura and then too quickly register again using the same name you may receive the following error message Unable...

Page 429: ...our output but would rather have the image fill the whole screen you have to options 1 Change the output frame size to match the aspect ratio of the input see Match output frame size with aspect ratio of input signal 2 Stretch the image to fit the output frame size aspect ratio see Stretch the image The color of the bars matte is defined by the Background color that is selected using the custom la...

Page 430: ... if you change the resolution of your source while streaming To change the output frame size on channels to match the aspect ratio of the video source 1 Connect to the Admin panel and login as admin see Connect to the Admin panel 2 To determine the input port name of the video source that s used in the channel select the channel from the Channels menu and click Layouts The custom layouts page open...

Page 431: ...ue in the Frame size fields 7 Click Apply Stretch the image You can remove the matte black bars by stretching the image to fit your output frame size using the custom layout editor 1 Login to the Admin panel as admin see Connect to the Admin panel 2 From the Channels menu select the channel and click Layouts The custom layout editor page opens 3 In the layouts list select the row for the layout yo...

Page 432: ...ution color depth etc to the connected video source Upload a new EDID In most cases the factory installed default EDID works fine for sources connected to the HDMI ports on Pearl Mini However there may be times when a connected video source uses resolutions that you do not want to use In that case you can manually upload an EDID and force Pearl Mini to use a specific set of attributes for a specif...

Page 433: ...the input port to use the factory default EDID Currently there is no way to tell if your input port is using a custom EDID If you are unsure restoring to factory default is the best approach To restore the default EDID 1 Login to the Admin panel as admin see Connect to the Admin panel 2 From the Inputs menu select the source you want to restore The source configuration page opens 3 Scroll to the E...

Page 434: ... source s aspect ratio 1 Connect to the Admin panel and login as admin See Connect to the Admin panel 2 From the Channels menu select a channel and click Layouts The custom layout editor page opens 3 In the layouts list select the row for the layout you want 4 In the items list below the layout editing area select the video source The video source settings appear 5 Check Keep aspect ratio when sca...

Page 435: ...ed source signal to a non interlaced signal 1 Login to the Admin panel as admin see Connect to the Admin panel 3 From the Inputs menu click the source name The configuration page for the source opens 4 Check Enable deinterlace and click Apply 423 ...

Page 436: ...Hz AAC audio can result in some dropped video frames Workaround Select another video frame rate a different audio sampling rate or choose MP3 audio l Configuring very low frame rates such as 1 fps encoding with a high bitrate setting e g 7000 kbps results in poor video quality Workaround Allow Pearl Mini to automatically select the best bitrate setting For 1 fps this results in a bitrate of about ...

Page 437: ...eny lists instead l It is possible to name two or more channels with the same value Use of automatic file transfer and UPnP is unpredictable if this occurs Workaround Ensure each channel has a unique name l The automatic file upload AFU file queue shows a maximum of 15 files Newer 15 and Top of the list buttons do not work All files are transfered even though they are not listed Workaround Wait fo...

Page 438: ...tput assigned to a Dashboard preview panel has its source changed the preview panel does not automatically update to reflect the change Workaround Refresh the Epiphan Live Dashboard in your web browser to update any changes in your preview panels Affecting USB devices Affecting other areas l AFU to Amazon Web Services S3 Simple Cloud Storage transfer sometimes does not recover after the network co...

Page 439: ...ment Agreement means this Epiphan Systems Inc Software License API means an application programming interface Documentation means the technical publications delivered to You with the Software relating to the installation and operation of the Software and or Hardware such as reference user installation and technical guides and release notes Epiphan means Epiphan Systems Inc Epiphan Hardware Product...

Page 440: ...ree software i e software licensed under the GNU Lesser General Public License or other free software licenses for which the applicable free software license may also require that the source code for such free software be made available to those receiving only executable versions of such free software If the source code for any free software distributed with the Software is not provided with the S...

Page 441: ... S RESELLERS OR DISTRIBUTORS NEITHER LICENSOR NOR ANY OF ITS AFFILIATES NOR ANY OF ITS OR THEIR LICENSORS SUPPLIERS SUBCONTRACTORS RESELLERS AND OR DISTRIBUTORS MAKE ANY REPRESENTATIONS OR PROVIDE ANY CONDITIONS AND OR WARRANTIES ABOUT THE SUITABILITY OF THE EPIPHAN HARDWARE PRODUCTS SOFTWARE SERVICES AND OR DOCUMENTATION NEITHER LICENSOR NOR ANY OF ITS AFFILIATES NOR ANY ITS OR THEIR LICENSORS SU...

Page 442: ...ensor may terminate this Agreement immediately by providing You with written notice if a You are in material breach of any provision of this Agreement which breach if capable of being cured is not cured within thirty 30 days after Licensor gives You written notice thereof or b You have committed a non curable material breach of this Agreement Upon termination You shall destroy all copies of the So...

Page 443: ...ration of nuclear facilities aircraft navigation systems air traffic control or direct life support machines Licensor its licensors suppliers subcontractors resellers and distributors specifically disclaim any express or implied representations warranties and or conditions for such uses 12 U S Government End Users The Software and Documentation are each a commercial item as that term is defined at...

Page 444: ...shall be reformed only to the extent necessary to make them enforceable under such circumstances This Agreement shall be governed by the laws of the Province of Ontario and the laws of Canada applicable therein No choice or conflict of laws rules of any jurisdiction shall apply to this Agreement You shall only be entitled to bring any action or proceeding arising out of or relating to this Agreeme...

Page 445: ...A 94301 USA www Epiphan com CE Compliance Statement Marking by the symbol indicates compliance of this device with the applicable directives of the European Community and meets or exceeds the following technical standards Directive 2014 30 EU Electromagnetic Compatibility Directive 2014 35 EU Low Voltage Directive Directive 2011 65 EU RoHS restriction of the use of certain hazardous substances in ...

Page 446: ...of Terms and Conditions These Terms and Conditions for use of this document and the associated Epiphan Product are governed and interpreted pursuant to the laws of the province of Ontario Canada notwithstanding any principles of conflicts of law All disputes arising out of or relating to these Terms and Conditions shall be finally resolved by arbitration conducted in the English language in Ottawa...

Page 447: ... and 2019 Epiphan Systems Inc ...

Search results

Summary of Contents for Pearl Mini

Reviews:

Brands by name

Popular brands

epiphan Pearl Mini, User Manual

Search results

Summary of Contents for Pearl Mini

Reviews:

Brands by name

Popular brands