libs/ui/tests/BufferHubBuffer_test.cpp

/*
 * Copyright 2018 The Android Open Source Project
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

#define LOG_TAG "BufferHubBufferTest"

#include <errno.h>
#include <sys/epoll.h>

#include <android/frameworks/bufferhub/1.0/IBufferHub.h>
#include <android/hardware_buffer.h>
#include <cutils/native_handle.h>
#include <gmock/gmock.h>
#include <gtest/gtest.h>
#include <hidl/ServiceManagement.h>
#include <hwbinder/IPCThreadState.h>
#include <ui/BufferHubBuffer.h>
#include <ui/BufferHubEventFd.h>

namespace android {

namespace {

using ::android::BufferHubDefs::isAnyClientAcquired;
using ::android::BufferHubDefs::isAnyClientGained;
using ::android::BufferHubDefs::isAnyClientPosted;
using ::android::BufferHubDefs::isClientAcquired;
using ::android::BufferHubDefs::isClientGained;
using ::android::BufferHubDefs::isClientPosted;
using ::android::BufferHubDefs::isClientReleased;
using ::android::BufferHubDefs::kMetadataHeaderSize;
using ::android::frameworks::bufferhub::V1_0::IBufferHub;
using ::testing::IsNull;
using ::testing::NotNull;

const int kWidth = 640;
const int kHeight = 480;
const int kLayerCount = 1;
const int kFormat = HAL_PIXEL_FORMAT_RGBA_8888;
const int kUsage = 0;
const AHardwareBuffer_Desc kDesc = {kWidth, kHeight,        kLayerCount,  kFormat,
                                    kUsage, /*stride=*/0UL, /*rfu0=*/0UL, /*rfu1=*/0ULL};
const size_t kUserMetadataSize = 1;

class BufferHubBufferTest : public ::testing::Test {
protected:
    void SetUp() override {
        android::hardware::ProcessState::self()->startThreadPool();

        if (!BufferHubServiceRunning()) {
            // TODO(b/112940221): Enforce the test cross all devices once BufferHub lands in Android
            // R for all Android varieties.
            GTEST_SKIP() << "Skip test as the BufferHub service is not running.";
        }
    }

    bool BufferHubServiceRunning() {
        sp<IBufferHub> bufferhub = IBufferHub::getService();
        return bufferhub.get() != nullptr;
    }
};

bool cmpAHardwareBufferDesc(const AHardwareBuffer_Desc& desc, const AHardwareBuffer_Desc& other) {
    // Not comparing stride because it's unknown before allocation
    return desc.format == other.format && desc.height == other.height &&
            desc.layers == other.layers && desc.usage == other.usage && desc.width == other.width;
}

class BufferHubBufferStateTransitionTest : public BufferHubBufferTest {
protected:
    void SetUp() override {
        BufferHubBufferTest::SetUp();

        if (IsSkipped()) {
            // If the base class' SetUp() stated the test should be skipped, we should short
            // circuit this sub-class' logic.
            return;
        }

        CreateTwoClientsOfABuffer();
    }

    std::unique_ptr<BufferHubBuffer> b1;
    uint32_t b1ClientMask = 0U;
    std::unique_ptr<BufferHubBuffer> b2;
    uint32_t b2ClientMask = 0U;

private:
    // Creates b1 and b2 as the clients of the same buffer for testing.
    void CreateTwoClientsOfABuffer();
};

void BufferHubBufferStateTransitionTest::CreateTwoClientsOfABuffer() {
    b1 = BufferHubBuffer::create(kWidth, kHeight, kLayerCount, kFormat, kUsage, kUserMetadataSize);
    ASSERT_THAT(b1, NotNull());
    b1ClientMask = b1->clientStateMask();
    ASSERT_NE(b1ClientMask, 0U);

    sp<NativeHandle> token = b1->duplicate();
    ASSERT_THAT(token, NotNull());

    b2 = BufferHubBuffer::import(token);
    ASSERT_THAT(b2, NotNull());

    b2ClientMask = b2->clientStateMask();
    ASSERT_NE(b2ClientMask, 0U);
    ASSERT_NE(b2ClientMask, b1ClientMask);
}

