Define CBRS HAL interfaces in IRadio 1.3 and IRadioConfig 1.1. (ded43999) · Commits · e / os / android_hardware_interfaces

radio/1.3/IRadio.hal

+33 −0

Original line number	Original line	Diff line number	Diff line
	@@ -17,8 +17,12 @@
	package android.hardware.radio@1.3;		package android.hardware.radio@1.3;

	import @1.2::IRadio;		import @1.2::IRadio;
			import @1.1::RadioAccessSpecifier;

	/**		/**
			* Note: IRadio 1.3 is an intermediate layer between Android P and Android Q. It's specifically
			* designed for CBRS related interfaces. All other interfaces for Q are added in IRadio 1.4.
			*
	* This interface is used by telephony and telecom to talk to cellular radio.		* This interface is used by telephony and telecom to talk to cellular radio.
	* All the functions have minimum one parameter:		* All the functions have minimum one parameter:
	* serial: which corresponds to serial no. of request. Serial numbers must only be memorized for the		* serial: which corresponds to serial no. of request. Serial numbers must only be memorized for the
	@@ -27,4 +31,33 @@ import @1.2::IRadio;
	* setResponseFunctions must work with @1.1::IRadioResponse and @1.1::IRadioIndication.		* setResponseFunctions must work with @1.1::IRadioResponse and @1.1::IRadioIndication.
	*/		*/
	interface IRadio extends @1.2::IRadio {		interface IRadio extends @1.2::IRadio {
			/**
			* Specify which bands modem's background scan must act on.
			* If specifyChannels is true, it only scans bands specified in specifiers.
			* If specifyChannels is false, it scans all bands.
			*
			* For example, CBRS is only on LTE band 48. By specifying this band,
			* modem saves more power.
			*
			* @param serial Serial number of request.
			* @param specifyChannels whether to scan bands defined in specifiers.
			* @param specifiers which bands to scan. Only used if specifyChannels is true.
			*
			* Response callback is IRadioResponse.setSystemSelectionChannelsResponse()
			*/
			oneway setSystemSelectionChannels(int32_t serial, bool specifyChannels,
			vec<RadioAccessSpecifier> specifiers);

			/**
			* Toggle logical modem on and off. It should put the logical modem in low power
			* mode without any activity, while the SIM card remains visible. The difference
			* with setRadioPower is, setRadioPower affects all logical modem while this controls
			* just one.
			*
			* @param serial Serial number of request.
			* @param on True to turn on the logical modem, otherwise turn it off.
			*
			* Response function is IRadioResponse.enableModemResponse()
			*/
			oneway enableModem(int32_t serial, bool on);
	};		};

radio/1.3/IRadioResponse.hal

+24 −0

Original line number	Original line	Diff line number	Diff line
	@@ -17,9 +17,33 @@
	package android.hardware.radio@1.3;		package android.hardware.radio@1.3;

	import @1.2::IRadioResponse;		import @1.2::IRadioResponse;
			import @1.0::RadioResponseInfo;

	/**		/**
			* Note: IRadio 1.3 is an intermediate layer between Android P and Android Q. It's specifically
			* designed for CBRS related interfaces. All other interfaces for Q are added in IRadio 1.4.
			*
	* Interface declaring response functions to solicited radio requests.		* Interface declaring response functions to solicited radio requests.
	*/		*/
	interface IRadioResponse extends @1.2::IRadioResponse {		interface IRadioResponse extends @1.2::IRadioResponse {
			/**
			* @param info Response info struct containing response type, serial no. and error
			*
			* Valid errors returned:
			* RadioError:NONE
			* RadioError:RADIO_NOT_AVAILABLE
			* RadioError:INTERNAL_ERR
			* RadioError:INVALID_ARGUMENTS
			*/
			oneway setSystemSelectionChannelsResponse(RadioResponseInfo info);

			/**
			* @param info Response info struct containing response type, serial no. and error
			*
			* Valid errors returned:
			* RadioError:NONE
			* RadioError:RADIO_NOT_AVAILABLE
			* RadioError:INTERNAL_ERR
			*/
			oneway enableModemResponse(RadioResponseInfo info);
	};		};

