1/* 2 * Copyright (C) 2016 The Android Open Source Project 3 * 4 * Licensed under the Apache License, Version 2.0 (the "License"); 5 * you may not use this file except in compliance with the License. 6 * You may obtain a copy of the License at 7 * 8 * http://www.apache.org/licenses/LICENSE-2.0 9 * 10 * Unless required by applicable law or agreed to in writing, software 11 * distributed under the License is distributed on an "AS IS" BASIS, 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13 * See the License for the specific language governing permissions and 14 * limitations under the License. 15 */ 16 17package android.hardware.contexthub@1.0; 18 19interface IContexthubCallback { 20 /** 21 * This callback is passed by the Contexthub service to the HAL 22 * implementation to allow the HAL to send asynchronous messages back 23 * to the service and registered clients of the ContextHub service. 24 * 25 * @params msg : message 26 * 27 */ 28 handleClientMsg(ContextHubMsg msg); 29 30 /** 31 * This callback is passed by the Contexthub service to the HAL 32 * implementation to allow the HAL to send the response for a 33 * transaction. 34 * 35 * @params txnId : transaction id whose result is being sent 36 * passed in by the service at start of transacation. 37 * result: result of transaction. 38 * 39 */ 40 handleTxnResult(uint32_t txnId, TransactionResult result); 41 42 /** 43 * This callback is passed by the Contexthub service to the HAL 44 * implementation to allow the HAL to send an asynchronous event 45 * to the ContextHub service. 46 * 47 * @params msg : message 48 * 49 */ 50 handleHubEvent(AsyncEventType evt); 51 52 /** 53 * This callback is passed by the Contexthub service to the HAL 54 * implementation to allow the HAL to send a notification to the service 55 * that a nanp-app has aborted. 56 * This method must be called when a nanoapp invokes chreAbort(...)). 57 * 58 * @params appId : app identifier 59 * : abortCode code passed by the nanoApp. 60 * 61 * Also see chreAbort(...) 62 * 63 */ 64 handleAppAbort(uint64_t appId, uint32_t abortCode); 65 66 /** 67 * This callback is passed by the Contexthub service to the HAL 68 * implementation to allow the HAL to send information about the 69 * currently loaded and active nanoapps on the hub. 70 * 71 * @params appInfo : vector of HubAppinfo structure for each nanoApp 72 * on the hub that can be enabled, disabled and 73 * unloaded by the service. Any nanoApps that cannot 74 * be controlled by the service must not be reported. 75 * All nanoApps that can be controlled by the service 76 * must be reported. 77 */ 78 handleAppsInfo(vec<HubAppInfo> appInfo); 79}; 80