view src/cs/services/lls/lls_api.h @ 221:5bf097aeaad7

LLS: when turning off all LEDs on boot, skip LED-C Having LLS turn off LED-A and LED-B on boot is normally unnecessary (they should already be off in Iota), but it is harmless, hence this logic is kept for robustness. However, having LLS read-modify-write the BCICTL2 register (to turn off LED-C) creates a potential race condition with FCHG writes to this register, especially in the case when baseband switch-on is caused by VCHG and charging is expected to start right away. Furthermore, control of the charging LED itself (on those hw targets that have it) is the responsibility of the FCHG SWE, hence LLS should leave it alone.
author Mychaela Falconia <falcon@freecalypso.org>
date Mon, 26 Apr 2021 21:55:13 +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_ */