Click here for the API Reference documentation.

The Modem Call Control (mcc) API uses profiles. Calls can be initiated or received through these profiles. Each profile represents a call type or specific configuration of a given call (e.g., a profile can represent a given cellular modem/SIM combination - if the modem in question supports multiple SIM operation).

Using Profiles

A given Legato device can support multiple profiles, but usually, the MCC API will be configured with a single profile name that will initiate or receive calls.

Call le_mcc_profile_GetByName() to access a specific profile by name.

le_mcc_profile_GetState() API allows the application to get the current state of the profile.

le_mcc_profile_AddStateChangeHandler() API installs a handler function that is notified when the profile's state changes.

le_mcc_profile_RemoveStateChangeHandler() API uninstalls the handler function.

When the Profile object is no longer needed, call le_mcc_profile_Release() must be used to release the profile.

Here's a profile code sample:

void ManageMyProfile(void)
{
    [...]
    // Get the Modem profile working on SIM card #1
    le_mcc_profile_ObjRef_t myProfile = le_mcc_profile_GetByName("Modem-Sim1");
    // Create and start a call on that profile
    le_mcc_call_ObjRef_t myCall = le_mcc_profile_CreateCall(myProfile, "+18008800800");
    le_mcc_call_Start(myCall);
    [...]
    // Set the profile into 'Do Not Disturb' mode: it will disable it's ablity to accept incoming
    // calls.
    le_mcc_profile_SetDoNotDisturb(myProfile);
    [...]
    // Clear the 'Do Not Disturb' mode: the profile gets back to be able to accept incoming calls.
    le_mcc_profile_ClearDoNotDisturb(myProfile);
    [...]
    // Set the profile into 'call forward mode': all calls incoming to this profile will
    // automatically be forwarded to another telephone number.
    le_mcc_profile_SetForwarding(myProfile, "+18008910910");
    [...]
}

Copyright (C) Sierra Wireless, Inc. 2014. Use of this work is subject to license.