TEST_F(BufferHubBufferTest, CreateBufferFails) {
    // Buffer Creation will fail: BLOB format requires height to be 1.
    auto b1 = BufferHubBuffer::create(kWidth, /*height=*/2, kLayerCount,
                                      /*format=*/HAL_PIXEL_FORMAT_BLOB, kUsage, kUserMetadataSize);

    EXPECT_THAT(b1, IsNull());

    // Buffer Creation will fail: user metadata size too large.
    auto b2 = BufferHubBuffer::create(kWidth, kHeight, kLayerCount, kFormat, kUsage,
                                      /*userMetadataSize=*/std::numeric_limits<size_t>::max());

    EXPECT_THAT(b2, IsNull());

    // Buffer Creation will fail: user metadata size too large.
    const size_t userMetadataSize = std::numeric_limits<size_t>::max() - kMetadataHeaderSize;
    auto b3 = BufferHubBuffer::create(kWidth, kHeight, kLayerCount, kFormat, kUsage,
                                      userMetadataSize);

    EXPECT_THAT(b3, IsNull());
}

TEST_F(BufferHubBufferTest, CreateBuffer) {
    auto b1 = BufferHubBuffer::create(kWidth, kHeight, kLayerCount, kFormat, kUsage,
                                      kUserMetadataSize);
    ASSERT_THAT(b1, NotNull());
    EXPECT_TRUE(b1->isConnected());
    EXPECT_TRUE(b1->isValid());
    EXPECT_TRUE(cmpAHardwareBufferDesc(b1->desc(), kDesc));
    EXPECT_EQ(b1->userMetadataSize(), kUserMetadataSize);
}

TEST_F(BufferHubBufferTest, DuplicateAndImportBuffer) {
    auto b1 = BufferHubBuffer::create(kWidth, kHeight, kLayerCount, kFormat, kUsage,
                                      kUserMetadataSize);
    ASSERT_THAT(b1, NotNull());
    EXPECT_TRUE(b1->isValid());

    sp<NativeHandle> token = b1->duplicate();
    ASSERT_THAT(token, NotNull());

    // The detached buffer should still be valid.
    EXPECT_TRUE(b1->isConnected());
    EXPECT_TRUE(b1->isValid());

    std::unique_ptr<BufferHubBuffer> b2 = BufferHubBuffer::import(token);

    ASSERT_THAT(b2, NotNull());
    EXPECT_TRUE(b2->isValid());

    EXPECT_TRUE(cmpAHardwareBufferDesc(b1->desc(), b2->desc()));
    EXPECT_EQ(b1->userMetadataSize(), b2->userMetadataSize());

    // These two buffer instances are based on the same physical buffer under the
    // hood, so they should share the same id.
    EXPECT_EQ(b1->id(), b2->id());
    // We use clientStateMask() to tell those two instances apart.
    EXPECT_NE(b1->clientStateMask(), b2->clientStateMask());

    // Both buffer instances should be in released state currently.
    EXPECT_TRUE(b1->isReleased());
    EXPECT_TRUE(b2->isReleased());

    // The event fd should behave like duped event fds.
    const BufferHubEventFd& eventFd1 = b1->eventFd();
    ASSERT_GE(eventFd1.get(), 0);
    const BufferHubEventFd& eventFd2 = b2->eventFd();
    ASSERT_GE(eventFd2.get(), 0);

    base::unique_fd epollFd(epoll_create(64));
    ASSERT_GE(epollFd.get(), 0);

    // Add eventFd1 to epoll set, and signal eventFd2.
    epoll_event e = {.events = EPOLLIN | EPOLLET, .data = {.u32 = 0}};
    ASSERT_EQ(epoll_ctl(epollFd.get(), EPOLL_CTL_ADD, eventFd1.get(), &e), 0) << strerror(errno);

    std::array<epoll_event, 1> events;
    EXPECT_EQ(epoll_wait(epollFd.get(), events.data(), events.size(), 0), 0);

    eventFd2.signal();
    EXPECT_EQ(epoll_wait(epollFd.get(), events.data(), events.size(), 0), 1);

    // The epoll fd is edge triggered, so it only responds to the eventFd once.
    EXPECT_EQ(epoll_wait(epollFd.get(), events.data(), events.size(), 0), 0);

    eventFd2.signal();
    eventFd2.clear();
    EXPECT_EQ(epoll_wait(epollFd.get(), events.data(), events.size(), 0), 0);
}

