MANUAL DE INSTALACIN, CONFIGURACIN Y USO DE STREAMIX 2.

2013 TodoStreaming

Qu es Streamix? Streamix es una distribucin de GNU/Linux basada en Debian 6 (Squeeze) para arquitecturas de 64 bits de Intel y AMD (Intel Core i3 o superior), que adems incorpora los drivers de las tarjetas PCI Express de BlackMagic adems de las libreras GPL libav, librtmp, libx264 y libfaac para el tratamiento del audio y video en H.264 y AAC, as como los protocolos de red usados para el streaming (RTMP y UDP). A parte lleva un servidor de medios llamado Streamix Server y una serie de utilidades para el control de las tarjetas BlackMagic, desarrollados por TodoStreaming para convertir al PC en donde este sistema es instalado, en un encoder o decoder para streaming de una calidad muy alta frente a otras soluciones mucho ms caras. El sistema es muy fcil de instalar, en unos pocos pasos. Una vez instalado e iniciado, solamente ofrece un interfaz web para su configuracin accesible desde la red, mediante un ordenador provisto de cualquier navegador. Una vez configurado y puesto en marcha el sistema es totalmente estable y seguro, ideal para sistemas de emisin o recepcin mediante streaming autnomos, que no requieren vigilancia o intervencin humana. Instalacin de Streamix Primeramante bajamos la imagen ISO del CD de instalacin, de la siguiente URL: http://www.todostreaming.es/downloads/streamix-fw-amd64.iso . Luego la grabamos con cualquier utilidad que acepte imgenes tipo ISO. Despus arrancamos el equipo con el CD, y aparecer la primera pantalla del instalador.

Pulsamos la tecla Enter para que comience la instalacin. Los requisitos bsicos de hardware para usar plenamente este operativo son las siguientes: 1.- Para SDTV PAL o NTSC es suficiente con un Core i3 de al menos 2.5 Ghz y 2 GB de RAM.

2.- Para HDTV 720p (1280x720) es suficiente con un Intel Core i3 de al menos 3 Ghz y 4 GBs de RAM. 3.- Para Full HD 1080 (1920x1080) es necesario un Intel Core i7/Xeon E3 (8 hyperthreads) de al menos 3.3 GHz y 4 GBs de RAM. En todos los casos, no es necesario el uso de tarjeta grfica aceladora, ya que no se hace uso de aceleracin grfica en ningn momento, todo se comprime o descomprime con la CPU sobre la RAM. En todos los casos es necesario el uso de una tarjeta capturadora PCI Express de BlackMagic. Este sistema ha sido ampliamente usado con las tarjetas Intesity Pro (con conexiones HDMI y analgicas), DeckLink SDI (con conexiones digitales SDI) y DeckLink Studio 2 (HDMI, analgicas y SDI). Los 3 modelos soportan tanto SDTV, como HDTV y fullHD, sus precios son econmicos y su calidad es profesional. Los siguientes pasos de la instalacin nos conducen por la eleccin del idioma de la instalacin y del teclado, y luego el de la red. Es necesario el asignar una IP local fija a este equipo, que luego nos permita acceder a l mediante el navegador, para ser configurado, e incluso cambiada dicha IP para un posterior traslado del equipo a otra red diferente.

Asmismo el resto de parmetros de red como son la mscara de subred, el gateway (o IP del router) y el servidor DNS que vamos a usar. Tras seleccionar nuestra zona horaria, se nos pedir la confirmacin del particionado de discos. Este instalador ocupa el disco duro completo, y no requiere ms de 4 GBs del espacio en el mismo para su instalacin completa. Tras unos 10 a 15 minutos, el sistema se terminar de instalar y nos pedir terminar la instalacin, aceptando Continuar, expulsando el disco de instalacin y reiniciando el sistema.

Tras su reinicio, el sistema mostrar una pantalla negra con un aspecto similar a ste:

Configuracin del sistema Una vez instalado el sistema, nos vamos a un equipo de la misma red que disponga de navegador web, y ponemos en la barra del navegador la direccin ip que hemos asignado al equipo durante la instalacin, de la manera http://ip_asignada_al_equipo.

Entonces aparecer la primera pgina del configurador, similar a la de un router.

El acceso por defecto es Username: admin Password: admin , luego se puede cambiar.

Al entrar el usuario y clave vemos el siguiente men:

