tree 18cd55aa942eca9a35a8b28565ac71d5a701c626
parent dec237bcdafe852638b1ff3867a2db4e07d0a4b3
author Andrew Jeffery <andrew@codeconstruct.com.au> 1730959236 +1030
committer Andrew Jeffery <andrew@codeconstruct.com.au> 1732086848 +1030

dsp: firmware_update: Iterators for downstream device descriptors

Provide an ergonomic and safe means to iterate through downstream
devices and their descriptors while avoiding the need to allocate. The
strategy leaves the library user to make their own choices about how the
data is handled.

The user-facing portion of the change takes the form of two new macros,
to be nested inside one another:

```
foreach_pldm_downstream_device(...) {
    foreach_pldm_downstream_device_descriptor(...) {
        // Do something with the device-specific descriptor
    }
}
```

Examples uses are provided in the documentation and in changes to the
test suite.

Change-Id: I6e79454b94868da73f318635bcaae57cd51fbf97
Signed-off-by: Andrew Jeffery <andrew@codeconstruct.com.au>