TEST_F(BufferHubBufferTest, ImportFreedBuffer) {
    auto b1 = BufferHubBuffer::create(kWidth, kHeight, kLayerCount, kFormat, kUsage,
                                      kUserMetadataSize);
    ASSERT_THAT(b1, NotNull());
    EXPECT_TRUE(b1->isValid());

    sp<NativeHandle> token = b1->duplicate();
    ASSERT_THAT(token, NotNull());

    // Explicitly destroy b1. Backend buffer should be freed and token becomes invalid
    b1.reset();

    std::unique_ptr<BufferHubBuffer> b2 = BufferHubBuffer::import(token);

    // Import should fail with INVALID_TOKEN
    EXPECT_THAT(b2, IsNull());
}

// nullptr must not crash the service
TEST_F(BufferHubBufferTest, ImportNullToken) {
    auto b1 = BufferHubBuffer::import(nullptr);
    EXPECT_THAT(b1, IsNull());
}

TEST_F(BufferHubBufferTest, ImportInvalidToken) {
    native_handle_t* token = native_handle_create(/*numFds=*/0, /*numInts=*/1);
    token->data[0] = 0;

    sp<NativeHandle> tokenHandle = NativeHandle::create(token, /*ownHandle=*/true);
    auto b1 = BufferHubBuffer::import(tokenHandle);

    EXPECT_THAT(b1, IsNull());
}

TEST_F(BufferHubBufferStateTransitionTest, GainBuffer_fromReleasedState) {
    ASSERT_TRUE(b1->isReleased());

    // Successful gaining the buffer should change the buffer state bit of b1 to
    // gained state, other client state bits to released state.
    EXPECT_EQ(b1->gain(), 0);
    EXPECT_TRUE(isClientGained(b1->bufferState(), b1ClientMask));
}

TEST_F(BufferHubBufferStateTransitionTest, GainBuffer_fromGainedState) {
    ASSERT_EQ(b1->gain(), 0);
    auto currentBufferState = b1->bufferState();
    ASSERT_TRUE(isClientGained(currentBufferState, b1ClientMask));

    // Gaining from gained state by the same client should not return error.
    EXPECT_EQ(b1->gain(), 0);

    // Gaining from gained state by another client should return error.
    EXPECT_EQ(b2->gain(), -EBUSY);
}

TEST_F(BufferHubBufferStateTransitionTest, GainBuffer_fromAcquiredState) {
    ASSERT_EQ(b1->gain(), 0);
    ASSERT_EQ(b1->post(), 0);
    ASSERT_EQ(b2->acquire(), 0);
    ASSERT_TRUE(isAnyClientAcquired(b1->bufferState()));

    // Gaining from acquired state should fail.
    EXPECT_EQ(b1->gain(), -EBUSY);
    EXPECT_EQ(b2->gain(), -EBUSY);
}

TEST_F(BufferHubBufferStateTransitionTest, GainBuffer_fromOtherClientInPostedState) {
    ASSERT_EQ(b1->gain(), 0);
    ASSERT_EQ(b1->post(), 0);
    ASSERT_TRUE(isAnyClientPosted(b1->bufferState()));

    // Gaining a buffer who has other posted client should succeed.
    EXPECT_EQ(b1->gain(), 0);
}

TEST_F(BufferHubBufferStateTransitionTest, GainBuffer_fromSelfInPostedState) {
    ASSERT_EQ(b1->gain(), 0);
    ASSERT_EQ(b1->post(), 0);
    ASSERT_TRUE(isAnyClientPosted(b1->bufferState()));

    // A posted client should be able to gain the buffer when there is no other clients in
    // acquired state.
    EXPECT_EQ(b2->gain(), 0);
}

