view src/aci2/aci/ati_cmd.h @ 662:8cd8fd15a095

SIM speed enhancement re-enabled and made configurable TI's original code supported SIM speed enhancement, but Openmoko had it disabled, and OM's disabling of speed enhancement somehow caused certain SIM cards to start working which didn't work before (OM's bug #666). Because our FC community is much smaller in year 2020 than OM's community was in their day, we are not able to find one of those #666-affected SIMs, thus the real issue they had encountered remains elusive. Thus our solution is to re-enable SIM speed enhancement and simply wait for if and when someone runs into a #666-affected SIM once again. We provide a SIM_allow_speed_enhancement global variable that allows SIM speed enhancement to be enabled or disabled per session, and an /etc/SIM_spenh file in FFS that allows it to enabled or disabled on a non-volatile basis. SIM speed enhancement is now enabled by default.
author Mychaela Falconia <falcon@freecalypso.org>
date Sun, 24 May 2020 05:02:28 +0000
parents 93999a60b835
children
line wrap: on
line source

/* 
+----------------------------------------------------------------------------- 
|  Project :  
|  Modul   :  J:\g23m-aci\aci\ati_cmd.h
+----------------------------------------------------------------------------- 
|  Copyright 2002 Texas Instruments Berlin, AG 
|                 All rights reserved. 
| 
|                 This file is confidential and a trade secret of Texas 
|                 Instruments Berlin, AG 
|                 The receipt of or possession of this file does not convey 
|                 any rights to reproduce or disclose its contents or to 
|                 manufacture, use, or sell anything it may describe, in 
|                 whole, or in part, without the specific written consent of 
|                 Texas Instruments Berlin, AG. 
+----------------------------------------------------------------------------- 
|  Purpose :  
+----------------------------------------------------------------------------- 
*/ 
#ifndef ATI_CMD_H
#define ATI_CMD_H

/* copied from uart.h... should always be the same as there */
#ifdef FF_MULTI_PORT
#define UART_INSTANCES     FF_MULTI_PORT
#else /* FF_MULTI_PORT */
#ifdef FF_TWO_UART_PORTS
#define UART_INSTANCES                 2
#ifdef _SIMULATION_
# define UART_DATA_CHANNEL              3
#else
# define UART_DATA_CHANNEL              4
#endif
#else /* FF_TWO_UART_PORTS */
#define UART_INSTANCES                 1
#endif /* FF_TWO_UART_PORTS */
#endif /* FF_MULTI_PORT */

/*
 * SKA 2002-09-05 
 * when compiling for WIN32 allow ToDo message
 * e.g.: #pragma message( __TODO__"verbose message for engineering mode" )
 * appears during compiling as
 * Z:\g23m\condat\MS\SRC\ACI\ati_cmd.c(2560) : ToDo : verbose message for engineering mode
 */
#ifdef _SIMULATION_
#define __STR2__(x) #x
#define __STR1__(x) __STR2__(x)
#define __TODO__ __FILE__ "("__STR1__(__LINE__)") : ToDo : "
#else
#define __TODO__
#endif


typedef enum
{
    ATI_SRC_TYPE_UNKNOWN    = -1,
    ATI_SRC_TYPE_UART,
    ATI_SRC_TYPE_BLUETOOTH,
    ATI_SRC_TYPE_SAT,
    ATI_SRC_TYPE_IRDA,
    ATI_SRC_TYPE_LC,
    ATI_SRC_TYPE_TST,
    ATI_SRC_TYPE_RIV,
    ATI_SRC_TYPE_PSI
} T_ATI_SRC_TYPE;

typedef enum
{
  ATI_FAIL,
  ATI_FAIL_NO_OUTPUT,
  ATI_BUSY,
  ATI_EXCT,
  ATI_CMPL,
  ATI_CMPL_NO_OUTPUT
} T_ATI_RSLT;

