1 /* 2 * Copyright 2018 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 #pragma once 18 19 #include <array> 20 #include <cstdint> 21 #include <optional> 22 #include <string> 23 #include <string_view> 24 #include <vector> 25 26 #include <ui/DeviceProductInfo.h> 27 #include <ui/DisplayId.h> 28 #include <ui/Size.h> 29 30 #define LEGACY_DISPLAY_TYPE_PRIMARY 0 31 #define LEGACY_DISPLAY_TYPE_EXTERNAL 1 32 33 namespace android { 34 35 using DisplayIdentificationData = std::vector<uint8_t>; 36 37 struct DetailedTimingDescriptor { 38 ui::Size pixelSizeCount; 39 ui::Size physicalSizeInMm; 40 }; 41 42 // These values must match the ones in ScreenPartStatus.aidl file in the composer HAL 43 enum class ScreenPartStatus : uint8_t { 44 /** 45 * Device cannot differentiate an original screen from a replaced screen. 46 */ 47 UNSUPPORTED = 0, 48 /** 49 * Device has the original screen it was manufactured with. 50 */ 51 ORIGINAL = 1, 52 /** 53 * Device has a replaced screen. 54 */ 55 REPLACED = 2, 56 }; 57 58 struct DisplayIdentificationInfo { 59 PhysicalDisplayId id; 60 std::string name; 61 uint8_t port; 62 std::optional<DeviceProductInfo> deviceProductInfo; 63 std::optional<DetailedTimingDescriptor> preferredDetailedTimingDescriptor; 64 ScreenPartStatus screenPartStatus; 65 }; 66 67 struct ExtensionBlock { 68 uint8_t tag; 69 uint8_t revisionNumber; 70 }; 71 72 struct HdmiPhysicalAddress { 73 // The address describes the path from the display sink in the network of connected HDMI 74 // devices. The format of the address is "a.b.c.d". For example, address 2.1.0.0 means we are 75 // connected to port 1 of a device which is connected to port 2 of the sink. 76 uint8_t a, b, c, d; 77 }; 78 79 struct HdmiVendorDataBlock { 80 HdmiPhysicalAddress physicalAddress; 81 }; 82 83 struct Cea861ExtensionBlock : ExtensionBlock { 84 std::optional<HdmiVendorDataBlock> hdmiVendorDataBlock; 85 }; 86 87 struct Edid { 88 uint16_t manufacturerId; 89 uint16_t productId; 90 std::optional<uint64_t> hashedBlockZeroSerialNumberOpt; 91 std::optional<uint64_t> hashedDescriptorBlockSerialNumberOpt; 92 PnpId pnpId; 93 uint32_t modelHash; 94 // Up to 13 characters of ASCII text terminated by LF and padded with SP. 95 std::string_view displayName; 96 uint8_t manufactureOrModelYear; 97 uint8_t manufactureWeek; 98 ui::Size physicalSizeInCm; 99 std::optional<Cea861ExtensionBlock> cea861Block; 100 std::optional<DetailedTimingDescriptor> preferredDetailedTimingDescriptor; 101 }; 102 103 bool isEdid(const DisplayIdentificationData&); 104 std::optional<Edid> parseEdid(const DisplayIdentificationData&); 105 std::optional<PnpId> getPnpId(uint16_t manufacturerId); 106 107 std::optional<DisplayIdentificationInfo> parseDisplayIdentificationData( 108 uint8_t port, const DisplayIdentificationData&); 109 110 PhysicalDisplayId getVirtualDisplayId(uint32_t id); 111 112 // Generates a consistent, stable, and hashed display ID that is based on the 113 // display's parsed EDID fields. 114 PhysicalDisplayId generateEdidDisplayId(const Edid& edid); 115 116 } // namespace android 117