xref: /aosp_15_r20/hardware/libhardware/modules/usbcamera/HotplugThread.h (revision e01b6f769022e40d0923dee176e8dc7cd1d52984)
1*e01b6f76SAndroid Build Coastguard Worker /*
2*e01b6f76SAndroid Build Coastguard Worker  * Copyright (C) 2015 The Android Open Source Project
3*e01b6f76SAndroid Build Coastguard Worker  *
4*e01b6f76SAndroid Build Coastguard Worker  * Licensed under the Apache License, Version 2.0 (the "License");
5*e01b6f76SAndroid Build Coastguard Worker  * you may not use this file except in compliance with the License.
6*e01b6f76SAndroid Build Coastguard Worker  * You may obtain a copy of the License at
7*e01b6f76SAndroid Build Coastguard Worker  *
8*e01b6f76SAndroid Build Coastguard Worker  *      http://www.apache.org/licenses/LICENSE-2.0
9*e01b6f76SAndroid Build Coastguard Worker  *
10*e01b6f76SAndroid Build Coastguard Worker  * Unless required by applicable law or agreed to in writing, software
11*e01b6f76SAndroid Build Coastguard Worker  * distributed under the License is distributed on an "AS IS" BASIS,
12*e01b6f76SAndroid Build Coastguard Worker  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13*e01b6f76SAndroid Build Coastguard Worker  * See the License for the specific language governing permissions and
14*e01b6f76SAndroid Build Coastguard Worker  * limitations under the License.
15*e01b6f76SAndroid Build Coastguard Worker  */
16*e01b6f76SAndroid Build Coastguard Worker #ifndef HOTPLUG_THREAD_H_
17*e01b6f76SAndroid Build Coastguard Worker #define HOTPLUG_THREAD_H_
18*e01b6f76SAndroid Build Coastguard Worker 
19*e01b6f76SAndroid Build Coastguard Worker #include <utils/Thread.h>
20*e01b6f76SAndroid Build Coastguard Worker #include "CameraHAL.h"
21*e01b6f76SAndroid Build Coastguard Worker 
22*e01b6f76SAndroid Build Coastguard Worker namespace usb_camera_hal {
23*e01b6f76SAndroid Build Coastguard Worker /**
24*e01b6f76SAndroid Build Coastguard Worker  * Thread for managing usb camera hotplug. It does below:
25*e01b6f76SAndroid Build Coastguard Worker  * 1. Monitor camera hotplug status, and notify the status changes by calling
26*e01b6f76SAndroid Build Coastguard Worker  *    module callback methods.
27*e01b6f76SAndroid Build Coastguard Worker  * 2. When camera is plugged, create camera device instance, initialize the camera
28*e01b6f76SAndroid Build Coastguard Worker  *    static info. When camera is unplugged, destroy the camera device instance and
29*e01b6f76SAndroid Build Coastguard Worker  *    static metadata. As an optimization option, the camera device instance (including
30*e01b6f76SAndroid Build Coastguard Worker  *    the static info) could be cached when the same camera plugged/unplugged multiple
31*e01b6f76SAndroid Build Coastguard Worker  *    times.
32*e01b6f76SAndroid Build Coastguard Worker  */
33*e01b6f76SAndroid Build Coastguard Worker 
34*e01b6f76SAndroid Build Coastguard Worker class CameraHAL;
35*e01b6f76SAndroid Build Coastguard Worker 
36*e01b6f76SAndroid Build Coastguard Worker class HotplugThread : public android::Thread {
37*e01b6f76SAndroid Build Coastguard Worker 
38*e01b6f76SAndroid Build Coastguard Worker     public:
39*e01b6f76SAndroid Build Coastguard Worker         explicit HotplugThread(CameraHAL *hal);
40*e01b6f76SAndroid Build Coastguard Worker         ~HotplugThread();
41*e01b6f76SAndroid Build Coastguard Worker 
42*e01b6f76SAndroid Build Coastguard Worker         // Override below two methods for proper cleanup.
43*e01b6f76SAndroid Build Coastguard Worker         virtual bool threadLoop();
44*e01b6f76SAndroid Build Coastguard Worker         virtual void requestExit();
45*e01b6f76SAndroid Build Coastguard Worker 
46*e01b6f76SAndroid Build Coastguard Worker     private:
47*e01b6f76SAndroid Build Coastguard Worker         CameraHAL *mModule;
48*e01b6f76SAndroid Build Coastguard Worker };
49*e01b6f76SAndroid Build Coastguard Worker 
50*e01b6f76SAndroid Build Coastguard Worker } // namespace usb_camera_hal
51*e01b6f76SAndroid Build Coastguard Worker 
52*e01b6f76SAndroid Build Coastguard Worker #endif // HOTPLUG_THREAD_H_
53