Camera3Device.cpp revision 491e341211b4772c75f719158f6b397e1c40497d 
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 <utils/Log.h>
41#include <utils/Trace.h>
42#include <utils/Timers.h>
43
44#include "utils/CameraTraces.h"
45#include "device3/Camera3Device.h"
46#include "device3/Camera3OutputStream.h"
47#include "device3/Camera3InputStream.h"
48#include "device3/Camera3ZslStream.h"
49
50using namespace android::camera3;
51
52namespace android {
53
54Camera3Device::Camera3Device(int id):
55        mId(id),
56        mHal3Device(NULL),
57        mStatus(STATUS_UNINITIALIZED),
58        mUsePartialResultQuirk(false),
59        mNextResultFrameNumber(0),
60        mNextShutterFrameNumber(0),
61        mListener(NULL)
62{
63    ATRACE_CALL();
64    camera3_callback_ops::notify = &sNotify;
65    camera3_callback_ops::process_capture_result = &sProcessCaptureResult;
66    ALOGV("%s: Created device for camera %d", __FUNCTION__, id);
67}
68
69Camera3Device::~Camera3Device()
70{
71    ATRACE_CALL();
72    ALOGV("%s: Tearing down for camera id %d", __FUNCTION__, mId);
73    disconnect();
74}
75
76int Camera3Device::getId() const {
77    return mId;
78}
79
80/**
81 * CameraDeviceBase interface
82 */
83
84status_t Camera3Device::initialize(camera_module_t *module)
85{
86    ATRACE_CALL();
87    Mutex::Autolock il(mInterfaceLock);
88    Mutex::Autolock l(mLock);
89
90    ALOGV("%s: Initializing device for camera %d", __FUNCTION__, mId);
91    if (mStatus != STATUS_UNINITIALIZED) {
92        CLOGE("Already initialized!");
93        return INVALID_OPERATION;
94    }
95
96    /** Open HAL device */
97
98    status_t res;
99    String8 deviceName = String8::format("%d", mId);
100
101    camera3_device_t *device;
102
103    ATRACE_BEGIN("camera3->open");
104    res = module->common.methods->open(&module->common, deviceName.string(),
105            reinterpret_cast<hw_device_t**>(&device));
106    ATRACE_END();
107
108    if (res != OK) {
109        SET_ERR_L("Could not open camera: %s (%d)", strerror(-res), res);
110        return res;
111    }
112
113    /** Cross-check device version */
114
115    if (device->common.version != CAMERA_DEVICE_API_VERSION_3_0) {
116        SET_ERR_L("Could not open camera: "
117                "Camera device is not version %x, reports %x instead",
118                CAMERA_DEVICE_API_VERSION_3_0,
119                device->common.version);
120        device->common.close(&device->common);
121        return BAD_VALUE;
122    }
123
124    camera_info info;
125    res = module->get_camera_info(mId, &info);
126    if (res != OK) return res;
127
128    if (info.device_version != device->common.version) {
129        SET_ERR_L("HAL reporting mismatched camera_info version (%x)"
130                " and device version (%x).",
131                device->common.version, info.device_version);
132        device->common.close(&device->common);
133        return BAD_VALUE;
134    }
135
136    /** Initialize device with callback functions */
137
138    ATRACE_BEGIN("camera3->initialize");
139    res = device->ops->initialize(device, this);
140    ATRACE_END();
141
142    if (res != OK) {
143        SET_ERR_L("Unable to initialize HAL device: %s (%d)",
144                strerror(-res), res);
145        device->common.close(&device->common);
146        return BAD_VALUE;
147    }
148
149    /** Get vendor metadata tags */
150
151    mVendorTagOps.get_camera_vendor_section_name = NULL;
152
153    ATRACE_BEGIN("camera3->get_metadata_vendor_tag_ops");
154    device->ops->get_metadata_vendor_tag_ops(device, &mVendorTagOps);
155    ATRACE_END();
156
157    if (mVendorTagOps.get_camera_vendor_section_name != NULL) {
158        res = set_camera_metadata_vendor_tag_ops(&mVendorTagOps);
159        if (res != OK) {
160            SET_ERR_L("Unable to set tag ops: %s (%d)",
161                    strerror(-res), res);
162            device->common.close(&device->common);
163            return res;
164        }
165    }
166
167    /** Start up status tracker thread */
168    mStatusTracker = new StatusTracker(this);
169    res = mStatusTracker->run(String8::format("C3Dev-%d-Status", mId).string());
170    if (res != OK) {
171        SET_ERR_L("Unable to start status tracking thread: %s (%d)",
172                strerror(-res), res);
173        device->common.close(&device->common);
174        mStatusTracker.clear();
175        return res;
176    }
177
178    /** Start up request queue thread */
179
180    mRequestThread = new RequestThread(this, mStatusTracker, device);
181    res = mRequestThread->run(String8::format("C3Dev-%d-ReqQueue", mId).string());
182    if (res != OK) {
183        SET_ERR_L("Unable to start request queue thread: %s (%d)",
184                strerror(-res), res);
185        device->common.close(&device->common);
186        mRequestThread.clear();
187        return res;
188    }
189
190    /** Everything is good to go */
191
192    mDeviceInfo = info.static_camera_characteristics;
193    mHal3Device = device;
194    mStatus = STATUS_UNCONFIGURED;
195    mNextStreamId = 0;
196    mNeedConfig = true;
197    mPauseStateNotify = false;
198
199    /** Check for quirks */
200
201    // Will the HAL be sending in early partial result metadata?
202    camera_metadata_entry partialResultsQuirk =
203            mDeviceInfo.find(ANDROID_QUIRKS_USE_PARTIAL_RESULT);
204    if (partialResultsQuirk.count > 0 && partialResultsQuirk.data.u8[0] == 1) {
205        mUsePartialResultQuirk = true;
206    }
207
208    return OK;
209}
210
211status_t Camera3Device::disconnect() {
212    ATRACE_CALL();
213    Mutex::Autolock il(mInterfaceLock);
214
215    ALOGV("%s: E", __FUNCTION__);
216
217    status_t res = OK;
218
219    {
220        Mutex::Autolock l(mLock);
221        if (mStatus == STATUS_UNINITIALIZED) return res;
222
223        if (mStatus == STATUS_ACTIVE ||
224                (mStatus == STATUS_ERROR && mRequestThread != NULL)) {
225            res = mRequestThread->clearRepeatingRequests();
226            if (res != OK) {
227                SET_ERR_L("Can't stop streaming");
228                // Continue to close device even in case of error
229            } else {
230                res = waitUntilStateThenRelock(/*active*/ false, kShutdownTimeout);
231                if (res != OK) {
232                    SET_ERR_L("Timeout waiting for HAL to drain");
233                    // Continue to close device even in case of error
234                }
235            }
236        }
237
238        if (mStatus == STATUS_ERROR) {
239            CLOGE("Shutting down in an error state");
240        }
241
242        if (mStatusTracker != NULL) {
243            mStatusTracker->requestExit();
244        }
245
246        if (mRequestThread != NULL) {
247            mRequestThread->requestExit();
248        }
249
250        mOutputStreams.clear();
251        mInputStream.clear();
252    }
253
254    // Joining done without holding mLock, otherwise deadlocks may ensue
255    // as the threads try to access parent state
256    if (mRequestThread != NULL && mStatus != STATUS_ERROR) {
257        // HAL may be in a bad state, so waiting for request thread
258        // (which may be stuck in the HAL processCaptureRequest call)
259        // could be dangerous.
260        mRequestThread->join();
261    }
262
263    if (mStatusTracker != NULL) {
264        mStatusTracker->join();
265    }
266
267    {
268        Mutex::Autolock l(mLock);
269
270        mRequestThread.clear();
271        mStatusTracker.clear();
272
273        if (mHal3Device != NULL) {
274            ATRACE_BEGIN("camera3->close");
275            mHal3Device->common.close(&mHal3Device->common);
276            ATRACE_END();
277            mHal3Device = NULL;
278        }
279
280        mStatus = STATUS_UNINITIALIZED;
281    }
282
283    ALOGV("%s: X", __FUNCTION__);
284    return res;
285}
286
287// For dumping/debugging only -
288// try to acquire a lock a few times, eventually give up to proceed with
289// debug/dump operations
290bool Camera3Device::tryLockSpinRightRound(Mutex& lock) {
291    bool gotLock = false;
292    for (size_t i = 0; i < kDumpLockAttempts; ++i) {
293        if (lock.tryLock() == NO_ERROR) {
294            gotLock = true;
295            break;
296        } else {
297            usleep(kDumpSleepDuration);
298        }
299    }
300    return gotLock;
301}
302
303status_t Camera3Device::dump(int fd, const Vector<String16> &args) {
304    ATRACE_CALL();
305    (void)args;
306
307    // Try to lock, but continue in case of failure (to avoid blocking in
308    // deadlocks)
309    bool gotInterfaceLock = tryLockSpinRightRound(mInterfaceLock);
310    bool gotLock = tryLockSpinRightRound(mLock);
311
312    ALOGW_IF(!gotInterfaceLock,
313            "Camera %d: %s: Unable to lock interface lock, proceeding anyway",
314            mId, __FUNCTION__);
315    ALOGW_IF(!gotLock,
316            "Camera %d: %s: Unable to lock main lock, proceeding anyway",
317            mId, __FUNCTION__);
318
319    String8 lines;
320
321    const char *status =
322            mStatus == STATUS_ERROR         ? "ERROR" :
323            mStatus == STATUS_UNINITIALIZED ? "UNINITIALIZED" :
324            mStatus == STATUS_UNCONFIGURED  ? "UNCONFIGURED" :
325            mStatus == STATUS_CONFIGURED    ? "CONFIGURED" :
326            mStatus == STATUS_ACTIVE        ? "ACTIVE" :
327            "Unknown";
328
329    lines.appendFormat("    Device status: %s\n", status);
330    if (mStatus == STATUS_ERROR) {
331        lines.appendFormat("    Error cause: %s\n", mErrorCause.string());
332    }
333    lines.appendFormat("    Stream configuration:\n");
334
335    if (mInputStream != NULL) {
336        write(fd, lines.string(), lines.size());
337        mInputStream->dump(fd, args);
338    } else {
339        lines.appendFormat("      No input stream.\n");
340        write(fd, lines.string(), lines.size());
341    }
342    for (size_t i = 0; i < mOutputStreams.size(); i++) {
343        mOutputStreams[i]->dump(fd,args);
344    }
345
346    lines = String8("    In-flight requests:\n");
347    if (mInFlightMap.size() == 0) {
348        lines.append("      None\n");
349    } else {
350        for (size_t i = 0; i < mInFlightMap.size(); i++) {
351            InFlightRequest r = mInFlightMap.valueAt(i);
352            lines.appendFormat("      Frame %d |  Timestamp: %lld, metadata"
353                    " arrived: %s, buffers left: %d\n", mInFlightMap.keyAt(i),
354                    r.captureTimestamp, r.haveResultMetadata ? "true" : "false",
355                    r.numBuffersLeft);
356        }
357    }
358    write(fd, lines.string(), lines.size());
359
360    {
361        lines = String8("    Last request sent:\n");
362        write(fd, lines.string(), lines.size());
363
364        CameraMetadata lastRequest = getLatestRequestLocked();
365        lastRequest.dump(fd, /*verbosity*/2, /*indentation*/6);
366    }
367
368    if (mHal3Device != NULL) {
369        lines = String8("    HAL device dump:\n");
370        write(fd, lines.string(), lines.size());
371        mHal3Device->ops->dump(mHal3Device, fd);
372    }
373
374    if (gotLock) mLock.unlock();
375    if (gotInterfaceLock) mInterfaceLock.unlock();
376
377    return OK;
378}
379
380const CameraMetadata& Camera3Device::info() const {
381    ALOGVV("%s: E", __FUNCTION__);
382    if (CC_UNLIKELY(mStatus == STATUS_UNINITIALIZED ||
383                    mStatus == STATUS_ERROR)) {
384        ALOGW("%s: Access to static info %s!", __FUNCTION__,
385                mStatus == STATUS_ERROR ?
386                "when in error state" : "before init");
387    }
388    return mDeviceInfo;
389}
390
391status_t Camera3Device::capture(CameraMetadata &request) {
392    ATRACE_CALL();
393    status_t res;
394    Mutex::Autolock il(mInterfaceLock);
395    Mutex::Autolock l(mLock);
396
397    // TODO: take ownership of the request
398
399    switch (mStatus) {
400        case STATUS_ERROR:
401            CLOGE("Device has encountered a serious error");
402            return INVALID_OPERATION;
403        case STATUS_UNINITIALIZED:
404            CLOGE("Device not initialized");
405            return INVALID_OPERATION;
406        case STATUS_UNCONFIGURED:
407            // May be lazily configuring streams, will check during setup
408        case STATUS_CONFIGURED:
409        case STATUS_ACTIVE:
410            // OK
411            break;
412        default:
413            SET_ERR_L("Unexpected status: %d", mStatus);
414            return INVALID_OPERATION;
415    }
416
417    sp<CaptureRequest> newRequest = setUpRequestLocked(request);
418    if (newRequest == NULL) {
419        CLOGE("Can't create capture request");
420        return BAD_VALUE;
421    }
422
423    res = mRequestThread->queueRequest(newRequest);
424    if (res == OK) {
425        waitUntilStateThenRelock(/*active*/ true, kActiveTimeout);
426        if (res != OK) {
427            SET_ERR_L("Can't transition to active in %f seconds!",
428                    kActiveTimeout/1e9);
429        }
430        ALOGV("Camera %d: Capture request enqueued", mId);
431    }
432    return res;
433}
434
435
436status_t Camera3Device::setStreamingRequest(const CameraMetadata &request) {
437    ATRACE_CALL();
438    status_t res;
439    Mutex::Autolock il(mInterfaceLock);
440    Mutex::Autolock l(mLock);
441
442    switch (mStatus) {
443        case STATUS_ERROR:
444            CLOGE("Device has encountered a serious error");
445            return INVALID_OPERATION;
446        case STATUS_UNINITIALIZED:
447            CLOGE("Device not initialized");
448            return INVALID_OPERATION;
449        case STATUS_UNCONFIGURED:
450            // May be lazily configuring streams, will check during setup
451        case STATUS_CONFIGURED:
452        case STATUS_ACTIVE:
453            // OK
454            break;
455        default:
456            SET_ERR_L("Unexpected status: %d", mStatus);
457            return INVALID_OPERATION;
458    }
459
460    sp<CaptureRequest> newRepeatingRequest = setUpRequestLocked(request);
461    if (newRepeatingRequest == NULL) {
462        CLOGE("Can't create repeating request");
463        return BAD_VALUE;
464    }
465
466    RequestList newRepeatingRequests;
467    newRepeatingRequests.push_back(newRepeatingRequest);
468
469    res = mRequestThread->setRepeatingRequests(newRepeatingRequests);
470    if (res == OK) {
471        waitUntilStateThenRelock(/*active*/ true, kActiveTimeout);
472        if (res != OK) {
473            SET_ERR_L("Can't transition to active in %f seconds!",
474                    kActiveTimeout/1e9);
475        }
476        ALOGV("Camera %d: Repeating request set", mId);
477    }
478    return res;
479}
480
481
482sp<Camera3Device::CaptureRequest> Camera3Device::setUpRequestLocked(
483        const CameraMetadata &request) {
484    status_t res;
485
486    if (mStatus == STATUS_UNCONFIGURED || mNeedConfig) {
487        res = configureStreamsLocked();
488        if (res != OK) {
489            SET_ERR_L("Can't set up streams: %s (%d)", strerror(-res), res);
490            return NULL;
491        }
492        if (mStatus == STATUS_UNCONFIGURED) {
493            CLOGE("No streams configured");
494            return NULL;
495        }
496    }
497
498    sp<CaptureRequest> newRequest = createCaptureRequest(request);
499    return newRequest;
500}
501
502status_t Camera3Device::clearStreamingRequest() {
503    ATRACE_CALL();
504    Mutex::Autolock il(mInterfaceLock);
505    Mutex::Autolock l(mLock);
506
507    switch (mStatus) {
508        case STATUS_ERROR:
509            CLOGE("Device has encountered a serious error");
510            return INVALID_OPERATION;
511        case STATUS_UNINITIALIZED:
512            CLOGE("Device not initialized");
513            return INVALID_OPERATION;
514        case STATUS_UNCONFIGURED:
515        case STATUS_CONFIGURED:
516        case STATUS_ACTIVE:
517            // OK
518            break;
519        default:
520            SET_ERR_L("Unexpected status: %d", mStatus);
521            return INVALID_OPERATION;
522    }
523    ALOGV("Camera %d: Clearing repeating request", mId);
524    return mRequestThread->clearRepeatingRequests();
525}
526
527status_t Camera3Device::waitUntilRequestReceived(int32_t requestId, nsecs_t timeout) {
528    ATRACE_CALL();
529    Mutex::Autolock il(mInterfaceLock);
530
531    return mRequestThread->waitUntilRequestProcessed(requestId, timeout);
532}
533
534status_t Camera3Device::createInputStream(
535        uint32_t width, uint32_t height, int format, int *id) {
536    ATRACE_CALL();
537    Mutex::Autolock il(mInterfaceLock);
538    Mutex::Autolock l(mLock);
539    ALOGV("Camera %d: Creating new input stream %d: %d x %d, format %d",
540            mId, mNextStreamId, width, height, format);
541
542    status_t res;
543    bool wasActive = false;
544
545    switch (mStatus) {
546        case STATUS_ERROR:
547            ALOGE("%s: Device has encountered a serious error", __FUNCTION__);
548            return INVALID_OPERATION;
549        case STATUS_UNINITIALIZED:
550            ALOGE("%s: Device not initialized", __FUNCTION__);
551            return INVALID_OPERATION;
552        case STATUS_UNCONFIGURED:
553        case STATUS_CONFIGURED:
554            // OK
555            break;
556        case STATUS_ACTIVE:
557            ALOGV("%s: Stopping activity to reconfigure streams", __FUNCTION__);
558            res = internalPauseAndWaitLocked();
559            if (res != OK) {
560                SET_ERR_L("Can't pause captures to reconfigure streams!");
561                return res;
562            }
563            wasActive = true;
564            break;
565        default:
566            SET_ERR_L("%s: Unexpected status: %d", mStatus);
567            return INVALID_OPERATION;
568    }
569    assert(mStatus != STATUS_ACTIVE);
570
571    if (mInputStream != 0) {
572        ALOGE("%s: Cannot create more than 1 input stream", __FUNCTION__);
573        return INVALID_OPERATION;
574    }
575
576    sp<Camera3InputStream> newStream = new Camera3InputStream(mNextStreamId,
577                width, height, format);
578    newStream->setStatusTracker(mStatusTracker);
579
580    mInputStream = newStream;
581
582    *id = mNextStreamId++;
583
584    // Continue captures if active at start
585    if (wasActive) {
586        ALOGV("%s: Restarting activity to reconfigure streams", __FUNCTION__);
587        res = configureStreamsLocked();
588        if (res != OK) {
589            ALOGE("%s: Can't reconfigure device for new stream %d: %s (%d)",
590                    __FUNCTION__, mNextStreamId, strerror(-res), res);
591            return res;
592        }
593        internalResumeLocked();
594    }
595
596    ALOGV("Camera %d: Created input stream", mId);
597    return OK;
598}
599
600
601status_t Camera3Device::createZslStream(
602            uint32_t width, uint32_t height,
603            int depth,
604            /*out*/
605            int *id,
606            sp<Camera3ZslStream>* zslStream) {
607    ATRACE_CALL();
608    Mutex::Autolock il(mInterfaceLock);
609    Mutex::Autolock l(mLock);
610    ALOGV("Camera %d: Creating ZSL stream %d: %d x %d, depth %d",
611            mId, mNextStreamId, width, height, depth);
612
613    status_t res;
614    bool wasActive = false;
615
616    switch (mStatus) {
617        case STATUS_ERROR:
618            ALOGE("%s: Device has encountered a serious error", __FUNCTION__);
619            return INVALID_OPERATION;
620        case STATUS_UNINITIALIZED:
621            ALOGE("%s: Device not initialized", __FUNCTION__);
622            return INVALID_OPERATION;
623        case STATUS_UNCONFIGURED:
624        case STATUS_CONFIGURED:
625            // OK
626            break;
627        case STATUS_ACTIVE:
628            ALOGV("%s: Stopping activity to reconfigure streams", __FUNCTION__);
629            res = internalPauseAndWaitLocked();
630            if (res != OK) {
631                SET_ERR_L("Can't pause captures to reconfigure streams!");
632                return res;
633            }
634            wasActive = true;
635            break;
636        default:
637            SET_ERR_L("Unexpected status: %d", mStatus);
638            return INVALID_OPERATION;
639    }
640    assert(mStatus != STATUS_ACTIVE);
641
642    if (mInputStream != 0) {
643        ALOGE("%s: Cannot create more than 1 input stream", __FUNCTION__);
644        return INVALID_OPERATION;
645    }
646
647    sp<Camera3ZslStream> newStream = new Camera3ZslStream(mNextStreamId,
648                width, height, depth);
649    newStream->setStatusTracker(mStatusTracker);
650
651    res = mOutputStreams.add(mNextStreamId, newStream);
652    if (res < 0) {
653        ALOGE("%s: Can't add new stream to set: %s (%d)",
654                __FUNCTION__, strerror(-res), res);
655        return res;
656    }
657    mInputStream = newStream;
658
659    *id = mNextStreamId++;
660    *zslStream = newStream;
661
662    // Continue captures if active at start
663    if (wasActive) {
664        ALOGV("%s: Restarting activity to reconfigure streams", __FUNCTION__);
665        res = configureStreamsLocked();
666        if (res != OK) {
667            ALOGE("%s: Can't reconfigure device for new stream %d: %s (%d)",
668                    __FUNCTION__, mNextStreamId, strerror(-res), res);
669            return res;
670        }
671        internalResumeLocked();
672    }
673
674    ALOGV("Camera %d: Created ZSL stream", mId);
675    return OK;
676}
677
678status_t Camera3Device::createStream(sp<ANativeWindow> consumer,
679        uint32_t width, uint32_t height, int format, size_t size, int *id) {
680    ATRACE_CALL();
681    Mutex::Autolock il(mInterfaceLock);
682    Mutex::Autolock l(mLock);
683    ALOGV("Camera %d: Creating new stream %d: %d x %d, format %d, size %d",
684            mId, mNextStreamId, width, height, format, size);
685
686    status_t res;
687    bool wasActive = false;
688
689    switch (mStatus) {
690        case STATUS_ERROR:
691            CLOGE("Device has encountered a serious error");
692            return INVALID_OPERATION;
693        case STATUS_UNINITIALIZED:
694            CLOGE("Device not initialized");
695            return INVALID_OPERATION;
696        case STATUS_UNCONFIGURED:
697        case STATUS_CONFIGURED:
698            // OK
699            break;
700        case STATUS_ACTIVE:
701            ALOGV("%s: Stopping activity to reconfigure streams", __FUNCTION__);
702            res = internalPauseAndWaitLocked();
703            if (res != OK) {
704                SET_ERR_L("Can't pause captures to reconfigure streams!");
705                return res;
706            }
707            wasActive = true;
708            break;
709        default:
710            SET_ERR_L("Unexpected status: %d", mStatus);
711            return INVALID_OPERATION;
712    }
713    assert(mStatus != STATUS_ACTIVE);
714
715    sp<Camera3OutputStream> newStream;
716    if (format == HAL_PIXEL_FORMAT_BLOB) {
717        newStream = new Camera3OutputStream(mNextStreamId, consumer,
718                width, height, size, format);
719    } else {
720        newStream = new Camera3OutputStream(mNextStreamId, consumer,
721                width, height, format);
722    }
723    newStream->setStatusTracker(mStatusTracker);
724
725    res = mOutputStreams.add(mNextStreamId, newStream);
726    if (res < 0) {
727        SET_ERR_L("Can't add new stream to set: %s (%d)", strerror(-res), res);
728        return res;
729    }
730
731    *id = mNextStreamId++;
732    mNeedConfig = true;
733
734    // Continue captures if active at start
735    if (wasActive) {
736        ALOGV("%s: Restarting activity to reconfigure streams", __FUNCTION__);
737        res = configureStreamsLocked();
738        if (res != OK) {
739            CLOGE("Can't reconfigure device for new stream %d: %s (%d)",
740                    mNextStreamId, strerror(-res), res);
741            return res;
742        }
743        internalResumeLocked();
744    }
745    ALOGV("Camera %d: Created new stream", mId);
746    return OK;
747}
748
749status_t Camera3Device::createReprocessStreamFromStream(int outputId, int *id) {
750    ATRACE_CALL();
751    (void)outputId; (void)id;
752
753    CLOGE("Unimplemented");
754    return INVALID_OPERATION;
755}
756
757
758status_t Camera3Device::getStreamInfo(int id,
759        uint32_t *width, uint32_t *height, uint32_t *format) {
760    ATRACE_CALL();
761    Mutex::Autolock il(mInterfaceLock);
762    Mutex::Autolock l(mLock);
763
764    switch (mStatus) {
765        case STATUS_ERROR:
766            CLOGE("Device has encountered a serious error");
767            return INVALID_OPERATION;
768        case STATUS_UNINITIALIZED:
769            CLOGE("Device not initialized!");
770            return INVALID_OPERATION;
771        case STATUS_UNCONFIGURED:
772        case STATUS_CONFIGURED:
773        case STATUS_ACTIVE:
774            // OK
775            break;
776        default:
777            SET_ERR_L("Unexpected status: %d", mStatus);
778            return INVALID_OPERATION;
779    }
780
781    ssize_t idx = mOutputStreams.indexOfKey(id);
782    if (idx == NAME_NOT_FOUND) {
783        CLOGE("Stream %d is unknown", id);
784        return idx;
785    }
786
787    if (width) *width  = mOutputStreams[idx]->getWidth();
788    if (height) *height = mOutputStreams[idx]->getHeight();
789    if (format) *format = mOutputStreams[idx]->getFormat();
790
791    return OK;
792}
793
794status_t Camera3Device::setStreamTransform(int id,
795        int transform) {
796    ATRACE_CALL();
797    Mutex::Autolock il(mInterfaceLock);
798    Mutex::Autolock l(mLock);
799
800    switch (mStatus) {
801        case STATUS_ERROR:
802            CLOGE("Device has encountered a serious error");
803            return INVALID_OPERATION;
804        case STATUS_UNINITIALIZED:
805            CLOGE("Device not initialized");
806            return INVALID_OPERATION;
807        case STATUS_UNCONFIGURED:
808        case STATUS_CONFIGURED:
809        case STATUS_ACTIVE:
810            // OK
811            break;
812        default:
813            SET_ERR_L("Unexpected status: %d", mStatus);
814            return INVALID_OPERATION;
815    }
816
817    ssize_t idx = mOutputStreams.indexOfKey(id);
818    if (idx == NAME_NOT_FOUND) {
819        CLOGE("Stream %d does not exist",
820                id);
821        return BAD_VALUE;
822    }
823
824    return mOutputStreams.editValueAt(idx)->setTransform(transform);
825}
826
827status_t Camera3Device::deleteStream(int id) {
828    ATRACE_CALL();
829    Mutex::Autolock il(mInterfaceLock);
830    Mutex::Autolock l(mLock);
831    status_t res;
832
833    ALOGV("%s: Camera %d: Deleting stream %d", __FUNCTION__, mId, id);
834
835    // CameraDevice semantics require device to already be idle before
836    // deleteStream is called, unlike for createStream.
837    if (mStatus == STATUS_ACTIVE) {
838        ALOGV("%s: Camera %d: Device not idle", __FUNCTION__, mId);
839        return -EBUSY;
840    }
841
842    sp<Camera3StreamInterface> deletedStream;
843    if (mInputStream != NULL && id == mInputStream->getId()) {
844        deletedStream = mInputStream;
845        mInputStream.clear();
846    } else {
847        ssize_t idx = mOutputStreams.indexOfKey(id);
848        if (idx == NAME_NOT_FOUND) {
849            CLOGE("Stream %d does not exist", id);
850            return BAD_VALUE;
851        }
852        deletedStream = mOutputStreams.editValueAt(idx);
853        mOutputStreams.removeItem(id);
854    }
855
856    // Free up the stream endpoint so that it can be used by some other stream
857    res = deletedStream->disconnect();
858    if (res != OK) {
859        SET_ERR_L("Can't disconnect deleted stream %d", id);
860        // fall through since we want to still list the stream as deleted.
861    }
862    mDeletedStreams.add(deletedStream);
863    mNeedConfig = true;
864
865    return res;
866}
867
868status_t Camera3Device::deleteReprocessStream(int id) {
869    ATRACE_CALL();
870    (void)id;
871
872    CLOGE("Unimplemented");
873    return INVALID_OPERATION;
874}
875
876
877status_t Camera3Device::createDefaultRequest(int templateId,
878        CameraMetadata *request) {
879    ATRACE_CALL();
880    ALOGV("%s: for template %d", __FUNCTION__, templateId);
881    Mutex::Autolock il(mInterfaceLock);
882    Mutex::Autolock l(mLock);
883
884    switch (mStatus) {
885        case STATUS_ERROR:
886            CLOGE("Device has encountered a serious error");
887            return INVALID_OPERATION;
888        case STATUS_UNINITIALIZED:
889            CLOGE("Device is not initialized!");
890            return INVALID_OPERATION;
891        case STATUS_UNCONFIGURED:
892        case STATUS_CONFIGURED:
893        case STATUS_ACTIVE:
894            // OK
895            break;
896        default:
897            SET_ERR_L("Unexpected status: %d", mStatus);
898            return INVALID_OPERATION;
899    }
900
901    const camera_metadata_t *rawRequest;
902    ATRACE_BEGIN("camera3->construct_default_request_settings");
903    rawRequest = mHal3Device->ops->construct_default_request_settings(
904        mHal3Device, templateId);
905    ATRACE_END();
906    if (rawRequest == NULL) {
907        SET_ERR_L("HAL is unable to construct default settings for template %d",
908                templateId);
909        return DEAD_OBJECT;
910    }
911    *request = rawRequest;
912
913    return OK;
914}
915
916status_t Camera3Device::waitUntilDrained() {
917    ATRACE_CALL();
918    Mutex::Autolock il(mInterfaceLock);
919    Mutex::Autolock l(mLock);
920
921    switch (mStatus) {
922        case STATUS_UNINITIALIZED:
923        case STATUS_UNCONFIGURED:
924            ALOGV("%s: Already idle", __FUNCTION__);
925            return OK;
926        case STATUS_CONFIGURED:
927            // To avoid race conditions, check with tracker to be sure
928        case STATUS_ERROR:
929        case STATUS_ACTIVE:
930            // Need to verify shut down
931            break;
932        default:
933            SET_ERR_L("Unexpected status: %d",mStatus);
934            return INVALID_OPERATION;
935    }
936
937    ALOGV("%s: Camera %d: Waiting until idle", __FUNCTION__, mId);
938    status_t res = waitUntilStateThenRelock(/*active*/ false, kShutdownTimeout);
939    return res;
940}
941
942// Pause to reconfigure
943status_t Camera3Device::internalPauseAndWaitLocked() {
944    mRequestThread->setPaused(true);
945    mPauseStateNotify = true;
946
947    ALOGV("%s: Camera %d: Internal wait until idle", __FUNCTION__, mId);
948    status_t res = waitUntilStateThenRelock(/*active*/ false, kShutdownTimeout);
949    if (res != OK) {
950        SET_ERR_L("Can't idle device in %f seconds!",
951                kShutdownTimeout/1e9);
952    }
953
954    return res;
955}
956
957// Resume after internalPauseAndWaitLocked
958status_t Camera3Device::internalResumeLocked() {
959    status_t res;
960
961    mRequestThread->setPaused(false);
962
963    res = waitUntilStateThenRelock(/*active*/ true, kActiveTimeout);
964    if (res != OK) {
965        SET_ERR_L("Can't transition to active in %f seconds!",
966                kActiveTimeout/1e9);
967    }
968    mPauseStateNotify = false;
969    return OK;
970}
971
972status_t Camera3Device::waitUntilStateThenRelock(bool active,
973        nsecs_t timeout) {
974    status_t res = OK;
975    if (active == (mStatus == STATUS_ACTIVE)) {
976        // Desired state already reached
977        return res;
978    }
979
980    bool stateSeen = false;
981    do {
982        mRecentStatusUpdates.clear();
983
984        res = mStatusChanged.waitRelative(mLock, timeout);
985        if (res != OK) break;
986
987        // Check state change history during wait
988        for (size_t i = 0; i < mRecentStatusUpdates.size(); i++) {
989            if (active == (mRecentStatusUpdates[i] == STATUS_ACTIVE) ) {
990                stateSeen = true;
991                break;
992            }
993        }
994    } while (!stateSeen);
995
996    return res;
997}
998
999
1000status_t Camera3Device::setNotifyCallback(NotificationListener *listener) {
1001    ATRACE_CALL();
1002    Mutex::Autolock l(mOutputLock);
1003
1004    if (listener != NULL && mListener != NULL) {
1005        ALOGW("%s: Replacing old callback listener", __FUNCTION__);
1006    }
1007    mListener = listener;
1008
1009    return OK;
1010}
1011
1012bool Camera3Device::willNotify3A() {
1013    return false;
1014}
1015
1016status_t Camera3Device::waitForNextFrame(nsecs_t timeout) {
1017    status_t res;
1018    Mutex::Autolock l(mOutputLock);
1019
1020    while (mResultQueue.empty()) {
1021        res = mResultSignal.waitRelative(mOutputLock, timeout);
1022        if (res == TIMED_OUT) {
1023            return res;
1024        } else if (res != OK) {
1025            ALOGW("%s: Camera %d: No frame in %lld ns: %s (%d)",
1026                    __FUNCTION__, mId, timeout, strerror(-res), res);
1027            return res;
1028        }
1029    }
1030    return OK;
1031}
1032
1033status_t Camera3Device::getNextFrame(CameraMetadata *frame) {
1034    ATRACE_CALL();
1035    Mutex::Autolock l(mOutputLock);
1036
1037    if (mResultQueue.empty()) {
1038        return NOT_ENOUGH_DATA;
1039    }
1040
1041    CameraMetadata &result = *(mResultQueue.begin());
1042    frame->acquire(result);
1043    mResultQueue.erase(mResultQueue.begin());
1044
1045    return OK;
1046}
1047
1048status_t Camera3Device::triggerAutofocus(uint32_t id) {
1049    ATRACE_CALL();
1050    Mutex::Autolock il(mInterfaceLock);
1051
1052    ALOGV("%s: Triggering autofocus, id %d", __FUNCTION__, id);
1053    // Mix-in this trigger into the next request and only the next request.
1054    RequestTrigger trigger[] = {
1055        {
1056            ANDROID_CONTROL_AF_TRIGGER,
1057            ANDROID_CONTROL_AF_TRIGGER_START
1058        },
1059        {
1060            ANDROID_CONTROL_AF_TRIGGER_ID,
1061            static_cast<int32_t>(id)
1062        },
1063    };
1064
1065    return mRequestThread->queueTrigger(trigger,
1066                                        sizeof(trigger)/sizeof(trigger[0]));
1067}
1068
1069status_t Camera3Device::triggerCancelAutofocus(uint32_t id) {
1070    ATRACE_CALL();
1071    Mutex::Autolock il(mInterfaceLock);
1072
1073    ALOGV("%s: Triggering cancel autofocus, id %d", __FUNCTION__, id);
1074    // Mix-in this trigger into the next request and only the next request.
1075    RequestTrigger trigger[] = {
1076        {
1077            ANDROID_CONTROL_AF_TRIGGER,
1078            ANDROID_CONTROL_AF_TRIGGER_CANCEL
1079        },
1080        {
1081            ANDROID_CONTROL_AF_TRIGGER_ID,
1082            static_cast<int32_t>(id)
1083        },
1084    };
1085
1086    return mRequestThread->queueTrigger(trigger,
1087                                        sizeof(trigger)/sizeof(trigger[0]));
1088}
1089
1090status_t Camera3Device::triggerPrecaptureMetering(uint32_t id) {
1091    ATRACE_CALL();
1092    Mutex::Autolock il(mInterfaceLock);
1093
1094    ALOGV("%s: Triggering precapture metering, id %d", __FUNCTION__, id);
1095    // Mix-in this trigger into the next request and only the next request.
1096    RequestTrigger trigger[] = {
1097        {
1098            ANDROID_CONTROL_AE_PRECAPTURE_TRIGGER,
1099            ANDROID_CONTROL_AE_PRECAPTURE_TRIGGER_START
1100        },
1101        {
1102            ANDROID_CONTROL_AE_PRECAPTURE_ID,
1103            static_cast<int32_t>(id)
1104        },
1105    };
1106
1107    return mRequestThread->queueTrigger(trigger,
1108                                        sizeof(trigger)/sizeof(trigger[0]));
1109}
1110
1111status_t Camera3Device::pushReprocessBuffer(int reprocessStreamId,
1112        buffer_handle_t *buffer, wp<BufferReleasedListener> listener) {
1113    ATRACE_CALL();
1114    (void)reprocessStreamId; (void)buffer; (void)listener;
1115
1116    CLOGE("Unimplemented");
1117    return INVALID_OPERATION;
1118}
1119
1120status_t Camera3Device::flush() {
1121    ATRACE_CALL();
1122    ALOGV("%s: Camera %d: Flushing all requests", __FUNCTION__, mId);
1123    Mutex::Autolock il(mInterfaceLock);
1124    Mutex::Autolock l(mLock);
1125
1126    mRequestThread->clear();
1127    status_t res;
1128    if (mHal3Device->common.version >= CAMERA_DEVICE_API_VERSION_3_1) {
1129        res = mHal3Device->ops->flush(mHal3Device);
1130    } else {
1131        res = waitUntilDrained();
1132    }
1133
1134    return res;
1135}
1136
1137/**
1138 * Methods called by subclasses
1139 */
1140
1141void Camera3Device::notifyStatus(bool idle) {
1142    {
1143        // Need mLock to safely update state and synchronize to current
1144        // state of methods in flight.
1145        Mutex::Autolock l(mLock);
1146        // We can get various system-idle notices from the status tracker
1147        // while starting up. Only care about them if we've actually sent
1148        // in some requests recently.
1149        if (mStatus != STATUS_ACTIVE && mStatus != STATUS_CONFIGURED) {
1150            return;
1151        }
1152        ALOGV("%s: Camera %d: Now %s", __FUNCTION__, mId,
1153                idle ? "idle" : "active");
1154        mStatus = idle ? STATUS_CONFIGURED : STATUS_ACTIVE;
1155        mRecentStatusUpdates.add(mStatus);
1156        mStatusChanged.signal();
1157
1158        // Skip notifying listener if we're doing some user-transparent
1159        // state changes
1160        if (mPauseStateNotify) return;
1161    }
1162    NotificationListener *listener;
1163    {
1164        Mutex::Autolock l(mOutputLock);
1165        listener = mListener;
1166    }
1167    if (idle && listener != NULL) {
1168        listener->notifyIdle();
1169    }
1170}
1171
1172/**
1173 * Camera3Device private methods
1174 */
1175
1176sp<Camera3Device::CaptureRequest> Camera3Device::createCaptureRequest(
1177        const CameraMetadata &request) {
1178    ATRACE_CALL();
1179    status_t res;
1180
1181    sp<CaptureRequest> newRequest = new CaptureRequest;
1182    newRequest->mSettings = request;
1183
1184    camera_metadata_entry_t inputStreams =
1185            newRequest->mSettings.find(ANDROID_REQUEST_INPUT_STREAMS);
1186    if (inputStreams.count > 0) {
1187        if (mInputStream == NULL ||
1188                mInputStream->getId() != inputStreams.data.i32[0]) {
1189            CLOGE("Request references unknown input stream %d",
1190                    inputStreams.data.u8[0]);
1191            return NULL;
1192        }
1193        // Lazy completion of stream configuration (allocation/registration)
1194        // on first use
1195        if (mInputStream->isConfiguring()) {
1196            res = mInputStream->finishConfiguration(mHal3Device);
1197            if (res != OK) {
1198                SET_ERR_L("Unable to finish configuring input stream %d:"
1199                        " %s (%d)",
1200                        mInputStream->getId(), strerror(-res), res);
1201                return NULL;
1202            }
1203        }
1204
1205        newRequest->mInputStream = mInputStream;
1206        newRequest->mSettings.erase(ANDROID_REQUEST_INPUT_STREAMS);
1207    }
1208
1209    camera_metadata_entry_t streams =
1210            newRequest->mSettings.find(ANDROID_REQUEST_OUTPUT_STREAMS);
1211    if (streams.count == 0) {
1212        CLOGE("Zero output streams specified!");
1213        return NULL;
1214    }
1215
1216    for (size_t i = 0; i < streams.count; i++) {
1217        int idx = mOutputStreams.indexOfKey(streams.data.i32[i]);
1218        if (idx == NAME_NOT_FOUND) {
1219            CLOGE("Request references unknown stream %d",
1220                    streams.data.u8[i]);
1221            return NULL;
1222        }
1223        sp<Camera3OutputStreamInterface> stream =
1224                mOutputStreams.editValueAt(idx);
1225
1226        // Lazy completion of stream configuration (allocation/registration)
1227        // on first use
1228        if (stream->isConfiguring()) {
1229            res = stream->finishConfiguration(mHal3Device);
1230            if (res != OK) {
1231                SET_ERR_L("Unable to finish configuring stream %d: %s (%d)",
1232                        stream->getId(), strerror(-res), res);
1233                return NULL;
1234            }
1235        }
1236
1237        newRequest->mOutputStreams.push(stream);
1238    }
1239    newRequest->mSettings.erase(ANDROID_REQUEST_OUTPUT_STREAMS);
1240
1241    return newRequest;
1242}
1243
1244status_t Camera3Device::configureStreamsLocked() {
1245    ATRACE_CALL();
1246    status_t res;
1247
1248    if (mStatus != STATUS_UNCONFIGURED && mStatus != STATUS_CONFIGURED) {
1249        CLOGE("Not idle");
1250        return INVALID_OPERATION;
1251    }
1252
1253    if (!mNeedConfig) {
1254        ALOGV("%s: Skipping config, no stream changes", __FUNCTION__);
1255        return OK;
1256    }
1257
1258    // Start configuring the streams
1259    ALOGV("%s: Camera %d: Starting stream configuration", __FUNCTION__, mId);
1260
1261    camera3_stream_configuration config;
1262
1263    config.num_streams = (mInputStream != NULL) + mOutputStreams.size();
1264
1265    Vector<camera3_stream_t*> streams;
1266    streams.setCapacity(config.num_streams);
1267
1268    if (mInputStream != NULL) {
1269        camera3_stream_t *inputStream;
1270        inputStream = mInputStream->startConfiguration();
1271        if (inputStream == NULL) {
1272            SET_ERR_L("Can't start input stream configuration");
1273            return INVALID_OPERATION;
1274        }
1275        streams.add(inputStream);
1276    }
1277
1278    for (size_t i = 0; i < mOutputStreams.size(); i++) {
1279
1280        // Don't configure bidi streams twice, nor add them twice to the list
1281        if (mOutputStreams[i].get() ==
1282            static_cast<Camera3StreamInterface*>(mInputStream.get())) {
1283
1284            config.num_streams--;
1285            continue;
1286        }
1287
1288        camera3_stream_t *outputStream;
1289        outputStream = mOutputStreams.editValueAt(i)->startConfiguration();
1290        if (outputStream == NULL) {
1291            SET_ERR_L("Can't start output stream configuration");
1292            return INVALID_OPERATION;
1293        }
1294        streams.add(outputStream);
1295    }
1296
1297    config.streams = streams.editArray();
1298
1299    // Do the HAL configuration; will potentially touch stream
1300    // max_buffers, usage, priv fields.
1301    ATRACE_BEGIN("camera3->configure_streams");
1302    res = mHal3Device->ops->configure_streams(mHal3Device, &config);
1303    ATRACE_END();
1304
1305    if (res != OK) {
1306        SET_ERR_L("Unable to configure streams with HAL: %s (%d)",
1307                strerror(-res), res);
1308        return res;
1309    }
1310
1311    // Finish all stream configuration immediately.
1312    // TODO: Try to relax this later back to lazy completion, which should be
1313    // faster
1314
1315    if (mInputStream != NULL && mInputStream->isConfiguring()) {
1316        res = mInputStream->finishConfiguration(mHal3Device);
1317        if (res != OK) {
1318            SET_ERR_L("Can't finish configuring input stream %d: %s (%d)",
1319                    mInputStream->getId(), strerror(-res), res);
1320            return res;
1321        }
1322    }
1323
1324    for (size_t i = 0; i < mOutputStreams.size(); i++) {
1325        sp<Camera3OutputStreamInterface> outputStream =
1326            mOutputStreams.editValueAt(i);
1327        if (outputStream->isConfiguring()) {
1328            res = outputStream->finishConfiguration(mHal3Device);
1329            if (res != OK) {
1330                SET_ERR_L("Can't finish configuring output stream %d: %s (%d)",
1331                        outputStream->getId(), strerror(-res), res);
1332                return res;
1333            }
1334        }
1335    }
1336
1337    // Request thread needs to know to avoid using repeat-last-settings protocol
1338    // across configure_streams() calls
1339    mRequestThread->configurationComplete();
1340
1341    // Update device state
1342
1343    mNeedConfig = false;
1344
1345    if (config.num_streams > 0) {
1346        mStatus = STATUS_CONFIGURED;
1347    } else {
1348        mStatus = STATUS_UNCONFIGURED;
1349    }
1350
1351    ALOGV("%s: Camera %d: Stream configuration complete", __FUNCTION__, mId);
1352
1353    return OK;
1354}
1355
1356void Camera3Device::setErrorState(const char *fmt, ...) {
1357    Mutex::Autolock l(mLock);
1358    va_list args;
1359    va_start(args, fmt);
1360
1361    setErrorStateLockedV(fmt, args);
1362
1363    va_end(args);
1364}
1365
1366void Camera3Device::setErrorStateV(const char *fmt, va_list args) {
1367    Mutex::Autolock l(mLock);
1368    setErrorStateLockedV(fmt, args);
1369}
1370
1371void Camera3Device::setErrorStateLocked(const char *fmt, ...) {
1372    va_list args;
1373    va_start(args, fmt);
1374
1375    setErrorStateLockedV(fmt, args);
1376
1377    va_end(args);
1378}
1379
1380void Camera3Device::setErrorStateLockedV(const char *fmt, va_list args) {
1381    // Print out all error messages to log
1382    String8 errorCause = String8::formatV(fmt, args);
1383    ALOGE("Camera %d: %s", mId, errorCause.string());
1384
1385    // But only do error state transition steps for the first error
1386    if (mStatus == STATUS_ERROR || mStatus == STATUS_UNINITIALIZED) return;
1387
1388    // Save stack trace. View by dumping it later.
1389    CameraTraces::saveTrace();
1390    // TODO: consider adding errorCause and client pid/procname
1391
1392    mErrorCause = errorCause;
1393
1394    mRequestThread->setPaused(true);
1395    mStatus = STATUS_ERROR;
1396}
1397
1398/**
1399 * In-flight request management
1400 */
1401
1402status_t Camera3Device::registerInFlight(int32_t frameNumber,
1403        int32_t requestId, int32_t numBuffers) {
1404    ATRACE_CALL();
1405    Mutex::Autolock l(mInFlightLock);
1406
1407    ssize_t res;
1408    res = mInFlightMap.add(frameNumber, InFlightRequest(requestId, numBuffers));
1409    if (res < 0) return res;
1410
1411    return OK;
1412}
1413
1414/**
1415 * QUIRK(partial results)
1416 * Check if all 3A fields are ready, and send off a partial 3A-only result
1417 * to the output frame queue
1418 */
1419bool Camera3Device::processPartial3AQuirk(
1420        int32_t frameNumber, int32_t requestId,
1421        const CameraMetadata& partial) {
1422
1423    // Check if all 3A states are present
1424    // The full list of fields is
1425    //   android.control.afMode
1426    //   android.control.awbMode
1427    //   android.control.aeState
1428    //   android.control.awbState
1429    //   android.control.afState
1430    //   android.control.afTriggerID
1431    //   android.control.aePrecaptureID
1432    // TODO: Add android.control.aeMode
1433
1434    bool gotAllStates = true;
1435
1436    uint8_t afMode;
1437    uint8_t awbMode;
1438    uint8_t aeState;
1439    uint8_t afState;
1440    uint8_t awbState;
1441    int32_t afTriggerId;
1442    int32_t aeTriggerId;
1443
1444    gotAllStates &= get3AResult(partial, ANDROID_CONTROL_AF_MODE,
1445        &afMode, frameNumber);
1446
1447    gotAllStates &= get3AResult(partial, ANDROID_CONTROL_AWB_MODE,
1448        &awbMode, frameNumber);
1449
1450    gotAllStates &= get3AResult(partial, ANDROID_CONTROL_AE_STATE,
1451        &aeState, frameNumber);
1452
1453    gotAllStates &= get3AResult(partial, ANDROID_CONTROL_AF_STATE,
1454        &afState, frameNumber);
1455
1456    gotAllStates &= get3AResult(partial, ANDROID_CONTROL_AWB_STATE,
1457        &awbState, frameNumber);
1458
1459    gotAllStates &= get3AResult(partial, ANDROID_CONTROL_AF_TRIGGER_ID,
1460        &afTriggerId, frameNumber);
1461
1462    gotAllStates &= get3AResult(partial, ANDROID_CONTROL_AE_PRECAPTURE_ID,
1463        &aeTriggerId, frameNumber);
1464
1465    if (!gotAllStates) return false;
1466
1467    ALOGVV("%s: Camera %d: Frame %d, Request ID %d: AF mode %d, AWB mode %d, "
1468        "AF state %d, AE state %d, AWB state %d, "
1469        "AF trigger %d, AE precapture trigger %d",
1470        __FUNCTION__, mId, frameNumber, requestId,
1471        afMode, awbMode,
1472        afState, aeState, awbState,
1473        afTriggerId, aeTriggerId);
1474
1475    // Got all states, so construct a minimal result to send
1476    // In addition to the above fields, this means adding in
1477    //   android.request.frameCount
1478    //   android.request.requestId
1479    //   android.quirks.partialResult
1480
1481    const size_t kMinimal3AResultEntries = 10;
1482
1483    Mutex::Autolock l(mOutputLock);
1484
1485    CameraMetadata& min3AResult =
1486            *mResultQueue.insert(
1487                mResultQueue.end(),
1488                CameraMetadata(kMinimal3AResultEntries, /*dataCapacity*/ 0));
1489
1490    if (!insert3AResult(min3AResult, ANDROID_REQUEST_FRAME_COUNT,
1491            &frameNumber, frameNumber)) {
1492        return false;
1493    }
1494
1495    if (!insert3AResult(min3AResult, ANDROID_REQUEST_ID,
1496            &requestId, frameNumber)) {
1497        return false;
1498    }
1499
1500    static const uint8_t partialResult = ANDROID_QUIRKS_PARTIAL_RESULT_PARTIAL;
1501    if (!insert3AResult(min3AResult, ANDROID_QUIRKS_PARTIAL_RESULT,
1502            &partialResult, frameNumber)) {
1503        return false;
1504    }
1505
1506    if (!insert3AResult(min3AResult, ANDROID_CONTROL_AF_MODE,
1507            &afMode, frameNumber)) {
1508        return false;
1509    }
1510
1511    if (!insert3AResult(min3AResult, ANDROID_CONTROL_AWB_MODE,
1512            &awbMode, frameNumber)) {
1513        return false;
1514    }
1515
1516    if (!insert3AResult(min3AResult, ANDROID_CONTROL_AE_STATE,
1517            &aeState, frameNumber)) {
1518        return false;
1519    }
1520
1521    if (!insert3AResult(min3AResult, ANDROID_CONTROL_AF_STATE,
1522            &afState, frameNumber)) {
1523        return false;
1524    }
1525
1526    if (!insert3AResult(min3AResult, ANDROID_CONTROL_AWB_STATE,
1527            &awbState, frameNumber)) {
1528        return false;
1529    }
1530
1531    if (!insert3AResult(min3AResult, ANDROID_CONTROL_AF_TRIGGER_ID,
1532            &afTriggerId, frameNumber)) {
1533        return false;
1534    }
1535
1536    if (!insert3AResult(min3AResult, ANDROID_CONTROL_AE_PRECAPTURE_ID,
1537            &aeTriggerId, frameNumber)) {
1538        return false;
1539    }
1540
1541    mResultSignal.signal();
1542
1543    return true;
1544}
1545
1546template<typename T>
1547bool Camera3Device::get3AResult(const CameraMetadata& result, int32_t tag,
1548        T* value, int32_t frameNumber) {
1549    (void) frameNumber;
1550
1551    camera_metadata_ro_entry_t entry;
1552
1553    entry = result.find(tag);
1554    if (entry.count == 0) {
1555        ALOGVV("%s: Camera %d: Frame %d: No %s provided by HAL!", __FUNCTION__,
1556            mId, frameNumber, get_camera_metadata_tag_name(tag));
1557        return false;
1558    }
1559
1560    if (sizeof(T) == sizeof(uint8_t)) {
1561        *value = entry.data.u8[0];
1562    } else if (sizeof(T) == sizeof(int32_t)) {
1563        *value = entry.data.i32[0];
1564    } else {
1565        ALOGE("%s: Unexpected type", __FUNCTION__);
1566        return false;
1567    }
1568    return true;
1569}
1570
1571template<typename T>
1572bool Camera3Device::insert3AResult(CameraMetadata& result, int32_t tag,
1573        const T* value, int32_t frameNumber) {
1574    if (result.update(tag, value, 1) != NO_ERROR) {
1575        mResultQueue.erase(--mResultQueue.end(), mResultQueue.end());
1576        SET_ERR("Frame %d: Failed to set %s in partial metadata",
1577                frameNumber, get_camera_metadata_tag_name(tag));
1578        return false;
1579    }
1580    return true;
1581}
1582
1583/**
1584 * Camera HAL device callback methods
1585 */
1586
1587void Camera3Device::processCaptureResult(const camera3_capture_result *result) {
1588    ATRACE_CALL();
1589
1590    status_t res;
1591
1592    uint32_t frameNumber = result->frame_number;
1593    if (result->result == NULL && result->num_output_buffers == 0) {
1594        SET_ERR("No result data provided by HAL for frame %d",
1595                frameNumber);
1596        return;
1597    }
1598    bool partialResultQuirk = false;
1599    CameraMetadata collectedQuirkResult;
1600
1601    // Get capture timestamp from list of in-flight requests, where it was added
1602    // by the shutter notification for this frame. Then update the in-flight
1603    // status and remove the in-flight entry if all result data has been
1604    // received.
1605    nsecs_t timestamp = 0;
1606    {
1607        Mutex::Autolock l(mInFlightLock);
1608        ssize_t idx = mInFlightMap.indexOfKey(frameNumber);
1609        if (idx == NAME_NOT_FOUND) {
1610            SET_ERR("Unknown frame number for capture result: %d",
1611                    frameNumber);
1612            return;
1613        }
1614        InFlightRequest &request = mInFlightMap.editValueAt(idx);
1615
1616        // Check if this result carries only partial metadata
1617        if (mUsePartialResultQuirk && result->result != NULL) {
1618            camera_metadata_ro_entry_t partialResultEntry;
1619            res = find_camera_metadata_ro_entry(result->result,
1620                    ANDROID_QUIRKS_PARTIAL_RESULT, &partialResultEntry);
1621            if (res != NAME_NOT_FOUND &&
1622                    partialResultEntry.count > 0 &&
1623                    partialResultEntry.data.u8[0] ==
1624                    ANDROID_QUIRKS_PARTIAL_RESULT_PARTIAL) {
1625                // A partial result. Flag this as such, and collect this
1626                // set of metadata into the in-flight entry.
1627                partialResultQuirk = true;
1628                request.partialResultQuirk.collectedResult.append(
1629                    result->result);
1630                request.partialResultQuirk.collectedResult.erase(
1631                    ANDROID_QUIRKS_PARTIAL_RESULT);
1632                // Fire off a 3A-only result if possible
1633                if (!request.partialResultQuirk.haveSent3A) {
1634                    request.partialResultQuirk.haveSent3A =
1635                            processPartial3AQuirk(frameNumber,
1636                                    request.requestId,
1637                                    request.partialResultQuirk.collectedResult);
1638                }
1639            }
1640        }
1641
1642        timestamp = request.captureTimestamp;
1643        /**
1644         * One of the following must happen before it's legal to call process_capture_result,
1645         * unless partial metadata is being provided:
1646         * - CAMERA3_MSG_SHUTTER (expected during normal operation)
1647         * - CAMERA3_MSG_ERROR (expected during flush)
1648         */
1649        if (request.requestStatus == OK && timestamp == 0 && !partialResultQuirk) {
1650            SET_ERR("Called before shutter notify for frame %d",
1651                    frameNumber);
1652            return;
1653        }
1654
1655        // Did we get the (final) result metadata for this capture?
1656        if (result->result != NULL && !partialResultQuirk) {
1657            if (request.haveResultMetadata) {
1658                SET_ERR("Called multiple times with metadata for frame %d",
1659                        frameNumber);
1660                return;
1661            }
1662            if (mUsePartialResultQuirk &&
1663                    !request.partialResultQuirk.collectedResult.isEmpty()) {
1664                collectedQuirkResult.acquire(
1665                    request.partialResultQuirk.collectedResult);
1666            }
1667            request.haveResultMetadata = true;
1668        }
1669
1670        request.numBuffersLeft -= result->num_output_buffers;
1671
1672        if (request.numBuffersLeft < 0) {
1673            SET_ERR("Too many buffers returned for frame %d",
1674                    frameNumber);
1675            return;
1676        }
1677
1678        // Check if everything has arrived for this result (buffers and metadata), remove it from
1679        // InFlightMap if both arrived or HAL reports error for this request (i.e. during flush).
1680        if ((request.requestStatus != OK) ||
1681                (request.haveResultMetadata && request.numBuffersLeft == 0)) {
1682            ATRACE_ASYNC_END("frame capture", frameNumber);
1683            mInFlightMap.removeItemsAt(idx, 1);
1684        }
1685
1686        // Sanity check - if we have too many in-flight frames, something has
1687        // likely gone wrong
1688        if (mInFlightMap.size() > kInFlightWarnLimit) {
1689            CLOGE("In-flight list too large: %d", mInFlightMap.size());
1690        }
1691
1692    }
1693
1694    // Process the result metadata, if provided
1695    bool gotResult = false;
1696    if (result->result != NULL && !partialResultQuirk) {
1697        Mutex::Autolock l(mOutputLock);
1698
1699        gotResult = true;
1700
1701        if (frameNumber != mNextResultFrameNumber) {
1702            SET_ERR("Out-of-order capture result metadata submitted! "
1703                    "(got frame number %d, expecting %d)",
1704                    frameNumber, mNextResultFrameNumber);
1705            return;
1706        }
1707        mNextResultFrameNumber++;
1708
1709        CameraMetadata captureResult;
1710        captureResult = result->result;
1711
1712        if (captureResult.update(ANDROID_REQUEST_FRAME_COUNT,
1713                        (int32_t*)&frameNumber, 1) != OK) {
1714            SET_ERR("Failed to set frame# in metadata (%d)",
1715                    frameNumber);
1716            gotResult = false;
1717        } else {
1718            ALOGVV("%s: Camera %d: Set frame# in metadata (%d)",
1719                    __FUNCTION__, mId, frameNumber);
1720        }
1721
1722        // Append any previous partials to form a complete result
1723        if (mUsePartialResultQuirk && !collectedQuirkResult.isEmpty()) {
1724            captureResult.append(collectedQuirkResult);
1725        }
1726
1727        captureResult.sort();
1728
1729        // Check that there's a timestamp in the result metadata
1730
1731        camera_metadata_entry entry =
1732                captureResult.find(ANDROID_SENSOR_TIMESTAMP);
1733        if (entry.count == 0) {
1734            SET_ERR("No timestamp provided by HAL for frame %d!",
1735                    frameNumber);
1736            gotResult = false;
1737        } else if (timestamp != entry.data.i64[0]) {
1738            SET_ERR("Timestamp mismatch between shutter notify and result"
1739                    " metadata for frame %d (%lld vs %lld respectively)",
1740                    frameNumber, timestamp, entry.data.i64[0]);
1741            gotResult = false;
1742        }
1743
1744        if (gotResult) {
1745            // Valid result, insert into queue
1746            CameraMetadata& queuedResult =
1747                *mResultQueue.insert(mResultQueue.end(), CameraMetadata());
1748            queuedResult.swap(captureResult);
1749        }
1750    } // scope for mOutputLock
1751
1752    // Return completed buffers to their streams with the timestamp
1753
1754    for (size_t i = 0; i < result->num_output_buffers; i++) {
1755        Camera3Stream *stream =
1756                Camera3Stream::cast(result->output_buffers[i].stream);
1757        res = stream->returnBuffer(result->output_buffers[i], timestamp);
1758        // Note: stream may be deallocated at this point, if this buffer was the
1759        // last reference to it.
1760        if (res != OK) {
1761            ALOGE("Can't return buffer %d for frame %d to its stream: "
1762                    " %s (%d)", i, frameNumber, strerror(-res), res);
1763        }
1764    }
1765
1766    // Finally, signal any waiters for new frames
1767
1768    if (gotResult) {
1769        mResultSignal.signal();
1770    }
1771
1772}
1773
1774
1775
1776void Camera3Device::notify(const camera3_notify_msg *msg) {
1777    ATRACE_CALL();
1778    NotificationListener *listener;
1779    {
1780        Mutex::Autolock l(mOutputLock);
1781        listener = mListener;
1782    }
1783
1784    if (msg == NULL) {
1785        SET_ERR("HAL sent NULL notify message!");
1786        return;
1787    }
1788
1789    switch (msg->type) {
1790        case CAMERA3_MSG_ERROR: {
1791            int streamId = 0;
1792            if (msg->message.error.error_stream != NULL) {
1793                Camera3Stream *stream =
1794                        Camera3Stream::cast(
1795                                  msg->message.error.error_stream);
1796                streamId = stream->getId();
1797            }
1798            ALOGV("Camera %d: %s: HAL error, frame %d, stream %d: %d",
1799                    mId, __FUNCTION__, msg->message.error.frame_number,
1800                    streamId, msg->message.error.error_code);
1801
1802            // Set request error status for the request in the in-flight tracking
1803            {
1804                Mutex::Autolock l(mInFlightLock);
1805                ssize_t idx = mInFlightMap.indexOfKey(msg->message.error.frame_number);
1806                if (idx >= 0) {
1807                    mInFlightMap.editValueAt(idx).requestStatus = msg->message.error.error_code;
1808                }
1809            }
1810
1811            if (listener != NULL) {
1812                listener->notifyError(msg->message.error.error_code,
1813                        msg->message.error.frame_number, streamId);
1814            }
1815            break;
1816        }
1817        case CAMERA3_MSG_SHUTTER: {
1818            ssize_t idx;
1819            uint32_t frameNumber = msg->message.shutter.frame_number;
1820            nsecs_t timestamp = msg->message.shutter.timestamp;
1821            // Verify ordering of shutter notifications
1822            {
1823                Mutex::Autolock l(mOutputLock);
1824                if (frameNumber != mNextShutterFrameNumber) {
1825                    SET_ERR("Shutter notification out-of-order. Expected "
1826                            "notification for frame %d, got frame %d",
1827                            mNextShutterFrameNumber, frameNumber);
1828                    break;
1829                }
1830                mNextShutterFrameNumber++;
1831            }
1832
1833            int32_t requestId = -1;
1834
1835            // Set timestamp for the request in the in-flight tracking
1836            // and get the request ID to send upstream
1837            {
1838                Mutex::Autolock l(mInFlightLock);
1839                idx = mInFlightMap.indexOfKey(frameNumber);
1840                if (idx >= 0) {
1841                    InFlightRequest &r = mInFlightMap.editValueAt(idx);
1842                    r.captureTimestamp = timestamp;
1843                    requestId = r.requestId;
1844                }
1845            }
1846            if (idx < 0) {
1847                SET_ERR("Shutter notification for non-existent frame number %d",
1848                        frameNumber);
1849                break;
1850            }
1851            ALOGVV("Camera %d: %s: Shutter fired for frame %d (id %d) at %lld",
1852                    mId, __FUNCTION__, frameNumber, requestId, timestamp);
1853            // Call listener, if any
1854            if (listener != NULL) {
1855                listener->notifyShutter(requestId, timestamp);
1856            }
1857            break;
1858        }
1859        default:
1860            SET_ERR("Unknown notify message from HAL: %d",
1861                    msg->type);
1862    }
1863}
1864
1865CameraMetadata Camera3Device::getLatestRequestLocked() {
1866    ALOGV("%s", __FUNCTION__);
1867
1868    CameraMetadata retVal;
1869
1870    if (mRequestThread != NULL) {
1871        retVal = mRequestThread->getLatestRequest();
1872    }
1873
1874    return retVal;
1875}
1876
1877/**
1878 * RequestThread inner class methods
1879 */
1880
1881Camera3Device::RequestThread::RequestThread(wp<Camera3Device> parent,
1882        sp<StatusTracker> statusTracker,
1883        camera3_device_t *hal3Device) :
1884        Thread(false),
1885        mParent(parent),
1886        mStatusTracker(statusTracker),
1887        mHal3Device(hal3Device),
1888        mId(getId(parent)),
1889        mReconfigured(false),
1890        mDoPause(false),
1891        mPaused(true),
1892        mFrameNumber(0),
1893        mLatestRequestId(NAME_NOT_FOUND) {
1894    mStatusId = statusTracker->addComponent();
1895}
1896
1897void Camera3Device::RequestThread::configurationComplete() {
1898    Mutex::Autolock l(mRequestLock);
1899    mReconfigured = true;
1900}
1901
1902status_t Camera3Device::RequestThread::queueRequest(
1903         sp<CaptureRequest> request) {
1904    Mutex::Autolock l(mRequestLock);
1905    mRequestQueue.push_back(request);
1906
1907    unpauseForNewRequests();
1908
1909    return OK;
1910}
1911
1912
1913status_t Camera3Device::RequestThread::queueTrigger(
1914        RequestTrigger trigger[],
1915        size_t count) {
1916
1917    Mutex::Autolock l(mTriggerMutex);
1918    status_t ret;
1919
1920    for (size_t i = 0; i < count; ++i) {
1921        ret = queueTriggerLocked(trigger[i]);
1922
1923        if (ret != OK) {
1924            return ret;
1925        }
1926    }
1927
1928    return OK;
1929}
1930
1931int Camera3Device::RequestThread::getId(const wp<Camera3Device> &device) {
1932    sp<Camera3Device> d = device.promote();
1933    if (d != NULL) return d->mId;
1934    return 0;
1935}
1936
1937status_t Camera3Device::RequestThread::queueTriggerLocked(
1938        RequestTrigger trigger) {
1939
1940    uint32_t tag = trigger.metadataTag;
1941    ssize_t index = mTriggerMap.indexOfKey(tag);
1942
1943    switch (trigger.getTagType()) {
1944        case TYPE_BYTE:
1945        // fall-through
1946        case TYPE_INT32:
1947            break;
1948        default:
1949            ALOGE("%s: Type not supported: 0x%x", __FUNCTION__,
1950                    trigger.getTagType());
1951            return INVALID_OPERATION;
1952    }
1953
1954    /**
1955     * Collect only the latest trigger, since we only have 1 field
1956     * in the request settings per trigger tag, and can't send more than 1
1957     * trigger per request.
1958     */
1959    if (index != NAME_NOT_FOUND) {
1960        mTriggerMap.editValueAt(index) = trigger;
1961    } else {
1962        mTriggerMap.add(tag, trigger);
1963    }
1964
1965    return OK;
1966}
1967
1968status_t Camera3Device::RequestThread::setRepeatingRequests(
1969        const RequestList &requests) {
1970    Mutex::Autolock l(mRequestLock);
1971    mRepeatingRequests.clear();
1972    mRepeatingRequests.insert(mRepeatingRequests.begin(),
1973            requests.begin(), requests.end());
1974
1975    unpauseForNewRequests();
1976
1977    return OK;
1978}
1979
1980status_t Camera3Device::RequestThread::clearRepeatingRequests() {
1981    Mutex::Autolock l(mRequestLock);
1982    mRepeatingRequests.clear();
1983    return OK;
1984}
1985
1986status_t Camera3Device::RequestThread::clear() {
1987    Mutex::Autolock l(mRequestLock);
1988    mRepeatingRequests.clear();
1989    mRequestQueue.clear();
1990    mTriggerMap.clear();
1991    return OK;
1992}
1993
1994void Camera3Device::RequestThread::setPaused(bool paused) {
1995    Mutex::Autolock l(mPauseLock);
1996    mDoPause = paused;
1997    mDoPauseSignal.signal();
1998}
1999
2000status_t Camera3Device::RequestThread::waitUntilRequestProcessed(
2001        int32_t requestId, nsecs_t timeout) {
2002    Mutex::Autolock l(mLatestRequestMutex);
2003    status_t res;
2004    while (mLatestRequestId != requestId) {
2005        nsecs_t startTime = systemTime();
2006
2007        res = mLatestRequestSignal.waitRelative(mLatestRequestMutex, timeout);
2008        if (res != OK) return res;
2009
2010        timeout -= (systemTime() - startTime);
2011    }
2012
2013    return OK;
2014}
2015
2016void Camera3Device::RequestThread::requestExit() {
2017    // Call parent to set up shutdown
2018    Thread::requestExit();
2019    // The exit from any possible waits
2020    mDoPauseSignal.signal();
2021    mRequestSignal.signal();
2022}
2023
2024bool Camera3Device::RequestThread::threadLoop() {
2025
2026    status_t res;
2027
2028    // Handle paused state.
2029    if (waitIfPaused()) {
2030        return true;
2031    }
2032
2033    // Get work to do
2034
2035    sp<CaptureRequest> nextRequest = waitForNextRequest();
2036    if (nextRequest == NULL) {
2037        return true;
2038    }
2039
2040    // Create request to HAL
2041    camera3_capture_request_t request = camera3_capture_request_t();
2042    Vector<camera3_stream_buffer_t> outputBuffers;
2043
2044    // Get the request ID, if any
2045    int requestId;
2046    camera_metadata_entry_t requestIdEntry =
2047            nextRequest->mSettings.find(ANDROID_REQUEST_ID);
2048    if (requestIdEntry.count > 0) {
2049        requestId = requestIdEntry.data.i32[0];
2050    } else {
2051        ALOGW("%s: Did not have android.request.id set in the request",
2052                __FUNCTION__);
2053        requestId = NAME_NOT_FOUND;
2054    }
2055
2056    // Insert any queued triggers (before metadata is locked)
2057    int32_t triggerCount;
2058    res = insertTriggers(nextRequest);
2059    if (res < 0) {
2060        SET_ERR("RequestThread: Unable to insert triggers "
2061                "(capture request %d, HAL device: %s (%d)",
2062                (mFrameNumber+1), strerror(-res), res);
2063        cleanUpFailedRequest(request, nextRequest, outputBuffers);
2064        return false;
2065    }
2066    triggerCount = res;
2067
2068    bool triggersMixedIn = (triggerCount > 0 || mPrevTriggers > 0);
2069
2070    // If the request is the same as last, or we had triggers last time
2071    if (mPrevRequest != nextRequest || triggersMixedIn) {
2072        /**
2073         * HAL workaround:
2074         * Insert a dummy trigger ID if a trigger is set but no trigger ID is
2075         */
2076        res = addDummyTriggerIds(nextRequest);
2077        if (res != OK) {
2078            SET_ERR("RequestThread: Unable to insert dummy trigger IDs "
2079                    "(capture request %d, HAL device: %s (%d)",
2080                    (mFrameNumber+1), strerror(-res), res);
2081            cleanUpFailedRequest(request, nextRequest, outputBuffers);
2082            return false;
2083        }
2084
2085        /**
2086         * The request should be presorted so accesses in HAL
2087         *   are O(logn). Sidenote, sorting a sorted metadata is nop.
2088         */
2089        nextRequest->mSettings.sort();
2090        request.settings = nextRequest->mSettings.getAndLock();
2091        mPrevRequest = nextRequest;
2092        ALOGVV("%s: Request settings are NEW", __FUNCTION__);
2093
2094        IF_ALOGV() {
2095            camera_metadata_ro_entry_t e = camera_metadata_ro_entry_t();
2096            find_camera_metadata_ro_entry(
2097                    request.settings,
2098                    ANDROID_CONTROL_AF_TRIGGER,
2099                    &e
2100            );
2101            if (e.count > 0) {
2102                ALOGV("%s: Request (frame num %d) had AF trigger 0x%x",
2103                      __FUNCTION__,
2104                      mFrameNumber+1,
2105                      e.data.u8[0]);
2106            }
2107        }
2108    } else {
2109        // leave request.settings NULL to indicate 'reuse latest given'
2110        ALOGVV("%s: Request settings are REUSED",
2111               __FUNCTION__);
2112    }
2113
2114    camera3_stream_buffer_t inputBuffer;
2115
2116    // Fill in buffers
2117
2118    if (nextRequest->mInputStream != NULL) {
2119        request.input_buffer = &inputBuffer;
2120        res = nextRequest->mInputStream->getInputBuffer(&inputBuffer);
2121        if (res != OK) {
2122            ALOGE("RequestThread: Can't get input buffer, skipping request:"
2123                    " %s (%d)", strerror(-res), res);
2124            cleanUpFailedRequest(request, nextRequest, outputBuffers);
2125            return true;
2126        }
2127    } else {
2128        request.input_buffer = NULL;
2129    }
2130
2131    outputBuffers.insertAt(camera3_stream_buffer_t(), 0,
2132            nextRequest->mOutputStreams.size());
2133    request.output_buffers = outputBuffers.array();
2134    for (size_t i = 0; i < nextRequest->mOutputStreams.size(); i++) {
2135        res = nextRequest->mOutputStreams.editItemAt(i)->
2136                getBuffer(&outputBuffers.editItemAt(i));
2137        if (res != OK) {
2138            ALOGE("RequestThread: Can't get output buffer, skipping request:"
2139                    " %s (%d)", strerror(-res), res);
2140            cleanUpFailedRequest(request, nextRequest, outputBuffers);
2141            return true;
2142        }
2143        request.num_output_buffers++;
2144    }
2145
2146    request.frame_number = mFrameNumber++;
2147
2148    // Log request in the in-flight queue
2149    sp<Camera3Device> parent = mParent.promote();
2150    if (parent == NULL) {
2151        CLOGE("RequestThread: Parent is gone");
2152        cleanUpFailedRequest(request, nextRequest, outputBuffers);
2153        return false;
2154    }
2155
2156    res = parent->registerInFlight(request.frame_number, requestId,
2157            request.num_output_buffers);
2158    if (res != OK) {
2159        SET_ERR("RequestThread: Unable to register new in-flight request:"
2160                " %s (%d)", strerror(-res), res);
2161        cleanUpFailedRequest(request, nextRequest, outputBuffers);
2162        return false;
2163    }
2164
2165    // Inform waitUntilRequestProcessed thread of a new request ID
2166    {
2167        Mutex::Autolock al(mLatestRequestMutex);
2168
2169        mLatestRequestId = requestId;
2170        mLatestRequestSignal.signal();
2171    }
2172
2173    // Submit request and block until ready for next one
2174    ATRACE_ASYNC_BEGIN("frame capture", request.frame_number);
2175    ATRACE_BEGIN("camera3->process_capture_request");
2176    res = mHal3Device->ops->process_capture_request(mHal3Device, &request);
2177    ATRACE_END();
2178
2179    if (res != OK) {
2180        SET_ERR("RequestThread: Unable to submit capture request %d to HAL"
2181                " device: %s (%d)", request.frame_number, strerror(-res), res);
2182        cleanUpFailedRequest(request, nextRequest, outputBuffers);
2183        return false;
2184    }
2185
2186    // Update the latest request sent to HAL
2187    if (request.settings != NULL) { // Don't update them if they were unchanged
2188        Mutex::Autolock al(mLatestRequestMutex);
2189
2190        camera_metadata_t* cloned = clone_camera_metadata(request.settings);
2191        mLatestRequest.acquire(cloned);
2192    }
2193
2194    if (request.settings != NULL) {
2195        nextRequest->mSettings.unlock(request.settings);
2196    }
2197
2198    // Remove any previously queued triggers (after unlock)
2199    res = removeTriggers(mPrevRequest);
2200    if (res != OK) {
2201        SET_ERR("RequestThread: Unable to remove triggers "
2202              "(capture request %d, HAL device: %s (%d)",
2203              request.frame_number, strerror(-res), res);
2204        return false;
2205    }
2206    mPrevTriggers = triggerCount;
2207
2208    // Return input buffer back to framework
2209    if (request.input_buffer != NULL) {
2210        Camera3Stream *stream =
2211            Camera3Stream::cast(request.input_buffer->stream);
2212        res = stream->returnInputBuffer(*(request.input_buffer));
2213        // Note: stream may be deallocated at this point, if this buffer was the
2214        // last reference to it.
2215        if (res != OK) {
2216            ALOGE("%s: RequestThread: Can't return input buffer for frame %d to"
2217                    "  its stream:%s (%d)",  __FUNCTION__,
2218                    request.frame_number, strerror(-res), res);
2219            // TODO: Report error upstream
2220        }
2221    }
2222
2223    return true;
2224}
2225
2226CameraMetadata Camera3Device::RequestThread::getLatestRequest() const {
2227    Mutex::Autolock al(mLatestRequestMutex);
2228
2229    ALOGV("RequestThread::%s", __FUNCTION__);
2230
2231    return mLatestRequest;
2232}
2233
2234void Camera3Device::RequestThread::cleanUpFailedRequest(
2235        camera3_capture_request_t &request,
2236        sp<CaptureRequest> &nextRequest,
2237        Vector<camera3_stream_buffer_t> &outputBuffers) {
2238
2239    if (request.settings != NULL) {
2240        nextRequest->mSettings.unlock(request.settings);
2241    }
2242    if (request.input_buffer != NULL) {
2243        request.input_buffer->status = CAMERA3_BUFFER_STATUS_ERROR;
2244        nextRequest->mInputStream->returnInputBuffer(*(request.input_buffer));
2245    }
2246    for (size_t i = 0; i < request.num_output_buffers; i++) {
2247        outputBuffers.editItemAt(i).status = CAMERA3_BUFFER_STATUS_ERROR;
2248        nextRequest->mOutputStreams.editItemAt(i)->returnBuffer(
2249            outputBuffers[i], 0);
2250    }
2251}
2252
2253sp<Camera3Device::CaptureRequest>
2254        Camera3Device::RequestThread::waitForNextRequest() {
2255    status_t res;
2256    sp<CaptureRequest> nextRequest;
2257
2258    // Optimized a bit for the simple steady-state case (single repeating
2259    // request), to avoid putting that request in the queue temporarily.
2260    Mutex::Autolock l(mRequestLock);
2261
2262    while (mRequestQueue.empty()) {
2263        if (!mRepeatingRequests.empty()) {
2264            // Always atomically enqueue all requests in a repeating request
2265            // list. Guarantees a complete in-sequence set of captures to
2266            // application.
2267            const RequestList &requests = mRepeatingRequests;
2268            RequestList::const_iterator firstRequest =
2269                    requests.begin();
2270            nextRequest = *firstRequest;
2271            mRequestQueue.insert(mRequestQueue.end(),
2272                    ++firstRequest,
2273                    requests.end());
2274            // No need to wait any longer
2275            break;
2276        }
2277
2278        res = mRequestSignal.waitRelative(mRequestLock, kRequestTimeout);
2279
2280        if ((mRequestQueue.empty() && mRepeatingRequests.empty()) ||
2281                exitPending()) {
2282            Mutex::Autolock pl(mPauseLock);
2283            if (mPaused == false) {
2284                ALOGV("%s: RequestThread: Going idle", __FUNCTION__);
2285                mPaused = true;
2286                // Let the tracker know
2287                sp<StatusTracker> statusTracker = mStatusTracker.promote();
2288                if (statusTracker != 0) {
2289                    statusTracker->markComponentIdle(mStatusId, Fence::NO_FENCE);
2290                }
2291            }
2292            // Stop waiting for now and let thread management happen
2293            return NULL;
2294        }
2295    }
2296
2297    if (nextRequest == NULL) {
2298        // Don't have a repeating request already in hand, so queue
2299        // must have an entry now.
2300        RequestList::iterator firstRequest =
2301                mRequestQueue.begin();
2302        nextRequest = *firstRequest;
2303        mRequestQueue.erase(firstRequest);
2304    }
2305
2306    // In case we've been unpaused by setPaused clearing mDoPause, need to
2307    // update internal pause state (capture/setRepeatingRequest unpause
2308    // directly).
2309    Mutex::Autolock pl(mPauseLock);
2310    if (mPaused) {
2311        ALOGV("%s: RequestThread: Unpaused", __FUNCTION__);
2312        sp<StatusTracker> statusTracker = mStatusTracker.promote();
2313        if (statusTracker != 0) {
2314            statusTracker->markComponentActive(mStatusId);
2315        }
2316    }
2317    mPaused = false;
2318
2319    // Check if we've reconfigured since last time, and reset the preview
2320    // request if so. Can't use 'NULL request == repeat' across configure calls.
2321    if (mReconfigured) {
2322        mPrevRequest.clear();
2323        mReconfigured = false;
2324    }
2325
2326    return nextRequest;
2327}
2328
2329bool Camera3Device::RequestThread::waitIfPaused() {
2330    status_t res;
2331    Mutex::Autolock l(mPauseLock);
2332    while (mDoPause) {
2333        if (mPaused == false) {
2334            mPaused = true;
2335            ALOGV("%s: RequestThread: Paused", __FUNCTION__);
2336            // Let the tracker know
2337            sp<StatusTracker> statusTracker = mStatusTracker.promote();
2338            if (statusTracker != 0) {
2339                statusTracker->markComponentIdle(mStatusId, Fence::NO_FENCE);
2340            }
2341        }
2342
2343        res = mDoPauseSignal.waitRelative(mPauseLock, kRequestTimeout);
2344        if (res == TIMED_OUT || exitPending()) {
2345            return true;
2346        }
2347    }
2348    // We don't set mPaused to false here, because waitForNextRequest needs
2349    // to further manage the paused state in case of starvation.
2350    return false;
2351}
2352
2353void Camera3Device::RequestThread::unpauseForNewRequests() {
2354    // With work to do, mark thread as unpaused.
2355    // If paused by request (setPaused), don't resume, to avoid
2356    // extra signaling/waiting overhead to waitUntilPaused
2357    mRequestSignal.signal();
2358    Mutex::Autolock p(mPauseLock);
2359    if (!mDoPause) {
2360        ALOGV("%s: RequestThread: Going active", __FUNCTION__);
2361        if (mPaused) {
2362            sp<StatusTracker> statusTracker = mStatusTracker.promote();
2363            if (statusTracker != 0) {
2364                statusTracker->markComponentActive(mStatusId);
2365            }
2366        }
2367        mPaused = false;
2368    }
2369}
2370
2371void Camera3Device::RequestThread::setErrorState(const char *fmt, ...) {
2372    sp<Camera3Device> parent = mParent.promote();
2373    if (parent != NULL) {
2374        va_list args;
2375        va_start(args, fmt);
2376
2377        parent->setErrorStateV(fmt, args);
2378
2379        va_end(args);
2380    }
2381}
2382
2383status_t Camera3Device::RequestThread::insertTriggers(
2384        const sp<CaptureRequest> &request) {
2385
2386    Mutex::Autolock al(mTriggerMutex);
2387
2388    CameraMetadata &metadata = request->mSettings;
2389    size_t count = mTriggerMap.size();
2390
2391    for (size_t i = 0; i < count; ++i) {
2392        RequestTrigger trigger = mTriggerMap.valueAt(i);
2393
2394        uint32_t tag = trigger.metadataTag;
2395        camera_metadata_entry entry = metadata.find(tag);
2396
2397        if (entry.count > 0) {
2398            /**
2399             * Already has an entry for this trigger in the request.
2400             * Rewrite it with our requested trigger value.
2401             */
2402            RequestTrigger oldTrigger = trigger;
2403
2404            oldTrigger.entryValue = entry.data.u8[0];
2405
2406            mTriggerReplacedMap.add(tag, oldTrigger);
2407        } else {
2408            /**
2409             * More typical, no trigger entry, so we just add it
2410             */
2411            mTriggerRemovedMap.add(tag, trigger);
2412        }
2413
2414        status_t res;
2415
2416        switch (trigger.getTagType()) {
2417            case TYPE_BYTE: {
2418                uint8_t entryValue = static_cast<uint8_t>(trigger.entryValue);
2419                res = metadata.update(tag,
2420                                      &entryValue,
2421                                      /*count*/1);
2422                break;
2423            }
2424            case TYPE_INT32:
2425                res = metadata.update(tag,
2426                                      &trigger.entryValue,
2427                                      /*count*/1);
2428                break;
2429            default:
2430                ALOGE("%s: Type not supported: 0x%x",
2431                      __FUNCTION__,
2432                      trigger.getTagType());
2433                return INVALID_OPERATION;
2434        }
2435
2436        if (res != OK) {
2437            ALOGE("%s: Failed to update request metadata with trigger tag %s"
2438                  ", value %d", __FUNCTION__, trigger.getTagName(),
2439                  trigger.entryValue);
2440            return res;
2441        }
2442
2443        ALOGV("%s: Mixed in trigger %s, value %d", __FUNCTION__,
2444              trigger.getTagName(),
2445              trigger.entryValue);
2446    }
2447
2448    mTriggerMap.clear();
2449
2450    return count;
2451}
2452
2453status_t Camera3Device::RequestThread::removeTriggers(
2454        const sp<CaptureRequest> &request) {
2455    Mutex::Autolock al(mTriggerMutex);
2456
2457    CameraMetadata &metadata = request->mSettings;
2458
2459    /**
2460     * Replace all old entries with their old values.
2461     */
2462    for (size_t i = 0; i < mTriggerReplacedMap.size(); ++i) {
2463        RequestTrigger trigger = mTriggerReplacedMap.valueAt(i);
2464
2465        status_t res;
2466
2467        uint32_t tag = trigger.metadataTag;
2468        switch (trigger.getTagType()) {
2469            case TYPE_BYTE: {
2470                uint8_t entryValue = static_cast<uint8_t>(trigger.entryValue);
2471                res = metadata.update(tag,
2472                                      &entryValue,
2473                                      /*count*/1);
2474                break;
2475            }
2476            case TYPE_INT32:
2477                res = metadata.update(tag,
2478                                      &trigger.entryValue,
2479                                      /*count*/1);
2480                break;
2481            default:
2482                ALOGE("%s: Type not supported: 0x%x",
2483                      __FUNCTION__,
2484                      trigger.getTagType());
2485                return INVALID_OPERATION;
2486        }
2487
2488        if (res != OK) {
2489            ALOGE("%s: Failed to restore request metadata with trigger tag %s"
2490                  ", trigger value %d", __FUNCTION__,
2491                  trigger.getTagName(), trigger.entryValue);
2492            return res;
2493        }
2494    }
2495    mTriggerReplacedMap.clear();
2496
2497    /**
2498     * Remove all new entries.
2499     */
2500    for (size_t i = 0; i < mTriggerRemovedMap.size(); ++i) {
2501        RequestTrigger trigger = mTriggerRemovedMap.valueAt(i);
2502        status_t res = metadata.erase(trigger.metadataTag);
2503
2504        if (res != OK) {
2505            ALOGE("%s: Failed to erase metadata with trigger tag %s"
2506                  ", trigger value %d", __FUNCTION__,
2507                  trigger.getTagName(), trigger.entryValue);
2508            return res;
2509        }
2510    }
2511    mTriggerRemovedMap.clear();
2512
2513    return OK;
2514}
2515
2516status_t Camera3Device::RequestThread::addDummyTriggerIds(
2517        const sp<CaptureRequest> &request) {
2518    // Trigger ID 0 has special meaning in the HAL2 spec, so avoid it here
2519    static const int32_t dummyTriggerId = 1;
2520    status_t res;
2521
2522    CameraMetadata &metadata = request->mSettings;
2523
2524    // If AF trigger is active, insert a dummy AF trigger ID if none already
2525    // exists
2526    camera_metadata_entry afTrigger = metadata.find(ANDROID_CONTROL_AF_TRIGGER);
2527    camera_metadata_entry afId = metadata.find(ANDROID_CONTROL_AF_TRIGGER_ID);
2528    if (afTrigger.count > 0 &&
2529            afTrigger.data.u8[0] != ANDROID_CONTROL_AF_TRIGGER_IDLE &&
2530            afId.count == 0) {
2531        res = metadata.update(ANDROID_CONTROL_AF_TRIGGER_ID, &dummyTriggerId, 1);
2532        if (res != OK) return res;
2533    }
2534
2535    // If AE precapture trigger is active, insert a dummy precapture trigger ID
2536    // if none already exists
2537    camera_metadata_entry pcTrigger =
2538            metadata.find(ANDROID_CONTROL_AE_PRECAPTURE_TRIGGER);
2539    camera_metadata_entry pcId = metadata.find(ANDROID_CONTROL_AE_PRECAPTURE_ID);
2540    if (pcTrigger.count > 0 &&
2541            pcTrigger.data.u8[0] != ANDROID_CONTROL_AE_PRECAPTURE_TRIGGER_IDLE &&
2542            pcId.count == 0) {
2543        res = metadata.update(ANDROID_CONTROL_AE_PRECAPTURE_ID,
2544                &dummyTriggerId, 1);
2545        if (res != OK) return res;
2546    }
2547
2548    return OK;
2549}
2550
2551
2552/**
2553 * Static callback forwarding methods from HAL to instance
2554 */
2555
2556void Camera3Device::sProcessCaptureResult(const camera3_callback_ops *cb,
2557        const camera3_capture_result *result) {
2558    Camera3Device *d =
2559            const_cast<Camera3Device*>(static_cast<const Camera3Device*>(cb));
2560    d->processCaptureResult(result);
2561}
2562
2563void Camera3Device::sNotify(const camera3_callback_ops *cb,
2564        const camera3_notify_msg *msg) {
2565    Camera3Device *d =
2566            const_cast<Camera3Device*>(static_cast<const Camera3Device*>(cb));
2567    d->notify(msg);
2568}
2569
2570}; // namespace android
2571