Introduction

This document describes the VoIP settings configuration parameters used in Nokia Asha Java Voice over IP (VoIP) API v1.0.

The Nokia Asha Java VoIP API v1.0 VoIP settings configuration consists of the following setting groups:

  • VoIP profile settings

  • SIP (Session Initiation Protocol) profile settings

  • NAT/Firewall traversal settings

Relationships between these setting groups are shown below.

Figure: The relations between the VoIP settings

A VoIP Profile Settings:

  • has one or more speech codec settings.

  • has one SIP profile (Asha Java VoIP API v1.0 VoIP Settings supports the SIP protocol only).

The SIP profile:

  • has one or more Internet Access Points (IAP).

  • may have NAT/Firewall traversal settings that refer to the SIP domain and the defined IAPs.

Note:

The VoIP profile and its related SIP profile must refer to the same IAPs.

References between the setting groups are handled using the following parameters:

  • APPREF — The APPREF parameter uniquely names the APPLICATION characteristic, that is, the part of the provisioning message that provides the phone with a set of settings (parameters) in line with provisioning document standards. APPREF must be unique within its enclosed structure, that is, within the configuration context.

  • TO-APPREF — The TO-APPREF parameter links the APPLICATION characteristics to another secondary APPLICATION characteristic with a matching APPREF parameter.

  • NAPID — Network Access Point Identifier (a parameter of the NAPDEF characteristics). The NAPID must be unique within its enclosed structure, that is, within the configuration context.

  • TO-NAPID — This parameter refers to a IAP with a matching NAPID parameter.

These parameters are defined in the setting groups as follows. Example values are used to illustrate the linking in practice.