Merge "NFC: Add Annotations to the HAL file" (3bca1eef) · Commits · e / os / android_hardware_interfaces

nfc/1.0/INfc.hal

+9 −0

Original line number	Diff line number	Diff line
		@@ -33,6 +33,8 @@ interface INfc {
		* If open() returns any other value, the NCI stack will stop.
		*
		*/
		@entry
		@callflow(next={"write", "coreInitialized", "prediscover", "powerCycle", "controlGranted"})
		open(INfcClientCallback clientCallback) generates (int32_t retval);

		/*
		@@ -41,6 +43,8 @@ interface INfc {
		* This method may queue writes and return immediately. The only
		* requirement is that the writes are executed in order.
		*/
		@callflow(next={"write", "prediscover", "coreInitialized", "close", "powerCycle",
		"controlGranted"})
		write(NfcData data) generates (int32_t retval);

		/*
		@@ -53,6 +57,7 @@ interface INfc {
		* If coreInitialized() returns any other value, the NCI stack will continue
		* immediately.
		*/
		@callflow(next={"write", "prediscover", "close"})
		coreInitialized(NfcData data) generates (int32_t retval);

		/*
		@@ -66,11 +71,13 @@ interface INfc {
		* If prediscover() returns any other value, the NCI stack will start
		* RF discovery immediately.
		*/
		@callflow(next={"write", "close", "coreInitialized", "powerCycle", "controlGranted"})
		prediscover() generates (int32_t retval);

		/*
		* Close the NFC controller. Should free all resources.
		*/
		@exit
		close() generates (int32_t retval);

		/*
		@@ -79,11 +86,13 @@ interface INfc {
		* Must only be called when there are no NCI commands pending.
		* NfcEvent.RELEASE_CONTROL will notify when HAL no longer needs exclusive control.
		*/
		@callflow(next={"write", "close", "prediscover", "coreInitialized", "powerCycle"})
		controlGranted() generates (int32_t retval);

		/*
		* Restart controller by power cyle;
		* NfcEvent.OPEN_CPLT will notify when operation is complete.
		*/
		@callflow(next={"write", "coreInitialized", "prediscover", "controlGranted", "close"})
		powerCycle() generates (int32_t retval);
		};