radio/1.4/IRadio.hal

+1 −1

Original line number	Original line	Diff line number	Diff line
	@@ -16,11 +16,11 @@

	package android.hardware.radio@1.4;		package android.hardware.radio@1.4;

	import @1.4::DataProfileInfo;
	import @1.0::Dial;		import @1.0::Dial;
	import @1.2::DataRequestReason;		import @1.2::DataRequestReason;
	import @1.3::IRadio;		import @1.3::IRadio;
	import @1.4::AccessNetwork;		import @1.4::AccessNetwork;
			import @1.4::DataProfileInfo;
	import @1.4::EmergencyServiceCategory;		import @1.4::EmergencyServiceCategory;

	/**		/**

radio/config/1.1/Android.bp

+6 −0

Original line number	Original line	Diff line number	Diff line
	@@ -7,14 +7,20 @@ hidl_interface {
	enabled: true,		enabled: true,
	},		},
	srcs: [		srcs: [
			"IRadioConfig.hal",
	"IRadioConfigIndication.hal",		"IRadioConfigIndication.hal",
	"IRadioConfigResponse.hal",		"IRadioConfigResponse.hal",
			"types.hal",
	],		],
	interfaces: [		interfaces: [
	"android.hardware.radio.config@1.0",		"android.hardware.radio.config@1.0",
	"android.hardware.radio@1.0",		"android.hardware.radio@1.0",
	"android.hidl.base@1.0",		"android.hidl.base@1.0",
	],		],
			types: [
			"ModemInfo",
			"PhoneCapability",
			],
	gen_java: true,		gen_java: true,
	}		}

radio/config/1.1/IRadioConfig.hal

0 → 100644

+59 −0

Original line number	Original line	Diff line number	Diff line
			/*
			* Copyright (C) 2018 The Android Open Source Project
			*
			* Licensed under the Apache License, Version 2.0 (the "License");
			* you may not use this file except in compliance with the License.
			* You may obtain a copy of the License at
			*
			* http://www.apache.org/licenses/LICENSE-2.0
			*
			* Unless required by applicable law or agreed to in writing, software
			* distributed under the License is distributed on an "AS IS" BASIS,
			* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
			* See the License for the specific language governing permissions and
			* limitations under the License.
			*/

			package android.hardware.radio.config@1.1;

			import @1.0::IRadioConfig;
			import @1.1::IRadioConfigResponse;
			import @1.1::PhoneCapability;

			/**
			* Note: IRadioConfig 1.1 is an intermediate layer between Android P and Android Q.
			* It's specifically designed for CBRS related interfaces. All other interfaces
			* for Q are added in IRadioConfig 1.2.
			*
			* This interface is used by telephony and telecom to talk to cellular radio for the purpose of
			* radio configuration, and it is not associated with any specific modem or slot.
			* All the functions have minimum one parameter:
			* serial: which corresponds to serial no. of request. Serial numbers must only be memorized for the
			* duration of a method call. If clients provide colliding serials (including passing the same
			* serial to different methods), multiple responses (one for each method call) must still be served.
			*/
			interface IRadioConfig extends @1.0::IRadioConfig {
			/**
			* Request current phone capability.
			*
			* @param serial Serial number of request.
			*
			* Response callback is IRadioResponse.getPhoneCapabilityResponse() which
			* will return <@1.1::PhoneCapability>.
			*/
			oneway getPhoneCapability(int32_t serial);

			/**
			* Set preferred data modem Id.
			* In a multi-SIM device, notify modem layer which logical modem will be used primarily
			* for data. It helps modem with resource optimization and decisions of what data connections
			* should be satisfied.
			*
			* @param serial Serial number of request.
			* @param modem Id the logical modem ID, which should match one of modem IDs returned
			* from getPhoneCapability().
			*
			* Response callback is IRadioConfigResponse.setPreferredDataModemResponse()
			*/
			oneway setPreferredDataModem(int32_t serial, uint8_t modemId);
			};