EMU keys editor. ---------------- The newly developed EMU keys keeping format allowed to compile an external editor for MEDIABOX's EMU keys. The program enables editing of providers, their attributes (address data for EMM filtering, provider's name, flags which can be used for any additional further functionality by firmware developers), as well as data used to decrypt ECM/EMM (keys). In addition, the program allows to import providers and keys from the previous (i.e. with old layout) EMU format, and Softcam.key files respectively. 1. Terms. 4 identities are currently used in the new keeping format, namely: - Conditional Access Systems (CA system identities, CA IDs); - providers' idents (service operator identities, SOIDs); - providers' attributes (names, UA/Serial, PPUA/SA data, additional processing flags); - finally, the keys. Conditional Access Systems and their corresponding CA IDs are defined in emuedit.ini file. You can add ANY CAS of your own, but please DO NOT CHANGE the ones already existing in the given file to avoid wrong functionality of the proggie. For any CA ID it can be defined as much as 255 SOIDs, and any SOID may have any length from 1 to 255 bytes. For any SOID one can define as much as 255 keys, their length being from 1 to 255 bytes. Every key is defined by its index (any value from 0x00 until 0xfe). Provider's attributes: - NAME: any text; - UA/Serial, PPUA/SA data: this depends on CAS,thus their length is not restricted in the proggie; - FLAGS: 1-bit values 0/1 which may be used by the developers to automaticly choose the ECM PID, Card Sharing and similar. Any work dealing with entering and editing of data is carried out with the built-in internal EMU buffer of the proggie, and on its closing the buffer should be saved as a file to avoid the loss of already changed values. 2. Data Entering. Right after the proggie was started the EMU buffer is empty, the data to fill it in can be entered in 3 ways: - manually; - by loading of EMU file keys; - by importing of old layout EMU file and Softcam.key. Upon loading data from EMU file key the EMU buffer will be totally rewritten, in other cases the new data are added to already entered ones as an update (i.e, if the key already exists its value will be substituted by a new one). 2.1. Data Manual Entering. PLZ select the CAS from the drop-down menu of CA System at the top of the proggie. Select the list 'Idents', press Add Ident and enter the provider's SOID value in the window you see. If necessary, enter provider's attributes (UA/Serial, PPUA/SA - HEX values only with NO SPACES, Name - any combination of letters and figures with/without spaces), and mark the necesary FLAGS. To enter the keys PLZ mark the necessary SOID of the corresponding provider and now PLZ proceed onto Keys page. Press Add Key, in the appeared window PLZ enter the Key Index and its value. To be sure all was done correctly, you can launch the self-control function by entering the key's length in the Length field (HEX format). In this case the proggie will check if the entered key length corresponds to the value declared in Length field, and if a mistake was made the key would not be saved. If you leave the field Length blank, then the key will be saved exactly as it was entered. 2.2. Loading From File. PLZ press Open EMU in the lower part of the proggie, or choose File/Open in its upper part. Open EMU Keys file (or settings dump you've earlier downloaded from your receiver to PC) and press OK. WARNING!!!!!! All data that were entered BEFORE the file was loaded will be LOST!PLZ BE ATTENTIVE!! 2.3. Imporing of Old Layout Settings. PLZ make sure you had created the settings backup dump of your tuner _BEFORE_ you downloaded the new firmware supporting new EMU keys format! The dump you can perform by using of Pionero, Mediacom, MediasatConnect and other similar programs. PLZ refer to the instruction manual of the program you use to save your settings onto a computer. PLZ select Import/Old EMU option at the top of the proggie, then choose the your file with settings (your dump), press OK. In the appeared 'Folders found' window mark sections EMU and RSA (in case the latter is there), press OK. All idents and keys for SECA, VIACCESS, NAGRA1 will be imported. If the dump was done from the receiver with OFM firmware, there additionally will be imported all data for NAGRA2 and CRYPTOWORKS systems. All the rest data WILL NOT be imported because of the discrepansies in format of keeping keys in different softwares. 2.4 Importing from a Softcam.key. Because of differences of keys indexes used in Softcam.key file and in MEDIABOX emulator for NAGRA � CRYPTOWORKS, it's absolutely necessary to correctly prepare the key_id.ini file, in accordance with which the conversion of keys will be conducted while importing. For instance, ---------------------- [N] M1=16 M2=11 00=06 01=46 ... meaning that key M1 for NAGRA will be imported as key 16, key M2 - as key 11, and so on. [W] 00=00 01=01 06=02 ... meaning that key 00 for CRYPTOWORKS will be imported as key 00, key 06 - as key 02, and so on. ------------------- If the program fails to find the corresponding Key Index in key_id.ini, then it won't import the given entry from Softcam.key file. PLZ select Import/Softcam.key at the top of the proggie, choose Softcam.key file, press OK, in the appeared list of keys PLZ mark only those entries you want to import. After pressing OK all marked entries will be added to EMU buffer. 3. Data Edition. To edit data you need: - to choose the necessary CAS from the drop-down list of CA System in the upper part of the proggie; - to mark the SOID of the corresponding provider in Idents list. 3.1. Working with Providers. In the bottom part of the proggie (subpage IDENTS) there are so-called Quick Buttons, allowing to create any new SOID, to change any existing SOID, to save provider's attributes after editing,to delete a provider, its attributes and keys. Upon pointing the mouse cursor on a button icon a corresponding hint will appear (Add Ident, Change Ident, Save Ident, Delete Ident). To edit provider's attributes all you need is to enter new data into corresponding fields and to set up the desired flags. In case of need you can also change provider's SOID by pressing the button Change Ident. After making changes PLZ save them simply by pressing Save Ident button. Delete Ident will remove provider, its attributes and keys from EMU buffer. 3.2. Working with Keys. In the bottom part of the proggie (subpage Keys) you'll find Quick Buttons, allowing to create new keys, change the existing ones, or delete keys. Upon pointing the mouse cursor on a button icon a corresponding hint will appear (Add Key, Edit Key, Delete Key). Adding of new keys is described above (position 2.1.), editing of existing keys is carried out the same way: -mark the necessary key in the list, press Edit Key, in the appeared window change Key Value, and finally press Save Key. N.B: if during a key edition its index was changed, the old key will remain the same, and a new key with a new index will be added to key list of the chosen provider. 4. Key Update in the Receiver. After finishing your work with EMU keys PLZ press Save EMU at the bottom of the proggie, then choose the name for the file you want to save into EMU buffer or leave its name as it is. The data are saved in format which is compatible with MEDIABOX setting files. The resulting file will have 2 MHW files inside: EMU & RSA. This file can be uploaded to a receiver through RS-232 port (COM-port) with the help of Mediacom, MediasatConnect and others upon choosing mode Settings. Do not forget to mark BOTH EMU & RSA sections. (c) d-mon (aka deemonru), 2007 =============================== English translation by YARO 07.03.2007-20.59 local time ===============================
lestan