Changes between Version 6 and Version 7 of ru/External-Software-E2WebIfAPI


Ignore:
Timestamp:
Jan 12, 2017 3:06:08 AM (7 months ago)
Author:
trac
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • ru/External-Software-E2WebIfAPI

    v6 v7  
     1[[TranslatedPages]] 
     2'''9.4 E2WebIfAPI''' [=#point9.4] ([wiki:Wiki#point0 Contents]) ([WikiStart#point0 Main page]) 
     3 
     4 
     5== Introduction == 
     6Enigma2 Web Interface ( WebIf ) API was defined for Dreambox . 
     7It is a protocol that allows you to control a Dreambox via HTTP requests. 
     8 
     9Typical control tasks are : 
     10 
     11* Programming (timer) and playing back recordings 
     12* Live streaming (TV and radio) 
     13* EPG functions (display, search) 
     14* Remote control (Remote Control) 
     15 
     16You can find a good overview of the E2WebIFAPI in the [http://dream.reichholf.net/wiki/Enigma2:WebInterface DreamboxWIKI]. 
     17 
     18== Motivation == 
     19 
     20For TitanNit the Android App [wiki:External-Software-TiMote#point109.1 9.1 TiMote] was developed. Anybody with an Android Smart-Phone or Tablet with this software installed can control their receiver or watch TV on the Android device. Isn't that cool? 
     21 
     22But owners of an iOS-device (i-Phone or i-Pad) are unlucky as there is no iOS TitanNit compatable web client such as TiMote. You can control your receiver via http protocol (same as Web Interface) but you wont be able to use all advantages like tiMote on an Android Platform. 
     23 
     24On the other hand iOS and Android Apps already exist for Dreambox receivers. These Apps are based on the Enigma2 protocol. Couldn't one just use that App on iOS instead of developing a new App? 
     25 
     26== The solution == 
     27TitanNit has its own protocol but is not compatible to the Enigma2 WebIf. Following a short analysis it was discovered that converting E2 requests to Titan didn't seem so difficult. Therefore, an E2 web server (e2webserv) was developed, which implements the Enigma2 WebIf. This server receives the E2 requests, delegates the calls to TitanNit web server and the responses is converted back into the XML format, which is expected from the E2 client. 
     28 
     29This way the TitanNit receiver is able to correspond to existing E2 - client software. 
     30 
     31 
     32== Requirements == 
     33 
     34* The Web server must be enabled on the receiver 
     35* The E2webserv must be installed on the receiver 
     36 
     37== IOS Apps == 
     38 
     39The following apps are installed on my iPad2: 
     40* dreaMote 
     41* DreaMote Lite 
     42* e2RemoteHD 
     43* Dreambox Live 
     44 
     45Should you not want to purchase any apps from the Apps-Store I can recommend dreaMote Lite . 
     46 
     47In addition to the app you need a player. 
     48 
     49I have tried the following players, which work well for me: 
     50* Good Player 
     51* BUZZ Player 
     52* OPlayerHD Lite 
     53* VLC Player 
     54 
     55VLC and OPlayerHD Lite are free. 
     56 
     57== XBMC == 
     58 
     59If you are running the Media Center software [http://xbmc.org/ XBMC] or [http://xbmc4xbox.org.uk/ XBMC4XBOX], you can connect your Titan receiver via the Live-TV-Plugin VU+. 
     60XBMC runs on Windows PCs aswell as Linux and is also available for Raspberry Pi and the Xbox. 
     61 
     62== VLC == 
     63Having installed the e2webserv you can enjoy Live-Streaming on your Windows or Linux PC using [http://www.videolan.org/vlc/ VLC] (no further software needed). 
     64 
     65You do not have to switch channels manually it all happens automatically. In order for this to take place you need an M3U playlist. You can easily generate the playlist by your Favourites and save to your PC. Having done so you only need to open the M3U list in VLC and select the desired channel. 
     66 
     67How do you export a particular favourites list into an M3U file? 
     68 
     69Enter the address in your Web browser. 
     70 
     71Example (favourite is "Polish"): 
     72 
     73[http://192.168.1.1:8080/web/services.m3u?bRef=Polish] 
     74 
     75Enter your receivers IP address and where names of Favourites have spaces within these spaces must be replaced with "%20". 
     76 
     77Example (favourite is "My TV" Receiver - IP: 192.168.0.10): 
     78 
     79[http://192.168.0.10:8080/web/services.m3u?bRef=Mein%20TV] 
     80 
     81Client Configuration == == 
     82Please configure the E2-clientas accordingly: 
     83* IP address of the receiver 
     84* Port: 8080 
     85* Streaming Port: 8001 
     86 
     87Please note that SSL is not supported. 
     88 
     89Below you see an example configuration for dreaMote. 
     90 
     91[[Image(DreaMote.png,384px)]] 
     92 
     93== E2webserv.conf == 
     94 
     95You must alter the server configuration manually. Using standard configured TitanNit no alterration on the e2webserv.conf should be neccessary. 
     96 
     97Should you have installed the plugin to Flash the configuration file '''e2webserv.conf''' lies in the directory '''/mnt/swapextensions/etc''' 
     98 
     99Here is the content: 
     100{{{ 
     101# E2 web port 
     102port = 8080 
     103# E2 data port 
     104data port = 8001 
     105# Titan web port 
     106titanium- port = 80 
     107# Titan data port 
     108titan data port = 22222 
     109# Titan host (change it if e2webserv is not running locally on the receiver) 
     110titan host = 127.0.0.1 
     111# Automatic switching of channels 
     112# It is useful if you do not want manually switch a channel on receiver with a single tuner. 
     113# If it is set to false and you have a single tuner you can stream the only channels located 
     114# On the same transponder as the current channel active on the receiver . 
     115Autozap = true 
     116# Log output file 
     117logFile = /tmp/e2webserv.log 
     118# Maximum log file size in KB. Set it to 0 (default 10KB) to disable logging (maximum allowed value is 1024). 
     119# When the file limit is reached a backup of the current file is created . 
     120# It Means maximally 2 x MaxLogSize KB will be used. 
     121MaxLogSize = 10 
     122# Thread pool size (1 through 8) 
     123threadpool = 2 
     124# Directory where the transponder and bouquet files are located. 
     125# You do not need to Specify it, it will be Automatically Discovered . 
     126# But if you you start e2webserv not on the receiver (but eg on your Linux server or Windows computer) then you 
     127# Shoulderstand copy the settings (channel, transponder, provider and all bouquets file) and here Specify the location on the local computer . 
     128titanDir = /mnt/settings 
     129}}} 
     130 
     131== Links == 
     132 
     133* Enigma2 Web API in [http://www.aaf-digital.info/forum/showthread.php?90948-Enigma2-Web-API-f % FCr - TitanNit AAF Forum] 
     134* Sources on [https://github.com/gswiatek/e2api4titan GitHub] 
     135[[br]] 
     136[[br]]