FreeCalypso > hg > fc-magnetite
view cdg211/prim/aci.pdf @ 600:8f50b202e81f
board preprocessor conditionals: prep for more FC hw in the future
This change eliminates the CONFIG_TARGET_FCDEV3B preprocessor symbol and
all preprocessor conditionals throughout the code base that tested for it,
replacing them with CONFIG_TARGET_FCFAM or CONFIG_TARGET_FCMODEM. These
new symbols are specified as follows:
CONFIG_TARGET_FCFAM is intended to cover all hardware designs created by
Mother Mychaela under the FreeCalypso trademark. This family will include
modem products (repackagings of the FCDEV3B, possibly with RFFE or even
RF transceiver changes), and also my desired FreeCalypso handset product.
CONFIG_TARGET_FCMODEM is intended to cover all FreeCalypso modem products
(which will be firmware-compatible with the FCDEV3B if they use TI Rita
transceiver, or will require a different fw build if we switch to one of
Silabs Aero transceivers), but not the handset product. Right now this
CONFIG_TARGET_FCMODEM preprocessor symbol is used to conditionalize
everything dealing with MCSI.
At the present moment the future of FC hardware evolution is still unknown:
it is not known whether we will ever have any beyond-FCDEV3B hardware at all
(contingent on uncertain funding), and if we do produce further FC hardware
designs, it is not known whether they will retain the same FIC modem core
(triband), if we are going to have a quadband design that still retains the
classic Rita transceiver, or if we are going to switch to Silabs Aero II
or some other transceiver. If we produce a quadband modem that still uses
Rita, it will run exactly the same fw as the FCDEV3B thanks to the way we
define TSPACT signals for the RF_FAM=12 && CONFIG_TARGET_FCFAM combination,
and the current fcdev3b build target will be renamed to fcmodem. OTOH, if
that putative quadband modem will be Aero-based, then it will require a
different fw build target, the fcdev3b target will stay as it is, and the
two targets will both define CONFIG_TARGET_FCFAM and CONFIG_TARGET_FCMODEM,
but will have different RF_FAM numbers. But no matter which way we are
going to evolve, it is not right to have conditionals on CONFIG_TARGET_FCDEV3B
in places like ACI, and the present change clears the way for future
evolution.
author | Mychaela Falconia <falcon@freecalypso.org> |
---|---|
date | Mon, 01 Apr 2019 01:05:24 +0000 |
parents | 56abf6cf8a0b |
children |
line wrap: on
line source
;******************************************************************************** ;*** File : aci.pdf ;*** Creation : Fri Jun 08 13:57:02 CST 2007 ;*** XSLT Processor : Apache Software Foundation / http://xml.apache.org/xalan-j / supports XSLT-Ver: 1 ;*** Copyright : (c) Texas Instruments AG, Berlin Germany 2002 ;******************************************************************************** ;*** Document Type : Service Access Point Specification ;*** Document Name : aci ;*** Document No. : 8411.105.00.205 ;*** Document Date : 2004-06-01 ;*** Document Status: BEING_PROCESSED ;*** Document Author: Liyi Yu ;******************************************************************************** PRAGMA SRC_FILE_TIME "Mon Jun 7 15:08:48 2004" PRAGMA LAST_MODIFIED "2004-06-01" PRAGMA ID_AND_VERSION "8411.105.00.205" CONST MAX_CMD_LEN 380 ; length of one ACI command sequence CONST MAX_TRC_LEN 80 ; Max. length of one ACI trace buffer CONST MAX_DATA_LEN 200 ; length of the signal data VALTAB VAL_cmd_src VAL 0 CMD_SRC_INT "Command from internal application" VAL 1 CMD_SRC_EXT "Command from external application" VAL 255 CMD_SRC_UNKNOWN "Reserved" VALTAB VAL_urt_stat VAL 0 URT_RDY_TO_SEND "URT is ready to accept new data" VAL 1 URT_DATA_AVAIL "URT has data available" VAL 255 URT_STAT_UNKNOWN "Reserved" VALTAB VAL_cause VAL 0 ABT_ABORT_DATA "Abort data mode" VAL 1 ABT_ABORT_CMD "Abort current command" VALTAB VAL_ackflg VAL 0 ACI_NAK "Not Acknowledge" VAL 1 ACI_ACK "Acknowledge" VAR cmd_src "Command source" B VAL @p_aci - VAL_cmd_src@ VAR cmd_len "Length of command" S VAR cmd_seq "Command sequence" B VAR urt_stat "URT status" B VAL @p_aci - VAL_urt_stat@ VAR cause "Cause" B VAL @p_aci - VAL_cause@ VAR ackflg "Acknowledge flag" B VAL @p_aci - VAL_ackflg@ VAR port_nb "port pumber" L VAR src_id "ACI source ID" B VAR trc_len "Length of trace" S VAR trc_buf "Trace buffer" B VAR cmd_ptr "Command index" L VAR signal_id "Signal Id" S VAR data "Signal data" L ; ACI_CMD_REQ 0x1500 ; ACI_CMD_CNF 0x5502 ; ACI_CMD_IND 0x5500 ; ACI_CMD_RES 0x1502 ; ACI_ABORT_REQ 0x1501 ; ACI_URT_STAT_IND 0x5501 ; ACI_INIT_IND 0x5503 ; ACI_INIT_RES 0x1503 ; ACI_DEINIT_REQ 0x1504 ; ACI_DEINIT_CNF 0x5504 ; ACI_OPEN_PORT_REQ 0x1505 ; ACI_OPEN_PORT_CNF 0x5505 ; ACI_CLOSE_PORT_REQ 0x1506 ; ACI_CLOSE_PORT_CNF 0x5506 ; ACI_ABORT_CNF 0x5507 ; ACI_CMD_REQ_BT 0x1507 ; ACI_CMD_CNF_BT 0x5508 ; ACI_CMD_IND_BT 0x5509 ; ACI_CMD_RES_BT 0x1508 ; ACI_ABORT_REQ_BT 0x1509 ; ACI_ABORT_CNF_BT 0x5510 ; ACI_TRC_IND 0x550A ; ACI_RIV_CMD_REQ 0x1510 ; ACI_EXT_IND 0x150B PRIM ACI_CMD_REQ 0x1500 { cmd_src ; Command source cmd_len ; length of command cmd_seq [MAX_CMD_LEN] ; Command } PRIM ACI_CMD_CNF 0x5502 { cmd_len ; length of the command cmd_seq [MAX_CMD_LEN] ; command } PRIM ACI_CMD_IND 0x5500 { cmd_len ; length of the command cmd_seq [MAX_CMD_LEN] ; command } PRIM ACI_CMD_RES 0x1502 { } PRIM ACI_ABORT_REQ 0x1501 { cmd_src ; Command source cause ; Abort cause } PRIM ACI_URT_STAT_IND 0x5501 { urt_stat ; status of URT } PRIM ACI_INIT_IND 0x5503 { } PRIM ACI_INIT_RES 0x1503 { ackflg ; Acknowledge } PRIM ACI_DEINIT_REQ 0x1504 { } PRIM ACI_DEINIT_CNF 0x5504 { } PRIM ACI_OPEN_PORT_REQ 0x1505 { port_nb ; port number } PRIM ACI_OPEN_PORT_CNF 0x5505 { port_nb ; port number ackflg ; result } PRIM ACI_CLOSE_PORT_REQ 0x1506 { port_nb ; port number } PRIM ACI_CLOSE_PORT_CNF 0x5506 { port_nb ; port number } PRIM ACI_ABORT_CNF 0x5507 { cmd_len ; length of the command cmd_seq [MAX_CMD_LEN] ; command } PRIM ACI_CMD_REQ_BT 0x1507 { cmd_src ; Command source cmd_len ; length of command cmd_seq [MAX_CMD_LEN] ; Command src_id ; ACI source } PRIM ACI_CMD_CNF_BT 0x5508 { cmd_len ; length of the command cmd_seq [MAX_CMD_LEN] ; command src_id ; ACI source } PRIM ACI_CMD_IND_BT 0x5509 { cmd_len ; length of the command cmd_seq [MAX_CMD_LEN] ; command src_id ; ACI source } PRIM ACI_CMD_RES_BT 0x1508 { src_id ; ACI source } PRIM ACI_ABORT_REQ_BT 0x1509 { cmd_src ; Command source cause ; Abort cause src_id ; ACI source } PRIM ACI_ABORT_CNF_BT 0x5510 { src_id ; ACI source } PRIM ACI_TRC_IND 0x550A { cmd_src ; Command source trc_len ; length of trace trc_buf [MAX_TRC_LEN] ; trace } PRIM ACI_RIV_CMD_REQ 0x1510 { cmd_ptr ; Command index } PRIM ACI_EXT_IND 0x150B { signal_id ; Signal Id data [MAX_DATA_LEN] ; data of the signal }