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