#define ATI_OUTPUT_BASIC_FORMAT_START     1    /* BIT  3 - 0 */
#define ATI_OUTPUT_BASIC_TYPE_START       8    /* BIT  7 - 4 */
#define ATI_OUTPUT_ATTRIB_START         256    /* BIT 11 - 8 */
#define ATI_OUTPUT_RESPONSE_TYPES    0x1000    /* BIT 12, 13 */


typedef enum
{
  ATI_BEGIN_CRLF_OUTPUT = (1 * ATI_OUTPUT_BASIC_FORMAT_START),
  ATI_END_CRLF_OUTPUT   = (2 * ATI_OUTPUT_BASIC_FORMAT_START),
  
  ATI_ECHO_OUTPUT       = (1 * ATI_OUTPUT_BASIC_TYPE_START), /* string without CR,LF              */
  ATI_NORMAL_OUTPUT     = (2 * ATI_OUTPUT_BASIC_TYPE_START), /* string ends with CR,LF            */
  ATI_CONFIRM_OUTPUT    = (4 * ATI_OUTPUT_BASIC_TYPE_START), /* string starts and ends with CR,LF */
  ATI_INDICATION_OUTPUT = (8 * ATI_OUTPUT_BASIC_TYPE_START), /* string ends with CR,LF            */

  ATI_FORCED_OUTPUT     = (1 * ATI_OUTPUT_ATTRIB_START), 
  ATI_ERROR_OUTPUT      = (2 * ATI_OUTPUT_ATTRIB_START),
  ATI_CONNECT_OUTPUT    = (4 * ATI_OUTPUT_ATTRIB_START),  /* buffer indications until back in CMD mode */

  /* the v25ter defines two types of responses */
  ATI_INFORMATION_TEXT_OUTPUT = (1 * ATI_OUTPUT_RESPONSE_TYPES),
  ATI_RESULT_CODE_OUTPUT      = (2 * ATI_OUTPUT_RESPONSE_TYPES)
} T_ATI_OUTPUT_TYPE;


/* send ATI output immediatly */
#define ATI_OUTPUT_TYPE_NORMAL  0 
/* buffer ATI output and send when confirm output received */
#define ATI_OUTPUT_TYPE_LARGE   1 

typedef enum
{
  ATI_LINE_STATE_UNKNOWN  = -1,
  ATI_LINE_STATE_DCD,
  ATI_LINE_STATE_RNG,
  ATI_LINE_STATE_OUTPUT_TYPE,    /* indication for output see above */
  ATI_LINE_STATE_START,
  ATI_LINE_STATE_END

} T_ATI_LINE_STATE_TYPE;


typedef enum
{
  ATI_UNKN_MODE = -1,
  ATI_CMD_MODE,
  ATI_DATA_MODE
} T_ATI_IO_MODE;

typedef enum
{
  CMD_IDLE  = 0,
  CMD_TYPING,
  CMD_RUNNING
} T_ATI_CMD_STATE;

typedef enum
{
  NO_BUFF  = 0,
  BUFF_TYPING,
  BUFF_RUNNING
} T_ATI_BUFF_UNS_MODE;
	
typedef struct
{
  CHAR              *output;
  T_ATI_OUTPUT_TYPE output_type;
} T_ATI_INDIC_BUFF;


typedef enum
{
  CMD_MODE = 0,
  TXT_MODE
} T_TEXT_MODE;

typedef struct
{
  char *key;                                    /* command key */
  T_ATI_RSLT (*fnc)     (char *, UBYTE srcId);  /* basic command handler */
  char *and_key;                                /* AND command key */
  T_ATI_RSLT (*and_fnc) ( char *, UBYTE srcId); /* and command handler */
} ATCommand_bas;

typedef struct
{
  CHAR *key;                       /* command key                    */
  T_ACI_AT_CMD binKey;             /* binary presentation of the cmd */
  T_ATI_RSLT (*sfnc) (char *, UBYTE srcId); /* set command handler   */
  T_ATI_RSLT (*tfnc) (char *, UBYTE srcId); /* test command handler  */
  T_ATI_RSLT (*qfnc) (char *, UBYTE srcId); /* query command handler */
  CHAR *output1;
} ATCommand;