TEST_F(BufferHubBufferStateTransitionTest, PostBuffer_fromOtherInGainedState) {
    ASSERT_EQ(b1->gain(), 0);
    ASSERT_TRUE(isClientGained(b1->bufferState(), b1ClientMask));

    EXPECT_EQ(b2->post(), -EBUSY);
}

TEST_F(BufferHubBufferStateTransitionTest, PostBuffer_fromSelfInGainedState) {
    ASSERT_EQ(b1->gain(), 0);
    ASSERT_TRUE(isClientGained(b1->bufferState(), b1ClientMask));

    EXPECT_EQ(b1->post(), 0);
    auto currentBufferState = b1->bufferState();
    EXPECT_TRUE(isClientReleased(currentBufferState, b1ClientMask));
    EXPECT_TRUE(isClientPosted(currentBufferState, b2ClientMask));
}

TEST_F(BufferHubBufferStateTransitionTest, PostBuffer_fromPostedState) {
    ASSERT_EQ(b1->gain(), 0);
    ASSERT_EQ(b1->post(), 0);
    ASSERT_TRUE(isAnyClientPosted(b1->bufferState()));

    // Post from posted state should fail.
    EXPECT_EQ(b1->post(), -EBUSY);
    EXPECT_EQ(b2->post(), -EBUSY);
}

TEST_F(BufferHubBufferStateTransitionTest, PostBuffer_fromAcquiredState) {
    ASSERT_EQ(b1->gain(), 0);
    ASSERT_EQ(b1->post(), 0);
    ASSERT_EQ(b2->acquire(), 0);
    ASSERT_TRUE(isAnyClientAcquired(b1->bufferState()));

    // Posting from acquired state should fail.
    EXPECT_EQ(b1->post(), -EBUSY);
    EXPECT_EQ(b2->post(), -EBUSY);
}

TEST_F(BufferHubBufferStateTransitionTest, PostBuffer_fromReleasedState) {
    ASSERT_TRUE(b1->isReleased());

    // Posting from released state should fail.
    EXPECT_EQ(b1->post(), -EBUSY);
    EXPECT_EQ(b2->post(), -EBUSY);
}

TEST_F(BufferHubBufferStateTransitionTest, AcquireBuffer_fromSelfInPostedState) {
    ASSERT_EQ(b1->gain(), 0);
    ASSERT_EQ(b1->post(), 0);
    ASSERT_TRUE(isClientPosted(b1->bufferState(), b2ClientMask));

    // Acquire from posted state should pass.
    EXPECT_EQ(b2->acquire(), 0);
}

TEST_F(BufferHubBufferStateTransitionTest, AcquireBuffer_fromOtherInPostedState) {
    ASSERT_EQ(b1->gain(), 0);
    ASSERT_EQ(b1->post(), 0);
    ASSERT_TRUE(isClientPosted(b1->bufferState(), b2ClientMask));

    // Acquire from released state should fail, although there are other clients
    // in posted state.
    EXPECT_EQ(b1->acquire(), -EBUSY);
}

TEST_F(BufferHubBufferStateTransitionTest, AcquireBuffer_fromSelfInAcquiredState) {
    ASSERT_EQ(b1->gain(), 0);
    ASSERT_EQ(b1->post(), 0);
    ASSERT_EQ(b2->acquire(), 0);
    auto currentBufferState = b1->bufferState();
    ASSERT_TRUE(isClientAcquired(currentBufferState, b2ClientMask));

    // Acquiring from acquired state by the same client should not error out.
    EXPECT_EQ(b2->acquire(), 0);
}

TEST_F(BufferHubBufferStateTransitionTest, AcquireBuffer_fromReleasedState) {
    ASSERT_TRUE(b1->isReleased());

    // Acquiring form released state should fail.
    EXPECT_EQ(b1->acquire(), -EBUSY);
    EXPECT_EQ(b2->acquire(), -EBUSY);
}

