inventory: initial API

add inventory message for EVE to upload to controller

Signed-off-by: Christoph Ostarek <[email protected]>

Author: christoph-zededa

proto/hardwareinventory/msg.proto

@@ -0,0 +1,57 @@
+// Copyright(c) 2025 Zededa, Inc.
+// SPDX-License-Identifier: Apache-2.0
+
+syntax = "proto3";
+
+package org.lfedge.eve.hardwareinventory;
+option go_package  = "github.com/lf-edge/eve-api/go/hardwareinventory";
+option java_package = "org.lfedge.eve.hardwareinventory";
+
+message USBBusDevnum {
+        // https://elixir.bootlin.com/linux/v6.16.9/source/include/linux/usb.h#L451
+        int64 bus = 1;
+        // https://elixir.bootlin.com/linux/v6.16.9/source/include/linux/usb.h#L657
+        int64 devnum = 2;
+}
+
+message USBDevice {
+        optional PCIAddress pci_parent = 1;
+        optional USBBusDevnum usb_parent = 2;
+
+        // these are uint16, protobuf only supports from uint32
+        // https://elixir.bootlin.com/linux/v6.16.9/source/include/linux/usb.h#L984
+        uint32 vendor_id = 3;
+        uint32 product_id = 4;
+
+        USBBusDevnum bus_devnum = 5;
+}
+
+message PCIAddress {
+        // https://github.com/lyonel/lshw/blob/master/src/core/pci.cc#L224
+        uint32 bus = 1;
+        uint32 device = 2;
+        uint32 function = 3;
+}
+
+message PCIDevice {
+        optional string parent_pci_device_address = 1;
+	string driver = 2;
+        PCIAddress address = 3;
+        // https://elixir.bootlin.com/linux/v6.16.9/source/include/linux/pci.h#L347
+	uint32 vendor_id = 4;
+        uint32 device_id = 5;
+	string revision = 6;
+	string subsystem_id = 7;
+	string class_id = 8;
+	string subclass_id = 9;
+        // IOMMU group names apparently are strings: https://elixir.bootlin.com/linux/v6.16.9/source/drivers/iommu/iommu.c#L1101
+        string iommu_group = 10;
+}
+
+// this message is POSTed to /inventory/{serial}/{softserial}
+message InventoryMsg {
+        string eve_version = 1;
+
+	repeated PCIDevice pci_devices = 2;
+	repeated USBDevice usb_devices = 3;
+}