view src/cs/services/lls/lls_api.h @ 303:f76436d19a7a default tip

!GPRS config: fix long-standing AT+COPS chance hanging bug There has been a long-standing bug in FreeCalypso going back years: sometimes in the AT command bring-up sequence of an ACI-only MS, the AT+COPS command would produce only a power scan followed by cessation of protocol stack activity (only L1 ADC traces), instead of the expected network search sequence. This behaviour was seen in different FC firmware versions going back to Citrine, and seemed to follow some law of chance, not reliably repeatable. This bug has been tracked down and found to be specific to !GPRS configuration, stemming from our TCS2/TCS3 hybrid and reconstruction of !GPRS support that was bitrotten in TCS3.2/LoCosto version. ACI module psa_mms.c, needed only for !GPRS, was missing in the TCS3 version and had to be pulled from TCS2 - but as it turns out, there is a new field in the MMR_REG_REQ primitive that needs to be set correctly, and that psa_mms.c module is the place where this initialization needed to be added.
author Mychaela Falconia <falcon@freecalypso.org>
date Thu, 08 Jun 2023 08:23:37 +0000
parents 4e78acac3d88
children
line wrap: on
line source

/**
 * @file   lls_api.h
 *
 * API Definition for LLS (Low Level Servies) Service.
 *
 * This file gathers all the constants, structure and functions declaration
 * useful for a LLS service user.
 *
 * @author   Laurent Sollier (l-sollier@ti.com)
 * @version 0.1
 */

/*
 * History:
 *
 *   Date          Author       Modification
 *  ----------------------------------------
 *  03/12/2002     L Sollier    Create
 *
 *
 * (C) Copyright 2002 by Texas Instruments Incorporated, All Rights Reserved
 */

#ifndef _LLS_API_H_
#define _LLS_API_H_


#include "rv/rv_general.h"

/**
 * @name External types
 *
 * Types used in API.
 *
 */
/*@{*/

/** Definition of available equipment, ... for D-Sample
 */
#define LLS_LED_A         0x01
#define LLS_BACKLIGHT     0x02
#define LLS_PRECHARGE_LED 0x03

/*@}*/

typedef UINT8 T_LLS_EQUIPMENT;

/**
 * @name API functions
 *
 * API functions declarations.
 */
/*@{*/

/**
 * function: lls_switch_on
 *
 * This function switch on an equipment.
 *
 * @param   equipment_sort    equipment sort.
 * @return
 *    - RV_OK if operation is successful,
 *    - RV_INVALID_PARAMETER if one parameter is incorrect,
 *    - RV_NOT_SUPPORTED 
 *
 */
T_RV_RET lls_switch_on(T_LLS_EQUIPMENT equipment_sort);


/**
 * function: lls_switch_off
 *
 * This function switch off an equipment.
 *
 * @param   equipment_sort    equipment sort.
 * @return
 *    - RV_OK if operation is successful,
 *    - RV_INVALID_PARAMETER if one parameter is incorrect,
 *    - RV_NOT_SUPPORTED 
 *
 */
T_RV_RET lls_switch_off(T_LLS_EQUIPMENT equipment_sort);


/*@}*/




#endif /* #ifndef _LLS_API_H_ */