OS 6.52 Release note

Feature	Description
Get CPU clock API	A new ADL API is available, adl_vsGetClockMode, to get the current CPU frequency.
Heap status API	A new ADL API is available, adl_memStat to retrieve current Heap memory consumption of the Open AT application.
File System full support	File System can be used to manage firmware and application upgrade through DOTA 1 & 2. A&D API set area remains available for compatibility purpose, but not recommended for new design.
Remote Debugging	Ability to securely connect to an AirPrime module to manage a trace session in order to remotely analyze the traces.
OpenSSL Certificates & Keys in File System	Ability to store Certificates and SSL keys in hidden file system folder. This feature is available in Beta stage

2. Abbreviations and Definitions

Table 2. Abbreviations and Definitions

Abbreviation/Acronym	Definitions
ADL	Application Development Layer
API	Application Programming Interface
APN	Access Point Name
CID	Context Identifier
Data Call	GSM Circuit Switched Data Call
EF	Elementary File
EXTINT	External Interruption
GPRS	General Packet Radio Service
GSM	Global System for Mobile communications
OS	Operating System
PDP	Packet Data Protocol
PLMN	Public Lands Mobile Network
SIM	Subscriber Identity Module

3. Related Documentation

Table 3. Related Documentation

Ref. #	Doc. #	Document title
[1]	4111843	AT Commands Interface Guide for Firmware 7.52 (Rev 6.0)
[2]	4111844	ADL User Guide for Open AT Application Framework OS 6.52 (Rev 6.0)
[3]	4111963	Product Technical Specification & Customer Design Guidelines - AirPrime Q2686 Refreshed (Rev 10.0)
[4]	4111964	Product Technical Specification & Customer Design Guidelines - AirPrime Q2687 Refreshed (Rev 12.0)
[5]	4111952	Product Technical Specification & Customer Design Guidelines - AirPrime SL6087 (Rev 10.0)
[6]	4111992	Product Technical Specification & Customer Design Guidelines - AirPrime SL808x, SL808xT, SL808xBT (Rev 8.3)
[7]	4114417	Customer Release Notes – Firmware 7.52

4. Compatibility

Table 4. Hardware Compatibility

AirPrime Compatibility List
AirPrime SL8080T, SL8082T, SL8082BT, SL8084T
AirPrime Q2686 Refreshed / AirPrime Q2687 Refreshed
AirPrime SL6087
AirLink Fastrack Xtend EDGE (FXT009)

Table 5. Software Compatibility

Component	Version
Open AT Firmware	7.52.0.201306260837 or 7.52.0.201404040850
Open AT Application Framework	2.52.0.201405121558

5. Software Release Description

5.1. Release Identification

Table 6. Open AT OS Release Information

Component	Revision
Software Identification	6.52.0.201306271400 or 6.52.0.201402271535
Date of generation of library	2013-04-23

Note: RVDS_ADL.lib is identical in both OS 6.52.0.201306271400 & OS 6.52.0.201402271535. The differences are limited to update in samples and documentation.

5.2. Software Tools Versions

Table 7. Software Tools Versions

S/W Tools Name	Version
Developer Studio	3.0
Compilation Tool Chain	ARM_EABI_GCC and RVDS

6. Software Changes Description

6.1. Validated Corrections/Improvements

This section presents all corrections or improvements integrated in OS 6.52.

Issues are sorted by alphabetical order of Impacted Domain.

Table 8. Validated Corrections/Improvements

ID	Description	Impacted Domain	Impacted Sub-Domain	Fixed in
67192	When AT+WRIM command is executed to set bit 16 of <events_bit_field>, the Ring Indicator pulse is sent for all the unsolicited responses instead of the unsolicited response initiated by an application.	AT	OTHER	6.52
65458	Spurious ADL_CALL_EVENT_NO_CARRIER events received on initiating a call, when AT+WBHV=2,1 has been executed and the call handler subscribed for call service has returned value equal to “ADL_CALL_NO_FORWARD_ATA”.	GSM	OTHER	6.52
62565	When an application subscribes to call service and initiates a voice call, then two ADL_CALL_EVENT_NO_CARRIER events are received on disconnecting the call from remote/receiver side.	GSM	OTHER	6.52
57032	If a command with type ADL_CMD_TYPE_PARA is subscribed by using the adl_atCmdSubscribe() API, the handler provided is also called while issuing the test command i.e. "AT+<xxxx>=?". Command handler should be called after confirming that '?' is not given after '='.	OTHER	OTHER	6.52
58257	AirPrime may reset if parameter "rsphdl" for function adl_atCmdCreate() is set to NULL and the list of subscribed responses is not equal to NULL.	AT	OTHER	6.51
60319	When the Network forces ME to change GPRS mobile class to CC, ADL_GPRS_EVENT_NW_CLASS_CC event is not received.	GPRS	OTHER	6.51
62061	Incorrect CID value (5) is returned by the GPRS event handler, on trying to activate PDP context on correct CID value (1-4), when an application which subscribes to GPRS service is downloaded onto the module.	GPRS	OTHER	6.51
59812	AT+WIND=0 does not disable +WIND: 9 indications if an application is running on the AirPrime.	GSM	OTHER	6.51
61292	When a GSM Data call is established using an application which has subscribed to Call Service, then on terminating the data call from remote, "ADL_CALL_EVENT_NO_CARRIER" event is received twice.	GSM	OTHER	6.51
61014	When an application is running and a concatenated command including “+CPIN2?” is issued, response is not received for commands following “+CPIN2?” in concatenated command string. In addition to this, the command class remains locked. As a result of this +CME ERROR: 515 is received for further AT commands.	OTHER	OTHER	6.51
62464	AirPrime is not able to go to sleep mode after some time if AirPrime switches between sleep mode and active mode continuously when a location application is running on the AirPrime.	OTHER	OTHER	6.51
62669	Subscription to Slave flow at a specific UART using ADL FCM service fails, if FCM flow is already subscribed in Master mode on the same UART.	OTHER	OTHER	6.51
62674	AirPrime does not resume the data transfer when a single credit is released using adl_fcmReleaseCredits() API after consuming all the available credits.	OTHER	OTHER	6.51
60299	Function adl_simEnterPIN() accepts the PIN code for the third time even if wrong PIN has already been entered twice. Ideally, ADL_RET_ERR_BAD_STATE should be received in this case.	SIM	OTHER	6.51

