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)

  • INVALIDStyle -
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 -
  • Note_INVALID -
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 -
  • Duration_INVALID -
GSM_RingNoteDurationSpec enum

Values:

  • NoSpecialDuration = = 0x00 << 6 -
  • DottedNote = = 0x01 << 6 -
  • DoubleDottedNote = = 0x02 << 6 -
  • Length_2_3 = = 0x03 << 6 -
  • DurationSpec_INVALID -
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
GSM_RingCommandType enum

Values:

  • RING_Note = = 1 -
  • RING_EnableVibra -
  • RING_DisableVibra -
  • RING_EnableLight -
  • RING_DisableLight -
  • RING_EnableLED -
  • RING_DisableLED -
  • RING_Repeat -
struct GSM_RingCommand
struct GSM_NoteRingtone
struct GSM_NokiaBinaryRingtone
struct GSM_BinaryTone
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_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

struct GSM_AllRingtonesInfo