TEST_F(BufferHubBufferStateTransitionTest, AcquireBuffer_fromGainedState) {
    ASSERT_EQ(b1->gain(), 0);
    ASSERT_TRUE(isAnyClientGained(b1->bufferState()));

    // Acquiring from gained state should fail.
    EXPECT_EQ(b1->acquire(), -EBUSY);
    EXPECT_EQ(b2->acquire(), -EBUSY);
}

TEST_F(BufferHubBufferStateTransitionTest, ReleaseBuffer_fromSelfInReleasedState) {
    ASSERT_TRUE(b1->isReleased());

    EXPECT_EQ(b1->release(), 0);
}

TEST_F(BufferHubBufferStateTransitionTest, ReleaseBuffer_fromSelfInGainedState) {
    ASSERT_TRUE(b1->isReleased());
    ASSERT_EQ(b1->gain(), 0);
    ASSERT_TRUE(isAnyClientGained(b1->bufferState()));

    EXPECT_EQ(b1->release(), 0);
}

TEST_F(BufferHubBufferStateTransitionTest, ReleaseBuffer_fromSelfInPostedState) {
    ASSERT_EQ(b1->gain(), 0);
    ASSERT_EQ(b1->post(), 0);
    ASSERT_TRUE(isAnyClientPosted(b1->bufferState()));

    EXPECT_EQ(b2->release(), 0);
}

TEST_F(BufferHubBufferStateTransitionTest, ReleaseBuffer_fromSelfInAcquiredState) {
    ASSERT_EQ(b1->gain(), 0);
    ASSERT_EQ(b1->post(), 0);
    ASSERT_EQ(b2->acquire(), 0);
    ASSERT_TRUE(isAnyClientAcquired(b1->bufferState()));

    EXPECT_EQ(b2->release(), 0);
}

TEST_F(BufferHubBufferStateTransitionTest, BasicUsage) {
    // 1 producer buffer and 1 consumer buffer initialised in testcase setup.
    // Test if this set of basic operation succeed:
    // Producer post three times to the consumer, and released by consumer.
    for (int i = 0; i < 3; ++i) {
        ASSERT_EQ(b1->gain(), 0);
        ASSERT_EQ(b1->post(), 0);
        ASSERT_EQ(b2->acquire(), 0);
        ASSERT_EQ(b2->release(), 0);
    }
}

TEST_F(BufferHubBufferTest, createNewConsumerAfterGain) {
    // Create a poducer buffer and gain.
    std::unique_ptr<BufferHubBuffer> b1 =
            BufferHubBuffer::create(kWidth, kHeight, kLayerCount, kFormat, kUsage,
                                    kUserMetadataSize);
    ASSERT_THAT(b1, NotNull());
    ASSERT_EQ(b1->gain(), 0);

    // Create a consumer of the buffer and test if the consumer can acquire the
    // buffer if producer posts.
    sp<NativeHandle> token = b1->duplicate();
    ASSERT_THAT(token, NotNull());

    std::unique_ptr<BufferHubBuffer> b2 = BufferHubBuffer::import(token);

    ASSERT_THAT(b2, NotNull());
    ASSERT_NE(b1->clientStateMask(), b2->clientStateMask());

    ASSERT_EQ(b1->post(), 0);
    EXPECT_EQ(b2->acquire(), 0);
}

TEST_F(BufferHubBufferTest, createNewConsumerAfterPost) {
    // Create a poducer buffer and post.
    std::unique_ptr<BufferHubBuffer> b1 =
            BufferHubBuffer::create(kWidth, kHeight, kLayerCount, kFormat, kUsage,
                                    kUserMetadataSize);
    ASSERT_EQ(b1->gain(), 0);
    ASSERT_EQ(b1->post(), 0);

    // Create a consumer of the buffer and test if the consumer can acquire the
    // buffer if producer posts.
    sp<NativeHandle> token = b1->duplicate();
    ASSERT_THAT(token, NotNull());

    std::unique_ptr<BufferHubBuffer> b2 = BufferHubBuffer::import(token);

    ASSERT_THAT(b2, NotNull());
    ASSERT_NE(b1->clientStateMask(), b2->clientStateMask());

    EXPECT_EQ(b2->acquire(), 0);
}

} // namespace

} // namespace android