El men solamente es accesible por una sola IP a la vez. El sistema desconecta una sesin automticamente a los 15 minutos de inactividad por motivos de seguridad. El men Multiplay solamente aparece una vez que tenemos funcionando el sistema como Decoder. En esta pantalla correspondiente a la configuracin de red, podemos cambiar los parmetros de la misma, y dichos cambios se realizarn una vez pulsemos Grabar y seguido reiniciemos el equipo. Advertencia: Asegrese de introducir valores de la red donde va a usar su equipo una vez reiniciado, ya que de hacerlo mal el equipo sera inaccesible. Ajusta correctamente tu zona horaria para que el reloj del sistema vaya perfectamente ajustado para el uso confiable de la funcin Program con otros equipos sincronizados mediante GPS o servidor NTP de red. Luego esta la funcin AutoPilot, que permitir fijar el comportamiento del equipo una vez configurado si ste es reiniciado o se queda sin alimentacin elctrica y luego arranca al recuperarla. Si no hay ningun autopilot, activado el equipo emitir o recibir solamente si pulsamos manualmente estas opciones en las pantallas correspondientes que veremos ms adelante. Las opciones son: Encoder, Decoder y Program (cada una con su propio panel de ajustes)

Aviso: Toda configuracin que cambie, deber ser grabada pulsando el botn Grabar, si quiere que sta sea usada durante su funcionamiento. La pgina para configurar la emisin es la de Encoder.

Por defecto viene ya configurada para conseguir una calidad broadcast en SDTV. Esto se consigue con un bitrate de video de 1200 kbps y audio de 96 kbps. Podemos elegir la entrada de video y de audio de la tarjeta Black Magic que vamos a usar para la captura, el modo de video de la fuente, el aspect ratio de la emisin, si vamos a trabajar con frames deinterlaced (recomendado para publicacin en Web y mviles), con campos originales (recomendado si el Decoder va a ser el propio Streamix o un receptor IP Amino), con campos convertidos a fotogramas progresivos de 50/60 fps (recomendado para receptores IP PeerTV y Lukas Video), el bitrate de calidad de video y de audio, si vamos a incorporar pulsos de datos de desconexin o reconexin local, que pueden trabajar en puerto COM1 o mediante un conversor USB. Luego viene el campo Destino, que hace referencia a la finalidad de la emisin, si va a ser usada para hacer enlaces con calidad Broadcast o si se va a usar para publicar en Web y compatible con iPhone, Android y BlackBerry. Tambin se puede escoger la calidad de compresin, si se dispone una CPU menos potente y no se puede conseguir a calidad Alta. Finalmente vienen los datos de conexin a nuestro servidor de streaming con los mismo parmetros que usaba en el Flash Media Live Encoder (FMS URL, Stream, Username y Password). Una vez establecidos estos parmetros, los grabamos pulsando el botn Grabar y ya podemos comenzar el envo del stream pulsando el botn Enviar. Si el envo es correcto, ver un mensaje como ste:

Si nos vamos a la pgina de Status, podremos ver en tiempo real el logging del stream enviado. Algo como sto:

Este logging va actualizndose cada 3 segundos, y nos permite ver si hay algn problema en la emisin, como falta de velocidad de subida, si los fps son inferiores a 25 (frames por segundo). Indicadores en general que nos permiten reconocer fallos en la emisin. Aviso: Recuerde que para emitir a un bitrate total determinado en RTMP, es aconsejable disponer del doble de ancho de banda de subida. El encoder adems de por RTMP, puede emitir en UDP dentro de redes locales o privadas. Solamente hay que poner en FMS URL, una URL del tipo: udp://192.168.1.120:10000 , que enviara el stream en paquetes UDP a un receptor en la direccin 192.168.1.120 al puerto 10000 La opcin Downscale, nos permite usar el downscaler por hardware que lleva la tarjeta BlackMagic, para convertir la entrada HD720 en SD o la HD1080 en SD. Si elige una de estas 2 opciones, tendr que poner el modo de video a capturar en PAL/NTSC, o de lo contrario la captura se har en HD. Esta opcin es muy til para mesas que trabajan todo el video en HDTV y quieren sacar en SDTV la mejor calidad posible en digital. En la pantalla decoder, podemos configurar al equipo como un receptor de streaming, con la capacidad de recibir solamente streams RTMP con datos embebidos o no de desconexin local sincronizados con el audio y video. Las opciones son muy similares a las del encoder. Salida de video y audio por la que vamos a ver la emisin, el modo de video de la fuente, el aspect ratio, la dominancia de campo (TFF tpica de PAL y la BFF tpica de NTSC), el puerto serie para la salida de la recepcin de los pulsos de desconexin local, el FMS URL, Stream, Username y Password de recepcin. En No Video Output podemos elegir si queremos que cuando no se reciba seal, se muestre congelada el ltimo fotograma (Last Frame) o simplemente una pantalla en negro (Black Frame). El bffer aconsejado es de 2 segundos para una red de internet estable, en caso de que se produzcan muchos cortes, se puede elevar el bffer, aunque si por encima de 5 segundos sigue cortndose es que la conexin no es suficientemente estable para dicha calidad de imagen. A mayor bffer tambin mayor es el tiempo de corte en el caso de microcortes debidos a deficiencias en la velocidad de bajada de la red.

