Camera3Stream.cpp revision 13c878f07fb36a49aade20cec684ed8e12724751
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-Stream" 18#define ATRACE_TAG ATRACE_TAG_CAMERA 19//#define LOG_NDEBUG 0 20 21#include <utils/Log.h> 22#include <utils/Trace.h> 23#include "device3/Camera3Stream.h" 24#include "device3/StatusTracker.h" 25 26#include <cutils/properties.h> 27 28namespace android { 29 30namespace camera3 { 31 32Camera3Stream::~Camera3Stream() { 33 sp<StatusTracker> statusTracker = mStatusTracker.promote(); 34 if (statusTracker != 0 && mStatusId != StatusTracker::NO_STATUS_ID) { 35 statusTracker->removeComponent(mStatusId); 36 } 37} 38 39Camera3Stream* Camera3Stream::cast(camera3_stream *stream) { 40 return static_cast<Camera3Stream*>(stream); 41} 42 43const Camera3Stream* Camera3Stream::cast(const camera3_stream *stream) { 44 return static_cast<const Camera3Stream*>(stream); 45} 46 47Camera3Stream::Camera3Stream(int id, 48 camera3_stream_type type, 49 uint32_t width, uint32_t height, size_t maxSize, int format) : 50 camera3_stream(), 51 mId(id), 52 mName(String8::format("Camera3Stream[%d]", id)), 53 mMaxSize(maxSize), 54 mState(STATE_CONSTRUCTED), 55 mStatusId(StatusTracker::NO_STATUS_ID) { 56 57 camera3_stream::stream_type = type; 58 camera3_stream::width = width; 59 camera3_stream::height = height; 60 camera3_stream::format = format; 61 camera3_stream::usage = 0; 62 camera3_stream::max_buffers = 0; 63 camera3_stream::priv = NULL; 64 65 if (format == HAL_PIXEL_FORMAT_BLOB && maxSize == 0) { 66 ALOGE("%s: BLOB format with size == 0", __FUNCTION__); 67 mState = STATE_ERROR; 68 } 69} 70 71int Camera3Stream::getId() const { 72 return mId; 73} 74 75uint32_t Camera3Stream::getWidth() const { 76 return camera3_stream::width; 77} 78 79uint32_t Camera3Stream::getHeight() const { 80 return camera3_stream::height; 81} 82 83int Camera3Stream::getFormat() const { 84 return camera3_stream::format; 85} 86 87camera3_stream* Camera3Stream::startConfiguration() { 88 ATRACE_CALL(); 89 Mutex::Autolock l(mLock); 90 status_t res; 91 92 switch (mState) { 93 case STATE_ERROR: 94 ALOGE("%s: In error state", __FUNCTION__); 95 return NULL; 96 case STATE_CONSTRUCTED: 97 // OK 98 break; 99 case STATE_IN_CONFIG: 100 case STATE_IN_RECONFIG: 101 // Can start config again with no trouble; but don't redo 102 // oldUsage/oldMaxBuffers 103 return this; 104 case STATE_CONFIGURED: 105 if (stream_type == CAMERA3_STREAM_INPUT) { 106 ALOGE("%s: Cannot configure an input stream twice", 107 __FUNCTION__); 108 return NULL; 109 } else if (hasOutstandingBuffersLocked()) { 110 ALOGE("%s: Cannot configure stream; has outstanding buffers", 111 __FUNCTION__); 112 return NULL; 113 } 114 break; 115 default: 116 ALOGE("%s: Unknown state %d", __FUNCTION__, mState); 117 return NULL; 118 } 119 120 oldUsage = camera3_stream::usage; 121 oldMaxBuffers = camera3_stream::max_buffers; 122 123 res = getEndpointUsage(&(camera3_stream::usage)); 124 if (res != OK) { 125 ALOGE("%s: Cannot query consumer endpoint usage!", 126 __FUNCTION__); 127 return NULL; 128 } 129 130 // Stop tracking if currently doing so 131 if (mStatusId != StatusTracker::NO_STATUS_ID) { 132 sp<StatusTracker> statusTracker = mStatusTracker.promote(); 133 if (statusTracker != 0) { 134 statusTracker->removeComponent(mStatusId); 135 } 136 mStatusId = StatusTracker::NO_STATUS_ID; 137 } 138 139 if (mState == STATE_CONSTRUCTED) { 140 mState = STATE_IN_CONFIG; 141 } else { // mState == STATE_CONFIGURED 142 LOG_ALWAYS_FATAL_IF(mState != STATE_CONFIGURED, "Invalid state: 0x%x", mState); 143 mState = STATE_IN_RECONFIG; 144 } 145 146 return this; 147} 148 149bool Camera3Stream::isConfiguring() const { 150 Mutex::Autolock l(mLock); 151 return (mState == STATE_IN_CONFIG) || (mState == STATE_IN_RECONFIG); 152} 153 154status_t Camera3Stream::finishConfiguration(camera3_device *hal3Device) { 155 ATRACE_CALL(); 156 Mutex::Autolock l(mLock); 157 switch (mState) { 158 case STATE_ERROR: 159 ALOGE("%s: In error state", __FUNCTION__); 160 return INVALID_OPERATION; 161 case STATE_IN_CONFIG: 162 case STATE_IN_RECONFIG: 163 // OK 164 break; 165 case STATE_CONSTRUCTED: 166 case STATE_CONFIGURED: 167 ALOGE("%s: Cannot finish configuration that hasn't been started", 168 __FUNCTION__); 169 return INVALID_OPERATION; 170 default: 171 ALOGE("%s: Unknown state", __FUNCTION__); 172 return INVALID_OPERATION; 173 } 174 175 // Register for idle tracking 176 sp<StatusTracker> statusTracker = mStatusTracker.promote(); 177 if (statusTracker != 0) { 178 mStatusId = statusTracker->addComponent(); 179 } 180 181 // Check if the stream configuration is unchanged, and skip reallocation if 182 // so. As documented in hardware/camera3.h:configure_streams(). 183 if (mState == STATE_IN_RECONFIG && 184 oldUsage == camera3_stream::usage && 185 oldMaxBuffers == camera3_stream::max_buffers) { 186 mState = STATE_CONFIGURED; 187 return OK; 188 } 189 190 status_t res; 191 res = configureQueueLocked(); 192 if (res != OK) { 193 ALOGE("%s: Unable to configure stream %d queue: %s (%d)", 194 __FUNCTION__, mId, strerror(-res), res); 195 mState = STATE_ERROR; 196 return res; 197 } 198 199 res = registerBuffersLocked(hal3Device); 200 if (res != OK) { 201 ALOGE("%s: Unable to register stream buffers with HAL: %s (%d)", 202 __FUNCTION__, strerror(-res), res); 203 mState = STATE_ERROR; 204 return res; 205 } 206 207 mState = STATE_CONFIGURED; 208 209 return res; 210} 211 212status_t Camera3Stream::getBuffer(camera3_stream_buffer *buffer) { 213 ATRACE_CALL(); 214 Mutex::Autolock l(mLock); 215 status_t res = OK; 216 217 // This function should be only called when the stream is configured already. 218 if (mState != STATE_CONFIGURED) { 219 ALOGE("%s: Stream %d: Can't get buffers if stream is not in CONFIGURED state %d", 220 __FUNCTION__, mId, mState); 221 return INVALID_OPERATION; 222 } 223 224 // Wait for new buffer returned back if we are running into the limit. 225 if (getHandoutOutputBufferCountLocked() == camera3_stream::max_buffers) { 226 ALOGV("%s: Already dequeued max output buffers (%d), wait for next returned one.", 227 __FUNCTION__, camera3_stream::max_buffers); 228 res = mOutputBufferReturnedSignal.waitRelative(mLock, kWaitForBufferDuration); 229 if (res != OK) { 230 if (res == TIMED_OUT) { 231 ALOGE("%s: wait for output buffer return timed out after %lldms", __FUNCTION__, 232 kWaitForBufferDuration / 1000000LL); 233 } 234 return res; 235 } 236 } 237 238 res = getBufferLocked(buffer); 239 if (res == OK) { 240 fireBufferListenersLocked(*buffer, /*acquired*/true, /*output*/true); 241 } 242 243 return res; 244} 245 246status_t Camera3Stream::returnBuffer(const camera3_stream_buffer &buffer, 247 nsecs_t timestamp) { 248 ATRACE_CALL(); 249 Mutex::Autolock l(mLock); 250 251 /** 252 * TODO: Check that the state is valid first. 253 * 254 * <HAL3.2 IN_CONFIG and IN_RECONFIG in addition to CONFIGURED. 255 * >= HAL3.2 CONFIGURED only 256 * 257 * Do this for getBuffer as well. 258 */ 259 status_t res = returnBufferLocked(buffer, timestamp); 260 if (res == OK) { 261 fireBufferListenersLocked(buffer, /*acquired*/false, /*output*/true); 262 mOutputBufferReturnedSignal.signal(); 263 } 264 265 return res; 266} 267 268status_t Camera3Stream::getInputBuffer(camera3_stream_buffer *buffer) { 269 ATRACE_CALL(); 270 Mutex::Autolock l(mLock); 271 status_t res = OK; 272 273 // This function should be only called when the stream is configured already. 274 if (mState != STATE_CONFIGURED) { 275 ALOGE("%s: Stream %d: Can't get input buffers if stream is not in CONFIGURED state %d", 276 __FUNCTION__, mId, mState); 277 return INVALID_OPERATION; 278 } 279 280 // Wait for new buffer returned back if we are running into the limit. 281 if (getHandoutInputBufferCountLocked() == camera3_stream::max_buffers) { 282 ALOGV("%s: Already dequeued max input buffers (%d), wait for next returned one.", 283 __FUNCTION__, camera3_stream::max_buffers); 284 res = mInputBufferReturnedSignal.waitRelative(mLock, kWaitForBufferDuration); 285 if (res != OK) { 286 if (res == TIMED_OUT) { 287 ALOGE("%s: wait for input buffer return timed out after %lldms", __FUNCTION__, 288 kWaitForBufferDuration / 1000000LL); 289 } 290 return res; 291 } 292 } 293 294 res = getInputBufferLocked(buffer); 295 if (res == OK) { 296 fireBufferListenersLocked(*buffer, /*acquired*/true, /*output*/false); 297 } 298 299 return res; 300} 301 302status_t Camera3Stream::returnInputBuffer(const camera3_stream_buffer &buffer) { 303 ATRACE_CALL(); 304 Mutex::Autolock l(mLock); 305 306 status_t res = returnInputBufferLocked(buffer); 307 if (res == OK) { 308 fireBufferListenersLocked(buffer, /*acquired*/false, /*output*/false); 309 mInputBufferReturnedSignal.signal(); 310 } 311 return res; 312} 313 314void Camera3Stream::fireBufferListenersLocked( 315 const camera3_stream_buffer& /*buffer*/, bool acquired, bool output) { 316 List<wp<Camera3StreamBufferListener> >::iterator it, end; 317 318 // TODO: finish implementing 319 320 Camera3StreamBufferListener::BufferInfo info = 321 Camera3StreamBufferListener::BufferInfo(); 322 info.mOutput = output; 323 // TODO: rest of fields 324 325 for (it = mBufferListenerList.begin(), end = mBufferListenerList.end(); 326 it != end; 327 ++it) { 328 329 sp<Camera3StreamBufferListener> listener = it->promote(); 330 if (listener != 0) { 331 if (acquired) { 332 listener->onBufferAcquired(info); 333 } else { 334 listener->onBufferReleased(info); 335 } 336 } 337 } 338} 339 340bool Camera3Stream::hasOutstandingBuffers() const { 341 ATRACE_CALL(); 342 Mutex::Autolock l(mLock); 343 return hasOutstandingBuffersLocked(); 344} 345 346status_t Camera3Stream::setStatusTracker(sp<StatusTracker> statusTracker) { 347 Mutex::Autolock l(mLock); 348 sp<StatusTracker> oldTracker = mStatusTracker.promote(); 349 if (oldTracker != 0 && mStatusId != StatusTracker::NO_STATUS_ID) { 350 oldTracker->removeComponent(mStatusId); 351 } 352 mStatusId = StatusTracker::NO_STATUS_ID; 353 mStatusTracker = statusTracker; 354 355 return OK; 356} 357 358status_t Camera3Stream::disconnect() { 359 ATRACE_CALL(); 360 Mutex::Autolock l(mLock); 361 ALOGV("%s: Stream %d: Disconnecting...", __FUNCTION__, mId); 362 status_t res = disconnectLocked(); 363 364 if (res == -ENOTCONN) { 365 // "Already disconnected" -- not an error 366 return OK; 367 } else { 368 return res; 369 } 370} 371 372status_t Camera3Stream::registerBuffersLocked(camera3_device *hal3Device) { 373 ATRACE_CALL(); 374 375 /** 376 * >= CAMERA_DEVICE_API_VERSION_3_2: 377 * 378 * camera3_device_t->ops->register_stream_buffers() is not called and must 379 * be NULL. 380 */ 381 if (hal3Device->common.version >= CAMERA_DEVICE_API_VERSION_3_2) { 382 ALOGV("%s: register_stream_buffers unused as of HAL3.2", __FUNCTION__); 383 384 /** 385 * Skip the NULL check if camera.dev.register_stream is 1. 386 * 387 * For development-validation purposes only. 388 * 389 * TODO: Remove the property check before shipping L (b/13914251). 390 */ 391 char value[PROPERTY_VALUE_MAX] = { '\0', }; 392 property_get("camera.dev.register_stream", value, "0"); 393 int propInt = atoi(value); 394 395 if (propInt == 0 && hal3Device->ops->register_stream_buffers != NULL) { 396 ALOGE("%s: register_stream_buffers is deprecated in HAL3.2; " 397 "must be set to NULL in camera3_device::ops", __FUNCTION__); 398 return INVALID_OPERATION; 399 } else { 400 ALOGD("%s: Skipping NULL check for deprecated register_stream_buffers", __FUNCTION__); 401 } 402 403 return OK; 404 } else { 405 ALOGV("%s: register_stream_buffers using deprecated code path", __FUNCTION__); 406 } 407 408 status_t res; 409 410 size_t bufferCount = getBufferCountLocked(); 411 412 Vector<buffer_handle_t*> buffers; 413 buffers.insertAt(/*prototype_item*/NULL, /*index*/0, bufferCount); 414 415 camera3_stream_buffer_set bufferSet = camera3_stream_buffer_set(); 416 bufferSet.stream = this; 417 bufferSet.num_buffers = bufferCount; 418 bufferSet.buffers = buffers.editArray(); 419 420 Vector<camera3_stream_buffer_t> streamBuffers; 421 streamBuffers.insertAt(camera3_stream_buffer_t(), /*index*/0, bufferCount); 422 423 // Register all buffers with the HAL. This means getting all the buffers 424 // from the stream, providing them to the HAL with the 425 // register_stream_buffers() method, and then returning them back to the 426 // stream in the error state, since they won't have valid data. 427 // 428 // Only registered buffers can be sent to the HAL. 429 430 uint32_t bufferIdx = 0; 431 for (; bufferIdx < bufferCount; bufferIdx++) { 432 res = getBufferLocked( &streamBuffers.editItemAt(bufferIdx) ); 433 if (res != OK) { 434 ALOGE("%s: Unable to get buffer %d for registration with HAL", 435 __FUNCTION__, bufferIdx); 436 // Skip registering, go straight to cleanup 437 break; 438 } 439 440 sp<Fence> fence = new Fence(streamBuffers[bufferIdx].acquire_fence); 441 fence->waitForever("Camera3Stream::registerBuffers"); 442 443 buffers.editItemAt(bufferIdx) = streamBuffers[bufferIdx].buffer; 444 } 445 if (bufferIdx == bufferCount) { 446 // Got all buffers, register with HAL 447 ALOGV("%s: Registering %zu buffers with camera HAL", 448 __FUNCTION__, bufferCount); 449 ATRACE_BEGIN("camera3->register_stream_buffers"); 450 res = hal3Device->ops->register_stream_buffers(hal3Device, 451 &bufferSet); 452 ATRACE_END(); 453 } 454 455 // Return all valid buffers to stream, in ERROR state to indicate 456 // they weren't filled. 457 for (size_t i = 0; i < bufferIdx; i++) { 458 streamBuffers.editItemAt(i).release_fence = -1; 459 streamBuffers.editItemAt(i).status = CAMERA3_BUFFER_STATUS_ERROR; 460 returnBufferLocked(streamBuffers[i], 0); 461 } 462 463 return res; 464} 465 466status_t Camera3Stream::getBufferLocked(camera3_stream_buffer *) { 467 ALOGE("%s: This type of stream does not support output", __FUNCTION__); 468 return INVALID_OPERATION; 469} 470status_t Camera3Stream::returnBufferLocked(const camera3_stream_buffer &, 471 nsecs_t) { 472 ALOGE("%s: This type of stream does not support output", __FUNCTION__); 473 return INVALID_OPERATION; 474} 475status_t Camera3Stream::getInputBufferLocked(camera3_stream_buffer *) { 476 ALOGE("%s: This type of stream does not support input", __FUNCTION__); 477 return INVALID_OPERATION; 478} 479status_t Camera3Stream::returnInputBufferLocked( 480 const camera3_stream_buffer &) { 481 ALOGE("%s: This type of stream does not support input", __FUNCTION__); 482 return INVALID_OPERATION; 483} 484 485void Camera3Stream::addBufferListener( 486 wp<Camera3StreamBufferListener> listener) { 487 Mutex::Autolock l(mLock); 488 mBufferListenerList.push_back(listener); 489} 490 491void Camera3Stream::removeBufferListener( 492 const sp<Camera3StreamBufferListener>& listener) { 493 Mutex::Autolock l(mLock); 494 495 bool erased = true; 496 List<wp<Camera3StreamBufferListener> >::iterator it, end; 497 for (it = mBufferListenerList.begin(), end = mBufferListenerList.end(); 498 it != end; 499 ) { 500 501 if (*it == listener) { 502 it = mBufferListenerList.erase(it); 503 erased = true; 504 } else { 505 ++it; 506 } 507 } 508 509 if (!erased) { 510 ALOGW("%s: Could not find listener to remove, already removed", 511 __FUNCTION__); 512 } 513} 514 515}; // namespace camera3 516 517}; // namespace android 518