13cf4996d6ed09bf5dc2cd049d7d0df0816530aecYifan Hong/* 23cf4996d6ed09bf5dc2cd049d7d0df0816530aecYifan Hong * Copyright (C) 2017 The Android Open Source Project 33cf4996d6ed09bf5dc2cd049d7d0df0816530aecYifan Hong * 43cf4996d6ed09bf5dc2cd049d7d0df0816530aecYifan Hong * Licensed under the Apache License, Version 2.0 (the "License"); 53cf4996d6ed09bf5dc2cd049d7d0df0816530aecYifan Hong * you may not use this file except in compliance with the License. 63cf4996d6ed09bf5dc2cd049d7d0df0816530aecYifan Hong * You may obtain a copy of the License at 73cf4996d6ed09bf5dc2cd049d7d0df0816530aecYifan Hong * 83cf4996d6ed09bf5dc2cd049d7d0df0816530aecYifan Hong * http://www.apache.org/licenses/LICENSE-2.0 93cf4996d6ed09bf5dc2cd049d7d0df0816530aecYifan Hong * 103cf4996d6ed09bf5dc2cd049d7d0df0816530aecYifan Hong * Unless required by applicable law or agreed to in writing, software 113cf4996d6ed09bf5dc2cd049d7d0df0816530aecYifan Hong * distributed under the License is distributed on an "AS IS" BASIS, 123cf4996d6ed09bf5dc2cd049d7d0df0816530aecYifan Hong * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 133cf4996d6ed09bf5dc2cd049d7d0df0816530aecYifan Hong * See the License for the specific language governing permissions and 143cf4996d6ed09bf5dc2cd049d7d0df0816530aecYifan Hong * limitations under the License. 153cf4996d6ed09bf5dc2cd049d7d0df0816530aecYifan Hong */ 163cf4996d6ed09bf5dc2cd049d7d0df0816530aecYifan Hong 173cf4996d6ed09bf5dc2cd049d7d0df0816530aecYifan Hongpackage android.frameworks.sensorservice@1.0; 183cf4996d6ed09bf5dc2cd049d7d0df0816530aecYifan Hong 193cf4996d6ed09bf5dc2cd049d7d0df0816530aecYifan Hongimport android.hardware.sensors@1.0::RateLevel; 203cf4996d6ed09bf5dc2cd049d7d0df0816530aecYifan Hong 213cf4996d6ed09bf5dc2cd049d7d0df0816530aecYifan Hong/** 223cf4996d6ed09bf5dc2cd049d7d0df0816530aecYifan Hong * The interface represents a direct channel created by 233cf4996d6ed09bf5dc2cd049d7d0df0816530aecYifan Hong * ISensorManager.createSharedMemoryDirectChannel() and 243cf4996d6ed09bf5dc2cd049d7d0df0816530aecYifan Hong * ISensorMangaer.createHardwareBufferDirectChannel(). 253cf4996d6ed09bf5dc2cd049d7d0df0816530aecYifan Hong */ 263cf4996d6ed09bf5dc2cd049d7d0df0816530aecYifan Honginterface IDirectReportChannel { 273cf4996d6ed09bf5dc2cd049d7d0df0816530aecYifan Hong 283cf4996d6ed09bf5dc2cd049d7d0df0816530aecYifan Hong /** 293cf4996d6ed09bf5dc2cd049d7d0df0816530aecYifan Hong * Configure direct report on channel 303cf4996d6ed09bf5dc2cd049d7d0df0816530aecYifan Hong * 313cf4996d6ed09bf5dc2cd049d7d0df0816530aecYifan Hong * Configure sensor direct report on a direct channel: set rate to value 323cf4996d6ed09bf5dc2cd049d7d0df0816530aecYifan Hong * other than STOP so that sensor event can be directly written into the 333cf4996d6ed09bf5dc2cd049d7d0df0816530aecYifan Hong * shared memory region used for creating the channel; set rate to STOP will 343cf4996d6ed09bf5dc2cd049d7d0df0816530aecYifan Hong * stop the sensor direct report. 353cf4996d6ed09bf5dc2cd049d7d0df0816530aecYifan Hong * 363cf4996d6ed09bf5dc2cd049d7d0df0816530aecYifan Hong * To stop all active sensor direct report configured to a channel, set 373cf4996d6ed09bf5dc2cd049d7d0df0816530aecYifan Hong * sensorHandle to -1 and rate to STOP. 383cf4996d6ed09bf5dc2cd049d7d0df0816530aecYifan Hong * 393cf4996d6ed09bf5dc2cd049d7d0df0816530aecYifan Hong * @param sensorHandle handle of the sensor to operate on. If it is -1 403cf4996d6ed09bf5dc2cd049d7d0df0816530aecYifan Hong * and rate is STOP, the call must stop of all active 413cf4996d6ed09bf5dc2cd049d7d0df0816530aecYifan Hong * sensor direct report. 423cf4996d6ed09bf5dc2cd049d7d0df0816530aecYifan Hong * @param rate rate level value to set on the specified sensor. 433cf4996d6ed09bf5dc2cd049d7d0df0816530aecYifan Hong * 443cf4996d6ed09bf5dc2cd049d7d0df0816530aecYifan Hong * @return result OK on success; 453cf4996d6ed09bf5dc2cd049d7d0df0816530aecYifan Hong * BAD_VALUE if parameter is invalid (for example, 463cf4996d6ed09bf5dc2cd049d7d0df0816530aecYifan Hong * rate level is not supported by sensor, etc); 473cf4996d6ed09bf5dc2cd049d7d0df0816530aecYifan Hong * INVALID_OPERATION if functionality is not supported. 4817742bb97d889c4a82c37ca93c9414da2c6c049cYifan Hong * @return token the token used to distinguish sensor events from 4917742bb97d889c4a82c37ca93c9414da2c6c049cYifan Hong * multiple different sensors of the same type in a 5017742bb97d889c4a82c37ca93c9414da2c6c049cYifan Hong * single direct channel, or 0 if: (1) no such token 5117742bb97d889c4a82c37ca93c9414da2c6c049cYifan Hong * may be returned or (2) error (in which case result 5217742bb97d889c4a82c37ca93c9414da2c6c049cYifan Hong * must be value other than OK). 533cf4996d6ed09bf5dc2cd049d7d0df0816530aecYifan Hong */ 5417742bb97d889c4a82c37ca93c9414da2c6c049cYifan Hong configure(int32_t sensorHandle, RateLevel rate) 5517742bb97d889c4a82c37ca93c9414da2c6c049cYifan Hong generates (int32_t token, Result result); 563cf4996d6ed09bf5dc2cd049d7d0df0816530aecYifan Hong}; 57