Enigma2 Backend: Difference between revisions

From Official Kodi Wiki
Jump to navigation Jump to search
>Jdembski
mNo edit summary
 
(57 intermediate revisions by 10 users not shown)
Line 1: Line 1:
== Overview ==
{{PVR_guide}}
With the PVR build of XBMC it is possible to provide PVR- and DVR-like functionalities to the end-user. XBMC itself acts as a frontend and is connected to various backends, like tvheadend, VDR or mediaportal. With the VU+ addon XBMC PVR can be used also with a connected VU+ or any other enigma2 based settop box.
{{mininav|[[PVR]]}}


== Supported settop boxes ==
<section begin="intro" />Enigma2 is a framebuffer-based zapping application (GUI) that is primarily targeted to physical set-top-boxes running embedded Linux ([http://www.openembedded.org/wiki/Main_Page OpenEmbedded] based firmware distributions), however Enigma2 can technically also run on regular PCs, but it is not common. (Also it's possible to run Enigma2 on RaspberryPi devices with Open Vision images and external USB tuners)
In general all enigma2 based settop boxes should be supported, the following are known to work. If you can confirm that the addon works with a settop box not listed below, please take a moment and post this into the PVR support forum thread for this addon.


Known to work:
While the Enigma2 software was originally developed by Dream Multimedia for their [[w:Dreambox|Dreambox]] series, the [http://opendreambox.org opendreambox.org] has made Enigma2 into an popular open source based firmware platform for set-top boxes and it is used by a number of different set-top box manufacturers, including the most commonly known are [[w:Dreambox|Dreambox]], [[w:DBox2|DBox2]], and [[w:Vu+|Vu+ (VuPlus)]], which all use Enigma2 based firmware images. Most of these Enigma2 based set-top boxes falls under the category of Linux-powered satellite, terrestrial and cable digital television receivers.
* VU+Uno
* VU+Duo
* VU+Ultimo
* DM800 HD (with Gemini image & OpenPLI)
* DM8000 (OpenPLI image)


== Configuration ==
With the Enigma2 PVR add-on Kodi PVR can be used also with any Enigma2 based set-top boxes running OpenWebIf. Other WebIfs are supported with a subset of the original functionality.


To configure the addon please change into section System->Addons->Installed Addons->PVR clients->VU+ Addon and click on the properties button.
__TOC__
{{-}}
==Enigma2 technical overview==
Enigma2 frontend code is based on the Python Script language with a PVR backend software for tuning and recording written in C++ programming language. The PVR backend side uses the [http://www.linuxtv.org LinuxTV DVB API], which is part of a standard Linux kernel.<section end="intro" />


This will open the properties dialog which is divided into three different tabs.
The Enigma2 platform and Kodi are similar in that they both use Python to add extra features, [https://forums.openpli.org/topic/60394-enigma2-plugin-kodiliteinstaller-for-usb-external-hdd-and-normal-installation/ KodiLite] is a plugin developed by "pcd" which could run so many Kodi plugins on Enigma2.


=== General ===
== Enigma2 Client PVR add-on (C/C++ based)==
Within this tab the mandatory addon options need to be configured before it can be successfully enabled.
{{main|Add-on:Enigma2_Client}}


* '''VU+ hostname or IP address''': Please enter the IP address or hostname of your enigma2 based settop box.
The Enigma2 Client PVR add-on is a native PVR client made by the Kodi community for all Enigma2 based set-top boxes. This PVR C/C++ binary add-on for Enigma2 is an [https://github.com/kodi-pvr/pvr.vuplus open source code] community project.
* '''Icon Path''': In order to have XBMC display channel logos you have to copy the picons from your settop box onto your OpenELEC machine. You then need to specify this path in this property.
* '''Update Interval in minutes''': As the settop box can also be used to modify timers, delete recordings etc. and the settop box does not notify the XBMC installation, the addon needs to regularly check for updates (new channels, new/changed/deletes timers, deleted recordings, etc.) This property defines how often the addon checks for updates.


=== Channels ===
== Compatibility with other Kodi PVR Add-ons ==
Within this tab options that refer to channel data can be set.


* '''Folder for channeldata''': Retrieving the channel data from the backend can take quite long. To avoid that the user has to wait a long time before the addon starts it stores the information about the available channels in a separate XML file. Instead of quering the backend the addon then tries to load the channels from this XML file during addon startup. This property defines into which directory this XML file will be put. The filename is "channeldata.xml". Also, the last played position of the recordings will be saved into this directory, so that the user can resume the playback of a previously stopped recording. The recording data is stored into the file "recordings.xml".
As OpenWebIf is capable of outputting M3U and XMLTV files it is also possible to configure other PVR add-ons to work with Enigma2 backends such as:
* '''Fetch only one TV bouquet''': If this option is set than only the channels that are in one specified TV bouquet will be loaded, instead of fetching all available channels in all available bouquets.
* '''TV-Bouquet''': If the previous option has been enabled you need to specify the TV bouquet to be fetched from the settop box. Please not that this is the bouquet-name as shown on the settop box (i.e. "Favourites (TV)"). This setting is case-sensitive.
* '''Check for bouquet updates''': If this option is set the addon will check for bouquet updates after the initial addon startup. If this option is disabled it will only use the bouquets stored in the channeldata.xml file.
* '''Check for channel updates''': If this option is set the addon will check for channel updates after the initial addon startup. If this option is disabled it will only use the channels stored in the channeldata.xml file.
* '''Zap before channelswitch (i.e. for Single Tuner boxes)''': When using the addon with a single tuner box it may be necessary that the addon needs to be able to zap to another channel on the settop box. If this option is enabled each channel switch in XBMC will also result in a channel switch on the settop box. Please note that "allow channel switching" needs to be enabled in the webinterface on the settop box.


=== Advanced ===
* the [[Add-on:PVR_IPTV_Simple_Client| PVR IPTV Simple Client]] directly
Within this tab more uncommon and advanced options can be configured.
* as a source for the TVHeadend backend and then via the [[Add-on:Tvheadend_HTSP_Client|TVHeadend HTSP Client]]


* '''Streaming Port''': This option defines the streaming port the settop box uses to stream live tv. The default is 8001 which should be fine if the user did not define a custom port within the webinterface.
== Supported set top boxes ==
* '''Webinterface Port''': This option defines the port that should be used to access the webinterface of the settop box.
=== Mipsel architecture ===
* '''Username''': If the webinterface of the settop box is protected with a username / password combination this needs to be set in this option.
* It was the main architecture for Enigma2 and all of Mipsel models run Enigma2 fine except dm7025 (ancient Dreambox model with ATI Xilleon 226 SoC instead of Broadcom) which isn't a HD model.
* '''Password''': If the webinterface of the settop box is protected with a username / password combination this needs to be set in this option.
Even some "smallflash" models (the models with 64MB internal flash or less) can't handle recent Enigma2 builds and some open source teams already abandoned them.
* '''Recording folder on receiver''': Per default the addon does not specify the recording folder in newly created timers, so the default set in the settop box will be used. If you want to specify a different folder (i.e. because you want all recordings scheduled via XBMC to be stored in a separate folder), then you need to set this option.
=== SH4 architecture ===
* '''Use only the DVB boxes' current recording path''': If this option is not set the addon will fetch all available recordings from all configured pathes from the settop box. If this option is set then it will only list recordings that are stored within the "current recording path" on the settop box.
* Only some Enigma2 teams are supporting this old/powerless architecture, Open Vision (fully) and OE-Alliance (partly).
* '''Automatic Timerlist Cleanup''': If this option is set then the addon will send the command to delete completed timers from the settop box after each update interval.
This architecture is well known by the name "fulan" or "spark".
* '''Send DeepStandby-Command''': If this option is set then the addon will send the DeepStandby-Command to the settop box when XBMC will be closed (or the addon will be deactivated), causing the settop box to shutdown into DeepStandby.
=== ARM architecture ===
* Modern Enigma2 set-top boxes come with ARM SoCs as the 4K content requires too much power for being processed, today ARM is considered as the main Enigma2 architecture and all new models come with Broadcom or HiSilicon but with ARM SoCs to support h265 and HEVC.
ARM64 with multilib isn't stable enough so choosing ARM over ARM64 is recommended.


== Support ==
== External links ==
* [https://forums.openpli.org/topic/20871-build-script-for-openpli-enigma2-on-ubuntu-104-32-bit/ Enigma2 for PC discussions]
* [https://github.com/E2OpenPlugins/e2openplugin-OpenWebif OpenWebIf]
=== Open source Enigma2 images ===
* [http://www.openpli.org OpenPLi]
* [http://www.vuplus-support.co.uk ViX]
* [https://www.opena.tv OpenATV]
* [https://www.openvision.tech Open Vision]


If you have problems using this addon you should try and contact the author via the XBMC PVR support forum.
{{updated|19}}
[[Category:PVR]]

Latest revision as of 03:50, 17 December 2020

Live TV, PVR & Radio Contents

PVR main page

1. Tuner Cards
2. Backends
3. Setup
4. Live TV Artwork

Related Pages:

All PVR Pages
All PVR Add-on Pages

Home icon grey.png   ▶ PVR ▶ Enigma2 Backend

Enigma2 is a framebuffer-based zapping application (GUI) that is primarily targeted to physical set-top-boxes running embedded Linux (OpenEmbedded based firmware distributions), however Enigma2 can technically also run on regular PCs, but it is not common. (Also it's possible to run Enigma2 on RaspberryPi devices with Open Vision images and external USB tuners)

While the Enigma2 software was originally developed by Dream Multimedia for their Dreambox series, the opendreambox.org has made Enigma2 into an popular open source based firmware platform for set-top boxes and it is used by a number of different set-top box manufacturers, including the most commonly known are Dreambox, DBox2, and Vu+ (VuPlus), which all use Enigma2 based firmware images. Most of these Enigma2 based set-top boxes falls under the category of Linux-powered satellite, terrestrial and cable digital television receivers.

With the Enigma2 PVR add-on Kodi PVR can be used also with any Enigma2 based set-top boxes running OpenWebIf. Other WebIfs are supported with a subset of the original functionality.


Enigma2 technical overview

Enigma2 frontend code is based on the Python Script language with a PVR backend software for tuning and recording written in C++ programming language. The PVR backend side uses the LinuxTV DVB API, which is part of a standard Linux kernel.

The Enigma2 platform and Kodi are similar in that they both use Python to add extra features, KodiLite is a plugin developed by "pcd" which could run so many Kodi plugins on Enigma2.

Enigma2 Client PVR add-on (C/C++ based)

The Enigma2 Client PVR add-on is a native PVR client made by the Kodi community for all Enigma2 based set-top boxes. This PVR C/C++ binary add-on for Enigma2 is an open source code community project.

Compatibility with other Kodi PVR Add-ons

As OpenWebIf is capable of outputting M3U and XMLTV files it is also possible to configure other PVR add-ons to work with Enigma2 backends such as:

Supported set top boxes

Mipsel architecture

  • It was the main architecture for Enigma2 and all of Mipsel models run Enigma2 fine except dm7025 (ancient Dreambox model with ATI Xilleon 226 SoC instead of Broadcom) which isn't a HD model.

Even some "smallflash" models (the models with 64MB internal flash or less) can't handle recent Enigma2 builds and some open source teams already abandoned them.

SH4 architecture

  • Only some Enigma2 teams are supporting this old/powerless architecture, Open Vision (fully) and OE-Alliance (partly).

This architecture is well known by the name "fulan" or "spark".

ARM architecture

  • Modern Enigma2 set-top boxes come with ARM SoCs as the 4K content requires too much power for being processed, today ARM is considered as the main Enigma2 architecture and all new models come with Broadcom or HiSilicon but with ARM SoCs to support h265 and HEVC.

ARM64 with multilib isn't stable enough so choosing ARM over ARM64 is recommended.

External links

Open source Enigma2 images