Convert all comments into "doxygen-ready" comments.
Bug: 36453077 Test: make Change-Id: Ic77394d4d2e1ccedba3a28230d870c5d6108bd40
This commit is contained in:
parent
2f44ec6c86
commit
675ae49ab1
18 changed files with 450 additions and 449 deletions
|
@ -18,7 +18,7 @@ package android.hardware.bluetooth@1.0;
|
|||
|
||||
import IBluetoothHciCallbacks;
|
||||
|
||||
/*
|
||||
/**
|
||||
* The Host Controller Interface (HCI) is the layer defined by the Bluetooth
|
||||
* specification between the software that runs on the host and the Bluetooth
|
||||
* controller chip. This boundary is the natural choice for a Hardware
|
||||
|
|
|
@ -16,7 +16,7 @@
|
|||
|
||||
package android.hardware.bluetooth@1.0;
|
||||
|
||||
/* The interface from the Bluetooth Controller to the stack. */
|
||||
/** The interface from the Bluetooth Controller to the stack. */
|
||||
interface IBluetoothHciCallbacks {
|
||||
/**
|
||||
* Invoked when the Bluetooth controller initialization has been
|
||||
|
|
|
@ -17,7 +17,7 @@
|
|||
package android.hardware.ir@1.0;
|
||||
|
||||
interface IConsumerIr {
|
||||
/*
|
||||
/**
|
||||
* transmit() sends an IR pattern at a given carrierFreq.
|
||||
*
|
||||
* The pattern is alternating series of carrier on and off periods measured in
|
||||
|
@ -30,7 +30,7 @@ interface IConsumerIr {
|
|||
*/
|
||||
transmit(int32_t carrierFreq, vec<int32_t> pattern) generates (bool success);
|
||||
|
||||
/*
|
||||
/**
|
||||
* getCarrierFreqs() enumerates which frequencies the IR transmitter supports.
|
||||
*
|
||||
* returns: On success, true and a vector of all supported frequency
|
||||
|
|
|
@ -19,7 +19,7 @@ package android.hardware.nfc@1.0;
|
|||
import INfcClientCallback;
|
||||
|
||||
interface INfc {
|
||||
/*
|
||||
/**
|
||||
* Opens the NFC controller device and performs initialization.
|
||||
* This may include patch download and other vendor-specific initialization.
|
||||
*
|
||||
|
@ -37,7 +37,7 @@ interface INfc {
|
|||
@callflow(next={"write", "coreInitialized", "prediscover", "powerCycle", "controlGranted"})
|
||||
open(INfcClientCallback clientCallback) generates (NfcStatus status);
|
||||
|
||||
/*
|
||||
/**
|
||||
* Performs an NCI write.
|
||||
*
|
||||
* This method may queue writes and return immediately. The only
|
||||
|
@ -49,7 +49,7 @@ interface INfc {
|
|||
"controlGranted"})
|
||||
write(NfcData data) generates (uint32_t retval);
|
||||
|
||||
/*
|
||||
/**
|
||||
* coreInitialized() is called after the CORE_INIT_RSP is received from the
|
||||
* NFCC. At this time, the HAL can do any chip-specific configuration.
|
||||
*
|
||||
|
@ -62,7 +62,7 @@ interface INfc {
|
|||
@callflow(next={"write", "prediscover", "close"})
|
||||
coreInitialized(NfcData data) generates (NfcStatus status);
|
||||
|
||||
/*
|
||||
/**
|
||||
* prediscover is called every time before starting RF discovery.
|
||||
* It is a good place to do vendor-specific configuration that must be
|
||||
* performed every time RF discovery is about to be started.
|
||||
|
@ -76,7 +76,7 @@ interface INfc {
|
|||
@callflow(next={"write", "close", "coreInitialized", "powerCycle", "controlGranted"})
|
||||
prediscover() generates (NfcStatus status);
|
||||
|
||||
/*
|
||||
/**
|
||||
* Close the NFC controller. Should free all resources.
|
||||
*
|
||||
* @return NfcStatus::OK on success and NfcStatus::FAILED on error.
|
||||
|
@ -84,7 +84,7 @@ interface INfc {
|
|||
@exit
|
||||
close() generates (NfcStatus status);
|
||||
|
||||
/*
|
||||
/**
|
||||
* Grant HAL the exclusive control to send NCI commands.
|
||||
* Called in response to NfcEvent.REQUEST_CONTROL.
|
||||
* Must only be called when there are no NCI commands pending.
|
||||
|
@ -95,7 +95,7 @@ interface INfc {
|
|||
@callflow(next={"write", "close", "prediscover", "coreInitialized", "powerCycle"})
|
||||
controlGranted() generates (NfcStatus status);
|
||||
|
||||
/*
|
||||
/**
|
||||
* Restart controller by power cyle;
|
||||
* NfcEvent.OPEN_CPLT will notify when operation is complete.
|
||||
*
|
||||
|
|
|
@ -17,13 +17,13 @@
|
|||
package android.hardware.nfc@1.0;
|
||||
|
||||
interface INfcClientCallback {
|
||||
/*
|
||||
/**
|
||||
* The callback passed in from the NFC stack that the HAL
|
||||
* can use to pass events back to the stack.
|
||||
*/
|
||||
sendEvent(NfcEvent event, NfcStatus status);
|
||||
|
||||
/*
|
||||
/**
|
||||
* The callback passed in from the NFC stack that the HAL
|
||||
* can use to pass incomming data to the stack.
|
||||
*/
|
||||
|
|
File diff suppressed because it is too large
Load diff
|
@ -16,11 +16,11 @@
|
|||
|
||||
package android.hardware.radio@1.0;
|
||||
|
||||
/*
|
||||
/**
|
||||
* Interface declaring unsolicited radio indications.
|
||||
*/
|
||||
interface IRadioIndication {
|
||||
/*
|
||||
/**
|
||||
* Indicates when radio state changes.
|
||||
*
|
||||
* @param type Type of radio indication
|
||||
|
@ -28,7 +28,7 @@ interface IRadioIndication {
|
|||
*/
|
||||
oneway radioStateChanged(RadioIndicationType type, RadioState radioState);
|
||||
|
||||
/*
|
||||
/**
|
||||
* Indicates when call state has changed.
|
||||
* Callee must invoke IRadio.getCurrentCalls()
|
||||
* Must be invoked on, for example,
|
||||
|
@ -41,7 +41,7 @@ interface IRadioIndication {
|
|||
*/
|
||||
oneway callStateChanged(RadioIndicationType type);
|
||||
|
||||
/*
|
||||
/**
|
||||
* Indicates when voice or data network state changed
|
||||
* Callee must invoke IRadio.getVoiceRegistrationState(), IRadio.getDataRegistrationState(),
|
||||
* and IRadio.getOperator()
|
||||
|
@ -50,7 +50,7 @@ interface IRadioIndication {
|
|||
*/
|
||||
oneway networkStateChanged(RadioIndicationType type);
|
||||
|
||||
/*
|
||||
/**
|
||||
* Indicates when new SMS is received.
|
||||
* Callee must subsequently confirm the receipt of the SMS with a
|
||||
* acknowledgeLastIncomingGsmSms()
|
||||
|
@ -64,7 +64,7 @@ interface IRadioIndication {
|
|||
*/
|
||||
oneway newSms(RadioIndicationType type, vec<uint8_t> pdu);
|
||||
|
||||
/*
|
||||
/**
|
||||
* Indicates when new SMS Status Report is received.
|
||||
* Callee must subsequently confirm the receipt of the SMS with a
|
||||
* acknowledgeLastIncomingGsmSms()
|
||||
|
@ -78,7 +78,7 @@ interface IRadioIndication {
|
|||
*/
|
||||
oneway newSmsStatusReport(RadioIndicationType type, vec<uint8_t> pdu);
|
||||
|
||||
/*
|
||||
/**
|
||||
* Indicates when new SMS has been stored on SIM card
|
||||
*
|
||||
* @param type Type of radio indication
|
||||
|
@ -86,7 +86,7 @@ interface IRadioIndication {
|
|||
*/
|
||||
oneway newSmsOnSim(RadioIndicationType type, int32_t recordNumber);
|
||||
|
||||
/*
|
||||
/**
|
||||
* Indicates when a new USSD message is received.
|
||||
* The USSD session is assumed to persist if the type code is REQUEST, otherwise
|
||||
* the current session (if any) is assumed to have terminated.
|
||||
|
@ -97,7 +97,7 @@ interface IRadioIndication {
|
|||
*/
|
||||
oneway onUssd(RadioIndicationType type, UssdModeType modeType, string msg);
|
||||
|
||||
/*
|
||||
/**
|
||||
* Indicates when radio has received a NITZ time message.
|
||||
*
|
||||
* @param type Type of radio indication
|
||||
|
@ -106,7 +106,7 @@ interface IRadioIndication {
|
|||
*/
|
||||
oneway nitzTimeReceived(RadioIndicationType type, string nitzTime, uint64_t receivedTime);
|
||||
|
||||
/*
|
||||
/**
|
||||
* Indicates current signal strength of the radio.
|
||||
*
|
||||
* @param type Type of radio indication
|
||||
|
@ -114,7 +114,7 @@ interface IRadioIndication {
|
|||
*/
|
||||
oneway currentSignalStrength(RadioIndicationType type, SignalStrength signalStrength);
|
||||
|
||||
/*
|
||||
/**
|
||||
* Indicates data call contexts have changed.
|
||||
*
|
||||
* @param type Type of radio indication
|
||||
|
@ -127,7 +127,7 @@ interface IRadioIndication {
|
|||
*/
|
||||
oneway dataCallListChanged(RadioIndicationType type, vec<SetupDataCallResult> dcList);
|
||||
|
||||
/*
|
||||
/**
|
||||
* Reports supplementary service related notification from the network.
|
||||
*
|
||||
* @param type Type of radio indication
|
||||
|
@ -135,14 +135,14 @@ interface IRadioIndication {
|
|||
*/
|
||||
oneway suppSvcNotify(RadioIndicationType type, SuppSvcNotification suppSvc);
|
||||
|
||||
/*
|
||||
/**
|
||||
* Indicates when STK session is terminated by SIM.
|
||||
*
|
||||
* @param type Type of radio indication
|
||||
*/
|
||||
oneway stkSessionEnd(RadioIndicationType type);
|
||||
|
||||
/*
|
||||
/**
|
||||
* Indicates when SIM issue a STK proactive command to applications
|
||||
*
|
||||
* @param type Type of radio indication
|
||||
|
@ -151,7 +151,7 @@ interface IRadioIndication {
|
|||
*/
|
||||
oneway stkProactiveCommand(RadioIndicationType type, string cmd);
|
||||
|
||||
/*
|
||||
/**
|
||||
* Indicates when SIM notifies applcations some event happens.
|
||||
*
|
||||
* @param type Type of radio indication
|
||||
|
@ -162,7 +162,7 @@ interface IRadioIndication {
|
|||
*/
|
||||
oneway stkEventNotify(RadioIndicationType type, string cmd);
|
||||
|
||||
/*
|
||||
/**
|
||||
* Indicates when SIM wants application to setup a voice call.
|
||||
*
|
||||
* @param type Type of radio indication
|
||||
|
@ -170,7 +170,7 @@ interface IRadioIndication {
|
|||
*/
|
||||
oneway stkCallSetup(RadioIndicationType type, int64_t timeout);
|
||||
|
||||
/*
|
||||
/**
|
||||
* Indicates that SMS storage on the SIM is full. Sent when the network
|
||||
* attempts to deliver a new SMS message. Messages cannot be saved on the
|
||||
* SIM until space is freed. In particular, incoming Class 2 messages must not
|
||||
|
@ -180,7 +180,7 @@ interface IRadioIndication {
|
|||
*/
|
||||
oneway simSmsStorageFull(RadioIndicationType type);
|
||||
|
||||
/*
|
||||
/**
|
||||
* Indicates that file(s) on the SIM have been updated, or the SIM
|
||||
* has been reinitialized.
|
||||
* Note: If the SIM state changes as a result of the SIM refresh (eg,
|
||||
|
@ -192,7 +192,7 @@ interface IRadioIndication {
|
|||
*/
|
||||
oneway simRefresh(RadioIndicationType type, SimRefreshResult refreshResult);
|
||||
|
||||
/*
|
||||
/**
|
||||
* Ring indication for an incoming call (eg, RING or CRING event).
|
||||
* There must be at least one callRing() at the beginning
|
||||
* of a call and sending multiple is optional. If the system property
|
||||
|
@ -210,7 +210,7 @@ interface IRadioIndication {
|
|||
*/
|
||||
oneway callRing(RadioIndicationType type, bool isGsm, CdmaSignalInfoRecord record);
|
||||
|
||||
/*
|
||||
/**
|
||||
* Indicates that SIM state changes.
|
||||
* Callee must invoke getIccCardStatus()
|
||||
*
|
||||
|
@ -218,7 +218,7 @@ interface IRadioIndication {
|
|||
*/
|
||||
oneway simStatusChanged(RadioIndicationType type);
|
||||
|
||||
/*
|
||||
/**
|
||||
* Indicates when new CDMA SMS is received
|
||||
* Callee must subsequently confirm the receipt of the SMS with
|
||||
* acknowledgeLastIncomingCdmaSms()
|
||||
|
@ -230,7 +230,7 @@ interface IRadioIndication {
|
|||
*/
|
||||
oneway cdmaNewSms(RadioIndicationType type, CdmaSmsMessage msg);
|
||||
|
||||
/*
|
||||
/**
|
||||
* Indicates when new Broadcast SMS is received
|
||||
*
|
||||
* @param type Type of radio indication
|
||||
|
@ -243,7 +243,7 @@ interface IRadioIndication {
|
|||
*/
|
||||
oneway newBroadcastSms(RadioIndicationType type, vec<uint8_t> data);
|
||||
|
||||
/*
|
||||
/**
|
||||
* Indicates that SMS storage on the RUIM is full. Messages
|
||||
* cannot be saved on the RUIM until space is freed.
|
||||
*
|
||||
|
@ -251,7 +251,7 @@ interface IRadioIndication {
|
|||
*/
|
||||
oneway cdmaRuimSmsStorageFull(RadioIndicationType type);
|
||||
|
||||
/*
|
||||
/**
|
||||
* Indicates a restricted state change (eg, for Domain Specific Access Control).
|
||||
* Radio must send this msg after radio off/on cycle no matter it is changed or not.
|
||||
*
|
||||
|
@ -260,7 +260,7 @@ interface IRadioIndication {
|
|||
*/
|
||||
oneway restrictedStateChanged(RadioIndicationType type, PhoneRestrictedState state);
|
||||
|
||||
/*
|
||||
/**
|
||||
* Indicates that the radio system selection module has
|
||||
* autonomously entered emergency callback mode.
|
||||
*
|
||||
|
@ -268,7 +268,7 @@ interface IRadioIndication {
|
|||
*/
|
||||
oneway enterEmergencyCallbackMode(RadioIndicationType type);
|
||||
|
||||
/*
|
||||
/**
|
||||
* Indicates when CDMA radio receives a call waiting indication.
|
||||
*
|
||||
* @param type Type of radio indication
|
||||
|
@ -276,7 +276,7 @@ interface IRadioIndication {
|
|||
*/
|
||||
oneway cdmaCallWaiting(RadioIndicationType type, CdmaCallWaiting callWaitingRecord);
|
||||
|
||||
/*
|
||||
/**
|
||||
* Indicates when CDMA radio receives an update of the progress of an OTASP/OTAPA call.
|
||||
*
|
||||
* @param type Type of radio indication
|
||||
|
@ -284,7 +284,7 @@ interface IRadioIndication {
|
|||
*/
|
||||
oneway cdmaOtaProvisionStatus(RadioIndicationType type, CdmaOtaProvisionStatus status);
|
||||
|
||||
/*
|
||||
/**
|
||||
* Indicates when CDMA radio receives one or more info recs.
|
||||
*
|
||||
* @param type Type of radio indication
|
||||
|
@ -292,7 +292,7 @@ interface IRadioIndication {
|
|||
*/
|
||||
oneway cdmaInfoRec(RadioIndicationType type, CdmaInformationRecords records);
|
||||
|
||||
/*
|
||||
/**
|
||||
* Indicates that nework doesn't have in-band information, need to
|
||||
* play out-band tone.
|
||||
*
|
||||
|
@ -301,14 +301,14 @@ interface IRadioIndication {
|
|||
*/
|
||||
oneway indicateRingbackTone(RadioIndicationType type, bool start);
|
||||
|
||||
/*
|
||||
/**
|
||||
* Indicates that framework/application must reset the uplink mute state.
|
||||
*
|
||||
* @param type Type of radio indication
|
||||
*/
|
||||
oneway resendIncallMute(RadioIndicationType type);
|
||||
|
||||
/*
|
||||
/**
|
||||
* Indicates when CDMA subscription source changed.
|
||||
*
|
||||
* @param type Type of radio indication
|
||||
|
@ -317,7 +317,7 @@ interface IRadioIndication {
|
|||
oneway cdmaSubscriptionSourceChanged(RadioIndicationType type,
|
||||
CdmaSubscriptionSource cdmaSource);
|
||||
|
||||
/*
|
||||
/**
|
||||
* Indicates when PRL (preferred roaming list) changes.
|
||||
*
|
||||
* @param type Type of radio indication
|
||||
|
@ -325,7 +325,7 @@ interface IRadioIndication {
|
|||
*/
|
||||
oneway cdmaPrlChanged(RadioIndicationType type, int32_t version);
|
||||
|
||||
/*
|
||||
/**
|
||||
* Indicates when Emergency Callback Mode Ends.
|
||||
* Indicates that the radio system selection module has
|
||||
* proactively exited emergency callback mode.
|
||||
|
@ -334,14 +334,14 @@ interface IRadioIndication {
|
|||
*/
|
||||
oneway exitEmergencyCallbackMode(RadioIndicationType type);
|
||||
|
||||
/*
|
||||
/**
|
||||
* Indicates the ril connects and returns the version
|
||||
*
|
||||
* @param type Type of radio indication
|
||||
*/
|
||||
oneway rilConnected(RadioIndicationType type);
|
||||
|
||||
/*
|
||||
/**
|
||||
* Indicates that voice technology has changed. Responds with new rat.
|
||||
*
|
||||
* @param type Type of radio indication
|
||||
|
@ -349,7 +349,7 @@ interface IRadioIndication {
|
|||
*/
|
||||
oneway voiceRadioTechChanged(RadioIndicationType type, RadioTechnology rat);
|
||||
|
||||
/*
|
||||
/**
|
||||
* Same information as returned by getCellInfoList().
|
||||
*
|
||||
* @param type Type of radio indication
|
||||
|
@ -357,7 +357,7 @@ interface IRadioIndication {
|
|||
*/
|
||||
oneway cellInfoList(RadioIndicationType type, vec<CellInfo> records);
|
||||
|
||||
/*
|
||||
/**
|
||||
* Indicates when IMS registration state has changed.
|
||||
* To get IMS registration state and IMS SMS format, callee needs to invoke
|
||||
* getImsRegistrationState()
|
||||
|
@ -366,7 +366,7 @@ interface IRadioIndication {
|
|||
*/
|
||||
oneway imsNetworkStateChanged(RadioIndicationType type);
|
||||
|
||||
/*
|
||||
/**
|
||||
* Indicated when there is a change in subscription status.
|
||||
* This event must be sent in the following scenarios
|
||||
* - subscription readiness at modem, which was selected by telephony layer
|
||||
|
@ -378,7 +378,7 @@ interface IRadioIndication {
|
|||
*/
|
||||
oneway subscriptionStatusChanged(RadioIndicationType type, bool activate);
|
||||
|
||||
/*
|
||||
/**
|
||||
* Indicates when Single Radio Voice Call Continuity (SRVCC)
|
||||
* progress state has changed
|
||||
*
|
||||
|
@ -387,7 +387,7 @@ interface IRadioIndication {
|
|||
*/
|
||||
oneway srvccStateNotify(RadioIndicationType type, SrvccState state);
|
||||
|
||||
/*
|
||||
/**
|
||||
* Indicates when the hardware configuration associated with the RILd changes.
|
||||
*
|
||||
* @param type Type of radio indication
|
||||
|
@ -395,7 +395,7 @@ interface IRadioIndication {
|
|||
*/
|
||||
oneway hardwareConfigChanged(RadioIndicationType type, vec<HardwareConfig> configs);
|
||||
|
||||
/*
|
||||
/**
|
||||
* Sent when setRadioCapability() completes.
|
||||
* Returns the phone radio capability exactly as
|
||||
* getRadioCapability() and must be the
|
||||
|
@ -406,7 +406,7 @@ interface IRadioIndication {
|
|||
*/
|
||||
oneway radioCapabilityIndication(RadioIndicationType type, RadioCapability rc);
|
||||
|
||||
/*
|
||||
/**
|
||||
* Indicates when Supplementary service(SS) response is received when DIAL/USSD/SS is changed to
|
||||
* SS by call control.
|
||||
*
|
||||
|
@ -414,7 +414,7 @@ interface IRadioIndication {
|
|||
*/
|
||||
oneway onSupplementaryServiceIndication(RadioIndicationType type, StkCcUnsolSsResult ss);
|
||||
|
||||
/*
|
||||
/**
|
||||
* Indicates when there is an ALPHA from UICC during Call Control.
|
||||
*
|
||||
* @param type Type of radio indication
|
||||
|
@ -422,7 +422,7 @@ interface IRadioIndication {
|
|||
*/
|
||||
oneway stkCallControlAlphaNotify(RadioIndicationType type, string alpha);
|
||||
|
||||
/*
|
||||
/**
|
||||
* Indicates when there is an incoming Link Capacity Estimate (LCE) info report.
|
||||
*
|
||||
* @param type Type of radio indication
|
||||
|
@ -430,7 +430,7 @@ interface IRadioIndication {
|
|||
*/
|
||||
oneway lceData(RadioIndicationType type, LceDataInfo lce);
|
||||
|
||||
/*
|
||||
/**
|
||||
* Indicates when there is new Carrier PCO data received for a data call. Ideally
|
||||
* only new data must be forwarded, though this is not required. Multiple
|
||||
* boxes of carrier PCO data for a given call must result in a series of
|
||||
|
@ -441,7 +441,7 @@ interface IRadioIndication {
|
|||
*/
|
||||
oneway pcoData(RadioIndicationType type, PcoDataInfo pco);
|
||||
|
||||
/*
|
||||
/**
|
||||
* Indicates when there is a modem reset.
|
||||
*
|
||||
* When modem restarts, one of the following radio state transitions must happen
|
||||
|
|
File diff suppressed because it is too large
Load diff
|
@ -288,7 +288,7 @@ enum CallState : int32_t {
|
|||
WAITING, // MT call only
|
||||
};
|
||||
|
||||
/*
|
||||
/**
|
||||
* User-to-User signaling Info activation types derived from 3GPP 23.087 v8.0
|
||||
*/
|
||||
enum UusType : int32_t {
|
||||
|
@ -301,7 +301,7 @@ enum UusType : int32_t {
|
|||
TYPE3_NOT_REQUIRED,
|
||||
};
|
||||
|
||||
/*
|
||||
/**
|
||||
* User-to-User Signaling Information data coding schemes. Possible values for
|
||||
* Octet 3 (Protocol Discriminator field) in the UUIE. The values have been
|
||||
* specified in section 10.5.4.25 of 3GPP TS 24.008
|
||||
|
@ -410,7 +410,8 @@ enum LastCallFailCause : int32_t {
|
|||
// callback mode
|
||||
CDMA_ACCESS_BLOCKED = 1009,
|
||||
|
||||
/* OEM specific error codes. Used to distinguish error from
|
||||
/**
|
||||
* OEM specific error codes. Used to distinguish error from
|
||||
* CALL_FAIL_ERROR_UNSPECIFIED and help assist debugging */
|
||||
OEM_CAUSE_1 = 0xf001,
|
||||
OEM_CAUSE_2 = 0xf002,
|
||||
|
@ -526,7 +527,7 @@ enum DataCallFailCause : int32_t {
|
|||
ERROR_UNSPECIFIED = 0xffff,
|
||||
};
|
||||
|
||||
/*
|
||||
/**
|
||||
* Please note that registration state UNKNOWN is
|
||||
* treated as "out of service" in the Android telephony.
|
||||
* Registration state REG_DENIED must be returned if Location Update
|
||||
|
@ -1018,7 +1019,7 @@ enum CdmaOtaProvisionStatus : int32_t {
|
|||
OTAPA_ABORTED
|
||||
};
|
||||
|
||||
/* Names of the CDMA info records (C.S0005 section 3.7.5) */
|
||||
/** Names of the CDMA info records (C.S0005 section 3.7.5) */
|
||||
enum CdmaInfoRecName : int32_t {
|
||||
DISPLAY,
|
||||
CALLED_PARTY_NUMBER,
|
||||
|
@ -1033,7 +1034,7 @@ enum CdmaInfoRecName : int32_t {
|
|||
T53_AUDIO_CONTROL
|
||||
};
|
||||
|
||||
/* Redirecting Number Information Record as defined in C.S0005 section 3.7.5.11 */
|
||||
/** Redirecting Number Information Record as defined in C.S0005 section 3.7.5.11 */
|
||||
enum CdmaRedirectingReason : int32_t {
|
||||
UNKNOWN = 0,
|
||||
CALL_FORWARDING_BUSY = 1,
|
||||
|
@ -1187,7 +1188,7 @@ struct CardStatus {
|
|||
vec<AppStatus> applications; // size <= RadioConst:CARD_MAX_APPS
|
||||
};
|
||||
|
||||
/*
|
||||
/**
|
||||
* User-to-User Signaling Information defined in 3GPP 23.087 v8.0
|
||||
*/
|
||||
struct UusInfo {
|
||||
|
@ -1893,7 +1894,7 @@ struct SimRefreshResult {
|
|||
// For SIM_RESET result it is empty string.
|
||||
};
|
||||
|
||||
/* CDMA Signal Information Record as defined in C.S0005 section 3.7.5.5 */
|
||||
/** CDMA Signal Information Record as defined in C.S0005 section 3.7.5.5 */
|
||||
struct CdmaSignalInfoRecord {
|
||||
bool isPresent; // true if signal information record is present
|
||||
int8_t signalType; // as defined 3.7.5.5-1
|
||||
|
@ -1911,7 +1912,7 @@ struct CdmaCallWaiting {
|
|||
CdmaCallWaitingNumberPlan numberPlan;
|
||||
};
|
||||
|
||||
/*
|
||||
/**
|
||||
* Display Info Rec as defined in C.S0005 section 3.7.5.1
|
||||
* Extended Display Info Rec as defined in C.S0005 section 3.7.5.16
|
||||
* Note: the Extended Display info rec contains multiple records of the
|
||||
|
@ -1924,7 +1925,7 @@ struct CdmaDisplayInfoRecord {
|
|||
string alphaBuf; // Max length = RadioConst:CDMA_ALPHA_INFO_BUFFER_LENGTH
|
||||
};
|
||||
|
||||
/*
|
||||
/**
|
||||
* Called Party Number Info Rec as defined in C.S0005 section 3.7.5.2
|
||||
* Calling Party Number Info Rec as defined in C.S0005 section 3.7.5.3
|
||||
* Connected Number Info Rec as defined in C.S0005 section 3.7.5.4
|
||||
|
@ -1942,7 +1943,7 @@ struct CdmaRedirectingNumberInfoRecord{
|
|||
CdmaRedirectingReason redirectingReason; // redirectingReason is set to UNKNOWN if not included
|
||||
};
|
||||
|
||||
/* Line Control Information Record as defined in C.S0005 section 3.7.5.15 */
|
||||
/** Line Control Information Record as defined in C.S0005 section 3.7.5.15 */
|
||||
struct CdmaLineControlInfoRecord {
|
||||
uint8_t lineCtrlPolarityIncluded;
|
||||
uint8_t lineCtrlToggle;
|
||||
|
@ -1950,12 +1951,12 @@ struct CdmaLineControlInfoRecord {
|
|||
uint8_t lineCtrlPowerDenial;
|
||||
};
|
||||
|
||||
/* T53 CLIR Information Record */
|
||||
/** T53 CLIR Information Record */
|
||||
struct CdmaT53ClirInfoRecord {
|
||||
uint8_t cause;
|
||||
};
|
||||
|
||||
/* T53 Audio Control Information Record */
|
||||
/** T53 Audio Control Information Record */
|
||||
struct CdmaT53AudioControlInfoRecord {
|
||||
uint8_t upLink;
|
||||
uint8_t downLink;
|
||||
|
|
|
@ -18,15 +18,15 @@ package android.hardware.radio.deprecated@1.0;
|
|||
|
||||
import android.hardware.radio@1.0::types;
|
||||
|
||||
/*
|
||||
/**
|
||||
* Interface declaring unsolicited oem hook indications.
|
||||
*/
|
||||
interface IOemHookIndication {
|
||||
/*
|
||||
/**
|
||||
* This is for OEM specific use.
|
||||
*
|
||||
* @param type Type of radio indication
|
||||
* @param data data passed as raw bytes
|
||||
*/
|
||||
oneway oemHookRaw(RadioIndicationType type, vec<uint8_t> data);
|
||||
};
|
||||
};
|
||||
|
|
|
@ -18,13 +18,13 @@ package android.hardware.radio.deprecated@1.0;
|
|||
|
||||
import android.hardware.radio@1.0::types;
|
||||
|
||||
/*
|
||||
/**
|
||||
* Interface declaring response functions to solicited oem hook requests.
|
||||
* Response functions defined in this interface are as per following convention:
|
||||
* <xyz>Response is response to IOemHook.<xyz>
|
||||
*/
|
||||
interface IOemHookResponse {
|
||||
/*
|
||||
/**
|
||||
* @param info Response info struct containing response type, serial no. and error
|
||||
* @param data data returned by oem
|
||||
*
|
||||
|
@ -36,7 +36,7 @@ interface IOemHookResponse {
|
|||
*/
|
||||
oneway sendRequestRawResponse(RadioResponseInfo info, vec<uint8_t> data);
|
||||
|
||||
/*
|
||||
/**
|
||||
* @param info Response info struct containing response type, serial no. and error
|
||||
* @param data data returned by oem
|
||||
*
|
||||
|
@ -47,4 +47,4 @@ interface IOemHookResponse {
|
|||
* RadioError:OEM_ERROR_X
|
||||
*/
|
||||
oneway sendRequestStringsResponse(RadioResponseInfo info, vec<string> data);
|
||||
};
|
||||
};
|
||||
|
|
|
@ -32,7 +32,7 @@ import android.hardware.renderscript@1.0::types;
|
|||
|
||||
interface IContext {
|
||||
|
||||
/*
|
||||
/**
|
||||
* TODO: Do we need to define "selectors"? It may be a property of the
|
||||
* "adapted allocation" that's returned.
|
||||
*
|
||||
|
@ -56,7 +56,7 @@ interface IContext {
|
|||
allocationAdapterCreate(Type type, Allocation baseAlloc)
|
||||
generates (AllocationAdapter subAlloc);
|
||||
|
||||
/*
|
||||
/**
|
||||
* TODO: Need to relate "offset" back to the terminology in
|
||||
* allocationAdapterCreate() -- the latter uses the terms "selector" and
|
||||
* "selected value". Can we use consistent terminology? Are "offset" and
|
||||
|
@ -72,7 +72,7 @@ interface IContext {
|
|||
@callflow(next={"*"})
|
||||
allocationAdapterOffset(AllocationAdapter alloc, vec<uint32_t> offsets);
|
||||
|
||||
/*
|
||||
/**
|
||||
* TODO: add more explanation here.
|
||||
*
|
||||
* Returns the Type of the Allocation.
|
||||
|
@ -83,7 +83,7 @@ interface IContext {
|
|||
@callflow(next={"*"})
|
||||
allocationGetType(Allocation allocation) generates (Type type);
|
||||
|
||||
/*
|
||||
/**
|
||||
* TODO: more clarification needed describing if the pointer can be aliased
|
||||
* or if the data can outlive the allocation.
|
||||
*
|
||||
|
@ -102,7 +102,7 @@ interface IContext {
|
|||
bitfield<AllocationUsageType> usage, Ptr ptr)
|
||||
generates (Allocation allocation);
|
||||
|
||||
/*
|
||||
/**
|
||||
* Creates an Allocation from a Bitmap.
|
||||
*
|
||||
* @param type Type describing data layout
|
||||
|
@ -118,7 +118,7 @@ interface IContext {
|
|||
bitfield<AllocationUsageType> usage)
|
||||
generates (Allocation allocation);
|
||||
|
||||
/*
|
||||
/**
|
||||
* Creates a Cubemapped Allocation from a Bitmap.
|
||||
*
|
||||
* @param type Type describing data layout
|
||||
|
@ -135,7 +135,7 @@ interface IContext {
|
|||
bitfield<AllocationUsageType> usage)
|
||||
generates (Allocation allocation);
|
||||
|
||||
/*
|
||||
/**
|
||||
* Returns the handle to a raw buffer that is being managed by the screen
|
||||
* compositor. This operation is only valid for Allocations with
|
||||
* USAGE_IO_INPUT.
|
||||
|
@ -147,7 +147,7 @@ interface IContext {
|
|||
allocationGetNativeWindow(Allocation allocation)
|
||||
generates (NativeWindow nativeWindow);
|
||||
|
||||
/*
|
||||
/**
|
||||
* TODO: more clarification needed
|
||||
*
|
||||
* Sets the NativeWindow of an Allocation. This operation is only valid
|
||||
|
@ -159,7 +159,7 @@ interface IContext {
|
|||
@callflow(next={"*"})
|
||||
allocationSetNativeWindow(Allocation allocation, NativeWindow nativewindow);
|
||||
|
||||
/*
|
||||
/**
|
||||
* Initialize BufferQueue with specified max number of buffers.
|
||||
*
|
||||
* @param alloc Allocation
|
||||
|
@ -168,7 +168,7 @@ interface IContext {
|
|||
@callflow(next={"*"})
|
||||
allocationSetupBufferQueue(Allocation alloc, uint32_t numBuffer);
|
||||
|
||||
/*
|
||||
/**
|
||||
* TODO: clearly define baseAlloc vs subAlloc
|
||||
*
|
||||
* Shares the BufferQueue with another Allocation. Both must be
|
||||
|
@ -181,7 +181,7 @@ interface IContext {
|
|||
@callflow(next={"*"})
|
||||
allocationShareBufferQueue(Allocation baseAlloc, Allocation subAlloc);
|
||||
|
||||
/*
|
||||
/**
|
||||
* Copies from the Allocation into a Bitmap. The bitmap must match the
|
||||
* dimensions of the Allocation.
|
||||
*
|
||||
|
@ -195,7 +195,7 @@ interface IContext {
|
|||
@callflow(next={"*"})
|
||||
allocationCopyToBitmap(Allocation allocation, Ptr data, Size sizeBytes);
|
||||
|
||||
/*
|
||||
/**
|
||||
* TODO: should we consolidate all [123]DWrite functions or [123]DRead
|
||||
* functions into the same API call? Our current plan is to be very similar
|
||||
* to the dispatch table API. How much should we deviate from the original
|
||||
|
@ -219,7 +219,7 @@ interface IContext {
|
|||
allocation1DWrite(Allocation allocation, uint32_t offset, uint32_t lod,
|
||||
uint32_t count, vec<uint8_t> data);
|
||||
|
||||
/*
|
||||
/**
|
||||
* Copies a value into a single sub-Element of this Allocation.
|
||||
*
|
||||
* @param allocation Allocation to be updated
|
||||
|
@ -237,7 +237,7 @@ interface IContext {
|
|||
uint32_t z, uint32_t lod, vec<uint8_t> data,
|
||||
Size compIdx);
|
||||
|
||||
/*
|
||||
/**
|
||||
* Copies from an array into a rectangular region in this Allocation.
|
||||
*
|
||||
* When this HAL entry is executed, all Vec3 elements have been explicitly
|
||||
|
@ -262,7 +262,7 @@ interface IContext {
|
|||
uint32_t lod, AllocationCubemapFace face, uint32_t w,
|
||||
uint32_t h, vec<uint8_t> data, Size stride);
|
||||
|
||||
/*
|
||||
/**
|
||||
* Copies from an array into a 3D region in this Allocation.
|
||||
*
|
||||
* When this HAL entry is executed, all Vec3 elements have been explicitly
|
||||
|
@ -288,7 +288,7 @@ interface IContext {
|
|||
uint32_t zoff, uint32_t lod, uint32_t w, uint32_t h,
|
||||
uint32_t d, vec<uint8_t> data, Size stride);
|
||||
|
||||
/*
|
||||
/**
|
||||
* Generates a mipmap chain. This is only valid if the Type of the
|
||||
* Allocation includes mipmaps.
|
||||
*
|
||||
|
@ -304,7 +304,7 @@ interface IContext {
|
|||
@callflow(next={"*"})
|
||||
allocationGenerateMipmaps(Allocation allocation);
|
||||
|
||||
/*
|
||||
/**
|
||||
* Copies all of an Allocation's data into an array.
|
||||
*
|
||||
* All Vec3 elements of an Allocation are padded to be Vec4, so the data
|
||||
|
@ -320,7 +320,7 @@ interface IContext {
|
|||
@callflow(next={"*"})
|
||||
allocationRead(Allocation allocation, Ptr data, Size sizeBytes);
|
||||
|
||||
/*
|
||||
/**
|
||||
* Copies a 1D region of this Allocation into an array.
|
||||
*
|
||||
* All Vec3 elements of an Allocation are padded to be Vec4, so the data
|
||||
|
@ -342,7 +342,7 @@ interface IContext {
|
|||
allocation1DRead(Allocation allocation, uint32_t xoff, uint32_t lod,
|
||||
uint32_t count, Ptr data, Size sizeBytes);
|
||||
|
||||
/*
|
||||
/**
|
||||
* Returns the value of a single sub-Element of this Allocation.
|
||||
*
|
||||
* HIDL is always running in Passthrough mode for RenderScript, so the
|
||||
|
@ -362,7 +362,7 @@ interface IContext {
|
|||
uint32_t z, uint32_t lod, Ptr data, Size sizeBytes,
|
||||
Size compIdx);
|
||||
|
||||
/*
|
||||
/**
|
||||
* Copies from a rectangular region in this Allocation to an array.
|
||||
*
|
||||
* All Vec3 elements of an Allocation are padded to be Vec4, so the data
|
||||
|
@ -391,7 +391,7 @@ interface IContext {
|
|||
uint32_t lod, AllocationCubemapFace face, uint32_t w,
|
||||
uint32_t h, Ptr data, Size sizeBytes, Size stride);
|
||||
|
||||
/*
|
||||
/**
|
||||
* Copies from a rectangular cuboid region in this Allocation to an array.
|
||||
*
|
||||
* All Vec3 elements of an Allocation are padded to be Vec4, so the data
|
||||
|
@ -421,7 +421,7 @@ interface IContext {
|
|||
uint32_t zoff, uint32_t lod, uint32_t w, uint32_t h,
|
||||
uint32_t d, Ptr data, Size sizeBytes, Size stride);
|
||||
|
||||
/*
|
||||
/**
|
||||
* Propagates changes from one usage of the Allocation to the other usages
|
||||
* of the Allocation.
|
||||
*
|
||||
|
@ -431,7 +431,7 @@ interface IContext {
|
|||
@callflow(next={"*"})
|
||||
allocationSyncAll(Allocation allocation, AllocationUsageType usageType);
|
||||
|
||||
/*
|
||||
/**
|
||||
* TODO: describe the functionality of resize1D better
|
||||
* TODO: original Java Doc description seems to contradict itself ("with
|
||||
* null contents and the region is otherwise undefined")
|
||||
|
@ -455,7 +455,7 @@ interface IContext {
|
|||
@callflow(next={"*"})
|
||||
allocationResize1D(Allocation allocation, uint32_t dimX);
|
||||
|
||||
/*
|
||||
/**
|
||||
* TODO: There are allocationCopy2DRange and 3DRange, but no 1DRange. Should
|
||||
* the interface be cleaned up more?
|
||||
*
|
||||
|
@ -483,7 +483,7 @@ interface IContext {
|
|||
uint32_t srcXoff, uint32_t srcYoff, uint32_t srcMip,
|
||||
AllocationCubemapFace srcFace);
|
||||
|
||||
/*
|
||||
/**
|
||||
* Copies a rectangular cuboid region into the allocation from another
|
||||
* Allocation.
|
||||
*
|
||||
|
@ -508,7 +508,7 @@ interface IContext {
|
|||
Allocation srcAlloc, uint32_t srcXoff,
|
||||
uint32_t srcYoff, uint32_t srcZoff, uint32_t srcMip);
|
||||
|
||||
/*
|
||||
/**
|
||||
* TODO: define buffer and output stream
|
||||
*
|
||||
* Sends a buffer to the output stream. The contents of the Allocation may
|
||||
|
@ -520,7 +520,7 @@ interface IContext {
|
|||
@callflow(next={"*"})
|
||||
allocationIoSend(Allocation allocation);
|
||||
|
||||
/*
|
||||
/**
|
||||
* Receives the latest input into the Allocation. This operation is only
|
||||
* valid if USAGE_IO_INPUT is set on the Allocation, otherwise an error
|
||||
* must be reported and no operations may be executed.
|
||||
|
@ -530,7 +530,7 @@ interface IContext {
|
|||
@callflow(next={"*"})
|
||||
allocationIoReceive(Allocation allocation);
|
||||
|
||||
/*
|
||||
/**
|
||||
* TODO: describe default values for lod, face, and z better.
|
||||
* TODO: what cases can invalidate the pointer? Resize? It should be
|
||||
* clarified that this method should always return a valid pointer, but the
|
||||
|
@ -560,7 +560,7 @@ interface IContext {
|
|||
AllocationCubemapFace face, uint32_t z)
|
||||
generates (Ptr dataPtr, Size stride);
|
||||
|
||||
/*
|
||||
/**
|
||||
* Retrieves an Element's metadata from native code.
|
||||
*
|
||||
* @param element Element to be read
|
||||
|
@ -570,7 +570,7 @@ interface IContext {
|
|||
elementGetNativeMetadata(Element element)
|
||||
generates (vec<uint32_t> elemData);
|
||||
|
||||
/*
|
||||
/**
|
||||
* TODO: define Sub-Element handles better.
|
||||
*
|
||||
* Retrieves an Element's sub Elements, specifically their identifiers,
|
||||
|
@ -587,7 +587,7 @@ interface IContext {
|
|||
generates (vec<Element> ids, vec<string> names,
|
||||
vec<Size> arraySizes);
|
||||
|
||||
/*
|
||||
/**
|
||||
* TODO: can normalization flag be removed?
|
||||
*
|
||||
* Creates an Element.
|
||||
|
@ -602,7 +602,7 @@ interface IContext {
|
|||
elementCreate(DataType dt, DataKind dk, bool norm, uint32_t size)
|
||||
generates (Element element);
|
||||
|
||||
/*
|
||||
/**
|
||||
* Creates a complex Element.
|
||||
*
|
||||
* @param einsPtr Container of input Elements
|
||||
|
@ -615,7 +615,7 @@ interface IContext {
|
|||
vec<Size> arraySizesPtr)
|
||||
generates (Element element);
|
||||
|
||||
/*
|
||||
/**
|
||||
* Retrives a Type's metadata from native code.
|
||||
*
|
||||
* @param type Type describing data layout
|
||||
|
@ -624,7 +624,7 @@ interface IContext {
|
|||
@callflow(next={"*"})
|
||||
typeGetNativeMetadata(Type type) generates (vec<OpaqueHandle> metadata);
|
||||
|
||||
/*
|
||||
/**
|
||||
* Creates a new Type.
|
||||
*
|
||||
* If Type is 1D, Y and Z must be 0. If Type is 2D, Z must be 0.
|
||||
|
@ -644,14 +644,14 @@ interface IContext {
|
|||
bool mipmaps, bool faces, YuvFormat yuv)
|
||||
generates (Type type);
|
||||
|
||||
/*
|
||||
/**
|
||||
* Destroys provided RenderScript context, including all objects created in
|
||||
* this context.
|
||||
*/
|
||||
@exit
|
||||
contextDestroy();
|
||||
|
||||
/*
|
||||
/**
|
||||
* TODO: provide overview of messaging model and figure out if this should
|
||||
* be part of HAL or not.
|
||||
* TODO: what is the "client" for purposes of this interface?
|
||||
|
@ -671,7 +671,7 @@ interface IContext {
|
|||
contextGetMessage(Ptr data, Size size)
|
||||
generates (MessageToClientType messageType, Size receiveLen);
|
||||
|
||||
/*
|
||||
/**
|
||||
* TODO: define subID better.
|
||||
*
|
||||
* Gets the metadata of a message to ensure entire message can be properly
|
||||
|
@ -687,7 +687,7 @@ interface IContext {
|
|||
generates (MessageToClientType messageType, Size receiveLen,
|
||||
uint32_t subID);
|
||||
|
||||
/*
|
||||
/**
|
||||
* TODO: Define "previous commands" better
|
||||
* TODO: Is the message identifier the same as subID?
|
||||
*
|
||||
|
@ -702,7 +702,7 @@ interface IContext {
|
|||
@callflow(next={"*"})
|
||||
contextSendMessage(uint32_t id, vec<uint8_t> data);
|
||||
|
||||
/*
|
||||
/**
|
||||
* TODO: Can this be done automatically as part of context creation? What
|
||||
* happens if we perform message operations before doing this?
|
||||
*
|
||||
|
@ -713,7 +713,7 @@ interface IContext {
|
|||
@callflow(next={"*"})
|
||||
contextInitToClient();
|
||||
|
||||
/*
|
||||
/**
|
||||
* TODO: Why doesn't this happen automatically as part of context
|
||||
* destruction? What happens if the FIFO is not empty?
|
||||
*
|
||||
|
@ -722,7 +722,7 @@ interface IContext {
|
|||
@callflow(next={"*"})
|
||||
contextDeinitToClient();
|
||||
|
||||
/*
|
||||
/**
|
||||
* TODO: do we need to mark asynchronous operations in this interface
|
||||
* definition?
|
||||
*
|
||||
|
@ -732,14 +732,14 @@ interface IContext {
|
|||
@callflow(next={"*"})
|
||||
contextFinish();
|
||||
|
||||
/*
|
||||
/**
|
||||
* Prints the currently available debugging information about the state of
|
||||
* the RS context to the logcat.
|
||||
*/
|
||||
@callflow(next={"*"})
|
||||
contextLog();
|
||||
|
||||
/*
|
||||
/**
|
||||
* TODO: full path? relative path? Investigate further.
|
||||
*
|
||||
* Sets the cache directory of the context.
|
||||
|
@ -749,7 +749,7 @@ interface IContext {
|
|||
@callflow(next={"*"})
|
||||
contextSetCacheDir(string cacheDir);
|
||||
|
||||
/*
|
||||
/**
|
||||
* TODO: does this apply to the GPU as well?
|
||||
*
|
||||
* Changes the priority of the cpu worker threads for this context.
|
||||
|
@ -759,7 +759,7 @@ interface IContext {
|
|||
@callflow(next={"*"})
|
||||
contextSetPriority(ThreadPriorities priority);
|
||||
|
||||
/*
|
||||
/**
|
||||
* TODO: does this need to be part of the HAL? What if the object already
|
||||
* has a name?
|
||||
*
|
||||
|
@ -771,7 +771,7 @@ interface IContext {
|
|||
@callflow(next={"*"})
|
||||
assignName(ObjectBase obj, string name);
|
||||
|
||||
/*
|
||||
/**
|
||||
* TODO: what if the object has no name?
|
||||
*
|
||||
* Returns the name of an object.
|
||||
|
@ -782,7 +782,7 @@ interface IContext {
|
|||
@callflow(next={"*"})
|
||||
getName(ObjectBase obj) generates (string name);
|
||||
|
||||
/*
|
||||
/**
|
||||
* TODO: starting here we have a set of interfaces for use with
|
||||
* ScriptGroups. At the very least we should indicate for each one that's
|
||||
* what it's for. Should we include ScriptGroup in the interface names?
|
||||
|
@ -810,7 +810,7 @@ interface IContext {
|
|||
vec<ScriptFieldID> depFieldIDS)
|
||||
generates (Closure closure);
|
||||
|
||||
/*
|
||||
/**
|
||||
* Creates a Closure which represents a function call to a invocable
|
||||
* function, combined with arguments and values for global variables.
|
||||
*
|
||||
|
@ -827,7 +827,7 @@ interface IContext {
|
|||
vec<int32_t> sizes)
|
||||
generates (Closure closure);
|
||||
|
||||
/*
|
||||
/**
|
||||
* Sets the argument of a Closure at specified index and size to provided
|
||||
* value.
|
||||
*
|
||||
|
@ -839,7 +839,7 @@ interface IContext {
|
|||
@callflow(next={"*"})
|
||||
closureSetArg(Closure closure, uint32_t index, Ptr value, int32_t size);
|
||||
|
||||
/*
|
||||
/**
|
||||
* Sets a global variable in a Closure.
|
||||
*
|
||||
* @param closure Closure
|
||||
|
@ -851,7 +851,7 @@ interface IContext {
|
|||
closureSetGlobal(Closure closure, ScriptFieldID fieldID, int64_t value,
|
||||
int32_t size);
|
||||
|
||||
/*
|
||||
/**
|
||||
* TODO: should slot be unsigned? (applies to other two ID interfaces, too)
|
||||
*
|
||||
* Creates a Script Kernel ID.
|
||||
|
@ -866,7 +866,7 @@ interface IContext {
|
|||
bitfield<MetadataSignatureBitval> sig)
|
||||
generates (ScriptKernelID scriptKernelID);
|
||||
|
||||
/*
|
||||
/**
|
||||
* Creates a Script Invoke ID.
|
||||
*
|
||||
* @param script Script
|
||||
|
@ -877,7 +877,7 @@ interface IContext {
|
|||
scriptInvokeIDCreate(Script script, int32_t slot)
|
||||
generates (ScriptInvokeID scriptInvokeID);
|
||||
|
||||
/*
|
||||
/**
|
||||
* TODO: describe the return value better. What is it?
|
||||
*
|
||||
* Creates a Script Field ID.
|
||||
|
@ -890,7 +890,7 @@ interface IContext {
|
|||
scriptFieldIDCreate(Script script, int32_t slot)
|
||||
generates (ScriptFieldID scriptFieldID);
|
||||
|
||||
/*
|
||||
/**
|
||||
* TODO: add more description
|
||||
*
|
||||
* Creates a Script Group.
|
||||
|
@ -908,7 +908,7 @@ interface IContext {
|
|||
vec<Type> types)
|
||||
generates (ScriptGroup scriptGroup);
|
||||
|
||||
/*
|
||||
/**
|
||||
* Creates a Script Group.
|
||||
*
|
||||
* @param name Name
|
||||
|
@ -920,7 +920,7 @@ interface IContext {
|
|||
scriptGroup2Create(string name, string cacheDir, vec<Closure> closures)
|
||||
generates (ScriptGroup2 scriptGroup2);
|
||||
|
||||
/*
|
||||
/**
|
||||
* TODO: if SetInput/Output corresponds to the Java API setInput() and
|
||||
* setOutput(), which are documented as deprecated in API 23, do we need to
|
||||
* support them? Or can we fallback to the CPU when they're used? Or can't
|
||||
|
@ -937,7 +937,7 @@ interface IContext {
|
|||
@callflow(next={"*"})
|
||||
scriptGroupSetOutput(ScriptGroup sg, ScriptKernelID kid, Allocation alloc);
|
||||
|
||||
/*
|
||||
/**
|
||||
* Sets an input of the Script Group. This specifies an Allocation to be
|
||||
* used for kernels that require an input Allocation provided from outside
|
||||
* of the Script Group.
|
||||
|
@ -949,7 +949,7 @@ interface IContext {
|
|||
@callflow(next={"*"})
|
||||
scriptGroupSetInput(ScriptGroup sg, ScriptKernelID kid, Allocation alloc);
|
||||
|
||||
/*
|
||||
/**
|
||||
* Executes a Script Group.
|
||||
*
|
||||
* @param sg Script Group to be executed.
|
||||
|
@ -957,7 +957,7 @@ interface IContext {
|
|||
@callflow(next={"*"})
|
||||
scriptGroupExecute( ScriptGroup sg);
|
||||
|
||||
/*
|
||||
/**
|
||||
* Frees any native resources associated with this object. The primary use
|
||||
* is to force immediate cleanup of resources when it is believed the GC
|
||||
* may not respond quickly enough.
|
||||
|
@ -967,7 +967,7 @@ interface IContext {
|
|||
@callflow(next={"*"})
|
||||
objDestroy(ObjectBase obj);
|
||||
|
||||
/*
|
||||
/**
|
||||
* Creates a Sampler.
|
||||
*
|
||||
* @param magFilter Magnification value for the filter
|
||||
|
@ -984,7 +984,7 @@ interface IContext {
|
|||
float aniso)
|
||||
generates (Sampler sampler);
|
||||
|
||||
/*
|
||||
/**
|
||||
* Binds an Allocation to a global pointer in the Script.
|
||||
*
|
||||
* @param script Script to be bound to
|
||||
|
@ -994,7 +994,7 @@ interface IContext {
|
|||
@callflow(next={"*"})
|
||||
scriptBindAllocation(Script script, Allocation allocation, uint32_t slot);
|
||||
|
||||
/*
|
||||
/**
|
||||
* TODO: is this necessary?
|
||||
*
|
||||
* Sets the timezone of a Script.
|
||||
|
@ -1005,7 +1005,7 @@ interface IContext {
|
|||
@callflow(next={"*"})
|
||||
scriptSetTimeZone(Script script, string timeZone);
|
||||
|
||||
/*
|
||||
/**
|
||||
* TODO: can scriptInvoke be combined with scriptInvokeV?
|
||||
*
|
||||
* Launches an invokable function.
|
||||
|
@ -1016,7 +1016,7 @@ interface IContext {
|
|||
@callflow(next={"*"})
|
||||
scriptInvoke(Script vs, uint32_t slot);
|
||||
|
||||
/*
|
||||
/**
|
||||
* Invokes a Script with values.
|
||||
*
|
||||
* @param vs Script to be invoked
|
||||
|
@ -1026,7 +1026,7 @@ interface IContext {
|
|||
@callflow(next={"*"})
|
||||
scriptInvokeV(Script vs, uint32_t slot, vec<uint8_t> data);
|
||||
|
||||
/*
|
||||
/**
|
||||
* TODO: add documentation for params
|
||||
* TODO: Should we rename "ScriptCall" to "LaunchOptions"?
|
||||
*
|
||||
|
@ -1043,7 +1043,7 @@ interface IContext {
|
|||
scriptForEach(Script vs, uint32_t slot, vec<Allocation> vains,
|
||||
Allocation vaout, vec<uint8_t> params, Ptr sc);
|
||||
|
||||
/*
|
||||
/**
|
||||
* Launches a Reduction kernel.
|
||||
*
|
||||
* @param vs Script
|
||||
|
@ -1056,7 +1056,7 @@ interface IContext {
|
|||
scriptReduce(Script vs, uint32_t slot, vec<Allocation> vains,
|
||||
Allocation vaout, Ptr sc);
|
||||
|
||||
/*
|
||||
/**
|
||||
* Sets a Script's integer variable to a value.
|
||||
*
|
||||
* @param vs RenderScript Script
|
||||
|
@ -1066,7 +1066,7 @@ interface IContext {
|
|||
@callflow(next={"*"})
|
||||
scriptSetVarI(Script vs, uint32_t slot, int32_t value);
|
||||
|
||||
/*
|
||||
/**
|
||||
* Sets a Script's Object variable to a value
|
||||
*
|
||||
* @param vs RenderScript Script
|
||||
|
@ -1076,7 +1076,7 @@ interface IContext {
|
|||
@callflow(next={"*"})
|
||||
scriptSetVarObj( Script vs, uint32_t slot, ObjectBase obj);
|
||||
|
||||
/*
|
||||
/**
|
||||
* Sets a Script's long variable to a value.
|
||||
*
|
||||
* @param vs RenderScript Script
|
||||
|
@ -1086,7 +1086,7 @@ interface IContext {
|
|||
@callflow(next={"*"})
|
||||
scriptSetVarJ(Script vs, uint32_t slot, int64_t value);
|
||||
|
||||
/*
|
||||
/**
|
||||
* Sets a Script's float variable to a value.
|
||||
*
|
||||
* @param vs RenderScript Script
|
||||
|
@ -1096,7 +1096,7 @@ interface IContext {
|
|||
@callflow(next={"*"})
|
||||
scriptSetVarF(Script vs, uint32_t slot, float value);
|
||||
|
||||
/*
|
||||
/**
|
||||
* Sets a Script's double variable to a value.
|
||||
*
|
||||
* @param vs RenderScript Script
|
||||
|
@ -1106,7 +1106,7 @@ interface IContext {
|
|||
@callflow(next={"*"})
|
||||
scriptSetVarD(Script vs, uint32_t slot, double value);
|
||||
|
||||
/*
|
||||
/**
|
||||
* Sets a Script's struct variable to a value.
|
||||
*
|
||||
* @param vs RenderScript Script
|
||||
|
@ -1116,7 +1116,7 @@ interface IContext {
|
|||
@callflow(next={"*"})
|
||||
scriptSetVarV(Script vs, uint32_t slot, vec<uint8_t> data);
|
||||
|
||||
/*
|
||||
/**
|
||||
* TODO: Why do we have typed setters but only untyped getter?
|
||||
*
|
||||
* Retrieves the value from a global variable in a script.
|
||||
|
@ -1130,7 +1130,7 @@ interface IContext {
|
|||
scriptGetVarV(Script vs, uint32_t slot, Size len)
|
||||
generates (vec<uint8_t> data);
|
||||
|
||||
/*
|
||||
/**
|
||||
* TODO: Is this a value to be replicated for each member of the array? Or
|
||||
* is there a representation for each separate member?
|
||||
*
|
||||
|
@ -1147,7 +1147,7 @@ interface IContext {
|
|||
scriptSetVarVE(Script vs, uint32_t slot, vec<uint8_t> data, Element ve,
|
||||
vec<uint32_t> dims);
|
||||
|
||||
/*
|
||||
/**
|
||||
* TODO: is cacheDir redundant with createCache() function? Can we remove
|
||||
* it?
|
||||
* TODO: define resName more clearly
|
||||
|
@ -1163,7 +1163,7 @@ interface IContext {
|
|||
scriptCCreate(string resName, string cacheDir, vec<uint8_t> text)
|
||||
generates (Script script);
|
||||
|
||||
/*
|
||||
/**
|
||||
* Creates a RenderScript Intrinsic script.
|
||||
*
|
||||
* @param id Intrinsic Script identifier
|
||||
|
|
|
@ -21,7 +21,7 @@ import IContext;
|
|||
|
||||
interface IDevice {
|
||||
|
||||
/*
|
||||
/**
|
||||
* Creates a RenderScript context.
|
||||
*
|
||||
* @param sdkVersion Target RS API level
|
||||
|
|
|
@ -38,7 +38,7 @@ interface IBase {
|
|||
};
|
||||
|
||||
struct MoreThanOneArrayField {
|
||||
/*
|
||||
/**
|
||||
* Generated (Java) code used to redeclare the same variable name
|
||||
* multiple times in the same scope, this test ensures that that's no
|
||||
* longer the case.
|
||||
|
|
|
@ -16,7 +16,7 @@
|
|||
|
||||
package android.hardware.tests.baz@1.0;
|
||||
|
||||
/*
|
||||
/**
|
||||
* Verify that introducing a typedef in types.hal does not mistakenly emit
|
||||
* a makefile section to create a dedicated ulong.java class as it used to.
|
||||
*/
|
||||
|
|
|
@ -17,7 +17,7 @@
|
|||
package android.hardware.tests.msgq@1.0;
|
||||
|
||||
interface IBenchmarkMsgQ {
|
||||
/*
|
||||
/**
|
||||
* This method requests the service to set up Synchronous read/write
|
||||
* wait-free FMQ with the client as reader.
|
||||
* @return ret Will be true if the setup was successful, false otherwise.
|
||||
|
@ -27,7 +27,7 @@ interface IBenchmarkMsgQ {
|
|||
configureClientInboxSyncReadWrite()
|
||||
generates(bool ret, fmq_sync<uint8_t> mqDescIn);
|
||||
|
||||
/*
|
||||
/**
|
||||
* This method requests the service to set up Synchronous read/write
|
||||
* wait-free FMQ with the client as writer.
|
||||
* @return ret Will be true if the setup was successful, false otherwise.
|
||||
|
@ -37,7 +37,7 @@ interface IBenchmarkMsgQ {
|
|||
configureClientOutboxSyncReadWrite()
|
||||
generates(bool ret, fmq_sync<uint8_t> mqDescOut);
|
||||
|
||||
/*
|
||||
/**
|
||||
* This method request the service to write into the FMQ.
|
||||
* @param count Number to messages to write.
|
||||
* @return ret Will be true if the write operation was successful,
|
||||
|
@ -45,14 +45,14 @@ interface IBenchmarkMsgQ {
|
|||
*/
|
||||
requestWrite(int32_t count) generates (bool ret);
|
||||
|
||||
/*
|
||||
/**
|
||||
* This method request the service to read from the FMQ.
|
||||
* @param count Number to messages to read.
|
||||
* @ret Will be true if the read operation was successful, false otherwise.
|
||||
*/
|
||||
requestRead(int32_t count) generates (bool ret);
|
||||
|
||||
/*
|
||||
/**
|
||||
* This method kicks off a benchmarking experiment where
|
||||
* the client writes a message into its outbox FMQ,
|
||||
* the service reads it and writes it into the client's
|
||||
|
@ -62,14 +62,14 @@ interface IBenchmarkMsgQ {
|
|||
*/
|
||||
benchmarkPingPong(uint32_t numIter);
|
||||
|
||||
/*
|
||||
/**
|
||||
* This method kicks off a benchmarking experiment where
|
||||
* the service writes into an FMQ and the client reads the same.
|
||||
* @param numIter The number of iterations to run the experiment.
|
||||
*/
|
||||
benchmarkServiceWriteClientRead(uint32_t numIter);
|
||||
|
||||
/*
|
||||
/**
|
||||
* This method sends a vector of time duration(in ns).
|
||||
* @param timeData vector of time instants measured by client.
|
||||
* Each entry is the number of ns between the epoch and a
|
||||
|
|
|
@ -22,7 +22,7 @@ interface ITestMsgQ {
|
|||
FMQ_NOT_FULL = 1 << 1,
|
||||
};
|
||||
|
||||
/*
|
||||
/**
|
||||
* This method requests the service to set up a synchronous read/write
|
||||
* wait-free FMQ with the client as reader.
|
||||
*
|
||||
|
@ -33,7 +33,7 @@ interface ITestMsgQ {
|
|||
configureFmqSyncReadWrite()
|
||||
generates(bool ret, fmq_sync<uint16_t> mqDesc);
|
||||
|
||||
/*
|
||||
/**
|
||||
* This method requests the service to return an MQDescriptor to
|
||||
* an unsynchronized FMQ set up by the server. If 'configureFmq' is
|
||||
* true, then the server sets up a new unsynchronized FMQ. This
|
||||
|
@ -48,7 +48,7 @@ interface ITestMsgQ {
|
|||
*/
|
||||
getFmqUnsyncWrite(bool configureFmq) generates(bool ret, fmq_unsync<uint16_t> mqDesc);
|
||||
|
||||
/*
|
||||
/**
|
||||
* This method request the service to write into the synchronized read/write
|
||||
* flavor of the FMQ.
|
||||
*
|
||||
|
@ -58,7 +58,7 @@ interface ITestMsgQ {
|
|||
*/
|
||||
requestWriteFmqSync(int32_t count) generates(bool ret);
|
||||
|
||||
/*
|
||||
/**
|
||||
* This method request the service to read from the synchronized read/write
|
||||
* FMQ.
|
||||
*
|
||||
|
@ -68,7 +68,7 @@ interface ITestMsgQ {
|
|||
*/
|
||||
requestReadFmqSync(int32_t count) generates(bool ret);
|
||||
|
||||
/*
|
||||
/**
|
||||
* This method request the service to write into the unsynchronized flavor
|
||||
* of FMQ.
|
||||
*
|
||||
|
@ -78,7 +78,7 @@ interface ITestMsgQ {
|
|||
*/
|
||||
requestWriteFmqUnsync(int32_t count) generates(bool ret);
|
||||
|
||||
/*
|
||||
/**
|
||||
* This method request the service to read from the unsynchronized flavor of
|
||||
* FMQ.
|
||||
*
|
||||
|
@ -88,7 +88,7 @@ interface ITestMsgQ {
|
|||
*/
|
||||
requestReadFmqUnsync(int32_t count) generates(bool ret);
|
||||
|
||||
/*
|
||||
/**
|
||||
* This method requests the service to trigger a blocking read.
|
||||
*
|
||||
* @param count Number of messages to read.
|
||||
|
@ -96,7 +96,7 @@ interface ITestMsgQ {
|
|||
*/
|
||||
oneway requestBlockingRead(int32_t count);
|
||||
|
||||
/*
|
||||
/**
|
||||
* This method requests the service to trigger a blocking read using
|
||||
* default Event Flag notification bits defined by the MessageQueue class.
|
||||
*
|
||||
|
@ -105,7 +105,7 @@ interface ITestMsgQ {
|
|||
*/
|
||||
oneway requestBlockingReadDefaultEventFlagBits(int32_t count);
|
||||
|
||||
/*
|
||||
/**
|
||||
* This method requests the service to repeatedly trigger blocking reads.
|
||||
*
|
||||
* @param count Number of messages to read in a single blocking read.
|
||||
|
|
|
@ -589,10 +589,10 @@ enum StaRoamingState : uint8_t {
|
|||
* Size limits for parameters used in the NAN interface.
|
||||
*/
|
||||
enum NanParamSizeLimits : uint32_t {
|
||||
/* Minimum length of Passphrase argument for data-path configuration */
|
||||
/** Minimum length of Passphrase argument for data-path configuration */
|
||||
MIN_PASSPHRASE_LENGTH = 8,
|
||||
|
||||
/* Maximum length of Passphrase argument for data-path configuration */
|
||||
/** Maximum length of Passphrase argument for data-path configuration */
|
||||
MAX_PASSPHRASE_LENGTH = 63,
|
||||
};
|
||||
|
||||
|
@ -607,29 +607,29 @@ typedef uint16_t CommandIdShort;
|
|||
*/
|
||||
enum NanStatusType : uint32_t {
|
||||
SUCCESS = 0,
|
||||
/* NAN Discovery Engine/Host driver failures */
|
||||
/** NAN Discovery Engine/Host driver failures */
|
||||
INTERNAL_FAILURE = 1,
|
||||
/* NAN OTA failures */
|
||||
/** NAN OTA failures */
|
||||
PROTOCOL_FAILURE = 2,
|
||||
/* The publish/subscribe discovery session id is invalid */
|
||||
/** The publish/subscribe discovery session id is invalid */
|
||||
INVALID_SESSION_ID = 3,
|
||||
/* Out of resources to fufill request */
|
||||
/** Out of resources to fufill request */
|
||||
NO_RESOURCES_AVAILABLE = 4,
|
||||
/* Invalid arguments passed */
|
||||
/** Invalid arguments passed */
|
||||
INVALID_ARGS = 5,
|
||||
/* Invalid peer id */
|
||||
/** Invalid peer id */
|
||||
INVALID_PEER_ID = 6,
|
||||
/* Invalid NAN data-path (ndp) id */
|
||||
/** Invalid NAN data-path (ndp) id */
|
||||
INVALID_NDP_ID = 7,
|
||||
/* Attempting to enable NAN when not available, e.g. wifi is disabled */
|
||||
/** Attempting to enable NAN when not available, e.g. wifi is disabled */
|
||||
NAN_NOT_ALLOWED = 8,
|
||||
/* Over the air ACK not received */
|
||||
/** Over the air ACK not received */
|
||||
NO_OTA_ACK = 9,
|
||||
/* Attempting to enable NAN when already enabled */
|
||||
/** Attempting to enable NAN when already enabled */
|
||||
ALREADY_ENABLED = 10,
|
||||
/* Can't queue tx followup message foor transmission */
|
||||
/** Can't queue tx followup message foor transmission */
|
||||
FOLLOWUP_TX_QUEUE_FULL = 11,
|
||||
/* Unsupported concurrency of NAN and another feature - NAN disabled */
|
||||
/** Unsupported concurrency of NAN and another feature - NAN disabled */
|
||||
UNSUPPORTED_CONCURRENCY_NAN_DISABLED = 12
|
||||
};
|
||||
|
||||
|
|
Loading…
Reference in a new issue