typedef void T_ATI_RESULT_CB (UBYTE             src_id,
                              T_ATI_OUTPUT_TYPE	output_type,
                              UBYTE             *output,
                              USHORT            output_len);

typedef void T_ATI_LINE_STATE_CB (UBYTE                 src_id,
                                  T_ATI_LINE_STATE_TYPE	line_state_type,
                                  ULONG                 line_state_param);

typedef struct
{
  T_ATI_IO_MODE        mode;
  UBYTE                src_id;
  T_ATI_SRC_TYPE       src_type;
  T_ATI_RESULT_CB     *result_cb;
  T_ATI_LINE_STATE_CB *line_state_cb;
  T_ATI_CMD_STATE      cmd_state;
  T_ATI_BUFF_UNS_MODE  buff_uns_mode;
  void                *indication_buffer;
  T_TEXT_MODE          text_mode;
  T_ACI_AT_CMD         curAtCmd;
} T_ATI_SRC_PARAMS;

typedef enum
{
  ATI_EXT_PART_UNKNOWN = -1,
  ATI_EXT_PART_BEGIN,		/* beginning part of a complete line		*/
  ATI_EXT_PART_LINE,		    /* a middle part from a complete line		*/
  ATI_EXT_PART_LAST,		    /* the last part from a complete line	*/
  ATI_EXT_CMPL_LINE			 /* a complete line			*/
} T_ATI_EXT_FORMAT;

EXTERN BOOL search_ati_src_id (UBYTE src_id, void *elem);
EXTERN void init_ati (void);
EXTERN BOOL ati_is_src_type( UBYTE srcId, T_ATI_SRC_TYPE source_type );
/*
 *
 * AT-Command interpreter interface functions
 *
 */

EXTERN UBYTE ati_init (T_ATI_SRC_TYPE         src_type,
                       T_ATI_RESULT_CB			  *result_cb,
                       T_ATI_LINE_STATE_CB    *line_state_cb);

EXTERN void ati_finit (UBYTE src_id);

EXTERN T_ATI_RSLT ati_execute (UBYTE src_id, UBYTE *chars, USHORT len);

EXTERN BOOL ati_execute_config_cmd (UBYTE *chars, USHORT len);

EXTERN BOOL ati_abort (UBYTE src_id);

EXTERN T_ATI_RSLT map_aci_2_ati_rslt (T_ACI_RETURN rslt);
EXTERN void trace_run_cmd_line (char *prefix, UBYTE src_id, char *cmd_name, char *cmd_params);

EXTERN T_ACI_AT_CMD get_command_id (CHAR *command_str);
EXTERN T_ATI_RSLT sEXT_Output (UBYTE	src_id, T_ATI_EXT_FORMAT output_format,	CHAR	*output);
EXTERN T_ATI_RSLT sEXT_Indication (UBYTE src_id, CHAR *indication_string);
EXTERN T_ATI_RSLT sEXT_Error	(UBYTE src_id, T_ACI_CME_ERR err);
EXTERN T_ATI_RSLT sEXT_Confirm (UBYTE src_id);
EXTERN T_ATI_RSLT sEXT_Init (CHAR *cmd_list[]);
EXTERN T_ATI_RSLT sEXT_Finit ();



#if defined (SMS_PDU_SUPPORT)
EXTERN T_ATI_RSLT   atPlusCMGSPdu ( char            * cl, UBYTE srcId);
EXTERN T_ATI_RSLT   atPlusCMGWPdu ( char            * cl, UBYTE srcId);
EXTERN T_ATI_RSLT   atPlusCMGCPdu ( char            * cl, UBYTE srcId);
EXTERN T_ATI_RSLT   atPlusCNMAPdu ( char            * cl, UBYTE srcId);
#endif
#endif /* ATI_CMD_H */