diff src/cs/drivers/drv_app/uart/serialswitch.c @ 0:b6a5e36de839

src/cs: initial import from Magnetite
author Mychaela Falconia <falcon@freecalypso.org>
date Sun, 15 Jul 2018 04:39:26 +0000
parents
children
line wrap: on
line diff
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/src/cs/drivers/drv_app/uart/serialswitch.c	Sun Jul 15 04:39:26 2018 +0000
@@ -0,0 +1,3480 @@
+/*******************************************************************************
+ *
+ * SERIALSWITCH.C
+ *
+ * This module allows managing the use of the serial ports of TI GSM Evaluation
+ * Boards.
+ * An application may have to send several serial data flows. The board on which
+ * the application is running may have one or several devices. The purpose of
+ * this module is to establish connections between the serial data flows and the
+ * serial devices at runtime, when the application is started.
+ *
+ * (C) Texas Instruments 1999 - 2003
+ *
+ ******************************************************************************/
+
+#define __SERIALSWITCH_C__
+
+#define __STANDARD_H__ /* Avoid to define UBYTE, SYS_UWORD16 and UINT32. */
+
+#include "main/sys_types.h"
+#include "nucleus.h"
+
+#include "traceswitch.h"
+#include "faxdata.h"
+#include "serialswitch.h" 
+
+#include "uart/uart.h"
+#include "uartfax.h"
+
+#include "memif/mem.h" 
+
+#include "l1sw.cfg"
+#if (!OP_L1_STANDALONE)
+  #include "rv.cfg"
+#endif
+#include "chipset.cfg"
+#include "swconfig.cfg"
+#ifdef BLUETOOTH_INCLUDED
+#include "btemobile.cfg"
+#endif
+
+#include <string.h> /* needed for memcmp & memset */
+
+#ifdef SERIAL_DYNAMIC_SWITCH
+  #include "ffs/ffs.h" 
+  #include "rvf/rvf_api.h"
+  #include "inth/iq.h"
+  #include "rvt/rvt_def_i.h" /* needed for Riviera/Layer1 Trace's callback function */
+#endif
+
+#if defined(BTEMOBILE)
+  #include "hci_ser.h"
+#endif
+
+#define DUMMY_DEVICE (0)
+
+#define IIR (0x02) /* UART interrupt ident. register - Read only  */
+#define SCR (0x10) /* UART suppl. control register   - Read/Write */
+#define SSR (0x11) /* UART suppl. status register    - Read only  */
+
+/*
+ * Interrupt identification register.
+ * Bit 0 is set to 0 if an IT is pending.
+ * Bits 1 and 2 are used to identify the IT.
+ */
+
+#define IIR_BITS_USED  (0x07)
+#define IT_NOT_PENDING (0x01)
+
+/*
+ * Supplementary Control Register
+ */
+
+#define RX_CTS_WAKE_UP_ENABLE_BIT (4)
+
+/*
+ * Supplementary Status Register
+ */
+
+#define RX_CTS_WAKE_UP_STS (0x02) /* Wake-up interrupt occurred  */
+
+/*
+ * This macro allows to read an UART register.
+ */
+
+#define READ_UART_REGISTER(UART,REG) \
+            *((volatile SYS_UWORD8 *) ((UART)->base_address + (REG)))
+
+
+/*
+ * This macro allows to disable the UART's wake-up interrupt.
+ */
+
+#define DISABLE_WAKE_UP_INTERRUPT(UART) \
+            *((volatile SYS_UWORD8 *) ((UART)->base_address + SCR)) &= \
+                ~(1 << (RX_CTS_WAKE_UP_ENABLE_BIT)); 
+
+/*
+ * Wake-up time duration in seconds and in number of TDMAs.
+ * 1 TDMA = (6 / 1300) s = 0.004615 s (= 4.615 ms).
+ */
+
+#define WAKE_UP_TIME_DURATION (10)  /* 10 seconds */
+#define WAKE_UP_TIME_IN_TDMA  (WAKE_UP_TIME_DURATION * 1300 / 6)
+
+
+/*
+ * Global uartswitch variable as read from FFS.
+ * It is supposed that NUMBER_OF_TR_UART, NUMBER_OF_FD_UART
+ * and NUMBER_OF_BT_UART have the same values.
+ */
+
+#define DUMMY             ('0')
+#define G23_PANEL         ('G')
+#define RIVIERA_TRACE_MUX ('R')
+#define FD_AT_COMMAND     ('D')
+#define BLUETOOTH_HCI     ('B')
+
+#if (CHIPSET == 12)
+  char ser_cfg_info[NUMBER_OF_TR_UART] = {DUMMY, DUMMY, DUMMY};
+#else
+  char ser_cfg_info[NUMBER_OF_TR_UART] = {DUMMY, DUMMY};
+#endif
+static SYS_UWORD16 serial_cfg = 0x0048; /* All dummies */
+
+#ifdef SERIAL_DYNAMIC_SWITCH
+  /*
+   * Global variables used for Dynamic Switch.
+   */
+
+  static char ser_new_cfg[NUMBER_OF_TR_UART]  = {DUMMY, DUMMY};
+  const static char uart_config_file[] = "/sys/uartswitch";
+  static SYS_BOOL dynamic_switch = 0;
+
+  /* Import Serial Info structure. */
+  extern T_AppliSerialInfo appli_ser_cfg_info;
+#endif
+
+/*
+ * Types of flows supported.
+ */
+
+typedef enum {
+    TRACE_FLOW,
+    FAX_DATA_FLOW,
+    BLUETOOTH_HCI_FLOW
+} t_flow_type;
+
+/*
+ * For each serial data flow, a set of function pointers allows calling the
+ * functions associated to a serial device.
+ */
+
+typedef struct s_tr_functions {
+
+    T_tr_UartId   device;
+    
+    void (*tr_Init) (T_tr_UartId device,
+                     T_tr_Baudrate baudrate,
+                     void (callback_function (void)));
+                         
+    SYS_UWORD32 (*tr_ReadNChars) (T_tr_UartId device,
+                                  char *buffer,
+                                  SYS_UWORD32 chars_to_read);
+
+    SYS_UWORD32 (*tr_ReadNBytes) (T_tr_UartId device,
+                                  char *buffer,
+                                  SYS_UWORD32 chars_to_read,
+                                  SYS_BOOL *eof_detected);
+
+    SYS_UWORD32 (*tr_WriteNChars) (T_tr_UartId device,
+                                   char *buffer,
+                                   SYS_UWORD32 chars_to_write);
+
+    SYS_UWORD32 (*tr_EncapsulateNChars) (T_tr_UartId device,
+                                         char *buffer,
+                                         SYS_UWORD32 chars_to_write);
+
+    SYS_UWORD32 (*tr_WriteNBytes) (T_tr_UartId device,
+                                   SYS_UWORD8 *buffer,
+                                   SYS_UWORD32 chars_to_write);
+
+    void  (*tr_WriteChar) (T_tr_UartId device,
+                           char character);
+
+    void  (*tr_WriteString) (T_tr_UartId device,
+                             char *buffer);
+
+    SYS_BOOL (*tr_EnterSleep) (T_tr_UartId device);
+
+    void (*tr_WakeUp) (T_tr_UartId device);
+
+} t_tr_functions;
+
+/*
+ * Set of function pointers for fax & data functions.
+ */
+ 
+typedef struct s_fd_functions {
+
+    T_fd_UartId   device;
+    
+    T_FDRET (*fd_Initialize) (T_fd_UartId device);
+
+    T_FDRET (*fd_Enable) (T_fd_UartId device,
+                          SYS_BOOL enable);
+
+    T_FDRET (*fd_SetComPar) (T_fd_UartId device,
+                             T_baudrate baudrate,
+                             T_bitsPerCharacter bpc,
+                             T_stopBits sb,
+                             T_parity parity);
+
+    T_FDRET (*fd_SetBuffer) (T_fd_UartId device,
+                             SYS_UWORD16 bufSize,
+                             SYS_UWORD16 rxThreshold,
+                             SYS_UWORD16 txThreshold);
+
+    T_FDRET (*fd_SetFlowCtrl) (T_fd_UartId device,
+                               T_flowCtrlMode fcMode,
+                               SYS_UWORD8 XON,
+                               SYS_UWORD8 XOFF);
+
+    T_FDRET (*fd_SetEscape) (T_fd_UartId device,
+                             SYS_UWORD8 escChar,
+                             SYS_UWORD16 guardPeriod);
+
+    T_FDRET (*fd_InpAvail) (T_fd_UartId device);
+
+    T_FDRET (*fd_OutpAvail) (T_fd_UartId device);
+
+    T_FDRET (*fd_EnterSleep) (T_fd_UartId device);
+
+    T_FDRET (*fd_WakeUp) (T_fd_UartId device);
+
+    T_FDRET (*fd_ReadData) (T_fd_UartId device,
+                            T_suspendMode suspend,
+                            void (readOutFunc (SYS_BOOL cldFromIrq,
+                                               T_reInstMode *reInstall,
+                                               SYS_UWORD8 nsource,
+                                               SYS_UWORD8 *source[],
+                                               SYS_UWORD16 size[],
+                                               SYS_UWORD32 state)));
+
+    T_FDRET (*fd_WriteData) (T_fd_UartId device,
+                             T_suspendMode suspend,
+                             void (writeInFunc (SYS_BOOL cldFromIrq,
+                                                T_reInstMode *reInstall,
+                                                SYS_UWORD8 ndest,
+                                                SYS_UWORD8 *dest[],
+                                                SYS_UWORD16 size[])));
+
+    T_FDRET (*fd_StopRec) (T_fd_UartId device);
+
+    T_FDRET (*fd_StartRec) (T_fd_UartId device);
+
+    T_FDRET (*fd_GetLineState) (T_fd_UartId device,
+                                SYS_UWORD32 *state);
+
+    T_FDRET (*fd_SetLineState) (T_fd_UartId device,
+                                SYS_UWORD32 state,
+                                SYS_UWORD32 mask);
+
+    T_FDRET (*fd_CheckXEmpty) (T_fd_UartId device);
+
+} t_fd_functions;
+
+#ifdef BTEMOBILE
+  /*
+   * Set of function pointers for Bluetooth HCI functions.
+   */
+   
+  typedef struct s_bt_functions {
+
+      T_bt_UartId   device;
+
+      T_HCI_RET (*bt_Init) (T_bt_UartId uart_device);
+
+      T_HCI_RET (*bt_Start) (void);
+
+      T_HCI_RET (*bt_Stop) (void);
+
+      T_HCI_RET (*bt_Kill) (void);
+
+      T_HCI_RET (*bt_SetBaudrate) (UINT8 baudrate);
+
+      T_HCI_RET (*bt_TransmitPacket) (void *uart_tx_buffer);
+
+      SYS_BOOL  (*bt_EnterSleep) (void);
+
+      void      (*bt_WakeUp) (void);
+
+  } t_bt_functions;
+#endif
+
+/*
+ * Prototypes of dummy functions.
+ * Dummy functions for Trace.
+ */
+
+static void dummy_tr_Init (T_tr_UartId device,
+                           T_tr_Baudrate baudrate,
+                           void (callback_function (void)));
+ 
+static SYS_UWORD32 dummy_tr_ReadNChars (T_tr_UartId device,
+                                        char *buffer,
+                                        SYS_UWORD32 chars_to_read);
+
+static SYS_UWORD32 dummy_tr_ReadNBytes (T_tr_UartId device,
+                                        char *buffer,
+                                        SYS_UWORD32 chars_to_read,
+                                        SYS_BOOL *eof_detected);
+ 
+static SYS_UWORD32 dummy_tr_WriteNChars (T_tr_UartId device,
+                                         char *buffer,
+                                         SYS_UWORD32 chars_to_write);
+ 
+static SYS_UWORD32 dummy_tr_EncapsulateNChars (T_tr_UartId device,
+                                               char *buffer,
+                                               SYS_UWORD32 chars_to_write);
+ 
+static SYS_UWORD32 dummy_tr_WriteNBytes (T_tr_UartId device,
+                                         SYS_UWORD8 *buffer,
+                                         SYS_UWORD32 chars_to_write);
+ 
+static void dummy_tr_WriteChar (T_tr_UartId device,
+                                char character);
+ 
+static void dummy_tr_WriteString (T_tr_UartId device,
+                                  char *buffer);
+ 
+static SYS_BOOL dummy_tr_EnterSleep (T_tr_UartId device);
+ 
+static void dummy_tr_WakeUp (T_tr_UartId device);
+ 
+/*
+ * Dummy functions for Fax & Data.
+ */
+
+static T_FDRET dummy_fd_Init (T_fd_UartId device);
+ 
+static T_FDRET dummy_fd_Enable (T_fd_UartId device,
+                                SYS_BOOL enable);
+ 
+static T_FDRET dummy_fd_SetComPar (T_fd_UartId device,
+                                   T_baudrate baudrate,
+                                   T_bitsPerCharacter bpc,
+                                   T_stopBits sb,
+                                   T_parity parity);
+ 
+static T_FDRET dummy_fd_SetBuffer (T_fd_UartId device,
+                                   SYS_UWORD16 bufSize,
+                                   SYS_UWORD16 rxThreshold,
+                                   SYS_UWORD16 txThreshold);
+ 
+static T_FDRET dummy_fd_SetFlowCtrl (T_fd_UartId device,
+                                     T_flowCtrlMode fcMode,
+                                     SYS_UWORD8 XON,
+                                     SYS_UWORD8 XOFF);
+ 
+static T_FDRET dummy_fd_SetEscape (T_fd_UartId device,
+                                   SYS_UWORD8 escChar,
+                                   SYS_UWORD16 guardPeriod);
+ 
+static T_FDRET dummy_fd_InpAvail (T_fd_UartId device);
+ 
+static T_FDRET dummy_fd_OutpAvail (T_fd_UartId device);
+ 
+static T_FDRET dummy_fd_EnterSleep (T_fd_UartId device);
+ 
+static T_FDRET dummy_fd_WakeUp (T_fd_UartId device);
+ 
+static T_FDRET dummy_fd_ReadData (T_fd_UartId device,
+                                  T_suspendMode suspend,
+                                  void (readOutFunc (SYS_BOOL cldFromIrq,
+                                                     T_reInstMode *reInstall,
+                                                     SYS_UWORD8 nsource,
+                                                     SYS_UWORD8 *source[],
+                                                     SYS_UWORD16 size[],
+                                                     SYS_UWORD32 state)));
+ 
+static T_FDRET dummy_fd_WriteData (T_fd_UartId device,
+                                   T_suspendMode suspend,
+                                   void (writeInFunc (SYS_BOOL cldFromIrq,
+                                                      T_reInstMode *reInstall,
+                                                      SYS_UWORD8 ndest,
+                                                      SYS_UWORD8 *dest[],
+                                                      SYS_UWORD16 size[])));
+ 
+static T_FDRET dummy_fd_StopRec (T_fd_UartId device);
+ 
+static T_FDRET dummy_fd_StartRec (T_fd_UartId device);
+ 
+static T_FDRET dummy_fd_GetLineState (T_fd_UartId device,
+                                      SYS_UWORD32 *state);
+ 
+static T_FDRET dummy_fd_SetLineState (T_fd_UartId device,
+                                      SYS_UWORD32 state,
+                                      SYS_UWORD32 mask);
+ 
+static T_FDRET dummy_fd_CheckXEmpty (T_fd_UartId device);
+ 
+#ifdef BTEMOBILE
+  /*
+   * Dummy functions for Bluetooth HCI.
+   */
+
+  static T_HCI_RET dummy_bt_Init (T_bt_UartId uart_device);
+   
+  static T_HCI_RET dummy_bt_Start (void);
+   
+  static T_HCI_RET dummy_bt_Stop (void);
+   
+  static T_HCI_RET dummy_bt_Kill (void);
+   
+  static T_HCI_RET dummy_bt_SetBaudrate (UINT8 baudrate);
+   
+  static T_HCI_RET dummy_bt_TransmitPacket (void *uart_tx_buffer);
+
+  static SYS_BOOL  dummy_bt_EnterSleep (void);
+  
+  static void      dummy_bt_WakeUp (void);
+
+#endif
+
+/*
+ * Constants tables representing the various possible configurations
+ * for Trace, Fax & Data and Bluetooth HCI according to the different devices.
+ * Constant table for Trace using no device.
+ */
+
+static const t_tr_functions dummy_trace = {
+
+    DUMMY_DEVICE,
+    dummy_tr_Init,
+    dummy_tr_ReadNChars,
+    dummy_tr_ReadNBytes,
+    dummy_tr_WriteNChars,
+    dummy_tr_EncapsulateNChars,
+    dummy_tr_WriteNBytes,
+    dummy_tr_WriteChar,
+    dummy_tr_WriteString,
+    dummy_tr_EnterSleep,
+    dummy_tr_WakeUp
+};
+
+/*
+ * Constant table for Trace using UART IrDA.
+ */
+
+static const t_tr_functions uart_irda_trace = {
+
+    UA_UART_0,
+    UA_Init,
+    UA_ReadNChars,
+    UA_ReadNBytes,
+    UA_WriteNChars,
+    UA_EncapsulateNChars,
+    UA_WriteNBytes,
+    UA_WriteChar,
+    UA_WriteString,
+    UA_EnterSleep,
+    UA_WakeUp
+};
+
+/*
+ * Constant table for Trace using UART Modem.
+ */
+
+static const t_tr_functions uart_modem_trace = {
+
+    UA_UART_1,
+    UA_Init,
+    UA_ReadNChars,
+    UA_ReadNBytes,
+    UA_WriteNChars,
+    UA_EncapsulateNChars,
+    UA_WriteNBytes,
+    UA_WriteChar,
+    UA_WriteString,
+    UA_EnterSleep,
+    UA_WakeUp
+};
+
+#if (CHIPSET == 12)
+  /*
+   * Constant table for Trace using UART Modem2.
+   */
+
+  static const t_tr_functions uart_modem2_trace = {
+
+      UA_UART_2,
+      UA_Init,
+      UA_ReadNChars,
+      UA_ReadNBytes,
+      UA_WriteNChars,
+      UA_EncapsulateNChars,
+      UA_WriteNBytes,
+      UA_WriteChar,
+      UA_WriteString,
+      UA_EnterSleep,
+      UA_WakeUp
+  };
+#endif
+
+/*
+ * Constant table for Fax & Data using no device.
+ */
+
+static const t_fd_functions dummy_fax_data = {
+
+    DUMMY_DEVICE,
+    dummy_fd_Init,
+    dummy_fd_Enable,
+    dummy_fd_SetComPar,
+    dummy_fd_SetBuffer,
+    dummy_fd_SetFlowCtrl,
+    dummy_fd_SetEscape,
+    dummy_fd_InpAvail,
+    dummy_fd_OutpAvail,
+    dummy_fd_EnterSleep,
+    dummy_fd_WakeUp,
+    dummy_fd_ReadData,
+    dummy_fd_WriteData,
+    dummy_fd_StopRec,
+    dummy_fd_StartRec,
+    dummy_fd_GetLineState,
+    dummy_fd_SetLineState,
+    dummy_fd_CheckXEmpty
+};
+
+/*
+ * Constant table for Fax & Data using UART Modem.
+ */
+
+static const t_fd_functions uart_modem_fax_data = {
+
+    UAF_UART_1,
+    UAF_Init,
+    UAF_Enable,
+    UAF_SetComPar,
+    UAF_SetBuffer,
+    UAF_SetFlowCtrl,
+    UAF_SetEscape,
+    UAF_InpAvail,
+    UAF_OutpAvail,
+    UAF_EnterSleep,
+    UAF_WakeUp,
+    UAF_ReadData,
+    UAF_WriteData,
+    UAF_StopRec,
+    UAF_StartRec,
+    UAF_GetLineState,
+    UAF_SetLineState,
+    UAF_CheckXEmpty
+};
+
+#ifdef BTEMOBILE
+  /*
+   * Constant table for BT HCI using no device.
+   */
+
+  static const t_bt_functions dummy_bt_hci = {
+
+      DUMMY_DEVICE,
+      dummy_bt_Init,
+      dummy_bt_Start,
+      dummy_bt_Stop,
+      dummy_bt_Kill,
+      dummy_bt_SetBaudrate,
+      dummy_bt_TransmitPacket,
+      dummy_bt_EnterSleep,
+      dummy_bt_WakeUp
+  };
+
+  /*
+   * Constant table for BT HCI using UART IrDA.
+   */
+
+  static const t_bt_functions uart_irda_bt_hci = {
+
+      UABT_UART_0,
+      hciu_init,
+      hciu_start,
+      hciu_stop,
+      hciu_kill,
+      hciu_set_baudrate,
+      hciu_transmit_packet,
+      hciu_enter_sleep,
+      hciu_wakeup
+  };
+
+  /*
+   * Constant table for BT HCI using UART Modem.
+   */
+
+  static const t_bt_functions uart_modem_bt_hci = {
+
+      UABT_UART_1,
+      hciu_init,
+      hciu_start,
+      hciu_stop,
+      hciu_kill,
+      hciu_set_baudrate,
+      hciu_transmit_packet,
+      hciu_enter_sleep,
+      hciu_wakeup
+  };
+
+  #if (CHIPSET == 12)
+    /*
+     * Constant table for BT HCI using UART Modem2.
+     */
+
+    static const t_bt_functions uart_modem2_bt_hci = {
+
+        UABT_UART_2,
+        hciu_init,
+        hciu_start,
+        hciu_stop,
+        hciu_kill,
+        hciu_set_baudrate,
+        hciu_transmit_packet,
+        hciu_go_to_sleep,
+        hciu_wakeup
+    };
+  #endif
+#endif
+
+#ifdef SERIAL_DYNAMIC_SWITCH
+  /*
+   * Structure used to store initialization parameters related to the AT-Cmd/F&D flow.
+   * Numbers of paramaters (in case of multiple calls) have been figured out from
+   * Condat AT-Command/F&D flow initialization.
+   */
+   
+  typedef struct s_data_flow {
+    
+      /*
+       * Parameters related to SER_fd_SetComPar (2 calls)
+       */
+      T_baudrate         baudrate[2];
+      T_bitsPerCharacter bpc[2];
+      T_stopBits         sb[2];
+      T_parity           parity[2];
+
+      /*
+       * Parameters related to SER_fd_SetBuffer
+       */
+      SYS_WORD16         bufSize;
+      SYS_WORD16         rxThreshold;
+      SYS_WORD16         txThreshold;
+
+      /*
+       * Parameters related to SER_fd_SetFlowCtrl (2 calls)
+       */
+      T_flowCtrlMode     fcMode[2];
+      SYS_UWORD8         XON[2];
+      SYS_UWORD8         XOFF[2];
+
+      /*
+       * Parameters related to SER_fd_SetEscape (2 calls)
+       */
+      SYS_UWORD8         escChar[2];
+      SYS_UWORD16        guardPeriod[2];
+
+      /*
+       * Parameters related to SER_fd_SetLineState (4 calls)
+       */
+      SYS_UWORD32        state[4];
+      SYS_UWORD32        mask[4];
+
+      /*
+       * Parameters related to SER_fd_ReadData
+       */
+      T_suspendMode      suspend_rd;
+      void               (*readOutFunc) (SYS_BOOL cldFromIrq,
+                                         T_reInstMode *reInstall,
+                                         SYS_UWORD8 nsource,
+                                         SYS_UWORD8 *source[],
+                                         SYS_UWORD16 size[],
+                                         SYS_UWORD32 state);
+      /*
+       * Parameters related to SER_fd_WriteData
+       */
+      T_suspendMode      suspend_wr;
+      void               (*writeInFunc) (SYS_BOOL cldFromIrq,
+                                         T_reInstMode *reInstall,
+                                         SYS_UWORD8 ndest,
+                                         SYS_UWORD8 *dest[],
+                                         SYS_UWORD16 size[]);
+
+  } t_data_flow;
+#endif /* (defined BTEMOBILE && (CHIPSET != 12)) */
+
+/*
+ * UART structure used for UARTs.
+ */
+ 
+typedef struct s_uart {
+    
+    SYS_UWORD32 base_address;
+    SYS_BOOL    device_used;
+    SYS_BOOL    deep_sleep_set_up;
+    t_flow_type flow_type;
+    SYS_WORD16  flow_id;
+    void (*interrupt_handler) (int uart_id,
+                               SYS_UWORD8 interrupt_status);
+    
+} t_uart;
+
+static const t_tr_functions *tr_functions[SER_MAX_NUMBER_OF_FLOWS];
+static const t_fd_functions *fd_functions;
+
+#ifdef BTEMOBILE
+  static const t_bt_functions *bt_functions;
+#endif
+
+#ifdef SERIAL_DYNAMIC_SWITCH
+  static SYS_BOOL uart_fd_initialized = 0;
+#endif
+
+static SYS_UWORD8  fd_buffer[FD_MAX_BUFFER_SIZE];
+static SYS_BOOL    fd_driver_enabled;
+
+#ifdef SERIAL_DYNAMIC_SWITCH
+  static t_data_flow data_flow_parameters;
+#else
+  static SYS_WORD16 bufSize;
+#endif
+
+#ifdef SERIAL_DYNAMIC_SWITCH
+  /*
+   * Variables used to count calls to SER_fd_XXX functions.
+   */
+
+  static SYS_UWORD8 fd_UAF_SetBuffer = 0;
+  static SYS_UWORD8 fd_UAF_SetEscape = 0;
+  static SYS_UWORD8 fd_UAF_SetComPar = 0;
+  static SYS_UWORD8 fd_UAF_SetFlowCtrl = 0;
+  static SYS_UWORD8 fd_UAF_ReadData = 0;
+  static SYS_UWORD8 fd_UAF_SetLineState = 0;
+  static SYS_UWORD8 fd_UAF_WriteData = 0;
+#endif
+
+/*
+ * Timer used for duration control when UARTs are waked up by an interrupt or
+ * each time any new incoming characters are received; This timer prevents the
+ * system to enter deep sleep mode.
+ */
+
+static NU_TIMER uart_sleep_timer;
+       SYS_BOOL uart_sleep_timer_enabled;
+
+/*
+ * HISR used to reset and restart the sleep timer from an UART use by a Trace
+ * flow in case of incoming characters.
+ */
+
+#define TIMER_HISR_PRIORITY      (2)
+#define TIMER_HISR_STACK_SIZE  (512) /* Bytes. */ 
+
+static NU_HISR timer_hisr_ctrl_block;
+static char    timer_hisr_stack[TIMER_HISR_STACK_SIZE];
+
+/*
+ * For next arrays, it is supposed that NUMBER_OF_TR_UART, NUMBER_OF_FD_UART
+ * and NUMBER_OF_BT_UART have the same values.
+ * An index on an internal uart for trace, fax & data or bluetooth hci reffers
+ * to the same uart device.
+ */
+ 
+static t_uart int_uart[NUMBER_OF_TR_UART];
+
+#if ((CHIPSET == 2) || (CHIPSET == 3))
+  static SYS_UWORD32 uart_spurious_interrupts;
+#elif ((CHIPSET == 4) || (CHIPSET == 5) || (CHIPSET == 6) || (CHIPSET == 7) || (CHIPSET == 8) || (CHIPSET == 9) || (CHIPSET == 10) || (CHIPSET == 11) || (CHIPSET == 12))
+  static SYS_UWORD32 uart_modem_spurious_interrupts;
+  static SYS_UWORD32 uart_irda_spurious_interrupts;
+#endif
+#if (CHIPSET == 12)
+  static SYS_UWORD32 uart_modem2_spurious_interrupts;
+#endif
+
+static const SYS_UWORD32 uart_base_address[NUMBER_OF_TR_UART] =
+{
+    MEM_UART_IRDA,
+    MEM_UART_MODEM
+    #if (CHIPSET == 12)
+      , MEM_UART_MODEM2
+    #endif
+};
+
+ 
+/*******************************************************************************
+ *
+ *                              dummy_tr_Init
+ *
+ * Purpose: No action.
+ *
+ * Parameters: See SER_tr_Init.
+ *
+ * Return: none
+ *
+ ******************************************************************************/
+ 
+static void
+dummy_tr_Init (T_tr_UartId device,
+               T_tr_Baudrate baudrate,
+               void (callback_function (void)))
+{
+    /*
+     * No action.
+     */
+}
+
+/*******************************************************************************
+ *
+ *                          dummy_tr_ReadNChars
+ *
+ * Purpose: No action.
+ *
+ * Parameters: See SER_tr_ReadNChars.
+ *
+ * Return: 0
+ *
+ ******************************************************************************/
+ 
+static SYS_UWORD32
+dummy_tr_ReadNChars (T_tr_UartId device,
+                     char *buffer,
+                     SYS_UWORD32 chars_to_read)
+{
+    return (0);
+}
+
+/*******************************************************************************
+ *
+ *                          dummy_tr_ReadNBytes
+ *
+ * Purpose: No action.
+ *
+ * Parameters: See SER_tr_ReadNBytes.
+ *
+ * Return: 0
+ *
+ ******************************************************************************/
+ 
+static SYS_UWORD32
+dummy_tr_ReadNBytes (T_tr_UartId device,
+                     char *buffer,
+                     SYS_UWORD32 chars_to_read,
+                     SYS_BOOL *eof_detected)
+{
+    return (0);
+}
+
+/*******************************************************************************
+ *
+ *                          dummy_tr_WriteNChars
+ *
+ * Purpose: No action.
+ *
+ * Parameters: See SER_tr_WriteNChars.
+ *
+ * Return: The number of character to write.
+ *
+ ******************************************************************************/
+ 
+static SYS_UWORD32
+dummy_tr_WriteNChars (T_tr_UartId device,
+                      char *buffer,
+                      SYS_UWORD32 chars_to_write)
+{
+    return (chars_to_write);
+}
+
+/*******************************************************************************
+ *
+ *                          dummy_tr_EncapsulateNChars
+ *
+ * Purpose: No action.
+ *
+ * Parameters: See SER_tr_EncapsulateNChars.
+ *
+ * Return: The number of character to write.
+ *
+ ******************************************************************************/
+ 
+static SYS_UWORD32
+dummy_tr_EncapsulateNChars (T_tr_UartId device,
+                      char *buffer,
+                      SYS_UWORD32 chars_to_write)
+{
+    return (chars_to_write);
+}
+
+/*******************************************************************************
+ *
+ *                          dummy_tr_WriteNBytes
+ *
+ * Purpose: No action.
+ *
+ * Parameters: See SER_tr_WriteNBytes.
+ *
+ * Return: The number of byte to write.
+ *
+ ******************************************************************************/
+ 
+static SYS_UWORD32
+dummy_tr_WriteNBytes (T_tr_UartId device,
+                      SYS_UWORD8 *buffer,
+                      SYS_UWORD32 chars_to_write)
+{
+    return (chars_to_write);
+}
+
+/*******************************************************************************
+ *
+ *                              dummy_tr_WriteChar
+ *
+ * Purpose: No action.
+ *
+ * Parameters: See SER_tr_WriteChar.
+ *
+ * Return: none
+ *
+ ******************************************************************************/
+ 
+static void
+dummy_tr_WriteChar (T_tr_UartId device,
+                    char character)
+{
+    /*
+     * No action.
+     */
+}
+
+/*******************************************************************************
+ *
+ *                          dummy_tr_WriteString
+ *
+ * Purpose: No action.
+ *
+ * Parameters: See SER_tr_WriteString.
+ *
+ * Return: none
+ *
+ ******************************************************************************/
+ 
+static void
+dummy_tr_WriteString (T_tr_UartId device,
+                      char *buffer)
+{
+    /*
+     * No action.
+     */
+}
+
+/*******************************************************************************
+ *
+ *                          dummy_tr_EnterSleep
+ *
+ * Purpose: No action.
+ *
+ * Parameters: See SER_tr_EnterSleep.
+ *
+ * Return: 1
+ *
+ ******************************************************************************/
+ 
+static SYS_BOOL
+dummy_tr_EnterSleep (T_tr_UartId device)
+{
+    return (1);
+}
+
+/*******************************************************************************
+ *
+ *                           dummy_tr_WakeUp
+ *
+ * Purpose: No action.
+ *
+ * Parameters: See SER_tr_WakeUp.
+ *
+ * Return: none
+ *
+ ******************************************************************************/
+ 
+static void
+dummy_tr_WakeUp (T_tr_UartId device)
+{
+    /*
+     * No action.
+     */
+}
+
+/*******************************************************************************
+ *
+ *                              dummy_fd_Init
+ *
+ * Purpose: Sets the size of the circular buffer to the maximum value and the
+ *          state of the driver to 'disabled'.
+ *
+ * Parameters: See SER_fd_Init.
+ *
+ * Return: FD_OK: Successful operation.
+ *
+ ******************************************************************************/
+ 
+static T_FDRET
+dummy_fd_Init (T_fd_UartId device)
+{
+    #ifdef SERIAL_DYNAMIC_SWITCH
+      data_flow_parameters.bufSize = FD_MAX_BUFFER_SIZE;
+    #else
+      bufSize = FD_MAX_BUFFER_SIZE;
+    #endif
+    fd_driver_enabled = 0;
+    
+    return (FD_OK);
+}
+
+/*******************************************************************************
+ *
+ *                              dummy_fd_Enable
+ *
+ * Purpose: Stores the state of the driver.
+ *
+ * Parameters: See SER_fd_Enable.
+ *
+ * Return: FD_OK: Successful operation.
+ *
+ ******************************************************************************/
+ 
+static T_FDRET
+dummy_fd_Enable (T_fd_UartId device,
+                 SYS_BOOL enable)
+{
+    fd_driver_enabled = enable;
+    
+    return (FD_OK);
+}
+
+/*******************************************************************************
+ *
+ *                              dummy_fd_SetComPar
+ *
+ * Purpose: No action.
+ *
+ * Parameters: See SER_fd_SetComPar.
+ *
+ * Return: FD_OK: Successful operation.
+ *
+ ******************************************************************************/
+ 
+static T_FDRET
+dummy_fd_SetComPar (T_fd_UartId device,
+                    T_baudrate baudrate,
+                    T_bitsPerCharacter bpc,
+                    T_stopBits sb,
+                    T_parity parity)
+{
+    return (FD_OK);
+}
+
+/*******************************************************************************
+ *
+ *                              dummy_fd_SetBuffer
+ *
+ * Purpose: No action.
+ *
+ * Parameters: See SER_fd_SetBuffer.
+ *
+ * Return: FD_OK: Successful operation.
+ *
+ ******************************************************************************/
+ 
+static T_FDRET
+dummy_fd_SetBuffer (T_fd_UartId device,
+                    SYS_UWORD16 bufSize,
+                    SYS_UWORD16 rxThreshold,
+                    SYS_UWORD16 txThreshold)
+{
+    return (FD_OK);
+}
+
+/*******************************************************************************
+ *
+ *                              dummy_fd_SetFlowCtrl
+ *
+ * Purpose: No action.
+ *
+ * Parameters: See SER_fd_SetFlowCtrl.
+ *
+ * Return: FD_OK: Successful operation.
+ *
+ ******************************************************************************/
+ 
+static T_FDRET
+dummy_fd_SetFlowCtrl (T_fd_UartId device,
+                      T_flowCtrlMode fcMode,
+                      SYS_UWORD8 XON,
+                      SYS_UWORD8 XOFF)
+{
+    return (FD_OK);
+}
+
+/*******************************************************************************
+ *
+ *                              dummy_fd_SetEscape
+ *
+ * Purpose: No action.
+ *
+ * Parameters: See SER_fd_SetEscape.
+ *
+ * Return: FD_OK: Successful operation.
+ *
+ ******************************************************************************/
+ 
+static T_FDRET
+dummy_fd_SetEscape (T_fd_UartId device,
+                    SYS_UWORD8 escChar,
+                    SYS_UWORD16 guardPeriod)
+{
+    return (FD_OK);
+}
+
+/*******************************************************************************
+ *
+ *                              dummy_fd_InpAvail
+ *
+ * Purpose: No action.
+ *
+ * Parameters: See SER_fd_InpAvail.
+ *
+ * Return: The size of the circular buffer.
+ *
+ ******************************************************************************/
+ 
+static T_FDRET
+dummy_fd_InpAvail (T_fd_UartId device)
+{
+    #ifdef SERIAL_DYNAMIC_SWITCH
+      return (data_flow_parameters.bufSize);
+    #else
+      return (bufSize);
+    #endif
+}
+
+/*******************************************************************************
+ *
+ *                              dummy_fd_OutpAvail
+ *
+ * Purpose: No action.
+ *
+ * Parameters: See SER_fd_OutpAvail.
+ *
+ * Return: The size of the circular buffer.
+ *
+ ******************************************************************************/
+ 
+static T_FDRET
+dummy_fd_OutpAvail (T_fd_UartId device)
+{
+    #ifdef SERIAL_DYNAMIC_SWITCH
+      return (data_flow_parameters.bufSize);
+    #else
+      return (bufSize);
+    #endif
+}
+
+/*******************************************************************************
+ *
+ *                          dummy_fd_EnterSleep
+ *
+ * Purpose: No action.
+ *
+ * Parameters: See SER_tr_EnterSleep.
+ *
+ * Return: 1
+ *
+ ******************************************************************************/
+ 
+static T_FDRET
+dummy_fd_EnterSleep (T_fd_UartId device)
+{
+    return (1);
+}
+
+/*******************************************************************************
+ *
+ *                           dummy_fd_WakeUp
+ *
+ * Purpose: No action.
+ *
+ * Parameters: See SER_tr_WakeUp.
+ *
+ * Return: FD_OK: Successful operation.
+ *
+ ******************************************************************************/
+ 
+static T_FDRET
+dummy_fd_WakeUp (T_fd_UartId device)
+{
+    return (FD_OK);
+}
+
+/*******************************************************************************
+ *
+ *                              dummy_fd_ReadData
+ *
+ * Purpose: No action.
+ *
+ * Parameters: See SER_fd_ReadData.
+ *
+ * Return: 0 if the suspend parameter is set to 'sm_noSuspend'.
+ *         FD_SUSPENDED if the suspend parameter is set to 'sm_suspend'.
+ *
+ ******************************************************************************/
+ 
+static T_FDRET
+dummy_fd_ReadData (T_fd_UartId device,
+                   T_suspendMode suspend,
+                   void (readOutFunc (SYS_BOOL cldFromIrq,
+                                      T_reInstMode *reInstall,
+                                      SYS_UWORD8 nsource,
+                                      SYS_UWORD8 *source[],
+                                      SYS_UWORD16 size[],
+                                      SYS_UWORD32 state)))
+{
+    T_FDRET result;
+
+    if (suspend == sm_noSuspend)
+        result = 0;
+    else
+        result = FD_SUSPENDED;
+        
+    return (result);
+}
+
+/*******************************************************************************
+ *
+ *                              dummy_fd_WriteData
+ *
+ * Purpose: The user's function is called with:
+ *            - cldFromIrq = 0
+ *            - ndest = 1
+ *            - dest[0] is a SYS_UWORD8 pointer on the beginning address of a local
+ *              buffer
+ *            - size[0] is set to data_flow_parameters.bufSize.
+ *
+ * Parameters: See SER_fd_WriteData.
+ *
+ * Return: The number of bytes written in the local buffer.
+ *
+ ******************************************************************************/
+ 
+static T_FDRET
+dummy_fd_WriteData (T_fd_UartId device,
+                    T_suspendMode suspend,
+                    void (writeInFunc (SYS_BOOL cldFromIrq,
+                                       T_reInstMode *reInstall,
+                                       SYS_UWORD8 ndest,
+                                       SYS_UWORD8 *dest[],
+                                       SYS_UWORD16 size[])))
+{
+    T_reInstMode dummyInstall;
+    SYS_UWORD8   *destination[2];
+    SYS_UWORD16  buffer_size[2];
+
+    destination[0] = &(fd_buffer[0]);
+    #ifdef SERIAL_DYNAMIC_SWITCH
+      buffer_size[0] = data_flow_parameters.bufSize;
+    #else
+      buffer_size[0] = bufSize;
+    #endif
+    
+    (*writeInFunc) (0, &dummyInstall, 1, &(destination[0]), &(buffer_size[0]));
+    
+    #ifdef SERIAL_DYNAMIC_SWITCH
+      return ((T_FDRET) (data_flow_parameters.bufSize - buffer_size[0]));
+    #else
+      return ((T_FDRET) (bufSize - buffer_size[0]));
+    #endif
+}
+
+/*******************************************************************************
+ *
+ *                              dummy_fd_StopRec
+ *
+ * Purpose: No action.
+ *
+ * Parameters: See SER_fd_StopRec.
+ *
+ * Return: FD_OK: Successful operation.
+ *
+ ******************************************************************************/
+ 
+static T_FDRET
+dummy_fd_StopRec (T_fd_UartId device)
+{
+    return (FD_OK);
+}
+
+/*******************************************************************************
+ *
+ *                              dummy_fd_StartRec
+ *
+ * Purpose: No action.
+ *
+ * Parameters: See SER_fd_StartRec.
+ *
+ * Return: FD_OK: Successful operation.
+ *
+ ******************************************************************************/
+ 
+static T_FDRET
+dummy_fd_StartRec (T_fd_UartId device)
+{
+    return (FD_OK);
+}
+
+/*******************************************************************************
+ *
+ *                              dummy_fd_GetLineState
+ *
+ * Purpose: Sets the RXBLEV field to the bufSize value.
+ *
+ * Parameters: See SER_fd_GetLineState.
+ *
+ * Return: FD_OK: Successful operation.
+ *
+ ******************************************************************************/
+ 
+static T_FDRET
+dummy_fd_GetLineState (T_fd_UartId device,
+                       SYS_UWORD32 *state)
+{
+    #ifdef SERIAL_DYNAMIC_SWITCH
+      *state = data_flow_parameters.bufSize << RXBLEV;
+    #else
+      *state = bufSize << RXBLEV;
+    #endif
+    
+    return (FD_OK);
+}
+
+/*******************************************************************************
+ *
+ *                              dummy_fd_SetLineState
+ *
+ * Purpose: No action.
+ *
+ * Parameters: See SER_fd_SetLineState.
+ *
+ * Return: FD_OK: Successful operation.
+ *
+ ******************************************************************************/
+ 
+static T_FDRET
+dummy_fd_SetLineState (T_fd_UartId device,
+                       SYS_UWORD32 state,
+                       SYS_UWORD32 mask)
+{
+    return (FD_OK);
+}
+
+/*******************************************************************************
+ *
+ *                              dummy_fd_CheckXEmpty
+ *
+ * Purpose: No action.
+ *
+ * Parameters: See SER_fd_CheckXEmpty.
+ *
+ * Return: FD_OK: Successful operation.
+ *
+ ******************************************************************************/
+ 
+static T_FDRET
+dummy_fd_CheckXEmpty (T_fd_UartId device)
+{
+    return (FD_OK);
+}
+
+#ifdef BTEMOBILE
+/*******************************************************************************
+ *
+ *                              dummy_bt_Init
+ *
+ * Purpose: No action.
+ *
+ * Parameters: See SER_bt_Init.
+ *
+ * Return: HCI_OK: Successful operation.
+ *
+ ******************************************************************************/
+ 
+static T_HCI_RET
+dummy_bt_Init (T_bt_UartId uart_device)
+{
+    return (HCI_OK);
+}
+
+/*******************************************************************************
+ *
+ *                              dummy_bt_Start
+ *
+ * Purpose: No action.
+ *
+ * Parameters: See SER_bt_Start.
+ *
+ * Return: HCI_OK: Successful operation.
+ *
+ ******************************************************************************/
+ 
+static T_HCI_RET
+dummy_bt_Start (void)
+{
+    return (HCI_OK);
+}
+
+/*******************************************************************************
+ *
+ *                              dummy_bt_Stop
+ *
+ * Purpose: No action.
+ *
+ * Parameters: See SER_bt_Stop.
+ *
+ * Return: HCI_OK: Successful operation.
+ *
+ ******************************************************************************/
+ 
+static T_HCI_RET
+dummy_bt_Stop (void)
+{
+    return (HCI_OK);
+}
+
+/*******************************************************************************
+ *
+ *                              dummy_bt_Kill
+ *
+ * Purpose: No action.
+ *
+ * Parameters: See SER_bt_Kill.
+ *
+ * Return: HCI_OK: Successful operation.
+ *
+ ******************************************************************************/
+ 
+static T_HCI_RET
+dummy_bt_Kill (void)
+{
+    return (HCI_OK);
+}
+
+/*******************************************************************************
+ *
+ *                           dummy_bt_SetBaudrate
+ *
+ * Purpose: No action.
+ *
+ * Parameters: See SER_bt_SetBaudrate.
+ *
+ * Return: HCI_OK: Successful operation.
+ *
+ ******************************************************************************/
+ 
+static T_HCI_RET
+dummy_bt_SetBaudrate (UINT8 baudrate)
+{
+    return (HCI_OK);
+}
+
+/*******************************************************************************
+ *
+ *                         dummy_bt_TransmitPacket
+ *
+ * Purpose: No action.
+ *
+ * Parameters: See SER_bt_TransmitPacket.
+ *
+ * Return: HCI_OK: Successful operation.
+ *
+ ******************************************************************************/
+ 
+static T_HCI_RET dummy_bt_TransmitPacket (void *uart_tx_buffer)
+
+{
+    return (HCI_OK);
+}
+
+/*******************************************************************************
+ *
+ *                              dummy_bt_EnterSleep
+ *
+ * Purpose: No action.
+ *
+ * Parameters: See SER_bt_EnterSleep.
+ *
+ * Return: TRUE.
+ *
+ ******************************************************************************/ 
+
+static SYS_BOOL
+dummy_bt_EnterSleep (void)
+{
+    return (TRUE);
+}
+
+/*******************************************************************************
+ *
+ *                              dummy_bt_WakeUp
+ *
+ * Purpose: No action.
+ *
+ * Parameters: See SER_bt_WakeUp
+ *
+ * Return: HCI_OK: none
+ *
+ ******************************************************************************/ 
+
+static void
+dummy_bt_WakeUp (void)
+{
+    /*
+     * No action.
+     */
+}
+
+#endif /* BTEMOBILE */
+
+/*******************************************************************************
+ *
+ *                     analyze_uart_sleep_timer_expiration
+ * 
+ * Purpose  : The timer has just expired. If requested, UARTs can again be set
+ *            up to enter Deep Sleep.
+ *
+ * Arguments: In : id: parameter not used.
+ *            Out: none
+ *
+ * Returns  : none 
+ *
+ ******************************************************************************/
+
+static VOID
+analyze_uart_sleep_timer_expiration (UNSIGNED id)
+{
+    /*
+     * Timer has expired.
+     * UARTs can again be set up for Deep Sleep.
+     */
+
+    (void) NU_Control_Timer (&uart_sleep_timer,
+                             NU_DISABLE_TIMER);
+      
+    uart_sleep_timer_enabled = 0;
+}
+
+/*******************************************************************************
+ *
+ *                          start_uart_sleep_timer
+ * 
+ * Purpose  : Starts the sleep timer once UARTs have been waked-up by an
+ *            interrupt or if new incoming characters have been received.
+ *
+ * Arguments: In : none
+ *            Out: none
+ *
+ * Returns  : none 
+ *
+ ******************************************************************************/
+
+static void
+start_uart_sleep_timer (void)
+{
+    /*
+     * UART sleep timer is started.
+     * UARTs can't no more be set up for Deep Sleep until the timer expires.
+     */
+
+    (void) NU_Reset_Timer (&uart_sleep_timer,
+                           &analyze_uart_sleep_timer_expiration,
+                           WAKE_UP_TIME_IN_TDMA,
+                           0, /* The timer expires once. */
+                           NU_DISABLE_TIMER);
+
+    (void) NU_Control_Timer (&uart_sleep_timer,
+                             NU_ENABLE_TIMER);
+}
+
+/*******************************************************************************
+ *
+ *                              set_flow_functions
+ *
+ * Purpose: Initializes a serial data flow functions set with the set of
+ *          functions of the selected device.
+ *
+ * Parameters: In : flow         : index of the serial data flow
+ *                  serial_driver: allows knowing which set of functions must
+ *                                 be selected
+ *             Out: none
+ *
+ * Return: none
+ *
+ ******************************************************************************/
+
+static void
+set_flow_functions (int flow,
+                    T_SerialDriver serial_driver)
+{
+
+    switch (serial_driver) {
+
+    case UART_MODEM_FAX_DATA:
+
+        fd_functions = &uart_modem_fax_data;
+        int_uart[fd_functions->device].device_used = 1;
+        int_uart[fd_functions->device].flow_type   = FAX_DATA_FLOW;
+        int_uart[fd_functions->device].flow_id     = flow;
+        int_uart[fd_functions->device].interrupt_handler =
+                                           UAF_InterruptHandler;
+        break;
+
+    case DUMMY_FAX_DATA:
+        
+        fd_functions = &dummy_fax_data;                               
+        break;
+
+
+    case UART_IRDA_TRACE:
+    case UART_MODEM_TRACE:
+    #if (CHIPSET == 12)
+      case UART_MODEM2_TRACE:
+    #endif
+
+        if (serial_driver == UART_IRDA_TRACE)
+            tr_functions[flow] = &uart_irda_trace;
+        else {
+          #if (CHIPSET == 12)
+            if (serial_driver == UART_MODEM2_TRACE)
+                tr_functions[flow] = &uart_modem2_trace;
+            else
+          #endif
+                tr_functions[flow] = &uart_modem_trace;
+        }
+
+        int_uart[tr_functions[flow]->device].device_used = 1;
+        int_uart[tr_functions[flow]->device].flow_type   = TRACE_FLOW;
+        int_uart[tr_functions[flow]->device].flow_id     = flow;
+        int_uart[tr_functions[flow]->device].interrupt_handler =
+                                      UA_InterruptHandler;
+        break;
+
+    case DUMMY_TRACE:
+
+        tr_functions[flow] = &dummy_trace;
+        break;
+
+    case DUMMY_BT_HCI:
+
+        /*
+         * if serial_driver = DUMMY_BT_HCI & if BTEMOBILE is not defined
+         * no action is performed.
+         */
+
+#ifdef BTEMOBILE
+        bt_functions = &dummy_bt_hci;                               
+        break;
+
+    case UART_IRDA_BT_HCI:
+    case UART_MODEM_BT_HCI:
+    #if (CHIPSET == 12)
+      case UART_MODEM2_BT_HCI:
+    #endif
+
+        if (serial_driver == UART_IRDA_BT_HCI)
+            bt_functions = &uart_irda_bt_hci;
+        else {
+          #if (CHIPSET == 12)
+            if (serial_driver == UART_MODEM2_BT_HCI)
+                bt_functions = &uart_modem2_bt_hci;
+            else
+          #endif
+                bt_functions = &uart_modem_bt_hci;
+        }
+
+        int_uart[bt_functions->device].device_used = 1;
+        int_uart[bt_functions->device].flow_type   = BLUETOOTH_HCI_FLOW;
+        int_uart[bt_functions->device].flow_id     = flow;
+        int_uart[bt_functions->device].interrupt_handler =
+                                             hciu_interrupt_handler;
+#endif /* BTEMOBILE */
+          break;
+    }
+}
+
+/*******************************************************************************
+ *
+ *                          SER_InitSerialConfig
+ *
+ * Purpose: The parameter serial_info allows knowing all serial information
+ *          necessary to set up the serial configuration of an application.
+ *          From this information, the function is able to determine if the
+ *          current serial configuration read out from the flash memory is
+ *          valid. If it does not correspond to an allowed configuration, the
+ *          default configuration is selected. This function must be called at
+ *          the application's initialization, but never after.
+ *
+ * Parameters: In : serial_info: application serial information like the default
+ *                               configuration and all allowed configurations.
+ *             Out: none
+ *
+ * Return: none
+ *
+ ******************************************************************************/
+
+void
+SER_InitSerialConfig (T_AppliSerialInfo *serial_info)
+{
+    int         uart_id;
+    int         flow;
+    SYS_UWORD16 serial_driver;
+    SYS_UWORD16 *allowed_config;
+    SYS_UWORD8  nb_allowed_config;
+    SYS_BOOL    valid_config_selected;
+    SYS_BOOL    uart_used;
+    SYS_BOOL    uart_used_for_trace;
+    SYS_UWORD16 current_config;
+    SYS_UWORD16 *pt_current_config = &(current_config);
+
+    /*
+     * Basic UARTs initializations.
+     */
+
+    for (uart_id = 0; uart_id < NUMBER_OF_TR_UART; uart_id++) {
+
+        int_uart[uart_id].base_address = uart_base_address[uart_id];
+        int_uart[uart_id].device_used = 0;
+        int_uart[uart_id].deep_sleep_set_up = 0;
+    }
+
+#if ((CHIPSET == 2) || (CHIPSET == 3))
+    uart_spurious_interrupts = 0;
+#elif ((CHIPSET == 4) || (CHIPSET == 5) || (CHIPSET == 6) || (CHIPSET == 7) || (CHIPSET == 8) || (CHIPSET == 9) || (CHIPSET == 10) || (CHIPSET == 11) || (CHIPSET == 12))
+    uart_modem_spurious_interrupts = 0;
+    uart_irda_spurious_interrupts = 0;
+#endif
+#if (CHIPSET == 12)
+    uart_modem2_spurious_interrupts = 0;
+#endif
+    uart_sleep_timer_enabled = 0;
+
+    /*
+     * Compute the current serial configuration.
+     */
+
+    for (uart_id = 0; uart_id < NUMBER_OF_TR_UART; uart_id++) {
+
+        switch (ser_cfg_info[uart_id]) { 
+
+            case G23_PANEL:
+                serial_cfg = serial_cfg +
+                    ((uart_id + 1) << (12 - (4 * SER_PROTOCOL_STACK)));
+                break;
+
+            case RIVIERA_TRACE_MUX:
+                serial_cfg = serial_cfg +
+                    ((uart_id + 1) << (12 - (4 * SER_LAYER_1)));
+                break;
+
+            case FD_AT_COMMAND:
+                serial_cfg = serial_cfg +
+                    ((uart_id + 1) << (12 - (4 * SER_FAX_DATA)));
+                break;
+
+            case BLUETOOTH_HCI:
+                serial_cfg = serial_cfg +
+                    ((uart_id + 1) << (12 - (4 * SER_BLUETOOTH_HCI)));
+                break;
+
+            case DUMMY:
+                break;
+        }
+    }
+
+    current_config = serial_cfg;
+    valid_config_selected = 0;
+    nb_allowed_config = serial_info->num_config;
+
+    /*
+     * Checks if the current serial config is one of the allowed.
+     */
+     
+    while ((nb_allowed_config > 0) && !valid_config_selected) {
+        
+        nb_allowed_config--;
+        allowed_config = (SYS_UWORD16 *)
+                          &(serial_info->allowed_config[nb_allowed_config]);
+        
+        if (*pt_current_config == *allowed_config)
+            valid_config_selected = 1;
+    }
+
+    /*
+     * If not, the default configuration is selected.
+     */
+
+    if (!valid_config_selected) {
+
+        pt_current_config = (SYS_UWORD16 *)&(serial_info->default_config);
+
+        #if (defined BTEMOBILE && (CHIPSET != 12))
+          /*
+           * Setup the global variable accordingly.
+           * The following default value are identical to the ones defined at
+           * the application initialization in init.c.
+           */
+
+          #ifdef BT_UART_USED_MODEM
+            memcpy (ser_cfg_info, "RB", NUMBER_OF_TR_UART);
+          #else
+            memcpy (ser_cfg_info, "BR", NUMBER_OF_TR_UART);
+          #endif
+        #endif
+    }
+
+    /*
+     * The serial data flow functions set is initialized.
+     */
+
+    flow = 0;
+    while (flow < SER_MAX_NUMBER_OF_FLOWS) {
+        
+        serial_driver = (T_SerialDriver)
+                            (((*pt_current_config) >> (12 - flow * 4)) & 0x000F);
+
+        set_flow_functions (flow, serial_driver);
+        flow++;
+    }
+    
+    /*
+     * Checks if both UARTs are used.
+     * If not, performs minimum initialization including Sleep Mode.
+     * Checks also if at least one UART is used by a Trace flow.
+     * If so, create a HISR in order to reset and restart the sleep timer
+     * in case of incoming characters.
+     */
+
+    uart_used = 0;
+    uart_used_for_trace = 0;
+    for (uart_id = 0; uart_id < NUMBER_OF_TR_UART; uart_id++) {
+
+        if (!(int_uart[uart_id].device_used))
+	    initialize_uart_sleep (uart_id);
+
+        else { /* if (int_uart[uart_id].device_used) */
+
+            uart_used = 1;  /* At least one UART is used */
+
+            if (int_uart[uart_id].flow_type == TRACE_FLOW) {
+
+                /* At least one UART used by a Trace flow */
+                uart_used_for_trace = 1;
+            }
+        }
+    }
+
+    /*
+     * If at least one uart is used, create a timer to figure out if the system
+     * can enter deep sleep mode regarding the UARTs.
+     */
+
+    if (uart_used) {
+
+        (void) NU_Create_Timer (
+                   &uart_sleep_timer,
+                   "Sleep",
+                   &analyze_uart_sleep_timer_expiration,
+                   0, /* Parameter supplied to the routine: not used. */
+                   WAKE_UP_TIME_IN_TDMA,
+                   0, /* The timer expires once. */
+                   NU_DISABLE_TIMER);
+
+        /*
+         * If at least one uart is used by a Trace flow, create a HISR to reset
+         * and restart the sleep timer.
+         */
+
+        if (uart_used_for_trace) {
+
+            /*
+             * The stack is entirely filled with the pattern 0xFE.
+             */
+
+            memset (&(timer_hisr_stack[0]), 0xFE, TIMER_HISR_STACK_SIZE);
+
+            /*
+             * The HISR entry function is the same function than the one called
+             * by the Rx HISR of the UARTFAX, since the only aim is to reset
+             * and restart the sleep timer in case of incoming characters on
+             * the Trace UART.
+             */
+
+            (void) NU_Create_HISR (
+                       &timer_hisr_ctrl_block,
+                       "Tim_HISR",
+                       SER_restart_uart_sleep_timer,
+                       TIMER_HISR_PRIORITY,
+                       &(timer_hisr_stack[0]),
+                       TIMER_HISR_STACK_SIZE);
+        }
+    }
+}
+
+
+/*******************************************************************************
+ *
+ *                          SER_WriteConfig
+ *
+ * Purpose: TBD
+ *
+ * Parameters: In : new_config: TBD
+ *                  write_to_flash: TBD
+ *             Out: none
+ *
+ * Return: 0 (FALSE)   : In case of error while trying to write file in FFS
+ *         >= 1 (TRUE) : Successful operation.
+ *
+ ******************************************************************************/
+
+SYS_BOOL
+SER_WriteConfig (char *new_config,
+                 SYS_BOOL write_to_flash)
+{
+#ifdef SERIAL_DYNAMIC_SWITCH
+    int      uart_id;
+    SYS_BOOL status = 1;
+
+    for (uart_id = 0; uart_id < NUMBER_OF_TR_UART; uart_id++)
+        ser_new_cfg[uart_id] = *new_config++;
+
+    /*
+     * Write in flash the new serial configuration if requested.
+     */
+
+    if (write_to_flash) {
+        if (ffs_fwrite (uart_config_file,
+                        ser_new_cfg,
+                        NUMBER_OF_TR_UART) < EFFS_OK) {
+            status = 0;
+        }
+    }
+
+    return (status);
+#else
+    /*
+     * Real Dynamic Switch is only available with Bluetooth AND all chips but
+     * Calypso+.
+     */
+
+    return (1);
+#endif
+}
+
+/*******************************************************************************
+ *
+ *                          SER_ImmediateSwitch
+ *
+ * Purpose: TBD
+ *
+ * Parameters: In : none
+ *             Out: none
+ *
+ * Return: 0 (FALSE)   : In case of error.
+ *         >= 1 (TRUE) : Successful operation.
+ *
+ ******************************************************************************/
+
+SYS_BOOL
+SER_ImmediateSwitch (void)
+{
+#ifdef SERIAL_DYNAMIC_SWITCH
+    int                uart_id;
+    SYS_BOOL           valid_config = 0;
+    T_AppliSerialInfo *serial_info = &appli_ser_cfg_info;
+    SYS_UWORD8         nb_allowed_config = serial_info->num_config;
+    SYS_UWORD16       *allowed_config;
+    int                flow;
+    T_SerialDriver     serial_flows[SER_MAX_NUMBER_OF_FLOWS];
+    T_tr_UartId        uart_nb;
+
+    /*
+     * First check if the new serial configuration is actually different from
+     * the previous one. A return is used to simplify the code.
+     */
+
+    if (!memcmp (ser_new_cfg,
+                 ser_cfg_info,
+                 NUMBER_OF_TR_UART))
+        return (1); /* new config and old config are identical => nothing to do */
+
+    /*
+     * Then check if the new serial config is valid or not.
+     * At that point, we assume that a serial config is valid if and only if the
+     * Bluetooth HCI flow is still enabled and still uses the same UART.
+     * Reset the current serial config, and compute the new one.
+     */
+
+    serial_cfg = 0x0048; /* All dummies */
+    for (uart_id = 0; uart_id < NUMBER_OF_TR_UART; uart_id++) {
+
+        switch (ser_new_cfg[uart_id]) { 
+
+            case G23_PANEL:
+                serial_cfg = serial_cfg +
+                    ((uart_id + 1) << (12 - (4 * SER_PROTOCOL_STACK)));
+                break;
+
+            case RIVIERA_TRACE_MUX:
+                serial_cfg = serial_cfg +
+                    ((uart_id + 1) << (12 - (4 * SER_LAYER_1)));
+                break;
+
+            case FD_AT_COMMAND:
+                serial_cfg = serial_cfg +
+                    ((uart_id + 1) << (12 - (4 * SER_FAX_DATA)));
+                break;
+
+            case BLUETOOTH_HCI:
+                serial_cfg = serial_cfg +
+                    ((uart_id + 1) << (12 - (4 * SER_BLUETOOTH_HCI)));
+
+#if 0
+                /*
+                 * Check if the Bluetooth HCI flow is enabled on the same UART.
+                 */
+
+                if (ser_cfg_info[uart_id] == BLUETOOTH_HCI)
+                    valid_config = 1;
+#endif
+
+                break;
+
+            case DUMMY:
+                break;
+        }
+    }
+
+#if 0
+    if (!valid_config)
+        return (0); /* Bluetooth HCI flow not enabled in the new serial config,
+                       or enabled but using a different UART. */
+#endif
+
+    /*
+     * Finally check if the new serial config is allowed by the application.
+     */
+     
+    valid_config = 0;
+    while ((nb_allowed_config > 0) && !valid_config) {
+        
+        nb_allowed_config--;
+        allowed_config = (SYS_UWORD16 *)
+                          &(serial_info->allowed_config[nb_allowed_config]);
+        
+        if (serial_cfg == *allowed_config)
+            valid_config = 1;
+    }
+
+    if (!valid_config) /* the new config is not allowed by the application */
+        return (0);
+
+    /*
+     * From now on, Dynamic Switch is being processed.
+     */
+
+    dynamic_switch = 1;
+
+    /*
+     * Disable UART interrupts until new serial config setup is complete.
+     */
+
+    #if ((CHIPSET == 4) || (CHIPSET == 5) || (CHIPSET == 6) || (CHIPSET == 7) || (CHIPSET == 8) || (CHIPSET == 9) || (CHIPSET == 10) || (CHIPSET == 11))
+      IQ_Mask (IQ_UART_IRDA_IT);
+    #endif
+    IQ_Mask (IQ_UART_IT);
+
+    /*
+     * Reset UARTs set-up.
+     */
+
+    for (uart_id = 0; uart_id < NUMBER_OF_TR_UART; uart_id++) {
+
+        int_uart[uart_id].device_used = 0;
+        int_uart[uart_id].deep_sleep_set_up = 0;
+        int_uart[uart_id].interrupt_handler = NULL;
+    }
+
+    /*
+     * All function pointers are set to dummy functions.
+     */
+
+    rvf_disable (21); /* beginning of the critical section */
+
+    for (flow = 0; flow < SER_MAX_NUMBER_OF_FLOWS; flow++)
+        tr_functions[flow] = &dummy_trace;
+
+    fd_functions = &dummy_fax_data;
+    #ifdef BTEMOBILE
+      bt_functions = &dummy_bt_hci;
+    #endif
+
+    rvf_enable (); /* end of the critical section */
+
+    /*
+     * Calls the Exit function of the UARTFAX driver if it was previously used.
+     */
+
+    if (uart_fd_initialized) {
+
+        /*
+         * UART IrDA can't be used for F&D/AT-Cmd flow => UART Modem was used
+         * by the F&D/AT-Cmd flow.
+         */
+
+        if (UAF_Exit (UAF_UART_1) == FD_OK) {
+            uart_fd_initialized = 0;
+        }
+    }
+#if 0
+    else {
+
+        /*
+         * AT that point, since the Bluetooth HCI flow already uses one UART,
+         * and since the second UART was not used by the F&D/AT-Cmd flow, we
+         * assume it was used by a Trace flow. Therefore, the HISR used to 
+         * reset and restart the sleep timer is deleted.
+         */
+
+        (void) NU_Delete_HISR (&timer_hisr_ctrl_block);
+    }
+#endif
+
+    /*
+     * Initialization of the new flows (Only AT-Cmd/F&D or Riviera/Layer1 Trace)
+     * and their associated UARTs HW (Irda or Modem) & SW (Trace or Fax&Data).
+     */
+
+    for (flow = 0; flow < SER_MAX_NUMBER_OF_FLOWS; flow++) {
+
+        serial_flows[flow] = (T_SerialDriver)
+                             ((serial_cfg >> (12 - flow * 4)) & 0x000F);
+
+        switch (serial_flows[flow]) {
+
+            /*
+             * For Riviera/Layer1 Trace flow, default baudrate is 115200 bps
+             * and callback function is defined in rvt_def_i.h.
+             */
+
+            case UART_IRDA_TRACE:
+            case UART_MODEM_TRACE:
+
+                if (serial_flows[flow] == UART_IRDA_TRACE)
+                    uart_nb = UA_UART_0;
+                else /* if (serial_flows[flow] == UART_MODEM_TRACE) */
+                    uart_nb = UA_UART_1;
+
+                if (flow == SER_LAYER_1) {
+
+                    UA_Init (uart_nb,
+                             TR_BAUD_CONFIG,
+                             rvt_activate_RX_HISR);
+
+#if 0
+                    /*
+                     * Create the HISR used to reset and restart the sleep
+                     * timer in case of incoming characters on the Trace flow.
+                     * The stack is entirely filled with the pattern 0xFE.
+                     */
+
+                    memset (&(timer_hisr_stack[0]),
+                            0xFE,
+                            TIMER_HISR_STACK_SIZE);
+
+                    (void) NU_Create_HISR (
+                               &timer_hisr_ctrl_block,
+                               "Tim_HISR",
+                               SER_restart_uart_sleep_timer,
+                               TIMER_HISR_PRIORITY,
+                               &(timer_hisr_stack[0]),
+                               TIMER_HISR_STACK_SIZE);
+#endif
+                }
+                else /* Other Trace flows are disabled */
+                    initialize_uart_sleep (uart_nb);
+                break;
+
+            /*
+             * For At-Cmd/F&D flow, functions are called in the appropriate
+             * order with the saved parameters.
+             * This has been figured out from the G23 initialization.
+             */
+
+            case UART_MODEM_FAX_DATA:
+
+                /* Global Initialization */
+                if (UAF_Init (UAF_UART_1) == FD_OK) {
+                    uart_fd_initialized = 1;
+                }
+
+                /* Disable the driver */
+                UAF_Enable (UAF_UART_1,
+                            0);
+
+                /* Set the SW Buffers parameters */
+                UAF_SetBuffer (UAF_UART_1,
+                               data_flow_parameters.bufSize,
+                               data_flow_parameters.rxThreshold,
+                               data_flow_parameters.txThreshold);
+
+                /* Set the Escape Sequence parameters (1st call) */
+                UAF_SetEscape (UAF_UART_1,
+                               data_flow_parameters.escChar[0],
+                               data_flow_parameters.guardPeriod[0]);
+
+                /* Set the Communication parameters (1st call) */
+                UAF_SetComPar (UAF_UART_1,
+                               data_flow_parameters.baudrate[0],
+                               data_flow_parameters.bpc[0],
+                               data_flow_parameters.sb[0],
+                               data_flow_parameters.parity[0]);
+
+                /* Set the Flow Control parameters (1st call) */
+                UAF_SetFlowCtrl (UAF_UART_1,
+                                 data_flow_parameters.fcMode[0],
+                                 data_flow_parameters.XON[0],
+                                 data_flow_parameters.XOFF[0]);
+
+                /* Set the Communication parameters (2nd call) */
+                UAF_SetComPar (UAF_UART_1,
+                               data_flow_parameters.baudrate[1],
+                               data_flow_parameters.bpc[1],
+                               data_flow_parameters.sb[1],
+                               data_flow_parameters.parity[1]);
+
+                /* Set the Flow Control parameters (2nd call) */
+                UAF_SetFlowCtrl (UAF_UART_1,
+                                 data_flow_parameters.fcMode[1],
+                                 data_flow_parameters.XON[1],
+                                 data_flow_parameters.XOFF[1]);
+
+                /* Set the Escape Sequence parameters (2nd call) */
+                UAF_SetEscape (UAF_UART_1,
+                               data_flow_parameters.escChar[1],
+                               data_flow_parameters.guardPeriod[1]);
+
+                /* Enable the driver */
+                UAF_Enable (UAF_UART_1,
+                            1);
+
+                /* Get the number of input bytes available */
+                UAF_InpAvail (UAF_UART_1);
+
+                /* Set the readOutFunc and the suspend mode */
+                UAF_ReadData (UAF_UART_1,
+                              data_flow_parameters.suspend_rd,
+                              data_flow_parameters.readOutFunc);
+
+                /* Get the number of output bytes available (1st call) */
+                UAF_OutpAvail (UAF_UART_1);
+
+                /* Set the states of the V.24 status lines (1st call) */
+                UAF_SetLineState (UAF_UART_1,
+                                  data_flow_parameters.state[0],
+                                  data_flow_parameters.mask[0]);
+
+                /* Set the states of the V.24 status lines (2nd call) */
+                UAF_SetLineState (UAF_UART_1,
+                                  data_flow_parameters.state[1],
+                                  data_flow_parameters.mask[1]);
+
+                /* Set the states of the V.24 status lines (3rd call) */
+                UAF_SetLineState (UAF_UART_1,
+                                  data_flow_parameters.state[2],
+                                  data_flow_parameters.mask[2]);
+
+                /* Set the states of the V.24 status lines (4th call) */
+                UAF_SetLineState (UAF_UART_1,
+                                  data_flow_parameters.state[3],
+                                  data_flow_parameters.mask[3]);
+
+                /* Set the writeInFunc and the suspend mode */
+                UAF_WriteData (UAF_UART_1,
+                               data_flow_parameters.suspend_wr,
+                               data_flow_parameters.writeInFunc);
+
+                /* Get the number of output bytes available (2nd call) */
+                UAF_OutpAvail (UAF_UART_1);
+
+                break;
+
+            case UART_IRDA_BT_HCI:
+            case UART_MODEM_BT_HCI:
+                /*
+                 * Nothing to initialize for Bluetooth HCI flow since it does
+                 * use the same UART.
+                 */
+
+            case DUMMY_TRACE:
+            case DUMMY_FAX_DATA:
+            case DUMMY_BT_HCI:
+                /*
+                 * Of course nothing to perform for Dummy flows.
+                 */
+
+                break;
+        }
+    }
+
+    /*
+     * All function pointers are set to the appropriate functions set.
+     */
+
+    for (flow = 0; flow < SER_MAX_NUMBER_OF_FLOWS; flow++){
+
+        /*
+         * For Dummy flows, pointers to dummy functions are already set.
+         */
+
+        if ((serial_flows[flow] != DUMMY_TRACE) &&
+            (serial_flows[flow] != DUMMY_FAX_DATA) &&
+            (serial_flows[flow] != DUMMY_BT_HCI)) {
+
+            rvf_disable (21); /* beginning of the critical section */
+            set_flow_functions (flow, serial_flows[flow]);
+            rvf_enable (); /* end of the critical section */
+        }
+    }
+
+    /*
+     * Dynamic Switch has been processed.
+     * The new serial config is actually stored.
+     */
+
+    dynamic_switch = 0;
+    for (uart_id = 0; uart_id < NUMBER_OF_TR_UART; uart_id++)
+        ser_cfg_info[uart_id] = ser_new_cfg[uart_id];
+
+    /*
+     * Re-enable UART interrupts.
+     */
+
+    #if ((CHIPSET == 4) || (CHIPSET == 5) || (CHIPSET == 6) || (CHIPSET == 7) || (CHIPSET == 8) || (CHIPSET == 9) || (CHIPSET == 10) || (CHIPSET == 11))
+      IQ_Unmask (IQ_UART_IRDA_IT);
+    #endif
+    IQ_Unmask (IQ_UART_IT);
+
+#endif
+    /*
+     * Real Dynamic Switch is only available with Bluetooth AND all chips but
+     * Calypso+.
+     */
+
+    return (1);
+}
+
+/*******************************************************************************
+ *
+ * All functions SER_tr_xxx and SER_fd_xxx call a function of the UART trace
+ * driver or the UART fax & data driver.
+ * All functions SER_bt_xxx call a function of the UART Bluetooth HCI driver.
+ * See the function call for parameters and return values.
+ *
+ ******************************************************************************/
+ 
+void
+SER_tr_Init (int serial_data_flow,
+             T_tr_Baudrate baudrate,
+             void (callback_function (void)))
+{
+    tr_functions[serial_data_flow]->tr_Init (
+                tr_functions[serial_data_flow]->device, baudrate, callback_function);
+}
+
+SYS_UWORD32
+SER_tr_ReadNChars (int serial_data_flow,
+                   char *buffer,
+                   SYS_UWORD32 chars_to_read)
+{
+    return (tr_functions[serial_data_flow]->tr_ReadNChars (
+                tr_functions[serial_data_flow]->device, buffer, chars_to_read));
+}
+
+SYS_UWORD32
+SER_tr_ReadNBytes (int serial_data_flow,
+                   char *buffer,
+                   SYS_UWORD32 chars_to_read,
+                   SYS_BOOL *eof_detected)
+{
+    return (tr_functions[serial_data_flow]->tr_ReadNBytes (
+                tr_functions[serial_data_flow]->device, buffer, chars_to_read, eof_detected));
+}
+
+SYS_UWORD32
+SER_tr_WriteNChars (int serial_data_flow,
+                    char *buffer,
+                    SYS_UWORD32 chars_to_write)
+{
+    return (tr_functions[serial_data_flow]->tr_WriteNChars (
+                tr_functions[serial_data_flow]->device, buffer, chars_to_write));
+}
+
+SYS_UWORD32
+SER_tr_EncapsulateNChars (int serial_data_flow,
+                          char *buffer,
+                          SYS_UWORD32 chars_to_write)
+{
+    return (tr_functions[serial_data_flow]->tr_EncapsulateNChars (
+                tr_functions[serial_data_flow]->device, buffer, chars_to_write));
+}
+
+SYS_UWORD32
+SER_tr_WriteNBytes (int serial_data_flow,
+                    SYS_UWORD8 *buffer,
+                    SYS_UWORD32 chars_to_write)
+{
+    return (tr_functions[serial_data_flow]->tr_WriteNBytes (
+                tr_functions[serial_data_flow]->device, buffer, chars_to_write));
+}
+
+void
+SER_tr_WriteChar (int serial_data_flow,
+                  char character)
+{
+    tr_functions[serial_data_flow]->tr_WriteChar (
+                tr_functions[serial_data_flow]->device, character);
+}
+
+void
+SER_tr_WriteString (int serial_data_flow,
+                    char *buffer)
+{
+    tr_functions[serial_data_flow]->tr_WriteString (
+                tr_functions[serial_data_flow]->device, buffer);
+}
+
+SYS_BOOL
+SER_tr_EnterSleep (int serial_data_flow)
+{
+    return (tr_functions[serial_data_flow]->tr_EnterSleep (
+                tr_functions[serial_data_flow]->device));
+}
+
+void
+SER_tr_WakeUp (int serial_data_flow)
+{
+    tr_functions[serial_data_flow]->tr_WakeUp (
+                tr_functions[serial_data_flow]->device);
+}
+
+/* Dummy function for backward compatibility. */
+T_FDRET
+SER_fd_Init (void)
+{
+    return (FD_OK);
+}
+
+T_FDRET
+SER_fd_Initialize (void)
+{
+    T_FDRET status;
+    
+    #ifdef SERIAL_DYNAMIC_SWITCH
+      data_flow_parameters.bufSize = FD_MAX_BUFFER_SIZE;
+    #else
+      bufSize = FD_MAX_BUFFER_SIZE;
+    #endif
+    status = fd_functions->fd_Initialize (fd_functions->device);
+
+    #ifdef SERIAL_DYNAMIC_SWITCH
+      /*
+       *  Check if the UARTFAX driver has actually been initialized.
+       */
+
+      if ((fd_functions->fd_Initialize == UAF_Init) &&
+          (status = FD_OK)) {
+
+          uart_fd_initialized = 1;
+      }
+    #endif
+
+    return (status);
+}
+
+T_FDRET
+SER_fd_Enable (SYS_BOOL enable)
+{
+    return (fd_functions->fd_Enable (fd_functions->device, enable));
+}
+
+T_FDRET
+SER_fd_SetComPar (T_baudrate baudrate,
+                  T_bitsPerCharacter bpc,
+                  T_stopBits sb,
+                  T_parity parity)
+{
+
+    #ifdef SERIAL_DYNAMIC_SWITCH
+      if (fd_UAF_SetComPar < 2) {
+
+          /*
+           * Stores the parameters in order to be able to retrieve them in case of
+           * Dynamic Sitch.
+           */
+
+          data_flow_parameters.baudrate[fd_UAF_SetComPar] = baudrate;
+          data_flow_parameters.bpc[fd_UAF_SetComPar]      = bpc;
+          data_flow_parameters.sb[fd_UAF_SetComPar]       = sb;
+          data_flow_parameters.parity[fd_UAF_SetComPar]   = parity;
+
+          /*
+           * Number of calls to SER_fd_SetComPar.
+           */
+
+          fd_UAF_SetComPar++;
+      }
+    #endif
+
+    return (fd_functions->fd_SetComPar (
+                fd_functions->device, baudrate, bpc, sb, parity));
+}
+
+T_FDRET
+SER_fd_SetBuffer (SYS_UWORD16 bufSize,
+                  SYS_UWORD16 rxThreshold,
+                  SYS_UWORD16 txThreshold)
+{
+
+    #ifdef SERIAL_DYNAMIC_SWITCH
+      if (fd_UAF_SetBuffer < 1) {
+
+          /*
+           * Stores the parameters in order to be able to retrieve them in case of
+           * Dynamic Sitch.
+           */
+
+          data_flow_parameters.bufSize     = bufSize;
+          data_flow_parameters.rxThreshold = rxThreshold;
+          data_flow_parameters.txThreshold = txThreshold;
+
+          /*
+           * Number of calls to SER_fd_SetBuffer.
+           */
+
+          fd_UAF_SetBuffer++;
+      }
+    #endif
+
+    return (fd_functions->fd_SetBuffer (
+                fd_functions->device, bufSize, rxThreshold, txThreshold));
+}
+
+T_FDRET
+SER_fd_SetFlowCtrl (T_flowCtrlMode fcMode,
+                    SYS_UWORD8 XON,
+                    SYS_UWORD8 XOFF)
+{
+
+    #ifdef SERIAL_DYNAMIC_SWITCH
+      if (fd_UAF_SetFlowCtrl < 2) {
+
+          /*
+           * Stores the parameters in order to be able to retrieve them in case of
+           * Dynamic Sitch.
+           */
+
+          data_flow_parameters.fcMode[fd_UAF_SetFlowCtrl] = fcMode;
+          data_flow_parameters.XON[fd_UAF_SetFlowCtrl]    = XON;
+          data_flow_parameters.XOFF[fd_UAF_SetFlowCtrl]   = XOFF;
+
+          /*
+           * Number of calls to SER_fd_SetFlowCtrl.
+           */
+
+          fd_UAF_SetFlowCtrl++;
+      }
+    #endif
+
+    return (fd_functions->fd_SetFlowCtrl (
+                fd_functions->device, fcMode, XON, XOFF));
+}
+
+T_FDRET
+SER_fd_SetEscape (char escChar,
+                  SYS_UWORD16 guardPeriod)
+{
+
+    #ifdef SERIAL_DYNAMIC_SWITCH
+      if (fd_UAF_SetEscape < 2) {
+
+          /*
+           * Stores the parameters in order to be able to retrieve them in case of
+           * Dynamic Sitch.
+           */
+
+          data_flow_parameters.escChar[fd_UAF_SetEscape]     = escChar;
+          data_flow_parameters.guardPeriod[fd_UAF_SetEscape] = guardPeriod;
+
+          /*
+           * Number of calls to SER_fd_SetEscape.
+           */
+
+          fd_UAF_SetEscape++;
+      }
+    #endif
+
+    return (fd_functions->fd_SetEscape (
+                fd_functions->device, escChar, guardPeriod));
+}
+
+T_FDRET
+SER_fd_InpAvail (void)
+{
+    return (fd_functions->fd_InpAvail (fd_functions->device));
+}
+
+T_FDRET
+SER_fd_OutpAvail (void)
+{
+    return (fd_functions->fd_OutpAvail (fd_functions->device));
+}
+
+T_FDRET
+SER_fd_EnterSleep (void)
+{
+    return (fd_functions->fd_EnterSleep (fd_functions->device));
+}
+
+T_FDRET
+SER_fd_WakeUp (void)
+{
+    return (fd_functions->fd_WakeUp (fd_functions->device));
+}
+
+T_FDRET
+SER_fd_ReadData (T_suspendMode suspend,
+                 void (readOutFunc (SYS_BOOL cldFromIrq,
+                                    T_reInstMode *reInstall,
+                                    SYS_UWORD8 nsource,
+                                    SYS_UWORD8 *source[],
+                                    SYS_UWORD16 size[],
+                                    SYS_UWORD32 state)))
+{
+
+    #ifdef SERIAL_DYNAMIC_SWITCH
+      if (fd_UAF_ReadData < 1) {
+
+          /*
+           * Stores the parameters in order to be able to retrieve them in case of
+           * Dynamic Sitch.
+           */
+
+          data_flow_parameters.suspend_rd  = suspend;
+          data_flow_parameters.readOutFunc = readOutFunc;
+
+          /*
+           * Number of calls to SER_fd_ReadData.
+           */
+
+          fd_UAF_ReadData++;
+      }
+    #endif
+
+    return (fd_functions->fd_ReadData (
+                fd_functions->device, suspend, readOutFunc));
+}
+
+T_FDRET
+SER_fd_WriteData (T_suspendMode suspend,
+                  void (writeInFunc (SYS_BOOL cldFromIrq,
+                                     T_reInstMode *reInstall,
+                                     SYS_UWORD8 ndest,
+                                     SYS_UWORD8 *dest[],
+                                     SYS_UWORD16 size[])))
+{
+
+    #ifdef SERIAL_DYNAMIC_SWITCH
+      if (fd_UAF_WriteData < 1) {
+
+          /*
+           * Stores the parameters in order to be able to retrieve them in case of
+           * Dynamic Sitch.
+           */
+
+          data_flow_parameters.suspend_wr  = suspend;
+          data_flow_parameters.writeInFunc = writeInFunc;
+
+          /*
+           * Number of calls to SER_fd_WriteData.
+           */
+
+          fd_UAF_WriteData++;
+      }
+    #endif
+
+    return (fd_functions->fd_WriteData (
+                fd_functions->device, suspend, writeInFunc));
+}
+
+T_FDRET
+SER_fd_StopRec (void)
+{
+    return (fd_functions->fd_StopRec (fd_functions->device));
+}
+
+T_FDRET
+SER_fd_StartRec (void)
+{
+    return (fd_functions->fd_StartRec (fd_functions->device));
+}
+
+T_FDRET
+SER_fd_GetLineState (SYS_UWORD32 *state)
+{
+    return (fd_functions->fd_GetLineState (fd_functions->device, state));
+}
+
+T_FDRET
+SER_fd_SetLineState (SYS_UWORD32 state,
+                     SYS_UWORD32 mask)
+{
+
+    #ifdef SERIAL_DYNAMIC_SWITCH
+      if (fd_UAF_SetLineState < 4) {
+
+          /*
+           * Stores the parameters in order to be able to retrieve them in case of
+           * Dynamic Sitch.
+           */
+
+          data_flow_parameters.state[fd_UAF_SetLineState] = state;
+          data_flow_parameters.mask[fd_UAF_SetLineState]  = mask;
+
+          /*
+           * Number of calls to SER_fd_SetLineState.
+           */
+
+          fd_UAF_SetLineState++;
+      }
+    #endif
+
+    return (fd_functions->fd_SetLineState (fd_functions->device, state, mask));
+}
+
+T_FDRET
+SER_fd_CheckXEmpty (void)
+{
+    return (fd_functions->fd_CheckXEmpty (fd_functions->device));
+}
+
+#ifdef BTEMOBILE
+T_HCI_RET
+SER_bt_Init (void)
+{
+    return (bt_functions->bt_Init (bt_functions->device));
+}
+
+T_HCI_RET
+SER_bt_Start (void)
+{
+    return (bt_functions->bt_Start ());
+}
+
+T_HCI_RET
+SER_bt_Stop (void)
+{
+    return (bt_functions->bt_Stop ());
+}
+
+T_HCI_RET
+SER_bt_Kill (void)
+{
+    return (bt_functions->bt_Kill ());
+}
+
+T_HCI_RET
+SER_bt_SetBaudrate (UINT8 baudrate)
+{
+    return (bt_functions->bt_SetBaudrate (baudrate));
+}
+
+T_HCI_RET SER_bt_TransmitPacket (void *uart_tx_buffer)
+{
+    return (bt_functions->bt_TransmitPacket (uart_tx_buffer));
+}
+
+SYS_BOOL SER_bt_EnterSleep (void)
+{
+    return (bt_functions->bt_EnterSleep());
+}
+
+void SER_bt_WakeUp (void)
+{
+    bt_functions->bt_WakeUp();
+}
+#endif /* BTEMOBILE */
+
+/*******************************************************************************
+ *
+ *                          SER_UartSleepStatus
+ *
+ * Purpose: This function checks if both UARTs are ready to enter Deep Sleep. 
+ *
+ * Parameters: In : none
+ *             Out: none 
+ *
+ * Return: 0	 : Deep Sleep is not possible.
+ *         >= 1  : Deep Sleep is possible.
+ *
+ ******************************************************************************/
+
+SYS_BOOL
+SER_UartSleepStatus (void)
+{
+    t_uart   *uart;
+    int      uart_id;
+    SYS_BOOL status;
+
+    /*
+     * Check first if the sleep timer is active or if a Dynamic Switch is
+     * being processed. A return is used to simplify the code.
+     */
+
+#ifdef SERIAL_DYNAMIC_SWITCH
+    if (uart_sleep_timer_enabled || dynamic_switch)
+#else
+    if (uart_sleep_timer_enabled)
+#endif
+        return (0);
+
+    /*
+     * Check if both UARTs are ready to enter Deep Sleep.
+     */
+
+    status = 1;
+    uart_id = 0;
+    while ((uart_id < NUMBER_OF_TR_UART) &&
+           (status)) {
+
+           uart = &(int_uart[uart_id]);
+
+           /*
+            * Check if the specified UART is actually used.
+            */
+
+           if (uart->device_used) {
+
+               /*
+                * Check if the specified UART is used by a Trace or
+                * by a Fax & Data flow.
+                */
+
+               if (uart->flow_type == TRACE_FLOW)
+                   status = SER_tr_EnterSleep (uart->flow_id);
+
+               else
+                   if (uart->flow_type == FAX_DATA_FLOW)
+                       status = (SYS_BOOL) SER_fd_EnterSleep ();
+#ifdef BTEMOBILE
+                   else
+                       if (uart->flow_type == BLUETOOTH_HCI_FLOW) 
+                           status = SER_bt_EnterSleep();
+#endif
+                       else
+                           status = 0;
+
+               if (status) {
+
+                   /*
+    	            * The specified UART is now set up for Deep Sleep.
+    	            */
+
+                   uart->deep_sleep_set_up = 1;
+
+               }
+           }
+
+           uart_id++;
+    }
+
+    /*
+     * Check if Deep Sleep is finally possible.
+     * If not revert eventual Deep Sleep settings.
+     */
+
+    if (!status) {
+
+        for (uart_id = 0; uart_id < NUMBER_OF_TR_UART; uart_id++) {
+
+            uart = &(int_uart[uart_id]);
+
+            /*
+             * If the specified used UART has already been set up for
+             * Deep Sleep, revert these settings.
+             */
+
+            if ((uart->device_used) &&
+                (uart->deep_sleep_set_up)) {
+
+                /*
+                 * Check if the specified UART is used by a Trace or
+                 * by a Fax & Data flow.
+                 * Bluetooth HCI can not yet handled Deep Sleep Mode.
+                 */
+
+                if (uart->flow_type == TRACE_FLOW)
+                    SER_tr_WakeUp (uart->flow_id);
+
+                else  
+                    if (uart->flow_type == FAX_DATA_FLOW) 
+                    	SER_fd_WakeUp ();
+#ifdef BTEMOBILE
+                    else 
+                        if (uart->flow_type == BLUETOOTH_HCI_FLOW)
+                            SER_bt_WakeUp ();
+#endif
+                uart->deep_sleep_set_up = 0;
+
+            }
+        }
+    }
+
+    return (status);
+}
+
+
+/*******************************************************************************
+ *
+ *                            SER_WakeUpUarts
+ *
+ * Purpose: This function wakes up used UARTs after Deep Sleep.
+ *
+ * Parameters: In : none
+ *             Out: none 
+ *
+ * Return: none
+ *
+ ******************************************************************************/
+
+void
+SER_WakeUpUarts (void)
+{
+    t_uart   *uart;
+    int      uart_id;
+
+    if (uart_sleep_timer_enabled)
+        start_uart_sleep_timer ();
+
+    for (uart_id = 0; uart_id < NUMBER_OF_TR_UART; uart_id++) {
+
+        uart = &(int_uart[uart_id]);
+
+        /*
+         * Check if the specified UART is actually used, and has not yet
+	 * been waked up.
+         */
+
+        if ((uart->device_used) &&
+            (uart->deep_sleep_set_up)) {
+
+            /*
+             * Check if the specified UART is used by a Trace or
+             * by a Fax & Data flow.
+             * Bluetooth HCI can not yet handled Deep Sleep Mode.
+             */
+
+            if (uart->flow_type == TRACE_FLOW)
+                SER_tr_WakeUp (uart->flow_id);
+
+            else
+                if (uart->flow_type == FAX_DATA_FLOW) 
+                	SER_fd_WakeUp ();
+#ifdef BTEMOBILE
+                else
+                    if (uart->flow_type == BLUETOOTH_HCI_FLOW)
+                        SER_bt_WakeUp ();
+#endif
+            /*
+             * The specified UART is no more set up for Deep Sleep.
+             */
+
+            uart->deep_sleep_set_up = 0;
+
+        }
+    }
+}
+
+
+/*******************************************************************************
+ *
+ *                         SER_restart_uart_sleep_timer
+ * 
+ * Purpose  : Resets and restarts the sleep timer each time some characters are
+ *            received.
+ *
+ * Arguments: In : none
+ *            Out: none
+ *
+ * Returns  : none
+ *
+ ******************************************************************************/
+
+void
+SER_restart_uart_sleep_timer (void)
+{
+    /*
+     * First disable the timer.
+     */
+
+    (void) NU_Control_Timer (&uart_sleep_timer,
+                             NU_DISABLE_TIMER);
+
+    /*
+     * Then start again this timer for a new period.
+     */
+
+    start_uart_sleep_timer ();
+}
+
+
+/*******************************************************************************
+ *
+ *                            SER_activate_timer_hisr
+ * 
+ * Purpose  : Activates the timer HISR to reset and restart the sleep timer
+ *            each time some characters are received.
+ *
+ * Arguments: In : none
+ *            Out: none
+ *
+ * Returns  : none
+ *
+ ******************************************************************************/
+
+void
+SER_activate_timer_hisr (void)
+{
+    (void) NU_Activate_HISR (&timer_hisr_ctrl_block);
+}
+
+
+#if ((CHIPSET == 2) || (CHIPSET == 3))
+
+/*******************************************************************************
+ *
+ *                                SER_uart_handler
+ * 
+ * Purpose  : UART interrupt handler.
+ *
+ * Arguments: In : none
+ *            Out: none
+ *
+ * Returns  : none
+ *
+ ******************************************************************************/
+
+void
+SER_uart_handler (void)
+{
+    SYS_UWORD8 interrupt_status;
+    t_uart     *uart;
+    int        uart_id;
+    SYS_BOOL   it_identified;
+
+    it_identified = 0;
+
+    /*
+     * Check first for a wake-up interrupt.
+     */
+
+    uart_id = 0;
+    while ((uart_id < NUMBER_OF_TR_UART) &&
+           (!it_identified)) {
+
+           uart = &(int_uart[uart_id]);
+           interrupt_status = READ_UART_REGISTER (uart, SSR);
+
+           if (interrupt_status & RX_CTS_WAKE_UP_STS) { /* Wake-up IT has occurred */
+
+               it_identified = 1;
+               uart_sleep_timer_enabled = 1;
+               DISABLE_WAKE_UP_INTERRUPT (uart);
+           }
+
+           uart_id++;
+    }
+
+    /*
+     * If no wake-up interrupt has been detected, check then systematically
+     * both UARTs for other interrupt causes.
+     */
+
+    if (!it_identified) {
+
+        for (uart_id = 0; uart_id < NUMBER_OF_TR_UART; uart_id++) {
+
+            uart = &(int_uart[uart_id]);
+            interrupt_status = READ_UART_REGISTER (uart, IIR) & IIR_BITS_USED;
+
+            if (!(interrupt_status & IT_NOT_PENDING)) {
+
+                it_identified = 1;
+                (*(uart->interrupt_handler)) (uart_id, interrupt_status);
+
+            } else {
+
+                if ((uart_id == UA_UART_1) && (!it_identified))
+                uart_spurious_interrupts++;
+            }
+        }
+    }
+}
+
+#elif ((CHIPSET == 4) || (CHIPSET == 5) || (CHIPSET == 6) || (CHIPSET == 7) || (CHIPSET == 8) || (CHIPSET == 9) || (CHIPSET == 10) || (CHIPSET == 11) || (CHIPSET == 12))
+
+/*******************************************************************************
+ *
+ *                                SER_uart_modem_handler
+ * 
+ * Purpose  : UART MODEM interrupt handler.
+ *
+ * Arguments: In : none
+ *            Out: none
+ *
+ * Returns  : none
+ *
+ ******************************************************************************/
+
+void
+SER_uart_modem_handler (void)
+{
+    SYS_UWORD8 interrupt_status;
+    t_uart     *uart;
+    SYS_BOOL   it_wakeup_identified;
+
+    it_wakeup_identified = 0;
+    uart = &(int_uart[UA_UART_1]);
+
+    /*
+     * Check first for a wake-up interrupt.
+     */
+
+    interrupt_status = READ_UART_REGISTER (uart, SSR);
+
+    if (interrupt_status & RX_CTS_WAKE_UP_STS) { /* Wake-up IT has occurred */
+
+        it_wakeup_identified = 1;
+        uart_sleep_timer_enabled = 1;
+#ifdef BTEMOBILE
+        if (uart->flow_type == BLUETOOTH_HCI_FLOW)
+        {
+            interrupt_status = READ_UART_REGISTER (uart, IIR) & IIR_BITS_USED;
+            (*(uart->interrupt_handler)) (UA_UART_1, interrupt_status);
+        }
+#endif /* BTEMOBILE */
+        DISABLE_WAKE_UP_INTERRUPT (uart);
+    }
+
+    /*
+     * If no wake-up interrupt has been detected, check UART for other
+     * interrupt causes.
+     */
+
+    if (!it_wakeup_identified) {
+
+        interrupt_status = READ_UART_REGISTER (uart, IIR) & IIR_BITS_USED;
+
+        if (!(interrupt_status & IT_NOT_PENDING))
+            (*(uart->interrupt_handler)) (UA_UART_1, interrupt_status);
+
+        else
+            uart_modem_spurious_interrupts++;
+    }
+}
+
+
+/*******************************************************************************
+ *
+ *                                SER_uart_irda_handler
+ * 
+ * Purpose  : UART IrDA interrupt handler.
+ *
+ * Arguments: In : none
+ *            Out: none
+ *
+ * Returns  : none
+ *
+ ******************************************************************************/
+
+void
+SER_uart_irda_handler (void)
+{
+    SYS_UWORD8 interrupt_status;
+    t_uart     *uart;
+    SYS_BOOL   it_wakeup_identified;
+
+    it_wakeup_identified = 0;
+    uart = &(int_uart[UA_UART_0]);
+
+    /*
+     * Check first for a wake-up interrupt.
+     */
+
+    interrupt_status = READ_UART_REGISTER (uart, SSR);
+
+    if (interrupt_status & RX_CTS_WAKE_UP_STS) { /* Wake-up IT has occurred */
+
+        it_wakeup_identified = 1;
+        uart_sleep_timer_enabled = 1;
+#ifdef BTEMOBILE
+        if (uart->flow_type == BLUETOOTH_HCI_FLOW)
+        {
+            interrupt_status = READ_UART_REGISTER (uart, IIR) & IIR_BITS_USED;
+            (*(uart->interrupt_handler)) (UA_UART_0, interrupt_status);
+        }
+#endif /* BTEMOBILE */
+        DISABLE_WAKE_UP_INTERRUPT (uart);
+    }
+
+    /*
+     * If no wake-up interrupt has been detected, check UART for other
+     * interrupt causes.
+     */
+
+    if (!it_wakeup_identified) {
+
+        interrupt_status = READ_UART_REGISTER (uart, IIR) & IIR_BITS_USED;
+
+        if (!(interrupt_status & IT_NOT_PENDING))
+            (*(uart->interrupt_handler)) (UA_UART_0, interrupt_status);
+
+        else
+            uart_irda_spurious_interrupts++;
+    }
+}
+
+#endif
+
+#if (CHIPSET == 12)
+  /*******************************************************************************
+   *
+   *                                SER_uart_modem2_handler
+   * 
+   * Purpose  : UART IrDA interrupt handler.
+   *
+   * Arguments: In : none
+   *            Out: none
+   *
+   * Returns  : none
+   *
+   ******************************************************************************/
+
+  void
+  SER_uart_modem2_handler (void)
+  {
+      SYS_UWORD8 interrupt_status;
+      t_uart     *uart;
+      SYS_BOOL   it_wakeup_identified;
+
+      it_wakeup_identified = 0;
+      uart = &(int_uart[UA_UART_2]);
+
+      /*
+       * Check first for a wake-up interrupt.
+       */
+
+      interrupt_status = READ_UART_REGISTER (uart, SSR);
+
+      if (interrupt_status & RX_CTS_WAKE_UP_STS) { /* Wake-up IT has occurred */
+
+          it_wakeup_identified = 1;
+          uart_sleep_timer_enabled = 1;
+#ifdef BTEMOBILE
+          if (uart->flow_type == BLUETOOTH_HCI_FLOW)
+          {
+              interrupt_status = READ_UART_REGISTER (uart, IIR) & IIR_BITS_USED;
+              (*(uart->interrupt_handler)) (UA_UART_2, interrupt_status);
+          }
+#endif /* BTEMOBILE */
+          DISABLE_WAKE_UP_INTERRUPT (uart);
+      }
+
+      /*
+       * If no wake-up interrupt has been detected, check UART for other
+       * interrupt causes.
+       */
+
+      if (!it_wakeup_identified) {
+
+          interrupt_status = READ_UART_REGISTER (uart, IIR) & IIR_BITS_USED;
+
+          if (!(interrupt_status & IT_NOT_PENDING))
+              (*(uart->interrupt_handler)) (UA_UART_2, interrupt_status);
+        
+          else
+              uart_modem2_spurious_interrupts++;
+      }
+  }
+
+#endif
+
+/*
+ * Temporary functions. 
+ */
+
+void
+UT_Init (int device_id,
+         int baudrate,
+         void (callback_function (void)))
+{
+    SER_tr_Init (SER_PROTOCOL_STACK, baudrate, callback_function);
+}
+
+SYS_UWORD32
+UT_ReadNChars (int device_id,
+               char *buffer,
+               SYS_UWORD32 chars_to_read)
+{
+    return (SER_tr_ReadNChars (SER_PROTOCOL_STACK, buffer, chars_to_read));
+}
+
+SYS_UWORD32
+UT_WriteNChars (int device_id,
+                char *buffer,
+                SYS_UWORD32 chars_to_write)
+{
+    return (SER_tr_WriteNChars (SER_PROTOCOL_STACK, buffer, chars_to_write));
+}
+
+void
+UT_WriteChar (int device_id,
+              char character)
+{
+    SER_tr_WriteChar (SER_PROTOCOL_STACK, character);
+}
+
+void
+UT_WriteString (int device_id,
+                char *buffer)
+{
+    SER_tr_WriteString (SER_PROTOCOL_STACK, buffer);
+}
+
+short
+UF_Init (SYS_UWORD8 deviceNo)
+{
+    return (SER_fd_Init ());
+}
+
+short
+UF_Enable (SYS_UWORD8 deviceNo,
+           SYS_BOOL enable)
+{
+    return (SER_fd_Enable (enable));
+}
+
+short
+UF_SetComPar (SYS_UWORD8 deviceNo,
+              T_baudrate baudrate,
+              T_bitsPerCharacter bpc,
+              T_stopBits sb,
+              T_parity parity)
+{
+    return (SER_fd_SetComPar (baudrate,
+                              bpc,
+                              sb,
+                              parity));
+}
+
+short
+UF_SetBuffer (SYS_UWORD8 deviceNo,
+              SYS_UWORD16 bufSize,
+              SYS_UWORD16 rxThreshold,
+              SYS_UWORD16 txThreshold)
+{
+    return (SER_fd_SetBuffer (bufSize, rxThreshold, txThreshold));
+}
+
+short
+UF_SetFlowCtrl (SYS_UWORD8 deviceNo,
+                T_flowCtrlMode fcMode,
+                SYS_UWORD8 XON,
+                SYS_UWORD8 XOFF)
+{
+    return (SER_fd_SetFlowCtrl (fcMode, XON, XOFF));
+}
+
+short
+UF_SetEscape (SYS_UWORD8 deviceNo,
+              SYS_UWORD8 escChar,
+              SYS_UWORD16 guardPeriod)
+{
+    return (SER_fd_SetEscape (escChar, guardPeriod));
+}
+
+short
+UF_InpAvail (SYS_UWORD8 deviceNo)
+{
+    return (SER_fd_InpAvail ());
+}
+
+short
+UF_OutpAvail (SYS_UWORD8 deviceNo)
+{
+    return (SER_fd_OutpAvail ());
+}
+
+short
+UF_ReadData (SYS_UWORD8 deviceNo,
+             T_suspendMode suspend,
+             void (readOutFunc (SYS_BOOL cldFromIrq,
+                                T_reInstMode *reInstall,
+                                SYS_UWORD8 nsource,
+                                SYS_UWORD8 *source[],
+                                SYS_UWORD16 size[],
+                                SYS_UWORD32 state)))
+{
+    return (SER_fd_ReadData (suspend, readOutFunc));
+}
+
+short
+UF_WriteData (SYS_UWORD8 deviceNo,
+              T_suspendMode suspend,
+              void (writeInFunc (SYS_BOOL cldFromIrq,
+                                 T_reInstMode *reInstall,
+                                 SYS_UWORD8 ndest,
+                                 SYS_UWORD8 *dest[],
+                                 SYS_UWORD16 size[])))
+{
+    return (SER_fd_WriteData (suspend, writeInFunc));
+}
+
+short
+UF_StopRec (SYS_UWORD8 deviceNo)
+{
+    return (SER_fd_StopRec ());
+}
+
+short
+UF_StartRec (SYS_UWORD8 deviceNo)
+{
+    return (SER_fd_StartRec ());
+}
+
+short
+UF_GetLineState (SYS_UWORD8 deviceNo,
+                 SYS_UWORD32 *state)
+{
+    return (SER_fd_GetLineState (state));
+}
+
+short
+UF_SetLineState (SYS_UWORD8 deviceNo,
+                 SYS_UWORD32 state,
+                 SYS_UWORD32 mask)
+{
+    return (SER_fd_SetLineState (state, mask));
+}
+
+short
+UF_CheckXEmpty (SYS_UWORD8 deviceNo)
+{
+    return (SER_fd_CheckXEmpty ());
+}