|accountName |Login Name (email), should be the registered e-mail address for the Telekom Kundencenter |
|accountPassword |Account password (same as for the Kundencenter) |
|userId |The technical userId required for the pairing process, see section "Retrieving userId" |
|ipAddress |IP address of the receiver, usually discovered by UPnP |
|port |Port to reach the remote service, usually 8081 for the MR401/MR201 or 49152 for MR400/200 |
|udn |UPnP Unique Device Name - a hex ID, which includes the 12 digit MAC address at the end (parsed by the binding) |
For textual configuration at least the `ipAddress`, `udn` and `userId` parameters are required.
### Retrieving the User ID
The binding requires a so called User ID (parameter `userId` in the Thing configuration) to pair with the receiver, which is generated by logging in with your Telekom credentials (Login Name + Password for the "Telekom Kundencenter").
openHAB needs to access the Internet to perform that operation, which can be disabled afterwards.
The binding initiates the pairing with the receiver once the U has been obtained, this is an automated process.
The Thing changes to ONLINE once the pairing result is received, otherwise check the Thing status for an error message.
There are different ways to setup the User ID:
1. Use the openHAB console
Run the following command on the console and provide your Telekom account credentials:
Login successful, returned User ID is 1903AAAAAAAAC7E9718BBBCBCBCBCBC
Edit thing configuration and copy this value to the field userId
```
On successful login the console will show the User ID value. Copy&Paste this value to the Thing configuration (parameter `userId`) of the receiver.
If you have multiple receivers under the same MagentaTV subscription you can use this value for all of them.
2. Provide your credentials in the UI
If you do not want to use the openHAB console, you can also setup the credentials in the Thing configuration
- Account Name (`accountName`) is your Login Name for the Telekom Kundencenter (registered email address)
- Account Password (`accountPassword`) is the corresponding password.
The binding uses these credentials to login to your account, retrieves the `userId` parameter and sets it in the Thing configuration.
For security reasons the credentials are automatically deleted from the thing configuration after the initial process.
| POWER | Power on/off the receiver (check standby mode) |
| 0..9 | Key 0..9 |
| SPACE | Space key |
| POUND | # key |
| START | * key |
| DELETE | Delete key (text edit) |
| ENTER | Enter/Select key |
| RED | Special Actions: red |
| GREEN | Special Actions: green |
| YELLOW | Special Actions: yellow |
| BLUE | Special Actions: blue |
| EPG | Electronic Program Guide |
| OPTION | Display options |
| SETTINGS | Display options |
| UP | Up arrow |
| DOWN | Down arrow |
| PGUP | Page up |
| PGDOWN | Page down |
| LEFT | Left arrow |
| RIGHT | Right arrow |
| OK | OK button |
| BACK | Return to last menu |
| EXIT | Exit menu |
| MENU | Menu |
| INFO | Display information |
| FAV | Display favorites |
| VOLUP | Volume up |
| VOLDOWN | Volume down |
| MUTE | Mute speakers |
| CHUP | Channel up |
| CHDOWN | Channel down |
| PLAY | Play |
| PAUSE | Play |
| STOP | Stop playing |
| RECORD | Start recording |
| REWIND | Rewind |
| FORWARD | Forward |
| LASTCH | Last channel |
| NEXTCH | Next channel |
| LASTCHAP | Last chapter |
| NEXTCHAP | Next chapter |
| PAIR | Re-pair with the receiver |
In addition you could send any key code in the 0xHHHH format., refer to
[Key Codes for Magenta/Huawei Media Receiver](http://support.huawei.com/hedex/pages/DOC1100366313CEH0713H/01/DOC1100366313CEH0713H/01/resources/dsv_hdx_idp/DSV/en/en-us_topic_0094619112.html)
Text item=RB_GF_LR_TVReceiver_ProgTitle label="Sendung [%s]" icon="it_television"
Text item=RB_GF_LR_TVReceiver_ProgDescription label="Beschreibung [%s]" icon="it_television"
Text item=RB_GF_LR_TVReceiver_ProgStart label="Start [%1$td.%1$tm.%1$ty %1$tH:%1$tM]" icon="time_clock"
Text item=RB_GF_LR_TVReceiver_ProgDuration label="Dauer [%d min.]" icon="time_clock"
Text item=RB_GF_LR_TVReceiver_PlayPosition label="Position [%d min.]" icon="it_television"
Text item=RB_GF_LR_TVReceiver_PlayMode label="Mode [%s]" icon="it_television"
}
}
```
### magentatv.rules
Due to the fact the POWER is a toggle button and the binding cannot detect the current status, which could lead into the situation that you want to power on the receiver as part of a scene, but due to the fact that it is already ON you switch it off.
Beginning with models 401/201 and new the binding is able to detect the Power-OFF condition, which can be used in a rule to improve this situation