El Username y Password de esta pgina, no tienen nada que ver con los de emisin. Estos parmetros son solamente aplicables a aquellos clientes que quieran proteger sus emisiones de ser

reproducidas por usuarios no autorizados, y desde el panel de control de estadsticas quieran registrar quienes sern sus receptores, y controlar cuando estos pueden o no acceder a un stream en concreto (ver manual SecuredTV). Una vez establecidos los parmetros, los guardamos pulsando Guardar y pulsamos Recibir para comenzar la recepcin del stream. En Status podremos ver en tiempo real el logging de la misma manera que hemos visto con el Encoder. Aviso: Este sistema de recepcin funciona bien reproduciendo streams creados por este mismo sistema. Si reproducimos streams generados por otros softwares, como Flash Media Live Encoder u otros, es posible que la sincronizacin audio/video no sea la correcta. En la pgina de Status, podemos ver la informacin en tiempo real de la emisin o recepcin tal como hemos visto en los apartados dedicados a las pginas del Encoder y del Decoder. Tambin podemos ver el nombre de la tarjeta Black Magic detectada en el sistema, y si el firmware de la misma esta correctamente actualizado respecto a la versin de drivers que instala Streamix. Si esto no es as, aparecer un mensaje avisando de esto, con un botn Actualizar, que al pulsar iniciar la

conexin al servidor de BlackMagic de donde recoger el firmware actualizado y llevar a cabo dicha puesta al da. Una vez esta actualizacin se haya efectuado, es necesario que reinicie el equipo desde el botn correspondiente en la pgina de Red. Este software solamente reconoce una sola tarjeta Black Magic en sistemas que tenga instados ms de una. Solamente se podr usar a la vez, o la opcin Encoder o la opcin Decoder. De hecho, una vez active la emisin o la recepcin, aparecer un botn Stop, para detener la misma, y en la otra funcin, desaparecer el botn correspondiente de puesta en marcha, dejando patente que solamente se puede usar el equipo como Encoder o como Decoder, y no como ambos simultneamente. Cuando se acciona el botn Recibir del Encoder, se activa un nuevo men antes oculto, llamado MultiPlay. En l se muestran todos los streams accesibles en el panel de usuario correspondiente al FMS URL que hemos escogido. As un usuario puede tener mltiples encoders con diferentes seales emitiendo desde diferentes localizaciones geogrficas. Desde este panel podr acceder a ellas mediante un mero clic sobre su nombre.

En este caso vemos como hay mltiples streams (de otros encoders de dicho FMS URL) que son accesibles. El que actualmente se esta reproduciendo aparece en naranja, sin posibilidad de clicar en l. Si queremos recibir la seal llamada video2, nos ponemos encima de su link, y hacemos clic sobre ella. Inmediatamente el stream livestream se desconecta y se conecta el nuevo stream seleccionado. De esta manera manual, se puede montar una infraestructura multipunto fuente a multipunto recepcin, pudiendo conectar cualquiera con cualquiera, se encuentre donde se encuentre emitiendo. Esto solo es posible si de por medio hay un servidor TodoStreaming repartiendo la seal a quien la solicita en el momento que la solicita, sin importar el nmero de emisores ni receptores que la compongan.

El men Program, permite programar mltiples acciones a cualquier fecha y hora que se quiera.

