Encoding of logo and ringtone messages

Modified on Thu, 12 Feb 2015 11:16 by henrik — Categorized as: XML API

Ringtones and logos are 8-bit binary data, and must be encoded as a hex-string before sending. The following describes briefly how to format the XML for logos and ringtones:

Ringtones¶

Set the following child-element to the element:

<OP>2</OP>

Let the text-element represent the ringtone encoded as a hex-string (not including the User Data Header, UDH). The following is a sample ringtone:

<TEXT>024A3A4954C80400B11E941A810824AB124D8924C495490
410210824D34841261A42092EC4954249B125E042092AD2042104
97624AA12552408420934D210498690824BA5255292A920C41A62
4BB1255092A920820421041C620E4084126189310210497624AC0
84124D892E84954800</TEXT>

Logos¶

Set the following child-element to the element: OperatorLogos:

<OP>3</OP>

Caller group graphics:

<OP>4</OP>

Let the text-element represent the logo encoded as a hex-string (not including the User Data Header, UDH). The following is a sample of an operatorlogo.

<TEXT>42F22000480E01000000000000000000000000000000000
00000006010000806000001C0707C003E0E038003E0734E0072CE
07C000E031DA005B8C070000207FBA005DFE040001FFC1EA00578
3FF801F0046BE007D6200F8000070DA005B0E0000000070F4002F
0E000000007078001E0E000000002000000004000000000000000
0000000</TEXT>

The first three bytes (6 hex-characters in the string above) are specifies the Operator Logo Header, which is the Mobile Country Code and Mobile Network Code with little endian BCD filled, with F16. That is, 42F2 hex = 244 decimal, which is Norway, and 20 hex = 02 decimal which is NetCom. The OTA bitmap data follows immediately after.

If sending a Caller-group graphic, the encoding will be the same as for an operatorlogo except that the first three bytes containing country and network code is not present.

Describing how to encode logos and ringtones into binary data is beyond the scope of this document. Please refer to the Smart Message Specifications from Nokia for more information.