Loading tv/tuner/1.0/Android.bp +1 −0 Original line number Diff line number Diff line Loading @@ -13,6 +13,7 @@ hidl_interface { "IDescrambler.hal", "IFrontend.hal", "IFrontendCallback.hal", "ILnb.hal", "ITuner.hal", ], interfaces: [ Loading tv/tuner/1.0/IFrontend.hal +95 −0 Original line number Diff line number Diff line Loading @@ -16,6 +16,7 @@ package android.hardware.tv.tuner@1.0; import IFrontendCallback; import ILnb; /** * A Tuner Frontend is used to tune to a frequency and lock signal. It provide Loading Loading @@ -79,4 +80,98 @@ interface IFrontend { * UNKNOWN_ERROR if failed for other reasons. */ close() generates (Result result); /** * Scan the frontend to use the settings given. * * This uses the frontend to start a scan from signal delivery information. * If previous scan isn't completed, this call MUST stop previous scan, * and start a new scan. * Scan is an async call, with FrontendScanMessage sent via callback. * * @param settings Signal delivery information which the frontend uses to * scan the signal. * @param type the type which the frontend uses to scan the signal. * * @return result Result status of the operation. * SUCCESS if successful, * INVALID_STATE if tuning can't be applied at current stage, * UNKNOWN_ERROR if tuning failed for other reasons. */ scan(FrontendSettings settings, FrontendScanType type) generates (Result result); /** * Stops a previous scanning. * * If the method completes successfully, the frontend stop previous * scanning. * * @return result Result status of the operation. * SUCCESS if successfully stop tuning. * UNKNOWN_ERROR if failed for other reasons. */ stopScan() generates (Result result); /** * Gets the statuses of the frontend. * * This retrieve the statuses of the frontend for given status types. * * @param statusTypes an array of status type which the caller request. * * @return result Result status of the operation. * SUCCESS if successful, * INVALID_STATE if tuning can't be applied at current stage, * UNKNOWN_ERROR if tuning failed for other reasons. * @return statuses an array of statuses which response the caller's * request. */ getStatus(vec<FrontendStatusType> statusTypes) generates (Result result, vec<FrontendStatus> statuses); /** * Sets Low-Noise Block downconverter (LNB) for satellite frontend. * * This assigns a hardware LNB resource to the satellite frontend. It can be * called multiple times to update LNB assignment. The LNB resource must be * released when the frontend is closed. * * @param lnbId the Id of assigned LNB resource. * * @return result Result status of the operation. * SUCCESS if successful, * INVALID_STATE if the frontend can't be set with a LNB, such as * cable frontend. * UNKNOWN_ERROR if failed for other reasons. */ setLnb(ILnb lnb) generates (Result result); /** * Enble or Disable Low Noise Amplifier (LNA). * * @param bEnable true if activate LNA module; false if deactivate LNA * * @return result Result status of the operation. * SUCCESS if successful, * INVALID_STATE if the frontend doesn't support LNA. * UNKNOWN_ERROR if failed for other reasons. */ setLna(bool bEnable) generates (Result result); /** * Sends DiSEqC (Digital Satellite Equipment Control) message. * * Client sends DiSeqc message to DiSEqc compatible device through the * frontend. The response message from the device comes back to the client * through frontend's callback onDiseqcMessage. * * @param diseqcMessage a byte array of data for DiSEqC message which is * specified by EUTELSAT Bus Functional Specification Version 4.2. * * @return result Result status of the operation. * SUCCESS if successful, * INVALID_STATE if the frontend can't send DiSEqc Message, such as * cable frontend. * UNKNOWN_ERROR if failed for other reasons. */ sendDiseqcMessage(vec<uint8_t> diseqcMessage) generates (Result result); }; tv/tuner/1.0/IFrontendCallback.hal +9 −1 Original line number Diff line number Diff line Loading @@ -33,5 +33,13 @@ interface IFrontendCallback { * Specification Version 4.2. */ oneway onDiseqcMessage(vec<uint8_t> diseqcMessage); }; /** * The callback function that must be called by HAL implementation to notify * the client of scan messages. * * @param type the type of scan message. * @param message the scan message sent by HAL to the client. */ oneway onScanMessage(FrontendScanMessageType type, FrontendScanMessage message); }; tv/tuner/1.0/ILnb.hal 0 → 100644 +68 −0 Original line number Diff line number Diff line /* * Copyright (C) 2019 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.tv.tuner@1.0; /** * A Tuner LNB (low-noise block downconverter) is used by satellite frontend * to receive the microwave signal from the satellite, amplify it, and * downconvert the frequency to a lower frequency. */ interface ILnb { /** * Set the lnb's power voltage. * * @param voltage the power's voltage the Lnb to use. * @return result Result status of the operation. * SUCCESS if successful, * INVALID_ARGUMENT if the selected voltage isn't allowed, * UNKNOWN_ERROR if failed for other reasons. */ setVoltage(FrontendLnbVoltage voltage) generates (Result result); /** * Set the lnb's tone mode. * * @param tone the tone mode the Lnb to use. * @return result Result status of the operation. * SUCCESS if successful, * INVALID_ARGUMENT if the selected tone mode isn't allowed, * UNKNOWN_ERROR if failed for other reasons. */ setTone(FrontendLnbTone tone) generates (Result result); /** * Select the lnb's position. * * @param position the position the Lnb to use. * @return result Result status of the operation. * SUCCESS if successful, * INVALID_ARGUMENT if the selected position isn't allowed, * UNKNOWN_ERROR if failed for other reasons. */ setSatellitePosition(FrontendLnbPosition position) generates (Result result); /** * Releases the LNB instance * * Associated resources are released. close may be called more than once. * Calls to any other method after this will return an error * * @return result Result status of the operation. * SUCCESS if successful, * UNKNOWN_ERROR if failed for other reasons. */ close() generates (Result result); }; tv/tuner/1.0/ITuner.hal +46 −2 Original line number Diff line number Diff line Loading @@ -19,6 +19,7 @@ package android.hardware.tv.tuner@1.0; import IDemux; import IDescrambler; import IFrontend; import ILnb; /** * Top level interface to manage Frontend, Demux and Decrambler hardware Loading @@ -45,6 +46,7 @@ interface ITuner { * @param frontendId the id of the frontend to be opened. * @return result Result status of the operation. * SUCCESS if successful, * UNAVAILABLE if no resource. * UNKNOWN_ERROR if creation failed for other reasons. * @return frontend the newly created frontend interface. */ Loading Loading @@ -77,4 +79,46 @@ interface ITuner { */ openDescrambler() generates (Result result, IDescrambler descrambler); /** * Create a new instance of Descrambler. * * It is used by the client to create a Descrambler instance. * * @return result Result status of the operation. * SUCCESS if successful, * UNKNOWN_ERROR if creation failed for other reasons. * @return descrambler the newly created descrambler interface. */ getFrontendInfo(FrontendId frontendId) generates (Result result, FrontendInfo info); /** * Get low-noise block downconverter (LNB) IDs. * * It is used by the client to get all available LNBs' IDs. * * @return result Result status of the operation. * SUCCESS if successful, * UNKNOWN_ERROR if tuning failed for other reasons. * @return frontendIds an array of LnbId for the available LNBs. */ getLnbIds() generates (Result result, vec<LnbId> lnbIds); /** * Create a new instance of Lnb given a lnbId. * * It is used by the client to create a Lnb instance for satellite Frontend. * * @param lnbId the id of the LNB to be opened. * @return result Result status of the operation. * SUCCESS if successful, * UNAVAILABLE if no resource. * UNKNOWN_ERROR if creation failed for other reasons. * @return lnb the newly created Lnb interface. */ openLnbById(LnbId lnbId) generates (Result result, ILnb lnb); }; Loading
tv/tuner/1.0/Android.bp +1 −0 Original line number Diff line number Diff line Loading @@ -13,6 +13,7 @@ hidl_interface { "IDescrambler.hal", "IFrontend.hal", "IFrontendCallback.hal", "ILnb.hal", "ITuner.hal", ], interfaces: [ Loading
tv/tuner/1.0/IFrontend.hal +95 −0 Original line number Diff line number Diff line Loading @@ -16,6 +16,7 @@ package android.hardware.tv.tuner@1.0; import IFrontendCallback; import ILnb; /** * A Tuner Frontend is used to tune to a frequency and lock signal. It provide Loading Loading @@ -79,4 +80,98 @@ interface IFrontend { * UNKNOWN_ERROR if failed for other reasons. */ close() generates (Result result); /** * Scan the frontend to use the settings given. * * This uses the frontend to start a scan from signal delivery information. * If previous scan isn't completed, this call MUST stop previous scan, * and start a new scan. * Scan is an async call, with FrontendScanMessage sent via callback. * * @param settings Signal delivery information which the frontend uses to * scan the signal. * @param type the type which the frontend uses to scan the signal. * * @return result Result status of the operation. * SUCCESS if successful, * INVALID_STATE if tuning can't be applied at current stage, * UNKNOWN_ERROR if tuning failed for other reasons. */ scan(FrontendSettings settings, FrontendScanType type) generates (Result result); /** * Stops a previous scanning. * * If the method completes successfully, the frontend stop previous * scanning. * * @return result Result status of the operation. * SUCCESS if successfully stop tuning. * UNKNOWN_ERROR if failed for other reasons. */ stopScan() generates (Result result); /** * Gets the statuses of the frontend. * * This retrieve the statuses of the frontend for given status types. * * @param statusTypes an array of status type which the caller request. * * @return result Result status of the operation. * SUCCESS if successful, * INVALID_STATE if tuning can't be applied at current stage, * UNKNOWN_ERROR if tuning failed for other reasons. * @return statuses an array of statuses which response the caller's * request. */ getStatus(vec<FrontendStatusType> statusTypes) generates (Result result, vec<FrontendStatus> statuses); /** * Sets Low-Noise Block downconverter (LNB) for satellite frontend. * * This assigns a hardware LNB resource to the satellite frontend. It can be * called multiple times to update LNB assignment. The LNB resource must be * released when the frontend is closed. * * @param lnbId the Id of assigned LNB resource. * * @return result Result status of the operation. * SUCCESS if successful, * INVALID_STATE if the frontend can't be set with a LNB, such as * cable frontend. * UNKNOWN_ERROR if failed for other reasons. */ setLnb(ILnb lnb) generates (Result result); /** * Enble or Disable Low Noise Amplifier (LNA). * * @param bEnable true if activate LNA module; false if deactivate LNA * * @return result Result status of the operation. * SUCCESS if successful, * INVALID_STATE if the frontend doesn't support LNA. * UNKNOWN_ERROR if failed for other reasons. */ setLna(bool bEnable) generates (Result result); /** * Sends DiSEqC (Digital Satellite Equipment Control) message. * * Client sends DiSeqc message to DiSEqc compatible device through the * frontend. The response message from the device comes back to the client * through frontend's callback onDiseqcMessage. * * @param diseqcMessage a byte array of data for DiSEqC message which is * specified by EUTELSAT Bus Functional Specification Version 4.2. * * @return result Result status of the operation. * SUCCESS if successful, * INVALID_STATE if the frontend can't send DiSEqc Message, such as * cable frontend. * UNKNOWN_ERROR if failed for other reasons. */ sendDiseqcMessage(vec<uint8_t> diseqcMessage) generates (Result result); };
tv/tuner/1.0/IFrontendCallback.hal +9 −1 Original line number Diff line number Diff line Loading @@ -33,5 +33,13 @@ interface IFrontendCallback { * Specification Version 4.2. */ oneway onDiseqcMessage(vec<uint8_t> diseqcMessage); }; /** * The callback function that must be called by HAL implementation to notify * the client of scan messages. * * @param type the type of scan message. * @param message the scan message sent by HAL to the client. */ oneway onScanMessage(FrontendScanMessageType type, FrontendScanMessage message); };
tv/tuner/1.0/ILnb.hal 0 → 100644 +68 −0 Original line number Diff line number Diff line /* * Copyright (C) 2019 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.tv.tuner@1.0; /** * A Tuner LNB (low-noise block downconverter) is used by satellite frontend * to receive the microwave signal from the satellite, amplify it, and * downconvert the frequency to a lower frequency. */ interface ILnb { /** * Set the lnb's power voltage. * * @param voltage the power's voltage the Lnb to use. * @return result Result status of the operation. * SUCCESS if successful, * INVALID_ARGUMENT if the selected voltage isn't allowed, * UNKNOWN_ERROR if failed for other reasons. */ setVoltage(FrontendLnbVoltage voltage) generates (Result result); /** * Set the lnb's tone mode. * * @param tone the tone mode the Lnb to use. * @return result Result status of the operation. * SUCCESS if successful, * INVALID_ARGUMENT if the selected tone mode isn't allowed, * UNKNOWN_ERROR if failed for other reasons. */ setTone(FrontendLnbTone tone) generates (Result result); /** * Select the lnb's position. * * @param position the position the Lnb to use. * @return result Result status of the operation. * SUCCESS if successful, * INVALID_ARGUMENT if the selected position isn't allowed, * UNKNOWN_ERROR if failed for other reasons. */ setSatellitePosition(FrontendLnbPosition position) generates (Result result); /** * Releases the LNB instance * * Associated resources are released. close may be called more than once. * Calls to any other method after this will return an error * * @return result Result status of the operation. * SUCCESS if successful, * UNKNOWN_ERROR if failed for other reasons. */ close() generates (Result result); };
tv/tuner/1.0/ITuner.hal +46 −2 Original line number Diff line number Diff line Loading @@ -19,6 +19,7 @@ package android.hardware.tv.tuner@1.0; import IDemux; import IDescrambler; import IFrontend; import ILnb; /** * Top level interface to manage Frontend, Demux and Decrambler hardware Loading @@ -45,6 +46,7 @@ interface ITuner { * @param frontendId the id of the frontend to be opened. * @return result Result status of the operation. * SUCCESS if successful, * UNAVAILABLE if no resource. * UNKNOWN_ERROR if creation failed for other reasons. * @return frontend the newly created frontend interface. */ Loading Loading @@ -77,4 +79,46 @@ interface ITuner { */ openDescrambler() generates (Result result, IDescrambler descrambler); /** * Create a new instance of Descrambler. * * It is used by the client to create a Descrambler instance. * * @return result Result status of the operation. * SUCCESS if successful, * UNKNOWN_ERROR if creation failed for other reasons. * @return descrambler the newly created descrambler interface. */ getFrontendInfo(FrontendId frontendId) generates (Result result, FrontendInfo info); /** * Get low-noise block downconverter (LNB) IDs. * * It is used by the client to get all available LNBs' IDs. * * @return result Result status of the operation. * SUCCESS if successful, * UNKNOWN_ERROR if tuning failed for other reasons. * @return frontendIds an array of LnbId for the available LNBs. */ getLnbIds() generates (Result result, vec<LnbId> lnbIds); /** * Create a new instance of Lnb given a lnbId. * * It is used by the client to create a Lnb instance for satellite Frontend. * * @param lnbId the id of the LNB to be opened. * @return result Result status of the operation. * SUCCESS if successful, * UNAVAILABLE if no resource. * UNKNOWN_ERROR if creation failed for other reasons. * @return lnb the newly created Lnb interface. */ openLnbById(LnbId lnbId) generates (Result result, ILnb lnb); };
