% Created 2010-08-31 Tue 17:57
\documentclass[final,a4paper,10pt,twocolumn,twoside]{memoir}
\usepackage[utf8]{inputenc}
\usepackage[T1]{fontenc}
\usepackage{fixltx2e}
\usepackage{graphicx}
\usepackage{longtable}
\usepackage{float}
\usepackage{wrapfig}
\usepackage{soul}
\usepackage{t1enc}
\usepackage{textcomp}
\usepackage{marvosym}
\usepackage{wasysym}
\usepackage{latexsym}
\usepackage{amssymb}
\usepackage{hyperref}
\tolerance=1000
\usepackage[english]{babel}
\usepackage{amsfonts, amsmath, amssymb}
\usepackage{ucs}
\usepackage[utf8x]{inputenc}
\usepackage[T1]{fontenc}
\usepackage{hyperref}
\usepackage[pdftex]{graphicx}
\usepackage{fullpage}
\usepackage{lmodern}
\usepackage[hang,small]{caption}

\providecommand{\alert}[1]{\textbf{#1}}

\title{HDSync Setup Manual}
\author{Denis J. Roio <jaromil@nimk.nl>}
\date{Version 0.3, September 2010}

\begin{document}

\maketitle

\setcounter{tocdepth}{3}
\vspace*{1cm}



\tableofcontents

\section{Background information}
\label{sec-1}


First of all be sure to read and understand the informations on the
\href{http://www.wdlxtv.com}{WDLXTV} website. To run HDSync you'll need a \textbf{WDTV Live} device for
each video channel you are playing.

\includegraphics[width=10em]{images/wdhdtv-front.jpg}

Be sure you have the \textbf{Live} model: the one with a network port on its
back (Ethernet RJ45)

\includegraphics[width=10em]{images/wdhdtv-retro.jpg}

Now, before proceeding with HDSync, download \href{http://wiki.wdlxtv.com/Main_Page}{B-Rad's firmware WDLXTV Live} and \href{http://wiki.wdlxtv.com/Flashing_the_Firmware}{flash it} on your device. Once all this is set you can start
follow the instructions below.
\section{Prepare the Usb keys}
\label{sec-2}


To run HDSync on your WDTV Live device you need one USB stick for each
device (and therefore each video channel); the usb stick will contain
our software and the video to play.

First \textbf{format the usb sticks with a decent journaled filesystem like the Linux Ext3} using tools like mkfs.ext3 from a GNU/Linux OS.

Then place our application (the \textbf{hdsync.app.bin} file) on the USB
sticks together with two configuration files, one of them needs to be
edited to set how many video channels you are playing.

\begin{itemize}
\item Copy the \textbf{hdsync.app.bin} in the usb stick
\item Copy the \textbf{S00custom-options} conf file in the usb key
\item Copy the \textbf{hdsync.conf} in the usb stick
\item Edit hdsync.conf according to your setup (set \textbf{VIDEO$_{\mathrm{CHANNELS}}$})
\item Create a \textbf{videos/} directory in the usb stick, place your video
\end{itemize}
\section{Prepare the WDTV devices}
\label{sec-3}


To setup the WDTV devices you need to connect them to a monitor or
project and move around with the remote control, reach the settings
indicated below and change them with correct values
\subsection{Network settings}
\label{sec-3_1}

\begin{itemize}
\item Set the configuration to \textbf{Manual}
\item Set the ip number of the box to a common C class IPv4\footnote{The IP is a numeric network address, a C class is determined by
    the last value of the series of numbers: be sure that the last and
    rightmost number changes, while all others stay the same. For
    further information please refer to common documentation on
    network administration. }
\item Set the netmask to \textbf{255.0.0.0}
\end{itemize}
\subsection{Video settings}
\label{sec-3_2}

\begin{itemize}
\item Set the \textbf{Video sequence} to \textbf{Normal}
\item Set the Browser display to \textbf{List mode}
\end{itemize}
\section{Connect your syncstarters}
\label{sec-4}


HDSync is made so that a complete setup will be extremely simple to
activate and deactivate: just using an ON/OFF switch, since that is
what works best when you want to leave your installation somewhere
like in an art gallery and give simple instructions to people.

Once you loaded the WDTV boxes with the HDSync software and got
everything configured, you will need to \textbf{connect them together via ethernet cables} - and a hub if there are more than 2 channels.

Then connect each WDTV box via a video cable (Composite or HDMI) to
your monitor or beamer, then connect the audio to the amplifier.

Then obviously you need to connect all power cables for all electronic
device involved in this setup; we use to set everything on the same
power socket so that its \textbf{ON/OFF switch} will be the main for the
whole installation.

At last, make sure that all cable connections are well plugged and\ldots{}
\section{Switch ON!}
\label{sec-5}


If everything went well so far you'll see the WDTV boot screens
popping up, then arriving at the menu they will automatically select
the video playback browser and stop on its first selection, wait half
a minute, then start.

In this phase you can notice that network leds are blinking: in case
you are using an hub you can count as many lights as many devices you
have (else there is a problem in the way you connected the network).

If you have a computer and want to monitor the sync operation ``from
inside'', you can assign yourself an IP in the range of those you used
for the boxes, then log into the devices via ssh and read their log in
\textbf{/tmp/hdsync.log}, realtime updates can be watches with the command:

\begin{verbatim}
 tail -f /tmp/hdsync.log
\end{verbatim}


This way you can also debug the software behaviour for errors; however
you won't need this unless you are developing HDSync, if you have any
troubles these are likely due to cables and setup of files on the USB
sticks. \textbf{Happy Hacking}!
\section{Terms and Conditions}
\label{sec-6}


HDSync is Free Software and you can use it, modify it and redistribute
it as you want, provided you read and agree with all terms of the GNU
GPL v3 license.

If you use this software for your own art projects, this doesn't mean
you need to use the same license we use and you can even sell artworks
made with it; but you must specify reasonably that you are using:

 \textbf{HDSync, free and open source software developed by Jaromil at the  Netherlands Media Art Institute}.
\section{Support}
\label{sec-7}


If you rely on this software and you wish we develop it further,
please express your appreciation with a kind donation.

If you need support using HDSync, distributing artworks or producing
installations with it, you can certainly \textbf{hire our services}: we can
offer assistance and development services as a professional art
institute with several years of experience in the fields of video and
media art.

Get in touch:

\begin{verbatim}
   Denis Jaromil Roio   |X|  Dyne.org Foundation
   software developer   |X|  Netherlands Media Art Institute
   GNU / Linux / *BSD   |X|  Montevideo / Time Based Arts
 ------------------------------------------------------------
  http://nimk.nl/onderzoek ~ ~ ~ http://nimk.nl/eng/research
  Tel: +31 20 6237101 121 ( Tue and Fri, 10:30 - 17:30 CET )
  Post:  NIMK/Artlab   Keizersgracht 264   1016 EV AMSTERDAM
  Email: jaromil@nimk.org IRC: irc.freenode.net /msg jaromil
  PGP: B2D9 9376 BFB2 60B7 601F 5B62 F6D3 FBD9 [ C2B6 8E39 ]
 
\end{verbatim}
\section{Disclaimer}
\label{sec-8}


    This program is free software: you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation, either version 3 of the License, or
    (at your option) any later version.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with this program.  If not, see \href{http://www.gnu.org/licenses/}{http://www.gnu.org/licenses/}.

\begin{verbatim}
 
 
 HDSync is brought to you by: 
 
\end{verbatim}


\includegraphics[width=10em]{images/nimk-logo-eng.jpg}

\begin{verbatim}
         & 
\end{verbatim}


\includegraphics[width=10em]{images/dyne-big.png}

\end{document}
