blob: c3af4ab0c8842048230e35889a33ab9279bcf309 [file] [log] [blame]
Yin-Chia Yeh5fd603e2019-11-20 11:22:27 -08001/*
2 * Copyright (C) 2019 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-OutputUtils"
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 macros for transitioning to the error state
29#define SET_ERR(fmt, ...) states.setErrIntf.setErrorState( \
30 "%s: " fmt, __FUNCTION__, \
31 ##__VA_ARGS__)
32
33#include <inttypes.h>
34
35#include <utils/Log.h>
36#include <utils/SortedVector.h>
37#include <utils/Trace.h>
38
39#include <android/hardware/camera2/ICameraDeviceCallbacks.h>
40
41#include <android/hardware/camera/device/3.4/ICameraDeviceCallback.h>
42#include <android/hardware/camera/device/3.5/ICameraDeviceCallback.h>
43#include <android/hardware/camera/device/3.5/ICameraDeviceSession.h>
44
Emilian Peev5104fe92021-10-21 14:27:09 -070045#include <camera/CameraUtils.h>
Yin-Chia Yeh5fd603e2019-11-20 11:22:27 -080046#include <camera_metadata_hidden.h>
47
48#include "device3/Camera3OutputUtils.h"
49
Emilian Peev5104fe92021-10-21 14:27:09 -070050#include "system/camera_metadata.h"
51
Yin-Chia Yeh5fd603e2019-11-20 11:22:27 -080052using namespace android::camera3;
53using namespace android::hardware::camera;
54
55namespace android {
56namespace camera3 {
57
58status_t fixupMonochromeTags(
59 CaptureOutputStates& states,
60 const CameraMetadata& deviceInfo,
61 CameraMetadata& resultMetadata) {
62 status_t res = OK;
63 if (!states.needFixupMonoChrome) {
64 return res;
65 }
66
67 // Remove tags that are not applicable to monochrome camera.
68 int32_t tagsToRemove[] = {
69 ANDROID_SENSOR_GREEN_SPLIT,
70 ANDROID_SENSOR_NEUTRAL_COLOR_POINT,
71 ANDROID_COLOR_CORRECTION_MODE,
72 ANDROID_COLOR_CORRECTION_TRANSFORM,
73 ANDROID_COLOR_CORRECTION_GAINS,
74 };
75 for (auto tag : tagsToRemove) {
76 res = resultMetadata.erase(tag);
77 if (res != OK) {
78 ALOGE("%s: Failed to remove tag %d for monochrome camera", __FUNCTION__, tag);
79 return res;
80 }
81 }
82
83 // ANDROID_SENSOR_DYNAMIC_BLACK_LEVEL
84 camera_metadata_entry blEntry = resultMetadata.find(ANDROID_SENSOR_DYNAMIC_BLACK_LEVEL);
85 for (size_t i = 1; i < blEntry.count; i++) {
86 blEntry.data.f[i] = blEntry.data.f[0];
87 }
88
89 // ANDROID_SENSOR_NOISE_PROFILE
90 camera_metadata_entry npEntry = resultMetadata.find(ANDROID_SENSOR_NOISE_PROFILE);
91 if (npEntry.count > 0 && npEntry.count % 2 == 0) {
92 double np[] = {npEntry.data.d[0], npEntry.data.d[1]};
93 res = resultMetadata.update(ANDROID_SENSOR_NOISE_PROFILE, np, 2);
94 if (res != OK) {
95 ALOGE("%s: Failed to update SENSOR_NOISE_PROFILE: %s (%d)",
96 __FUNCTION__, strerror(-res), res);
97 return res;
98 }
99 }
100
101 // ANDROID_STATISTICS_LENS_SHADING_MAP
102 camera_metadata_ro_entry lsSizeEntry = deviceInfo.find(ANDROID_LENS_INFO_SHADING_MAP_SIZE);
103 camera_metadata_entry lsEntry = resultMetadata.find(ANDROID_STATISTICS_LENS_SHADING_MAP);
104 if (lsSizeEntry.count == 2 && lsEntry.count > 0
105 && (int32_t)lsEntry.count == 4 * lsSizeEntry.data.i32[0] * lsSizeEntry.data.i32[1]) {
106 for (int32_t i = 0; i < lsSizeEntry.data.i32[0] * lsSizeEntry.data.i32[1]; i++) {
107 lsEntry.data.f[4*i+1] = lsEntry.data.f[4*i];
108 lsEntry.data.f[4*i+2] = lsEntry.data.f[4*i];
109 lsEntry.data.f[4*i+3] = lsEntry.data.f[4*i];
110 }
111 }
112
113 // ANDROID_TONEMAP_CURVE_BLUE
114 // ANDROID_TONEMAP_CURVE_GREEN
115 // ANDROID_TONEMAP_CURVE_RED
116 camera_metadata_entry tcbEntry = resultMetadata.find(ANDROID_TONEMAP_CURVE_BLUE);
117 camera_metadata_entry tcgEntry = resultMetadata.find(ANDROID_TONEMAP_CURVE_GREEN);
118 camera_metadata_entry tcrEntry = resultMetadata.find(ANDROID_TONEMAP_CURVE_RED);
119 if (tcbEntry.count > 0
120 && tcbEntry.count == tcgEntry.count
121 && tcbEntry.count == tcrEntry.count) {
122 for (size_t i = 0; i < tcbEntry.count; i++) {
123 tcbEntry.data.f[i] = tcrEntry.data.f[i];
124 tcgEntry.data.f[i] = tcrEntry.data.f[i];
125 }
126 }
127
128 return res;
129}
130
Bharatt Kukreja0e13db32022-12-07 21:38:45 +0000131status_t fixupAutoframingTags(CameraMetadata& resultMetadata) {
132 status_t res = OK;
133 camera_metadata_entry autoframingEntry =
134 resultMetadata.find(ANDROID_CONTROL_AUTOFRAMING);
135 if (autoframingEntry.count == 0) {
136 const uint8_t defaultAutoframingEntry = ANDROID_CONTROL_AUTOFRAMING_OFF;
137 res = resultMetadata.update(ANDROID_CONTROL_AUTOFRAMING, &defaultAutoframingEntry, 1);
138 if (res != OK) {
139 ALOGE("%s: Failed to update ANDROID_CONTROL_AUTOFRAMING: %s (%d)",
140 __FUNCTION__, strerror(-res), res);
141 return res;
142 }
143 }
144
145 camera_metadata_entry autoframingStateEntry =
146 resultMetadata.find(ANDROID_CONTROL_AUTOFRAMING_STATE);
147 if (autoframingStateEntry.count == 0) {
148 const uint8_t defaultAutoframingStateEntry = ANDROID_CONTROL_AUTOFRAMING_STATE_INACTIVE;
149 res = resultMetadata.update(ANDROID_CONTROL_AUTOFRAMING_STATE,
150 &defaultAutoframingStateEntry, 1);
151 if (res != OK) {
152 ALOGE("%s: Failed to update ANDROID_CONTROL_AUTOFRAMING_STATE: %s (%d)",
153 __FUNCTION__, strerror(-res), res);
154 return res;
155 }
156 }
157
158 return res;
159}
160
Shuzhen Wangcd8811c2022-08-29 17:23:52 +0000161void correctMeteringRegions(camera_metadata_t *meta) {
162 if (meta == nullptr) return;
163
164 uint32_t meteringRegionKeys[] = {
165 ANDROID_CONTROL_AE_REGIONS,
166 ANDROID_CONTROL_AWB_REGIONS,
167 ANDROID_CONTROL_AF_REGIONS };
168
169 for (uint32_t key : meteringRegionKeys) {
170 camera_metadata_entry_t entry;
171 int res = find_camera_metadata_entry(meta, key, &entry);
172 if (res != OK) continue;
173
174 for (size_t i = 0; i < entry.count; i += 5) {
175 if (entry.data.i32[0] > entry.data.i32[2]) {
176 ALOGW("%s: Invalid metering region (%d): left: %d, right: %d",
177 __FUNCTION__, key, entry.data.i32[0], entry.data.i32[2]);
178 entry.data.i32[2] = entry.data.i32[0];
179 }
180 if (entry.data.i32[1] > entry.data.i32[3]) {
181 ALOGW("%s: Invalid metering region (%d): top: %d, bottom: %d",
182 __FUNCTION__, key, entry.data.i32[1], entry.data.i32[3]);
183 entry.data.i32[3] = entry.data.i32[1];
184 }
185 }
186 }
187}
188
Yin-Chia Yeh5fd603e2019-11-20 11:22:27 -0800189void insertResultLocked(CaptureOutputStates& states, CaptureResult *result, uint32_t frameNumber) {
190 if (result == nullptr) return;
191
192 camera_metadata_t *meta = const_cast<camera_metadata_t *>(
193 result->mMetadata.getAndLock());
194 set_camera_metadata_vendor_id(meta, states.vendorTagId);
Shuzhen Wangcd8811c2022-08-29 17:23:52 +0000195 correctMeteringRegions(meta);
Yin-Chia Yeh5fd603e2019-11-20 11:22:27 -0800196 result->mMetadata.unlock(meta);
197
198 if (result->mMetadata.update(ANDROID_REQUEST_FRAME_COUNT,
199 (int32_t*)&frameNumber, 1) != OK) {
200 SET_ERR("Failed to set frame number %d in metadata", frameNumber);
201 return;
202 }
203
204 if (result->mMetadata.update(ANDROID_REQUEST_ID, &result->mResultExtras.requestId, 1) != OK) {
205 SET_ERR("Failed to set request ID in metadata for frame %d", frameNumber);
206 return;
207 }
208
209 // Update vendor tag id for physical metadata
210 for (auto& physicalMetadata : result->mPhysicalMetadatas) {
211 camera_metadata_t *pmeta = const_cast<camera_metadata_t *>(
212 physicalMetadata.mPhysicalCameraMetadata.getAndLock());
213 set_camera_metadata_vendor_id(pmeta, states.vendorTagId);
Shuzhen Wangcd8811c2022-08-29 17:23:52 +0000214 correctMeteringRegions(pmeta);
Yin-Chia Yeh5fd603e2019-11-20 11:22:27 -0800215 physicalMetadata.mPhysicalCameraMetadata.unlock(pmeta);
216 }
217
218 // Valid result, insert into queue
Jayant Chowdhary8a0be292020-01-08 13:10:38 -0800219 std::list<CaptureResult>::iterator queuedResult =
Yin-Chia Yeh5fd603e2019-11-20 11:22:27 -0800220 states.resultQueue.insert(states.resultQueue.end(), CaptureResult(*result));
Jayant Chowdhary8a0be292020-01-08 13:10:38 -0800221 ALOGV("%s: result requestId = %" PRId32 ", frameNumber = %" PRId64
Yin-Chia Yeh5fd603e2019-11-20 11:22:27 -0800222 ", burstId = %" PRId32, __FUNCTION__,
223 queuedResult->mResultExtras.requestId,
224 queuedResult->mResultExtras.frameNumber,
225 queuedResult->mResultExtras.burstId);
226
227 states.resultSignal.notify_one();
228}
229
230
231void sendPartialCaptureResult(CaptureOutputStates& states,
232 const camera_metadata_t * partialResult,
233 const CaptureResultExtras &resultExtras, uint32_t frameNumber) {
234 ATRACE_CALL();
235 std::lock_guard<std::mutex> l(states.outputLock);
236
237 CaptureResult captureResult;
238 captureResult.mResultExtras = resultExtras;
239 captureResult.mMetadata = partialResult;
240
241 // Fix up result metadata for monochrome camera.
242 status_t res = fixupMonochromeTags(states, states.deviceInfo, captureResult.mMetadata);
243 if (res != OK) {
244 SET_ERR("Failed to override result metadata: %s (%d)", strerror(-res), res);
245 return;
246 }
247
Shuzhen Wang8c75a642020-10-29 21:58:53 -0700248 // Update partial result by removing keys remapped by DistortionCorrection, ZoomRatio,
249 // and RotationAndCrop mappers.
250 std::set<uint32_t> keysToRemove;
251
252 auto iter = states.distortionMappers.find(states.cameraId.c_str());
253 if (iter != states.distortionMappers.end()) {
254 const auto& remappedKeys = iter->second.getRemappedKeys();
255 keysToRemove.insert(remappedKeys.begin(), remappedKeys.end());
256 }
257
258 const auto& remappedKeys = states.zoomRatioMappers[states.cameraId.c_str()].getRemappedKeys();
259 keysToRemove.insert(remappedKeys.begin(), remappedKeys.end());
260
261 auto mapper = states.rotateAndCropMappers.find(states.cameraId.c_str());
262 if (mapper != states.rotateAndCropMappers.end()) {
Ravneet58485902023-04-07 04:34:48 +0000263 const auto& remappedKeys = mapper->second.getRemappedKeys();
Shuzhen Wang8c75a642020-10-29 21:58:53 -0700264 keysToRemove.insert(remappedKeys.begin(), remappedKeys.end());
265 }
266
267 for (uint32_t key : keysToRemove) {
268 captureResult.mMetadata.erase(key);
269 }
270
271 // Send partial result
272 if (captureResult.mMetadata.entryCount() > 0) {
273 insertResultLocked(states, &captureResult, frameNumber);
274 }
Yin-Chia Yeh5fd603e2019-11-20 11:22:27 -0800275}
276
277void sendCaptureResult(
278 CaptureOutputStates& states,
279 CameraMetadata &pendingMetadata,
280 CaptureResultExtras &resultExtras,
281 CameraMetadata &collectedPartialResult,
282 uint32_t frameNumber,
Eino-Ville Talvalaf2e37092020-01-07 15:32:32 -0800283 bool reprocess, bool zslStillCapture, bool rotateAndCropAuto,
Yin-Chia Yeh5fd603e2019-11-20 11:22:27 -0800284 const std::set<std::string>& cameraIdsWithZoom,
285 const std::vector<PhysicalCaptureResultInfo>& physicalMetadatas) {
286 ATRACE_CALL();
287 if (pendingMetadata.isEmpty())
288 return;
289
290 std::lock_guard<std::mutex> l(states.outputLock);
291
292 // TODO: need to track errors for tighter bounds on expected frame number
293 if (reprocess) {
294 if (frameNumber < states.nextReprocResultFrameNum) {
295 SET_ERR("Out-of-order reprocess capture result metadata submitted! "
296 "(got frame number %d, expecting %d)",
297 frameNumber, states.nextReprocResultFrameNum);
298 return;
299 }
300 states.nextReprocResultFrameNum = frameNumber + 1;
301 } else if (zslStillCapture) {
302 if (frameNumber < states.nextZslResultFrameNum) {
303 SET_ERR("Out-of-order ZSL still capture result metadata submitted! "
304 "(got frame number %d, expecting %d)",
305 frameNumber, states.nextZslResultFrameNum);
306 return;
307 }
308 states.nextZslResultFrameNum = frameNumber + 1;
309 } else {
310 if (frameNumber < states.nextResultFrameNum) {
311 SET_ERR("Out-of-order capture result metadata submitted! "
312 "(got frame number %d, expecting %d)",
313 frameNumber, states.nextResultFrameNum);
314 return;
315 }
316 states.nextResultFrameNum = frameNumber + 1;
317 }
318
319 CaptureResult captureResult;
320 captureResult.mResultExtras = resultExtras;
321 captureResult.mMetadata = pendingMetadata;
322 captureResult.mPhysicalMetadatas = physicalMetadatas;
323
324 // Append any previous partials to form a complete result
325 if (states.usePartialResult && !collectedPartialResult.isEmpty()) {
326 captureResult.mMetadata.append(collectedPartialResult);
327 }
328
329 captureResult.mMetadata.sort();
330
331 // Check that there's a timestamp in the result metadata
332 camera_metadata_entry timestamp = captureResult.mMetadata.find(ANDROID_SENSOR_TIMESTAMP);
333 if (timestamp.count == 0) {
334 SET_ERR("No timestamp provided by HAL for frame %d!",
335 frameNumber);
336 return;
337 }
Yin-Chia Yehc530c592020-03-09 14:50:36 -0700338 nsecs_t sensorTimestamp = timestamp.data.i64[0];
339
Yin-Chia Yeh5fd603e2019-11-20 11:22:27 -0800340 for (auto& physicalMetadata : captureResult.mPhysicalMetadatas) {
341 camera_metadata_entry timestamp =
342 physicalMetadata.mPhysicalCameraMetadata.find(ANDROID_SENSOR_TIMESTAMP);
343 if (timestamp.count == 0) {
344 SET_ERR("No timestamp provided by HAL for physical camera %s frame %d!",
345 String8(physicalMetadata.mPhysicalCameraId).c_str(), frameNumber);
346 return;
347 }
348 }
349
350 // Fix up some result metadata to account for HAL-level distortion correction
Yin-Chia Yeh7ffbd982020-04-13 10:04:23 -0700351 status_t res = OK;
352 auto iter = states.distortionMappers.find(states.cameraId.c_str());
353 if (iter != states.distortionMappers.end()) {
354 res = iter->second.correctCaptureResult(&captureResult.mMetadata);
355 if (res != OK) {
356 SET_ERR("Unable to correct capture result metadata for frame %d: %s (%d)",
357 frameNumber, strerror(-res), res);
358 return;
359 }
Yin-Chia Yeh5fd603e2019-11-20 11:22:27 -0800360 }
361
362 // Fix up result metadata to account for zoom ratio availabilities between
363 // HAL and app.
364 bool zoomRatioIs1 = cameraIdsWithZoom.find(states.cameraId.c_str()) == cameraIdsWithZoom.end();
365 res = states.zoomRatioMappers[states.cameraId.c_str()].updateCaptureResult(
366 &captureResult.mMetadata, zoomRatioIs1);
367 if (res != OK) {
368 SET_ERR("Failed to update capture result zoom ratio metadata for frame %d: %s (%d)",
369 frameNumber, strerror(-res), res);
370 return;
371 }
372
Eino-Ville Talvalaf2e37092020-01-07 15:32:32 -0800373 // Fix up result metadata to account for rotateAndCrop in AUTO mode
374 if (rotateAndCropAuto) {
375 auto mapper = states.rotateAndCropMappers.find(states.cameraId.c_str());
376 if (mapper != states.rotateAndCropMappers.end()) {
377 res = mapper->second.updateCaptureResult(
378 &captureResult.mMetadata);
379 if (res != OK) {
380 SET_ERR("Unable to correct capture result rotate-and-crop for frame %d: %s (%d)",
381 frameNumber, strerror(-res), res);
382 return;
383 }
384 }
385 }
386
Bharatt Kukrejad33fe9f2022-11-23 21:52:52 +0000387 // Fix up autoframing metadata
Bharatt Kukreja0e13db32022-12-07 21:38:45 +0000388 res = fixupAutoframingTags(captureResult.mMetadata);
389 if (res != OK) {
390 SET_ERR("Failed to set autoframing defaults in result metadata: %s (%d)",
391 strerror(-res), res);
392 return;
Bharatt Kukrejad33fe9f2022-11-23 21:52:52 +0000393 }
Bharatt Kukreja0e13db32022-12-07 21:38:45 +0000394 for (auto& physicalMetadata : captureResult.mPhysicalMetadatas) {
395 res = fixupAutoframingTags(physicalMetadata.mPhysicalCameraMetadata);
396 if (res != OK) {
397 SET_ERR("Failed to set autoframing defaults in physical result metadata: %s (%d)",
398 strerror(-res), res);
Bharatt Kukrejad33fe9f2022-11-23 21:52:52 +0000399 return;
400 }
401 }
402
Yin-Chia Yeh5fd603e2019-11-20 11:22:27 -0800403 for (auto& physicalMetadata : captureResult.mPhysicalMetadatas) {
404 String8 cameraId8(physicalMetadata.mPhysicalCameraId);
Eino-Ville Talvalaf2e37092020-01-07 15:32:32 -0800405 auto mapper = states.distortionMappers.find(cameraId8.c_str());
406 if (mapper != states.distortionMappers.end()) {
407 res = mapper->second.correctCaptureResult(
Yin-Chia Yeh5fd603e2019-11-20 11:22:27 -0800408 &physicalMetadata.mPhysicalCameraMetadata);
409 if (res != OK) {
410 SET_ERR("Unable to correct physical capture result metadata for frame %d: %s (%d)",
411 frameNumber, strerror(-res), res);
412 return;
413 }
414 }
415
416 zoomRatioIs1 = cameraIdsWithZoom.find(cameraId8.c_str()) == cameraIdsWithZoom.end();
417 res = states.zoomRatioMappers[cameraId8.c_str()].updateCaptureResult(
418 &physicalMetadata.mPhysicalCameraMetadata, zoomRatioIs1);
419 if (res != OK) {
420 SET_ERR("Failed to update camera %s's physical zoom ratio metadata for "
421 "frame %d: %s(%d)", cameraId8.c_str(), frameNumber, strerror(-res), res);
422 return;
423 }
424 }
425
426 // Fix up result metadata for monochrome camera.
427 res = fixupMonochromeTags(states, states.deviceInfo, captureResult.mMetadata);
428 if (res != OK) {
429 SET_ERR("Failed to override result metadata: %s (%d)", strerror(-res), res);
430 return;
431 }
432 for (auto& physicalMetadata : captureResult.mPhysicalMetadatas) {
433 String8 cameraId8(physicalMetadata.mPhysicalCameraId);
434 res = fixupMonochromeTags(states,
435 states.physicalDeviceInfoMap.at(cameraId8.c_str()),
436 physicalMetadata.mPhysicalCameraMetadata);
437 if (res != OK) {
438 SET_ERR("Failed to override result metadata: %s (%d)", strerror(-res), res);
439 return;
440 }
441 }
442
443 std::unordered_map<std::string, CameraMetadata> monitoredPhysicalMetadata;
444 for (auto& m : physicalMetadatas) {
445 monitoredPhysicalMetadata.emplace(String8(m.mPhysicalCameraId).string(),
446 CameraMetadata(m.mPhysicalCameraMetadata));
447 }
448 states.tagMonitor.monitorMetadata(TagMonitor::RESULT,
Yin-Chia Yehc530c592020-03-09 14:50:36 -0700449 frameNumber, sensorTimestamp, captureResult.mMetadata,
Yin-Chia Yeh5fd603e2019-11-20 11:22:27 -0800450 monitoredPhysicalMetadata);
451
452 insertResultLocked(states, &captureResult, frameNumber);
453}
454
Yin-Chia Yeh5fd603e2019-11-20 11:22:27 -0800455void removeInFlightMapEntryLocked(CaptureOutputStates& states, int idx) {
456 ATRACE_CALL();
457 InFlightRequestMap& inflightMap = states.inflightMap;
458 nsecs_t duration = inflightMap.valueAt(idx).maxExpectedDuration;
459 inflightMap.removeItemsAt(idx, 1);
460
461 states.inflightIntf.onInflightEntryRemovedLocked(duration);
462}
463
464void removeInFlightRequestIfReadyLocked(CaptureOutputStates& states, int idx) {
465 InFlightRequestMap& inflightMap = states.inflightMap;
Greg Kaiser51b882c2020-06-10 05:41:44 +0000466 const InFlightRequest &request = inflightMap.valueAt(idx);
Yin-Chia Yeh5fd603e2019-11-20 11:22:27 -0800467 const uint32_t frameNumber = inflightMap.keyAt(idx);
Shuzhen Wang316781a2020-08-18 18:11:01 -0700468 SessionStatsBuilder& sessionStatsBuilder = states.sessionStatsBuilder;
Yin-Chia Yeh5fd603e2019-11-20 11:22:27 -0800469
470 nsecs_t sensorTimestamp = request.sensorTimestamp;
471 nsecs_t shutterTimestamp = request.shutterTimestamp;
472
473 // Check if it's okay to remove the request from InFlightMap:
474 // In the case of a successful request:
475 // all input and output buffers, all result metadata, shutter callback
476 // arrived.
Shuzhen Wangb7b42652020-05-07 11:59:02 -0700477 // In the case of an unsuccessful request:
478 // all input and output buffers, as well as request/result error notifications, arrived.
Yin-Chia Yeh5fd603e2019-11-20 11:22:27 -0800479 if (request.numBuffersLeft == 0 &&
480 (request.skipResultMetadata ||
481 (request.haveResultMetadata && shutterTimestamp != 0))) {
482 if (request.stillCapture) {
483 ATRACE_ASYNC_END("still capture", frameNumber);
484 }
485
486 ATRACE_ASYNC_END("frame capture", frameNumber);
487
Ivan Lozanoc0ad82f2020-07-30 09:32:57 -0400488 // Validation check - if sensor timestamp matches shutter timestamp in the
Yin-Chia Yeh5fd603e2019-11-20 11:22:27 -0800489 // case of request having callback.
490 if (request.hasCallback && request.requestStatus == OK &&
491 sensorTimestamp != shutterTimestamp) {
492 SET_ERR("sensor timestamp (%" PRId64
493 ") for frame %d doesn't match shutter timestamp (%" PRId64 ")",
494 sensorTimestamp, frameNumber, shutterTimestamp);
495 }
496
497 // for an unsuccessful request, it may have pending output buffers to
498 // return.
499 assert(request.requestStatus != OK ||
500 request.pendingOutputBuffers.size() == 0);
501
Greg Kaiser51b882c2020-06-10 05:41:44 +0000502 returnOutputBuffers(
Yin-Chia Yeh5fd603e2019-11-20 11:22:27 -0800503 states.useHalBufManager, states.listener,
504 request.pendingOutputBuffers.array(),
Shuzhen Wang90708ea2021-11-04 11:40:49 -0700505 request.pendingOutputBuffers.size(), /*timestamp*/0, /*readoutTimestamp*/0,
Shuzhen Wang316781a2020-08-18 18:11:01 -0700506 /*requested*/true, request.requestTimeNs, states.sessionStatsBuilder,
507 /*timestampIncreasing*/true,
Shuzhen Wangb7b42652020-05-07 11:59:02 -0700508 request.outputSurfaces, request.resultExtras,
Emilian Peev5104fe92021-10-21 14:27:09 -0700509 request.errorBufStrategy, request.transform);
Shuzhen Wangb7b42652020-05-07 11:59:02 -0700510
511 // Note down the just completed frame number
512 if (request.hasInputBuffer) {
513 states.lastCompletedReprocessFrameNumber = frameNumber;
Shuzhen Wang828ade32022-01-10 17:19:02 -0800514 } else if (request.zslCapture && request.stillCapture) {
Shuzhen Wangb7b42652020-05-07 11:59:02 -0700515 states.lastCompletedZslFrameNumber = frameNumber;
516 } else {
517 states.lastCompletedRegularFrameNumber = frameNumber;
518 }
Yin-Chia Yeh5fd603e2019-11-20 11:22:27 -0800519
Shuzhen Wang316781a2020-08-18 18:11:01 -0700520 sessionStatsBuilder.incResultCounter(request.skipResultMetadata);
521
Greg Kaiser51b882c2020-06-10 05:41:44 +0000522 removeInFlightMapEntryLocked(states, idx);
523 ALOGVV("%s: removed frame %d from InFlightMap", __FUNCTION__, frameNumber);
Yin-Chia Yeh5fd603e2019-11-20 11:22:27 -0800524 }
525
526 states.inflightIntf.checkInflightMapLengthLocked();
527}
528
Shuzhen Wang99080502021-03-07 21:08:20 -0800529// Erase the subset of physicalCameraIds that contains id
530bool erasePhysicalCameraIdSet(
531 std::set<std::set<String8>>& physicalCameraIds, const String8& id) {
532 bool found = false;
533 for (auto iter = physicalCameraIds.begin(); iter != physicalCameraIds.end(); iter++) {
534 if (iter->count(id) == 1) {
535 physicalCameraIds.erase(iter);
536 found = true;
537 break;
538 }
539 }
540 return found;
541}
542
Shuzhen Wang3c00b092022-11-08 22:53:07 +0000543const std::set<std::string>& getCameraIdsWithZoomLocked(
544 const InFlightRequestMap& inflightMap, const CameraMetadata& metadata,
545 const std::set<std::string>& cameraIdsWithZoom) {
546 camera_metadata_ro_entry overrideEntry =
547 metadata.find(ANDROID_CONTROL_SETTINGS_OVERRIDE);
548 camera_metadata_ro_entry frameNumberEntry =
549 metadata.find(ANDROID_CONTROL_SETTINGS_OVERRIDING_FRAME_NUMBER);
550 if (overrideEntry.count != 1
551 || overrideEntry.data.i32[0] != ANDROID_CONTROL_SETTINGS_OVERRIDE_ZOOM
552 || frameNumberEntry.count != 1) {
553 // No valid overriding frame number, skip
554 return cameraIdsWithZoom;
555 }
556
557 uint32_t overridingFrameNumber = frameNumberEntry.data.i32[0];
558 ssize_t idx = inflightMap.indexOfKey(overridingFrameNumber);
559 if (idx < 0) {
560 ALOGE("%s: Failed to find pending request #%d in inflight map",
561 __FUNCTION__, overridingFrameNumber);
562 return cameraIdsWithZoom;
563 }
564
565 const InFlightRequest &r = inflightMap.valueFor(overridingFrameNumber);
566 return r.cameraIdsWithZoom;
567}
568
Emilian Peevf4816702020-04-03 15:44:51 -0700569void processCaptureResult(CaptureOutputStates& states, const camera_capture_result *result) {
Yin-Chia Yeh5fd603e2019-11-20 11:22:27 -0800570 ATRACE_CALL();
571
572 status_t res;
573
574 uint32_t frameNumber = result->frame_number;
575 if (result->result == NULL && result->num_output_buffers == 0 &&
576 result->input_buffer == NULL) {
577 SET_ERR("No result data provided by HAL for frame %d",
578 frameNumber);
579 return;
580 }
581
582 if (!states.usePartialResult &&
583 result->result != NULL &&
584 result->partial_result != 1) {
585 SET_ERR("Result is malformed for frame %d: partial_result %u must be 1"
586 " if partial result is not supported",
587 frameNumber, result->partial_result);
588 return;
589 }
590
591 bool isPartialResult = false;
592 CameraMetadata collectedPartialResult;
593 bool hasInputBufferInRequest = false;
594
595 // Get shutter timestamp and resultExtras from list of in-flight requests,
596 // where it was added by the shutter notification for this frame. If the
597 // shutter timestamp isn't received yet, append the output buffers to the
598 // in-flight request and they will be returned when the shutter timestamp
599 // arrives. Update the in-flight status and remove the in-flight entry if
600 // all result data and shutter timestamp have been received.
601 nsecs_t shutterTimestamp = 0;
602 {
603 std::lock_guard<std::mutex> l(states.inflightLock);
604 ssize_t idx = states.inflightMap.indexOfKey(frameNumber);
605 if (idx == NAME_NOT_FOUND) {
606 SET_ERR("Unknown frame number for capture result: %d",
607 frameNumber);
608 return;
609 }
610 InFlightRequest &request = states.inflightMap.editValueAt(idx);
611 ALOGVV("%s: got InFlightRequest requestId = %" PRId32
612 ", frameNumber = %" PRId64 ", burstId = %" PRId32
Shuzhen Wangb7b42652020-05-07 11:59:02 -0700613 ", partialResultCount = %d/%d, hasCallback = %d, num_output_buffers %d"
614 ", usePartialResult = %d",
Yin-Chia Yeh5fd603e2019-11-20 11:22:27 -0800615 __FUNCTION__, request.resultExtras.requestId,
616 request.resultExtras.frameNumber, request.resultExtras.burstId,
Shuzhen Wangb7b42652020-05-07 11:59:02 -0700617 result->partial_result, states.numPartialResults,
618 request.hasCallback, result->num_output_buffers,
619 states.usePartialResult);
Yin-Chia Yeh5fd603e2019-11-20 11:22:27 -0800620 // Always update the partial count to the latest one if it's not 0
621 // (buffers only). When framework aggregates adjacent partial results
622 // into one, the latest partial count will be used.
623 if (result->partial_result != 0)
624 request.resultExtras.partialResultCount = result->partial_result;
625
Austin Borgerc8099762023-01-12 17:08:46 -0800626 if (result->result != nullptr) {
Emilian Peev5104fe92021-10-21 14:27:09 -0700627 camera_metadata_ro_entry entry;
628 auto ret = find_camera_metadata_ro_entry(result->result,
629 ANDROID_LOGICAL_MULTI_CAMERA_ACTIVE_PHYSICAL_ID, &entry);
630 if ((ret == OK) && (entry.count > 0)) {
631 std::string physicalId(reinterpret_cast<const char *>(entry.data.u8));
Austin Borgerc8099762023-01-12 17:08:46 -0800632 if (!states.activePhysicalId.empty() && physicalId != states.activePhysicalId) {
633 states.listener->notifyPhysicalCameraChange(physicalId);
634 }
635 states.activePhysicalId = physicalId;
636
637 if (!states.legacyClient && !states.overrideToPortrait) {
638 auto deviceInfo = states.physicalDeviceInfoMap.find(physicalId);
639 if (deviceInfo != states.physicalDeviceInfoMap.end()) {
640 auto orientation = deviceInfo->second.find(ANDROID_SENSOR_ORIENTATION);
641 if (orientation.count > 0) {
642 ret = CameraUtils::getRotationTransform(deviceInfo->second,
643 OutputConfiguration::MIRROR_MODE_AUTO, &request.transform);
644 if (ret != OK) {
645 ALOGE("%s: Failed to calculate current stream transformation: %s "
646 "(%d)", __FUNCTION__, strerror(-ret), ret);
647 }
648 } else {
649 ALOGE("%s: Physical device orientation absent!", __FUNCTION__);
Emilian Peev5104fe92021-10-21 14:27:09 -0700650 }
651 } else {
Austin Borgerc8099762023-01-12 17:08:46 -0800652 ALOGE("%s: Physical device not found in device info map found!",
653 __FUNCTION__);
Emilian Peev5104fe92021-10-21 14:27:09 -0700654 }
Emilian Peev5104fe92021-10-21 14:27:09 -0700655 }
656 }
657 }
658
Yin-Chia Yeh5fd603e2019-11-20 11:22:27 -0800659 // Check if this result carries only partial metadata
660 if (states.usePartialResult && result->result != NULL) {
661 if (result->partial_result > states.numPartialResults || result->partial_result < 1) {
662 SET_ERR("Result is malformed for frame %d: partial_result %u must be in"
663 " the range of [1, %d] when metadata is included in the result",
664 frameNumber, result->partial_result, states.numPartialResults);
665 return;
666 }
667 isPartialResult = (result->partial_result < states.numPartialResults);
668 if (isPartialResult && result->num_physcam_metadata) {
669 SET_ERR("Result is malformed for frame %d: partial_result not allowed for"
670 " physical camera result", frameNumber);
671 return;
672 }
673 if (isPartialResult) {
674 request.collectedPartialResult.append(result->result);
675 }
676
677 if (isPartialResult && request.hasCallback) {
678 // Send partial capture result
679 sendPartialCaptureResult(states, result->result, request.resultExtras,
680 frameNumber);
681 }
682 }
683
684 shutterTimestamp = request.shutterTimestamp;
685 hasInputBufferInRequest = request.hasInputBuffer;
686
687 // Did we get the (final) result metadata for this capture?
688 if (result->result != NULL && !isPartialResult) {
689 if (request.physicalCameraIds.size() != result->num_physcam_metadata) {
690 SET_ERR("Expected physical Camera metadata count %d not equal to actual count %d",
691 request.physicalCameraIds.size(), result->num_physcam_metadata);
692 return;
693 }
694 if (request.haveResultMetadata) {
695 SET_ERR("Called multiple times with metadata for frame %d",
696 frameNumber);
697 return;
698 }
699 for (uint32_t i = 0; i < result->num_physcam_metadata; i++) {
700 String8 physicalId(result->physcam_ids[i]);
Shuzhen Wang99080502021-03-07 21:08:20 -0800701 bool validPhysicalCameraMetadata =
702 erasePhysicalCameraIdSet(request.physicalCameraIds, physicalId);
703 if (!validPhysicalCameraMetadata) {
704 SET_ERR("Unexpected total result for frame %d camera %s",
Yin-Chia Yeh5fd603e2019-11-20 11:22:27 -0800705 frameNumber, physicalId.c_str());
706 return;
707 }
708 }
709 if (states.usePartialResult &&
710 !request.collectedPartialResult.isEmpty()) {
711 collectedPartialResult.acquire(
712 request.collectedPartialResult);
713 }
714 request.haveResultMetadata = true;
Shuzhen Wangb7b42652020-05-07 11:59:02 -0700715 request.errorBufStrategy = ERROR_BUF_RETURN_NOTIFY;
Yin-Chia Yeh5fd603e2019-11-20 11:22:27 -0800716 }
717
718 uint32_t numBuffersReturned = result->num_output_buffers;
719 if (result->input_buffer != NULL) {
720 if (hasInputBufferInRequest) {
721 numBuffersReturned += 1;
722 } else {
723 ALOGW("%s: Input buffer should be NULL if there is no input"
724 " buffer sent in the request",
725 __FUNCTION__);
726 }
727 }
728 request.numBuffersLeft -= numBuffersReturned;
729 if (request.numBuffersLeft < 0) {
730 SET_ERR("Too many buffers returned for frame %d",
731 frameNumber);
732 return;
733 }
734
735 camera_metadata_ro_entry_t entry;
736 res = find_camera_metadata_ro_entry(result->result,
737 ANDROID_SENSOR_TIMESTAMP, &entry);
738 if (res == OK && entry.count == 1) {
739 request.sensorTimestamp = entry.data.i64[0];
740 }
741
Shuzhen Wangb7b42652020-05-07 11:59:02 -0700742 // If shutter event isn't received yet, do not return the pending output
743 // buffers.
744 request.pendingOutputBuffers.appendArray(result->output_buffers,
Yin-Chia Yeh5fd603e2019-11-20 11:22:27 -0800745 result->num_output_buffers);
Shuzhen Wangb7b42652020-05-07 11:59:02 -0700746 if (shutterTimestamp != 0) {
747 returnAndRemovePendingOutputBuffers(
748 states.useHalBufManager, states.listener,
Shuzhen Wang316781a2020-08-18 18:11:01 -0700749 request, states.sessionStatsBuilder);
Yin-Chia Yeh5fd603e2019-11-20 11:22:27 -0800750 }
751
752 if (result->result != NULL && !isPartialResult) {
753 for (uint32_t i = 0; i < result->num_physcam_metadata; i++) {
754 CameraMetadata physicalMetadata;
755 physicalMetadata.append(result->physcam_metadata[i]);
756 request.physicalMetadatas.push_back({String16(result->physcam_ids[i]),
757 physicalMetadata});
758 }
759 if (shutterTimestamp == 0) {
760 request.pendingMetadata = result->result;
761 request.collectedPartialResult = collectedPartialResult;
762 } else if (request.hasCallback) {
763 CameraMetadata metadata;
764 metadata = result->result;
Shuzhen Wang3c00b092022-11-08 22:53:07 +0000765 auto cameraIdsWithZoom = getCameraIdsWithZoomLocked(
766 states.inflightMap, metadata, request.cameraIdsWithZoom);
Yin-Chia Yeh5fd603e2019-11-20 11:22:27 -0800767 sendCaptureResult(states, metadata, request.resultExtras,
768 collectedPartialResult, frameNumber,
769 hasInputBufferInRequest, request.zslCapture && request.stillCapture,
Shuzhen Wang3c00b092022-11-08 22:53:07 +0000770 request.rotateAndCropAuto, cameraIdsWithZoom,
Eino-Ville Talvalaf2e37092020-01-07 15:32:32 -0800771 request.physicalMetadatas);
Yin-Chia Yeh5fd603e2019-11-20 11:22:27 -0800772 }
773 }
774 removeInFlightRequestIfReadyLocked(states, idx);
775 } // scope for states.inFlightLock
776
777 if (result->input_buffer != NULL) {
778 if (hasInputBufferInRequest) {
779 Camera3Stream *stream =
780 Camera3Stream::cast(result->input_buffer->stream);
781 res = stream->returnInputBuffer(*(result->input_buffer));
782 // Note: stream may be deallocated at this point, if this buffer was the
783 // last reference to it.
784 if (res != OK) {
785 ALOGE("%s: RequestThread: Can't return input buffer for frame %d to"
786 " its stream:%s (%d)", __FUNCTION__,
787 frameNumber, strerror(-res), res);
788 }
789 } else {
790 ALOGW("%s: Input buffer should be NULL if there is no input"
791 " buffer sent in the request, skipping input buffer return.",
792 __FUNCTION__);
793 }
794 }
795}
796
Greg Kaiser51b882c2020-06-10 05:41:44 +0000797void returnOutputBuffers(
Yin-Chia Yeh5fd603e2019-11-20 11:22:27 -0800798 bool useHalBufManager,
799 sp<NotificationListener> listener,
Emilian Peevf4816702020-04-03 15:44:51 -0700800 const camera_stream_buffer_t *outputBuffers, size_t numBuffers,
Shuzhen Wang90708ea2021-11-04 11:40:49 -0700801 nsecs_t timestamp, nsecs_t readoutTimestamp, bool requested,
802 nsecs_t requestTimeNs, SessionStatsBuilder& sessionStatsBuilder,
803 bool timestampIncreasing, const SurfaceMap& outputSurfaces,
Shuzhen Wangb7b42652020-05-07 11:59:02 -0700804 const CaptureResultExtras &inResultExtras,
Emilian Peev5104fe92021-10-21 14:27:09 -0700805 ERROR_BUF_STRATEGY errorBufStrategy, int32_t transform) {
Yin-Chia Yeh5fd603e2019-11-20 11:22:27 -0800806
807 for (size_t i = 0; i < numBuffers; i++)
808 {
Shuzhen Wangb7b42652020-05-07 11:59:02 -0700809 Camera3StreamInterface *stream = Camera3Stream::cast(outputBuffers[i].stream);
810 int streamId = stream->getId();
811
812 // Call notify(ERROR_BUFFER) if necessary.
Emilian Peevf4816702020-04-03 15:44:51 -0700813 if (outputBuffers[i].status == CAMERA_BUFFER_STATUS_ERROR &&
Shuzhen Wangb7b42652020-05-07 11:59:02 -0700814 errorBufStrategy == ERROR_BUF_RETURN_NOTIFY) {
815 if (listener != nullptr) {
816 CaptureResultExtras extras = inResultExtras;
817 extras.errorStreamId = streamId;
818 listener->notifyError(
819 hardware::camera2::ICameraDeviceCallbacks::ERROR_CAMERA_BUFFER,
820 extras);
821 }
822 }
823
Yin-Chia Yeh5fd603e2019-11-20 11:22:27 -0800824 if (outputBuffers[i].buffer == nullptr) {
825 if (!useHalBufManager) {
826 // With HAL buffer management API, HAL sometimes will have to return buffers that
827 // has not got a output buffer handle filled yet. This is though illegal if HAL
828 // buffer management API is not being used.
829 ALOGE("%s: cannot return a null buffer!", __FUNCTION__);
Shuzhen Wang316781a2020-08-18 18:11:01 -0700830 } else {
831 if (requested) {
832 sessionStatsBuilder.incCounter(streamId, /*dropped*/true, 0);
833 }
Yin-Chia Yeh5fd603e2019-11-20 11:22:27 -0800834 }
835 continue;
836 }
837
Yin-Chia Yeh5fd603e2019-11-20 11:22:27 -0800838 const auto& it = outputSurfaces.find(streamId);
839 status_t res = OK;
Yin-Chia Yeh5fd603e2019-11-20 11:22:27 -0800840
Shuzhen Wangb7b42652020-05-07 11:59:02 -0700841 // Do not return the buffer if the buffer status is error, and the error
842 // buffer strategy is CACHE.
Emilian Peevf4816702020-04-03 15:44:51 -0700843 if (outputBuffers[i].status != CAMERA_BUFFER_STATUS_ERROR ||
Shuzhen Wangb7b42652020-05-07 11:59:02 -0700844 errorBufStrategy != ERROR_BUF_CACHE) {
845 if (it != outputSurfaces.end()) {
846 res = stream->returnBuffer(
Shuzhen Wang90708ea2021-11-04 11:40:49 -0700847 outputBuffers[i], timestamp, readoutTimestamp, timestampIncreasing,
848 it->second, inResultExtras.frameNumber, transform);
Shuzhen Wangb7b42652020-05-07 11:59:02 -0700849 } else {
850 res = stream->returnBuffer(
Shuzhen Wang90708ea2021-11-04 11:40:49 -0700851 outputBuffers[i], timestamp, readoutTimestamp, timestampIncreasing,
Emilian Peev5104fe92021-10-21 14:27:09 -0700852 std::vector<size_t> (), inResultExtras.frameNumber, transform);
Shuzhen Wangb7b42652020-05-07 11:59:02 -0700853 }
854 }
Yin-Chia Yeh5fd603e2019-11-20 11:22:27 -0800855 // Note: stream may be deallocated at this point, if this buffer was
856 // the last reference to it.
Shuzhen Wang316781a2020-08-18 18:11:01 -0700857 bool dropped = false;
Yin-Chia Yeh5fd603e2019-11-20 11:22:27 -0800858 if (res == NO_INIT || res == DEAD_OBJECT) {
859 ALOGV("Can't return buffer to its stream: %s (%d)", strerror(-res), res);
Shuzhen Wang316781a2020-08-18 18:11:01 -0700860 sessionStatsBuilder.stopCounter(streamId);
Yin-Chia Yeh5fd603e2019-11-20 11:22:27 -0800861 } else if (res != OK) {
862 ALOGE("Can't return buffer to its stream: %s (%d)", strerror(-res), res);
Shuzhen Wang316781a2020-08-18 18:11:01 -0700863 dropped = true;
864 } else {
Emilian Peevf4816702020-04-03 15:44:51 -0700865 if (outputBuffers[i].status == CAMERA_BUFFER_STATUS_ERROR || timestamp == 0) {
Shuzhen Wang316781a2020-08-18 18:11:01 -0700866 dropped = true;
867 }
868 }
869 if (requested) {
870 nsecs_t bufferTimeNs = systemTime();
871 int32_t captureLatencyMs = ns2ms(bufferTimeNs - requestTimeNs);
872 sessionStatsBuilder.incCounter(streamId, dropped, captureLatencyMs);
Yin-Chia Yeh5fd603e2019-11-20 11:22:27 -0800873 }
874
875 // Long processing consumers can cause returnBuffer timeout for shared stream
876 // If that happens, cancel the buffer and send a buffer error to client
877 if (it != outputSurfaces.end() && res == TIMED_OUT &&
Emilian Peevf4816702020-04-03 15:44:51 -0700878 outputBuffers[i].status == CAMERA_BUFFER_STATUS_OK) {
Yin-Chia Yeh5fd603e2019-11-20 11:22:27 -0800879 // cancel the buffer
Emilian Peevf4816702020-04-03 15:44:51 -0700880 camera_stream_buffer_t sb = outputBuffers[i];
881 sb.status = CAMERA_BUFFER_STATUS_ERROR;
Shuzhen Wang90708ea2021-11-04 11:40:49 -0700882 stream->returnBuffer(sb, /*timestamp*/0, /*readoutTimestamp*/0,
Shuzhen Wang316781a2020-08-18 18:11:01 -0700883 timestampIncreasing, std::vector<size_t> (),
Emilian Peev5104fe92021-10-21 14:27:09 -0700884 inResultExtras.frameNumber, transform);
Yin-Chia Yeh5fd603e2019-11-20 11:22:27 -0800885
886 if (listener != nullptr) {
887 CaptureResultExtras extras = inResultExtras;
888 extras.errorStreamId = streamId;
889 listener->notifyError(
890 hardware::camera2::ICameraDeviceCallbacks::ERROR_CAMERA_BUFFER,
891 extras);
892 }
893 }
894 }
895}
896
Shuzhen Wangb7b42652020-05-07 11:59:02 -0700897void returnAndRemovePendingOutputBuffers(bool useHalBufManager,
Shuzhen Wang316781a2020-08-18 18:11:01 -0700898 sp<NotificationListener> listener, InFlightRequest& request,
899 SessionStatsBuilder& sessionStatsBuilder) {
Shuzhen Wang828ade32022-01-10 17:19:02 -0800900 bool timestampIncreasing =
901 !((request.zslCapture && request.stillCapture) || request.hasInputBuffer);
Shuzhen Wangffc4c012022-04-20 15:55:46 -0700902 nsecs_t readoutTimestamp = request.resultExtras.hasReadoutTimestamp ?
903 request.resultExtras.readoutTimestamp : 0;
Shuzhen Wangb7b42652020-05-07 11:59:02 -0700904 returnOutputBuffers(useHalBufManager, listener,
905 request.pendingOutputBuffers.array(),
906 request.pendingOutputBuffers.size(),
Shuzhen Wangffc4c012022-04-20 15:55:46 -0700907 request.shutterTimestamp, readoutTimestamp,
Shuzhen Wang90708ea2021-11-04 11:40:49 -0700908 /*requested*/true, request.requestTimeNs, sessionStatsBuilder, timestampIncreasing,
Shuzhen Wangb7b42652020-05-07 11:59:02 -0700909 request.outputSurfaces, request.resultExtras,
Emilian Peev5104fe92021-10-21 14:27:09 -0700910 request.errorBufStrategy, request.transform);
Shuzhen Wangb7b42652020-05-07 11:59:02 -0700911
912 // Remove error buffers that are not cached.
913 for (auto iter = request.pendingOutputBuffers.begin();
914 iter != request.pendingOutputBuffers.end(); ) {
915 if (request.errorBufStrategy != ERROR_BUF_CACHE ||
Emilian Peevf4816702020-04-03 15:44:51 -0700916 iter->status != CAMERA_BUFFER_STATUS_ERROR) {
Shuzhen Wangb7b42652020-05-07 11:59:02 -0700917 iter = request.pendingOutputBuffers.erase(iter);
918 } else {
919 iter++;
920 }
921 }
922}
923
Emilian Peevf4816702020-04-03 15:44:51 -0700924void notifyShutter(CaptureOutputStates& states, const camera_shutter_msg_t &msg) {
Yin-Chia Yeh5fd603e2019-11-20 11:22:27 -0800925 ATRACE_CALL();
926 ssize_t idx;
927
928 // Set timestamp for the request in the in-flight tracking
929 // and get the request ID to send upstream
930 {
931 std::lock_guard<std::mutex> l(states.inflightLock);
932 InFlightRequestMap& inflightMap = states.inflightMap;
933 idx = inflightMap.indexOfKey(msg.frame_number);
934 if (idx >= 0) {
935 InFlightRequest &r = inflightMap.editValueAt(idx);
936
937 // Verify ordering of shutter notifications
938 {
939 std::lock_guard<std::mutex> l(states.outputLock);
940 // TODO: need to track errors for tighter bounds on expected frame number.
941 if (r.hasInputBuffer) {
942 if (msg.frame_number < states.nextReprocShutterFrameNum) {
943 SET_ERR("Reprocess shutter notification out-of-order. Expected "
944 "notification for frame %d, got frame %d",
945 states.nextReprocShutterFrameNum, msg.frame_number);
946 return;
947 }
948 states.nextReprocShutterFrameNum = msg.frame_number + 1;
949 } else if (r.zslCapture && r.stillCapture) {
950 if (msg.frame_number < states.nextZslShutterFrameNum) {
951 SET_ERR("ZSL still capture shutter notification out-of-order. Expected "
952 "notification for frame %d, got frame %d",
953 states.nextZslShutterFrameNum, msg.frame_number);
954 return;
955 }
956 states.nextZslShutterFrameNum = msg.frame_number + 1;
957 } else {
958 if (msg.frame_number < states.nextShutterFrameNum) {
959 SET_ERR("Shutter notification out-of-order. Expected "
960 "notification for frame %d, got frame %d",
961 states.nextShutterFrameNum, msg.frame_number);
962 return;
963 }
964 states.nextShutterFrameNum = msg.frame_number + 1;
965 }
966 }
967
968 r.shutterTimestamp = msg.timestamp;
Shuzhen Wangffc4c012022-04-20 15:55:46 -0700969 if (msg.readout_timestamp_valid) {
970 r.resultExtras.hasReadoutTimestamp = true;
971 r.resultExtras.readoutTimestamp = msg.readout_timestamp;
972 }
Shuzhen Wang696e4da2022-09-08 14:31:13 -0700973 if (r.minExpectedDuration != states.minFrameDuration ||
974 r.isFixedFps != states.isFixedFps) {
Shuzhen Wang00abbeb2022-02-25 17:14:42 -0800975 for (size_t i = 0; i < states.outputStreams.size(); i++) {
976 auto outputStream = states.outputStreams[i];
Shuzhen Wang696e4da2022-09-08 14:31:13 -0700977 outputStream->onMinDurationChanged(r.minExpectedDuration, r.isFixedFps);
Shuzhen Wang00abbeb2022-02-25 17:14:42 -0800978 }
979 states.minFrameDuration = r.minExpectedDuration;
Shuzhen Wang696e4da2022-09-08 14:31:13 -0700980 states.isFixedFps = r.isFixedFps;
Shuzhen Wang00abbeb2022-02-25 17:14:42 -0800981 }
Yin-Chia Yeh5fd603e2019-11-20 11:22:27 -0800982 if (r.hasCallback) {
983 ALOGVV("Camera %s: %s: Shutter fired for frame %d (id %d) at %" PRId64,
984 states.cameraId.string(), __FUNCTION__,
985 msg.frame_number, r.resultExtras.requestId, msg.timestamp);
986 // Call listener, if any
987 if (states.listener != nullptr) {
Shuzhen Wangb7b42652020-05-07 11:59:02 -0700988 r.resultExtras.lastCompletedRegularFrameNumber =
989 states.lastCompletedRegularFrameNumber;
990 r.resultExtras.lastCompletedReprocessFrameNumber =
991 states.lastCompletedReprocessFrameNumber;
992 r.resultExtras.lastCompletedZslFrameNumber =
993 states.lastCompletedZslFrameNumber;
Yin-Chia Yeh5fd603e2019-11-20 11:22:27 -0800994 states.listener->notifyShutter(r.resultExtras, msg.timestamp);
995 }
996 // send pending result and buffers
Shuzhen Wang3c00b092022-11-08 22:53:07 +0000997 const auto& cameraIdsWithZoom = getCameraIdsWithZoomLocked(
998 inflightMap, r.pendingMetadata, r.cameraIdsWithZoom);
Yin-Chia Yeh5fd603e2019-11-20 11:22:27 -0800999 sendCaptureResult(states,
1000 r.pendingMetadata, r.resultExtras,
1001 r.collectedPartialResult, msg.frame_number,
1002 r.hasInputBuffer, r.zslCapture && r.stillCapture,
Shuzhen Wang3c00b092022-11-08 22:53:07 +00001003 r.rotateAndCropAuto, cameraIdsWithZoom, r.physicalMetadatas);
Yin-Chia Yeh5fd603e2019-11-20 11:22:27 -08001004 }
Shuzhen Wangb7b42652020-05-07 11:59:02 -07001005 returnAndRemovePendingOutputBuffers(
Shuzhen Wang316781a2020-08-18 18:11:01 -07001006 states.useHalBufManager, states.listener, r, states.sessionStatsBuilder);
Yin-Chia Yeh5fd603e2019-11-20 11:22:27 -08001007
1008 removeInFlightRequestIfReadyLocked(states, idx);
1009 }
1010 }
1011 if (idx < 0) {
1012 SET_ERR("Shutter notification for non-existent frame number %d",
1013 msg.frame_number);
1014 }
1015}
1016
Emilian Peevf4816702020-04-03 15:44:51 -07001017void notifyError(CaptureOutputStates& states, const camera_error_msg_t &msg) {
Yin-Chia Yeh5fd603e2019-11-20 11:22:27 -08001018 ATRACE_CALL();
1019 // Map camera HAL error codes to ICameraDeviceCallback error codes
1020 // Index into this with the HAL error code
Emilian Peevf4816702020-04-03 15:44:51 -07001021 static const int32_t halErrorMap[CAMERA_MSG_NUM_ERRORS] = {
Yin-Chia Yeh5fd603e2019-11-20 11:22:27 -08001022 // 0 = Unused error code
1023 hardware::camera2::ICameraDeviceCallbacks::ERROR_CAMERA_INVALID_ERROR,
Emilian Peevf4816702020-04-03 15:44:51 -07001024 // 1 = CAMERA_MSG_ERROR_DEVICE
Yin-Chia Yeh5fd603e2019-11-20 11:22:27 -08001025 hardware::camera2::ICameraDeviceCallbacks::ERROR_CAMERA_DEVICE,
Emilian Peevf4816702020-04-03 15:44:51 -07001026 // 2 = CAMERA_MSG_ERROR_REQUEST
Yin-Chia Yeh5fd603e2019-11-20 11:22:27 -08001027 hardware::camera2::ICameraDeviceCallbacks::ERROR_CAMERA_REQUEST,
Emilian Peevf4816702020-04-03 15:44:51 -07001028 // 3 = CAMERA_MSG_ERROR_RESULT
Yin-Chia Yeh5fd603e2019-11-20 11:22:27 -08001029 hardware::camera2::ICameraDeviceCallbacks::ERROR_CAMERA_RESULT,
Emilian Peevf4816702020-04-03 15:44:51 -07001030 // 4 = CAMERA_MSG_ERROR_BUFFER
Yin-Chia Yeh5fd603e2019-11-20 11:22:27 -08001031 hardware::camera2::ICameraDeviceCallbacks::ERROR_CAMERA_BUFFER
1032 };
1033
1034 int32_t errorCode =
1035 ((msg.error_code >= 0) &&
Emilian Peevf4816702020-04-03 15:44:51 -07001036 (msg.error_code < CAMERA_MSG_NUM_ERRORS)) ?
Yin-Chia Yeh5fd603e2019-11-20 11:22:27 -08001037 halErrorMap[msg.error_code] :
1038 hardware::camera2::ICameraDeviceCallbacks::ERROR_CAMERA_INVALID_ERROR;
1039
1040 int streamId = 0;
1041 String16 physicalCameraId;
1042 if (msg.error_stream != nullptr) {
1043 Camera3Stream *stream =
1044 Camera3Stream::cast(msg.error_stream);
1045 streamId = stream->getId();
1046 physicalCameraId = String16(stream->physicalCameraId());
1047 }
1048 ALOGV("Camera %s: %s: HAL error, frame %d, stream %d: %d",
1049 states.cameraId.string(), __FUNCTION__, msg.frame_number,
1050 streamId, msg.error_code);
1051
1052 CaptureResultExtras resultExtras;
1053 switch (errorCode) {
1054 case hardware::camera2::ICameraDeviceCallbacks::ERROR_CAMERA_DEVICE:
1055 // SET_ERR calls into listener to notify application
1056 SET_ERR("Camera HAL reported serious device error");
1057 break;
1058 case hardware::camera2::ICameraDeviceCallbacks::ERROR_CAMERA_REQUEST:
1059 case hardware::camera2::ICameraDeviceCallbacks::ERROR_CAMERA_RESULT:
Yin-Chia Yeh5fd603e2019-11-20 11:22:27 -08001060 {
1061 std::lock_guard<std::mutex> l(states.inflightLock);
1062 ssize_t idx = states.inflightMap.indexOfKey(msg.frame_number);
1063 if (idx >= 0) {
1064 InFlightRequest &r = states.inflightMap.editValueAt(idx);
1065 r.requestStatus = msg.error_code;
1066 resultExtras = r.resultExtras;
Shuzhen Wangb7b42652020-05-07 11:59:02 -07001067 bool physicalDeviceResultError = false;
Yin-Chia Yeh5fd603e2019-11-20 11:22:27 -08001068 if (hardware::camera2::ICameraDeviceCallbacks::ERROR_CAMERA_RESULT ==
1069 errorCode) {
1070 if (physicalCameraId.size() > 0) {
1071 String8 cameraId(physicalCameraId);
Shuzhen Wang99080502021-03-07 21:08:20 -08001072 bool validPhysicalCameraId =
1073 erasePhysicalCameraIdSet(r.physicalCameraIds, cameraId);
1074 if (!validPhysicalCameraId) {
Yin-Chia Yeh5fd603e2019-11-20 11:22:27 -08001075 ALOGE("%s: Reported result failure for physical camera device: %s "
1076 " which is not part of the respective request!",
1077 __FUNCTION__, cameraId.string());
1078 break;
1079 }
Yin-Chia Yeh5fd603e2019-11-20 11:22:27 -08001080 resultExtras.errorPhysicalCameraId = physicalCameraId;
Shuzhen Wangb7b42652020-05-07 11:59:02 -07001081 physicalDeviceResultError = true;
Yin-Chia Yeh5fd603e2019-11-20 11:22:27 -08001082 }
1083 }
1084
Shuzhen Wangb7b42652020-05-07 11:59:02 -07001085 if (!physicalDeviceResultError) {
Greg Kaiser51b882c2020-06-10 05:41:44 +00001086 r.skipResultMetadata = true;
Shuzhen Wangb7b42652020-05-07 11:59:02 -07001087 if (hardware::camera2::ICameraDeviceCallbacks::ERROR_CAMERA_RESULT
1088 == errorCode) {
1089 r.errorBufStrategy = ERROR_BUF_RETURN_NOTIFY;
1090 } else {
1091 // errorCode is ERROR_CAMERA_REQUEST
1092 r.errorBufStrategy = ERROR_BUF_RETURN;
1093 }
1094
1095 // Check whether the buffers returned. If they returned,
1096 // remove inflight request.
Yin-Chia Yeh5fd603e2019-11-20 11:22:27 -08001097 removeInFlightRequestIfReadyLocked(states, idx);
1098 }
1099 } else {
1100 resultExtras.frameNumber = msg.frame_number;
1101 ALOGE("Camera %s: %s: cannot find in-flight request on "
1102 "frame %" PRId64 " error", states.cameraId.string(), __FUNCTION__,
1103 resultExtras.frameNumber);
1104 }
1105 }
1106 resultExtras.errorStreamId = streamId;
1107 if (states.listener != nullptr) {
1108 states.listener->notifyError(errorCode, resultExtras);
1109 } else {
1110 ALOGE("Camera %s: %s: no listener available",
1111 states.cameraId.string(), __FUNCTION__);
1112 }
1113 break;
Shuzhen Wangb7b42652020-05-07 11:59:02 -07001114 case hardware::camera2::ICameraDeviceCallbacks::ERROR_CAMERA_BUFFER:
1115 // Do not depend on HAL ERROR_CAMERA_BUFFER to send buffer error
1116 // callback to the app. Rather, use STATUS_ERROR of image buffers.
1117 break;
Yin-Chia Yeh5fd603e2019-11-20 11:22:27 -08001118 default:
1119 // SET_ERR calls notifyError
1120 SET_ERR("Unknown error message from HAL: %d", msg.error_code);
1121 break;
1122 }
1123}
1124
Emilian Peevf4816702020-04-03 15:44:51 -07001125void notify(CaptureOutputStates& states, const camera_notify_msg *msg) {
Yin-Chia Yeh5fd603e2019-11-20 11:22:27 -08001126 switch (msg->type) {
Emilian Peevf4816702020-04-03 15:44:51 -07001127 case CAMERA_MSG_ERROR: {
Yin-Chia Yeh5fd603e2019-11-20 11:22:27 -08001128 notifyError(states, msg->message.error);
1129 break;
1130 }
Emilian Peevf4816702020-04-03 15:44:51 -07001131 case CAMERA_MSG_SHUTTER: {
Yin-Chia Yeh5fd603e2019-11-20 11:22:27 -08001132 notifyShutter(states, msg->message.shutter);
1133 break;
1134 }
1135 default:
1136 SET_ERR("Unknown notify message from HAL: %d",
1137 msg->type);
1138 }
1139}
1140
Yin-Chia Yeh5fd603e2019-11-20 11:22:27 -08001141void flushInflightRequests(FlushInflightReqStates& states) {
1142 ATRACE_CALL();
Shuzhen Wang316781a2020-08-18 18:11:01 -07001143 { // First return buffers cached in inFlightMap
Yin-Chia Yeh5fd603e2019-11-20 11:22:27 -08001144 std::lock_guard<std::mutex> l(states.inflightLock);
1145 for (size_t idx = 0; idx < states.inflightMap.size(); idx++) {
Greg Kaiser51b882c2020-06-10 05:41:44 +00001146 const InFlightRequest &request = states.inflightMap.valueAt(idx);
1147 returnOutputBuffers(
Yin-Chia Yeh5fd603e2019-11-20 11:22:27 -08001148 states.useHalBufManager, states.listener,
1149 request.pendingOutputBuffers.array(),
Shuzhen Wang90708ea2021-11-04 11:40:49 -07001150 request.pendingOutputBuffers.size(), /*timestamp*/0, /*readoutTimestamp*/0,
1151 /*requested*/true, request.requestTimeNs, states.sessionStatsBuilder,
1152 /*timestampIncreasing*/true, request.outputSurfaces, request.resultExtras,
1153 request.errorBufStrategy);
Shuzhen Wangb7b42652020-05-07 11:59:02 -07001154 ALOGW("%s: Frame %d | Timestamp: %" PRId64 ", metadata"
1155 " arrived: %s, buffers left: %d.\n", __FUNCTION__,
1156 states.inflightMap.keyAt(idx), request.shutterTimestamp,
1157 request.haveResultMetadata ? "true" : "false",
1158 request.numBuffersLeft);
Yin-Chia Yeh5fd603e2019-11-20 11:22:27 -08001159 }
Shuzhen Wangb7b42652020-05-07 11:59:02 -07001160
Yin-Chia Yeh5fd603e2019-11-20 11:22:27 -08001161 states.inflightMap.clear();
1162 states.inflightIntf.onInflightMapFlushedLocked();
1163 }
1164
1165 // Then return all inflight buffers not returned by HAL
1166 std::vector<std::pair<int32_t, int32_t>> inflightKeys;
1167 states.flushBufferIntf.getInflightBufferKeys(&inflightKeys);
1168
1169 // Inflight buffers for HAL buffer manager
1170 std::vector<uint64_t> inflightRequestBufferKeys;
1171 states.flushBufferIntf.getInflightRequestBufferKeys(&inflightRequestBufferKeys);
1172
1173 // (streamId, frameNumber, buffer_handle_t*) tuple for all inflight buffers.
1174 // frameNumber will be -1 for buffers from HAL buffer manager
1175 std::vector<std::tuple<int32_t, int32_t, buffer_handle_t*>> inflightBuffers;
1176 inflightBuffers.reserve(inflightKeys.size() + inflightRequestBufferKeys.size());
1177
1178 for (auto& pair : inflightKeys) {
1179 int32_t frameNumber = pair.first;
1180 int32_t streamId = pair.second;
1181 buffer_handle_t* buffer;
1182 status_t res = states.bufferRecordsIntf.popInflightBuffer(frameNumber, streamId, &buffer);
1183 if (res != OK) {
1184 ALOGE("%s: Frame %d: No in-flight buffer for stream %d",
1185 __FUNCTION__, frameNumber, streamId);
1186 continue;
1187 }
1188 inflightBuffers.push_back(std::make_tuple(streamId, frameNumber, buffer));
1189 }
1190
1191 for (auto& bufferId : inflightRequestBufferKeys) {
1192 int32_t streamId = -1;
1193 buffer_handle_t* buffer = nullptr;
1194 status_t res = states.bufferRecordsIntf.popInflightRequestBuffer(
1195 bufferId, &buffer, &streamId);
1196 if (res != OK) {
1197 ALOGE("%s: cannot find in-flight buffer %" PRIu64, __FUNCTION__, bufferId);
1198 continue;
1199 }
1200 inflightBuffers.push_back(std::make_tuple(streamId, /*frameNumber*/-1, buffer));
1201 }
1202
1203 std::vector<sp<Camera3StreamInterface>> streams = states.flushBufferIntf.getAllStreams();
1204
1205 for (auto& tuple : inflightBuffers) {
1206 status_t res = OK;
1207 int32_t streamId = std::get<0>(tuple);
1208 int32_t frameNumber = std::get<1>(tuple);
1209 buffer_handle_t* buffer = std::get<2>(tuple);
1210
Emilian Peevf4816702020-04-03 15:44:51 -07001211 camera_stream_buffer_t streamBuffer;
Yin-Chia Yeh5fd603e2019-11-20 11:22:27 -08001212 streamBuffer.buffer = buffer;
Emilian Peevf4816702020-04-03 15:44:51 -07001213 streamBuffer.status = CAMERA_BUFFER_STATUS_ERROR;
Yin-Chia Yeh5fd603e2019-11-20 11:22:27 -08001214 streamBuffer.acquire_fence = -1;
1215 streamBuffer.release_fence = -1;
1216
1217 for (auto& stream : streams) {
1218 if (streamId == stream->getId()) {
1219 // Return buffer to deleted stream
Emilian Peevf4816702020-04-03 15:44:51 -07001220 camera_stream* halStream = stream->asHalStream();
Yin-Chia Yeh5fd603e2019-11-20 11:22:27 -08001221 streamBuffer.stream = halStream;
1222 switch (halStream->stream_type) {
Emilian Peevf4816702020-04-03 15:44:51 -07001223 case CAMERA_STREAM_OUTPUT:
Yin-Chia Yeh5fd603e2019-11-20 11:22:27 -08001224 res = stream->returnBuffer(streamBuffer, /*timestamp*/ 0,
Shuzhen Wang90708ea2021-11-04 11:40:49 -07001225 /*readoutTimestamp*/0, /*timestampIncreasing*/true,
Shuzhen Wang316781a2020-08-18 18:11:01 -07001226 std::vector<size_t> (), frameNumber);
Yin-Chia Yeh5fd603e2019-11-20 11:22:27 -08001227 if (res != OK) {
1228 ALOGE("%s: Can't return output buffer for frame %d to"
1229 " stream %d: %s (%d)", __FUNCTION__,
1230 frameNumber, streamId, strerror(-res), res);
1231 }
1232 break;
Emilian Peevf4816702020-04-03 15:44:51 -07001233 case CAMERA_STREAM_INPUT:
Yin-Chia Yeh5fd603e2019-11-20 11:22:27 -08001234 res = stream->returnInputBuffer(streamBuffer);
1235 if (res != OK) {
1236 ALOGE("%s: Can't return input buffer for frame %d to"
1237 " stream %d: %s (%d)", __FUNCTION__,
1238 frameNumber, streamId, strerror(-res), res);
1239 }
1240 break;
1241 default: // Bi-direcitonal stream is deprecated
1242 ALOGE("%s: stream %d has unknown stream type %d",
1243 __FUNCTION__, streamId, halStream->stream_type);
1244 break;
1245 }
1246 break;
1247 }
1248 }
1249 }
1250}
1251
1252} // camera3
1253} // namespace android