feat(cdc_acm): mock open/close device

[peter-marcisovsky]

Description

This MR, as a part of USB Class drivers testing, uses callback functions to some functions from from usb_host.c, used for device opening and closing.

Cmock framework defines callbacks, as user-defined functions which are called whenever a certain mocked function is called, to which a callback function is registered to.

This is useful for us, for example, when we want to "open" a USB device during a class driver host test.

Since the whole USB stack is mocked, usb_host_devcie_open just calls an empty cmock function. But we can register a callback to the usb_host_devcie_open function, which will "open" a mocked USB device. Once the USB device is opened, we can use it for further host testing.

A developer must define USB devices he want's to have "connected" during a test case by himself, at the beginning of a host test case. One can do so by calling usb_host_mock_add_device and passing a device's device and config desc and a desired device address.

Changes

• Added host tests:
  • Device opening test_device_opening.cpp - We are testing device opening/closing itself
  • Device interfaction test_device_interaction.cpp - We are testing interaction of already opened device with the CDC-ACM driver
• Test fixtures:
  • CDC-ACM driver mock API for host testing, implements functions
  • mock_cdc_acm_host_install mock_cdc_acm_host_uninstall - Installs/Uninstalls CDC-ACM driver on mocked USB component
  • mock_cdc_acm_host_open mock_cdc_acm_host_close - Opens/Closes mocked CDC device in the CDC-ACM driver
  • mock_cdc_acm_host_data_tx_blocking - Submits mocked transfer to already opened mocked device

Related

• Blocking change: USB Mock in esp-idf must be updated first
• IDF-11343 USB class testing: USB Host device list mock

Testing

---

Checklist

Before submitting a Pull Request, please ensure the following:

• 🚨 This PR does not introduce breaking changes.
• All CI checks (GH Actions) pass.
• Documentation is updated as needed.
• Tests are updated or added as necessary.
• Code is well-commented, especially in complex areas.
• Git history is clean — commits are squashed to the minimum necessary.

[peter-marcisovsky]

There are 2 sub-folders for host tests now:

• descriptors parsing tests : this tests use USB and Freertos components mocked
• device itneractions tests : this tests use only mocked USB, Freertos is real component

For this reason, the tests must have been regrouped

[tore-espressif]

Nice job @peter-marcisovsky !

[peter-marcisovsky]

CI failing, because we don't have the changes from esp-idf merged into the master.

First we merge feature(usb_host): cmock add device and wait for the docker image update.
Then, once the CI passes, we merge this MR.