Ringtone

GSM_Error PHONE_RTTLPlayOneNote(GSM_StateMachine * s, GSM_RingNote note, gboolean first)

Play one note using state machine interface.

GSM_Error PHONE_Beep(GSM_StateMachine * s)

Makes phone beek using state machine interface.

GSM_Error GSM_GetRingtone(GSM_StateMachine * s, GSM_Ringtone * Ringtone, gboolean PhoneRingtone)

Gets ringtone from phone.

GSM_Error GSM_SetRingtone(GSM_StateMachine * s, GSM_Ringtone * Ringtone, int * maxlength)

Sets ringtone in phone.

GSM_Error GSM_GetRingtonesInfo(GSM_StateMachine * s, GSM_AllRingtonesInfo * Info)

Acquires ringtone informaiton.

GSM_Error GSM_DeleteUserRingtones(GSM_StateMachine * s)

Deletes user defined ringtones from phone.

GSM_Error GSM_PlayTone(GSM_StateMachine * s, int Herz, unsigned char Volume, gboolean start)

Plays tone.

GSM_Error GSM_RingtoneConvert(GSM_Ringtone * dest, GSM_Ringtone * src, GSM_RingtoneFormat Format)

GSM_Error GSM_ReadRingtoneFile(char * FileName, GSM_Ringtone * ringtone)

GSM_Error GSM_SaveRingtoneFile(char * FileName, GSM_Ringtone * ringtone)

GSM_Error GSM_SaveRingtoneOtt(FILE * file, GSM_Ringtone * ringtone)

GSM_Error GSM_SaveRingtoneMidi(FILE * file, GSM_Ringtone * ringtone)

GSM_Error GSM_SaveRingtoneIMelody(FILE * file, GSM_Ringtone * ringtone)

GSM_Error GSM_SaveRingtoneWav(FILE * file, GSM_Ringtone * ringtone)

GSM_Error GSM_SaveRingtoneRttl(FILE * file, GSM_Ringtone * ringtone)

const unsigned char * GSM_GetRingtoneName(const GSM_AllRingtonesInfo * Info, const int ID)

Returns ringtone name, NULL if not found.

int GSM_RTTLGetTempo(int Beats)

GSM_RingNoteStyle enum

Values:

• NaturalStyle = 0x00 << 6 -

  Natural style (rest between notes)

• ContinuousStyle = 0x01 << 6 -

  Continuous style (no rest between notes)

• StaccatoStyle = 0x02 << 6 -

  Staccato style (shorter notes and longer rest period)

GSM_RingNoteNote enum

Values:

• Note_Pause = 0x00 << 4 -
• Note_C = 0x01 << 4 -
• Note_Cis = 0x02 << 4 -
• Note_D = 0x03 << 4 -
• Note_Dis = 0x04 << 4 -
• Note_E = 0x05 << 4 -
• Note_F = 0x06 << 4 -
• Note_Fis = 0x07 << 4 -
• Note_G = 0x08 << 4 -
• Note_Gis = 0x09 << 4 -
• Note_A = 0x0a << 4 -
• Note_Ais = 0x0b << 4 -
• Note_H = 0x0c << 4 -

GSM_RingNoteDuration enum

Values:

• Duration_Full = 0x00 << 5 -
• Duration_1_2 = 0x01 << 5 -
• Duration_1_4 = 0x02 << 5 -
• Duration_1_8 = 0x03 << 5 -
• Duration_1_16 = 0x04 << 5 -
• Duration_1_32 = 0x05 << 5 -

GSM_RingNoteDurationSpec enum

Values:

• NoSpecialDuration = 0x00 << 6 -
• DottedNote = 0x01 << 6 -
• DoubleDottedNote = 0x02 << 6 -
• Length_2_3 = 0x03 << 6 -

GSM_RingNoteScale enum

Values:

• Scale_55 = 1 -

  55 Hz for note A

• Scale_110 -

  110 Hz for note A

• Scale_220 -
• Scale_440 -

  first scale for Nokia

• Scale_880 -
• Scale_1760 -
• Scale_3520 -

  last scale for Nokia

• Scale_7040 -
• Scale_14080 -

struct GSM_RingNote

Public Members

GSM_RingNoteDuration Duration

GSM_RingNoteDurationSpec DurationSpec

GSM_RingNoteNote Note

GSM_RingNoteStyle Style

GSM_RingNoteScale Scale

int Tempo

GSM_RingCommandType enum

Values:

• RING_Note = 1 -
• RING_EnableVibra -
• RING_DisableVibra -
• RING_EnableLight -
• RING_DisableLight -
• RING_EnableLED -
• RING_DisableLED -
• RING_Repeat -

struct GSM_RingCommand

Public Members

GSM_RingCommandType Type

GSM_RingNote Note

unsigned char Value

struct GSM_NoteRingtone

Public Members

int NrCommands

gboolean AllNotesScale

GSM_RingCommand Commands[GSM_MAX_RINGTONE_NOTES]

struct GSM_NokiaBinaryRingtone

Public Members

unsigned char Frame[50000]

size_t Length

struct GSM_BinaryTone

Public Members

unsigned char * Buffer

size_t Length

GSM_RingtoneFormat enum

Values:

• RING_NOTETONE = 1 -
• RING_NOKIABINARY -
• RING_MIDI -
• RING_MMF -

struct GSM_Ringtone

Structure for saving various ringtones formats

Public Members

GSM_NokiaBinaryRingtone NokiaBinary

Ringtone saved in one of three formats

GSM_BinaryTone BinaryTone

GSM_NoteRingtone NoteTone

GSM_RingtoneFormat Format

Ringtone format

unsigned char Name[(GSM_MAX_RINGTONE_NAME_LENGTH+1)*2]

Ringtone name

int Location

Ringtone location

struct GSM_RingtoneInfo

Public Members

int Group

Nokia specific

int ID

unsigned char Name[30 *2]

struct GSM_AllRingtonesInfo

Public Members

int Number

GSM_RingtoneInfo * Ringtone