6.2. Interface Changes

Table 9. Interface Changes

Command	Comment
wm_l3info_Gprs_Mobile_Allocation_t	A new structure to store the GPRS Mobile Allocation Information.
wm_l3info_Cell_SyncCellInfo_t	A new field, GprsMobileAllocation of type wm_l3info_Gprs_Mobile_Allocation_t, is added to this structure. This field stored the GPRS Mobile Allocation information (Arfcn list) of the serving cell.
adl_vsGetClockMode	New API to indicate the CPU clock speed (between 26Mhz and 104Mhz) of boost mode.
adl_memStat	New API that gives, at run time, the dynamic status of the heap memory (RAM) reserved for Application.
adl_fsLock	New File system API to lock the access to the given directory (and everything it contains).
adl_fsUnlock	New File system API to unlock the access to the given directory (and everything it contains).
adl_fsChangePassword	New File system API to change the password of a given path.
adl_remotedebugSubscribe adl_remotedebugUnsubscribe adl_remdebugActivationSet adl_remdebugActivationGet	New API for Remote Debugging Services.
adl_audiogainfixedSubscribe adl_audiogainfixedUnsubscribe	New API to subscribe to the fixed gain audio service and specify the gain to use.
adl_InitApplicationInterruptPrio	The adl_InitApplicationInterruptPrio ADL table is no more supported by the OS.

7. Troubleshooting

Please refer to the Troubleshooting Guide available in Developer Zone before contacting customer support.

8. Restrictions and Additional Information

This section presents additional information or restrictions that must be taken into account regarding OS 6.52. Issues are sorted by alphabetical order of Impacted Domain

Table 10. Restrictions and Additional Information

Issue ID	Description (What/When)	Impacted Domain	Impacted Sub-Domain
66697	Random value of "Context" is received incase API adl_atCmdSendText() is used after API adl_atCmdSendExt().	AT	OTHER
41819	When FCM service is running with call and/or SIM services, commands ATA, ATD, ATH, AT+CGANS, AT+CGACT, AT+CGDATA, ATO and AT+CPIN cannot be filtered using the API adl_atCmdSubscribe().	AT	OTHER
56598	On issuing a pre subscribed command from an application, through the 'adl_atCmdSendExt()' API, an OK and ERROR is received alternatively, i.e. the command is sent to the command handler and the firmware alternatively. Ideally, the command should always be sent to the command handler and OK should be received.	OTHER	OTHER
66337	Error is not returned in case an attempt is made to play or listen an audio stream which is not supported by AirPrime.	OTHER	OTHER
66654	Error is returned and command handler is not invoked for any custom command when command is sent using the API adl_atCmdSendExt().	OTHER	OTHER
41818	Subscription to commands beginning with "ATA", "ATD" or "ATH" using the API adl_atCmdSubscribe () fails in case Call service is subscribed prior to subscribing to the commands from the application.	OTHER	OTHER
53324	When Using %I64 format specifier for displaying u64/s64 variable through API adl_atSendresponse() in TARGET mode it always prints only "%I64d" instead of the value of the variable. Workaround: use %lld instead of %I64.	OTHER	OTHER
53517	Sometimes handler associated with adl_errSubscribe() function is not invoked on reception of error from OS.	RTK	OTHER

Comment

Forum

Related items

ADL User Guide for Open AT Application Framework OS 6.52
The purpose of this document is to provide Sierra Wireless customers with a full description of the APIs associated with the OS 6.52.
Open AT Application Framework
The Open AT Application Framework is a complete software package for embedded M2M application development. It offers a range of readily available building blocks which accelerate the application development process, allowing you to bring connected products to market faster and reduce development costs.

1.1. Document Scope

1.2. Document Audience

3. Related Documentation

5.1. Release Identification

Tags

Related items