Camera3Device.cpp revision 261394e3edbe10f4f145f543187dcfbabf702c11 
1/*
2 * Copyright (C) 2013 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
17#define LOG_TAG "Camera3-Device"
18#define ATRACE_TAG ATRACE_TAG_CAMERA
19//#define LOG_NDEBUG 0
20//#define LOG_NNDEBUG 0  // Per-frame verbose logging
21
22#ifdef LOG_NNDEBUG
23#define ALOGVV(...) ALOGV(__VA_ARGS__)
24#else
25#define ALOGVV(...) ((void)0)
26#endif
27
28// Convenience macro for transient errors
29#define CLOGE(fmt, ...) ALOGE("Camera %d: %s: " fmt, mId, __FUNCTION__, \
30            ##__VA_ARGS__)
31
32// Convenience macros for transitioning to the error state
33#define SET_ERR(fmt, ...) setErrorState(   \
34    "%s: " fmt, __FUNCTION__,              \
35    ##__VA_ARGS__)
36#define SET_ERR_L(fmt, ...) setErrorStateLocked( \
37    "%s: " fmt, __FUNCTION__,                    \
38    ##__VA_ARGS__)
39
40#include <inttypes.h>
41
42#include <utils/Log.h>
43#include <utils/Trace.h>
44#include <utils/Timers.h>
45
46#include "utils/CameraTraces.h"
47#include "device3/Camera3Device.h"
48#include "device3/Camera3OutputStream.h"
49#include "device3/Camera3InputStream.h"
50#include "device3/Camera3ZslStream.h"
51#include "device3/Camera3DummyStream.h"
52#include "CameraService.h"
53
54using namespace android::camera3;
55
56namespace android {
57
58Camera3Device::Camera3Device(int id):
59        mId(id),
60        mHal3Device(NULL),
61        mStatus(STATUS_UNINITIALIZED),
62        mUsePartialResult(false),
63        mNumPartialResults(1),
64        mNextResultFrameNumber(0),
65        mNextReprocessResultFrameNumber(0),
66        mNextShutterFrameNumber(0),
67        mListener(NULL)
68{
69    ATRACE_CALL();
70    camera3_callback_ops::notify = &sNotify;
71    camera3_callback_ops::process_capture_result = &sProcessCaptureResult;
72    ALOGV("%s: Created device for camera %d", __FUNCTION__, id);
73}
74
75Camera3Device::~Camera3Device()
76{
77    ATRACE_CALL();
78    ALOGV("%s: Tearing down for camera id %d", __FUNCTION__, mId);
79    disconnect();
80}
81
82int Camera3Device::getId() const {
83    return mId;
84}
85
86/**
87 * CameraDeviceBase interface
88 */
89
90status_t Camera3Device::initialize(CameraModule *module)
91{
92    ATRACE_CALL();
93    Mutex::Autolock il(mInterfaceLock);
94    Mutex::Autolock l(mLock);
95
96    ALOGV("%s: Initializing device for camera %d", __FUNCTION__, mId);
97    if (mStatus != STATUS_UNINITIALIZED) {
98        CLOGE("Already initialized!");
99        return INVALID_OPERATION;
100    }
101
102    /** Open HAL device */
103
104    status_t res;
105    String8 deviceName = String8::format("%d", mId);
106
107    camera3_device_t *device;
108
109    ATRACE_BEGIN("camera3->open");
110    res = module->open(deviceName.string(),
111            reinterpret_cast<hw_device_t**>(&device));
112    ATRACE_END();
113
114    if (res != OK) {
115        SET_ERR_L("Could not open camera: %s (%d)", strerror(-res), res);
116        return res;
117    }
118
119    /** Cross-check device version */
120    if (device->common.version < CAMERA_DEVICE_API_VERSION_3_0) {
121        SET_ERR_L("Could not open camera: "
122                "Camera device should be at least %x, reports %x instead",
123                CAMERA_DEVICE_API_VERSION_3_0,
124                device->common.version);
125        device->common.close(&device->common);
126        return BAD_VALUE;
127    }
128
129    camera_info info;
130    res = CameraService::filterGetInfoErrorCode(module->getCameraInfo(
131        mId, &info));
132    if (res != OK) return res;
133
134    if (info.device_version != device->common.version) {
135        SET_ERR_L("HAL reporting mismatched camera_info version (%x)"
136                " and device version (%x).",
137                info.device_version, device->common.version);
138        device->common.close(&device->common);
139        return BAD_VALUE;
140    }
141
142    /** Initialize device with callback functions */
143
144    ATRACE_BEGIN("camera3->initialize");
145    res = device->ops->initialize(device, this);
146    ATRACE_END();
147
148    if (res != OK) {
149        SET_ERR_L("Unable to initialize HAL device: %s (%d)",
150                strerror(-res), res);
151        device->common.close(&device->common);
152        return BAD_VALUE;
153    }
154
155    /** Start up status tracker thread */
156    mStatusTracker = new StatusTracker(this);
157    res = mStatusTracker->run(String8::format("C3Dev-%d-Status", mId).string());
158    if (res != OK) {
159        SET_ERR_L("Unable to start status tracking thread: %s (%d)",
160                strerror(-res), res);
161        device->common.close(&device->common);
162        mStatusTracker.clear();
163        return res;
164    }
165
166    /** Start up request queue thread */
167
168    mRequestThread = new RequestThread(this, mStatusTracker, device);
169    res = mRequestThread->run(String8::format("C3Dev-%d-ReqQueue", mId).string());
170    if (res != OK) {
171        SET_ERR_L("Unable to start request queue thread: %s (%d)",
172                strerror(-res), res);
173        device->common.close(&device->common);
174        mRequestThread.clear();
175        return res;
176    }
177
178    mPreparerThread = new PreparerThread();
179
180    /** Everything is good to go */
181
182    mDeviceVersion = device->common.version;
183    mDeviceInfo = info.static_camera_characteristics;
184    mHal3Device = device;
185    mStatus = STATUS_UNCONFIGURED;
186    mNextStreamId = 0;
187    mDummyStreamId = NO_STREAM;
188    mNeedConfig = true;
189    mPauseStateNotify = false;
190
191    // Will the HAL be sending in early partial result metadata?
192    if (mDeviceVersion >= CAMERA_DEVICE_API_VERSION_3_2) {
193        camera_metadata_entry partialResultsCount =
194                mDeviceInfo.find(ANDROID_REQUEST_PARTIAL_RESULT_COUNT);
195        if (partialResultsCount.count > 0) {
196            mNumPartialResults = partialResultsCount.data.i32[0];
197            mUsePartialResult = (mNumPartialResults > 1);
198        }
199    } else {
200        camera_metadata_entry partialResultsQuirk =
201                mDeviceInfo.find(ANDROID_QUIRKS_USE_PARTIAL_RESULT);
202        if (partialResultsQuirk.count > 0 && partialResultsQuirk.data.u8[0] == 1) {
203            mUsePartialResult = true;
204        }
205    }
206
207    camera_metadata_entry configs =
208            mDeviceInfo.find(ANDROID_SCALER_AVAILABLE_STREAM_CONFIGURATIONS);
209    for (uint32_t i = 0; i < configs.count; i += 4) {
210        if (configs.data.i32[i] == HAL_PIXEL_FORMAT_IMPLEMENTATION_DEFINED &&
211                configs.data.i32[i + 3] ==
212                ANDROID_SCALER_AVAILABLE_STREAM_CONFIGURATIONS_INPUT) {
213            mSupportedOpaqueInputSizes.add(Size(configs.data.i32[i + 1],
214                    configs.data.i32[i + 2]));
215        }
216    }
217
218    return OK;
219}
220
221status_t Camera3Device::disconnect() {
222    ATRACE_CALL();
223    Mutex::Autolock il(mInterfaceLock);
224
225    ALOGV("%s: E", __FUNCTION__);
226
227    status_t res = OK;
228
229    {
230        Mutex::Autolock l(mLock);
231        if (mStatus == STATUS_UNINITIALIZED) return res;
232
233        if (mStatus == STATUS_ACTIVE ||
234                (mStatus == STATUS_ERROR && mRequestThread != NULL)) {
235            res = mRequestThread->clearRepeatingRequests();
236            if (res != OK) {
237                SET_ERR_L("Can't stop streaming");
238                // Continue to close device even in case of error
239            } else {
240                res = waitUntilStateThenRelock(/*active*/ false, kShutdownTimeout);
241                if (res != OK) {
242                    SET_ERR_L("Timeout waiting for HAL to drain");
243                    // Continue to close device even in case of error
244                }
245            }
246        }
247
248        if (mStatus == STATUS_ERROR) {
249            CLOGE("Shutting down in an error state");
250        }
251
252        if (mStatusTracker != NULL) {
253            mStatusTracker->requestExit();
254        }
255
256        if (mRequestThread != NULL) {
257            mRequestThread->requestExit();
258        }
259
260        mOutputStreams.clear();
261        mInputStream.clear();
262    }
263
264    // Joining done without holding mLock, otherwise deadlocks may ensue
265    // as the threads try to access parent state
266    if (mRequestThread != NULL && mStatus != STATUS_ERROR) {
267        // HAL may be in a bad state, so waiting for request thread
268        // (which may be stuck in the HAL processCaptureRequest call)
269        // could be dangerous.
270        mRequestThread->join();
271    }
272
273    if (mStatusTracker != NULL) {
274        mStatusTracker->join();
275    }
276
277    {
278        Mutex::Autolock l(mLock);
279
280        mRequestThread.clear();
281        mStatusTracker.clear();
282
283        if (mHal3Device != NULL) {
284            ATRACE_BEGIN("camera3->close");
285            mHal3Device->common.close(&mHal3Device->common);
286            ATRACE_END();
287            mHal3Device = NULL;
288        }
289
290        mStatus = STATUS_UNINITIALIZED;
291    }
292
293    ALOGV("%s: X", __FUNCTION__);
294    return res;
295}
296
297// For dumping/debugging only -
298// try to acquire a lock a few times, eventually give up to proceed with
299// debug/dump operations
300bool Camera3Device::tryLockSpinRightRound(Mutex& lock) {
301    bool gotLock = false;
302    for (size_t i = 0; i < kDumpLockAttempts; ++i) {
303        if (lock.tryLock() == NO_ERROR) {
304            gotLock = true;
305            break;
306        } else {
307            usleep(kDumpSleepDuration);
308        }
309    }
310    return gotLock;
311}
312
313Camera3Device::Size Camera3Device::getMaxJpegResolution() const {
314    int32_t maxJpegWidth = 0, maxJpegHeight = 0;
315    if (mDeviceVersion >= CAMERA_DEVICE_API_VERSION_3_2) {
316        const int STREAM_CONFIGURATION_SIZE = 4;
317        const int STREAM_FORMAT_OFFSET = 0;
318        const int STREAM_WIDTH_OFFSET = 1;
319        const int STREAM_HEIGHT_OFFSET = 2;
320        const int STREAM_IS_INPUT_OFFSET = 3;
321        camera_metadata_ro_entry_t availableStreamConfigs =
322                mDeviceInfo.find(ANDROID_SCALER_AVAILABLE_STREAM_CONFIGURATIONS);
323        if (availableStreamConfigs.count == 0 ||
324                availableStreamConfigs.count % STREAM_CONFIGURATION_SIZE != 0) {
325            return Size(0, 0);
326        }
327
328        // Get max jpeg size (area-wise).
329        for (size_t i=0; i < availableStreamConfigs.count; i+= STREAM_CONFIGURATION_SIZE) {
330            int32_t format = availableStreamConfigs.data.i32[i + STREAM_FORMAT_OFFSET];
331            int32_t width = availableStreamConfigs.data.i32[i + STREAM_WIDTH_OFFSET];
332            int32_t height = availableStreamConfigs.data.i32[i + STREAM_HEIGHT_OFFSET];
333            int32_t isInput = availableStreamConfigs.data.i32[i + STREAM_IS_INPUT_OFFSET];
334            if (isInput == ANDROID_SCALER_AVAILABLE_STREAM_CONFIGURATIONS_OUTPUT
335                    && format == HAL_PIXEL_FORMAT_BLOB &&
336                    (width * height > maxJpegWidth * maxJpegHeight)) {
337                maxJpegWidth = width;
338                maxJpegHeight = height;
339            }
340        }
341    } else {
342        camera_metadata_ro_entry availableJpegSizes =
343                mDeviceInfo.find(ANDROID_SCALER_AVAILABLE_JPEG_SIZES);
344        if (availableJpegSizes.count == 0 || availableJpegSizes.count % 2 != 0) {
345            return Size(0, 0);
346        }
347
348        // Get max jpeg size (area-wise).
349        for (size_t i = 0; i < availableJpegSizes.count; i += 2) {
350            if ((availableJpegSizes.data.i32[i] * availableJpegSizes.data.i32[i + 1])
351                    > (maxJpegWidth * maxJpegHeight)) {
352                maxJpegWidth = availableJpegSizes.data.i32[i];
353                maxJpegHeight = availableJpegSizes.data.i32[i + 1];
354            }
355        }
356    }
357    return Size(maxJpegWidth, maxJpegHeight);
358}
359
360ssize_t Camera3Device::getJpegBufferSize(uint32_t width, uint32_t height) const {
361    // Get max jpeg size (area-wise).
362    Size maxJpegResolution = getMaxJpegResolution();
363    if (maxJpegResolution.width == 0) {
364        ALOGE("%s: Camera %d: Can't find find valid available jpeg sizes in static metadata!",
365                __FUNCTION__, mId);
366        return BAD_VALUE;
367    }
368
369    // Get max jpeg buffer size
370    ssize_t maxJpegBufferSize = 0;
371    camera_metadata_ro_entry jpegBufMaxSize = mDeviceInfo.find(ANDROID_JPEG_MAX_SIZE);
372    if (jpegBufMaxSize.count == 0) {
373        ALOGE("%s: Camera %d: Can't find maximum JPEG size in static metadata!", __FUNCTION__, mId);
374        return BAD_VALUE;
375    }
376    maxJpegBufferSize = jpegBufMaxSize.data.i32[0];
377    assert(kMinJpegBufferSize < maxJpegBufferSize);
378
379    // Calculate final jpeg buffer size for the given resolution.
380    float scaleFactor = ((float) (width * height)) /
381            (maxJpegResolution.width * maxJpegResolution.height);
382    ssize_t jpegBufferSize = scaleFactor * (maxJpegBufferSize - kMinJpegBufferSize) +
383            kMinJpegBufferSize;
384    if (jpegBufferSize > maxJpegBufferSize) {
385        jpegBufferSize = maxJpegBufferSize;
386    }
387
388    return jpegBufferSize;
389}
390
391status_t Camera3Device::dump(int fd, const Vector<String16> &args) {
392    ATRACE_CALL();
393    (void)args;
394
395    // Try to lock, but continue in case of failure (to avoid blocking in
396    // deadlocks)
397    bool gotInterfaceLock = tryLockSpinRightRound(mInterfaceLock);
398    bool gotLock = tryLockSpinRightRound(mLock);
399
400    ALOGW_IF(!gotInterfaceLock,
401            "Camera %d: %s: Unable to lock interface lock, proceeding anyway",
402            mId, __FUNCTION__);
403    ALOGW_IF(!gotLock,
404            "Camera %d: %s: Unable to lock main lock, proceeding anyway",
405            mId, __FUNCTION__);
406
407    String8 lines;
408
409    const char *status =
410            mStatus == STATUS_ERROR         ? "ERROR" :
411            mStatus == STATUS_UNINITIALIZED ? "UNINITIALIZED" :
412            mStatus == STATUS_UNCONFIGURED  ? "UNCONFIGURED" :
413            mStatus == STATUS_CONFIGURED    ? "CONFIGURED" :
414            mStatus == STATUS_ACTIVE        ? "ACTIVE" :
415            "Unknown";
416
417    lines.appendFormat("    Device status: %s\n", status);
418    if (mStatus == STATUS_ERROR) {
419        lines.appendFormat("    Error cause: %s\n", mErrorCause.string());
420    }
421    lines.appendFormat("    Stream configuration:\n");
422
423    if (mInputStream != NULL) {
424        write(fd, lines.string(), lines.size());
425        mInputStream->dump(fd, args);
426    } else {
427        lines.appendFormat("      No input stream.\n");
428        write(fd, lines.string(), lines.size());
429    }
430    for (size_t i = 0; i < mOutputStreams.size(); i++) {
431        mOutputStreams[i]->dump(fd,args);
432    }
433
434    lines = String8("    In-flight requests:\n");
435    if (mInFlightMap.size() == 0) {
436        lines.append("      None\n");
437    } else {
438        for (size_t i = 0; i < mInFlightMap.size(); i++) {
439            InFlightRequest r = mInFlightMap.valueAt(i);
440            lines.appendFormat("      Frame %d |  Timestamp: %" PRId64 ", metadata"
441                    " arrived: %s, buffers left: %d\n", mInFlightMap.keyAt(i),
442                    r.shutterTimestamp, r.haveResultMetadata ? "true" : "false",
443                    r.numBuffersLeft);
444        }
445    }
446    write(fd, lines.string(), lines.size());
447
448    {
449        lines = String8("    Last request sent:\n");
450        write(fd, lines.string(), lines.size());
451
452        CameraMetadata lastRequest = getLatestRequestLocked();
453        lastRequest.dump(fd, /*verbosity*/2, /*indentation*/6);
454    }
455
456    if (mHal3Device != NULL) {
457        lines = String8("    HAL device dump:\n");
458        write(fd, lines.string(), lines.size());
459        mHal3Device->ops->dump(mHal3Device, fd);
460    }
461
462    if (gotLock) mLock.unlock();
463    if (gotInterfaceLock) mInterfaceLock.unlock();
464
465    return OK;
466}
467
468const CameraMetadata& Camera3Device::info() const {
469    ALOGVV("%s: E", __FUNCTION__);
470    if (CC_UNLIKELY(mStatus == STATUS_UNINITIALIZED ||
471                    mStatus == STATUS_ERROR)) {
472        ALOGW("%s: Access to static info %s!", __FUNCTION__,
473                mStatus == STATUS_ERROR ?
474                "when in error state" : "before init");
475    }
476    return mDeviceInfo;
477}
478
479status_t Camera3Device::checkStatusOkToCaptureLocked() {
480    switch (mStatus) {
481        case STATUS_ERROR:
482            CLOGE("Device has encountered a serious error");
483            return INVALID_OPERATION;
484        case STATUS_UNINITIALIZED:
485            CLOGE("Device not initialized");
486            return INVALID_OPERATION;
487        case STATUS_UNCONFIGURED:
488        case STATUS_CONFIGURED:
489        case STATUS_ACTIVE:
490            // OK
491            break;
492        default:
493            SET_ERR_L("Unexpected status: %d", mStatus);
494            return INVALID_OPERATION;
495    }
496    return OK;
497}
498
499status_t Camera3Device::convertMetadataListToRequestListLocked(
500        const List<const CameraMetadata> &metadataList, RequestList *requestList) {
501    if (requestList == NULL) {
502        CLOGE("requestList cannot be NULL.");
503        return BAD_VALUE;
504    }
505
506    int32_t burstId = 0;
507    for (List<const CameraMetadata>::const_iterator it = metadataList.begin();
508            it != metadataList.end(); ++it) {
509        sp<CaptureRequest> newRequest = setUpRequestLocked(*it);
510        if (newRequest == 0) {
511            CLOGE("Can't create capture request");
512            return BAD_VALUE;
513        }
514
515        // Setup burst Id and request Id
516        newRequest->mResultExtras.burstId = burstId++;
517        if (it->exists(ANDROID_REQUEST_ID)) {
518            if (it->find(ANDROID_REQUEST_ID).count == 0) {
519                CLOGE("RequestID entry exists; but must not be empty in metadata");
520                return BAD_VALUE;
521            }
522            newRequest->mResultExtras.requestId = it->find(ANDROID_REQUEST_ID).data.i32[0];
523        } else {
524            CLOGE("RequestID does not exist in metadata");
525            return BAD_VALUE;
526        }
527
528        requestList->push_back(newRequest);
529
530        ALOGV("%s: requestId = %" PRId32, __FUNCTION__, newRequest->mResultExtras.requestId);
531    }
532    return OK;
533}
534
535status_t Camera3Device::capture(CameraMetadata &request, int64_t* /*lastFrameNumber*/) {
536    ATRACE_CALL();
537
538    List<const CameraMetadata> requests;
539    requests.push_back(request);
540    return captureList(requests, /*lastFrameNumber*/NULL);
541}
542
543status_t Camera3Device::submitRequestsHelper(
544        const List<const CameraMetadata> &requests, bool repeating,
545        /*out*/
546        int64_t *lastFrameNumber) {
547    ATRACE_CALL();
548    Mutex::Autolock il(mInterfaceLock);
549    Mutex::Autolock l(mLock);
550
551    status_t res = checkStatusOkToCaptureLocked();
552    if (res != OK) {
553        // error logged by previous call
554        return res;
555    }
556
557    RequestList requestList;
558
559    res = convertMetadataListToRequestListLocked(requests, /*out*/&requestList);
560    if (res != OK) {
561        // error logged by previous call
562        return res;
563    }
564
565    if (repeating) {
566        res = mRequestThread->setRepeatingRequests(requestList, lastFrameNumber);
567    } else {
568        res = mRequestThread->queueRequestList(requestList, lastFrameNumber);
569    }
570
571    if (res == OK) {
572        waitUntilStateThenRelock(/*active*/true, kActiveTimeout);
573        if (res != OK) {
574            SET_ERR_L("Can't transition to active in %f seconds!",
575                    kActiveTimeout/1e9);
576        }
577        ALOGV("Camera %d: Capture request %" PRId32 " enqueued", mId,
578              (*(requestList.begin()))->mResultExtras.requestId);
579    } else {
580        CLOGE("Cannot queue request. Impossible.");
581        return BAD_VALUE;
582    }
583
584    return res;
585}
586
587status_t Camera3Device::captureList(const List<const CameraMetadata> &requests,
588                                    int64_t *lastFrameNumber) {
589    ATRACE_CALL();
590
591    return submitRequestsHelper(requests, /*repeating*/false, lastFrameNumber);
592}
593
594status_t Camera3Device::setStreamingRequest(const CameraMetadata &request,
595                                            int64_t* /*lastFrameNumber*/) {
596    ATRACE_CALL();
597
598    List<const CameraMetadata> requests;
599    requests.push_back(request);
600    return setStreamingRequestList(requests, /*lastFrameNumber*/NULL);
601}
602
603status_t Camera3Device::setStreamingRequestList(const List<const CameraMetadata> &requests,
604                                                int64_t *lastFrameNumber) {
605    ATRACE_CALL();
606
607    return submitRequestsHelper(requests, /*repeating*/true, lastFrameNumber);
608}
609
610sp<Camera3Device::CaptureRequest> Camera3Device::setUpRequestLocked(
611        const CameraMetadata &request) {
612    status_t res;
613
614    if (mStatus == STATUS_UNCONFIGURED || mNeedConfig) {
615        res = configureStreamsLocked();
616        // Stream configuration failed due to unsupported configuration.
617        // Device back to unconfigured state. Client might try other configuraitons
618        if (res == BAD_VALUE && mStatus == STATUS_UNCONFIGURED) {
619            CLOGE("No streams configured");
620            return NULL;
621        }
622        // Stream configuration failed for other reason. Fatal.
623        if (res != OK) {
624            SET_ERR_L("Can't set up streams: %s (%d)", strerror(-res), res);
625            return NULL;
626        }
627        // Stream configuration successfully configure to empty stream configuration.
628        if (mStatus == STATUS_UNCONFIGURED) {
629            CLOGE("No streams configured");
630            return NULL;
631        }
632    }
633
634    sp<CaptureRequest> newRequest = createCaptureRequest(request);
635    return newRequest;
636}
637
638status_t Camera3Device::clearStreamingRequest(int64_t *lastFrameNumber) {
639    ATRACE_CALL();
640    Mutex::Autolock il(mInterfaceLock);
641    Mutex::Autolock l(mLock);
642
643    switch (mStatus) {
644        case STATUS_ERROR:
645            CLOGE("Device has encountered a serious error");
646            return INVALID_OPERATION;
647        case STATUS_UNINITIALIZED:
648            CLOGE("Device not initialized");
649            return INVALID_OPERATION;
650        case STATUS_UNCONFIGURED:
651        case STATUS_CONFIGURED:
652        case STATUS_ACTIVE:
653            // OK
654            break;
655        default:
656            SET_ERR_L("Unexpected status: %d", mStatus);
657            return INVALID_OPERATION;
658    }
659    ALOGV("Camera %d: Clearing repeating request", mId);
660
661    return mRequestThread->clearRepeatingRequests(lastFrameNumber);
662}
663
664status_t Camera3Device::waitUntilRequestReceived(int32_t requestId, nsecs_t timeout) {
665    ATRACE_CALL();
666    Mutex::Autolock il(mInterfaceLock);
667
668    return mRequestThread->waitUntilRequestProcessed(requestId, timeout);
669}
670
671status_t Camera3Device::createInputStream(
672        uint32_t width, uint32_t height, int format, int *id) {
673    ATRACE_CALL();
674    Mutex::Autolock il(mInterfaceLock);
675    Mutex::Autolock l(mLock);
676    ALOGV("Camera %d: Creating new input stream %d: %d x %d, format %d",
677            mId, mNextStreamId, width, height, format);
678
679    status_t res;
680    bool wasActive = false;
681
682    switch (mStatus) {
683        case STATUS_ERROR:
684            ALOGE("%s: Device has encountered a serious error", __FUNCTION__);
685            return INVALID_OPERATION;
686        case STATUS_UNINITIALIZED:
687            ALOGE("%s: Device not initialized", __FUNCTION__);
688            return INVALID_OPERATION;
689        case STATUS_UNCONFIGURED:
690        case STATUS_CONFIGURED:
691            // OK
692            break;
693        case STATUS_ACTIVE:
694            ALOGV("%s: Stopping activity to reconfigure streams", __FUNCTION__);
695            res = internalPauseAndWaitLocked();
696            if (res != OK) {
697                SET_ERR_L("Can't pause captures to reconfigure streams!");
698                return res;
699            }
700            wasActive = true;
701            break;
702        default:
703            SET_ERR_L("%s: Unexpected status: %d", mStatus);
704            return INVALID_OPERATION;
705    }
706    assert(mStatus != STATUS_ACTIVE);
707
708    if (mInputStream != 0) {
709        ALOGE("%s: Cannot create more than 1 input stream", __FUNCTION__);
710        return INVALID_OPERATION;
711    }
712
713    sp<Camera3InputStream> newStream = new Camera3InputStream(mNextStreamId,
714                width, height, format);
715    newStream->setStatusTracker(mStatusTracker);
716
717    mInputStream = newStream;
718
719    *id = mNextStreamId++;
720
721    // Continue captures if active at start
722    if (wasActive) {
723        ALOGV("%s: Restarting activity to reconfigure streams", __FUNCTION__);
724        res = configureStreamsLocked();
725        if (res != OK) {
726            ALOGE("%s: Can't reconfigure device for new stream %d: %s (%d)",
727                    __FUNCTION__, mNextStreamId, strerror(-res), res);
728            return res;
729        }
730        internalResumeLocked();
731    }
732
733    ALOGV("Camera %d: Created input stream", mId);
734    return OK;
735}
736
737
738status_t Camera3Device::createZslStream(
739            uint32_t width, uint32_t height,
740            int depth,
741            /*out*/
742            int *id,
743            sp<Camera3ZslStream>* zslStream) {
744    ATRACE_CALL();
745    Mutex::Autolock il(mInterfaceLock);
746    Mutex::Autolock l(mLock);
747    ALOGV("Camera %d: Creating ZSL stream %d: %d x %d, depth %d",
748            mId, mNextStreamId, width, height, depth);
749
750    status_t res;
751    bool wasActive = false;
752
753    switch (mStatus) {
754        case STATUS_ERROR:
755            ALOGE("%s: Device has encountered a serious error", __FUNCTION__);
756            return INVALID_OPERATION;
757        case STATUS_UNINITIALIZED:
758            ALOGE("%s: Device not initialized", __FUNCTION__);
759            return INVALID_OPERATION;
760        case STATUS_UNCONFIGURED:
761        case STATUS_CONFIGURED:
762            // OK
763            break;
764        case STATUS_ACTIVE:
765            ALOGV("%s: Stopping activity to reconfigure streams", __FUNCTION__);
766            res = internalPauseAndWaitLocked();
767            if (res != OK) {
768                SET_ERR_L("Can't pause captures to reconfigure streams!");
769                return res;
770            }
771            wasActive = true;
772            break;
773        default:
774            SET_ERR_L("Unexpected status: %d", mStatus);
775            return INVALID_OPERATION;
776    }
777    assert(mStatus != STATUS_ACTIVE);
778
779    if (mInputStream != 0) {
780        ALOGE("%s: Cannot create more than 1 input stream", __FUNCTION__);
781        return INVALID_OPERATION;
782    }
783
784    sp<Camera3ZslStream> newStream = new Camera3ZslStream(mNextStreamId,
785                width, height, depth);
786    newStream->setStatusTracker(mStatusTracker);
787
788    res = mOutputStreams.add(mNextStreamId, newStream);
789    if (res < 0) {
790        ALOGE("%s: Can't add new stream to set: %s (%d)",
791                __FUNCTION__, strerror(-res), res);
792        return res;
793    }
794    mInputStream = newStream;
795
796    mNeedConfig = true;
797
798    *id = mNextStreamId++;
799    *zslStream = newStream;
800
801    // Continue captures if active at start
802    if (wasActive) {
803        ALOGV("%s: Restarting activity to reconfigure streams", __FUNCTION__);
804        res = configureStreamsLocked();
805        if (res != OK) {
806            ALOGE("%s: Can't reconfigure device for new stream %d: %s (%d)",
807                    __FUNCTION__, mNextStreamId, strerror(-res), res);
808            return res;
809        }
810        internalResumeLocked();
811    }
812
813    ALOGV("Camera %d: Created ZSL stream", mId);
814    return OK;
815}
816
817status_t Camera3Device::createStream(sp<ANativeWindow> consumer,
818        uint32_t width, uint32_t height, int format, android_dataspace dataSpace,
819        camera3_stream_rotation_t rotation, int *id) {
820    ATRACE_CALL();
821    Mutex::Autolock il(mInterfaceLock);
822    Mutex::Autolock l(mLock);
823    ALOGV("Camera %d: Creating new stream %d: %d x %d, format %d, dataspace %d rotation %d",
824            mId, mNextStreamId, width, height, format, dataSpace, rotation);
825
826    status_t res;
827    bool wasActive = false;
828
829    switch (mStatus) {
830        case STATUS_ERROR:
831            CLOGE("Device has encountered a serious error");
832            return INVALID_OPERATION;
833        case STATUS_UNINITIALIZED:
834            CLOGE("Device not initialized");
835            return INVALID_OPERATION;
836        case STATUS_UNCONFIGURED:
837        case STATUS_CONFIGURED:
838            // OK
839            break;
840        case STATUS_ACTIVE:
841            ALOGV("%s: Stopping activity to reconfigure streams", __FUNCTION__);
842            res = internalPauseAndWaitLocked();
843            if (res != OK) {
844                SET_ERR_L("Can't pause captures to reconfigure streams!");
845                return res;
846            }
847            wasActive = true;
848            break;
849        default:
850            SET_ERR_L("Unexpected status: %d", mStatus);
851            return INVALID_OPERATION;
852    }
853    assert(mStatus != STATUS_ACTIVE);
854
855    sp<Camera3OutputStream> newStream;
856    if (format == HAL_PIXEL_FORMAT_BLOB) {
857        ssize_t jpegBufferSize = getJpegBufferSize(width, height);
858        if (jpegBufferSize <= 0) {
859            SET_ERR_L("Invalid jpeg buffer size %zd", jpegBufferSize);
860            return BAD_VALUE;
861        }
862
863        newStream = new Camera3OutputStream(mNextStreamId, consumer,
864                width, height, jpegBufferSize, format, dataSpace, rotation);
865    } else {
866        newStream = new Camera3OutputStream(mNextStreamId, consumer,
867                width, height, format, dataSpace, rotation);
868    }
869    newStream->setStatusTracker(mStatusTracker);
870
871    res = mOutputStreams.add(mNextStreamId, newStream);
872    if (res < 0) {
873        SET_ERR_L("Can't add new stream to set: %s (%d)", strerror(-res), res);
874        return res;
875    }
876
877    *id = mNextStreamId++;
878    mNeedConfig = true;
879
880    // Continue captures if active at start
881    if (wasActive) {
882        ALOGV("%s: Restarting activity to reconfigure streams", __FUNCTION__);
883        res = configureStreamsLocked();
884        if (res != OK) {
885            CLOGE("Can't reconfigure device for new stream %d: %s (%d)",
886                    mNextStreamId, strerror(-res), res);
887            return res;
888        }
889        internalResumeLocked();
890    }
891    ALOGV("Camera %d: Created new stream", mId);
892    return OK;
893}
894
895status_t Camera3Device::createReprocessStreamFromStream(int outputId, int *id) {
896    ATRACE_CALL();
897    (void)outputId; (void)id;
898
899    CLOGE("Unimplemented");
900    return INVALID_OPERATION;
901}
902
903
904status_t Camera3Device::getStreamInfo(int id,
905        uint32_t *width, uint32_t *height, uint32_t *format) {
906    ATRACE_CALL();
907    Mutex::Autolock il(mInterfaceLock);
908    Mutex::Autolock l(mLock);
909
910    switch (mStatus) {
911        case STATUS_ERROR:
912            CLOGE("Device has encountered a serious error");
913            return INVALID_OPERATION;
914        case STATUS_UNINITIALIZED:
915            CLOGE("Device not initialized!");
916            return INVALID_OPERATION;
917        case STATUS_UNCONFIGURED:
918        case STATUS_CONFIGURED:
919        case STATUS_ACTIVE:
920            // OK
921            break;
922        default:
923            SET_ERR_L("Unexpected status: %d", mStatus);
924            return INVALID_OPERATION;
925    }
926
927    ssize_t idx = mOutputStreams.indexOfKey(id);
928    if (idx == NAME_NOT_FOUND) {
929        CLOGE("Stream %d is unknown", id);
930        return idx;
931    }
932
933    if (width) *width  = mOutputStreams[idx]->getWidth();
934    if (height) *height = mOutputStreams[idx]->getHeight();
935    if (format) *format = mOutputStreams[idx]->getFormat();
936
937    return OK;
938}
939
940status_t Camera3Device::setStreamTransform(int id,
941        int transform) {
942    ATRACE_CALL();
943    Mutex::Autolock il(mInterfaceLock);
944    Mutex::Autolock l(mLock);
945
946    switch (mStatus) {
947        case STATUS_ERROR:
948            CLOGE("Device has encountered a serious error");
949            return INVALID_OPERATION;
950        case STATUS_UNINITIALIZED:
951            CLOGE("Device not initialized");
952            return INVALID_OPERATION;
953        case STATUS_UNCONFIGURED:
954        case STATUS_CONFIGURED:
955        case STATUS_ACTIVE:
956            // OK
957            break;
958        default:
959            SET_ERR_L("Unexpected status: %d", mStatus);
960            return INVALID_OPERATION;
961    }
962
963    ssize_t idx = mOutputStreams.indexOfKey(id);
964    if (idx == NAME_NOT_FOUND) {
965        CLOGE("Stream %d does not exist",
966                id);
967        return BAD_VALUE;
968    }
969
970    return mOutputStreams.editValueAt(idx)->setTransform(transform);
971}
972
973status_t Camera3Device::deleteStream(int id) {
974    ATRACE_CALL();
975    Mutex::Autolock il(mInterfaceLock);
976    Mutex::Autolock l(mLock);
977    status_t res;
978
979    ALOGV("%s: Camera %d: Deleting stream %d", __FUNCTION__, mId, id);
980
981    // CameraDevice semantics require device to already be idle before
982    // deleteStream is called, unlike for createStream.
983    if (mStatus == STATUS_ACTIVE) {
984        ALOGV("%s: Camera %d: Device not idle", __FUNCTION__, mId);
985        return -EBUSY;
986    }
987
988    sp<Camera3StreamInterface> deletedStream;
989    ssize_t outputStreamIdx = mOutputStreams.indexOfKey(id);
990    if (mInputStream != NULL && id == mInputStream->getId()) {
991        deletedStream = mInputStream;
992        mInputStream.clear();
993    } else {
994        if (outputStreamIdx == NAME_NOT_FOUND) {
995            CLOGE("Stream %d does not exist", id);
996            return BAD_VALUE;
997        }
998    }
999
1000    // Delete output stream or the output part of a bi-directional stream.
1001    if (outputStreamIdx != NAME_NOT_FOUND) {
1002        deletedStream = mOutputStreams.editValueAt(outputStreamIdx);
1003        mOutputStreams.removeItem(id);
1004    }
1005
1006    // Free up the stream endpoint so that it can be used by some other stream
1007    res = deletedStream->disconnect();
1008    if (res != OK) {
1009        SET_ERR_L("Can't disconnect deleted stream %d", id);
1010        // fall through since we want to still list the stream as deleted.
1011    }
1012    mDeletedStreams.add(deletedStream);
1013    mNeedConfig = true;
1014
1015    return res;
1016}
1017
1018status_t Camera3Device::deleteReprocessStream(int id) {
1019    ATRACE_CALL();
1020    (void)id;
1021
1022    CLOGE("Unimplemented");
1023    return INVALID_OPERATION;
1024}
1025
1026status_t Camera3Device::configureStreams() {
1027    ATRACE_CALL();
1028    ALOGV("%s: E", __FUNCTION__);
1029
1030    Mutex::Autolock il(mInterfaceLock);
1031    Mutex::Autolock l(mLock);
1032
1033    return configureStreamsLocked();
1034}
1035
1036status_t Camera3Device::getInputBufferProducer(
1037        sp<IGraphicBufferProducer> *producer) {
1038    Mutex::Autolock il(mInterfaceLock);
1039    Mutex::Autolock l(mLock);
1040
1041    if (producer == NULL) {
1042        return BAD_VALUE;
1043    } else if (mInputStream == NULL) {
1044        return INVALID_OPERATION;
1045    }
1046
1047    return mInputStream->getInputBufferProducer(producer);
1048}
1049
1050status_t Camera3Device::createDefaultRequest(int templateId,
1051        CameraMetadata *request) {
1052    ATRACE_CALL();
1053    ALOGV("%s: for template %d", __FUNCTION__, templateId);
1054    Mutex::Autolock il(mInterfaceLock);
1055    Mutex::Autolock l(mLock);
1056
1057    switch (mStatus) {
1058        case STATUS_ERROR:
1059            CLOGE("Device has encountered a serious error");
1060            return INVALID_OPERATION;
1061        case STATUS_UNINITIALIZED:
1062            CLOGE("Device is not initialized!");
1063            return INVALID_OPERATION;
1064        case STATUS_UNCONFIGURED:
1065        case STATUS_CONFIGURED:
1066        case STATUS_ACTIVE:
1067            // OK
1068            break;
1069        default:
1070            SET_ERR_L("Unexpected status: %d", mStatus);
1071            return INVALID_OPERATION;
1072    }
1073
1074    if (!mRequestTemplateCache[templateId].isEmpty()) {
1075        *request = mRequestTemplateCache[templateId];
1076        return OK;
1077    }
1078
1079    const camera_metadata_t *rawRequest;
1080    ATRACE_BEGIN("camera3->construct_default_request_settings");
1081    rawRequest = mHal3Device->ops->construct_default_request_settings(
1082        mHal3Device, templateId);
1083    ATRACE_END();
1084    if (rawRequest == NULL) {
1085        ALOGI("%s: template %d is not supported on this camera device",
1086              __FUNCTION__, templateId);
1087        return BAD_VALUE;
1088    }
1089    *request = rawRequest;
1090    mRequestTemplateCache[templateId] = rawRequest;
1091
1092    return OK;
1093}
1094
1095status_t Camera3Device::waitUntilDrained() {
1096    ATRACE_CALL();
1097    Mutex::Autolock il(mInterfaceLock);
1098    Mutex::Autolock l(mLock);
1099
1100    return waitUntilDrainedLocked();
1101}
1102
1103status_t Camera3Device::waitUntilDrainedLocked() {
1104    switch (mStatus) {
1105        case STATUS_UNINITIALIZED:
1106        case STATUS_UNCONFIGURED:
1107            ALOGV("%s: Already idle", __FUNCTION__);
1108            return OK;
1109        case STATUS_CONFIGURED:
1110            // To avoid race conditions, check with tracker to be sure
1111        case STATUS_ERROR:
1112        case STATUS_ACTIVE:
1113            // Need to verify shut down
1114            break;
1115        default:
1116            SET_ERR_L("Unexpected status: %d",mStatus);
1117            return INVALID_OPERATION;
1118    }
1119
1120    ALOGV("%s: Camera %d: Waiting until idle", __FUNCTION__, mId);
1121    status_t res = waitUntilStateThenRelock(/*active*/ false, kShutdownTimeout);
1122    if (res != OK) {
1123        SET_ERR_L("Error waiting for HAL to drain: %s (%d)", strerror(-res),
1124                res);
1125    }
1126    return res;
1127}
1128
1129// Pause to reconfigure
1130status_t Camera3Device::internalPauseAndWaitLocked() {
1131    mRequestThread->setPaused(true);
1132    mPauseStateNotify = true;
1133
1134    ALOGV("%s: Camera %d: Internal wait until idle", __FUNCTION__, mId);
1135    status_t res = waitUntilStateThenRelock(/*active*/ false, kShutdownTimeout);
1136    if (res != OK) {
1137        SET_ERR_L("Can't idle device in %f seconds!",
1138                kShutdownTimeout/1e9);
1139    }
1140
1141    return res;
1142}
1143
1144// Resume after internalPauseAndWaitLocked
1145status_t Camera3Device::internalResumeLocked() {
1146    status_t res;
1147
1148    mRequestThread->setPaused(false);
1149
1150    res = waitUntilStateThenRelock(/*active*/ true, kActiveTimeout);
1151    if (res != OK) {
1152        SET_ERR_L("Can't transition to active in %f seconds!",
1153                kActiveTimeout/1e9);
1154    }
1155    mPauseStateNotify = false;
1156    return OK;
1157}
1158
1159status_t Camera3Device::waitUntilStateThenRelock(bool active,
1160        nsecs_t timeout) {
1161    status_t res = OK;
1162    if (active == (mStatus == STATUS_ACTIVE)) {
1163        // Desired state already reached
1164        return res;
1165    }
1166
1167    bool stateSeen = false;
1168    do {
1169        mRecentStatusUpdates.clear();
1170
1171        res = mStatusChanged.waitRelative(mLock, timeout);
1172        if (res != OK) break;
1173
1174        // Check state change history during wait
1175        for (size_t i = 0; i < mRecentStatusUpdates.size(); i++) {
1176            if (active == (mRecentStatusUpdates[i] == STATUS_ACTIVE) ) {
1177                stateSeen = true;
1178                break;
1179            }
1180        }
1181    } while (!stateSeen);
1182
1183    return res;
1184}
1185
1186
1187status_t Camera3Device::setNotifyCallback(NotificationListener *listener) {
1188    ATRACE_CALL();
1189    Mutex::Autolock l(mOutputLock);
1190
1191    if (listener != NULL && mListener != NULL) {
1192        ALOGW("%s: Replacing old callback listener", __FUNCTION__);
1193    }
1194    mListener = listener;
1195    mRequestThread->setNotificationListener(listener);
1196    mPreparerThread->setNotificationListener(listener);
1197
1198    return OK;
1199}
1200
1201bool Camera3Device::willNotify3A() {
1202    return false;
1203}
1204
1205status_t Camera3Device::waitForNextFrame(nsecs_t timeout) {
1206    status_t res;
1207    Mutex::Autolock l(mOutputLock);
1208
1209    while (mResultQueue.empty()) {
1210        res = mResultSignal.waitRelative(mOutputLock, timeout);
1211        if (res == TIMED_OUT) {
1212            return res;
1213        } else if (res != OK) {
1214            ALOGW("%s: Camera %d: No frame in %" PRId64 " ns: %s (%d)",
1215                    __FUNCTION__, mId, timeout, strerror(-res), res);
1216            return res;
1217        }
1218    }
1219    return OK;
1220}
1221
1222status_t Camera3Device::getNextResult(CaptureResult *frame) {
1223    ATRACE_CALL();
1224    Mutex::Autolock l(mOutputLock);
1225
1226    if (mResultQueue.empty()) {
1227        return NOT_ENOUGH_DATA;
1228    }
1229
1230    if (frame == NULL) {
1231        ALOGE("%s: argument cannot be NULL", __FUNCTION__);
1232        return BAD_VALUE;
1233    }
1234
1235    CaptureResult &result = *(mResultQueue.begin());
1236    frame->mResultExtras = result.mResultExtras;
1237    frame->mMetadata.acquire(result.mMetadata);
1238    mResultQueue.erase(mResultQueue.begin());
1239
1240    return OK;
1241}
1242
1243status_t Camera3Device::triggerAutofocus(uint32_t id) {
1244    ATRACE_CALL();
1245    Mutex::Autolock il(mInterfaceLock);
1246
1247    ALOGV("%s: Triggering autofocus, id %d", __FUNCTION__, id);
1248    // Mix-in this trigger into the next request and only the next request.
1249    RequestTrigger trigger[] = {
1250        {
1251            ANDROID_CONTROL_AF_TRIGGER,
1252            ANDROID_CONTROL_AF_TRIGGER_START
1253        },
1254        {
1255            ANDROID_CONTROL_AF_TRIGGER_ID,
1256            static_cast<int32_t>(id)
1257        }
1258    };
1259
1260    return mRequestThread->queueTrigger(trigger,
1261                                        sizeof(trigger)/sizeof(trigger[0]));
1262}
1263
1264status_t Camera3Device::triggerCancelAutofocus(uint32_t id) {
1265    ATRACE_CALL();
1266    Mutex::Autolock il(mInterfaceLock);
1267
1268    ALOGV("%s: Triggering cancel autofocus, id %d", __FUNCTION__, id);
1269    // Mix-in this trigger into the next request and only the next request.
1270    RequestTrigger trigger[] = {
1271        {
1272            ANDROID_CONTROL_AF_TRIGGER,
1273            ANDROID_CONTROL_AF_TRIGGER_CANCEL
1274        },
1275        {
1276            ANDROID_CONTROL_AF_TRIGGER_ID,
1277            static_cast<int32_t>(id)
1278        }
1279    };
1280
1281    return mRequestThread->queueTrigger(trigger,
1282                                        sizeof(trigger)/sizeof(trigger[0]));
1283}
1284
1285status_t Camera3Device::triggerPrecaptureMetering(uint32_t id) {
1286    ATRACE_CALL();
1287    Mutex::Autolock il(mInterfaceLock);
1288
1289    ALOGV("%s: Triggering precapture metering, id %d", __FUNCTION__, id);
1290    // Mix-in this trigger into the next request and only the next request.
1291    RequestTrigger trigger[] = {
1292        {
1293            ANDROID_CONTROL_AE_PRECAPTURE_TRIGGER,
1294            ANDROID_CONTROL_AE_PRECAPTURE_TRIGGER_START
1295        },
1296        {
1297            ANDROID_CONTROL_AE_PRECAPTURE_ID,
1298            static_cast<int32_t>(id)
1299        }
1300    };
1301
1302    return mRequestThread->queueTrigger(trigger,
1303                                        sizeof(trigger)/sizeof(trigger[0]));
1304}
1305
1306status_t Camera3Device::pushReprocessBuffer(int reprocessStreamId,
1307        buffer_handle_t *buffer, wp<BufferReleasedListener> listener) {
1308    ATRACE_CALL();
1309    (void)reprocessStreamId; (void)buffer; (void)listener;
1310
1311    CLOGE("Unimplemented");
1312    return INVALID_OPERATION;
1313}
1314
1315status_t Camera3Device::flush(int64_t *frameNumber) {
1316    ATRACE_CALL();
1317    ALOGV("%s: Camera %d: Flushing all requests", __FUNCTION__, mId);
1318    Mutex::Autolock il(mInterfaceLock);
1319
1320    NotificationListener* listener;
1321    {
1322        Mutex::Autolock l(mOutputLock);
1323        listener = mListener;
1324    }
1325
1326    {
1327        Mutex::Autolock l(mLock);
1328        mRequestThread->clear(listener, /*out*/frameNumber);
1329    }
1330
1331    status_t res;
1332    if (mHal3Device->common.version >= CAMERA_DEVICE_API_VERSION_3_1) {
1333        res = mHal3Device->ops->flush(mHal3Device);
1334    } else {
1335        Mutex::Autolock l(mLock);
1336        res = waitUntilDrainedLocked();
1337    }
1338
1339    return res;
1340}
1341
1342status_t Camera3Device::prepare(int streamId) {
1343    ATRACE_CALL();
1344    ALOGV("%s: Camera %d: Preparing stream %d", __FUNCTION__, mId, streamId);
1345    Mutex::Autolock il(mInterfaceLock);
1346    Mutex::Autolock l(mLock);
1347
1348    sp<Camera3StreamInterface> stream;
1349    ssize_t outputStreamIdx = mOutputStreams.indexOfKey(streamId);
1350    if (outputStreamIdx == NAME_NOT_FOUND) {
1351        CLOGE("Stream %d does not exist", streamId);
1352        return BAD_VALUE;
1353    }
1354
1355    stream = mOutputStreams.editValueAt(outputStreamIdx);
1356
1357    if (stream->isUnpreparable() || stream->hasOutstandingBuffers() ) {
1358        CLOGE("Stream %d has already been a request target", streamId);
1359        return BAD_VALUE;
1360    }
1361
1362    if (mRequestThread->isStreamPending(stream)) {
1363        CLOGE("Stream %d is already a target in a pending request", streamId);
1364        return BAD_VALUE;
1365    }
1366
1367    return mPreparerThread->prepare(stream);
1368}
1369
1370uint32_t Camera3Device::getDeviceVersion() {
1371    ATRACE_CALL();
1372    Mutex::Autolock il(mInterfaceLock);
1373    return mDeviceVersion;
1374}
1375
1376/**
1377 * Methods called by subclasses
1378 */
1379
1380void Camera3Device::notifyStatus(bool idle) {
1381    {
1382        // Need mLock to safely update state and synchronize to current
1383        // state of methods in flight.
1384        Mutex::Autolock l(mLock);
1385        // We can get various system-idle notices from the status tracker
1386        // while starting up. Only care about them if we've actually sent
1387        // in some requests recently.
1388        if (mStatus != STATUS_ACTIVE && mStatus != STATUS_CONFIGURED) {
1389            return;
1390        }
1391        ALOGV("%s: Camera %d: Now %s", __FUNCTION__, mId,
1392                idle ? "idle" : "active");
1393        mStatus = idle ? STATUS_CONFIGURED : STATUS_ACTIVE;
1394        mRecentStatusUpdates.add(mStatus);
1395        mStatusChanged.signal();
1396
1397        // Skip notifying listener if we're doing some user-transparent
1398        // state changes
1399        if (mPauseStateNotify) return;
1400    }
1401    NotificationListener *listener;
1402    {
1403        Mutex::Autolock l(mOutputLock);
1404        listener = mListener;
1405    }
1406    if (idle && listener != NULL) {
1407        listener->notifyIdle();
1408    }
1409}
1410
1411/**
1412 * Camera3Device private methods
1413 */
1414
1415sp<Camera3Device::CaptureRequest> Camera3Device::createCaptureRequest(
1416        const CameraMetadata &request) {
1417    ATRACE_CALL();
1418    status_t res;
1419
1420    sp<CaptureRequest> newRequest = new CaptureRequest;
1421    newRequest->mSettings = request;
1422
1423    camera_metadata_entry_t inputStreams =
1424            newRequest->mSettings.find(ANDROID_REQUEST_INPUT_STREAMS);
1425    if (inputStreams.count > 0) {
1426        if (mInputStream == NULL ||
1427                mInputStream->getId() != inputStreams.data.i32[0]) {
1428            CLOGE("Request references unknown input stream %d",
1429                    inputStreams.data.u8[0]);
1430            return NULL;
1431        }
1432        // Lazy completion of stream configuration (allocation/registration)
1433        // on first use
1434        if (mInputStream->isConfiguring()) {
1435            res = mInputStream->finishConfiguration(mHal3Device);
1436            if (res != OK) {
1437                SET_ERR_L("Unable to finish configuring input stream %d:"
1438                        " %s (%d)",
1439                        mInputStream->getId(), strerror(-res), res);
1440                return NULL;
1441            }
1442        }
1443        // Check if stream is being prepared
1444        if (mInputStream->isPreparing()) {
1445            CLOGE("Request references an input stream that's being prepared!");
1446            return NULL;
1447        }
1448
1449        newRequest->mInputStream = mInputStream;
1450        newRequest->mSettings.erase(ANDROID_REQUEST_INPUT_STREAMS);
1451    }
1452
1453    camera_metadata_entry_t streams =
1454            newRequest->mSettings.find(ANDROID_REQUEST_OUTPUT_STREAMS);
1455    if (streams.count == 0) {
1456        CLOGE("Zero output streams specified!");
1457        return NULL;
1458    }
1459
1460    for (size_t i = 0; i < streams.count; i++) {
1461        int idx = mOutputStreams.indexOfKey(streams.data.i32[i]);
1462        if (idx == NAME_NOT_FOUND) {
1463            CLOGE("Request references unknown stream %d",
1464                    streams.data.u8[i]);
1465            return NULL;
1466        }
1467        sp<Camera3OutputStreamInterface> stream =
1468                mOutputStreams.editValueAt(idx);
1469
1470        // Lazy completion of stream configuration (allocation/registration)
1471        // on first use
1472        if (stream->isConfiguring()) {
1473            res = stream->finishConfiguration(mHal3Device);
1474            if (res != OK) {
1475                SET_ERR_L("Unable to finish configuring stream %d: %s (%d)",
1476                        stream->getId(), strerror(-res), res);
1477                return NULL;
1478            }
1479        }
1480        // Check if stream is being prepared
1481        if (stream->isPreparing()) {
1482            CLOGE("Request references an output stream that's being prepared!");
1483            return NULL;
1484        }
1485
1486        newRequest->mOutputStreams.push(stream);
1487    }
1488    newRequest->mSettings.erase(ANDROID_REQUEST_OUTPUT_STREAMS);
1489
1490    return newRequest;
1491}
1492
1493bool Camera3Device::isOpaqueInputSizeSupported(uint32_t width, uint32_t height) {
1494    for (uint32_t i = 0; i < mSupportedOpaqueInputSizes.size(); i++) {
1495        Size size = mSupportedOpaqueInputSizes[i];
1496        if (size.width == width && size.height == height) {
1497            return true;
1498        }
1499    }
1500
1501    return false;
1502}
1503
1504status_t Camera3Device::configureStreamsLocked() {
1505    ATRACE_CALL();
1506    status_t res;
1507
1508    if (mStatus != STATUS_UNCONFIGURED && mStatus != STATUS_CONFIGURED) {
1509        CLOGE("Not idle");
1510        return INVALID_OPERATION;
1511    }
1512
1513    if (!mNeedConfig) {
1514        ALOGV("%s: Skipping config, no stream changes", __FUNCTION__);
1515        return OK;
1516    }
1517
1518    // Workaround for device HALv3.2 or older spec bug - zero streams requires
1519    // adding a dummy stream instead.
1520    // TODO: Bug: 17321404 for fixing the HAL spec and removing this workaround.
1521    if (mOutputStreams.size() == 0) {
1522        addDummyStreamLocked();
1523    } else {
1524        tryRemoveDummyStreamLocked();
1525    }
1526
1527    // Start configuring the streams
1528    ALOGV("%s: Camera %d: Starting stream configuration", __FUNCTION__, mId);
1529
1530    camera3_stream_configuration config;
1531
1532    config.num_streams = (mInputStream != NULL) + mOutputStreams.size();
1533
1534    Vector<camera3_stream_t*> streams;
1535    streams.setCapacity(config.num_streams);
1536
1537    if (mInputStream != NULL) {
1538        camera3_stream_t *inputStream;
1539        inputStream = mInputStream->startConfiguration();
1540        if (inputStream == NULL) {
1541            SET_ERR_L("Can't start input stream configuration");
1542            return INVALID_OPERATION;
1543        }
1544        streams.add(inputStream);
1545    }
1546
1547    for (size_t i = 0; i < mOutputStreams.size(); i++) {
1548
1549        // Don't configure bidi streams twice, nor add them twice to the list
1550        if (mOutputStreams[i].get() ==
1551            static_cast<Camera3StreamInterface*>(mInputStream.get())) {
1552
1553            config.num_streams--;
1554            continue;
1555        }
1556
1557        camera3_stream_t *outputStream;
1558        outputStream = mOutputStreams.editValueAt(i)->startConfiguration();
1559        if (outputStream == NULL) {
1560            SET_ERR_L("Can't start output stream configuration");
1561            return INVALID_OPERATION;
1562        }
1563        streams.add(outputStream);
1564    }
1565
1566    config.streams = streams.editArray();
1567
1568    // Do the HAL configuration; will potentially touch stream
1569    // max_buffers, usage, priv fields.
1570    ATRACE_BEGIN("camera3->configure_streams");
1571    res = mHal3Device->ops->configure_streams(mHal3Device, &config);
1572    ATRACE_END();
1573
1574    if (res == BAD_VALUE) {
1575        // HAL rejected this set of streams as unsupported, clean up config
1576        // attempt and return to unconfigured state
1577        if (mInputStream != NULL && mInputStream->isConfiguring()) {
1578            res = mInputStream->cancelConfiguration();
1579            if (res != OK) {
1580                SET_ERR_L("Can't cancel configuring input stream %d: %s (%d)",
1581                        mInputStream->getId(), strerror(-res), res);
1582                return res;
1583            }
1584        }
1585
1586        for (size_t i = 0; i < mOutputStreams.size(); i++) {
1587            sp<Camera3OutputStreamInterface> outputStream =
1588                    mOutputStreams.editValueAt(i);
1589            if (outputStream->isConfiguring()) {
1590                res = outputStream->cancelConfiguration();
1591                if (res != OK) {
1592                    SET_ERR_L(
1593                        "Can't cancel configuring output stream %d: %s (%d)",
1594                        outputStream->getId(), strerror(-res), res);
1595                    return res;
1596                }
1597            }
1598        }
1599
1600        // Return state to that at start of call, so that future configures
1601        // properly clean things up
1602        mStatus = STATUS_UNCONFIGURED;
1603        mNeedConfig = true;
1604
1605        ALOGV("%s: Camera %d: Stream configuration failed", __FUNCTION__, mId);
1606        return BAD_VALUE;
1607    } else if (res != OK) {
1608        // Some other kind of error from configure_streams - this is not
1609        // expected
1610        SET_ERR_L("Unable to configure streams with HAL: %s (%d)",
1611                strerror(-res), res);
1612        return res;
1613    }
1614
1615    // Finish all stream configuration immediately.
1616    // TODO: Try to relax this later back to lazy completion, which should be
1617    // faster
1618
1619    if (mInputStream != NULL && mInputStream->isConfiguring()) {
1620        res = mInputStream->finishConfiguration(mHal3Device);
1621        if (res != OK) {
1622            SET_ERR_L("Can't finish configuring input stream %d: %s (%d)",
1623                    mInputStream->getId(), strerror(-res), res);
1624            return res;
1625        }
1626    }
1627
1628    for (size_t i = 0; i < mOutputStreams.size(); i++) {
1629        sp<Camera3OutputStreamInterface> outputStream =
1630            mOutputStreams.editValueAt(i);
1631        if (outputStream->isConfiguring()) {
1632            res = outputStream->finishConfiguration(mHal3Device);
1633            if (res != OK) {
1634                SET_ERR_L("Can't finish configuring output stream %d: %s (%d)",
1635                        outputStream->getId(), strerror(-res), res);
1636                return res;
1637            }
1638        }
1639    }
1640
1641    // Request thread needs to know to avoid using repeat-last-settings protocol
1642    // across configure_streams() calls
1643    mRequestThread->configurationComplete();
1644
1645    // Update device state
1646
1647    mNeedConfig = false;
1648
1649    if (mDummyStreamId == NO_STREAM) {
1650        mStatus = STATUS_CONFIGURED;
1651    } else {
1652        mStatus = STATUS_UNCONFIGURED;
1653    }
1654
1655    ALOGV("%s: Camera %d: Stream configuration complete", __FUNCTION__, mId);
1656
1657    // tear down the deleted streams after configure streams.
1658    mDeletedStreams.clear();
1659
1660    return OK;
1661}
1662
1663status_t Camera3Device::addDummyStreamLocked() {
1664    ATRACE_CALL();
1665    status_t res;
1666
1667    if (mDummyStreamId != NO_STREAM) {
1668        // Should never be adding a second dummy stream when one is already
1669        // active
1670        SET_ERR_L("%s: Camera %d: A dummy stream already exists!",
1671                __FUNCTION__, mId);
1672        return INVALID_OPERATION;
1673    }
1674
1675    ALOGV("%s: Camera %d: Adding a dummy stream", __FUNCTION__, mId);
1676
1677    sp<Camera3OutputStreamInterface> dummyStream =
1678            new Camera3DummyStream(mNextStreamId);
1679
1680    res = mOutputStreams.add(mNextStreamId, dummyStream);
1681    if (res < 0) {
1682        SET_ERR_L("Can't add dummy stream to set: %s (%d)", strerror(-res), res);
1683        return res;
1684    }
1685
1686    mDummyStreamId = mNextStreamId;
1687    mNextStreamId++;
1688
1689    return OK;
1690}
1691
1692status_t Camera3Device::tryRemoveDummyStreamLocked() {
1693    ATRACE_CALL();
1694    status_t res;
1695
1696    if (mDummyStreamId == NO_STREAM) return OK;
1697    if (mOutputStreams.size() == 1) return OK;
1698
1699    ALOGV("%s: Camera %d: Removing the dummy stream", __FUNCTION__, mId);
1700
1701    // Ok, have a dummy stream and there's at least one other output stream,
1702    // so remove the dummy
1703
1704    sp<Camera3StreamInterface> deletedStream;
1705    ssize_t outputStreamIdx = mOutputStreams.indexOfKey(mDummyStreamId);
1706    if (outputStreamIdx == NAME_NOT_FOUND) {
1707        SET_ERR_L("Dummy stream %d does not appear to exist", mDummyStreamId);
1708        return INVALID_OPERATION;
1709    }
1710
1711    deletedStream = mOutputStreams.editValueAt(outputStreamIdx);
1712    mOutputStreams.removeItemsAt(outputStreamIdx);
1713
1714    // Free up the stream endpoint so that it can be used by some other stream
1715    res = deletedStream->disconnect();
1716    if (res != OK) {
1717        SET_ERR_L("Can't disconnect deleted dummy stream %d", mDummyStreamId);
1718        // fall through since we want to still list the stream as deleted.
1719    }
1720    mDeletedStreams.add(deletedStream);
1721    mDummyStreamId = NO_STREAM;
1722
1723    return res;
1724}
1725
1726void Camera3Device::setErrorState(const char *fmt, ...) {
1727    Mutex::Autolock l(mLock);
1728    va_list args;
1729    va_start(args, fmt);
1730
1731    setErrorStateLockedV(fmt, args);
1732
1733    va_end(args);
1734}
1735
1736void Camera3Device::setErrorStateV(const char *fmt, va_list args) {
1737    Mutex::Autolock l(mLock);
1738    setErrorStateLockedV(fmt, args);
1739}
1740
1741void Camera3Device::setErrorStateLocked(const char *fmt, ...) {
1742    va_list args;
1743    va_start(args, fmt);
1744
1745    setErrorStateLockedV(fmt, args);
1746
1747    va_end(args);
1748}
1749
1750void Camera3Device::setErrorStateLockedV(const char *fmt, va_list args) {
1751    // Print out all error messages to log
1752    String8 errorCause = String8::formatV(fmt, args);
1753    ALOGE("Camera %d: %s", mId, errorCause.string());
1754
1755    // But only do error state transition steps for the first error
1756    if (mStatus == STATUS_ERROR || mStatus == STATUS_UNINITIALIZED) return;
1757
1758    mErrorCause = errorCause;
1759
1760    mRequestThread->setPaused(true);
1761    mStatus = STATUS_ERROR;
1762
1763    // Notify upstream about a device error
1764    if (mListener != NULL) {
1765        mListener->notifyError(ICameraDeviceCallbacks::ERROR_CAMERA_DEVICE,
1766                CaptureResultExtras());
1767    }
1768
1769    // Save stack trace. View by dumping it later.
1770    CameraTraces::saveTrace();
1771    // TODO: consider adding errorCause and client pid/procname
1772}
1773
1774/**
1775 * In-flight request management
1776 */
1777
1778status_t Camera3Device::registerInFlight(uint32_t frameNumber,
1779        int32_t numBuffers, CaptureResultExtras resultExtras, bool hasInput) {
1780    ATRACE_CALL();
1781    Mutex::Autolock l(mInFlightLock);
1782
1783    ssize_t res;
1784    res = mInFlightMap.add(frameNumber, InFlightRequest(numBuffers, resultExtras, hasInput));
1785    if (res < 0) return res;
1786
1787    return OK;
1788}
1789
1790/**
1791 * Check if all 3A fields are ready, and send off a partial 3A-only result
1792 * to the output frame queue
1793 */
1794bool Camera3Device::processPartial3AResult(
1795        uint32_t frameNumber,
1796        const CameraMetadata& partial, const CaptureResultExtras& resultExtras) {
1797
1798    // Check if all 3A states are present
1799    // The full list of fields is
1800    //   android.control.afMode
1801    //   android.control.awbMode
1802    //   android.control.aeState
1803    //   android.control.awbState
1804    //   android.control.afState
1805    //   android.control.afTriggerID
1806    //   android.control.aePrecaptureID
1807    // TODO: Add android.control.aeMode
1808
1809    bool gotAllStates = true;
1810
1811    uint8_t afMode;
1812    uint8_t awbMode;
1813    uint8_t aeState;
1814    uint8_t afState;
1815    uint8_t awbState;
1816
1817    gotAllStates &= get3AResult(partial, ANDROID_CONTROL_AF_MODE,
1818        &afMode, frameNumber);
1819
1820    gotAllStates &= get3AResult(partial, ANDROID_CONTROL_AWB_MODE,
1821        &awbMode, frameNumber);
1822
1823    gotAllStates &= get3AResult(partial, ANDROID_CONTROL_AE_STATE,
1824        &aeState, frameNumber);
1825
1826    gotAllStates &= get3AResult(partial, ANDROID_CONTROL_AF_STATE,
1827        &afState, frameNumber);
1828
1829    gotAllStates &= get3AResult(partial, ANDROID_CONTROL_AWB_STATE,
1830        &awbState, frameNumber);
1831
1832    if (!gotAllStates) return false;
1833
1834    ALOGVV("%s: Camera %d: Frame %d, Request ID %d: AF mode %d, AWB mode %d, "
1835        "AF state %d, AE state %d, AWB state %d, "
1836        "AF trigger %d, AE precapture trigger %d",
1837        __FUNCTION__, mId, frameNumber, resultExtras.requestId,
1838        afMode, awbMode,
1839        afState, aeState, awbState,
1840        resultExtras.afTriggerId, resultExtras.precaptureTriggerId);
1841
1842    // Got all states, so construct a minimal result to send
1843    // In addition to the above fields, this means adding in
1844    //   android.request.frameCount
1845    //   android.request.requestId
1846    //   android.quirks.partialResult (for HAL version below HAL3.2)
1847
1848    const size_t kMinimal3AResultEntries = 10;
1849
1850    Mutex::Autolock l(mOutputLock);
1851
1852    CaptureResult captureResult;
1853    captureResult.mResultExtras = resultExtras;
1854    captureResult.mMetadata = CameraMetadata(kMinimal3AResultEntries, /*dataCapacity*/ 0);
1855    // TODO: change this to sp<CaptureResult>. This will need other changes, including,
1856    // but not limited to CameraDeviceBase::getNextResult
1857    CaptureResult& min3AResult =
1858            *mResultQueue.insert(mResultQueue.end(), captureResult);
1859
1860    if (!insert3AResult(min3AResult.mMetadata, ANDROID_REQUEST_FRAME_COUNT,
1861            // TODO: This is problematic casting. Need to fix CameraMetadata.
1862            reinterpret_cast<int32_t*>(&frameNumber), frameNumber)) {
1863        return false;
1864    }
1865
1866    int32_t requestId = resultExtras.requestId;
1867    if (!insert3AResult(min3AResult.mMetadata, ANDROID_REQUEST_ID,
1868            &requestId, frameNumber)) {
1869        return false;
1870    }
1871
1872    if (mDeviceVersion < CAMERA_DEVICE_API_VERSION_3_2) {
1873        static const uint8_t partialResult = ANDROID_QUIRKS_PARTIAL_RESULT_PARTIAL;
1874        if (!insert3AResult(min3AResult.mMetadata, ANDROID_QUIRKS_PARTIAL_RESULT,
1875                &partialResult, frameNumber)) {
1876            return false;
1877        }
1878    }
1879
1880    if (!insert3AResult(min3AResult.mMetadata, ANDROID_CONTROL_AF_MODE,
1881            &afMode, frameNumber)) {
1882        return false;
1883    }
1884
1885    if (!insert3AResult(min3AResult.mMetadata, ANDROID_CONTROL_AWB_MODE,
1886            &awbMode, frameNumber)) {
1887        return false;
1888    }
1889
1890    if (!insert3AResult(min3AResult.mMetadata, ANDROID_CONTROL_AE_STATE,
1891            &aeState, frameNumber)) {
1892        return false;
1893    }
1894
1895    if (!insert3AResult(min3AResult.mMetadata, ANDROID_CONTROL_AF_STATE,
1896            &afState, frameNumber)) {
1897        return false;
1898    }
1899
1900    if (!insert3AResult(min3AResult.mMetadata, ANDROID_CONTROL_AWB_STATE,
1901            &awbState, frameNumber)) {
1902        return false;
1903    }
1904
1905    if (!insert3AResult(min3AResult.mMetadata, ANDROID_CONTROL_AF_TRIGGER_ID,
1906            &resultExtras.afTriggerId, frameNumber)) {
1907        return false;
1908    }
1909
1910    if (!insert3AResult(min3AResult.mMetadata, ANDROID_CONTROL_AE_PRECAPTURE_ID,
1911            &resultExtras.precaptureTriggerId, frameNumber)) {
1912        return false;
1913    }
1914
1915    // We only send the aggregated partial when all 3A related metadata are available
1916    // For both API1 and API2.
1917    // TODO: we probably should pass through all partials to API2 unconditionally.
1918    mResultSignal.signal();
1919
1920    return true;
1921}
1922
1923template<typename T>
1924bool Camera3Device::get3AResult(const CameraMetadata& result, int32_t tag,
1925        T* value, uint32_t frameNumber) {
1926    (void) frameNumber;
1927
1928    camera_metadata_ro_entry_t entry;
1929
1930    entry = result.find(tag);
1931    if (entry.count == 0) {
1932        ALOGVV("%s: Camera %d: Frame %d: No %s provided by HAL!", __FUNCTION__,
1933            mId, frameNumber, get_camera_metadata_tag_name(tag));
1934        return false;
1935    }
1936
1937    if (sizeof(T) == sizeof(uint8_t)) {
1938        *value = entry.data.u8[0];
1939    } else if (sizeof(T) == sizeof(int32_t)) {
1940        *value = entry.data.i32[0];
1941    } else {
1942        ALOGE("%s: Unexpected type", __FUNCTION__);
1943        return false;
1944    }
1945    return true;
1946}
1947
1948template<typename T>
1949bool Camera3Device::insert3AResult(CameraMetadata& result, int32_t tag,
1950        const T* value, uint32_t frameNumber) {
1951    if (result.update(tag, value, 1) != NO_ERROR) {
1952        mResultQueue.erase(--mResultQueue.end(), mResultQueue.end());
1953        SET_ERR("Frame %d: Failed to set %s in partial metadata",
1954                frameNumber, get_camera_metadata_tag_name(tag));
1955        return false;
1956    }
1957    return true;
1958}
1959
1960void Camera3Device::returnOutputBuffers(
1961        const camera3_stream_buffer_t *outputBuffers, size_t numBuffers,
1962        nsecs_t timestamp) {
1963    for (size_t i = 0; i < numBuffers; i++)
1964    {
1965        Camera3Stream *stream = Camera3Stream::cast(outputBuffers[i].stream);
1966        status_t res = stream->returnBuffer(outputBuffers[i], timestamp);
1967        // Note: stream may be deallocated at this point, if this buffer was
1968        // the last reference to it.
1969        if (res != OK) {
1970            ALOGE("Can't return buffer to its stream: %s (%d)",
1971                strerror(-res), res);
1972        }
1973    }
1974}
1975
1976
1977void Camera3Device::removeInFlightRequestIfReadyLocked(int idx) {
1978
1979    const InFlightRequest &request = mInFlightMap.valueAt(idx);
1980    const uint32_t frameNumber = mInFlightMap.keyAt(idx);
1981
1982    nsecs_t sensorTimestamp = request.sensorTimestamp;
1983    nsecs_t shutterTimestamp = request.shutterTimestamp;
1984
1985    // Check if it's okay to remove the request from InFlightMap:
1986    // In the case of a successful request:
1987    //      all input and output buffers, all result metadata, shutter callback
1988    //      arrived.
1989    // In the case of a unsuccessful request:
1990    //      all input and output buffers arrived.
1991    if (request.numBuffersLeft == 0 &&
1992            (request.requestStatus != OK ||
1993            (request.haveResultMetadata && shutterTimestamp != 0))) {
1994        ATRACE_ASYNC_END("frame capture", frameNumber);
1995
1996        // Sanity check - if sensor timestamp matches shutter timestamp
1997        if (request.requestStatus == OK &&
1998                sensorTimestamp != shutterTimestamp) {
1999            SET_ERR("sensor timestamp (%" PRId64
2000                ") for frame %d doesn't match shutter timestamp (%" PRId64 ")",
2001                sensorTimestamp, frameNumber, shutterTimestamp);
2002        }
2003
2004        // for an unsuccessful request, it may have pending output buffers to
2005        // return.
2006        assert(request.requestStatus != OK ||
2007               request.pendingOutputBuffers.size() == 0);
2008        returnOutputBuffers(request.pendingOutputBuffers.array(),
2009            request.pendingOutputBuffers.size(), 0);
2010
2011        mInFlightMap.removeItemsAt(idx, 1);
2012
2013        ALOGVV("%s: removed frame %d from InFlightMap", __FUNCTION__, frameNumber);
2014     }
2015
2016    // Sanity check - if we have too many in-flight frames, something has
2017    // likely gone wrong
2018    if (mInFlightMap.size() > kInFlightWarnLimit) {
2019        CLOGE("In-flight list too large: %zu", mInFlightMap.size());
2020    }
2021}
2022
2023
2024void Camera3Device::sendCaptureResult(CameraMetadata &pendingMetadata,
2025        CaptureResultExtras &resultExtras,
2026        CameraMetadata &collectedPartialResult,
2027        uint32_t frameNumber,
2028        bool reprocess) {
2029    if (pendingMetadata.isEmpty())
2030        return;
2031
2032    Mutex::Autolock l(mOutputLock);
2033
2034    // TODO: need to track errors for tighter bounds on expected frame number
2035    if (reprocess) {
2036        if (frameNumber < mNextReprocessResultFrameNumber) {
2037            SET_ERR("Out-of-order reprocess capture result metadata submitted! "
2038                "(got frame number %d, expecting %d)",
2039                frameNumber, mNextReprocessResultFrameNumber);
2040            return;
2041        }
2042        mNextReprocessResultFrameNumber = frameNumber + 1;
2043    } else {
2044        if (frameNumber < mNextResultFrameNumber) {
2045            SET_ERR("Out-of-order capture result metadata submitted! "
2046                    "(got frame number %d, expecting %d)",
2047                    frameNumber, mNextResultFrameNumber);
2048            return;
2049        }
2050        mNextResultFrameNumber = frameNumber + 1;
2051    }
2052
2053    CaptureResult captureResult;
2054    captureResult.mResultExtras = resultExtras;
2055    captureResult.mMetadata = pendingMetadata;
2056
2057    if (captureResult.mMetadata.update(ANDROID_REQUEST_FRAME_COUNT,
2058            (int32_t*)&frameNumber, 1) != OK) {
2059        SET_ERR("Failed to set frame# in metadata (%d)",
2060                frameNumber);
2061        return;
2062    } else {
2063        ALOGVV("%s: Camera %d: Set frame# in metadata (%d)",
2064                __FUNCTION__, mId, frameNumber);
2065    }
2066
2067    // Append any previous partials to form a complete result
2068    if (mUsePartialResult && !collectedPartialResult.isEmpty()) {
2069        captureResult.mMetadata.append(collectedPartialResult);
2070    }
2071
2072    captureResult.mMetadata.sort();
2073
2074    // Check that there's a timestamp in the result metadata
2075    camera_metadata_entry entry =
2076            captureResult.mMetadata.find(ANDROID_SENSOR_TIMESTAMP);
2077    if (entry.count == 0) {
2078        SET_ERR("No timestamp provided by HAL for frame %d!",
2079                frameNumber);
2080        return;
2081    }
2082
2083    // Valid result, insert into queue
2084    List<CaptureResult>::iterator queuedResult =
2085            mResultQueue.insert(mResultQueue.end(), CaptureResult(captureResult));
2086    ALOGVV("%s: result requestId = %" PRId32 ", frameNumber = %" PRId64
2087           ", burstId = %" PRId32, __FUNCTION__,
2088           queuedResult->mResultExtras.requestId,
2089           queuedResult->mResultExtras.frameNumber,
2090           queuedResult->mResultExtras.burstId);
2091
2092    mResultSignal.signal();
2093}
2094
2095/**
2096 * Camera HAL device callback methods
2097 */
2098
2099void Camera3Device::processCaptureResult(const camera3_capture_result *result) {
2100    ATRACE_CALL();
2101
2102    status_t res;
2103
2104    uint32_t frameNumber = result->frame_number;
2105    if (result->result == NULL && result->num_output_buffers == 0 &&
2106            result->input_buffer == NULL) {
2107        SET_ERR("No result data provided by HAL for frame %d",
2108                frameNumber);
2109        return;
2110    }
2111
2112    // For HAL3.2 or above, If HAL doesn't support partial, it must always set
2113    // partial_result to 1 when metadata is included in this result.
2114    if (!mUsePartialResult &&
2115            mDeviceVersion >= CAMERA_DEVICE_API_VERSION_3_2 &&
2116            result->result != NULL &&
2117            result->partial_result != 1) {
2118        SET_ERR("Result is malformed for frame %d: partial_result %u must be 1"
2119                " if partial result is not supported",
2120                frameNumber, result->partial_result);
2121        return;
2122    }
2123
2124    bool isPartialResult = false;
2125    CameraMetadata collectedPartialResult;
2126    CaptureResultExtras resultExtras;
2127    bool hasInputBufferInRequest = false;
2128
2129    // Get shutter timestamp and resultExtras from list of in-flight requests,
2130    // where it was added by the shutter notification for this frame. If the
2131    // shutter timestamp isn't received yet, append the output buffers to the
2132    // in-flight request and they will be returned when the shutter timestamp
2133    // arrives. Update the in-flight status and remove the in-flight entry if
2134    // all result data and shutter timestamp have been received.
2135    nsecs_t shutterTimestamp = 0;
2136
2137    {
2138        Mutex::Autolock l(mInFlightLock);
2139        ssize_t idx = mInFlightMap.indexOfKey(frameNumber);
2140        if (idx == NAME_NOT_FOUND) {
2141            SET_ERR("Unknown frame number for capture result: %d",
2142                    frameNumber);
2143            return;
2144        }
2145        InFlightRequest &request = mInFlightMap.editValueAt(idx);
2146        ALOGVV("%s: got InFlightRequest requestId = %" PRId32
2147                ", frameNumber = %" PRId64 ", burstId = %" PRId32
2148                ", partialResultCount = %d",
2149                __FUNCTION__, request.resultExtras.requestId,
2150                request.resultExtras.frameNumber, request.resultExtras.burstId,
2151                result->partial_result);
2152        // Always update the partial count to the latest one if it's not 0
2153        // (buffers only). When framework aggregates adjacent partial results
2154        // into one, the latest partial count will be used.
2155        if (result->partial_result != 0)
2156            request.resultExtras.partialResultCount = result->partial_result;
2157
2158        // Check if this result carries only partial metadata
2159        if (mUsePartialResult && result->result != NULL) {
2160            if (mDeviceVersion >= CAMERA_DEVICE_API_VERSION_3_2) {
2161                if (result->partial_result > mNumPartialResults || result->partial_result < 1) {
2162                    SET_ERR("Result is malformed for frame %d: partial_result %u must be  in"
2163                            " the range of [1, %d] when metadata is included in the result",
2164                            frameNumber, result->partial_result, mNumPartialResults);
2165                    return;
2166                }
2167                isPartialResult = (result->partial_result < mNumPartialResults);
2168                if (isPartialResult) {
2169                    request.partialResult.collectedResult.append(result->result);
2170                }
2171            } else {
2172                camera_metadata_ro_entry_t partialResultEntry;
2173                res = find_camera_metadata_ro_entry(result->result,
2174                        ANDROID_QUIRKS_PARTIAL_RESULT, &partialResultEntry);
2175                if (res != NAME_NOT_FOUND &&
2176                        partialResultEntry.count > 0 &&
2177                        partialResultEntry.data.u8[0] ==
2178                        ANDROID_QUIRKS_PARTIAL_RESULT_PARTIAL) {
2179                    // A partial result. Flag this as such, and collect this
2180                    // set of metadata into the in-flight entry.
2181                    isPartialResult = true;
2182                    request.partialResult.collectedResult.append(
2183                        result->result);
2184                    request.partialResult.collectedResult.erase(
2185                        ANDROID_QUIRKS_PARTIAL_RESULT);
2186                }
2187            }
2188
2189            if (isPartialResult) {
2190                // Fire off a 3A-only result if possible
2191                if (!request.partialResult.haveSent3A) {
2192                    request.partialResult.haveSent3A =
2193                            processPartial3AResult(frameNumber,
2194                                    request.partialResult.collectedResult,
2195                                    request.resultExtras);
2196                }
2197            }
2198        }
2199
2200        shutterTimestamp = request.shutterTimestamp;
2201        hasInputBufferInRequest = request.hasInputBuffer;
2202
2203        // Did we get the (final) result metadata for this capture?
2204        if (result->result != NULL && !isPartialResult) {
2205            if (request.haveResultMetadata) {
2206                SET_ERR("Called multiple times with metadata for frame %d",
2207                        frameNumber);
2208                return;
2209            }
2210            if (mUsePartialResult &&
2211                    !request.partialResult.collectedResult.isEmpty()) {
2212                collectedPartialResult.acquire(
2213                    request.partialResult.collectedResult);
2214            }
2215            request.haveResultMetadata = true;
2216        }
2217
2218        uint32_t numBuffersReturned = result->num_output_buffers;
2219        if (result->input_buffer != NULL) {
2220            if (hasInputBufferInRequest) {
2221                numBuffersReturned += 1;
2222            } else {
2223                ALOGW("%s: Input buffer should be NULL if there is no input"
2224                        " buffer sent in the request",
2225                        __FUNCTION__);
2226            }
2227        }
2228        request.numBuffersLeft -= numBuffersReturned;
2229        if (request.numBuffersLeft < 0) {
2230            SET_ERR("Too many buffers returned for frame %d",
2231                    frameNumber);
2232            return;
2233        }
2234
2235        camera_metadata_ro_entry_t entry;
2236        res = find_camera_metadata_ro_entry(result->result,
2237                ANDROID_SENSOR_TIMESTAMP, &entry);
2238        if (res == OK && entry.count == 1) {
2239            request.sensorTimestamp = entry.data.i64[0];
2240        }
2241
2242        // If shutter event isn't received yet, append the output buffers to
2243        // the in-flight request. Otherwise, return the output buffers to
2244        // streams.
2245        if (shutterTimestamp == 0) {
2246            request.pendingOutputBuffers.appendArray(result->output_buffers,
2247                result->num_output_buffers);
2248        } else {
2249            returnOutputBuffers(result->output_buffers,
2250                result->num_output_buffers, shutterTimestamp);
2251        }
2252
2253        if (result->result != NULL && !isPartialResult) {
2254            if (shutterTimestamp == 0) {
2255                request.pendingMetadata = result->result;
2256                request.partialResult.collectedResult = collectedPartialResult;
2257            } else {
2258                CameraMetadata metadata;
2259                metadata = result->result;
2260                sendCaptureResult(metadata, request.resultExtras,
2261                    collectedPartialResult, frameNumber, hasInputBufferInRequest);
2262            }
2263        }
2264
2265        removeInFlightRequestIfReadyLocked(idx);
2266    } // scope for mInFlightLock
2267
2268    if (result->input_buffer != NULL) {
2269        if (hasInputBufferInRequest) {
2270            Camera3Stream *stream =
2271                Camera3Stream::cast(result->input_buffer->stream);
2272            res = stream->returnInputBuffer(*(result->input_buffer));
2273            // Note: stream may be deallocated at this point, if this buffer was the
2274            // last reference to it.
2275            if (res != OK) {
2276                ALOGE("%s: RequestThread: Can't return input buffer for frame %d to"
2277                      "  its stream:%s (%d)",  __FUNCTION__,
2278                      frameNumber, strerror(-res), res);
2279            }
2280        } else {
2281            ALOGW("%s: Input buffer should be NULL if there is no input"
2282                    " buffer sent in the request, skipping input buffer return.",
2283                    __FUNCTION__);
2284        }
2285    }
2286}
2287
2288void Camera3Device::notify(const camera3_notify_msg *msg) {
2289    ATRACE_CALL();
2290    NotificationListener *listener;
2291    {
2292        Mutex::Autolock l(mOutputLock);
2293        listener = mListener;
2294    }
2295
2296    if (msg == NULL) {
2297        SET_ERR("HAL sent NULL notify message!");
2298        return;
2299    }
2300
2301    switch (msg->type) {
2302        case CAMERA3_MSG_ERROR: {
2303            notifyError(msg->message.error, listener);
2304            break;
2305        }
2306        case CAMERA3_MSG_SHUTTER: {
2307            notifyShutter(msg->message.shutter, listener);
2308            break;
2309        }
2310        default:
2311            SET_ERR("Unknown notify message from HAL: %d",
2312                    msg->type);
2313    }
2314}
2315
2316void Camera3Device::notifyError(const camera3_error_msg_t &msg,
2317        NotificationListener *listener) {
2318
2319    // Map camera HAL error codes to ICameraDeviceCallback error codes
2320    // Index into this with the HAL error code
2321    static const ICameraDeviceCallbacks::CameraErrorCode
2322            halErrorMap[CAMERA3_MSG_NUM_ERRORS] = {
2323        // 0 = Unused error code
2324        ICameraDeviceCallbacks::ERROR_CAMERA_INVALID_ERROR,
2325        // 1 = CAMERA3_MSG_ERROR_DEVICE
2326        ICameraDeviceCallbacks::ERROR_CAMERA_DEVICE,
2327        // 2 = CAMERA3_MSG_ERROR_REQUEST
2328        ICameraDeviceCallbacks::ERROR_CAMERA_REQUEST,
2329        // 3 = CAMERA3_MSG_ERROR_RESULT
2330        ICameraDeviceCallbacks::ERROR_CAMERA_RESULT,
2331        // 4 = CAMERA3_MSG_ERROR_BUFFER
2332        ICameraDeviceCallbacks::ERROR_CAMERA_BUFFER
2333    };
2334
2335    ICameraDeviceCallbacks::CameraErrorCode errorCode =
2336            ((msg.error_code >= 0) &&
2337                    (msg.error_code < CAMERA3_MSG_NUM_ERRORS)) ?
2338            halErrorMap[msg.error_code] :
2339            ICameraDeviceCallbacks::ERROR_CAMERA_INVALID_ERROR;
2340
2341    int streamId = 0;
2342    if (msg.error_stream != NULL) {
2343        Camera3Stream *stream =
2344                Camera3Stream::cast(msg.error_stream);
2345        streamId = stream->getId();
2346    }
2347    ALOGV("Camera %d: %s: HAL error, frame %d, stream %d: %d",
2348            mId, __FUNCTION__, msg.frame_number,
2349            streamId, msg.error_code);
2350
2351    CaptureResultExtras resultExtras;
2352    switch (errorCode) {
2353        case ICameraDeviceCallbacks::ERROR_CAMERA_DEVICE:
2354            // SET_ERR calls notifyError
2355            SET_ERR("Camera HAL reported serious device error");
2356            break;
2357        case ICameraDeviceCallbacks::ERROR_CAMERA_REQUEST:
2358        case ICameraDeviceCallbacks::ERROR_CAMERA_RESULT:
2359        case ICameraDeviceCallbacks::ERROR_CAMERA_BUFFER:
2360            {
2361                Mutex::Autolock l(mInFlightLock);
2362                ssize_t idx = mInFlightMap.indexOfKey(msg.frame_number);
2363                if (idx >= 0) {
2364                    InFlightRequest &r = mInFlightMap.editValueAt(idx);
2365                    r.requestStatus = msg.error_code;
2366                    resultExtras = r.resultExtras;
2367                } else {
2368                    resultExtras.frameNumber = msg.frame_number;
2369                    ALOGE("Camera %d: %s: cannot find in-flight request on "
2370                            "frame %" PRId64 " error", mId, __FUNCTION__,
2371                            resultExtras.frameNumber);
2372                }
2373            }
2374            if (listener != NULL) {
2375                listener->notifyError(errorCode, resultExtras);
2376            } else {
2377                ALOGE("Camera %d: %s: no listener available", mId, __FUNCTION__);
2378            }
2379            break;
2380        default:
2381            // SET_ERR calls notifyError
2382            SET_ERR("Unknown error message from HAL: %d", msg.error_code);
2383            break;
2384    }
2385}
2386
2387void Camera3Device::notifyShutter(const camera3_shutter_msg_t &msg,
2388        NotificationListener *listener) {
2389    ssize_t idx;
2390    // Verify ordering of shutter notifications
2391    {
2392        Mutex::Autolock l(mOutputLock);
2393        // TODO: need to track errors for tighter bounds on expected frame number.
2394        if (msg.frame_number < mNextShutterFrameNumber) {
2395            SET_ERR("Shutter notification out-of-order. Expected "
2396                    "notification for frame %d, got frame %d",
2397                    mNextShutterFrameNumber, msg.frame_number);
2398            return;
2399        }
2400        mNextShutterFrameNumber = msg.frame_number + 1;
2401    }
2402
2403    // Set timestamp for the request in the in-flight tracking
2404    // and get the request ID to send upstream
2405    {
2406        Mutex::Autolock l(mInFlightLock);
2407        idx = mInFlightMap.indexOfKey(msg.frame_number);
2408        if (idx >= 0) {
2409            InFlightRequest &r = mInFlightMap.editValueAt(idx);
2410
2411            ALOGVV("Camera %d: %s: Shutter fired for frame %d (id %d) at %" PRId64,
2412                    mId, __FUNCTION__,
2413                    msg.frame_number, r.resultExtras.requestId, msg.timestamp);
2414            // Call listener, if any
2415            if (listener != NULL) {
2416                listener->notifyShutter(r.resultExtras, msg.timestamp);
2417            }
2418
2419            r.shutterTimestamp = msg.timestamp;
2420
2421            // send pending result and buffers
2422            sendCaptureResult(r.pendingMetadata, r.resultExtras,
2423                r.partialResult.collectedResult, msg.frame_number,
2424                r.hasInputBuffer);
2425            returnOutputBuffers(r.pendingOutputBuffers.array(),
2426                r.pendingOutputBuffers.size(), r.shutterTimestamp);
2427            r.pendingOutputBuffers.clear();
2428
2429            removeInFlightRequestIfReadyLocked(idx);
2430        }
2431    }
2432    if (idx < 0) {
2433        SET_ERR("Shutter notification for non-existent frame number %d",
2434                msg.frame_number);
2435    }
2436}
2437
2438
2439CameraMetadata Camera3Device::getLatestRequestLocked() {
2440    ALOGV("%s", __FUNCTION__);
2441
2442    CameraMetadata retVal;
2443
2444    if (mRequestThread != NULL) {
2445        retVal = mRequestThread->getLatestRequest();
2446    }
2447
2448    return retVal;
2449}
2450
2451
2452/**
2453 * RequestThread inner class methods
2454 */
2455
2456Camera3Device::RequestThread::RequestThread(wp<Camera3Device> parent,
2457        sp<StatusTracker> statusTracker,
2458        camera3_device_t *hal3Device) :
2459        Thread(/*canCallJava*/false),
2460        mParent(parent),
2461        mStatusTracker(statusTracker),
2462        mHal3Device(hal3Device),
2463        mId(getId(parent)),
2464        mReconfigured(false),
2465        mDoPause(false),
2466        mPaused(true),
2467        mFrameNumber(0),
2468        mLatestRequestId(NAME_NOT_FOUND),
2469        mCurrentAfTriggerId(0),
2470        mCurrentPreCaptureTriggerId(0),
2471        mRepeatingLastFrameNumber(NO_IN_FLIGHT_REPEATING_FRAMES) {
2472    mStatusId = statusTracker->addComponent();
2473}
2474
2475void Camera3Device::RequestThread::setNotificationListener(
2476        NotificationListener *listener) {
2477    Mutex::Autolock l(mRequestLock);
2478    mListener = listener;
2479}
2480
2481void Camera3Device::RequestThread::configurationComplete() {
2482    Mutex::Autolock l(mRequestLock);
2483    mReconfigured = true;
2484}
2485
2486status_t Camera3Device::RequestThread::queueRequestList(
2487        List<sp<CaptureRequest> > &requests,
2488        /*out*/
2489        int64_t *lastFrameNumber) {
2490    Mutex::Autolock l(mRequestLock);
2491    for (List<sp<CaptureRequest> >::iterator it = requests.begin(); it != requests.end();
2492            ++it) {
2493        mRequestQueue.push_back(*it);
2494    }
2495
2496    if (lastFrameNumber != NULL) {
2497        *lastFrameNumber = mFrameNumber + mRequestQueue.size() - 1;
2498        ALOGV("%s: requestId %d, mFrameNumber %" PRId32 ", lastFrameNumber %" PRId64 ".",
2499              __FUNCTION__, (*(requests.begin()))->mResultExtras.requestId, mFrameNumber,
2500              *lastFrameNumber);
2501    }
2502
2503    unpauseForNewRequests();
2504
2505    return OK;
2506}
2507
2508
2509status_t Camera3Device::RequestThread::queueTrigger(
2510        RequestTrigger trigger[],
2511        size_t count) {
2512
2513    Mutex::Autolock l(mTriggerMutex);
2514    status_t ret;
2515
2516    for (size_t i = 0; i < count; ++i) {
2517        ret = queueTriggerLocked(trigger[i]);
2518
2519        if (ret != OK) {
2520            return ret;
2521        }
2522    }
2523
2524    return OK;
2525}
2526
2527int Camera3Device::RequestThread::getId(const wp<Camera3Device> &device) {
2528    sp<Camera3Device> d = device.promote();
2529    if (d != NULL) return d->mId;
2530    return 0;
2531}
2532
2533status_t Camera3Device::RequestThread::queueTriggerLocked(
2534        RequestTrigger trigger) {
2535
2536    uint32_t tag = trigger.metadataTag;
2537    ssize_t index = mTriggerMap.indexOfKey(tag);
2538
2539    switch (trigger.getTagType()) {
2540        case TYPE_BYTE:
2541        // fall-through
2542        case TYPE_INT32:
2543            break;
2544        default:
2545            ALOGE("%s: Type not supported: 0x%x", __FUNCTION__,
2546                    trigger.getTagType());
2547            return INVALID_OPERATION;
2548    }
2549
2550    /**
2551     * Collect only the latest trigger, since we only have 1 field
2552     * in the request settings per trigger tag, and can't send more than 1
2553     * trigger per request.
2554     */
2555    if (index != NAME_NOT_FOUND) {
2556        mTriggerMap.editValueAt(index) = trigger;
2557    } else {
2558        mTriggerMap.add(tag, trigger);
2559    }
2560
2561    return OK;
2562}
2563
2564status_t Camera3Device::RequestThread::setRepeatingRequests(
2565        const RequestList &requests,
2566        /*out*/
2567        int64_t *lastFrameNumber) {
2568    Mutex::Autolock l(mRequestLock);
2569    if (lastFrameNumber != NULL) {
2570        *lastFrameNumber = mRepeatingLastFrameNumber;
2571    }
2572    mRepeatingRequests.clear();
2573    mRepeatingRequests.insert(mRepeatingRequests.begin(),
2574            requests.begin(), requests.end());
2575
2576    unpauseForNewRequests();
2577
2578    mRepeatingLastFrameNumber = NO_IN_FLIGHT_REPEATING_FRAMES;
2579    return OK;
2580}
2581
2582bool Camera3Device::RequestThread::isRepeatingRequestLocked(const sp<CaptureRequest> requestIn) {
2583    if (mRepeatingRequests.empty()) {
2584        return false;
2585    }
2586    int32_t requestId = requestIn->mResultExtras.requestId;
2587    const RequestList &repeatRequests = mRepeatingRequests;
2588    // All repeating requests are guaranteed to have same id so only check first quest
2589    const sp<CaptureRequest> firstRequest = *repeatRequests.begin();
2590    return (firstRequest->mResultExtras.requestId == requestId);
2591}
2592
2593status_t Camera3Device::RequestThread::clearRepeatingRequests(/*out*/int64_t *lastFrameNumber) {
2594    Mutex::Autolock l(mRequestLock);
2595    mRepeatingRequests.clear();
2596    if (lastFrameNumber != NULL) {
2597        *lastFrameNumber = mRepeatingLastFrameNumber;
2598    }
2599    mRepeatingLastFrameNumber = NO_IN_FLIGHT_REPEATING_FRAMES;
2600    return OK;
2601}
2602
2603status_t Camera3Device::RequestThread::clear(
2604        NotificationListener *listener,
2605        /*out*/int64_t *lastFrameNumber) {
2606    Mutex::Autolock l(mRequestLock);
2607    ALOGV("RequestThread::%s:", __FUNCTION__);
2608
2609    mRepeatingRequests.clear();
2610
2611    // Send errors for all requests pending in the request queue, including
2612    // pending repeating requests
2613    if (listener != NULL) {
2614        for (RequestList::iterator it = mRequestQueue.begin();
2615                 it != mRequestQueue.end(); ++it) {
2616            // Set the frame number this request would have had, if it
2617            // had been submitted; this frame number will not be reused.
2618            // The requestId and burstId fields were set when the request was
2619            // submitted originally (in convertMetadataListToRequestListLocked)
2620            (*it)->mResultExtras.frameNumber = mFrameNumber++;
2621            listener->notifyError(ICameraDeviceCallbacks::ERROR_CAMERA_REQUEST,
2622                    (*it)->mResultExtras);
2623        }
2624    }
2625    mRequestQueue.clear();
2626    mTriggerMap.clear();
2627    if (lastFrameNumber != NULL) {
2628        *lastFrameNumber = mRepeatingLastFrameNumber;
2629    }
2630    mRepeatingLastFrameNumber = NO_IN_FLIGHT_REPEATING_FRAMES;
2631    return OK;
2632}
2633
2634void Camera3Device::RequestThread::setPaused(bool paused) {
2635    Mutex::Autolock l(mPauseLock);
2636    mDoPause = paused;
2637    mDoPauseSignal.signal();
2638}
2639
2640status_t Camera3Device::RequestThread::waitUntilRequestProcessed(
2641        int32_t requestId, nsecs_t timeout) {
2642    Mutex::Autolock l(mLatestRequestMutex);
2643    status_t res;
2644    while (mLatestRequestId != requestId) {
2645        nsecs_t startTime = systemTime();
2646
2647        res = mLatestRequestSignal.waitRelative(mLatestRequestMutex, timeout);
2648        if (res != OK) return res;
2649
2650        timeout -= (systemTime() - startTime);
2651    }
2652
2653    return OK;
2654}
2655
2656void Camera3Device::RequestThread::requestExit() {
2657    // Call parent to set up shutdown
2658    Thread::requestExit();
2659    // The exit from any possible waits
2660    mDoPauseSignal.signal();
2661    mRequestSignal.signal();
2662}
2663
2664bool Camera3Device::RequestThread::threadLoop() {
2665
2666    status_t res;
2667
2668    // Handle paused state.
2669    if (waitIfPaused()) {
2670        return true;
2671    }
2672
2673    // Get work to do
2674
2675    sp<CaptureRequest> nextRequest = waitForNextRequest();
2676    if (nextRequest == NULL) {
2677        return true;
2678    }
2679
2680    // Create request to HAL
2681    camera3_capture_request_t request = camera3_capture_request_t();
2682    request.frame_number = nextRequest->mResultExtras.frameNumber;
2683    Vector<camera3_stream_buffer_t> outputBuffers;
2684
2685    // Get the request ID, if any
2686    int requestId;
2687    camera_metadata_entry_t requestIdEntry =
2688            nextRequest->mSettings.find(ANDROID_REQUEST_ID);
2689    if (requestIdEntry.count > 0) {
2690        requestId = requestIdEntry.data.i32[0];
2691    } else {
2692        ALOGW("%s: Did not have android.request.id set in the request",
2693                __FUNCTION__);
2694        requestId = NAME_NOT_FOUND;
2695    }
2696
2697    // Insert any queued triggers (before metadata is locked)
2698    int32_t triggerCount;
2699    res = insertTriggers(nextRequest);
2700    if (res < 0) {
2701        SET_ERR("RequestThread: Unable to insert triggers "
2702                "(capture request %d, HAL device: %s (%d)",
2703                request.frame_number, strerror(-res), res);
2704        cleanUpFailedRequest(request, nextRequest, outputBuffers);
2705        return false;
2706    }
2707    triggerCount = res;
2708
2709    bool triggersMixedIn = (triggerCount > 0 || mPrevTriggers > 0);
2710
2711    // If the request is the same as last, or we had triggers last time
2712    if (mPrevRequest != nextRequest || triggersMixedIn) {
2713        /**
2714         * HAL workaround:
2715         * Insert a dummy trigger ID if a trigger is set but no trigger ID is
2716         */
2717        res = addDummyTriggerIds(nextRequest);
2718        if (res != OK) {
2719            SET_ERR("RequestThread: Unable to insert dummy trigger IDs "
2720                    "(capture request %d, HAL device: %s (%d)",
2721                    request.frame_number, strerror(-res), res);
2722            cleanUpFailedRequest(request, nextRequest, outputBuffers);
2723            return false;
2724        }
2725
2726        /**
2727         * The request should be presorted so accesses in HAL
2728         *   are O(logn). Sidenote, sorting a sorted metadata is nop.
2729         */
2730        nextRequest->mSettings.sort();
2731        request.settings = nextRequest->mSettings.getAndLock();
2732        mPrevRequest = nextRequest;
2733        ALOGVV("%s: Request settings are NEW", __FUNCTION__);
2734
2735        IF_ALOGV() {
2736            camera_metadata_ro_entry_t e = camera_metadata_ro_entry_t();
2737            find_camera_metadata_ro_entry(
2738                    request.settings,
2739                    ANDROID_CONTROL_AF_TRIGGER,
2740                    &e
2741            );
2742            if (e.count > 0) {
2743                ALOGV("%s: Request (frame num %d) had AF trigger 0x%x",
2744                      __FUNCTION__,
2745                      request.frame_number,
2746                      e.data.u8[0]);
2747            }
2748        }
2749    } else {
2750        // leave request.settings NULL to indicate 'reuse latest given'
2751        ALOGVV("%s: Request settings are REUSED",
2752               __FUNCTION__);
2753    }
2754
2755    camera3_stream_buffer_t inputBuffer;
2756    uint32_t totalNumBuffers = 0;
2757
2758    // Fill in buffers
2759
2760    if (nextRequest->mInputStream != NULL) {
2761        res = nextRequest->mInputStream->getInputBuffer(&inputBuffer);
2762        if (res != OK) {
2763            // Can't get input buffer from gralloc queue - this could be due to
2764            // disconnected queue or other producer misbehavior, so not a fatal
2765            // error
2766            ALOGE("RequestThread: Can't get input buffer, skipping request:"
2767                    " %s (%d)", strerror(-res), res);
2768            Mutex::Autolock l(mRequestLock);
2769            if (mListener != NULL) {
2770                mListener->notifyError(
2771                        ICameraDeviceCallbacks::ERROR_CAMERA_REQUEST,
2772                        nextRequest->mResultExtras);
2773            }
2774            cleanUpFailedRequest(request, nextRequest, outputBuffers);
2775            return true;
2776        }
2777        request.input_buffer = &inputBuffer;
2778        totalNumBuffers += 1;
2779    } else {
2780        request.input_buffer = NULL;
2781    }
2782
2783    outputBuffers.insertAt(camera3_stream_buffer_t(), 0,
2784            nextRequest->mOutputStreams.size());
2785    request.output_buffers = outputBuffers.array();
2786    for (size_t i = 0; i < nextRequest->mOutputStreams.size(); i++) {
2787        res = nextRequest->mOutputStreams.editItemAt(i)->
2788                getBuffer(&outputBuffers.editItemAt(i));
2789        if (res != OK) {
2790            // Can't get output buffer from gralloc queue - this could be due to
2791            // abandoned queue or other consumer misbehavior, so not a fatal
2792            // error
2793            ALOGE("RequestThread: Can't get output buffer, skipping request:"
2794                    " %s (%d)", strerror(-res), res);
2795            Mutex::Autolock l(mRequestLock);
2796            if (mListener != NULL) {
2797                mListener->notifyError(
2798                        ICameraDeviceCallbacks::ERROR_CAMERA_REQUEST,
2799                        nextRequest->mResultExtras);
2800            }
2801            cleanUpFailedRequest(request, nextRequest, outputBuffers);
2802            return true;
2803        }
2804        request.num_output_buffers++;
2805    }
2806    totalNumBuffers += request.num_output_buffers;
2807
2808    // Log request in the in-flight queue
2809    sp<Camera3Device> parent = mParent.promote();
2810    if (parent == NULL) {
2811        // Should not happen, and nowhere to send errors to, so just log it
2812        CLOGE("RequestThread: Parent is gone");
2813        cleanUpFailedRequest(request, nextRequest, outputBuffers);
2814        return false;
2815    }
2816
2817    res = parent->registerInFlight(request.frame_number,
2818            totalNumBuffers, nextRequest->mResultExtras,
2819            /*hasInput*/request.input_buffer != NULL);
2820    ALOGVV("%s: registered in flight requestId = %" PRId32 ", frameNumber = %" PRId64
2821           ", burstId = %" PRId32 ".",
2822            __FUNCTION__,
2823            nextRequest->mResultExtras.requestId, nextRequest->mResultExtras.frameNumber,
2824            nextRequest->mResultExtras.burstId);
2825    if (res != OK) {
2826        SET_ERR("RequestThread: Unable to register new in-flight request:"
2827                " %s (%d)", strerror(-res), res);
2828        cleanUpFailedRequest(request, nextRequest, outputBuffers);
2829        return false;
2830    }
2831
2832    // Inform waitUntilRequestProcessed thread of a new request ID
2833    {
2834        Mutex::Autolock al(mLatestRequestMutex);
2835
2836        mLatestRequestId = requestId;
2837        mLatestRequestSignal.signal();
2838    }
2839
2840    // Submit request and block until ready for next one
2841    ATRACE_ASYNC_BEGIN("frame capture", request.frame_number);
2842    ATRACE_BEGIN("camera3->process_capture_request");
2843    res = mHal3Device->ops->process_capture_request(mHal3Device, &request);
2844    ATRACE_END();
2845
2846    if (res != OK) {
2847        // Should only get a failure here for malformed requests or device-level
2848        // errors, so consider all errors fatal.  Bad metadata failures should
2849        // come through notify.
2850        SET_ERR("RequestThread: Unable to submit capture request %d to HAL"
2851                " device: %s (%d)", request.frame_number, strerror(-res), res);
2852        cleanUpFailedRequest(request, nextRequest, outputBuffers);
2853        return false;
2854    }
2855
2856    // Update the latest request sent to HAL
2857    if (request.settings != NULL) { // Don't update them if they were unchanged
2858        Mutex::Autolock al(mLatestRequestMutex);
2859
2860        camera_metadata_t* cloned = clone_camera_metadata(request.settings);
2861        mLatestRequest.acquire(cloned);
2862    }
2863
2864    if (request.settings != NULL) {
2865        nextRequest->mSettings.unlock(request.settings);
2866    }
2867
2868    // Remove any previously queued triggers (after unlock)
2869    res = removeTriggers(mPrevRequest);
2870    if (res != OK) {
2871        SET_ERR("RequestThread: Unable to remove triggers "
2872              "(capture request %d, HAL device: %s (%d)",
2873              request.frame_number, strerror(-res), res);
2874        return false;
2875    }
2876    mPrevTriggers = triggerCount;
2877
2878    return true;
2879}
2880
2881CameraMetadata Camera3Device::RequestThread::getLatestRequest() const {
2882    Mutex::Autolock al(mLatestRequestMutex);
2883
2884    ALOGV("RequestThread::%s", __FUNCTION__);
2885
2886    return mLatestRequest;
2887}
2888
2889bool Camera3Device::RequestThread::isStreamPending(
2890        sp<Camera3StreamInterface>& stream) {
2891    Mutex::Autolock l(mRequestLock);
2892
2893    for (const auto& request : mRequestQueue) {
2894        for (const auto& s : request->mOutputStreams) {
2895            if (stream == s) return true;
2896        }
2897        if (stream == request->mInputStream) return true;
2898    }
2899
2900    for (const auto& request : mRepeatingRequests) {
2901        for (const auto& s : request->mOutputStreams) {
2902            if (stream == s) return true;
2903        }
2904        if (stream == request->mInputStream) return true;
2905    }
2906
2907    return false;
2908}
2909
2910void Camera3Device::RequestThread::cleanUpFailedRequest(
2911        camera3_capture_request_t &request,
2912        sp<CaptureRequest> &nextRequest,
2913        Vector<camera3_stream_buffer_t> &outputBuffers) {
2914
2915    if (request.settings != NULL) {
2916        nextRequest->mSettings.unlock(request.settings);
2917    }
2918    if (request.input_buffer != NULL) {
2919        request.input_buffer->status = CAMERA3_BUFFER_STATUS_ERROR;
2920        nextRequest->mInputStream->returnInputBuffer(*(request.input_buffer));
2921    }
2922    for (size_t i = 0; i < request.num_output_buffers; i++) {
2923        outputBuffers.editItemAt(i).status = CAMERA3_BUFFER_STATUS_ERROR;
2924        nextRequest->mOutputStreams.editItemAt(i)->returnBuffer(
2925            outputBuffers[i], 0);
2926    }
2927}
2928
2929sp<Camera3Device::CaptureRequest>
2930        Camera3Device::RequestThread::waitForNextRequest() {
2931    status_t res;
2932    sp<CaptureRequest> nextRequest;
2933
2934    // Optimized a bit for the simple steady-state case (single repeating
2935    // request), to avoid putting that request in the queue temporarily.
2936    Mutex::Autolock l(mRequestLock);
2937
2938    while (mRequestQueue.empty()) {
2939        if (!mRepeatingRequests.empty()) {
2940            // Always atomically enqueue all requests in a repeating request
2941            // list. Guarantees a complete in-sequence set of captures to
2942            // application.
2943            const RequestList &requests = mRepeatingRequests;
2944            RequestList::const_iterator firstRequest =
2945                    requests.begin();
2946            nextRequest = *firstRequest;
2947            mRequestQueue.insert(mRequestQueue.end(),
2948                    ++firstRequest,
2949                    requests.end());
2950            // No need to wait any longer
2951
2952            mRepeatingLastFrameNumber = mFrameNumber + requests.size() - 1;
2953
2954            break;
2955        }
2956
2957        res = mRequestSignal.waitRelative(mRequestLock, kRequestTimeout);
2958
2959        if ((mRequestQueue.empty() && mRepeatingRequests.empty()) ||
2960                exitPending()) {
2961            Mutex::Autolock pl(mPauseLock);
2962            if (mPaused == false) {
2963                ALOGV("%s: RequestThread: Going idle", __FUNCTION__);
2964                mPaused = true;
2965                // Let the tracker know
2966                sp<StatusTracker> statusTracker = mStatusTracker.promote();
2967                if (statusTracker != 0) {
2968                    statusTracker->markComponentIdle(mStatusId, Fence::NO_FENCE);
2969                }
2970            }
2971            // Stop waiting for now and let thread management happen
2972            return NULL;
2973        }
2974    }
2975
2976    if (nextRequest == NULL) {
2977        // Don't have a repeating request already in hand, so queue
2978        // must have an entry now.
2979        RequestList::iterator firstRequest =
2980                mRequestQueue.begin();
2981        nextRequest = *firstRequest;
2982        mRequestQueue.erase(firstRequest);
2983    }
2984
2985    // In case we've been unpaused by setPaused clearing mDoPause, need to
2986    // update internal pause state (capture/setRepeatingRequest unpause
2987    // directly).
2988    Mutex::Autolock pl(mPauseLock);
2989    if (mPaused) {
2990        ALOGV("%s: RequestThread: Unpaused", __FUNCTION__);
2991        sp<StatusTracker> statusTracker = mStatusTracker.promote();
2992        if (statusTracker != 0) {
2993            statusTracker->markComponentActive(mStatusId);
2994        }
2995    }
2996    mPaused = false;
2997
2998    // Check if we've reconfigured since last time, and reset the preview
2999    // request if so. Can't use 'NULL request == repeat' across configure calls.
3000    if (mReconfigured) {
3001        mPrevRequest.clear();
3002        mReconfigured = false;
3003    }
3004
3005    if (nextRequest != NULL) {
3006        nextRequest->mResultExtras.frameNumber = mFrameNumber++;
3007        nextRequest->mResultExtras.afTriggerId = mCurrentAfTriggerId;
3008        nextRequest->mResultExtras.precaptureTriggerId = mCurrentPreCaptureTriggerId;
3009    }
3010    return nextRequest;
3011}
3012
3013bool Camera3Device::RequestThread::waitIfPaused() {
3014    status_t res;
3015    Mutex::Autolock l(mPauseLock);
3016    while (mDoPause) {
3017        if (mPaused == false) {
3018            mPaused = true;
3019            ALOGV("%s: RequestThread: Paused", __FUNCTION__);
3020            // Let the tracker know
3021            sp<StatusTracker> statusTracker = mStatusTracker.promote();
3022            if (statusTracker != 0) {
3023                statusTracker->markComponentIdle(mStatusId, Fence::NO_FENCE);
3024            }
3025        }
3026
3027        res = mDoPauseSignal.waitRelative(mPauseLock, kRequestTimeout);
3028        if (res == TIMED_OUT || exitPending()) {
3029            return true;
3030        }
3031    }
3032    // We don't set mPaused to false here, because waitForNextRequest needs
3033    // to further manage the paused state in case of starvation.
3034    return false;
3035}
3036
3037void Camera3Device::RequestThread::unpauseForNewRequests() {
3038    // With work to do, mark thread as unpaused.
3039    // If paused by request (setPaused), don't resume, to avoid
3040    // extra signaling/waiting overhead to waitUntilPaused
3041    mRequestSignal.signal();
3042    Mutex::Autolock p(mPauseLock);
3043    if (!mDoPause) {
3044        ALOGV("%s: RequestThread: Going active", __FUNCTION__);
3045        if (mPaused) {
3046            sp<StatusTracker> statusTracker = mStatusTracker.promote();
3047            if (statusTracker != 0) {
3048                statusTracker->markComponentActive(mStatusId);
3049            }
3050        }
3051        mPaused = false;
3052    }
3053}
3054
3055void Camera3Device::RequestThread::setErrorState(const char *fmt, ...) {
3056    sp<Camera3Device> parent = mParent.promote();
3057    if (parent != NULL) {
3058        va_list args;
3059        va_start(args, fmt);
3060
3061        parent->setErrorStateV(fmt, args);
3062
3063        va_end(args);
3064    }
3065}
3066
3067status_t Camera3Device::RequestThread::insertTriggers(
3068        const sp<CaptureRequest> &request) {
3069
3070    Mutex::Autolock al(mTriggerMutex);
3071
3072    sp<Camera3Device> parent = mParent.promote();
3073    if (parent == NULL) {
3074        CLOGE("RequestThread: Parent is gone");
3075        return DEAD_OBJECT;
3076    }
3077
3078    CameraMetadata &metadata = request->mSettings;
3079    size_t count = mTriggerMap.size();
3080
3081    for (size_t i = 0; i < count; ++i) {
3082        RequestTrigger trigger = mTriggerMap.valueAt(i);
3083        uint32_t tag = trigger.metadataTag;
3084
3085        if (tag == ANDROID_CONTROL_AF_TRIGGER_ID || tag == ANDROID_CONTROL_AE_PRECAPTURE_ID) {
3086            bool isAeTrigger = (trigger.metadataTag == ANDROID_CONTROL_AE_PRECAPTURE_ID);
3087            uint32_t triggerId = static_cast<uint32_t>(trigger.entryValue);
3088            if (isAeTrigger) {
3089                request->mResultExtras.precaptureTriggerId = triggerId;
3090                mCurrentPreCaptureTriggerId = triggerId;
3091            } else {
3092                request->mResultExtras.afTriggerId = triggerId;
3093                mCurrentAfTriggerId = triggerId;
3094            }
3095            if (parent->mDeviceVersion >= CAMERA_DEVICE_API_VERSION_3_2) {
3096                continue; // Trigger ID tag is deprecated since device HAL 3.2
3097            }
3098        }
3099
3100        camera_metadata_entry entry = metadata.find(tag);
3101
3102        if (entry.count > 0) {
3103            /**
3104             * Already has an entry for this trigger in the request.
3105             * Rewrite it with our requested trigger value.
3106             */
3107            RequestTrigger oldTrigger = trigger;
3108
3109            oldTrigger.entryValue = entry.data.u8[0];
3110
3111            mTriggerReplacedMap.add(tag, oldTrigger);
3112        } else {
3113            /**
3114             * More typical, no trigger entry, so we just add it
3115             */
3116            mTriggerRemovedMap.add(tag, trigger);
3117        }
3118
3119        status_t res;
3120
3121        switch (trigger.getTagType()) {
3122            case TYPE_BYTE: {
3123                uint8_t entryValue = static_cast<uint8_t>(trigger.entryValue);
3124                res = metadata.update(tag,
3125                                      &entryValue,
3126                                      /*count*/1);
3127                break;
3128            }
3129            case TYPE_INT32:
3130                res = metadata.update(tag,
3131                                      &trigger.entryValue,
3132                                      /*count*/1);
3133                break;
3134            default:
3135                ALOGE("%s: Type not supported: 0x%x",
3136                      __FUNCTION__,
3137                      trigger.getTagType());
3138                return INVALID_OPERATION;
3139        }
3140
3141        if (res != OK) {
3142            ALOGE("%s: Failed to update request metadata with trigger tag %s"
3143                  ", value %d", __FUNCTION__, trigger.getTagName(),
3144                  trigger.entryValue);
3145            return res;
3146        }
3147
3148        ALOGV("%s: Mixed in trigger %s, value %d", __FUNCTION__,
3149              trigger.getTagName(),
3150              trigger.entryValue);
3151    }
3152
3153    mTriggerMap.clear();
3154
3155    return count;
3156}
3157
3158status_t Camera3Device::RequestThread::removeTriggers(
3159        const sp<CaptureRequest> &request) {
3160    Mutex::Autolock al(mTriggerMutex);
3161
3162    CameraMetadata &metadata = request->mSettings;
3163
3164    /**
3165     * Replace all old entries with their old values.
3166     */
3167    for (size_t i = 0; i < mTriggerReplacedMap.size(); ++i) {
3168        RequestTrigger trigger = mTriggerReplacedMap.valueAt(i);
3169
3170        status_t res;
3171
3172        uint32_t tag = trigger.metadataTag;
3173        switch (trigger.getTagType()) {
3174            case TYPE_BYTE: {
3175                uint8_t entryValue = static_cast<uint8_t>(trigger.entryValue);
3176                res = metadata.update(tag,
3177                                      &entryValue,
3178                                      /*count*/1);
3179                break;
3180            }
3181            case TYPE_INT32:
3182                res = metadata.update(tag,
3183                                      &trigger.entryValue,
3184                                      /*count*/1);
3185                break;
3186            default:
3187                ALOGE("%s: Type not supported: 0x%x",
3188                      __FUNCTION__,
3189                      trigger.getTagType());
3190                return INVALID_OPERATION;
3191        }
3192
3193        if (res != OK) {
3194            ALOGE("%s: Failed to restore request metadata with trigger tag %s"
3195                  ", trigger value %d", __FUNCTION__,
3196                  trigger.getTagName(), trigger.entryValue);
3197            return res;
3198        }
3199    }
3200    mTriggerReplacedMap.clear();
3201
3202    /**
3203     * Remove all new entries.
3204     */
3205    for (size_t i = 0; i < mTriggerRemovedMap.size(); ++i) {
3206        RequestTrigger trigger = mTriggerRemovedMap.valueAt(i);
3207        status_t res = metadata.erase(trigger.metadataTag);
3208
3209        if (res != OK) {
3210            ALOGE("%s: Failed to erase metadata with trigger tag %s"
3211                  ", trigger value %d", __FUNCTION__,
3212                  trigger.getTagName(), trigger.entryValue);
3213            return res;
3214        }
3215    }
3216    mTriggerRemovedMap.clear();
3217
3218    return OK;
3219}
3220
3221status_t Camera3Device::RequestThread::addDummyTriggerIds(
3222        const sp<CaptureRequest> &request) {
3223    // Trigger ID 0 has special meaning in the HAL2 spec, so avoid it here
3224    static const int32_t dummyTriggerId = 1;
3225    status_t res;
3226
3227    CameraMetadata &metadata = request->mSettings;
3228
3229    // If AF trigger is active, insert a dummy AF trigger ID if none already
3230    // exists
3231    camera_metadata_entry afTrigger = metadata.find(ANDROID_CONTROL_AF_TRIGGER);
3232    camera_metadata_entry afId = metadata.find(ANDROID_CONTROL_AF_TRIGGER_ID);
3233    if (afTrigger.count > 0 &&
3234            afTrigger.data.u8[0] != ANDROID_CONTROL_AF_TRIGGER_IDLE &&
3235            afId.count == 0) {
3236        res = metadata.update(ANDROID_CONTROL_AF_TRIGGER_ID, &dummyTriggerId, 1);
3237        if (res != OK) return res;
3238    }
3239
3240    // If AE precapture trigger is active, insert a dummy precapture trigger ID
3241    // if none already exists
3242    camera_metadata_entry pcTrigger =
3243            metadata.find(ANDROID_CONTROL_AE_PRECAPTURE_TRIGGER);
3244    camera_metadata_entry pcId = metadata.find(ANDROID_CONTROL_AE_PRECAPTURE_ID);
3245    if (pcTrigger.count > 0 &&
3246            pcTrigger.data.u8[0] != ANDROID_CONTROL_AE_PRECAPTURE_TRIGGER_IDLE &&
3247            pcId.count == 0) {
3248        res = metadata.update(ANDROID_CONTROL_AE_PRECAPTURE_ID,
3249                &dummyTriggerId, 1);
3250        if (res != OK) return res;
3251    }
3252
3253    return OK;
3254}
3255
3256/**
3257 * PreparerThread inner class methods
3258 */
3259
3260Camera3Device::PreparerThread::PreparerThread() :
3261        Thread(/*canCallJava*/false), mActive(false), mCancelNow(false) {
3262}
3263
3264Camera3Device::PreparerThread::~PreparerThread() {
3265    Thread::requestExitAndWait();
3266    if (mCurrentStream != nullptr) {
3267        mCurrentStream->cancelPrepare();
3268        ATRACE_ASYNC_END("stream prepare", mCurrentStream->getId());
3269        mCurrentStream.clear();
3270    }
3271    clear();
3272}
3273
3274status_t Camera3Device::PreparerThread::prepare(sp<Camera3StreamInterface>& stream) {
3275    status_t res;
3276
3277    Mutex::Autolock l(mLock);
3278
3279    res = stream->startPrepare();
3280    if (res == OK) {
3281        // No preparation needed, fire listener right off
3282        ALOGV("%s: Stream %d already prepared", __FUNCTION__, stream->getId());
3283        if (mListener) {
3284            mListener->notifyPrepared(stream->getId());
3285        }
3286        return OK;
3287    } else if (res != NOT_ENOUGH_DATA) {
3288        return res;
3289    }
3290
3291    // Need to prepare, start up thread if necessary
3292    if (!mActive) {
3293        // mRunning will change to false before the thread fully shuts down, so wait to be sure it
3294        // isn't running
3295        Thread::requestExitAndWait();
3296        res = Thread::run("C3PrepThread", PRIORITY_BACKGROUND);
3297        if (res != OK) {
3298            ALOGE("%s: Unable to start preparer stream: %d (%s)", __FUNCTION__, res, strerror(-res));
3299            if (mListener) {
3300                mListener->notifyPrepared(stream->getId());
3301            }
3302            return res;
3303        }
3304        mCancelNow = false;
3305        mActive = true;
3306        ALOGV("%s: Preparer stream started", __FUNCTION__);
3307    }
3308
3309    // queue up the work
3310    mPendingStreams.push_back(stream);
3311    ALOGV("%s: Stream %d queued for preparing", __FUNCTION__, stream->getId());
3312
3313    return OK;
3314}
3315
3316status_t Camera3Device::PreparerThread::clear() {
3317    status_t res;
3318
3319    Mutex::Autolock l(mLock);
3320
3321    for (const auto& stream : mPendingStreams) {
3322        stream->cancelPrepare();
3323    }
3324    mPendingStreams.clear();
3325    mCancelNow = true;
3326
3327    return OK;
3328}
3329
3330void Camera3Device::PreparerThread::setNotificationListener(NotificationListener *listener) {
3331    Mutex::Autolock l(mLock);
3332    mListener = listener;
3333}
3334
3335bool Camera3Device::PreparerThread::threadLoop() {
3336    status_t res;
3337    {
3338        Mutex::Autolock l(mLock);
3339        if (mCurrentStream == nullptr) {
3340            // End thread if done with work
3341            if (mPendingStreams.empty()) {
3342                ALOGV("%s: Preparer stream out of work", __FUNCTION__);
3343                // threadLoop _must not_ re-acquire mLock after it sets mActive to false; would
3344                // cause deadlock with prepare()'s requestExitAndWait triggered by !mActive.
3345                mActive = false;
3346                return false;
3347            }
3348
3349            // Get next stream to prepare
3350            auto it = mPendingStreams.begin();
3351            mCurrentStream = *it;
3352            mPendingStreams.erase(it);
3353            ATRACE_ASYNC_BEGIN("stream prepare", mCurrentStream->getId());
3354            ALOGV("%s: Preparing stream %d", __FUNCTION__, mCurrentStream->getId());
3355        } else if (mCancelNow) {
3356            mCurrentStream->cancelPrepare();
3357            ATRACE_ASYNC_END("stream prepare", mCurrentStream->getId());
3358            ALOGV("%s: Cancelling stream %d prepare", __FUNCTION__, mCurrentStream->getId());
3359            mCurrentStream.clear();
3360            mCancelNow = false;
3361            return true;
3362        }
3363    }
3364
3365    res = mCurrentStream->prepareNextBuffer();
3366    if (res == NOT_ENOUGH_DATA) return true;
3367    if (res != OK) {
3368        // Something bad happened; try to recover by cancelling prepare and
3369        // signalling listener anyway
3370        ALOGE("%s: Stream %d returned error %d (%s) during prepare", __FUNCTION__,
3371                mCurrentStream->getId(), res, strerror(-res));
3372        mCurrentStream->cancelPrepare();
3373    }
3374
3375    // This stream has finished, notify listener
3376    Mutex::Autolock l(mLock);
3377    if (mListener) {
3378        ALOGV("%s: Stream %d prepare done, signaling listener", __FUNCTION__,
3379                mCurrentStream->getId());
3380        mListener->notifyPrepared(mCurrentStream->getId());
3381    }
3382
3383    ATRACE_ASYNC_END("stream prepare", mCurrentStream->getId());
3384    mCurrentStream.clear();
3385
3386    return true;
3387}
3388
3389/**
3390 * Static callback forwarding methods from HAL to instance
3391 */
3392
3393void Camera3Device::sProcessCaptureResult(const camera3_callback_ops *cb,
3394        const camera3_capture_result *result) {
3395    Camera3Device *d =
3396            const_cast<Camera3Device*>(static_cast<const Camera3Device*>(cb));
3397    d->processCaptureResult(result);
3398}
3399
3400void Camera3Device::sNotify(const camera3_callback_ops *cb,
3401        const camera3_notify_msg *msg) {
3402    Camera3Device *d =
3403            const_cast<Camera3Device*>(static_cast<const Camera3Device*>(cb));
3404    d->notify(msg);
3405}
3406
3407}; // namespace android
3408