Elegimos la fecha en el almanaque perpetuo, pulsamos sobre Set, y ya podemos comenzar a aadir lineas de programa, que se van ordenando por hora de ejecucin conforme se introducen, aunque esto se haga desordenadamente. En cualquier momento se puede cambiar cualquier campo errneo, y grabar pulsando Save. Introducir nuevas lineas de programa es tan sencillo como pulsar New..., y borrarlas tan sencillo como pulsando la equis roja de la derecha de su fila. Se puede escoger entre 3 acciones: encode, decode y stop. En todas ellas se usan los ajustes correspondientes de los mens Encoder y Decoder, excepto el stream que podemos elegirlo. De esta manera podemos automatizar hasta el segundo exacto la actividad del sistema Streamix, sin intervencin humana. No hay lmites en cuanto al nmero de programaciones y a las fechas de anticipacin. Pueden programarse los prximos 100 aos da a da si as se desea. Enlaces punto a punto en redes privadas Streamix tambin permite conectar 2 PCs con tarjetas Black Magic dentro de una red interna privada sin necesidad de apoyarse en un servidor de TodoStreaming. Para ello simplemente tenemos que configurar el Encoder para enviar seal por UDP rellenando solamente la FMS URL con una direccin del tipo udp://ip_del_receptor:puerto (donde puerto recomendamos que sea un nmero entre 1025 y 65535). Luego en el receptor configuramos en Decoder en la FMS URL con una direccin del tipo udp://@:puerto (el mismo puerto usado para el envo). Este tipo de enlace usa un bffer de seguridad de tan solo 1.000 msec, por lo que el retardo entre emisor y receptor debe de ser inferior a los 2 segundos (en torno a 1.25 segundos). Enlaces punto a multipunto en redes privadas De igual manera se pueden efectuar enlaces punto a multipunto dentro de redes privadas, si los routers y switches que se usan en la red tienen habilitado el protocolo IGMP. Tambin hemos de usar el protocolo UDP, pero sobre una direccin IP multicast como por ejemplo 224.0.0.1 . En ese caso el emisor configurara en el Encoder la FMS URL como udp://224.0.0.1:10000?ttl=1 y los receptores configuraran en el Decoder la FMS URL como udp://224.0.0.1:10000 . El retardo entre el emisor y los receptores sera igualmente inferior a los 2 segundos. El parmetro TTL indica el nmero de routers que van a repetir el datagrama multicast (en redes con un slo routers sera 1 como en este ejemplo). Uso de receptores IPTV en redes privadas Esta versin de Streamix, lleva integrada el middleware para el uso con UDP de los receptores IP de las marcas PeerTV (con JSTV), Lukas Video y Amino. De esta manera se puede montar a nivel

local, sin necesidad de apoyarse sobre un servidor externo de TodoStreaming, una red punto a punto o punto a multipunto, donde el emisor es un PC con Streamix y una tarjeta BlackMagic, y los receptores son cajas IPTV de esas marcas. Para configurar el receptor IP para que cargue el middleware del PC con Streamix, solamente hay que introducir la URL http://ip_pc_streamix/iptv.cgi en las configuraciones correspondientes de cada caja IPTV. En el caso de los receptores PeerTV con JSTV, se hace en el campo Application URL (ver manual SecuredTV). En los receptores Lukas Video, se hace en el campo Start Page URL del Content Source (ver manual SecuredTV). En los receptores Amino se hace en el Management Menu, en la seccin Browser, en el campo Home Page. TodoStreaming recomienda Amino por su alta calidad y estabilidad. Disponemos de Amino A-140 con firmware modificado para que arranque en negro sin carteles de inicio, muy elegante para sistemas que emiten directo a antena. El men Password nos permite cambiar para mayor seguridad el user y pasword de acceso al men, cosa muy til para sistemas que se configuren para ser accedidos desde la red pblica de internet. Por ltimo tratar el tema de la actualizacin por Internet de Streamix. La versin 2.1 es la primera que no requiere reinstalacin para ser actualizada. Cuando haya una nueva versin en el servidor de TodoStreaming, el sistema se la bajar y en la pantalla de Status aparecer un cartel como ste:

Cuando lo deseemos podremos pulsar el botn Update, y la actualizacin se ejecutar en tan solo 2 segundos, de manera que no se cambiar la configuracin anterior, ni su funcionamiento. El sistema solamente se desconectar y reconectar en esos 2 segundos, por lo que puede elegir el momento de hacerlo cuando menos trastorno provoque.

Reconocimientos Finalmente queremos reconocer todo el software y libreras Open Source con licencias GPL y BSD diversas que forman parte de este sistema instalable: Debian: http://www.debian.org/index.es.html Linux Kernel: http://www.kernel.org/ Libav: http://libav.org/ Librtmp: http://rtmpdump.mplayerhq.hu/ Libfaac: http://www.audiocoding.com/faac.html x264: http://www.videolan.org/developers/x264.html Golang: http://golang.org/ BlackMagic SDK: http://www.blackmagic-design.com/support/ BMD Tools: https://github.com/lu-zero/bmdtools Todo este software esta protegido bajo las licencias GPL y BSD, y su cdigo fuente puede ser encontrado en los links arriba mencionados, a excepcin del StreamixServer que ha sido desarrollado usando Golang como lenguaje de desarrollo por TodoStreaming, y es distribuido junto con esta distribucin de Linux Debian como freeware. Agradecimientos especiales a Luca Barbato, desarrollador del equipo Libav y tambin a Antonio Toms Martnez por algunas de las utilidades para las tarjetas Black Magic(bmdtools), el desarrollo del Streamix Server y el middleware de las distintas cajas IPTV.

2013 TodoStreaming