pax_global_header00006660000000000000000000000064150654553730014527gustar00rootroot0000000000000052 comment=8a6f5f0e06730ead6eb69c2b08852e38e73c6b46 cyme-2.2.6/000077500000000000000000000000001506545537300124735ustar00rootroot00000000000000cyme-2.2.6/.github/000077500000000000000000000000001506545537300140335ustar00rootroot00000000000000cyme-2.2.6/.github/FUNDING.yml000066400000000000000000000013011506545537300156430ustar00rootroot00000000000000# These are supported funding model platforms github: tuna-f1sh patreon: # Replace with a single Patreon username open_collective: # Replace with a single Open Collective username ko_fi: tunaf1sh tidelift: # Replace with a single Tidelift platform-name/package-name e.g., npm/babel community_bridge: # Replace with a single Community Bridge project-name e.g., cloud-foundry liberapay: # Replace with a single Liberapay username issuehunt: # Replace with a single IssueHunt username otechie: # Replace with a single Otechie username lfx_crowdfunding: # Replace with a single LFX Crowdfunding project-name e.g., cloud-foundry custom: # Replace with up to 4 custom sponsorship URLs e.g., ['link1', 'link2'] cyme-2.2.6/.github/workflows/000077500000000000000000000000001506545537300160705ustar00rootroot00000000000000cyme-2.2.6/.github/workflows/build.yml000066400000000000000000000203741506545537300177200ustar00rootroot00000000000000on: push: branches: - main pull_request: release: types: - created workflow_dispatch: env: CARGO_CMD: cargo RUSTFLAGS: "-Dwarnings" name: Test, build and package jobs: crate_metadata: name: Extract crate metadata runs-on: ubuntu-latest if: github.event_name == 'release' steps: - uses: actions/checkout@v4 - name: Extract crate information id: crate_metadata run: | cargo metadata --no-deps --format-version 1 | jq -r '"name=" + .packages[0].version' | tee -a $GITHUB_OUTPUT cargo metadata --no-deps --format-version 1 | jq -r '"version=" + .packages[0].version' | tee -a $GITHUB_OUTPUT cargo metadata --no-deps --format-version 1 | jq -r '"maintainer=" + .packages[0].authors[0]' | tee -a $GITHUB_OUTPUT cargo metadata --no-deps --format-version 1 | jq -r '"homepage=" + .packages[0].homepage' | tee -a $GITHUB_OUTPUT cargo metadata --no-deps --format-version 1 | jq -r '"msrv=" + .packages[0].rust_version' | tee -a $GITHUB_OUTPUT outputs: name: ${{ steps.crate_metadata.outputs.name }} version: ${{ steps.crate_metadata.outputs.version }} maintainer: ${{ steps.crate_metadata.outputs.maintainer }} homepage: ${{ steps.crate_metadata.outputs.homepage }} msrv: ${{ steps.crate_metadata.outputs.msrv }} format: name: Ensure 'cargo fmt' has been run runs-on: ubuntu-latest steps: - uses: dtolnay/rust-toolchain@stable with: components: rustfmt toolchain: stable - uses: actions/checkout@v4 - run: cargo fmt -- --check # Clippy pre-check would be nice but OS dependant features and libusb deps for all-features requires in matrix build: name: ${{ matrix.job.os }}-${{ matrix.job.target }} runs-on: ${{ matrix.job.os }} needs: [format] strategy: fail-fast: false matrix: job: # default features for all targets - { os: ubuntu-24.04-arm, target: aarch64-unknown-linux-gnu, use-cross: false, feature-flags: "" } - { os: windows-latest, target: x86_64-pc-windows-gnu, use-cross: false, feature-flags: "" } - { os: ubuntu-latest, target: x86_64-unknown-linux-gnu, use-cross: false, feature-flags: "" } - { os: macos-latest, target: universal-apple-darwin, use-cross: false, feature-flags: "" } outputs: # could use these for release job? # pkg-linux-aarch64: ${{ steps.package.outputs.pkg-aarch64-unknown-linux-gnu }} # pkg-linux-x86_64: ${{ steps.package.outputs.pkg-x86_64-unknown-linux-gnu }} # pkg-windows-x86_64: ${{ steps.package.outputs.pkg-x86_64-pc-windows-gnu }} # pkg-macos-x86_64: ${{ steps.package.outputs.pkg-universal-apple-darwin }} homebrew-pkg-name: ${{ steps.package.outputs.MACOS_PKG_NAME }} steps: - uses: actions/checkout@v4 - uses: actions/cache@v4 with: path: | ~/.cargo/registry/index/ ~/.cargo/registry/cache/ ~/.cargo/git/db/ ~/.cargo/bin/cargo-deb target/ key: ${{ matrix.job.os }}-cargo-${{ hashFiles('**/Cargo.lock') }} - uses: dtolnay/rust-toolchain@stable with: components: rustfmt, clippy toolchain: stable # Could remove this step if not clippy/testing --all-features as only required for non-native profiler - name: Install prerequisites shell: bash run: | case ${{ matrix.job.target }} in *-linux-*) sudo apt-get -y update; sudo apt-get -y install libudev-dev libusb-1.0-0-dev; # install cargo-deb if not cached if ! command -v cargo-deb &> /dev/null; then cargo install cargo-deb fi ;; *) ;; esac - name: Rustup add target if: matrix.job.use-cross == false shell: bash run: | case ${{ matrix.job.target }} in universal-apple-*) rustup target add x86_64-apple-darwin rustup target add aarch64-apple-darwin ;; *) rustup target add ${{ matrix.job.target }} ;; esac - name: Install cross shell: bash if: matrix.job.use-cross == true run: | echo "CARGO_CMD=cross" >> "$GITHUB_ENV" cargo install cross - name: Clippy check no warnings id: clippy shell: bash # cross targets should be covered if: matrix.job.use-cross == false run: cargo clippy --all-targets --all-features - name: Test id: test shell: bash # cross is buggy with QEMU and slow if: matrix.job.use-cross == false run: make test env: CARGO_FLAGS: ${{ matrix.job.feature-flags }} TARGET: ${{ matrix.job.target }} - name: Generated files up to date id: generate shell: bash if: matrix.job.use-cross == false run: | make generated git diff --exit-code env: CARGO_FLAGS: ${{ matrix.job.feature-flags }} TARGET: ${{ matrix.job.target }} - name: Build release id: build shell: bash run: echo "bin-${TARGET}=$(make release | tail -n1)" >> "$GITHUB_OUTPUT" env: CARGO_FLAGS: ${{ matrix.job.feature-flags }} TARGET: ${{ matrix.job.target }} - name: Create tarball id: package shell: bash run: | PKG_PATH="$(make package | tail -n1)" echo "pkg-${TARGET}=${PKG_PATH}" >> "$GITHUB_OUTPUT" echo "PKG_NAME=$(basename ${PKG_PATH})" >> "$GITHUB_OUTPUT" echo "PKG_PATH=${PKG_PATH}" >> "$GITHUB_OUTPUT" if [[ "${TARGET}" == *"apple"* ]]; then echo "MACOS_PKG_NAME=$(basename ${PKG_PATH})" >> "$GITHUB_OUTPUT" fi env: CARGO_FLAGS: ${{ matrix.job.feature-flags }} TARGET: ${{ matrix.job.target }} - name: Create Debian package id: debian-package shell: bash if: contains(matrix.job.target, 'linux') run: | DPKG_PATH="$(make dpkg | tail -n1)" # replace _ with - DPKG_NAME="$(sed 's/_/-/g' <<< $(basename ${DPKG_PATH}))" mv "${DPKG_PATH}" "$(dirname ${DPKG_PATH})/${DPKG_NAME}" DPKG_PATH="$(dirname ${DPKG_PATH})/${DPKG_NAME}" echo "dpkg-${TARGET}=${DPKG_PATH}" >> "$GITHUB_OUTPUT" echo "DPKG_NAME=$(basename ${DPKG_PATH})" >> "$GITHUB_OUTPUT" echo "DPKG_PATH=${DPKG_PATH}" >> "$GITHUB_OUTPUT" env: CARGO_FLAGS: ${{ matrix.job.feature-flags }} TARGET: ${{ matrix.job.target }} - name: Upload package artifact uses: actions/upload-artifact@master with: name: ${{ steps.package.outputs.PKG_NAME }} path: ${{ steps.package.outputs.PKG_PATH }} - name: Upload dpkg artifact uses: actions/upload-artifact@master if: steps.debian-package.outputs.DPKG_NAME with: name: ${{ steps.debian-package.outputs.DPKG_NAME }} path: ${{ steps.debian-package.outputs.DPKG_PATH }} release: name: Release runs-on: ubuntu-latest needs: [build, crate_metadata] if: github.event_name == 'release' steps: - name: Download build artifacts uses: actions/download-artifact@v4 with: path: artifacts - name: Upload release artifacts uses: softprops/action-gh-release@v2 with: files: | artifacts/**/*.tar.gz artifacts/**/*.zip artifacts/**/*.deb token: ${{ secrets.GITHUB_TOKEN }} - name: Bump Homebrew formula uses: mislav/bump-homebrew-formula-action@v3 with: formula-name: cyme formula-path: Formula/cyme.rb homebrew-tap: tuna-f1sh/homebrew-taps download-url: https://github.com/tuna-f1sh/cyme/releases/download/v${{ needs.crate_metadata.outputs.version }}/${{ needs.build.outputs.homebrew-pkg-name }} commit-message: | {{formulaName}} {{version}} Created by https://github.com/mislav/bump-homebrew-formula-action env: COMMITTER_TOKEN: ${{ secrets.COMMITTER_TOKEN }} cyme-2.2.6/.gitignore000066400000000000000000000000501506545537300144560ustar00rootroot00000000000000tests/data/config_save.json log /target cyme-2.2.6/CHANGELOG.md000066400000000000000000000301101506545537300142770ustar00rootroot00000000000000# Changelog ## [2.2.6] - 2025-09-22 ### Fixed - watch: panic exiting due to potential dropped channel send ([#79](https://github.com/tuna-f1sh/cyme/pull/79)). ## [2.2.5] - 2025-09-18 ### Fixed - config: encoding arg not being passed to print settings ([#77](https://github.com/tuna-f1sh/cyme/pull/77)). ## [2.2.4] - 2025-07-28 ### Changed - Update to use release v0.2.0 of nusb. ## [2.2.3] - 2025-06-18 ### Added - `--block-operation` add to control how block args are processed: new, add, append, prepend or remove from config/defaults ([#72](https://github.com/tuna-f1sh/cyme/pull/72)). - Block args can take comma separated values ([#72](https://github.com/tuna-f1sh/cyme/pull/72)). - Default block args in `--help` ([#71](https://github.com/tuna-f1sh/cyme/issues/71)). ### Changed - nusb v0.2.0-beta.2. ## [2.2.2] - 2025-05-20 ### Fixed - watch: bus assignment based on Windows bus_id ([#68](https://github.com/tuna-f1sh/cyme/pull/68)). ## [2.2.1] - 2025-05-06 ### Added - Support for `--json` with `watch` sub-command ([#66](https://github.com/tuna-f1sh/cyme/pull/66)). ## [2.2.0] - 2025-04-21 `cyme watch` subcommand to watch for USB device hotplug events and _live_ edit display settings. A simple TUI proof of concept that grew beyond just showing hotplug events into something quite handy for exploring enumerated devices. It can also edit display settings and save them to the cyme config file. It's a nice way to customise display blocks: press 'b' to use the editor and 'Ctrl-s' to save. Use '?' for other keybindings. Navigation is mostly Vim-like. Try connecting and disconnecting a device while running `cyme watch` to see the hotplug events. The interface is simplistic at the moment but could be re-skinned with something like Ratatui in the future. Here's a quick demo: https://youtu.be/ohRBrVBRolA?si=OY8zEtqF-8x_Lp7u ### Added - `cyme watch` subcommand to watch for USB device hotplug events and 'live' edit display settings ([#58](https://github.com/tuna-f1sh/cyme/pull/58)). - no_color option to config. Clearer parity/merge with CLI args. - device event and DeviceBlock::LastEvent, DeviceBlock::EventIcon. Default is profiled time (P: %y-%m-%d %H:%M:%S) but used by `cyme watch` to show connect/disconnect events. - benches for profiling. - RUST_LOG can be module level eg: `RUST_LOG=nusb=info,cyme=debug`. ### Changed - build: Makefile targets used in CI ([#64](https://github.com/tuna-f1sh/cyme/pull/64)). - custom PortPath type used for get_ methods improves look-up 70-100%. Makes profiler faster as it uses these methods to build the device tree. ([801aa](https://github.com/tuna-f1sh/cyme/commit/801aa3fba28aae7be988d747b1a42bedbc06e496)). - simple_logger now logs to stderr so can be redirected without effecting display output: `cyme watch 2> log`. - path args String to PathBuf. ## [2.1.3] - 2024-04-03 ### Fixed - lsusb-verbose: hub dump not reading full descriptor for bcd >= 0x0300 so missing hub descriptor ([#63](https://github.com/tuna-f1sh/cyme/pull/63)). - lsusb-verbose: verbose white space and some strings. ### Changed - build: hide `--gen` behind `cli_generate` feature ([#61](https://github.com/tuna-f1sh/cyme/pull/61)). - lsusb: brought upto date with v018 releae and some pre-v019 features ([#62](https://github.com/tuna-f1sh/cyme/pull/62)). ### Added - display: negotiated-speed block to show the actual operating speed of the connected device. ## [2.1.2] - 2024-02-21 Mostly housekeeping and minor fixes. Did a dependency audit and updated some crates. Working towards a hotplug 'watch' subcommand. ### Fixed - control read endpoint stall will be re-attempted after clearing halt ([#54](https://github.com/tuna-f1sh/cyme/pull/54)). - udev-hwdb: native supports hwdb lookup again ([#59](https://github.com/tuna-f1sh/cyme/pull/59)). - lsusb: fallback to desccriptor strings in verbose dump for idProduct and idVendor ([#55](https://github.com/tuna-f1sh/cyme/issues/55)). - Bus::is_empty was inverse but display::prepare_devices filter accounted by also inverting. No real bug but fixed for clarity. ### Changed - macOS: claim interface when reading Debug Descriptors. - nusb: use cached device descriptor rather than reading manually with control message ([nusb #102](https://github.com/kevinmehall/nusb/pull/102)). - log now outputs to stderr so can be redirected. - lazy_static dropped for LazyLock. - rand replaced with fast_rand. ### Added - Example usage in README. ## [2.1.1] - 2024-12-01 Minor updates to match `lsusb` updates. Fixing bugs playing with USB gadgets! ### Fixed - Linux root_hubs now read_link pci driver like lsusb for driver field. - lsusb verbose would print all audio BmControl2 bits and show ILLEGAL VALUE for 0 bits. ### Changed - lsusb tree number padding is now 3 digits for bus and device numbers to match lsusb. ## [2.1.0] - 2024-10-30 ### Fixed - Linux root\_hub missing from it's own devices; lsusb mode listing with libusb feature. - nusb feature not profiling root\_hub devices and so not gathering BOS, hub descriptors and status etc. - Attempt to claim HID interfaces on Linux to avoid dmesg warning. Note that if a kernel module is loaded for a device, it may still be claimed by that module and so not available to cyme. cyme could detach the kernel module but this is not done for usability reasons. The behaviour is the same as lsusb. ([#52](https://github.com/tuna-f1sh/cyme/pull/52)). ### Changed - Logging should be more useful in debug mode. ## [2.0.0] - 2024-10-18 Big release after almost two years since the first commit: `cyme` is now native Rust\* by default! Thanks to support from [nusb](https://github.com/kevinmehall/nusb), the system profiler is much improved for all platforms. See the updated README for target configuration changes. \*Native crates. The OS interfaces behind the scenes (currently sysfs, IOKit and WinUSB) are in their respective code but this opens the door for Rust OSes, which the previous 'libusb' profiler could not facilitate. ### Added - Bus information is now profiled on non-Linux platforms using 'nusb' - much nicer output for macOS and Windows. - pci.ids vendor and device information for buses where IDs are available. ### Changed - `cyme` default target now uses native Rust profiling thanks to [nusb](https://github.com/kevinmehall/nusb) ([#26](https://github.com/tuna-f1sh/cyme/pull/26)). - Default Driver and Interface display blocks now include driver and sysfs on Linux but not on other platforms ([#41](https://github.com/tuna-f1sh/cyme/issues/41)). - macOS `system_profiler` is not used by default with 'nusb' since IOKit is used directly. It can be forced with `--system_profiler`. The macOS mod is now only compiled for macOS targets. - 'sysfs' read/readlink is now attempted first for Linux driver information then udev (if feature enabled) ([#45](https://github.com/tuna-f1sh/cyme/pull/45)). ## [1.8.5] - 2024-10-11 ### Added - risv64 support ([#37](https://github.com/tuna-f1sh/cyme/pull/37)). ### Fixed - MixerUnit1 number of channels index incorrect causing OoB panic ([#38](https://github.com/tuna-f1sh/cyme/issues/38)). ## [1.8.4] - 2024-09-27 ### Changed - Default sort by bus number and device address within buses for all display modes (matching lsusb) ([#33](https://github.com/tuna-f1sh/cyme/issues/33)). - Default Rust udev feature no longer supports hwdb lookup as it's broken - usb-ids is used. Use `--no-default-features -F=udevlib -F=udev_hwdb` if really wishing to use local 'hwdb.bin'. ([#35](https://github.com/tuna-f1sh/cyme/issues/35)). ## [1.8.3] - 2024-09-20 ### Fixes - Fix panic when using auto-width and utf-8 characters landing on non-char boundary ([#30](https://github.com/tuna-f1sh/cyme/issues/32)). - Corrected some typos ([#28](https://github.com/tuna-f1sh/cyme/pull/28)). - Fix lintian errors with cargo-deb package ([#29](https://github.com/tuna-f1sh/cyme/pull/31)). ## [1.8.2] - 2024-08-20 ### Changed - Standard cyme list now excludes root_hubs (`--tree` shows them as buses as before). `--lsusb` list mode will still show them. Use `--list-root-hubs` (or in config) to include them in the cyme list on Linux as before. ### Fixes - Fix length and offset calculation in lsusb::dump_hub that would print some incorrect data. - Minor formatting fixes for `lsusb --verbose` mode; indent in dump_interface, min 1 space between fields, wTotalLength as hex. ## [1.8.1] - 2024-07-16 ### Fixes - Fix panic due to potential subtraction overflow in `lsusb --verbose` mode ([#24](https://github.com/tuna-f1sh/cyme/issues/25)). ## [1.8.0] - 2024-07-15 `cyme` should now match `lsusb --verbose` mode with full device descriptor dumps, including using USB control messages to get BOS, Hub device status, HID reports and more. It's been a lot of grunt work and lines of code (not very creative lines!) creating all the types but it should be useful as a USB profiling crate moving forwards and I think more robust than `lsusb` in some cases. There may still be some formatting differences but the data _should_ be the same. `cyme` without `--lsusb --verbose` display isn't changed for the most part, since the dumping is extremely device specific and verbose. I may add device status as a display block in future. ### Added - Full dumps of device descriptors for matching `--lsusb --verbose` [#23](https://github.com/tuna-f1sh/cyme/pull/23) ([#15](https://github.com/tuna-f1sh/cyme/issues/15)) - Device name pattern matching for icon with `Icon::name(String)` ([#22](https://github.com/tuna-f1sh/cyme/pull/22)) ### Changed - `cyme` is now in [Homebrew core](https://formulae.brew.sh/formula/cyme). One can `brew uninstall cyme`, `brew untap tuna-f1sh/taps`, then install with `brew install cyme` ([#21](https://github.com/tuna-f1sh/cyme/pull/21)). - Update `--lsusb` mode to match updated lsusb behaviour if driver/names missing (print '[none]'/'[unknown]'). ## [1.7.0] - 2024-06-25 ### Changed - Replace [udev-rs](https://github.com/Smithay/udev-rs) and indirectly libudev-sys with Rust native [udev](https://github.com/cr8t/udev); libudev dependency (and system requirement) is now optional but can be used with `--no-default-features -F=udevlib`. ([#19](https://github.com/tuna-f1sh/cyme/pull/19)) ### Fixes - Replace more font-awesome icons in default look-up that have been deprecated ([#20](https://github.com/tuna-f1sh/cyme/issues/20)) ## [1.6.1] - 2024-06-13 ### Fixes - Replace font-awesome icons in default look-up that have been deprecated. ## [1.6.0] - 2023-11-23 _A release of patches, PRs and merges :), thanks to support_ ### Added - Support udev/sysfs iString lookup ([#14](https://github.com/tuna-f1sh/cyme/pull/14)) (@haata). - Add fully defined USB Device based on class code triplet. - Support bLength, wTotalLength and bDescriptorType fields in `lsusb --verbose` with ([rusb/#185](https://github.com/a1ien/rusb/pull/185)). This completes the `lsusb --verbose` support apart from extra descriptors. - Add `lsusb::names` mod that ports 'usbutils/names.c' to match the behaviour using `lsusb --verbose`. This means class, sub-class and protocol udev-hwdb names are included now in `lsusb --verbose` ([b99e87](https://github.com/tuna-f1sh/cyme/commit/b99e87a586248fdd6dbf72d5624e5e61e993ff5a)). - Add the display blocks `uid-class`, `uid-subc-lass`, `uid-protocol`, `class`, and `class-value` for `DeviceBlock`s and `InterfaceBlock`s. These are also added for `--more`. - Add `feature=udev_hwdb` to guard against systems that have udev but not hwdb support ([cross/#1377](https://github.com/cross-rs/cross/issues/1377))/([libudev-sys/#16](https://github.com/dcuddeback/libudev-sys/pull/16)). ### Changed - 'usb-ids' crate is now a dependency rather than optional to support `lsusb::names` lookup without udev_hwdb (non-Linux). ([usb-ids.rs/#50](https://github.com/woodruffw/usb-ids.rs/pull/50)) will add extra descriptor parsing in future. - iString descriptors will now be retrieved in order libusb descriptor -> sysfs cache (Linux) -> udev_hwdb (bundled usb-ids `--feature=udev_hwdb`) -> usb-ids. ### Fixes - Fix BaseClass as u8 in lsusb --verbose being enum index not repr(c) base class byte. - Fix BaseClass as u8 in icon serializer being enum index not repc(c) base class byte. ## [1.5.2] - 2023-11-01 _Changelog started._ ## [0.2.0] - 2022-11-16 _First release._ cyme-2.2.6/Cargo.lock000066400000000000000000001465671506545537300144230ustar00rootroot00000000000000# This file is automatically @generated by Cargo. # It is not intended for manual editing. version = 4 [[package]] name = "aho-corasick" version = "1.1.3" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "8e60d3430d3a69478ad0993f19238d2df97c507009a52b3c10addcd7f6bcb916" dependencies = [ "memchr", ] [[package]] name = "android_system_properties" version = "0.1.5" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "819e7219dbd41043ac279b19830f2efc897156490d7fd6ea916720117ee66311" dependencies = [ "libc", ] [[package]] name = "anes" version = "0.1.6" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "4b46cbb362ab8752921c97e041f5e366ee6297bd428a31275b9fcf1e380f7299" [[package]] name = "anstream" version = "0.6.20" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "3ae563653d1938f79b1ab1b5e668c87c76a9930414574a6583a7b7e11a8e6192" dependencies = [ "anstyle", "anstyle-parse", "anstyle-query", "anstyle-wincon", "colorchoice", "is_terminal_polyfill", "utf8parse", ] [[package]] name = "anstyle" version = "1.0.11" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "862ed96ca487e809f1c8e5a8447f6ee2cf102f846893800b20cebdf541fc6bbd" [[package]] name = "anstyle-parse" version = "0.2.7" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "4e7644824f0aa2c7b9384579234ef10eb7efb6a0deb83f9630a49594dd9c15c2" dependencies = [ "utf8parse", ] [[package]] name = "anstyle-query" version = "1.1.4" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "9e231f6134f61b71076a3eab506c379d4f36122f2af15a9ff04415ea4c3339e2" dependencies = [ "windows-sys 0.60.2", ] [[package]] name = "anstyle-wincon" version = "3.0.10" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "3e0633414522a32ffaac8ac6cc8f748e090c5717661fddeea04219e2344f5f2a" dependencies = [ "anstyle", "once_cell_polyfill", "windows-sys 0.60.2", ] [[package]] name = "assert-json-diff" version = "2.0.2" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "47e4f2b81832e72834d7518d8487a0396a28cc408186a2e8854c0f98011faf12" dependencies = [ "serde", "serde_json", ] [[package]] name = "autocfg" version = "1.5.0" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "c08606f8c3cbf4ce6ec8e28fb0014a2c086708fe954eaa885384a6165172e7e8" [[package]] name = "base64" version = "0.13.1" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "9e1b586273c5702936fe7b7d6896644d8be71e6314cfe09d3167c95f712589e8" [[package]] name = "bitflags" version = "1.3.2" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "bef38d45163c2f1dde094a7dfd33ccf595c92905c8f8f4fdc18d06fb1037718a" [[package]] name = "bitflags" version = "2.9.4" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "2261d10cca569e4643e526d8dc2e62e433cc8aba21ab764233731f8d369bf394" [[package]] name = "bumpalo" version = "3.19.0" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "46c5e41b57b8bba42a04676d81cb89e9ee8e859a1a66f80a5a72e1cb76b34d43" [[package]] name = "byteorder" version = "1.5.0" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "1fd0f2584146f6f2ef48085050886acf353beff7305ebd1ae69500e27c67f64b" [[package]] name = "cansi" version = "2.2.1" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "4bdcae87153686017415ce77e48c53e6818a0a058f0e21b56640d1e944967ef8" [[package]] name = "cast" version = "0.3.0" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "37b2a672a2cb129a2e41c10b1224bb368f9f37a2b16b612598138befd7b37eb5" [[package]] name = "cc" version = "1.2.38" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "80f41ae168f955c12fb8960b057d70d0ca153fb83182b57d86380443527be7e9" dependencies = [ "find-msvc-tools", "shlex", ] [[package]] name = "cfg-if" version = "1.0.3" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "2fd1289c04a9ea8cb22300a459a72a385d7c73d3259e2ed7dcb2af674838cfa9" [[package]] name = "cfg_aliases" version = "0.2.1" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "613afe47fcd5fac7ccf1db93babcb082c5994d996f20b8b159f2ad1658eb5724" [[package]] name = "chrono" version = "0.4.42" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "145052bdd345b87320e369255277e3fb5152762ad123a901ef5c262dd38fe8d2" dependencies = [ "iana-time-zone", "js-sys", "num-traits", "serde", "wasm-bindgen", "windows-link 0.2.0", ] [[package]] name = "ciborium" version = "0.2.2" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "42e69ffd6f0917f5c029256a24d0161db17cea3997d185db0d35926308770f0e" dependencies = [ "ciborium-io", "ciborium-ll", "serde", ] [[package]] name = "ciborium-io" version = "0.2.2" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "05afea1e0a06c9be33d539b876f1ce3692f4afea2cb41f740e7743225ed1c757" [[package]] name = "ciborium-ll" version = "0.2.2" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "57663b653d948a338bfb3eeba9bb2fd5fcfaecb9e199e87e1eda4d9e8b240fd9" dependencies = [ "ciborium-io", "half", ] [[package]] name = "clap" version = "4.5.48" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "e2134bb3ea021b78629caa971416385309e0131b351b25e01dc16fb54e1b5fae" dependencies = [ "clap_builder", "clap_derive", ] [[package]] name = "clap_builder" version = "4.5.48" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "c2ba64afa3c0a6df7fa517765e31314e983f51dda798ffba27b988194fb65dc9" dependencies = [ "anstream", "anstyle", "clap_lex", "strsim", "terminal_size 0.4.3", ] [[package]] name = "clap_complete" version = "4.5.58" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "75bf0b32ad2e152de789bb635ea4d3078f6b838ad7974143e99b99f45a04af4a" dependencies = [ "clap", ] [[package]] name = "clap_derive" version = "4.5.47" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "bbfd7eae0b0f1a6e63d4b13c9c478de77c2eb546fba158ad50b4203dc24b9f9c" dependencies = [ "heck 0.5.0", "proc-macro2", "quote", "syn", ] [[package]] name = "clap_lex" version = "0.7.5" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "b94f61472cee1439c0b966b47e3aca9ae07e45d070759512cd390ea2bebc6675" [[package]] name = "clap_mangen" version = "0.2.29" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "27b4c3c54b30f0d9adcb47f25f61fcce35c4dd8916638c6b82fbd5f4fb4179e2" dependencies = [ "clap", "roff", ] [[package]] name = "colorchoice" version = "1.0.4" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "b05b61dc5112cbb17e4b6cd61790d9845d13888356391624cbe7e41efeac1e75" [[package]] name = "colored" version = "2.2.0" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "117725a109d387c937a1533ce01b450cbde6b88abceea8473c4d7a85853cda3c" dependencies = [ "lazy_static", "windows-sys 0.59.0", ] [[package]] name = "colored" version = "3.0.0" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "fde0e0ec90c9dfb3b4b1a0891a7dcd0e2bffde2f7efed5fe7c9bb00e5bfb915e" dependencies = [ "windows-sys 0.59.0", ] [[package]] name = "core-foundation" version = "0.10.1" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "b2a6cd9ae233e7f62ba4e9353e81a88df7fc8a5987b8d445b4d90c879bd156f6" dependencies = [ "core-foundation-sys", "libc", ] [[package]] name = "core-foundation-sys" version = "0.8.7" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "773648b94d0e5d620f64f280777445740e61fe701025087ec8b57f45c791888b" [[package]] name = "criterion" version = "0.5.1" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "f2b12d017a929603d80db1831cd3a24082f8137ce19c69e6447f54f5fc8d692f" dependencies = [ "anes", "cast", "ciborium", "clap", "criterion-plot", "is-terminal", "itertools", "num-traits", "once_cell", "oorandom", "plotters", "rayon", "regex", "serde", "serde_derive", "serde_json", "tinytemplate", "walkdir", ] [[package]] name = "criterion-plot" version = "0.5.0" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "6b50826342786a51a89e2da3a28f1c32b06e387201bc2d19791f622c673706b1" dependencies = [ "cast", "itertools", ] [[package]] name = "crossbeam-deque" version = "0.8.6" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "9dd111b7b7f7d55b72c0a6ae361660ee5853c9af73f70c3c2ef6858b950e2e51" dependencies = [ "crossbeam-epoch", "crossbeam-utils", ] [[package]] name = "crossbeam-epoch" version = "0.9.18" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "5b82ac4a3c2ca9c3460964f020e1402edd5753411d7737aa39c3714ad1b5420e" dependencies = [ "crossbeam-utils", ] [[package]] name = "crossbeam-utils" version = "0.8.21" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "d0a5c400df2834b80a4c3327b3aad3a4c4cd4de0629063962b03235697506a28" [[package]] name = "crossterm" version = "0.28.1" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "829d955a0bb380ef178a640b91779e3987da38c9aea133b20614cfed8cdea9c6" dependencies = [ "bitflags 2.9.4", "crossterm_winapi", "mio", "parking_lot", "rustix 0.38.44", "signal-hook", "signal-hook-mio", "winapi", ] [[package]] name = "crossterm_winapi" version = "0.9.1" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "acdd7c62a3665c7f6830a51635d9ac9b23ed385797f70a83bb8bafe9c572ab2b" dependencies = [ "winapi", ] [[package]] name = "crunchy" version = "0.2.4" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "460fbee9c2c2f33933d720630a6a0bac33ba7053db5344fac858d4b8952d77d5" [[package]] name = "cyme" version = "2.2.6" dependencies = [ "assert-json-diff", "cansi", "chrono", "clap", "clap_complete", "clap_mangen", "colored 3.0.0", "core-foundation", "core-foundation-sys", "criterion", "crossterm", "diff", "dirs", "fastrand", "futures-lite", "heck 0.4.1", "io-kit-sys", "itertools", "log", "nusb", "pci-ids", "regex", "rusb", "serde", "serde_json", "serde_with", "simple_logger", "strum", "strum_macros", "terminal_size 0.2.6", "udev", "udevrs", "unicode-width", "usb-ids", "uuid", ] [[package]] name = "darling" version = "0.20.11" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "fc7f46116c46ff9ab3eb1597a45688b6715c6e628b5c133e288e709a29bcb4ee" dependencies = [ "darling_core", "darling_macro", ] [[package]] name = "darling_core" version = "0.20.11" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "0d00b9596d185e565c2207a0b01f8bd1a135483d02d9b7b0a54b11da8d53412e" dependencies = [ "fnv", "ident_case", "proc-macro2", "quote", "strsim", "syn", ] [[package]] name = "darling_macro" version = "0.20.11" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "fc34b93ccb385b40dc71c6fceac4b2ad23662c7eeb248cf10d529b7e055b6ead" dependencies = [ "darling_core", "quote", "syn", ] [[package]] name = "deranged" version = "0.5.3" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "d630bccd429a5bb5a64b5e94f693bfc48c9f8566418fda4c494cc94f911f87cc" dependencies = [ "powerfmt", "serde", ] [[package]] name = "diff" version = "0.1.13" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "56254986775e3233ffa9c4d7d3faaf6d36a2c09d30b20687e9f88bc8bafc16c8" [[package]] name = "dirs" version = "6.0.0" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "c3e8aa94d75141228480295a7d0e7feb620b1a5ad9f12bc40be62411e38cce4e" dependencies = [ "dirs-sys", ] [[package]] name = "dirs-sys" version = "0.5.0" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "e01a3366d27ee9890022452ee61b2b63a67e6f13f58900b651ff5665f0bb1fab" dependencies = [ "libc", "option-ext", "redox_users", "windows-sys 0.61.0", ] [[package]] name = "either" version = "1.15.0" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "48c757948c5ede0e46177b7add2e67155f70e33c07fea8284df6576da70b3719" [[package]] name = "errno" version = "0.3.14" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "39cab71617ae0d63f51a36d69f866391735b51691dbda63cf6f96d042b63efeb" dependencies = [ "libc", "windows-sys 0.61.0", ] [[package]] name = "fastrand" version = "2.3.0" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "37909eebbb50d72f9059c3b6d82c0463f2ff062c9e95845c43a6c9c0355411be" [[package]] name = "find-msvc-tools" version = "0.1.2" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "1ced73b1dacfc750a6db6c0a0c3a3853c8b41997e2e2c563dc90804ae6867959" [[package]] name = "fnv" version = "1.0.7" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "3f9eec918d3f24069decb9af1554cad7c880e2da24a9afd88aca000531ab82c1" [[package]] name = "futures-core" version = "0.3.31" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "05f29059c0c2090612e8d742178b0580d2dc940c837851ad723096f87af6663e" [[package]] name = "futures-io" version = "0.3.31" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "9e5c1b78ca4aae1ac06c48a526a655760685149f0d465d21f37abfe57ce075c6" [[package]] name = "futures-lite" version = "2.6.1" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "f78e10609fe0e0b3f4157ffab1876319b5b0db102a2c60dc4626306dc46b44ad" dependencies = [ "fastrand", "futures-core", "futures-io", "parking", "pin-project-lite", ] [[package]] name = "getrandom" version = "0.2.16" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "335ff9f135e4384c8150d6f27c6daed433577f86b4750418338c01a1a2528592" dependencies = [ "cfg-if", "libc", "wasi", ] [[package]] name = "glob" version = "0.3.3" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "0cc23270f6e1808e30a928bdc84dea0b9b4136a8bc82338574f23baf47bbd280" [[package]] name = "half" version = "2.6.0" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "459196ed295495a68f7d7fe1d84f6c4b7ff0e21fe3017b2f283c6fac3ad803c9" dependencies = [ "cfg-if", "crunchy", ] [[package]] name = "hash32" version = "0.3.1" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "47d60b12902ba28e2730cd37e95b8c9223af2808df9e902d4df49588d1470606" dependencies = [ "byteorder", ] [[package]] name = "hashbrown" version = "0.12.3" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "8a9ee70c43aaf417c914396645a0fa852624801b24ebb7ae78fe8272889ac888" [[package]] name = "heapless" version = "0.8.0" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "0bfb9eb618601c89945a70e254898da93b13be0388091d42117462b265bb3fad" dependencies = [ "hash32", "stable_deref_trait", ] [[package]] name = "heck" version = "0.4.1" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "95505c38b4572b2d910cecb0281560f54b440a19336cbbcb27bf6ce6adc6f5a8" [[package]] name = "heck" version = "0.5.0" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "2304e00983f87ffb38b55b444b5e3b60a884b5d30c0fca7d82fe33449bbe55ea" [[package]] name = "hermit-abi" version = "0.3.9" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "d231dfb89cfffdbc30e7fc41579ed6066ad03abda9e567ccafae602b97ec5024" [[package]] name = "hermit-abi" version = "0.5.2" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "fc0fef456e4baa96da950455cd02c081ca953b141298e41db3fc7e36b1da849c" [[package]] name = "hex" version = "0.4.3" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "7f24254aa9a54b5c858eaee2f5bccdb46aaf0e486a595ed5fd8f86ba55232a70" [[package]] name = "iana-time-zone" version = "0.1.64" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "33e57f83510bb73707521ebaffa789ec8caf86f9657cad665b092b581d40e9fb" dependencies = [ "android_system_properties", "core-foundation-sys", "iana-time-zone-haiku", "js-sys", "log", "wasm-bindgen", "windows-core", ] [[package]] name = "iana-time-zone-haiku" version = "0.1.2" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "f31827a206f56af32e590ba56d5d2d085f558508192593743f16b2306495269f" dependencies = [ "cc", ] [[package]] name = "ident_case" version = "1.0.1" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "b9e0384b61958566e926dc50660321d12159025e767c18e043daf26b70104c39" [[package]] name = "indexmap" version = "1.9.3" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "bd070e393353796e801d209ad339e89596eb4c8d430d18ede6a1cced8fafbd99" dependencies = [ "autocfg", "hashbrown", "serde", ] [[package]] name = "io-kit-sys" version = "0.4.1" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "617ee6cf8e3f66f3b4ea67a4058564628cde41901316e19f559e14c7c72c5e7b" dependencies = [ "core-foundation-sys", "mach2", ] [[package]] name = "io-lifetimes" version = "1.0.11" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "eae7b9aee968036d54dce06cebaefd919e4472e753296daccd6d344e3e2df0c2" dependencies = [ "hermit-abi 0.3.9", "libc", "windows-sys 0.48.0", ] [[package]] name = "is-terminal" version = "0.4.16" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "e04d7f318608d35d4b61ddd75cbdaee86b023ebe2bd5a66ee0915f0bf93095a9" dependencies = [ "hermit-abi 0.5.2", "libc", "windows-sys 0.59.0", ] [[package]] name = "is_terminal_polyfill" version = "1.70.1" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "7943c866cc5cd64cbc25b2e01621d07fa8eb2a1a23160ee81ce38704e97b8ecf" [[package]] name = "itertools" version = "0.10.5" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "b0fd2260e829bddf4cb6ea802289de2f86d6a7a690192fbe91b3f46e0f2c8473" dependencies = [ "either", ] [[package]] name = "itoa" version = "1.0.15" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "4a5f13b858c8d314ee3e8f639011f7ccefe71f97f96e50151fb991f267928e2c" [[package]] name = "js-sys" version = "0.3.80" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "852f13bec5eba4ba9afbeb93fd7c13fe56147f055939ae21c43a29a0ecb2702e" dependencies = [ "once_cell", "wasm-bindgen", ] [[package]] name = "lazy_static" version = "1.5.0" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "bbd2bcb4c963f2ddae06a2efc7e9f3591312473c50c6685e1f298068316e66fe" [[package]] name = "libc" version = "0.2.175" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "6a82ae493e598baaea5209805c49bbf2ea7de956d50d7da0da1164f9c6d28543" [[package]] name = "libredox" version = "0.1.10" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "416f7e718bdb06000964960ffa43b4335ad4012ae8b99060261aa4a8088d5ccb" dependencies = [ "bitflags 2.9.4", "libc", ] [[package]] name = "libudev-sys" version = "0.1.4" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "3c8469b4a23b962c1396b9b451dda50ef5b283e8dd309d69033475fa9b334324" dependencies = [ "libc", "pkg-config", ] [[package]] name = "libusb1-sys" version = "0.7.0" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "da050ade7ac4ff1ba5379af847a10a10a8e284181e060105bf8d86960ce9ce0f" dependencies = [ "cc", "libc", "pkg-config", "vcpkg", ] [[package]] name = "linux-raw-sys" version = "0.3.8" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "ef53942eb7bf7ff43a617b3e2c1c4a5ecf5944a7c1bc12d7ee39bbb15e5c1519" [[package]] name = "linux-raw-sys" version = "0.4.15" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "d26c52dbd32dccf2d10cac7725f8eae5296885fb5703b261f7d0a0739ec807ab" [[package]] name = "linux-raw-sys" version = "0.9.4" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "cd945864f07fe9f5371a27ad7b52a172b4b499999f1d97574c9fa68373937e12" [[package]] name = "linux-raw-sys" version = "0.11.0" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "df1d3c3b53da64cf5760482273a98e575c651a67eec7f77df96b5b642de8f039" [[package]] name = "lock_api" version = "0.4.13" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "96936507f153605bddfcda068dd804796c84324ed2510809e5b2a624c81da765" dependencies = [ "autocfg", "scopeguard", ] [[package]] name = "log" version = "0.4.28" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "34080505efa8e45a4b816c349525ebe327ceaa8559756f0356cba97ef3bf7432" [[package]] name = "mach2" version = "0.4.3" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "d640282b302c0bb0a2a8e0233ead9035e3bed871f0b7e81fe4a1ec829765db44" dependencies = [ "libc", ] [[package]] name = "memchr" version = "2.7.5" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "32a282da65faaf38286cf3be983213fcf1d2e2a58700e808f83f4ea9a4804bc0" [[package]] name = "minimal-lexical" version = "0.2.1" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "68354c5c6bd36d73ff3feceb05efa59b6acb7626617f4962be322a825e61f79a" [[package]] name = "mio" version = "1.0.4" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "78bed444cc8a2160f01cbcf811ef18cac863ad68ae8ca62092e8db51d51c761c" dependencies = [ "libc", "log", "wasi", "windows-sys 0.59.0", ] [[package]] name = "nix" version = "0.29.0" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "71e2746dc3a24dd78b3cfcb7be93368c6de9963d30f43a6a73998a9cf4b17b46" dependencies = [ "bitflags 2.9.4", "cfg-if", "cfg_aliases", "libc", ] [[package]] name = "nom" version = "7.1.3" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "d273983c5a657a70a3e8f2a01329822f3b8c8172b73826411a55751e404a0a4a" dependencies = [ "memchr", "minimal-lexical", ] [[package]] name = "num-conv" version = "0.1.0" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "51d515d32fb182ee37cda2ccdcb92950d6a3c2893aa280e540671c2cd0f3b1d9" [[package]] name = "num-traits" version = "0.2.19" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "071dfc062690e90b734c0b2273ce72ad0ffa95f0c74596bc250dcfd960262841" dependencies = [ "autocfg", ] [[package]] name = "num_threads" version = "0.1.7" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "5c7398b9c8b70908f6371f47ed36737907c87c52af34c268fed0bf0ceb92ead9" dependencies = [ "libc", ] [[package]] name = "nusb" version = "0.2.0" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "701a6a7ed08d280343b136da239b8d62d2f0733866541dff3a0d6bfa9be50139" dependencies = [ "core-foundation", "core-foundation-sys", "futures-core", "io-kit-sys", "linux-raw-sys 0.9.4", "log", "once_cell", "rustix 1.1.2", "slab", "windows-sys 0.60.2", ] [[package]] name = "once_cell" version = "1.21.3" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "42f5e15c9953c5e4ccceeb2e7382a716482c34515315f7b03532b8b4e8393d2d" [[package]] name = "once_cell_polyfill" version = "1.70.1" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "a4895175b425cb1f87721b59f0f286c2092bd4af812243672510e1ac53e2e0ad" [[package]] name = "oorandom" version = "11.1.5" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "d6790f58c7ff633d8771f42965289203411a5e5c68388703c06e14f24770b41e" [[package]] name = "option-ext" version = "0.2.0" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "04744f49eae99ab78e0d5c0b603ab218f515ea8cfe5a456d7629ad883a3b6e7d" [[package]] name = "parking" version = "2.2.1" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "f38d5652c16fde515bb1ecef450ab0f6a219d619a7274976324d5e377f7dceba" [[package]] name = "parking_lot" version = "0.12.4" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "70d58bf43669b5795d1576d0641cfb6fbb2057bf629506267a92807158584a13" dependencies = [ "lock_api", "parking_lot_core", ] [[package]] name = "parking_lot_core" version = "0.9.11" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "bc838d2a56b5b1a6c25f55575dfc605fabb63bb2365f6c2353ef9159aa69e4a5" dependencies = [ "cfg-if", "libc", "redox_syscall", "smallvec", "windows-targets 0.52.6", ] [[package]] name = "pci-ids" version = "0.2.5" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "d88ae3281b415d856e9c2ddbcdd5961e71c1a3e90138512c04d720241853a6af" dependencies = [ "nom", "phf", "phf_codegen", "proc-macro2", "quote", ] [[package]] name = "phf" version = "0.11.3" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "1fd6780a80ae0c52cc120a26a1a42c1ae51b247a253e4e06113d23d2c2edd078" dependencies = [ "phf_shared", ] [[package]] name = "phf_codegen" version = "0.11.3" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "aef8048c789fa5e851558d709946d6d79a8ff88c0440c587967f8e94bfb1216a" dependencies = [ "phf_generator", "phf_shared", ] [[package]] name = "phf_generator" version = "0.11.3" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "3c80231409c20246a13fddb31776fb942c38553c51e871f8cbd687a4cfb5843d" dependencies = [ "phf_shared", "rand", ] [[package]] name = "phf_shared" version = "0.11.3" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "67eabc2ef2a60eb7faa00097bd1ffdb5bd28e62bf39990626a582201b7a754e5" dependencies = [ "siphasher", ] [[package]] name = "pin-project-lite" version = "0.2.16" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "3b3cff922bd51709b605d9ead9aa71031d81447142d828eb4a6eba76fe619f9b" [[package]] name = "pkg-config" version = "0.3.32" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "7edddbd0b52d732b21ad9a5fab5c704c14cd949e5e9a1ec5929a24fded1b904c" [[package]] name = "plotters" version = "0.3.7" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "5aeb6f403d7a4911efb1e33402027fc44f29b5bf6def3effcc22d7bb75f2b747" dependencies = [ "num-traits", "plotters-backend", "plotters-svg", "wasm-bindgen", "web-sys", ] [[package]] name = "plotters-backend" version = "0.3.7" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "df42e13c12958a16b3f7f4386b9ab1f3e7933914ecea48da7139435263a4172a" [[package]] name = "plotters-svg" version = "0.3.7" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "51bae2ac328883f7acdfea3d66a7c35751187f870bc81f94563733a154d7a670" dependencies = [ "plotters-backend", ] [[package]] name = "powerfmt" version = "0.2.0" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "439ee305def115ba05938db6eb1644ff94165c5ab5e9420d1c1bcedbba909391" [[package]] name = "proc-macro2" version = "1.0.101" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "89ae43fd86e4158d6db51ad8e2b80f313af9cc74f5c0e03ccb87de09998732de" dependencies = [ "unicode-ident", ] [[package]] name = "quote" version = "1.0.40" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "1885c039570dc00dcb4ff087a89e185fd56bae234ddc7f056a945bf36467248d" dependencies = [ "proc-macro2", ] [[package]] name = "rand" version = "0.8.5" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "34af8d1a0e25924bc5b7c43c079c942339d8f0a8b57c39049bef581b46327404" dependencies = [ "rand_core", ] [[package]] name = "rand_core" version = "0.6.4" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "ec0be4795e2f6a28069bec0b5ff3e2ac9bafc99e6a9a7dc3547996c5c816922c" [[package]] name = "rayon" version = "1.11.0" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "368f01d005bf8fd9b1206fb6fa653e6c4a81ceb1466406b81792d87c5677a58f" dependencies = [ "either", "rayon-core", ] [[package]] name = "rayon-core" version = "1.13.0" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "22e18b0f0062d30d4230b2e85ff77fdfe4326feb054b9783a3460d8435c8ab91" dependencies = [ "crossbeam-deque", "crossbeam-utils", ] [[package]] name = "redox_syscall" version = "0.5.17" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "5407465600fb0548f1442edf71dd20683c6ed326200ace4b1ef0763521bb3b77" dependencies = [ "bitflags 2.9.4", ] [[package]] name = "redox_users" version = "0.5.2" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "a4e608c6638b9c18977b00b475ac1f28d14e84b27d8d42f70e0bf1e3dec127ac" dependencies = [ "getrandom", "libredox", "thiserror", ] [[package]] name = "regex" version = "1.11.2" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "23d7fd106d8c02486a8d64e778353d1cffe08ce79ac2e82f540c86d0facf6912" dependencies = [ "aho-corasick", "memchr", "regex-automata", "regex-syntax", ] [[package]] name = "regex-automata" version = "0.4.10" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "6b9458fa0bfeeac22b5ca447c63aaf45f28439a709ccd244698632f9aa6394d6" dependencies = [ "aho-corasick", "memchr", "regex-syntax", ] [[package]] name = "regex-syntax" version = "0.8.6" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "caf4aa5b0f434c91fe5c7f1ecb6a5ece2130b02ad2a590589dda5146df959001" [[package]] name = "roff" version = "0.2.2" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "88f8660c1ff60292143c98d08fc6e2f654d722db50410e3f3797d40baaf9d8f3" [[package]] name = "rusb" version = "0.9.4" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "ab9f9ff05b63a786553a4c02943b74b34a988448671001e9a27e2f0565cc05a4" dependencies = [ "libc", "libusb1-sys", ] [[package]] name = "rustix" version = "0.37.28" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "519165d378b97752ca44bbe15047d5d3409e875f39327546b42ac81d7e18c1b6" dependencies = [ "bitflags 1.3.2", "errno", "io-lifetimes", "libc", "linux-raw-sys 0.3.8", "windows-sys 0.48.0", ] [[package]] name = "rustix" version = "0.38.44" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "fdb5bc1ae2baa591800df16c9ca78619bf65c0488b41b96ccec5d11220d8c154" dependencies = [ "bitflags 2.9.4", "errno", "libc", "linux-raw-sys 0.4.15", "windows-sys 0.59.0", ] [[package]] name = "rustix" version = "1.1.2" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "cd15f8a2c5551a84d56efdc1cd049089e409ac19a3072d5037a17fd70719ff3e" dependencies = [ "bitflags 2.9.4", "errno", "libc", "linux-raw-sys 0.11.0", "windows-sys 0.61.0", ] [[package]] name = "rustversion" version = "1.0.22" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "b39cdef0fa800fc44525c84ccb54a029961a8215f9619753635a9c0d2538d46d" [[package]] name = "ryu" version = "1.0.20" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "28d3b2b1366ec20994f1fd18c3c594f05c5dd4bc44d8bb0c1c632c8d6829481f" [[package]] name = "same-file" version = "1.0.6" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "93fc1dc3aaa9bfed95e02e6eadabb4baf7e3078b0bd1b4d7b6b0b68378900502" dependencies = [ "winapi-util", ] [[package]] name = "scopeguard" version = "1.2.0" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "94143f37725109f92c262ed2cf5e59bce7498c01bcc1502d7b9afe439a4e9f49" [[package]] name = "serde" version = "1.0.226" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "0dca6411025b24b60bfa7ec1fe1f8e710ac09782dca409ee8237ba74b51295fd" dependencies = [ "serde_core", "serde_derive", ] [[package]] name = "serde_core" version = "1.0.226" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "ba2ba63999edb9dac981fb34b3e5c0d111a69b0924e253ed29d83f7c99e966a4" dependencies = [ "serde_derive", ] [[package]] name = "serde_derive" version = "1.0.226" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "8db53ae22f34573731bafa1db20f04027b2d25e02d8205921b569171699cdb33" dependencies = [ "proc-macro2", "quote", "syn", ] [[package]] name = "serde_json" version = "1.0.145" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "402a6f66d8c709116cf22f558eab210f5a50187f702eb4d7e5ef38d9a7f1c79c" dependencies = [ "itoa", "memchr", "ryu", "serde", "serde_core", ] [[package]] name = "serde_with" version = "2.3.3" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "07ff71d2c147a7b57362cead5e22f772cd52f6ab31cfcd9edcd7f6aeb2a0afbe" dependencies = [ "base64", "chrono", "hex", "indexmap", "serde", "serde_json", "serde_with_macros", "time", ] [[package]] name = "serde_with_macros" version = "2.3.3" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "881b6f881b17d13214e5d494c939ebab463d01264ce1811e9d4ac3a882e7695f" dependencies = [ "darling", "proc-macro2", "quote", "syn", ] [[package]] name = "shlex" version = "1.3.0" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "0fda2ff0d084019ba4d7c6f371c95d8fd75ce3524c3cb8fb653a3023f6323e64" [[package]] name = "signal-hook" version = "0.3.18" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "d881a16cf4426aa584979d30bd82cb33429027e42122b169753d6ef1085ed6e2" dependencies = [ "libc", "signal-hook-registry", ] [[package]] name = "signal-hook-mio" version = "0.2.4" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "34db1a06d485c9142248b7a054f034b349b212551f3dfd19c94d45a754a217cd" dependencies = [ "libc", "mio", "signal-hook", ] [[package]] name = "signal-hook-registry" version = "1.4.6" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "b2a4719bff48cee6b39d12c020eeb490953ad2443b7055bd0b21fca26bd8c28b" dependencies = [ "libc", ] [[package]] name = "simple_logger" version = "4.3.3" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "8e7e46c8c90251d47d08b28b8a419ffb4aede0f87c2eea95e17d1d5bacbf3ef1" dependencies = [ "colored 2.2.0", "log", "time", "windows-sys 0.48.0", ] [[package]] name = "siphasher" version = "1.0.1" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "56199f7ddabf13fe5074ce809e7d3f42b42ae711800501b5b16ea82ad029c39d" [[package]] name = "slab" version = "0.4.11" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "7a2ae44ef20feb57a68b23d846850f861394c2e02dc425a50098ae8c90267589" [[package]] name = "smallvec" version = "1.15.1" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "67b1b7a3b5fe4f1376887184045fcf45c69e92af734b7aaddc05fb777b6fbd03" [[package]] name = "stable_deref_trait" version = "1.2.0" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "a8f112729512f8e442d81f95a8a7ddf2b7c6b8a1a6f509a95864142b30cab2d3" [[package]] name = "strsim" version = "0.11.1" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "7da8b5736845d9f2fcb837ea5d9e2628564b3b043a70948a3f0b778838c5fb4f" [[package]] name = "strum" version = "0.26.3" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "8fec0f0aef304996cf250b31b5a10dee7980c85da9d759361292b8bca5a18f06" [[package]] name = "strum_macros" version = "0.26.4" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "4c6bee85a5a24955dc440386795aa378cd9cf82acd5f764469152d2270e581be" dependencies = [ "heck 0.5.0", "proc-macro2", "quote", "rustversion", "syn", ] [[package]] name = "syn" version = "2.0.106" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "ede7c438028d4436d71104916910f5bb611972c5cfd7f89b8300a8186e6fada6" dependencies = [ "proc-macro2", "quote", "unicode-ident", ] [[package]] name = "terminal_size" version = "0.2.6" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "8e6bf6f19e9f8ed8d4048dc22981458ebcf406d67e94cd422e5ecd73d63b3237" dependencies = [ "rustix 0.37.28", "windows-sys 0.48.0", ] [[package]] name = "terminal_size" version = "0.4.3" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "60b8cb979cb11c32ce1603f8137b22262a9d131aaa5c37b5678025f22b8becd0" dependencies = [ "rustix 1.1.2", "windows-sys 0.60.2", ] [[package]] name = "thiserror" version = "2.0.16" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "3467d614147380f2e4e374161426ff399c91084acd2363eaf549172b3d5e60c0" dependencies = [ "thiserror-impl", ] [[package]] name = "thiserror-impl" version = "2.0.16" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "6c5e1be1c48b9172ee610da68fd9cd2770e7a4056cb3fc98710ee6906f0c7960" dependencies = [ "proc-macro2", "quote", "syn", ] [[package]] name = "time" version = "0.3.44" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "91e7d9e3bb61134e77bde20dd4825b97c010155709965fedf0f49bb138e52a9d" dependencies = [ "deranged", "itoa", "libc", "num-conv", "num_threads", "powerfmt", "serde", "time-core", "time-macros", ] [[package]] name = "time-core" version = "0.1.6" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "40868e7c1d2f0b8d73e4a8c7f0ff63af4f6d19be117e90bd73eb1d62cf831c6b" [[package]] name = "time-macros" version = "0.2.24" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "30cfb0125f12d9c277f35663a0a33f8c30190f4e4574868a330595412d34ebf3" dependencies = [ "num-conv", "time-core", ] [[package]] name = "tinytemplate" version = "1.2.1" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "be4d6b5f19ff7664e8c98d03e2139cb510db9b0a60b55f8e8709b689d939b6bc" dependencies = [ "serde", "serde_json", ] [[package]] name = "udev" version = "0.8.0" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "50051c6e22be28ee6f217d50014f3bc29e81c20dc66ff7ca0d5c5226e1dcc5a1" dependencies = [ "io-lifetimes", "libc", "libudev-sys", "pkg-config", ] [[package]] name = "udevrs" version = "0.4.0" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "fab690f9439c2b6eca25d85a2874558af78d23bea98cc50f53b0e7644d7311a5" dependencies = [ "bitflags 2.9.4", "glob", "heapless", "libc", "log", "nix", ] [[package]] name = "unicode-ident" version = "1.0.19" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "f63a545481291138910575129486daeaf8ac54aee4387fe7906919f7830c7d9d" [[package]] name = "unicode-width" version = "0.2.1" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "4a1a07cc7db3810833284e8d372ccdc6da29741639ecc70c9ec107df0fa6154c" [[package]] name = "usb-ids" version = "1.2025.2" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "1f464d03993287ba27fae1c81bfa368df4493983de7e340429fc10e470043383" dependencies = [ "nom", "phf", "phf_codegen", "proc-macro2", "quote", ] [[package]] name = "utf8parse" version = "0.2.2" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "06abde3611657adf66d383f00b093d7faecc7fa57071cce2578660c9f1010821" [[package]] name = "uuid" version = "1.18.1" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "2f87b8aa10b915a06587d0dec516c282ff295b475d94abf425d62b57710070a2" dependencies = [ "js-sys", "serde", "wasm-bindgen", ] [[package]] name = "vcpkg" version = "0.2.15" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "accd4ea62f7bb7a82fe23066fb0957d48ef677f6eeb8215f372f52e48bb32426" [[package]] name = "walkdir" version = "2.5.0" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "29790946404f91d9c5d06f9874efddea1dc06c5efe94541a7d6863108e3a5e4b" dependencies = [ "same-file", "winapi-util", ] [[package]] name = "wasi" version = "0.11.1+wasi-snapshot-preview1" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "ccf3ec651a847eb01de73ccad15eb7d99f80485de043efb2f370cd654f4ea44b" [[package]] name = "wasm-bindgen" version = "0.2.103" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "ab10a69fbd0a177f5f649ad4d8d3305499c42bab9aef2f7ff592d0ec8f833819" dependencies = [ "cfg-if", "once_cell", "rustversion", "wasm-bindgen-macro", "wasm-bindgen-shared", ] [[package]] name = "wasm-bindgen-backend" version = "0.2.103" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "0bb702423545a6007bbc368fde243ba47ca275e549c8a28617f56f6ba53b1d1c" dependencies = [ "bumpalo", "log", "proc-macro2", "quote", "syn", "wasm-bindgen-shared", ] [[package]] name = "wasm-bindgen-macro" version = "0.2.103" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "fc65f4f411d91494355917b605e1480033152658d71f722a90647f56a70c88a0" dependencies = [ "quote", "wasm-bindgen-macro-support", ] [[package]] name = "wasm-bindgen-macro-support" version = "0.2.103" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "ffc003a991398a8ee604a401e194b6b3a39677b3173d6e74495eb51b82e99a32" dependencies = [ "proc-macro2", "quote", "syn", "wasm-bindgen-backend", "wasm-bindgen-shared", ] [[package]] name = "wasm-bindgen-shared" version = "0.2.103" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "293c37f4efa430ca14db3721dfbe48d8c33308096bd44d80ebaa775ab71ba1cf" dependencies = [ "unicode-ident", ] [[package]] name = "web-sys" version = "0.3.80" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "fbe734895e869dc429d78c4b433f8d17d95f8d05317440b4fad5ab2d33e596dc" dependencies = [ "js-sys", "wasm-bindgen", ] [[package]] name = "winapi" version = "0.3.9" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "5c839a674fcd7a98952e593242ea400abe93992746761e38641405d28b00f419" dependencies = [ "winapi-i686-pc-windows-gnu", "winapi-x86_64-pc-windows-gnu", ] [[package]] name = "winapi-i686-pc-windows-gnu" version = "0.4.0" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "ac3b87c63620426dd9b991e5ce0329eff545bccbbb34f3be09ff6fb6ab51b7b6" [[package]] name = "winapi-util" version = "0.1.11" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "c2a7b1c03c876122aa43f3020e6c3c3ee5c05081c9a00739faf7503aeba10d22" dependencies = [ "windows-sys 0.61.0", ] [[package]] name = "winapi-x86_64-pc-windows-gnu" version = "0.4.0" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "712e227841d057c1ee1cd2fb22fa7e5a5461ae8e48fa2ca79ec42cfc1931183f" [[package]] name = "windows-core" version = "0.62.0" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "57fe7168f7de578d2d8a05b07fd61870d2e73b4020e9f49aa00da8471723497c" dependencies = [ "windows-implement", "windows-interface", "windows-link 0.2.0", "windows-result", "windows-strings", ] [[package]] name = "windows-implement" version = "0.60.0" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "a47fddd13af08290e67f4acabf4b459f647552718f683a7b415d290ac744a836" dependencies = [ "proc-macro2", "quote", "syn", ] [[package]] name = "windows-interface" version = "0.59.1" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "bd9211b69f8dcdfa817bfd14bf1c97c9188afa36f4750130fcdf3f400eca9fa8" dependencies = [ "proc-macro2", "quote", "syn", ] [[package]] name = "windows-link" version = "0.1.3" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "5e6ad25900d524eaabdbbb96d20b4311e1e7ae1699af4fb28c17ae66c80d798a" [[package]] name = "windows-link" version = "0.2.0" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "45e46c0661abb7180e7b9c281db115305d49ca1709ab8242adf09666d2173c65" [[package]] name = "windows-result" version = "0.4.0" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "7084dcc306f89883455a206237404d3eaf961e5bd7e0f312f7c91f57eb44167f" dependencies = [ "windows-link 0.2.0", ] [[package]] name = "windows-strings" version = "0.5.0" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "7218c655a553b0bed4426cf54b20d7ba363ef543b52d515b3e48d7fd55318dda" dependencies = [ "windows-link 0.2.0", ] [[package]] name = "windows-sys" version = "0.48.0" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "677d2418bec65e3338edb076e806bc1ec15693c5d0104683f2efe857f61056a9" dependencies = [ "windows-targets 0.48.5", ] [[package]] name = "windows-sys" version = "0.59.0" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "1e38bc4d79ed67fd075bcc251a1c39b32a1776bbe92e5bef1f0bf1f8c531853b" dependencies = [ "windows-targets 0.52.6", ] [[package]] name = "windows-sys" version = "0.60.2" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "f2f500e4d28234f72040990ec9d39e3a6b950f9f22d3dba18416c35882612bcb" dependencies = [ "windows-targets 0.53.3", ] [[package]] name = "windows-sys" version = "0.61.0" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "e201184e40b2ede64bc2ea34968b28e33622acdbbf37104f0e4a33f7abe657aa" dependencies = [ "windows-link 0.2.0", ] [[package]] name = "windows-targets" version = "0.48.5" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "9a2fa6e2155d7247be68c096456083145c183cbbbc2764150dda45a87197940c" dependencies = [ "windows_aarch64_gnullvm 0.48.5", "windows_aarch64_msvc 0.48.5", "windows_i686_gnu 0.48.5", "windows_i686_msvc 0.48.5", "windows_x86_64_gnu 0.48.5", "windows_x86_64_gnullvm 0.48.5", "windows_x86_64_msvc 0.48.5", ] [[package]] name = "windows-targets" version = "0.52.6" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "9b724f72796e036ab90c1021d4780d4d3d648aca59e491e6b98e725b84e99973" dependencies = [ "windows_aarch64_gnullvm 0.52.6", "windows_aarch64_msvc 0.52.6", "windows_i686_gnu 0.52.6", "windows_i686_gnullvm 0.52.6", "windows_i686_msvc 0.52.6", "windows_x86_64_gnu 0.52.6", "windows_x86_64_gnullvm 0.52.6", "windows_x86_64_msvc 0.52.6", ] [[package]] name = "windows-targets" version = "0.53.3" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "d5fe6031c4041849d7c496a8ded650796e7b6ecc19df1a431c1a363342e5dc91" dependencies = [ "windows-link 0.1.3", "windows_aarch64_gnullvm 0.53.0", "windows_aarch64_msvc 0.53.0", "windows_i686_gnu 0.53.0", "windows_i686_gnullvm 0.53.0", "windows_i686_msvc 0.53.0", "windows_x86_64_gnu 0.53.0", "windows_x86_64_gnullvm 0.53.0", "windows_x86_64_msvc 0.53.0", ] [[package]] name = "windows_aarch64_gnullvm" version = "0.48.5" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "2b38e32f0abccf9987a4e3079dfb67dcd799fb61361e53e2882c3cbaf0d905d8" [[package]] name = "windows_aarch64_gnullvm" version = "0.52.6" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "32a4622180e7a0ec044bb555404c800bc9fd9ec262ec147edd5989ccd0c02cd3" [[package]] name = "windows_aarch64_gnullvm" version = "0.53.0" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "86b8d5f90ddd19cb4a147a5fa63ca848db3df085e25fee3cc10b39b6eebae764" [[package]] name = "windows_aarch64_msvc" version = "0.48.5" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "dc35310971f3b2dbbf3f0690a219f40e2d9afcf64f9ab7cc1be722937c26b4bc" [[package]] name = "windows_aarch64_msvc" version = "0.52.6" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "09ec2a7bb152e2252b53fa7803150007879548bc709c039df7627cabbd05d469" [[package]] name = "windows_aarch64_msvc" version = "0.53.0" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "c7651a1f62a11b8cbd5e0d42526e55f2c99886c77e007179efff86c2b137e66c" [[package]] name = "windows_i686_gnu" version = "0.48.5" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "a75915e7def60c94dcef72200b9a8e58e5091744960da64ec734a6c6e9b3743e" [[package]] name = "windows_i686_gnu" version = "0.52.6" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "8e9b5ad5ab802e97eb8e295ac6720e509ee4c243f69d781394014ebfe8bbfa0b" [[package]] name = "windows_i686_gnu" version = "0.53.0" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "c1dc67659d35f387f5f6c479dc4e28f1d4bb90ddd1a5d3da2e5d97b42d6272c3" [[package]] name = "windows_i686_gnullvm" version = "0.52.6" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "0eee52d38c090b3caa76c563b86c3a4bd71ef1a819287c19d586d7334ae8ed66" [[package]] name = "windows_i686_gnullvm" version = "0.53.0" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "9ce6ccbdedbf6d6354471319e781c0dfef054c81fbc7cf83f338a4296c0cae11" [[package]] name = "windows_i686_msvc" version = "0.48.5" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "8f55c233f70c4b27f66c523580f78f1004e8b5a8b659e05a4eb49d4166cca406" [[package]] name = "windows_i686_msvc" version = "0.52.6" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "240948bc05c5e7c6dabba28bf89d89ffce3e303022809e73deaefe4f6ec56c66" [[package]] name = "windows_i686_msvc" version = "0.53.0" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "581fee95406bb13382d2f65cd4a908ca7b1e4c2f1917f143ba16efe98a589b5d" [[package]] name = "windows_x86_64_gnu" version = "0.48.5" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "53d40abd2583d23e4718fddf1ebec84dbff8381c07cae67ff7768bbf19c6718e" [[package]] name = "windows_x86_64_gnu" version = "0.52.6" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "147a5c80aabfbf0c7d901cb5895d1de30ef2907eb21fbbab29ca94c5b08b1a78" [[package]] name = "windows_x86_64_gnu" version = "0.53.0" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "2e55b5ac9ea33f2fc1716d1742db15574fd6fc8dadc51caab1c16a3d3b4190ba" [[package]] name = "windows_x86_64_gnullvm" version = "0.48.5" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "0b7b52767868a23d5bab768e390dc5f5c55825b6d30b86c844ff2dc7414044cc" [[package]] name = "windows_x86_64_gnullvm" version = "0.52.6" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "24d5b23dc417412679681396f2b49f3de8c1473deb516bd34410872eff51ed0d" [[package]] name = "windows_x86_64_gnullvm" version = "0.53.0" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "0a6e035dd0599267ce1ee132e51c27dd29437f63325753051e71dd9e42406c57" [[package]] name = "windows_x86_64_msvc" version = "0.48.5" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "ed94fce61571a4006852b7389a063ab983c02eb1bb37b47f8272ce92d06d9538" [[package]] name = "windows_x86_64_msvc" version = "0.52.6" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "589f6da84c646204747d1270a2a5661ea66ed1cced2631d546fdfb155959f9ec" [[package]] name = "windows_x86_64_msvc" version = "0.53.0" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "271414315aff87387382ec3d271b52d7ae78726f5d44ac98b4f4030c91880486" cyme-2.2.6/Cargo.toml000066400000000000000000000120761506545537300144310ustar00rootroot00000000000000[package] name = "cyme" authors = ["John Whittington "] description = "List system USB buses and devices. A modern cross-platform lsusb" repository = "https://github.com/tuna-f1sh/cyme" readme = "README.md" license = "GPL-3.0-or-later" rust-version = "1.82" version = "2.2.6" edition = "2021" keywords = ["usb", "lsusb", "system_profiler", "macos", "libusb"] categories = ["command-line-utilities"] exclude = [".github", "scripts"] [dependencies] clap = { version = "4.0.22", features = ["derive", "wrap_help"] } # CLI argument parsing clap_complete = { version = "4.0.6", optional = true } # CLI completions clap_mangen = { version = "0.2.5", optional = true } # for generating man - could manually do this colored = "3.0.0" # terminal colouring helper cansi = { version = "=2.2.1", optional = true } # ANSI escape code helper; decolored - no dependencies itertools = "0.10.5" # iterator methods used for building device tree rusb = { version = "0.9.4", optional = true } # libusb bindings nusb = { version = "0.2.0", optional = true } # pure Rust USB library serde = { version = "1.0", features = ["derive"] } # --json serialisation and --from-json deserialisation serde_json = "1.0.87" serde_with = "2.0.1" log = "0.4.17" simple_logger = { version = "4.0.0", features = ["stderr"], optional = false } # perhaps make this optional in the future; only required by bin targets usb-ids = { version = "1" } # USB ID database heck = "0.4.0" # common case conversions - could be internal but simple crate with no dependencies dirs = "6.0.0" # cross-platform XDG_CONFIG_HOME - could be internal since only this path fastrand = "2.1.1" # fast random number generator for masking serials terminal_size = "0.2.5" # terminal size for automatic column width during display strum = "0.26" # enum to string conversion strum_macros = "0.26" # enum to string conversion regex = { version = "1.10.5", optional = true } # icon name lookup with regex uuid = { version = "1.9.1", features = ["serde"] } # descriptor UUID field support as type pci-ids = "0.2.5" # PCI ID database unicode-width = "0.2.0" # ensure USB device table is printed with equal width columns - zero dependencies crossterm = { version = "0.28.1", optional = true } # watch: terminal manipulation futures-lite = { version = "2.6.0", optional = true } # watch: async helper chrono = { version = "0.4.39", features = ["serde"] } # watch: event times as human readable [dev-dependencies] diff = "0.1" assert-json-diff = "2.0.2" criterion = "0.5.1" [target.'cfg(target_os="linux")'.dependencies] udevrs = { version = "^0.4.0", optional = true } udevlib = { package = "udev", version = "^0.8.0", optional = true } [target.'cfg(target_os="macos")'.dependencies] core-foundation = "0.10.1" core-foundation-sys = "0.8.4" io-kit-sys = "0.4.0" [features] libusb = ["dep:rusb"] # libusb bindings rather than nusb Rust udev = ["dep:udevrs"] # udev device info lookup udev_hwdb = ["udevlib?/hwdb"] # udev hardware database lookup rather than usb-ids udevlib = ["dep:udevlib"] # udev libc bindings rather than Rust usb_test = [] # testing with phyiscal USB devices regex_icon = ["dep:regex"] # icon name lookup with regex cli_generate = ["dep:clap_complete", "dep:clap_mangen"] # for generating man and completions native = ["nusb", "udev"] # pure Rust USB and udev bindings ffi = ["libusb", "udevlib"] # C bindings for libusb and libudev watch = ["crossterm", "futures-lite", "nusb", "cansi"] # watch mode bin = [] default = ["native", "regex_icon", "watch", "bin"] # default native Rust USB (nusb, udevrs) with regex icon name lookup [[bin]] name = "cyme" path = "src/main.rs" [[bench]] name = "get" harness = false [[bench]] name = "profile" harness = false [profile.release] lto = true strip = true panic = "abort" codegen-units = 1 # quicker binary, slower build [package.metadata.cross.target.arm-unknown-linux-gnueabihf] pre-build = ["dpkg --add-architecture armhf && apt-get update && apt-get install --assume-yes libusb-1.0-0-dev:armhf libudev-dev:armhf"] [package.metadata.cross.target.aarch64-unknown-linux-gnu] pre-build = ["dpkg --add-architecture arm64 && apt-get update && apt-get install --assume-yes libusb-1.0-0-dev:arm64 libudev-dev:arm64"] [package.metadata.cross.target.i686-unknown-linux-gnu] pre-build = ["dpkg --add-architecture i386 && apt-get update && apt-get install --assume-yes libusb-1.0-0-dev:i386 libudev-dev:i386"] [package.metadata.cross.target.x86_64-unknown-linux-gnu] pre-build = ["apt-get update && apt-get install --assume-yes libusb-1.0-0-dev libudev-dev"] [package.metadata.cross.target.aarch64-linux-android] image = "ghcr.io/cross-rs/aarch64-linux-android:main" [package.metadata.deb] section = "utility" copyright = "2024, John Whittington " changelog = "CHANGELOG.md" extended-description = """Profiles system USB buses and the devices on those buses, including full device descriptors. Compatable with lsusb arguments and output whilst adding new features.""" assets = [ ["target/release/cyme", "usr/bin/", "755"], ["README.md", "usr/share/doc/cyme/README", "644"], ["doc/cyme.1", "/usr/share/man/man1/cyme.1", "644"], ] cyme-2.2.6/LICENSE000066400000000000000000001045151506545537300135060ustar00rootroot00000000000000 GNU GENERAL PUBLIC LICENSE Version 3, 29 June 2007 Copyright (C) 2007 Free Software Foundation, Inc. Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed. Preamble The GNU General Public License is a free, copyleft license for software and other kinds of works. The licenses for most software and other practical works are designed to take away your freedom to share and change the works. By contrast, the GNU General Public License is intended to guarantee your freedom to share and change all versions of a program--to make sure it remains free software for all its users. We, the Free Software Foundation, use the GNU General Public License for most of our software; it applies also to any other work released this way by its authors. You can apply it to your programs, too. When we speak of free software, we are referring to freedom, not price. Our General Public Licenses are designed to make sure that you have the freedom to distribute copies of free software (and charge for them if you wish), that you receive source code or can get it if you want it, that you can change the software or use pieces of it in new free programs, and that you know you can do these things. To protect your rights, we need to prevent others from denying you these rights or asking you to surrender the rights. Therefore, you have certain responsibilities if you distribute copies of the software, or if you modify it: responsibilities to respect the freedom of others. For example, if you distribute copies of such a program, whether gratis or for a fee, you must pass on to the recipients the same freedoms that you received. You must make sure that they, too, receive or can get the source code. And you must show them these terms so they know their rights. Developers that use the GNU GPL protect your rights with two steps: (1) assert copyright on the software, and (2) offer you this License giving you legal permission to copy, distribute and/or modify it. For the developers' and authors' protection, the GPL clearly explains that there is no warranty for this free software. For both users' and authors' sake, the GPL requires that modified versions be marked as changed, so that their problems will not be attributed erroneously to authors of previous versions. Some devices are designed to deny users access to install or run modified versions of the software inside them, although the manufacturer can do so. This is fundamentally incompatible with the aim of protecting users' freedom to change the software. The systematic pattern of such abuse occurs in the area of products for individuals to use, which is precisely where it is most unacceptable. Therefore, we have designed this version of the GPL to prohibit the practice for those products. If such problems arise substantially in other domains, we stand ready to extend this provision to those domains in future versions of the GPL, as needed to protect the freedom of users. Finally, every program is threatened constantly by software patents. States should not allow patents to restrict development and use of software on general-purpose computers, but in those that do, we wish to avoid the special danger that patents applied to a free program could make it effectively proprietary. To prevent this, the GPL assures that patents cannot be used to render the program non-free. The precise terms and conditions for copying, distribution and modification follow. TERMS AND CONDITIONS 0. Definitions. "This License" refers to version 3 of the GNU General Public License. "Copyright" also means copyright-like laws that apply to other kinds of works, such as semiconductor masks. "The Program" refers to any copyrightable work licensed under this License. Each licensee is addressed as "you". "Licensees" and "recipients" may be individuals or organizations. To "modify" a work means to copy from or adapt all or part of the work in a fashion requiring copyright permission, other than the making of an exact copy. The resulting work is called a "modified version" of the earlier work or a work "based on" the earlier work. A "covered work" means either the unmodified Program or a work based on the Program. To "propagate" a work means to do anything with it that, without permission, would make you directly or secondarily liable for infringement under applicable copyright law, except executing it on a computer or modifying a private copy. Propagation includes copying, distribution (with or without modification), making available to the public, and in some countries other activities as well. To "convey" a work means any kind of propagation that enables other parties to make or receive copies. Mere interaction with a user through a computer network, with no transfer of a copy, is not conveying. An interactive user interface displays "Appropriate Legal Notices" to the extent that it includes a convenient and prominently visible feature that (1) displays an appropriate copyright notice, and (2) tells the user that there is no warranty for the work (except to the extent that warranties are provided), that licensees may convey the work under this License, and how to view a copy of this License. If the interface presents a list of user commands or options, such as a menu, a prominent item in the list meets this criterion. 1. Source Code. The "source code" for a work means the preferred form of the work for making modifications to it. "Object code" means any non-source form of a work. A "Standard Interface" means an interface that either is an official standard defined by a recognized standards body, or, in the case of interfaces specified for a particular programming language, one that is widely used among developers working in that language. The "System Libraries" of an executable work include anything, other than the work as a whole, that (a) is included in the normal form of packaging a Major Component, but which is not part of that Major Component, and (b) serves only to enable use of the work with that Major Component, or to implement a Standard Interface for which an implementation is available to the public in source code form. A "Major Component", in this context, means a major essential component (kernel, window system, and so on) of the specific operating system (if any) on which the executable work runs, or a compiler used to produce the work, or an object code interpreter used to run it. The "Corresponding Source" for a work in object code form means all the source code needed to generate, install, and (for an executable work) run the object code and to modify the work, including scripts to control those activities. However, it does not include the work's System Libraries, or general-purpose tools or generally available free programs which are used unmodified in performing those activities but which are not part of the work. For example, Corresponding Source includes interface definition files associated with source files for the work, and the source code for shared libraries and dynamically linked subprograms that the work is specifically designed to require, such as by intimate data communication or control flow between those subprograms and other parts of the work. The Corresponding Source need not include anything that users can regenerate automatically from other parts of the Corresponding Source. The Corresponding Source for a work in source code form is that same work. 2. Basic Permissions. All rights granted under this License are granted for the term of copyright on the Program, and are irrevocable provided the stated conditions are met. This License explicitly affirms your unlimited permission to run the unmodified Program. The output from running a covered work is covered by this License only if the output, given its content, constitutes a covered work. This License acknowledges your rights of fair use or other equivalent, as provided by copyright law. You may make, run and propagate covered works that you do not convey, without conditions so long as your license otherwise remains in force. You may convey covered works to others for the sole purpose of having them make modifications exclusively for you, or provide you with facilities for running those works, provided that you comply with the terms of this License in conveying all material for which you do not control copyright. Those thus making or running the covered works for you must do so exclusively on your behalf, under your direction and control, on terms that prohibit them from making any copies of your copyrighted material outside their relationship with you. Conveying under any other circumstances is permitted solely under the conditions stated below. Sublicensing is not allowed; section 10 makes it unnecessary. 3. Protecting Users' Legal Rights From Anti-Circumvention Law. No covered work shall be deemed part of an effective technological measure under any applicable law fulfilling obligations under article 11 of the WIPO copyright treaty adopted on 20 December 1996, or similar laws prohibiting or restricting circumvention of such measures. When you convey a covered work, you waive any legal power to forbid circumvention of technological measures to the extent such circumvention is effected by exercising rights under this License with respect to the covered work, and you disclaim any intention to limit operation or modification of the work as a means of enforcing, against the work's users, your or third parties' legal rights to forbid circumvention of technological measures. 4. Conveying Verbatim Copies. You may convey verbatim copies of the Program's source code as you receive it, in any medium, provided that you conspicuously and appropriately publish on each copy an appropriate copyright notice; keep intact all notices stating that this License and any non-permissive terms added in accord with section 7 apply to the code; keep intact all notices of the absence of any warranty; and give all recipients a copy of this License along with the Program. You may charge any price or no price for each copy that you convey, and you may offer support or warranty protection for a fee. 5. Conveying Modified Source Versions. You may convey a work based on the Program, or the modifications to produce it from the Program, in the form of source code under the terms of section 4, provided that you also meet all of these conditions: a) The work must carry prominent notices stating that you modified it, and giving a relevant date. b) The work must carry prominent notices stating that it is released under this License and any conditions added under section 7. This requirement modifies the requirement in section 4 to "keep intact all notices". c) You must license the entire work, as a whole, under this License to anyone who comes into possession of a copy. This License will therefore apply, along with any applicable section 7 additional terms, to the whole of the work, and all its parts, regardless of how they are packaged. This License gives no permission to license the work in any other way, but it does not invalidate such permission if you have separately received it. d) If the work has interactive user interfaces, each must display Appropriate Legal Notices; however, if the Program has interactive interfaces that do not display Appropriate Legal Notices, your work need not make them do so. A compilation of a covered work with other separate and independent works, which are not by their nature extensions of the covered work, and which are not combined with it such as to form a larger program, in or on a volume of a storage or distribution medium, is called an "aggregate" if the compilation and its resulting copyright are not used to limit the access or legal rights of the compilation's users beyond what the individual works permit. Inclusion of a covered work in an aggregate does not cause this License to apply to the other parts of the aggregate. 6. Conveying Non-Source Forms. You may convey a covered work in object code form under the terms of sections 4 and 5, provided that you also convey the machine-readable Corresponding Source under the terms of this License, in one of these ways: a) Convey the object code in, or embodied in, a physical product (including a physical distribution medium), accompanied by the Corresponding Source fixed on a durable physical medium customarily used for software interchange. b) Convey the object code in, or embodied in, a physical product (including a physical distribution medium), accompanied by a written offer, valid for at least three years and valid for as long as you offer spare parts or customer support for that product model, to give anyone who possesses the object code either (1) a copy of the Corresponding Source for all the software in the product that is covered by this License, on a durable physical medium customarily used for software interchange, for a price no more than your reasonable cost of physically performing this conveying of source, or (2) access to copy the Corresponding Source from a network server at no charge. c) Convey individual copies of the object code with a copy of the written offer to provide the Corresponding Source. This alternative is allowed only occasionally and noncommercially, and only if you received the object code with such an offer, in accord with subsection 6b. d) Convey the object code by offering access from a designated place (gratis or for a charge), and offer equivalent access to the Corresponding Source in the same way through the same place at no further charge. You need not require recipients to copy the Corresponding Source along with the object code. If the place to copy the object code is a network server, the Corresponding Source may be on a different server (operated by you or a third party) that supports equivalent copying facilities, provided you maintain clear directions next to the object code saying where to find the Corresponding Source. Regardless of what server hosts the Corresponding Source, you remain obligated to ensure that it is available for as long as needed to satisfy these requirements. e) Convey the object code using peer-to-peer transmission, provided you inform other peers where the object code and Corresponding Source of the work are being offered to the general public at no charge under subsection 6d. A separable portion of the object code, whose source code is excluded from the Corresponding Source as a System Library, need not be included in conveying the object code work. A "User Product" is either (1) a "consumer product", which means any tangible personal property which is normally used for personal, family, or household purposes, or (2) anything designed or sold for incorporation into a dwelling. In determining whether a product is a consumer product, doubtful cases shall be resolved in favor of coverage. For a particular product received by a particular user, "normally used" refers to a typical or common use of that class of product, regardless of the status of the particular user or of the way in which the particular user actually uses, or expects or is expected to use, the product. A product is a consumer product regardless of whether the product has substantial commercial, industrial or non-consumer uses, unless such uses represent the only significant mode of use of the product. "Installation Information" for a User Product means any methods, procedures, authorization keys, or other information required to install and execute modified versions of a covered work in that User Product from a modified version of its Corresponding Source. The information must suffice to ensure that the continued functioning of the modified object code is in no case prevented or interfered with solely because modification has been made. If you convey an object code work under this section in, or with, or specifically for use in, a User Product, and the conveying occurs as part of a transaction in which the right of possession and use of the User Product is transferred to the recipient in perpetuity or for a fixed term (regardless of how the transaction is characterized), the Corresponding Source conveyed under this section must be accompanied by the Installation Information. But this requirement does not apply if neither you nor any third party retains the ability to install modified object code on the User Product (for example, the work has been installed in ROM). The requirement to provide Installation Information does not include a requirement to continue to provide support service, warranty, or updates for a work that has been modified or installed by the recipient, or for the User Product in which it has been modified or installed. Access to a network may be denied when the modification itself materially and adversely affects the operation of the network or violates the rules and protocols for communication across the network. Corresponding Source conveyed, and Installation Information provided, in accord with this section must be in a format that is publicly documented (and with an implementation available to the public in source code form), and must require no special password or key for unpacking, reading or copying. 7. Additional Terms. "Additional permissions" are terms that supplement the terms of this License by making exceptions from one or more of its conditions. Additional permissions that are applicable to the entire Program shall be treated as though they were included in this License, to the extent that they are valid under applicable law. If additional permissions apply only to part of the Program, that part may be used separately under those permissions, but the entire Program remains governed by this License without regard to the additional permissions. When you convey a copy of a covered work, you may at your option remove any additional permissions from that copy, or from any part of it. (Additional permissions may be written to require their own removal in certain cases when you modify the work.) You may place additional permissions on material, added by you to a covered work, for which you have or can give appropriate copyright permission. Notwithstanding any other provision of this License, for material you add to a covered work, you may (if authorized by the copyright holders of that material) supplement the terms of this License with terms: a) Disclaiming warranty or limiting liability differently from the terms of sections 15 and 16 of this License; or b) Requiring preservation of specified reasonable legal notices or author attributions in that material or in the Appropriate Legal Notices displayed by works containing it; or c) Prohibiting misrepresentation of the origin of that material, or requiring that modified versions of such material be marked in reasonable ways as different from the original version; or d) Limiting the use for publicity purposes of names of licensors or authors of the material; or e) Declining to grant rights under trademark law for use of some trade names, trademarks, or service marks; or f) Requiring indemnification of licensors and authors of that material by anyone who conveys the material (or modified versions of it) with contractual assumptions of liability to the recipient, for any liability that these contractual assumptions directly impose on those licensors and authors. All other non-permissive additional terms are considered "further restrictions" within the meaning of section 10. If the Program as you received it, or any part of it, contains a notice stating that it is governed by this License along with a term that is a further restriction, you may remove that term. If a license document contains a further restriction but permits relicensing or conveying under this License, you may add to a covered work material governed by the terms of that license document, provided that the further restriction does not survive such relicensing or conveying. If you add terms to a covered work in accord with this section, you must place, in the relevant source files, a statement of the additional terms that apply to those files, or a notice indicating where to find the applicable terms. Additional terms, permissive or non-permissive, may be stated in the form of a separately written license, or stated as exceptions; the above requirements apply either way. 8. Termination. You may not propagate or modify a covered work except as expressly provided under this License. Any attempt otherwise to propagate or modify it is void, and will automatically terminate your rights under this License (including any patent licenses granted under the third paragraph of section 11). However, if you cease all violation of this License, then your license from a particular copyright holder is reinstated (a) provisionally, unless and until the copyright holder explicitly and finally terminates your license, and (b) permanently, if the copyright holder fails to notify you of the violation by some reasonable means prior to 60 days after the cessation. Moreover, your license from a particular copyright holder is reinstated permanently if the copyright holder notifies you of the violation by some reasonable means, this is the first time you have received notice of violation of this License (for any work) from that copyright holder, and you cure the violation prior to 30 days after your receipt of the notice. Termination of your rights under this section does not terminate the licenses of parties who have received copies or rights from you under this License. If your rights have been terminated and not permanently reinstated, you do not qualify to receive new licenses for the same material under section 10. 9. Acceptance Not Required for Having Copies. You are not required to accept this License in order to receive or run a copy of the Program. Ancillary propagation of a covered work occurring solely as a consequence of using peer-to-peer transmission to receive a copy likewise does not require acceptance. However, nothing other than this License grants you permission to propagate or modify any covered work. These actions infringe copyright if you do not accept this License. Therefore, by modifying or propagating a covered work, you indicate your acceptance of this License to do so. 10. Automatic Licensing of Downstream Recipients. Each time you convey a covered work, the recipient automatically receives a license from the original licensors, to run, modify and propagate that work, subject to this License. You are not responsible for enforcing compliance by third parties with this License. An "entity transaction" is a transaction transferring control of an organization, or substantially all assets of one, or subdividing an organization, or merging organizations. If propagation of a covered work results from an entity transaction, each party to that transaction who receives a copy of the work also receives whatever licenses to the work the party's predecessor in interest had or could give under the previous paragraph, plus a right to possession of the Corresponding Source of the work from the predecessor in interest, if the predecessor has it or can get it with reasonable efforts. You may not impose any further restrictions on the exercise of the rights granted or affirmed under this License. For example, you may not impose a license fee, royalty, or other charge for exercise of rights granted under this License, and you may not initiate litigation (including a cross-claim or counterclaim in a lawsuit) alleging that any patent claim is infringed by making, using, selling, offering for sale, or importing the Program or any portion of it. 11. Patents. A "contributor" is a copyright holder who authorizes use under this License of the Program or a work on which the Program is based. The work thus licensed is called the contributor's "contributor version". A contributor's "essential patent claims" are all patent claims owned or controlled by the contributor, whether already acquired or hereafter acquired, that would be infringed by some manner, permitted by this License, of making, using, or selling its contributor version, but do not include claims that would be infringed only as a consequence of further modification of the contributor version. For purposes of this definition, "control" includes the right to grant patent sublicenses in a manner consistent with the requirements of this License. Each contributor grants you a non-exclusive, worldwide, royalty-free patent license under the contributor's essential patent claims, to make, use, sell, offer for sale, import and otherwise run, modify and propagate the contents of its contributor version. In the following three paragraphs, a "patent license" is any express agreement or commitment, however denominated, not to enforce a patent (such as an express permission to practice a patent or covenant not to sue for patent infringement). To "grant" such a patent license to a party means to make such an agreement or commitment not to enforce a patent against the party. If you convey a covered work, knowingly relying on a patent license, and the Corresponding Source of the work is not available for anyone to copy, free of charge and under the terms of this License, through a publicly available network server or other readily accessible means, then you must either (1) cause the Corresponding Source to be so available, or (2) arrange to deprive yourself of the benefit of the patent license for this particular work, or (3) arrange, in a manner consistent with the requirements of this License, to extend the patent license to downstream recipients. "Knowingly relying" means you have actual knowledge that, but for the patent license, your conveying the covered work in a country, or your recipient's use of the covered work in a country, would infringe one or more identifiable patents in that country that you have reason to believe are valid. If, pursuant to or in connection with a single transaction or arrangement, you convey, or propagate by procuring conveyance of, a covered work, and grant a patent license to some of the parties receiving the covered work authorizing them to use, propagate, modify or convey a specific copy of the covered work, then the patent license you grant is automatically extended to all recipients of the covered work and works based on it. A patent license is "discriminatory" if it does not include within the scope of its coverage, prohibits the exercise of, or is conditioned on the non-exercise of one or more of the rights that are specifically granted under this License. You may not convey a covered work if you are a party to an arrangement with a third party that is in the business of distributing software, under which you make payment to the third party based on the extent of your activity of conveying the work, and under which the third party grants, to any of the parties who would receive the covered work from you, a discriminatory patent license (a) in connection with copies of the covered work conveyed by you (or copies made from those copies), or (b) primarily for and in connection with specific products or compilations that contain the covered work, unless you entered into that arrangement, or that patent license was granted, prior to 28 March 2007. Nothing in this License shall be construed as excluding or limiting any implied license or other defenses to infringement that may otherwise be available to you under applicable patent law. 12. No Surrender of Others' Freedom. If conditions are imposed on you (whether by court order, agreement or otherwise) that contradict the conditions of this License, they do not excuse you from the conditions of this License. If you cannot convey a covered work so as to satisfy simultaneously your obligations under this License and any other pertinent obligations, then as a consequence you may not convey it at all. For example, if you agree to terms that obligate you to collect a royalty for further conveying from those to whom you convey the Program, the only way you could satisfy both those terms and this License would be to refrain entirely from conveying the Program. 13. Use with the GNU Affero General Public License. Notwithstanding any other provision of this License, you have permission to link or combine any covered work with a work licensed under version 3 of the GNU Affero General Public License into a single combined work, and to convey the resulting work. The terms of this License will continue to apply to the part which is the covered work, but the special requirements of the GNU Affero General Public License, section 13, concerning interaction through a network will apply to the combination as such. 14. Revised Versions of this License. The Free Software Foundation may publish revised and/or new versions of the GNU General Public License from time to time. Such new versions will be similar in spirit to the present version, but may differ in detail to address new problems or concerns. Each version is given a distinguishing version number. If the Program specifies that a certain numbered version of the GNU General Public License "or any later version" applies to it, you have the option of following the terms and conditions either of that numbered version or of any later version published by the Free Software Foundation. If the Program does not specify a version number of the GNU General Public License, you may choose any version ever published by the Free Software Foundation. If the Program specifies that a proxy can decide which future versions of the GNU General Public License can be used, that proxy's public statement of acceptance of a version permanently authorizes you to choose that version for the Program. Later license versions may give you additional or different permissions. However, no additional obligations are imposed on any author or copyright holder as a result of your choosing to follow a later version. 15. Disclaimer of Warranty. THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION. 16. Limitation of Liability. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. 17. Interpretation of Sections 15 and 16. If the disclaimer of warranty and limitation of liability provided above cannot be given local legal effect according to their terms, reviewing courts shall apply local law that most closely approximates an absolute waiver of all civil liability in connection with the Program, unless a warranty or assumption of liability accompanies a copy of the Program in return for a fee. END OF TERMS AND CONDITIONS How to Apply These Terms to Your New Programs If you develop a new program, and you want it to be of the greatest possible use to the public, the best way to achieve this is to make it free software which everyone can redistribute and change under these terms. To do so, attach the following notices to the program. It is safest to attach them to the start of each source file to most effectively state the exclusion of warranty; and each file should have at least the "copyright" line and a pointer to where the full notice is found. Copyright (C) This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see . Also add information on how to contact you by electronic and paper mail. If the program does terminal interaction, make it output a short notice like this when it starts in an interactive mode: Copyright (C) This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'. This is free software, and you are welcome to redistribute it under certain conditions; type `show c' for details. The hypothetical commands `show w' and `show c' should show the appropriate parts of the General Public License. Of course, your program's commands might be different; for a GUI interface, you would use an "about box". You should also get your employer (if you work as a programmer) or school, if any, to sign a "copyright disclaimer" for the program, if necessary. For more information on this, and how to apply and follow the GNU GPL, see . The GNU General Public License does not permit incorporating your program into proprietary programs. If your program is a subroutine library, you may consider it more useful to permit linking proprietary applications with the library. If this is what you want to do, use the GNU Lesser General Public License instead of this License. But first, please read . cyme-2.2.6/Makefile000066400000000000000000000103151506545537300141330ustar00rootroot00000000000000PROJECT_NAME := $(shell cargo metadata --no-deps --format-version 1 | jq -r '.packages[0].name') VERSION := $(shell cargo metadata --no-deps --format-version 1 | jq -r '.packages[0].version') OS := $(shell uname) RSRCS += $(wildcard src/*.rs) $(wildcard src/**/*.rs) AUTOCOMPLETES = doc/_$(PROJECT_NAME) doc/$(PROJECT_NAME).bash doc/$(PROJECT_NAME).fish doc/_$(PROJECT_NAME).ps1 DOCS = $(AUTOCOMPLETES) doc/$(PROJECT_NAME).1 doc/cyme_example_config.json # ?= allows overriding from command line with 'cross' CARGO_CMD ?= cargo CARGO_TARGET_DIR ?= target PACKAGE_DIR ?= $(CARGO_TARGET_DIR)/packages CARGO_FLAGS += --locked ifeq ($(TARGET),) PACKAGE_BASE := $(PROJECT_NAME)-v$(VERSION)-$(OS) TARGET_DIR := $(CARGO_TARGET_DIR) else PACKAGE_BASE := $(PROJECT_NAME)-v$(VERSION)-$(TARGET) TARGET_DIR := $(CARGO_TARGET_DIR)/$(TARGET) ifneq ($(TARGET),universal-apple-darwin) CARGO_FLAGS += --target $(TARGET) endif endif RELEASE_BIN := $(TARGET_DIR)/release/$(PROJECT_NAME) ifeq ($(findstring windows,$(TARGET)),windows) ARCHIVE_EXT := zip else ARCHIVE_EXT := tar.gz endif ARCHIVE := $(PACKAGE_DIR)/$(PACKAGE_BASE).$(ARCHIVE_EXT) ifeq ($(OS), Darwin) PREFIX ?= /usr/local else PREFIX ?= /usr endif BIN_PATH ?= $(PREFIX)/bin BASH_COMPLETION_PATH ?= $(PREFIX)/share/bash-completion/completions ZSH_COMPLETION_PATH ?= $(PREFIX)/share/zsh/site-functions MAN_PAGE_PATH ?= $(PREFIX)/share/man/man1 .PHONY: release install clean generated docs gen enter_version new_version release_version test package dpkg release: $(RELEASE_BIN) @echo "$(RELEASE_BIN)" install: release @echo "Installing $(PROJECT_NAME) $(VERSION)" install -Dm755 "$(RELEASE_BIN)" "$(DESTDIR)$(BIN_PATH)/$(PROJECT_NAME)" install -Dm644 ./doc/$(PROJECT_NAME).1 "$(DESTDIR)$(MAN_PAGE_PATH)/$(PROJECT_NAME).1" @if [ -d "$(DESTDIR)$(BASH_COMPLETION_PATH)" ]; then \ install -vDm0644 ./doc/$(PROJECT_NAME).bash "$(DESTDIR)$(BASH_COMPLETION_PATH)/$(PROJECT_NAME).bash"; \ fi @if [ -d "$(DESTDIR)$(ZSH_COMPLETION_PATH)" ]; then \ install -vDm0644 ./doc/_$(PROJECT_NAME) "$(DESTDIR)$(ZSH_COMPLETION_PATH)/_$(PROJECT_NAME)"; \ fi clean: $(CARGO_CMD) clean generated: $(DOCS) # I'm lazy to remember what I called it! docs: $(DOCS) gen: $(DOCS) enter_version: @echo "Current version: $(VERSION)" @echo "Enter new version: " @read new_version; \ sed -i "s/^version = .*/version = \"$$new_version\"/" Cargo.toml # update because Cargo.lock references self for tests $(CARGO_CMD) update new_version: test enter_version gen release_version: @exec scripts/release_version.sh test: $(CARGO_CMD) test $(CARGO_FLAGS) $(CARGO_TEST_FLAGS) # test with libusb profiler $(CARGO_CMD) test $(CARGO_FLAGS) $(CARGO_TEST_FLAGS) --no-default-features -F=ffi package: $(ARCHIVE) @echo "$(ARCHIVE)" dpkg: $(RELEASE_BIN) ifeq ($(TARGET),) cargo deb --no-strip --no-build else cargo deb --target $(TARGET) --no-strip --no-build endif $(DOCS): Cargo.toml $(RSRCS) @echo "Generating docs for $(PROJECT_NAME) $(VERSION)" $(CARGO_CMD) run $(CARGO_FLAGS) -F=cli_generate -- --gen $(RELEASE_BIN): Cargo.lock $(RSRCS) ifeq ($(TARGET),universal-apple-darwin) cargo build --target aarch64-apple-darwin $(CARGO_FLAGS) --release cargo build --target x86_64-apple-darwin $(CARGO_FLAGS) --release mkdir -p $(shell dirname $(RELEASE_BIN)) lipo -create -output $(RELEASE_BIN) \ $(CARGO_TARGET_DIR)/aarch64-apple-darwin/release/$(PROJECT_NAME) \ $(CARGO_TARGET_DIR)/x86_64-apple-darwin/release/$(PROJECT_NAME) else $(CARGO_CMD) build $(CARGO_FLAGS) --release endif $(ARCHIVE): $(RELEASE_BIN) README.md LICENSE CHANGELOG.md $(DOCS) mkdir -p $(PACKAGE_DIR)/$(PACKAGE_BASE) cp $(RELEASE_BIN) $(PACKAGE_DIR)/$(PACKAGE_BASE)/ cp README.md LICENSE CHANGELOG.md $(PACKAGE_DIR)/$(PACKAGE_BASE)/ cp 'doc/$(PROJECT_NAME).1' $(PACKAGE_DIR)/$(PACKAGE_BASE)/ mkdir -p $(PACKAGE_DIR)/$(PACKAGE_BASE)/autocomplete cp $(AUTOCOMPLETES) $(PACKAGE_DIR)/$(PACKAGE_BASE)/autocomplete/ ifeq ($(ARCHIVE_EXT),zip) cd $(PACKAGE_DIR) && 7z -y a $(PACKAGE_BASE).zip $(PACKAGE_BASE) else cd $(PACKAGE_DIR) && tar czf $(PACKAGE_BASE).tar.gz $(PACKAGE_BASE) endif rm -rf $(PACKAGE_DIR)/$(PACKAGE_BASE) %.deb: ifeq ($(TARGET),) cargo deb --no-strip --no-build --output $@ else cargo deb --target $(TARGET) --no-strip --no-build --output $@ endif cyme-2.2.6/README.md000066400000000000000000000346061506545537300137630ustar00rootroot00000000000000```bash o o /---o /---/---o o---/ \---\---o o \---o o ``` # Cyme [![Crates.io](https://img.shields.io/crates/v/cyme?style=flat-square)](https://crates.io/crates/cyme) [![docs.rs](https://img.shields.io/docsrs/cyme?style=flat-square)](https://docs.rs/cyme/latest/cyme/) List system USB buses and devices. A modern cross-platform `lsusb` that attempts to maintain compatibility with, but also add new features. Profiles system USB buses and the devices on those buses, including full device descriptors. As a developer of embedded devices, I use a USB list tool on a frequent basis and developed this to cater to what I believe are the short comings of `lsusb`: verbose dump is mostly _too_ verbose, tree doesn't contain useful data on the whole, it barely works on non-Linux platforms and modern terminals support features that make glancing through the data easier. The project started as a quick replacement for the barely working [lsusb script](https://github.com/jlhonora/lsusb) and a Rust project to keep me up to date! Like most fun projects, it quickly experienced feature creep as I developed it into a cross-platform replacement for `lsusb`. It started as a macOS `system_profiler` parser, evolved to include a 'libusb' based profiler for reading full device descriptors and now defaults to a pure Rust profiler using [nusb](https://github.com/kevinmehall/nusb). It's not perfect as it started out as a Rust refresher but I had a lot of fun developing it and hope others will find it useful and can contribute. Reading around the [lsusb source code](https://github.com/gregkh/usbutils/blob/master/lsusb.c), USB-IF and general USB information was also a good knowledge builder. The name comes from the technical term for the type of blossom on a Apple tree: [cyme](https://en.wikipedia.org/wiki/Inflorescence#Determinate_or_cymose) - it is Apple related and also looks like a USB device tree 😃🌸. ![cli tree output](./doc/cli-tree.png) # Features * Compatible with `lsusb` using `--lsusb` argument. Supports all arguments including `--verbose` output - fully parsed device descriptors! Output is identical for use with no args (list), tree (excluding drivers on non-Linux) and should match for verbose (perhaps formatting differences). * Default build is a native Rust profiler using [nusb](https://docs.rs/nusb/latest/nusb). * Filters like `lsusb` but that also work when printing `--tree`. Adds `--filter-name`, `--filter-serial`, `--filter-class` and option to hide empty `--hide-buses`/`--hide-hubs`. * Improved `--tree` mode; shows device, configurations, interfaces and endpoints as tree depending on level of `--verbose`. * Controllable display `--blocks` for device, bus `--bus-blocks`, configurations `--config-blocks`, interfaces `--interface-blocks` and endpoints `--endpoint-blocks`. Use `--more` to see more by default. * Modern terminal features with coloured output, utf-8 characters and icon look-up based device data. Can be turned off and customised. See `--encoding` (glyphs [default], utf8 and ascii), which can keep icons/tree within a certain encoding, `--color` (auto [default], always and never) and `--icon` (auto [default], always and never). Auto `--icon` will only show icons if all icons to be shown are supported by the `--encoding`. * Can be used as a library too with system profiler module, USB descriptor modules and `display` module for printing amongst others. * `--json` output that honours filters and `--tree`. * `--headers` to show meta data only when asked and not take space otherwise. * `--mask-serials` to either '\*' or randomise serial string for sharing dumps with sensitive serial numbers. * Auto-scaling to terminal width. Variable length strings such as descriptors will be truncated with a '...' to indicate this. Can be disabled with config option 'no-auto-width' and a fixed max defined with 'max-variable-string-len'. * `cyme watch` subcommand to watch for USB device hotplug events and also live edit display settings. Works with all global flags. * Targets for Linux, macOS and Windows. ## Demo * [General use asciicast](https://asciinema.org/a/IwYyZMrGMbXL4g15qDIaUViyM) * [Watch sub-command](https://youtu.be/ohRBrVBRolA) # Install ## Requirements For pre-compiled binaries, see the [releases](https://github.com/tuna-f1sh/cyme/releases). Pre-compiled builds use native profiling backends and should require no extra dependencies. From crates.io with a Rust tool-chain installed: `cargo install cyme`. To do it from within a local clone: `cargo install --locked --path .`. ### Package Managers * [Homebrew 'cyme'](https://formulae.brew.sh/formula/cyme) which will also install a man page, completions and the 'libusb' dependency: ```bash brew install cyme ``` * [Arch Linux official package](https://archlinux.org/packages/extra/x86_64/cyme/) ```bash pacman -S cyme ``` * [Debian packages as part of release](https://github.com/tuna-f1sh/cyme/releases) - need a Debian maintainer for this. More package managers to come/package distribution, please feel free to create a PR if you want to help out here. ## Alias `lsusb` If one wishes to create a macOS version of lsusb or just use this instead, create an alias one's environment with the `--lsusb` compatibility flag: `alias lsusb='cyme --lsusb'` ## Linux udev Information > [!NOTE] > Only supported on Linux targets. To obtain device and interface drivers being used on Linux like `lsusb`, one can use the `--features udev` feature when building - it's a default feature. The feature uses the Rust crate [udevrs](https://crates.io/crates/udevrs) to obtain the information. To use the C FFI libudev library, use `--no-default-features --features udevlib` which will use the 'libudev' crate. Note that this will require 'libudev-dev' to be installed on the host machine. To lookup USB IDs from the udev hwdb as well (like `lsusb`) use `--features udev_hwdb`. Without hwdb, `cyme` will use the 'usb-ids' crate, which is the same source as the hwdb binary data but the bundled hwdb may differ due to customisations or last update ('usb-ids' will be most up to date). ## Profilers and Feature Flags ### Native Uses native Rust [nusb](https://docs.rs/nusb/latest/nusb) and [udevrs](https://crates.io/crates/udevrs) for profiling devices: sysfs (Linux), IOKit (macOS) and WinUSB. It is the default profiler as of 2.0.0. Use `--feature=native` ('nusb' and 'udevrs' on Linux) or `--feature=nusb` to manually specify. ### Libusb Uses 'libusb' for profiling devices. Requires [libusb 1.0.0](https://libusb.info) to be installed: `brew install libusb`, `sudo apt install libusb-1.0-0-dev` or one's package manager of choice. Was the default feature before 2.0.0 for gathering verbose information. It is the profiler used by `lsusb` but there should be no difference in output between the two, since cyme uses control messages to gather the same information. If one wishes to use 'libusb', use `--no-default-features` and `--feature=libusb` or `--feature=ffi` for udevlib too. > [!NOTE] > 'libusb' does not profile buses on non-Linux systems (since it relies on root\_hubs). On these platforms, `cyme` will generate generic bus information. ### macOS `system_profiler` Uses the macOS `system_profiler SPUSBDataType` command to profile devices. Was the default feature before 2.0.0 for macOS systems to provide the base information; 'libusb' was used to open devices for verbose information. It is not used anymore if using the default native profiler but can be forced with `--system-profiler` - the native profiler uses the same IOKit backend but is much faster as it is not deserializing JSON. It also always captures bus numbers where `system_profiler` does not. > [!TIP] > If wishing to use only macOS `system_profiler` and not obtain more verbose information, remove default features with `cargo install --no-default-features cyme`. There is not much to be gained by this considering that the default native profiler uses the same IOKit as a backend, can open devices to read descriptors (verbose mode) and is much faster. # Usage Use `cyme --help` for basic usage or `man ./doc/cyme.1`. There are also autocompletions in './doc'. ## Examples ### Tree ```bash # List all USB devices and buses in a tree format with default display blocks cyme --tree # As above but with configurations too cyme --tree --verbose # And with interfaces and endpoints - each verbose level goes futher down the USB descriptor tree. Using short arg here. cyme --tree -vvv # List all USB devices and buses in a tree format with more display blocks, all verbose levels and headings to show what is being displayed cyme --tree --more --headings # Export the tree to a JSON file - --json works with all options cyme --tree --verbose --json > tree.json # Then import the JSON file to view the system USB tree as it was when exported. All cyme args can be used with this static import as if it was profiled data. cyme --from-json tree.json ``` ### lsusb ```bash # List all USB devices and buses like 'lsusb' cyme --lsusb # lsusb verbose device dump including all descriptor informaion cyme --lsusb --verbose # lsusb tree mode (can add verbose levels [-v]) cyme --lsusb --tree ``` ### Blocks See `cyme --help` for blocks available. One can also omit the value to the arg to show options. Specifying multiple blocks requires multiple args or csv. By default the supplied blocks will replace the default blocks. Use `--block-operation` to change this behaviour. ```bash # List USB devices with more display blocks cyme --more # List USB devices with chosen blocks: name, vid, pid, serial, speed (can use short -b) cyme --blocks name,vendor-id,product-id,serial -b speed # Customise other blocks - it's probably easier to use Config at this point cyme --blocks name --bus-blocks name --config-blocks name --interface-blocks class --endpoint-blocks number # Use block-operation to change the default or config blocks with arg blocks cyme --block-operation remove --blocks serial cyme --block-operation add --blocks base-class --blocks last-event --bus-blocks host-controller-vendor ``` ### Filtering ```bash # Filter for only Apple devices (vid:pid is base16) cyme -d 0x05ac # Specifically an Apple Headset, masking the serial number with '*' cyme -d 05ac:8103 --mask-serials hide # Filter for only devices with a certain name and class (filters can be combined) cyme --filter-name "Black Magic" --filter-class cdc-data ``` ## Crate For usage as a library for profiling system USB devices, the crate is 100% documented so look at [docs.rs](https://docs.rs/cyme/latest/cyme/). The main useful modules for import are [profiler](https://docs.rs/cyme/latest/cyme/profiler/index.html), and [usb](https://docs.rs/cyme/latest/cyme/usb/index.html). There are also some examples in 'examples/', these can be run with `cargo run --example filter_devices`. It wasn't really written from the ground-up to be a crate but all the USB descriptors might be useful for high level USB profiling. ## Config `cyme` will check for a 'cyme.json' config file in: * Linux: "$XDG\_CONFIG\_HOME/cyme or $HOME/.config/cyme" * macOS: "$HOME/Library/Application Support/cyme" * Windows: "{FOLDERID\_RoamingAppData}/cyme" One can also be supplied with `--config`. Copy or refer to './doc/cyme\_example\_config.json' for configurables. The file is essentially the default args; supplied args will override these. Use `--debug` to see where it is looking or if it's not loading. `cyme watch` can also be used to live edit display settings then save the config to the default location with 'Ctrl-s'. It's probably the easiest way to customise display blocks. ### Custom Icons and Colours See './doc/cyme\_example\_config.json' for an example of how icons can be defined and also the [docs](https://docs.rs/cyme/latest/cyme/icon/enum.Icon.html). The config can exclude the "user"/"colours" keys if one wishes not to define any new icons/colours. Icons are looked up in an order of User -> Default. For devices: `Name` -> `VidPid` -> `VidPidMsb` -> `Vid` -> `UnknownVendor` -> `get_default_vidpid_icon`, classes: `ClassifierSubProtocol` -> `Classifier` -> `UndefinedClassifier` -> `get_default_classifier_icon`. User supplied colours override all internal; if a key is missing, it will be `None`. #### Icons not Showing/Boxes with Question Marks Copied from [lsd](https://github.com/lsd-rs/lsd#icons-not-showing-up): For `cyme` to be able to display icons, the font has to include special font glyphs. This might not be the case for most fonts that you download. Thankfully, you can patch most fonts using [NerdFont](https://www.nerdfonts.com/) and add these icons. Or you can just download an already patched version of your favourite font from [NerdFont font download page](https://www.nerdfonts.com/font-downloads). Here is a guide on how to setup fonts on [macOS](https://github.com/Peltoche/lsd/issues/199#issuecomment-494218334) and [Android](https://github.com/Peltoche/lsd/issues/423). To check if the font you are using is setup correctly, try running the following snippet in a shell and see if that [prints a folder icon](https://github.com/Peltoche/lsd/issues/510#issuecomment-860000306). If it prints a box, or question mark or something else, then you might have some issues in how you setup the font or how your terminal emulator renders the font. ```sh echo $'\uf115' ``` If one does not want icons, provide a config file with custom blocks not including the any 'icon\*' blocks - see the example config. Alternatively, to only use standard UTF-8 characters supported by all fonts (no private use area) pass `--encoding utf8` and `--icon auto` (default). The `--icon auto` will drop the icon blocks if the characters matched are not supported by the `--encoding`. For no icons at all, use the hidden `--no-icons` or `--icon never` args. # Known Issues * `sudo` is required to open and read Linux root\_hub string descriptors and potentially all devices if the user does not have [permissions](https://docs.rs/nusb/latest/nusb/#linux). The program works fine without these however, as will use sysfs/hwdb/'usb-ids' like lsusb. Use debugging `-z` to see what devices failed to read. The env CYME_PRINT_NON_CRITICAL_PROFILER_STDERR can be used to print these to stderr. `--lsusb --verbose` will print a message to stderr always to match the 'lsusb' behaviour. * Users cannot open special non-user devices on Apple buses (VHCI); T2 chip for example. These will still be listed with 'native' and `system_profiler` but not `--force-libusb`. They will not print verbose information however and log an error if `--verbose` is used/print if `--lsusb`. cyme-2.2.6/benches/000077500000000000000000000000001506545537300141025ustar00rootroot00000000000000cyme-2.2.6/benches/get.rs000066400000000000000000000027461506545537300152400ustar00rootroot00000000000000use criterion::{black_box, criterion_group, criterion_main, Criterion}; use cyme::profiler; use cyme::usb::{DevicePath, EndpointPath, PortPath}; use std::sync::LazyLock; fn bench_dump() -> profiler::SystemProfile { profiler::read_json_dump("./tests/data/cyme_libusb_macos_tree.json").unwrap() } static DUMP: LazyLock = LazyLock::new(bench_dump); pub fn get_node(c: &mut Criterion) { let dump = &DUMP; c.bench_function("bench_get_device", |b| { b.iter(|| { let result = dump.get_node(&PortPath::new(2, vec![2, 3, 1])); black_box(result); }); }); c.bench_function("bench_get_root", |b| { b.iter(|| { let result = dump.get_node(&PortPath::new(2, vec![0])); black_box(result); }); }); } pub fn get_interface(c: &mut Criterion) { let dump = &DUMP; c.bench_function("bench_get_interface", |b| { b.iter(|| { let result = dump.get_interface(&DevicePath::new(20, vec![3, 3], Some(1), Some(5), None)); black_box(result); }); }); } pub fn get_endpoint(c: &mut Criterion) { let dump = &DUMP; c.bench_function("bench_get_endpoint", |b| { b.iter(|| { let result = dump.get_endpoint(&EndpointPath::new(20, vec![3, 3], 1, 5, 0, 0x85)); black_box(result); }); }); } criterion_group!(single_benches, get_node, get_interface, get_endpoint); criterion_main!(single_benches); cyme-2.2.6/benches/profile.rs000066400000000000000000000010671506545537300161140ustar00rootroot00000000000000use criterion::{black_box, criterion_group, criterion_main, Criterion}; use cyme::profiler; pub fn profile(c: &mut Criterion) { c.bench_function("bench_gather_system_profile", |b| { b.iter(|| { black_box(profiler::get_spusb_with_extra().unwrap()); }); }); #[cfg(target_os = "macos")] c.bench_function("bench_gather_system_profile_sp", |b| { b.iter(|| { black_box(profiler::macos::get_spusb().unwrap()); }); }); } criterion_group!(single_benches, profile); criterion_main!(single_benches); cyme-2.2.6/doc/000077500000000000000000000000001506545537300132405ustar00rootroot00000000000000cyme-2.2.6/doc/_cyme000066400000000000000000000425271506545537300142710ustar00rootroot00000000000000#compdef cyme autoload -U is-at-least _cyme() { typeset -A opt_args typeset -a _arguments_options local ret=1 if is-at-least 5.2; then _arguments_options=(-s -S -C) else _arguments_options=(-s -C) fi local context curcontext="$curcontext" state line _arguments "${_arguments_options[@]}" : \ '-d+[Show only devices with the specified vendor and product ID numbers (in hexadecimal) in format VID\:\[PID\]]:VIDPID:_default' \ '--vidpid=[Show only devices with the specified vendor and product ID numbers (in hexadecimal) in format VID\:\[PID\]]:VIDPID:_default' \ '-s+[Show only devices with specified device and/or bus numbers (in decimal) in format \[\[bus\]\:\]\[devnum\]]:SHOW:_default' \ '--show=[Show only devices with specified device and/or bus numbers (in decimal) in format \[\[bus\]\:\]\[devnum\]]:SHOW:_default' \ '-D+[Selects which device lsusb will examine - supplied as Linux /dev/bus/usb/BBB/DDD style path]:DEVICE:_default' \ '--device=[Selects which device lsusb will examine - supplied as Linux /dev/bus/usb/BBB/DDD style path]:DEVICE:_default' \ '--filter-name=[Filter on string contained in name]:FILTER_NAME:_default' \ '--filter-serial=[Filter on string contained in serial]:FILTER_SERIAL:_default' \ '--filter-class=[Filter on USB class code]:FILTER_CLASS:((use-interface-descriptor\:"Device class is unspecified, interface descriptors are used to determine needed drivers" audio\:"Speaker, microphone, sound card, MIDI" cdc-communications\:"The modern serial interface; appears as a UART/RS232 port on most systems" hid\:"Human Interface Device; game controllers, keyboards, mice etc. Also commonly used as a device data interface rather then creating something from scratch" physical\:"Force feedback joystick" image\:"Still imaging device; scanners, cameras" printer\:"Laser printer, inkjet printer, CNC machine" mass-storage\:"Mass storage devices (MSD)\: USB flash drive, memory card reader, digital audio player, digital camera, external drive" hub\:"High speed USB hub" cdc-data\:"Used together with class 02h (Communications and CDC Control) above" smart-card\:"USB smart card reader" content-security\:"Fingerprint reader" video\:"Webcam" personal-healthcare\:"Pulse monitor (watch)" audio-video\:"Webcam, TV" billboard\:"Describes USB-C alternate modes supported by device" usb-type-c-bridge\:"An interface to expose and configure the USB Type-C capabilities of Connectors on USB Hubs or Alternate Mode Adapters" bdp\:"This base class is defined for devices that conform to the “VESA USB BDP Device Specification†found at the VESA website. This specification defines the usable set of SubClass and Protocol values. Values outside of this defined spec are reserved. These class codes can only be used in Interface Descriptors" mctp\:"This base class is defined for devices that conform to the “MCTP over USB†found at the DMTF website as DSP0283. This specification defines the usable set of SubClass and Protocol values. Values outside of this defined spec are reserved. These class codes can only be used in Interface Descriptors" i3c-device\:"An interface to expose and configure I3C function within a USB device to allow interaction between host software and the I3C device, to drive transaction on the I3C bus to/from target devices" diagnostic\:"Trace and debugging equipment" wireless-controller\:"Wireless controllers\: Bluetooth adaptors, Microsoft RNDIS" miscellaneous\:"This base class is defined for miscellaneous device definitions. Some matching SubClass and Protocols are defined on the USB-IF website" application-specific-interface\:"This base class is defined for devices that conform to several class specifications found on the USB-IF website" vendor-specific-class\:"This base class is defined for vendors to use as they please"))' \ '*-b+[Specify the blocks which will be displayed for each device and in what order. Supply arg multiple times or csv to specify multiple blocks]:BLOCKS:((bus-number\:"Number of bus device is attached" device-number\:"Bus issued device number" branch-position\:"Position of device in parent branch" port-path\:"Linux style port path" sys-path\:"Linux udev reported syspath" driver\:"Linux udev reported driver loaded for device" icon\:"Icon based on VID/PID" vendor-id\:"Unique vendor identifier - purchased from USB IF" product-id\:"Vendor unique product identifier" vid-pid\:"Unique vendor identifier and product identifier as a string formatted "vid\:pid" like lsusb" name\:"The device name as reported in descriptor or using usb_ids if None" manufacturer\:"The device manufacturer as provided in descriptor or using usb_ids if None" product-name\:"The device product name as reported by usb_ids vidpid lookup" vendor-name\:"The device vendor name as reported by usb_ids vid lookup" serial\:"Device serial string as reported by descriptor" speed\:"Advertised device capable speed" negotiated-speed\:"Negotiated device speed as connected" tree-positions\:"Position along all branches back to trunk device" bus-power\:"macOS system_profiler only - actually bus current in mA not power!" bus-power-used\:"macOS system_profiler only - actually bus current used in mA not power!" extra-current-used\:"macOS system_profiler only - actually bus current used in mA not power!" bcd-device\:"The device version" bcd-usb\:"The supported USB version" base-class\:"Base class enum of interface provided by USB IF - only available when using libusb" sub-class\:"Sub-class value of interface provided by USB IF - only available when using libusb" protocol\:"Prototol value for interface provided by USB IF - only available when using libusb" uid-class\:"Class name from USB IDs repository" uid-sub-class\:"Sub-class name from USB IDs repository" uid-protocol\:"Protocol name from USB IDs repository" class\:"Fully defined USB Class Code enum based on BaseClass/SubClass/Protocol triplet" base-value\:"Base class as number value rather than enum" last-event\:"Last time device was seen" event-icon\:"Event icon"))' \ '*--blocks=[Specify the blocks which will be displayed for each device and in what order. Supply arg multiple times or csv to specify multiple blocks]:BLOCKS:((bus-number\:"Number of bus device is attached" device-number\:"Bus issued device number" branch-position\:"Position of device in parent branch" port-path\:"Linux style port path" sys-path\:"Linux udev reported syspath" driver\:"Linux udev reported driver loaded for device" icon\:"Icon based on VID/PID" vendor-id\:"Unique vendor identifier - purchased from USB IF" product-id\:"Vendor unique product identifier" vid-pid\:"Unique vendor identifier and product identifier as a string formatted "vid\:pid" like lsusb" name\:"The device name as reported in descriptor or using usb_ids if None" manufacturer\:"The device manufacturer as provided in descriptor or using usb_ids if None" product-name\:"The device product name as reported by usb_ids vidpid lookup" vendor-name\:"The device vendor name as reported by usb_ids vid lookup" serial\:"Device serial string as reported by descriptor" speed\:"Advertised device capable speed" negotiated-speed\:"Negotiated device speed as connected" tree-positions\:"Position along all branches back to trunk device" bus-power\:"macOS system_profiler only - actually bus current in mA not power!" bus-power-used\:"macOS system_profiler only - actually bus current used in mA not power!" extra-current-used\:"macOS system_profiler only - actually bus current used in mA not power!" bcd-device\:"The device version" bcd-usb\:"The supported USB version" base-class\:"Base class enum of interface provided by USB IF - only available when using libusb" sub-class\:"Sub-class value of interface provided by USB IF - only available when using libusb" protocol\:"Prototol value for interface provided by USB IF - only available when using libusb" uid-class\:"Class name from USB IDs repository" uid-sub-class\:"Sub-class name from USB IDs repository" uid-protocol\:"Protocol name from USB IDs repository" class\:"Fully defined USB Class Code enum based on BaseClass/SubClass/Protocol triplet" base-value\:"Base class as number value rather than enum" last-event\:"Last time device was seen" event-icon\:"Event icon"))' \ '*--bus-blocks=[Specify the blocks which will be displayed for each bus and in what order. Supply arg multiple times or csv to specify multiple blocks]:BUS_BLOCKS:((bus-number\:"System bus number identifier" icon\:"Icon based on VID/PID" name\:"System internal bus name based on Root Hub device name" host-controller\:"System internal bus provider name" host-controller-vendor\:"Vendor name of PCI Host Controller from pci.ids" host-controller-device\:"Device name of PCI Host Controller from pci.ids" pci-vendor\:"PCI vendor ID (VID)" pci-device\:"PCI device ID (PID)" pci-revision\:"PCI Revsision ID" port-path\:"syspath style port path to bus, applicable to Linux only"))' \ '*--config-blocks=[Specify the blocks which will be displayed for each configuration and in what order. Supply arg multiple times or csv to specify multiple blocks]:CONFIG_BLOCKS:((name\:"Name from string descriptor" number\:"Number of config, bConfigurationValue; value to set to enable to configuration" num-interfaces\:"Interfaces available for this configuruation" attributes\:"Attributes of configuration, bmAttributes" icon-attributes\:"Icon representation of bmAttributes" max-power\:"Maximum current consumption in mA"))' \ '*--interface-blocks=[Specify the blocks which will be displayed for each interface and in what order. Supply arg multiple times or csv to specify multiple blocks]:INTERFACE_BLOCKS:((name\:"Name from string descriptor" number\:"Interface number" port-path\:"Interface port path, applicable to Linux" base-class\:"Base class enum of interface provided by USB IF" sub-class\:"Sub-class value of interface provided by USB IF" protocol\:"Prototol value for interface provided by USB IF" alt-setting\:"Interfaces can have the same number but an alternate settings defined here" driver\:"Driver obtained from udev on Linux only" sys-path\:"syspath obtained from udev on Linux only" num-endpoints\:"An interface can have many endpoints" icon\:"Icon based on BaseClass/SubCode/Protocol" uid-class\:"Class name from USB IDs repository" uid-sub-class\:"Sub-class name from USB IDs repository" uid-protocol\:"Protocol name from USB IDs repository" class\:"Fully defined USB Class Code based on BaseClass/SubClass/Protocol triplet" base-value\:"Base class as number value rather than enum"))' \ '*--endpoint-blocks=[Specify the blocks which will be displayed for each endpoint and in what order. Supply arg multiple times or csv to specify multiple blocks]:ENDPOINT_BLOCKS:((number\:"Endpoint number on interface" direction\:"Direction of data into endpoint" transfer-type\:"Type of data transfer endpoint accepts" sync-type\:"Synchronisation type (Iso mode)" usage-type\:"Usage type (Iso mode)" max-packet-size\:"Maximum packet size in bytes endpoint can send/recieve" interval\:"Interval for polling endpoint data transfers. Value in frame counts. Ignored for Bulk & Control Endpoints. Isochronous must equal 1 and field may range from 1 to 255 for interrupt endpoints"))' \ '--block-operation=[Operation to perform on the blocks supplied via --blocks, --bus-blocks, --config-blocks, --interface-blocks and --endpoint-blocks]:BLOCK_OPERATION:((add\:"Add new blocks to the existing blocks, ignoring duplicates" append\:"Append new blocks to the end of the existing blocks" new\:"Replace all blocks with new ones" prepend\:"Prepend new blocks to the start of the existing blocks" remove\:"Remove matching blocks from the existing blocks"))' \ '--sort-devices=[Sort devices operation]:SORT_DEVICES:((device-number\:"Sort by bus device number" branch-position\:"Sort by position in parent branch" no-sort\:"No sorting; whatever order it was parsed"))' \ '--group-devices=[Group devices by value when listing]:GROUP_DEVICES:((no-group\:"No grouping" bus\:"Group into buses with bus info as heading - like a flat tree"))' \ '--color=[Output coloring mode]:COLOR:((auto\:"Show colours if the output goes to an interactive console" always\:"Always apply colouring to the output" never\:"Never apply colouring to the output"))' \ '--encoding=[Output character encoding]:ENCODING:((glyphs\:"Use UTF-8 private use area characters such as those used by NerdFont to show glyph icons" utf8\:"Use only standard UTF-8 characters for the output; no private use area glyph icons" ascii\:"Use only ASCII characters for the output; 0x00 - 0x7F (127 chars)"))' \ '--icon=[When to print icon blocks]:ICON:((auto\:"Show icon blocks if the \[\`Encoding\`\] supports icons matched in the \[\`icon\:\:IconTheme\`\]" always\:"Always print icon blocks if included in configured blocks" never\:"Never print icon blocks"))' \ '--from-json=[Read from json output rather than profiling system]:FROM_JSON:_files' \ '-c+[Path to user config file to use for custom icons, colours and default settings]:CONFIG:_files' \ '--config=[Path to user config file to use for custom icons, colours and default settings]:CONFIG:_files' \ '--mask-serials=[Mask serial numbers with '\''*'\'' or random chars]:MASK_SERIALS:((hide\:"Hide with '\''*'\'' char" scramble\:"Mask by randomising existing chars" replace\:"Mask by replacing length with random chars"))' \ '-l[Attempt to maintain compatibility with lsusb output]' \ '--lsusb[Attempt to maintain compatibility with lsusb output]' \ '-t[Dump USB device hierarchy as a tree]' \ '--tree[Dump USB device hierarchy as a tree]' \ '*-v[Verbosity level (repeat provides count)\: 1 prints device configurations; 2 prints interfaces; 3 prints interface endpoints; 4 prints everything and more blocks]' \ '*--verbose[Verbosity level (repeat provides count)\: 1 prints device configurations; 2 prints interfaces; 3 prints interface endpoints; 4 prints everything and more blocks]' \ '-m[Print more blocks by default at each verbosity]' \ '--more[Print more blocks by default at each verbosity]' \ '--sort-buses[Sort devices by bus number. If using any sort-devices other than no-sort, this happens automatically]' \ '--hide-buses[Hide empty buses when printing tree; those with no devices]' \ '--hide-hubs[Hide empty hubs when printing tree; those with no devices. When listing will hide hubs regardless of whether empty of not]' \ '--list-root-hubs[Show root hubs when listing; Linux only]' \ '--decimal[Show base16 values as base10 decimal instead]' \ '--no-padding[Disable padding to align blocks - will cause --headings to become maligned]' \ '--no-color[Disable coloured output, can also use NO_COLOR environment variable]' \ '--ascii[Disables icons and utf-8 characters]' \ '--no-icons[Disables all Block icons by not using any IconTheme. Providing custom XxxxBlocks without any icons is a nicer way to do this]' \ '--headings[Show block headings]' \ '--json[Output as json format after sorting, filters and tree settings are applied; without -tree will be flattened dump of devices]' \ '-F[Force pure libusb profiler on macOS rather than combining system_profiler output]' \ '--force-libusb[Force pure libusb profiler on macOS rather than combining system_profiler output]' \ '*-z[Turn debugging information on. Alternatively can use RUST_LOG env\: INFO, DEBUG, TRACE]' \ '*--debug[Turn debugging information on. Alternatively can use RUST_LOG env\: INFO, DEBUG, TRACE]' \ '--gen[Generate cli completions and man page]' \ '--system-profiler[Use the system_profiler command on macOS to get USB data]' \ '-h[Print help (see more with '\''--help'\'')]' \ '--help[Print help (see more with '\''--help'\'')]' \ '-V[Print version]' \ '--version[Print version]' \ ":: :_cyme_commands" \ "*::: :->cyme" \ && ret=0 case $state in (cyme) words=($line[1] "${words[@]}") (( CURRENT += 1 )) curcontext="${curcontext%:*:*}:cyme-command-$line[1]:" case $line[1] in (watch) _arguments "${_arguments_options[@]}" : \ '-h[Print help]' \ '--help[Print help]' \ && ret=0 ;; (help) _arguments "${_arguments_options[@]}" : \ ":: :_cyme__help_commands" \ "*::: :->help" \ && ret=0 case $state in (help) words=($line[1] "${words[@]}") (( CURRENT += 1 )) curcontext="${curcontext%:*:*}:cyme-help-command-$line[1]:" case $line[1] in (watch) _arguments "${_arguments_options[@]}" : \ && ret=0 ;; (help) _arguments "${_arguments_options[@]}" : \ && ret=0 ;; esac ;; esac ;; esac ;; esac } (( $+functions[_cyme_commands] )) || _cyme_commands() { local commands; commands=( 'watch:Watch for USB devices being connected and disconnected' \ 'help:Print this message or the help of the given subcommand(s)' \ ) _describe -t commands 'cyme commands' commands "$@" } (( $+functions[_cyme__help_commands] )) || _cyme__help_commands() { local commands; commands=( 'watch:Watch for USB devices being connected and disconnected' \ 'help:Print this message or the help of the given subcommand(s)' \ ) _describe -t commands 'cyme help commands' commands "$@" } (( $+functions[_cyme__help__help_commands] )) || _cyme__help__help_commands() { local commands; commands=() _describe -t commands 'cyme help help commands' commands "$@" } (( $+functions[_cyme__help__watch_commands] )) || _cyme__help__watch_commands() { local commands; commands=() _describe -t commands 'cyme help watch commands' commands "$@" } (( $+functions[_cyme__watch_commands] )) || _cyme__watch_commands() { local commands; commands=() _describe -t commands 'cyme watch commands' commands "$@" } if [ "$funcstack[1]" = "_cyme" ]; then _cyme "$@" else compdef _cyme cyme fi cyme-2.2.6/doc/_cyme.ps1000066400000000000000000000264231506545537300147700ustar00rootroot00000000000000 using namespace System.Management.Automation using namespace System.Management.Automation.Language Register-ArgumentCompleter -Native -CommandName 'cyme' -ScriptBlock { param($wordToComplete, $commandAst, $cursorPosition) $commandElements = $commandAst.CommandElements $command = @( 'cyme' for ($i = 1; $i -lt $commandElements.Count; $i++) { $element = $commandElements[$i] if ($element -isnot [StringConstantExpressionAst] -or $element.StringConstantType -ne [StringConstantType]::BareWord -or $element.Value.StartsWith('-') -or $element.Value -eq $wordToComplete) { break } $element.Value }) -join ';' $completions = @(switch ($command) { 'cyme' { [CompletionResult]::new('-d', '-d', [CompletionResultType]::ParameterName, 'Show only devices with the specified vendor and product ID numbers (in hexadecimal) in format VID:[PID]') [CompletionResult]::new('--vidpid', '--vidpid', [CompletionResultType]::ParameterName, 'Show only devices with the specified vendor and product ID numbers (in hexadecimal) in format VID:[PID]') [CompletionResult]::new('-s', '-s', [CompletionResultType]::ParameterName, 'Show only devices with specified device and/or bus numbers (in decimal) in format [[bus]:][devnum]') [CompletionResult]::new('--show', '--show', [CompletionResultType]::ParameterName, 'Show only devices with specified device and/or bus numbers (in decimal) in format [[bus]:][devnum]') [CompletionResult]::new('-D', '-D ', [CompletionResultType]::ParameterName, 'Selects which device lsusb will examine - supplied as Linux /dev/bus/usb/BBB/DDD style path') [CompletionResult]::new('--device', '--device', [CompletionResultType]::ParameterName, 'Selects which device lsusb will examine - supplied as Linux /dev/bus/usb/BBB/DDD style path') [CompletionResult]::new('--filter-name', '--filter-name', [CompletionResultType]::ParameterName, 'Filter on string contained in name') [CompletionResult]::new('--filter-serial', '--filter-serial', [CompletionResultType]::ParameterName, 'Filter on string contained in serial') [CompletionResult]::new('--filter-class', '--filter-class', [CompletionResultType]::ParameterName, 'Filter on USB class code') [CompletionResult]::new('-b', '-b', [CompletionResultType]::ParameterName, 'Specify the blocks which will be displayed for each device and in what order. Supply arg multiple times or csv to specify multiple blocks') [CompletionResult]::new('--blocks', '--blocks', [CompletionResultType]::ParameterName, 'Specify the blocks which will be displayed for each device and in what order. Supply arg multiple times or csv to specify multiple blocks') [CompletionResult]::new('--bus-blocks', '--bus-blocks', [CompletionResultType]::ParameterName, 'Specify the blocks which will be displayed for each bus and in what order. Supply arg multiple times or csv to specify multiple blocks') [CompletionResult]::new('--config-blocks', '--config-blocks', [CompletionResultType]::ParameterName, 'Specify the blocks which will be displayed for each configuration and in what order. Supply arg multiple times or csv to specify multiple blocks') [CompletionResult]::new('--interface-blocks', '--interface-blocks', [CompletionResultType]::ParameterName, 'Specify the blocks which will be displayed for each interface and in what order. Supply arg multiple times or csv to specify multiple blocks') [CompletionResult]::new('--endpoint-blocks', '--endpoint-blocks', [CompletionResultType]::ParameterName, 'Specify the blocks which will be displayed for each endpoint and in what order. Supply arg multiple times or csv to specify multiple blocks') [CompletionResult]::new('--block-operation', '--block-operation', [CompletionResultType]::ParameterName, 'Operation to perform on the blocks supplied via --blocks, --bus-blocks, --config-blocks, --interface-blocks and --endpoint-blocks') [CompletionResult]::new('--sort-devices', '--sort-devices', [CompletionResultType]::ParameterName, 'Sort devices operation') [CompletionResult]::new('--group-devices', '--group-devices', [CompletionResultType]::ParameterName, 'Group devices by value when listing') [CompletionResult]::new('--color', '--color', [CompletionResultType]::ParameterName, 'Output coloring mode') [CompletionResult]::new('--encoding', '--encoding', [CompletionResultType]::ParameterName, 'Output character encoding') [CompletionResult]::new('--icon', '--icon', [CompletionResultType]::ParameterName, 'When to print icon blocks') [CompletionResult]::new('--from-json', '--from-json', [CompletionResultType]::ParameterName, 'Read from json output rather than profiling system') [CompletionResult]::new('-c', '-c', [CompletionResultType]::ParameterName, 'Path to user config file to use for custom icons, colours and default settings') [CompletionResult]::new('--config', '--config', [CompletionResultType]::ParameterName, 'Path to user config file to use for custom icons, colours and default settings') [CompletionResult]::new('--mask-serials', '--mask-serials', [CompletionResultType]::ParameterName, 'Mask serial numbers with ''*'' or random chars') [CompletionResult]::new('-l', '-l', [CompletionResultType]::ParameterName, 'Attempt to maintain compatibility with lsusb output') [CompletionResult]::new('--lsusb', '--lsusb', [CompletionResultType]::ParameterName, 'Attempt to maintain compatibility with lsusb output') [CompletionResult]::new('-t', '-t', [CompletionResultType]::ParameterName, 'Dump USB device hierarchy as a tree') [CompletionResult]::new('--tree', '--tree', [CompletionResultType]::ParameterName, 'Dump USB device hierarchy as a tree') [CompletionResult]::new('-v', '-v', [CompletionResultType]::ParameterName, 'Verbosity level (repeat provides count): 1 prints device configurations; 2 prints interfaces; 3 prints interface endpoints; 4 prints everything and more blocks') [CompletionResult]::new('--verbose', '--verbose', [CompletionResultType]::ParameterName, 'Verbosity level (repeat provides count): 1 prints device configurations; 2 prints interfaces; 3 prints interface endpoints; 4 prints everything and more blocks') [CompletionResult]::new('-m', '-m', [CompletionResultType]::ParameterName, 'Print more blocks by default at each verbosity') [CompletionResult]::new('--more', '--more', [CompletionResultType]::ParameterName, 'Print more blocks by default at each verbosity') [CompletionResult]::new('--sort-buses', '--sort-buses', [CompletionResultType]::ParameterName, 'Sort devices by bus number. If using any sort-devices other than no-sort, this happens automatically') [CompletionResult]::new('--hide-buses', '--hide-buses', [CompletionResultType]::ParameterName, 'Hide empty buses when printing tree; those with no devices') [CompletionResult]::new('--hide-hubs', '--hide-hubs', [CompletionResultType]::ParameterName, 'Hide empty hubs when printing tree; those with no devices. When listing will hide hubs regardless of whether empty of not') [CompletionResult]::new('--list-root-hubs', '--list-root-hubs', [CompletionResultType]::ParameterName, 'Show root hubs when listing; Linux only') [CompletionResult]::new('--decimal', '--decimal', [CompletionResultType]::ParameterName, 'Show base16 values as base10 decimal instead') [CompletionResult]::new('--no-padding', '--no-padding', [CompletionResultType]::ParameterName, 'Disable padding to align blocks - will cause --headings to become maligned') [CompletionResult]::new('--no-color', '--no-color', [CompletionResultType]::ParameterName, 'Disable coloured output, can also use NO_COLOR environment variable') [CompletionResult]::new('--ascii', '--ascii', [CompletionResultType]::ParameterName, 'Disables icons and utf-8 characters') [CompletionResult]::new('--no-icons', '--no-icons', [CompletionResultType]::ParameterName, 'Disables all Block icons by not using any IconTheme. Providing custom XxxxBlocks without any icons is a nicer way to do this') [CompletionResult]::new('--headings', '--headings', [CompletionResultType]::ParameterName, 'Show block headings') [CompletionResult]::new('--json', '--json', [CompletionResultType]::ParameterName, 'Output as json format after sorting, filters and tree settings are applied; without -tree will be flattened dump of devices') [CompletionResult]::new('-F', '-F ', [CompletionResultType]::ParameterName, 'Force pure libusb profiler on macOS rather than combining system_profiler output') [CompletionResult]::new('--force-libusb', '--force-libusb', [CompletionResultType]::ParameterName, 'Force pure libusb profiler on macOS rather than combining system_profiler output') [CompletionResult]::new('-z', '-z', [CompletionResultType]::ParameterName, 'Turn debugging information on. Alternatively can use RUST_LOG env: INFO, DEBUG, TRACE') [CompletionResult]::new('--debug', '--debug', [CompletionResultType]::ParameterName, 'Turn debugging information on. Alternatively can use RUST_LOG env: INFO, DEBUG, TRACE') [CompletionResult]::new('--gen', '--gen', [CompletionResultType]::ParameterName, 'Generate cli completions and man page') [CompletionResult]::new('--system-profiler', '--system-profiler', [CompletionResultType]::ParameterName, 'Use the system_profiler command on macOS to get USB data') [CompletionResult]::new('-h', '-h', [CompletionResultType]::ParameterName, 'Print help (see more with ''--help'')') [CompletionResult]::new('--help', '--help', [CompletionResultType]::ParameterName, 'Print help (see more with ''--help'')') [CompletionResult]::new('-V', '-V ', [CompletionResultType]::ParameterName, 'Print version') [CompletionResult]::new('--version', '--version', [CompletionResultType]::ParameterName, 'Print version') [CompletionResult]::new('watch', 'watch', [CompletionResultType]::ParameterValue, 'Watch for USB devices being connected and disconnected') [CompletionResult]::new('help', 'help', [CompletionResultType]::ParameterValue, 'Print this message or the help of the given subcommand(s)') break } 'cyme;watch' { [CompletionResult]::new('-h', '-h', [CompletionResultType]::ParameterName, 'Print help') [CompletionResult]::new('--help', '--help', [CompletionResultType]::ParameterName, 'Print help') break } 'cyme;help' { [CompletionResult]::new('watch', 'watch', [CompletionResultType]::ParameterValue, 'Watch for USB devices being connected and disconnected') [CompletionResult]::new('help', 'help', [CompletionResultType]::ParameterValue, 'Print this message or the help of the given subcommand(s)') break } 'cyme;help;watch' { break } 'cyme;help;help' { break } }) $completions.Where{ $_.CompletionText -like "$wordToComplete*" } | Sort-Object -Property ListItemText } cyme-2.2.6/doc/cli-tree.png000066400000000000000000006702201506545537300154610ustar00rootroot00000000000000‰PNG  IHDRZ~Û¿ÝH ²iCCPICC ProfileH‰•—Té€ÿ™ôF D@JèéB   l„$@(!¦ `GWp-ˆˆ€º¢« 6ª Åö ²ˆ¨ëbÁ†Êàv÷÷Þy÷œîwîÜÿ–9óϹE“#eÀ*d ¥âˆ@_z\|÷ €P`ÉáJDÌððP€È”þ»|èи¾m3ëßïÿWQåñ%\ p„“xn&Â'õž+K@Õ v£¥RÑ8w"¬.F DX>Î)“ü~œ“&Ÿð‰Š`!¬žÌáˆS ›#vz67‰CBØNÈÎAØ+33‹‡p ÂæˆáñøŒ¤¿ÄIù[Ì$EL'EÁ“½LÞO eprÿÏÇñ¿%3C6•ÃYäTqP¢‘º {éY! &Í ›bo‚SeAÑSÌ•°¦˜Çñ Qì͘:ÅÉ‚¶"Ž”5Å|‰ä‹³"¹’Å,æsÄÓyeéÑ {*Ÿ­ˆŸ—;ÅÙ‚˜¹S,I ™öa)ìbY„¢~¾0Ðw:o€¢÷LÉ_ú°{¥©QAŠÞ9Óõó…Ì阒8Em<¾Ÿÿ´O´Â_$õUäe„+üù »$;R±WŠ¼Ó{ÃÏ0>Å H ð€d:ðC´ˆ@à€\)?G:Þ+K”+¤¤JéLä¤ñél!×Öšî`çàÀø¹|-ÞÑ&Î#D»6m[[ €gëØØØÉi[ðMŽ&@lœ¶™/@e€+§¸2qö¤ =~Á"Pê@ ù.s`€ ð>Àƒ0âÁ"À© ˆÁR°¬… lÛ@Ø ö‚pÍà8.ƒëà&¸ 9/Á0øF!ÂAˆ iAú d9@ È ò‡B¡(J„R !$ƒ–Ck¡b¨ª€ö@µÐQ¨:]…º¡ûP4½…¾À(˜ «Ãº°)< fÀL8Ž‚Â)ð8.€7Âåp5|n‚ÏÃ×á»°~  Š„¢¡ P6(Š… C% ’QbÔJTª UªGµ¡:P·QrÔ+Ôg4MEÓÑ6ht:ÍE/A¯Do@W kÐMè‹èÛè>ô0ú;†‚ÑÁXaÜ1lL&³Sˆ)ÃìÇ4b.aîb0°X, k†uÅaã±iØeØ ØØì9l7¶;‚Ãá´pV8O\Žƒ“â q;p‡pgq·p¸Ox^ï€À'à…ø||þ þ þ~?JP!˜Ü a!—°‰°ÐF¸A ŒU‰fDOb1¸†XN¬'^">"¾#‘H†$7Ò<’€´šTN:BºBê#}&«‘-É,ò²Œ¼‘|€|Ž|ŸüŽB¡˜R|( )e#¥–rò„òI‰ªd«ÄVâ)­RªTjRº¥ôZ™ l¢ÌT^¤œ§\¦|\ù†ò+‚Š© K…£²R¥R¥U¥WeD•ªj¯¦š©ºAõ êUÕçj85S55žZÚ^µ jýTՈʢr©k©û¨—¨êXu3u¶zšz±úaõ.õa 5 'JÓrŠfJcÓ2h›hÇh=´/3tg0gðg¬ŸQ?ãÖŒš35}4ùšEš šw5¿hѵüµÒµ¶h5k=ÖFk[jÏÓ^ª½Kû’ö«™ê3=frgÍ<6ó¬c©¡³Lg¯N§Îˆ®žn ®Hw‡îÝWz4=½4½R½3zCúT}/}~©þYýt :“žA/§_¤èÈ ötŒšFæ6>6"1Œ’JÚ†õç/7®3~`B0a˜¤šl7é0ùhjfkºÎ´Ùô¹™¦Û,ϬÎì‘9ÅÜÛ|‰yµù ¬Ã"Ýb§ÅMKØÒÙ2Õ²Òò†låb%°ÚiÕm±v³ZW[÷Úm˜6Ù6u6}¶4ÛPÛ|ÛfÛ׳Œg%ÌÚ2«cÖw;g» »}víÕìƒíóíÛìß:X:p*î8RW9¶8¾q²râ;írºçLužã¼Î¹Ýù›‹«‹Ø¥ÞeÈÕØ5ѵʵ—¡Îgl`\qøùº­r;åöÙÝÅ]ê~ÌýOtƒÏg›ÍæÏÞ7»ßÓГã¹ÇSîE÷JôúÙKîmàÍñ®ö~êcäÃóÙï3È´`¦11_ûÚùŠ}}?²ÜY+XçüP~~E~]þjþÑþþO Rꆗž Â…m êeë²¹ìZöp°kðŠà‹!äÈŠ§¡–¡âж9ðœà9[ç<šk2W8·9 „±Ã¶†=7 _~rv^ø¼ÊyÏ"ì#–GtDR#GŒüåµ)êa´y´,º=F9fALmÌÇX¿Ø’Xyܬ¸q×ãµãñ- ¸„˜„ý #óýço›?°ÀyAá‚ž…f s^]¤½(cÑéÅÊ‹9‹'bc&~å„qª9#I줪¤a.‹»û’çÃ+å ñ=ù%üÁdÏä’äç)ž)[S†R½SËR_ X‚ Á›´ ´ÝiÓÃÒ¤eÄf4dâ33[…jÂtáÅ,½¬œ¬n‘•¨P$_â¾dÛ’aqˆx¿’,”´HÕ‘©Sf.ûAÖ—í•]™ýiiÌÒã9ª9ÂœÎ\ËÜõ¹ƒyy¿,C/ã.k_n°|Íò¾Ì{VB+“V¶¯2ZU°j`uàêš5Ä5ék~Í·Ë/É¿6vm[nÁê‚þ¨+T*ö®óX·ûGô‚»Ö;®ß±þ{¯èZ±]qYñ× Ü ×~²ÿ©ü§±É»6¹lÚµ»Y¸¹g‹÷–šÕ’¼’þ­s¶6•ÒK‹Jßo[¼íj™SÙîíÄí²íòòÐò–Æ;6ïøZ‘Zq·Ò·²¡J§j}ÕǼ·vùìªß­»»x÷—Ÿ?ßÛ¸§©Ú´ºl/voöÞgûböuüÂø¥v¿öþâýßÈk"j.ÖºÖÖÔ9¸©®“Õ Zpèæa¿Ã-õ6õ{h ÅGÀÙ‘Gö 9Ö~œq¼þ„ɉªFjcQÔ”Û4ÜœÚ,o‰oén nmoóhkìçö¿ü]òûׂg”geƒúƒµÏžŸ ºùbþ‹—¢—£¯ ÿPý£êµùëúüÙ97<ðFüfìí†wZï¼wzß>>òäCæ‡ÑEŸ´>Õ|f|îøûeptéWÜ×òoßÚ¾‡|4–96&âˆ9£ Ypr2o@‰€ŠÌÄù“sõ„@“ÿþOÎÞâ@=¢ÆÇ#Ö9Ž Ët5Ê>ŒFQ>vtT¬©xb^,òçRïáåfòĺüS&gù¿ÔýO Æ£:êÎÈ ÇS®–eXIfMM*JR(‡iZ’†„ Z ~ASCIIScreenshotµæBK pHYs%%IR$ðØiTXtXML:com.adobe.xmp 1626 Screenshot 638 2 144 144 1 k€Y@IDATxì|UöÇqw—6I“º»—¶”¶¸»Ë»,ì»Àâ¶X\YÜu‘––B¨PwoÒ&5î.ÿ{ïë¼<™yï¥yi—Ïdf®žû½ó¦|î™sŽÛÀA©­°‘F¯J6oYo£FÏd{xxÂÛ˯gç¨.E ¶®~¾A°÷,'co[ÓvM–ÎÞkõx&         èÜz£¢E¢¦²¥w>p®&µT–0‘ €½ÜímØÓíš››ÐØX×Óbp|  )Kì=K+™ì=›¶U™ôÕÙ{­Ï$@$@$@$@$@$@$@$@$@$@½‹@¯µhé]˜)- ÀñH ×Z´‹Á9‘ ô.T´ô®õ¢´$@$@$@$@$@$@$@$@$@$@$@.D€ŠZ ŠB$@$@$@$@$@$@$@$@$@$@$лPÑÒ»Ö‹Ò’ ¸*Z\h1( @ï"@EKïZ/JK&à ¤N×gE ×!À߯ë¬%!       ŽxvTå$@½À ÄY¸púóðp÷Äά%øâ·;zß$(1 œ øû=AžÓ&      èµ:¥h DUUU·OÒçg¿/?ãX¿¿š‹Ì_ZŒ÷¼ =gLx£SÏÃÁüßñáò›õªôê¼ÐÀÜzæB5‡·~¼ ¹%»ÚÏ€„™JÉ"+ îs2ÜŵÝ,t1¡ýœŒÚú <²ÖUÄ¢ípöûÇÙ¿ß®¾?Ú™j·9›_·ÉNI€H€H€H€H€H€H€H íºknnVM½½}ÚéÂyEÍõnÈÞPw7ã‘23Øy°§ã–€»›»R,¸»µ)鎷ÉJëy@©MÚŸÝ.aÅÒÐT«*mÍø–J–öq¹T鈔³p‘°F:eÌ.%…±MÀÙïŸîøývåýa{¦ÝSâl~Ý#%{%       ÛÚµh©­­F``0BCÂPRRl»'–\Q…Ô™áÆc‡Á/¢µÅíê„ŒõyA$È[…§¾œ oO?ÔÔ— @/"Àßo/Z,ŠJ$@$@$@$@$@$@$@‚@»Ú‹šÚ)D(Z<<Ž¥@áN7T6ÇMøÕ¡^hllÁþÍwMz2ú¸£ßP?Uthw-j* ý…Çz"¶¯J‹Q’׈ñóBáèMKËPœ×ÿ wŒŸ ßlý­ ùõº7æÉþ Tò7Ôµ¢àpv¯¯Bc½±Êqä%b“ÌA°,êÊ‘ž·y¥»;5oÏ ütÑ6ÂýVQÅAìÏùÍ(Û§ÅMíãÔx¥ÕÙ8ó*k;~†==¼1P²  Úº!·xöå¬VÚ°âïŠÄˆ‘ºó«¨ÉG~Ù^Ý2-SŽ"ä­i(AvÑvØËOº'˜81aƒàîæ‰|Á|Ïá¥ê:%f¢.³p=ê J\m|í,cÉ$FB|øPøzÃMhZë*‘W²Y…†ö9hýô¦stH*B"‡öQ×¾ÞA’1_»(©ÊÏä!íV¥åRrôu-ùJ·qä: îæ¼PP¾{¯ÏpY;½g<ÿŽü~ôdêmy]ýý8úûÕøØûþÐÚ˳£ëoÚWW¯[aø7QòÒ÷õ­m(C†x·—*.l°xgE£ª®P·ž|/¥ÆNUâdo±©€vÆûÇ~ο«ÌYŸH€H€H€H€H€H€HÀ9ÚU´”——AÆi‘Ö,RáR+,\Ž… ±ƒ+ê…¢¥m‚! ¾KmEiºÜ†è¾äãç†óoKÀ虑bƒ×|œÆÆV,ÿ,K>*²Š*Ÿâ‹KþÖO5xú¦8’©¯?7gß”„úÚfçLú'䦣–挶ˆX%ßýþZZõfr³ú´ñ÷cd¿³„ŠÃü¨m¨À‚u`gæZ—VgÙþô bDÊVí›[š°j×[X¾õe›ñRdôKgþ[lº'˜õ#”-Rîö’Üh¼lÖ+ºU6§ÿßvÐ~âÀË0&íµ¡¹)ãk»øE% ^…<›¦‚òJ~M¾ÿ,<GÊö™VQ×aBAuñŒ+”4zI*¼¾øíNݶzõ{KÞØþaâÀË­Ä  ™iá¯;ÞÀ²­/™f!$ ÎX÷Ÿ®Æüq÷@>¦©²¶Ÿýú¥H3Í×®ñü;òûÑäèíg{Þ?Žþ~%3GÞ²½£ë/ûp4µˆ/¤rñÂÏÂË÷­»Q·«÷÷÷kDs‹!v\[!0uèõ–4»…RW>ã–ÉÇ+ÐøûxïçëpðÈ:Ë*pôýã(?GÇ·š3H€H€H€H€H€H€H€Ž)ÈÈð‡Û±¥µÁÁ¡ªŠŒÕÒÜÜ„ššêöš8\ÖP冸ўðhÛ(ojl@þæ&‡û¶ÙØW¿á± ›®”™»+…õH òÕKO…z!u„øÂÞ½é[Í¿Æ/Ì©ÇÔ3#áåíŽæ¦ìݨ¯Ì8ÿÖ>÷ƦeEض²Ò(JÒ`?aŠ 0/aÅRŒ_¾ÊGd¢"ã|1h|06ÿR"”<ùöBD¬¯Pºø`Ý¥ÆöêBÈõýI9#MM­Øøs!Ö..Dú¶ xûº#*Á#§‡#'½…ÙúŠ ó{×´‰ ‚ªúŒN=‡Ž¬ÇÆŸ#³`#ü|CèiØÀ´C:›lR­rñô14ižØÈk–ôo°)ýkÑ~¼„%28CûÎS–Ö’”lÕÉÿUÖ(RI#­/¤RFZbøú!À7IÑã„’§Qô¹I61K>^þ¸nî‡BÉ/¬6Ä3”½Û3âHé^ô!"?:4MµÙxàK+ëÙŸ¨ÑâKíRãáå髬òK÷ˆþ–›gycÉ/·x;¶ü9â,¿¶÷÷ k—ŸübüÚ¹ï+N­B•´OÊÈ BÄ0D‡ôGXÁRcÃþÏP]góIò»æ”÷ÅÕü3òW +¤Õ¢g;ªkKÄWö‰b #0¨Ï,lÜÿ¹Z#Ë9ôÖû8¡X’_ãkk'­xäÚI×QÅ•™Æ|­<³`½ZÓùø†a€KU–´Š—ÍÿÃÜ_Q%øE§ ¡ Áo¶ …£´x1MÎxþùý˜ÊÒ¯-?]}ÿ8úûuôýáèú;ºf¿òê\Œx‰xÏo¬Þ?îÞÈÈÿÝj¸!}çª÷£TÆîÌ\lU.OS‡\§òåó_VcVÇÑ÷£üßl2¼!      èíZ´H‰ àï€ððH%`bB’²n)(ÌW.UUúJGg“±¢ ‘ýŒÝ¤L ÃÖ÷rÑÒ,·$œŸ†O îÂBTÇ_½|k–ñðÌÃEw$bììHH‹’Uß›¹“.¹ÖÿT„çÆbÜÉ‘øáí|4Yè2b“½j˜Ïú%%ƾM/*Ëñó'ÂbF¤ºšlÜòì 45´àÇ÷ .§j*spÛ‹Áè3PX¼H &^”óljaÂÕY+Þü‡¹ÅËŠ¯JpñíñÂýX4Îùc_ìú}wGž¨” ½ë†T¶ü²íü¶ó¿FñWŠëËgý©qS1iàUøuû¬¾ŠN®Â$ž$!Íø`é JA£u°z×»8kÒcBs.Nw/ö W^–.¬õ9Y)Rd›¯VÝ%” ?hÍ…Û,w\$”8RI0mèý5µ˜? #SÎVV ²Ñ+ïÀ®¬Ÿíò^>ûuã½ÞEvÑ6¼²à,³¢+f½†´øify¶oÚøý&,&ä˜Z’Ö—‹¾úÅN²Éo°pó#7óeúfͽb3ÿ{­¹êëê9oïõ.b…õ…ü"_¦Ï»C|™Þ6™—3²©HŽ}Bp¼$ù¬š>¯§Œ¾Sl _+Ü}À‹.êò4}}‚ųp¶™2eý¾1B‘õŽRšMÖKË„e•irôùw´½©,½óºí÷cÏûÇÑ߯£ïž_?¿„È‘X»÷³çsÙÖ…¥ÛË0]!~+o׃ÎýØÃÑ÷£ü¿wþf(5 _Ü;3̬ƒŠ-y{û@*\ú§ ÆèQã:´>-χW5£YÄ<Ñ’O°ˆc2¦{”,rŒ¡“ J–¬}UfJY&ŒxðÝë¹J9áéé¦â·È|Ó´f¡á }!ç°)A¦EêzÜœ0u.Ê©ÅÁÖn¿daeIÛæ{E‰T¤ŠÒ¶¼ÊRCž‡‡¼ÛŒ}T½Ó VG{7 ö–nÅÄÖâ÷¨zaÑ>BQ㣮Ç? bnÕ.óM}é*ì—íE…üò;JXWX&ùE´L鹫͔,2Onj®š¤‹¦øða2Û,ÕÔ—ãç-Ï ÷bš)Yd%9þo; ãK÷2ÑG ¦$ E‚LY…›Í”,2Oº-[»çyÙí©±©+ÅF¦i’>šâÅ¿”£ñA +2Ì”,²)¿åš˜ö/¯e<™”5LÎrumúGºúyâó ê8·Ò´ˆ×ÖíýÄLÉ"‹³ 7‰X9ËTÍäXC¬ÓfŽ>ÿŽ¶7•¥7_ÛûþqtÎŽ¾?\eýZZÛÞ5é*ìçÍϪ[/ñÿ#´"§}ÿ8ÊÏÑñ‚‘ ØM C‹­çœœÃº刲l 4(ƒµb§Ÿ¥û°âôD2Ä+‘$ŒõCîzs—7Î8<Ö |8¼WßB§º¼=™/wäfX+J¤;®ÂMWšp/6ñ´Hlù¥Ò(š0hÀèY‹ iùÒ)L¸“)/ÃÜ­™6VyQ3j*›àä‰ðodíf8NN‰‘#06íÂNõ*ÝJI0áÂÔtaåÑ™”ž¿ ;Y»…1m[T‘®ƒ¥D¸`Ò’t¡d™¤|™òËöX©{Ⱦ¶¡~Þ!ÂV‚•ë¦Ì‚ BA³A·­Ì,­jsU#ãX¦@ÿ(•%]æè¥|á‚ìX¤BaE¡¡¸âqx=~~†ç;¿d¯±žéEGòK¾2I·kÒ:FoëõŸmÓq¹v…ç×ùµ¶…e´K³s~én`ÿŽ¶·”Çž{WX?{ß?öÌ×´£ïg¬_Gü›[„"ú1S±­® Ë÷ëº,(OWùÒEa ¿á]cÕØ Gß?Žòst|¦Î¦$@$@$@$@$@$@$@N"ÐiE‹¯¡AÄIÉÏE›m‹“¤ÐéÆ+ ©þf%G,-5ÌJ»‘ñUdjj0¸0ÑëÍTy¢W¾fAR´¤ADœ'Šó (ýGù!DÄ›‘n½6üÜæ’L¯{ó|D™"|1ê$kE‚,¡T’1[º#…õUîµ:Ó·T(HEK€Ox§ÛÔ7VénÀ›Ž×ÔÔ`zk¼–.Á´dè^æ{yžµpÈ}Xò|­ªÅÙP«kQ¨n¥ÅŠ æ.㚸I ÛÑäíÕæOË3={¸~ŠMÍú °F±Iy,’½üÜÊ/7SõRGòç•îBay†°6ê‡ ¦>ƒ±©"SĹ)¬GJ÷¡XÄ^°ýËÔ±ëy®ðüv]jëÍné´eûU°ðš:k×…Ú3mïóïh{MFGή°~öþ~™·lëèûÃë×ÿÆæº-¶øÉ9ÊçZ*ZÜݽä­S“£ïGù9:¾Sa°3       »tIÑb×v6ê;Õ^mÕ5ÍÈY']‰uŸû0;E56Û±º •ÂÕ— j?q~~xÇð•þ¸S _ïß\iYÒiä´È£'R^É.ü´ù™N u4 |™~ÜÙ69Å;;Õ·#•† bòèj’qXf¼“] /ƒuQWû8‘ë˘7Ÿür‹ˆeó¼RT¥÷VòÐRu]16ø ¿íx6”QZ]{ÏÇÃóÛÞÜ÷d/‡<ÚKö>ÿZŸŽ¶×ú±ç|¼¯Ÿ=LºÚÆ‘õ눿ž¥\Wåë®úÎzÿØËÏYãwöK$@$@$@$@$@$@$Ð1—U´¤Ì4ÄѦ¹ºÍ ®«d‘rÊX.ë—`öÅ wJ”ˆ‹R/o7³%\McÝÝã6Lc$Ï»×—bÏúrÓ,«ëÌ=Ýã‚IZ$È£+IºLYµëÝ®4éÖºûs~Ãþ¼ßÚ#»p‹Uù¼±wcâÀËEŸl;¸ò eÛDKÒÒeΨ۵ÛîìÞ iIåa¼¾èBì~úÅMFlè@Ï&!ñî®f »I1ãðîOW Îηo9ž_G,{Ÿm\GÛkýØsæúÙCͼ#ëgóÑ{öÎïGø9cüž%ÈÑI€H€H€H€H€H€HàÄ&à’Š–ÀØD 0wµ”±B*ºOÑbܶupˆß(ÁÌ ãîÁàè o×¥¶ª ;×èÇqÆ#¨ÉŸµWƒÿ®{Ü“9CNWíCa—)»xÖíý¸Kbúû„aü€KT›Åÿ…µ{?²j/]‰uFÑ¢çÖLvæàci%³3ꛪU—Òœ^ò÷ Ó˶ʓ ”ƒGÖªC+ öÆì‘Á¨~g#)j Òâ¦anûÊ0­-Ï#àÈó/Gp´}ç¤d­ŽØûþàúÈÚûþq?{Çïè¹`9 @÷hóÍÕýcuz„ä™æ®—*Ô£xO÷n5×U\zùzØ”ó²»qõƒ}1x¼yìÓ%Gš±o“Á¢däŒ0ŒšiØ`Þ´¼M¦5{]Sa°žð pIÝ™s'Û ½ÕÖ”SzÞ;.NÄdqw3<7;2ëV×Êu EfSs­*òñ Ô­â묛ï*™2–ŠLÒâÄÏ;ÄJ¬!}çYåu6£¢¦ßþ~?*jŽ¨&qáƒ;Û”õ:IÀ‘ç_áhûNŠÉj68úþp•õóñÑÏy¸{—Œ>jöMMuVDü.™ü¼õã“ùy·õ+c}u%uæýÓü:3~Wæú$@$@$@$@$@$@$@ÝCÀõ-BŸ’r’ù×ïËK»gö&½æ2lt OX» iÞ3;ú3iju¹ú{Cl–AcCÑo„aÓyýëÔV ÈÈ?dp–6ªmCÉ´»€w\*EòˆIÒ™ iåðº ü€šµi\S ÒjåÜ)O¨#:$Õ´-Â]˜–´Í@í^;÷‰­]ꞥÛ™ú‰¸$2Þ‹eJ®´\9í &ùU·t‘véÌ—œ¢Ä•ñjdÜšÁ}NnWü‘ýÎÄéãïÇô¡7èÖ“_z7Í"ݳÏ©¹¥AMÏÇ˶B×Ùówäù—²8ÚÞÙó9Ñúsôýá*ë'Ý 7–)%fÜŽ¾µ¹šÖÑä=eyjü4U½¥µÅ•‡L›ªkGß?Úøöüû!pt|« 1ƒH€H€H€H€H€H€Hà˜°ÞÑ=æ"˜5´QÞÆLŠáЯ†Gcf7\lø¹DÄ}B"½qŽ}Ö†&®Ÿ7.û{²µ¢¤¶¶ãd÷új”6À?Ø^^nÈ;XƒìýÝ;‡uKJÑÒÒŠøœvmÄÀÆäëïŽónMÀX¡(:) å…ëc^`Kú×BaҬₜ<ê¯fʯœ>áŒL9g£¼&ߌX~énc<–9£ï0~y­UŠŠY#ÿ¬Ýêžwg-Uù¡‰8CŒ%Zê; ã\¬Ýꞃü¢˜`vxyúðò[–É993VêßP]ö‹[Îü÷]²÷^¼óEüš-ß´;\°_Œr¿6kä­“väìZòp÷TñYƒúª¬ì¢íZÑqy>R¶OÍ+"(“…’*<¨Ùúyz´½À‘ç_Êàh{gÍ£·öãèï×Ñ÷‡«¬Ÿ´6¹`ÚÓŠm-E‡¤áŒ‰ª[iÕ–W²S+2žwfþ(± JÑ{þ”§Ì¬êRb& ׃·©º»²~B}£õ¿ßŽ¾åçèøF¼       è1.çg*å$ó à‚]•¨)è^·a’~nz–|˜yW&bØäp ™†’¼:øø{"(Ì`ÒÜÜŠ/ž?„Æt&òƒûß`þU‰ja×-1X¸tç*d5⇷ãŒúböÅ ˜0/ùYµ">Œb“Tœ©ˆùêåC¨«9¾-ìá,K·*Bav=æ]¨>~ˆLð3Ž}pg¼™‹Ì=Öþá•L.*K YššZ±iÙ±™ÃŠ/KPœ× ”EñB¹â´Ð6aRþEïä"cGçä7™Ê s¹j×»(Š™#þ¬”"¾ŒsÏ,Ü„e[^DfÁFcžéÅr¡d¨ —iCÿ€@a]¢)6êÄÚ+¶½‚Õ»Þ œ?˜61»ÆTøü·¿ªMõÑBÉ#ÝFIÅICS-–‹öÛ~ß®¢Å¬³¼Ù¸ÿKÈCº“®~4¥”Ü,m/IeÕ›?^Ž“Å—çÃ’OSíµ RÙNrÜ’þ?,ÛúR{ÝeÍ-Mxïçk1gÔíÊ‚Êß7Lm4w÷äyþ¥lŽ¶ïîùÏý;ãýáë'ÌJ?Yñgœ)”­©qSŒKVY[ ”$Ò"ÅV’ÊŠªÚ"Ì}»RÎÄ„öWUåïigÖøqãSJy«×ÞïGø9c|½y1H€H€H€H€H€H€HàØp8(UîÑ0Y‹ö@H„—øz¶U(/Q]Þ5+[ží‡”¡Áر¦ï>’eÑ{÷߆F ù#½„;´Vå4¢¦²kòw¿„®=B° ä!ù•Tf¡¶¡sÊ2_E*ü|B…EK•øÒ?ÝèV¬³3–n½¢Bú W8bìL¥lél[W­'­yþt†Á}Ø« Î1ÆôГW2 V<’ƒä_×X²ê\u­WŸyÎ'`ïó¯Iâh{­ž»NÀïWX?åN- ^)kå{T¾ :›BE;9×IZ¶H…ug“3Þ?ŽðsÆø+ë‘ 8-Îciì)2Á ÷¼5TÝ¿ýÐ~ìZkîjÊX‘$p‚vΞø¨rÿóô—ÓPSß9ÅÕ ‚‡Ó$        èÅ\ÊuX/æh&úøSBÕ}ei#öl ’Å oŽk#û‰Ÿp³9†‰¸+£RÏUy™GÖSÉbF‡7$@$@$@$@$@$@$@$@$@½-N^A»cçD©^7.-BK³“`w$àÂ&¾±¡u%,«ÎÁ·¿? [ÆL         è­¨hqòÊEÄ{áð¾*qk—8¹wvG®Mà`Þï(­Ì6 )ã*Ô7V"»x+¶\Ø¥X ÆNxA$@$@$@$@$@$@$@$@$@.L€1Z\xq( €kpwmñ( ¸.*Z\wm( €‹ ¢Åň①¸.*Z\wm( €‹ ¢Åň①¸.*Z\wm( €‹ ¢Åň①¸.*Z\wm( €‹ ¢Åň①¸.O×’‘ œ¨"""¦¦&äç磲²òDEÁy“ ¸8*ZŽ.ÐâE‹©îÒÓÓqÑÅ—˜-]ll,.ø^å½öÚkxó¿o™•óæÄ&ðþ{ïbèС Âø ÑÒÒbä /Ä=wߥò{üq|óÍ·få®t3~üx„††(‘–.]f5—î”uÞ¼y¸þºk1pà@ã0’åºuëñò¿ÿ;vó]õ¢'ùu•‰”õµÿ¼j³ÙC?‚ Ø,w´½ÍŽY@$@$@$@$@$@$@$@$@½ˆ-GËÃÞžr“·ÿþØ¿¿q)ÝÄ•Vî.ê2‘€)ñìhχ››|ZÌ“»ÈÓÊÝÝ]Ûcß­¾#GŽT˜0q"êëÌ'ÓMw¹íV\wÝuV½K^“&MÄøñãð÷»î‚Tþ¸rê)~ö0‘Ϫö\êµ—Ïm{ÉÑöíõÍ2        è-¨h±±R§:/š(ZlTc6 €HËMÉ"Ý…}òé§Ø¸a#¼}|pòɳ1oî\Heèc>ªòËÊË0*»ÈÏÏÃG}lbР;v¬Yž­GÛÛê—ù$@$@$@$@$@$@$@$@$ЛPÑrtµ4+„ÒÒR„……aþüSñâK/÷¦µ¤¬$Ðk \xáFÙï»ÿ,^¼Øxÿã?¢ºª çwpÚé§ããÍ•Æʼ謬Ãxêé§ÍÚ\~ÙeV´8ÚÞl`Þ @/%@EËÑ…kmmUWk×®…Œ‡QÂ}Ò–­[»¼´ÉÉI˜(âtDGG©¶yyùX½f rssuûJKKSãUTT`Û¶í8óÌ3зO,[¾;wî„——Î>ë,UgÕê5ظq£n?Zfß¾}0eò5~]]2Åfêo¿ý†šš­ Ï.L >>'N1ƒ¢ ×/ûp6V­^-\xÕw(µ···xö& 5µƒ‚ ŸkH~ïÞ}Ø°aš››­ú>|¸P.†󃃃×Ó¦MCcc£ñ^^9R úÛk–çèÍáªO¦ÚÚZ,Y²Äª;ÓF*ZdÐ?ͪÜ4Ã~Ò‚# À-Í-X¹j•RèÌ{ ’’’”L[·lÅïâÝ —œÁOÆ€0ÀÀ`ÿ¾ýÈËÏǨQ#1A¬¥¿¿?òró°|Å è‰`–gÏüÍ:èá{Þ_Îä×ÃÓçð$@$@$@$@$@$@$@$@½-‹VYUÍ›7c̘18õ´Óº¤h‰ŒŒÄƒ<€“NšaÑ+T@ñÿ}ó ž|ò_hh0y!¥_rñEBɲ ™™™BÑr¦jíµ×⪫¯Áo¾Ó¦MUy×_=îàA|ÿý÷Vc„††â¡‡ÄìY³¬Ê¤’åù^ÄçŸnUÆ × ‚ûï¿sæÌfa¥IVU]Äú}ñÅZ–ÕyêԩµÖ#ˆˆˆ°*“99¹âÙ¹›6m6+¿åOÂäÉ“Ìò´›çž}V»4ž.\ˆ{ï»ßxððpÕMYY¹ú­Xö¹G(vn½í6•]\TlY¬îáw÷]‡ŒÍ$[—^zÞxóMDEšs\/\™ÝqÇ QÓä ~'ŒÇ£Â-šL>ú† jT,icýíowâ™gžÅg6~ÃŽÌ_£'ÏŽ¼¿œÁ¯'çαI€H€H€H€H€H€H€H€z7׎ÊÝlåWí?,2¸-š{Êt6p¹¯¯/Þúï›F%‹´ÛÅņMaÙÏùâ‹ü‡|Àæ¬bbbÑ_|ÙÿÕ×_+ë“âñÇE¤ØðÕòdãÛÿú+¹||¼ñúkÿ1*YŠÄfôÊ•«Ä¦ú&e‘ ¿Š¿ïÞàŠË/·9> zŽ€\¿×ÄúrÊ)F%‹©õI p™uÿ}÷âÊ+®Ð2!!Ï?÷¬QÉ"3È8xÕâZ¦„„x¼úÊ+ˆ‹‹Óí£'3-K–²Hkž_ýM;wí²,†£üL;¼û’EþvM­ˆÆ‹G~È´j·\O›>M)Y¤Ò§°°È¨x’ÖJ÷Šßðtaed™œ9˾Ž3ß_öð;sä$@$@$@$@$@$@$@$@Ç/Z´X¬­T˜üôÓOøÇ=wC~e?iÒ$¬n›:JÒ*%99YU“ˆ¯Ó‹ŠŠÔ½tKôÒ‹/ 00gœqÞzëmµnÙgTT$.ýÈ/æ¥û {„ r}æ¬Ùj³üàÁCøÛw¨Ít™øðac]t1 ¤î¿ûî;1þcAÅe’uß}çåJì/¹ ,ƒ‰+4ÝòGº1j±pÑÒæŽKoP¹~ƒVEPV ;„Û8ù<ž)ž™¿ÿýoðôôÄm·Ýª¬™,×ïÔùó„²ÁGµÿäÓÏð¬°DÑ\~É úû„’朳φŸŸN;íTõ jr<ûÜs0u&r©©©ªøæ›ÿˆ ×a%%ú%Z=qv”Ÿ&³tÓ'Q^tö‰ß TžyÆéxøá‡ÕõìÙ³…;±¾Âò,Kkgó›:eŠêS©—Ê63êaa©6sæL5æM7݈ßV®4Ž//œ5³Ná3ß_öð;†SåP$@$@$@$@$@$@$@$@Ç!*Z,ÕËÓ eeeX³æwå®ë´SçwJÑ"»Y"42ýóŸÿ§úP7〈òá‡âfáL¦Q£Gé*ZÊËËn‰2³ ¹¥¥eF‹„lÅŠ´P1M§ 9e’1.þõÔÓF%‹ÌËÉÉÁëo¼Žî¿rÓ}öɳñõ×ÿ“ELÝ@à‡… ºÜë|¡(ÑÒßÿ~—ñùÖ(Ÿ~öû$*k[ë'­¡´ôå—_•,2Oºª{öÙçð¿ÿÖ\ZI˜¦ýû÷›Þ¢Jž×Ҧ͛„U‡¹«;­Ì•ÎŽòÓæ"­Èž{þ9¥d‘y---øö»ï1zôhœ{šŒÝdªhq6?§éý÷?ÐDBii©p ø0/^¤eÆ S1d4K%YÑYó7zŒ/œùþ²‡ß1ž.‡#       8ÎÐu˜Å‚ÊV™-6¸›%¾`—nm:J|ð°:¸KRQc™L7fƒEr½$—kI»ÖÎ2¿Uüg+õILTE…«(Ór­þÎmî–´ºZÏ=O@[“BáòMºû²LëÖ­3fiu⢴´Äx;oÞ\ãµv!­¤¶ˆ€îòŠ·ã-iLìågÊcãÆM¦·êzÛöíƼPaaÒI*·,“´`J®àd’nÖ´˜6Z=gÎ_ëóXž5ùñþ²‡ß±œ+Ç"       8þТÅÆš._¾\Åg±1f̘¡6¨mT5Ë–‡.6BÃàéцW·ÖRGñ(´z]9K·d2IWSgŸ}–ºÖÆ‘gé~HK†ºÚ=ÏÎ%ð”°(j1QšÉÞÇŒ¹"þŠ­tTùVf¢01­[.‚ÄkIoý–üô3þð‡?(÷V7Šóüyó±yËfÈëôôtȯüõ€ZŸ½ýì(?ÓùWVVšÞªëššZcž»ø=ug*3YkÓqöîÝ KK6­Ü™ó×ú<–gg¾¿ìáw,çʱH€H€H€H€H€H€H€H€Ž?mš€ãonÍHºåùõ×_UpòÓN=ë×oh·?ûâ.GãlC³Ši·A7öë×>òH7õÎn;C@ºú2 d/ÛȘ-í)Z:Óo{ud\Gä¾ûîS±ZúöíyhIºÀZ¹ržzúi³Ø>Z9Ï®OàQwéxOÝùþ:øïÏçG$@$@$@$@$@$@$@®J€Š–vVæ‡E‹”¢eÚ´i*y;UñÔ¿þ%,_¦«*Ò‚à÷ß×¢º¦ÚØ$M—´»;åææaÑ¢ÚÆÔ R»YØ«ÈX"«El¡ÓE°û1cÆBnZ'$Ä++Ô]>ŸÃ‡ÃE_‚‚‚‚^57 {bàûëÄXgÎ’H€H€H€H€H€H€H€Ž7T´´³¢Ò@Æ;‘nm¦N¢Ì{zZ#2dˆQɲiÓ&\ÃTmÓ®çÏŸß­Š-–ËáÇñÒËÿ6š×½€€´8‘Êyè%Í œ,³©(,,ĻｯY×ÛÛ£FÂ_n»2ˆºt!wé%ãÅ—^–Å.“´ç×–@>>>;v¬*...†t£ešœÅÏ´ÏÞtÝÛ篭?ß_½é©£¬$@$@$@$@$@$@$@$@ý]]­ô?744`é²eŠÂi§žP\/ 4Ș-ceÈMOˤ§ ±¬ãÈ}II©jåH7lÛCJKËÔÈ1±±º˜æ—”ëÖÑË”Ïðºuëpûw‹ l¼v•‹’’%Jhhˆ®²iÐÀøÏ«¯¨ã²K/±»»øY ä¢Îœ¿i|!w®ÿaO{¾¿\ôÁ¢X$@$@$@$@$@$@$@$@"Ðõ]´Nu{üTZ´h±šÌ„ ãu7€eaKk›bÅ–¢cò¤‰Ý eÏÞ=ªÿ¤¤$¤ 7e–iÖÌ™xõ•WÔ1}ºÁÅ™eÞ÷mý0gÎ+AÎ>ë,cÞ¾½ûŒ×ÚÅK/¾ˆwÞ~ ¯½öšîsjªükjjÒšéžkjëŒù}úô5^wçžýûU÷2ÖÑ)§œb5Ô™&óß»ÏP×´’£üLûrôº'ø9sþÒbHKÇ×.;}¶§½&?ß_ÆÌŠ$@$@$@$@$@$@$@$@.DÀÚ– ç ¢¬]»òkûððp„††êŠ´}ûcþå—]†;v`Ù²åîp"##qýu×a¦Pttgúâ‹/0]Ä’‘®§žyú)<ñä¿”¾¾¾˜4q"î¾û.%cc#{ìøªÝ¬»£omýdßÿ÷ÏÇ1dð lÙºAA8ãŒ30eÊd5l~þü¶r¥•Òbj̘1*ÿÉ'ŸÀÇ,â°ÂÃÉ ¸é¦m¶nÝb¼Ö»Ø¶m+4ÅàË/½„åË—+·yZÝü;wíÒnrþò˯0oî\Õ×? C† Ɔõàíã“O>YÄ9M•ÕÔÔà‡… ­Æt”ŸU‡dô?gÎ_Z@É÷„——.8ÿ|DFD 33ËŒÈ2aé'ŸO½dO{M~¾¿ôˆ2H€H€H€H€H€H€H€HÀÕ PÑÒÁ IK€—ü¤âZتzàÀ,üáµ,cI<÷ì³.›jkk¢.~ø®¼ò []8œÿË/¿âÓÏ>Ç%_¤‚ ¿ùÆëV}ʹ<ñÄ“ÈËÏ·*cFÏ0]?ù ]ýõVÉçé®»î2Szh•^-#GŽPñ„¤ÂBSZhåÚ9;;G='Ú½Þù“O>Å9gŸƒ˜˜hÄÇÇáòË/3«–ž~À銹9ÿî{ïáš«¯Vüò,Ó$Ÿßzeåå¦ÙêÚQ~V:Ñüœ9ÿ²²2ÃçowÞ¡(è)‰srrl*Zìio*¿~ýÀ÷— ›’ stÖ ä‹-ê°ÖC=ŒwÞ}W)Wde„\*YŽ)À=ÿ¸«V­ê°G+<ñÄxèá‡qèÐ!«®¶lÙ‚oº_}ýµU3\ƒ€\¿xûºÑÒ¤’ÖÒ‚àâK.ÁÖmÛ´l³óÞ}ûpÅ•WbéÒ¥¨¯¯7+“72oÁ‚¸úškPUUeUnšQZZŠ+¯ºJÕ—×Z rÓ:Ýqýüó/àÞûîGzzºY÷rü7âšk®ÅO"’­ä?[}Ú“ßSüœ9ÿ>ø@Äõ¹›7oFuuu—1ØÓžï¯.cf        !à6pPj«‹Èr\ˆ!,ò‹ìkC-—.wLãc«IƉ êÑÑÑ"~L+²²²P®cp¬dá8]' ]ÕEEE I¤»°ºº¶¸)õæ#ÜmÅÇÇ#((H<{­B±R‰Ã‡³ÑÜÜÜQS—)‰‰Qϯ”977ÒJ¢+É~]ÇUëööùóýåªOå"       Ð#@E‹æ‘ @'ÐuX' ± èðÔË<–y[·l>–Ãq,  8.Œ5ú¸˜'A$@$@$@$@$@$@$@½-Zzû R~           #À-=†ž“ ôv´héí+HùI€H€H€H€H€H€H€H€H€H€H€zŒ-=†ž“ ôvT´ôö¤ü$@$@$@$@$@$@$@$@$@$@$@=F€Š–CÏI€H€H€H€H€H€H€H€H€H€H€z;*Zzû R~           #@EK¡çÀ$@$@$@$@$@$@$@$@$@$@$@½-½})? @ ¢¥ÇÐs`           ÞN€Š–Þ¾‚”ŸH€H€H€H€H€H€H€H€H€H€H ÇxöØÈÝ<°OH"cÖVTä ¡ª²›Gd÷$@$` æŽÐhO´4ÅyM¨«n9¡Ð†º#LÌ_¼~Q’ß„šÊkþ'úúŸP;'K$@$@$@$@$@$@$@‚€Ë(Z¦Ýþ(’&ŸŒ¬u¿à·gîµZŸà\ðßTþÏÞŠ#;6YÕ‘qc&côe7#¢ß ¶r±ÛwdÏ6lþàß(g½4îú;0pÞùVEMõ5¨ÈÏAöú_±gÁgh¬©¶ª#3R眅I7Þ­[fš™¹f)V>ÿ i–ÕuHß~8éoÿDPl_UV–…w\iUÏ4ÃQùMû:®ï}w‚#}ÔT–}–‹%ºä´úòÁŸž1yV-¤|øâíÇd“>m”nx|€ÅèÖ·eGêðäõ{­ œ˜›â…èÔT5ãÀ–Z'ölÝ•³ù€yW% >Åß8XKK+öo.Ç÷oæ ÿP£1ßôâ²»1bz„ÊÚ¼¼Ÿ=›kZ¬®Ÿ\0Rß¼wÒ·Ys¹ð¯ñ;' û7•á­3­Ú·—¡¿sM >øça«ª!îxà£áíŽ/ óÇük˜`ìC*[íªÀ·rŹΘozqÎc1éôÓ,uÝX׌¢¼:ì\S†•ß–èþ&ž‚soIVõß}x?öl¨±êGfœyc ¦ž‹ºª&üë†Ý¨­jSþhãÚU‰×îÊ°j•è…;_¢ò_¸uòꯣ½ëïJ¿?«É3ƒH€H€H€H€H€H€H€H Cº®Ã|}½¤>±è“ƒˆðxxèVíp€NWpw‡»§'Ü=†ðä˜ò§ûðõÖõhª³þ"\ÖÍß±«ÿý˜¼TÉ;0}&ÌÀðó®F`T¦þå,¹ïF­ØxÎ\ùŽlßh¼7½è;e6Æ\þ'••½i•i‘ñÚÓדþø¤LŸg¨·qª ó1p¾µ•±‘Î…½òëtÕk³ÒF6sí®Dòà ô?7Ô׊Ý_K¹uâëúfR¥ õÇE·§˜åu÷Mæ®Z39FNÁü« ŠSùš›\¡#lœÅ?<ÖSXL,Ðö ë•/^ÈŠá7L¤¾}pù=)ˆˆóÅ¥w&ã©›ö¢µÍ˜Â þQ倴~ññóÀIAØòKïqwå³nNRs‘óÿü¹,”æÝ× Wü#E) .ük2öoÙeó·x`[>6ÓÀDüõ òÀÐÉ!˜}q<Âb|pé]IxåNs‹éžmÁ³qÝ#ý‘˜€áS±}U•±y1÷Êxy¹¡(·«¿/5+sÆ£ë¢þþœÁž} €+0~¿Û¿_"¦L¡«d‘‚zK“ä¤x̘:!Á® »™ }'φ‡—7ê«ÊñË¿î6*Yd¥ŠœCø婨x->A¡ˆ=ɬ­éMS}ª òŒGiÆ^lûôM¬{çyUMZÆÅõ1m¢®¥K±Ê¼ÃV‡DF^tƒª³é£Wqp¹Áý™eþðw¥di ­ ｄåÿw'ê*Ë-«uxo¯üvÜ‹*ô¤¤Ý½¶ ¥õâÙuCÊP?—œAcP˜Ýhv”é»%êÎ 4Ô›ËQYÖ&ƒ©|2ÞÆñ”œÅô¬PõœÕ ·Tï=zȨd‘¬²öÖ㓧)lQ}ü4ÈW]ëýÉÞoPŒ™®Wì²yç+E†´à‘ó×”,Rà‚¬F¼ÿX†²r ñ€1úV-²®tV"TÚ‘s A¹ýûî5ƒòEZÆH‹5Ë´km5¤’F¦S¯N~m5b’¼0öä(•!2ÍÝð;ºþ'êï¯m•xE$@$@$@$@$@$@$@½›€²hé—A;÷½¿Ÿ/&OŽ_VnBmØu‘#\ƈT´o§®µJU~6r·o€X8¼üloôÙšŽTLúÃ]ª88!I)TlÕÕòÃR`æ?žQ  ]ß‚_½§Yݽ½Q]”_Ÿ½E{·[•;šÑ‘üaýÂ?<µ¥%(Ißm5œt}7j¢Ê—òÕW65­* 8Q‡#§²—<ô']7i±ñ˜y׿”‹6Ëöò¾\XýúÌ}(Ë< W씼¸o±Aí…&áâ*ko-búVbôIH%•/GlŽ1ùŒHL=#r3vÙ§ùÂÕQ?µ)nlp5°ue1>}ê0Ž>jÆ"yáh{³Î켑îÑνED_ï˘¦IZZ|ùÒ!lýµ{6š§‰‰ó£!ÝF­û±ß‘/ï6³‚Ó¯ƒØø.ÄçÏç@ºz2M“N‹Àô³cM³ÔuD¼/®{´¿UþÒOs°èÝB«üžœ¿¿a®µB©d+ýçî}"Fˆ;J tN&Ùvþ^ªžÙ‘Óƒ±zA™­î\*¿¹Ñ0@¡H±•^¿ç ­¢ó›DÿG_¿h¨×W>Þ×€Í+Š0fV¤p– ®+æ#â„«¶ß½žÝá8öVpxýí˜íH€H€H€H€H€H€H€H€\‚€gÿÔ¾p·Ü•í„h2žKTD( ‹]c#°pß%uD¿Aˆ3y›Ötb¯3r‚R²´45¢4+½Ý†¾a8åá—àŽœM«±æåG;´äÈX¶°Ý>-ìŠüv%ž¡Y÷<°¾ibS³y"N¥°"j»£Q±HÖ0! ɘóà øæ– „ÕQÇÊ*{äè?Ê`qxo¥²àHß^­º‰Kñ‡»°XÑߤÕÆòÊKÿž‚#YµØ»©BlŒC'…!&É#EòÊ’F|ój¾VÝêìh{«;›!+—ßÓC&†‰J­Ø¼¬Ùûkàíë.,KÂ<$WÞ›†¦ÆýعÆÀ¤³]w¦žö ñã]p[²°j©B†påäå#Æü¤Ë¬qs¢„+·üø¾¹’D2=’Yc&(ÌþÁžB¡Õ¢‚œ Ž^T–êø~êñù[h¶,…÷¶,zTգͽ|<°yi‰R´Œ99¢×(ZíªÆI"œTbªPÜ÷Tm멃¢ËYFû+å¡T æ²mšµèÝ< ¿ÓpÏeüÜPqªÆÚ¸Tþt\]–D¿´Üë(µ»þ5f9 €KðŒ‰¶mÒ‘äq±.£hÉY÷+Ês3Ÿ„Yw?…ÝÂU×¥ßwÊÅW»óhÒeÖÔ[PÕv/ü õåíS0ï|F\™… —\3îzûþ9ëkw¨n)´C~{änÒ¤’E¦_žþÿ¾B]kb†ÅÜG^…_X¢‡ŽAîÆÕZ‘SÏýG܆¥o3Xñ!ªË••Kê« Ù–ƒÇ¥ˆ`Ùùøþ6ë—Eï %EáJ,“N‹ÁOØtéäh{Ky:{?xœ¿R²È`êoþc¯°ÌiSd­øªß/6ž£qÎûb×ï»Õþí»3õ¤µLñiXöY~ú°È!þ.~¯7<ž‚þ£B0ýœXüüq¡YœŒeŸ‹6ÅÆúgÜ™Ä+e× ÞoÌoçßžl*;ÊÏÝÓM(øª!c$‚tƒÖââìZ[…ÂõJ¡vÕƒý±òyXûc©®‹¯Nñ8ZIê/ŽõÇEÂBJ¦Uß棪̶²´TÄwYõmžz~N¿.Q¸ôT0‹Þµ­=:O$@$@$@$@$@$@$@$@$`7Ow÷6÷>]í%8Øt¼«íº£¾ "¿âÉ»1÷±Wàaç]­i}’õûr¤¯Xˆêü܇Ž1çÿ÷{UO~¥ìåO_ÔW•cÓǯ‰8+ïv؇©ß&¿Ðô?Cé+~ÀêNX·t<€íN‘ßv÷6Küã ebÇ]O¡tdûF|rùLU§¥¡{¾,w¡d°l™Ò·u‘%6°Ó·W(%IšˆÓ²}Uû®³ZšZ„b MÉ"û:XøVžêÃSl„' òƒ ¾­—m¯×ggòFL7|¹¿wc™™’Eµ ¿D)Zd¼š>}µÇ¶U@gƳUG3_öi›’EÖ“ÁÇú0O)Z|EÜ•˜$oä¦;÷p•ùÛâÒaþQƒñ K^[~-ÆáÊn̬Püü‰9Ïûê RæwÏÀÍO@p6ë¢xuäªÁ¶U¥Øøs)Šót,‘,dMŠ><—G0‘Šoa%O‹ÞËÆR‹gË¢¹º•u&¥¢´Š’iÅ—y(/²íÒMU:ú§Ï€@Üûî Ó,uí.\¾1‘ €-íÉX-®”*²bÁWë‘oÑÜ`ØH뛊‘Ý€sÿýF]ñ'åþ«=™=¼„Û¢p±I'i}!•,2yxzÃ'0Hœ;žóîo?ÄW7…¯o>‹ïýÒ—/T}¤Î< CιB]w×gÈolµe%†fB9ÕgòlÝ.šjk!©ëŽÔw€/äF¾t/”¹»Ö8„fÝÒ¤A c,й8"¾Ê× /7‰ëk r…Û~m¯#R§²Âb Ïi^†¾Ë&¹Ñ\SiØè7 <ߩλP)_¸“›î–©0§M±âgG0tËþ,ï]eþ–ruúþ¨E‹VÓ2ƒÕܘÙZ–ËŸd6â¹?í1z ŒqTb“ý1÷òÜýÖPœv­uì ËIyy¹!$ÒÛpDx+%‹¬ãáí&\ÿy(W~–m,ïk«Z„UP›KˬÝúJQËvò^Æ ¿%Ë#TÈÄD$@$@$@$@$@$@$@$@¶ØÞ1¶ÕÂ$¿¹›6ÌM†èòe]i ~õÿ°áíç/bµô8‰ã§ÁË7Ã…•‹»ød|Ó{/Ûì7ÇF¬~õqc¹·h#¬\F^|=†žu9BûôòÇoo7æJcM5ä!SuA ÷lÊ…&ôŸs6† EË®o>l·½qp;.œ!¿â$}7ʳ3’Ø3îxy§œƒ‚Ý[Pv8e‡ "7«Ûæ¬É›6*P]æì¯BC›ç,aÑbX‹h'$(Ü]ÄY±íz¨Iı•TÀo?±éëqÔü@§¢£íuºìT–Œ"SD‚/F¤oi&Ý0É$ã¶tW’AËõR‹ VM½zöæ¹Êüí•Ô¡Ýu(9RùÌ&ö÷îÖø"vˬӰ²´Ÿ?Ÿ‹o_ËÃÀqâ;5ƒ'„)èì‹„¢Úß¿in1fÚÍ×ç‹çÅ»âhòös–PJYsÒyqˆé뇷8Ԯ뻨D/Œ˜Þ¦ :õÚìÙ(\Ðé?šÚPêœw°ß¾~Ø,OÞ„E{ãâ£îˬ ™A$@$@$@$@$@$@$@$pÂpHÑR]Ýf5àj$›êj‘µz™:¼1ñO÷"yòÉrÖeʤ<+CWä¦ú:3cr‹¾ôÐ~ìÚ‚Óž| £'#iÚ)Èüm‰n{[™û­->A¡B‘‚r¡€èŽÔ]òw(«p¶ìÿþŽ“îzáÉ7|œ:´vµåÅØÿÓwØñåÛÂڨͺA+wÆ9íh|–Œ•bC·­ÇÂÃÊšÃ?Èi#°yye[áqv5RÄ‘‘ljšzíü-•â~óò"œ|IÆÌŠ–|Èø;îî]èúÚVlû­J~¹¸à¯ 깜~n,ÖÿT"Ú7êJ.]ÏYºËËhÀÁÕ¸õùÁ4.#…"qË Û¿á³nŒWÊPiÕ’:" ©wr06ü\¡;¦ifmul±þw-ºŽ™–iC^“ œÐE;MŽ«¢žž«xî;J±)^"ƈÊŠšP%\l™%æ2æI®peŸâ´Q~Ö20|oLM╸s9Æ͉BL’ð¿gG*Ì®Še—nk7æì›ú¨² ?¢0»?}tDXEª˜/3ÎÄÏwÏ¿Y¯¿îŒ˜I$@$@$@$@$@$@$@$Ð[¸çå!'· KòÊM¥ÍÛöW6›…]êżrS­á+{¿P}·G¾!mù" ºiò Å_­QG¬ˆ§b+iAØ[Å×Îö$ÿ0ƒ Ò-™iò Æéϼ§Ž°”A¦EÆkŸÀ6+–ºŠö-Œœ|aK~9ŒÆß;@?¾‡·˜£–kºfQS\ˆÕÿ~ šUOx?}FZÿöœûkñYÒ«qß9Û­ŽoÛ¥º ‹ñADœ‰_1‹ÁüôˤnÌÛÏCÕn¬·ýü8ÚÞBœNßÖT\Ù¿ÓõÒŠ==ÿúûÐ/ÐðŒèa¼åéøëËCDÜ’¶ß’±ž %ܦ¥ÅÀØ“ÃQWc­@4¶wð¢¾ÖÐwp˜¾#(¼m^–ŠÌ€w<õÃHuH‹[©¥Ùð»é„NJ·‹ÀPÃo³¡NÿßI§†"6Ù_X­´àÇ „e…ÍBñ˜¯ú›ua‚ºGQåðúëΘ™$@$@$@$@$@$@$@$@½…€Úuں㊊;÷¼T²lß)ë;WYP–}H1 KJƒTœX¦¸QUV«° ©ÌÍ4+®Š‹úÊ2¸‰Oš“¦œlV¦Ýxx{‹ø*“Ô­ ÐÞÕ«\†ÉvÅé{̚ו• ®¢Tåõ™0ìL»é3y–º”Jšª#ÙZö1;·'¿¢4+]É™62¦e’V(2IeUEî!umú'eæi˜pã]zþÕ¦Ùm×â¹in<›Å姭‚cWýGYéÛôc7ȘÚf¼ŒÓb+ɯíâÛ6•µzý†û)ky_”kÛÿ£íeÿ¦ÉAaÖ²È:–)ÿAù•6Jg_T–›á—Þ•¨Ž˜$ýÍtË>{ê^ºÈ’I pß9œ9ûø”¯ý†ÃÇÏZk’4È~EAþÁºÎLIÕÙ¼¢\Åf6%\ü~l+ø:Ý¡ŠG² òÇ ëù¬X¦£ ïé’«0Û<^IuE‹úmÉø1#gX¿»e_ÒµßÀ±†²#™æŠj˱ôîÃb<0tR˜*ÊÞ/#g™'_wÌ¿*Ae®ú6åEmJ©¥Ÿ¡¶ªI¬‹æ_kÞÐIwù‡ºgý$»!       èfjG­Ylžÿ¾~;öíÏDs³þ×ÂRŽªêZ¬^» ™‡ _;S¶¬5KÕ&¾§¯&ÿé>x¶YVD‘]§†ËÝü;k,6ÚÄ&þ¾%ߪòsÏÅÈËn†§_Û—ÕRÉ0óžgà­Æ8¸â›¢»{yCººÒŽàø¾Hsæýó xúú+eÁŸ¿1o¯Æ7ä 9ër¤r6ÜÜnV Sˆäó0òÂëU›t1vs½õF½OHbâÍMáááåi–/ë ­’¹ Gïì’_´ÍZ½T¸<«sôôÛ3ã+Û¾üf5BæïË„õ‹õF©ä5pþù}éÍjþîm wOO ñY‚cû¨>Š÷í<*­sN¾îHH3(Ol)Z ö¨3v‚a§ÖWFHi*ŠqÅ?’Þ¶Ù•è… ÿÒW [YÚˆ¬½¶7Êm/ÉͨW_åËësoIDbo„ÇzšÞbãÚ4­[Rª6䥛©Ó®‚{~ÈMèónMÀXáBInV—‹¯ü-“Ü7# ¸Í²Ç4?4ʤcËNœtŸwÐð|E%úaú¹aˆŒ7Ÿ»ø‰Z%GçoÚ¡=ü7¯(ïÎV¥L¹ê$᪪SBš·Pp%«!Šrjqh·íçÇTy-;*Åz 2ÑײX÷ÞK¸3]3½kËçgûÊ %¿¯.º=þAmÏ¿á¾8å2ƒcߦrÔU[ü!~[k¬"'#”QfÊ&©$¹æ¡då¾K2Úðs™®Ü2ÓÓÛ]±“üä!{æ…à–g*EI£P6­]\bÕ~Îe‘BAä…šÊ&,ûÜÜ=˜Œ³ì³<ÕfüÜ(aõâ|E££ëïJ¿?+¸Ì        è€q7Uè °÷@fæ"6&¡!ðññQîÁjjë”Å‹´z‘õº#ÕÁ–O^Ø+n–#3páÛ‹QY#Ü5ù«ör̆Ú*lxûyÝáw|ù6¢EüXl]]vΕ¨*Ì»§#㌊‰ ï¾ ,2²tû™ñÂõØùo.Ð-oV¾ôª ¬M;¾x qB!5p8&ÿñ^Œ½æ/¨-)€t…¦¹Ý*9´›ÞY·ïñ7܉”©§è–Ç%á¼ÿüϬìãKgè*lì•¿¶¤ëßy“nº[Ä¡™"ø/B¹°òöD@¤á+péúËÿý?~BÁ æ?áú; V>B!ä'ܾIe‹L¹ÛÖ™Åo1›”7©#ü ¿¦—ÏæÁÖJ ­Û[+1lr8ÒFØV´dת8÷½?G2k”KTCÿ²ŸïßÌB³ùýZ÷êìh{ÙI}m+–|3nè‹ÂRgÀËkÓÞ~p?v­kS8d5⇷«6³/N›ÓÑÈV 2xzlr€š“´FøêåC•ÅF¹èXƸ¹é‰¦C¯ï}w˜ñº$¿ÿwÍã}w\ìX]eŒMröMI"î†ù(¯Ý½¶š¯³£ó7ÁþÅyMXøVκ1 Ç„âþBQVX“%8Ü ’.­>}&º]í¼W7/+VϬ|Æ;“¤Uéšéµ±|~J šñãûÙBI×G(ãÂñà'a(Í«¿¡ðìeª«n·¯åèu‡Ÿ?)DòÐ ¤ÆœK0óÂx”ŠgÅÃË]XˆùõÂß¿‘¥b§èv"2û Á×-njjŧO§£ôˆ¹¢PºœvŽxÇ‹´ôÓ\a½bý|¯ü®SÏŽAh¤7ÎüCÞ¼ïªï¬?Ž®¿+ýþœÅ„ý À‰DÀ¨hÑ&ÝÐØ„¬ì#êÐòŽÕyç×¬#/þ£âŸ¤†–îÂò¶®Çú·ž³©$inhÀÒ‡ÿŒÁç^‰Á§^ ”3RA¡¥âŒ=Øüñk]Â.•+5¥EB9°»¾ûåYZ—fçæFxùÁ?b˜°\0÷ø‡Á;!EÕ©¯*ÇþŸ¿Ç¶ÏÞÐUŽ˜uää›ÎÊ/‡•Ê’Ú²"Œ¹òÏŠ}Xß4%MKS2…ÅцwžG]Y©®„ U•XtÏõ*è}Ê´¹Ê2FSÐÈRIv@0Ø*”iÎNi£ ÖOyÂ}VM¥õ&«6^Ævƒb"HÄ¡î³d°qË$j¿÷ØAa¤”Z¹´dYðß,lZ¦ïšL«çh{­Ÿ_–@Ž9ý¼XÄôõ‡—WÇ›ì²Mq^æ]¯bU¤…¶}¹PXó,z'WXGtÞšB“åXŸ¥"ëµ»àôëb•Ž´T°aÀe&š3çoÿ_¿.EYA£raÝWº fB"IàmåøîõäeuŸg&yû7ÛVVâœ[Z;õ ´ßSû¥Ë>+FeIæ^ËH*e’ ºý[Ê•’E˜×KÂHïd`æ˜rfŒRÎH‹$-e¨Æïå`÷ú®Åw’Ê•ÊâÅï—¯ !]Z¦ÓoˆW ÑÒ‚zÅÚÚEÖ—ò-ù GXë¤(fÇúcïÆ®Éb9®å}w­¿å8¼'       p=n¥¶ó-uÏ › ”%‘ÂUW#ªòCnäw%ÄÆÃ?4R¹ «.̵© èJŸ­+ÝfDÇÃW¸«¯(1Yr”mï õ¢ã„û´h¥’1Yšê:¿A¯ÍßKXÃH%YCM%ª×=Ýeå`çþ9SψŠˆ ¼ú7ƒ2MºÉ ‹öB]m‹ØàmзD8:¶£í0³.¤ì!‘^y+Šr„²°”YÃã䦧ç/Çü[$ÿ\ȶБK+‘àpO45µˆç§I×J¤=¹eû 0O¥¤)9"Þ᥽kþíÍ­3e½}ý;3GÖ!       h#`eÑÒVÔ³WUù9BÁ¢ï¦¦3’UççB=‘dÀøʼÃêè‰ñ1fuAžp‘&”#v$mþv4u©&e"–‰<ìMŽ¶·w\Ù®'ÇvDngµíéù÷ôøŽr”®°äaor´½½ãºJ»Þ¾þ®Â‘r @o!Ðñ¸·HL9I€H€H€H€H€H€H€H€H€H€H€HÀEPÑâ" A1H€H€H€H€H€H€H€H€H€H€H€z—uÖûPRâÞL 7½ÛW—ˆX,µvMÃÑöv ÊF$@$@$@$@$@$@$@$@$@$@=NÀmà ÔÖ—‚ @/$@×a½pÑ(2 €k ¢Å5ÖR ôBí*ZΗ.]Bbb"²³³ëpfHrÇí3ððÃË’çÎŸÇ 7Ü€ââ3jr&ÀlM ¡_lÍûgL€ 0ÆA€-V:_}¹;w6j-//O¾èlÙ²ß|û²²²ŒÊp†>çž}×^{ Þyç]|½r¥öàK/¾€É“'cÑ¢7ñÝ÷ßkóëÃÆíâÅp%Êð#‘››kVÙ+Qè‹Ï?C·nÝdWã'LÄÅ‹U»½gæݘ3gŽ<ö‹/aíÚµÚr–ŽÿǾGëÖ­µíÑM¤§gàĉX¬^³ýõ—ÞqÞ©$ðÍ7+Õ¾}eFÅ1LKKÇ‘£Gð믿aÛ¶mFe(ƒÏŸ*Îl þX·AARÚÓ§O㦛oÑ“<44k׬–y‹/ÆÒÏ>×;Î;L€ 0†Nàšk®Æ]wÞ…-šk‡rùòe:tü þÛ±C›_Ÿ7 ¬¯y³fˆŒlº®[;õéÓ‹?ùØd³/¾ôX³fÉã|€ 0JåúS9"ëlÑ|ÍkPz}ÁüôÓÿ¬Ó0·Â˜`õš»³Òéqpt„£ÊÇ××:uÂìÙ³ñÛ¯¿ K—.Vê±ñ6Ó±cÉòÔ©Szƒìر£j¾^!íØÛÛ«žµß„D4ÙíÞ}û´²÷êÕËd¹ž={iËíÙ³G¯œ¥ãWãäââ‚ðð0 >o½¹~ð\]]õúå Gí¹ÑeI #"ÂqÕ˜1øø£ñê+/ƒÎ•aâógH„÷ßTTÚµk§'¾ØSþ]Ø‹²œ˜`‰ÀsÏ=‡ÿ{é%=% ÏÎÎÑÑÑøD(n¼ñÆ1äu¬Cyy¹”õðáȯ¹‰r_Pû¶Ç91&P=Ætý©~´5+aoW9?`oÏÏŸ5£Ç¥™` —[´XéÜÑ;¥ââb¼ÿþÚVÉ„vÔ¨QbEVHéòÞ»ïbÂĉ²œ¶oh ЄoÛ¶må~ì‰Ú|šHS,Nœ<©Í¯/GÃÊ•ßhÅ0pZ·j%÷×oØ€´Ô4í±’’úåa÷îÜ3s¦”¯WÏžX'V‡&:/ÑÝ¢eöù󜜬WÄZ㧗ëå˗˶iB4"<C‡) † Œ^xÏ<£Y¤'ïh ,ùôSí¶ƒ8oôïf¸PVÑ9$‹°””|ðáGÚ2´ÁçOï4pÆÃ{õð>ÑÀ±²øL€ ÔCÆ Å7\/%+**Â×_}ûöÃÅÕ#GŒÀDñÎAï(O>ñ8¶oߎ„„„z8ŠJ‘~þùlÙ²~~¾8uê´VéRYÂ:[ÉÉIzÏíÔj‡Q¨jÁ‘uzæV˜@ã!ÐØ®?çÌðH˜`LÀ–XÑb%údžO©´´TÏÝå}øÑGøü³¥rUY``F­çv‰ÊpÒhÞ¼™´ZHîŽ233µXZ ¥…³³3’’’‘““£Í¯/;wî}”ôòËÿ§U´ÐKïÁƒ‡”Cõî{ÿþý åñíÕ«§ª|´BÜÓÃCÛ½{—QkŸ\]½§£¨¤ŽZ¶l/>ÿ˜8a>[úÎœ=k$gh‹ÃÔ[X*-^ü œœœ0}út,ÿò+=÷u|þ ‰ñ~C" ,t {†ŸŸÆotiHãaY™`æ¸æšk´Eyô1=¡7nÂÅÔTáRìNyÿ?n,>ûü mùúº‘*d¦O]¦sçÎãE‹ôº¸uÚ4V´èá&P5Æxý©zÄ|” 0&À˜@õXÑR=#‹KÐ$ö×ÂÚá a¾O©Mk¥ƒnÃ}ûö —¢\ï%I)r©EéìÙ8œ"ÕM–÷mµiÓž^^ ʼn=˜˜÷B­^}ÉkßNgâDl¬žHJü‰:V.zx§ÖÈ ë ðáM“ñ¤Ð"Ë+ÃXB={ôж¿KXÀ\É/c*<õä²ÛaDZ¢¥†' F¸zû]X*]=eŠ´¢s½ùï¿kØJíŠóù«7®e>e¡) ÇŽ+]vq§ö8`~#%I±Û¯o?L:HærûÿÉXkj‘&¹8¤¤PŸLn0 ¹4üå×_±`ÁBiý§{œâÜróMBÉrPÆ ÷|”î+ÈgÜ~î3ƒ’ywß}·¸¿€Õ«WË}Ý?¤à~ñŤ«Ý|Ú&%Ë;ﾇ~øÁðï3&ÐÄ hìé!QP¬‘²²2="'…Å‘£FëåîXrýé×·^~ùeÙäË/¿"bQvÆu×]§×Åc=Š7ß| ß«\ÃhqØ+"~œZ"E÷¸ñãÕéåÕöú­×ï0&Pc–^üqt±léº5~ÂD|ºd±\ô§+½CÌ÷222t³µÛ–\¿¨Kë'óèÏgK?…¿¿¿XÑ2.$  By¤-À ÕØôPK¿¡^¢E7‘bNQté*dtËðvý&@פñãÆi…¤®œ˜@c#@nþù'ž~êIy¿èß¿¿ þ\Ý8É*¥e…ûÿÝ‚ÿ«³…2Y“¾ÿÞ»ò%zÒ¤IòÞ©#Šî[7ˆvÈ…¹ÏyJÈ@ †)-UÉåçc>"CP¾®ûÏ›nºYaî Å\µj•èÿíªt*»|Ù2éJlÞ¼¹X³f ²²³«gL ‰øñÇŸD\*Íýý@§Îñ«°ÀÛ±c§Þd¥)Ö¼þ 8PZ›¯î’IaM‹£^–zÇ—ÝÏž= [¶nÕ…ÜÝ}÷L½¼÷ßqõ¨ìXãú­Ò,g1&`K¯?J´ %ª}¦Ýz›t»Jû£„+®W_yEÆní+,çº ìÄûªn²ôúeiý3n—ò‘Ldyóô3ÏÊç;Zl3mêT<ðÀýºâò6`L€ 4f)Z&Roq¬^·¥^ÉFÃcT‚…Ó$ö¯¿ý†·ß~G»ÂËš‚ÓjZ%ýôÓOZ% åQŒ˜·Þz¿üò‹,B«ÌêS"ùNŸ>-•@´ú—^Îh5/åS"S\R²”–– ÿÓÛµPõi ]b»ÿôë×WøÊŽ’/¸Š%”n|[¸ kèl¯´üä:DIô ß¦MÌ;WkŠôèQ?~\)ÂßL Ñprt’ñ¥þ¾±É]ׄñãÌR´€ BACiþü×ôbTQL•¯¿þs„ 0JÝ…E5EK¶P~’…Rü9Í"ÌÌ,©d¡¼ :qÕÈBE7rR¢ ßX¤wKHHÀ’O—àùçž“‹&ÈøÏ?kîåºmð6`M“Å`ûò˯pûí3$²Œ£½wü'âK­Y»7n2ùîaÍëYìõÕ í‰ •é/¾øþøc|ÆïÒ¥‹Þó%$ËAÅzP©hèþLÉ7õméõÛT»œÏ˜@Õ,½þ(­“bå½÷ß—JÊ#k¸?ÿüKZ Ïž5KëÓ§·‘¢ÅÒë—¥õ齙ŠT”,´Os+ijã€0ˆ­Z '&À˜@“"P9#פ†}åK+ÊC‚Cà#‚¥åååY]€ÌÌJ¿¥cÇ^…S§NéõA@4‘^ŸS»vm¥P||¼VÉBò*A6ir«¦/_õy¼õM¶ÝBAHŒô°Û£{wlݶMŠØ£‡ÆÂ…"wÇTº«oò³<{bLÇСX#‚hŒH±HiÝHEËPÕåÕW«êŠ•ƒj…u­+½EÐVµD×G%)ÛÊ7å_ÿ™JÍ"#å!rͨö|päÈQmU¥¬6ƒ7˜hòÞ~çáî0A®žööö–<ÈBy¸°$¡Y-?üÈ£ZK=]`Ê5Åן½ûöê6-·Éï´peÜEXÚ¥?-œRò®E†5®ßµè–«0&PAÀ’ë.DµÅ|ûöí× ó(†ÉÒë—¥õC„çJ´ˆU×RY‘3fO +Zü͘hBÌR´Ô7«‘ú|~È/ñÓO?£ÑCXcN2맶_}ù%n¦¤©©©Ú2ÖØØ V}ÜsÏ=r’|–ø7vöíßzq"kZeF>Cësjß®½ïĉzb*ù' òõ ñŽÅvíªœ ïÕ«§Ž¢¥»l›”w´:‘SÃ$°ÿ~¼ôÿ'® q s,50“ÀæÍ›åjn²0:t¨Ù‹ (6ù÷÷÷ƒ£CåãwVMZ;‘Õ&%r}võÕSä¶Ò}“û%yxTÆZRòø› 0&@æ®I±Bñ¦È-î¢-\î|òñGÒ-Y0ë&k^²²ÔÝÆÆÆÂÐ’OWklÛêúm Ù¹ &ÐÐ Ôöú£» Emž"G(j•ääTù\¦äYzý²´¾â.>;[}Ž%ÛÄ5Q‘Ÿ¿™`L q0¾c5Îq^±Q‘ÅÅ&1É£›V¯^#Â]Ï£"î¹Æ"ØWçÏ×-bñ6M‚¿ôÒK"˳2Îg£’È—Üq½±h‘êŠ ¥Ü•þ&ë‰fÍ4«y»wï&»OOÏ@‹͵¢(ù™2¿¸¸ÉÉÉÚã¼a‡‘Aœée¸§ˆK@ÉK¬Þ&×S”8>‹ÄPïÿ¼ûÞ{ZËÊ.!=- GÅBâÄšZ-ý¯ˆ…6fÌá>l|µ×.Š]öÄã %ÇÕP¬blÁ©uëÖxY(C91&ÀjC€{ý!,úèCÏ×Ç ÃóÏ?'­HÚ·on¸ß~û­jÓuyýyYĪ«T_®ßu5>n— 4–\,£¥×/Kë[*?×gL€ 0ÆE€-Wè|~ýõJ̼ûn¹ºŒVØ GðVïù·U«±]ø¦Ÿ(‚Ý÷ìÙ ôÐ._¶è…kèÐ!bµnÜtó-¸xñ¢Õû¯Mƒ´Rw•ˆ]£›n½uèc˜f̘ú „é"ø'ë ²d¢M¾d;wê$vÝ»u“®¨'5“nëJÀ­YƒÀ²eË­Ñ ·Á4ß×­“Š–ÁƒC7n‘Ú ÞX¸PÞéY€Réü‚|mѶBÙΚš^,ecéõËÒú–ÊÏõ™`L q`E‹•Î§®é«Z“ôÀ‘˜˜(-AAjEdžâ.Ä°€½Ž»’ªú"—dËEPLúPrvvFwocÞÜAA(I±1õ–›EÀ¹ »°É>YÅV¸‹«í(‘uÎ%ÁKIJþÉ“'Q.üàŸ«4¬çoë 8-¤h!SèN:"º[´lœ~¿ðÐVÉIüŽ•TTX¤lòw!À篜¨F$&YpR¼r A×4º×¨)\: ¥2-B ´wï^Ü=ó£ Ñäú³.-Ê=ü{¿ÿÁ‡è,ðP˜¨KdG.)•””ÀÐ-åïÏnäö•žÿ›5«´§c”òõ§>\¿5ù/hz¬qýÑ÷ÐÝVhÚ‰…¢U%K¯_–ÖWd£­jÉÎÞúîfÕúá<&À˜¨_Ôï õKÆF! Ý€CCCåX²uü*ƒËÍÍ‘›ä¶Iñª£ïM°5ÚÎÍÍ£/³½xíÚµKÁT*tèÐQÙ´ù7±¸é¦›qß}÷KYÈåË 7Þ$ó(Þ¼‡d~ŽX‘§ä?ûÜó6—»± °kwe°{òéÝ-ZãÎâæÐ9°Uê*”„JJJJT6ù»àó×@NT#“î}7m’#š0~‚ÉëWÇ´£¦Xg¤T6Lj Ã2–ì“[LJÁÁA–4Ãu™hbzôèíÛ¶ÊÏCiž—«BPXXht¸!_¬}ý¦Å\J²wàWd…35Ö¸þ(Šj_™'ÑíK÷¹(77W÷ܶôúeiý‚‚)Gppå<®!!!º»¼Í˜`M„?EZéD«­ÂÐmúváòJ hKé ŠTÒ¤‰•MùMJšñ&hóŽë”U2ßq–}ñ9/^,]…)ùÊ·îä­ì­o)**JŠtRX³è>tµoßNæŸÖ,œêžÀ±cÇä*pê©sçÎÒª…¶wíÚM_6IÍš5ÃÌ™3µ}ÿóÏ¿ÚmÞ¨ÿøüÕÿsÔX%\·î9´¾}û¨Þé`ùåJÅŠî ½.“ýûéîZ}ûxìqÙf‹-´1±t;1|8>þè#ù2Dc}£{œ·™hšΞ=«U;Vûž¡KcäÈÚü'*ß5”2 ùúcíëwzzº‚E¸ZîªÝæ &ÀŒ Xãú£;2i’þüõ8^ÄÙSYý&K¯_–ÖW¼lPLÓÁƒé‰G‹tÆ^5V/w˜`L i`×aV>Ïäré–›oÖ¶êîᎾ}ûA™¨!…ÇW_}¥=®lü*â”\{íµr÷‘GÕ‹‰‰ÁȽ1uê-PÜg‘eÁÑ£G•jÚoº™÷ìÙSî/Xð:¾ùæ‡%UöŒˆÀìÙ³´eدݮ/Z…Jì =‘´ã6È×+Tvúôéƒ!"€’º%…’¦NŠÑ£F+»øèãQ\\¬Ý¯Oôûܳg/† ŠˆßŸ—o×îª-Ö?™¡ßwß½²O¡`Œ¿]rÙãââ"ó(îÂ1±ÀɺøüY—'·V?ìܹ2´¯¯¯ªP‡Öæß:m>ŒM›6K…`` î¾ë. ŠŽºL?þø£¼ТŠ7½×,”rK þýúáÉ'ŸÉOn^y¥î‚J×å¹m&À¬O€þù'Hɺ–¬XñbÇÂÙÅY\?ú ñµÿÃÚmeÃÖןY³î—§æYS‘Iq‡æíí…GyDÉ–ßÿüóÖ•­µ¯ß䀮³ô.wÃõ×#0 ññçôúß$,%÷8 —Ç;L )°ÆõGáFïÅ4B®ÒÿݲU¸>w„ qÕ˜1²-ýûï”âÚoK¯_–Ö߸q£X”ØIÊ3þ«âÿ±ôè™íö3„Ëxo­¬¼Á˜`M‡+Z¬t®+ š~úé§T[¥`ã‹Þ|Kû‚ [hÿþ"®Ê—¸ãöÛå¤ò¼¹suËí<áVë9á6KéK·À{¢¥›ˆ§AnÇÆ^u•üèW¶/\HÀwßÿ ìÖ›ïöñY -WÚióõ0õFð AºtéŒÛoŸ¡*ÖÕ8T`égŸÕ[E ÉGAïIÑ¢(YHùB± ªJÖ?M4ΞU©ÔísÛ¶íxùeždÔeb­m>Ö"ÉíÔ'tíZ¿áO—Ì”\líï¿c¢°¥û÷Ûo½%c‹y¿ýú땘>ý6SMXœOVzt_¾åæ›Ðºuk,ýt‰Q›4–×__€¤äd£cœÁ˜@Ó%ðêü×жm[i GÊ–G~XÆ’O?•Ïw†m}ý¹ñ†MºMôððÀ á@7¥¥§iߣ¬}ýÎÊÊ’1,{T£ÜQS²'$$°¢E÷„ðv“&`éõGwNã¡(ž={¶üBýL¼;§¥¥fÃÒë—¥õW~ó-&OžŒ–-[JåʳÏ<­•‘”¶+V¬À]bÁ'&À˜hZì›Öp¯ühi…)7~þùgL»õ6|ûí·&…xçwñâK/!11I¯ M°ÐƒYF(ãõ ˆÊ¿mútÐÊ 5k Ê[³f n¿ã­k(Ã6l¹_i¹¢ïÖ ª}”ëD=·h±%;k÷mh½BT;çJ'úÝ_VY[¶nÅO>…ûxjþů´\ÜŸyøü™Ç‰KÕ-?„\uéÅ_²å˵×ggg©dII¹ˆ§ž~Û¶m«® ‹¿þúëòþgÔÖþýû1köüO+­M¥†|ý±öõ›&FV4ûöí³É³¯©sÄùL >°ôú£¸#+²Å‹—`Å×_C×Å9ÅeyW,&ýD3•,½~YRŸÞKïžy|WÕU¥¦¥ãÑÇéÓgL‰ÍùL€ 0&Ј ØEuhSùÏ` “Çk|¯^·ÅàïÖ5ÈÈH¢¤¸qññ5zØwîÂÃÃ¥EByùe¡XÉÅùó@5œ˜`L€ 0c¤`!‹ZE‘‘.]ÆÂðJ§°ÐP±Â;XĹ òÿ}¥Eàþ˜h€hÒ’žÿÉåU©pµ“””„ÌÌ̤¡^êËõ»F°¹0hDjsýù曕è\áz«GÏ^2æyTh#žÅH‰As j HMa³ôúeI}r7‚B¡`9Íó.¦Nç3&ÀšV´4“ÌCdL€ 0&À˜`L€ 0&À˜@} °rå×PâšöìÕ›•õᤰ L€ 0&`1vf1Bn€ 0&À˜`L€ 0&À˜`L€ 0&À˜hª›êÀ­5îû÷Y«)n‡ 0&À˜`L€ 0&À˜`M†ÀÞ=1Mf¬ } Ýº÷hèC`ù™`uJ€-Zê/7Θ`L€ 0&À˜`L€ 0&À˜`L€ 4flÑbáÙe¾…¹:`L€ 0&À˜`L€ 0&À˜`L€ 0L€-ZðÉcÑ™`L€ 0&À˜`L€ 0&À˜`L€ 0Û`E‹mùsïL€ 0&À˜`L€ 0&À˜`L€ 0&À˜@&ÀŠ–|òXt&À˜`L€ 0&À˜`L€ 0&À˜`LÀ¶XÑb[þÜ;`L€ 0&À˜`L€ 0&À˜`L€ 0&Ѐ °¢¥Ÿ< 0&À˜`L€ 0&À˜`L€ 0&À˜°-V´Ø–?÷Θ`L€ 0&À˜`L€ 0&À˜`L€ 4`¬hiÀ'EgL€ 0&À˜`L€ 0&À˜`L€ 0&ÀlKÀѶÝsïL€ 0&À˜`L€ 0&À˜`L€ X‹ÀýC=áæd‡qEØrºÔZÍr;L€ 0&PV´T‡1k°··Gt×®Gff&öîÛ‡ââbk4Ím0&Àê„€‹/œÝ½›t¾NÚçF™`L€ 0&À˜¨Ñ˜Þ×O6¾áxbÝt­2&À˜€V´!©á>öðw·CAée\È,GÉ¥šÉäi‡ /{””]FBV9 ›Ø?Ïx¸ú£¤´¹ñ(+· €Î;ãõ×^C‹͵'0++ ¯½¾ëׯ×æY{#(Ðþn(--GbR. ‹Ê¬Ý·W‡l}þšzÿuxjDÓ}‡`øc `ï舸ÿ6bË¢g„Ü,$`€O |Åýÿ22’JQ\x¹FX,­ïâï'”–”##¹ …yå5êßËϾÁŽ(ϽéIe(ʯYýuÆ…™`L@K ÌÛ^ÌØ¡¸bþ ¯†ëm=ÿ`ëþµ ëÉƤ.R’ ™%8˜PÃɤz2ƒ 0&Ð °¢¥5{;àæžn˜ÖÛW<äTžzØÙ›‹þÉAzAÕ/Ìã;ºà®¾hæç¬Ù%ñŽºíL>ø;ç…Ò¥±&;;;ôº ;Ý /·`í0Ë.•àpü:üµïmä¥kóëz£U«–Xúéxxhr”þ|}}±pÁëb¢›6oV²­ò=fDkÜvK7D†{kÛ»té2vî>%Ëbp!1W›_W­Zøâù'‡!"L#Cܹ,Ìž·ºÊî&\ÕóîPe:øïö8Ì_´¥ÚrTàê‰Q¸of_”••c惿!)9ϬzJ!Kë+íÔäÛÖçÏý×æü+ŒlÝ¿"‡%ßã~€VQªMä¥&â·ûoT=fifÿûžA›á‘x`'6ÏÄ¢æšõ"•,ÔHó¾ÃqmÅåªï=–tØmÚt¹f:2âObÝãwXÒ×e šÀÜ÷Ú ¼§ê²RŠ°àîXÕc”Ùk”ÆL GñXd@IDAT`„›¶ ÝÿíÊĚϒ–Põ‚Kë÷ëƒ7†"(R¿ÿ{³Dÿ‰H‰¯ºÿÎ<0vFÂ[¹kå//¿Œ“û²±zi’ãŒë÷ïƒkïo)Ë/é$ŽÇhëênLž‚ASBQ”W†…3i•?âQ{þ¯Ý´E?|ø.œ,ÑîÓÆu„¡ï8Í3åÞ©øáýUÁãï°Âõê˜Ú9ðo:¾}ã‚ö°¥òkªØ¨éïgÊìP œbØL•ûïÜÔ乬iÿUvÄ™¨5yÃ=qcO_ä^ÂÔeÉÈ.ªúnrWLïã‹æþúó;ãòñþ?YˆK¯zþÀÖó¶èßÉØ8_œ,•,Eb%áѤ"ñ`T q–‡¶õÄòéahÜ8O9Q¹~Ð"Œíõ¤T²KFÞy–äÂÑÁÝ[_Ù~„G˜)|VÏŸûàƒFJ¥R =ñÄbþÒôùTÊšû=뎞xê‘!RÉR$,XbO¦áÜ…l88Øa`ÿæøøIh×ÚßÜæjUŽ&½= -šùÂÑÑ^~èXM²îÕ”òU}Û“6ÒŒäéá„;ní!ÛüeÍÑ+Y,­o†ˆFEl}þ¬ÑmÏ?Á°uÿF'¤–öRIAÖ Fq¬®ý¢þì¬ÐGüö(+*”¢žþ{m*Y¨Evblj 4eöâ~é(žùÔ>öâ^n*M¼;So#•,¤œÈH.B~v©¼ÿwà‡>耈¶•h†íXZÿƇÂqÓí¤’…,i.ž/Ôöß±ú°ÚDW*` û|µî|±VÉ’“Q‚‚œ2Ð=?ª—/|·šwp1¬†Ý²…ÕN‘ä5îŽq11*¿`¡L•e6~Ÿ¨U²(%‰uiÑ%y¼Û_%[ó-Úë2Ð%b²’ÊÙ©<ÎÐcœÚùRË—i½d ùu¬éï‡Æ£&gUyºýn×´Ãú¼Ï˜€åè]ÿ¦^~p×Ï%Û2«U²<}•7ž,•,4ÿ@s™—äüÁÀÖøjF8z5«\j(¡­çlÙ?1.,¹,Yl¯£ÛÑ01ÿRP\.«½ÂÚ‹µáhÅùåüŒlç{ˆGü~DóL¯ão&À˜¨[¦ïšuÛ/·n@€V’ŒŠÒ¬:Xö_–ïÌf»šwÆaíœð‚XMè鈧ÇúaÞOÆ+zDVúàüõ`6ÞÛœ£uÖ6È ¯F„¯^žˆiË/Ê›® z·GÛëÑ¥Å89†/ÆÖß¡ôR‘|çîÐl4®ðšTÀLé÷VlšmÕ±FGwŤ‰“ðÁ‡"7·rÅÈÀ«ì',,­[·ÆéÓ§e9Šå2gÎlœ=‡uëÖUY×ð`·.Á¸ùú®2{íúX|üY HÙB©M+?¼ôÌ„‡záédžâîû‹Ó«^Ù$+Öà›«#~`F k-kíÜ})©y˜2¡ƒY­ü½å,JR-;t`KÜ=£§<¶+¦r%¨jáŠÌéS»ÃÛËé…Xùý¡ªŠª³´¾j£UdÚúüYÚ¿¥çßÖýWqjj|èŸ7ž„½ƒ“^½vc¯Eç)·êåÕç¤ý;ñÃcàèâ†â\ýÕwõYn– 4t_¾rŽNú³ñý'øcØu¦‰´îê*,I4¶¦ã—Wa½LÊ[Ÿjo±JùÖ'ZaÑìX#ã4Këwä‰~ÿ”„?W^Ôº+kÖÞ7>ÜR*PHŽ×n?Š2ÃÿPGLžÕ\žºÂzåÇwÏ!3Eãâ¤y”‹”? ÌSm‰7H~Ãä^lÍgp×ÿµCd[tè‰CÛô­W¯š'8-±ÛWgªþD’Åjâ1!=Øk¿¸¨-Ó¢ƒ«dw<& „µyUéüÉ<|³0¾ª"(“—ºÉZò+mÖô÷³ñÛ‹‚‰¾¥w—Þ˜xW3a |oÍ9ª4­ýÎH68Ú#@MûשʛL€ XMæ?5&¤—?”PˆU‹ªlu„˜c¸ºÂâb¥°~üì¿<íüAÇP{ð¡T²Pñ;vþ/ü±çuy¼MØ x»×ÌM‚¬XÅŸ¡C‡âæ›oÂ’%‹áå¥Q–‘ÒäÁ¹ópϬÙU~RRRdËTþÕW_ÁìY³põ”)Uô¦~hÒø(yàxl*Þùh‡VÉB™§ÏfâåËã-šù€&µ­æÎé'•,ä¦dÉ»ñì+‘“[lv7ùù¥¸kô ðÀ ¡4¡ôùW{±~ã™jÛŒ ÷Â55 ’¥¦ñi,­_­€*l}þ,íßÒóoëþUNI­³ò/&ËòD^ùçdÕº=[U¼T"b;°’ÅVø¹ß&J€ ©Jõ>ùÙUÇX ÐP"+’oœ×*Y(ïôA‘·ð,m"¸¹ZwÕ_qKù–Öï;.€š©pQ–¢U²PÞù%øâ…Ó +RöDõ6žlê1ÂWZÞ ·^_¾§U²Pýs±ÅøvQm"¨™Hña˜ŽŠ…I§jÂãoг: iá$\ªÉ*¤¹d¥‡—“p;–…€pW=ËŸ®ƒ¼eÝøãúÊCh¿T¬Z6ùФÕ"”6W÷/½ùD1žÓl }£X™ ¿¢ŒVRPú36Oõ¡*Vø %S`R´D…8aïùúÉB¢†œ\ê«Q4ŽS·9zn®îÿŠl9̯#r 4 Žv¥Z|éÒ¥èÜ©3 •-³gÏ‘–-»víR-o˜©(Y&N˜€sçÎã…_4,Rí~»6š‰–MÂ2DÍXåäé éF¬y¤Úµ ÀþC•ã÷õqAÇöšúñÂÕXb’ú„Btç`x¸‹·¥åˆÙŸ¤'“³³ƒ´`™ÿÆ?8r\£Ô+P‹rsöÏŽ+Qíñ¿ßŽâ›ͳL™}Wá Ç^ÄÆ4L5éÞÒú5éK)këógIÿ4KÏ¿­ûWÎCSývñöA`û.ªÃ/H»ˆÌ¸“ªÇ”Lßmá‚âœl¤8 7ÿ@DöÏ€`ä,d2ϘŽ-¡´SÕ·{`0üZ¶“EÒNEq¶úÊôªÚàcL 1 KJ¶d¨N‚Ÿ:P(”/¥ð“@‘íܤòE—ƒ¥õ*ž?OPŸÌÉJ½$Ý{Qì¿r_V¹â—äk©™Œ:s8GOI£Èw´EùepõpDXkWоaZ+”(sßë$•I½Fz#æ¯ ÅËaÒýµ}x»ú³ µåìŒ ß$"z?º ñA©TÙE—~ÒZF’ù G e3gßRùÍéƒË0&и zØaÎ`âûû=™r¡eu#÷ÑLÅE½Z"KˆÄ¬é–\S¶~Í?Ô‡ùP¡¨ÿâ¿,Œhï rvâ¢æ7¬²„cB–¾%£çòŠÙ:‡#Ú» DÄêÍîãwÅÅ}Q«o˜7©‹›ôêA.èÿ9UbxØhŸÜœup–9Îðv{âÿ¼âˈM)Á„KΊÎ`L€ X™@£R´x{y sÇÖ 06ï¿$–vÄKĉ“çPv©úž•9WÛÜ k4߇Õ äFL,(‘7MG7ö^®šÌô<ÓcKÏ¿$-7ÐÆgÈôÓ¶Ç%ãóiûTY— 7b—ÅÂöxé¶îϾ¸¸=üÞ}ç]©lY»f5 ÔXÕ„srrB``€T²Ü=s&.^¬t[¡V^-ÏËSã{=3Ót¿tŒ-žú~Úó„5ÉÓ{ cþ8ŸƒYsW¡¤DÿwDJ–·_/cb/ýr‘¢eמ¼ûÉ¡`ªþaNM~üˆ0/¼þc„bÇÿ>ƒO>ßmXDu¿G´ìÚ¯™x ¼Œ–ìP-SU¦¥õ«j»ªc¶>–ôOã²ôüÛºÿªÎMS8æת=F>ó¶êPOmZÿ>|Uõ˜’ÙaâMh7új$Ü…SWcÐýÏÁÁY³x@–¹í~œÞ¼;>žòZÜ)ö̈gÞ‚ËöȈ;uOÜ©tÍßL Ép2”H™b*)ŠWãHKëçˆ~ÉZ& Lçß¼Ž N"Û;Ps,7ÃXFwÍ3iaϯŸá-ÐfÄD䥥àà·KªhAýP·is¤’åRI1¶¼ýÊë©uªºôœË® åO­7åÙÀÄ㇬RÛú1ÒÐ6Ú½ÇaÛê4¤Äë+S&Ü g±À‡”=Çv[•(×5¹•¼3Vä®[ž„®b5·ˆ ú\å+¶5‹®ölLÅ…“U?cS?ö"¨Á‰½YèÜß_*Y:÷×LTÜ’…6ÑÆ.ÏÙ¬õm©üÖ’ƒÛaL áèßÒQëõíMiÚ8+Õdí‘<ô.¦&vöÁûò…÷ ýÙüû†xɉÿ aU¸íŒñuTy£¬âõSûgðúYhf·uÿŠÐ~W\>†ˆX_¤d"¬/)m>Q \¶«/B ã 'QÿÅñA8š\„=ç à"<3 Öª-„ËÍ ½‘&\kêÆ¡º¦RfŽ÷Ñ(ÇÖ®z¾‹ø½qM Ú /0â$îŽÏ8¥rqoˆ°Ôé×Ò]zCy÷úÜøy’Ù¿+S²q>`L ©PŸñm`£ Ft—vÈÎÎÃß[÷âøÉx©H¡‰e²^IMËÂî½G#>ÎÎŽèß·+\]ôWõ×÷!ßÐCãCõdj±º¦ÿdJv N:‹•›¹©ò9¿oÔ­rx)Y'p1ûT •”-¹&blÚ´ ½z÷Á~h²ïôtý€¤& šyÀK¬@"Zæ¤3q™X¾R£\¹ùú®hÝÒO[mÆÔh©€).¾„ïlÌU=Nk«Õzc²ˆ7¢ù½·îÃ^|z¸°R‰¬¶½ Wµ•V9fÃÆS¸cZ7<óè<8»/FmG‡ªYXZ¿ZkXÀÖç¯&ý×phf·uÿf ÙH ¥Åª¹Sõ>)ÇÔxtþ­£ptÕ7øóù{qð»¥Ø·â#¬yhš°tÑX¤uš|³˜ÌÔ¹)™ÑCH—žèrõm²äž"çÂY3jq&À®˜9ØÿOºT¦Üÿfú^å#þC(<pëÓÍ0äšPárô2V.<ƒc¯_V“âƒlû-I¶7ñ®HDõôE‰ˆ›²ny²Y}¸yÚãàÍN}½E<PܘS àVa5dVCµ,d©üµì–«1&ÐÀ ÕÉã£å(¶ŸÉ—±]ÍÒº#Åøëx®T¦|zK(&uq‹T…KGo{¼2É7÷×Q¤å¥ßSÍžd·õüƒ-ú÷z•M±¥Æ V®èßʹÂmW̹2ÃÅÔùP^©;‹¸:ÿÛŸ{¿OÃgÛ ð‘ˆ—sëòPìJ7÷ôƒC SMŠs¨Y@–(G’ŒçêVlb/•,”÷̪dÌû)oü•‹EâóØ/xèšûg §#z6«[ËN]¹x› 0&ÐÐ ˜eÑ2yüz;Îõw «°d! •»Ué,)%¥BÙÒ¿OWtéÔ1ûŽÕÛqé Ö»¹£\Í@yË„PsÃ{lt2ÄKâí+’‘–_·“ãæÈd«2­Bú¡[ë)²û/¶•W´ß)¢0wNdfbÎC«‘žaÚ¥˜"Yª êÛ :ã±¹ñÀc¿£P¸ÜtmWYdɲÝÂRLݻ҆5¾u‚þ~nÒ¹ûsói,|‡¬[ŒËdusû´²ûó"ÎÌÛ ÆÃIGÉtͤŽ˜>5Ï¿²Ç`i}kŒ[· [Ÿ¿Úô¯+¿¥Û¶îßRù›jý²âBùi™ÞðÉúäàŸ!<ºœ\=àÓ¬ˆùrB¯Œ©gO š÷’\ò—°ï?Ä®ýÁTQÎgLÀVÄ-yåÂóHŽ/ÄÈ›ÃqÓ#­0銩â 㣤Äàû·ãe`ûºqãwiBÑ woÍëÍß?%!;­ê‰&E&GîÈŽ|” ÷/úú EG/ìîÈ(ø»“p S] uŔ١&‹• ß0k>«Ú5¬%ò›ì˜0&Ш ÜÙßCb/ í7ÿÒŸ'˜;ÌSÎ!ìO(ÄS¿[úÓÕ k³Ä"ÎÜÞÏ_ă ÆÜa—à!Ü) #?œ“õ¯ü‘Ž£ÕLØ+€m=ÿ`«þí°åL1J…Rj`kwt wÞJr¥»/²N©.‰jøBÜt¹ ûPXTjã!aÃEÌqCª"¹ ]ÈÈvž²ÄšÃƤ†Uƒ*܉Òï`ëi}kT*»G(ŠF¾^V«Î™,Ę`L@0KÑRŸYµˆ «öpèÈ©*•,ÊÒÒ³qþB2š7 ƒ»›+ ëpyÒ©ßä7óÕIÁÒéÕÆØ\l~¨ÍIƒÛ¸Ë:bݘÿ9e|ó4§†^ÆÏ37yKº ;rnŽÄohèC2KþBaB RTtŒ ÄÖÿ4IUU&Y¬|úþDµ Ĥqí1vd8ˆ'í½û±êwË‚YWÕ·î±~9‚µëOBXQ‹xKÂœ}l{\5ª-ÆŒhƒ³ñ™ª®ËÆn r9FÉ]Äuyý­-8}6n®NRQs‹°Ò¡ø4¯½4÷<¸ d£›,­¯Û–5¶m}þjÓ¿5Æ­´aëþ9®äw`TW´sµÉ./•–`×’7L¯²ÎŸUÁ’›tN+ž³§æP›QÅF_á†Ì# ŹYØþáËU”äCL€ Ø’Àe1!”zA´ÞYXŒ+q_H¦Œ”bäeëßs«“uÔÔ@D´1v]¸wcÿ§?¥ÛVa^9b…û¯Ã5«»Ï3]V·m;ˆ‰²¢ürœõ;öÕXõ’Û0yL(aªK>Îz­iE )pªS´X"uòñq&À–ö¸­âzõÅŽ $æè{½pn}ÝàY…²˜\FÅg”!W¼¹89ÂÛ­Òò81« Y5X¬iëù[õO®ÃòŠEÌʸ©¡_Úæ 'ÒXU“N§‘’ƸÐYáŤLœ j?P*EªV´ŒŠr‘1cHqóÇÑêY¦h:% G´sÆŸ±ÆóLÆYÆ‚r`L€ è0KѲzݽJõig€pFÊ’ôŒl³Å:w!E*Z‚}Þ<—f7nÅ‚~nvx÷ú ù€D+Jæ¯×_¥RUWë„ÏÕžÍÜ‘”-„^¨ú¦\U; ù˜»‹n¹î.¾HÍ>ƒU;ž³úpZµj‰æÍ›kÛõôÔ¸¼ÒfÔ`cÈÁb%¥æ\eddâСC5¨­_tæÓèÖ5ÉópàpŠþÁ*öÈbeɲÌ»·?æÜÕ..ÈÏ/Á¢÷Ì‹“REÓfÊÏ/}jƒÉóqøXªˆoSŽñWµÇÍ×uÅ?5²j!¥¥Óg30÷‰u(*ªüÍŸ<-&fŽ^Ä‚—Ç "Ì[*n~^¥oÍfi}³gfA[Ÿ¿Úöoæðª-fëþ«° x…F íÈÉ&[.+.ª÷ŠR©¥ËÂ…§6隬i35.^>h[¡lò ‰@«Acäm½Š¢Ì ƒÒ¼Ë˜@}!0if0†ß.]uýýS"þ[› gŒ®hHiѪ³?u¬X)4¦Ö]<%\Ö¦óÂß=ªP´E:!zH€¶Úø;#p|ÏIH‡óÚ\õ » ]ÊöÕ©Òª¥\LnØ«QÔTÛFi-?»û„ 5S©\ç2hªŒ%ò›j“ó™hœhrü©1þržÜD}Su<Sê)•5dóõ®Lü"Ü%6ó³.¾RiÐ- ü˜„ã)úJµöl=ÿ`«þiq ¥ÿíÏE©¸w\Ÿ]ñÊ”cšêK…"ÞT¢cŽÎvbᣩ•ù“»hæ!vžÍ7Ë›I¬8§4ÇÔ*À¯LÁÕÑ 맳iÂm¦øœË(7çöY)o1&À˜€$`–¢¥>³òpw«q`{r3FÉÃ]8Ô¬§I,ÊÇ;7¢¹‚FÐú)5YQ°áx þŠ½ ›ÕÓ!Ö©X.NîRÉàÕ¹…ñõ¦Y(.­ÝhU‚~õå—ðöÖL­ªœ9ÇÞ~ë-½b“&OÁùóÕ[¢èUªØÙôïYlÞg¤P+k˜G–+dEBñQ(}õÝ\L³>;Ã~«Ú_µ.V*Z|¼]Т™7âÎU*VÉê¥M+¬ËVìÕS²(mîÙŸ„]1 Âm`$÷o]E‹¥õ•>¬ùmëógIÿÖà`ëþ­1†š¶‘~:1_}`²Úeò_ÓÈY¯ ¸÷½Q¦;€„]õw±‡ž°¼Ãš Â?)Y(Øý'Ož@JÅäRzRŽÇœÁha2îöHÌšßoÌ>Š¼Ìê'ëv®KÃÉ}9Zš£n ‡›°Ð®.M™.­pɪ¥M´°Šñ@ïQÞˆù«²­êÚ8¶»ÇvWZáUW^9ž•^‚_?¶lñ–5äWäáo&À7–"èz÷Håß{g¨ZDTGà:ájœ,b(Øý}?¤ .]s}NÈ.ÇŽ¸4ÜÙß³à½B1uY2 L+¨/[Ï?غÿígK±ý¬±‹¶ê΃5ŽGúÚ£[ÅïaµnèO¡Â㿤áõ)hì‚Þ-ÜåG‘‡~«å`™pkÆ®Ã*ü͘¨ž@õo-Õ·aÓöb™™b`® ´:žÕ­I„›ÀW Cˆ+r /áÁŸR’[õƒÚ8èæ©›TB[èn4ÛŽöN¸eè÷ï„Â’l¬Øx² ,{ù5gá‹Ð!*J{xÒ¤‰ðóÓ¸œÐfš¹ñõÊop¹\óÛLÏHGBB‚™5Õ‹©Å2Q/©ŸÛ¥cZ·ªØ­ñëêãÂ5_õ“#ú-Yoïbj¥û_RV*ZZ6óÑvtPX®˜J$KEKhˆ¾ë"Kë›êÏÒ|[Ÿ¿Úöo鸕ú¶î_‘ãJ}S÷¦è½$?çwk”*nþÁ2®KH‡huêŽÔ£û¯Ô©à~˜0“€ƒx‹7=B–^½ôœVÉ¢[ý¯oÓСZvò°ë±ösÓ÷i¥ÞÁ­ú¾åŠ•¶Õ)ZÚõ®RÅ„!Y¢üúq‚Pþ” Ÿˆ70þŽHäþ¨°¶QZ¯Ÿß ]þúI•¥b—€®Gª—j`+cU!^¦§z(tÈ=5 Õ>ŠEÉ¢KlÙŽôoé.'ð§ööAÚu«mÛzþÁÖý«1¹y;k”n4w´õ´º…¹š²ÊE<ߋŠ#ú´pAû aáâŒP'ø{8âŽþþè!8÷~ŸÖdðªqã<&À˜@ULß}«ªUŽ•””ÂÕÕ¥F¹º s‘ŠEÝú–ȼô¥‰¾r5AQI9ù9E˜oV?Á­èTŒ±*G¨xliÌ ;1Èë½V¡ýPRVˆ•›çàböéJVÞZ³f 裤è讵R´²pÑ¢EJ35þV&¥«2O&6”Ê«ø¸¹:âÉG†ˆø(v2ø|ïÂQë̘/VÔÍD'¢oÙ\£,!K•’cÿÊøH~e´MÉIÇwzi©é+J»ö,­¯‘²¿Êø DÓkTw]œ?kõ¯'p vlÝ D5*Újĸúø#-öR…õ…jªPê+ãT-ÙÈKMÆö÷_–$ì…„ o~ ¿í0ðþg±æá[q©ÄüGÆÉÞ£½áéëˆøc8{D=f öÙÍôíMU)§6nåÞR±–C­ˆŒë¦z@dšªÞÆb2†Ò±]• "d†ÎŸ£;³¤¢¥}O#E‹5®‹äöëêÙÍd1¦Šx1¥øse zŽ „Œr} þú&MG¢úµY[ù­ùû© [÷_™¹hŒžTãaµ ¶‡ŸˆßBiÛYÓÏWÛÎHEK?¡pùè_}%¸­çlÝ¡×QºGO.:)­?&Ü—¿JWÙ3)§bDà{úš{y§æ .·;{Ëóß¿¥“°Ö©sgUŒ2&ÀlD ~štÔFVv|}<á,‚·™›‚5«õ³²sÍ­rÅÊ=1Æ#Û{ÉÀgOþ–‚ÃIæÝ)ó*‚{ûË@iêâT˨|¦^ªaçNêó:5#|£–áûæáBZíãœÔ†Ä… jS­Ö.”ÎòDJ¾¾ÆÁc•2ʱ¬,õÉ*wïݽê…ìœb,þ|7–­Ü'«O½!¢4Áe•ö¬õíåéŒOÞ™,?íÚhVV¶ííUéæ/;G_~]·f-t¬[ ÛhÕ\ãï=ÕÀ š¥õ û©Í¾­ÏŸµú¯ÍØ©Ž­û¯­ÜTâªôžñ ÚŒ˜h²7¡ˆ¡Tœk¾û“5‘å"®Ëö^•V~ÞaÍ}Ëì&2rfS"Ðgl &ÍlŽ>W©ßûˆ…—ŸF‘Q ÜȪ¥ÂŠ|O_M9µ2Ê1rïe˜,©¯»PÁ°]µ}'•€ÌÅ ’›§fÂO­ž[Åók‘‰ç×þã}*&KŠË±~…&.]Vê%l[¥±fqc˜àX_yj+¿5~?j¼ÍͳuÿæÊÉå˜@c$P"n ›¥ªO^‘i ½‹cUË3‰‘Ç ÃTó5¸T×Eÿ†c¼ûž®êƒ&«#—Š…CÇTêÝÜÁÞšg€5GL/z0U_-?5ï2æÿ‘‹¹šgö!¦Ÿ1Ôês`L )P¿ª7 " ‰©ÒX›V×Õ‰î îÞ­[E¢¨¸éé•î‡ª«w%ŽÏìk„OiZUðÒڋدþR­&KlŠÆ'Âè(¨=6µ ²G èŒÒ‰Tãmµ6ZÞÈnsÑ«Ý".I9~Þþ$N'o¿âCØS«>wíÚ]«zJ¥S§5XG i¥º*µpÖ!I_Az6> iéš27^ÛÙ°ªÜðwÃð¡­äöÎ}e˜¥õU;¬a¦­ÏŸ5ú¯áõŠÛº=aj¸“~ꨬÙ{0\Œ­+œœÐ¬ïPY&í¤¦l »h²Å3ÎÇ‘_WÈñwž2 þm;5Y<ðÆIà ̈́H‡>¾p6¾|ÀQÌktî¯Yt®¢¬!‰ §4÷¿nƒýa¯r‹nÛÍMXÍh&HOë/T ¶,©ŸšX"ž¹4õ¡¯Ždê6L£HJAv Srœ&¯uo¸¸?Á6ïà¢u–|ÖX~Ww{Œ›¡yØö[2²Ó*(mü. ¤HrqsqbB »®û–Èoß%lÝ¿%²s]&ÐÐ œñ®nYv±ÊÏ_'ôß™tÇ|AÔW¦îÇvT¹‰Â¤ô¥q¹|>ÓxþÀÚóÏŒõÆ¿5Ãï÷† —eÕ/¢µvÿº|®äv[á®+ÀÝøþG Å¢4!»òÞf(Û¤.2ëTj1(À½¹iB'<1Ú 3ú¹«V¡9©’2M{†.ÙT+p&`L€ H ^Ñ’šž…Ô´L´mÓáaU¯¸§Éâî]ÛÃÓà ÇcÏVéBéJÿ>¦tu‘>0©ßovgâ¨"îm¯úñS¹ÿrPcÊÛ5 ‰¦‹Î³I+,ïõ)ARsV¬|9xÁôúJÛZýõl{=†v™%›Û~ìK$¤†¯g„êÇÃÕôÊQKåÙ³gO­šX­ã~¬6 ¬ùㄬ֩CæÎéeGä–ë…§†KLüù,R‰câíåŒG$ÛØú_<þÞ'·iåͶ£XXLE†{cö½e¾á_„‰Ø'ºO‹>G±G7Ÿ¶u]œÛRèPºáš.˜8¶TìÐ>•=¼¦ßÒv±aÓ))‹Ü©øCþØøå°Ü5¬5˜Õ•«nÚ·õǯ\wgää åц“ºÕ¥?wKêë5VË[Ÿ?Kû·äü2[÷_ËÓ&«úk•´ºpó À°'Â= Ò}ƒ«Ÿ??:žAa ÙÈSþjIWfÕu³µ!áU~ BnþFå©JŽnîFÇœÜÕ_ÈÌ°†…þ°9Iñ°î×>ðìunn5l‹‹3úF`çòäíïŒÏ·n®*5%dqÛ3Íáâ"•;~×,¨0ÃŽß5.±‚›»aÚ“Íà.ž•Ôª³+¦>¡Yd¯îžÌ’ú¹å8²C³xcò¬8ÙW*‡”þýCpÇ -ÑZ3 ´c­±û®}gáÒ¥ËR™2ýÙz–'¡ÂUÉÔÇZÊæÒ„’&¢eô4qýîË ÄªÛM?è·_˜WŽMß'Éú}® V/•ÏŠŒ¶þ¶D~kü~,¿­û·Dv®Ëš:´üËØrJ30wx nèá ×G„‰{É‚)~2H:±ú倦¬.7kÎ?t‹tÀ”®>R¹C±AQýûº5û×וÞ.îâ_žä?Å­ÅüÍ“c¥(dUrƽº~ÍÛ Ë wâàwKë¬?n˜ \IÏ—‚‚È_=»:ôöÅs+|‘‘,” b‘ƒ_¨‹vÑÁïËÎ#éŒú$Ç©…øçç$h> ݇ ë d$ÁEøÞ'%r¹µbÁYÕ¡YZÿ§÷. T(yÅBŸëîo)\¡•#ëb1œ\„ÿÿàÊgÛ¿JıÝë]AÒÅ¢µŸŸÃ¡¨!ϯô‘ò;ˆR2Q"—`ß½/”Úº5€0G ¾F(²EÚø]¢°^1( ò·®JÇ «CàèŒÉ÷D`é³qT¼^$Kå·ÆïǶîßÙ¹.`Àë²dàófb2ý±QAxpèe$å”ÀM¸« ©pEEœ¾Þ•©ŸÃšóž®%=Íð¢`Íþmù{8)î™>âžýÛœ›·X,˜µ“žHhþF<àÍéÂ-ºº„£;¸Êòebáá*‹ÔkirÙ_ ¼©x#\,VxZ,Fxdäed”Éy#OG¡x! €Ýqñ[4õø/`L€ TM Q(ZJ„ReÛÝ¥-ZµŒ@óf¡ÂÊ% yyù‚xQóõ÷Dø|?tä$âÎi|6W¦á}ÿŸ<œÍ(ÅÂÍÝ0£ÅK/%ºñn;÷þÎFb¶‰»tÃn½’ØQ¬²~뭷бcGü÷߬߰?ö˜°¬Ð¬âT¶\D¥]¹òtïÞ ½{õ‡~€ûïEEÆ+6Õêæ}òyŒømgáÖ›£…‰:u –EÊ„É/¹ËúDÄ\!¥‰a"‹‘aƒ[Êì—î2¡ˆ8Žáƒ[IEÈã ÆÝ÷ÿ*âj”6Uë} bÿÈ3`†°\™0¶½ˆ»ä*-P¨ARþüñçI,ÿf¿žrF·3²¼yíÍ-8p(Y*›ÈM)x(‘ÅË®= øü«=8—¥[M»mi}mClØúüÕ¶ †¬WÕÖýë SÃã«¿CnrzL›-ƒ·{…Dh[ÈjöïÞÒú&Ä2;ÛÖ篩÷oö‰R)èê q&üÞ¤%£ =U¥g1&ÀŒ xùÛÃ?XX¡ˆE¤Y"žžn¼ãÒê9d%áíïˆ^£ýÐ|ÊÊ.ãíûŽâ¢˜Ä2'YRŸÜ}ú‡:ÂË×QX– Ë–Ô2ä×poƒ°>q’î}ÓKQà „Ì9oTÆ¿sûR+gëþÕdâ<&ÀÌ#@Æ ä.ÌßÃ%ÂcJŽ°n(49M¤Ú¨¥ó亪]°=²….<±×~KûWÔÎ üÃľ¿,îå´L€¨#Ø´ñ/$%%ã6¡HIKÓ÷nN·dùòÉÇ¡[·nÒ…Ø–­[Í©Æe˜`L€ 0&`D€Ë?±´£ˆûâ,¬Br°ø‰3FeªÊ°´~Umó1&À˜`LÀ2÷õÄtán>#¿ S–$ /&–µÇµ™`LÀ:ý_2ÕTT»òÐ ó¤!& ²Í*–†xæ–ÌWeß¾ýX¾|9RSk·z½´´¬_ǃ”,ôÛåĘ`L€ 0Ú¸$ Y³Ó Ñmˆ?üE¬“Ô„|$Ç™o-kiýÚÈÌu˜`L€ 0óÜ=À[ÆnY}8GÄP©½5‹y½q)&À˜0—@£V´˜ Ë1K $$$Hwa–´SVV†¸¸8V²X‘ë2&À˜`’@J| ZuqC€ˆÛÒ²“'v®KGY©ù 9,­Ï§ 0&À˜¨kà‡½yØ{ž•,uC˜[eL€ ÔŽ+ZjÇk1&À˜`L€ 0zMà|l>¼…uK ŠE¼¶‹çÍ·j¡YZ¿^Ãaá˜`L€ 0&À˜`V$Шc´X‘7Ř`L€ 0&À˜`L€ 0&À˜`L€ 0#öF9œÁ˜`L€ 0&À˜`L€ 0&À˜`L€ 0&`V´˜…‰ 1&À˜`L€ 0&À˜`L€ 0&À˜`LÀ˜+ZŒ™p`L€ 0&À˜`L€ 0&À˜`L€ 0&ÀÌ"ÀŠ³0q!&À˜`L€ 0&À˜`L€ 0&À˜`L€ `E‹1ÎaL€ 0&À˜`L€ 0&À˜`L€ 0&À˜€YXÑb&.Ę`L€ 0&À˜`L€ 0&À˜`L€ 0c¬h1fÂ9L€ 0&À˜`L€ 0&À˜`L€ 0&À˜0‹€£Y¥¸`L€ 0&À˜`L€ 0&À˜`õžÀýC=áæd‡qEØrº´ÞËË2&ÀV´4†³Èc`L€ 0&À˜`L€ 0&À˜hò¢#0½¯Ÿä°áxb“çÁ˜`WŠ+Z®éöîcw;”^Æ…Ìr”\ªYAžvò²GIÙe$d•£0Ô `-K;;;#2"~þþpqq._¾ŒK—.!''IIIÈÊʪeëæW tG€¿JKË‘˜”‹Â¢2ó+sIØšŸ­û·ô'ÐÐå·tü\Ÿ 0&À˜€-ø:À'ÀQ<ÿ]FFR)Š /_Q1Âáéãˆâ¢KHK(EY{ÿðò³‡o°#ÊÅ{[zRŠò˯([w&Ç$οøÝe],EI±­%âþ¯$Kç/,••ç?ô Nêâ!3.d–à`B '“ô›â=&À˜¨V´ÔV]µ·nîé†i½}…’¤òÔ eÉÆØ\|ôOÒ ª~aßÑw ôE3?g­¸—Ä3þ¶3yøàïlœJ—Ƙz¶½û<_íÐŽžÛ€ÿm{¢Úr5)àëãƒiÓ¦bøˆh׶-ìí«}”š–Ž;þ÷ß}Çפ«jËŽÑ·ÝÒ ‘áÞÚ²—.]ÆÎÝç±dY .$æjóëj£U _<ÿä0D„idˆ;—…ÙóV[Ô]Xˆ'–/¾V¶1÷ñß{*]¯½ÞÝÃ0ÿÅÑzyj;1ûñìËÕÉ<[ó³uÿº`®ž…ûföEYY9f>ø’’ót«n[SþÚô¯åà`‡›®íŒ1#Û"TüvèâZ‘²²‹pó?*»Vùn3z úÏzÒ¬¶ýü%~÷©YekSȧyxG4Gi^.’ÅÔ¦ ®ÃjD ßì'ÑvÔ$ÚM¯ÐÒ,›HÄú¯RõÊZR¿ßxÑ÷ýš¾—¿tÇc ôÚVv&Ï Á )¡(Ê+ÙÇP˜§y–œ2;'‡(ÅÌú~çþ£H‰¯œ}¿~nú\lT÷’X(’V‚Ø=ÙØú[šœ´6*$2ꪾX#ƒÂÜR\8™¿§áèÎ|µîѶ»f¾Ú^õ˜nfVJÜ«›%·¯¹7ý'† îh.?qÆèxP¤]ÜIæ¿ûàQ$Ÿ­d§[¸×(/Œ™ŽÀ7m6=ÿÛ•‰5Ÿ%I¥‡ö€ʹ-Ì-âÙÇPcúýA¬)Âàkü0üú0øV¾”–”ãÀ¿éXûyrÅ¢1µ4íÉHD P;d”÷Æ݇‘‘¢?Y¨œÿSû³ñÙsqFu(cÌ­55eÅ—Ä98Š¼Šw!Kÿºuà±3"ÞÊ]›]^~'÷ecõÒ$Ç©Ÿ·v=Üp÷+Õÿ~NìÉÂ/ÆkÛV6,ýý)íÐwhK'Lº*~C)ç ðÎ}'u‹˜Üîs•8ÿ!iQ9þ2ñþzdGÖ™Œ‹çÕÇoËóOƒQú?ò_VÌ?o4>±ðñù•]eþÒgNàôÁBmkþ~´Úp£u =æOÔÎ!œ×ßé_]¬V"kÌ_TÛI5l1ÿáälž©•læÊDOÑ¿Î=1Ú S¢}d™ßäàµõ9Úò´ñä/LîêƒÝñxøzÇ,ÝqSI£Ú{ÉfÖ©û÷KååúL€ 0ÆD r6¿1ªŽ…¦_™ä‹QQšb‰x9J/7>®ðtµÇ„ÎÞè+^g®LFr®º²…|p*æ¡EâåæLz ÜíÐ2ÀCÛz¢W3wÜû}N\Ôh€¸ŒD&ËûêÎvvU+AŒ®Ë—-CPP`5%+`Ò¤I˜8q"^??ýô¿Êƒlͺ£'n¾^ó2P$,XâÏgÁÍÍ Í#}0°st‹Å£O¯ÇÉ3Ö}ÓyÂUmñÀìþpqOŸÉÁÁ:Ì5íÐ ½arÇ”ã†Çt÷íu&ÜuóiÛÖülÝ¿.O'ÜqkÉôÇ_›¥d±¦üµé_WþGˆq£Ûêfi·­õ{Ô6(6ì„rÕÞ±úëÕ¡²u™Z.×LGú™ãøý±Ûë²+n› Hvò÷OßœjN€îiŽŽ*7¶ÿgï*à«8¶þŸ¸»‡„(ÜÝ[¼-¥-uêî}ýêö*¯¯´Ô[ZúêE*8‡@±! qw÷ð™ÍÞ\Ù{s-s~¹ÙÝÑ3ÿ™{w÷œ9ç(4¥ôóaIýƒË1õ²:„9ãâCqú Uµ1½lI™ÄyÜò}ŽJÉÂØcTÆò®0žÄîËJmØÙÙr¾oc.òÇ·¯UTvtT}Æœ½ŽeoÜX€ïßÉÑÁÇXümh€õ¢t6~¥¹eåÕÛgϺJ4ÿ–L_³˜p¿¬ ŽÎ¶põ´Çàñ>ˆê‰KDvrƒRu´ÐLZH<õÂ__gT²€XºæÉ0 ›")K˜%MEa=\<ìàìf‡Q³ü;Üÿ}(¥ZJÖ±¾ùÓaŠ%(Œ_®¯_²îŸJ †ñÎ_ TJÖœ¥ëŸµÁhÒbo\rWé‚þW”4P6ƒ~#½1È+Ÿ8ƒŒÓºæŒ/¥õ¯j¬õDßøÔׇvõk}õå2La»˜ÆààØöŒ¢¾IE.§t¼ê‘P>Ï,O{ý ä‹þ´ðëSHiª«È•çO©]4+Ï?k_îß>òühwo­õ£3Î.HX爇gøÑbyȤï7IÎgGVÚRù…z{æœw¥üÃŽ~#+ëZàN²š}IÑÒ¦gØL%ùKM} <è÷XéÔ†kÃN{q™„V±Žp¥ï3ÝðGB›‚P«˜¸@À8ÉPt,šÔD`!=àÈJ–/hWÍ—´s®ž¼=ñ›t¬=ž»8~ôÂòäEÞ¸ÿ']AùðÞm>8;VŽ÷¶U¨Ü…ÅøÛàõÅõ²Ç óýpõ—ü¦«ÉAϾJHû iy10|6f“vÙ&åü­XÆÜÄûî»×$%‹z?ì…ù‘‡ƦM›Q^^®žeòùÐÁ*%Ëï±âÓx0e £èHo<ÿÔt„¹ãÉG¦à–»×pwf&wb ‚³“¼gs‰•|LR3¥†ºáo`{Œœ) Q™B¦¹MgÍAf.˜´y®,‘)L ¯Ç®µÛg«vý2·Pò‡Å÷øg[%V<šÄ…äÌBcâ"ýÖÃÖ®Ïâk$©Å§Ï¦‘K5)¶Þô+‚a£e¸ÅbP¨³²¬M‘¤ž^’§žµRËmÍx{K/ W_s-’““Ú2Œ8ûö›o ¹ #ªè--½ˆnÝ™ª¸[1)¥YåÜXlŒ/ŽÏWµååéˆ}¥úéTFŸ zÈ ¸ºØS€ÕÄÉUÕg'ä*ŒY°¼üÆ$œ–”‚Œ¼`íL†¨/²æê…ÓIEØGÖ1çÚÙ‚)+Z̵V°?#‡f°˜%ý[cþÔ™»ãæÑÜåʼn“زCШç+[¿v{æô¯ÞxȤnÉ"§uÇ£WŸ¸ú‚)aŠÎœ€³z7ßÔ×T!÷È~”žUÞéî·@IÐÁÆæÔ›ÑÁÕ ¡£&ê ·2'9’àKδsrFààü2?á0šêê:z|"ú’K({”e¤ ëàßh®'‰b;ä‚ãáê€&’•g¥"çÐn47ç²ÆÒúí°g0›¹ =ÞlÜä«$5Yûw€¹Ä ŠÅër|jõ¸` ­àþýâàÝn¤ðë…†êJ”ÐÜœ~\hý6TUÐú=@œÖéN$t~'%Ê}ï äÂø‘3<¿¹Uñr#)hÇýÙ8±§ªK.+lFÂÞRRøø‘¢ÀxÈ3‰K볇ê?çs«ŠŸé`´ .“5³0³Dbttg‰¢+ùh-)_áFBÀÞ±Î1&´»t÷±ÁÜÃxò®5yÈ=køwÛž^]ä˜$G¶kZ;ÉmÛU‰+’®B¢œPVضã[.£ï8ÿæ 8¹Ú¡”H;Óµæ×WONŸyUw…Å” ÿ¢i‰$—aGKÖp„$Leß^›ÒNÖ‘‚¨‰#˜ÆÏ®ÕIeÑBŠŽ® ;{²`©Ç7¯¦"ý”&oíñDŠXŸ@éý•}G”ˆ)ˆŽì("% Y†ñÂÆoŒGè¬ùWâÛ”4KÖ)ýtDYGzfίhÄ3ë qìLô75Öed‰—]Ö>®-­Ò?×^ÔŽ#é^SAVlÒët⾃͂ÁÎÜ+Jµ±Ã—‘ìÍ).Ô–,sàáHWôWU‰ù 8šÝ|ÞyB1CQF X‚Ày¥hñpwÅ QðóÕ5wm¦­i98“”¦æöox–€jNÝçÖK¨'r” Ì{g7Br[­CîË…Q1íþÒGÅÕͤhÝ@Ûv[è+ÛÓÓ}ÜÃpíŒádïŠc©ë±áÐë:¤¦ÆFÔ×~!Õf@Vèó¹­]Þе»›|´´T*³<¯Å͵-P)k³ªº7]7Ñ‘>ÈÌ®Àí÷­ECƒæ:bJ–·_Ë->ùꎢåÀ¡l¼ûá>TVš†ú˜˜råÅgfòàåê鉤lyë?»Õ“tÎmZ·š«h±?fÌH°¤kÌŸÌòpŠãÃ]-$~å>9¹Ý£%ü«7nnÿêmôÄóþó¯@ì¬ÅÈ9vÉ[ÖaâÝÏÀÖA^ðñ\{7R¶ýŽ}+^F‹Öý+vÎ%0ÿJa»öÆŒ§ÞÖI?öÓ8ºú#t¿ UÙ¿ž¹cny>‘ý4ÊÔ–bûëOpEFFëSÖŒ¹íQDO›G7*v§j#æ.mïG¯!c÷–¶D­3Këk5gò¥{pf<ó6<‚Ã5ê–’’iߊWTø¬{ð”¥'k”a®A!˜öØë\9¥“I åÙiøû­§ë*•7%mÐ¥×!râldìߎ¯?®SÕÞÅUÅÿÆ-GþñC:e¬Áÿ¹–&®Ü›òð+°s”6ðŽØúÝNë÷Ýõ«ÃˆHè2Ï4p‹æ>hÎu¡t^ÐG߃é×®Ìê¾äNËÉ5 #¦,0‡,­¯îîÌÍ“½:™ÿ¬cÿ†ê0å#¦LÑG²¢ÅÉUáB­Òâ;C¹›­2 ‚½qUûA°YÕo^Ká-¤R~þl¤˜‘l ±Û‚­‘±ˆXƒáý1j¶dýÛG™ŠJ$Þ±žÌzfܼ@ž»íÇ\ƒÖ0–¬GéŠYßè£?Ã7°”K.m’-¤˜EZWPb|~!wsæ¸eóöoû>æ¥éŽMO ‹1rÆRgο±<é+gÉúÑ×fg¥ïM­Å›ËI¨oÞú³T~aé8»ƒüÃÉÁ†”$ ÷3û¹á£]Õˆô#×—ÞXCîܽ]Û—»0‹¢‰Qöxea FœœåÐ xeC9šŒ44bOàóK®à6%’XY´¤‚>Ä“¹˜÷SmúUe´ž°ºÏ¬/âR´óĵ@@ (#pÞ(Zú„að .„JJÎ@vn! k)@º Y ¸#"<„ɽ臇PY¥l9¢ SǦ²àÆÓúPYï±dŠ*‹®2Juæå«“’²wb;§[÷‰t3Ô¥¬¬1ôž&+vXà=uj¢'·×ÞÞ…ï,@X¨®»r>[õª³2yèÞ‰ü%ùä) ûs‚*O>Ù°EzÑ–¯M=º8Ûá¥çf"Ðß ù÷íÏÄ™”b¸»9bÚäH\C<"9`g {R%òñvÆèÁðòt¦ïz=YðäéµÔaå-ÁÕ·”,éßóÇøg<Üuëh>”ßÿ:ƒä³Ê»S•Æj ÿr{æö?wv4­¡r3prl{ñÿä?‹øzReÒIEE=–?ô»zR·9·wtƸ;Ÿ@aR˜å„­½ÂÆN…gHDOŸª¢|ûn¥¿µeÅd5rV•æäå G7O² ©GUA¶*]>©+7¼+8îò›¸5FÂÚÕh¬©„gïHô7ÎÞþ\±öþ«PG–DkgÒC/!lÔ$476àìŽ?QLÖ v4žð1SÐ(¦’ð}kã#È>°S£*¿°´¾n‹&¥0‹éOÿ[R²Ð23~'ŠSNÃÁÕ‘“gcèÕwnøŸþÄ›ð!b rDežd‰çê„P²&ñ À¬çÞÅow_Î-† 7ØɹVâ¿Y?M¼ï_„Ý)ä8¤¹~§ÍGmIþùfE'Ntg,~™‹8 \Ív¨žãEçÒ¦¥C[ ‘•døÕØ>Ì-çÕjõÍâИC–Öwój{]ª«1RÚe£Ô‘Ÿñ•šŸ e7UJeúrQÅZYóa†¢u†v½FÒÙnØ-MH”~du ³Û·Šä}Ðcê¥ËÃx½·R)ˆº6/Ú׳®à±…˜’i×ýÖ,r=s׿üü#·£tÌ6°£¼WkŒYÑâNîÎút#¥¢¹#kFòÑj½q‰”ú25íà&óÝ™2wc2ÙRL%¦TS"9˜¼ÑqŠº`þ•ø6%ÍÜõcJQö÷#¿“ [C~¡Ð¬IIòmÛJÔ­.ÿ6Ò£N‡ h ­“cܸ’e2Y¯1Úv¦†\¶«mœÒâ@æÉžêÿk®?NæÕáPf éû4…¬ûP|­yƒ¢ÇíN-­Ïš5[rÛØxŽÜi™æ^ÉkÝ&‹¹»ôîpÎÏ©ƒ¥<¶Šµ˜›¸ÈŸ7•“Zƒ¼4ýV7êý¡àÜ,N ܯ]™£žeÔ9›óÑsxÙ-ßçP ùö«uÕú'Ï”œXŒ–‘3ݱôÁ(z~m“3Kí=ëò±feÅajY¢$¿Mñ9È §*ÿ¶G–žÅò)(·1Ôóo _†ÊtÕú1ÄSwÈ3G~a)ß]!ÿp'½ÊÖÄ®h™é„q‘.¨$·]ñM˜J.õ‘¬ì„ï—ñ8½rÙ•»ªÈÒÄ£]qåo|EñÔªØó°`°äN’Y¢$äênΕÛgǾ6\ÉÂΟZ›Çã³s™F†WàŠMæGÏ#Âì±û¬q¿ár}q*F)ZÎÜmñÙ°eâÈ’…Y¨ì;pÜ [°Üüb4>‰q£ã0x`4âÿ9ÕmÇ¥Îبp;¾›¥}A>@¡%ÃœðÈ,”ЈV塨š¶)\(Ôö~7'?ôë=Žž]‹ß˜u‹üTsã±h^?Üwç8R>ÖâÎÖ¡¸¤MhªoØÌReâ˜0 @ŠŠ ¸ç‘?á+.ãUV~q,Å ï\Ô×v{éÌe£²˜QW²°´ÊªFü¼ö$žzd »T$9F‹£ƒî¹c, ŠªqìD>ìiGЈa!ðörÂ¥  ¼¢«þwL± õDsðS¯oé¹9ý[2Ìj醫‡s¶3)NÏÛ¯ÍåØÉã¸dÁ\·¬Ͼ¸Y9í¯Sù·¤ÿ¤JMkû]ìë‹[IaÈèÙ—¶ Ž”êÔÔ¤y­žg鹓‡7®þ^Áb£µáä­ëp`åz»iª¯E¹öR§Š-vŒ”+LÑbïä Ï°h”¦Q/bÕóÄ?ÔP²°Æ OEƈ …D0) Žjõ1a&OÉ9²WCÉÂé÷–)‹˜¢Å•\”ùÆ D1Y쨓¥õÕÛ2ç<ˆ”ŒÊ³S5”,,­¡ª'~]…)¾È.ÉÅG$2ÿ8Ùu矹êúîši¼n‹‘±j;ê DkñŽ6¶§µªNÌÕÝá¯ÿË-Ìžoì ä‘Å ]\iê«ëÚ¬ó´KÜXÀƒMk§Ë×–Ögílù_Æ€ÚÅCz=ØþS.ôá–ûµÖÑÑÉóA&æf*ŒüÝϹ6”ÇÙ¨¯mÆÎ_ ål£¥õu¤'r 5e‰/Æ·º ŠßT@Ê'¥’–§1ÅÂS_ö×iȆžc:šf-ó‡/ ú˜bí×4-!ÞˆQçlB%{oÛc O1ÃœIy ý>n^mœÂÄÙ͆+úXûlý•äµ ó õ1Ð}ÒaJB¶§œ\ íûÝxëÜ®Xÿ²ë[;r?tÉ]}PÎ6Ô¯ 7k6ˆî wo{LZÄÔoúÖøø&†°²V^¹KÊK«Aíz¿øÆP$K³rR§è!Î0FRTžÜ_®ž¥xÞ•ó¯È ‰]±~L`¯Ó‹š#¿°”É®’8ÐýjçÙzÚÜz¢\âDÞJ*¹»/fÒ1ã°Ï÷Ukcû$ÿ»³Œ+Zí{a)¤þ=t¦[èŒXI±¹þDûqÕü[ÝI2)Ñ®]%Ê!RÍøO&ç«=dÌ‹ €@@ p#`”¢¥;cÔ§w íü±Åñ„dƒJy EÅåÈÌÊCxX0\œPSkÄ6'¹r™ßÌ—p·a[+±•ühC“¢]x_zÙ`7æɺ7OcÚé‰eöžü‡“~"—6pw ÀȘ¥µC£¡ < »Oj 2­1Æ«¯¹%%ZîtÚiØß¿U8×N9s²'„Y01Zúùa×^é!ÉP[LÅ,V>&wKýbý°à⾸ˆ,MØËêá#9XûG¢¡êåùz»ðúÉg•1L>kØíƒJÑâh‹»Rñæö¨,Wœœìðò³3Èš-K/„~M x:†…íæàgZ•Íéß’ù»xV |}¤WÌBäÕïDJj1œìyÌ–«ÈʉÅ÷yåùY¸íÞµVÇÏ’þ ŠjH±Ö¶KR¶nb%e[5Å êLbî¾ô‘­á[nYfª†µŠÜNen›pËÁM×JG.gcYÆYÅfJÓ’¸¢…¹&Ó&·€žT’š¤Å¯kŠ Q_UÎ-bÜCt-–ÖWìÔ„DgoiLúø/=kX±U[Öú»E?ºÌ:&}×&Þ›jÛWvëTê¤kñ_Jk‡)µ©Rß宯Œ¥õk«ZH»j‡Oóã]dœÒüèë×é}¸ãÑ•ƒ›bJ–U/§PÐný÷nKëGÅyà¹ÕUý³{‰3Å?‘Ÿ/²Rª±þ“Ž³î±'A»Om‹îdbÊ­©dÅÄhËwÙ:Š Gg0%^{ñ]´ÙfV%×=ÅŸEî*Ʊí ýXs® àý±í۾ׯXÓîÏâO„iî/§ÝäÍÒhêŠõO¯*œÿñ;‹ñýÛÙ*˧,ÜüBb†x`ê’`ìø©¨Ã}Fƒ¤Uð÷ϲpË‹}J»îïy'›¾ÉEY}98‘`x¼'f^¿CuüŸmí[¤uåük ÍäË®X?&3ÙIÌ•_XÊ^WÉ?˜ë0òTMîÃj¸b„cY¸0²§{I{”BqÈd$êeSÉ‹IYµ±öý¸RD÷K½üÌ~Ž`1c˜â毓í?wÓ÷’ãpz¬6%êþ`Öè&ñ:âŸ@@ èGÀ°Ô§µÞº?uwhêo²ssÆ“0¦,).i—ŒÌYFV>W´øûy!=³ã^šäþÌ=z;÷»Küáåb‹TzYxyCÛ®íöÚü3¡ŠL<][NN³ ß”Ûk«§å×5V}•Uç ³ð Ý›0"f &¼{N}iu«–K/îV0mÜš‚¡qAÈ+¨âÂfc™c++¿ˆÇýwÃ7†#).ªÉNùÍ÷v³ÍÚFl磆e!Jƒ¿Ï2C©äælõd©B<®þñ¸JÉÂòëÈÞ‡ŸÄÊ÷Á•”úúQÌ–|¹ªâÑ\ü3#ÑÜþÍ?¦Tc”’Z‚ûû“c&³”R‚' ðÚ ³J®Äæ_Ô¿¬5l h*ÿÖî_æ½³L™°ž‚¥ë#uw\JeX|%b–*ê`-MÊŠ©Òô$l½®\ww0 dÏÈ=$ }&ÍV±ª~"û±—˪çÉiæÖWoËœsYÖÒ¨<öæ&åy‘û*¡˜$,NŽgï(L¡X5¹³/AÁ©#(#CYZ2*rHQÖ‘? 2#f­Å¿¾õËØj! ™¢…})#PSÑ„/×ÿÛÚÐN°bKë3®ü{ÛcÈä6eêÜ›BqúP¿·*sm½TÕ‘Å­pt¶åÚZ„¿(~Œ!% +hi}¦Èò øÚÄb|ìÿ«›¿+ÔÙ­¯]Ö’ë\r­µf¥î¦ï\ùP¤%Më¯KÒµ%÷†qWUµdAbxS‹þ†4s\i“Ø­/Fs… sõÿ³4 è¹ Š Í yîº3MR*dœ©ÂoHøÅwÃÜÃÞÏ}G8ãÌáöŽ¬Ó®Xÿ¹iµØú=)Wèùuë÷E*% ㇹ<[»2 }0¬«lÖÏ)ÇŒ «ßÄÜ…ýüß4n功‹QuË澉žß™içoyh/¾QWÏ¿Šq3Oºbý˜Éj‡V³D~a)c]%ÿ [§ŸT¢‘#Ì•õté™RÎ34¶Æ&ý/Ù,ÏΡm|4Ô‚”·p°äJyjµQÞLó[¸Œ)Ò×/. Äâ!58’]‹Ô¢&$Ó'£¤å¼sÛ>ª¢„@@ 0ÿÆëê‚]·íf6¹¼«Kçï3†?V†äÁxçr?„ÓK €öÀO…0eGÁÆÓ Øœ˜Å›Ûçù\.>é{®hqqô‚¿GY¶¤œÏÃÅÖ¿Syœsܤ1Ë&L‰òá}ý¿£Ý¸ÓIÅ`}”’ZÊcÕØ‘BÇßÏU_1Uº%ø©±àÄ’þM??_›…±ûŪÃJy‡Žäâ@|6¹]ìIãÂÛU´˜ÂGô/óÝÙG£„YoœÄ‚Ø+²WlÄø™dõ2S-Å´SKë›Ö›K“„lë+bêc¯Â'¢/¹WÅ?rµåÅHÚ´'~úÍÝÐu“ðõhþe {ø‘ݯ-qÓei}ߢÛC¸+³j‰âÉw©šéøÍíïD·þ”cøøÉTÞŒ=ž?³j0\È¢„í„oOÉÂ*YZŸ êy¿ÍzĄ̊­4®oKÇÎê×V“`눮= ¬ã6K†Û#j°g-)6š­Ð•#m»íåhRZ8£¼¸Ÿ>›‚úZýBDuì.YÆ×_ÒÑr£ø¦P]u32%¿UÙ)õ{±?·ºèúR´÷Ìßë?“vg&ênÈ9Û@ϯ$h%E §_÷|mß»¾ ‰+1r–7üC¸Ò(õD%·›sªË±ãgýÏèòþZ„Wù!6À£ú¸ðËcTB÷¥µäÊð rk&\‡I˜ˆÿ€@Àºç›1œ·–a¾m›\Uj¢¹5 ³ì×Pٮȣp xc±/ú:¡‚Ü%ÜûS>ò+{IQç—Ý<Չ햺P©¼¦ÍrÉÅQòlm,Ž???KñF”Ú¯¯§Àt èÛ·/Ü:Ø9JÆóàþˆŠlÈ—ÿmÝi“¡+½+ÓØÚo$g·LÑÂ>ƹøÓ¶1eÌíßÔù‹óT±sŒ,Wôѱ„<®h 4Îu•±üwTÿúÆ!Ò;ìû‘ux¯Á O×›oi}½ ·›ÑzslÝ‘¨]\¶ÆÑNW¿®ÊËÂï_ Á#4t )\b)žN$Üüƒáìé‹!—ß„@Š³ñ™;º¥uKOç_}.ĹyÄ—b)°àÛ¿­ÈÆ´ËHX@–½ÉíÓI“¬ Ìã ­ÛÉ¿÷÷|r;J1cü±ùÛ|T–’æÃH2§>Ôg%¶^3²ûSÌFÍ¥YÎ ­Ëº—¿£n¢ž;Špãóè㊚Ê&|üT’QJ2ÖÜÐ)nÜE³LúmE–žŒKf £ÍßåâŠ#ѧ¿;úrÁéxÛòºÓú×%ÝžšÙó«-ìì{~Õ¨ßI%ùÍP!ìšžøLrÅ·ñÛlÔUþþvõü[ S·]?–Ì„úÖ’_˜Ð¥bÑ Uþ1¤da²£])Æß˲ÊZ(žoyB±Ãè>ŽèK¿ù‘¾"—‘>®v¸qœ†“ç.²¸ÓÆVqD¢@@  Ç+ZáädüK›s''É5@=ÕínÄÌKŸŸïÅwÔ‘¹õC¿ä“ù¦á‡S6Y‡¢GNć){œ9ß.v¶ðŒác,(g±zt.ÎSÃP‚װοwÞy_~õ5ðÍ7«Ð)JtÓÍ·pEKHH~ûõrÍeÚÚUj“¥ÉBmCæɲ°°ÅÀp¦x&?46„Ѧm)5<”,[|qýÕCðùª#úº·ZºÞ©1´°­Ð»µð3—kõoÎüÙ«½¸7Ò˼>’ݺÉþêÕËY¿5úWçEœw­¿)…I'qæMgÀÒú¦÷¨Q£±5~Š“G›‚Y½€¾tõ2üœÆ‘w<žä<_ »ú.DOŸÀC<|rÛQFÉu;ýØÓùïtÀΟYœˆÅw„ñÅo*DaV# Mó1b†í¢w €ð~ؼºsqïZSÌc‡°Ø%S©ÿõŸêß 4–ÖWj³;§é}~"¦ågCf¥£.¿/B_–Qé¬ÿ«CìPOÔ“ ¸ÏžMF~«ëœöp Gá…·…ób»×Òæ2#ëj7~s9)êêàì„9dÕr:>YoqKÖ¿üü£·qÊŠ´ç)e䊧Ê…¡¡6»{ÞÜáLqB ³jIijØõuWÏ¿¥XZ²~,í»»Ô7W~a)ÿ²üC;†ÿüA’Û° §È}™šÇaõrúΙ%žß³ Åfówë…;'“ËèAÜRf¹vd;‚€@ }ºïÖ˜öyç%ÊÊ+àåé{ãuF~’0¥¬¼ÒÈ^:¯Øc³=0£¯;|öøš|œÈ5îNYÕÜÛ‡JSæ×·5¯¤5ð™r©ž—êäàÛçþÀ?ÁÞÀ\†ÉT[oø_.gÊñè1ŠBÔ@naN:¥Xµ‘üÿËy999(*’ÌèyISlP-±Šâ¨0òò’v³¨e©Nå¼²2Ú*ª‡îºeB‚ÜQ^Q(®ÉßþÃK.»|ö“‚ãê©jQ²œÞÕ…¶C*›«®ßtõb®¬ÝÞ^Êîílmx¼V§¦V÷!ÑZø©ódʹµú7gþÔÉ÷Q³nÑæ?2\úªž—ËX¿5ú—ùÇ®A ¾²œwlïܾ[>%-­¯Ô¦)ieY©¼xàÀapp“^TÕ뇟®~iÒ9s%·ç¿/¢º8Ÿ×ó‰êoR}c 7ÕJ;µ\uygõ\%×@ì¼±Æð®nVFLá__ÿ6äXÜÖQúmnª×ÿQïWœw.ãæz!(Â…¬VZ°a•´VË ›±{­d <}i0ܽ;÷•Y°ü³Ur©4nÚšÖ¿¥õ;wÌï­–Ü 3róR~~RÏcñfÔ©©á 2k ~äöÕë)/¹/C&ùr7W_½ŒôÓÆ×g\Eñ(ýÀøÛøi 5%^XZ ½>1«Fá}ÝÈZÇ…Ÿ+ý³dý××HÚ+g7ýî~³x â&¶ýË|xÚ" Ìnz¾_¶ôzkO1N17z=Bc0æ¢ÎêúÏÈu;lwåü×ÓîFÞÊßwŸ¶ye D%²dý(µ×ÓÌ•_(•^ÙŒ¦óEþáæ¤AR”è–2-¥°ê^þ«dȨo òwÄ´VEi€@@ pa  ü«ÞƒÆžSæ,:2Ô(®méîÙuõ (.–„CFUì„BwNrÅ%ä›í*xþ÷ìO—nlÆt˜/ù%žÕÏJ›ÿcümЇ1:S¨ù¢eLûݹLu]1jê%¨ýÔ㠛ŇÐÐT‹’ÊL« §°PÚáyûm·“Ë°`Œ;³f*ó`oo{î^___,[¶ ¡¡!œÂBý¾™e49ERÚLŸ ¥]Ñä ,¼·ä"Šΰ¢%rÚ<Œ¹ý1 ZrƒrÏd)¢ ¯n]©\ÚäT?¿˜¤TÑuíǬhµ47£"'Ÿ«ÿ³ÿ>}bàä-ÅöRo?pÈhº/I›UyÙêYâ¼ àäbƒ‹¯—ž¡w¯ÉÓˆ³åE`‚v˜þâ‚:Ûí?òx,ø¤Kt×V{ YZ¿½ö»C~V²tÿ:É6 h1CUJ˜œMå³\zã¶DƒŸ£;¥çKCc{£?ÆÍ s;÷Ý)FŸgmúÛqË%vþûçYíº˜b匥C[ÊQœ#™Yµ(‘¥ë?‚Ù3b±nX|mêÓ߉[v°ô¼TMüYÚ܃ñØ'ƒpýÓìR‡b‡¹¨ž‹ó3¤w=BÝ,á’»zsžS(¶CÂ^ÃBß®žÿü iþ‚"]ÀÜiSßáÒ=•­íÂ,Ý÷rK×v=ñÚù…öxŸºÈ?†?î Ƹˆö7Ñž/òr×åë¢ûûÁ(²Ebv¹²¢a¸`°+‡2¹°,À½±4o #›åŽëÇ*+¢™Lª\o3bç‚€@À8tŸ(Œ«×mJ—¡°¨1Ñá 6¼ãž ‹‡ÅQl WgœNL¥F÷¹c,Šsä>0°«–âdnBiX øa×.'a_Ûｋ WBDO‹°1SPS,íWïÛÒúêm™s^‘†c?É«†Åï«ÿ÷7–­ÞŽÑ7=ˆ”më 6Ë܃õ»x †/»1³kŒßÆ΃(>‹GPo£øL‚Á¶ÌÉÌسÍ õ°srƤ_Ô°Ê Š…á×ÜÉ›Mß·M­nÒÔû±ÿu5˜üÐË`Š5™<ã0îÎÇù%³ê)={ZÎG-˜{OŸ ;ƒCVæÖŸuµ íyL­?H›GdÖj«Z°õ{É*`4ÅJ "×!IÌ…Tâ!isÄäÅAŠ‚lCüXZßPÛrž=íaRŸ7W¶çõt/ÿ¶ßE¹®5Žûþæ, Ü™»îr¡w™"9aÙc‘ü2?½© Ö{þ•û{±'¥Ã®ÿþ%™gê4ðPÇÀ‚5kÓÜ›‚aoß …dYsöxµÞº¬%E†v{ê×êV-a±n8FFª—±týÿ³½ ,® s“uý³}ÈÕ^Û<3ËŽeEðk‘vJÿøM’"‹)j˜ÂÊÁ©»Þ±Xrož•\­èRÍÒõÇæD}ŽØ¹lck§û›¤¸›¯e ›êŽHr5ÄÞÖ}œ¥–£|ÚÕó|WŸ?G'[ŠéÓ.îmk4*Î ³¯–”Ðg—+*-]?ʨt^*“)hËÜZ-¨ìIn¢§­ °T~¡>Ò¡½m±(ÎÌ¢…Åy`zûÊõóEþQCîâ_Xào5emÉoŸíÇ!bV%§)’¹Ñ=hj¬;Ïúý„iÞZüÜmqÙ0/ÜAÖˆ‹‡8A=Œ©=ý”Ý8ν½%¯'s”ºi€@@  €@ÛÛ€BfOI:|ä4&ŒŠ‘ÃÀÇ+‰ÉhlÔÜuâéኡ¤dñôpÃÙÔ,df[Ç4ÝZ ¦»d+];Æ죶©Â“k% ¹Ì!ò©É4Wöƺa^<À)Eõp!ßÖÑ´K‚=U“Kˆgשâ¹ÈuχãßÇ?DdÐX„ù Å¢±ÏcΈGQY›7'?8“k1Fye‰ØôÏ¿­:Ü•‚¥K—r+s~óÍ·ÈÍ‚æZ5§Žåá§ßpù%ƒ°h^Ìœ…t²Tpr¶Gdo®Ø¨®iÀËoþÍ_~´ûx€Ìj Òßûp¿Fvn^>[uËoÃÛÞ³/ñG$Á‹\ðÞ;ÆbYÓ(QX¨¾ùt‰Fּ˿áÊ9q_|6¥Ä˜Q½1ÿ¢~˜>% ™Yåp§§Ç`wü´æ$._¨Å]ž9L1LþÈÇxr7óªPŠ‡‚rªÏb±øHŒØü}ÿv:?×þgéú»ä®PRŽøj7˯ý)¶úf‰O->B.‹ƒÅZYp«´©àðÖ"d%µ/˜íÊùg£(-hƆ¯³0ï¦0 ¢ ßÏ}çRúþ8Ð÷Ç“‚3ª«nš²ù¹ú?k¬õöºâüមÕ_Òk÷N¿¿Ü.)šä¼©ïf¢^íµÕRù…Ü.;ºÑšW'7µMwêéêçç‹ü#© ž´æÖÜJ±yëiÃl/ÉoHg‰w¶£Yá÷ƒa1‹¬æXù&Ú8÷—‚2—•ÑG¿©!o*¡ÍOÒfŠ‡fœCYM—ùòخ՜æ`ZMkü}-‰t€@@ PGà¼P´4Re÷Þ£28‘¡ "+—2TUUÓÎRŠÛàIŠ{B/øÇ’–¡»£V”žzþŸUH-iÄMã¼ù sY·0b7ÞÝ)Õxo{9rÊõÜ¥{ê [ùnjiÄW›nÄ”¸»0*v)\½ádÅsk(&Ë‘”_±íØVµfa·ðP]©÷Úëo`Ó¦M­\)¶ln˯«×ó¶¢\Õ`ꇟÅÓÚ.Ã5Wá–!Hþ‘›Èä—¹{úb®0¥‰6Íš‰©“"xòŠO( ÒY{Ó&E‚YÌ<úÀ$Ür÷o¨ªnÔnÊìk¶óíùW·cùm£qñ¬X.àg‚ÿÚº&|µú6oO1¨ha¿»bΦ•âªËãàçŠÐ`IÁÆ,×âçPÌ™dÍ"¹(SbÔ\ü”Ú2'ÍÜþ­1 ÿWÞÚ‰£Ç󸲎¹™c 2FÌâäÀ¡l|öõ!ÂW×íš41œg¶Ò÷nAüï ®Œ”? d=þÏaÛ«bÜ]O"dèXUO5%\É’¹w›*Mœtæ߃t—’g÷ZeF#=¦l\•M»½#Ño¤}\ÈÊDrWÕ£H>R‹ì³ÕrÅÔ%AœÏ&?,­ßc´´u³òu˜µ,˜¬œÀä2“Ðxå“É(ÉS“ŽÊ™À‘)76¯ÎÁUD¡w´+ Ó]‘°Orge­õÿ÷/¥(+hä.ø˜e‘w€¤° åú³™Û4׀ؓ5É9’ð4ÔT¢:ŸNì-Z>6øþæP>‰þš‡)æ˹˜Ë¶PêוôĤcD%=:æÑ°sA€@@ `ç¢E}ø,ðý9º;t§X,êü‰s€@@ º7ѳaÂò§¹²à‡ç ¾R¿eœ©#é¿ð*Æ”z«—MáJSꈲÀ……‹gòØ'¸û©äcøè1ý â 1Z€@@ p~ p÷7\GîæKȽݢ•¹äÅäü—…@@ è霮ÃôMB³>g–ú*ˆt€@@ .H"§Íƒ“Z wò¹FqWB3cÇ#/á°U•,¬Ñ²´dœÙø«IxŸqNLÂK\ˆÔמ#—S¸î©ÄþáÓÝñÏ6Ó¬ /DÜĘ@OA ŽÜ f—5âÏ“BÉÒS&Mð)\œ×Š– bÅ €@@ °‹–Á'¢¯b;U…9سâ%ÅÁAnðötâë.+§‚¯CSÐêéãwôô†«_pîª ²ÑPUiÊð{|ÙÐ1“1í‘×`cg‡´½[°óͧzÔ˜z:ÿ= lf¼}àâ„sÍM¨ÊÏFcMµB©ŽKr ³‡ëjP•›‰æÆ ëÊÍËÞvìç %yM¨©ìYÂO?[xúÚ¡‰ž‹²ÐP×qkE´,mX*¿hkɼ3!ÿÐÄmÁ`WžUÚ€cÙÖ»´&âJ t.BÑÒ¹xìͦpåg\=Ê‹”$mSSO/‹[+ñÁŽ ×Л¯š;À7OðB˜·ƒªT3½#ï>[…÷·—#“”.ç#EÇÕÓ?lwh)9»±zÇÝí–³V0wa;wíDjj*ÂÃÛvxŸ8~ÂZݨڙ== ×^5½Céªù³Æø{õê…%‹úóùó#%™L ¤%Þ¾+ Ÿ|y%¥µr²â±«Æ¯ÈŒ‰Á#ÆcøÕwÂ7ª[m’VæŸ>†Vý…t¼(lÔd®dac 3  µÁ¥¶V¼oì \üòÇz[ýáÆ9f é;‹½Œ[9Ã50—¼ÿ#oõÏ'oEIÊ)«õ0ò¦ÐîR“Ú[÷е¨ÈJÕ©Ã\×Ýï>±ª¼s-´YàØúò=”gœU¥«ŸLzðô?v`ç[ºJ=GO\þé¼ÊæîEþ‰ÃêÕ¥sZ£ý\…A‹¯†‹O€*¿¹¡i{6ã0}ëJKÌø;X@IDATTéyòÔ—ýááçÈ»Øú}6®*4Ø]Ì0gÜúR_ƒeXfY~^»%Qo¹þ£\pñM¡è- fXA¦lI;Yß?Ë¡£²Æbîþ˜zyˆÞvÕ3Žþ]ŒïÞÈR%-º#ª®9yçî“ÈO×U~ ™ì†‹¯E@˜³ª¦l9¹¿ë?ÎFI¾²éêÇ{cÈdã,Œß¸å„ÞväNM?¹ž|4§þÒB0r–?’—á³çÒå¦Ú=Z¿„½%Xõr¦NŸ®´qìÙoãxú'OAÊ1ÃÏ: ˆ€@ Sˆò³ÁË ýT2„Ô¢\÷uA»}[C~Ñn'íè ù‡½-°íþÞ*Îný6§ó5å,ÍrÇ¢!ž¼Ì xeƒæ{ìã³Ý±0ÎÓkðàÏÖ}Æp$QÒ̾î¼ïõ ÿþ¯BœÚ¤ùŒ.E€ÄPxqfö“nˆ $/¬l‚§“-Üœl0oÆôqÁ­ßæ!¯RYÙÂ|p2óPFu -8[܇^ˆðuÄ”7Œ sÁ]ßçâLæC¯ÐÃÿÙØØÁ–>íQ¯^ç-oö¬Ùxë­78K555¸âÊ«øydd$þøãOìÝ··=vMÊ¿ýƸr‰ô2[G,é™epv¶GxoOLŽ¡C‚ðð“tÖºrêLΛƒ{îGzúl%[[ã0ü‰˜33†×ji!átaœìáE–S&F`ÌÈÞxþÕm8x8GnZçhnÿ¶v6°£O{dÃÞ&:ˆºrþ,?“£?óY1LŠäè0KªÂ¢jxx8ÂÍÕsfDcä°Üûèï›HywzWŽßS{ÑewÇãRSÌ’¥(6¶¶\h8`(.zi%¶¿ù8²öÿmîºué{¶ rÒØ99#eûï¢da0峚±6uÿÖæÛP{*œØ—ÕŠÔËÆÆä9`ó¦Mýæ_1·<¬J®-+¢víáèæ‰ÐaãøÚPlü×Ý(NJP•Q´òÀ¾oúÈàø‰ŸÉ½„ˆ‰³xõæÆÔ”ÀÑÝ.6!CÇ€)©ª òôua•t¿P{ø9©Úê;£]E ƒÓÎNSU#­'6¶úËŒŸï…%÷Fð’L¹RVPO¿_½àéç€Hzþ\þ–;¾~1'öêþ~Û?kœ¦JƒØ#™1¼kTR¸˜ºÄ o ç9Œÿ zþu ggg7; ™èƒèÁîxÿÁDåèZ÷²ûºÑ<°Á sæO½9së3\Ù ͱz?ò¹5ð—ñ3Ô·Œo;ðÉl‰£@@ ÐÉ,ŠsÄÃ3üáH±0ZÚ¿¬@a ž›–ÿª—Óº:å±z+™ÑÕógéøçÎŽQ)Y¾ùþ(Vÿxœ»{cï “Æ‡ã1š?æÊîaZ#=·Y•®¿C&&¸ø`ôÍòZ9G÷cï/¡¦HÚèÉ¿Ÿˆ¾˜°üiürô šê4ׯ‰Ýuûâ¹Göã‡gÃÎÑõ•š»÷¬É|iZ"~»ûr& ç8k$šxÑYü›ÈV·,~ü§/ø‡d-#36~:F^{7Zš±öþer²êX]˜«:g'ÌâfÔð4f½²oÅË*…†OÌ@Lyø%¸†bâýÿºû®³r±&EÏ\¨R²ýñs$üò%šëë¹%VØØ©˜xßspööǸ;ŸÂ–î³f×:mÅ •¬IÒNU"b€;ÂúºÁѹêkõß³ÓOÖâõ[ÛPC'{ââzó¶ÕӛɺC‰¼üm±èÎ><ëÌ?åøáí ”J÷º€p{\ûd$B"]°ô$9©——̤*¬~=]© UZ]æ=tËwس®X•ÏNOðÀü›Ã¸ë¯ßyR#]”äiZ³øÛa•gt:¾ ?¼“IŠ©Ÿ¾d%~íÑpõ´Çe÷†áã'Sy9õkVfcÃ*ý ´ |1ù’ 0ÞÛs£fÎü©óbi}õ¶Œ9·þÆô#ÊÝÚ‡'æx⢜ÁÝ)ÕȯlÄeÃÚ< âÜRù…¡¶Éëò³EõèèÄå8+v¶)Z‡Ø—d7{S«1>²ÍRÔ˜qY£Ì‚87ÞLÎœ.z\æ†ÆU²0@X•CCýSS”o¬:ƒ«0ÚÅÔ——jàÏ梶Dz^a÷cõ¹‘Ï[š¤M2ë“/âÖ_ ÕôýyL¥daù%É'±û½çyQÏ>ðë+Ý+x‚•þõŸ·”·”ºsŽ}·RR²°â?sßvøìž2l,˜Rµ#)v¸dÕ|jJɪĖ¬J"µ¹ÂR꛼›¡0«Qõ©,kSD¨§³x+J7Éö´‹¹¦¢ _½¦R²°²dÉr–»cÊŠ¾#ô ‹i×®zJç•%šJ²*rg«]®²DâŸÝ?´óØ5…îÑ áÓ¼8NµUMäº*]¥da…ήźO2yù¾ôœíî­ûÚÃxRꇥÕV5côl?^óêlÔUkòÏ3Ôþ™3jÕai}õ¶Œ9·þÆô#ÊÝGfIJæfü?Û‹ðȯ%(¯5ü;§>Kåêm™sÞäžÎ6ØCʶ¡µo@Û=fjŒtïf²™Î¦ ’—Þ·ÖŸnÃ:ÑŸ@@ 8ÿ$î4§n®HÛÏ.ÎŽh¡•¤É/,E£ÖË}w™~æC36@òǽñ´² wÛ™z%‹ÌÓÓO=‰-[6Ë—V;ÆFK‚€­¤¨` mJJ)¡ø&åÜ*$6ÆGŽ· #½<1 ¯T?ÊääViWç×CÀÕÅž6?¢¹#Ù\…1W_/¿± §%!›b# ‰,KP Ïùá—¶]¹êE ‹j°„øó/ꇱäBì«ÕGÕ³aIÿ¬!YÑÀ,Zº‚ºzþ,?séÃaÛöwª"|;v§ã‘û&ñ¼è(Ð|ª“%ãWo‡÷uLj¡!ðw¡ßÿsȦ¸De£´¬ã^tÜh·=£¢3 ŠÖ*UyYÈ9 òmï¬+¨ô ‚[@0WL%‡ƒ«ÂHyÃvñ7Ö×!Ÿê²tcˆY„P¬WŠ3ÑDØrŠ…‘sh7)%$ ±öÚpCа1põ ä–•y™È9¼ue¥z«²úà̲§4-Io]í Æðбpõ äYU9¼Yx¯]Þ×–òÏ‚§{õŽl—ö<’{x¯Ár–ÌŸ­ƒ=BGO¥'1¼â”“ȉßÝa®Û Ä„Lï>ѼtþÉ#hªÕµöb±j«àà쯈«Æ:²¥8jÌÚŒQê®Mü¨ý/sïàîgx²7••­Õ´ËY|M›b†H»ŠÓNÖ (²Š‚Ò;ráûéxÍßL‹ûRkÀ7XzþÌ8S¥h­ÂÜm%-‡‡·=œ\õ»gSk²SOƒ"$aÖÙŠüŸŽo2†;¢²XaêÌÏ¿9ˆÆl‡ÂÌZìü­D=K÷ÜÒù³´¾.G"E DÀ‘”ùùxf}!Žç˜öm ù…AæŒÈìò w{|¾· ÓÉ•¹;Óê"yj¬+ÊÈ2»¬}\[Z¥7~®½¨GR¬Þ rIv ½N'î‹°`Á`gÚØ‘Üþó?Ý~jKò$x8ÒýUÕŸCb~Žf7ŸwžPŒÁP”– p^)Z<Ü]1h@ü|uÍ]›i«FZFÎ$e ©¹ýž% šS÷¹õ’àû„‚ÿhÖs#ÆDÀìFh§ðžëN±\Óî;}T\ÝLŠÐ ´m·…¾²=-½W«ë°sçŒß…cí1Æ ŽSÅdQo{õwÿCqQ1î½÷nøúú`ïžÝ\ÌÊ>|÷ÞwŸzq³Î™¥£R–Çâµ°˜êTU݈›®Á…å™Ù¸ý¾µ`ÌÕ‰)YÞ~u.iýÉW‡ ­ha‚ìw?܇ÊVw_êuÛ;ðo<§f”é-ž–QÎóüüÚÊË…-韵¡RÔu‘¢¥«çÏÒñ¿üæß|*NI–sò¼ÈÇÚéÌ€ÌzI)Ž%ã—ûpq¶ÃwÇŒ)Q¼9Y̘ï~:†¯¿;ª¨ˆT/kÎy Åt`ää%)œ”ÚØòü=JÉ<­ïEK( øåÈ?uÌÓ”G^æBeõ i$ìÝóÞ¿¸‡zº|Îâ¡Œ¹íQDO›'-gБY ìýè5dìÞ¢–ªyjçìL®‘žä±U´d1+Nüú5Ž}ÿ©¢ÐÞ;²/f<õ¶fƒ­WÉ[×aï_RÌSOäüSŒ›è)´£€-5b'~[…£dmÐh)ÿác§aÔ ÷«q¬|Ê\i}{…¤pÔ.aéüy†GcÆÓoÁÍ?D£é"²Ùcþ•:ùÂÁYÚuÙPÝ&×faã3wq«±*-·cÚå̹þûgyµ¢ÄcŠÕ¹±Ö0U¬Å’–%G:pW,€{Fb-Ã+1|ª/b†1åKÛæËzÑ­ÝÜ(m0p#EŠ>Zù„²]_ùÎLwt‘ži™õ‰ÕVµ=Êe•Êi§…÷wĨْÓoeêXÒh—·tþ,­¯Í¸í!°7µol.'¡¾th¯¼v¾¥ò íöL½îò'RF7Ý»gösÃG»ªégƒ0o¬!wîÞ®íË]˜EÑÄ({¼²0P#NÎrä„ ¼²¡Mm·2ƒ0±'èyƒÙsÛ€KH†dˆB<™‹y?Õ¦_í²l£î3닸‡íaA<(-¤DIJÎ@vn!ªªk)@º ¼½ÝB‚äÞô£ÝÍ ¨¬ê¸ÝÊPëOe7À§ ï6ˆ%STYô”Qªû2)çzL’-´dXúëA9²ë0Ù¢ÅÍÉÑ!áæäƒÚ†J¤åíGIUV‡Žèæ›oÖiŸ)Y^ýuž>mÚTÄÅ æñZä‚‘‘‘ò©EG9¸°!=—…ÞS§&zr{íí]Xñ΄…zàº+‡à³Uÿ¨Š0k‘‡îÈeŸ'IþýϺV'¶¤¨Ê›z” 2±€©ú6ÞÛ·«olÔ]ÿ–ôÏú¶mPØÒÊ‹·3F†—§3ýVÔ“Pž^K™wKŽ]=–Œ¿ž”r[õX²È˜°8Aò²Ë"ež6Y2~Ökû…§§c8Y²0:yº>p&åË°!Á öÀõˆqË%æÚÌÚTxæoÒ7ª?‚Éš¤=«}ýÛRðïI÷?ò ²B¡X/,xØèIð ‹FÄø™¨--Fü§ÿÖ­NL¢`Þa£&)EÎîøÅ©‰þ&B†Œæy…d=S@Bgf}7AazÅ­´ w­¤Ý@S]YÎœÕHvõ SEÄÿŒgÞAàÀá¼8S8&ž³6>Á}0äò›ÈB§ ?}iT“¦²”ÿúÊrñ«÷ß.ÎS’Í|æm² "=T 2îDÉÙD²ŒrGääÙ²T÷Þ¤Î_ן·Þ“ <À”¦žé6™¥WúÎÛöb/ìG†¨"'Ã`YK2c‡I›2+É’Ü~¯æÍS|w›vヘÛwÚÉjL]BրѮ0Ú§vŸçccÆ$ß?Œ)ktšîK—‡ñi?Aqµ‰¥ógi}£Ç& V~O ›™d ù…™]«ªµ>=(zó u†üƒ´?VÉ1n\É29Jò4²íL ¹l—¬Fe~Ô­°§úÿšë“yu8”YGzçãŠ>>˜7ÈEäS=þ‹zÚçÃÃìB®>­?aøÞÅð{ã?Äø“z;˜^M8Ï@²Ôὡ¼»$K?ËUÅÿå‹€@@  óBÑÒ;$CÇ’k˜J:r µµm Ìz¥°¨Œ‚}IèÖãÆÄaçîPWoX¹¡µ.ȸ¼ÕowRa=ε ¦ ±âN÷u]–KË7sCuzjžM/i)Ÿ#×aC"bñ¸IxÞ¶¼™ðéÀ™ï°áÐëô a~¦b‘œœŒ3¦iT³µi3?ºãÎ;qÇwЋ»üX¤¥¦i”·æ…»›=j)x;S¤´GgÓJñå·ÿà¶FâÊ%qض3 ,ÑõˆpL}}3^{g ò HÃÚëH!?/¿ÍUYÜÀ@ìÏV(Er)Qº«ÅŠF$2?øŒXŒ–ÙÓ£ÈÍÕD Ë‹óšõ§±âÓƒ*k$#šµ¨HgÎ_Gÿ’ý9lM¥¦ë·ZRÌ”ñO®R²¼»b/ÖýÙ&”µ³µÁ£÷OÀ¬éѸŠÖöo4Öv#–}ào”礃Řþø8µî;$oYÇãS¨©½sïˆXœþóGþò?ª¢GW„I¿LŠ–è7çRÿáSÔWHÖ]r!÷…)YXðMÿw/ É“L§Ö|‹ñw?˜ 1öÖGðËÁ]:V!,à·¬dÙ·òu$møE®ÎcgŒ»çYDO‹¸K¯Ç™?Ðq#ÆÜš­½o™ª;™ñÜ{f\<šÞ¤ ’•,̺@]ð}ØÖ“}ác¦bÈe7à4§¹QÓu¦FÇf\XÊÿÙ­¿ƒ}”ȯ_.zñCž•´e­R·Ç’ù‹œ6Ÿ+YXã;Þz ™{·©ú9þãg˜ùì{ªkqb:r —Òô$R‚j*MoMØáÒÔ”c’eO>ÅG©.oäV.ÑC\p|wÛ½R+¦çœÜ_Å]cù‡9ãúçb±ë×\ìßPŠ"Ú¡{¡Ò Fn`Z°veŽQ0X:–Ö7ŠIQH t"æÈ/,e¯+äî¤WÙšXÃ-#0Ž6HT’Û®øŒ&LÕ¿éH~¥ì„ï—ñ8½òøWîª"KL¤MWŽðÆWû«Qm„èjÁ`iÓ³DIÈÕÝœ(·ÏŽ}m¸’…?µ6Çfç2 ¯ÀWÃÏÍ#Âì±ûì…û\ c"Ž€@ÀÚ$ÑJ/œ;Ù@n×fmزqdÉÂ,Tö8nÐ-Xn~1ŸÄ¸Ñq$´Fü?§º–y#{nÇw3°â_PchÉ0'<2ËŸ¬8špê<U[W8n YƆvZ3²³uÄÜQO¡¢&iùñ¤l±Gt0Å+ —±ý®AM})vÿ¨CXû`ÅðÇ%—,Vµå•K1úÿÙ;ø¨ŠíÿHｇ„„ÞHïMTlØ°ë_åé³?±‹½WôYŸíÙ˳‚ JQé½·!¤Þ{øÏÌæn¶&›lBvá7|–{ïÔ3ß¹[2çžs† Å•W]…²²2¼òÊ+ú²ö<™5³nŸ;Rl(W`î¿ /ßÜï½éøÒReÌð8ôí! £ñÏýŠn Á¸ä‚ªê»m–bÖ]»˜ögëuºˆ¡!7ß»áú«cÛŽ,H+ Ã4x`”PvVYk75,j“s-F‰§‡þyóC¤ ;veCZÑ ƒà /\pnWâÓ¯,»—iA:9Ùëמó’3'wW3ûìëí6ajéüGˆWýî?k¤d‘™µÂJé­ÿlÀ”‰Ý”òLʳìÏÃ6Éak%iI¹ò¹û0íÉÃ;0ý…B@¾ ÒR¶nRV.BYVó›u'D”g©X1LRy²õÓ7•¢EZ¸„õ€c›„²Ä %Œž¢®2¶­5R²¨LñWœt¹%-Òâ!´{_ä%[¥Å E‡L¹"ßPÉ"óäÜ6ôªré%Ý&Ef¤‘uìMÕ¥ÅØòÙ¿…‹³R³¾åø;…‹T´¸yù PX÷äÚgï'¥½Oh8&Þ÷¼²LÊÚ%\.Z²F’Ø»~QýÏPó9¾o»‘’EfV—–`ϯ0þ®'Uþ×2Q†B¹ãÍv|ûaË· ¶|&#Q<µ*SÊŽ…ŠøÙ–²³Ç ÷aâa›öR´Èàò?usŸë)‚Å»cÒ%1ê••ZŽ« °ùäeŠJͤÐ(/̺9Êj-i1ºð?–ÝKZmÔÞ~.8ûzÝï•ße"?«ù¹Û»~ö¶ïL’H€š$Кý‹&;´¡°£ö?<„G†¿U‰‡[O`tW ˆñÞJJ”»/iÒ\Íðá:«VW>'ùæß…JÑâéÞ ý¢ÝDÌ–¦¿¼…!Ë亸§ w5ÿpFxCÜ5¹K´*Å\‰²Y(Š&/ÐýÝÝœ 2MnI€H€ľ´³CèÒ9Rlž¹bçîƒM*Y´yææáhzâã¢áãí…òŠJ­È!ÒoæSçD(·aË„;‰ålx”AÌdl7Õ&T< ¿˜ÿ×aÍžÅ!û×ýÆoĸ±cáïï¼¼<,Yòæ?ö>ûü <ûÌÓèÑC·¹Üµk¢P^ôÅÆMõ³›}ÑlLŸ~–ˆÙ*âš”àïU«ðþûïëËí=-&ÒpFºÀêÓ+ «Öê~$5Õ¯´T‘+ï-˜…^=ÂpÎôž8kr7Hk‡-Û2ðó¯û›jnWÙûoÂ3ó§¢{×P,xq¦PflCÊ¡xy¹aôˆ8\qI¤Ë³òŠ±I~È®±,5Ö+<]ñçªÃxqÁ½åŠ”áéG&+T_Ðßü°Òº§=ÓÉ^¿öšt”ž7AÝ‹­NlØ„­¥óŽÔýQ±/9×bÿEÅÕxæ¥?!Ýà¥ηXÇÞÌbt~áÝWbÐåsÑUÄqõðD°ˆ›!_g_¯bŒlû\X6h¯Y°ðèa‹AëK³Ž¡¶²\)¼ƒCÍZúEĨ¼üÃÉfe2£v&<Åçl¡º‡lEÐÒùKŠLÕ&–P†ã-ÿ+Õð²]Î+ ò±î­g°éÃW#bµÈ éEŒw/_ .. ֖OÞ°:v–n-É2ù…ÝIX•˜&-ŠLºŒ=Ó´X]k. µº†•\Ý=Ôe]u£ÛMÃry~dÕï¦Ym~í&>Sƒ{ÁÃ?@ìm7>èîãÊC #þñ„õPuE)V<}²,1,7<×Ö¤µë×ÉUwOX[¿ºZþ•lÈÛ–sÏÀ L}ä5xú©ø;kß|Ò–f­®Ó}NY|,¹"‘>iqZ"„[/ÿ”ä‹G\Û)•Ôã›W3ðÓ;™è5T|f BŸáÁJ4ùÒX¸Š§ryßúwŸts¶õÏ<«ÒÕ[ØD²Z¹ƒ ¢Ü1úœH5ú/ïE‰FÚ»~ö¶7†$@$ÐìÙ¿°WìŽÚÿz•þ·MÄXŠéŠzƒx€A&­L]Xù¯F<ˆ`-É27NâÁGk5óÏíï¯.Ö.³É›ÉþìzµÇ”ê‰'ÏÄy˱íXçÖâ x¥‰ßÖ%k—g$@$@ÆÌwlŒËþÊ×G«n:Зé$´ú¾>å¦u:úZìçâÕÙaˆAÐd´;¿ËAKž(Xº¯ìOWÍ:z.'cüŒüÝ/k)»`ŸøÑS«â¶øZâÒZ{-?¡KÞ{ïu™““‹Ÿ~úGEŸ>}pá…(Ê×_‰‰“&ãÛo¿5S´È²àà`±!\ï¿ÿ{÷îE||ç]¡bÚH·o½ôŠÙfÉå¬ëg+g©çæí­âÚDwAEAþxòNÔV4ÿd¨=óëÞŸåЮ¡Ðhì)çh ÊKjáãï†îI¾Øº¢¤±°Îª*N`Çߥêåí—ÙwÆ"IXÕŒÖ*ÏGVªe…pa^5~|Ëq^²×ù·Ä)+ÞäíEØ!üãÛšì]?{ÛÛ*'ë‘ @{°wÿÂ^Ù:zÿcÍá¬3vDê䂤ÎÞjè_lp&+ }îý!ÏÎ CO íâ£^šüùeµøY¸0ýH¸5£ë0 $@$Ð<ƒ?皯ìˆ5\\\ĨíxruÂO´L²­#&ùpö ç…¢w¤Š+êpÛwÙÈ.iùóòËÓ05á±Æ°Ú)y.QÔÕ×(E‹««îéíÖLtþüGU³={öàò9Wè»øñ§ñò+/cÉâÅÂXî¿ÿ~<÷Üsúry"ó¤’%//ÓgÌPʭ‚7àË/>Gß¾}!Ǹîúëµ¢V[£d‘ƒõ‰ÁúqepøÙ§b]è3Ûé$ëx™Q iñÉ»ªÑþûå6a]cyƒ§ÄÑw+ß;5ÂY®T´È×ÉHŽ´~-™¿»» ž|x2zt.“Jª0ï‘ßp<ÇØï°-üZ;[ú>™udÜ‘5¯ÍGdïðG¢p+¶í³·ÚE„c[V#}ËÚ&ûÎÙ·³ÉòŽ(ríèsö¥B1\C-AÞ¡ý¨7°îq÷òÆ+oíÑZy™[×Ù܇³®ŸÍt‚Š®îî˜xÿKíÚ[¹Ûûý±ÛQžcÝŠ£-¦äî té£{ uÒÅ">ŠxYJ=Eœ–“¡h1»¢´_> B¾ÀP ™„_?²Í–a?Îpž4Þ݈¿N…QºÍ"Û»~ö¶·YPV$ v$ÐVûöŠxºîœÝO§d‘{G«Rl·dN/¬ñ| O(nÖÅ=Ã=‘(¾ï£Ýâë†kG†`°PàüãëÜÓæ^{ïA¶' §W´TW×Nâ¯Ô$//ÝF{•hëhIš—>vvzš ²ºwŸ-Ì7›w¡éT,W-NK¸WétV¸XÓ‚Ì!C«Úÿ¼ív³VÒJå‘GÅ[o½‰©S¦˜)ZdžL²Ž¬kšdŸË—ým Óò¦®µMé¦Ì“5×AÒRÄZòñHî»{œŠ‡òûŠ «â¦\=g >üt›µfí–ýUƒáçë£ÇŠEóö‹Ón°±ãSeýä=öпƩx6ÒåÚCÿÔ´æÝ:Ú=ÿ†[ZûŒ³ûI«VWSƒŒíÐmâÙŠKlûqÞÓ9É{pà×o[Þ¿ö™Ð¥‹¦Þ3.V2o.×ö/úÆL~Ï€@§P´øGÇaü=O)·gÉü„}¿|e6‹ö®ŸÖ©µõkê‡Ö¶CÚغ"Ö‘«›;Êó³QYاE­q1NÔ}çˆ0TÄDªÀò§îFÑÑC¦µÚü:¡¯7ÜE [™ª*Íýk¹¸º¨òîI¢F†ªw2ÿ“:Ïä­E:5‘]t9'süæÆÒ¾?š«×T¹?…soŒWUVÿ,njpùÒT­ÌÞõ³·½&$@$ÐQZ»a¯¼Ú_´MýÌÑ~h?uíÓÛKþg÷Ó=°ñÛ^á¾Ìü§D“bKåÔ&ø^¾ÝÃqá~0w\€è7@YÊŒ®5¥Å @óœ^ÑRXTŒØ˜x¸»¡ºÆ6Ë–ˆ0ÝÓú…Eíï‚¡ù%0®1ïÌLî鯟Ý÷S6veÚöMY*‚s‹X.!*PšqŸÚUhCY~Cà3-ÿT8úF‹`s^¨¨.FY¥¹ (WWQ®SÈU×Øî›ÊJ(Ï| YwõšÕª‰tfš´<­Ži¹ìSömûÅ´ŽµëRG%(Ð AAÖ7A´²ÂBð&þㆡˆ‰ò‡tÓõŽˆK2fÔqÜ}ë(\>{ ÖmHÇžý–ƒ›tÓ&—=D¬–Ózª¾Þûh£zÊ´M:¶ÐId„/<Å£X%¥Õ(°ÀÇMltÉx52•W´ýÌŽ^¿¶šÿ]·ŒÀ¸Ñ ÊÍÚüg–Û|¿Ø;ÿ²¿Š~~Ö•îÞ3N­á¯K“!cµU’Š‚‹?\¬ºûãñÛ‘µc£Å®ëëtŸå'Lµ3¨-ÝŒYLâ¯Dw/UTWeþþ­*Ñ)³Ü½}-6o.³ºB÷G•§Ÿ ¸m9¹óqåÖëÀï?"³«Ë=XÎ NèN Ö¥GVÿn±R'[S[lyò2Ý}|0éÁ—àáãì=[±áÝçmÜÞõ«m¸'<|,ß?R&GNÕ:×”¾ÖåœþÌ»Šíº÷žGò’ï¦SÛÐÞ;(Ô(_»ð l̯iÂ؈›ï®÷& kªZ¬xarìÒºh×c->KJ^½5Ùl¬¨Dwüëí~ŽôDh´ò2mû­kÖ‘… ß@Ìÿr€*yÿ¡B¡bÙEZ½Œ¬+’#nTU•ëFòö³ìÀÞË¯Ñ U««&cðßäËD<Äp”Ö`égÇ Jš?µwýìmß¼„í[£J<=-S@°»ÅüC×Å’"Ñb#f’ 8Öî_Xš¤ø“Kx¡°Tbžwªìøy5~OÎR:QðždªªÑÔJ†5tçCãÝ û ^¸»å^Ì{rJOàé%Eïƒá¾´g$-–81H€,°ü©n©¦ƒæËÈQ.Àº%ÆÚ$¡«øöîšØ•UÕb³¼ù'­mê´*Íë‹óÊتeÑq¬?bûÓû³uAŒ§öò…¥§:º‡» ‹t&Óœš6’Øqº™2èNüóÜ_péøW, Õ5r”>¸òñƒëØšéáѼë±zá›ß0I÷v¦y†åÚ¹-}ku StŠŸIãÅ< KtçÝ„+°øÎòiX åp¾.ÓäÿCcqöô^*wÁ;ëPXT…_;€m;2Å{¬“²tÑ” &MÛåòŸ7P–5;vecÍzÛÝx´F˜®‚Þ¾óïŸh±ùƒ¢”,²0õH¡Å:ödvôúµÅüoÖGòþ‘SϾò76mÍ´‰½ó?Ü°&CLj'¿Í¿Ö¤ÒnÊÄ®;ª‹Í2ÙZ±ª¸U%…êó¥ËhÕši[Wñ™+\JÉTØÄòA»Â'\ˆÙ°ˆ¾ƒà"žæ—©$Óü½P–¢Ê¢UGÓÿ¤2hô©W`\WÓbѵ4Òu’i N쉮ÂåYüˆ‰¦Eö_(ž\=¼,öÞk Å|K™šÒA–YÛx·Ôή<ñ¡;ö®§›€ÒãÇðç ÷AS¬ÙÒ¯½ëW’¥»'äúkJ+Ãq£Åº:r*L;¤Ä‹÷¹ŒbšÂzöWJ™¯Ý«†u ÓSÕep—î÷ºiÒæ/]Ó•d1-V×Isæ¢ç´ ”ûº¿_Ÿ¬m,Ök̃¾›wX~øGÆD)/Öý”qZÚ2•׫¾åw|Òxsvr,éڪ׺²ì#–1m)SKûÊj)Q'Ýö¿kLûá5 €c°gÿÂtFž€¿îŒÃ¯ÿˆÆÈ„æŸ>Uö?º w]¡>æÀKŠ´V‘éX‘N©­»2þÿœþºï¹ƒ9UîmM3ûzbÞT\=B÷0—i;ù½Z¸Î–Éàçºi5^“ ˜0ÿElRÁÑ/sò ‘“[€îÝâmnE`(¿üCrЀžÂ‘7öí?¬6 Ë;ò|ÖOåSÊðÅÆìO,ƸX|[ø"þaG©@¬7þ%¾0= ~›$†¹ˆ gáJs8¯ ;Ò­Qw${ÆÞžò“j~&'Ý·ÆÍš˜¾8gÄ£ª<#rŠµz(éòKÆö?~‚Å>þï†ÿSù©©©ê˜4h0äk붭Ðò´:¦È>eß–ÜŠ™Ö5½^¸ä€ÊêÛ;·Ï¡¬3´: ñxT(¤æÈÑB`^+ÓŽþ¸ç¶1êrÕÚ#Xùwª:—O¯¾ôÆT ‹©Î1¸ù:˹2–Jt¤ŸÑKºü’IÆ41-³¤ R•þ›<>ýûF¨§gßþ ù /{Ç_ºL§|Ð/Raà%\¨i©g÷ÜqË(u™|0O0l{mG¯Ÿ½óŸ9­;æ\¢Û ÿö‡ÝØ ×l͵{@®•i²wþK—T÷JX¨7ÁAöRÉø€pg&S~A¶îÈ2Þ¾kñ&9°T÷ù#7j冭áf±oD”Šùà¡6߯üÕêxå"ðöø»Ÿ†Wpãø1ñu˃ªMEQò’w›µOY¶2ðzHBO ºòÈàòZ’–Ãoš§‚³Ç ò<óùZ!dó2Ž½GŒ¬5‡´8w×ã꺢0ÇwmÒ—i'Þ!aðŒ1z¹I_<"¹y‹Í7“2)“–òËx,ºÍ·ÁWÝ ©”2L!Ýû"é²› ³šè¬û]¾'³ÚZ7Ì' 0!ÐøטI3]nÙ¶£G&áŒA}t û¦¡ÆÄX`€/’„’%0À‡§‹˜º?,ežý¢7~® ù²–V(Å?o>5¥‚fΰ`\$¾0§÷ @Jn|<\ÐM<%!•UÕã‘…¹òoöS.¥d­Á¦äo0´Ç%ßÿ&Œî{ŠË2áîæï5ߪšrü¼ö»æþóÏ 1{ö…xù¥pÙesr(EßßÄ qÛm·ªëO>ùTŸ¯È¼ÇŸ¯ê½D<åïåíŽÄ.ÁJÉ"Ý+=ýâ_jCÚ´ÿ;…"!4Ä[/ýíõFÅ™Y¥øàÓ͸åÿ†«¾×¬Kæm™FunÖ'…5¥€Ïþs‘QÑÌÙŸ)åQfÃ…´š¹±A¡óÇÊ8hÙÇ°­½ãKë‹…Köãa‘!_ÐÇsK…ÂÊ ró^&é2ìÅ« ‡m³óŽ^?{çߧWãÆè¥ö‡|YK¯9‚Çž]iTlïü*À'_lŵW ßñ9<Y%ðõñÐ+]d€ã—ÄúUW[þCÅH ^ìúîCDôIBT¿!jöÿùW¡4瘲Bñ ‹†ff¶éã×Pœ‘fµ÷¢ôTåžë¢w–/)¢½;K+5ݽ›?^ WJvR|,›?û7†^}\x zL=…i‡Å†»BÄSþ®bgM*bÖ½óœØhÖ¹i2l_*,×¾~ƒ„B#~øÄ ‡’ìt¸ûø»Áí’´ÐXý擨³Ûlâý/"L(D,¥„QS„;¦)FE>xY‹¥º´»~üTqKs¦`8Ù{·£¦¬TijéŠpaÍ°óûO,btØ’dl 9É"fàpļ4ܬÙògîƱMïe{ä—wÑÉ&×kòƒ/›g˜±tþ-ÈÞ¹Ù0 ö®ß±ÍkplËjăžgžÄqg¢(ý<ýàÙ»þýfÍ1Ó‘.J³Žaó§obصw@ZU]ôÞ/(ËËVïÍ*©®º «<¡îcSÙe°úm_¾£âøÄ /\ù-A‰°,òJ>ï`ÝgSuE)6‰@–’¼Ç´$ß»òe-Y·½p¿µâçKE€|H>Ôpx—uk‘ƒÛKÐTˆ Ön:ˆŒñqó³½L³Õõƒ7Î-?«Ï\»Ï¬Þ_æ Aøvï6 S/ÅÄ‹cP êº ëÀàñû±agí—÷Ò„E‚ãYDçfÔbÉ'é˜y]úŽÆ£Ÿ¡0§žÂ‹¯æ+“´úþ£fs—¡QºßßáqÞxà£F^–*óêalø­H_dïúÙÛ^/HÃI×þ0\sÓryýá£ÉسÁ\áh©®-yÇëðÛuüû‰ É~Œ‚ÌJa…æŠ@PY¦Ê²ZüôÎ1[ºc “HàžÉ˜Ú»ñááãC<ðýM:E©–?áµ£¨20L³wÿBëWýÄž…aòkpÙl˜gz~ªì$¯B øÌüin¬ˆÍ[%˜í¤<‘ȯ_¹oóêŠ<«îÔ¦ööRõkÅKöš»6efxýöráM%1â»òiá¸{ò –ת}£?7¡xÑýؘZÞ¿Å°5ÏI€H€¬8%-26ËêµÛ1°w$&Ä">.JX¹¢´´L<Ù+þP /÷DlíÜ,‚3›?Ñk 3å/ø³‡ókpÝÈ`õ…9PX·È$¿xW ß߯¯,BF‘ùÓ|Î4Ǧd]´á /LÆØ~7 À' !þº§¥»ƒ«±tË È)>ÜTÍ–=ùÔ“:tðý÷ßaß¾}Â]>¢££Ñµk¢j¿bÅJüøÓf}ɼI“&bâÄ xýõWqèÐadff"44½{÷Võ¥Õ‹£5éí6‰{»W\:PXø£o‚©V˜ü®ß”Ž·EÌ©41MS'&bÂØ•ýÖûÔSÿ¦u¾ÿy&ŽM„´˜¹÷α¸áÖQZÖ>.—Ï€ˆ0_T‰ ñÿ»ÅT”v»~í­u8”Z€ËÆPcIWX›¶dˆ˜5„5‹î©âö¢£×ÏY篭ŧ_íÀ±Œb\=gâb•–V¶kÏq¼ûáF›cÆhíl=Ö K·eý}.¸ }fÌV›»Ñ]ôÍóíÃÖ/Þi6¶I'KêÏïǘ;WJ­iɲù“7pøÏ%Z–Ùq4û’.½Q)%¢ú7> ([? 9{¶™µÓ2v~óR%]v#cº Z÷ù)Ëeû-Ÿ,h·˜Û¿|Õe%BItµp÷¦WÌÈÍq©4Ù#1„Õˆ­I²¨Ö7}ιL)k\Ý­dlíçdÖ³kýÄgÔŸbóèuw¡û”Y"ž¯R|ÕV–+~‡ÿ\ìЊÉyŸP•ådb𜛅 ¶Dø†Eéð‹¹eîڌͽ†‚Ôd«K²ûûÿBZ\Éûß/Jþ%ùµ˜veŒŠ%$•V2IþÉÛŠ”’Å•tÍã“ 4Ø”V©pè!üR¹ðÅ&Û,(O…ýñSó~ÈÊŽ` OÐ=à'ÉäK©dYqÀº5ɹâA ™Ö*CA¹$g{*ßÿÿ÷y¶zïi½üá%”]‘ ±^d/¥•õX¸«ï®6ß?°}Ö$ Ó@§^½»µìÙÁ… !>á"à½Gƒ‹Ž’Òrdeåâð‘ ±yÛ>›ÃŽ†%FøIóë„òj±I!”+"Vúi•Büãàç.”k•È/ICeMÛþ@Xðúë˜0a¼Ó/¿úÏ=÷œY¾aÆ÷? ¬a.1ÌRçþùn¿ã³üÖdDGù!4Ø•µÈÌ.A¹x:…Év±ÑþÊÂGºLKÏ,FY;)•¬IÔÑëçìó÷ß>j“'C¬_QñÉýôŠPH+²œ ±éolhºîÃn¼½…‚FQ_úð\Uì_±a,]‰¸.Ò"ÅÖ$Ûú„Fª6%ÂÝ’´iI’qb¤19f©°l‘qhNF’ñEbà!,1jå¼Ó…‹Ï·b'c|GÞõ“nÙE¬©ü+ÉJCmeËžnt†ó/ÍOÏ–´LÁí+”a¨«©lßÒûßt¤ 2f‰°›úüÌÏ -¸ÛêHùš[ºÇ uƒ|È$çh-*Ëmÿìl®o–7O@Þ?!:þ¹ÇjQQJþÍSc  I@º®êá‚"¡×Ï1ÄZšN…ý0ßNˆû8eb'5¯¾ÉØ(]B\ðõõ:«£{ÈÂß)­ßç’.ÛbŸ¾â9¡#G‰øù˜%Ö@ž3‘ ´ŒÀ)§h1œ¾ |B|;È'Ò™H =\táEÊšEº[ò›õ§Í-=ý¬éèÞ½»²jùß÷ÿ³T…y$@§½¢eï6,}èæÓ`Æœ" @k Ü:ÞW wóùÂ=ã¬w3…“ÖöÄv$@$@mIà”pf H]¿m¬±a~Û°GA¢3¿µì…H€H€H€H€H€H€HàÔ'0@¸Ê_|a¬ÐWæI‹¤¥Å /¾hÔæŠ9slV´ØÛÞh`^ €“ ¢¥aáNœ8¡ÎÖ¯_'"&&ƒ„û¤mÛ··xiº`„ˆÓ®ÚfffaÍÚµÈÈÈ°ØW÷îÝÕxÅÅÅرc'Î=÷ÄÇÅaùŠ•Ø½{7ÜÝÝqÞ¬YªÎê5k±yóf‹ýh™ññq=j´¿²²GÄfêßÿòòr­ L &&#F 1ƒÂ!×/ýh:V¯Y#\xU5+µ‡‡‡¸÷†£[·®ðó÷‡¼¯e ùýû`Ó¦M¨««3ëcÀ€B¹¤ÏП;555úky’}\ô·ß(ÏÞ‹žÂUŸLXºt©Yw2¦T´ÈÔ³Gw³rÃŒÖ𓾾>¨¯«ÇªÕ«•BgÚ´3Ñ¥K%ÓömÛ±N|6XJmÁOÆ€êÙSÇ ù@22³²0hP†‹µôññAfF&V¬\‰ãÇ[Á(¯5ó7ê ƒ/ZóùÕ–ü:xúžH€H€H€H€H€H€H€HÀ PÑb²h%¥eغu+† ‚3g¶HцGy&Œ7é* ø?þˆçž{ÕÕÆ1/d ôË.½D(YvàÈ‘#BÑr®jÝu×áêk®Å?æÎÅرcTÞ 7Ü€‡y¿üò‹ÙAAA˜?ÿQLž4ɬL*Y^}íu|óÍ7feÌp Axøá‡0uêThVšd¥eexM¬ß·ß~«e™ÇŒ#\k=ŽÐÐP³2™qìX†¸wÆ–-[Êo½åŒ5Ò(O»xåå—µSýqÑ¢Exð¡‡õ×mq¢º),,RïÓ>÷ ÅÎm·ß®²óróL‹Õµ=üî›w/dl&©Øºüò9xïý÷fÌq£pev÷ÝwC*D S[ð1|žnÑdzâ‰'Ñ¿?½bIë_ÿº/½ô2¾¶ò¶gþÚy´çó«-øuäÜ96 €spì¨ÜÀV>ÕþëbÛ¢igN…­Ë½¼¼ðÁÞ×+Y¤å€ÜØÎËÓm Ë~.OäÏô«³ŠŒŒBñdÿÿ¾ÿ^YŸÈ˜O=ùÂĆ¯–'ßuçfryzzàÝwÞÖ+YrÅfôªU«Å¦úe‘ ŸŠèÁpåWXŸG@®ß;býÎ<óL½’ÅÐúÄO¸Ìzø¡qÕ•WZ266¯¾ò²^É"3‡¡ÇQ&ÎeŠÁ[ÿþ7¢££-öÑ‘™¦Š%SY¤5Ï_ý­^»÷ì1-†½ü ;¼ï¾û”’E¾w ­ˆ† =?6ß°j»œ7V)Y¤Ò'''W¯x’ÖJŠ÷ð8aedšÚrþ¦}ŸŒë¶üüj ¿“1GŽA$@$@$@$@$@$@$@$pê E‹ÉÚJ…Éï¿ÿŽî¿ò)û‘#GbpÛÔ\’V) ªšÜ~\<ž››«®¥[¢¯¿???œsÎ9øàƒÕ¸iŸááa˜-ú‘OÌK÷A÷ äúÄI“Õfùáéø×=w«Ít™ôèQ}—\r)z÷î­®þùg1þ“AÅe’u?þè#åJìŽ;nÇÂ… Á`â M»ü'ÝÕ›¸è ltÇeiP¹~}úôQETV »„Û8y?ž+î™{ïýÜÜÜpûí·)k&Óõ›1ý,¡lðTí¿üêk¼,,Q4—_rƒþ!¡¤9ÿ¼óàíí™3g¨{P“ãåW^¡»0©ëÖ­›*ž;÷¨6q–ŸoÙ¢Dë¯#ŽöòÓd–nú¤"êâK.Áñ” ÒsÏ9=ö˜:Ÿ†%K+EYÿþýU ÍRIVl«ùë=É'mùùÕ~'yºŽH€H€H€H€H€H€H€Hà#@×a& *7ZeZ¼Dç>l’x‚]ºµi.}úé§Âê`žzIEi2ܘ AÊ-%¸\KÚ¹v”ù'Ä?k)®sgUtX¸Š2Ü(×êïÞÝènI««•ñØñ´5É.ߤ»/Ó´aÃ}–VWŸ!N òõ—g5M®H+©m" »|IÅÛ©–4&­ågÈcóæ-†—ê|ÇÎú¼ aaÒžI*·L“´`J®àd’nÖ´˜6Z½¶œ¿ÖçÉúsG9ÉÏÏW¢ZT6õîÕ o¿õoõšsùefb·?³4£-ço_Èŵå_­iÏÏ/½±( €MZ¾‹fS·§N¥Å‹—¨É >Ìâ°,¬?ѨX±¦è5rD»BÙ·Ÿê¿K—.è&Ü”™¦I'â­ÿ[½ÆÓ¹83­ÃëŽ# ­ŸŸ¯/¦Nj&Èy³féóì? ?×N¼þ:>úð¼óÎ;ïSCå_mm­ÖÌâ±¼¢RŸ¯?oÏ“Éɪ{ëèÌ3Ï4ê\ƒùï? «kXÉ^~†}Ù{ÞüÚrþÒbHK ÐNm>¶¦½&??¿lÆÌŠ$@$@$@$@$@$@$@$@DÀÜ– 碬_¿òiûYiçÎ]úü+æÌÁ®]»°|ù Hw8aaa¸áúë1Q(:Ú3}ûí·'bÉH×S/½øž}îy%‡——FŽû䯩©Á“OžúAµÛ“u{ô­­Ÿìû™§ŸBß>½±mûvøûùãœsÎÁèÑ£Ô°YYÙø{Õ*3¤ÅÔ!CTþsÏ=‹/¾øBÄaÉ««+:ÇÆâæ›oÒ·Ù¾}›þÜÒÉŽÛ¡)ßX°+V¬Pn󴺿ýövïÙ£]¶Éñ»ïþ‡³¦MS}=ýÔ“èÛ·6mÜOL™2EÄ™©ÊÊËËñë¢EfcÚËϬC;2:‚_[Î_Z@ÉÏ www̾è"„…†âÈ‘4#"Ë…¥Ÿ¼?-¥Ö´×äçç—%¢Ì#       ptT´4³BÒà·¥¿«¸Öªû2³²Ìʘѱ ×OÞC7Üpƒ™@ò~š7ož‘ÒC«ôº°hIJ¨â I……¦´Ðʵczú1uŸh×–Ž_~ùÎ?ï|DFF &&W\1ǨZJÊÁ6W´ÈÍù?ù×^sÚà—Gù2Lòþ}tþ|f«s{ù™uhGFGðkËùª>ÿºçnEÁ’’øرcV-­io(×®]ÁÏ/;n@6%       8éè:ÌäK/n¶Öüùá£?VÊYY!—J–ììã¸ÿ±zõêfû°·Â³Ï>‹ù=†ÔÔT³®¶mÛ†›nž‹ÿ}ÿ½Y3ƒ€\¿GyÉ n´4©¤u´ ¸ô²Ë°}Ç-Ûè¸ÿÀ\yÕUX¶lªªªŒÊä…Ì[¸p!®¹öZ”––š•fફ¯Võ幨ܰN{œ¿úêkx𡇑’’bÔ½óæ͸öÚëð»ˆd-ÙÃÏZŸ­Éï(~m9ÿO?ýTÄõ¹[·nEYYY‹1´¦=?¿ZŒ™ H€H€H€H€H€H€H€H€„@§^½»pYN 1¤‚E>‘í+bmÈ åÒåŽa|Œ“5ÉhT=""BÄ9´´4Y°8Y²pœ–®êÂÃÃ…‚¤Ò]XeecÜ”æzóî¶bbbàïï/î½B±R‚£GÓQWW×\S‡)ŒŒT÷¯”9##ÒJ¢%É~-ÇQë:ûüùùå¨wå"       °D€ŠKT˜G$@$@$@$@$@$@$@$@$@$@$@6 ë0 ± X"àf)ódæm߶õdDZH€H€Hà” 4hð)1N‚H€H€H€H€H€H€H€œ-Zœ})? @‡`Œ–CÏI€H€H€H€H€H€H€H€H€H€H€œ-Zœ})? @‡ ¢¥ÃÐs`           g'@E‹³¯ å'          è0T´tzL$@$@$@$@$@$@$@$@$@$@$àì¨hqö¤ü$@$@$@$@$@$@$@$@$@$@$@F€Š–CÏI€H€H€H€H€H€H€H€H€H€H€œ-ξ‚”ŸH€H€H€H€H€H€H€H€H€H€H ÃPÑÒaè90 €³ ¢ÅÙWò“ t·¹ö †oXpâJCuiI;ÈîI€4~A.Žp“o?ägÕ¢¼¤^+:-ŽþÁ.ó¯¯ò2kQYvzÍÿ´XdN’H€H€H€H€H€H€H€H€8Œ¢eì]O Ë¨)HÛð'þ~éA³ò Äìÿüªòÿxâ6dïÚbVGfD…Ásæ"´kïÆr±Û›½o¶~ú&rÄÑRzÃÝèuÖEfEµUå(Î:†ôa߯QS^fVGft›: #oºÏb™a摵˰êÕG ³ÌÎã»b¿ž†T¼*+L?„Ew_eVÏ0Ã^ù û:Îü¸7Â<ÕT–¥Ÿæ8ä´â{{â–— îU)»tçIÙ¤Ÿs_g ŠÝkóñéÓGM¤|]ðÈçTþû@ÊŽ ³:2£÷PL¿.»ùêË¥²%uO1}!Ž•ú|Óóÿ…‘gGf©óšÊ:äfV ¹ ±ê§|‹,FÌÄ·&¨ú?–Œ}›ÊÍú‘çÞ‰1³¢PYZ‹çÿo/*J•Úø©{JðμCfíÃ;»ãžwúªü×nÛƒ¬Ã5fudF¿Q¾8ëêXÄ$úèËëëO yk~yÿ²R-·ë>Èÿ÷TO}k'…Ù•xî†ýFųnŽÂèsÍÙU2¹xõÖ=È>Ò(ËE·GcØ´“Z@]M=Šr«±s‘àŸ«”Ff•˜A$@$@$@$@$@$@$@$@§9‹®Ã¼¼<Š.qQˆ‹DhH \]-Vm;|..pqsƒ‹««Õ>U¹¨ƒN,ÖéqÖ…˜úðk:%‹´dÉÉDyþqU?²OÎzê]t1ÞbÛN.®ºñ¥ /ß„uëƒA—ÝŒs^ý¾ÑVÚ7ÈoÐÖ°í\ŽÓT’ ›³_ø»êåh®ìÏ^ù›’ÉÙÊÂbÝå7·NêÕsH€ÃN¡t2j²šO–à..:9\\-¿·¤šlVÞ~uvRH%‹T®dW©MzY?±_€P(õB¡ˆ°”:‰qµþ Þ~nˆëá‡éWwÆ=oõBH¤ùûgãÒ"ä eŒl7ýÚXñf0!8ÂU(#¢TeBñf¨d‘µµñÅÇÅ$ç ÉÕÉ €±çãºù=ôJ–âüj”×B²íuFn{­7¤bÍR2ì_ÇÒÑÒút2[ªÛTž© Úú›¶ñôvEDœ7Æ…»ßꃾ#,¯Ÿi¼&        Ó‰€‘EKHpz÷LPŠSuuu8šž}ÉGPSSkZÜá×>avý]JŽŒíë±ößO¡µ¢þËs÷•É‹ü¬FkÃBiÑóÅó©ú,7ñþñÂŒkb•òòŠû»â•[öÒ²EOˆ'$@$@$@$@$@$@$@$@$èŸßîѵ3FhQÉ"A¹ K“„.1?f0üŽ]ü¨Épu÷@Uiþ|þ>½’E Z|,¾ð€Š×âé„èÁ#­Ê_[U‰²ã™úWÁ¡ýØñÕûØðÑ«ª´ŒñŽ3k/]Š•d5{ù„†#é’ÿSõ·|þ¯Ð¹?3í`ø÷*%K½PhmúdV()l¼ ïïÆ4•ÖÝ?²~I¾®½´,2l¯[cP]U¯g/× ÷X ¶®(Á[÷&£²¼N(,]…ûµ0SxM$@$@$@$@$@$@$@$@§5µÙ5!½{% \Â?N3ÉÇÛ £†€·—e8Í4o·b¿ÈXÕwîÝ­UJ³Ò‘±s ¦ÀÝÛúF¯5 $±º'÷­ÕÕòƒ{bâ/)О_¾Äîÿ}¢™]<÷2Dô¬\¸Yê»MóÄ-Ü} N¾Ô=åHÝ«³lД/ÖÆŠJpGßá¾ÂF· îíç‚Ó1óºpL¹< ]òÛ«½µ~[“/­+FŸ¤dŸ*d8Öîíüv Ö v Ô¢µJnF-n/qAÊáåkîþ«¹yn^Ö¨tŒèìa±ú"¡D‘Š…ˆxoœ1¹ñqm´rßuhW1v­1¶t±ØQ+2£tŠ<9†%Ë)›¦²L§$‰îj®hiÅ'µ‰´NÚ½Vg Ôu€N‘yRà`$@$@$@$@$@$@$@$@$àÀÜ|ѧw׉èîî†!ƒzcõºí-jמ•ë¥i€H^A!V‡YöØ?­–5W ú—»¸B‘P'¬^šK~Q1uþëðJC-Áæ_o²IÆÖµØðîó¨.-i²^k ›“¿ßW!qÌ™H[¿RY™Žãîã‹É¾¢²—οŢ›4ߨLœ÷¼rÑfÚ^^ Ë¢¿^z…GZ*n“¼èD¸Ý]¹LJÛ_Èø žŠîƒäÆ{¶Õ1F†1çDBn”/ÿ*K¸ºê*žõ®¶¯ÊÃW/EífÔ—½í:kå…tvÁ­1ÊzÃTg*--¾[Šíµ¢¡®F¼7Dò 6·6Ѧóîý‡µÓkEÿ o?H« Kéèjl]™‹!“„«°Xq^ŒØîž".Lˆjûó»é–šµIž§Î„¦¢Tç.ÌR§oßw@ÄRqAþqÝg•¥:ŽœW”+ÌnDò ²¾ÆŽ,?e#        ö"àÖ£[<\LwemMÆs  BN^¡ µÛ¿JÎ]jЮ½=d2·¬mÓA#“†+%K}m ÒRšìÛ+8g>¶^!8¶e Ö¾ñD³*‡–/j²O{ ["«Æ÷Фû_Dp|w±©]L§DX»ã¾áQˆ4"VÎÔG_÷ÎVGÍ+«Z#GA:k¥£ûKP#ö…Sv–©n¢}àãï‚òË›ôÚXn.¸üÞDd§U`ÿ–b±1ôŒÈ.>Hª\2ýøV–VÝìho{³mÍ–L{òßð Eÿ ¯Q/i}’¶nRV.BYVF³ÓŒ8 ýçUO>¥îîã7O/T•aËïˆ8+7Û‡zô¾¡–wP(â†W¯”•¿b Ö-Í`½F›Èo½{«%>!áº2aÁbI¡”½s3¾¼b¢ªS_Ý>Oö»ˆÐ2XºL);\d V);‹•’¤û`ÿf-õµõXòI£’Eö% t°èƒLÕ‡›['ÌÜ2øº¥do{K}Ú’7pœÎrcÿæB#%‹j+,ùo¶R´ «„¸^žHÛgÝ*Ä–ñLëÈàê?usŸë á>lÒ%1ê••ZŽ« °ùäe6o Ñ}pù¬!†’P²HE‰‡§°D*®ÅâOÒ±ì«\Ó¡Í®eáB©ä sý¶ò»LåZwéeØA\O?<øqoÃ,uî"\~ÉSX@Evit æ*î÷¸žÞ˜ve¬Z‡ªŠ:üýCÎ适s$        › èv"m®n\QÆjq¤Tœ~ ﾃ.Ÿ‹®ã§ÃÕÃSXYtS¯³¯Ç®?ŶÏßnÒ—«»|B"̦åêæO?¸ _Ru55få†{ú ÿøQè[\D_áèqæùè6élt›8…GaÏŸVoÓó¶¿5Uæëš åTܨÉ8²êw³nj+*ÌòÚ2#¾§¼|\•{©#{Ç’Ö-Ò¥G’TÂd69d¶°Ê.ÇL“TÈMfOoWø‡X¿ïímo:®­×ÁQ^ªjæ!Ë.»¤¢Aº|òñwnµ<Ú\Ñ"Ï>RƒWnÙ‹×FaÐÄ0µ1•àùšzy V~›Åç4iMãîÞ aæÁî]=: Ù]•+7ὯÉTQZ/ܾb°A¦´½–•b–:q®ãBXZ*?Õóºôñǽïö³8Myÿút ŽÛ¦´²Ø 3I€H€H€H€H€H€H€H€Hà$`}Ç؆ÉÖ +GK•ùX÷Ö3Øô᫈±ZâGLDçacáîå‹ÂÊÅÅÕ[>yêØY»6cÍ[OéË=D»Haå’té è7ë ÅuÅò§îjRYSS^ù’©ìx&röí@½xä¿ÇÔóÐÿü+±çÇÏšl¯¼'m!+†E~Ê^¥B`ç®÷SÈÊ¥ã{·)ÅRaêAg¤µÛœ5y»òS§Ç’KQÝè9K§%B¸µòqqV¬»žª­¶^¦¾{®®ÂÔÂJ²·½•n›Í––2…ÆzaÐË–fÒ —L2nK{¥’‚z|ój~z'½†Š÷ܘ ô¬`“/ŠJüò¾±Å¡,wãÛWŽÒ<¼] ãîL»".ŒFd¼7>x$µIeMxgw ªu×Åbßædqÿ鳬žd.ÇOï5+ŽðÀ¥ îËÌ O¡Œºº¨©Ô}®wr餋rz›—çb‰ˆC%Ë)´Øœ @›°KÑRVÖh5ÐfµQGµ•H[³\½<|ý0â–‘0j úΚƒ”‹P”vÈâHµU•F.Ƥº¤ 5Ç÷lÃÌç>@ìàQè2öLù{©ÅöÖ2,ù^)Z<ýƒ„2"E²¥=R{É߬¬ÂeØògîÅ„yÏ"$¡'¢ U/­]EQ’ÿ»¾ûuíä:¬{C|–C»JĆ¾62Dì½5G÷$_l]¡‹ßÒXãÔ9K–;òÕÑ©ªâvü]ª^Þ~˜}g¬’kÜQØø{>²R-›¥ÈM~Sc™‡ªqxwn{µz B’P$m[i} gÝ£”aÒª¥ÛÀ@ÄvóÅÐ)ØôGó±E*Êjqp›ùçZD\ónÏ:šy[ŒŸ"]ï=pXuå!Œ¤þ´¿²‚ª,¯£’¥-³        S’€[~A1B‚uq-Z:Ãã9 î¢ZÚð$ׯ.+Åš×æ#²÷@Œ=Q¸ÛöÙ[-’"ÿàdl[‹Ø!cD¼•q-V´”å5>ÅïØ¢±Û¢²½òÛ"CiV:Ýs5¢úŸ¨¤áBáÒq‰ð Vqsξ‘ý†`éÃ7·¹u‹»' ÝÉ4ébD¼,¥ž"NË©¬hÙ»±û6Yšº>ïÈ>ËîÅôÚøDºòúòù£Hëê!“‚ðëG-‹óqt5dü™>ÂÑoTUEKÁÞÊ‚¦¾þ~|ë&ήƈéÂYg¡ôÙƒj náÚxº§LwÒ*lí¢lL¹,Vļ ÇŸgCZ,1‘ p;”z¬UŠ–ÊÊjËl>0µñpv\i~ZÙ…Œ«’±}ƒˆ“r¶pÿ•Øª^ Ó(E‹O¨q Wwa¥ÒMõY”ž",6,<­/#ª7¤NvÎE맥Gkò·´Ÿ&ë Ë–¬›ÔK«çŽAsþ¡âÔDöIBôà‘ÈܲV+n“cB_oÈø2U5¸>2ìØÅÕE•wO’J® Ã"ÛÏ­{ ³­{Û71Šæ+mVÿ\ØDÍŽ)’qU’·aèÔpl]ø_kEÊI¯ŠeMc°vÃnDH$œwsœÊÚô{rÒkð»P ™¦â¾Œ¿( |Ñ>ŸY'Ä}ß\ŠJt1f:¡0·¥N¢°XõS&ÌŽŒ]3Að[øŸãÍM“å$@$@$@$@$@$@$@$@$pÚpÉÌÊűŒ–mžÉMÅ­;ö¡¾¾Qy`/¹Ú ÝSöÞA–Ýy6æטU÷ •ÿ[«^Q"žŠµTßSæ„xÚ½5É'X'ƒtKf˜Ü}pöKŸ¨WpboÃ"ý¹§_£KeqÓúFm|bM~9ŒÆßÃ×r|1G-Õ”·Ì"¢iǦä—B¤¥(Yº÷…Œicš¤ŠLRYUœ‘ªÎ ÿKœ8Ãoš‡~]c˜Ýx.šjݵuOcûÎz Ö)²RvXŽÝ!c‚hʧÅZ’ÖÁæ›å]x+kÙ.7úÿ){ÛËþ  þÁæ²È:¦)+U§üê>Èò&¾T†\>¯³zEv1W¦d§é”‡Q‰>uMSÏÁº{BºäÊI7ŽWRV\¯ØºˆàéIãÍß»²/éڭ׺²ì#ÆŠJÓ±,]Gº¢ßÈ`U”ž,#''/L¿:Ve®þ) E¹:Å‘ÌXöU.*JkU`÷é×D7l£«¬TÝœºöã­œIêÒÛK()tŠ¢¬Ã•&¥Ž}¹ò9J9æå㊱ç‡8¶°”ŽH€H€H€H€H€H€H€H€:€€ÚQ­›çë6îÄä#¨«³ü´¸”­´¬kÖïÀ‘£º'ÄÛRÞ´µËÔ&¾›—7FÝò<ü-+"ú FÒ%׫á2¶®CM¹ÉF«ØÄ?°ô'UÞsÚHš3nÞOÖK%ÃÄû_‚OH„ãðÊ_­ŠîâîéêJ{ÄÄ£ÛÔY8ëé÷àæ壔ÿøѸ½_—×wÖè~æyèäÒ°Y-L!ÆŸ…¤‹oPmRÄØuUæõžÁðŒ1zi Ww7£|YOh•Œeh¸j•ü¢mÚšeÂåY•˜£÷ÿ³wðQTMÒ{ï… B ½÷6@TPøPQ± (‚`oXÄŠ"ˆÒ;½!½÷žðͼË^®ì%w¹Kƒ™_6»ûöµýïÞÝî›73Ðç…%jü}0°}§‡gŠnÙ…Ö/ÚåÄ+dÄ8è4i¦83ó ™…„b|'…[§Ô+çeû^ÝD{3ðo¡PžèR´S\?¯†Þ¢“¼2‚ÚÏJ-†Gæ5G· eƒg€%Lx®±è^vz1D_Ö=Pnlyj$îz¡°Ê íûŸ€€–Vàæc¡¶X¡âBUŽíHG ³Ûà‡Š’Q{‚Y~ %ÄÏúCgt¡EÊŠL´òД³²ð³¬mÌáÁ0zÅùµ³¡“JŒ+'3¡ Wã;ÙÝ®°Šë1ÒFLõTS6’ä±…M…û.j#ü¿ Íæ•ûè¢ÊÙÃ\¹ûnÃáéC„¢¤¸ø6¶•¦Ì/m ™ì "KÈË.]¿¨»£1»~ŽY»b¬Ÿ¦ÚŠ&©žê®OíÉüH™2eAÑ©.ÿV¨àj*vSbó!ê¢öýCŠ(ÕklïTaY¥šîâ©ra¥jxx³XÄÇ¡fúÞë£vmk¸i®ž 0&À˜`L€ 0&À˜`L€ 4ÊÑ<ÔÀåÈh¸q3|¼ÝÁÅÙ¬­­…{°¼üañBV/”¯&$/9"6,‡°GžFË‘~0aÕvÈNŠEwMv"€=µY”Ÿá«–Ê6î·Uà…ñ?|0Ø:]o{ߣ“ f–ààá«TL„¯ù-2¢eë D?t=6îÛ-²ÇË0ÐÄÏß„Ü$mEÓ¹_¿_THx†´ƒžÿ›{òÓ’€\¡In·Ò¢®Àɾ­»ëô¡Yǜ|›À_ÿ¡vìÇIýd6Õí~Z _ý)ô˜1ãÐôBþÛ -‡¬ìÀÞÃG´M®¿tñ¿úÏFF“ƒ—¿8ÿnÓ^TXù BÈݾ‘²…$îÌ1µø-"ÑÈÍÛÛYSнy㜶Hª>òt6´íé-ÚëV´$Å䃕µ¼öC;H¼™'¬X<õS=›¿†Ruƒ©z±6¶‚3~5²0&À˜`L€ 0&À˜`L€ 0&€…´jŽÃ€õO|üQY⮺Š!'áÐ@¾!bïãv.ÂUXnrœN!uê›—ÜfÙ{ù º+ÌÊÀ˜,±¢ú–¯ùì½|Ñ}š—P QL–’Ýôšý•Îß­aHIV”— ¹‰èº©¦Ì¡4;PýûŸñ…Þc¼Q‘Ë^R(ÓÈM“«—%ä—ᑬ%‚Ô”±å¥zLµ¦¾;{X"òÛ‹ÊÂJPrm’•ˆ“›”””aùY+¹rR•wtµJš´Dü cPõ»Iˆ¿ ò/#þqèî:ÿ»éZó¹2&À˜`L€ 0&À˜`L€ 0-‹–ú‚$'!,ònŠôécnBÐRBã³ão‰¥.Ú7E›¹Iñè" •#Õéü«Q´^ÉÀX&´TWŒ-_Ýv©œ±m“+,Zª+Æ–¯n»õ¥œ±üëËyp?˜`L€ 0&À˜`L€ 0&À˜¨š@EÄëªór&À˜`L€ 0&À˜`L€ 0&À˜`L€ 0¬hQÁ›L€ 0&À˜`L€ 0&À˜`L€ 0&À˜0„@½ufÈIp^&`,¸kypöPÆbɯVUÆ–¯V£\ˆ 0&À˜`L€ 0&À˜`L€ 0&Àêœ@£VÍo×y/¸L€ 0&À˜`L€ 0&À˜`L€ 0&À˜h€ØuX¼hÜe&À˜`L€ 0&À˜`L€ 0&À˜`L ~`EKý¸Ü &À˜`L€ 0&À˜`L€ 0&À˜`L ¨TÑ2vd_ …… 0&À˜`L€ 0&À˜`L€ 0&À˜`L@›@¥ŠíìœÂ˜`L€ 0&À˜`L€ 0&À˜`L€ 0& `E‹D‚×L€ 0&À˜`L€ 0&À˜`L€ 0&À˜0+Z ÆÙ™`L€ 0&À˜`L€ 0&À˜`L€ 0& `E‹D‚×L€ 0&À˜`L€ 0&À˜`L€ 0&À˜0+Z ÆÙ™`L€ 0&À˜`L€ 0&À˜`L€ 0& `E‹D‚×L€ 0&À˜`Là.'ЪU+èÝ»7ØÙÙÝå$øô™`L€ 0&À˜`ú°Ð?+çdL€ 0&À˜`L@/// ¥´´âââ 33SWÖz™þØÔ)ð /ˆ¾EߺãLJ¢zÙWî”é 4ôû×ôD¸F&À˜`L€ 0& ?V´èw¶FX@IDATϪҜ?|¿BCCµòäääˆíýû÷Ã~‚ŒŒ ­<œ Nàõ×^ƒûï¿–.ýÖ­_¯<¸há0vìXøðÃয়V¦×‡©801ûÙgõêÊ€ƒ ;;[¯¼µ‘iÕw+¡C‡¢©‘£FCRR’l³ONŸ3gÎÇÞX¸þþûoe>cÏÿ×_~†   e}´AƒT©©ipåÊeؼåoøï¿ÿÔŽóN\!ÁÁ å[Ä0%%Î_8þ¹ <¨•‡øúÉbáD= l߶ <==Dîk×®ÁƒR+éããoÙ,Ò–/_ß®üNí8ï0;À}÷Ý O<þ4iÒXy:·o߆³gϲe_Ãá#G”éõy£wï>Êî5 „€€@ Ïµ©¥k×®°üëe:«]¸èMزe‹Îã|À´î”û×´T@¼Ð{ ɻｿýö»©›àú˜`L€ 0&Àî ì:ÌDÓÜÂ,dhÓ¦ ̘16ýù´mÛÖD-Þ¹Õ´nÝJ°ŒŒŒT;ÉÖ­[˦«eª£333Ùë/wOÔQu6{òÔ)eß;wî¬3_XXge¾'N¨å3öüå8Y[[ƒŸŸ/ 0>þèCøò‹/ÀÆÆF­]ÞQ°07W^U–ÄÐß߆  ˾úÞZ²èZi _?M"¼os•û/$$Z¶l©V¼îI÷¥æeaw×_Þ\´HMÉBçبQ#hß¾=| … &4ˆÓÞ¶}”••‰¾ž;wnÞ¼Y#ý&6Ò÷‚ÜÚ ³Ô;éþ551³FÏ÷ffüûej¾\`L€ 0&Àî4lÑb¢+J/Œ$………ðùç_(k%üÁƒãŒ@ ¥ËgŸ~ £Fù”™xCI€|[´h!ö/_¹¢L§<ÉâáÊÕ«Êôú²qáÂEX¿þGewzöê AÍš‰ýv쀔äå±¢¢úå‚ãøñpxrútÑ¿Îaa° g§k ]—öÚ‹ä[·b !!A-‹©ÎŸwÖ¬Y#ê¦Y??èׯ oß>ðÆ `þ|ÅÌBµðŽ’ÀŠo¾Qn›ãu£ÏÍTVÑ5$‹°ÄÄDøâ˯”yhƒ¯ŸÞ1’À¨‘#à³zø=mäiqq& K ÿ~0aü8q¬  Ö­[§NE€µ5 8Fã3=#Î}åe8tèÄÆÆÊÖS_7nüöï?®®.yM©t1uÿâÕž›¨þV­B ² ¦î×p§Ý¿|M™`L€ 0&À˜@]`E‹‰è“{’ââb5wW”öåW_Áw+¿³=<ÜaÈ!jn—(‹‚@ãÆÂj!Ý¥§§+±4C¥…••ÄÇ'@VV–2½¾l=zh‘dñâ7•Št9sæ¬t¨Þ­#""€”?Ä·sç0ÙþÑ u{{qìøñcZyLuþäêê3E%5Ô´iXõÝwàîî£G‚•ß®„ë7nhõÈE¦tAK¥åË¿KKKxôÑGaÍ÷?¨¹¯ãë§IŒ÷ ! M4 ïlWWW1b¤ÖçØú8/hHî»ï>ewç¼ø’š‹Æ;wARr2º{\|ÿŽ1V~·J™¿¾n$cŸi©I‰Ž¾|ø¡ZOžÌŠ5"5¿s'Þ¿5O[`L€ 0&À˜`òXÑ"ÏŤ©4ˆ½­>@÷$̓–ªtëÖ  Ö—¢Lí%]Êãéé äR‹äÆ(¸…Jå„Ë»c]Í›ƒ£#ˆâ\¾|ÂÃÃEÜ ¹rõ%-¸¥"ÎÄ•Ë—Õº$ÅŸ¸¢b墖wªM€¬°Î yŒ'…Y^iÆ ëÔIYÿ1´€©M‰Šº)b:¼:÷ÑlÿýYÑbàGWo[ÑRéÞ{îÖAt­wïÙc`-ÕËÎׯzÜR)i¢)ì†.\þuĸO§O|¤XíÞ­;÷eI¹~èðaëL®2²€$ƒ¤€'…öرc€âJìÚ½Ο?/·é¾§<M·‡šu’²¿WÏ^¢}²N¸‰ƒÁc-//O3+ï3A YÓ¦bMÏZrq°¶nU|÷R&wwE,#Q@æ_uî?Š¬p×wõÊUˆG‹ÓŽ;=WÚÙÙA|\¼ø¾×ÍÛÛBB´c|Q÷ ‹Ô&‘ÈtY-ÉÐϯZaÞ©ÆÞ¿:uGñ¾â»’ÞC „qãZŠÉggÏžÃïÞCzYFUçþW…fLygg4xâïG>~ß:|Èu^Ùm…=Õvx› 0&À˜`L€ è"ÀŠ]d L—fôê*–ššª<$—÷ ðá>rss¡—J R©¹Rxÿ½wÅî§è~lõšï¥CÊuïÞ½a ZRÐÌ9‰ƒ×¼'Ož’;\giôRóþûï‰öÝÝ} mà[òÁ‰öíÛ‰ôá'àãO>‘óÚHÇŠº7ÃÂ:Á®]»Õj¤iI(om –Ä×ÇWÚäµ.]ºŒŠEX«MáëW›´ë®­ìœ\t™t ¿CÂ`$ZŸ¢hñððú$76šB.ÿøóOxï½÷…õêqŠ{ñÐÄQÉrFÄ’ ÷x$£Á”©Áÿf΄>}z‹´iÓ¦áoà°yóf±¯úÌ ¾!\=©¦Ó6)Y–~úüòË/š‡xŸ €Âž„›b”””¨Q¹Šnô ¢–¦¹cÌý×½[WX¼x±¨rñâ% 0xàµ&^zéEøè£ág™{˜&ç,Áø]rBŠÎ#GÊRK«îçW­Þ©ÆÞ¿/¿ü2„b,JºïGŽ ߬X.&í¨ž =Ì~îyHKKSMVnsÿS%Æ–ïÛ§þ¾¼ Ê>=ýôÓ°aÃOpö,L€ 0&À˜`L@_ÚQ‘õ-Éù "гGweþšp#åïïK?ùX©dÉA…Íõë×ÅÌRÞPPìeèÆÌ×·~ TÛÚÚˆ—4zQóñQ ÓKíK‹··—8rKCi8ë˜Åt(N‹$;w‘6•ëŽ-7ÐeWJJE¼e†Þ(V‰kcƒ÷ ‹á+rkyv>_?ïWC,aoo‡–SÛEׇ "âés666½¦¤d!‚41@š @ñ…ÆáÀñBŒÑ¤K¼½}€\þ¾q£PŒP\¯·pðØÃÃ]™Fe_xþ9­~Y[[Á t­Gñ4HRÐuåqRÂI1#›¬^›?yøaqœÿ1U’.Íäü±©ª‡ôÚ6åý×c™‘’…¬±’16œÔžú6ïaP6µ˜âókê>q}ú0öþUm‰î1²Œ&7’d--I»víp²˜bB•”&­½ÿ-OV0}ô¡š’…¬ºóóóaÒ¤‡ Oï^RWy͘`L€ 0&Àª$À-U"20ZP²ðòòÂ@¨£ÄìZJ;®TöîÛG›&òûMÃI6üô3|üñÇb€ˆöéûµ×æÃ}÷Þ ¶¶¶0jÔHø®ù'×BŒO]ÅÁ®åàéé/Ì™ƒ³“£Eý[ùí7àææ†3➃˜˜XÈ+W)3ð†Qh68½Ó=Ô-ZT…s’¢KU!£š‡·ë7úN9b„²“4Ú… ˜š ¸þûï¿0ïÕ¹âûºG"øwUíUJÓr÷Kûöí‡7qv¾¤Ð%kÎÏ?ûT ‚3FüvÉÅh¢ßñX¹#÷I¯bh€ƒ„¥(¹Ü|éÅ9b2¥«ºß|ðÁ‰„»•èæ_ý…í/QZ%PÞ5«W WbÏ=7¶lÙ™™U¿‹üúëo—HñýúÌ3Ï@›ÐPø-°Ž9ª6ج ‰)ï¿Þ½z kßõè®––49eZj 0@4?cÆS°ÿÀµ®[§iÓ¦«¥}þùg`_—Mí€ÌŽ)>¿2ÕrR-0öþ•ºI ñà˜üð#Âm#íFW\o-Y"b/vCË«èBù4>oªŠ±÷¿±å§L™*úG}"Ë›yó_¿¤¬Ÿùd©r†¡Va#h6¯$¿ýö›RÉBi#æã??þøCd¡YŽõI¨×®]J š}Lƒ4›˜ÒIÈ”Ÿ”,ÅÅÅèÿür¬>CCï ±ˆ8 Ý»wC_í!b€E²„RÏRnÃ:ÛÚî?¹®‘„ š7o³gÏVºò¸pá\ºtIÊÂk&`2––"¾ÓaômOîºF¡—¢…:°4$o¿ýŽZŒ(Š©²nÝ:˜‰.ÀH:¢C9EK&*?HÉBr3Z¡¤OOÏJJ‹Q‰kF*ª2ûIB3˜ßÿàCµß˜ØØXXñÍ XðúëbÒùð߸Qñ[ªZoß½(Ö÷ßÿS§NÈ2Šzî;Œñ…¶üý7ìܹK糟)ï?²˜þᇵʋA– .‚íÛ·‰g¬¶mÛªý¾SF²“¬Ç¤‚šîϤt]kc?¿ºêåôš'`ìý+õ+Ÿ}þ¹P²PYSýûïÂÒpÆSO‰l]»vÑR´{ÿ[žž{I(Ö˜¤d¡}zY‹¿=={ö„ÞlÕBHX˜`L€ 0&Àô P1"§GfÎR}4£ÜÛËœ1ØbNNNõ+ÒQ2=½Âïñðáà 22R-' @Ñ@z}––-[+ ›7o*•,Ô_)È+ ®úò_ŸÏ·¾õí8*é…“^–;uì]ìÔIaáB/¡ÇÃ+\ŒÕ·þsN„뎡C±&(F ¨ ¤Ø#Ù¶}»P´ Ä€ÈÖo½UeSk×V ËeVµnt ËrBßO’HÛÒšÒo+#iH¹*Öb‡\#Êý>Ÿ?A™YÊ«Là &€>YºÝÝÅŠÙïNNN‚ Yˆ@KZÈjô…9/*-µT¡I÷”)î¿“§NªV-¶É뺒m‹–6diMW¤‰Z™«‘`ŠÏo5šå"&$`Ìý«Ú ¹É8§NE(³xâ{¦{ÿ[Þ=Ð$4UKG©Ÿá'ÂYÑ"Áà5`L€ 0&À˜@•ôR´Ô7«‘*Ϫ3_ìyóæ+{`Öäß—ÜJÐ ß¾ÿBSôäädeSlìÀYcO>ù¤$ ×#†€S§€^ÜÉZ„f9’Ïáú,Á-ƒE÷®\¹¢ÖM)ýªFºZ&Þ1šÀ±cô;‡©(Z:ŠºIyG³cY&ˆˆXôæ›øÕ0O€{Ý`ìÞ½[Ìæ' Ï~ýúé­ä§Ø\äËßÍÍ,Ì+O(¸·$4Plj!«Ir}vï½÷ˆm©Z“û%Iìí+bIi¼fD€ÍoB×s¤X¡xCäÆ‹&×´G—I_/ûJ¸U" RU1åý—‘!ïÖîòåË iÉ¥ÚSl×Õç×}ç:ªÿª*´åÞ3²PÑ'‰¥eÅ÷º”fìýolyÉÝsf¦ü;R¦ŽÏ”Ô^3&À˜`L€ 0UÚO¼ªGyÛ`dq± ™TeóæÍpÝõ¼ˆqGÈ5™Ð¿õöÛªYŒÞ¦AðE‹a,–×Dœ îH‹$dÂOî¸>øðCÙ[R¾Ú^“õD` b6qÇŽDó©©iФIceW¤ô´´t‘^XX Êã¼açΟA¤i0& ã"8âìqr=EÂñY†zÿïÓÏ>Sö±¤¤RSRàÂÅ @±X˜@m Ùòû0ÙСCÑ}ØÈ*¿;(vØ+/¿„JŽ{A²Š©~j¶‹QɪK€&ÛlG‹.Zèùf@ÿþ°`ÁëŠ$88Æ6l­¾&ï¿Åw¨¦¤¾|~kêüî¦z¹ådìýolycûÏå™`L€ 0&À˜`EK-ÝëÖ­‡éÓ¦‰Ù4ÃÑ›¼åMm†Cè4» ë ôÒáïï'^öé…¿_¿¾8[¸-<8ñ!HJJ2yûÕ©f ÿ…±kTåá‡'-š2eÊ£@ ¹àxƒW²˜–ù£&ä‹:´M¡°ëØ¡ƒp5B-ɹ„0m¸6SX½z)ªá:˜€Q¶nÛ&-}úôÕ¸Ar•~ðþûâ÷‰Ž‘&ÏÍËUfmÊÞA膬¦%..¶mÛZi3g0X2 ЇMp¡‰7™èºuÕw+E‘¡CëT´4Ôû¯¾|~õ¹&œG†Þ¿ú×,ŸÓØûßØòò½âT&À˜`L€ 0&`V´ÆKgnUÓy¹LôÂ'-žžrYDšä®D3ƒ™Š»”ÊÚ"—dk0(+-$VVVÐãm<7ûY  ¨¤Ø˜ôÐD Xù…fu²O@—Ë]‚…àlO²Î)E^’HéW¯^…2ôÃ]èX:ÎkÓ 8-¤h!W mÚ´†öÚ‹Êéþ¥€©u%–xKR_ mòºàë×@.” »I”ï„ܺÐw }×Ë)\Ú R—&œ8fÍzZô…\ÎŒŸð H£ôçž{^¤gáŒP)ýµ×Ôy¿ïÔ;^ìž|Êwh¯pçFqsèÔ•´C%¡$ññqÒ&¯¾~ äB™°›ôÛ³s×.Q㨑£t~´nÕJÙ*Å#¥®¦È)h4ó³On)I¼¼<©†ËÞ…:uê‡ËóÏ+žW*ߟ¯u¸!ߦþüÒdIÌÌùEbQSkSÜ¿’¢ƒú(½ç¨öWõ{5;;[õØ6öþ7¶|^^žè‡—WÅ{–j'½½½Uwy› 0&À˜`L€ TJ€ßb*Å£ÿA¹Y\ª¥§¢Ë+) .¦× T*ɘѣ¥M±&%ÍÈQ£”i—TòJ‰Ÿc\†Õ«¾ƒåË— WaRº´V¼¢™ÅõMBBBD—®¢5‹êK[ppK‘~­YXjžÀÅ‹Å,tj)44TXµÐö±cÇiU'Ó§OW¶½wï>å6oÔ|ýêÿ5ª©nÛ¶]TÝ­[WÙß%:Xv»B±¢: §Ú§ž=º«îš|ûÒåK¢Î&Mš(cR©62pÀXöÕWbéÛWa}£zœ·ï^7nÜP*‡®|ÎS%2hÐ@eú•+ÏzRž†|ÿ™ú󛚚*aAW·í”Û¼Q3Lqÿª¾ÿŒ£þþB½‰qº$!«AM1öþ7¶¼d%O1 ûôî­Ö=Rò6\-w˜`L€ 0&À˜@eØuXetªqŒ\.=4q¢²¤½tëÖ¤"RxüðÃÊãÒÆŸ§äþûï»sæ¼T.<<ƒ‘;Á¤Iä>‹, .\¸ S®ée ,,Lì¿÷Þ»ðã?b–dX8ÀßfÌxJ™÷ôéåv}ÙP*T._Që’ò¼5ÒÕ2Õƒ®]»B_ŒE I[TRH2iÒ$2xˆ´ _-[………Êýú´A÷ç‰'¡ÿ~ЫgO¼ÿE÷Ž¯\Ñbªó'7³fýO´iŽ F¼wÉeµµµH£¸×q`‹Å´øú™–'צ pôèQHKKÀ]\\d±œ={N™þðäÉpîÜ9صk·P¸{xxÀ´'ž€¨è¨Iùõ×_Å÷7MjøèÃàÝ÷Þý —P=ºw‡¹s_ê?¹…Z²¤æ‚Š×ä9rÝ5C€ÿþû/’ÅÓÃè^Z»ö¸|é2XY[áýÓ-t'(ÿù—_•ÛÒF]ßO=õ$8:(~ë¥>IîÐœœáÅ9s¤d±Þ»w¯Ò•¨©?¿dMŸ3z–?nx¸»ÃÍ›ÑjíïBK¹ˆÓ§ÕÒx§zLqÿJ-Ós-½ÿ«ã}û ëbK5j4 :Td¡I^{ö앲+×ÆÞÿÆ–ß¹s'N*j#úóöÛoá3ú×pcqÑwþÔ)SÐ峓²¯¼Á˜`L€ 0&Àª"ÀŠ–ªéy\²Â áyó^•-EÁÆ?üècå ªj¦ˆˆÓWå{xlêT1¨üÜìÙª‡ÅvºÕzÝfIm©fø -Z:`< r;6|Ø0±¨—¶cbb᧟‘vëÍ:¸<>‹¦åJKeºº¦Þt¼¼#mÛ†ÂÔ©Sd»5Je6eøvåÊz«h¡þQÐ{R´HJR¾Pì„ÊÄTçO3žªP ª¶yðà!X¼˜9U™˜j›¯Ÿ©Hr=ªè»ãŸÿŠ¸`ªéªÛ“ëï­[a4ZmÒïç',b]‹%gggñ{·nÝzxôÑGT‹™t›¬äèwñ¡‰BPP|ûÍ ­úé\Þ}÷=ˆOHÐ:Æ w7·Þ~Z´h!¬¡HÙ2ç…d¬øæñûªy°®ï¿ ã'èt›gooSÐ"[URRS”ϱ¦þüfddˆ‚/½¨PîÈ)YcccYÑ¢zAŒÜ6öþU}'ù3fÌ‹f·Vâ³oJJŠf2{ÿ[~ý`ìرдiS¡\ymþ 43KÎZ‚Ò¶lÙS{LéJ³ŽºÜ¯°\Qw«"ºu¥ž[´Ô%;S·­i½BT;§¶…îû$´ÊÚà¼2÷Uxú™g@ο}m÷‹ÛÓ_?ý8Ý鹶£ZU²pá"X½fòómee%”,‰‰Iðê¼ùpðàÁªª0úø»ï¾+~£¢¢´êŠˆˆ€§fÌ„ßñwœ… h øe“&? ß|û-Ð=«)d¥õÆoY†3åuIC¾ÿLýù¥íЊæÔ©Suòì¡ëÝ©éÆÞ¿’ë0²BZ¾|¬]·T]S\–Oq2Ø×xL—{ÿSžž+§MRk&À˜`L€ 0&Àª$ðt?°µlG£ `ÿµâ*ós&À˜`L€ 0º#ÀŠ–ºcÏ-ß…ÚµkONŸ5‚ggϾ ð)3&À˜`L€ 0&Pöþæðh7W‘mÇ¥¸ª²óq&À˜`L€ 0:&ÀŠ–:¾5Õ¼Ÿ³¸Ù5‚¼âÛ“^E¥5Õ׫/‡&N„¹s_²fùsÓ&}‹U+Ÿ§‡¸»ÙBqqÄÅgC~AIµê©n¡ºn¿ºý®/å:¿†Þÿº¾¬]ÁÞÃàömÈIŠ…¢œìZí’½Ø:¹AqAäÄß‚ÒbžA[«€3Š€ƒ‹¸zYÐÇÒJ /›­Gj`aæo 0g÷u2OÇFPXrb3Ê §Ð°<ay3(*/Ÿ_Ë_ÿuݾa´j>÷˜¶ö¢‘˜ô"8Ë/s5Oœ[`L€ 0&À˜€qXÑb¿zUÚ¬ÀÄ0[˜ÜÅ_’*.-½lí¼œ _íÍ‚Ô<y¸ÃÅ˹Lèû ¸96gšœ Ë·Ž¯Ó³mÓF©d¡ŽìÙ½§Fú3t`<òPðsRÖ_ZzŽ¿+V‡CL\ÍØV·ý.}áí…C”}Öµ~*^[¼S×áŸ^]~¦<ñfM\`ÁÜþà﫸‡¢¢3`Æs›õjÂý7¦}]ôõv€5Ëï‡g¿¼.G¦êÊZ­ô>/,†&=Cô±½°ÿ£ùZuX;9Ãø•[Eú‹Ÿ…Äs'µòP‚oXOè4y&¸µª8Ž£Å‰—ÎÀ©µ_B2®å¤Ë´92|œÖ¡’Â<ÈJˆ…˜ãûàÒ–Ÿ¡8/W+2­ìZyBï vn^ÊäÒ¢Bˆ:ôœÄö ÒÓ”é¦ÜúŸté4üûÆ,­ªüÃØO7ˆô-/MÌèkZyŒIè>c.´|ÄŸ=»–õót}üy¡d)-.‚ìÄ(ÊËs+kh>`4Œùè,V65 Rÿéâ‡ý“΋Ü.šZ¨]ª_gû¦në39ž£]„²‚”,4@žžX(” t»4ÃçŸY…@Ûž ÍàG¿óð>ÃßKC…~—¨,-íû¸~d´D:.wûRšt¼²µ®¾©¶¯ZÞÚÖ¼m¡ï}>0gYkhÓ]þüá9«–“¶m, °¥Œ˜/. 7oÝßoÆð×Õ©ªkÕïOºÎ{O}"{´äÖ%ÝG¸‚* ŠPiql{†Z6]í[bL *Ó¦»+<ñfK˜8Ç¿ÕŠÖØN°—<ØÙ,ðÞZq0½J%˼aNðÚp/¡d¡çÿ¨ÔBHÏ+Åg`€^AöðÃT$ê~¦ G{ %KAQ\@ÕAåûµÀ‰ úõ©¦¤.Û'ÆùE·ëAÁ¶j§H—»?ž^a™8.÷j†`ªÃBîíV›á;ƒZZƒ½5ÆtÄ{}ëyu­áµq &À˜`L€ 0Ú  û©»6Zç6LF€f² QÌzZ}8 ÖàÌ»Bœ¼(^ZZÂ#¼À_šç w…ç~3íŒ+“„YYؘ}ÓÑ¢–+±û 37º?dD­¦+Ú³GQYô­[ðâK/ã@På3 m¹C[/˜8®(ö÷?—aÙÊp e Ióf®°hþ@ðóq„y/õƒiOoªwíÓ@I¾M>>ë±-÷¯gØÞ‰R××ÏÖÆ^x¦' î$ð=‰É9pÏ(ËŠJÀÛcÛ¯¤k â‡t}âÑ׸ÓGáðWoA^ *YPœü›Bß—€[Ó`è5ë5Øxú8”ȸ$œ;‡¾\"ÊÑ?+'ìÖÚ=0<}¡÷soŽמR—6š M{»§]ç7®ÒBô7ƒGÝûCïÙo€­«'ô˜9v.ž-ã5¨\<Íáž™MD_®œÊ„_>‰†ŒdÅo…WcKxd^3ðkfžo W#.@a¾i¥Áwúý"åF›Ž±WÿÙç7/äÃûÓÏ+Yvèë #¦*fÙ«¦—¢ureu!~|?J™Å '/ÛÀÈ©þàæc¿ŸÌº¨Ó²%òLüòñMey[Gsíé ƒ&ú«·5Lz¥ |õâuåqiÃXþ›VÄÂ?k¤ê´Ö½Æ¸ eQ*4ÝÀØ• Ã)ýëÿ€;l]¬UÞßtúS(‰÷ÿ™ óúkòk„Ï%®Þ–0`¼7´BKq²JºU»5­E¤f‡éqèÕ¡î@:¿³±ùð×™Í,jûñÿÞr‹‹õÇÒaåáÜ}µö1ƒùÃ< ¥—5,í ÷¯åJ¸S@E ?ÏdÂg»³”å[xšÁû÷z¿‹%–÷€Ék’Ä ¿ZŒÜ©ëö©û×S ¡•·xZ¶¿Âr©­Ÿ9¸ã»Óá¹Ð³™¼¢ÒÈÓ¯´ø˜vâx8ZË$eWþù¯´">Ș`L€ 0&PkjnzR­7D&tR˜µï¸˜…³ßJJ§Çò=W‹á“Ý)´ ݛڃ×hÕ2ªëëBÉRv»vœü6ì™yEê³€ügccÆ…éÓž€G~ºví ÖÖÖ@éç·e_ ó翃 ‚WçÎ…¹¯¼÷Œ vvvF÷jÌÈQÇ¥ËÉ°ô«#J% %^»‘‹ßÛ#Ž7 t7µÛ¾¤h)Ū˜ØlKJjž©»^/ê3–Ÿ±'1{fw¡d!7s+V‡×–섬lh×SŒí¿±íëÙÍz›­qÏA`ni…9™°÷ý¹J% u8+6 ö~0Oø@²vtßN ¥­ÜÉ”@nR¼rI¿~Îüô-[½Td'ËGß@­¢­FMi7öÿg6¬P(Y(·Žìcß)Êûuì¤baõ‰@»>N@ÖyY%ðýâ(¥’…ú˜] ?,¹.¬\ì-!8¬æKc®æ,aƒ ³Eï|S¬\²ÑYÕtŠ7S™á¬{r«%-)±Åpjw6,{ù*’‚”@½ïñÐY¹ “ÊÒ:6²v¬M†¿–+”/däáo©UÞXþÙieÊsW=_ÚÎÏ)…®C}þïÇX-÷ee¨OÛõk¼èS¯±>`ë ýZ6ÐcöX äM—hò#Wk‘ù°rA\ W2¹ æoV(ý›º[CÇÓÏÏ«ëöé¬uLß„–Í»ößJšå®^KnÄ8CËîq¶Â—¹‹³5´V”¿‰®Æââs4‹‹ýö¡^`og Åè÷=Θ`L€ 0»•À¥hqr´‡ÐÖAàáî¢u=KqjXTt\¹ %¥U?0kUPÏÞÀH’s8  'äFŒ†°éAÜ¢æÆäš®•´È¸ýð÷±%èg9³VÚSm¤G÷îðéÒOÐO¸öÇÉ 1;w]kÛÝݾüâs˜6}:DDœÖ:®O‚£ƒ"xizºü‹6ÕAÇHÑâ`_è”Òsr‹áñGÃÐŘÜŠÍ‚§fÿEEêŸR²|òîHáýÛïOh)ZŒiŸú`FòQŒQ´û©çgõ€Áš«ºqõ–””ÁÏÏÂêu²Š(Êdg‹åŸî ƒúi•'åÒ†ßÎÀNë,/ªæ?cø™âú‘"éÓ¯@vvÕ/ór§hLÿ©>cÛ§:H¹²äõÁàƒŠ6U¡XE}~P5©Þm—aLÝ3áw.*é¬FïEýä®]•¢Õ‹¦ì[º@$¥\–WR 7bååIiQß$ôþG¡Yï¡}t°Ò쟥= šÿ‰HÞ±p$ž=¡™Eìß.+ÿ.½¡ß‹ï€…µbðQxäi¸¶ço8òÕÛPv>?ÈÂh@‰¥Å ½*RtÉŠWoè:d|º¢yQÏù#éЩ¿;tè뇶ԮUme'’‰®‘Hpƾ¡R‚|Ë?þ@VšRSü·²†.Ct.¿¥ò·@_Ÿ{O€±O6.ÆömLU*ÜÚõrqj¨ß{7ª(`4O¢Šý´„ 儃PlTï·²Šfà…AÎ"&GRv |{H~Ò‹f©¹¥¨t‘ÿn¦ÉX^ŠëNy5ÅÑFñRŠÖCºDjà ㅘZêº}:+3TF£ËåÛè>Ì–È…fèzÏÕ 6¡;5WûªÏ›,zYÂ;c½Á-ì$™…[ÏgÁ;ÿd>Šê%TzT['‘÷ßËYÂteý0>Ñû÷*\ÄÉå#EÙë[RôRÜÉ•ç4&À˜`L€ 0ý Týä¨]uš³I ôíÝ \œàjd4ìÙ¶l?ÛvÂÍg!9%’ Ÿ0pt0ÞUSž¬Fã¤DÙq ]<à’¡Ã÷xK b)=öG§ë~™Ò¨ºÁìF\ßT'Jr öæ›oÊ*Y wäÈQ¸xQ{&¶¾uH¢+3‘fõSàNU!%Ä{Ÿ@‹¯2ôw‚G'¶W=,¬ æ<Û[(.\L‚Ÿ¯ð%/e4¦}ªÃ\ŠÑBoª(n®¶0|pL| (@ºŸ¯úà¹È¤òNéÝ…C`È@…’åìùDøeã9øsËE¡<¢@è?Ø&MPıQ)*6©üâ× ÷Y´}áR2üöçy x7±ñYè–Æ ¦Lê=ÜQ³¨IöágŠë÷ÏÎkÕV²cúOåmŸ”do½¡P²”áˆà¡#Ñ°fý)ø}ÓT¼ÛÃÃ÷4µYŸ$ùÊ9Ñ÷ VàÖÓä]óîÐM(YÊJŠ!=úšZý¥huwsÿ±fÉ+ª]ЊEÒ>fÅE«•¿“vYXb<š…ŠV1§Y çþø2ãnŠSl>`4t˜4ãN:Ý;æ\¢.(fŸ4·‡Ö]ëàù3H,­ÍáÔN…ÕEØ`…U‚âHÝÿw)·zÎÃ|C%¸“øø—à tB”Ba£ZGðG¦÷Ï ížÃ¸ƒ—OÈ[kKý8üwšpG'=GWXzHaÍrt{ädè9Ê-Uª²vPQbäU¿•*µ6{4µPÆZüdWŠ2NŠVF„¿Ï+2£CQá¢ýZ7«¯£øOË-ƒ×µDå·¯¬5‹Ô)ÚHèùÈÔ"U©¢¯Ôj¢&Û—£€öÇ¢r…r…”,}ƒÊöÝWòÀÉF›«TNbb‰åŽô„ °òP*¬Åx97Ó¼G¡Û½§zëoÚ)ÐüÐÕ!É–s•ßûÄïƒûJz8Šç°1"~Ç库+F¿qdôé8o°5\Ï*úÀÿ˜`L€ 0&Àô' ?ýIÿòõ"g€Ÿ´oÛ]ûdɈ‹Ÿ_ñ"HÖ+É)bñõv‡Žíƒ¡G·v°ÿà)((Ô~á¨'TßIáÃùjr!}¬™—Äèv½¯rÔ¨‘àããmT?£¢¢à¥—_†Bߎ8ƒ1}®Ó@|Ur=*] L?9µ3L×vïJ#™2©½PÀ–Â{Kèí†ÉöÍ)ê+ Åh:0^šÝ•W/¶4x¾iË%X¶ò¸¬ÕKïЮ­â:¼óÑ>ع÷†¨þQÝ‹^½z4†ÉÚïœîÏ”p£OÏÆÐ Ý…‘|ºì0lÞvElÓ? s3xù¹^B‰ó²ùûQ“nĤ† áW×OêGu׆ô¿ºmHå†jŽ®âÊ8ŠG´ÿP…2`íOðþ›Ã¤¬õr{lŸÐwökç~7o€È›Õ\|U«ã8D.³z?»@¿ø÷ÏP˜©ø\RŸÃ%ýæUÈŒ¾nHÑ•×38.nùNÿ¸\ÙoÚîÿê‡й7´óœÛ¸Šó*øRæZ!páhŽp-åh SÞh þˆ‡£ÿ¤k¹¸ª±Î”›Y4‚Ë'sÅ€ÓÖŽ€ÞªŠ«Rc}R©ØÝ×ÚöRXË‘{3}…C:ÛÁƒsš‰"7%È*+j‚·aΈnœŠ‹Êà¯qUv¹ õöa ûSpBÕ8_8øW4 µ…À–ø töüš\e•eè2T¡¼)FëžøëÚV••ÕçY¼<ÄCd=t=WÄVÔ§åÙv¾z5ˆ!­áT,}¾7¶](D+3˜ÕÏ †bz¶/Úš¬·òƽñ N®¸|^–¤LзOÆæ«‹öQ¯²ërômá½›Ù@fvn»Â£K KE¬¹ó’”@¡Wçç“"N¦”oÅ´4qƒÞ¨žæ ßÍ…\=^=Ç´U(eÈå||å“ソ͠…§Â}âü¿´îγà+Œ-äá`a–¨l«°Î’úÉk&À˜`L€ 0ÓÐKÑ2vd_ÓµhâšþÙyÚ…¶€ìœ<8rìl¥nÁâS¡øäèѵ´mÓÂOUß‚ÀħQ£Õuil4›Šd5ú f1ý]Ù—_}…ÊÁ|£ëQ­àžQ!0{fTäÃÌç7럄,Uzw „6­½PÑÑ žyi+4oê Þ¯°Y±ú8Zwd«6£sÛÐö¥-ÖVð̌ gÎ%‚%*[Â:ú«‹ Ü?¶5dfÀÚŸ´Ýecàö•èÒ,ß`U•,ÔA ð¾þ×3BÑBîÅš5q+‘ŠYÇÒ ôêÞXl^¾’¢¦d¡Ä´²Y¶ò˜pIFÊŸ°¾ZmHõ˜jm(?j×”×ÏØó¨Nÿi³S{Ŭåóhq¥ªd¡:³sŠá÷¿.Àü—úÓD–%wT{Þ› Ö|¶ÎîÐö©b!ë“è#»…۪܄ª}Ûw…q+7‹¾’•‘¥£pU˜“ 'Qapþ÷5Ÿ‡O».Ð|À(Qî̯« .oHæ­áþ嵊42×ëQE«œ¡ ·ñ:œEKU¡ksò‡/…¢ÅÜÊÜ[†BÂéãªYx»Ž K©5o]‡™ïƒ#ºø ŸX¢òàÌÁt8ñ_:P`óÅ<Têãï 6±/zñ†°.ð߆껫2´¿Ö8ëÞ»IÅ”usTüb¼‰aøƒº|*Ì/…ý]—´èä Ö)xÉÚf©\^V lû>vþ$.¦æOíG? º¹ç·x½•U¤\0ÞWÜ;Cû~ åÒ‰ÿ’!3¥òÁj]LlìÌ ß8wè9J1‘#üß$tŸ¦+wõÓïa/±¢"ç£ÿÔŸÓg÷wÏð±ùðê&mE9éùÞø;'QÁÔînÑ f÷/{t FsXnà`ý’í©p¡Š{©÷ã:ÚÀKCÚ+ܨ]»¡®¤‘Ëolš¡ü¨=S^¿ºè¿1mº»*ÜE^—¿6‘×S©¾VÊfÅÜ€-sŽ“fBP¿@ƒú®›‹¥ýø'àÜŸk!bý×t¡uöÇÜÒ ƒÂ{i7·°kG0Çø*¥ÅÚ1ZÊì}ü ßKo 1Q‡wBô¡]º²š$ÎÙÁËß$uU§’t´Ö)+щʼ¥H§ø4¶®žÕ©šËÔ0Ä›Åðɬ‹0ò1è8ÀC(|šÚapz;2É-â`ÛšäÊ>>Õï¡ÆGòä®t…¢e{­*Zš ÍË+Beσ”,kß¾éI꿪™-q ØÙCû÷Ñܪ7Çgmœx ãëÔü‡=êöè6)=©vÿ¬[1¤ÚwÚ¦@÷‡6'À ‰þ0d²?¸xZ‰çˆ]?ë~6P­#¨¼ñce=ûØ¢+2éù$Ý0mù6AyÜTäîë‘n ‹™UGÒ . GçUÄ•].væà€qDt ¹Œº™VÙøldmiN¶Š¸+”?.£2 P–ôiŽ®â°œ;*ÚH1°7RÇE×Õ#Óëª}r–ƒJ´c¨ % ’ÝháBbI«*äÆA’,€T³Þ@/%x¨~¡ÑþQÍ?8ÄZÄŒ!ÅÍö UOÂJÍS|¦©‡[ZÁ¿—µßóò´“T›äm&À˜`L€ 0ÐKѲyÛ~6iÚªz¢0R–¤¦Éû–—k-:&Q(Z<=\àæ-Ó¿4ɵYi®¶Ð'¯§xA£moÿ£>K®.út§µéââlÔ)å¡ š‚Ó+ûvìºÚù@BR* õî#Y¬¬XÏý¯Ì|¢+X£â#­D>üì AT†¶Ý”ýˆV'ä$üÇ_Ï*•,Ôñô_ñõwÇaÅg÷)IZ{@ÄYùs"¥LË WpD¿ÒàÕaoW1Ë—ö5ÅÊJ1(QT¤{j×¾(Íb5¶o(?©#¦º~R}Õ]W·ÿÕmϼ|¶©®ëW„îg‚¤§Á‘eï@øª¥à‡±Zw]û€¥=´C+3œ2òû/tžJ¹phÙ[ÊãVXέ\:Lœ¡÷< .A°ë­*UÖH…­]`È‚OÁÚÑ2c®Ãá/—H‡jl áß-ÕªßÎÓz?³@+ÝÔ ¥U[‡”•)Zha©Ÿ²ÓËà—¥q°iy<„tÁÏLohØ68HMƒïô=±ù[ùߣÎHc 6êb¤%¢ë&te€Ÿ1WußWFµ«Q˜¬7‹Ñ](I#Ôµ.l?ñ>¶¯‰¯TÉBe"Ïd¬Å@IDATÁ¯K+Ü.ZÙšAËŽö0ìaèÿ€/x7¶…ïDé|0Ÿ¦–BIEýÙüÍ-ƒ­GönL…>÷ù % Õn´ôµf²@‹'7mESNF1PŒ—ÿ6$C±‰­YèÖyu¨›„'7Q?†WÏ-á3ý„²†,bÖal?Nça¬3´pqJƒþ¶ð̯ñp)±êßÂmó%,Ðâ3‹àTLåJblj©«öñ##ä÷ˆl(FŹ²=† \é˜ØÑñ¯]Ôé:f K²z«JƶU¸z>z#W/k¢ËxMé¯ÆaY2ÖîmŸdýt#¥"q‰N+«4þNUýáãL€ 0&À˜`†hð#öv¶Âm˜!§MnÆHìíl )Ö òÒ¤ý¥ã= 1¾4¦ ùÿó¿%Ïhª—ÐÎΕV&ϲkß g…¬ ²\=<Z)ÜnüðÓitåeØË¿¡í_ºš ´è’k7ÒE¬rÝåéQîÚD%3Í<¥@õãî Ê!•C rÓP~ª'iŠë§Z_u¶éuÚ»ÓÊ”ä ë² ±²w€î³æCÓžƒ¡Í=“áÚî¿uÆI)),UcäÄ$=ê*$]ˆ€Qï}þzB“>CEàûʘYØÚÂàŸ“oÈOO†ÿ–<%&vo(×~Qn$œ ×:ääßD+˜€.…ù·áÌþ±Ø:ÄÁøçý¡Cwè{¿ÿ7 º›x†¾æÏ,îŸÚƒò‡°An¨hI“T•ÿºúnLú5T”|3 o__Û-Q, g¼WfÉ"µIJM¥D<O¿q>ž]ÚZuqý!bOå.Dá߬@aE{õt&œÁø†JnfÝ–}ïS¸“Üù“þŠµè+9°ñ‹ EC~¶~ì í§”¿)]ï`+v?Û“&k!åÕµ~]}‘E »ŸõK"D¥*”)±ÈâHT <ÞÃfàýÿÙx˜´]±åiÞ°ê5ï¸Tÿ]ŽÔ3Ô‰Ôuû‡nÃ!|æ¬ p1ƒå÷Ãf=܆Qé:½üG ¼{´ô²†.MìÄ"õŸî‹¿ÎfÁjtkÆ®Ã$*¼fL€ 0&À˜@ÍÐm‡^smš´f333€5lÆU)Æ\ ¡²w¢Ðäüîu‡VÞ6…î"žý-³ëèéN¬rNééÆY Ñ=صKW•M·Y% µÞ¶µ'5S¸± } NOá •ê¶/×é‹ŠÉÙ5 )[4åÓºŠ@÷–èZcçžëÂæ‹GAZ(~KC“êò3Õõ3–Wuûol»wZyR>út¡Px4jdÍЭ˜¡’yâ"‹b]ûVZÜÜÒ¼ú¸µŠíòï¢Ù—¬ÿ`e¥•óA&PËÈÔ†÷oAf*Z$á´tŠ›brÑ°h¡úOîV<tìï&Üx– ¥Am ‡?ü·âsÛm˜'Æ-ÑþÝÔ·?·ÐÑåŠó íi?Cøw@«ŒíD\µ?—ÅèÛ=­|±‘Š‰!¸ž\šé+¹¥Âúˆ,h‰»V¤—‚Jßúåò©z¤òv²À öhÑ£±x£²L—ÐãГ½“b¾@E¤dQÍ¿úHœŽÉg´pš„–^úˆ¦’¥svôiFgžºn_gÇjøÀèP…ÒÞÝàý§¯Äd”a<$xæ—xøþh¾ž ™Š{ßÍÞëáŸãä;},sôm“ó1&À˜`L€ ÈÐýô.Ÿ¿Þ¥ƒµAý²±Q¸(IJwšÐCô¢Ñ.b6SºË™³1ÍÇÔwÚ¹Ö‡ó¹y||AR«ÛŸ3ž‚C‡ãŒ×ê_'iP»²—( ŽMRVÉ3‹Ÿ;§/¾Œ5‚w_ƒ.üѲŦLn«ÖFèuK!éö­ìgRú «äñÑà¾Kêº}©u½¦ç÷Ñ¡ ·aÿ\D÷eº=ÙÊv•”Sáøž²gðth3û:a½Nâú÷@×|d±Ã˜`L€ 0&Psj÷­¯Î##3 \œÀ ƒ?ê+^ŠÙú™•»?з¾ú”ï•¡N0(ØQ^œ»)ÎÅø¤^ŸN¦ô%âÔ)£{Ù¾}{˜÷ê«FYXå`݃HÒ±Œ Ý1aþ7­ øù8BfV!,Ǹ(«×+ÎoÒøöÐ&ÄCç¹Û¾·—=4pWyw~dQCñbHòòÕ_[4sSÆcÙ³?JäÑüg^…cìÜr¿zº•¶ó_ì oÎÝ»økVoô¾±ü¤T÷úIå«»6Uÿ«Û~!&Ñ‹ÇÁ^Ûï~uÛ’+W’¯˜Amëâ.wlœ+Ò‹5\pQ,”G~?,Œ§¢KÊJçx[sª¯®év®Š>E—tŸ1]” áwð ¤\9§+k½J—ø[Ù+©4;geï¤L*ƸXºDWyŠcn­øn"÷l,õ‡€½³|°µƒXZvÒýûWF‘¥Qjb XD—ArrgŠHí<ØM¸ï’ÉR£I3åÔ.E0ù£¼ÁÖ¡úü.Šgì¢õ !¦â?è!Œ'ˆÁë)ÊŽuÕWÕ(Ш¼ÇÄ)6KeKŽsÕnXc\C¤<Z‘œòßO7¨]írǽüXZyàuå†A×Dû:ºU£É6òŸ/²:²¶T£:º¤Kc ðrR(2· »>SHrÎmx{{&$e+8Öþð=q—(¬ªÒÈk©"ËÀ¾Í„›ÍüÍÑXãg‘|íFšæa±O „Ñ#BÄöçË@Ff!lýç Dœ‰Š ²t‘”šÛþ´)a°úëûaá«4«û;ú+Ú‰º©pa"eTw¶–EÀŒ¡è­2¹Q^g—N8û·ü…X5KŒW3x@ôéÙD5ÙdÛÆò£ŽsýŒ=Sôߘ>ÄÅg‰â;ø*•nªõuÆëZ“’%ªwmÒHq¢)¾»‹¤Û·Ë ;î¦Úá¬L(ÌÎÀÏ­4é5X혴cne…ñUzˆÝŒjX˜Ø{ù€ä2,õÚ%©Zµu‡É3!xØý8]û?[ ÇÔŽ×çôèk¢{-Úˆ˜6š}õ-gGʪ¬¸(ÍÃÊ}7¼~6® 7<ÊDÜðF]’œ„X±æõƒ@nVäe•ˆÏ}‡~ÚŸ=ê¥%êÏC:+Ž%ÞÔ­h4õÚ“)b³´E×N¥• °šº]Õúöüž,”K6hõÐç>í{[5¯®mWosí¡˜ sU}ØüÝ}-„å µÿ÷ª(ÈUWæèê×Ê°‡V'UºüwE÷¤°,/ Ýo-?Q„”CC®[éêU(ñrb¡86$Ä^VgØ›0Ð:É•díòâ€Ê¿ùÃ`ßó°õ¾Ð£iÕ“àLݾJWju³…§5¸Ûi+¾H"Y›Çfêžü6¦­Â­[dr!^ý?£ÚXÃ+CaJw;Ùó¥gä¢r×»ªÏ˲™9‘ 0&À˜`LÀh ^Ñ’œšÉ)éТycðóÕ=ãžH‘îŽí‚ÁÁÞ.]¾Q© %£ÉÖr÷´³>x©Ù§Ã…øðs2“]\e^j¹»&oÎÞÆ \üÕ[KÅ,fs3 µtʧý*T½.ݺu Nœ8Q½Â¥¬­­!;[÷ µFvµÝ-Û¯ˆý6­Û[ÔqàðM,ChöïG_²ðs‚wQkWÚ1¶ý;#EUíB½aÚ£Ð`ÅËyp 7xnVOqüjd*žƒº‚ô굌Ӥx)}ò±ÎjçN…Zµt‡©“;‰òºþíØ)£<ÜíàWú«YÖ’jÞK}EÑ´ô|8u&AW5ÕN7–Ÿ±×ܯùz;¨-’ÅÄÑ<&¹‘NØØþÛ>ݳ$¾ÞŽðü,¼ÿË­Ÿ(­sG_[®@¤ýšèÃ;ñ-ll¡ç¬×ÀÊ¡BaêÚ :<ø„h6îÔ(ÎS¨¤ïÊŽMâ8):HáAÁè%!% ÅL±sómÜسU:¤µ6³´B×`žÊÅɯ14r ûì›öAäj•£<íÇ?.ÒÏoZ©ÓÅÞÛOv±vV ¸jUR‡ чvBiQ¡àßç…%jü}Ð Z§‡gŠÞÝ<² J4,ŠT»]\}ç¼­¦,sn=fÎÙrS!ýº¼¢JµÞ®Eøut»â7­ÇHo1Õ¬m+~áIIðئàìa%b„ÿ—Qiç,ѽ—›E¥ ¹¹ÒG2SJáú¹l %‡G€¼µ&ÕCŠ Õ6í1V‡$ªé.ž «Né˜>krÁ%ÅWé{¯ÍòèbÌÙÃ\¹xXB·áÎðôÇ!XÎ(æÉÑí5LÀäã¾8Á¡$ßʇëgsÕX¨ž?m«^[Íþßû)¹·adŽ8õÙ<`|'Poâ‹ïïÝã*‚¤S¦?N+òª²úãŒ"­¿-¼„öÖ·4ó0à ëžâ™ùZÞœ‰Ñ­( :;˜Ã=휔;äùU+÷LÙ¾êyÕövºk^<Æ \U¾‚ßÜ¡¢+dUr)QžS÷o©xnø¿3 Gsx £ Ìèã÷¶·Õ0†–ø•ñX;pUXõ^ˆ/2¤j΢`L€ 0&P *ÓÕ(]OŠœŒ¸½ztÀµÖàæ —#£ñ…PÝšÃÙÉ: ’ÅÙɮ߈[±ÚƒÍõätªÕPߊ7ÿGº¹-ºd÷•˜÷Wº®Ã 2}d—ùжÉÙ¾»;6…çïýGíØÛ?uAÿǦqóí·+¡sçÎjõWggÝúõÕ)&ÊÐàÿož‡ñ÷…Â=£Z ë‹›h¥ack Íš¸ % ¹ÇzûÃ}B¡ ÙÐó¨Èpw³…¬ìBøìë£j‡ãr໵'`Öôn¢îCG¢!<"^-±í‡ŸŠ‡-Û/ßü`{˜p[HJÉA¥‰òƒ„\†}øùAµvi';§~Þx~° @‹žv¡>pþb"ä¢;µ&]¡uˆ'løí rŸíLuD^O‡ï<=Ü ¿KCn—®¨¬”J—Rt=ó¶_T$ÿ¢LõTWŒågìõ{vFwÁN®ÿþN°nå8µC£Æ¯Ê7)ÑØþÛþ‘ðX8ݺÀèá!0°_ÜŠÉG½ðóu„ß6]€ñ÷¶‘ºkò5‹Ø°Ây-GúÁ„UÛ!;)¬líÀÖUaMU”Ÿ᫖ʶ}î·UàÕºø„† …GÛû…œäX0³°_`,¾æS´Èˆ–­ƒýÐòbÜ·[d—a „Ÿ¿ ¹IÚŠBÏà¶Ê2Ô6-ºäæ‘Ý°ïƒWu®“ôü´8¾úSè®ÏüÃz!ÿm‰–CVv`ïá#úDJ]ü¥N§^¿¶h‘4î›Í@–C¨üvökªà ±ãxý$nR^×=ÿ6$CSŒmм ™ä&øAzB˜£u¢«—µôñÍßDCrLå3òƒÚ:Áü5Ÿ¹³[õÆU¸pLEaŠÊ]rjWªðN}tIÓ6¶0ãÝÙê}IÃszç1Ã}{~K„V]\Àƒª÷å {×P–”·Ü²£3,X×N¶%%·á§¯AºÌ@±±üÝ}ϯž¶0ouåìYzŽý“)ÛÇ»5ñÝÐÌÝ q0ý¥Ážðl¿ÛŸU¶xÿ{—»¢"6뎥ËÆç81=h‚Öä®®0ìG´v‚k)…`‡Š·æh¥Awnna,Ø’¢´žÑÅÚ˨ŠƒÊ¤ÕtÕmS¶¯Zomo_M*gTªnšé±1 QaÕHX?úŠXº;Juª ie#ò— ÉÉö‹†½›ü‘‡Þ œÀÏÙæ ó„9ƒnCF^‰¸nn¨xQ|÷Ê+ßRÛd¸=&À˜`L€ Ü]îEK*U> íÛ¶€fMý¡q Z¹d@NN.˜á´*Wg\0n Î8>{þ*DEk4Ý]—ÏÖ”9ÇÃÿÏÞyÀGQ|üAzOHO%„zï HTAÁ*VìQÿŠ » ¨XP¨€ Hï%@hP¤A éø¿7›½ì]ö.×’\’7ù\vwvvÊw¶Î›÷ÞèÖÕ|aËÉ“'aåÊUUë›Å1xngÁ½¢ÅÌþ6­%§×¤í±¡¿AŸ+$4Ñ · lú6ÑäLž´6tÊ•'a`ßæ@3/>Ó¦>ñäæiX™[¾\Ö§_ïs Wážñí!ÀÏ Bƒ%¤8Às0}ÆìCmÉD”|Œ¼\²,¯÷b<6ZŒú÷i&v‘°…(¿­8““«.üõ$%_ƒ)“:BX¨—Ðà‘C- ß퇸øt9ÊêKsùY«ÿ,m¹õ·´\:ž4¯f¿·¸ ¿%\QÀá…¥Øÿ±°aËÙ*´PŽ¯ø ²2 Ã„‡ÁÝ?è›R4Öí¤Þû¢WHr½¸6Î~Zß>Z/„3žÁÒñ”GjQúy>¤ÜM›F®ä_M‡Ô£ nåO}ñœÑÇÖ¶„§×­@þéÐyò“‚½O“–¢ 7JKájÅ,™…Y•M0¸ ›ß{z>ö*„t̽Q&ù™W„åÒî͵ K½¨o Z>úöÕs0p¼/ôˆÛÁË!ñL¬û> Nì×ïŸGNkíå‘90BcÃÚy›ß™ØH:—¡án0àΠع2ÈA}e„+9¨w$…3iš ~-ó¯¬uaÿÕü›0å‡ËðP/wÙÆ|qp½Y™©/|4‰”Bø~ol=£ÞÄàó­¹p>³Dq4`Ú-hàçÙ<ø Íà%g둈”Ò¿˜‹%@‡pRÙ?ÇÖ “µVùr~5±¤÷—þLGa‡to&M¢z¤¡& Y6ŸÒ¯M2ÅváuJýiJÀùQ0í§ËèôÞ†Ey€3 »”6òñ³úX6,ØYñýß”r8-`L€ 0&À˜€qDµj¡÷n̈~"—Uk·—› ¤jäã Íšƒ?:¼wt”œþåäæCjj:œ¿ EÅú?4l ú\…ZJ iÓ&ðÛòåhòJ¿y}M+)))÷?qqqú’˜ä¾>.b 9åräãì¶ê ––ŠZ¤aC&ËÑÿFžŽPG_[hÖp“Æžàéáyù%Â̘lVLß1jñþnxqöõÉÿG6έÎ`)¿ê¬«ZY5YWWd ó†âÖº%‘ò™ käÖŠQ ÷ò5Ôn(Ðû™§{¸Øñj~î ¿5cP¸‚óUL dº*" !d£\3}(™,-ßÔòª"½òFŽyÈ0!ã†ð©¯œ¦Âò‡BÅîÿL…ígÍÿN%“m¡X®*‰¡Œ rðÑ—Š}@ë˜`L€ 0&Àª‡@´(±‘ãû›øvI3â90ª&0tè-ðÁܹè HÛt‚¡roâ¹9çí·aÅŠ? %ã}L€ 0&À˜`L€ Ô!Oôw‡Éhî93¯n[‚ZDu¨qÜ&À˜`L€ ÔCuÂt˜¾~»®Ï®¾8ž X@à¿ÿ6À“ùOÃ+/¿ Mš„AJJ*¬[¿¶oÛ©—/C`` ôìÙúõí péÒ%øü‹/`Ӧ͔ʇ2&À˜`L€ 0&PÛ´q†¤¬Xw…,µ­ó¸¾L€ 0&À˜P!P§5ZTÚËQL Z ±B3ÌÕTKå¸&À˜`L€ 0&À˜`L€ 0&À˜°ãmY­HΈ Ô},d©û}Ì-dL€ 0&À˜`L€ 0&À˜`L€ ´ðyÀ˜`L€ 0&À˜`L€ 0&À˜`L€ 03 ° ÅLp|`L€ 0&À˜`L€ 0&À˜`L€ 0&ÀXÐÂç`L€ 0&À˜`L€ 0&À˜`L€ 0&ÀÌ$P§-cFôúq`L€ 0&À˜`L€ 0&À˜`L€ 0&À˜@U¨Ó‚–ªÆy2&À˜`L€ 0&À˜`L€ 0&À˜`L@&À‚™/™`L€ 0&À˜`L€ 0&À˜`L€ 0&`"´˜Œ“3&À˜`L€ 0&À˜`L€ 0&À˜`L@&À‚™/™`L€ 0&À˜`L€ 0&À˜`L€ 0&`"´˜Œ“3&À˜`L€ 0&À˜`L€ 0&À˜`L@&À‚™/™`L€ 0&À˜`L€ 0&Àª@«V­ OŸ>àêêZíesL€ 0&À¬AÀÞ™pL€ 0&À˜`L€ 0&À˜`ÕO èwýúuHNN†ìììꯄ%>pÿxöÙgE/]‚ñãÇCQQ±9ò¡L€ 0ê!PÛï¿ÕC©þ”‚–úÓ×[úÃ÷K¡mÛ¶Òäæ抵íÛ·ÃÏ¿ü YYYÒp„6™¯¿·ß>æÍû–ýô“fçìYo˜1càÃ?‚_—/×ÄÛÂÊýøbûôSOU•ƒCNNŽQi«#Ñw‹A‡DQ#FŽ‚+W®¨ûð´©0}út±ïÍY³áŸþѤ³´ý¿ÿ¶ÂÃÃ5ùÑ }äddd©Sñ°jõ?°aíý¼QNà矂¨ÈÈòˆ²5b˜žžÇãŽÃ_ý ;w"¸ÿT±p$¨þ]»üýýD]Ïž= wO¸G«ÞAAAðÏêU"nþüù°pÑb­ý¼Á˜`L >7n,<ôàCдi †›7oÂÑ£Gá믿Ý{öhâmy¥OŸ¾šê5 ƒÆÃ€Þ ¬ºuëó¿ùZo¶³f¿«W¯Ö»Ÿw0&Àduåþ+·ÇZK¥qQ ï½ÿ>üñÇÿ¬•u­È‡M‡ÕŠnªúJÚÙÛƒ½ÊÏÛÛÚ´i>ú(üýןЮ]»ª¯L-/¡uëV‚å™3g´ZÒºukÕx­D5´Ñ°aCÕþW;'j¨Šz‹=xè¦î]ºtÑ›®sç.štÐJgiûÕ8999AHH0 8>þèCøò‹/ÀÙÙY«\ÞØÛÙiúFÉ’†††À°¡Cá믾„wÞžÔWºûO—o3ÚCÀNqýGEEADD„Våà–|_hˆi90&À˜`™3gÂ[³gk YhOƒ ::¾AÂ]wÝU+p­ýw-ܸqCÔõرcpáÂ…*©7±‘ß+Ô– q?&À˜@eêÒý·²¶šº¿aƒòñņ ëß÷k´˜zÆÔÑôôÂA¡¨¨>ÿü M+InÈ!8£$HèòÙ§ŸÂÈQ£D:M"^Ñ ß–-[ŠíøS§4ñ4$k<œ:}Zo++qq'য়~ÖT§Wï^Þ¼¹Ø^·~=¤§¥köÛ– ÷þý1ðð´i¢~]:w†µ8;Z7P¿DwˆÑ—.%BjjªVkµŸ>–.]*ò¦ÁÐèß¿?À _¿¾ðæ›oÀk¯I’}­ ð††À‚o¿Õ¬Ûa¿Ñu3…UÔ‡¤vùòeøâ˯4ih…ûO o0ZM`äˆáð™ >'k5T®<`L€ Ô9ô‡»Æß)ÚUXXË–-ƒC‡bÁÉÙ £ð›¾ñ_~éEصk$%%Ù4ƒ+þ„íÛw€7œ9sV#t±v¥SSS´¾{)ÿV­¢ÀЄ=k×ócL v¨k÷ßÚݶW{´Ø^ŸÔHH½˜BII‰–¹+Šûò«¯`ñ¢…bVŒŸŸ/ÜrË-Zf—( ‰@“&aBk! Í]½zUƒ¥9 -!%%®]»¦‰·••½{÷ýä0gÎ[A ½´9rTÞesËØØX áñíÒ¥³jýh†´»››Ø·ÿ¾ i¬Õ~2uõ™BPI5kÖ¾[¼|}}aÔÈ‘°há"8wþ|…:p„D€L膮¨©4þ7ààà“'O†¥ßÿ e¾ŽûO—o3ÚC@žèAÏL>|D…ûhíi ×” 0&À˜@õ7nœ¦ çžAËÄîÆ›àJZš{P¼?~+,Zü&½­®¤aéW•áâÅKðÁ‡jqï¤I,hÑ"ÂL€ "PￆÚËûL#À‚ÓxÕËÔ4ˆ½ µ>@õc -Â%M%ŒîÝ»£€Á ýRÜÐzÉ“Óøûû™Ô¢pþ|\BwjË{`^-Z„ƒ»‡ˆüÄÇŸ‚˜˜á÷Bí8[‰‹ŒüLœŠ×ª’ìâ”BËE+o˜M€´°Ž  bŒ'i^éúêÜ©“&ÿ}¨S!!á‚ð)ðÊË/‰b À‚; M½­AM¥±·Ý&´ƒ¨¯7oÙbb.æ%çþ3ÅŒ% Oô é­·Þ*L.vD¿[±‡›…& ¶{tï΀ýEMnص{·ð5§I¤X! T2ñH hBÁ˜1£ìÂoÚ¼Ž?.§è¾CivîÚ ºf'Y‰UšlÑ»WoQ>Í.¾€ƒ9äã.??_7)o3&À˜°ˆ@ófÍÄñô­¬æÇpÍéÝ™ùúJ¾ÐÄ*ÿÌy~‘µÈHÉÜçéS§!-tìØh\ÀÕÕR’SÄûº>ÿ™UÑG#U¯¨¨Xk J•µ¢L}þkÌL€ 0 XzÿíÔ©#xˆñNß 4:xð`ô[!&¿=z ¿=v¥ÙgÎý[Ù\KŽ÷öò‚ÁCC~?à÷ήÝ{€L?Þ¸)™T–SŸÖYÐRŸzÛ@[å¥ú’dddhv©¥}ó7ðâj yyyÐ[áÈN>ˆTqç¾ÿžØüÍ-Yú½¼K³ìÓ§¼š4ó_-$%%ÃÌ7fÂÁƒ‡Ôv×XÝTæÎ}_”ïÛHª{Û¶m€|ËÁ¯ìå6:º½ˆ?s>þäy7/-$°ÿ~!h¡s³sçN°iÓf­éA&J[ÝœQÊ!8(X^å¥ NžŒGA‹t}˜Ugàþ«NÚ\V}%“›‡&Oá=¼3Œ@í?S-~~~@ï!¤Æ¯ȤãŸýï¿?Wh?*÷“Ýú{&ÜB–#Â<™'¤ð ΞrÿðØôéзo7uêT|yV­Z%¶•ÿHÀ?kÖ›ÂT‹2žÖIÈ2ïÓÏà·ß~ÓÝÅÛL€ 0&ÀÌ& Ù£1 ‰|”––jåuÍpr‹Vœî†%ϯÝ»Áœ9sD–sæ¼¾\ÛÂwÜ¡UÄ /<}ô1,WyÒäÊ·Ñÿ¢Z ‰ÃGŒPÛ¥gîó_+Þ`L€ ˜HÀÒûï‹/¾mÑ6Ý·GŒß.˜/& +«AcOÏx233•ÑšuKîß”‰¥Ç÷ëÛ¿¯ÞwwwMžxâ øå—_áNX«Ï¡¢WáúLƒÛ®—@¯ž=4ûªÂŒThh(Ìûäc%6çÎ3ÿIxCœbfÌ‚ƒmk ÚÅÅYÜ$éF$ ÓM‹¶å_``€h™E¡¸0œõÊÁzÈO‹ºté*¯j–;J-çÑdWzz¹¿M‚*^)QøµqÆó…ƒé<<ÊàyÕ<;œûÏôþâ#˜€©ÜÜ\Qsí_qØ°¡·¿LÆäáìì,Ì›ÊB2áH3ä "äßéNø™…>²ô…ÀÀ “ÿ[±BFȯÚ;8øãç竉£cŸ}fF…z999Â4mHöð)¤£éÐ;v⤃bFÍê}ýµWá¾{ïûù`L€ 0k-(ÐLè¸ßä,­ùüꋾ(IÈBÚœièÛSvjOu{ Ÿ4 gí`翵ëÄù1&P?XzÿUR¢{$Yf!3Êd­EíÛ·ÇÉêÒ„n9N^Zzÿ¶ôxÒ‚ù裵„,dU¦  &N¼úöé-Wµ^.Y£¥^v»F£FùA @ÚèHo¤˜ÝIq‡Ñ”ÇÖmÛhÕªìÆ’Ãp ¿üº>þøc1@AÛô‚öúë¯Á¸±cÁÅÅFŽ‹mÈÆ,™ºãÎñTUl™þþ~ðìsÏáìØ‹"Žþ-Zø-4jÔ%Ò3 11 òË„Gš¼bšL%:‡º F‹2`Nt)2Ê4¼nÛèž4bøpM%i†&Àê0ùï¿ÿàÕW^ÏËž={ 罕µ’´Rš•™OÙ¶m;¼…³ke:iÓ~þÙ§â#`ôèÑâÝAÍG=·Çc>dBŒÌŸ¼‚u   šºdòô…矓A(^iþôî»' ÝV¢š+W®ÄòßÖÌ*¦´K—,¦ÄfÌxV¯^ YÙÙ•5‰÷3&À˜¨”Àï¿ÿ~ͤ÷ã'Ÿ|Ú´m ¡çž={µëôedÍçWŸÞ½…µ†ŸÐÜ8Mx É…³QÓsàÀ¢øG}¶ïØ¡U2‹3uê4­¸Ï?ÿ ÜÊüjjíPÙ°Æó_%[ŽbL€ TJÀÒû¯\M‹ŠŒ‚I÷Þ'ÌÓö4ÅõÎÛo ßÏÝQs°ºp8Œã]Ê`éýÛÒã§L¹_ÔêDš7¯¾öºø>¢Éj“&N„'Ÿ|BYÝz·^/-cFô³ÙŽ]µv»MՆǨ8 §Aì¿þþ>ùdžf†Š5+N³IåðÇh„,G>b>þøøóÏ?Eš%cKêwöìY!¢Ù¯ôrI³Y)ž©Ò‘¥¤¤íçîÒ ÀØRj{]ˆmlìaèÑ£;Úú/è²&”Ò?KM˜ «íl«»þdú@ô nÑ¢<ýôÓUÚ¸¸88yò¤œ„—L€ Ôö¿Ön´íKæºFŽn” …š¿4Þ}÷ÿ´|t‘O•eË–Át4F¡#š‘T´d£ðƒ„,.\”&I\½š%„,—¨ð+G*Ê0ëIfpÍýàC­g|RR,øv¼1s¦˜4B6ŒW¬Þe”yð:`L€ 0S Ãï¿ÿî¿Š8”4+éGßí»Ñ?Ùêþ7éýv·æó‹,^üðÚ&ÐÌìY³fÿÿ®ßÈíÚµÓú>£„¤y*kŸÊêš?“ãõ--}þëË—ã™`†Xzÿ•ó&ÁÊgŸ.„,GÚ€ÿý·AhÚ?úÈ#"Y·n]+Z,½[z<»Q _›²…¶i,ôGüöêÕ«ô©ÇZ-å#ZD…ÐC€f”‚:;ÊÍÍÕ“Êüè«WËíÞzë08sæŒVf4Bé¶""Z -  .h„,T_ÙI î˜úòhËíµµºíG!ÝðéaÕ©cGرs§¨b§N’† =öÇ”›³µús}$bôûÐ!_ä#`u V)¬ý÷_!h„!Þy§Ò†þøcùÀŽZb¥v©':T ô|ƒ¼./)þ&þé a‹]dšRíýèøñ8Í¡rZM¯0&À˜°€À'ó桹Ì$1{ØÓÓSäDþQ“„~¤õÿìsÏk4=•EÉÏ$k<¿:¨ÌZ¬“çY4Þ5mÈRM<”'ÂUHlF„5žÿfˇ0&ÀKî¿J„j“ŠÕ$ñÇqXÝ`éýÛÒãÑòš¯Ôô—ës †-2Œºº´5­[æLvU_}õ5MÝPƒìë‘Z2Í0ýáûïáTKKKÓ¤±ÆÊz”Ú>üðÃbü\¿u8Š=ôâGÚ"4K†lþÙrˆŒˆÕ;uê”V5åøÓ:ñZ‰xÃbûö•ÐwéÒY!hé(ò&áÍ®âP; ÄÆÆÂì·ÞÂ{BBílך 0£lÞ¼YÌÆ% Ûþýû=É‚|£‘-ãF|ÀÞ®|9ç• ôX;Ö*2}6vìmb].‡–d>Enn徦ä8^2&À˜°„9šÿMW’`…ü•‘/šI!MÎ|óõWÂ, YPk>¿²²ÔÍbÆÇǃ®&¨²ÖX¯©ç¿5êÎy0&P» ˜{ÿUNèR缆‚j988”×Èq–Þ¿-=^v7‘­>F›­ç™ ׿®/+öX]o1·Ï Ҹ؄ƒÊ°jÕ*8ŽæzžG¿#d‹TØÞy÷]e‹×i|öìÙè‹åuágƒœ+ÑO¤BGæ¸>øðCU‰©œ®º—¤=&Ífíرƒ(>##š6m¢©ŠŸ™yUÄCjjªf?¯X‡À±ãÇ…cz™ïŒvù)xàìe2=Eý³ 6ÿïÓÏ>ÓÔ±´ô:d¤§C܉8 _H˜¨ûh¶ë6ô7tèP46¢Ò{7ùn{éÅPÈ1d­˜š sPÌ 0&À˜@u É’ÿ¢F(ýèûtà€ðÆ3…Idd$Œ?~ùåÕjUåókú-«ª`+Ïÿªjç˘@í `Éý×ÒZzÿ¶ôxKë_WgAK]íY+·kÙ²Ÿ`ÚÔ©bv Í0ECèV.p&Î*Ø…¶ÙG¡³ûλ]ô¡¡!âe‘^û÷UÛÁÝî+W®X½|s2¤™ª+Ñw2Ü{ï$ Ÿn˜2e2ÐT¸'£ó(Ö%@ö IÅ’lA¶mÓFì:vè TÕ©$5•LëÖ€s³%K–Z#΃ 0ZL`ÍÚµBÐÒ·o_PúmRkÒsçŠ÷ÚG°ä8/?O“´% Û£²ªÉÉ)°víƒÅAg‘˜`L€ T%š H'³Ñôöw‹‰¢†Þ2D¯ ¥¶>¿låù_•}Éy3&P»˜zÿµ´u–Þ¿-=ÞÒú×ÕãYÐRW{ÖÄv)U×Ô¥Frr²´øûû©%q²¹ Ý æ: •E&É–¢S?úQptt„ŽèocÆÓO9Ñ#ÁÆÄ{& Ã¨/t‹¨‘mÒŠ/3 …³…(vÎuä%9þôéÓpíÀ_,s´+ïç¥õŸ´*c›6­!ºC´ÈœÎ_rXVSÁÏc9Ê«¼¬%¸ÿjIGq5ë Ò`%'¤ÖN÷tzÖª \Ú P&aP8xð Löp§¿dú´*-ò; Ù'þü‹/ëLpC˜`LÀv '™¬¤P\\ ºfÁ(þ~ûÙdú~ +·¶@û(Ôæç—-<ÿ%ŠüŸ 0úFÀ÷_帩r]fÙ'š –Þ¿-=^®MˆW Zß\³Z9¶§NÅVkËõª1t‰ò³öå åä\«d¶I¶÷'ï£e` ä,‰ÖsrriaT Ç}ûö '~ò­Zµ–Wk|I,î¾{<þø¢.dòdü]w‹8ŠŸ1ã gÉñ¯Ï|£Æë]W+°o¹³{²IÜ!Z2çF~s¨j*´G!¡RR’åU^Öܵ¤£¸šu†=û7nÚ$Ú3rÄH½÷ïÖ­ZiÚL¾ÞH¨®Ô4ºi,Ù&³ ü-ɆeL€ 0&`4N:Á®;Äï™g¤ïMCTØ]›Ÿ_Ö~þÓdH94´ã!2™/™¨HÀ÷_YÐA¹Ëã¬Ê’”ß999Ê]bÝÒû·¥Çççç‹z”ó*+¨Ü¬wëü©w]®Þ`5)ª2åýhòJvèJŽéu9º“ÃèQ£äU±$!͈‘#5q'iåÈÏÑ/Ã’ïÃüùó…©09^^*Ohf«­…¨¨(Q¥Ó¨Í¢¼iFFFˆøS¨ÍÂ¡ê œ8qBÌ‚¦’Ú¶m+´Zh}ß¾ý´¨‘Ó¦MÓ”½uë6Í:¯Ø>î?Ûï#®aÝ$°ví¿¢aÝ»wS}/ 7n– V”$J"½zöPnZ}ýdüI‘gÓ¦M5>Á”… 8¾þê+ñë×OÒ¾Qîçu&À˜`¦8þ¼frÁ­·ÞªùNWæ3xð Mü©SåßêršÚüü²öó?##CÆ‚¦ÊÛkÖy… 0& KÀ÷_åøëèÑÚã§TÞôS)Òš× –Þ¿-=^¶ÒC>‘ûöé£U=šävë°[µâêÛ›«o=^I{ÉäÒ=&hR¹º¹B÷î=@¨ Ç?ü Ù/¯ü…~Jn¿ýv±ùÜsσÎÈ=aâÄ{@6ŸEšqqqòaš%]Œ;wÛï¿ÿüüóÏè‡%M8¶m >úˆ&íáñšu[YÑTâOiUIÓnx­D6°Ñ­[7臶ðåÐ…r˜8q"Ü2äy¾úúk(**ÒlÛÒ Ÿ„úCï^½ðüóÕÛ·ß° ÅZí'5ÒÇL”i‡ÆPúðxïý¹¢dÒ¥gðòË/՟̺¼ývÕ9®Ê6rÞL€ 0&`[H0ðßÿ Yüý|žE?þøÄŸŒG'G|þôD wi*½ü·ß5ëòJM?¿yäaðp—¾Õä:ÉæÐ<==àùçž“£ÅrëÖ­SÐÖ~þ“ zNÓXÈø;ï?__¸pá¢Vù›PÓ6öða­8Þ`L þ°ÆýW¦Fãj4þJ®¶mß®`äÈQ0lèP‘„&™oÙ²UN®YZzÿ¶ôø7â¤æ6¢>ï¾ûŽ~GÑ%}óÜ?e ºœðÔÔµ>®° ¥>öºJ›e- ~õÕWTR³ñ?úXó‚£L{ýª|Ü¿TžñôÓÊÝb=ÍjÍD³YrYÊŸ¡FKô§AfÇn6Lü”ûåõÄÄ$øuùoò¦Í,#Ëü³èj®Dhâµ06Sñ²Š´k×î¿ŠjµF*¤é”`á¢E6+h¡ú‘Ó{´ÈB¾í~CÁZí§¶G) *Ëܹs̙ÃlJ&ÖZçþ³I· غw¯[ÿŸð˦¯VäíŸ5k`jÍÒûË',lÕ“‰///ñ¾±lÙO0yò}ú²°8ž´é½äž wCxx8,üvA…<©-ï½÷>¤¤¦VØÇL€ 0&ÀÌ!ðλÿ-[¶Ú”$lyîÙgU³Yðí·âûHwgM?¿î—^³›nnn0-j(CzFºfÂÚÏÿ¬¬,áö…ç%áŽÚ$¤¤$´(;„×™@=&`éýW9&ú Ê}ôQñÓEºÇÞÒÓÓu£ÁÒû·¥Çÿôó/0fÌhÖ¬™®¼þÚ«š:’ÐúÇ„‡pÂ[} ëkùÝÆ + 7V¬X“î½~ùå½Λ÷)Ìš=’“S´ÒÐ]Ȥ!;Ž×J€ßäÉ@’Q5m Š[½z5ÜÿÀÓPºyÔäv¹æŠ¶ZvTd”¨Ö)×h©IvÖ.[W{…4¨ÈwNu:ﯠVÖö;ॗ_'ž|Ôì#Ww½¸<ãpÿljS1ª$ð/jVfÍš K–.ÕÜ_…åòå+ðÊ«¯ÁÎ;+ËÂâýï½÷žxÿIHH¨Wll,<òètø¾Gq`L€ 0&`-ärâ¤{áÛ… žyº´h–Þ¿-9žÌ57n ù(`9Ëã¶ØI,hÑw¦r<`L€ 0&À˜`L€ 0&À˜`L€ 0+øé§e ûEîÜ¥+ '¬ÀÔ–²`Óa¶Ô\&À˜`L€ 0&À˜`L€ 0&À˜`L V°¯UµåÊZÀáØCVÏ“3dL€ 0&À˜`L€ 0&À˜`L€ 0uĨïàX›#Сc'£êÄ-FaâDL€ 0&À˜`L€ 0&À˜`L€ 0&À˜¨H€5Z*2©W1ÆJäên,`L€ 0&À˜`L€ 0&À˜`L€ 0# °F‹‘ 8`L€ 0&À˜`L€ 0&À˜`L€ 0&Àt ° E—o3&À˜`L€ 0&À˜`L€ 0&À˜`LÀH,h1'cL€ 0&À˜`L€ 0&À˜`L€ 0&À˜€.´èám&À˜`L€ 0&À˜`L€ 0&À˜`L€ I€-F‚âdL€ 0&À˜`L€ 0&À˜`L€ 0&À˜Ð%À‚]"¼Í˜`L€ 0&À˜`L€ 0&À˜`L€ 0# ° ÅHPœŒ 0&À˜`L€ 0&À˜`L€ 0&À˜`ºìu#x› 0úK aÆàáá L@_PÅÅÅ&ÁI™`L€ 0&À˜`L€ 0&À˜`Ö%ðDwpqh{ aûÙëf^In,h©ïfõ…€§§'üúË/bR“‹ŠŠàɧž†}ûö™t'fL€ Ø*'/optõ€œ”K¶ZE®`L€ 0&À˜`L€ 0&  j“»ûˆ˜õ'“{ªg•-ÕÙK1‘@ˆWChäÚòKnBâÕP|ÝÄ 8¹ÉÚ¶ic²… qrr‚XUÐâïç ¾\ ¤ä$§ä@Aa©Éí±ä€à wðñrå&&_õ°$¿úvlM÷_P€øùºBÞ8RRs 7Ï´ 5]ÿúv¾ØZ{C»÷ƒ/¼ íí!a÷FØþák¶VE®`L€ ÔA^~vàåkï7!3¥Š nÖªVZZß`{p÷²‡¢ÂëžT¥¦½¾Õ*Vj•µ”ŸZž¦Äyø4ï{¸ßÝ)¥P˜wÔÃA®iéMì¿b(.4éðzŸXæW[¯ÿšî@wï†àƒçïM¼mf¦–B~Ní:-íKÛ_ÓýWÛ˯éñK÷àïÑŠñþ›”u êÙóS÷üÝÎMD%^-†#IÕ?˜Ì‚Ýáí#ÐíUMè쓺zãM¢üÔ,›ÅÆøøjë5Èȯ]–¼µËKÐ=rgÃW«oƒü¢lK³Ô{|4fn “cÖC…Ã}÷t€Æ!žšì®_¿ {÷_‚Kb 19Goí• À·µ‚»no'éåü‹q°~ËŽX¸ôd^-£µ–#‡µ„õÒŠSÛض+Þýp»Ú.ոǦuƒq£ZANn1<ôøŸp-§rmÍ›zÃ/€Ð`‰aÂÅ,xtÆ*Õü­Y“ýGm1´%L¸³=„…jŸ?%ÁüïbàÂ%Ã×µëoNÿ©õIp ;,»Øõô‹k þL†Z2«ÅÝ>¸6 ù]±ŽüºÐjy›“‘[`ŒûâwqèÚW§AæÙædcô1a]û ! Фû@¼7ˆ¯6£s¨] û>;šöbT¥ÿzr<ä]I1*-'bL€ "`‡¯úïþÕA“äËgO@âií÷œ;ž †îÃDšƒÓà·yå³{Œð‚ÛŸh&ö-}NÆäkòR®Œy$úÜ…¹¥0wÚ (È-|›ôrcˆîç ÇwgÂïVÔ`tÉ_oüÔ^d·ðµSpöˆö{àOC·ap&6ÍLP«Yz¯ ™ ¥E×áý©q‹ º¡Ë:)üB]4»èý÷ľ«°zQŠ:hv(V,­?eu×3!Ðå8}0 ¿yA‘»ñ«æÖŸJ Glßq>0ðÎ`¨wÔZR|oË€§@NºS rûÕöéÆ}0õd^Öl÷Xô q90ÿ¥sº‡€cx~~ÿéSqz^{äJYþ¡Íi°üãòóSÎìýÕÒ9®vþÈiÌágó_.¿m/7¸uJ(„4w•£àÆ›púP6¬Z˜© ÚíÖ$*[‰îçÃñø€°òó—„-q{ñüý6©wêó翉¿Æ.°se*¬úö²n–šm'€W—´WO<.Âö?¯jö)ùk"õ¬¨õD'˜úv¤ž#Ê£OÈ‚ïfi_ªWw @IDAT·=½Ç"›|øôÉÓå‰uÖšµq†éD‰ØyOÄÁå YÖTÿËç¿N•¡„)…x_Ì‚gê¸ÉÇ›{ýÈ÷OÝòIPRS‚σ<س&Ï£<Ý$ZÛ­ººÂðC¡q i`•vR q×ðœIÆ¥a‰_M¿r#ÌéùXZšÛ~s¯k]¿Ê6Ôôz¸_CxwŒ„ùHÏ óéÅ0ù‡+•VËÆ/G´v‚‡z{kêN•¾ŽÌçrá‹-ÙpIå£Ò†U’ÀÁ`óŒÆšTÓ~J†“—µŸÓ/Ýâ·E{‰4kŽ_ƒÿ[wM“žV^êcÚ{Áþ ùðìÿ2µöYºá„ï—C"=D6«WÝø¡¡zZgtÔP ¼ Aß·àíÑÞ0cŸ²ãÇERV äÞ'û0²­'|?%‚<(eýÁ>­ GÔ½`×Ð6þ¢J„,vvv0jÔ(èÛ§ÅP£"#a̘1dV^<Ð^y®Ÿ²¢Küét¸˜˜ vv  wÏ&ðõ¼ÑÞȬ¼+;ˆ^f¾Ô›Ö]YdMšÜ¼bpt´ƒaƒ[ÀüOÇ@ jJ¨RÙÛWþkHOc#µõŽ1­E¾K–4JÈBŸ¯> Mü5õ±³«žÛ|Mö!}þ©^ðÂÓ}„…úάìBqþtïÚ|vtŠÖnZ»þæôŸ¡SC>¿è\­Êàî¡BÐ@!ºWeqFçMu¡Ÿ‘1ú(ó^صJ ¥Á´³[þ©ÓBAï_2ßÊ–ÕÁß¼^㣘¨ìñŸõhÙ¡Ÿ·vðy×®·Hûè¼Îì_ŸZ…âØá„âóAûpÚò °ÃÁÐ ‘fãòd-! í§÷2*»!¾kê ´Ÿ~jÏßÊŽwÅÙ¥P€@Çï^sEUÈ2jjL|±…²Ðàvfj!äe—ˆ÷—v½Á3_´‚Жåe=++ŸÒª?í§¹R”ÆJ§/XRê³{_ ƒ±6BšÉŸ‘\ˆýT Ž ¡+ €žù²ø⨎JÛ/·ÑÐR­`¿‹¶ëœ[rQÔçrž4!K7(Ëîë Ž(Ð åÇëÍågóŸjÐw¬<8+B#d¹–Y ù×JŵÕÅžú´4i¥Ò°²æ ¸³Ly½¥²Ðàv6PRÿQ»£û4‚Ÿ·¿ò ”t¥Ûú¿Ë"M/t‘@S_è1Ü<9ŠûÀ¾³´’)ùËœõ-Õú__ZÝxµkãÜ‘QÿPܧë\_oï&Ò‘ ÷òÅŠB–šìùü×m¯‹»=„Eð¬1<ÿu4ÒsýÉÇë›oiÊõ£¬ƒúT >oÓÃz+&<‡fÍ+^~y¯QÞ0íH!d¡óêêå"qRÙÍqüèñ¢  õ…š<©Næö¿ÜKÚoîõc­ëWnCM/okïKî æ¾N`OïøÓwN+ëJ§dM_’’Y£„¥''Äá;QBFŽôo‰5'Cd€þû“²=¦®§‚⛂×àÈr!;åCl`ùùE7$ž*×oC¼Ho•g«©uÑM?8 ܜ¾RÁšãÚdtÓVÕ¶öS¯ªJá|™@%Æà nH”$u\‚³Ê–âÌ…"´%.Òxg³ùáCÿÕ[}`ÆÖ•xVRµÙM/ó£{̆† ìàRúa8tæ*©Çª•+…¹°#GŽÀ7óXTÆàÁƒ`úôé••O?=cžÆ†í„&¥ÿg]<|½(HØB¡Es˜ýÚ  ò€W_èSŸø_Ðñ®iÅ@šû69.[~~þý(áÌCºï÷íÕ^z¦¯0eöü“½à¥77T(yËöópøhJ…xŠèß»LÒYìÛ“¨šF7’úÿY,‹^€âN¦Ášõ§u“hm»8Û‹ôC„‹ø½ûárZ.Ü6²•VºªÚ¨éþë×» Œ&ÍHûmÅ1øá—ÃssQ-}áù§{ãyÔ^ÃógÒÔ?*˜‚³výMí¿ªêsò lßU–ü£¢Á·e[°wvÑÌɳ¶“»~{`(Ø;¹@QŽöì›ÚÖcêóÝ<8ü³þûÔˆñÐzô=8šÅ9†µÂŒ)Ó0&À”Rq6c(~G÷mÿ|W>ƒ´i+g1Øv2& gìêa02o´zQ¢ˆkÜÒ Ú÷v‡£;s•YðÉ@ƒvé8x¿kUùLx­DU¸1è.?pvµƒÂüë°ù÷ô %…·w†Awá "†Ã;2àÏ/“4˜Ñ.pï+̓{_j>osÊ•–Ö¿Ç­^б¿¯hÿ?'ÁæåiP\„›øþMý9áùæhJÍÆσ…¯%ˆtÊ/H‚u?¦*£´Ö{ö…~ãP› ù›jFH+#}ô¡ŠdN.vЦ§Än5~ö¬%ü¬qþ7 ²‡14m8…Ú+¿zª%­Ÿ&QNâüó v†‰Ï7ƒèüÓž° dêmäCaâxºN›w ®eHÇG¢•Šû^iB¸ã©0øöÕó"üïÀ¦lv_ Ñœ`À¾°fIš¼K³$­·wJ“¤¶ÿ•ZÁ”ž¥ýß¿³(Pÿ}øHœ¦\Ý•bœø©Î-ÇÑ·Zx;8¶[]ë"¼½4¾qú0¾Oê|¾ÖtÿËm:säüöñy\<ì m//Ÿ½šëtZR¶¡cG·w»cðýòJŽÎ×ÐVÜW5â-+V³ªîê$©•­?q 씄,Ôrº,¶œ.O6K'=š¹A@=Ðjé9B}Ûá ñ:ü³wŽî{™ÕNŠñwÝ_~ù%üñ¿ÿYœç¾ý1ðÕW_Á´‡1IÈB!©TŸŒOƒy_íÑYhßÙóWaÎû[h55¼€Å­Æn-²Ü´í,Y+„,Aòœí».Â× ÷Šý]:¡Z<úÑ yè$1)§ÂÏß× ¦Lì(’/þá ¬ÛhÜKêØQQád6âÓ¯wWúaýôô@BJ¿à»ýðúÛQ†¾T«'Ôtÿ!J¦Kh„,If¶fÎÙ(>†ù¸@·ÎÒ€†’Œµëojÿ)ëRÓëÁÑÝD.Ø yé©8ÃÕüÛHçpM×­:Ë¿^Œ¶ñë…˜^Í€œ”Kª¿âü\h1d´@ø·ï $¿ü%º:ûƒËbL îpóp@³_Yà⬥¹Ñ¾4øqᤶðDI‚LÊÐ !…÷‡‚Rë%°©tâ/ö‘@æº4GlWÇ?wôwÑg¬4H¼íÏTÔ¨8XÛ @(\¹T?¿I#d¡82SöóÜó´ M\ ¼½öŒQ±£†ÿYZÿ>cE mI‡u?” Y(ß¿Ih¶rþE±?ª³·TŠ9™7 -±DõW{º •øn@!Ž©þFÅTºšxZ:G;nTiZeKùYzþwä-4§Håû9 ! Õñb|üòa‚¨®?š#Á§nè4°üøß½ ²PºS Ðì˜dŽ/¿óÉÿ‹2 hÓïÒ$5Ò:sq×ÞOi;òB­4'!(#VºÁÒþ—g­ßÀKSßyDñÙéÒི|2A˜|N2WØ¢£$LQî§uº5k#í;+ݧ”ijºÿåºV!™Õ“IgŠaýixýIÂÒ ñ ÅQé* Å8ë].›–äèLl,z#A<¨ØAwã7‰vÚ÷õ‚tÒÀ¢óW²Pª+¨=ôÃÛçÄ74 û";Wì­éó×Òþ·´ý–\?Ö¸~µ{³ú·^¸E²™­ÏñôŸ™]Pñ9­¯f5=~y{I˜p'’Ì]_.d¡úžI»¯­’&®4CMŽ«F¿ÂË¥!ìBa t”š3ZJï+T·êd©si¼nõ1ã'>X»žŸhÖ.ó3™€»› 4om[5‡Ö‘MÑׂ?8É”:Ȇ^¾DQXRzaÑmêæSåƒÆ‘þu—µÛÝÅw˜!ì=¹ R³âuqXm;??.Z ÿ½Òâ<8ß.\§OÖ¾P+(¢…ô!´ 5CÔ”UNŸÍ¦ èØÔPPo/'èÕ-TüB‚¥Žr¿¼Ý6@¤éÚ1XŽK'4 FÚ6o“>hņâßÖå³|Zi¾ŒLG½õú |lÿû;NhÉ(²Ô»êÛÈšÜIìÿsUœ4éM\¶ƒÌ›‘˳¯¬ßþŒSeXY–ì¯Éþ£zJ1‡ôh]IχäTéAT–VÙ^Kê¯Ì‡ÖÍé?9êÇýšaÿw„©xôé&>€­­Á%—Wa‰šTÁí»ˆèô“Gà þ(—i¹ˆ •¤ñÚµøÙ»à‹æCåÛß=:LšMû;'é¯r¸&ÊÎÑšô¹ECÇ5îÑ_z*;¡}£DÙZ´Öä¥\!sXrýœ<¤;å~'O/Í~9¼ôi& ñ”éu×½›¶ÇûE¶»\ùAjtºïqhsÇ úÈMø1ÐvüƒÐzì½"_cØ›¿©é:O~]Ü!;ùįú¥Òéþ#î„Ž÷>íîzÂz ;Gu“7rfÖ:(?[ã'·‘—L€ è'ààG¶KÚ&úI¯(u»^>„VfJù7€Z.ÿ …ÞIÑepù=~Ä80‡3£Ï»ÇvIájÇWUÜ{ДTCaFiÛŠ ÕbH‡Âá홪‚ 3‡ Pø"™ja{‚KêO¾7dŸ ±[¤þ×…tdGù IHxÅ~ÝôÊíQ³›=¤¡kû_é•i-]§At,ŽDS[†Ì`é–c ?9/KÎÿàfÒ9E×HQ^D:|[æIÊ`þA•2¦¼ÿ›T|ŒYŸdªŒ´¾úŽ•¾Å4U@e“AwK‚ÊÝ«/W0û§I§gŘþ×h´àD5s‚,%ÝÛ”æÃD¸Aj’&eURëÖãFYíýÜÀ]œáI4‡6¥»+jʘ'ª†øø.(¶¢Ð¸²@i£CíànÔÂœÖ˦õv…{º¸i á+¤Ù¡nX›¥fôôpƒ¶­ÃÑGDEuµë(jM¸˜ §N_„Òë•Ÿ°5ÓóK}_ (âZ 3bô Dçº}Åç¤Ú!µ6nx—WÀÙÁ ®å_†ÍG¾¬Òv_•É“ïƒK‰‰pôè1‹ÊâqüíìV~Ó ö€÷Þ n®Ž°qË9øfñ~ev׸›8.-=–þk0­¼sß$øô›=“cŒL‘6 9†ßûïœ ox€àÒ©b ˆÎèçqØäP\¿†š1N(¨i$ÞÝV.H¬PfUGI›ž#%mÍ8k_Ÿ6 R…)jõ¢}î8[Tm P-}uÆYZÿeïŸÕM8¡nCÎ ùýÛ}~ȧHס’ü_ó/© ±ŒÍË`:Åøüñ=W¡Ó_ô5ä »Vgä §•·iY‚Yný_*Œy¸‰0ñFIYàC¦ãP“†¾Á¶®HWV麱ý/kHÜ$Cþf„3±9hÞ*‚›¹‚«gà ZkÍÛIßW¯ - Ý"jºÿu룻]Š>“äëú¡&Bfª$h¦²Ý½è~Y~^Çú‰xψ¯œiÔþÉ社ó¿ªÏ_KûßÒö«1¡8c¯Ÿªº~õÕËÚñ»ÏÀ²áZ¡y×M_zà»… ÷ëÐÌÀ'}TEpF_j‡“Ð DéM4æówäAs¿†ÂgÌßhÎÌÇ­òrI£¨O¸üߘ@pBS¯rxWÖ¿ÿ·.J¼ýÐÑ#ÛI‚ïÿâqúв\„ °¹cq‚d٤͎²TÍ\.4„t÷U¶]yË+Ë÷[…@Ó° èקx{¹Ãé3aËö°úß°vý.سÿ(¤¥_ÅäÆ0 ogðp—T¡¬R° dBÀú“¨¢Š¿,•Ù4TÅtâ$_v¯ê´æXT…–Á} ]Shð6æ=(.Uÿð°¨ÅÁ/¼ð‚p`ß·OE¬y«$´=z4<þØthÖ¬¹I™O †ÞsåYýä8KJñÎûþ'; —a¡ž0yB´r·pfÿÜS}„$)Ëÿw\k e6¡& ý²¯•¿¼)‘Ÿ¹ØDæ ¤Ñ0÷í¡àãí $ùàÓâ%ÕÐ1ò¾î]B4¾b¾Z¸OË–œFm¹nãÙ²P}j²ÿ¨üu%-ª[o‰ŠS†i÷w¶\Í*ÄûiÅKê¯,ÇÜþsu±‡wÞ”„,7ð‹fמ‹(d;$4¡üÐüܽ:ç´²Lk®–™ K;׋‹áʱC"{ÒêptWbé–ß51Ý=áøÊŸ!ö×p~ÇzÜ”‚‹? žù 8ûèÌXÄ H fî#!ËM4~qßV<ö[ˆC 7¿ˆF͈ª ¥……xNëWZhú½×}ºôœþ ¤>‡[ÇþüAh‚PÝ[ íîž¦Þ ¼¹ xåh1`„Rdœ; §Öÿ ç¶ý …×® áW¿gæmõ ª ëÔýáD}¨?ÈoÞ€iû>÷ŽhãuÒÞð7ìYøÄüðjEG7Oðüÿ -'½y”í0çü¡›³Íñ«¬¡¼Ÿ 0-älúÔÁ,!\!!KÛžÒ‡ò‘íY8“¹òVk—¦ ÿµ›è´Ù º ó†[§HÚË6¦Aâiõw;­ Xyã–I¤ Ivü­®Í¢,’3õùÝX6s¤/]MÆ›Sÿœh»%Güò²ÕGQBÂ5ïßiIÒÌÜJÛ‰Ÿ ·?&Ž;†~?ã¨[K¨4c”}’88ÙÁ¡™âˆÎCpTËÄ`?eæžÿòû¯2/Ýu2#uád!™!Ý`ÌñºÇènïþ'¥Bc¡×(ÍîÁ÷HÚ,$lÍͪX¶&¡îŠ ý/k´È‚2oÖõOž4‚ý„Ýì•ÛçÑÉ2™mÆ×hѾâøL‹héÝùLl¹fˆòxy½¦ú_._ß2²“«h[)¢¦&yýéËÌÌxwoIM‡ækŸ qÒLúÆ-Ü u·Šü++ÒVÎ_sûßÒö«ò1áú¡ã­~ýªVªj"ÿ9^d¶ÅÆ/Ë?ªÚ,21ùÜ¢{TUrh¿/!OWHÈÒ¯Lûqó©|ðtÖ/nëä€ÇÏáq©…°hWü¸ï*\@MG #Ñlá#}$µ1õïfÂirÎêc†Ÿý„äƒq’…Þ³öbVÄfÁÿð·ýõ”à½Ì®}zg ?SCùËÔ#9½Õ4Á¤v8˜bO@AAùƒŒ´WÒÒ³Ä/8Ð:FGBÏîíaûÎCPh‚Æ€Õ*[Cï$½¨œN+‚séÚÙª’Õ‹u°s‚QÝgŠ|O'm‡—6X½ Ý yôQhÛ¶-žsh~Išy§›ÆØíþ;wí‚óçpп\UÜØãuÓy¸;  á: ¥²p.᪘~øþ.0áÎö°y{P…)£…†œÛ¿?oäøšÕSиѭÄÊóüóÔÆ ¿™à2óT-Ñ|جWÂÚÿNÁ®½‰zr—¢IðÔôžbc_L¢ð cðßYý·~Ó9èÞ¥1šÝjŸÎß.Ùçï‹êŸxN êß`P ÷ñ6-ÿ?†šRÊÇ’þ:¸úKš,äˆüÉáÇ_caî[ÃäÍ*]†Dwù_>~P,³Ï m Òr l×.íÙRiùŽn°jÆDP *â[ÿÃæ|Nî^5ânt¼>_+ŸæG¡@Eú ÞúÑkpi÷fÍþ£¿/†!o|¦Ù®Š•ôø£°òé‰ZY~ó3í(]Z; l4BaGW|G—/Ò¤:üË4óSA!V›1à `tµZ£™µèîâ˜=ßÎ…Óÿ®ÐOšƒ^ÿ‚Úv†î=‰{6W8^“ØŠ+-Ð|™_Ë6(p+‚˜%ŸÌ9¸SOëÚäÞ€ÿÞz ÒâÊ5ñNüýôzâuh9x ô˜ö¬Ø¿Cr~¥'GsÎ[䧧y͘€äŸÌ‡µíÙÚt÷„¨®^ÂäÖ™ÃùЮ—ž£Ê£É÷οSp€4F=Ôý=Ø‹™ðk—¦–'ª¦5r°LΛ)l\ž Å…ÕTp,¦Ïmþ¢UÉçóq ·|f»¡¦vGçÆa‘îBCjå‚dCI-ßWöIѵmâæ A³Ö@Næ3Sq&a5[:ÿMm2]ÛÐÑýð)8¡ôÎ`ع2šµu°wü¼ [~O3)KSúÝŠ@>Zº ñ€»ž GíòÉ8ú¶kÕeø{A*¾ãT¬iß\B³UÔç-¢Ý…_!M*Ì& )œFÍ—ª Öîêâ w?×\T{çß©¦ »¬ØØ®C%á ÒSÎißLãöæ Ó€äChÊ›°ãÏØ»î*¤ã ûê Ö>M©wU´ß”ë‡êZ“í7…UM¤­‰ñK4¨Pˆž’²yé²0£*ÛïáŒþ¶âó¡_KwèÓÜz6w…œÂs±0y*ɵ v†å8цütËaÁŽ\Ô4i}Pˆ:¡³|þøòŒ˜33ºL‹4QŽ§žœ‰¦ÉZúK(^[™*ü‚ËåÓ²K“kðú†òÃ÷ÉÎa°óœi÷•z!h3¢Ÿ’™M­¯Û¸Ú·m 9¹ù°gßQƒfÁR.g@ÉÁ8èÙ­=´kÓb°©¶TUeº6±ÒLÊÉnÃÜUU‡êÈ·_»GÁÇ= oŒEðOÌ;ZEÞÚùEè>.\9Ë·ÍÐÚgÉ Ž“L†Y*h¹|ù2ÐÏᶑQð4 ®¢I¨éϬ‚ŒÌÊg—“¦JŸîaЦu¼ðtoxò…5Т™Ü}{{Q¥8øž”bú‹nçÁ0tpK‘Dzå‡+mžòFÎ×{÷¿ÿ6Ÿ…¹óH»E]Ðsj-é+Ò°ù|¾öìñǦvu8z<fýß–JëPÓ ª»ÿé»mGóŠY0ñ®hìÿ¾ðȃ݄™9²Ï~áRj퀓§*ŸUJìÌ©¿%ý×):Ht™®S Y(2'·þ·2^{¡¿HSUÿÈé}@™ÓûËÇHÅ Ø”c¡Y¯ÁÔ¾›Q‚–øµ¿k Y(£´‡…– åC>`t¯¢ âP í¥…âŠss nõ¯ÐÿÙ·iÓ¦CiQÿc‰VI›ç WHÐâàì^a-àjÂ)­4MºÛd&M)d¡HXÅ,ž£?ùQh5Bá †ª28º¹Cgô/CáØ_Ë ï²áªf½‡ˆ´É±»µ„,"Ï!6‘ …„i¾Xÿ ÔøÑÌ9lŸ¾¶q<`ú Ø£?»ã{òÄÀj«î^Ð.cÑ9°w@ÓÆ„¿¦Cwp¸zJŸ·[þHQubmL^¦¦!‡×/-”Lf’Ç5t²Ó‹aÏ?Ò¤Sóãô-;¢Ï!’ eÃφŸC2/Ø‘ õ¿±Â̼¶TšT%çEˆ•™ .“§{:Wc·e@ïÑhÆÎ6übš¹+e¹æ¬×äùoN}•Çp…Lp‘™À.C¼ º¿¤ý|`CšI×°©ýß°LMÌï1ãk Ù4¡óè5°Ã~èä%êÓwlä¡ÆÍ?©÷çéCׄ ¥eª” v›8hîE$0®ê`Iÿ·ìä o,+›5Žç4ÝÃÈ¿i­ý>(oCÁìëÇ@¦ÎhÖ®ÿ¾Ð«ÌcÌWPx®}]sKß9Óß}5èîôë‚BÙ|8²ó*ØpUÕd›v.–oYëü5µ&Ön¿©×\ßšj¿\¾-.kbüòÎŽÎðÂ-þ™[ ÷ÿ˜ éyêcNÖæåˆÂéí犄HïpWh⌖Šr„¹/§Êž¡Xr‘õ¾ÿ)ͳþ5šIÐBæÄÚâ–}ð‚7Hëd0 è)¬>–k ¥´Ë¿ÌoQÚq¶¢å Š~I$®Ì™Zaƽ¹ªÉqV!дq Îœ°ƒ£Çϲȅ¥gd£?TòWÖñ@vóÞ ̆mŒÏMh‡¹.¯pèÓæ!Ñ´íÇæCVn’V3íÑö«“7ún‘nZ;-ؘ6õ!غe3Ìÿæ r‘}ðûaÛÖ-ðÖìY$ ››io˜À‚­£üŒÊ†¤±Rˆbü¨?=<žy¼§øØ=› +×Ä•2Qp;Ì|i€¨Ë¶ °uÇånÕõßþ<úîúÌxi ¬ßxF¤:¨Ü}GÕcš†yá¾vb sR.k?\œíÁËÓ©‚ÕÌl ²&úf]L¼¹¹Ò=§t…Bjj.dgë¼àdjý-í?_IÝý̹LÕZ9gœ€Hõ`##iŸ$H?U>/k·—i»T–]ÖÅsªI®&œñÎÞ¾ö»¡óx ™çµr«çÔãåý¶²Ìºt^UÛ$'墦ŠŽîïáîè@žB:šlS W/œýBûä´jé¬}Ï#àì‰N¨ÓSáøŸßWš­{€TÿÌóR럑E¹Ù"º²ú›sþÈyÚ ?Ýöó6`• ÿäÇä4ÎjlÑÞSÌ*'³aìPcL {úñx¼.žÐþp—ã«bIƒ’äO‚~²O™lœQI6ì9˜N€´‚&¿.Þ¿ïÈ@m'í÷b}9›€Îè€|bl^n¼& ó9Wøyû9ê+JŠ×Ç:¸I¬u\ñ]ÇpF–ïµÖù?d¢L™Vá×®—ñæ[Lm Õ}×*IHqˤPˆD!½×oZ~Ť¬Líÿe·º~ÉÇÎûSOÂòOÐ1ö‰ðÞƒÇáÌÉ\4iÚ(]ï)+u&V:7›ºâ¹W~¯ o/ñJ»T×2 ϬVægîº%ý^x®‹Ÿ¯£²P=ìÓö•LÍ6ûú)kl8Þóßü¹æ÷Öò¶0çö0ìÞP‘"Íø¬^X.Ä*;L,._(O?ûÖ‘ FR; BŸ9tìË‹ÛÂÈýÅ}DyŒµ×­uþšS/k¶ßÔëG®oM¶_®ƒ--kjü²o 4õ‡ |QPJ‚‰ê d:,‡Yö¡€³3¾9àD“ͨáBÖ+ gÓIHS1Õy´bTJ6½0ø• E*¦*åä3†7ÿÆU>I;#_*”j8(BýYŸïpô#?2¦†êëSkfÅô«Ön·bnÖͪšË/(ÄûÒ „1¹_L¼ M‚ѹ³7ÎÔVè“­§ñqi€6ñüÁÛÕÎãÇÊ»ëÊ?žl½î¦Ô.î1=f]C{H»vvÆ-1åp«¤Õ§ea•ÌÍÈdý¦³Ð¡}¤^É…Ãnjג!•Kb`Æc=aúCÝÀ m&硞ᇟï'E®®·—¼7{¨pFåaLÈË+Á2%©xê•<8v" í÷Þ€Ã"aÂíá·qZZ-$Pzö‰^ÂÑä…KÙ¸_ÿlocÊ·…45Ñ<ˆfãPXEAËWCWñÐ8Ä&†Ý£ j:Í\§Î¨ 3”ÜL©¿5úfÎQ(ƺ«…bt[Õ!5.(dœ=Zåªù—Q£…‚Wh3ô¯â …W }n µ@ÂrV_˜]qvo;éU„ÌT©…륵c¤êºžµ›hT”*oe‘ve_ï×õÙ—A!ò dпtå´šü¬¼âÕ$¢†¹îG“a׋ÔûDY,™7£àMûUîÒ¬Ëv°å´š:+æœ?2[à§ÓÞdLÀHò€ç®UiB«…YO¡)& Æú&ñoìÑýʸG< ' Xg0ÜÈ*™”ì"šúë+iæcD'wñ@4‰ò€ÈÎ.ØŽÊ?øM*¬Ž'¦Áêio·“Ëòá·jqP3¡MB‰W}{©ÂìwC™¤ i²¿Hý§LçàÊÌ')ã5ë:cH ' !ór‘¸5Æ›êôd­ó?¼;šòÖ4Q^¹„ööawÕ /·®È€¾ã‚ÁÛ_ðŠÝša’6‚9ýŸ’P€Âœ$ü.CÓ7Ëӵ̃Ñ+ÙʉðÜWmÀÇ"¢\àì‘Š×òÅ“ÂL ÂÛ¹j̇…·÷èN6ìÛSækéÒ’þ'Òïó.jªàè‚=Ý„°bÀÁØÄ¿‘ 8i)V̾~Êò smž*t’+òѳá—4 ŸNúBÎÕðÛ¼dø{~ štƒö}¼¡uwÑoƒ'„ ¥U OÐWŽ¡xKÏ_CyW¶Ïí7çúQÖ«&Û¯¬GM¯×äøåÚã¹(èp…”ìb8”hXûÚœÊæµ¢o“(Áw·ëøÛ‡P ò>Cå• ‰H}öÙ£ÀW6ó¨/Åi'Ýs÷žÏ3J›'þò 1ÆÜý°¼=&ÆFçClRœO/…3ø»ˆ~Éô×ÌPM¤}õBÐR9†šKáæê"̆™R23FÁ͵îj´¸â³vÞx?h‚ÝtT{æ4!M4…SmIëïÕšøwÕ]óÞœªïƸhñw@? ½{÷Ksÿ-Yú=ÐÏÓoÞN/t¦ßÞHseÔ­‘@þQ(üðëa¸’.]3ÆÖœ“¿B–°POa¶ì•YP j~¿¬\/-¤•Ò4ÌM\• VI¢}Û@Qµ‹÷å“ÆØvÔTºêî?2õEBrvÿükÿ¢Z⛜’ û$™õzð¾N0wÎ0xèñ¿D:ClL©]é¿à2AËå¸C@fÄä“|Ah#• ö]!aÛ:y—Iˤ}Û~l›@wô£BýŸr4¦‚·ÊjÞ¬×437¤²dfíçóÇ,l|¨uNìχûËüLiÀm„-fÒjií¡hr¢ëOˆÙPõ…y×áb¼4˜t¶iû íˆ[§„  å¬)ͨ×ip’ÝÃï¶ÿÆ.Q ‹Þ8 äØ0îñ0Ñÿ§gôïnJ(ÈÕ؊ƒèa•¼ûëV ·mN‡!÷„BçÁPÐ’*43d kSêdjZkÿ{צ™Ã’Ã{B„))y»ª–yÙ7`ïÚ+Ðoœda㯦 Œ›Óÿ—â‹áR¼~ͧäsÅBðK‚/?õa3šc“p"":x¡¹»r?-áeƒ~gåT2­|-éÿô‰š‘¢}®§`ÛÏσ§æµ†V]½¡Ã2ç¨Þ³¯Ÿ² zÅå÷}ò™Ss5Ó•´Z«¾A÷ Ò~£Ÿ‹{2Œ&:ôõ…~·Áþÿ2ö󤞻áXKÏ_ù·×’ö›sý(ke íWÖ§&ÖkzürýÉbØŸeJ ÕŽ`×ùØu¾â„Êê¨Hcï†Ðß(¬2Âl¥#N/þ™ïÝæNеé'‡L|/X‰¦$— Y3sL‡©?1äÜyYåÈ6h)šj1%Ðìx ²]QSŽ­ iÑ'8|0ÖZ:õ‚ëðÔèû#G÷M¶6´Ä¸:6hP>¨éå !ý*èå\!Î4˸]»vPPPñãÂÔüÉÇK``œ;wÍ7™ö£V–9Bʧ]koî£Érè pøkÕI4ÍgœV€š¨x{æ`ˆhé ×rŠà¥7ÖÁ•4Ëfp)÷ö"i¹ Eyû£Cô]C5u—WÊ¥ËÛµaY]ýgo×îŸÔQ YðÝ~EÉhÙò#нK(´Eÿ=wkß.•´4”it×­]è?;GGð”L×µ»} ÐO-0Æ\A‹Z~g[šôä/çjàì_ô±É•K:¸î6x\ÚÉ£÷óN&À˜€9":¡©YœÁLš0}„þŠQØ€š%qÐ-Î$ísÊWCvó7ü’w?Ûš¶òÀAJW8cÚ„e~õeÝí«?0»4néù9¥ðík§híÐßZF{¢9õbõ!ÓÑh¡‚n΂–Ž¡fM*”¢oG'•„V¬¥5Ï]!UoœéK>;ª#$‘®r|N&‘Œ UÖÿ8üp½ä†0óN~¤ô…³8“[Zð$?-dúÎ MpÑ|Á³G«þÚ·fÿ+ÛH‚¨øYк›´íå­WТ<ÆœuT[[û‹ÌYý2÷’ðŸC}A~“Ö,Ñ/T3§ÞºÇ˜{þêæcmSÚo­ëÇ–Úo †¦äa+ã—ºB3æ,›Òl›I;ª­$d¡±ãg·„‘˜uýÙ\AM {èÖÔ "ý 9Þ/‚Ði#7{x g#è„œÇPãQ—me¯ž§feµ¨Çû‹‹KÀÙÙÉ$ÎÎ’je[ש—Íå-¤‰…h.ç¹—Q}˸òºÀbt÷YÕÚŒ%ß-†N:Á‘#Gà›ù ,*ûŽÛÇÁôéÓ!!!^yõ58qâ„ÑùÉƒÚ†Ô eÓ37 <1È—ÉËÏõC5Å@Îç»v EÍ_˜2)¾û1¶ÒúP¯¿Ð:F _/¯¿µAKûD-G|²6kâ%v‘¦Ššù'¹}”Hn‡Z^dB¬6¹}5Ñ-Ã}@^ì‰Ñÿq½g¢´té‚žµ-Öª¿¥ý‡§ŸzЯžÚäXÿVоô\!ç뺡j8Ð~Òh©Ò @·¿JÛdLæò=M_ûÉÃÂ4vN8“ç"—“k~ƒìKçŒÏ±¬þiècæÔšß?ÎZ)m€ŸµšÂù0&`:2;6öÑ0q`Ìi–X‚Ž«/£FŸð9ÐÿN?Øðsºé[pD̆ll/ÄWg†Z-'cÎÌÍÐí_~·¢YÞ¶,­??éå01X]„³ë¿qÆèv²¾9æá&ÍΕ89Ï„z‹yªÌ¤ò“ÑYHsWÔppÒ  †‚%ü,9ÿå÷_Cu3´ÏÒã åmì¾íÿ²J ?-÷4‘ü´4o+ÍŠNF6ù×*¿pkªÿaœ–X„‚4!ì‹’ÐZÈšñéCÙЄ6•b•M°…ó—êcIÿ+Û£»^Yû)½-\?ºõ®mÛ55~)?~ }&Ëç–ü©TÛØS_â?ª­d6ljªù{1” PbÐñ=ý¤ÉÕþî `z?OÌ×ShÊôDÓ¤¤±cJ0üÔ7%'Nk¬ìk8HèŽÆ˼ü¤ÙúYÙêê›fUÄFzi¨' ŽôŽ^þû2K1MeÔFšaR5J¯AúµóÅUÓ×ï½÷>¬\¹vì4Îÿˆ¡†ÅŸ:«W¯†Ï¿øµZÎJZa_.úQ¡àí]ñ%HN,ïËBóPúÂcS»BHd_+‚ù‹÷Ã’Ÿ‰¤ÑOG›(?}‡iâŸ}¼ôëÝL˜ïšõ› .¾òswGøfÞñ‹h!™+ÓdX¶âéQnæ/ûšvý‹KÐdb¶ÁŸÌG7_[Ù–ë'÷‘Z½ä}Öî?t™+Þk-©¿5ú¯¨HºÏ¹¹ªĸ»U´[lJ›+K+ûgÉ<¿LXá÷Ï‹ˆ,ÜýƒÁ-UV¥EÒ5áèZÑQ<åè*½<é+¶´@š-è覞ÎÑfJ¡$¿êgÊe»,.^êÈ<›Z°sp{'éÞXœW5Ï‚vw>n¾Px-Ž,_¨V ½qE9’†žƒ‹äøUoÂ*Úa üª¨iœ-`Fè9ÂÈù19B^÷ãeqDVÚuعRòc9è®`tP¯þÉ[„³)xú¨?=•¿cÀØp“’V …&‘î8PYnŽB™GšG¦àî­^¾rù+Ð UUÝrôm[Z9ß;Ÿ†h4ñSŠöØ¿Ÿs.œÔ~W–Ó©-߃þ<ѯñY¿Ì4çéjù™§g„ëàFéû¡ËFPXæpW-_kð³èüÏ—„.îåç¹n=]Êœ«µ£¨’ãÝ˯;9­nþ–n[Òÿ>vèOÇÜõÜÈ… C™L­ýrÝ/ž*Dw×Å€yÓV.ÐýÜP8£0Á&§U.kºÿ•uÑ·îî-}7V.0Ò—GUÄ“/§Öt?ÒèÑngl jÍò9©ïü¯êó×’þ·Fû‰‹%×ÏÀšã—h¨Ãè[6~ÐÈ€£xß²}™žCFXE ÝÕM.lÊ4 ‹PËQ_èÚÄ<¥w¨ÕhîÐ!-÷&¼ûo6\AíZ ‘úßÑô•§Þ*}©9Þê’’Ó„ °ÍCÊÛ¯¾ðæ¡°¨22ÊÍu°'šÞ× Æ¡Me’*Îþç ì½ Ø6^m‹«—‘s¾\5Æà/î¿—£– GÞxs,Xð­Ún“â6mÚ ¯Ï|6nÜEx~šÎœÍÉõk®:«£škÒX„<{>S5k2¹5jx”Ø÷ùü=•]kÖ‚Ø#)x5š.NNú?$¦Nî$Ž'™÷>Ù1‡¤dÕ‘™W ±,郰O0ÅžòÕ~½›ŠÂÂRHJÑ(MLÊûËàoëöóå™ÙàZMöñ”_žo®JÇή èÛLìKL*·;-'¶¤þÖè¿ä©N;‹sU®—¼Z8òF,eÿ,)G¨æNÚ E¹Òó&¨õµZrRE¹ÁÑ]¡Š×ãàŽ=Të%G^½xV¬úµlŽn…5ÁzŠýdëZr‚|˜Í,¯ž?%êÜ¡jU|‘ ¢ú—MIÊJ8cõz“ð¬íØ{E¾~ø JòM{I•ùSÿ©'/oè=c¶øy…©_£jÇWÓüŒ­'§cÿÏÞUÀYUmïéî.fèJº[@BEŸŠb+ˆŠXØ>ÿúôÙ]ØŠòLPÀ@¥»;‡aº»{ø¯µÏÜ;7gnMÉ^¿¹sÏÙgÇ:߉{ÎúöZK"`{\Üì0ýFåjÇ/™(Ê%†£A6|› 6d9»ÚcúM!ªb­ï¬dÅ‹3„¼Øp¥+=(±= ‡$Ë13¹ì EÈKWž٫Ť6„J0Æòcé×è6ÀUM¤Ç+}iÖjIý5Ç1¶l­þÜ1bF°Àø/ÇSN}ÏZcãsˆ¦ñW)ØþúY**ËÚ‡1øÐæ"±?ýFùQè)ã"kñ³öüϤdð,]úyÑu¢ÏEõrV‡ ËLÐ?ÿ2“”ö14ëשqN™úpõÜ8#+YÉa¤ÞhƒkÿŒ›C±ì㾸ñ‰hƒÚtè¦~.oJ&VN(ïw‘=ÝÓG™øsŽBŠ5%m}ü›Ò·1Õw„2Á75μgÃæú¶v{y •׊ã3`œÁîÉÛ­ç%ʶ¬†sU³b[Ÿ¿Ö[쿵×&–ë²-í—_ê…­K#ñÛ]¡­?1Tã3YÊ=uJOwèß½nvèL‰ÞYÎæèOÔÐí¯­Ö»Q¸.7ý=`EåÑ›VÔøl§«ç¬~Êï̹œ*p‚{Sefg,›â‰‡žÃ6éêZ¥?^6WôŸ(ÍíAÖ· œ¼Bää [×(„…6=ãžÅc{ÀÃݧÏ$!aÁ·JÛ–k<'ÖYÄÀãVî+ÀIJÈæegðãkàBl9ÍþÙ=»¹¹añâ»pÕ¼yVïèСCq÷݋ѳG³ûZ÷‡bhìÓ+K ‡³†—‡åzúÑ ÂΘ”Rˆc'õg«yy:áÁ{G‹q·ïJÂæm‰b™/‘WßÙIÄO"¼°ðÆÀ™Óºaþ¿ú‹6?¬>3gsìaðãã­ü`‰ÊôÝŽ™Ða¹êò~¸ìÒîê‡r¶N™ƒ×ÛÿÜxNè"VløuÒÕWåá@Ót·©ÜHm¥B[¿¼ü ìÚ“,veámC1÷²žà<;* rÇÿ=>‘BÈ)ÞFëþ8£Ú¤þ¶VuG.ð9Ë쉥äU¥I^20³D »o²™£›;ü»ôu²Nj‡TS7¤s<ë„zOEʨ·Ù`!eÏfÑ‹GP8†-|ÆJ%ìmÓóÒ+T«¿“wn@]u\\1æþçàäÑèÙÂáÎ]¿H´KÚ½µòQ¹úÀ=8LëãÀ¾ô$®d|ÓÙæH÷M[Jü¦ßÄT;ö(óÀó`}„Ð…Êú\ô˜XÍ>}%)¶Zô5øú»Eh¸¢ô$dŸ<¤·¿šûïàª?k0~Ã:\ ˜6~Ñ=0ð†Åd,l´2VÃî\†®ãg rØ8”ç)3Ìm¹mŸ-÷Eö%˜‡À”ùtÿ¦XÚœÓcã÷ŠªŽQ¿ñ» ±:tZ y½èÙǶ‹¼Î.ö”S%nžÏ]b]0u¾Bâœ=Xd¶_Ó«%²»ú k4:«tÜý›¢sP”«åFï>*‰éë‚ë–ňլ¤r2äêºm©?ÏÜ÷ qhòÓðÓ¨RÖê?|º·ÈgÂn]•ò 0¦ƒ%»Õ•·„Ò3_'ä¤Tàü±2£m¹OCD‚n¶ZgÂïüñ¸¸Ù# ÂÑ0µøY{þÚ\(ÎÎÁ²à‰ÎZž_|½\÷P´Ð47­‚¾ëŸ‡©=“nž¸á±ÎZž!]û»bÎQ¢ýY ßTR`º¬žf¿¬=þûÿR&ú1ÑÄ„Ÿ&YÑÝ óîí,tH=WÖlHºs‡•IS]b=é*p=¼iÒ°­¿ `'; ³h¯þF8bØ¥Þ¸ûµž‚¨æœ9{þ0<ÑQÕG«Ó;þž?›µÓo Ժƙ$ºùßÑ"|$çnÚÿw¡žŠm}þZuüm°ÿÖ^?z€v°¶)êÚ=<ØÉM— °¥ýr@„=æÄzƒ=Z87ÈÒ‰ŠÝ¢)HW-›cÃ]ñÎÜLL€%yLB^Ž¦'*š£5¶•SºˆggùÁWƒìïBú?2Uyf¯’ÓY†õ÷ ×õñÝ•÷þ_é7× ð´Ç•}°¼içöw{Шđ^eoá†_%ªÈÉŒjÕ&“¿5‡ÉmdE#pððiŒ1— ì ?Ÿ4œ9—Œ '¤)Þ^î@$‹·—Î'¤"%MßجY¿£-÷ m4¬Ý@É,ùcL6-Åck Œm–åf ðã? <<Ì&9Z†\2wÞqþuõÕX²ä>¡¼/¦Ê¡£™øñçDTôÅœ™½0yB$%ÂÅÕ1}ÉRV^ç_Ùªö^Ðì{éâ‘ð÷sÉëßú`æ&dd–âÓ°øöa¢ï»“±ÿ°ò⭪ػg j×\ÙO|Ô: Ûv&á™ÿnÖ*ýêÛ#"¯ EÜ3 o‚ܼ øùº‚C‹±°'ÎGŸÐjg«•{Çò2$‘á^øúm"mæU_Û”ðiëã÷Ú»;å#È´%‹FþC‘•]*‹àÀF‡ïVÇžýiz0Y«¿^‡fì&öR~™aC"ˆ¨ë‰‰ãº …ÂÉyÒÓCX¨'~üå$®šÛÇÌ^M«Ôo°âEBdJÎI…L1Ô2óÄD O†ÿK m¶ª,íÀNp"õðÁ£Ñcêåˆ;E©Ipöô‚gpN¬Y‰¾sæ£"?û>#ˆ¤ < Wö;˜4àPdî!¢]Y^öö†Á>&<ú ØÆDœ þhÊÞO_Ù_¿×,²j¹ˆïLã{ù5ŒO!?V¼˜ ÕNµbKýÙØüøýT]üþìé8ڇƙíÖêÕ«‘|š@ž)ü1&Gwäã«ç’µ6û‡(ïlØ~ìó¦uÿþì]¯xçjubÍ ;É¡yèFÉÑy¢¤1±?[œÿy4±ñ×O“‰éŒ^C|ðÔ7Þâü³'‹“o°‚-‡äûöÕ$ú×ß‹ÜôZüñ¥rýô¿ñAaN5œ)  ,ìu°êýÆ6(±öø³÷Ԯ߲0rf° üÆÍ CÍŠvÄCãõ÷ÝëIÍjwX1zòuDódJöŠªŠ&Nê±­¿j§ºôÆS_ǪVµ¾9œß·¯Ä£Àˆ¡S«r+¯üý¿DSn†®±^˜r]8&\†‚ÌJšde)1²ÍéãƒO÷Ó¹]ˆë¯é/fö÷é$š×’ËÞ2B@9W˜4ÑöQ……zÿã½È/П=´jÍiL&B^:·Ýý3JËjt»²x½¦¦<þn$Ï•™—öÉÙÝÝ”ôâ’*üñW¾Xyئä†ÅʶPö<~&nÑ}kÉs¨?¦Nê&.U¨9öj:—‹•?Åö]Æ_ô,Õßp²ŽLÞ-¾c(¦Oé7"{v@…šû’Λ¿7Ç·Ñ;TìB~RªKÏÉ>~HÔsõö‡2+Yzs [^~Cn¹Ý&Ï£‹» >j+Ëq˜ò…$lù½I¢…»[¿JƒÜ#ߨnbÔúÚZ$íÚ€ýŸ¿ÊÂöKПøéK k–Œ×ÜÖÝÕW!ÙS'yßVZñ.ʲÛïoÿ©Ÿ¿FiVééß!ýgbe:‚Cß¼ß$‘×Ü)ÒÜöŽŽ_sû'·K$ú\v{è…¼€^Òw¬1<Ûº†"kü¹"¼UbD™ž—¸áÌmÂwãwy(ɯŴ„q™ö,Öþ¾Í”¾Ú]Ž¨¿Ÿ¯¢£BH ™ %¥åÈÌÌEBR:ªªÛç]»;øR!³5j>xÿ=³Ûqƒÿýï[¼øÒKµ5Ô(4Äþä †挬”»ÜQ„ó°þ>^.(*®äP­1¾£ì”™z¶åñëDÓÈBC܉œvEuu²sJé8ÿ6´km©¿››¢#}P]S‡Ôôp^Ÿ‹I8Ô”wD V’ÌdÔVꇪh÷ P¸ù¡®ªJäd±¤æÆhÉíœÓÄÕ'õ5Õ(ËÉ øîëwß- ˆð^,%ÉMx-cGǯ%0‘}J$¦!À^^~””½¹iµ½dLëɲZªñ/™â+ò–°ÁóõÅ'M2ôòˆªöUËPûç´R?K¿µHøÚ“÷—£Ož›^CÞ(æè8D›·¿rýä¤Ô¢²Ü¼öÖêomû€0 ŸFúÓººþ[;çO[kñkëöŒ?&Éò³jPjf¸º¶>­=þÖî[¿‹}|]Õ=ÈEÄ ¦›yïeìÂ(Ï\€G'”W_@‘+eæ™?ÚüîdÇ¡ý(£}HÌ«¹»)ÖÙÏßÝ.6?¼:Ûâ-_æmá4®;9rÒí%d~ȤcÀË–Š$Z,E®Úqâû ttÿI¹XZ69„…Œ1~øE­¿ùf%^~å‹ÚÊF‰€D@" H$‰€‚çYöqo‘_àÜÑb|¸ì|‡‚¦£ëßÖ`KüÚú´íøòø·-þm=º<þm}äø»Çy`¥›È§ð®s–g !o}»Q];\»QK*ÂÔÑ,xI²Ès¡µ8qò$R)ô—¹RE³Æ7oÙbn3Y_" H$‰€D@" ÐA€s;¬¡¼,œçcÐDÃqäušµ›ÕŽ®[)ñkë#жãËã߶ø·õèòø·õãwb)ÌcZa V)jw$ ã's´t„³Hê(hŠ‹‹Á9[¼¼¼Ì­œ’×t°Ð6fí ¬,H$‰€D@" hEŽl-ň™EàDÕ³ïˆÄ©=§;T(¦Ž®+jƒCIü ÂrÑÊãÑjƒ;*¿AXd¡D@À¢osÕËíqÁ> ÀïcŠõìÞYl:{N™Qc¬^{-ïèú·W\¥^ÿlØCÅœO}}ÇŠ¿ûÏ>zrï$‰€D@" Hþ ¤œ)ƒW€Šr«QEù ³S:VÐõŽ®[ŸC¿¶>m;¾<þm‹[.[9¾DÀrdŽ˱“-%‰€D@" H$‰€D@" H$‰€D@" ¸È9Z.ò@î¾D@" H$‰€D@" H$‰€D@" H$–# ‰˱“-%‰€D@" H$‰€D@" H$‰€D@" ¸ÈDËE~ÈÝ—H$‰€D@" H$‰€D@" H$‰€DÀr$Ñb9v²¥D@" H$‰€D@" H$‰€D@" H$9’h¹ÈO¹û‰€D@" H$‰€D@" H$‰€D@" XŽ€$Z,ÇN¶”H$‰€D@" H$‰€D@" H$‰€Dà"G@-ù w_" H$‰€D@" H$‰€D@" H$Ëp°¼©l)H$‰€D@" H$‰€D@" H$‰€D í¸{œ\;aOb%¶Å×´ªB’hiU¸å`Ž‡€úÇÆ",, 8x說ª:ÞŽH%‰€D Upöö“›'J2RZe<9ˆD@" H$‰€D@" Hú‡ÛcÁ0_ÄŸ§Ó[I´´:är@S󶃟['”×\@jA=ªëLiõÏ©ããO· ÔÖV¡ ,•Õ%m²s}ûöÅ_x;G©Ç/,,Ä ÿ}ëׯW—Ùz!0À þ~®¨©©GzF **km=Ä?º¿¶Æ¯­Ç·öඵþ!AîðwCÝø22KPZÖº30¬ÅO¶¿¸6zvHܵÛ^yüâDî½DÀ ܃BáæˆÚê*”e¥¡º¬ÔŒÖÖWu ƒ«—j*ËQJDi]Mëþþø‡:ÀÃÛU•uÈM«AmëkÇ÷°‡·¿=¿^@~F ª*.XPÌèÁÓ×>A¨§÷¦¼ŒZT–Õ›ÑZV•H$‰€DÀÚÚ~èÑ žv¨®½€´ÂzT´òó“%˜µd›YýÜE÷©Õ8šÖúÆdI´´äÑ•}›…€]'àšÁ®˜?ćn§fÝ,6œ)Á{[Š‘WÞº/,fí€ *êv%Æô¹þžÑêÞê/Ô!>}'þ<ô rŠÎ«Ë[z!&&´îîÊMJ5ž^zñ¿¨©®ÆÆM›TÅ6ùž:± n¸v"¼ÔýÕÕ]Àž})Xþù~¤¦·<áÓÙO=2á¡Š‰É…XxßZµ>–,„{à‹¯M—<üÎœËÓêfÈÀP<ÿï)Ze†VöJÇÏn0´I”µ5~m=¾&0s/ë‰Å·#²²·ßû Í«l¡¿5çÏŒ©ÝpͼXD†kŸÿ¥áÃÏö#)¥Hsm¶<ä¶ÐóÒyzýÕV•£83 ©û¶âôºïPS^¦UÇ¿{_Lþ#­2Í•ïož¦×Fs{{Y0ú]¾ùIqøýá›[U-&#®[¹E=æïÞ†üó§Õë¼0ìÎeè>e®(‹ßü+v¿ÿ‚Ööö¶9d¬ YX¯¨a€Nôã~¡ýþv_øºMž£ã… 4É£¬¹q§÷×ÏHÛ¿]¯N{(PéŸql6>·´=¨ÔauðŽê‚ñ=ÏerIaêyüúÀ‚VÙŸ®Sæ ß7À+´³z¼ú:"ÛìÆþ/ÞAqj‚ºÜæ töšu-úÎO$Oºû:"{wþƒ+ÞEeA¾ºÜÖ |‹s¹/&Ì …w€“ºûšêzÙš‡_?Í@ MºÒnóà=áŠk2±ö£,ÍÍZËŽÎÀcŸ÷›—#õ•Œm« ´¶[2¾V´rÉdOL†€pWõ&~~=µ·ë>ɤ‘zƒÆ¼%¡:­sÕ¦:šhT”[3Š°ý—\Aš¨¶úî;Ò—ÞŽ°7õæúú ˆ;T„µ§!3QÛâbKüT.y«+ºz¨Vµ¾ ³*ñâmg´ÊäŠD@" HÚ]ìðüìDú*Ï ôû»à«ìfUkö˽që(µî¬t=2í8_Šw6!…H[‹£=°é¾u··“ŽÓYÚã,›â‰9ý½EßNã…õÅêú¼ðÈTOÌŽõƾ¤rÜÿ“mŸ1É”<¹‡§o݉–·jíXÊ¡BY&hmè} ÏÍòÁ}ÉRM/'i…5(­¬‡³C'Ììë…/o Aˆ'×ügÊœáÏ`îðgÉR[_ƒÜâ”WÀ®“=º‡Å™?!:xh«íü’{ïÕ#YTƒw¢7´eË–‘ýÌvÇãΛãÑÆ ’¥’Zëz±øqŒZü„ YêjªQ”–ˆÊbzþ£c>x4f½ö‚û ¶|çšjI÷˜±üCoY*H¿$+Õå%°wrF× —aÖ«_Ñý¿e~@5×?‰¹ ; ’…=AòÒ+QQZ G'; ™ˆ¥ïö‚o°öùÍÜí–Ÿ²èw¾F^ wò„7&çûÂËÏ ÕuØûG¡v5 Ç×ìä²Û‚pÝÃ]ÉÂäF~f%ÊŠjÄïw¿‘~XúN/„wk$4ÛòsïƒîÇÙÕA‘®{yx¿7ú מô¤Ùǘ¹¾¸åßÝÕ$Kq~5Ê‹kÁ}÷¼Ä÷¾Ù Q½ˆmÒ›á§Ñ§=/ëî‡jÝŽžå¥H$‰€D ½!0'ÖŸ_†g8ðo2}èÕ°Yá_µ¶¶_r’_$H–Jšœr2£‰yU`óÕ¸n4ÑwA(z™°3Íî­~Æ©¢ú‚ÀkRÆI&\“±Oã—WÕ+xx°£çO7}ÛZ&uw†»³è‘ ¿PÞIm=Fsý5º 4WSn—´ ³é7¹§Â:~¾+_ì)CE‹iwG<==xìR_Ü÷£mÏÜ-“»î5ƒ»]%êï<ù96{ŸÜþ”›B˜_ÌùB|zâª1¯àÍÕSÁDŒ­¤ÿX̺lÞy÷]””42¾£FjrˆÐÐtéÒñññ¢çrY´h!ñûï¿7ÙVwã€~Ab&?—ÿºþ Þÿd?˜laéã‹gŸˆ°O<öÐ8Üv÷/d·£»¦ ÅÕÅ÷ß3“Çw½îÙ—Š¬œR̙و£ïJE ð ú-‹W­XI¡4 I[ã×Öãëb²àºðòtF^~¾ùî˜îf½ukõ·öü;* 3§õz}¿ê8¾úßu¸¼žÝüñà’Qtøáq:ÿçßö£©§·6(È<~;ß}NÝ““‡"‡Cì•7Á#0£ïû?üùÄêí‰gðóÝÊ}KUÔw0ªÖå·i$'©Õ GOÆ¡¯ßW7 èÑŒýþH;´ áƒFªËÛóBÆá=øþæ©ppvEU‰öì¥ö¬wöé#Øþæ¿U¤ÏÀ0ô™{=»G¡Û¤ÙdOÂÉÕ+ëÈ¥€ƒ‹+FÜõbÆ^*ö%õÀ”åd¢çôy­²o‘#'ª=ÖŽÿü5Ž}ÿ‰š¨ô#¢{äÝÃ/º‡ CV/œkóP^]'ÏFôhÅ£öÈŸáĪ/PÇyøèÅ7røxŒ^ò4\}1bÑãØðì›c2üRo ç/úýke6}—r¤/±£QÄŒ¡Ìª:+Vñ®ÝOÞ2Ù%¶µšªˆöÓ©­d=‰€¸zâVöç©b,ß¡,<_›ãjðú¦\1âðhwý½ZuQ^èϦm¥a¯©IÞéôü“X¹i1Ýëàá€nac¶ú7nÜ8\sÍ¿°|ù‡ðôTÈ.&Mî]rî¸sa“Ÿ¬,%T×ÿÏžÃÂ;ïÄÜ9sÌVmÖŒž¢Íé39xã½Ýj’… ã ðì‹›ÅöΑÞ`£¸­eÉ¢á‚dá0Ë?Û‡'žÛ€â~ÓoQ-uD´¤¦•ýäæ•T¨­ñkëñ5A‰óÄå—)KSòûX«¿µçÏÌ©ÝÅ.0Á·üóZ:s˜¹')\“p~¾®:X1èhî³­–k«hnv†úSpþ Ž~û1ö~þ†"¸÷x†Fª‡««®ÉÎ9á¹êSžk<|‹º¡\ÐCÀÅË ©wÂ38¾1 éÆ•ØÐÉ’sö¸øî(ÿøÜèH$ ã*rbhœÿe™éÈ<¶Ÿ@]\§ß „—/Kùg 0쎇ÉÂaºöù66½ð *KZ&L£!ĺÑÁÂÏ¡¯ÞQ“,\–Jès¡¾^®!ƒFp±M¥×Ì«E ÛÖãèÿ–+$ —Є–”Ý›±÷Såþ6p8Ülÿü5zn°ÿÐæ\¬ÿªdãÇv”b͇Éb{ÏÁ>ð Ôöjá<$ÈÛGÍ«‡þkíà‰Þð rFey…àÊu5ÿY3>÷3’ ,Ù)XùbŠšdá²ø£TöR/"(Ê•HíŸbCÿjšõ™O‰êÃùim*ÁûÇ ÝÙÃeôe,Ívƒ&úÏöúòÙD5ÉÂu’ÏTá¯$ŠêäÓ¹—‹XVý³~ª¾ø› žœÔ­OY‘2iJ³ž\–H$‰@[#ðÐ…dá0[oÓ3ÈC«óQT¡1¡ÛÚ~yÅ…L8A^À/ýÙH²°ÚçrêñøZ%ôY4yê Œhÿ oW;ì$2… MÏ™ñÝ”çÖ­µ…# ŽR¨®;^ÒÚëÇkÄÕÝËKðpwE`€/Ü\ɸVO_bâr PSûÏ|XåzÝé%ˆåÏÓ† É›ÎVáÉé š=ˆ™´G‡ÒkÛþ÷ñ  $fí1¨Hqy JS)¬Xgøx(u V´ ðã?Fß>}1jÔHA¶,\¸Hx¶ìݻפÞT$Ëe3g"99Oÿûß&µÓ¬Ô½«òò¸q[‚ÁÙ~qñù"”RT„7ºÓ ÿÃǹ>ÞÎèÝCiŸDá–Ò3J5»V/÷ïw7Gá °ÿ°òb®Úèäd/ÍyZó¼#»ãjÜß¿ÀÅÛ¯É~­Å ŽIO¾.ÆÓ¨€H‚Ýï¿@9J^Åkï¿…Iç4«Õv­ ´rnãZìz÷?ºÅzë-yüô³ € ?•¸xûªÅ·[@ˆŸ?ž\ˆa·=¿˜žZu* r°ù¥G‘kÄ3©©ãÇDÛÞO_GâÖõZ}ê®\¨¯EøÑ÷à ¶Myùun¸œ+g÷{σ½6 ‰Ÿ<;ºN˜©wýT—cׇ/"yÇCMÛ´, W"^ ßßri£7†ŽVÑã.ň;××·Ò=FCÒ),ßÞå/i‘/›[|±‚H`ïðáÍfh0&C˜8f©(È3TŪ²­o<%Úçž1LT ’õÒ}™ï…¶–¯_Œ]&ž2üüWC1dž§0`ü -üó´å§L̾#Jä3Ùº*OM8pè1ÎsÂÞ"[Vi0]X;¾X˜L1&*¢ÅÅݲ˜" ÍÁÂd®8»)Ï¥†¯m®ÿÁ#gÅ”ülýg\kñÓÕG®K$‰€D # °+¡/ÿ]DF}Ë&º¶µýÒÓEy¦Èkâ÷?¯¬Žˆ ïñk‹cäB¹ôŽnUí æ·—!&€BŸú:á gæëÞü¸ìQ4º‹#^˜ gÇÆç¼Å¤ào'ŠñÂú"J›`š¶Üzf?/Qù¯34Å°iYÝYå÷{in€zÒ¿zCÃUO®ËBºÛš[·ýss#Êíè‚~}»‰—à¸sÉHËÈAiY%2²ƒ¯¯'¢£ÂÈÐà2ê@I©aσ·óB¾þ<­ÿð¯©vwJâ¤ºì’ Œ¿Lh¶éHˇÎÿL‰î‡a`×+°÷ìJä×RòÀûÁdKYe>â(¼˜­EE¶¬ùe BB‚áíí­5{dÔ‘† ) UVî\¸Ð"’…ûá¤Ú,M9t¨¼B8q–¦ÔÒ÷Å×·ãý7f‰Dâ ®éOWRWaoƒî-l·'Oe㻟N¨·©ÖoP^ôUëæ~»¹:à?OOFp ‡0òïÞ“‚³ñyðôpÆ„±1¸žtjJì)K=ÿÒ(!¢BáãíJ×zyðdõÔáúÖàÇí­kÆ·ÅñcýY‡»n*vå×?ÎâÜyóc í«5úsÖž?ë7Äa@l.Ò?¯;¤í°5·ß4L¶V )CûÐ’eÁ† #[}m Øðns¡c7éÉ7Ügè:ëÔaäœ9N‰˜È‹`¸HÝÿª[h†}%Nüø…þðÔ~ü#¯ ¬¿rüshVz6 ]Ý{ ¼B"1à_·Ó>؉Ð8ú4]2`þ"A²0 ²íõ§ÁÄOKˆ%H?²‡’¯$KyE°prùྃi%~‚Hzâ5…d¡{}ÊþmÈ‹? 'wO ©4æ/4>6m©%Ž¢Tíß,÷€PáéÑdCÕÆ>~ªa¬ùÖ$ºj*Œ?ÅÒyʹN¬Y‰J&îC^J“DŽ &²ÖÜw-* tÂñþ?ú2¿t‘ä?¼s§~®ÉÅËc—>+ž“wümt7:‘÷Ìè%ÿ¦cwŠ¼#ÀÞÑI„žóë NhÎ^ašùÔÑøc(zä1”ÿ£ç·üŽ<òfâ;Q”£)¨×Œ'òfcÍCHÛ»Mݬ=,$Óµ1ü¶VáCÆdŸèÑS…º)äSS®}üÎoüµMw…ÉȺ¾»Mš…Ó¿ý€bò"Ò”AD”qRúÊâ|ò.Ú®¹ÉêeöTJÚög“ýø°Ç #,ÅéÉMÖ5wc ñ‡77zjÖÅI5T5a_Èÿþ'ûLöz1?Õ8¶ü6g|[¿™Óº ¯&έóç†s¸yþ„…z ¢êÄ©lÝ‘Dހ͟K* ÌÑ_ÕÆÒï?7žÇ°K")÷æK3ðÑçûÀeþn¸Îé‰ãbDÈ»_Ûª•¿ÈÒñLnGO@¡dè}ïS¢É©_¿³yÈ,î8‚Œ¹*’…gWkþR«±ÿ— ¾ãÑÿÊ›pšB8ÕÕhÏæ<&*’e7ÍL[¿J½‹kÄ=O¡ëøˆ½âFœýý{˜FŒCBõ›{ƒèïÀŠwõŒ êl°àä扤]Ñž aƒF‚½ ²(OHÔð FG°? 3ÅÆx–íï<‹„Í¿©Ç:öç˜úìûêuC niÍ’ë´6Mzú-„¡Ufl¥%Ÿ±1Í-žÔˆ‰ˆòj2&LN­½ï:­<gzÿˆiÏ~;ÖsÆ¿pdå‡ZÍ#†U“,»?¢ó÷Æó—=M&>ñº0Ä»u)Rwo2ê•Ø£/N­û^«kü£¯ â’Ñè=ëZ_õ…ÑJy?˜dáP{ýß½È9yX­ß)ºÞFÞý‘³1üö‡°jú[à7T= ™ Â/ãè>0!3všA¢ÅÅÇ—î/JØ°ÄíM“ fo“ê ›GøàQˆ!2hú Ë)OÌ;H¤kЕB¿ ºa±ðÒãónÛO RÓ&ƒšÑ‰*‡KARŠ’µ U3º±¸êè9¢mzB92µïýªN‰ƒÇVJt?ýÆJ|ŠkòÝבÝ=èò6ÿ`¹'¸)ã«ôh‰oÿPô¥x4ž;\ÜC %ñk…e§‰€D@" hç´…ýÒ“xJš“QÓ0/]Ef´$TžÄ«l]±ÿЩvµ/-¥Ì(ÁfrÿŸS À¢°éÕŽeäɇ1})¡üˆç0mðCä>ç»NöÂÃåç]#-ïø?q÷õöiÎÌžX²h‘X´t-òò ‡”ÐlÈž*£‡E¢Oï "*Fជ~C×h_üëŠXQm9¯Ó2šž9©ÙŸ9˲ŠåyÌh’,\VRZƒŸÖœÄããUƒ¢ÊÑâìä€{GvnŽÏ‚#1úƒ†Á×ÇWÌî¢âJ¬øÖpxÍŽ-ÁO³½µË–ŒoÍñc¯¥›æ+Þ)”§çõgìTûqù¬ÞXp]žznRÓ›?,Ñ_5–%ßü ñü«Û(7’R ñò›Ûqú¬mÉL]]CÉ#dÞ'kE1Ï’u$Ã?‡ ª*-ÂA2Øžøé Ý&6Yç<¿~H…R-’…;çPGÇÈ‹…‰7òô誗o"’ˆ–ܸZ$ —qûŸ¿!B’±çFpìP½1¸ž!qr÷Àèûž³¹Ó(¼Ð™_¿7TÍfeìÁ“ºw+yÌÔÃkPÏX$ÐlsÞ{gã3‚¬ÅgÓ³¥%h‘,\ƹ,Ž¯^q÷?Ç«-"-uül¡¬£›zϹ=.½Rt¿qÑðT\áÌï?h‘,\–sê’÷nA4Z¡äau„ 5$jر–{î¤ÉÂ…µ•ØOÉÈg½¾BxÅøuëc4ȾV¾ÿDô¥úÇçÎÁ¯ÞD {Eøwï‹Ì#ûT›Åw4åbI?¼K‹d…tsâ}L´¸Sˆ4?®³ö$ Dž0ÑNÄ$çb©)/ÓR/rädòˆ°CMe™Í=B´²t…0ÞA$JQÊyÄ^y3FS>”!7Ý &^;‘ {‹mû9äÓùÑÚ¹™T$ãÑ>kíáÑm +å&Qˆ–¿W6†ï3¤“+® …§¯#µñFÿq~¢Ú¿sP”Ûô˶¡þ¸Ìœñõaj¹³‹‚;7†ã0i‘ï|Ú áp¢UuضÚr¨9=Z¿æÆ”Û%‰€D@"ðOD -ì—óºà¡)È'›Vd"·Ìö“‹ +'z^Ùv¾ŠÈ ÕÅ ±a.­¨D„ûbï”æ„šá³ÝÚÏî<ÏúÝm…‚hápb}iÒÉÞ$}¯^;]éjM°aYwÜpÎfÍú á\¥íñú$Ê"Š&½"š4‚L³_ÕòEA´¨v¶=~wŽ¦™ëö8vâ\“$‹J÷ܼ"¤¤f"*2n®.(¯ i\ÿ`á¸yÿ™$†m8S‚gM 2;(õê‘[œˆªêb yW§Æð]¥©(«2=R…@­ö("L˜çZ½{`û.å&§®``=UØc壷ç g÷ÌšÞ—’§ {‹<œŽ5¿1ÐÊ6Eþ¾n¢£sçó vxî|Ór5Ñâl-ÛðÊÛ;Õž+..xþ©IäÍŠ«¯è‹ïWŸ{ç4%–à×Tæn³d|kŽßô)Ýàï§Ì˜pssÂ_Û†ø„<¸º8Šœ-×’—ç÷yá™)¸ãÞ5í?ÎÏ“œZŒÒÒj8Ó¾xñ””ÉÌ,EQQ£§£ªÜÖßjÈ’`늽ƒÍÆ÷¤øøzÞ$ºu-YÏ>qü1&e96Gwe¦Šf]àp±Ê†jCRU\ö”aCsaâ9CU – [ô¨ÈÀ92v¾û¬Á:¶,ìDÞ7l$N?²Wƹoöpaá¤êÆÄZü\}ýE×ù q‡(8o܃Ã`3 [êø™©B(tÝUŸý¦nÆFnöBáoéuà«·ÕÛ -™ñ_'ˆkͶªdè¹q†Ï_ö$àpuLr]c Û hlCaíØ€¯jïê«­µÆoH°nìø—ç岕±àñÛÑ’B^>u”ßI„J1ç‰ Ó‘”¼{3åhÑ‘Ò¬ÛVËìMT”–„j 7çJ÷)ÆZ%%Yà{Pk‹{HÆ=ô¼ šwm@òNå^ÔZz°'ǂǺˆgÁ#Ûópt[Ó/Íœè~çÚLLº&Sæ‡Ã'ÐI¬\#|¬7‘‡ ‹cCÔ±bä_<å¡SyàhVI (Fµdáþ)Ò4Ñ2¹§38g 7œl~’v^¹òLÅqe&vwÂ_gôíÌåúEš*6¹|Q-kßÖ$m¹q$…c²$/¿Èd5’S³ÑàC33Mn×Ñ*úºv›óáãfrÿz~}ë¿h¶&fS=ˆÑ}n¡Mvœü⾃ŸggŒíwz„CTÐ`|õ÷­HÏ7lŒ±Dט˜hDEE©›z1ÕR;v …hPn€ùù8v옥]Qؤx‘³"3»GȳÃTa•åŸïÇ}wÀ¢[‡Â™ˆ‹2ò3|å­-íľ­¯®6ü\MÉ\›’ s¶ò‡£’ô}LM²p›JòÿüàÓ}XþÖ¸‰Ð»GåliKñkJGs¶Y:¾¥ÇI5–ø„|,Yö»Vx­¸x2,œÌÆ‹ÏNE8…»ìÒXµ¦io@Kõ7#ݺwÞBaï®ìGDk¾[uëþ8ƒˆ0/Ì¿ª?† /FòÔzr=Ξ3LæéögÉ:çuØùþÔM\ÜL^.®¹ }iV¿%gßøŸû[,tƒ‹ %Vï 'O/1]¥ÏRoJØÀÊÂ9TŒIÒö¿ŒmR—;{z£ÛÔ¹bÝ“Èåòã½ÿèçÕ[lûÏÎÎ^txš¼"Ø«¥¾¾Ž¼öˆ²N ÛšÑRü87 K½NH6ÕXuµVt…Ó±x†E¢óåœ×­£Ê¡ª«»½-×™œL;¸‹Âëa¶4‰_?uØ0ök¯2èÆ{Ðïòâvüçˆûs5£f׻ϵÔPûu§IV·?×îg;+©ß¿–j°žná–Uys9å·#’…åð–<äe4ýb®Û¯[:¾¡¾L-«#Ë@ …ËeéDFgWå÷àÀÆ\üñE†É$ ·ïÒÏ=/ñáE-I¡xé0B´pE[á§5¨\‘H$‰ÀE‚@[Ú/?QJ!®ÜQTC©æ?ûXzˆè‘EÈO‡KPCćÂß›¤¼©¶5Õw …x5&¼ÍÁ©Mœ6V£±|v?ÅŽ¹'¡Ì$ož3YõÂÆãïŒçfcnÿrN«@Bn-ÎÑ'9¿^äkiÁ¼%ý7.óÚËÚV"àîÆÉ®ÆÏÔ®TõÝÝ”DC¦¶ëHõÈžŒ7® @%AâHKÌ5Œb{ß÷¡=®$ '»ÿâï›E¨0Ö9Ÿ¹¢Ü<PI3.MõdQ¹ç÷\Ä*V­bòµap¥®Í‰-ðkn ¹]" H$ÿDÚÚ~ùçéjü}&U$vo |w&Ô`'Ù¬ÚB"|ì0€žYÖš6Œë„‡Wçâ¿sÐ=ÈC:»‰ocÉ/«ÅšcÅøœÂšÉÐa &ê¿…¤Py˜ªx]CBgnûOJ·€—çú£W° ŠÉ]þÞ³UbÚKVGÄÞf*OìP}ýÁWÔ$‹æ¾l=þº…ETà Œê}þ:ôºæf‹—_zùôêÙSÝ~Ö¬Ëàëë«^7gáëoVŠdºÜ&/?iiiæ4׫k ÉÂôëˆ.1ûÀÉå^{Ú¬DèzÊ´qMhF «d¢…?¦ˆ¥ø™Ò·)u,ßÜãé­Vç(y®“£'2ѬÄî4VOUn©þªö¦~;ØÛQ~™¢úòÏö©IÍö_wÃ. G_Ê?tõå}ðÑ57·ø2çàü áƒGS¢ö±6'Zß|z_v yÕãüÖ?(DÓáÑ¡Ú1Gšq?ø†»U«-ö͉çSömý»Rµ02Ú÷ê@J¤­™ ¼Å°°cëñkø}m˜‘¤«†Ê›A·üŸ¶^]QÖjí»´ƒ;Ú Á—sÚrOÕ–Üç4ºnk+ËE§(Ê9÷ûOb¸èÑSÄwâÎ "×QKê`IßL’$’™eÿo«I;ŽSn”ðA#ÔkzÏžC+ÞÓÜlÓe{GGLxôUøwé%ÂÅýõÌ›¦*Éo~&ÝÜQ^R‹3›dH;§L¬©©¹@Þ0†=ÌŒéc‹ñõmN9;·íú5‹’p ›ˆ¿¿ÉBIAӞњý¥$²š2ŠfjšB´pkðÓS.K$‰€DàbA ½Ø/™<ж!] rY_…daÛñöxãþºX¤ÖS>›lòrÀÐÎÎèèŒ'„GµŸ»ná‡ADàÜõ]®ÙVóÓ[tµ‘ë6E šâE»¸4Æâ7¥sÅ%¾ªÆš6eŒÕa÷²g.ólb%…[z`U¹o™þra¬ßö\ìÓ nÎ 1—¶Õ¨ªqi[ÑÒ%t$pÈh5³6¬[·üQIÿþ±-L¾òÊ+ªnÌþVµ›r/Tûê›øÅp¥|&<0v”àå¯Mñ2(œ<[üqãüþølÅa³õ2·ç•1(ÆÊ V6¿ÐVø™?²ÒÂVã[rü‰§šã÷ UX7U>Í}µ•þš}šºÜ­‹/|¼/ŽÝûS6Û½/U-— Z™ha¥ S“ÑâædTGK6ðìó^3®M÷}ö†Á„óÎ^ÞM-ª{‚Ñ Ð4ÍJs2±óígEe6€Î|õKøvîŽQw?u÷_ßlØ(ÓF±m-[àWÓ0[ÝÅ«‘ ÖÔÒX¹f«–mtü¬Ò¡-·õþ7ŒŸC9bÎþöC["añØÒ-yïVt7‡]*ˆÊ=DD)K{ æC¡U×WÚþíF÷?õÀA´„ ÞrD Ý?G-}¡±Cˆ´ª 0‘€óû´–ðí{þ#‘è>ÀUBëӧΙM”X£«µã7õó£z¶%'9“eû/yU)ÞøøyX÷‰á‰$ªç“;¶aÅ!S¼àá〤SåH8a8ô¡ šG!E" H$ÿ8ÚÊ~©âPš23©ƒU•ÿqèSSಾžbÏÖŸ¢ðe†#ùÝs&§öSâ{þJ»@NX4–BÎ÷õž2#¢É[ǼÉ;*£CË -‰@aQ1Ù<àäh:ç C ‹JZRµ6é{ÙT/Lêá)=òKŽg˜y¥´‰ÖÖ êè`^¨G{óꛣ]jªqCoSýX"LÕg)åQaññQØhU¹æ·j[!…W2&wÝ6a!ž(*®Â‡”×äóoFê:Êsѧg€±fV—«’Ó»»ÑtLâᮣ6‰¢à wJÖî_ÃÇ–½8ß Ky…þMÞVø‰,øg«ñ-9~šaá:kx·èîFL”¯<Ç@9[é¯;¦)ëN<Æ qr2ý·ÂŒn›­êÖ0 p¶ßèîêdãI;þ2Ø5'‰oJØÅÙÃxÄÑKÿãy ¡ƒ‰¨6Aêëê°óÿ/=¯Ð( m¶Ð„V­_Åø¦&ŃÉsÇÉ@ž®¨‘[tÇZâøµ¨Â6î¼qÿ½ó4‡`/gå·±ºÌøsŸ“»ò’¡Ù–—™4´oÉÇáu¥ª¤H9ººënêPë ÛÖ }Ù ÍÕ/‘#&ˆ\OeyYÈ¡€­)Œ¹)bïÔô³nMåèѬkêøšm†/|„BÇM"oÂZlzyrÏ×ÜÜâËó–„¢ÿòò¿€/Ÿ=‡¤ÓúçjK*aéøÞ˜ÅÃÇðóŸæ¶ÒBýç7ÑØÀ?ö`9´1Gl1“=R ¿²W•+ †«‡ñsÎU$‘¥œ ‰_ gQÑÐK0ëö( ¦„o5Ô‰§¯‚KyN†êÈ2‰€D@" tTli¿$“ÉRZ¥ØIý~ã 5ôoØ–oãßCcYZæábx§9ˆ‹sÄÚ*òR6&C¢ä¥ ڲÜ椥ç€C€u 7©o{ºúºÄD ²ªyyÊ˱I ;@¥EcÜqyoá–õ̯ÙØ“ÔzIœÚž¼’$J´¤Ü<úÇ\fP»NvèÛyºØ–Wœh°Ž- ÷íßoQ7{÷ªÑ¹x%?Éı1dQ•6~w¥P`QŠŠž’áCÂqÙt% ÚÛîFaQ~[‡fÐ5ÖIxº¨È Cí­)KÏPba*ÆÒíKx!èj¬ßvã`|þÁø÷£4J/"¼t¸$1I‰=߸°~šý™»l‹ñ-=~ „Gnž*äê+úTÝßÏÆňm{ xØBƒ›P˜–QB!³”ŠSÆw1ØÂÞ¾ƉÛRÓ㮬܅îA!"dwºÉ4 ¹†‹ë5Öðq¶çÀô$°§2+ÝÀ&QT˜/¾y¶7¥uÅ7¦‡˜é5|‚î¦&×óÏŸÆ JLÍÒwÎ|øuëÓdý6Ùhü’¶ÿ > \Ü0á±Wá-vÅÞÙ½f_‹¨-K´´Ôñk“ãaÁ  gE«ÐC ž¿!6JõÃX˜xÎè~»“¿ëJ0…ÀëDÏ,œ÷CW ’•ë'´ÿÝMb½¦FÝ÷ŒøxG¾GlØÊ…™‡÷ˆpWŒUø1nk”Ð q;¸ª›l+è4bñã¸îÛm¸ú‹ßÊÇ® )ÉHQë3~†ÁšLš¨B §'¬£YhÎøªvæ/BiWˆðÛÞú72ïUmj•ï7bÄŒ`ÔÓýì/ÇãìAÛúÍí„5ã§6„*0ÆHMý‘º pU“ŒŠ9±@IDAT0éñæ‘G›Ê§®‹›=Æ\®móh™‰ V]úyóËèJT/guØ°ÌóÆ×íKw=õ¬bÐè5ÔN‚3p(¶¾#”ÉÉ uuû뉀D@" è¨ØÒ~ùø¥^غ4¿ÝŠÑÍO¬<“U%`›ÒÓú¿þ@·@;t¦Dï,gsLŸè!´â¿n®ËßM˜@Qy§)¤’!µfõsÅçrªÀ îM•™}œ±lŠ'nîf° ¿bWSè~×mƒu *o^†¶È²VA '¯9¹èÖ5 a¡MϸgcñÀØðpwÅé3 tÀ3{­¢¼ ™ë,bàq—+÷àdF-¼ì ~| \ˆ6T¥Õ»*­ÈÅ™”ÍbÜiƒ—aXëà`×h,ôqÃ5ãÞFˆo/QgÜ÷-¦ã,ê{­Fø1K:X÷‡bhêÓ+K ‡³Æ,ÿè(o<ý(ÏLå¯(Ä1y8¼<ðལÅÐÛw%aó¶D±Ì—È«ïì{œD„yaá-† I>ÞΥܚ• çDÑ,çe]2ˆÇd öÄÒŤƒ÷ —]20³ ^7$nPŒg±}ƒqÛ‚AN°ñǵG7?Ü·X™…w.Ï`kñ3¤“9eÖŽoÍñcÃÌ÷«•™·“‰¨¸çÎapwo¼~¿—Ÿ›wÊPW\BäÛŸqz»f­þÖœ?yùصG1ž-¼m(æ^ÖšáÐBÈÛéÿŸH!ð#˺?Îèéo«;G'¸ùª?^aQè:e.}þ#a„¯«©Æ¹¿nr86«È–¡w> ?Šõï¦õa¾Jò8‹BªZp7tgx3¹1 !‡ªî÷ùM¿ c¥åUóàópñQ ;\=>ÆÞÿ¢IEa²›G&ýþcg$ ¯›Q÷< ;‡ÆkSW¶X·~Åi‰8úÓBýàÞ1÷ï0ÿÛ­¸nåf ½å~ÄoZ×ä®±÷€î1vh°º9¸ºémstÓ~ mÉãפâídc|ÃùëîŒ1a˜7¢w å(Kí™Q‰wTŒXôˆXeÏŽ"u%~Ã:á¹åÝoX,<`TuøX »sº 9lÊó2U›ÚÝ7{¡%íÚ$ôŠ¸d4Bú ˉۈhiBœ½}õÎQ'w%——=y›ëžÛz}ö€îSæ ]¼ü0ôÖ¥[õ+ ò¼o«Ø0ä¦%è>ã*-²Í=(ã–½>6,gÖ¯ßÆþ™;>÷Ã÷øþWÝ"º<ñË7È£œ\ºû¬Zg¬l-ç{‹\$ÜïÖUH9[ ¿ƒJvjk±vüÝ¿å •‚¢\Eè37zwQIL_\·,F¬f%¯¥ª¯ûÍ9fÎP&׌bH9´¹uu™²à‰Îðôm?„B]\÷P´è67­‰§lK´ìù#_c^~N¸ñ©hx42M¬Ç GÁ7ØYE»S&Téî£\—H$‰@[ À6E]{£‡³òêHvWÝmt”´¥ýr@„=æÄzƒ=Z87ÈÒ‰†'Whª°úh©X wÅCD8k¼¢ÆØQ’÷@AÀ$äUáhªq¢B³Ï¶X.§tÏÎòƒ¯Æd‘.¤ÿ#S„:ìUr:Ë°þdRß]ñèÿõ¸q¯Cûài+ú`!ySÏíïBö×ÆZŽô8só7Dø*žç'3ª7š¸¤q8Ll!«Ùƒ‡OcÔˆdí ?Ÿ4œ9—ŒšÅð¤ÌÛˈdñöòÀù„T¤¤e«6ý#¾û†6Þnæ þ“MgKñØšc›;dùÚ½ÿF Oø{vÆÌ¡O`êà‡PT–æíªÞ§'?G\ú6õº-ÜÝÝñòK/YÔåÒ¥÷áž{îEEC¬s;9t4?þ|W]ÞsföÂä ]Dž .®Žˆéì+ìeåÕxþ•­'¦.%"‚½ØþÖ{´†ÏÈ,ŧ+`ñíÃDß;w'cÿá ­:÷.Ž äMcH"ýðõ'ó´6ͼêkAÞ¨ wïOÃ^ò”6$—]ÚÇuAJj<éîê‰9‰«æöQU×ûÞ(l@ŸE„ÌüõÇÕWôCvn)NðWŒ’2ì•·wèµåkñ3Ø©…ÖŽoíñ[µæzv-WÌîÙ3z"#«ntþðyÁRU]‡_ÛŠüý™²ÖêoíùóÚ»;E¡Í˜ \²hÞ:YÙtü‰° T ~¼ß­:Ž=t®µ”pò÷y6ª××Ö`ûÛÿ‡²ì¦ ­ZìðwcÈ÷R2ùa{u˜žº_xiû•s¹º´ÇÉk„ }1£§"¤ï dQ˜Ÿš²RøÐìùÀýplåJ‰êª×ª  ‘<×hLN*5l<"‡ŒEIV*ÝÜáêí/ª±vÇ»ÏQžófôpýï>éÿY.tèGzýöcÕÐmþm üx'Ž¬üe¹™è;÷zp¨4QTš†#?|Ž\:›6áÑW`ÄÛ'zäd G4Y §½Ÿ¾¦•‹§%ŸÖÀít¥ˆ.Pr‰Ý¾ˆšrÅ{P·ö²žHáÃzL½äÑÂ^<ÅÉ`Ï´¦dèíŠ{¡:^¡q嫵6­¼nꪪ´ÊT+|ÏÑ'·Æû·f¹æòîþK÷ºqݸãa %Â¥4'ƒŽŸ ÜBÔUù>™qp—zÝЂ%ãó=V%ý._þ“¤Ý›°õåGm¶¨<ªW#f(' ŒÉÑùøê¹dc›-*·vüsG*°…¢ñW†bà8ÄŽöC~F%œÉ … ÙµâÅ‹ôÛücz ñ›§FÌôÅ–Ÿ´½ºóhbÚ¯Ÿ&cÎE½§¾ñãÛ“Å€I–êªz|û*yÏ›>ÑÓ$]³Sj°öãdÌ]¨Œýä äg™C“œ|CœÕÞ¿}ž‚Œóæ)LRBV’H$‰€<8ÉSz)FzÝæQôû½êÎp­âño¦ JÃDkKû¥åcÓI»šåšË(§OPŸ?Ôóˆ0˜ÞÛ ñ¹Up£¾º’—CeôûÿԺ܆Ø9š­ÛÏr\v¼é™é—Eá”›»Š£N‡õ§Ç ¼±)uFž_¦ôrõkiâífN&Y}¸œ¢)y!Œß?6-Lº€ÂòZ›Ÿ‡/ µ¶/±¼!‹y˜I¢Å<¼Z¤v5‘*;vAÿ~ÝŽ¨Èòr)DiiÍŠ£eoúPÞzA>v"‰ÉMºZDIÙi‹"PV™å¿]…ñ±wa@—9ðp @€WŒ“Ê¥åÇŽŸàTʆÑÃfi¿öÚkèÝ»7víÚõ®ÇÃ=Dž/Àºדáå›oVbàÀrÉ%x÷Ýwp÷Ý÷ ²’^²,>ÝOçv!®¿¦¿ð éÓ;HôRK.{îéʹ¤‰®L™£«ôþÇ{ ÒW­9 cbÀ3/ƒÛîþ¥eæ\uÇÕ\gÏ™gþ»‹ïŠéSº ?þ+*kñåÊÃø{s|“D ÷õæû»q>±×^‹ w„‡z‰!ØsmÿÁtÊ9³—¼YŠ5‡ÕZ¶?­N¬X±t|[?Æÿ…W·áȱLAÖq˜9&ÈXØãeï4|úÕÂW™jh7-ÕßP_æ–q˜»E÷­Å‚kûcê¤nðóuU‡Êã};—‹•?Åö])ævmU}&WÊ r‘yìN®ùEÉçMêïÔÏ_£’¼GzϺV%öä)Ó”ùßrpî‰Ø+o„«O€Ú0_]Q*”“d`ŒwsS]àØ÷Ÿ‚Ãê ¸ö2.wFKU&n~ù¶Å98¿Ã©ß@ï™ÿ"oFÒ΄E¼ªû6ÿ¶~¼çþüY|\\„ʨîÞ¹Å÷±%_‹+oƒNüô¥rþ^s;zÝàê(z­«®‡V¼Û,Éɯ#›þû0FÜõ WkUžŸ-H–”oõ¾fK³Ò0àš;¡Ò¯q&_?‡¾y9'k´hŸ‹Y'¡¢ G_¶?[UѬcû‘Oįð@¡›÷‰5ÿkvüª¢üúàˆ½úVtxÝýá­´£>rÉÄÉæÔ=[šíË’ñ›íTVhµe!+©S® %OF(<¸a‘.Ë;G„†u¦Ù+œ;\´óeïâŽñóB°cM>è§YK¶®*@av ¦ßö¬  Ù­,üüpîhÖ,Ok1¢cÛê"vªqéMá‹qƒ¨‹Z·L2N¬_‘Žc;ôŸÝÕ•ä‚D@" H.rö'×€ ‡îA4¹‰°X¹ß¸ÍBª··”"!¿·P˜N& ú7üþ3ñ°#¾ om.Bz‘–B³£6\æg•e«s‰ìðÅ°èƨ9äÉÂ$˦³Æ'jÌî«e;é9© œ‘3]h~6nÿ&‹’Þ{bZOO¸AÜë…{)­¬ÇºãEXná3L§ž½ºÕhöŒ±BÓµ¿o3]ãvT³#êïçë…è¨PRÂ{''%üMIi923s‘”N³²už®ÛÞRÛ Ð‰Â…øº‡ÃÝ…’‚ÖU£¨<åU¦Ýl-Õàùÿ<‡Y³fáÌ™3¸åÖÛPVV†€€,XpF)ÊŸ|êiZ_€«æ]‰ƒ⛕ÿùsçóáï£ÿþØ·ÿ‘-‹ÉÛÃø ÑCC<àOÆf&*2²JPNìrG77DGú º¦©é%D<™¯{8yÁ°'‡0X\?%äÂ^SRLG€sªøP¨/öB*ËJ7½!פû¿…Ztñö£ã^rò23÷þeÕøæi+k@À?Ôœ˜~Ùǽ)o‰y•ãÃe¦y„¶¾¦rD‰€D@" H$ »Çy`¥›È/«ÅœåhÈ[ßnvB†k7‡B_‘:cÁèô«Ê‰€ÅäååáÎ…‹˜˜hɳÌÂEwaÄðáرs§ÅºÈ†‰€D@"Ð6ÄL˜I3é}4§ÙõAaè6i–(Ë.ýPÓxÙe-hh6§—±°°0\pÁù˜:e bccakk+5}úôiäååcÛöíX»öìßÀZ]êµãïç_g46¶ 7¯ µug–r'(À~¾.¨§ 7/¿ šêžÕ ëÁì…3ýüõ²³ªËÐqS0ýÁçaCJÚô°å¥ÇΪññ`˜`L {¸yÙÀ;Àô¸‰Òü&ÔTµtOGÝÔª»· ¼Hþzo)ÉkB]õ™%7aáf™`L€ ôiÁ6ðwï‡ú¦ÓÈ)o¦¾sâú»õ£ú6hh­_ÛÃÓ?½Ýçhué…C]¥N²Ëp8§ç'“YÑÒýç˜{0“€M?àòQθjŒýHµ]šâÇnCRÞÞ\‰’zó: Óƒm„³£¬q5gx﮽EiæíT777Üwß½¸ð‚ ´ÊÝ„UKHH0.½äbéoçÎ]xæÙg‘•eUësfDãš+†#,ÄCÛmsóiìÚ“…åïEvn•6¿»6¢ú{áßOCh°,Czf9n¿gµYÝÍ›‹Ë/N@x¨¾üûäàÝö"#«Â¬v ºá“w/”²—ýc-’RK ‹h÷-‘_ÛH7úÂùÓýŽ[Æâ‚Q¥iÀMKW¢²ªA÷pŸÙþöÓËàéáh¶<·-û¹Ë×’Z'ão±³:}š”ÜÕ•(N9Ž”ßBÎÞ­FeÔ2ÂÇL‘”,âXĸé s8H³fj…{1Ï7nÎ{ö=“|{ùh¬©6y¼;ÄÍ»ãn¼-Møùþ«Pßó+qºs|Ü6`L@—ÀÀ1.8ïÆP„ÅÈ/Æâ˜P¶¤'Vâ—sé³N·¸´½øö LZh”ß^Æ«w&¢ £mö#n¤3n~:¾½*Ò±ä}åøè‰ “å†LtÅÜëBå¢-ÓÒr)*°úý䧷õ©-@Ü„ i|Ux÷!ãçzÿ0{<ðî`©Êkw'"ÿ”~;W=†aS|qlG)>ÖøYÜ•®ýûË©þû%ãäáZÝî¶ûd <üäç‘?WäbýçEFe” …~z ^»+EÉ6úŒì„%/ò ù_¼,cÏ 0ª#Î}mU#²Sª±sm1w™w/îŒü¢SKûW«ßÜÔ‚ªÒFd×`Ç/Ū׮2àñçyâ»"•Ýv?7~›‹uŸµ…»• ò78Ì»L€ 03žÀ=ÓÝpé(/TÖ6ãÊóQQ×þüá¢G\;Ö >Ú±7Ó‰]éÕxcs9ÒKÚ_01o#nšä…poýúÛÒ4xsS²HiÓ©7ú·§5Øï Óë–/sq¢@œÍvÇâažR™µÇ*ñܺJmy±ñðw,JðÄžŒÜ÷C©Þ1Kwi*yV¼»ÔÌšcÝ?¨&oÛl¶ÚQÎc=D€¦áðôB/Ì !hr½¨ª žN¶ps²Áü!×ß·|™üªö,{Hd«vccc[ó¿Žý ˆY7 Ë•·Þ|ÁÁAf7«d2‹s«œ_Ý1˜Únï0U§½ü~d±&¬OÔ’³—ÂÇN‘þRÿ\o?Û¡Ò$cûDM>vNÎ8¹é—Ë«õÛyBqljÜ=Ñ¿©>\Ý0òÊÛ$ÙŽýü%+YLâ|&ÀÎ xáâ»#¥±ˆ öòÂzØØöƒ§Ÿ¢èùéËîøìéTÝ¡?ÙÞ‹ììÚy(2ƒŽ¨oNBSiòùÞ¤0é¯=\YÚ ÝÓ]<ì0`´"‡¸cù#ÉÈ4@«dùe]Þù`¯¤lÅb¢¼ñäc3äŽGœŠ›ï\%ÉbЄE»ÎNv¸ï®‰˜5-Zjgמli°xþ@³Ú2)B«dùöÇ£øìëCZwgb}ñÀ²I4‡NòÀ‚›Â)žàiüwI¢Þ1±Sš¯?Ñßîs" ë“—n3./¤ÿh2A-ùÙaÑmÒ!!ÿw¯e¢¬@–?b€#®~$ ¾ÁN¸òH¼x{ÈP´Ï¦Øá²5Qúñ*DrGx¼ÉŠs]áO©•¸‰g­è¡ÎFŠ0¥lt‚¼ˆ.å=´>å°ô),z¾z!]›'΋w =¦_ˆäé@X½fÕcãwúç[[6:+¿n]KûO;Z‰ÏŸK—šŠ-ß`L½(@R͸,ÅyõØõ«i«öZ\øæ}Iº"m×Té»>±ÆõoÔ g0&ÀÎPâvþÈ_IÉr$§?6¶„ÕÚ šcT”,_î.Ã;4PÜ} ²Ácçú!.ÀO-ðÇ…ïç…2Öä§Ãx}c¥¶~¬¿ ^8?¡^öTßW}R(Múëöoévo÷/äO+®ÇÀ@'i÷-mŠ–¡´ØÀ—ænwœªÆĨ6KeKÇlný… nRѽd-SØK‹ôM¬Ÿ1w\Ž X‡À¥#e³²õÇ+Iû,+YDËây|SJ#^Ù(+ÆGº"€|'ž­©º®%Uª±¡S¤a'fþŽÚÓëeãììŒ7ÞxÃHÉ¢Ñh°ü½÷pÑÅ—`ô˜±Ò߬ÙsðÄ“O"==]êfÿþý¸í¶ÛQQa™< çÉ.N$áÕ·wj•,¢““§ÊðÔó›¤þú‡{BLê[;-[2^R²7eË?Úƒ>½, ŒWšêwþœ8éPÐ,ÿxŸVÉ"2…›¯=µAzõñvÆØQ!¦šér¾¥òw¹ãÖŠ½}þ å?Á ˆóƒ8Ÿ¯½³£/z­2YÚ/+¯EvN•êßøÑ¡R™­Û3PÕM.КêQ]˜×öGîªòìÅŸÏÞœ;¤þ‡^x-­4n³øRe674öi%‹[ÈX•—¥÷WS\`jH=’ïŽAó/“úÚóÉhªë¥Z †;aL€ t@ a²ìí)&ce>}*]«dÕ Éú᳧Ӥ{¸«§=âG鿬kÈGQv£ÞŸpÙ$’°Œ1<&ö› ¥*V´žHµ¼ÒFE±þ$·Ô ý7r†-Bê‡Z,¿¢dÇ3“êñõKébþáÎè?°ÍZDÊìcÿÅ”"Çw•£Œ¬ŠÄ¸¢†8›”²VCqÓj¤ã1#了……ÕEä`ùXêAÓ /hÕk))¨”?ß&õ`->øw:Nì-—šqY0=öжßYùÛj’"ÍÂþ›(¦hU©pÖBìš‘z¨Vr5wx«¬š}eˆäEU·OÝíÓ¤èS®5SŸÕúZ:k\ÿº2ð6`LàL&pñ' ¦… Âí× ”šÒëk‡¸¨uÀ¶“Õxó¯6%‹(p<¿¬,M%H ƒñ‘öÚzÊÆ…ÃåÉüc¹uxa}›’EO-jÁc«eKFaÝ2"Ìúö ½Ý¿§§³ ¶“2E(”„5‘’¦ÅÊÏ‚MO§ š+!»q]s´w܆‰1[ÿŒ÷4ɳ°?7WgøûyÃÅÙ‘&g[h—4qEe´’Ùàíà,»ð¡'´Å"­?!?°mcr=þužœïoGšIýi†å϶ý`ïõ" kêwVÞK– <?-Îå5ÍÈ)ïxþ„üæHCçpF¼#é^_IVÄ»3êŒâ¾˜b¡›¿,lŲ| µ±YíyA·0m‹² ¡¶d™ãGÚ£šúÓH*hÀ¡œæ.["±¢Åtoîz¸»bÈ høùz‰ÑLªÙôÌ\$§d¢©¹ã Ö¨>žñøyâü(½P©%áFL|Å\ßžué‹?É?-Ó*Óè+6”Ž‰»\Ú,Õd!½`·’mñ§®¸Bn[i,33 7ßr+ª«M¿5ФåÇŸ|ªT±øÓÝÍAj£¬—H☈×âæ*—U:ÕT7âÆkGA¸æÊÊ©„Þ`0).”,¯ügž´šìýO÷ÁPѲ{_^ûßÎ.[ ”“%‚°¶îÍÔ’ˆùâïç**51F¡\yú_³Dýº)‰”-/¿±M7ËhÛRùìdFoŸ?]q—Þ:–j(*®Æ'_Ô=Ôî¶p¿&,ƒæÌŒ5ZuX¥i K«ؼ5Ýd–Ôä‰õô»fCq}Ô•„‹æÅKýææU‘’Ñx"äPV< )lûmròôÖkÙ;*3{E/Oّ⺼õŒ²kôÙX­Áˆ«–À'2•yXsßÕ’¥‰nAÿAÃqÞÓïÒ  ö}ñ¶ª¢Eăwë?3}¾TN·~Cu%v¼û<2·mÐÍîsÛ £)ÎTR¬¶`Ïû/÷9ùX &À˜€µ 4“%€Hn¤H1•–?rÊÔ!‹ó aQЕäè"¯à¬Õ˜~7ûßÃɣĥ…* ‚®tÚ u„CX —k™IµŒ¨ÂÈi¾ˆ!”/m‹› »N=XEéŠÓR©ou5T~ö2ÂJ¥+I×Ý››41f̱«ò›#9ý›jGX§(ÉË- þdL€ X“À}3=¥˜…ä†ñýíêïÓ†ý•T7“÷RŸ‹ÁÜägQÖ0¹S,i‘JÚ¹ÿ+}xP¼k§Þî_ŒÇÉÁ†”äÅ‚žf pû[«åg#)§V‘;5o׎Ç-,Ή¶Çs‹áHÎJZJkUâ¹u Ïéf%Q{þPyÑÈïI´¦ƒÇŽOáâMv§ÖP”ýkM±YŠ;ÃúÜ°ïw þáA˜rÎH œí†”ÔLlÚ²k~ÛŠ_×o§íGhÒ°Œ&’Ã0mò(¸»É¦PÝ"H/4*¾ëO4Hå&üÇ‘)šòµË,3þ¡ë±­Úeni"²‹@¸3LvÎHˆZ(eïOý^UcnXÇÜý¹sçÂÑQ^M(êˉ‡~¸]%‹¹mw¦œà³½÷\ŪCÎÒMMôËûü+[¥Øᡸöòaº‡%k•ûï>Gš‹HkI®Œ› «[mßÉÓGÛVc­þêÖ&²j«ÈNÓû3×åU Yjn{ýÿÐÒÔàþzÉÍÚ~Ć­ƒ=&ÝõOIyR”tX=> ÀÉ÷?ƒ˜ È-L#RþX…￈½Ÿ½ wÆÁÕÓx¡ã¦èµÝ§vh cn¼W)yýJ²JîSâ±0L€ 0î ž(/ê £€êƒÆöüûbÑ¢(Zܽm0f¶)|0þ£°Pž”}µOa‘q¢Nr+¥v¼/äÅ"YIUh$Ϲ'Èç%8Š(èÞT:EAf…›Vñ“`|þb†É RvÝÅ°›Î$X]úlKWå75.Ý|sú×-¯»ÝL“OJ²Õ™@Ròø“ 0&À,#0!ÒNëù•?‹µqR:jõ—c²BfÁOR¸ßç–Nq—&þKÉ*u[š±‚_™‘jû•7îQyo÷Hk'¥ÉÞê_h¿;½ZR®%˲Þicr <œŒ¹*õ&öTÿ‰yþH̯ÃÛKð9ÅËÉ(•yÏâÛΑŸO”zí}Ž ·#ë#Y9¶æ¨þ|…a=ÁïÅ d%‹˜ƒÜEcøñ`9~ ¿­äN®‘žm„Û·×.„³éµ@†Íj÷ÛzÔãî$€aCãh’­ ûGmm[la½RT\.ýúbÄ°xL—€-Û ®Þø ßröfÛ—´ú N)ª§ KêÙ½)_wö=Œ”,BÙÒrºOþdÕ®Î9g’^{[·nƒpÖ’;­ ¨­k–&¾;’'-½LRLÜzýh\~q6nI‡Èéº+‡A(`„¨ç_ÝÚ¡®ŽúR;¾þÏ4Œ†éS¢ðÚ óh‚~Dž¿¯ n!™fL’\–=ÿß¿ôâÏ(mÍ™ƒ@Ù’EÄ£Ù²=S9„Ï¿9ˆþï\íþ™²ÑÓçO(²î^2A³{o¶ÃŽ˜#WaƆIqtú÷:>V¨­òíÊcxpÙ98ov,îº}zTvÊ3Rqà›÷0úš;1ôÂë±íˆ<‘.»URÀ4Õ×a+)dÔ4MÁ#' |Ìd 2Ü‚ßÿïn%¶Y2'—gïü'bg.Âø[Ä{¶ª¶¡"VfÅÎ^,YõÔk*¶q-†]q+܃ÂP¯©DñÍÚNqžÎBkÖ…Ì1&Ðç$îÒ ˆÜvˆ&×=‡­+ó°k]Ši…dO$%䘈Ñ2z–;.½/š¬O”é HÏÛW`Õòü>ÈÞRVq#å 'ËþÌ (>NuE£då3ÌG¶©¯îÒ²Èí[ä wræ¦_Ž0FÓ$‰H)dùÒÕ4fŽlEÛHÖOyiê*¿92™Ó¿9íp&À˜°.auòÙ~R£ÛÓª¥ØÎæöðë±zLŠªÂìîxïŠ ¼±¹¿&Ö“‹ –NõÀÊo ÷ï'×™­¼q§õËu´ˆ¼±u]¸¢L0W&KËõFÿî¤Wù3©SbÝpN”&Ð*rÛµ7³ Óâd÷ªjãR”PC(®ÎŠýåRœn¥Üò­²4ñÁ9´çòQÞøtW5ªÍ˜ú^ØjE+,QŽåµ¿8?>бþò‚óÇ~Î7ºvFGTâmŠ ççf‡Qáö¤lëÜséßBѲh^ß]źnÃN$ ‰E•¦;wi×-X^A ÷'Ò„`†ŽÁÞ}cB\ùBt×ç˜;m¦H“À¿[w™4ä¤ìMäkÐØâÅñq²K"¥¿¶lQ6>ïXr;||dß—Fu2’’“ðý÷?èät~sñüäÆi)k±äÞÕ()­í°a©rθp @ã“p׃kéË.Lê.'åG¹^êŽ$nϾ¼…Üû•ãÊK‡Qÿ“qÛc%7g6¤¥ÏÈ*Ç‹¯mʼndõó7rX$–°žÐU²ˆÌ*M#~ø9=8µ;Dï–6{ãü]CV?Âu›ˆ¥òÆ»»ôÆuÇÍc$—`GŽåã‰ç6é;Sω”òöîÏÑS²ˆLqn?þ․hÊ°ñ¾8NÖ'ºÉÒúºmn+nÃvì΄)·s†u¬¹oïâ‚A‹¯FüÜ‹¤fOþ¹Íõm‹¬ÕWâÊÏ1v ü “#¿=r3¼úÇbÈù×H]ëM~¶jw‘“fIù¹wè)Y¤L:‡¾^.)Z\ý‚à;%)ÆVmª ÷P¦°ÚAŠ‘Dœš¹Ï¼KqZÚ–Î š*.»Ÿ{UyY=$wØè~"8ý'ϤaÉóñp'÷a3. ‘þòÓkpx[öýQÖe—SæHoc#¯¶´#÷ÜÑbAבJØ’«¯¸‘ž’L“ÏBue~ÿRÿÞoNûæ– 'ÿæ}2Ш¸ ÉÑÝI¸O‹j}Ï:y¸U¡BÏ>'‰ƒˆ/K‹ÝL)Z„l)*%EKìpñ®ÖæÞ40ž܉ÉS ©‡Ú_Yª6F'rË6õb_Lœ(Þû{!­7.i©üÆ-Ê9æöoª~gò…Û¶ÿ¬n²Êžõ…øñÍ<“Çù`LàïHàÆ ®R özRÄ¿ü‡þ<á²inÒâÁœZ<²J^€«Ëˆnsxü—rZÄÝ€ëÇûP<è,›Ö Wr fK NÑdýÓ¿• ±ƒ {¥Í‹G8áÁÙþ(Õ4áúÏóQ\-zè¹Ô[ý;Ðâ”-iõ’Ȥh$„8‘§¢*ÉÝ—£Ï0¤ËÂG;e+Z…–pöÖ–rIÑ"܉ !ëâÝôÀØNV'3ãä…ËkŽª/Ñ­îß÷Oœ¥­'•(ûHQ4ó ù½»#dºí*Û E‹2ؾøÙ?,VNÙâȱÔv•,ŠìÅ%ÈÊÎGDx0\œPS«¾²G)¦ ¿yÏ, ܆m sö?“ÍPežéƒÖ‘?Äg‚½I9ûS¾Ó9bM//O½†²2Û,)ôÐÎüù n˜m´àÀ‹-“Ha"Vøx;cÐ?lÝÑñä¢p-&,VÞ{c1Pàð…çÅc.YŠØÒrÿÁ\ü¼6ÉHVkf´Íafv%4ÏѲ{ˆ%­)?_ƒŠ •·ÃÖã¾Þ²»…Ô´R¥ŠÞgjšº‚F¯PÚééó'âã\vÑP‰À+Å:!žŽFñ}dA²Ijê)uþÅ%5¨¬ª—Ωvo¨h±´¾"‡áçÀ8šàˆ–•›k×%¶ú~Ðà‘¸ä£µÚvûÑ”£›'ħH%i'°ï³7´Ç­ºAß_a±²è•/àGÊع"fúØÐrãÜû‘ò›iå­[@ˆ$Jé©U‘jJŠÈ2¤B‹[`HŸS´DÏZ goIv{7lyý ”¥‘Og„›Š¡\ ÏÐHÌü÷«r ›nPt©‚ãL&À˜@(ÈhÄ+KcÞ A1ÝäË<ˆb~ˆ¿ÙW†`Ów¹øõ“"5ƒF‹¥ëתÇ}îÝR‚¯Õj«á¼ƒS6nz*Z ?íâ`lþ¾Xu¢ßPˆYWú!4Æxçþ ¥8ºC2A©kOŠŸ Ù݆’×SŸñNRÀzŸ%ãxÛÂ&aÝ"-q’Åô$êA æ\öw! ²„‘F'ÈÏVÂb©²¤ý•¥Ñ xü«ÁÚ!‹gwg ˆ++‰”Mn<ּߦÄѤ KåmYÒ¿®,–lÛ·ãZL×ÊÊ’>¸.`Làl! Ü}]3N¶xühg)r b„¹Ð}ÝËÅnt5•„˨ŒÒ&T‘çG{;x8Óʃ֔[Þ„òN(K&ǸHs–¾d!›S'»ã³·ú®Ã44͵›È ‘6’…‹HöBcÕA:Y,”4Æ…N‘£&:A¢}?I)Ò¾¢eÖG)fŒPÜü–Øö,cܲœSR#w*$œç€ß“ŒŠÖg•1•ñ·P´¬þu‹©ñ÷zþDr&”%%¥æû®ÍÌ.-þ~^´R^ý¡³×f¼û‘O<éRh”Ÿ]§¯¥¶B}¾‰1­Ö,•5ùHÍßfuy••|JöŠ%£ Ÿ.´ÞÒ´þÏ“ž„üB -0»9a±²œâjÜsÇ,¹i,ÅŸ±¥x3 xéõmÝò‚®+Øm7’Û2šì+~uFÖ®–u¡gíW/ñC=t“ùݽßÁbWåèÍzŽö®9_a_êôhý‡ìÒÒ2h‡®ÝîêFY™å ±?ÿ:%ÅYéʘ…åÊ‚¹ñd ïþì›C4Qݵ›¯¹ „«,¡dÁîxì7R€ÊŠÓÜ< vïË…pkuã5#ñÂSç⦥?©=7·¯3¡\Ož?aÍ’0$P²üÃÝfÅô1ÅP¸SÜ€™*Ó^¾¥õuÛvq±£Ø>ÑRÖ¯ëSºåû¯ÛŸØ.&—Z»–¿¨Í1Oê«+PSdýÉ-m')¿ýˆøs/”╈C‡V|ˆšâBƒR껑gAüIÉÅ×_;Öƒ_½«§dQÆ‘x²÷m—âÐDŒŸÎŠ 2&pÖ1?oÑHÎn¹¸äÞP '«Š)aÏï¥ÈO·î Ñ,ZÁ˜•Td’c.À–b"ÞÓϼ×æ]¿Kî´”Fg]gZáÚ^ª¥`»©•8áÝ?YÛŸ%íh)´Ú¤,ÊjDMU\Ȳ$v¸+lTw¿K¡Û~¼Š,_<%¥‡âf,ºuÒ#õ€z½¶ž€LŠóòã›™Ú,3§¶ªe…ê ´iÃRùE[–ô¯+KW·ÅûNEqÇcíjû\ 0&p6ˆ¤ ë#Âä…v¯o*Uµˆèh¼‘«/a#‚Ý/ý¶é%²2%‡¬2w¦ãÆ .¸ž?^¿$W~œ‡ÒšöçâÖŸhÀIÙW¹£ž»çxo÷¿ýT#¶Ÿ2vÑÖ=£Õo5ÌËÃ[¯‡Õf¸ µÅyúÇÊbüg±â1†¬rÅŸ’Äuñ3¹Pý˜Üš±ë0…Êô), šš:÷ÝÜ,ÿZ#œAÃnWTŠiÏ÷ÅÀ@'TÖ6ãîï PPÕK¿XíJÚ½‡E-‚ƒ3M°¶àÀÉ»¥³ääd=EË´iÓðõ7ߨöõÈ£RPncåÞ-·ÞŠ‰ÆkëZgR¶+J!ÄÐAþˆŽ’ÍHÅþœÑøiõ rÍ×ñJQ¾³ÉΖV=\5Bª¶ü£=Z%‹n;_¬8 0}Źô‚Áxï“ýº‡ÏÊíž:º¿ƒþCeü˜P#ž”oNÚ½7»öå´[4ñ„é Këëv<{z œÈåY ½|ÿö{Šî¡nÛn¨­F)¹ëÍä?p¼)6‹’b¦‡ä_V˜>gÿ6dïß¡TUý,:qD5¿·2=Â"µ] ËS©ðøAIÑâlªç3&ÀÎ*µš|ýB–ÿÃÓ×£fxaíǦïÁÝ2xzýhnl‘Ü<ÛÙ›v?¢Û÷a ⪛&ÑJÉŽ-ºå{rÛž¼Üö§@ö"͸”âãПZŠ§8-¦-¢üIZÉ*)Z†yÐ^>|ÉmŠ8gbØÉ#/vª«nFvJç-f­%WûWcÅyL€ 0&нt=RR,°IQÂÆE?Ò"SI8¹u’¼(÷MRÔ(JÝòï¬Ára*&ð¯$KÛ·ÿÒ¿·ë–U¶ •,Ý°NZéJõ³·ûWª2 ‘•nbîxëIóŸ%²Ë[(žN!Y"ÙalGÄû;’…‹‚(nš«n˜àƒ‘tþï ‹gC¶ ËôÕ×QM>n 4™FO¹HNN²iu=Õ=Û’0/{r—¤M¬#3ôû, ó­î™ ïëì·a©¹ÛPYcå…ᘷmÛ†)S&k³'ÂdðàÁHLLÔæ)ÇŽ»drpp@|\Û¤¨(»wï^¥ŠÙŸÊ¤|{æ…Šë1ñl*‰Xß?…Ìûá÷'1fd¨ã⺫†á£ÏMObšjÏœüØhoxyÊ ¨4Qo*íÜ“-)ZF¤—XŠáK5™ÊW-Üó™}åü b]J­—Ôñäbü´¦ ŠK뫽hÞ)w/)~ºÛ"K¥û^Én½Î¹çIŠÏdƒ“›Ö"tÔøD @Âå·âY{˜L­¿ E)‰H^ûÉb}ñ€­}›«”–&ӆͭ€•x9}q,,`LÀÚšèU'å@ÆP€ÙÀþò‹´µû°¤=åùÇ’6z³nä`g(±AêëŒ-*lh1‘8KÖ*@®IQEœ\DÈqZ¢†È«BsÉ…Gß|“tဵäïB×fU±%K(%5“kNL€ 0&`]Ìñïtƒq6ð&פ"m;eúýk¹õŠ–ñ¤p1T´(¿èm¿òÆb(s;íL_W23§·û7SÌn/&æ ‘Œ¬#ëZµx/í !({)ð½øª¥¢þný°dŠµë!ÿ ‘öd­Ó¹¹wV´´G½Ž•WT"4$|©¡Ñ<Ë–?yµ~yEǦØ=0«vñЊ‘ï.>zxUŽæ?ô[µÃ>ÚX˜_½â%éö¥vßÄ᯿þŠ»ï¾ ®®®R_B™P~®@IDATñÌÓOášk¯CMMÇ+Ðî¼s)|}}µ[ÈÖÛööW”k ëlh(ŽŠPVxy™~‰VŽ•“{.SéŽ›Ç $È•õx÷Ã=8gb!î§É÷+)NÊÎÝÙHL*6UµËù«ÉÁÁøg·ž°‰äêb¯Ú’›kÛd¬j^ÎìÍó'~73³ÛqåãíŒöVP {‘\»ÈÙÒú†§oð?DGÊ¿ókÖ%>k÷GßpÜCQ_UŽ}Ÿ¾ŽÂ‡0qÉ£H¸èzäìÝŠâ䣪c¯¯’Ï¿½³ü;¦Z¨fêºE󋆈ɢ–¼Âe7rºåÕÊq`LàL! §?ñu‚$îûÿL&…Š±ë,q°ED6¥ÔÞ¶Rl‘M34'Æ0 WZöPW¤ºÖÀ©ºeêkä:În¦Ÿ¥ ®êõuÛêÊv=­ÞÉÃ[ýùÑݧM.5EJœŸ…‚Í¿z§±õlP”=üßx:JV*%yê滋Éu²8R áþEqjDJ=Ðq|©`ÿ³–ü]ì¾Ãj~¡m祬¨s“46Θ`S t+±YÚK~®öpsR·DuÔQ‚·×†rLmºGCó7BYãÓzWÊê~ú¶+Uy~Ð-§lÓÚŠq¢ìµÿÙý·ßc÷5uŽ„Õ‘c«%±ˆ¡c*‰°C€‡|¯]sLV”˜*kn~‘æ4žý­ciñHYFÅv^Ñ¢~å™+—³˜@Nn„뛘¨P³Ú²¥o_tTêêPRÒþä¢Y ö¡BK&»â‚až’YÖ“¿bW†úÃ|¹ÛD{¹Ô¶¦®É9›º­ŸòŠ |úÙgzíÇÄÄàý÷–# @/ßpçÖ[nÆ ×_¯—-7ÅÅWf¤ž,‘Ú™1%ŠV³ë5)íÄ+°ˆ0±šŽ\œ2&/ò…˨çÉVo¼»åõXK“ÔçÑw¬ŸdéâèØöÂ)êX#åäUi_þgO‹VmÒ–ì[§MŽ”Žeç¿tææÉy#†K²6"YÁfö¡ýÞ<Ù9U¸ñŽŸÚýÛ¼åT»´NeÈþDG R-çåéˆGïŸ,ýEFÈסnAKëë¶%¶¶Z³”–ÕBXBýRð¨‰Rl1ÖｄúŠr¤þ¾ ùG÷AXqœsÏ°uT·þ,Ë<)! 6F•£§&Ýó¤ôçÙª°P-H™MõmŠ\g¯6%²©ò–æ—“ì5¥r š!ç_­Úœ³"§œ+ËÞ¿]µ g2&ÀÎ4Õdé ‚€‹g´áS½TÅ®¡”ÀòêŠÕŠffλ!½?×ý3RµFÜísYA¦ñ¤N~º,SôPR2?ÀF tÔº Ë?ÕvQí¬ ™™rÿAQ²%‰añ#e…G -Ù,R Î7²õÙú°úâ=Gœ#‘DœS©…ô=§ŽÉm„pAÔ`yui*¹ëÎd-ù»KÆ—JM—Ö£0“-ÝÅ™ÛeLàïE “F\ñqa»$›¾ÿdS}eê~î õ÷K¡ô˜3@¾‡f•ÿ~'Èϳ¸ÂøîO÷Lô§@ë"%›¡hl®þº7kï&—eÆ s Ï°µû7l¿§öcÉ]—¯‹1A¡@Q¼ÝäTÈ‹JÔdZ8T~6I-ª‡ponš?ØÍvÇuãÛâ²èÖ–. Mr{u&ÚaE‹.Í^Ø.*)GQqbc"ì×®âEdDB<­ÌvƉ¤S’ïþv+œA'8J>ð„È_í)C"­˜ ñ°QýóVù"žACíPT'w œ'•;pr%gó0:l\¥ÀgŸ}Ž´´4½#C‡ÅÏ«~Â=ËîÆ€Èm€¬%öööÆœ9³ñá‡à®»îÒ«S_OV$Ë—ëå™»³æ7yÕþàþX¶d<u– ˆ‰íÇ™.)`2²Êq$Qž”ÔmÛÃÝÜ}Ž”µuG6mI—¶ÅêÇ—ßÜa1âÛoTŸˆéÁnzŠ„©Ó é*ƒJJk±cW¦Ôßí7Åù ¯¶ŸÖ Wüßc3È…™ìtÍoIRYÝÿ„Ì"ºãÞ¥4~…ÐèÁXÔª@Ò­£»m‰üºítu»·Ï_WåVê­û#b"&Ê·\?B1¦$”þž;&`öŒLNn¼ŒWJXZ_éK|ºÑê›é¤pé7’«¹u%¯”ÑGÿŠ×À½?;ùÁÒΙ& ŽÙ»è?Ð8º{àœ»þ%.s×&dnûC)}·¿óŒ¤üðŽÀ¨ëîV%prÃœ&k:ŸÈxŒ¸f)llÛª¢¯q·=„˜ió>n*jJòUÛP2ËN%k•-coû|¢ÉoJᣴљO!÷±U_JU¢¦ÌŘ›ï‡½KÛd–èöoÀ¬uê5Hýã§Î4Ïe™`}—=£íúM~¦›0/ç]ﯧ¬Ö&7<IAè¤{áÞ?Ê­>–½¿Ë }„¢dÞ þpÐ E瀋ïî/õ™Z‚ ㉖›Ê%ÙD –kÿÙîÞ:ÏäjâÊ#¥úÅ9µ0ÞúŠ–#[+¥þlqÙ}a¸¾­ÿè'̹*Tê?yêªõß'œ\m+ßoNšP´ˆ™¨´còb %è¼Ô Ê©årÑ îðw–äJ;j}å˜ÒµµåWÚíʧp&,´ÄŸ» ¢†8áúÇ#0bª¯Ô܆oò´‹²ÔÚ|‚ìÚýsvk;·jmp`L€ ˜G ¸ú4¶¤j¤Â˦ûá’‘NЙ~B0ÍC>¿Ø[ ’. ­<$—Õm}åa9/!ÔÒ„½£Žn$Êφ‚¬ûK ˜Sdys8Û´¢@´9<Ì‹^;¹­w€vÂC=ðÅëeÏ¿ä Iy£dþ÷­íˆˆð’”9Ë–LÀí7EA¡FR˜êb_ñãQìÚ›£TÓ~î¤<H}ܘ0,˜;3¦F#‹Üa¹ÓÝ#$Ø߯JÄ%çÖ–7Ü°T~Ãö:»ßÛ篳ò–ÏȪÄŸîÃm¤ˆnæΛŒÌ28ÑS)_„âO(b^g'¹Ô3¶´³´¾®dXÛòý²Âf¬û,óo Ç Úúø×Þ(£þȉF/R]uV½küì3ÌY²ÖϧÚQˆ¤ªÂЉ>ˆ•Ý›–9EÄi¡$”VbAR6½¯Õ×RãÝ”¬-¿%bŠë÷ÿV Smbóyع¶}%¡ s~ì“¡ªõ•Ì ßäà×OŠ”]þdL€ 0 üg}¹ø<œ&Ӝ廧žF^eœéù#°Õ•hþ‹Ýeªñ9öQL±@üª±Þ¸˜&ìÏä“Åõp¡ç‡²ÒË6«éþÿï5ÅZëSâºQÝ䦳èV7_wÛšýë¶ÛÓÛ)dñéIÏ,«–„RlîzRXõ“,?ññêÆ“îÔft’Ê7Ñ<Ío\̲ò` ySò@¾ô\Ü?ó4ÊižGôëC‹gìZÍiö¤×´ÆoéÓ³¦k‡K[@@ÄضㆠETd("ƒÈÊ¥M5­Ì¥u/Oú£¸%4Ñ}äX Ò3Û_‘k(\µw™$Å©ü](Õd÷ˆDYYY¸ŽÜ€½ñúèß?¨O±ÒÊ”’EÄeyéåÿbõêÕFõ:“ñ¿÷Òµ]Ž«/&Yv $».k"“½]¤„øÅ\JÃ4{z”Ö-×;ïï†p·d˜~üù¦OŽ‚°˜ùǽ“qó?ASm½vá¦lÉ=«qíÃ0gf,DLÅÕ™xMN)ÆWßÆÖêŠ(QæÉÿlÂÒ[ÇÒ$\HÁ4 εuMøô«ƒøcÓÉv-†ãíý3ùü ^+~<†Üü*\ÕHRîyÑon°ãQ²¢úð³}8|Ì´‚ÛÒúJg [­—ÎEnžñõ®”;[>#§ÎEä$Y³çÃWT B9i6ü$àœ»Çê{®DCµ>›ã?}MA†_~+¼#b4´m%PÁñC8ðå;(J+ÀMÝ0ŸÜ]úÒäzd««/º}ã8-ZøtW96§šž3zc³§JqãoiÂ~Xëý_Lüo£Øg¯oª@n…éû«"ý^r-)q´ÀDôýÕÞö•óJ=kõ¯´×ŸâY顕ŤìðƸH­EdÉ"”,“M??-¢…:"mO«†8ŸI"Dï-_PÐ{wœ;ÀN¤ìÒU°iêZ°æh–oÓŸs0·~Ƙ”hѼ)R;«Ýbn{}ªÜ™(¿·"#‚áOïì%žUšäçãTF.êLÑû|æŒ$àææ†%KnÇå—]Fן¼®½$''ãÅ—^Æž=ú+ÌÛ«cαà 7ø’²B(ò ªT­Ìi§7Ê¥Tp+MÔ;£¡¡…ETÐês“pUî…†ÆfdçV¡ŽœiéL>‚u€Ÿ ý»Hñ¢²s+QUeþù³Fý3í|÷5y]üàâ(Y±Tåe¢AÓ9SâÞ‹¯¿$¿°bÑæ’Ž±»ºÞ–‘ûgL€ tß`;r¿e') J UÔwG¿J›~!rÿM-(Êi2r·¥”3õéåo /?{ɽsq®ˆoÒñ‹©¶º’/øyøØA,R*&ùk5=ÛWdæ:L€ 0&Àz“€0^îÂ|\û¡ÜvT’uC'-2CÈu¤Ÿ[?Ô4e )Wª;7} ¹®Š °A­+Éí³ƒ¥ý÷&¥o?âL«‰azI‹4£3üìOn:WÜ*eÿce>¶œìú<¹pÙJýº’!2éÈPEž^óéˆí®&V´t•\ÔïOÓÙmj>NL  ᢋ.Ä´©SG1+l¥Þ… ±¢¢bìܹþ¹›6o¦{|}öà©á®˜`L€ 0&À˜`L€ 0&À˜ÀߎÀSÝp-…›(%÷¨‹—ç¡5n}ŸáÀ®ÃúÌ©0¤¹™W!S᜞ ŸŸwÞùŸô'”,ÞÞrÌœ²²2)VKOÈÀ}0&À˜`L€ 0&À˜`L€ 0&ÀróšSÞˆ_+ûœ’EÈÇŠA`& 4Sl ââb“Çù`L€ 0&À˜`L€ 0&À˜`L ; ,ù¦oÏO’72NL€ 0&À˜`L€ 0&À˜`L€ 0&À˜`]!ÀŠ–®Pã:L€ 0&À˜`L€ 0&À˜`L€ 0&À˜ ¬háË€ 0&À˜`L€ 0&À˜`L€ 0&À˜`]$ÀŠ–.‚ãjL€ 0&À˜`L€ 0&À˜`L€ 0&À˜`E _L€ 0&À˜`L€ 0&À˜`L€ 0&À˜è"V´tWcL€ 0&À˜`L€ 0&À˜`L€ 0&À˜+Zø`L€ 0&À˜`L€ 0&À˜`L€ 0&À˜@ °¢¥‹à¸`L€ 0&À˜`L€ 0&À˜`L€ 0&ÀXÑÂ×`L€ 0&À˜`L€ 0&À˜`L€ 0&ÀºHÀ®‹õ¸`c666hiiùà¡3&À˜`L€ 0&À˜`L€ 0&ЗÜ9Õ Îöý°+½[N6ö¨h¬héQÜÜ8³ $$$àÖ[nA¿~ýp÷²egö`Xz&À˜€ Žž^ppqGU^–‰gwöß}üg÷ÙåÑ1&À˜`L€ 0&ÀÎNÃBmqí8oipëOäöø YÑÒãȹCs„xÚÀÇ¥jO#»¬ ÍæÔâ2ÝIàŠË/ÇÃ?aÍòÓªUÝÙüý\àëãŒÆÆäæU¡¶®©[û3l¼·û7”çLÛg~gÚÓ—×ÑÓ®~AÀéÓÐæ AS¥_à,ß 7Ó|6vvHß±[^zì,±þðþîãקÁ{L€ 0&À˜è~¾Ávpó´C}]3ŠsÑÔ³ °»€ôàîm¯;´Ð¼OI^êªÙ{FÈø° {ØÀß½ê›N#§¼šúÎ5îïÖêÛ ¡µ~m{»ÿÎÑêþÒ ‡ºJd—5àpNÏO&³¢¥ûÏ1÷`&›~À壜qÕ/ú‘j»4Å݆¤*¼½¹%5§ÍlíÌ*6*öb,ûï…NÌ\¶=Ôa9k2x°VÉ"ÚÞ´q“µ»Ú›3#×\1a!Úö››Ocמ,,ÿx/²s»w·«ýŒgŸ˜­•ÙÔÆÞ¹øçSL>ãó»ÊÏšêï…?< ¡Áò5”žYŽÛïYmv½]_WÐ;n‹  D•¦7-]‰ÊªÝÃVß5#¯Zßèmm“²¥àÄaøü-ÑgGÉ3"¡h$åLþ‘½ï‘ã®!¸àÍ菉~}ô”ž<Þn¿ác¦HJQ(bÜt Ÿ¤tj·R/ûȵXO‚z;¯)/¦sv)ëWšuî”ΔñûÆ ÁyϾ§ˆmôùí 碱¦Ú(Ÿ3˜è;.^Œ±çè ÔÜÔ‚ªÒFd×`Ç/ÅHO¬Ó;®»3þøWº’­÷9çj?̺2MõÍxþæDhhL$…_~z ^»Ë4çÈÁ4öHu~Òý§Œ?=± ï>”¦dk?ýÃìñÀ»ƒ¥ý×îNDþ)ý™3Kë[zýYÂO *n¤3n~:^;^SÉûÊñÑF‡uÏÿEXñ_ãUÃϯ.Õ{ÿ±dœ<\kÔÆ¥÷†`ôl¤ì/LJ÷aT¡5Ã’óo­ï¥«ò+㘓/ðÆô‹ƒáéç d£±¡â7ç—óPE‹N;JË^AHŒ›j±ò‚:úî$³ÖõgØ0½: ¶ªÙ)Õع¶‰»Ú2Ñs¯ EH”‹¶©––ÓH9PÕïç ?]ÿ{§-ÄL@…À=ÓÝpé(/TÖ6ãÊóQQ×þüá¢G\;Ö >mß¿fúÊíJ¯Æ›Ë‘^Òþ÷oÞ GÜ4É áÞúõ·¥iðæ¦ dµÞ³TDµJVoôoo l¼'L+ÿ-_æâD>§‡f»cñ0O©ÌÚc•xn]¥¶¼ØxxŽ;%xbOF îû¡T;Ž4•<+Þ]jfͱî?4%kÛl¶©œÏz€=càé…^˜5@þB4ÐäzQU|¦Œ_Ü7 ÇmÖ¹`}†€¸ÇÙÙéÿ.ÛÙÙÂ1Ä~!N5Ó›¾ËÅ/ªÊ,~Ò ë«¤L2È6J–ÖW ŸóïèǶNl;xæôæÊ®ô£|–—4Juí<íaï4¶®¼õ v”Æ)¸zùÛk-žþvRùÊRýýlù‹>ìÜìç&ýŸëÿ=”¬mK‘A|ª?ÝãzÛ*÷_¥¾ É¡–\huð4š€œ¶¬,Ô*YDÙ´ÃU˜zaBc\!ÊÕTéOò(íE'¸Jõ5å(ÈÔŸ°UƯvmˆúº×‡¸ç&‹ë[xýZÂOŒEp5ç4u~”þE[Ã&ûbå[¹h0X®´¯‚OT“®WQÆTR!•ÿ,9ÿÖúþX"¿4$:ÿW?ŽSeee#yò¨,ª‡‹‡œé;8†Pq#=ñÖýI(kUšª ²lè}GamXÆ[ÝëÛ°Žá¾ÚwD÷ü–·§IëÁãÅŸ7ö¬/ÄŠWI §2…3ù|oRxö×V¿QâZ00Ú ‘Cܱü‘ddž0¸°´5xƒ ´ˆ°Áe£½!n)Ë·•u¨dyô\œßª ó¹å ðt¶ƒ·‹-&E»b Í?Þ÷}>öe©{W1@÷Tu¤M£Å .ýé눩±nî‚;Vä!¹PýþÔ&y׶z³;zΨªk;ÍÕÎŒw&EK›BUÜ-§Ñøkê[àáLï©"à ÙÐhÃÎÔÍÁ |gvgÆ9•žÇH_‹µÇŒüi««e;žÙíjË\ t‚€Ð$+J–w”âZùPO¿gÒ—4Ο?zàxt®7îù¾{&Ú;!®Õ‹Kÿ éù{TÛ1³FÜ+KÉm’Sµ+dNœ0Aj%3+ <øò(¤ò¤dA?Çh•,¿¬KÂ;ì…P¶ˆå'› w<úàTÜ|çª>׿xÐI¬¾¹‘,L¥:Z!x6¦Þ>ÎNv¸ï®‰˜5-Z»kO6 Š4X<_Ç2£ð½]ßP4ñ2/Æ#®«ÄEX»ÞôJMú]Ùwñ À؛æÚ…o?ƒšbyRË#4Sx>‘ñ˜´ôŸøñÐ4ÕõÎKWÆÖ•:ywáÛæÀÎÑõUú«oºÒ^OÕ)8~½ü˜ÔP@¸…aТ«>f2†^t=ª rú{ÇnÏ”ñ—¥'á§;/ÑÃ0d¤têeò`}ž@ÚÑJ|þ\º$§˜,ô vÀÔ‹¤Iº—…uE=výZar5´8ëÍûŒWlëV¨©2ý –•¢ÁW/dè7Ú®«1®ïèÜ/ Ũ~Rùã»ËPVØ€I êfløºÛW—èeä7…£‰¬ùÿ»$Qï˜Ø)Í—Em²xøØInvÄqï@G²x©E0­ ÷ °§ÙÈÃWlC’MÚ0ø/õp%¾ýoÛøÝm1d¢'f^"µyåCýñöiµ€UËs°îó|£|%cÒB_L¹ ‚)EˆRVísÆ¥~p¢ /QãwÅzEN©•ž»Å³RôPgÝÑ6É£[0:A^Ä—rˆîçÖ}}ÑíÆ¢í®^uÚ?Q·ŸÎûËK·_oJû 4™¦šä×é<8ÒdÚà î8¸¹gV[rþ­ýýQecFæø¹žZ%Ëï_å`ãŠ"YQE\&¹áò¢àéë€Kî Çû¥·Ûâ§O§ÁξMÑ+ O˜ïƒi·[O´ôúa_½®íG\WÞö˜~I YßyIV‹…YõôÖÿ½ó ²Ã¢Û"¤zÉd½òÝk™Z…RÄG\ýY;áÊ"ñâíI8mâ2ÔvÌkâçì‘9¾’’åHN-~>lÚV€šAsŒŠ’åKºw°CÅÝ×  LùÇIçxØ¥7!õº‡èþÀšà™0~!cU^–ÞÜÈM'&ÀÎ<M´’»ª´m­¬°©‡2pÝ¿Z¤•ò³¯ Áîß*Lþ|¦ç¯¢ì®ÿf7ҪˮԿðÎIÉ"î׿~œ…MäþbîµþfáKqƒ¥T.ÓD?ÓíÉS«i‘”B ¡«hñ r@>M,ø’5—›¯V—Då…ê«Â…«0Å͘$­žÏI-‚¦¬Ý‰(ò,àj/ÅŽ·þ'ΙîyÓ=ææeƒ±sdÔ4‰ÜÙx n¯áœóƒ¤&ÿZ™šÊ¶ëCd ¹i5‹uEÌwUE‹°Š,+ZR’¢¥¦®^í §#~¢®b¥ÐBhÛ»ÞÚëGË&Eey¥5Ó§Ç-–œk:âcêø9çË Ù›ŠõÝÒ÷ÿÈ6 œ]3qÙýQ@n¼ümQ®£`5lS¶xiSÀŠãÕê«ð ëZzý5Ðï§Þïu b¬¤JÇ-OGJÊ–—có%Rü¥ÿ‘3¼`K¦µš&|úT:êkÛ&2“êñõKé¸ë•ðwFÿNíº‘TÚäÏ¿/‹G8a0)æ„Û¯þ(íP¯¾¨U ¿íd5ÞüKîx~ XY„•·…I ƒñätËIýgŒ ‡Ë“ùÇrëðÂúJ½þR‹ZðØêB|zm¨dÝ2"ÌûMXÅtõŒõvÿBnOgl'eÊŒx7k"ÅrgZ¬ìBU°éiEKÅÙ!»!\s´÷æåXÑÒÕ+»ë¹¹:S0po¸8;Ò ‘rCš¸¢246™w³ìFѺ¥iáCOh‹EZB}Â~cr=)ZäîãÉü½ü~ží)Ø{ ®˜ö™ÔÙcç‰Ï±åØÝ6ä)¤`yú©ÿƒ···^ 8räŠKJ°páB,½ã½ãbçÞ{ïÁ?ÿõoìرÃ蘹q1ò‹ØŸ[N©¾D§œ,Efv…äF,.ÖWOÑâåéˆAñrý *“›§£Td6$®.öhllÁÞƒyJ¶ôiIÿ¢EÑ",Z,MÁdf:2þ²ö?7¿ »÷å ¤Ô<+‚°PzÑ‚i…YŵõËÊÛ_Õa‰Ü–ð³Æùs Wa‚åÙ7ãØ ý挫·ëëÊèë㌛®)e­\¡hìîä*uQœ|LOÉ¢ô«ÉÏF.Å[qñö½³þªÏðh¸¶­–V"9¸º!tÌ9JÚϪÜ,Tæfj÷ņwôrQæ‡Ú²RÕø)Â:#xÄx©NqÒ“V&¶ö; Þýc¥²%'‘»w[‡ŠGOøÅ•êþ',{ÊÒS ³Mî‹x0CGÃÙÛ-¤øŠ*«¦¹^}rËdCV¢XnBÑ"܇%Ê¿QÓâ\QN–¨9åúÊ_…îgK+=qgÄÓ³ýVT’åîŒ:£¸/ºõLm/$ Wal©¡66ëüÞ˜*/Ê&„Ú’eŽ<iþiêO#© ‡rš»l‰ÔödfªgÎï1î®2(~¾^F}6“j6=3É)™hjîø‚5j g<¾F¶P8š«®LnÄÄ# ø"ëæ³>ù¸‡ãš™ïÁÉÞ‡O­Áº}/tÛ˜'Œ×^}…ü¡ÿ888`ôèÑíöíëë‹·Þ|7ßr <ÔnYSÝÝäUweeê7:QOñZÜ\ÛVè‰|Mu#n¼vb¢|•S‰Û–ýŒ†ýïˆP²¼òŸy’¯å÷?Ýg¤h±¤!ƒMë’0K-Â}Õ½K'`ÖôINÑ®’š(0ìŠP¬ŽƒªŠ(QÎ…ü‰Þ{çDÌœmT_(—¾þþ0>ûúÉúJ_]ù´„Ÿ5ΟP$½ö¿¨êb°øÞ®¯Ë|é­cI!耢âj|ò%MN÷@ ‘œ¼|Lö¶áÉÖ™ƒqç^€A .7ÈM’‡aæc¯åþþcúê]½ü!^‹¨sæ s×&É¢Fï íˆIj¥­õO,•¬4 ËxFÄ`æ?_†›¿¾ECqj"¶¿õŒaq½}ï¨xmûzh'õÏÕØÑA}QGÄsG1nb¦ÒŠR8è¦úªrìþð¤ÿµN7»Ç¶+s3´}¹ø)Z¬1~× LèÉÅœ¶3 R8ýõò?Qž‘ª“+oÆϽç]áúì]S|ÎnzåÒwlÀöןè6+£öÎ_ -r9úÓç8ôõr#e‘WT,&ßý„$ëªeW 2û”žÜÊN̬E{ã}¤È¬Áw7ÍS²ù“ 0讲÷òë{Š–¤½•øñ­œ.¹Åê`è.+j å“P´ÈnÁÄÄ­¹))%eJyq¼Úž—•2å…úEu",„u¸­‰Uë榈Ž3'@*þÓ»YhV½3ÙœX½?a¾¬ðÞø]žIk˜ÔƒUäž(Á‘.Óâ´X½D •‡e˜XaÿwIæò³i}§a]J:ÕŽí,ÃÈi¾>ÅÛ×”w©¹ÎV²äü÷Ä÷§£ñ|ñüI©Húqõ÷ßFŠù |ÿlɥ♘w‡Bv7ib»MÑâèb# ©V£ÿÞ®;Îÿ=œ,Ål¿kœ˜€)÷Íô”br’Ñ÷·«/º5¬[RÝLJ ÜËxL”‹ÁÜäû«(k˜Ü)–´H%í\¿J:ñÛ Ûéê~o÷/ävr°!eD#…|8MîÃÜðîÖjDùÙHÊ©UäNÍÛUþŽ·7FatN´=ž[Gû¶ß¹¥Tií±J<·®4fVµç /„Œ¸ÜöC<…‹7ÙEœTéÿÙ» Àª®¤ýwwƒ„à$¸»Õ T¨»m…ºR£ºívÛn©Òe+´?u/ÐÒÒâî, qw7þ™ór_žçY8/ïÞ£s¾+ïÞó™ÑùÃDÙ³+‹Ì"îtªÂðY¥[Jîw8=£Ã0xP<™S6#9%Ù¹d®]]KÒÈÊÀ½b"h"9 á¡A´:= •U†-?:\Ñè€/€ÕÇLÿxö!S4å²Ë(Õ¿Ñu€Z]Ö¤—{nšþ<Ýœ½ ¿nÆ KnÙ]Ø‹/¾hd±¤ýíÛw€ÝˆY+J€ISÏùJ\œ¥)LB¼öÖf,^4Ñ‘>¸ñêD|²lŸº[+¸éÚ¡Âò†É{‹-øÙãøý¹Fõ¢bí¸ºº¾¢÷è4Y=1Vì~ðÑNÔ¶Æ)Rò;ê»ðÄaÑt`\„‡Ü½æ[§Õ–£<ë¤Z57¿@¸zùÒ„x=ª ²ÕéÊF]¹å«Z•ºÆ¾ÜÝ1ãÙ·È !Œ^H[¹k“°¢pñôFì¤YÂe–±ºœÞTW§5Nó ¢à»Dž˜%tNyòuD$ŽÅ‹OCqÊQQ?‚,qÜ|ü1é¡—Äï{Æ–¿ÍjÒž…NkÌp98«^4Û·Çø§=ùücâþ¹dÙQIVP|Ïö ¦@Å„od/Ì|îmS…û3$ŽNΘøà D¥c9Ð~ô¨‰ð‹îM93Èâ©»?þ¡ª¶¥Ññ›þì"„TY’1áSxü0i¡Aä°1ð ï‰Ä+nESC’~øL«/>ž ßÈÅÓñ3çbïgïhå+;½§^$6Ó¨¼±ñ+eå·D@"І@3½¼+â¨ñ®¤uõ÷®¿Ê»L…2²haá,¥ŒVa²‹° ¯ˆR¦´Ð2¢¥ï0ñŒÊ1còÒʹ̤gÒËæG‹z‡)îæñ=–¿³Î¼.Ît¼9€ýæ_ [³ðØÒ(È-»mc÷C½<„»%eÌüÝ;QqÖuÇISŸÎÚ6?Å¢E!Z¼É][¿^DØ9‘;§frýTmš ¢cÍâìêˆ}kJÑ2|F`§-¶ÿθ~TèþÛH—Óþõ•†3[S#â\ÄuÄ»…Ùf^&[ìüL>—©«Ñž-UÞ•|Cßš0†òešD`l/'u¬ç·Ö©ã¤´‡ÌoIUA.¦fòÅwûªÉúDûüœ?É[Lü—UÕ–“ús•­·?“ótL”²ð\½Ei²í)I¿‡Žì_éÚïL¯Æ¤x/A²L"ë3–u'j04ŠV€gªÿü…Á8’W‡=™5Dp9`2¹íà‚‹ÈmiYµjÆ1ÒœHíDÖGªg¡•‡M?{0~¯_„ø`ò"E î:UM8âx†’¥ÎZÀÑ+ÐoÏ Å•Ÿäš}^)úµÝù”ùÝéDE„ qpríS‰=û¢¶¶í‡”­W ‹ÊÄ'<4&MûbìèlÚ²&]õ/øNW¾“:¼b˜êA9™^*Niß;I…NëfTŸkàç%ú €«&½½)?áxö:»ëpÑE",L5¹omãéééxìñÇQoçóÑ›VÔ’ÏhžˆoON¦—Òêÿ}øÇÍ#põ¼¬Û”Nc¹éÚDATÔIñÚ¢Íbò¯½ö8ß’þù…c´Ìš‡Ç˜ V߈DúÓB¿r¿®<†Åïî¼”tå{ÂØh5Éòê›±fCš’%^_xr*ÆÁuW&âûŸ“„û3uÚ˜8.FM²pL«N¨³ðøƒã1sZo\CØüBzt¤1¥cKðëˆã§èq¦|»©vÿÝc…º;wgaÓÖŒNS={çF”眂oDOL[ð:Ž®ø)kVèÅ¿0¤»¥â"Ãnºƒ/½e´²ÿ÷ÇnV’;ô;vêlA²p'Þ|Z+†Ì¡ï?ÁŒ…†'¿¥Ø-Õò®UvÅ÷ôçÞ!‚@u<´2 ìDž¤&Y¶ÿïßHþã'u)&k¦=ó ÇèÛBÖöu‚pQ趎Ÿ-b˜daÙðÆSÈܾ^l+BF༓;µ`„9{¶*YZßþ½úàتxWÎÖO}E¸>ëwÞe8ôÝǨ¯°ï„YÔèÉj’e㢅8µiµºÿ½ŽŽ"ÆMÌè)H¼üfûõKrÖ6QÙLî5“׬Ġ¹×!~úlør±V>7Ä®Ñbû‰6S×®T·-7$‰€-”µ’&ŠµJ@ˆjr¡„¬VÊÈÚeÐXuó>AªÉŽ²‚v–w¶Öà ~#ÔHÖq¹'M\ÌÝwR³nŒ[<>3Hh¸õdµˆíl®º«’ê1>¶3û{ãׄáÝ ÅXu¤ž¬X0²fQzù/ü^hö$»7ýÔò:ÉÆÖuá ™`®N¶–ëŠþ½‰WY{¼F-bÝ06Ö•ä¶kwF¦ô1¾hQ!Q\o÷–iÅé^²¹Š,M0Œ\=ÜŸï¨FµSßsZ­XÙ%)×ôâü¾¡‚daÌŸ^ž§w©À[*ÈË Ã£‰l³ì|N-_8ÉÖs¶Ãêÿ¹f;È’…-T¶ïN.Ç/lݢܕìÄÔ)Smnåý> r°Öæv4˜{Q?<@“Î¥eµ¸û¡fÅ'aK• ££1p@ãqßc¿£w/\uY‚hzÉÒ]d)fÞ‹–¥ý+1Z\]œpß]cP@nŸ·31òÇFÀßÏ —]<åuXöÍAÍ¡ŠíÊÊz ⾇¬Ø´HÎä•z_~P-ì^,¶§N¤h[Œ#Ú9~¢H‹dáÄ&²²YüñNá’̉õ®×‡¨lÇ?–âÇ]ÛóøÙq(ÖÔ d‰æzr{÷îwhõ{Ïí#1kz<%åáùW×kåÙc‡-)׿¶ç½üÜ}1˜&”ùSš‘Š "R×ÿ†ê<Ë'Kì¡›9m„QL–‚c´HNãXGV~ƒÉ¿Ì»"1£§ŠvÙM™&ɉMuµØýÉ"Ìyk™ âvZ¼¡T'üñPMвɚHWòíÁ××OÉ-DL¶¼Ñu+wšfö-{_-láÔ7Ù»7kªô†ª ìýâ4TWi‘,Ü_‡ÈŠ…‰'7ŠqÓ›¬¥Žiõ“²úgA´°%WÔ˜©8µù/­ü¸Vk–ŠÜ = •'w$û àI+ÿµbˆÑÆv­.ÀOïåÍ sÃܻŒæ³ÅòÊ ŒæwEFY«+Å¢%LeÙÂd O"»Ó䀫{°%[‡Ô×6‹ò†t懅_´ZÀÐ{×u!W'r†^{7â(Έ£‹+Y)ôŸÄ+n1*öù¡^Œ {ê`m[žª•L%i' 6QzÒpºÁÂV$zQu–¢ä#k—žJÇùp 8X\¶³»T¦kËZï)tÓæ öºDwÙd_–™F.çôã«ò²El&:Üýí>‚‚¤}à1©.l›àpölsÅ£”¯ÈÉ@Þá=`¯ϬKµÆ߃ܿöžr(š²î7¥Šü–H:&Œ‰æ*}Ce8XüäËŒ-ì:«Û-­-¾*K– äZCþéy•y‘jÒÀ7˜H‹V v'fL;Æ@W]zÀÃÛ‘ÞUé>®?¡[çÝBÁÐÁ1QÖ}[¨—o,Ih핯å4ÉÕBÎX5‘ž²¿ ³®ƒˆWãIïJ ö¸ÕýºWk?wë6èLDC‘mÖŠ­õm=ÿ¬Å^5…pýÝ›Šñí[ÙjË·,ÜöRâ}0e^86üP¤?Q®3¸wm©Šh™ØiD‹µÇ_±h±Çõcíyc¬[%Ýø”*ææÍÅ8¸©í=ÐX[Òm=ÿâ|ðÜWÕ*0QêN­•÷ã¬Ôj¬ü(OojcƵAˆì­}/àò{É5ÝámÚ“±¦Ú‘yg?½pÃh•ÅÔ§ÛK££Ëƒîk~Žð¢û»1a—Q§JšPIs3®ÎNðqWM¾sùœ2Z´`Y2±7¹Ú¤z´X€‰ )fühSÌŠô®êŸ]‡‘§|rV#ˆV}Y¸°8·z};Fþ¤1I£Ÿ™F^ŒšèqûA‚1M´Ìèç*bÆ0qóÇ‘öר:åc6­ ÅtÑ­ÑOÒWÔHÊYM´¬XµÉÈ°»Oò8rÆdIqI¹ÙJedå ¢%8ȧ2ÍûÑ2»ñnTПVa½=/XÜ ™Q~åOm–º©jWUê«À–²êdî§Iû& Ÿ‡ oÇÖ£ŸÙͪÅÏÏ×&ÝkjjPgÄß¾- ¯^›Š! aÈ+¨""ßì¦ØbeÉÒÝx𞱸û¶Qp%⣚¬DÞxg /¶6[,í?Ü”}EV'ìÔñ«ï©Iî°ŽìG?üd–¼3W9Ð7ˆb¶“2}âüáMvŸÊÃ)·áé¡z‰æmC±\XȘ¬Ý˜n,Ëîé–â§(`¯ã§´w&|3¡øð½ã„«¹S™åø.S»®´Û¿ŠÝŸ.BÅj‰3Q#ÃÙÍ dáâ@K÷~þ^—ég¬ãŽªGŽ cHš›lxJ2Ô N“R,ÍÆü›Ðͧ…t`¢E)«ÓĽ[’zTĸñŠÃäGþ‰\" (ÎIYæI”¥§€‰snÀÍ&fñ8ržíë q¢˜eþäâËÅÛG,tPºqöÐ'W”<åûøŸ? ¢%œÈ¯°H09Äš8RX2qì 4I´(pÉo‰€Ý`Ë‹ÿÌ7néßPgú!°º¼ûÈmˆ1i1þxe¬J‡§+Å>­I@˜« 8¸ã²V¢Å?ØY힃“”ƒø~Ý«[ÅÅ,†zâ¼ë#1åòp„Ƹ㓅é&oåa½œÅ$;7±â™ú“òJã¾3Èý×/¨Uõæ… o‰FL?oôîŽ{MO˜d«nʘìˆÜ§%.AåvúÄ =j'å’k¦_—¨ú×ÌñqÁÕÄj&ܶµ¾­çŸµøå¦×bí·D®Ðå±öÛ"5ɃäGšåK²ðÈáF“•À}kî@IDATÑýÜ‘zPçX𠕆¤­CI>¹Þ!Ò,Š&®²’ŸsÕlÚ´öøÛóú±i:•™,¼ãåÞ‚°Ì?Uƒïþ“¥SÂþ»¶žLdûP<]áK;þ( Ò­“ƉìEn ýôŠfR¼H¢E—s5o=OÎ “ðì&ê«Ý¦­átßd/AÖ°EÌ;Kñ3Y?FS¬ª›Çø Ò`H¤;îû>ÇòÛwe¿Šb¾ ö@nyöe™&ŒécKzWõO<ˆÉEg##ìJç)ɤä™W£F,>ÝrœçD >7—ºùšûVýæïH«6Ëšè8SžcŽ¥8,/_ŠKkÀÖOiEMH¡OFI‹Éø;š}Úî¸7VC½É4=<=8X¶e7¥¼§‡õ+oôéf ¼hÑAˆ¡m€ôÐ…°…QìfóXÝÉß ¢ÅÃÕÁ>qdÙ’jqQÁÃÃƒÈ »ÇgY»1MÄY±ÆM[®Ì>¿/âãÄÿï›äÊ˲kÌÒþ%ƒ?Æ$5­TÄša×]ÁAú“v¼òç–ë‡bÞÜA‚2ÖΙ’n)~šã²ÇñÓl¯»o³5K P¡æ’Ovš“¨£ÇÄî®2¶®O/Œ™ÿ´F>âP¤ÒdqyÆÉŽVA¶&!@34k_}SžøzõExÂHñQ†P[^Œä¿–ãðŸ´XQÊuÕ7ˆ‰×܉s®“«uÏUYÛ׃ÇÉ®÷âg^‚ý_,ÉŸ6G|ç؉šbóWww²_‰À™Š?/–Yφ”7à—ÅgÖâµrš`q%7'ì¦' TƒhiÅâGD‹"lebL)&bq®öÄP.ÿMKªÆý‹ ÿH? ™âm2x÷¥ó£…yòr$ÿê–H]u32Ž«ôËN­Ç˜ ‚……Éù7EÑbú‡­^ÒV¢Ï_Äm‹Ó×:é’²¯²]Uj)ØqÊ~j…Dkcb¬![ëÛzþY‹_&­àÍ/–“+Í¥äÖLºSP9ƒ¾Ù7j¹±DšÉO0‹âWÕ’ºgBY^œÿú%èê† ò'|ÿùȯ4}c;Æe‹Žå5m/®*I[ÚSê–––!,L5É«¤YòÍç਑£°yËKª™UÖ’…< q±mqpú_V±JÌ긵µýêƒWŠ5’³I&Zø£+÷Ü>JÄpi¡‚k֟ĉÔb­ wvuÇÍ#t«uë}kñ³×ñëÖàh(§y&Rcd¤F®j3„Ò»J8nÅÖ·ŸGhÿD±2?–ÜŠ)“È]¥“ì·û!P•—…ß½IXu„ M„KŠg ¯àpA>$^q+B Çêgï2˺¥3G8ü–1`öÕ´¢·'7þâ“ÇÉ©ÍÜßÙÍÃo¸×¤JË%åïH˜w â§ÏÁÁ¯—ÀÁÅÑÛ…%eÍr“õe¦D@" °ž`æã^äŸÞ'ÐQ-i´¢–¥¶ªõDžø»Ð½Mõ¥Ä¤°¤žˆ?¾§ FùcÐ8?£DËZÌ.¦8®à/‹m[ϱ>þþ:W=‹žŒ¸ÿHkgµr*­¤D éÀqZØõ’/Ůᡧ²l±•%øtDzÖàgt„_s#¿¿û8gý÷á'G§òÞue‚h:%€,›òÈåÜiŠ÷£cú¢SÇÖ]kŽg\?–Œ‹ÂÐá–z!*ÞS¸üßÓÉV–ôi¯²LôÙËzI—¤O+Í9n“‰€&š©B)×øXý{L(¹¯3&<óñªE¹ïQ£,šå—n¯ÁØ^bÿÚ‘žø`cû xò^SZ~5“:t»«ûïÐÁ™h|ö éÆsÇ›SÍ·¤Ì*k¡x:d‰ä„Q=]Ñ7Ø•,\\F.Pb<\½|„…LCu²wnÔkW&H$í# Äá’Í4a+E2 âËDKP„‹:6ŠR¢œ\…ù‡8Srn¥úïJYSß…YõD´€ˆ‹6ëÍòì=óâĈ¤-Ëiq\«ËÍ2–nïþ»œ&ëëˆ0qÃydÕrlwŠÉ&8Nn& ”ÂÁ±ƒâø%רl±c‰t쯞%šœ£eËÊ+àçë ¾d®„©Vë—•·o mn›Ý¥Ü³|0½¯·|´à×|εÜä´»ŒÅ\=Ü\|pç…߉O¸ÿƒÕØe˜"µõeʦÍßû÷ln㉉‰xêÉ'm²°ª¢8*,~~*6ÚPßJ^Y™á‡I®sÏí#æòŠzü—â¢,ýR5¾k¯HÄÀ~A†ši¶ö≘(øûv;ãäè v VS«}“Ž PÇcY¿)Ý ŽŽí8¦¬nõ«çåeœ´}úÑIxñé©-& vjA¢­ø)]Y{ü”úgâwC#ùÍ*7ùQðíˆññDó ?nŸ°DšI1"¼bŸå´¥Ë9Œ´§™ÜT«Zmêâ©zHÒÌãmO^¡ª’FŠ ¥+Mõª{‚‹‡aËÃíê¶cí~C­ê¡ÌÕËpÌ+GggšpWÝÛª;ÿwÛ;B5Æã«)*°v˜VÕcwY[ßÕÅù¢~@œŠT6Ô»©3(ô–â즚4kn=ÖËY‘èO–7°žåÔ–¿ ¶Ð£û¯R©º 9û¶‹ÝØ ³ÐkâybûäÆ?i‚Xû¾¯Ô‘߉€i‚"Û&÷K[ƒ¿›®qnå–ªÜmE÷SÝ#KóÛî5<‰ìG«3Ù²ƒ¥¬ -Ï”x2—¥¡Îð‚ªé×Pª{ÝJrwj)¬:Wþ(GA¥êÞÙ7´íYÔÜö ÊÜÚ²œÍdçŠ êÞ±‘fµåHW_\lêêP\\nV3¥ÐÝ=qi¢¯0Ëzá·ì8Õ= ìgu]1jêUþ ûGÏ0Øü€è™"½¡©%•™ËX“øç꿬©¦W窫®Ä²ÿûœ‚¸[7¡™B®²X¦MŠUíÔì¤7¹‹‰RMb¦¦•hf©·ÙåÒì ú‰ýwÿ»eåõøýÏØ0WléâêjøAÎÖþo¿i8–~xžrªZÍCÄ• §¥ŸÒ&Ê4ç­] ýŠSAäÍ”¤µ¶9rXœ ˜ö÷¡x53¦Æa⸞¦š±:ÏVü¸c[ŽŸÕŠwƒŠYÙ•¸õž_L~6lJë0Më+ÊQ_Y&‚÷oøþãH."É…œ›’–VW˜ÎîÆISÝú¥©")(~ ‘*ú“ílÁÂdOENºØÖüSIn«XÂ)ð¸2i®™>tŒæ®Ý·KÓNˆ6ÇŒ“*ºÆú·.iâàð-ƒ/»ItY]”GAëí.ÅN½£ï|ƒæÝlxhdéÒÌ>:XL,«ô‹ŠƒG°¾+ËCáÀ>5H*sUÇZìø£nœÅ–%íŠÆ ØÑÅ0QÜ/±Ýf”ÇÿøQlFÐ1#Wi,©kVŠoùG" °iW©î _¤ Ã:¢Àò^ÏœŠ•JdïV¢EÃj¥œH"@¼[ƒT+Á¿-OÄ«Zà—•¬?Á.º¦\!šüíÓ,ÔU&c,éS)»gM9ŠsTÎlÕbJ˜XHKR-d`Ò)v ê}$…\Š«b~ÞŽ'>„›žée¦>C=Ô‹Áò3ŒÇøÑ­¼o}¹ˆÍ2˜\ót†%šµÇ¿£¯]\ í_xK0Æ^*ðúúõTŠITk¨˜^ZÖ ÕõØ”Y ée“«7zl½v3ZËê—êÚ”¼tÕXãû€ãÓèJLWµÛ°¼4Õ½@·ŒÜ?7È(mÁ5K L~þ>aüþŸEõO·Bwþå1é1«Ÿê½4³Tÿùãx¾êž8³Ÿ§!/Šˆv@O ´ÎrÂŒ…"OŸïƒEã÷{ÂÉe±Ü툽ûo§»ËŽ§!ú×?(Š·™ìr©eH‰9ƒUñS虇Ü›+ tÅ3½qÓà 9ø±\ÿ³h¼.šÛ<$Ñb6TS°°¸ …E¥ˆïƒˆpã+î¹w$74¡/¼<ÝqìxpåöÐ1ºuf«s\…<îó«]¥8B#| ~ü \ˆ©«½ûb³ÙÝÉß‹fÇ ¸™‚Þ_A7եɷœ„ØÙ˜’0_ä8ù+™ÃÙïA#33{öì±Ë\]]QYiüÍT'+ÿ8!²öÆw&áÐ+ÆÏ=9UÌSžÊ,á#zMùx»àÑû'ˆôÍÛNA± áKäÍ÷¶¢žVDEøà®[GêÕå[û_½F5yÊAÍo¿q¹lûqì€ç«\B%§ãT¦6AšœZ¤ŽÇò[Fhuëß'7_7Œ7Êêµ)ÂuP ž{bŠ–e “TO=6IÔ-)­Å¾ƒyFÛ±6ÃVül=~ì~-<ÔKëãå©ZÁÉ1qtó3^e¼]]_Ñ£K¾é"9±úWÑußó.ÃëI↩O¾ €At¤­ÿݤš¥§TׂOxOô¿øZx…EÁ34BýqtÑ'"2¶®¡ éõp¢X~.^ª î(Œ«»þnÑç©íkÑT«ÿš¹c½È÷ ‰Äè»À‘îEŠ°•N¿ó/Sv ~»©õStuj}kur'7$ú󶳇öYê:„pô ÅÄG^·'„N4ÖÜÝO‰Ý‚cˆ(°Q®;ZzÊn®øãæˆ`rÕ5eÁ¿ÑkÂLQôàŸŒbëøÙ=X¿ æaصw#~Ö%ààòŠ889aÅgñ ‹IÅ'’”,½ïšÒBL&üXwE|ÈgÜü§Å.›/N6^Ÿ 1é¥-£î|lA£{ü4Ï’4ŽÇ¢ZÔ1ìÆ{Á¤¢¦ù7äš;5“LnçìÝ*¬wغÉÑÙ¥)(9yÌd™)Є­.e—Oüñ`×On¸ù¹ ¬º¬ù&W<çÊÝË„9™ü¸{Ùÿµ×‹°êö«¬Îæ1éæœ16(3ÒÙ=K¹5a)-PÝÏÄ6Mìø¹Â‹|·Ð,AY‘ñ‰ ' vî¨þG9côù¾¸÷?ýhÔ´štÇú .¼5œøô@af-NªÖ¯æø M¤ ¥üѴʈîã…£U“)FŠS0û ‘—ààhw/æäaýgcõ϶tsðÛýW± 3šèæ ÍõQ}\0ïþž"?+¥º]WVšø•Ó¹vòp%ÜÈ5OP”áE šåy›-g4ÏCÛ†¥kŽ¿½®kõs¯ˆgÃõ7þ”‹L²Ì24nNã{¦ðõÈ×µ©7-ì%®]%ß›,”nx:þ¡®â¾¹ýwÕqVò»Ë÷¾õeâ:å,7>Ó¬·"aäªçÚÇz‰Ý¢ìZ¤µßü‡Ò‡ü>w(ª>M)U€¦áŠanÐ\ïNó¯ÍõAÒ¹ÐÏTe5ûù *-!ÒÑ„½kÛôbƒ(Èz°øÉO#Ë›ƒYƹÍ!QŽ˜›@ït pl‡¦·TSt°gÿJ›]ñ]Cá"^š ²5Žð[0Kõ>ÍV%Çò ãÇÎ\¦ôQÍüF¿9–H·#.ꇻȚð’D7h†Qv¦WÙ[Æz Ê_õ^x$Wõ¬eIû§ƒ%ÕdY{"°wÿ1Œ;#†@€_6Ž§dÐmÛƒ2÷åëã‰!D²øúxádZ2³õ'›í©Sg·5(¼mbì†Ñþà1Yw¢ O-WY€+s¦¥o<ô!bÃÆ :hæŽyç •µùðr ‚;¹cÉ+;Ž¿öýÇîCûè£1bÄ›ÛýâË/­nƒ'ÿø% W\:s/ê/¬/N‘•†›»3b{ú ’…Ýc½òÆFƒ/Ú‘àŽŠÊz¼óá-=róªðɲ=˜ÇhÑöÖíؽ?W«Œ­ýïÞ—KdÍqÌ!‹šë®JÄ•— FAQ‘&N`òƒ…]†½ñî­~y§²ªßþt×_5SÉ¢'aP’Žæ£šÜ©õŒñÇ€~Áøú‡ƒ„C›û8ÝFRN–âó¯öá–ë‡Ñ½$cGG#'¯ž.jÒ…”¾Iý74þ¡ÒmÓ’}[ñ³õøÝ×!£#}ðÅÇó´².ºâ A¾)‰]]_Ñ£«¾ÿð)BhRžWàsÐòÁ—ÞˆªÂlaEஶÆØýÙÛdQ’aRÍ,"=JO%ÿgŒºõ!ñѬ°úùùÈ?´G3 µ%EصômŒ%’$røx\ùé*”眻ó eÙõÔnŠ¡aH²÷lEöÞ-Twú걓f‘åÆ)¸zûÀ;4 I˿ ¹×ª*Ò¦>ùØšÆô7üÑ”ŸüG+–G9YäìýêC ¿~>bÆLAÌèɨ-+‚#G.PõUåØúÞËšÍØ}›ßUŸ­6ØnÒ¯_ eõÏólòŸ?î—€‰®q÷<Ñ·?Šº ú¦‰Owß@:Tš9wjÅoÑU¦<+]Ä4™·d9YN¥Šz¾Qlå¨zñÞóÙ»jRD·®²ßTW‹ýß~„‘7݈Äшxs´’¥þ^ûê#ÈÞ­º7TUâð/ËÄyÏî¾Â CþÑh¬®¢xDqî;‡~úþ1½ÕõMmœ¦Xe«eè5w‰b)ÒšÅ\2O" F w‚^üÖ°õ؆s±ýwmk`uÅÖ  †ûôgƒu“µö×|“UŸj¥Ùºsé=‘:%Ð`3Áä×]W§§/ÙZW`7QVäû‡¸‚c;hÆ#áIdŽáD±U*Ji±„ñnû õÅÂ/ `wFß¼‘ŠRaª÷7&6žZjÿï¥açŸåû0–¸›¬Zf\[G1h(VËÍ8²3ÙXQ$sœ^O??È¢÷ÅúÚ³gQ¢Ñ›Èh?¶žØö{>Æ]*&ü'Ï‹[B9 âM5ÁÄ.›¾}ë”á^LÀ»om1â}Ô1†hKåã¦{½´åª¶>}.™Î•%‡nž5Çß^×ëbþ1ýÛÈédÆcrpK þïå¶gð‚ÌF¬ø(—ÜE ›FúáÙe~(É#2‚Ž‰?]—¼@—å÷¥™È=iù$¡1=ì™^L kû$sïTaá—¾(É­#ââgIÄÒPß‚oÞ¦ÉôÇfãþɧ‘[ÑwòÚꊊáøbg©Áø{(¦/¿n”?æÑ„ý|ZTºö&+ ¾«éü]¸²Hm=c ^/ª£)^F¼°h–±gÿšívöv2Y,û)ÿëÝ‘›»^¸ucK Æb­+F³C•™ýÝDù&"ÿ°Œýy ySòA-Fyê¼`<2¤Ô4‰~ˆüuj½‡îJ¯ißb2’h± ¯)Í>ú·l;€ÄÁñˆí‰˜è0²r)CUU5­ ¥?_úPÜr›r()éö_‘Þ!“š@SK#>ÿëLN¸#û\ W¸9ljú5“eêÏXwð»Z³(ÊmÛ¾»vïÁ¨‘Ö“-ÇŽÃòå+”&­úþð“Ýtn—áú«ÉÁ„ˆvšÈdoÇî,|H1W˜4Ñ•™Sc1eb/‘ÌÁäÙjCW~Z~ S'Æ‚-fh"n¿÷TUk›€ZÛ¿Ò×Û‹·ãdz)®¹"!Ažˆ Wdly¶{oÅŒÙIÖ,ªÕvJå{éûézo º‰‚0š<¡—Èb²… ”ï~JÂuWž€PÚXöÍAdçTà¦ë†":ÒWXð(y‡É hɧ»päx‘’d÷okñ³×ñ³û€Î¡›°æ…û0à²1àÂ+àî ¶HQ¤˜Väïûê¿f1g뀿ž›a7Þ‡èÑ“àæM¤9Ïx´#‹&öæà÷ã{¹ÈM«Åô«"D¬&µXØZâÄÞr,ÿ_¶Unûn®Ä¥÷žOš:uÔ¶5Ç¿£®ŸŽ£n»›~.%b¢ç߉ˆX†·YåÑäàŸËrph‹þ»³n;]¹¿ñ§R?ê‚›"㎠²`¡G{ðýgù’ìnKu%n²oÛ(­9›þ/·óÂEän2~;zµºúâ þ£Dú}¾£ RŒÿþ½»¡ i´áVrÓÇö‰­ç/OüoI­Æ;äF1§ÜK 1„Ýä• ‡>´h‚ûþj·éÅ%JU{õ¯´×ß|­?ñs‘þÝjËz’% “,ëN'Š/¤²fÙz²|<-ZŸ;¾Ì§ ÷Þ8¯Ÿ7܈ìÒ$Ø8ÆÏÊÃåXbå=´G¿þ½jtñ…“„®+Vm²DgYÖü}Ð+&ÁðÞ¥ÕÅJeU òòŠv*õ Æ/tº•U»ì6Ìß+nþàÀ÷¥U™ÄâšX†fÝ{öŒÁwß~K.¯ÚÐÌm¶‘‚üÞtó-8r䈹UÚ-æ…@wÔÖ5!7¿5Ä.w¦ØÚd8ýX“… »,ËÊ­ ëó®[~Ž‰ò·+ªk…›1&š,•`Oº‡xˆ—¤ê¿œVgt¦ØŠ_gê*ûÒGÀ3,~AÂUXuaŽq‚C¿ª]RáGqIª sÏ©@èì6Ì3„Ý«yÑKr j*QO„ümDFýãqô'‚/ÿÈ>¬~önQÊ#(žÁáh¬©F9ÅbK‘ŽŽïãÙ .d ÕÄýR<Å­˜%}Ÿ÷ÊÿJb;6`ÿŸ°¤ª,+H$.C (‰Ü79¡©±…ÙMv¹Óeƒ:G:f—‹!´°„IWrÈîÛÎ4ñ v„_¹:¤gÆ¢Z0TÑñÏ~gFRߎA€Ø]X€g4ü ²n°Ð"2‚\Ÿyõ@MYƹBëe-v]Õ'Äå5@Žç¾­ý[¤l"üà ÇjÂ0½¸Ådl”žtÏûö¶H¡Éã?çaSªyóm†Tg—m‘Ô¯'ÒG†JšzÈ£cÀÛÖŠ$Z¬E®êqàûÓttϦX,›ìÂJfÍš‰×ÿýo25Ö6]4ÕÇ—yéå—ñÓO†]Ò˜ª+ó$‰€D@" &ZŽîÇêgî:£ñÆ¥ü Æ°öÕGÉEÙæ3zÈÌÌĻｇµk×lO&J$‰€Dà\B nÚl1\vw–»oÛ¹4t9V‰€D@" H$‰€D@"Ðá$›Ëì²F¬:RÑíH¼$Z:üHζlÙ‚‹çÎ.ÄêtÜõdeeaÏž=øàƒÅg΀¤¦‰€D@" è (HBïi‰žR×­®÷:£[Ù‡D@" H$‰€D@" 8W¸û›Ž‹=l %Ñbe³ ]’å,žŽD@" tJÓOP<“õ(Í8ÙM4²N ï°(§ŸÔ¿µ®YK" H$‰€D@" HÎXdŒ–3öÐIÅ%‰€D@" H$‰€D@" H$‰€D@" èjÌzÝÕšÊþ%‰€D@" H$‰€D@" H$‰€D@" t3$ÑÒ͈TG" H$‰€D@" H$‰€D@" H$3I´œ9ÇJj*H$‰€D@" H$‰€D@" H$‰@7C@-Ýì€Hu$‰€D@" H$‰€D@" H$‰€D@" 8sDË™s¬¤¦‰€D@" H$‰€D@" H$‰€D@" t3$ÑÒ͈TG" H$‰€D@" H$‰€D@" H$3I´œ9ÇJj*H$‰€D@" H$‰€D@" H$‰@7CÀ©›é#Õ‘œ888 ¥¥åœ«¤D@" H$‰€D@"`9÷Nö‚»sìH¯Ã¦ÔFË5$‰€D@" H: I´tÔ²#‰€Üqzôèûx@B"H$‰€D@" HôHŒtÄ£ýEúêc9zù2A" H$‰€D {! ‰–îu<ì¦M„¯üzŽ›Œ°éͧõzpõñÅÿ.Òÿ~é~äÞ«W†‡ðëîF`\ÿ¶|"[òľe ÉÈÛA¿óçée5Õ× "/Y»6âØÊo½gÎÅØ;èÕ×M8µm 6/zN7Ùnû‘£'aصwÁ¿gu›§ÉÅbÎÁØóÙ;(Ï8©NïvôûÓÎ5tÉuðhûýin¨GúÖ¿±—Ž_]iI‡¨­ÿ‚cð×sóõúð‰ˆÁÅo-ÒW>vᘪWÆ–„1w-@üŒ¹È=´ k_~È–¦,®ëH:¯ü2D]ïý‡"+¹A½Ï—ߎѨŽÉÞ5…øn‘öªðKï ÃØÙ¡Zux§±®E¹uHÚV†Í¿– ®Ú°»O[ë_· ‰“õú7”ðúí‡Q’¯=Ù:ïpŒ:¯íœSêÑ­µ•„G5¶ÿ^„#;ô K{à§èŸ´­Ë^ÉTºW{ÒŸ…_&ˆýž>Ôƒµê<Þ°µ¾¡ñ77µ ²¤§ŽVaÛoEH?R§Õ§æNüPwÜñϾšI·ËòëðÚíÇ æu—ĸ ¼rq¢ý]„JiE ¸ñÿ ÌR﮸m¼Ÿº.Wb²aËÉ*¼·¾™Dºt¤tuÿ“z;ãΉþèìª&=>cWz5ÞÝP†“E†Ç¿`–7.NðÅ®S5xøGûÞã]éþ6£¯·ÐgeRÇ>¿«-7$‰€D@" HlB m6Þ¦fdå®F€8¼<Ç3ú©Èèí °² ¾nŽðrsÀEƒ|0º§îø2y•gÙÂãŸ7á îy8lÁRQ“w?úxchÜ%è>ÿy=Ê«s;ýpÝrë-Â’…;>pàÖoØ`wî¼e8®ž§šÌ¨# –S™epwwFL”/ÆÁÄ0<úÔŸH>ißAe ¶ôïèä'ú´'Ì&ž¥b ~ö‚ä¢óâqß]cáêâ¨nÒѱýãÂ…í¡¿-ý«îŠ ²Rspr‚ƒcnºjp¾š7$}οciÂZ[²å‰öxÒ>tÀœÿÏ%XÿÆdíبW½‡ƒ£è_7ÃÅÉA½ù3@L„¯^xª ôï=Zõ×­¯»Ïýt”ô›}Fßþ¨ºùÚ²"“3\½|9t,B_‚ÕÏß‹âä$u™n³AÇtÒ#ÿD¯ 3…JÍ ¨))€«·/\<¼Ñ{êlD UOÝAøçÙ]måø÷0vþ‘~ÊùÇ ì-Ü/·o´{w¨Óž“SÔV5ÁÝË C&ù± 1±LÃ<Þ µÍð (= ÜÎz8ö ß}\œ¨½è>^â3æü`|øÄ =’ƒU±µ>ÿ®ê_g˜ª]ÇÏT}ç ÃìZ]€o™dÒy´?¥Âј(ã3 >=©Æok};œáሠ7 Ÿ„õßçà·O5Π¬“¢ŸF²Þ¦)ýô wAÂÜW<:=®ËCºµ›%DqOU×Ђ“Å ðpé^®˜ï…ѸçÛ\œ(0L6˜Õ‰‰B]ÝÿU´Hí:O)¢û‰3ϾîŽ뉡‘î¸÷û<$åj“œ\ÞN '>‡ ÜJƒV~Oïã OWŠéH×ìïIÚ¥•MÊj‰€D@" H$Œ€$Z:àÎjþbzÁRH–¥´ªð3Z¹XOÞ¢øukJgø'jŠT“‚>‘½0éÑ—Ы/ÆÏ?Ø…¦:Ã.y‡÷`ëû/«ÇìâåƒèÑ“‘pùÍð Ç„_ÄêgîTç+§6ÿ…üC{”]­ï˜ñÓ1üúù"-kï­<{íx†F`ä-*K¶^Ù¾ø5!?“ý'¼C#Iÿç±âkÀV.ÝIzϸXM²øþS$ýôšëÉß M¼E™‚ <wÿ`Œ½ûi¬yéî¤úY£K­&¤ áĉZê=û»Á‡È†c»ËП¬}MIÊÁ |÷ŸSê"îÞŽ4ÎÓ¯Ž€¨+®}¢'>xô¤:_wÃÚú¿.ÉÆŸËŒpãçbÒ¥a¨«iFM¥ñs?ýH%¾úwºZ­ô»êꌩW„Š±³ÕKAf=Ö}_¬.£lØ?¥­®ú>y¸Ë^MÝ3qî‚É—‡’iÚUdT«ÊõÔ;u¤ÿ¾£À2ÉÜ%Êi¦7“uxwZOƒ'ÏóÅù|„z[R«‘O–L—5}¾+cÕä—ƒåxg]…Ú]X|°þ}I"ýœñÒì \÷Y˜ôWêÚ㻫ûðqÀƒSU$Ë®ô¼òg‰zAÚÀpG¼<;XŒÿ¹ ƒpíÒ|»ß†s¼Dönº¿œ…‹äL]æI$‰€D@" 8S0s­Ó™:¼sGï+‡ùŠÁ®>Z%[T$ 'ðkáúäF¼µ®Häéå‰oÕ¤¶H8KþŒîwÉ¡ôß±îÀû‚dáÿÑÌ¿ñÇž‰üÞáàã*¶íýÇÍÍ çÍš…;n¿ 7\=FWWWpúáÃIXüá‡xúég0cút<¹`<ñæ^|1<<^˜.°á2Ó® §k·´Åøi·Øù{M“±äOiA3RÔâÓçOáàf±4óÚæ>õ„¼ûia_YÖ”Dó¸”äun¬;=E$<6SE²°›¯w×ᱟKP^kœÓmæ²!ªÉü¤œ:ü{uÉÂåR [ðô éÏÖ-C£ì¿>¯«û?o Øp·²® –«Iÿ²`yqU!o¢'¶ƒÉJª³$ŒÞՆǨÞV–nÃ: wÙD@" H$[°ÿ³­Ù¡¾—§;‚ƒüááîJ+ä[hÂV–¢±©{¾$Ù:döáÛ'ÄU4³ú˜á‰èu'êñ¬Ê«ú;Ñʨ¶I[ûïêúÎŽ®óS ‡ÓWTçHÆj\2VµÒ;ܹË7XÎÚÄI“&áå—^„¿¿¿V 8t芊‹1gÎÌ¿ç­|Þyè¡ñ̳ ±mÛ6½Ú×CGâgÒö«µöÛ|²t „?='‡ötF^ºeÇÏ~štLK®äâ*¿¢Ï®,Ä¡Ëçú‡º Åþ:^¥ëUN¤ÏoAzq½p#Ö,¤öfÚ÷]ª«ûR³û³jP£}Yˆñsú*"aØ s|°³Ñ€ô-­èyöÀ´¾t®ÑµVAõvžªÃ1ÂÐR™3Ø]Xåsßt®WCm1‡˜éˆþ¡.ðq¥=ú_UÇóp€Æ`‡ÇkCÝÊ4‰€D@" H$Î*¢ÅÇÛƒÄ!(Pß\¾™–z¥gäàDršš-ÑÁ­Ûí>·R5q~8Çð »ã)l~'×Õgü°åq1¦Ì¢}ÇÖDnÄNÓ¿ôÏÁÁ¾§ýØ1cðö¢·ÈÇ·~».4 7bă:)‰xÿ½wqûw`ÿþJ²EßÞ^ªÅÒRýIJ¥!Îãx-^žm«}9¯ªº·Þ8œ\Œ 3»w>° :“ÒL²¼õ¯ ÅjÐ>ߣG´ØÒ?ëàÐêHÜ¢…ÝO=4,fLí­·jµ‰ã~ûÓ!,ýb¿A"Šuðp§ú÷ŽÃôÉqzõ™\úú‡ƒø¿¯­ÏmX+¶àgãÇDÒÛnGe¥Y3e‹þܼ­ýs|üÙ2fÖôx½ãWYÕ@–^Û°as:ívÒB1=XÜüŒê¶æ…Ö™^£%Œgˆö™¥åÜÍdõÒžx…Eaæóï±á‰“ÿèÛ«cK¾‹»jÕnCµñU»«Ÿ½G>U…Ú$¯Ò¯“›;Fÿãqôžz‘§’Îßl)³í¿¯!c ¤?Ňé3ó°Û²”5+0HG׶’7Ü‹Ôu¿ —f-ž6.Z(Ê?ØVGcK¸kÅ_‰•¢‘Ý囃.»±f!cÇzaQ¥«³‡'¦?ý–H^ýü|£næN·4!rärõö*œ\U“·¢ã·žðûàÂO·?kö])Ý©#5h¤øì>ì÷¥…bR=ˆb+ìø£ÞþÆ-QÚë-%ZŸ°i¯¼n¾µõcú»bä,•Ô/ÿÍD³áÇ;Ýî î—䵑 ^¾ü¬¢}¯ïHü *Ô‰‰l•¢ˆ_ÐÙG´lK«Åë—Ó¤¾u U¼éÚa)&ë)cR\ÝLD hßþŽººÕ˜*É"̘Ìÿ..DhåU/ÃEâœñêÅ¡ZqræS£¿'UàÕ?ËA¢f ¿«]4Xe÷×ñ á ÚTÅ_vñ¤^t§[–‰²gW %Ý<¹/H$‰€D@"`_ôg†íÛ~§µÖ3: ƒÅ‹—øä” dçÒr-™ƒ;•7zÅDÐDrÂCƒhR/ •U†-?:Ma;vÄ$ÊêcÚ/ͺÍ÷ q$ §g”™Ò­w&ì76×Ø%‹¢(Y¼0ÉÂR\‘.¾íñ‡Ý‚½øâ‹IKÚß¾}ŽÕ_IlnJ€cS+Ö”¸0¸SS˜„xí­ÍX¼h¢#}pãÕ‰ødYaÅÖÜ?AL^9JÁtLÒ¬.¶méŸpTb´ð›*I€¿;F ‡Ÿ¯;]«õd“gÔÒ†ËóþõüL$ å]JÊÇQr£Æº)ÆuýUCPG_}wH”ÑüÃõ_zf†‘% Ë‘c…ô)€;‘/CÃ®*,o˜¬±·Ø‚Ÿ=ŽßŸkRm’-úsǶ÷<ûÄŒ%,®þ^—‚dÅÅäË„±1DÀ‡à¹S°°± [wdÙ4ÖŽ¨\HV,qýNÖ¹{­·n3¤_(b狤¥©¥¦µ› f½ð.Ü|½w+¶½÷’pe¨]û¥µÞ“LÌ–¦0Þm"£9ˆþä†U(N;N“ý5!ý‡` Mþ¯m| Ù;7mǙʽûI&'!?i¯ v8Æ »,ë=m6ªŠò…k0ÍØRæÔ¦ÕšIzÛ~dÅ"nR”S‘“¡—¶$ôpr¦x4Ï£˜¬b8^»ÃSã7u6jKŠ°ï‹Å6\V~bo $Ë ±ª‰Êƒ›ÊÐ;ÑrK0EѾÃ<Äák¢yé–[ÆXUŸ.‰ËæG‹~Sܽã{l{fõòk{ܯ«1<ÛÛQø)8vÕ·flG@ñ]¥½ûý-ÉòsRS‡Ö»o«=†fNÛ¶b)ÍÏJö¥I·õ—®êÿDák†±Ptr¦çØç/ Æ‘¼:ìɬ«“&Ç{ —c‘ÛÁ¢ª&,ÞTm|âá«"‡W6}í3~¯_DÖ6äÅ@ÜuªÙäþŽñ %—Šczyk¤·ç…âÊOrÕñwÌRD’H$‰€D@" °¶7/‹«vŸ Q!H܇\ûTbÏþ£¨­m{é`ë•Â¢2ñ  ¤IÓ¾;:›¶ì£IWÓäD÷¡íš\1Ì[4’\X“EÆ_lï©{¶0ºßõB±ü²((O±›’]t!ÂÂT“ûÖ6šžžŽÇœÜÙ÷|ôörF-ùœç‰øöädz)>ûrþqó\=/ë6¥ƒÓXnº6Qì†éµE›é…×Ôëp[O–ôïHd,£eÖ´8<öÀ"¯ÚVN¶PŸ¿®<†Åïî¼ÚzQmM­&Y^}s#ÖlHSá¶_xr*ÆÓ„ûuW&âûŸ“Äd¼ºmL£&YÞ^¼ +VPg;‘óîÇ™ÓzãÂæÒ£#݈)[‚_G?Ek¿-ÑßÚ>”z£ÉU“,lõÄBŠ“‘T dá;:Þ|>]03÷Ý5Ûvf›}«éàìQžsJLèO[ð:Ž’«.¶¬à˜)6 ͱ˧ ÷/Íýí[Ô—«®kcíö=¼B"Ev¹”šüÄkHþ{9²w'(ŒµÕYé·†I–Óä*ô¯ïG!¹ Säè¯_bÜ½Ï ~úÅsÇcøi×f£Ä÷ÐOŸãз+Õq€b®L{ömD$ŽÂÀ‹¯Æáï>¶Ø*C‰áRz*å'ÕmŸmÁ}áèÊïpà«ÿª‡ÆÛSž|Q#&`Àœkpø§ÏÐXczâP]Ù w/ÜT*ˆ–£}Ðo¤/jir3å@ Oðµ°5Õj¿¸ê‘XQw˯y¨*kÿ÷Téˆ'`­­?š‚›G÷õ:Ë—ä(MZý=r–Ê­i#Yçäž4lÕfoü¬VVVìr¼É ¯Žq5¶®ËRÈ„ÎR¬«û·dœÊ#ñ p7|KD/ÇÉTdÉæ*²4 À„Þž¸z¸?>ßQj3õç VÃl‰’DqbLIßPvi¦²À|zyžˆË©Y~DL> ØLA^NíŒ-'Û,¼4ËÉm‰€D@" H$û `Ñrñ…“ìÓ[´òçšíH K¶PÙ¾óI·`¹ùÅhÜ{„&ä0x`oìÞg½A ¥Ãšã^MŲt[Y‡õÓ]Ž ƒ!qs…z·MÙCß©S¦ÚÜÌû|@ä`­Ííh60÷¢~äFi,µ¸û¡fÅ'aK• ££1Vÿ?öÀxÜ÷ØïèÝËW]– š^²tYŠwícKÿJŒW'1^PTƒ‡óáLdËð¡ð÷sÃe@yE–}£ïž§’·L.ͪè V“da8Àû—ßD [8ÄöôÉ”Mu1~LŒØ?~¢H‹dáÄ&²²YüñNᒌɟáCÂõúÐjÌ;]}ül‚5úÛÒçä ½DõÝ{³µHNäI¥_ìDKh°ú÷ $k'ËãЈ:è»SZÿÚœ÷òp÷ ÄàËo¶>ÉؾN¸]ªÎk²5œÈ€y¯Z²•‘³‡·páT_UŽ½4áôãgí@cFÍÝ/Ñ£&‹Oêúß±µS¬[ÚWQ·D¯ñ3DRÎþmZ$‹H¤€É&Z<ƒÂ?Åd±bHšêk‘ôÃR­¬ŠívÈ&ZœÝ<áÝ¥émD¬Va;a #!Ü™QÞÁï?5PÂ~IA½à²ÿþ¤×`G³õôêYšpšÎãC„•¦ð¹½÷ÿÞD »c ì3yvi±Û¶“³’¶WÓâ‚Óè?Ú=xc?g—[έîLu?Ì ¿hµ|!’Ä&&]ÈURMEV}ž…5ߘ¾oØZ_Ñ Ù·E‰Ýõ?ä– ìn´ª~^ Æ]¤Z²û¯r¦ô¤ým+~ڭɽ3yCÝðØÌ`”Iyó²<U›·¸Æ^ãíêþ­=jâSºÿh ¯szŸ,ê˜hq%kªAáN³…nH&Ä Y¦÷ñ%V63Q³z°§£Ø壆ïþç!bIDAT´9UŸDÙ“Ñ„éïªm°)‰€D@" H$‹@ç¼}wàzF…ÒÊwGr”b’dQT(*.GfVb¢Ã)&ƒjj ¯ìSÊŸéßì·÷ŸsB„Ó¬5Ç+±ö„K©ÎôAkèïï‰+'ýG¸ KÊX¤S«5rmßìß¿¿M´Ð ìM›h…µe<&<_Ê.¸ô Âæmª—,SÝ°¥ [¬üïݹè×'s.è‹ó§÷[„ìÝŸƒå¿7U]+ÏÒþÕD‹«#ÅÑHÃïnU[®¸9òÊÂé…ו—  l]£)€?Æ$/¿íeÕÓC;F ×áê,Ç’ O¤•W4àÕ77Wd©iÚ$¨hç?–âÇÝÛóøÙ:kô·¥Ï°ÕähŠ‘cST\ƒ "ã|h™,ëîF´ðØ+(hûÊGnÀÐkïFÜä DŒÿ˜ÞàOâ·áð/Ë°ÿËZcpìªÉƒ‚À늣“ \½¼áHq¤šõ'b4Ëýõ ¤üý Ý?¨­`ô™u©p›ÅdAYæIùy™fñÛtÅ­ˆ%—[:’¶q²vlÔJõ ‰û%iÉZéÊNMq!˜lrõ¢U¡F‰–²Ì4ƒÖ*•¹mî¾\¼T÷ ¥mSßža˜üØ+Â4"}Ûdl]kª¸ÍyLd(ÖH67fE¥d­ÃÄ”®”ÓyÃéŸÆÝ?X7ÛnûŽN=PWÝ‚dZU>`´Ê‚ƒÝ†±8 Óž8ÓD¨ok`lͲŽ.=àáíHÏšD¼›¸|l­¯ôyÞ!ð$·A¥õX÷m¡’Üîw\‚žûj ºÿv»S@nå÷5+µ+?ÊSçënØŠŸn{rÿÌD`bor•GªÑÈÄÀ†'} ±«ûç!Ý2Ö}CôŸÿ8RFðH-ªW[iÂ’F^šÈÚÖ‰\‹ RDÿ©Y~F?W¸1ÌÄÍGÚ_„U\£zæc6­ þ:®ÿžW£Ÿ¤Ù¥Ü–H$‰€D@" °#&‰–«6Ù±«Žij¹c²¤¸¤Üì2²òÑä‡S™Æ_:Ín°›ôwï·çÃÏÃid~þÊŸç–5‹‡«?n˜¾®~(,?‰åÛŸµû‘òó³Ü‰¦5äB¥®Îþdß굩’†¼‚*" ò5»4¹Í+K–îƃ÷ŒÅÝ·‚+Õd%òÆ;[„e€ÉÊ™–öŸFnʾ"«v*ýÕ÷‡Ô$ 7YGþ+>üd–¼3L’ èD1[ ‰I™>qþð¦ uer‰Ûðô0™c¹°44h8"±õÏÚéš»ºm)~Š2ö:~J{Ö~[«¿µý¹óP’¨LŸÜKlëþQâȸºšüÙÓ­Ö©ûu¥%pýUìþt"(VK̘©ˆ5QXR$•‹ƒ£#ö~þžQ8.ÆÖÅÿTç»F(Yb ¹úv š{=ü¢ã°öŸ›$kkªÉµ“jUnuA. $ò¡I‹|é 8òË&ë«;·q#tàPD«× Çÿ´‰'7wQÎ;"='ÎÒ«Ã ÊñWÊ*Äñ] [j¨EÃâGf`ÃÕ×3¾ Wo?”gĶ÷_6PʾI¥)ØýÉ"½F=‚Ã0á¾…zéöN0†÷ÓÒÔ ˆ&[:Jˆ²uE¡°jaW‚'öªÎe ××®¤¬À÷‹2Ôå\ÜÐg¨'λ>S.GhŒ;>Y˜nô·ÐÖúÜqX/gŒŸ£²>Yñ¿L£Ö'j%56œˆhò П®¢x ;þ(Àß_¢Ñˆ5 7c+~ªÈÍ3UIUäbʹå Ø—ešèˆavuÿ<¦¡‘nÛjݦ1È£yüa˜xj$K:cÂyNDØÒOx»rñ`•«çiÕfYÏoïx±®xùâP\’XƒýÙµH+"·‰ôÉ(i1§]…d‰€D@" H$‹è¸7^‹Ô°¾°§˶Ìß·RÞÓÃÍúŽ»yM^´¿èŠ ÄÐK7`|è‡BœK+š\=ÉèÝ •µøbí¨o´ì<éŒCìááAd†‹Ý㳬ݘ&⬘OEs¬l¹2ûü¾ˆ Éÿ÷ÍY†¥ýK.&k’bM5´¶SÓJE¬vݤÿòË+wo¹~(æÍ$È!­ÊgàŽ¥øiÑÇO³=k¶mÑßšþ”:ìBLq#¦¤‰ßMuµÂú- \<½0fþÓè5nν©ë~3磩¾š.ÆxŠ¹4=³ä¢×>Aä°q‚ˆh/x».f'þøI-LøFÅ‚-:Z’ÿú¹w©»Iœw3aá£Þ7´Áñ§«ÅÉÝ3¾Ÿðž¨--Äß/?„&;»‡44Ɔê*äÚ­—åÙS/ílN8º«Gwµ&掵‘bšçjO,çžl@ZR5î_4ýGúaÈvGfØ…¦­õYÏKçG +Òäå8Hñ,‘ŒUø齶q“Á,j+›É2Fƒ(4£Akñ3£iYä @`õ±ü}¶Yñ™«xæ¶uZEû_8¯]¢%{ïdíݦUOw§ðØ!Ý$»î;:;cê“o"0®¿pWö×  ¦° ?»v&ë2ÉÏñ=äŽl”?ó3J´SÆÜúC&{!>ÑGÄûeq–±æŒ¦×U7#+Ù°U–ÑJ2C"`ž¼×~ëLéêþ×é¸Y¾bhs§-³©H~wÛœjþµœUÖBñt ÈÉ £zº¢o°+b]F.<ÈZ†sÏ·E]F uæù#û’H$‰€D@"ЕœñDKCC#ÜÜ\-ÂÐÍMåZ¡žêžmB.€ñÂìÿoï<À£ª¶=þ'!}2é„ÄÐCB‚Òô‚]lÀ½áZ\ô‚ø¾‹íù|W}OÅû\T¼ Š¨€*R”DJé$¤—Iܵ÷É!S“™9)”µ¿ïÌ™³Ï^»üΙ™3{íµ–¿\ÍÔÐx דù¸¢XºØÆjm<Â=ÌíW¾ˆ¸ðÑhl®Çêmsq²2ÃZÑÉK?ž®IÑ":1gÎعk¹Ërþ:©“ÚâúÛJªë¡Œ°•„BbñÂqp!ŽßmËÀÈaQdÙ„™3’°âÃ}¶Äd|qRkû6hã„¿Ÿn¹q€,ñÆ;¿b)…Ì“ŸÞ½mEK ;½™W¯ù¸»¯ŸÖtTÿîGËõ;|¬_l°¼þN×ÛQ‚o,W¥à÷_?ñFrÿçT¯*ò²¥¢Å;(ÔDÞÕݬTâe^e^N[û]<Ûúݤ~˜T¢ù@ý:YQËwZIzŽ}ó/'+é1ºÎW,x‰#!¬’¶þ×Â.±þ逞sí(É3¢ð RܶSÜât{ò^7ß#åv¬§Å1Ùßó©”.ʱgÔtºÉöóZæRÛ«DZ)YPÂÚx|´²3çBhßΡh*&žŸoLP܆m:\m5ÞK[ åT ¾ ¸L ÑõÀÜqzªW/-e’É5áÎLþni‹#ŸcL€ 0&À˜€V–KõÖØÅò•Uð÷ÓÁÝÍ~Qh°²Z¿¢Òºû‡.B‡6·h2Å(èç+/.þ² sÑ¡é†Ênº|)ÅLÆé3ÍXóã|ä•vîêå}{÷jeRR–<ñ„& «Š£"’¿¿²ÎZ§Ôs¶cÂÌ»w$"Ã}QYeÀrŠ‹²rµ2¾ÿ˜š„Aýƒ­U+ó´¶FÁÌczéàoÝ_OW—s.ÁêêMÿ$ö‰ <å‡íYVûèÚŽcìÚ¿z:m¥í“Ã3ONÄè‘QVÛÐ’©•ŸÚ¶³×O•wvßQýw¶ýJ t/’e|gëtD®¹^q­çådUÌÓ¯5¿ÉÌ…”ˆåq×ç»äNñTl¥3-qBΚ/õµ%`–ï ôA(Œ“¹ãºñå÷å§(,Ï‹÷"ˆ¼šªì‡¦Ê´·oláçî£L2Y+¯žkª³t§d¨VúäæeéVÐZ]•7zÎbr]vµ ü¾íÅE(=v°³šêÐzÕûWel^¹±Ë¶&Š+f+Ù’±…\=”ïváÞîBL:å³±¡UéèÈ8Ú“¿úOO/Ä"žÊæU'©ºÛËhõ½HúëJ(ßÀÖÀrÏfž´Ê›×g~ÕÚ¯òÓçó²—âqA¹&2P»uA-çNµ^·^ª5—ÙìNѾÝSÁ:Z”&’¯‡íNûR¼B‘j[Êʳ ×bÂÛÃM©ÛІ¢odLO„ê•{u¹+ìˆTRsÏo¬ÄÉjÅ%b¿°ÖÏBGÔÏu0&À˜`L€ X°ýTiYö¼ÌÉ/(‘ÔñqöM~ºÒÓÿeq½Ð`hDYYÇOu'¤¹c}pk’Ÿ4 úë“ø%ÛÔ×xwö­+Ú¾zÈ£ÑwYWœÁÚ‹‘Q´³Ó›Ý´ù»icúôiøðƒ÷)ˆ»í‰Æ¶:N®²Dºj\}¶,O®Àbz)“¥™§, PŽP Üx]ynÙòݨ¨4à›MÇ°o¡TdK–?›æhmÿޙñòÍÛðÔÍ«–Ç#††K+q•]aRÆxÞÙ£%¨½I:H whm¥Ì–:G‹„[Ëbãò})^Í&^†±czgwØ{­üDG´\?­éˆþkéCfv¹–nµaõ´dáX¹ÅÆ´* ¬v"³"/KJôî¡81OCGË,ñÝT]mrÚ@Š Cu}n]ÐûŠ?˜œS\ÝÝ)¾J²<¬p">ŠOh¸t&*(Ë8¢V+÷ §ÐP¥ð‹5Þäœz=æ*ùV(ijŠóÔìÛWäœu…  ßÄ<õM€»·òÝX‘a~å9J^DÒH‹s"C\“+æ?-7¿èˬ–Ñš9dÆ\ô»æ6ùû³ýµ§P´ïW­Uv™¼Ê/¸Ï ȼሖ{O(ûª ²ÌOŸ;¤ûß3@‰íu.“Þ„‘QÜß"ÕåËý…ô抄deN^ºã íÉEôÄ„©‘É×+òÐPëœ2§»˜·Ä²ó†Ÿåߊ~Ãt²kgèǺÄJpu­òíûªéŠ{×ò“œÌaE‹9¯£ÅÊB…Iý}`åñ}Bè·‰­‹tÌEÕ“×êñÓ‚h|3/ɱí/‚ëèöÍÇ×ÞqF©²Pih/oˆø–æ)!ª%£ÔöýÓ‡Üuy[ ÕÚ;¿ÒRѨ¶wÓ`e¡ÀñD€{{Ó ƒ<°h’/fŽö¶*"ž‘Éõ®HÆÏËV s&`L€ 0&À˜€f–ÿˆ4WÙµ””U ¤´}âca{Å½è• =éMìŽͤNÕ`½kûÜ­MIô>xEÝí)GtÔ»XݬüèŒ>ueÃûÜñƒMî<ü>òËÂ_euóñ´œr¶¯¹¹¹HMMuVÜDÎÃÃÕÕÕ&yölØxL4 Î c…ƒ˜X^J ¡€ÉέÀ4ËÕ²z_w<öÈ•²ŽŸweCµ ‘—_ß ­xì©ÇœÙÖ'2µ¶¿yËqÙvbBî½{¹lýsÞ¯O æ?8FžO?^Fc0U¦g”ž‹Çrÿ¬&cBúážä¼­—Í[Ó)䥋&˜XÖ%Õ’ÇÇIÑSåõØ»¿ÈV5Nçkå§õú EDD˜ÎdÓµX‡ˆ˜8æçÌ•yZû¯µýMߧ“ë½³ˆ'ë¦ûî&ƒI«ÃÛ»'æÏKƤ«â1ft4N–:>QªÖekŸ³k Ä$tOO/Œyð?á®kU˜†& Ãé–¢{w£©Î¬}ºñŽmþRžõbÂÞXÙ ”$"æ‡w`¨l#ó‡olu.nîð 9·é#c?i ®}þmê›7N75âø÷_˜ÊËö•¼ASîDŸÉ· ‡¿Œ.tìøk1dÚ½R&ƒÚ>mP&åL+Ñv”µ}“›°œÿø &“õ~1¤à\ð”l ª0¥GX4–±eÎ’ëÅÀØ~z׃jróöƨ!~ÂõŠ¤º²Žÿü ÆISgË&}¹eÇ',Òêæá§LØ«ý;ö9;·Ë8ƒ¼Çþå9“û7œÜ  »s®ìföî­h6³È2îSCÆ-|ÞDÙ(®_òÜŲ˜ˆõS~ÂTÑg,ßÝï{º»À/ØõÜÒË £®õÃCÿÛ^®h¢Õè¿l´¾PAôÝYùëgG‚¿Jrëqâ@-Ã{ÚÜ<¼,'r»›ÛŸ«d\OWLÿK/xû¶þµ¸,Ñ“gDÉ.û­ÒªI«¼:~á"L(zÄæ肸Oܳ4CÇ+Ö|[>)”¿ójyuïF:cæ>úÖçã|ÿÖïUö|Ø‹gzóç}]‹u†ýï1?g~­Û_#‡‘å…ÇiÂÞ£uøˆ v¡ ë!R“YfÀþ<ÛŠQÉ^®˜’èaÑ"bƒ,¸ªýçíŽlß™ë±ùpYÁ“E Y¤<s ‰²ä2ÿS×+ÿ-sËq ßöø…e̳7"Àè3*äOVä…UÉ‘bëò˜zB_å¹á냎ýöuÅíCý1glnIò„qC7ºeg%{£W€¢AJ+T”JÎpb&À˜`L€ 0û=NÛ'p>–úmß\‘<#†D >ŽÏ¡?ĦÖ~z !%‹Ÿ^‡™yÈÍ·œl>ÇfoŸ"”Õf¢ü]£äfKvÛ±,Y¯¬`¶UæBËï”x®ËWš ±ÙJi9ßãÓí lv8ÿwÞň#–3Xµzµy–ÝÇbòÿ³/aê­ ˜rÃi}‘MVž^nˆë •,Â=Öó/ýdu¢a)2‚½PE.˜^{ó“v ‹jðÞ‡©xð¾Q²î»s²¯Ð¤ŒÖöSöbÃÆ£¸‰,jfLO´ÛÓ„x )MzJå‡hL¸ {iÙ“vÅAuMÖ¬=€;§ÁD²èILÇ¡ÃŨ%wj½c0°>þl?q°´4P+;~¢ï´³îFß%1H‚¢jøÐòFÕÙéÓgñ2µßØhý²Z—3{­ü´^¿G挖ì¬õ=:JUïÞarꆩ«¤òMÍÔÚ­ígçVáÝ÷Sñ)…›»ë&õCvN9‹~ݿߢ² ›¬ˆtð —}J[÷¯Úé²ÇàEÖCw¼ý„åUOZ<à«Ü¿¤ÐÛC÷¿êO•9Ÿö}‡úáo«ZŸ%ŒûÖÜ|Ÿ¼”r¥¢¬³òAáÊó[H´–¬l½—ŒÛWßúJ&~ÝdºØ@=×]ûò“§±éƒ<Ü0;š,±ôã”6ÐýCJ+ È-RCm3¾\nÝšI«¼:îøD=žY“¤šìü¼»¿©0ÉSbyaÎ ýÕC“ý“ÿl½§Šðß³Î?EácWûaÒ€Vå¾ñbݱöEÑ¥æOx5£ŸÁTŠé!h͸<wЄýuõÈ(5u‡ âÉJC(fj gð· ¥hoyšŽdŒ“Ά´q™Žl߸^{ßçWžÁ?~*Åü‰Áçƒõó|PPÑ¡¤ÁäE.¿žý¶í@òéd1åG÷ü—s£(6¦V=¤%à'¸½²­L*tD}æiÒOY¾™žS6’âÇ‘´n_y3Ð#’úºäš,¼ú,*è9G´¨ëIŠñØ“U׿Eò `L€ 0&À˜@'¸(-¤TÙ±ëw$ Ø(ÄD‡“•Kjjjie« M”úÑFqKhÅñCéÈʱœhê$¾\í%@`×îÝØ“’ŠËG:¯l9räÖ¯ÿJ­7ßK¡{»wþ1‰,|1h`¨¬¯™\ü’’‡7)æŠPš˜§Iã0al¬ÌÁä…Õ†yZ»þ&Žƒ°˜ù낱¸÷¡/PSÛdRÌÙöÕJ^¥IðYåøÓÔD„û *B/O ˳”ß (f̯dÍR¥7Ù¯\µ>ï$›$F㯌•ç…²E(P>]{3¦YŸ€Q+úð“ýÈ/¨ÂÌCå'-xÔsÉ è­{v´TÍêð½³ü:êúi³ý×Ú®*¿†®±PŽ ë%¡T ðW&èÅyqýÞû ûuž‚ýÐÚP_Q†!¼:RøEö–]î ߃=ïýŸM%ÉéÆFlyúa ¼ín ¼~ªTÎè#yQIYìýh9 Û%ë´÷E(WêÊKQt iëW£²ÅE—¹üé¦&|·t“åJ¿kn…§>îQq²˜¡¦éß…ýkÞîkµ/GÖ„Ú’B ›1~Ô¶>"F9EŸÿƒ©H%E@yVºZÜbø‹UäÖ,_òˆ‰GøàÖ•ÔŇÇÞÕo $mŸ…g(Ò7­¥û·Ãï~XÞ»1}ä‰3ÍÍÈ&‹­”•¯ ¡¢½g±í…¿"yÞDQÜå‰JêHi'”,¹»¶)] ¯B¹R]FV`û+ñãç%(Ê2ýÍkoZåÛ«ÿ|:¿uMªO5ãš»"æ¡4I(¸Ó÷UJ%KIžm~ZåÍY¨ì³ŽÔ`÷×¥ÈØoù\c.s)/û±™§š0›\ä‰ û$²nILüïȨÅk?T¢€í¥rÍ&}CI¹M…?J±®Ü2¯§£Ú7¯×ÞãSêQTUŒ9Wú#–ܤE·X€ˆ1¤f×áÕÊq¼¤íñÓO­+%eGFŶºñ*!K¡dÙv̶5ÉÍ Š¢lç‰Z”׉VíO"DÝ}«‹)è½/®éï ORv…µÄzµÔP\© +ñÖËçû[á’L€ 0&À˜`öèÑ@¼cOtöÖÜMåôˆ‰@¼wwWV"U×Ô¡¨¨™Ù04Úþ£×M]æf/½{ÇàÓ5kÈ啧ãi¢IΙ÷ÌBZZšÃ²¶"Âu ðB}C3 ‹«;e¿­¶E¾Öö£"|¥ÂD¸,Ë+¬"ëû>·Â=`L/=ô¾¨­k’nÆ„¢ÉÑâCß!Þr’¨€Ú¯¬²ýÙѺí)¯•Ÿ=mtf™îî(];yýè×-”gÕÕ]{ýtáQ¤, &W]M“"5Õáö „·°\ý_[R`Ç·CÕ·YX¸Ýò „'¹¸2TÑ‚R^tµ‚wp(¹? “V(‚Ÿ¡Úº‚ÕÖ@Œå«Éݘ£ümÕ{©äû„FÿP©X1Yš[a-8yÇŽMõµ¨Ìͤ%ÝÕ£æ¥r+85NsFØSºô,ÍoF}c¿ÁZåê4 #I®×‚u=(H<)¹I¹BëUJÂuUßPT’ñ`A•c×^4¤µ}‡:k¥p¨o„‘û;Ò1!¯ü *ÿî öéâXK ³Êδ¥7¹¹[óç(Ù“¿®+Âö ûžw­t]ºl‹¢v}ÈHNô¿š¾º‹èˆ÷œ˜`L€ 0&Àº†ÀE§h1Æ&ߟ¥§Ë‹)‹ñøøýùE`òäIxñï§X@¦®ÚêåYš|zö¹ç°víº¶Šñ9&À˜`L€ 0&À."×ánrù|ŠÜëMy«¬ˆ.¢ÁñP˜`L€ 0&p ¸(\‡Ùºn§EtCNL ‹|÷Ý÷x¸îQ<±x1bb¢QXX„M›7aûOÛQT\Œ°°0$'Ƹ±cÑ·o_äææbÙë¯cëÖm]ÔCn† 0&À˜`L€ 0ó@b¤'ò+šðmZ+Y· Â}`L€ 0&À˜€FµE‹F6,Îœ& \ˆ58ánÅéY 0&À˜`L€ 0&À˜`L€ 0&Àº…€ý>Žº¥{Ü(¸0 °’å¼nÜk&À˜`L€ 0&À˜`L€ 0&À˜€£XÑâ(1.Ϙ`L€ 0&À˜`L€ 0&À˜`L€ 0¬há[ 0&À˜`L€ 0&À˜`L€ 0&À˜`N`E‹“àXŒ 0&À˜`L€ 0&À˜`L€ 0&À˜`¬há{€ 0&À˜`L€ 0&À˜`L€ 0&À˜`N`E‹“àXŒ 0&À˜`L€ 0&À˜`L€ 0&À˜`¬há{€ 0&À˜`L€ 0&À˜`L€ 0&À˜`N`E‹“àXŒ 0&À˜`L€ 0&À˜`L€ 0&À˜`¬há{€ 0&À˜`L€ 0&À˜`L€ 0&À˜`Nø7¼ÄÆrõ¦ÿ³IEND®B`‚cyme-2.2.6/doc/cyme.1000066400000000000000000000377511506545537300142740ustar00rootroot00000000000000.ie \n(.g .ds Aq \(aq .el .ds Aq ' .TH cyme 1 "cyme 2.2.6" .SH NAME cyme \- List system USB buses and devices. A modern cross\-platform lsusb .SH SYNOPSIS \fBcyme\fR [\fB\-l\fR|\fB\-\-lsusb\fR] [\fB\-t\fR|\fB\-\-tree\fR] [\fB\-d\fR|\fB\-\-vidpid\fR] [\fB\-s\fR|\fB\-\-show\fR] [\fB\-D\fR|\fB\-\-device\fR] [\fB\-\-filter\-name\fR] [\fB\-\-filter\-serial\fR] [\fB\-\-filter\-class\fR] [\fB\-v\fR|\fB\-\-verbose\fR]... [\fB\-b\fR|\fB\-\-blocks\fR] [\fB\-\-bus\-blocks\fR] [\fB\-\-config\-blocks\fR] [\fB\-\-interface\-blocks\fR] [\fB\-\-endpoint\-blocks\fR] [\fB\-\-block\-operation\fR] [\fB\-m\fR|\fB\-\-more\fR] [\fB\-\-sort\-devices\fR] [\fB\-\-sort\-buses\fR] [\fB\-\-group\-devices\fR] [\fB\-\-hide\-buses\fR] [\fB\-\-hide\-hubs\fR] [\fB\-\-list\-root\-hubs\fR] [\fB\-\-decimal\fR] [\fB\-\-no\-padding\fR] [\fB\-\-color\fR] [\fB\-\-encoding\fR] [\fB\-\-icon\fR] [\fB\-\-headings\fR] [\fB\-\-json\fR] [\fB\-\-from\-json\fR] [\fB\-F\fR|\fB\-\-force\-libusb\fR] [\fB\-c\fR|\fB\-\-config\fR] [\fB\-z\fR|\fB\-\-debug\fR]... [\fB\-\-mask\-serials\fR] [\fB\-\-system\-profiler\fR] [\fB\-h\fR|\fB\-\-help\fR] [\fB\-V\fR|\fB\-\-version\fR] [\fIsubcommands\fR] .SH DESCRIPTION List system USB buses and devices. A modern cross\-platform lsusb .SH OPTIONS .TP \fB\-l\fR, \fB\-\-lsusb\fR Attempt to maintain compatibility with lsusb output .TP \fB\-t\fR, \fB\-\-tree\fR Dump USB device hierarchy as a tree .TP \fB\-d\fR, \fB\-\-vidpid\fR \fI\fR Show only devices with the specified vendor and product ID numbers (in hexadecimal) in format VID:[PID] .TP \fB\-s\fR, \fB\-\-show\fR \fI\fR Show only devices with specified device and/or bus numbers (in decimal) in format [[bus]:][devnum] .TP \fB\-D\fR, \fB\-\-device\fR \fI\fR Selects which device lsusb will examine \- supplied as Linux /dev/bus/usb/BBB/DDD style path .TP \fB\-\-filter\-name\fR \fI\fR Filter on string contained in name .TP \fB\-\-filter\-serial\fR \fI\fR Filter on string contained in serial .TP \fB\-\-filter\-class\fR \fI\fR Filter on USB class code .br .br \fIPossible values:\fR .RS 14 .IP \(bu 2 use\-interface\-descriptor: Device class is unspecified, interface descriptors are used to determine needed drivers .IP \(bu 2 audio: Speaker, microphone, sound card, MIDI .IP \(bu 2 cdc\-communications: The modern serial interface; appears as a UART/RS232 port on most systems .IP \(bu 2 hid: Human Interface Device; game controllers, keyboards, mice etc. Also commonly used as a device data interface rather then creating something from scratch .IP \(bu 2 physical: Force feedback joystick .IP \(bu 2 image: Still imaging device; scanners, cameras .IP \(bu 2 printer: Laser printer, inkjet printer, CNC machine .IP \(bu 2 mass\-storage: Mass storage devices (MSD): USB flash drive, memory card reader, digital audio player, digital camera, external drive .IP \(bu 2 hub: High speed USB hub .IP \(bu 2 cdc\-data: Used together with class 02h (Communications and CDC Control) above .IP \(bu 2 smart\-card: USB smart card reader .IP \(bu 2 content\-security: Fingerprint reader .IP \(bu 2 video: Webcam .IP \(bu 2 personal\-healthcare: Pulse monitor (watch) .IP \(bu 2 audio\-video: Webcam, TV .IP \(bu 2 billboard: Describes USB\-C alternate modes supported by device .IP \(bu 2 usb\-type\-c\-bridge: An interface to expose and configure the USB Type\-C capabilities of Connectors on USB Hubs or Alternate Mode Adapters .IP \(bu 2 bdp: This base class is defined for devices that conform to the “VESA USB BDP Device Specification†found at the VESA website. This specification defines the usable set of SubClass and Protocol values. Values outside of this defined spec are reserved. These class codes can only be used in Interface Descriptors .IP \(bu 2 mctp: This base class is defined for devices that conform to the “MCTP over USB†found at the DMTF website as DSP0283. This specification defines the usable set of SubClass and Protocol values. Values outside of this defined spec are reserved. These class codes can only be used in Interface Descriptors .IP \(bu 2 i3c\-device: An interface to expose and configure I3C function within a USB device to allow interaction between host software and the I3C device, to drive transaction on the I3C bus to/from target devices .IP \(bu 2 diagnostic: Trace and debugging equipment .IP \(bu 2 wireless\-controller: Wireless controllers: Bluetooth adaptors, Microsoft RNDIS .IP \(bu 2 miscellaneous: This base class is defined for miscellaneous device definitions. Some matching SubClass and Protocols are defined on the USB\-IF website .IP \(bu 2 application\-specific\-interface: This base class is defined for devices that conform to several class specifications found on the USB\-IF website .IP \(bu 2 vendor\-specific\-class: This base class is defined for vendors to use as they please .RE .TP \fB\-v\fR, \fB\-\-verbose\fR Verbosity level (repeat provides count): 1 prints device configurations; 2 prints interfaces; 3 prints interface endpoints; 4 prints everything and more blocks .TP \fB\-b\fR, \fB\-\-blocks\fR \fI...\fR Specify the blocks which will be displayed for each device and in what order. Supply arg multiple times or csv to specify multiple blocks. Default blocks: \-\-blocks bus\-number,device\-number,icon,vendor\-id,product\-id,name,serial,speed .br .br \fIPossible values:\fR .RS 14 .IP \(bu 2 bus\-number: Number of bus device is attached .IP \(bu 2 device\-number: Bus issued device number .IP \(bu 2 branch\-position: Position of device in parent branch .IP \(bu 2 port\-path: Linux style port path .IP \(bu 2 sys\-path: Linux udev reported syspath .IP \(bu 2 driver: Linux udev reported driver loaded for device .IP \(bu 2 icon: Icon based on VID/PID .IP \(bu 2 vendor\-id: Unique vendor identifier \- purchased from USB IF .IP \(bu 2 product\-id: Vendor unique product identifier .IP \(bu 2 vid\-pid: Unique vendor identifier and product identifier as a string formatted "vid:pid" like lsusb .IP \(bu 2 name: The device name as reported in descriptor or using usb_ids if None .IP \(bu 2 manufacturer: The device manufacturer as provided in descriptor or using usb_ids if None .IP \(bu 2 product\-name: The device product name as reported by usb_ids vidpid lookup .IP \(bu 2 vendor\-name: The device vendor name as reported by usb_ids vid lookup .IP \(bu 2 serial: Device serial string as reported by descriptor .IP \(bu 2 speed: Advertised device capable speed .IP \(bu 2 negotiated\-speed: Negotiated device speed as connected .IP \(bu 2 tree\-positions: Position along all branches back to trunk device .IP \(bu 2 bus\-power: macOS system_profiler only \- actually bus current in mA not power! .IP \(bu 2 bus\-power\-used: macOS system_profiler only \- actually bus current used in mA not power! .IP \(bu 2 extra\-current\-used: macOS system_profiler only \- actually bus current used in mA not power! .IP \(bu 2 bcd\-device: The device version .IP \(bu 2 bcd\-usb: The supported USB version .IP \(bu 2 base\-class: Base class enum of interface provided by USB IF \- only available when using libusb .IP \(bu 2 sub\-class: Sub\-class value of interface provided by USB IF \- only available when using libusb .IP \(bu 2 protocol: Prototol value for interface provided by USB IF \- only available when using libusb .IP \(bu 2 uid\-class: Class name from USB IDs repository .IP \(bu 2 uid\-sub\-class: Sub\-class name from USB IDs repository .IP \(bu 2 uid\-protocol: Protocol name from USB IDs repository .IP \(bu 2 class: Fully defined USB Class Code enum based on BaseClass/SubClass/Protocol triplet .IP \(bu 2 base\-value: Base class as number value rather than enum .IP \(bu 2 last\-event: Last time device was seen .IP \(bu 2 event\-icon: Event icon .RE .TP \fB\-\-bus\-blocks\fR \fI...\fR Specify the blocks which will be displayed for each bus and in what order. Supply arg multiple times or csv to specify multiple blocks. Default blocks: \-\-bus\-blocks port\-path,name,host\-controller,host\-controller\-device .br .br \fIPossible values:\fR .RS 14 .IP \(bu 2 bus\-number: System bus number identifier .IP \(bu 2 icon: Icon based on VID/PID .IP \(bu 2 name: System internal bus name based on Root Hub device name .IP \(bu 2 host\-controller: System internal bus provider name .IP \(bu 2 host\-controller\-vendor: Vendor name of PCI Host Controller from pci.ids .IP \(bu 2 host\-controller\-device: Device name of PCI Host Controller from pci.ids .IP \(bu 2 pci\-vendor: PCI vendor ID (VID) .IP \(bu 2 pci\-device: PCI device ID (PID) .IP \(bu 2 pci\-revision: PCI Revsision ID .IP \(bu 2 port\-path: syspath style port path to bus, applicable to Linux only .RE .TP \fB\-\-config\-blocks\fR \fI...\fR Specify the blocks which will be displayed for each configuration and in what order. Supply arg multiple times or csv to specify multiple blocks. Default blocks: \-\-config\-blocks number,icon\-attributes,max\-power,name .br .br \fIPossible values:\fR .RS 14 .IP \(bu 2 name: Name from string descriptor .IP \(bu 2 number: Number of config, bConfigurationValue; value to set to enable to configuration .IP \(bu 2 num\-interfaces: Interfaces available for this configuruation .IP \(bu 2 attributes: Attributes of configuration, bmAttributes .IP \(bu 2 icon\-attributes: Icon representation of bmAttributes .IP \(bu 2 max\-power: Maximum current consumption in mA .RE .TP \fB\-\-interface\-blocks\fR \fI...\fR Specify the blocks which will be displayed for each interface and in what order. Supply arg multiple times or csv to specify multiple blocks. Default blocks: \-\-interface\-blocks port\-path,icon,alt\-setting,base\-class,sub\-class \-\-interface .br .br \fIPossible values:\fR .RS 14 .IP \(bu 2 name: Name from string descriptor .IP \(bu 2 number: Interface number .IP \(bu 2 port\-path: Interface port path, applicable to Linux .IP \(bu 2 base\-class: Base class enum of interface provided by USB IF .IP \(bu 2 sub\-class: Sub\-class value of interface provided by USB IF .IP \(bu 2 protocol: Prototol value for interface provided by USB IF .IP \(bu 2 alt\-setting: Interfaces can have the same number but an alternate settings defined here .IP \(bu 2 driver: Driver obtained from udev on Linux only .IP \(bu 2 sys\-path: syspath obtained from udev on Linux only .IP \(bu 2 num\-endpoints: An interface can have many endpoints .IP \(bu 2 icon: Icon based on BaseClass/SubCode/Protocol .IP \(bu 2 uid\-class: Class name from USB IDs repository .IP \(bu 2 uid\-sub\-class: Sub\-class name from USB IDs repository .IP \(bu 2 uid\-protocol: Protocol name from USB IDs repository .IP \(bu 2 class: Fully defined USB Class Code based on BaseClass/SubClass/Protocol triplet .IP \(bu 2 base\-value: Base class as number value rather than enum .RE .TP \fB\-\-endpoint\-blocks\fR \fI...\fR Specify the blocks which will be displayed for each endpoint and in what order. Supply arg multiple times or csv to specify multiple blocks. Default blocks: \-\-endpoint\-blocks number,direction,transfer\-type,sync\-type,usage\-type,max\-packet\-size .br .br \fIPossible values:\fR .RS 14 .IP \(bu 2 number: Endpoint number on interface .IP \(bu 2 direction: Direction of data into endpoint .IP \(bu 2 transfer\-type: Type of data transfer endpoint accepts .IP \(bu 2 sync\-type: Synchronisation type (Iso mode) .IP \(bu 2 usage\-type: Usage type (Iso mode) .IP \(bu 2 max\-packet\-size: Maximum packet size in bytes endpoint can send/recieve .IP \(bu 2 interval: Interval for polling endpoint data transfers. Value in frame counts. Ignored for Bulk & Control Endpoints. Isochronous must equal 1 and field may range from 1 to 255 for interrupt endpoints .RE .TP \fB\-\-block\-operation\fR \fI\fR [default: new] Operation to perform on the blocks supplied via \-\-blocks, \-\-bus\-blocks, \-\-config\-blocks, \-\-interface\-blocks and \-\-endpoint\-blocks Default is \*(Aqnew\*(Aq for legacy, \*(Aqadd\*(Aq is probably more useful .br .br \fIPossible values:\fR .RS 14 .IP \(bu 2 add: Add new blocks to the existing blocks, ignoring duplicates .IP \(bu 2 append: Append new blocks to the end of the existing blocks .IP \(bu 2 new: Replace all blocks with new ones .IP \(bu 2 prepend: Prepend new blocks to the start of the existing blocks .IP \(bu 2 remove: Remove matching blocks from the existing blocks .RE .TP \fB\-m\fR, \fB\-\-more\fR Print more blocks by default at each verbosity .TP \fB\-\-sort\-devices\fR \fI\fR [default: device\-number] Sort devices operation .br .br \fIPossible values:\fR .RS 14 .IP \(bu 2 device\-number: Sort by bus device number .IP \(bu 2 branch\-position: Sort by position in parent branch .IP \(bu 2 no\-sort: No sorting; whatever order it was parsed .RE .TP \fB\-\-sort\-buses\fR Sort devices by bus number. If using any sort\-devices other than no\-sort, this happens automatically .TP \fB\-\-group\-devices\fR \fI\fR [default: no\-group] Group devices by value when listing .br .br \fIPossible values:\fR .RS 14 .IP \(bu 2 no\-group: No grouping .IP \(bu 2 bus: Group into buses with bus info as heading \- like a flat tree .RE .TP \fB\-\-hide\-buses\fR Hide empty buses when printing tree; those with no devices .TP \fB\-\-hide\-hubs\fR Hide empty hubs when printing tree; those with no devices. When listing will hide hubs regardless of whether empty of not .TP \fB\-\-list\-root\-hubs\fR Show root hubs when listing; Linux only .TP \fB\-\-decimal\fR Show base16 values as base10 decimal instead .TP \fB\-\-no\-padding\fR Disable padding to align blocks \- will cause \-\-headings to become maligned .TP \fB\-\-color\fR \fI\fR [default: always] Output coloring mode .br .br \fIPossible values:\fR .RS 14 .IP \(bu 2 auto: Show colours if the output goes to an interactive console .IP \(bu 2 always: Always apply colouring to the output .IP \(bu 2 never: Never apply colouring to the output .RE .TP \fB\-\-encoding\fR \fI\fR [default: glyphs] Output character encoding .br .br \fIPossible values:\fR .RS 14 .IP \(bu 2 glyphs: Use UTF\-8 private use area characters such as those used by NerdFont to show glyph icons .IP \(bu 2 utf8: Use only standard UTF\-8 characters for the output; no private use area glyph icons .IP \(bu 2 ascii: Use only ASCII characters for the output; 0x00 \- 0x7F (127 chars) .RE .TP \fB\-\-icon\fR \fI\fR [default: auto] When to print icon blocks .br .br \fIPossible values:\fR .RS 14 .IP \(bu 2 auto: Show icon blocks if the [`Encoding`] supports icons matched in the [`icon::IconTheme`] .IP \(bu 2 always: Always print icon blocks if included in configured blocks .IP \(bu 2 never: Never print icon blocks .RE .TP \fB\-\-headings\fR Show block headings .TP \fB\-\-json\fR Output as json format after sorting, filters and tree settings are applied; without \-tree will be flattened dump of devices .TP \fB\-\-from\-json\fR \fI\fR Read from json output rather than profiling system .TP \fB\-F\fR, \fB\-\-force\-libusb\fR Force pure libusb profiler on macOS rather than combining system_profiler output Has no effect on other platforms or when using nusb .TP \fB\-c\fR, \fB\-\-config\fR \fI\fR Path to user config file to use for custom icons, colours and default settings .TP \fB\-z\fR, \fB\-\-debug\fR Turn debugging information on. Alternatively can use RUST_LOG env: INFO, DEBUG, TRACE .TP \fB\-\-mask\-serials\fR \fI\fR Mask serial numbers with \*(Aq*\*(Aq or random chars .br .br \fIPossible values:\fR .RS 14 .IP \(bu 2 hide: Hide with \*(Aq*\*(Aq char .IP \(bu 2 scramble: Mask by randomising existing chars .IP \(bu 2 replace: Mask by replacing length with random chars .RE .TP \fB\-\-system\-profiler\fR Use the system_profiler command on macOS to get USB data If not using nusb this is the default for macOS, merging with libusb data for verbose output. nusb uses IOKit directly so does not use system_profiler by default .TP \fB\-h\fR, \fB\-\-help\fR Print help (see a summary with \*(Aq\-h\*(Aq) .TP \fB\-V\fR, \fB\-\-version\fR Print version .SH SUBCOMMANDS .TP cyme\-watch(1) Watch for USB devices being connected and disconnected .TP cyme\-help(1) Print this message or the help of the given subcommand(s) .SH VERSION v2.2.6 .SH AUTHORS John Whittington cyme-2.2.6/doc/cyme.bash000066400000000000000000000210741506545537300150400ustar00rootroot00000000000000_cyme() { local i cur prev opts cmd COMPREPLY=() if [[ "${BASH_VERSINFO[0]}" -ge 4 ]]; then cur="$2" else cur="${COMP_WORDS[COMP_CWORD]}" fi prev="$3" cmd="" opts="" for i in "${COMP_WORDS[@]:0:COMP_CWORD}" do case "${cmd},${i}" in ",$1") cmd="cyme" ;; cyme,help) cmd="cyme__help" ;; cyme,watch) cmd="cyme__watch" ;; cyme__help,help) cmd="cyme__help__help" ;; cyme__help,watch) cmd="cyme__help__watch" ;; *) ;; esac done case "${cmd}" in cyme) opts="-l -t -d -s -D -v -b -m -F -c -z -h -V --lsusb --tree --vidpid --show --device --filter-name --filter-serial --filter-class --verbose --blocks --bus-blocks --config-blocks --interface-blocks --endpoint-blocks --block-operation --more --sort-devices --sort-buses --group-devices --hide-buses --hide-hubs --list-root-hubs --decimal --no-padding --color --no-color --encoding --ascii --no-icons --icon --headings --json --from-json --force-libusb --config --debug --mask-serials --gen --system-profiler --help --version watch help" if [[ ${cur} == -* || ${COMP_CWORD} -eq 1 ]] ; then COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") ) return 0 fi case "${prev}" in --vidpid) COMPREPLY=($(compgen -f "${cur}")) return 0 ;; -d) COMPREPLY=($(compgen -f "${cur}")) return 0 ;; --show) COMPREPLY=($(compgen -f "${cur}")) return 0 ;; -s) COMPREPLY=($(compgen -f "${cur}")) return 0 ;; --device) COMPREPLY=($(compgen -f "${cur}")) return 0 ;; -D) COMPREPLY=($(compgen -f "${cur}")) return 0 ;; --filter-name) COMPREPLY=($(compgen -f "${cur}")) return 0 ;; --filter-serial) COMPREPLY=($(compgen -f "${cur}")) return 0 ;; --filter-class) COMPREPLY=($(compgen -W "use-interface-descriptor audio cdc-communications hid physical image printer mass-storage hub cdc-data smart-card content-security video personal-healthcare audio-video billboard usb-type-c-bridge bdp mctp i3c-device diagnostic wireless-controller miscellaneous application-specific-interface vendor-specific-class" -- "${cur}")) return 0 ;; --blocks) COMPREPLY=($(compgen -W "bus-number device-number branch-position port-path sys-path driver icon vendor-id product-id vid-pid name manufacturer product-name vendor-name serial speed negotiated-speed tree-positions bus-power bus-power-used extra-current-used bcd-device bcd-usb base-class sub-class protocol uid-class uid-sub-class uid-protocol class base-value last-event event-icon" -- "${cur}")) return 0 ;; -b) COMPREPLY=($(compgen -W "bus-number device-number branch-position port-path sys-path driver icon vendor-id product-id vid-pid name manufacturer product-name vendor-name serial speed negotiated-speed tree-positions bus-power bus-power-used extra-current-used bcd-device bcd-usb base-class sub-class protocol uid-class uid-sub-class uid-protocol class base-value last-event event-icon" -- "${cur}")) return 0 ;; --bus-blocks) COMPREPLY=($(compgen -W "bus-number icon name host-controller host-controller-vendor host-controller-device pci-vendor pci-device pci-revision port-path" -- "${cur}")) return 0 ;; --config-blocks) COMPREPLY=($(compgen -W "name number num-interfaces attributes icon-attributes max-power" -- "${cur}")) return 0 ;; --interface-blocks) COMPREPLY=($(compgen -W "name number port-path base-class sub-class protocol alt-setting driver sys-path num-endpoints icon uid-class uid-sub-class uid-protocol class base-value" -- "${cur}")) return 0 ;; --endpoint-blocks) COMPREPLY=($(compgen -W "number direction transfer-type sync-type usage-type max-packet-size interval" -- "${cur}")) return 0 ;; --block-operation) COMPREPLY=($(compgen -W "add append new prepend remove" -- "${cur}")) return 0 ;; --sort-devices) COMPREPLY=($(compgen -W "device-number branch-position no-sort" -- "${cur}")) return 0 ;; --group-devices) COMPREPLY=($(compgen -W "no-group bus" -- "${cur}")) return 0 ;; --color) COMPREPLY=($(compgen -W "auto always never" -- "${cur}")) return 0 ;; --encoding) COMPREPLY=($(compgen -W "glyphs utf8 ascii" -- "${cur}")) return 0 ;; --icon) COMPREPLY=($(compgen -W "auto always never" -- "${cur}")) return 0 ;; --from-json) COMPREPLY=($(compgen -f "${cur}")) return 0 ;; --config) COMPREPLY=($(compgen -f "${cur}")) return 0 ;; -c) COMPREPLY=($(compgen -f "${cur}")) return 0 ;; --mask-serials) COMPREPLY=($(compgen -W "hide scramble replace" -- "${cur}")) return 0 ;; *) COMPREPLY=() ;; esac COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") ) return 0 ;; cyme__help) opts="watch help" if [[ ${cur} == -* || ${COMP_CWORD} -eq 2 ]] ; then COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") ) return 0 fi case "${prev}" in *) COMPREPLY=() ;; esac COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") ) return 0 ;; cyme__help__help) opts="" if [[ ${cur} == -* || ${COMP_CWORD} -eq 3 ]] ; then COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") ) return 0 fi case "${prev}" in *) COMPREPLY=() ;; esac COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") ) return 0 ;; cyme__help__watch) opts="" if [[ ${cur} == -* || ${COMP_CWORD} -eq 3 ]] ; then COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") ) return 0 fi case "${prev}" in *) COMPREPLY=() ;; esac COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") ) return 0 ;; cyme__watch) opts="-h --help" if [[ ${cur} == -* || ${COMP_CWORD} -eq 2 ]] ; then COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") ) return 0 fi case "${prev}" in *) COMPREPLY=() ;; esac COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") ) return 0 ;; esac } if [[ "${BASH_VERSINFO[0]}" -eq 4 && "${BASH_VERSINFO[1]}" -ge 4 || "${BASH_VERSINFO[0]}" -gt 4 ]]; then complete -F _cyme -o nosort -o bashdefault -o default cyme else complete -F _cyme -o bashdefault -o default cyme fi cyme-2.2.6/doc/cyme.fish000066400000000000000000000365771506545537300150720ustar00rootroot00000000000000# Print an optspec for argparse to handle cmd's options that are independent of any subcommand. function __fish_cyme_global_optspecs string join \n l/lsusb t/tree d/vidpid= s/show= D/device= filter-name= filter-serial= filter-class= v/verbose b/blocks= bus-blocks= config-blocks= interface-blocks= endpoint-blocks= block-operation= m/more sort-devices= sort-buses group-devices= hide-buses hide-hubs list-root-hubs decimal no-padding color= no-color encoding= ascii no-icons icon= headings json from-json= F/force-libusb c/config= z/debug mask-serials= gen system-profiler h/help V/version end function __fish_cyme_needs_command # Figure out if the current invocation already has a command. set -l cmd (commandline -opc) set -e cmd[1] argparse -s (__fish_cyme_global_optspecs) -- $cmd 2>/dev/null or return if set -q argv[1] # Also print the command, so this can be used to figure out what it is. echo $argv[1] return 1 end return 0 end function __fish_cyme_using_subcommand set -l cmd (__fish_cyme_needs_command) test -z "$cmd" and return 1 contains -- $cmd[1] $argv end complete -c cyme -n "__fish_cyme_needs_command" -s d -l vidpid -d 'Show only devices with the specified vendor and product ID numbers (in hexadecimal) in format VID:[PID]' -r complete -c cyme -n "__fish_cyme_needs_command" -s s -l show -d 'Show only devices with specified device and/or bus numbers (in decimal) in format [[bus]:][devnum]' -r complete -c cyme -n "__fish_cyme_needs_command" -s D -l device -d 'Selects which device lsusb will examine - supplied as Linux /dev/bus/usb/BBB/DDD style path' -r complete -c cyme -n "__fish_cyme_needs_command" -l filter-name -d 'Filter on string contained in name' -r complete -c cyme -n "__fish_cyme_needs_command" -l filter-serial -d 'Filter on string contained in serial' -r complete -c cyme -n "__fish_cyme_needs_command" -l filter-class -d 'Filter on USB class code' -r -f -a "use-interface-descriptor\t'Device class is unspecified, interface descriptors are used to determine needed drivers' audio\t'Speaker, microphone, sound card, MIDI' cdc-communications\t'The modern serial interface; appears as a UART/RS232 port on most systems' hid\t'Human Interface Device; game controllers, keyboards, mice etc. Also commonly used as a device data interface rather then creating something from scratch' physical\t'Force feedback joystick' image\t'Still imaging device; scanners, cameras' printer\t'Laser printer, inkjet printer, CNC machine' mass-storage\t'Mass storage devices (MSD): USB flash drive, memory card reader, digital audio player, digital camera, external drive' hub\t'High speed USB hub' cdc-data\t'Used together with class 02h (Communications and CDC Control) above' smart-card\t'USB smart card reader' content-security\t'Fingerprint reader' video\t'Webcam' personal-healthcare\t'Pulse monitor (watch)' audio-video\t'Webcam, TV' billboard\t'Describes USB-C alternate modes supported by device' usb-type-c-bridge\t'An interface to expose and configure the USB Type-C capabilities of Connectors on USB Hubs or Alternate Mode Adapters' bdp\t'This base class is defined for devices that conform to the “VESA USB BDP Device Specification†found at the VESA website. This specification defines the usable set of SubClass and Protocol values. Values outside of this defined spec are reserved. These class codes can only be used in Interface Descriptors' mctp\t'This base class is defined for devices that conform to the “MCTP over USB†found at the DMTF website as DSP0283. This specification defines the usable set of SubClass and Protocol values. Values outside of this defined spec are reserved. These class codes can only be used in Interface Descriptors' i3c-device\t'An interface to expose and configure I3C function within a USB device to allow interaction between host software and the I3C device, to drive transaction on the I3C bus to/from target devices' diagnostic\t'Trace and debugging equipment' wireless-controller\t'Wireless controllers: Bluetooth adaptors, Microsoft RNDIS' miscellaneous\t'This base class is defined for miscellaneous device definitions. Some matching SubClass and Protocols are defined on the USB-IF website' application-specific-interface\t'This base class is defined for devices that conform to several class specifications found on the USB-IF website' vendor-specific-class\t'This base class is defined for vendors to use as they please'" complete -c cyme -n "__fish_cyme_needs_command" -s b -l blocks -d 'Specify the blocks which will be displayed for each device and in what order. Supply arg multiple times or csv to specify multiple blocks' -r -f -a "bus-number\t'Number of bus device is attached' device-number\t'Bus issued device number' branch-position\t'Position of device in parent branch' port-path\t'Linux style port path' sys-path\t'Linux udev reported syspath' driver\t'Linux udev reported driver loaded for device' icon\t'Icon based on VID/PID' vendor-id\t'Unique vendor identifier - purchased from USB IF' product-id\t'Vendor unique product identifier' vid-pid\t'Unique vendor identifier and product identifier as a string formatted "vid:pid" like lsusb' name\t'The device name as reported in descriptor or using usb_ids if None' manufacturer\t'The device manufacturer as provided in descriptor or using usb_ids if None' product-name\t'The device product name as reported by usb_ids vidpid lookup' vendor-name\t'The device vendor name as reported by usb_ids vid lookup' serial\t'Device serial string as reported by descriptor' speed\t'Advertised device capable speed' negotiated-speed\t'Negotiated device speed as connected' tree-positions\t'Position along all branches back to trunk device' bus-power\t'macOS system_profiler only - actually bus current in mA not power!' bus-power-used\t'macOS system_profiler only - actually bus current used in mA not power!' extra-current-used\t'macOS system_profiler only - actually bus current used in mA not power!' bcd-device\t'The device version' bcd-usb\t'The supported USB version' base-class\t'Base class enum of interface provided by USB IF - only available when using libusb' sub-class\t'Sub-class value of interface provided by USB IF - only available when using libusb' protocol\t'Prototol value for interface provided by USB IF - only available when using libusb' uid-class\t'Class name from USB IDs repository' uid-sub-class\t'Sub-class name from USB IDs repository' uid-protocol\t'Protocol name from USB IDs repository' class\t'Fully defined USB Class Code enum based on BaseClass/SubClass/Protocol triplet' base-value\t'Base class as number value rather than enum' last-event\t'Last time device was seen' event-icon\t'Event icon'" complete -c cyme -n "__fish_cyme_needs_command" -l bus-blocks -d 'Specify the blocks which will be displayed for each bus and in what order. Supply arg multiple times or csv to specify multiple blocks' -r -f -a "bus-number\t'System bus number identifier' icon\t'Icon based on VID/PID' name\t'System internal bus name based on Root Hub device name' host-controller\t'System internal bus provider name' host-controller-vendor\t'Vendor name of PCI Host Controller from pci.ids' host-controller-device\t'Device name of PCI Host Controller from pci.ids' pci-vendor\t'PCI vendor ID (VID)' pci-device\t'PCI device ID (PID)' pci-revision\t'PCI Revsision ID' port-path\t'syspath style port path to bus, applicable to Linux only'" complete -c cyme -n "__fish_cyme_needs_command" -l config-blocks -d 'Specify the blocks which will be displayed for each configuration and in what order. Supply arg multiple times or csv to specify multiple blocks' -r -f -a "name\t'Name from string descriptor' number\t'Number of config, bConfigurationValue; value to set to enable to configuration' num-interfaces\t'Interfaces available for this configuruation' attributes\t'Attributes of configuration, bmAttributes' icon-attributes\t'Icon representation of bmAttributes' max-power\t'Maximum current consumption in mA'" complete -c cyme -n "__fish_cyme_needs_command" -l interface-blocks -d 'Specify the blocks which will be displayed for each interface and in what order. Supply arg multiple times or csv to specify multiple blocks' -r -f -a "name\t'Name from string descriptor' number\t'Interface number' port-path\t'Interface port path, applicable to Linux' base-class\t'Base class enum of interface provided by USB IF' sub-class\t'Sub-class value of interface provided by USB IF' protocol\t'Prototol value for interface provided by USB IF' alt-setting\t'Interfaces can have the same number but an alternate settings defined here' driver\t'Driver obtained from udev on Linux only' sys-path\t'syspath obtained from udev on Linux only' num-endpoints\t'An interface can have many endpoints' icon\t'Icon based on BaseClass/SubCode/Protocol' uid-class\t'Class name from USB IDs repository' uid-sub-class\t'Sub-class name from USB IDs repository' uid-protocol\t'Protocol name from USB IDs repository' class\t'Fully defined USB Class Code based on BaseClass/SubClass/Protocol triplet' base-value\t'Base class as number value rather than enum'" complete -c cyme -n "__fish_cyme_needs_command" -l endpoint-blocks -d 'Specify the blocks which will be displayed for each endpoint and in what order. Supply arg multiple times or csv to specify multiple blocks' -r -f -a "number\t'Endpoint number on interface' direction\t'Direction of data into endpoint' transfer-type\t'Type of data transfer endpoint accepts' sync-type\t'Synchronisation type (Iso mode)' usage-type\t'Usage type (Iso mode)' max-packet-size\t'Maximum packet size in bytes endpoint can send/recieve' interval\t'Interval for polling endpoint data transfers. Value in frame counts. Ignored for Bulk & Control Endpoints. Isochronous must equal 1 and field may range from 1 to 255 for interrupt endpoints'" complete -c cyme -n "__fish_cyme_needs_command" -l block-operation -d 'Operation to perform on the blocks supplied via --blocks, --bus-blocks, --config-blocks, --interface-blocks and --endpoint-blocks' -r -f -a "add\t'Add new blocks to the existing blocks, ignoring duplicates' append\t'Append new blocks to the end of the existing blocks' new\t'Replace all blocks with new ones' prepend\t'Prepend new blocks to the start of the existing blocks' remove\t'Remove matching blocks from the existing blocks'" complete -c cyme -n "__fish_cyme_needs_command" -l sort-devices -d 'Sort devices operation' -r -f -a "device-number\t'Sort by bus device number' branch-position\t'Sort by position in parent branch' no-sort\t'No sorting; whatever order it was parsed'" complete -c cyme -n "__fish_cyme_needs_command" -l group-devices -d 'Group devices by value when listing' -r -f -a "no-group\t'No grouping' bus\t'Group into buses with bus info as heading - like a flat tree'" complete -c cyme -n "__fish_cyme_needs_command" -l color -d 'Output coloring mode' -r -f -a "auto\t'Show colours if the output goes to an interactive console' always\t'Always apply colouring to the output' never\t'Never apply colouring to the output'" complete -c cyme -n "__fish_cyme_needs_command" -l encoding -d 'Output character encoding' -r -f -a "glyphs\t'Use UTF-8 private use area characters such as those used by NerdFont to show glyph icons' utf8\t'Use only standard UTF-8 characters for the output; no private use area glyph icons' ascii\t'Use only ASCII characters for the output; 0x00 - 0x7F (127 chars)'" complete -c cyme -n "__fish_cyme_needs_command" -l icon -d 'When to print icon blocks' -r -f -a "auto\t'Show icon blocks if the [`Encoding`] supports icons matched in the [`icon::IconTheme`]' always\t'Always print icon blocks if included in configured blocks' never\t'Never print icon blocks'" complete -c cyme -n "__fish_cyme_needs_command" -l from-json -d 'Read from json output rather than profiling system' -r -F complete -c cyme -n "__fish_cyme_needs_command" -s c -l config -d 'Path to user config file to use for custom icons, colours and default settings' -r -F complete -c cyme -n "__fish_cyme_needs_command" -l mask-serials -d 'Mask serial numbers with \'*\' or random chars' -r -f -a "hide\t'Hide with \'*\' char' scramble\t'Mask by randomising existing chars' replace\t'Mask by replacing length with random chars'" complete -c cyme -n "__fish_cyme_needs_command" -s l -l lsusb -d 'Attempt to maintain compatibility with lsusb output' complete -c cyme -n "__fish_cyme_needs_command" -s t -l tree -d 'Dump USB device hierarchy as a tree' complete -c cyme -n "__fish_cyme_needs_command" -s v -l verbose -d 'Verbosity level (repeat provides count): 1 prints device configurations; 2 prints interfaces; 3 prints interface endpoints; 4 prints everything and more blocks' complete -c cyme -n "__fish_cyme_needs_command" -s m -l more -d 'Print more blocks by default at each verbosity' complete -c cyme -n "__fish_cyme_needs_command" -l sort-buses -d 'Sort devices by bus number. If using any sort-devices other than no-sort, this happens automatically' complete -c cyme -n "__fish_cyme_needs_command" -l hide-buses -d 'Hide empty buses when printing tree; those with no devices' complete -c cyme -n "__fish_cyme_needs_command" -l hide-hubs -d 'Hide empty hubs when printing tree; those with no devices. When listing will hide hubs regardless of whether empty of not' complete -c cyme -n "__fish_cyme_needs_command" -l list-root-hubs -d 'Show root hubs when listing; Linux only' complete -c cyme -n "__fish_cyme_needs_command" -l decimal -d 'Show base16 values as base10 decimal instead' complete -c cyme -n "__fish_cyme_needs_command" -l no-padding -d 'Disable padding to align blocks - will cause --headings to become maligned' complete -c cyme -n "__fish_cyme_needs_command" -l no-color -d 'Disable coloured output, can also use NO_COLOR environment variable' complete -c cyme -n "__fish_cyme_needs_command" -l ascii -d 'Disables icons and utf-8 characters' complete -c cyme -n "__fish_cyme_needs_command" -l no-icons -d 'Disables all Block icons by not using any IconTheme. Providing custom XxxxBlocks without any icons is a nicer way to do this' complete -c cyme -n "__fish_cyme_needs_command" -l headings -d 'Show block headings' complete -c cyme -n "__fish_cyme_needs_command" -l json -d 'Output as json format after sorting, filters and tree settings are applied; without -tree will be flattened dump of devices' complete -c cyme -n "__fish_cyme_needs_command" -s F -l force-libusb -d 'Force pure libusb profiler on macOS rather than combining system_profiler output' complete -c cyme -n "__fish_cyme_needs_command" -s z -l debug -d 'Turn debugging information on. Alternatively can use RUST_LOG env: INFO, DEBUG, TRACE' complete -c cyme -n "__fish_cyme_needs_command" -l gen -d 'Generate cli completions and man page' complete -c cyme -n "__fish_cyme_needs_command" -l system-profiler -d 'Use the system_profiler command on macOS to get USB data' complete -c cyme -n "__fish_cyme_needs_command" -s h -l help -d 'Print help (see more with \'--help\')' complete -c cyme -n "__fish_cyme_needs_command" -s V -l version -d 'Print version' complete -c cyme -n "__fish_cyme_needs_command" -f -a "watch" -d 'Watch for USB devices being connected and disconnected' complete -c cyme -n "__fish_cyme_needs_command" -f -a "help" -d 'Print this message or the help of the given subcommand(s)' complete -c cyme -n "__fish_cyme_using_subcommand watch" -s h -l help -d 'Print help' complete -c cyme -n "__fish_cyme_using_subcommand help; and not __fish_seen_subcommand_from watch help" -f -a "watch" -d 'Watch for USB devices being connected and disconnected' complete -c cyme -n "__fish_cyme_using_subcommand help; and not __fish_seen_subcommand_from watch help" -f -a "help" -d 'Print this message or the help of the given subcommand(s)' cyme-2.2.6/doc/cyme_example_config.json000066400000000000000000000050021506545537300201250ustar00rootroot00000000000000{ "icons": { "user": { "classifier#02": "îž•", "classifier-sub-protocol#fe:01:01": "", "name#.*^[sS][dD]\\s[cC]ard\\s[rR]eader.*": "", "undefined-classifier": "☶", "unknown-vendor": "", "vid#05ac": "ï…¹", "vid#2e8a": "", "vid-pid#1d50:6018": "", "vid-pid-msb#0483:37": "" }, "tree": { "endpoint_in": "→", "endpoint_out": "â†", "tree-blank": " ", "tree-bus-start": "â—", "tree-configuration-terminator": "•", "tree-corner": "└──", "tree-device-terminator": "â—‹", "tree-disconnected-terminator": "✕", "tree-edge": "├──", "tree-interface-terminator": "â—¦", "tree-line": "│ " } }, "colours": { "name": "bright blue", "serial": "green", "manufacturer": "blue", "driver": "bright magenta", "string": "blue", "icon": null, "location": "magenta", "path": "bright cyan", "number": "cyan", "speed": "magenta", "vid": "bright yellow", "pid": "yellow", "class_code": "bright yellow", "sub_code": "yellow", "protocol": "yellow", "attributes": "magenta", "power": "red", "tree": "bright black", "tree_bus_start": "bright black", "tree_bus_terminator": "bright black", "tree_configuration_terminator": "bright black", "tree_interface_terminator": "bright black", "tree_endpoint_in": "yellow", "tree_endpoint_out": "magenta" }, "blocks": [ "bus-number", "device-number", "icon", "vendor-id", "product-id", "name", "serial", "driver", "speed" ], "bus-blocks": [ "port-path", "name", "host-controller", "host-controller-device" ], "config-blocks": [ "number", "icon-attributes", "max-power", "name" ], "interface-blocks": [ "port-path", "icon", "alt-setting", "base-class", "sub-class", "protocol", "name", "driver" ], "endpoint-blocks": [ "number", "direction", "transfer-type", "sync-type", "usage-type", "max-packet-size" ], "mask-serials": null, "max-variable-string-len": null, "no-auto-width": false, "lsusb": false, "tree": false, "verbose": 0, "more": false, "hide-buses": false, "hide-hubs": false, "list-root-hubs": false, "decimal": false, "no-padding": false, "no-color": false, "ascii": false, "no-icons": false, "headings": false, "force-libusb": false, "print-non-critical-profiler-stderr": false }cyme-2.2.6/examples/000077500000000000000000000000001506545537300143115ustar00rootroot00000000000000cyme-2.2.6/examples/extra_data.rs000066400000000000000000000012401506545537300167700ustar00rootroot00000000000000use cyme::profiler; fn main() -> Result<(), String> { // get all system devices - this time with extra data which contain the Configuration, driver data (with udev) let sp_usb = profiler::get_spusb_with_extra() .map_err(|e| format!("Failed to gather system USB data from libusb, Error({e})"))?; let devices = sp_usb.flattened_devices(); // print all configurations for device in devices { if let Some(extra) = device.extra.as_ref() { println!("Device {} has configurations:", device.name); for c in extra.configurations.iter() { println!("{c:?}"); } }; } Ok(()) } cyme-2.2.6/examples/filter_devices.rs000066400000000000000000000022221506545537300176440ustar00rootroot00000000000000/// This example shows how to use the Filter to filter out devices that match a certain criteria /// /// See [`Filter`] docs for more information use cyme::profiler::{self, Filter}; use cyme::usb::BaseClass; fn main() -> Result<(), String> { // get all system devices let mut sp_usb = profiler::get_spusb() .map_err(|e| format!("Failed to gather system USB data from libusb, Error({e})"))?; // if one does want the tree, use the utility let filter = Filter { class: Some(BaseClass::Hid), ..Default::default() }; // will retain only the buses that have devices that match the filter - parent devices such as hubs with a HID device will be retained filter.retain_buses(&mut sp_usb.buses); sp_usb .buses .retain(|b| b.devices.as_ref().is_some_and(|d| d.is_empty())); // if one does not care about the tree, flatten the devices and do manually // let hid_devices = sp_usb.flatten_devices().iter().filter(|d| d.class == Some(BaseClass::HID)); if sp_usb.buses.is_empty() { println!("No HID devices found"); } else { println!("Found HID devices"); } Ok(()) } cyme-2.2.6/examples/print_devices.rs000066400000000000000000000014471506545537300175230ustar00rootroot00000000000000use cyme::display; use cyme::profiler; fn main() -> Result<(), String> { // get all system devices - use get_spusb_with_extra for verbose info let sp_usb = profiler::get_spusb() .map_err(|e| format!("Failed to gather system USB data from libusb, Error({e})"))?; // flatten since we don't care tree/buses let devices = sp_usb.flattened_devices(); // print with default [`display::PrintSettings`] display::DisplayWriter::default() .print_flattened_devices(&devices, &display::PrintSettings::default()); // alternatively iterate over devices and do something with them for device in devices { if let (Some(0x05ac), Some(_)) = (device.vendor_id, device.product_id) { println!("Found Apple device: {device}"); } } Ok(()) } cyme-2.2.6/examples/walk_sp_data.rs000066400000000000000000000015621506545537300173140ustar00rootroot00000000000000use cyme::profiler::{self, Device}; fn recursive_map_devices(device: &Device) { // the alternate format will print with colour println!("Device: {device:#}"); if let Some(v) = device.devices.as_ref() { for d in v { recursive_map_devices(d) } }; } fn main() -> Result<(), String> { // get all system devices let sp_usb = profiler::get_spusb() .map_err(|e| format!("Failed to gather system USB data from libusb, Error({e})"))?; // SPUSBDataType contains buses... for bus in sp_usb.buses { // which may contain devices... if let Some(devices) = bus.devices { // to walk all the devices, since each device can have devices attached, call a recursive function for device in devices { recursive_map_devices(&device); } } } Ok(()) } cyme-2.2.6/scripts/000077500000000000000000000000001506545537300141625ustar00rootroot00000000000000cyme-2.2.6/scripts/release_version.sh000077500000000000000000000047501506545537300177140ustar00rootroot00000000000000#!/usr/bin/env bash set -euo pipefail VERSION="$(cargo metadata --no-deps --format-version=1 | jq -r '.packages[0].version')" DATE="$(date +%Y-%m-%d)" echo "Preparing release version $VERSION" # Check if the version is already in the changelog if git rev-parse -q --verify "v$VERSION" >/dev/null 2>&1; then echo "Error: git tag v$VERSION already exists! Aborting." exit 1 fi # Change to version and date if Unreleased if ! grep -qE "^## \\[$VERSION\\]" CHANGELOG.md; then if grep -qE "^## \\[Unreleased\\]" CHANGELOG.md; then echo "Renaming [Unreleased] to [$VERSION] - $DATE" sed -i "s/^## \\[Unreleased\\]/## [$VERSION] - $DATE/" CHANGELOG.md else echo "Error: No '## [Unreleased]' or '## [$VERSION]' heading found in CHANGELOG.md." exit 1 fi fi # Extract the changes text for this version CHANGELOG_CONTENT="$( awk "/^## \\[$VERSION\\]/ {found=1; next} /^## \\[/ {found=0} found" CHANGELOG.md )" if [ -z "$(echo "$CHANGELOG_CONTENT" | sed 's/^[[:space:]]*\$//')" ]; then echo "Error: No content found for version $VERSION in CHANGELOG.md!" exit 1 fi echo "Changelog content for version $VERSION:" echo "$CHANGELOG_CONTENT" # Abort if dirty if ! git diff-index --quiet HEAD --; then echo "Error: Working directory is dirty! Please commit or stash your changes before proceeding." exit 1 fi # Ensure on main if ! git rev-parse --abbrev-ref HEAD | grep -q "main"; then echo "Error: Not on main branch! Please switch to the main branch before proceeding." exit 1 fi echo "Creating signed git tag v$VERSION" echo "$CHANGELOG_CONTENT" | git tag -a "v$VERSION" -F - echo "Tag v$VERSION created." # Check to continue read -r -p "Tag v$VERSION created locally. Push tag to origin? [y/N] " answer case "$answer" in [Yy]* ) echo "Pushing tag v$VERSION to origin..." # Ensure the tagged commit is pushed to the remote git push origin git push origin "v$VERSION" ;; * ) echo "Skipping tag push." exit 0 ;; esac read -r -p "Create GitHub release with 'gh release create v$VERSION --notes-from-tag'? [y/N] " answer case "$answer" in [Yy]* ) echo "Creating GitHub release from tag..." gh release create "v$VERSION" --notes-from-tag --verify-tag --title "v$VERSION" ;; * ) echo "Skipping GitHub release creation." ;; esac read -r -p "Publish version $VERSION to crates.io? [y/N] " answer case "$answer" in [Yy]* ) echo "Publishing to crates.io..." cargo publish ;; * ) echo "Skipping crates.io publish." ;; esac cyme-2.2.6/src/000077500000000000000000000000001506545537300132625ustar00rootroot00000000000000cyme-2.2.6/src/colour.rs000066400000000000000000000272561506545537300151470ustar00rootroot00000000000000//! Colouring of cyme output use colored::*; use serde::ser::SerializeSeq; use serde::{Deserialize, Deserializer, Serialize}; use std::fmt; /// Colours [`crate::display::Block`] fields based on loose typing of field type /// /// Considered using HashMap with Colouring Enum like IconTheme but this seemed to suit better, it is less flexible though... #[derive(Debug, Deserialize, Serialize, PartialEq, Eq, Clone)] #[serde(deny_unknown_fields)] pub struct ColourTheme { /// Colour to use for name from descriptor #[serde( default, serialize_with = "color_serializer", deserialize_with = "deserialize_option_color_from_string" )] pub name: Option, /// Colour to use for serial from descriptor #[serde( default, serialize_with = "color_serializer", deserialize_with = "deserialize_option_color_from_string" )] pub serial: Option, /// Colour to use for manufacturer from descriptor #[serde( default, serialize_with = "color_serializer", deserialize_with = "deserialize_option_color_from_string" )] pub manufacturer: Option, /// Colour to use for driver from udev #[serde( default, serialize_with = "color_serializer", deserialize_with = "deserialize_option_color_from_string" )] pub driver: Option, /// Colour to use for general String data #[serde( default, serialize_with = "color_serializer", deserialize_with = "deserialize_option_color_from_string" )] pub string: Option, /// Colour to use for icons #[serde( default, serialize_with = "color_serializer", deserialize_with = "deserialize_option_color_from_string" )] pub icon: Option, /// Colour to use for location data #[serde( default, serialize_with = "color_serializer", deserialize_with = "deserialize_option_color_from_string" )] pub location: Option, /// Colour to use for path data #[serde( default, serialize_with = "color_serializer", deserialize_with = "deserialize_option_color_from_string" )] pub path: Option, /// Colour to use for general number values #[serde( default, serialize_with = "color_serializer", deserialize_with = "deserialize_option_color_from_string" )] pub number: Option, /// Colour to use for speed #[serde( default, serialize_with = "color_serializer", deserialize_with = "deserialize_option_color_from_string" )] pub speed: Option, /// Colour to use for Vendor ID #[serde( default, serialize_with = "color_serializer", deserialize_with = "deserialize_option_color_from_string" )] pub vid: Option, /// Colour to use for Product ID #[serde( default, serialize_with = "color_serializer", deserialize_with = "deserialize_option_color_from_string" )] pub pid: Option, /// Colour to use for generic BaseClass #[serde( default, serialize_with = "color_serializer", deserialize_with = "deserialize_option_color_from_string" )] pub class_code: Option, /// Colour to use for SubCodes #[serde( default, serialize_with = "color_serializer", deserialize_with = "deserialize_option_color_from_string" )] pub sub_code: Option, /// Colour to use for protocol #[serde( default, serialize_with = "color_serializer", deserialize_with = "deserialize_option_color_from_string" )] pub protocol: Option, /// Colour to use for info/enum type #[serde( default, serialize_with = "color_serializer", deserialize_with = "deserialize_option_color_from_string" )] pub attributes: Option, /// Colour to use for power information #[serde( default, serialize_with = "color_serializer", deserialize_with = "deserialize_option_color_from_string" )] pub power: Option, /// Tree colour #[serde( default, serialize_with = "color_serializer", deserialize_with = "deserialize_option_color_from_string" )] pub tree: Option, /// Colour at prepended before printing `Bus` #[serde( default, serialize_with = "color_serializer", deserialize_with = "deserialize_option_color_from_string" )] pub tree_bus_start: Option, /// Colour printed at end of tree before printing `Device` #[serde( default, serialize_with = "color_serializer", deserialize_with = "deserialize_option_color_from_string" )] pub tree_bus_terminator: Option, /// Colour printed at end of tree before printing configuration #[serde( default, serialize_with = "color_serializer", deserialize_with = "deserialize_option_color_from_string" )] pub tree_configuration_terminator: Option, /// Colour printed at end of tree before printing interface #[serde( default, serialize_with = "color_serializer", deserialize_with = "deserialize_option_color_from_string" )] pub tree_interface_terminator: Option, /// Colour for endpoint in before print #[serde( default, serialize_with = "color_serializer", deserialize_with = "deserialize_option_color_from_string" )] pub tree_endpoint_in: Option, /// Colour for endpoint out before print #[serde( default, serialize_with = "color_serializer", deserialize_with = "deserialize_option_color_from_string" )] pub tree_endpoint_out: Option, } fn deserialize_option_color_from_string<'de, D>(deserializer: D) -> Result, D::Error> where D: Deserializer<'de>, { #[derive(Deserialize)] #[serde(untagged)] enum ColorOrNull<'a> { Str(&'a str), #[serde(deserialize_with = "deserialize_color")] FromStr(Color), Null, } match ColorOrNull::deserialize(deserializer)? { ColorOrNull::Str(s) => match s { "" => Ok(None), _ => Ok(Some(Color::from(s))), }, ColorOrNull::FromStr(i) => Ok(Some(i)), ColorOrNull::Null => Ok(None), } } // Custom color deserialize, adapted from: https://github.com/Peltoche/lsd/blob/master/src/theme/color.rs fn deserialize_color<'de, D>(deserializer: D) -> Result where D: serde::de::Deserializer<'de>, { struct ColorVisitor; impl<'de> serde::de::Visitor<'de> for ColorVisitor { type Value = Color; fn expecting(&self, formatter: &mut fmt::Formatter) -> fmt::Result { formatter.write_str("colour string or `3 u8 RGB array`") } fn visit_str(self, value: &str) -> Result where E: serde::de::Error, { Ok(Color::from(value)) } fn visit_seq(self, mut seq: M) -> Result where M: serde::de::SeqAccess<'de>, { let mut values = Vec::new(); if let Some(size) = seq.size_hint() { if size != 3 { return Err(serde::de::Error::invalid_length( size, &"a list of size 3(RGB)", )); } } loop { match seq.next_element::() { Ok(Some(x)) => { values.push(x); } Ok(None) => break, Err(e) => { return Err(e); } } } // recheck as size_hint sometimes not working if values.len() != 3 { return Err(serde::de::Error::invalid_length( values.len(), &"A u8 list of size 3: [R, G, B]", )); } Ok(Color::TrueColor { r: values[0], g: values[1], b: values[2], }) } } deserializer.deserialize_any(ColorVisitor) } fn color_to_string(color: Color) -> String { match color { Color::Black => "black".into(), Color::Red => "red".into(), Color::Green => "green".into(), Color::Yellow => "yellow".into(), Color::Blue => "blue".into(), Color::Magenta => "magenta".into(), Color::Cyan => "cyan".into(), Color::White => "white".into(), Color::BrightBlack => "bright black".into(), Color::BrightRed => "bright red".into(), Color::BrightGreen => "bright green".into(), Color::BrightYellow => "bright yellow".into(), Color::BrightBlue => "bright blue".into(), Color::BrightMagenta => "bright magenta".into(), Color::BrightCyan => "bright cyan".into(), Color::BrightWhite => "bright white".into(), Color::TrueColor { r, g, b } => format!("[{r}, {g}, {b}]"), } } /// Have to make this because external crate does not impl Display fn color_serializer(color: &Option, s: S) -> Result where S: serde::ser::Serializer, { match color { Some(c) => match c { Color::TrueColor { r, g, b } => { let mut seq = s.serialize_seq(Some(3))?; seq.serialize_element(r)?; seq.serialize_element(g)?; seq.serialize_element(b)?; seq.end() } _ => s.serialize_str(&color_to_string(*c)), }, None => s.serialize_none(), } } impl Default for ColourTheme { fn default() -> Self { ColourTheme::new() } } impl ColourTheme { /// New theme with defaults pub fn new() -> Self { ColourTheme { name: Some(Color::BrightBlue), serial: Some(Color::Green), manufacturer: Some(Color::Blue), driver: Some(Color::BrightMagenta), string: Some(Color::Blue), icon: None, location: Some(Color::Magenta), path: Some(Color::BrightCyan), number: Some(Color::Cyan), speed: Some(Color::Magenta), vid: Some(Color::BrightYellow), pid: Some(Color::Yellow), class_code: Some(Color::BrightYellow), sub_code: Some(Color::Yellow), protocol: Some(Color::Yellow), attributes: Some(Color::Magenta), power: Some(Color::Red), tree: Some(Color::BrightBlack), tree_bus_start: Some(Color::BrightBlack), tree_bus_terminator: Some(Color::BrightBlack), tree_configuration_terminator: Some(Color::BrightBlack), tree_interface_terminator: Some(Color::BrightBlack), tree_endpoint_in: Some(Color::Yellow), tree_endpoint_out: Some(Color::Magenta), } } } #[cfg(test)] mod tests { use super::*; #[test] fn test_serialize_color_theme() { let ct: ColourTheme = ColourTheme::new(); println!("{}", serde_json::to_string_pretty(&ct).unwrap()); } #[test] fn test_deserialize_color_theme() { let ct: ColourTheme = serde_json::from_str(r#"{"name": "blue"}"#).unwrap(); assert_eq!(ct.name, Some(Color::Blue)); } #[test] fn test_serialize_deserialize_color_theme() { let ct: ColourTheme = ColourTheme::new(); let ser = serde_json::to_string_pretty(&ct).unwrap(); let ctrt: ColourTheme = serde_json::from_str(&ser).unwrap(); assert_eq!(ct, ctrt); } } cyme-2.2.6/src/config.rs000066400000000000000000000254761506545537300151130ustar00rootroot00000000000000//! Config for cyme binary use serde::{Deserialize, Serialize}; use std::fs::File; use std::io::BufReader; use std::path::{Path, PathBuf}; use crate::colour; use crate::display; use crate::display::Block; use crate::error::{Error, ErrorKind, Result}; use crate::icon; const CONF_DIR: &str = "cyme"; const CONF_NAME: &str = "cyme.json"; /// Allows user supplied icons to replace or add to `DEFAULT_ICONS` and `DEFAULT_TREE` #[derive(Debug, Default, Serialize, Deserialize, PartialEq, Eq)] #[serde(rename_all = "kebab-case", deny_unknown_fields, default)] pub struct Config { #[serde(skip)] filepath: Option, /// User supplied [`crate::icon::IconTheme`] - will merge with default pub icons: icon::IconTheme, /// User supplied [`crate::colour::ColourTheme`] - overrides default pub colours: colour::ColourTheme, /// Default [`crate::display::DeviceBlocks`] to use for displaying devices pub blocks: Option>, /// Default [`crate::display::BusBlocks`] to use for displaying buses pub bus_blocks: Option>, /// Default [`crate::display::ConfigurationBlocks`] to use for device configurations pub config_blocks: Option>, /// Default [`crate::display::InterfaceBlocks`] to use for device interfaces pub interface_blocks: Option>, /// Default [`crate::display::EndpointBlocks`] to use for device endpoints pub endpoint_blocks: Option>, /// Whether to hide device serial numbers by default pub mask_serials: Option, /// Max variable string length to display before truncating - descriptors and classes for example pub max_variable_string_len: Option, /// Disable auto generation of max_variable_string_len based on terminal width pub no_auto_width: bool, // non-Options copied from Args /// Attempt to maintain compatibility with lsusb output pub lsusb: bool, /// Dump USB device hierarchy as a tree pub tree: bool, /// Verbosity level: 1 prints device configurations; 2 prints interfaces; 3 prints interface endpoints; 4 prints everything and all blocks pub verbose: u8, /// Print more blocks by default at each verbosity pub more: bool, /// Hide empty buses when printing tree; those with no devices. pub hide_buses: bool, /// Hide empty hubs when printing tree; those with no devices. When listing will hide hubs regardless of whether empty of not pub hide_hubs: bool, /// Show root hubs when listing; Linux only pub list_root_hubs: bool, /// Show base16 values as base10 decimal instead pub decimal: bool, /// Disable padding to align blocks pub no_padding: bool, /// Disable color pub no_color: bool, /// Disables icons and utf-8 characters pub ascii: bool, /// Disables all [`display::Block`] icons pub no_icons: bool, /// Show block headings pub headings: bool, /// Force nusb/libusb profiler on macOS rather than using/combining system_profiler output pub force_libusb: bool, /// Print non-critical errors (normally due to permissions) during USB profiler to stderr pub print_non_critical_profiler_stderr: bool, } impl Config { /// New based on defaults pub fn new() -> Self { Default::default() } /// From system config if exists else default #[cfg(not(debug_assertions))] pub fn sys() -> Result { if let Some(p) = Self::config_file_path() { let path = p.join(CONF_NAME); log::info!("Looking for system config {:?}", &path); return match Self::from_file(&path) { Ok(c) => { log::info!("Loaded system config {:?}", c); Ok(c) } Err(e) => { // if parsing error, print issue but use default // IO error (unable to read) will raise as error if e.kind() == ErrorKind::Parsing { log::warn!("{}", e); Err(e) } else { Ok(Self::new()) } } }; } else { Ok(Self::new()) } } /// Use default if running in debug since the integration tests use this #[cfg(debug_assertions)] pub fn sys() -> Result { log::warn!("Running in debug, not checking for system config"); Ok(Self::new()) } /// Get example [`Config`] pub fn example() -> Self { Config { icons: icon::example_theme(), blocks: Some(display::DeviceBlocks::example_blocks()), bus_blocks: Some(display::BusBlocks::example_blocks()), config_blocks: Some(display::ConfigurationBlocks::example_blocks()), interface_blocks: Some(display::InterfaceBlocks::example_blocks()), endpoint_blocks: Some(display::EndpointBlocks::example_blocks()), ..Default::default() } } /// Attempt to read from .json format confg at `file_path` pub fn from_file>(file_path: P) -> Result { let f = File::open(&file_path)?; let mut config: Self = serde_json::from_reader(BufReader::new(f)).map_err(|e| { Error::new( ErrorKind::Parsing, &format!( "Failed to parse config at {:?}; Error({})", file_path.as_ref(), e ), ) })?; // set the file path we loaded from for saving config.filepath = Some(file_path.as_ref().to_path_buf()); Ok(config) } /// This provides the path for a configuration file, specific to OS /// return None if error like PermissionDenied pub fn config_file_path() -> Option { dirs::config_dir().map(|x| x.join(CONF_DIR)) } /// Get the file path for the config pub fn filepath(&self) -> Option<&Path> { self.filepath.as_deref() } /// Save the current config to a file pub fn save_file>(&self, path: P) -> Result<()> { log::info!("Saving config to {:?}", path.as_ref().display()); // create parent folders if let Some(parent) = path.as_ref().parent() { log::debug!("Creating parent folders for {:?}", parent.display()); std::fs::create_dir_all(parent)?; } let f = File::create(&path)?; serde_json::to_writer_pretty(f, self) .map_err(|e| Error::new(ErrorKind::Io, &format!("Failed to save config: Error({e})"))) } /// Save the current config to the file it was loaded from or default location if None pub fn save(&self) -> Result<()> { if let Some(p) = self.filepath() { self.save_file(p) } else if let Some(p) = Self::config_file_path() { self.save_file(p.join(CONF_NAME)) } else { Err(Error::new( ErrorKind::Io, "Unable to determine config file path", )) } } /// Merge the settings from a [`display::PrintSettings`] into the config /// /// Dynamic settings and those loaded from config such as [`icon::IconTheme`] and [`color::ColourTheme`] are not merged pub fn merge_print_settings(&mut self, settings: &display::PrintSettings) { self.blocks = settings.device_blocks.clone(); self.bus_blocks = settings.bus_blocks.clone(); self.config_blocks = settings.config_blocks.clone(); self.interface_blocks = settings.interface_blocks.clone(); self.endpoint_blocks = settings.endpoint_blocks.clone(); self.more = settings.more; self.decimal = settings.decimal; self.mask_serials = settings.mask_serials.clone(); self.no_padding = settings.no_padding; self.headings = settings.headings; self.tree = settings.tree; self.max_variable_string_len = settings.max_variable_string_len; self.no_auto_width = !settings.auto_width; self.no_icons = matches!(settings.icon_when, display::IconWhen::Never) || !matches!(settings.encoding, display::Encoding::Glyphs); self.ascii = matches!(settings.encoding, display::Encoding::Ascii); self.verbose = settings.verbosity; } /// Returns a [`display::PrintSettings`] based on the config pub fn print_settings(&self, encoding: Option) -> display::PrintSettings { let colours = if self.no_color { None } else { Some(self.colours.clone()) }; let icons = if self.no_icons { None } else { Some(self.icons.clone()) }; let encoding = encoding.unwrap_or({ if self.ascii { display::Encoding::Ascii } else if self.no_icons { display::Encoding::Utf8 } else { display::Encoding::Glyphs } }); display::PrintSettings { device_blocks: self.blocks.clone(), bus_blocks: self.bus_blocks.clone(), config_blocks: self.config_blocks.clone(), interface_blocks: self.interface_blocks.clone(), endpoint_blocks: self.endpoint_blocks.clone(), more: self.more, decimal: self.decimal, mask_serials: self.mask_serials.clone(), no_padding: self.no_padding, headings: self.headings, tree: self.tree, max_variable_string_len: self.max_variable_string_len, auto_width: !self.no_auto_width, icon_when: if self.no_icons { display::IconWhen::Never } else { display::IconWhen::Auto }, encoding, icons, colours, verbosity: self.verbose, ..Default::default() } } } #[cfg(test)] mod tests { use super::*; #[test] #[cfg(feature = "regex_icon")] fn test_deserialize_example_file() { let path = PathBuf::from("./doc").join("cyme_example_config.json"); assert!(Config::from_file(path).is_ok()); } #[test] fn test_deserialize_config_no_theme() { let path = PathBuf::from("./tests/data").join("config_no_theme.json"); assert!(Config::from_file(path).is_ok()); } #[test] fn test_deserialize_config_missing_args() { let path = PathBuf::from("./tests/data").join("config_missing_args.json"); assert!(Config::from_file(path).is_ok()); } #[test] fn test_save_config() { // save to temp file let path = PathBuf::from("./tests/data").join("config_save.json"); let c = Config::new(); assert!(c.save_file(&path).is_ok()); assert!(Config::from_file(path).is_ok()); } } cyme-2.2.6/src/display.rs000066400000000000000000003726531506545537300153150ustar00rootroot00000000000000//! Provides the main utilities to display USB types within this crate - primarily used by `cyme` binary. //! //! TODO: There is some repeat code that could probably be made into functions/generics use clap::ValueEnum; use colored::*; use fastrand; use itertools::Itertools; use serde::{Deserialize, Serialize}; use std::cmp; use std::collections::HashMap; use std::hash::Hash; use std::io::{self, Write}; use strum::{IntoEnumIterator, VariantArray}; use strum_macros::{Display, EnumIter, VariantArray}; use unicode_width::UnicodeWidthStr; use crate::colour; use crate::error::Result; use crate::icon; use crate::profiler::{Bus, Device, Filter, SystemProfile}; use crate::types::NumericalUnit; use crate::usb::{ path::ConfigurationPath, path::DevicePath, path::EndpointPath, path::PortPath, ConfigAttributes, Configuration, DeviceExtra, Direction, Endpoint, Interface, }; const ICON_HEADING: &str = "I"; const DEFAULT_AUTO_WIDTH: u16 = 80; // default terminal width to scale if None returned for size const MIN_VARIABLE_STRING_LEN: usize = 5; // minimum variable string length to scale to const LIST_INSET_SPACES: u8 = 2; // number of spaces for non-tree inset /// Colouring control for the output #[derive(Copy, Clone, PartialEq, Eq, Debug, Serialize, Deserialize, ValueEnum, Default)] #[serde(rename_all = "kebab-case")] pub enum ColorWhen { /// Show colours if the output goes to an interactive console #[default] Auto, /// Always apply colouring to the output Always, /// Never apply colouring to the output Never, } impl std::fmt::Display for ColorWhen { fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result { write!(f, "{self:?}") } } /// Icon control for the output #[derive(Copy, Clone, PartialEq, Eq, Debug, Serialize, Deserialize, ValueEnum, Default)] #[serde(rename_all = "kebab-case")] pub enum IconWhen { /// Show icon blocks if the [`Encoding`] supports icons matched in the [`icon::IconTheme`] #[default] Auto, /// Always print icon blocks if included in configured blocks Always, /// Never print icon blocks Never, } impl std::fmt::Display for IconWhen { fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result { write!(f, "{self:?}") } } impl IconWhen { fn retain_ref( &self, devices: &[&T], blocks: &mut Vec>, settings: &PrintSettings, ) { match self { IconWhen::Never => { blocks.retain(|b| !b.is_icon()); } IconWhen::Auto => { let valid_icons = devices .iter() // all must be valid to avoid tofu chars .all(|d| has_valid_icons(*d, blocks, settings)); if settings.icons.is_none() || !valid_icons { log::debug!("{:?} removing icon blocks", settings.icon_when); blocks.retain(|b| !b.is_icon()); } } IconWhen::Always => { if settings.icons.is_none() { log::warn!( "{:?} blocks requested but no icons provided", settings.icon_when ); } } } } fn retain( &self, devices: &[T], blocks: &mut Vec>, settings: &PrintSettings, ) { match self { IconWhen::Never => { blocks.retain(|b| !b.is_icon()); } IconWhen::Auto => { let valid_icons = devices .iter() // all must be valid to avoid tofu chars .all(|d| has_valid_icons(d, blocks, settings)); if settings.icons.is_none() || !valid_icons { log::debug!("{:?} removing icon blocks", settings.icon_when); blocks.retain(|b| !b.is_icon()); } } IconWhen::Always => { if settings.icons.is_none() { log::warn!( "{:?} blocks requested but no icons provided", settings.icon_when ); } } } } } /// Character encoding control for the output #[derive(Copy, Clone, PartialEq, Eq, Debug, Serialize, Deserialize, ValueEnum, Default)] #[serde(rename_all = "kebab-case")] pub enum Encoding { /// Use UTF-8 private use area characters such as those used by NerdFont to show glyph icons #[default] Glyphs, /// Use only standard UTF-8 characters for the output; no private use area glyph icons Utf8, /// Use only ASCII characters for the output; 0x00 - 0x7F (127 chars) Ascii, } impl std::fmt::Display for Encoding { fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result { write!(f, "{self:?}") } } impl Encoding { /// Returns if a char is valid for the encoding for not /// /// ``` /// use cyme::display::Encoding; /// /// let enc = Encoding::Ascii; /// assert!(enc.char_is_valid('I')); /// assert!(!enc.char_is_valid('\u{2000}')); /// assert!(!enc.char_is_valid('â—')); /// /// let enc = Encoding::Utf8; /// assert!(enc.char_is_valid('I')); /// assert!(enc.char_is_valid('\u{2000}')); /// assert!(enc.char_is_valid('â—')); /// assert!(!enc.char_is_valid('\u{e001}')); /// assert!(!enc.char_is_valid('ï…¼')); /// /// let enc = Encoding::Glyphs; /// assert!(enc.char_is_valid('I')); /// assert!(enc.char_is_valid('\u{2000}')); /// assert!(enc.char_is_valid('\u{f287}')); /// assert!(enc.char_is_valid('\u{e001}')); /// assert!(enc.char_is_valid('ï…¼')); /// ``` pub fn char_is_valid(&self, c: char) -> bool { match self { Encoding::Ascii if !c.is_ascii() => false, // not inside private use area Encoding::Utf8 => !matches!(c, '\u{E000}'..='\u{F8FF}' | '\u{F0000}'..='\u{FFFFD}' | '\u{100000}'..='\u{10FFFD}'), _ => true, } } /// Returns if a str is valid for the encoding for not /// /// ``` /// use cyme::display::Encoding; /// /// let enc = Encoding::Ascii; /// assert!(enc.str_is_valid("hello world")); /// assert!(!enc.str_is_valid("├──")); // utf-8 tree /// assert!(!enc.str_is_valid("chip ï‹›")); /// /// let enc = Encoding::Utf8; /// assert!(enc.str_is_valid("hello world")); /// assert!(enc.str_is_valid("├──")); // utf-8 tree /// assert!(!enc.str_is_valid("chip ï‹›")); /// /// let enc = Encoding::Glyphs; /// assert!(enc.str_is_valid("hello world")); /// assert!(enc.str_is_valid("├──")); // utf-8 tree /// assert!(enc.str_is_valid("chip ï‹›")); /// ``` pub fn str_is_valid(&self, s: &str) -> bool { s.chars().all(|c| self.char_is_valid(c)) } } /// Info that can be printed about a [`Device`] #[non_exhaustive] #[derive( Debug, EnumIter, VariantArray, ValueEnum, Display, Copy, Eq, PartialEq, Ord, PartialOrd, Clone, Hash, Serialize, Deserialize, )] #[serde(rename_all = "kebab-case")] pub enum DeviceBlocks { /// Number of bus device is attached BusNumber, /// Bus issued device number DeviceNumber, /// Position of device in parent branch BranchPosition, /// Linux style port path PortPath, /// Linux udev reported syspath SysPath, /// Linux udev reported driver loaded for device Driver, /// Icon based on VID/PID Icon, /// Unique vendor identifier - purchased from USB IF VendorId, /// Vendor unique product identifier ProductId, /// Unique vendor identifier and product identifier as a string formatted "vid:pid" like lsusb VidPid, /// The device name as reported in descriptor or using usb_ids if None Name, /// The device manufacturer as provided in descriptor or using usb_ids if None Manufacturer, /// The device product name as reported by usb_ids vidpid lookup ProductName, /// The device vendor name as reported by usb_ids vid lookup VendorName, /// Device serial string as reported by descriptor Serial, /// Advertised device capable speed Speed, /// Negotiated device speed as connected NegotiatedSpeed, /// Position along all branches back to trunk device TreePositions, /// macOS system_profiler only - actually bus current in mA not power! BusPower, /// macOS system_profiler only - actually bus current used in mA not power! BusPowerUsed, /// macOS system_profiler only - actually bus current used in mA not power! ExtraCurrentUsed, /// The device version BcdDevice, /// The supported USB version BcdUsb, /// Base class enum of interface provided by USB IF - only available when using libusb #[serde(alias = "class-code")] // was called ClassCode in previous versions BaseClass, /// Sub-class value of interface provided by USB IF - only available when using libusb SubClass, /// Prototol value for interface provided by USB IF - only available when using libusb Protocol, /// Class name from USB IDs repository UidClass, /// Sub-class name from USB IDs repository UidSubClass, /// Protocol name from USB IDs repository UidProtocol, /// Fully defined USB Class Code enum based on BaseClass/SubClass/Protocol triplet Class, /// Base class as number value rather than enum #[serde(alias = "class-value")] // was called ClassCode in previous versions BaseValue, /// Last time device was seen LastEvent, /// Event icon EventIcon, } /// Info that can be printed about a [`Bus`] #[non_exhaustive] #[derive( Debug, Copy, EnumIter, VariantArray, ValueEnum, Display, Eq, PartialEq, Ord, PartialOrd, Hash, Clone, Serialize, Deserialize, )] #[serde(rename_all = "kebab-case")] pub enum BusBlocks { /// System bus number identifier BusNumber, /// Icon based on VID/PID Icon, /// System internal bus name based on Root Hub device name Name, /// System internal bus provider name HostController, /// Vendor name of PCI Host Controller from pci.ids HostControllerVendor, /// Device name of PCI Host Controller from pci.ids HostControllerDevice, /// PCI vendor ID (VID) PciVendor, /// PCI device ID (PID) PciDevice, /// PCI Revsision ID PciRevision, /// syspath style port path to bus, applicable to Linux only PortPath, } /// Info that can be printed about a [`Configuration`] #[non_exhaustive] #[derive( Debug, Copy, EnumIter, VariantArray, ValueEnum, Display, Eq, PartialEq, Hash, Clone, Serialize, Deserialize, )] #[serde(rename_all = "kebab-case")] pub enum ConfigurationBlocks { /// Name from string descriptor Name, /// Number of config, bConfigurationValue; value to set to enable to configuration Number, /// Interfaces available for this configuruation NumInterfaces, /// Attributes of configuration, bmAttributes Attributes, /// Icon representation of bmAttributes IconAttributes, /// Maximum current consumption in mA MaxPower, } /// Info that can be printed about a [`Interface`] #[non_exhaustive] #[derive( Debug, Copy, EnumIter, VariantArray, ValueEnum, Display, Eq, PartialEq, Hash, Clone, Serialize, Deserialize, )] #[serde(rename_all = "kebab-case")] pub enum InterfaceBlocks { /// Name from string descriptor Name, /// Interface number Number, /// Interface port path, applicable to Linux PortPath, /// Base class enum of interface provided by USB IF #[serde(alias = "class-code")] // was called ClassCode in previous versions BaseClass, /// Sub-class value of interface provided by USB IF SubClass, /// Prototol value for interface provided by USB IF Protocol, /// Interfaces can have the same number but an alternate settings defined here AltSetting, /// Driver obtained from udev on Linux only Driver, /// syspath obtained from udev on Linux only SysPath, /// An interface can have many endpoints NumEndpoints, /// Icon based on BaseClass/SubCode/Protocol Icon, /// Class name from USB IDs repository UidClass, /// Sub-class name from USB IDs repository UidSubClass, /// Protocol name from USB IDs repository UidProtocol, /// Fully defined USB Class Code based on BaseClass/SubClass/Protocol triplet Class, /// Base class as number value rather than enum #[serde(alias = "class-value")] BaseValue, } /// Info that can be printed about a [`Endpoint`] #[non_exhaustive] #[derive( Debug, Copy, EnumIter, VariantArray, ValueEnum, Display, Eq, PartialEq, Hash, Clone, Serialize, Deserialize, )] #[serde(rename_all = "kebab-case")] pub enum EndpointBlocks { /// Endpoint number on interface Number, /// Direction of data into endpoint Direction, /// Type of data transfer endpoint accepts TransferType, /// Synchronisation type (Iso mode) SyncType, /// Usage type (Iso mode) UsageType, /// Maximum packet size in bytes endpoint can send/recieve MaxPacketSize, /// Interval for polling endpoint data transfers. Value in frame counts. Ignored for Bulk & Control Endpoints. Isochronous must equal 1 and field may range from 1 to 255 for interrupt endpoints. Interval, } /// Length of field printed by block #[derive(Debug, Eq, PartialEq)] pub enum BlockLength { /// Fixed length like numbers with padding Fixed(usize), /// Variable length such as string descriptors - contained value is the heading (min) length Variable(usize), } impl BlockLength { /// Get the length contained in Enum pub fn len(self) -> usize { match self { BlockLength::Fixed(s) => s, BlockLength::Variable(s) => s, } } /// Is the length zero pub fn is_empty(self) -> bool { match self { BlockLength::Fixed(s) => s == 0, BlockLength::Variable(s) => s == 0, } } /// Get the fixed length if `[BlockLength::Fixed]` else None pub fn fixed_len(self) -> Option { match self { BlockLength::Fixed(s) => Some(s), _ => None, } } /// Get the variable length if `[BlockLength::Variable]` else None pub fn variable_len(self) -> Option { match self { BlockLength::Variable(s) => Some(s), _ => None, } } } /// Helper trait to allow for generic block handling pub trait BlockEnum: Eq + Hash + VariantArray + ValueEnum {} impl BlockEnum for DeviceBlocks {} impl BlockEnum for BusBlocks {} impl BlockEnum for ConfigurationBlocks {} impl BlockEnum for InterfaceBlocks {} impl BlockEnum for EndpointBlocks {} /// Intended to be `impl` by a xxxBlocks `enum` pub trait Block { /// The inset when printing non-tree as a list const INSET: u8 = 0; /// List of default blocks to use for printing T with optional `verbose` for maximum verbosity fn default_blocks(verbose: bool) -> Vec where Self: Sized; /// Example blocks for generated files fn example_blocks() -> Vec where Self: Sized, { Self::default_blocks(false) } /// Returns the length of block value given device data - like block_length but actual device field length rather than fixed/heading fn len(&self, d: &[&T]) -> usize; /// Returns length type and usize contained, [`BlockLength::Variable`] will be heading usize without actual device data fn block_length(&self) -> BlockLength; /// Creates a HashMap of B keys to usize of longest value for that key in the `d` Vec or heading if > this; values can then be padded to match this fn generate_padding(d: &[&T]) -> HashMap; /// Colour the block String fn colour(&self, s: &str, ct: &colour::ColourTheme) -> ColoredString; /// Creates the heading for the block value, for use with the heading flag fn heading(&self) -> &str; /// Pads the heading with provided padding block HashMap fn heading_padded(&self, pad: &HashMap) -> String; /// Returns whether the value intended for the block is a variable length type (string descriptor) fn value_is_variable_length(&self) -> bool { match self.block_length() { BlockLength::Fixed(_) => false, BlockLength::Variable(_) => true, } } /// Formats the value associated with the block into a display String fn format_value( &self, d: &T, pad: &HashMap, settings: &PrintSettings, ) -> Option; /// Formats u16 values like VID as base16 or base10 depending on decimal setting fn format_base_u16(v: u16, settings: &PrintSettings) -> String { if settings.decimal { // pad 6 not 5 to maintian 0x padding format!("{v:6}") } else { format!("0x{v:04x}") } } /// Formats u8 values like codes as base16 or base10 depending on decimal setting fn format_base_u8(v: u8, settings: &PrintSettings) -> String { if settings.decimal { format!("{v:4}") } else { format!("0x{v:02x}") } } /// Formats VID and PID values into a string like "vid:pid" with padding fn format_vidpid(v: Option, p: Option, settings: &PrintSettings) -> String { match (v, p) { (Some(v), Some(p)) => { if settings.decimal { format!("{v:>5}:{p:<5}") } else { format!(" {v:04x}:{p:04x} ") } } _ => format!("{:>5}:{:<5}", "-", "-"), } } /// If the block is used for icons fn is_icon(&self) -> bool { false } /// Get static array of all blocks for this type fn all_blocks() -> &'static [B] where Self: Sized, { B::VARIANTS } } impl DeviceBlocks { /// Default `DeviceBlocks` for watch mode printing pub fn default_watch_blocks(verbose: bool, tree: bool) -> Vec { let mut blocks = if tree { Self::default_device_tree_blocks() } else { Self::default_blocks(verbose) }; blocks.push(DeviceBlocks::EventIcon); blocks.push(DeviceBlocks::LastEvent); blocks } /// Default `DeviceBlocks` for tree printing are different to list, get them here pub fn default_device_tree_blocks() -> Vec { #[cfg(target_os = "linux")] { vec![ DeviceBlocks::Icon, DeviceBlocks::BranchPosition, DeviceBlocks::DeviceNumber, DeviceBlocks::VendorId, DeviceBlocks::ProductId, DeviceBlocks::Name, DeviceBlocks::Serial, DeviceBlocks::Driver, ] } #[cfg(not(target_os = "linux"))] { vec![ DeviceBlocks::Icon, DeviceBlocks::BranchPosition, DeviceBlocks::DeviceNumber, DeviceBlocks::VendorId, DeviceBlocks::ProductId, DeviceBlocks::Name, DeviceBlocks::Serial, ] } } } impl Block for DeviceBlocks { #[cfg(target_os = "linux")] fn default_blocks(verbose: bool) -> Vec { if verbose { vec![ DeviceBlocks::BusNumber, DeviceBlocks::DeviceNumber, DeviceBlocks::TreePositions, DeviceBlocks::PortPath, DeviceBlocks::Icon, DeviceBlocks::VendorId, DeviceBlocks::ProductId, DeviceBlocks::BcdDevice, DeviceBlocks::BcdUsb, DeviceBlocks::BaseValue, DeviceBlocks::BaseClass, DeviceBlocks::SubClass, DeviceBlocks::UidSubClass, DeviceBlocks::Protocol, DeviceBlocks::UidProtocol, DeviceBlocks::Name, DeviceBlocks::Manufacturer, DeviceBlocks::Serial, DeviceBlocks::Driver, DeviceBlocks::SysPath, DeviceBlocks::Speed, ] } else { vec![ DeviceBlocks::BusNumber, DeviceBlocks::DeviceNumber, DeviceBlocks::Icon, DeviceBlocks::VendorId, DeviceBlocks::ProductId, DeviceBlocks::Name, DeviceBlocks::Serial, DeviceBlocks::Driver, DeviceBlocks::Speed, ] } } #[cfg(not(target_os = "linux"))] fn default_blocks(verbose: bool) -> Vec { if verbose { vec![ DeviceBlocks::BusNumber, DeviceBlocks::DeviceNumber, DeviceBlocks::TreePositions, DeviceBlocks::PortPath, DeviceBlocks::Icon, DeviceBlocks::VendorId, DeviceBlocks::ProductId, DeviceBlocks::BcdDevice, DeviceBlocks::BcdUsb, DeviceBlocks::BaseValue, DeviceBlocks::BaseClass, DeviceBlocks::SubClass, DeviceBlocks::UidSubClass, DeviceBlocks::Protocol, DeviceBlocks::UidProtocol, DeviceBlocks::Name, DeviceBlocks::Manufacturer, DeviceBlocks::Serial, DeviceBlocks::Speed, ] } else { vec![ DeviceBlocks::BusNumber, DeviceBlocks::DeviceNumber, DeviceBlocks::Icon, DeviceBlocks::VendorId, DeviceBlocks::ProductId, DeviceBlocks::Name, DeviceBlocks::Serial, DeviceBlocks::Speed, ] } } fn example_blocks() -> Vec { vec![ DeviceBlocks::BusNumber, DeviceBlocks::DeviceNumber, DeviceBlocks::Icon, DeviceBlocks::VendorId, DeviceBlocks::ProductId, DeviceBlocks::Name, DeviceBlocks::Serial, DeviceBlocks::Driver, DeviceBlocks::Speed, ] } fn len(&self, d: &[&Device]) -> usize { match self { DeviceBlocks::Name => d.iter().map(|d| d.name.width()).max().unwrap_or(0), DeviceBlocks::Serial => d .iter() .flat_map(|d| d.serial_num.as_ref().map(|s| s.width())) .max() .unwrap_or(0), DeviceBlocks::Manufacturer => d .iter() .flat_map(|d| d.manufacturer.as_ref().map(|s| s.width())) .max() .unwrap_or(0), DeviceBlocks::TreePositions => d .iter() .map(|d| d.location_id.tree_positions.len() * 2) .max() .unwrap_or(0), DeviceBlocks::PortPath => d .iter() // byte len ok as I know it's all ascii .map(|d| d.port_path().to_string().len()) .max() .unwrap_or(0), DeviceBlocks::SysPath => d .iter() .flat_map(|d| { d.extra .as_ref() .and_then(|e| e.syspath.as_ref().map(|s| s.len())) }) .max() .unwrap_or(0), DeviceBlocks::Driver => d .iter() .flat_map(|d| { d.extra .as_ref() .and_then(|e| e.driver.as_ref().map(|s| s.len())) }) .max() .unwrap_or(0), DeviceBlocks::ProductName => d .iter() .flat_map(|d| { d.extra .as_ref() .and_then(|e| e.product_name.as_ref().map(|s| s.width())) }) .max() .unwrap_or(0), DeviceBlocks::VendorName => d .iter() .flat_map(|d| { d.extra .as_ref() .and_then(|e| e.vendor.as_ref().map(|s| s.width())) }) .max() .unwrap_or(0), DeviceBlocks::BaseClass => d .iter() .flat_map(|d| d.class.as_ref().map(|c| c.to_string().len())) .max() .unwrap_or(0), DeviceBlocks::UidClass => d .iter() .flat_map(|d| d.class_name().map(|s| s.len())) .max() .unwrap_or(0), DeviceBlocks::UidSubClass => d .iter() .flat_map(|d| d.sub_class_name().map(|s| s.len())) .max() .unwrap_or(0), DeviceBlocks::UidProtocol => d .iter() .flat_map(|d| d.protocol_name().map(|s| s.len())) .max() .unwrap_or(0), DeviceBlocks::Class => d .iter() .map(|d| d.fully_defined_class().map_or(0, |c| c.to_string().len())) .max() .unwrap_or(0), DeviceBlocks::LastEvent => d .iter() .flat_map(|d| d.last_event().map(|s| s.to_string().len())) .max() .unwrap_or(0), _ => self.block_length().len(), } } fn generate_padding(d: &[&Device]) -> HashMap { DeviceBlocks::iter() .map(|b| (b, cmp::max(b.heading().len(), b.len(d)))) .collect() } fn format_value( &self, d: &Device, pad: &HashMap, settings: &PrintSettings, ) -> Option { match self { DeviceBlocks::BusNumber => Some(format!("{:3}", d.location_id.bus)), DeviceBlocks::DeviceNumber => Some(format!("{:3}", d.location_id.number)), DeviceBlocks::BranchPosition => Some(format!("{:3}", d.get_branch_position())), DeviceBlocks::PortPath => Some(format!( "{:pad$}", d.port_path().to_string(), pad = pad.get(self).unwrap_or(&0) )), DeviceBlocks::SysPath => Some(match d.extra.as_ref() { Some(e) => format!( "{:pad$}", e.syspath.as_ref().unwrap_or(&format!( "{:pad$}", "-", pad = pad.get(self).unwrap_or(&0) )), pad = pad.get(self).unwrap_or(&0) ), None => format!("{:pad$}", "-", pad = pad.get(self).unwrap_or(&0)), }), DeviceBlocks::Driver => Some(match d.extra.as_ref() { Some(e) => format!( "{:pad$}", e.driver.as_ref().unwrap_or(&format!( "{:pad$}", "-", pad = pad.get(self).unwrap_or(&0) )), pad = pad.get(self).unwrap_or(&0) ), None => format!("{:pad$}", "-", pad = pad.get(self).unwrap_or(&0)), }), DeviceBlocks::ProductName => Some(match d.extra.as_ref() { Some(e) => format!( "{:pad$}", e.product_name.as_ref().unwrap_or(&format!( "{:pad$}", "-", pad = pad.get(self).unwrap_or(&0) )), pad = pad.get(self).unwrap_or(&0) ), None => format!("{:pad$}", "-", pad = pad.get(self).unwrap_or(&0)), }), DeviceBlocks::VendorName => Some(match d.extra.as_ref() { Some(e) => format!( "{:pad$}", e.vendor.as_ref().unwrap_or(&format!( "{:pad$}", "-", pad = pad.get(self).unwrap_or(&0) )), pad = pad.get(self).unwrap_or(&0) ), None => format!("{:pad$}", "-", pad = pad.get(self).unwrap_or(&0)), }), DeviceBlocks::Icon => settings.icons.as_ref().map(|i| i.get_device_icon(d)), DeviceBlocks::VendorId => Some(match d.vendor_id { Some(v) => Self::format_base_u16(v, settings), None => format!("{:>6}", "-"), }), DeviceBlocks::ProductId => Some(match d.product_id { Some(v) => Self::format_base_u16(v, settings), None => format!("{:>6}", "-"), }), DeviceBlocks::VidPid => Some(Self::format_vidpid(d.vendor_id, d.product_id, settings)), DeviceBlocks::Name => Some(format!( "{:pad$}", d.name, pad = pad.get(self).unwrap_or(&0) )), DeviceBlocks::Manufacturer => Some(match d.manufacturer.as_ref() { Some(v) => format!("{:pad$}", v, pad = pad.get(self).unwrap_or(&0)), None => format!("{:pad$}", "-", pad = pad.get(self).unwrap_or(&0)), }), DeviceBlocks::Serial => Some(match d.serial_num.as_ref() { Some(v) => format!("{:pad$}", v, pad = pad.get(self).unwrap_or(&0)), None => format!("{:pad$}", "-", pad = pad.get(self).unwrap_or(&0)), }), DeviceBlocks::Speed => Some(match d.device_speed.as_ref() { Some(v) => format!("{:>10}", v.to_string()), None => format!("{:>10}", "-"), }), DeviceBlocks::NegotiatedSpeed => Some( match d.extra.as_ref().and_then(|e| e.negotiated_speed.as_ref()) { Some(v) => { let nu = NumericalUnit::::from(v); format!("{:>10}", nu.to_string()) } None => format!("{:>10}", "-"), }, ), DeviceBlocks::TreePositions => Some(format!( "{:pad$}", format!("{:}", d.location_id.tree_positions.iter().format("-")), pad = pad.get(self).unwrap_or(&0) )), DeviceBlocks::BusPower => Some(match d.bus_power { Some(v) => format!("{v:3} mA"), None => format!("{:>6}", "-"), }), DeviceBlocks::BusPowerUsed => Some(match d.bus_power_used { Some(v) => format!("{v:3} mA"), None => format!("{:>6}", "-"), }), DeviceBlocks::ExtraCurrentUsed => Some(match d.extra_current_used { Some(v) => format!("{v:3} mA"), None => format!("{:>6}", "-"), }), DeviceBlocks::BcdDevice => Some(match d.bcd_device { Some(v) => format!("{:5}", v.to_string()), None => format!("{:>5}", "-"), }), DeviceBlocks::BcdUsb => Some(match d.bcd_usb { Some(v) => format!("{:5}", v.to_string()), None => format!("{:>5}", "-"), }), DeviceBlocks::BaseClass => Some(match d.class.as_ref() { Some(v) => format!("{:pad$}", v.to_string(), pad = pad.get(self).unwrap_or(&0)), None => format!("{:pad$}", "-", pad = pad.get(self).unwrap_or(&0)), }), DeviceBlocks::SubClass => Some(match d.sub_class.as_ref() { Some(v) => Self::format_base_u8(*v, settings), None => format!("{:>4}", "-"), }), DeviceBlocks::Protocol => Some(match d.protocol.as_ref() { Some(v) => Self::format_base_u8(*v, settings), None => format!("{:>4}", "-"), }), DeviceBlocks::UidClass => Some(match d.class_name() { Some(v) => format!("{:pad$}", v, pad = pad.get(self).unwrap_or(&0)), None => format!("{:pad$}", "-", pad = pad.get(self).unwrap_or(&0)), }), DeviceBlocks::UidSubClass => Some(match d.sub_class_name() { Some(v) => format!("{:pad$}", v, pad = pad.get(self).unwrap_or(&0)), None => format!("{:pad$}", "-", pad = pad.get(self).unwrap_or(&0)), }), DeviceBlocks::UidProtocol => Some(match d.protocol_name() { Some(v) => format!("{:pad$}", v, pad = pad.get(self).unwrap_or(&0)), None => format!("{:pad$}", "-", pad = pad.get(self).unwrap_or(&0)), }), DeviceBlocks::Class => Some(match d.fully_defined_class() { Some(v) => format!("{:pad$}", v, pad = pad.get(self).unwrap_or(&0)), None => format!("{:pad$}", "-", pad = pad.get(self).unwrap_or(&0)), }), DeviceBlocks::BaseValue => Some(match d.class.as_ref() { Some(v) => Self::format_base_u8((*v).into(), settings), None => format!("{:pad$}", "-", pad = pad.get(self).unwrap_or(&0)), }), DeviceBlocks::LastEvent => Some(match d.last_event() { Some(v) => format!("{:pad$}", v, pad = pad.get(self).unwrap_or(&0)), None => format!("{:pad$}", "-", pad = pad.get(self).unwrap_or(&0)), }), DeviceBlocks::EventIcon => match d.last_event() { Some(e) => settings.icons.as_ref().map(|i| i.get_event_icon(&e)), None => None, }, } } fn colour(&self, s: &str, ct: &colour::ColourTheme) -> ColoredString { match self { DeviceBlocks::BcdUsb | DeviceBlocks::BcdDevice | DeviceBlocks::DeviceNumber | DeviceBlocks::LastEvent => ct.number.map_or(s.normal(), |c| s.color(c)), DeviceBlocks::BusNumber | DeviceBlocks::BranchPosition | DeviceBlocks::TreePositions => ct.location.map_or(s.normal(), |c| s.color(c)), DeviceBlocks::Icon | DeviceBlocks::EventIcon => { ct.icon.map_or(s.normal(), |c| s.color(c)) } DeviceBlocks::PortPath | DeviceBlocks::SysPath => { ct.path.map_or(s.normal(), |c| s.color(c)) } DeviceBlocks::VendorId | DeviceBlocks::VidPid => { ct.vid.map_or(s.normal(), |c| s.color(c)) } DeviceBlocks::ProductId => ct.pid.map_or(s.normal(), |c| s.color(c)), DeviceBlocks::Name | DeviceBlocks::ProductName => { ct.name.map_or(s.normal(), |c| s.color(c)) } DeviceBlocks::Serial => ct.serial.map_or(s.normal(), |c| s.color(c)), DeviceBlocks::Manufacturer | DeviceBlocks::VendorName => { ct.manufacturer.map_or(s.normal(), |c| s.color(c)) } DeviceBlocks::Driver => ct.driver.map_or(s.normal(), |c| s.color(c)), DeviceBlocks::Speed | DeviceBlocks::NegotiatedSpeed => { ct.speed.map_or(s.normal(), |c| s.color(c)) } DeviceBlocks::BusPower | DeviceBlocks::BusPowerUsed | DeviceBlocks::ExtraCurrentUsed => ct.power.map_or(s.normal(), |c| s.color(c)), DeviceBlocks::BaseClass | DeviceBlocks::UidClass | DeviceBlocks::Class | DeviceBlocks::BaseValue => ct.class_code.map_or(s.normal(), |c| s.color(c)), DeviceBlocks::SubClass | DeviceBlocks::UidSubClass => { ct.sub_code.map_or(s.normal(), |c| s.color(c)) } DeviceBlocks::Protocol | DeviceBlocks::UidProtocol => { ct.protocol.map_or(s.normal(), |c| s.color(c)) } } } fn heading(&self) -> &str { match self { DeviceBlocks::BusNumber => "Bus", DeviceBlocks::DeviceNumber => "#", DeviceBlocks::BranchPosition => "Prt", DeviceBlocks::PortPath => "PPath", DeviceBlocks::SysPath => "SPath", DeviceBlocks::Driver => "Driver", DeviceBlocks::VendorId => "VID", DeviceBlocks::ProductId => "PID", DeviceBlocks::VidPid => "VID:PID", DeviceBlocks::Name => "Name", DeviceBlocks::Manufacturer => "Manfacturer", DeviceBlocks::ProductName => "PName", DeviceBlocks::VendorName => "VName", DeviceBlocks::Serial => "Serial", DeviceBlocks::Speed => "Speed", DeviceBlocks::NegotiatedSpeed => "NgSpd", DeviceBlocks::TreePositions => "TPos", // will be 000 mA = 6 DeviceBlocks::BusPower => "PBus", DeviceBlocks::BusPowerUsed => "PUsd", DeviceBlocks::ExtraCurrentUsed => "PExr", // 00.00 = 5 DeviceBlocks::BcdDevice => "Dev V", DeviceBlocks::BcdUsb => "USB V", DeviceBlocks::BaseClass => "BaseC", DeviceBlocks::SubClass => "SubC", DeviceBlocks::Protocol => "Pcol", DeviceBlocks::UidClass => "UidCl", DeviceBlocks::UidSubClass => "UidSc", DeviceBlocks::UidProtocol => "UidPc", DeviceBlocks::Class => "Class", DeviceBlocks::BaseValue => "CVal", DeviceBlocks::Icon => ICON_HEADING, DeviceBlocks::EventIcon => "E", DeviceBlocks::LastEvent => "Event", } } fn heading_padded(&self, pad: &HashMap) -> String { format!( "{:^pad$}", self.heading(), pad = pad.get(self).unwrap_or(&0) ) } fn block_length(&self) -> BlockLength { match self { DeviceBlocks::Icon | DeviceBlocks::EventIcon => BlockLength::Fixed(1), DeviceBlocks::BusNumber | DeviceBlocks::DeviceNumber | DeviceBlocks::BranchPosition => { BlockLength::Fixed(3) } DeviceBlocks::VendorId | DeviceBlocks::ProductId => BlockLength::Fixed(6), DeviceBlocks::VidPid => BlockLength::Fixed(11), DeviceBlocks::Speed => BlockLength::Fixed(10), DeviceBlocks::NegotiatedSpeed => BlockLength::Fixed(10), DeviceBlocks::BusPower | DeviceBlocks::BusPowerUsed | DeviceBlocks::ExtraCurrentUsed => BlockLength::Fixed(6), DeviceBlocks::BcdDevice | DeviceBlocks::BcdUsb => BlockLength::Fixed(5), DeviceBlocks::SubClass | DeviceBlocks::Protocol | DeviceBlocks::BaseValue => { BlockLength::Fixed(4) } _ => BlockLength::Variable(self.heading().len()), } } fn is_icon(&self) -> bool { self == &DeviceBlocks::Icon } } impl Block for BusBlocks { fn default_blocks(verbose: bool) -> Vec { if verbose { vec![ BusBlocks::Icon, BusBlocks::PortPath, BusBlocks::Name, BusBlocks::HostController, BusBlocks::HostControllerDevice, BusBlocks::HostControllerVendor, BusBlocks::PciVendor, BusBlocks::PciDevice, BusBlocks::PciRevision, ] } else { vec![ BusBlocks::PortPath, BusBlocks::Name, BusBlocks::HostController, BusBlocks::HostControllerDevice, ] } } fn len(&self, d: &[&Bus]) -> usize { match self { BusBlocks::Name => d.iter().map(|d| d.name.width()).max().unwrap_or(0), BusBlocks::HostController => d .iter() .map(|d| d.host_controller.width()) .max() .unwrap_or(0), BusBlocks::HostControllerVendor => d .iter() .flat_map(|d| d.host_controller_vendor.as_ref().map(|v| v.width())) .max() .unwrap_or(0), BusBlocks::HostControllerDevice => d .iter() .flat_map(|d| d.host_controller_device.as_ref().map(|v| v.width())) .max() .unwrap_or(0), BusBlocks::PortPath => d .iter() .map(|d| d.path().unwrap_or_default().as_os_str().len()) .max() .unwrap_or(0), _ => self.block_length().len(), } } fn generate_padding(d: &[&Bus]) -> HashMap { BusBlocks::iter() .map(|b| (b, cmp::max(b.heading().len(), b.len(d)))) .collect() } fn colour(&self, s: &str, ct: &colour::ColourTheme) -> ColoredString { match self { BusBlocks::BusNumber => ct.location.map_or(s.normal(), |c| s.color(c)), BusBlocks::PciVendor => ct.vid.map_or(s.normal(), |c| s.color(c)), BusBlocks::PciDevice => ct.pid.map_or(s.normal(), |c| s.color(c)), BusBlocks::Name => ct.name.map_or(s.normal(), |c| s.color(c)), BusBlocks::HostController => ct.class_code.map_or(s.normal(), |c| s.color(c)), BusBlocks::HostControllerVendor => ct.manufacturer.map_or(s.normal(), |c| s.color(c)), BusBlocks::HostControllerDevice => ct.name.map_or(s.normal(), |c| s.color(c)), BusBlocks::PciRevision => ct.number.map_or(s.normal(), |c| s.color(c)), BusBlocks::Icon => ct.icon.map_or(s.normal(), |c| s.color(c)), BusBlocks::PortPath => ct.path.map_or(s.normal(), |c| s.color(c)), } } fn format_value( &self, bus: &Bus, pad: &HashMap, settings: &PrintSettings, ) -> Option { match self { BusBlocks::BusNumber => bus .get_bus_number() .map(|v| format!("{v:3}")) .or(Some("---".to_string())), BusBlocks::Icon => settings .icons .as_ref() .map(|i| i.get_bus_icon(bus)) .or(Some(" ".to_string())), BusBlocks::PciVendor => Some(match bus.pci_vendor { Some(v) => Self::format_base_u16(v, settings), None => format!("{:>6}", "-"), }), BusBlocks::PciDevice => Some(match bus.pci_device { Some(v) => Self::format_base_u16(v, settings), None => format!("{:>6}", "-"), }), BusBlocks::PciRevision => Some(match bus.pci_revision { Some(v) => Self::format_base_u16(v, settings), None => format!("{:>6}", "-"), }), BusBlocks::Name => Some(format!( "{:pad$}", bus.name, pad = pad.get(self).unwrap_or(&0) )), BusBlocks::HostController => Some(format!( "{:pad$}", bus.host_controller, pad = pad.get(self).unwrap_or(&0) )), BusBlocks::HostControllerVendor => Some(match bus.host_controller_vendor.as_ref() { Some(v) => format!("{:pad$}", v, pad = pad.get(self).unwrap_or(&0)), None => format!("{:pad$}", "-", pad = pad.get(self).unwrap_or(&0)), }), BusBlocks::HostControllerDevice => Some(match bus.host_controller_device.as_ref() { Some(v) => format!("{:pad$}", v, pad = pad.get(self).unwrap_or(&0)), None => format!("{:pad$}", "-", pad = pad.get(self).unwrap_or(&0)), }), BusBlocks::PortPath => Some(match bus.path() { Some(v) => format!("{:pad$}", v.display(), pad = pad.get(self).unwrap_or(&0)), None => format!("{:pad$}", "-", pad = pad.get(self).unwrap_or(&0)), }), } } fn heading(&self) -> &str { match self { BusBlocks::BusNumber => "Bus", BusBlocks::PortPath => "PPath", BusBlocks::PciDevice => "VID", BusBlocks::PciVendor => "PID", BusBlocks::PciRevision => "Revisn", BusBlocks::Name => "Name", BusBlocks::HostController => "HostController", BusBlocks::HostControllerVendor => "HostVendor", BusBlocks::HostControllerDevice => "HostDevice", BusBlocks::Icon => ICON_HEADING, } } fn heading_padded(&self, pad: &HashMap) -> String { format!( "{:^pad$}", self.heading(), pad = pad.get(self).unwrap_or(&0) ) } fn block_length(&self) -> BlockLength { match self { BusBlocks::Icon => BlockLength::Fixed(1), BusBlocks::BusNumber => BlockLength::Fixed(3), BusBlocks::PciDevice | BusBlocks::PciVendor | BusBlocks::PciRevision => { BlockLength::Fixed(6) } _ => BlockLength::Variable(self.heading().len()), } } fn is_icon(&self) -> bool { self == &BusBlocks::Icon } } impl Block for ConfigurationBlocks { const INSET: u8 = 1; fn default_blocks(verbose: bool) -> Vec { if verbose { vec![ ConfigurationBlocks::Number, ConfigurationBlocks::IconAttributes, ConfigurationBlocks::Attributes, ConfigurationBlocks::NumInterfaces, ConfigurationBlocks::MaxPower, ConfigurationBlocks::Name, ] } else { vec![ ConfigurationBlocks::Number, ConfigurationBlocks::IconAttributes, ConfigurationBlocks::MaxPower, ConfigurationBlocks::Name, ] } } fn len(&self, d: &[&Configuration]) -> usize { match self { ConfigurationBlocks::Name => d.iter().map(|d| d.name.len()).max().unwrap_or(0), ConfigurationBlocks::Attributes => d .iter() .map(|d| d.attributes_string().len()) .max() .unwrap_or(0), _ => self.block_length().len(), } } fn generate_padding(d: &[&Configuration]) -> HashMap { ConfigurationBlocks::iter() .map(|b| (b, cmp::max(b.heading().len(), b.len(d)))) .collect() } fn colour(&self, s: &str, ct: &colour::ColourTheme) -> ColoredString { match self { ConfigurationBlocks::Number => ct.location.map_or(s.normal(), |c| s.color(c)), ConfigurationBlocks::NumInterfaces => ct.number.map_or(s.normal(), |c| s.color(c)), ConfigurationBlocks::MaxPower => ct.power.map_or(s.normal(), |c| s.color(c)), ConfigurationBlocks::Name => ct.name.map_or(s.normal(), |c| s.color(c)), ConfigurationBlocks::Attributes => ct.attributes.map_or(s.normal(), |c| s.color(c)), ConfigurationBlocks::IconAttributes => ct.icon.map_or(s.normal(), |c| s.color(c)), } } fn format_value( &self, config: &Configuration, pad: &HashMap, settings: &PrintSettings, ) -> Option { match self { ConfigurationBlocks::Number => Some(format!("{:2}", config.number)), ConfigurationBlocks::NumInterfaces => Some(format!("{:2}", config.interfaces.len())), ConfigurationBlocks::Name => Some(format!( "{:pad$}", config.name, pad = pad.get(self).unwrap_or(&0) )), ConfigurationBlocks::MaxPower => Some(format!("{:6}", config.max_power)), ConfigurationBlocks::Attributes => Some(format!( "{:pad$}", config.attributes_string(), pad = pad.get(self).unwrap_or(&0) )), ConfigurationBlocks::IconAttributes => Some(format!( "{:pad$}", attributes_to_icons(&config.attributes, settings), pad = pad.get(self).unwrap_or(&0) )), } } fn heading(&self) -> &str { match self { ConfigurationBlocks::Number => "#", ConfigurationBlocks::NumInterfaces => "I#", ConfigurationBlocks::MaxPower => "PMax", ConfigurationBlocks::Name => "Name", ConfigurationBlocks::Attributes => "Attributes", ConfigurationBlocks::IconAttributes => ICON_HEADING, } } fn heading_padded(&self, pad: &HashMap) -> String { format!( "{:^pad$}", self.heading(), pad = pad.get(self).unwrap_or(&0) ) } fn block_length(&self) -> BlockLength { match self { ConfigurationBlocks::Number => BlockLength::Fixed(2), ConfigurationBlocks::NumInterfaces => BlockLength::Fixed(2), ConfigurationBlocks::MaxPower => BlockLength::Fixed(6), // two possible icons and a space between ConfigurationBlocks::IconAttributes => BlockLength::Fixed(3), _ => BlockLength::Variable(self.heading().len()), } } fn is_icon(&self) -> bool { self == &ConfigurationBlocks::IconAttributes } } impl Block for InterfaceBlocks { const INSET: u8 = 2; #[cfg(target_os = "linux")] fn default_blocks(verbose: bool) -> Vec { if verbose { vec![ InterfaceBlocks::PortPath, InterfaceBlocks::Icon, InterfaceBlocks::AltSetting, InterfaceBlocks::BaseValue, InterfaceBlocks::BaseClass, InterfaceBlocks::SubClass, InterfaceBlocks::UidSubClass, InterfaceBlocks::Protocol, InterfaceBlocks::UidProtocol, InterfaceBlocks::Name, InterfaceBlocks::NumEndpoints, InterfaceBlocks::Driver, InterfaceBlocks::SysPath, ] } else { vec![ InterfaceBlocks::PortPath, InterfaceBlocks::Icon, InterfaceBlocks::AltSetting, InterfaceBlocks::BaseClass, InterfaceBlocks::SubClass, InterfaceBlocks::Protocol, InterfaceBlocks::Name, InterfaceBlocks::Driver, ] } } #[cfg(not(target_os = "linux"))] fn default_blocks(verbose: bool) -> Vec { if verbose { vec![ InterfaceBlocks::PortPath, InterfaceBlocks::Icon, InterfaceBlocks::AltSetting, InterfaceBlocks::BaseValue, InterfaceBlocks::BaseClass, InterfaceBlocks::SubClass, InterfaceBlocks::UidSubClass, InterfaceBlocks::Protocol, InterfaceBlocks::UidProtocol, InterfaceBlocks::Name, InterfaceBlocks::NumEndpoints, ] } else { vec![ InterfaceBlocks::PortPath, InterfaceBlocks::Icon, InterfaceBlocks::AltSetting, InterfaceBlocks::BaseClass, InterfaceBlocks::SubClass, InterfaceBlocks::Protocol, InterfaceBlocks::Name, ] } } fn example_blocks() -> Vec { vec![ InterfaceBlocks::PortPath, InterfaceBlocks::Icon, InterfaceBlocks::AltSetting, InterfaceBlocks::BaseClass, InterfaceBlocks::SubClass, InterfaceBlocks::Protocol, InterfaceBlocks::Name, InterfaceBlocks::Driver, ] } fn len(&self, d: &[&Interface]) -> usize { match self { InterfaceBlocks::Name => d .iter() .flat_map(|d| d.name.as_ref().map(|s| s.width())) .max() .unwrap_or(0), InterfaceBlocks::BaseClass => d .iter() .map(|d| d.class.to_string().len()) .max() .unwrap_or(0), InterfaceBlocks::PortPath => d.iter().map(|d| d.path.len()).max().unwrap_or(0), InterfaceBlocks::SysPath => d .iter() .flat_map(|d| d.syspath.as_ref().map(|v| v.len())) .max() .unwrap_or(0), InterfaceBlocks::Driver => d .iter() .flat_map(|d| d.driver.as_ref().map(|v| v.len())) .max() .unwrap_or(0), InterfaceBlocks::UidClass => d .iter() .flat_map(|d| d.class_name().map(|s| s.len())) .max() .unwrap_or(0), InterfaceBlocks::UidSubClass => d .iter() .flat_map(|d| d.sub_class_name().map(|s| s.len())) .max() .unwrap_or(0), InterfaceBlocks::UidProtocol => d .iter() .flat_map(|d| d.protocol_name().map(|s| s.len())) .max() .unwrap_or(0), InterfaceBlocks::Class => d .iter() .map(|d| d.fully_defined_class().to_string().len()) .max() .unwrap_or(0), _ => self.block_length().len(), } } fn generate_padding(d: &[&Interface]) -> HashMap { InterfaceBlocks::iter() .map(|b| (b, cmp::max(b.heading().len(), b.len(d)))) .collect() } fn colour(&self, s: &str, ct: &colour::ColourTheme) -> ColoredString { match self { InterfaceBlocks::Number => ct.number.map_or(s.normal(), |c| s.color(c)), InterfaceBlocks::Name => ct.name.map_or(s.normal(), |c| s.color(c)), InterfaceBlocks::PortPath | InterfaceBlocks::SysPath => { ct.path.map_or(s.normal(), |c| s.color(c)) } InterfaceBlocks::Icon => ct.icon.map_or(s.normal(), |c| s.color(c)), InterfaceBlocks::BaseClass | InterfaceBlocks::UidClass | InterfaceBlocks::Class | InterfaceBlocks::BaseValue => ct.class_code.map_or(s.normal(), |c| s.color(c)), InterfaceBlocks::SubClass | InterfaceBlocks::UidSubClass => { ct.sub_code.map_or(s.normal(), |c| s.color(c)) } InterfaceBlocks::Protocol | InterfaceBlocks::UidProtocol => { ct.protocol.map_or(s.normal(), |c| s.color(c)) } InterfaceBlocks::Driver => ct.driver.map_or(s.normal(), |c| s.color(c)), InterfaceBlocks::AltSetting | InterfaceBlocks::NumEndpoints => { ct.number.map_or(s.normal(), |c| s.color(c)) } } } fn format_value( &self, interface: &Interface, pad: &HashMap, settings: &PrintSettings, ) -> Option { match self { InterfaceBlocks::Number => Some(format!("{:2}", interface.number)), InterfaceBlocks::Name => Some(match interface.name.as_ref() { Some(v) => format!("{:pad$}", v, pad = pad.get(self).unwrap_or(&0)), None => format!("{:pad$}", "-", pad = pad.get(self).unwrap_or(&0)), }), InterfaceBlocks::NumEndpoints => Some(format!("{:2}", interface.endpoints.len())), InterfaceBlocks::PortPath => Some(format!( "{:pad$}", interface.path, pad = pad.get(self).unwrap_or(&0) )), InterfaceBlocks::SysPath => Some(match interface.syspath.as_ref() { Some(v) => format!("{:pad$}", v, pad = pad.get(self).unwrap_or(&0)), None => format!("{:pad$}", "-", pad = pad.get(self).unwrap_or(&0)), }), InterfaceBlocks::Driver => Some(match interface.driver.as_ref() { Some(v) => format!("{:pad$}", v, pad = pad.get(self).unwrap_or(&0)), None => format!("{:pad$}", "-", pad = pad.get(self).unwrap_or(&0)), }), InterfaceBlocks::BaseClass => Some(format!( "{:pad$}", interface.class.to_string(), pad = pad.get(self).unwrap_or(&0) )), InterfaceBlocks::SubClass => Some(Self::format_base_u8(interface.sub_class, settings)), InterfaceBlocks::Protocol => Some(Self::format_base_u8(interface.protocol, settings)), InterfaceBlocks::AltSetting => { Some(Self::format_base_u8(interface.alt_setting, settings)) } InterfaceBlocks::Icon => settings.icons.as_ref().map(|i| { i.get_classifier_icon(&interface.class, interface.sub_class, interface.protocol) }), InterfaceBlocks::UidClass => Some(match interface.class_name() { Some(v) => format!("{:pad$}", v, pad = pad.get(self).unwrap_or(&0)), None => format!("{:pad$}", "-", pad = pad.get(self).unwrap_or(&0)), }), InterfaceBlocks::UidSubClass => Some(match interface.sub_class_name() { Some(v) => format!("{:pad$}", v, pad = pad.get(self).unwrap_or(&0)), None => format!("{:pad$}", "-", pad = pad.get(self).unwrap_or(&0)), }), InterfaceBlocks::UidProtocol => Some(match interface.protocol_name() { Some(v) => format!("{:pad$}", v, pad = pad.get(self).unwrap_or(&0)), None => format!("{:pad$}", "-", pad = pad.get(self).unwrap_or(&0)), }), InterfaceBlocks::Class => Some(format!( "{:pad$}", interface.fully_defined_class(), pad = pad.get(self).unwrap_or(&0) )), InterfaceBlocks::BaseValue => { Some(Self::format_base_u8(interface.class.into(), settings)) } } } fn heading(&self) -> &str { match self { InterfaceBlocks::Number => "#", InterfaceBlocks::Name => "Name", InterfaceBlocks::NumEndpoints => "E#", InterfaceBlocks::PortPath => "PPath", InterfaceBlocks::SysPath => "SPath", InterfaceBlocks::Driver => "Driver", InterfaceBlocks::BaseClass => "BaseC", InterfaceBlocks::SubClass => "SubC", InterfaceBlocks::Protocol => "Pcol", InterfaceBlocks::AltSetting => "Alt#", InterfaceBlocks::UidClass => "UidCl", InterfaceBlocks::UidSubClass => "UidSc", InterfaceBlocks::UidProtocol => "UidPc", InterfaceBlocks::Class => "Class", InterfaceBlocks::BaseValue => "CVal", InterfaceBlocks::Icon => ICON_HEADING, } } fn heading_padded(&self, pad: &HashMap) -> String { format!( "{:^pad$}", self.heading(), pad = pad.get(self).unwrap_or(&0) ) } fn block_length(&self) -> BlockLength { match self { InterfaceBlocks::Icon => BlockLength::Fixed(1), InterfaceBlocks::Number => BlockLength::Fixed(2), InterfaceBlocks::NumEndpoints => BlockLength::Fixed(2), InterfaceBlocks::SubClass | InterfaceBlocks::Protocol | InterfaceBlocks::AltSetting | InterfaceBlocks::BaseValue => BlockLength::Fixed(4), _ => BlockLength::Variable(self.heading().len()), } } fn is_icon(&self) -> bool { self == &InterfaceBlocks::Icon } } impl Block for EndpointBlocks { const INSET: u8 = 3; fn default_blocks(verbose: bool) -> Vec { if verbose { vec![ EndpointBlocks::Number, EndpointBlocks::Direction, EndpointBlocks::TransferType, EndpointBlocks::SyncType, EndpointBlocks::UsageType, EndpointBlocks::Interval, EndpointBlocks::MaxPacketSize, ] } else { vec![ EndpointBlocks::Number, EndpointBlocks::Direction, EndpointBlocks::TransferType, EndpointBlocks::SyncType, EndpointBlocks::UsageType, EndpointBlocks::MaxPacketSize, ] } } fn len(&self, d: &[&Endpoint]) -> usize { match self { EndpointBlocks::TransferType => d .iter() .map(|d| d.transfer_type.to_string().len()) .max() .unwrap_or(0), EndpointBlocks::SyncType => d .iter() .map(|d| d.sync_type.to_string().len()) .max() .unwrap_or(0), EndpointBlocks::UsageType => d .iter() .map(|d| d.usage_type.to_string().len()) .max() .unwrap_or(0), EndpointBlocks::Direction => d .iter() .map(|d| d.address.direction.to_string().len()) .max() .unwrap_or(0), EndpointBlocks::MaxPacketSize => d .iter() .map(|d| d.max_packet_string().len()) .max() .unwrap_or(0), _ => self.block_length().len(), } } fn generate_padding(d: &[&Endpoint]) -> HashMap { EndpointBlocks::iter() .map(|b| (b, cmp::max(b.heading().len(), b.len(d)))) .collect() } fn colour(&self, s: &str, ct: &colour::ColourTheme) -> ColoredString { match self { EndpointBlocks::Number | EndpointBlocks::Interval | EndpointBlocks::MaxPacketSize => { ct.number.map_or(s.normal(), |c| s.color(c)) } EndpointBlocks::Direction | EndpointBlocks::UsageType | EndpointBlocks::TransferType | EndpointBlocks::SyncType => ct.attributes.map_or(s.normal(), |c| s.color(c)), } } fn format_value( &self, end: &Endpoint, pad: &HashMap, _settings: &PrintSettings, ) -> Option { match self { EndpointBlocks::Number => Some(format!("{:2}", end.address.number)), EndpointBlocks::Interval => Some(format!("{:2}", end.interval)), EndpointBlocks::MaxPacketSize => Some(format!( "{:pad$}", end.max_packet_string(), pad = pad.get(self).unwrap_or(&0) )), EndpointBlocks::Direction => Some(format!( "{:pad$}", end.address.direction.to_string(), pad = pad.get(self).unwrap_or(&0) )), EndpointBlocks::TransferType => Some(format!( "{:pad$}", end.transfer_type.to_string(), pad = pad.get(self).unwrap_or(&0) )), EndpointBlocks::SyncType => Some(format!( "{:pad$}", end.sync_type.to_string(), pad = pad.get(self).unwrap_or(&0) )), EndpointBlocks::UsageType => Some(format!( "{:pad$}", end.usage_type.to_string(), pad = pad.get(self).unwrap_or(&0) )), } } fn heading(&self) -> &str { match self { EndpointBlocks::Number => "#", EndpointBlocks::Interval => "Iv", EndpointBlocks::MaxPacketSize => "MaxPkb", EndpointBlocks::Direction => "Dir", EndpointBlocks::TransferType => "TranT", EndpointBlocks::SyncType => "SyncT", EndpointBlocks::UsageType => "UsgeT", } } fn heading_padded(&self, pad: &HashMap) -> String { format!( "{:^pad$}", self.heading(), pad = pad.get(self).unwrap_or(&0) ) } fn block_length(&self) -> BlockLength { match self { EndpointBlocks::Number => BlockLength::Fixed(2), EndpointBlocks::Interval => BlockLength::Fixed(2), _ => BlockLength::Variable(self.heading().len()), } } } /// Value to sort [`Device`] #[derive(Default, PartialEq, Eq, Debug, ValueEnum, Clone, Copy, Serialize, Deserialize)] pub enum Sort { #[default] /// Sort by bus device number DeviceNumber, /// Sort by position in parent branch BranchPosition, /// No sorting; whatever order it was parsed NoSort, } impl Sort { /// Sort the [`Device`]s in place pub fn sort_devices(&self, devices: &mut [Device]) { // add bus number to maintain bus order when sorting match self { Sort::BranchPosition => { devices.sort_by_key(|d| d.get_branch_position() + d.location_id.bus) } Sort::DeviceNumber => devices.sort_by_key(|d| d.location_id.number + d.location_id.bus), _ => (), } } /// Sort the references to [`Device`]s in place pub fn sort_devices_ref(&self, devices: &mut [&Device]) { match self { Sort::BranchPosition => { devices.sort_by_key(|d| d.get_branch_position() + d.location_id.bus) } Sort::DeviceNumber => devices.sort_by_key(|d| d.location_id.number + d.location_id.bus), _ => (), } } /// Sort the devices at each branch by calling this recursively after sorting the devices at this level pub fn sort_devices_recursive(&self, devices: &mut Vec) { // sort the devices at this level self.sort_devices(devices); // then sort the devices at each branch for device in devices { if let Some(branch_devices) = &mut device.devices { self.sort_devices_recursive(branch_devices); } } } /// Walk the bus tree and sort the devices at each branch pub fn sort_bus(&self, bus: &mut Bus) { if matches!(self, Sort::NoSort) { return; } if let Some(devices) = &mut bus.devices { self.sort_devices_recursive(devices); } } /// Sort buses in place, sorting devices on each bus and then by bus number pub fn sort_buses(&self, buses: &mut Vec) { buses.sort_by_key(|b| b.get_bus_number()); for bus in buses { self.sort_bus(bus); } } } /// Value to group [`Device`] #[derive(Default, Debug, ValueEnum, Clone, PartialEq, Eq, Serialize, Deserialize)] #[serde(rename_all = "kebab-case")] pub enum Group { #[default] /// No grouping NoGroup, /// Group into buses with bus info as heading - like a flat tree Bus, } /// Options for [`PrintSettings`] mask_serials #[derive(Default, Debug, ValueEnum, Clone, PartialEq, Eq, Serialize, Deserialize)] #[serde(rename_all = "kebab-case")] pub enum MaskSerial { /// Hide with '*' char #[default] Hide, /// Mask by randomising existing chars Scramble, /// Mask by replacing length with random chars Replace, } /// Mode being used for printing #[derive(Default, Debug, ValueEnum, Clone, PartialEq, Eq, Serialize, Deserialize)] pub enum PrintMode { /// Normal printing to static output #[default] Normal, /// Dynamic printing such as watch mode Dynamic, } /// Passed to printing functions allows default args #[derive(Debug, Default)] pub struct PrintSettings { /// Don't pad in order to align blocks pub no_padding: bool, /// Print in decimal not base16 pub decimal: bool, /// No tree printing pub tree: bool, /// Sort devices pub sort_devices: Sort, /// Sort buses by bus number pub sort_buses: bool, /// Group devices pub group_devices: Group, /// Print headings for blocks pub headings: bool, /// Level of verbosity pub verbosity: u8, /// Print more blocks by default pub more: bool, /// Print as json pub json: bool, /// Character encoding to use pub encoding: Encoding, /// Scramble serial numbers, useful if sharing sensitive device dumps pub mask_serials: Option, /// [`DeviceBlocks`] to use for printing pub device_blocks: Option>, /// [`BusBlocks`] to use for printing pub bus_blocks: Option>, /// [`ConfigurationBlocks`] to use for printing pub config_blocks: Option>, /// [`InterfaceBlocks`] to use for printing pub interface_blocks: Option>, /// [`EndpointBlocks`] to use for printing pub endpoint_blocks: Option>, /// [`crate::icon::IconTheme`] to apply - None to not print any icons pub icons: Option, /// [`crate::colour::ColourTheme`] to apply - None to not colour pub colours: Option, /// Max variable string length to display before truncating - descriptors and classes for example pub max_variable_string_len: Option, /// Enable auto generation of max_variable_string_len based on terminal width pub auto_width: bool, /// Terminal width and height data pub terminal_size: Option<(u16, u16)>, /// When to print icon blocks pub icon_when: IconWhen, /// Printing in watch mode pub print_mode: PrintMode, } /// Converts a HashSet of [`ConfigAttributes`] a String of nerd icons fn attributes_to_icons(attributes: &Vec, settings: &PrintSettings) -> String { let mut icon_strs = Vec::new(); if settings.icons.is_some() { for a in attributes { match a { ConfigAttributes::SelfPowered => icon_strs.push("\u{f06a5}"), // 󰚥 ConfigAttributes::RemoteWakeup => icon_strs.push("\u{f0155}"), // ó°…• ConfigAttributes::BatteryPowered => icon_strs.push("\u{f244}"), //  ConfigAttributes::BusPowered => icon_strs.push("\u{f11f0}"), // 󱇰 } } } icon_strs.join(" ") } /// Truncates and appends '...' to show string has been truncated /// /// `len` is length of resulting String, with '...' so original `s` content will be len - 3 /// /// If `len` is less than 3, `s` truncated to this length /// /// ``` /// use cyme::display::truncate_string; /// let mut string = String::from("Hello world"); /// truncate_string(&mut string, 8); /// assert_eq!(string, "Hello..."); /// // emoji are 2 bytes so will be truncated correctly on char boundary /// let mut string = String::from("Hell😅 world"); /// truncate_string(&mut string, 8); /// assert_eq!(string, "Hell😅..."); /// let mut string = String::from("bl"); /// truncate_string(&mut string, 2); /// assert_eq!(string, "bl"); /// // don't shorten if already length /// let mut string = String::from("blah"); /// truncate_string(&mut string, 4); /// assert_eq!(string, "blah"); /// // just over length /// let mut string = String::from("blahx"); /// truncate_string(&mut string, 4); /// assert_eq!(string, "b..."); /// ``` pub fn truncate_string(s: &mut String, len: usize) { // if already less than or equal to len, or len is less than 3, return if s.width() <= len || len <= 3 { return; } // use char_indices to find last char boundary before len - 3 // not s.len() as this is the byte length and utf-8 chars can be multiple bytes if let Some((i, _)) = s.char_indices().nth(len - 3) { s.truncate(i); s.push_str("..."); } } /// Finds the maximum string size to truncate variable fields /// /// Calculates based on the [`PrintSettings`] terminal_size width, the total length of the [`BlockLength::Fixed`] fields and thus the remaining space to divide between [`BlockLength::Variable`] fields as the maximum string size /// /// Total length is based the prior calculated `variable_lens` - the values represent the maximum length of variable fields to print pub fn auto_max_string_len( blocks: &[impl Block], offset: usize, #[allow(clippy::ptr_arg)] variable_lens: &Vec, settings: &PrintSettings, ) -> Option { if variable_lens.is_empty() { return None; } // total fixed includes length of blocks to account for spaces between fields, plus tree offset let total_fixed: usize = blocks .iter() .filter_map(|b| b.block_length().fixed_len()) .sum::() + blocks.len() + offset; let total_variable: usize = variable_lens.iter().sum(); let total_len: usize = total_fixed + total_variable + (blocks.len() * 2); let (width, height) = settings.terminal_size.unwrap_or((DEFAULT_AUTO_WIDTH, 0)); log::trace!( "Auto scaling running for max length {total_len:?} of which fixed {total_fixed:?}, to terminal size {width:?} {height:?}" ); let w = width as usize; if total_len > w { // fixed already taking all space, return min if w < total_fixed { log::trace!("Cannot scale, fixed already taking all space!"); return Some(MIN_VARIABLE_STRING_LEN); } // remaining len for variable strings let variable_len_remain: usize = w - total_fixed; // auto max is the space not taken by fixed divided by number of variable length // *variable_lens checked not zero at entry so should not be div 0 let mut auto_max_string = variable_len_remain / (variable_lens.len()); // remaining chars are those not used by variable strings; ones not over the found auto max and can be used by other variable strings - bumping the global max up since they won't use it let mut remaining_chars: usize = variable_lens .iter() .filter(|v| **v <= auto_max_string) .map(|v| auto_max_string - v) .sum(); log::trace!( "Auto max string calculated {auto_max_string:?}, remaining {remaining_chars:?}" ); // equally divide remaining chars between variable > auto_max_string - not perfect as could be shared per how much longer each is but this would require unique max for each block let variable_longer = variable_lens .iter() .filter(|v| **v > auto_max_string) .count(); if variable_longer != 0 { remaining_chars /= variable_longer; } auto_max_string += remaining_chars; if auto_max_string < MIN_VARIABLE_STRING_LEN { log::trace!( "Ignoring auto max string {auto_max_string:?}! Clamped to MIN_VARIABLE_STRING_LEN {MIN_VARIABLE_STRING_LEN:?}" ); Some(MIN_VARIABLE_STRING_LEN) } else { log::trace!("Final auto max string {auto_max_string:?}"); Some(auto_max_string) } } else { None } } /// Returns true if the [`Block`] has a valid icon for the [`PrintSettings`] [`Encoding`] pub fn has_valid_icons( d: &T, blocks: &[impl Block], settings: &PrintSettings, ) -> bool { blocks.iter().filter(|b| b.is_icon()).all(|b| { if log::log_enabled!(log::Level::Trace) { let val = b.format_value(d, &HashMap::new(), settings); let ret = match &val { Some(v) => settings.encoding.str_is_valid(v), None => false, }; log::trace!( "icon {:?} valid for {:?}: {:?}", val, settings.encoding, ret ); ret } else { match b.format_value(d, &HashMap::new(), settings) { Some(v) => settings.encoding.str_is_valid(&v), None => false, } } }) } /// Formats each [`Block`] value shown from a device `d` pub fn render_value( d: &T, blocks: &[impl Block], pad: &HashMap, settings: &PrintSettings, max_string_length: Option, dimmed: bool, ) -> Vec { let mut ret = Vec::new(); for b in blocks { if let Some(mut string) = b.format_value(d, pad, settings) { // truncate if max_string_length present and before colour applied as this will _add_ chars if b.value_is_variable_length() { if let Some(ml) = max_string_length { truncate_string(&mut string, ml) } } match &settings.colours { Some(c) => { if dimmed { ret.push(format!("{}", string.dimmed().white())) } else { ret.push(format!("{}", b.colour(&string, c))) } } None => ret.push(string.to_string()), }; } } ret } /// Renders the headings for each [`Block`] being shown pub fn render_heading( blocks: &[impl Block], pad: &HashMap, max_string_length: Option, ) -> Vec { let mut ret = Vec::new(); for b in blocks { let mut string = b.heading_padded(pad); if b.value_is_variable_length() { if let Some(ml) = max_string_length { truncate_string(&mut string, ml) } } ret.push(string) } ret } /// Generates tree formatting and values given `current_tree`, current `branch_length` and item `index` in branch fn generate_tree_data( current_tree: &TreeData, branch_length: usize, index: usize, settings: &PrintSettings, ) -> TreeData { let mut pass_tree = current_tree.clone(); // get prefix from icons if tree - maybe should cache these before build rather than lookup each time... if settings.tree { pass_tree.prefix = if pass_tree.depth > 0 { let edge_icon = if index + 1 != pass_tree.branch_length { icon::Icon::TreeLine } else { icon::Icon::TreeBlank }; format!( "{}{}", pass_tree.prefix, settings.icons.as_ref().map_or( icon::get_default_tree_icon(&edge_icon, &settings.encoding), |i| i.get_tree_icon(&edge_icon, &settings.encoding) ) ) } else { pass_tree.prefix.to_string() }; } pass_tree.depth += 1; pass_tree.branch_length = branch_length; pass_tree.trunk_index = index as u8; pass_tree } /// Generates the [`DeviceExtra`] blocks based on the [`PrintSettings`] or defaults. Will also retain based on `is_icon` and [`IconWhen`] setting /// /// If [`IconWhen::Auto`] will render icon block values to check if supported by [`Encoding`] and remove if not fn generate_extra_blocks( extra: &DeviceExtra, settings: &PrintSettings, ) -> ( Vec, Vec, Vec, ) { let mut blocks = ( settings.config_blocks.to_owned().unwrap_or( Block::::default_blocks(settings.more), ), settings.interface_blocks.to_owned().unwrap_or( Block::::default_blocks(settings.more), ), settings.endpoint_blocks.to_owned().unwrap_or( Block::::default_blocks(settings.more), ), ); // auto drop icon blocks depending on IconWhen and Encoding // will drop if any in search is not valid for encoding rather than per device // I think accepable as similar to device block behaviour match settings.icon_when { // if never or auto and no icons, drop IconWhen::Never | IconWhen::Auto if settings.icons.is_none() => { blocks.0.retain(|b| !b.is_icon()); blocks.1.retain(|b| !b.is_icon()); blocks.2.retain(|b| !b.is_icon()); } // skip further processing if including private use area utf8 IconWhen::Auto if settings.encoding == Encoding::Glyphs => (), // always only warn if no icons provided IconWhen::Always => { if settings.icons.is_none() { log::warn!( "{:?} blocks requested but no icons provided", settings.icon_when ); } } // drill through values checking _ => { settings .icon_when .retain(&extra.configurations, &mut blocks.0, settings); extra.configurations.iter().for_each(|c| { settings .icon_when .retain(&c.interfaces, &mut blocks.1, settings); c.interfaces.iter().for_each(|i| { settings .icon_when .retain(&i.endpoints, &mut blocks.2, settings); }); }); } } blocks } /// Passed to print functions to support tree building #[derive(Debug, Default, Clone)] pub struct TreeData { /// Length of the branch sitting on branch_length: usize, /// Index within parent list of devices trunk_index: u8, /// Depth of tree being built - normally len() tree_positions but might not be if printing inner depth: usize, /// Prefix to apply, builds up as depth increases prefix: String, } /// The operation to perform on the blocks when specified by the user #[derive(Default, PartialEq, Eq, Debug, ValueEnum, Clone, Copy, Serialize, Deserialize)] pub enum BlockOperation { /// Add new blocks to the existing blocks, ignoring duplicates Add, /// Append new blocks to the end of the existing blocks Append, /// Replace all blocks with new ones #[default] New, /// Prepend new blocks to the start of the existing blocks Prepend, /// Remove matching blocks from the existing blocks Remove, } impl BlockOperation { /// Create a new or run the operation on the blocks, returning the new blocks pub fn new_or_op, T>( &self, blocks: Option>, new: &[B], verbose: bool, ) -> Result> { if matches!(self, BlockOperation::New) { return Ok(new.to_vec()); } let mut current = blocks.unwrap_or_else(|| B::default_blocks(verbose)); self.run(&mut current, new)?; Ok(current) } /// Run the operation on the blocks, modifying them in place pub fn run(&self, blocks: &mut Vec, new: &[T]) -> Result<()> { match self { BlockOperation::New => { *blocks = new.to_vec(); } BlockOperation::Append => { blocks.extend(new.iter().cloned()); } BlockOperation::Prepend => { let mut new = new.to_vec(); new.append(blocks); *blocks = new; } BlockOperation::Add => { for b in new { if !blocks.contains(b) { blocks.push(b.clone()); } } } BlockOperation::Remove => { for b in new { blocks.retain(|x| x != b); } } } Ok(()) } } /// Used to describe the item being printed #[derive(Debug, Clone, PartialEq, Eq)] pub enum LineItem { /// Bus number Bus(usize), /// Device port path Device(PortPath), /// Configuration number Config(ConfigurationPath), /// Interface name Interface(DevicePath), /// Endpoint Address Endpoint(EndpointPath), /// New lines or other non-item None, } /// DisplayWriter allows control of output to terminal or other Writer /// /// Mainly for watch mode to allow control of output pub struct DisplayWriter { raw_mode: bool, line_context: Vec, inner: W, } impl Write for DisplayWriter { fn write(&mut self, buf: &[u8]) -> io::Result { self.inner.write(buf) } fn flush(&mut self) -> io::Result<()> { self.inner.flush() } } impl Default for DisplayWriter { fn default() -> Self { Self::new(io::stdout()) } } impl DisplayWriter { /// Create a new DisplayWriter with the inner writer pub fn new(inner: W) -> Self { Self { raw_mode: false, line_context: Vec::new(), inner, } } /// Set the raw mode for the writer /// /// Raw mode will print `\r\n` instead of `\n` for newlines pub fn set_raw_mode(&mut self, raw_mode: bool) { self.raw_mode = raw_mode; } /// Print text to the writer pub fn print>(&mut self, text: S) -> io::Result<()> { write!(self.inner, "{}", text.as_ref())?; self.inner.flush()?; Ok(()) } /// Print text to the writer with a newline pub fn println>(&mut self, text: S, item: LineItem) -> io::Result<()> { if self.raw_mode { write!(self.inner, "{}\r\n", text.as_ref())?; } else { writeln!(self.inner, "{}", text.as_ref())?; } self.line_context.push(item); self.inner.flush()?; Ok(()) } /// Get the inner writer pub fn into_inner(self) -> W { self.inner } /// Get the line context for the writer pub fn line_context(&self) -> &Vec { &self.line_context } /// All device [`Endpoint`] pub fn print_endpoints( &mut self, interface: &Interface, blocks: &[EndpointBlocks], settings: &PrintSettings, tree: &TreeData, dimmed: bool, ) { let endpoints = &interface.endpoints; let device_path = interface.device_path(); let mut pad = if !settings.no_padding { let endpoints: Vec<&Endpoint> = endpoints.iter().collect(); EndpointBlocks::generate_padding(&endpoints) } else { HashMap::new() }; pad.retain(|k, _| blocks.contains(k)); let max_variable_string_len: Option = if settings.auto_width { let offset = if settings.tree { tree.depth * 3 + 1 } else { (EndpointBlocks::INSET * LIST_INSET_SPACES) as usize }; let variable_lens: Vec = pad .iter() .filter(|(k, _)| k.value_is_variable_length()) .map(|(_, v)| *v) .collect(); auto_max_string_len(blocks, offset, &variable_lens, settings) .or(settings.max_variable_string_len) } else { settings.max_variable_string_len }; log::trace!("Print endpoints padding {pad:?}, tree {tree:?}"); // if there is a max variable length, adjust padding to this if current > it and is variable if let Some(ml) = max_variable_string_len.as_ref() { for (k, v) in pad.iter_mut() { if k.value_is_variable_length() { *v = cmp::min(*v, *ml); } } } for (i, endpoint) in endpoints.iter().enumerate() { let line_item = if let Some(dp) = device_path.as_ref() { LineItem::Endpoint(EndpointPath::new_with_device_path( dp.to_owned(), endpoint.address.address, )) } else { LineItem::None }; // get current prefix based on if last in tree and whether we are within the tree if settings.tree { let mut prefix = if tree.depth > 0 { let edge_icon = if i + 1 != tree.branch_length { icon::Icon::TreeEdge } else { icon::Icon::TreeCorner }; let edge = settings.icons.as_ref().map_or( icon::get_default_tree_icon(&edge_icon, &settings.encoding), |i| i.get_tree_icon(&edge_icon, &settings.encoding), ); format!("{}{}", tree.prefix, edge) // zero depth } else { tree.prefix.to_string() }; let mut terminator = settings.icons.as_ref().map_or( icon::get_default_tree_icon( &icon::Icon::Endpoint(endpoint.address.direction), &settings.encoding, ), |i| { i.get_tree_icon( &icon::Icon::Endpoint(endpoint.address.direction), &settings.encoding, ) }, ); // colour tree if let Some(ct) = settings.colours.as_ref() { prefix = ct .tree .map_or(prefix.normal(), |c| prefix.color(c)) .to_string(); terminator = if endpoint.address.direction == Direction::In { ct.tree_endpoint_in .map_or(terminator.normal(), |c| terminator.color(c)) .to_string() } else { ct.tree_endpoint_out .map_or(terminator.normal(), |c| terminator.color(c)) .to_string() }; } // maybe should just do once at start of bus if settings.headings && i == 0 { let heading = render_heading(blocks, &pad, max_variable_string_len).join(" "); self.println( format!("{} {}", prefix, heading.bold().underline()), LineItem::None, ) .unwrap(); } // render and print tree if doing it self.print(format!("{prefix}{terminator} ")).unwrap(); self.println( render_value( endpoint, blocks, &pad, settings, max_variable_string_len, dimmed, ) .join(" "), line_item, ) .unwrap(); } else { if settings.headings && i == 0 { let heading = render_heading(blocks, &pad, max_variable_string_len).join(" "); self.println( format!("{:spaces$}{}", "", heading.bold().underline(), spaces = 6), LineItem::None, ) .unwrap(); } self.println( format!( "{:spaces$}{}", "", render_value( endpoint, blocks, &pad, settings, max_variable_string_len, dimmed ) .join(" "), spaces = (EndpointBlocks::INSET * LIST_INSET_SPACES) as usize ), line_item, ) .unwrap(); } } } /// All device [`Interface`] pub fn print_interfaces( &mut self, interfaces: &[Interface], blocks: (&Vec, &Vec), settings: &PrintSettings, tree: &TreeData, dimmed: bool, ) { let mut pad = if !settings.no_padding { let interfaces: Vec<&Interface> = interfaces.iter().collect(); InterfaceBlocks::generate_padding(&interfaces) } else { HashMap::new() }; pad.retain(|k, _| blocks.0.contains(k)); let max_variable_string_len: Option = if settings.auto_width { let offset = if settings.tree { tree.depth * 3 + 1 } else { (InterfaceBlocks::INSET * LIST_INSET_SPACES) as usize }; let variable_lens: Vec = pad .iter() .filter(|(k, _)| k.value_is_variable_length()) .map(|(_, v)| *v) .collect(); auto_max_string_len(blocks.0, offset, &variable_lens, settings) .or(settings.max_variable_string_len) } else { settings.max_variable_string_len }; // if there is a max variable length, adjust padding to this if current > it if let Some(ml) = max_variable_string_len.as_ref() { for (k, v) in pad.iter_mut() { if k.value_is_variable_length() { *v = cmp::min(*v, *ml); } } } log::trace!("Print interfaces padding {pad:?}, tree {tree:?}"); for (i, interface) in interfaces.iter().enumerate() { let line_item = if let Some(dp) = interface.device_path() { LineItem::Interface(dp) } else { LineItem::None }; // get current prefix based on if last in tree and whether we are within the tree if settings.tree { let mut prefix = if tree.depth > 0 { let edge_icon = if i + 1 != tree.branch_length { icon::Icon::TreeEdge } else { icon::Icon::TreeCorner }; let edge = settings.icons.as_ref().map_or( icon::get_default_tree_icon(&edge_icon, &settings.encoding), |i| i.get_tree_icon(&edge_icon, &settings.encoding), ); format!("{}{}", tree.prefix, edge) // zero depth } else { tree.prefix.to_string() }; let mut terminator = settings.icons.as_ref().map_or( icon::get_default_tree_icon( &icon::Icon::TreeInterfaceTerminator, &settings.encoding, ), |i| i.get_tree_icon(&icon::Icon::TreeInterfaceTerminator, &settings.encoding), ); // colour tree if let Some(ct) = settings.colours.as_ref() { prefix = ct .tree .map_or(prefix.normal(), |c| prefix.color(c)) .to_string(); terminator = ct .tree_interface_terminator .map_or(terminator.normal(), |c| terminator.color(c)) .to_string(); } // maybe should just do once at start of bus if settings.headings && i == 0 { let heading = render_heading(blocks.0, &pad, max_variable_string_len).join(" "); self.println( format!("{} {}", prefix, heading.bold().underline()), LineItem::None, ) .unwrap(); } // render and print tree if doing it self.print(format!("{prefix}{terminator} ")).unwrap(); self.println( render_value( interface, blocks.0, &pad, settings, max_variable_string_len, dimmed, ) .join(" "), line_item, ) .unwrap(); } else { if settings.headings && i == 0 { let heading = render_heading(blocks.0, &pad, max_variable_string_len).join(" "); self.println( format!("{:spaces$}{}", "", heading.bold().underline(), spaces = 4), LineItem::None, ) .unwrap(); } self.println( format!( "{:spaces$}{}", "", render_value( interface, blocks.0, &pad, settings, max_variable_string_len, dimmed ) .join(" "), spaces = (InterfaceBlocks::INSET * LIST_INSET_SPACES) as usize ), line_item, ) .unwrap(); } // print the endpoints if settings.verbosity >= 3 || interface.is_expanded() { self.print_endpoints( interface, blocks.1, settings, &generate_tree_data(tree, interface.endpoints.len(), i, settings), dimmed, ); } } } /// All device [`Configuration`] pub fn print_configurations( &mut self, device: &Device, configs: &[Configuration], blocks: ( &Vec, &Vec, &Vec, ), settings: &PrintSettings, tree: &TreeData, ) { let mut pad = if !settings.no_padding { let configs: Vec<&Configuration> = configs.iter().collect(); ConfigurationBlocks::generate_padding(&configs) } else { HashMap::new() }; pad.retain(|k, _| blocks.0.contains(k)); let max_variable_string_len: Option = if settings.auto_width { let offset = if settings.tree { tree.depth * 3 + 1 } else { (ConfigurationBlocks::INSET * LIST_INSET_SPACES) as usize }; let variable_lens: Vec = pad .iter() .filter(|(k, _)| k.value_is_variable_length()) .map(|(_, v)| *v) .collect(); auto_max_string_len(blocks.0, offset, &variable_lens, settings) .or(settings.max_variable_string_len) } else { settings.max_variable_string_len }; // if there is a max variable length, adjust padding to this if current > it if let Some(ml) = max_variable_string_len.as_ref() { for (k, v) in pad.iter_mut() { if k.value_is_variable_length() { *v = cmp::min(*v, *ml); } } } log::trace!("Print configs padding {pad:?}, tree {tree:?}"); for (i, config) in configs.iter().enumerate() { let line_item = LineItem::Config((device.port_path(), config.number)); // get current prefix based on if last in tree and whether we are within the tree if settings.tree { let mut prefix = if tree.depth > 0 { let edge_icon = if i + 1 != tree.branch_length { icon::Icon::TreeEdge } else { icon::Icon::TreeCorner }; let edge = settings.icons.as_ref().map_or( icon::get_default_tree_icon(&edge_icon, &settings.encoding), |i| i.get_tree_icon(&edge_icon, &settings.encoding), ); format!("{}{}", tree.prefix, edge) // zero depth } else { tree.prefix.to_string() }; let mut terminator = settings.icons.as_ref().map_or( icon::get_default_tree_icon( &icon::Icon::TreeConfigurationTerminator, &settings.encoding, ), |i| { i.get_tree_icon( &icon::Icon::TreeConfigurationTerminator, &settings.encoding, ) }, ); // colour tree if let Some(ct) = settings.colours.as_ref() { prefix = ct .tree .map_or(prefix.normal(), |c| prefix.color(c)) .to_string(); terminator = ct .tree_configuration_terminator .map_or(terminator.normal(), |c| terminator.color(c)) .to_string(); } // maybe should just do once at start of bus if settings.headings && i == 0 { let heading = render_heading(blocks.0, &pad, max_variable_string_len).join(" "); self.println( format!("{} {}", prefix, heading.bold().underline()), LineItem::None, ) .unwrap(); } // render and print tree if doing it self.print(format!("{prefix}{terminator} ")).unwrap(); self.println( render_value( config, blocks.0, &pad, settings, max_variable_string_len, device.is_disconnected(), ) .join(" "), line_item, ) .unwrap(); } else { if settings.headings && i == 0 { let heading = render_heading(blocks.0, &pad, max_variable_string_len).join(" "); self.println( format!("{:spaces$}{}", "", heading.bold().underline(), spaces = 2), LineItem::None, ) .unwrap(); } self.println( format!( "{:spaces$}{}", "", render_value( config, blocks.0, &pad, settings, max_variable_string_len, device.is_disconnected() ) .join(" "), spaces = (ConfigurationBlocks::INSET * LIST_INSET_SPACES) as usize ), line_item, ) .unwrap(); } // print the interfaces if settings.verbosity >= 2 || config.is_expanded() { self.print_interfaces( &config.interfaces, ((blocks.1), (blocks.2)), settings, &generate_tree_data(tree, config.interfaces.len(), i, settings), device.is_disconnected(), ); } } } /// Recursively print `devices`; will call for each `Device` devices if `Some` /// /// Will draw tree if `settings.tree`, otherwise it will be flat pub fn print_devices( &mut self, devices: &[Device], db: &Vec, settings: &PrintSettings, tree: &TreeData, padding: &HashMap, ) { let mut padding = padding.clone(); let max_variable_string_len: Option = if settings.auto_width { let offset = if settings.tree { tree.depth * 3 + 1 } else { 0 }; let variable_lens: Vec = padding .iter() .filter(|(k, _)| k.value_is_variable_length()) .map(|(_, v)| *v) .collect(); auto_max_string_len(db, offset, &variable_lens, settings) .or(settings.max_variable_string_len) } else { settings.max_variable_string_len }; // if there is a max variable length, adjust padding to this if current > it if let Some(ml) = max_variable_string_len.as_ref() { for (k, v) in padding.iter_mut() { if k.value_is_variable_length() { *v = cmp::min(*v, *ml); } } } log::trace!("Print devices padding {padding:?}, tree {tree:?}"); for (i, device) in devices.iter().filter(|d| !d.is_hidden()).enumerate() { // get current prefix based on if last in tree and whether we are within the tree if settings.tree { let mut prefix = if tree.depth > 0 { let edge_icon = if i + 1 != tree.branch_length { icon::Icon::TreeEdge } else { icon::Icon::TreeCorner }; let edge = settings.icons.as_ref().map_or( icon::get_default_tree_icon(&edge_icon, &settings.encoding), |i| i.get_tree_icon(&edge_icon, &settings.encoding), ); format!("{}{}", tree.prefix, edge) // zero depth } else { tree.prefix.to_string() }; let icon_terminator = if device.is_disconnected() { icon::Icon::TreeDisconnectedTerminator } else { icon::Icon::TreeDeviceTerminator }; let mut terminator = settings.icons.as_ref().map_or( icon::get_default_tree_icon(&icon_terminator, &settings.encoding), |i| i.get_tree_icon(&icon_terminator, &settings.encoding), ); // colour tree if let Some(ct) = settings.colours.as_ref() { prefix = ct .tree .map_or(prefix.normal(), |c| prefix.color(c)) .to_string(); terminator = ct .tree_bus_terminator .map_or(terminator.normal(), |c| terminator.color(c)) .to_string(); } // maybe should just do once at start of bus if settings.headings && i == 0 { let heading = render_heading(db, &padding, max_variable_string_len).join(" "); self.println( format!("{} {}", prefix, heading.bold().underline()), LineItem::None, ) .unwrap(); } // render and print tree if doing it self.print(format!("{prefix}{terminator} ")).unwrap(); } else if settings.headings && i == 0 { let heading = render_heading(db, &padding, max_variable_string_len).join(" "); self.println(format!("{}", heading.bold().underline()), LineItem::None) .unwrap(); } // print the device let device_string = render_value( device, db, &padding, settings, max_variable_string_len, device.is_disconnected(), ) .join(" "); self.println(&device_string, LineItem::Device(device.port_path())) .unwrap(); // print the configurations if let Some(extra) = device.extra.as_ref() { if settings.verbosity >= 1 || device.is_expanded() { // generate extra blocks if not passed and drop icons if not supported by encoding let blocks = generate_extra_blocks(extra, settings); let num = device .devices .as_ref() .map_or(0, |d| d.iter().filter(|d| !d.is_hidden()).count()); // pass branch length as number of configurations for this device plus devices still to print self.print_configurations( device, &extra.configurations, (&blocks.0, &blocks.1, &blocks.2), settings, &generate_tree_data(tree, extra.configurations.len() + num, i, settings), ); } } else if settings.verbosity >= 1 { log::warn!( "Unable to print verbose information for {device} because libusb extra data is missing" ) } if let Some(d) = device.devices.as_ref() { // and then walk down devices printing them too self.print_devices( d, db, settings, &generate_tree_data( tree, d.iter().filter(|dd| !dd.is_hidden()).count(), i, settings, ), &padding, ); } } } /// Print [`SystemProfile`] [`Bus`] and [`Device`] information pub fn print_sp_usb(&mut self, sp_usb: &SystemProfile, settings: &PrintSettings) { let mut bb = settings .bus_blocks .to_owned() .unwrap_or(Block::::default_blocks(settings.more)); let mut db = settings .device_blocks .to_owned() .unwrap_or(if settings.more { DeviceBlocks::default_blocks(true) } else if settings.tree { DeviceBlocks::default_device_tree_blocks() } else { DeviceBlocks::default_blocks(false) }); // remove icon blocks if not supported by encoding match settings.icon_when { IconWhen::Never | IconWhen::Auto if settings.icons.is_none() => { bb.retain(|b| !b.is_icon()); db.retain(|b| !b.is_icon()); } IconWhen::Auto if settings.encoding == Encoding::Glyphs => (), IconWhen::Always => { if settings.icons.is_none() { log::warn!( "{:?} blocks requested but no icons provided", settings.icon_when ); } } _ => { settings.icon_when.retain(&sp_usb.buses, &mut bb, settings); sp_usb.buses.iter().for_each(|bo| { bo.devices .iter() .for_each(|b| settings.icon_when.retain(b, &mut db, settings)); }); } } let base_tree = TreeData { ..Default::default() }; let mut pad: HashMap = if !settings.no_padding { BusBlocks::generate_padding(&sp_usb.buses.iter().collect::>()) } else { HashMap::new() }; pad.retain(|k, _| bb.contains(k)); let max_variable_string_len: Option = if settings.auto_width { let variable_lens: Vec = pad .iter() .filter(|(k, _)| k.value_is_variable_length()) .map(|(_, v)| *v) .collect(); auto_max_string_len(&bb, base_tree.depth * 3, &variable_lens, settings) .or(settings.max_variable_string_len) } else { settings.max_variable_string_len }; // if there is a max variable length, adjust padding to this if current > it if let Some(ml) = max_variable_string_len.as_ref() { for (k, v) in pad.iter_mut() { if k.value_is_variable_length() { *v = cmp::min(*v, *ml); } } } log::trace!( "print system profile with settings: {settings:?}; padding: {pad:?}; tree {base_tree:?}" ); let len = sp_usb.buses.iter().filter(|b| !b.is_hidden()).count(); for (i, bus) in sp_usb.buses.iter().filter(|b| !b.is_hidden()).enumerate() { if settings.tree { let mut prefix = base_tree.prefix.to_owned(); let mut start = settings.icons.as_ref().map_or( icon::get_default_tree_icon(&icon::Icon::TreeBusStart, &settings.encoding), |i| i.get_tree_icon(&icon::Icon::TreeBusStart, &settings.encoding), ); // colour tree if let Some(ct) = settings.colours.as_ref() { prefix = ct .tree .map_or(prefix.normal(), |c| prefix.color(c)) .to_string(); start = ct .tree_bus_start .map_or(start.normal(), |c| start.color(c)) .to_string(); } if settings.headings { let heading = render_heading(&bb, &pad, max_variable_string_len).join(" "); // 2 spaces for bus start icon and space to info self.println( format!("{:>spaces$}{}", "", heading.bold().underline(), spaces = 2), LineItem::Bus(i), ) .unwrap(); } self.print(format!("{prefix}{start} ")).unwrap() } else if settings.headings { let heading = render_heading(&bb, &pad, max_variable_string_len).join(" "); // 2 spaces for bus start icon and space to info self.println(format!("{}", heading.bold().underline()), LineItem::Bus(i)) .unwrap(); } self.println( render_value(bus, &bb, &pad, settings, max_variable_string_len, false).join(" "), LineItem::Bus(i), ) .unwrap(); if let Some(d) = bus.devices.as_ref() { let num = d.iter().filter(|d| !d.is_hidden()).count(); let tree = generate_tree_data(&base_tree, num, i, settings); let mut padding = if !settings.no_padding { // if tree, generate padding for only local devices // otherwise we need it for all device as flattened if settings.tree { let devices = d .iter() .filter(|d| !d.is_hidden()) .collect::>(); DeviceBlocks::generate_padding(&devices) } else { let devices = bus .flattened_devices() .into_iter() .filter(|d| !d.is_hidden()) .collect::>(); DeviceBlocks::generate_padding(&devices) } } else { HashMap::new() }; padding.retain(|k, _| db.contains(k)); // and then walk down devices printing them too self.print_devices(d, &db, settings, &tree, &padding); } // separate bus groups with line if i + 1 != len { self.println("", LineItem::None).unwrap(); } } } /// Print `devices` [`Device`] references without looking down each device's devices! pub fn print_flattened_devices(&mut self, devices: &[&Device], settings: &PrintSettings) { let mut db = settings .device_blocks .to_owned() .unwrap_or(DeviceBlocks::default_blocks(settings.more)); // remove icon blocks if not supported match settings.icon_when { IconWhen::Never | IconWhen::Auto if settings.icons.is_none() => { db.retain(|b| !b.is_icon()); } IconWhen::Auto if settings.encoding == Encoding::Glyphs => (), IconWhen::Always => { if settings.icons.is_none() { log::warn!( "{:?} blocks requested but no icons provided", settings.icon_when ); } } _ => settings.icon_when.retain_ref(devices, &mut db, settings), } let mut pad = if !settings.no_padding { DeviceBlocks::generate_padding(devices) } else { HashMap::new() }; pad.retain(|k, _| db.contains(k)); log::trace!("Flattened devices padding {pad:?}"); let max_variable_string_len: Option = if settings.auto_width { let variable_lens: Vec = pad .iter() .filter(|(k, _)| k.value_is_variable_length()) .map(|(_, v)| *v) .collect(); auto_max_string_len(&db, 0, &variable_lens, settings) .or(settings.max_variable_string_len) } else { settings.max_variable_string_len }; // if there is a max variable length, adjust padding to this if current > it if let Some(ml) = max_variable_string_len.as_ref() { for (k, v) in pad.iter_mut() { if k.value_is_variable_length() { *v = cmp::min(*v, *ml); } } } if settings.headings { let heading = render_heading(&db, &pad, max_variable_string_len).join(" "); println!("{}", heading.bold().underline()); } for (i, device) in devices.iter().enumerate() { println!( "{}", render_value( *device, &db, &pad, settings, max_variable_string_len, device.is_disconnected() ) .join(" ") ); // print the configurations if let Some(extra) = device.extra.as_ref() { if settings.verbosity >= 1 || device.is_expanded() { let blocks = generate_extra_blocks(extra, settings); // pass branch length as number of configurations for this device plus devices still to print self.print_configurations( device, &extra.configurations, (&blocks.0, &blocks.1, &blocks.2), settings, &generate_tree_data( &Default::default(), extra.configurations.len() + device .devices .as_ref() .map_or(0, |d| d.iter().filter(|d| !d.is_hidden()).count()), i, settings, ), ); } } else if settings.verbosity >= 1 { log::warn!( "Unable to print verbose information for {device} because libusb extra data is missing" ) } } } /// A way of printing a reference flattened [`SystemProfile`] rather than hard flatten /// /// Prints each `&Bus` and tuple pair `Vec<&Device>` pub fn print_bus_grouped( &mut self, bus_devices: Vec<(&Bus, Vec<&Device>)>, settings: &PrintSettings, ) { let bb = settings .bus_blocks .to_owned() .unwrap_or(Block::::default_blocks(settings.more)); let mut pad: HashMap = if !settings.no_padding { let buses: Vec<&Bus> = bus_devices.iter().map(|bd| bd.0).collect(); BusBlocks::generate_padding(&buses) } else { HashMap::new() }; pad.retain(|k, _| bb.contains(k)); let max_variable_string_len: Option = if settings.auto_width { let mut variable_lens = pad.clone(); variable_lens.retain(|k, _| k.value_is_variable_length()); auto_max_string_len(&bb, 0, &variable_lens.into_values().collect(), settings) .or(settings.max_variable_string_len) } else { settings.max_variable_string_len }; // if there is a max variable length, adjust padding to this if current > it if let Some(ml) = max_variable_string_len.as_ref() { for (k, v) in pad.iter_mut() { if k.value_is_variable_length() { *v = cmp::min(*v, *ml); } } } let len = bus_devices.len(); for (i, (bus, devices)) in bus_devices.into_iter().enumerate() { if settings.headings { let heading = render_heading(&bb, &pad, max_variable_string_len).join(" "); self.println(format!("{}", heading.bold().underline()), LineItem::Bus(i)) .unwrap(); } self.println( render_value(bus, &bb, &pad, settings, max_variable_string_len, false).join(" "), LineItem::Bus(i), ) .unwrap(); self.print_flattened_devices(&devices, settings); // new line for each group if i + 1 != len { self.println("", LineItem::None).unwrap(); } } } } /// Mask the `device` serial if it has one using the [`MaskSerial`] method and recursively if `recursive` pub fn mask_serial(device: &mut Device, hide: &MaskSerial, recursive: bool) { if let Some(serial) = device.serial_num.as_mut() { *serial = match hide { MaskSerial::Hide => serial.chars().map(|_| '*').collect::(), MaskSerial::Scramble => serial .chars() .map(|_| { serial .chars() .nth(fastrand::usize(0..serial.len())) .unwrap_or('*') }) .collect::(), MaskSerial::Replace => serial .chars() .map(|_| fastrand::alphanumeric()) .collect::() .to_uppercase(), }; } if recursive { device .devices .iter_mut() .for_each(|dd| dd.iter_mut().for_each(|d| mask_serial(d, hide, recursive))); } } /// Main cyme bin prepare for printing function - changes mutable `sp_usb` with requested `filter` and sort in `settings` pub fn prepare(sp_usb: &mut SystemProfile, filter: Option<&Filter>, settings: &PrintSettings) { // if not printing tree, hard flatten now before filtering as filter will retain non-matching parents with matching devices in tree // flattening now will also mean hubs will be removed when listing if `hide_hubs` because they will appear empty and sorting will be in bus -> device order rather than tree position log::debug!("Running prepare pre-printing"); if !settings.tree && !matches!(settings.print_mode, PrintMode::Dynamic) { log::debug!("Flattening SPUSBDataType"); sp_usb.into_flattened(); } // do the filter if present; will keep parents of matched devices even if they do not match log::debug!("Filtering with {filter:?}"); if let Some(filter) = filter { if matches!(settings.print_mode, PrintMode::Dynamic) { filter.hide_buses(&mut sp_usb.buses); } else { filter.retain_buses(&mut sp_usb.buses); } } // sort device tree based on sort option log::debug!("Sorting with {:?}", settings.sort_devices); settings.sort_devices.sort_buses(&mut sp_usb.buses); // sort the buses if asked and not already sorted if settings.sort_buses && matches!(settings.sort_devices, Sort::NoSort) { log::debug!("Sorting buses by bus number"); sp_usb.buses.sort_by_key(|d| d.get_bus_number()); } // hide serials Recursively if let Some(hide) = settings.mask_serials.as_ref() { log::debug!("Masking serials with {hide:?}"); for bus in &mut sp_usb.buses { bus.devices.iter_mut().for_each(|devices| { for device in devices { mask_serial(device, hide, true); } }); } } log::trace!("sp_usb data post filter and bus sort\n\r{sp_usb:#}"); } /// Main cyme bin print function pub fn print(sp_usb: &SystemProfile, settings: &PrintSettings) { log::trace!("Printing with {settings:?}"); let mut dw = DisplayWriter::default(); if settings.tree || settings.group_devices == Group::Bus { if settings.json { println!("{}", serde_json::to_string_pretty(&sp_usb).unwrap()); } else { dw.print_sp_usb(sp_usb, settings); } } else { // get a list of all devices let devs = sp_usb.flattened_devices(); if settings.json { println!("{}", serde_json::to_string_pretty(&devs).unwrap()); } else { dw.print_flattened_devices(&devs, settings); } } } cyme-2.2.6/src/error.rs000066400000000000000000000105631506545537300147660ustar00rootroot00000000000000//! Error type used within crate with From for commonly used crate errors use std::error; use std::{fmt, io}; /// Result type used within crate pub type Result = std::result::Result; /// Contained with [`ErrorKind`] to provide more context #[derive(Debug, PartialEq, Clone)] pub struct ErrorArg where E: fmt::Debug, G: fmt::Debug, { expected: E, got: G, } impl fmt::Display for ErrorArg { fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result { write!(f, "Expected: {}, Got: {}", self.expected, self.got) } } impl ErrorArg where E: fmt::Debug, G: fmt::Debug, { /// New ErrorArg pub fn new(expected: E, got: G) -> ErrorArg { ErrorArg { expected, got } } /// The expected value pub fn expected(&self) -> &E { &self.expected } /// The actual value pub fn got(&self) -> &G { &self.got } } #[derive(Debug, PartialEq, Clone)] /// Kind of error produced pub enum ErrorKind { /// Error running macOS `system_profiler` command SystemProfiler, /// Unsupported system for command being run; system_profiler not on macOS for example, libusb feature not installed Unsupported, /// Unable to find USB device on bus NotFound, /// Unable to open device to query device descriptors - check permissions Opening, /// Error parsing a string into a value - used for u32 to json deserialization Parsing, /// Error decoding an encoded value into a type Decoding, /// Error parsing config file Config, /// [`std::io::Error`] probably not found when reading file to parse Io, /// libusb error LibUSB, /// nusb error Nusb, /// Stall in control request transfer TransferStall, /// Error calling udev Udev, /// Invalid arg for method or cli InvalidArg, /// Error calling IOKit IoKit, /// Error From other crate without enum variant Other(&'static str), /// Invalid device descriptor InvalidDescriptor, /// Invalid device descriptor length DescriptorLength(ErrorArg), /// Invalid device used in context InvalidDevice, /// Invalid USB path InvalidPath, } #[derive(Debug, PartialEq)] /// Cyme error which impl [`std::error`] pub struct Error { /// The [`ErrorKind`] pub kind: ErrorKind, /// String description pub message: String, } impl Error { /// New error helper pub fn new(kind: ErrorKind, message: &str) -> Error { Error { kind, message: message.to_string(), } } /// New error helper for descriptor length pub fn new_descriptor_len(name: &str, expected: usize, got: usize) -> Error { let error_arg = ErrorArg::new(expected, got); Error { kind: ErrorKind::DescriptorLength(error_arg), message: format!( "Invalid descriptor length for {name}. Expected: {expected}, Got {got}" ), } } /// The [`ErrorKind`] pub fn kind(&self) -> ErrorKind { self.kind.to_owned() } /// The description pub fn message(&self) -> &String { &self.message } } impl error::Error for Error {} impl fmt::Display for Error { fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result { if f.alternate() { write!(f, "{}", self.message) } else { write!(f, "{:?} Error: {}", self.kind, self.message) } } } impl From for Error { fn from(error: io::Error) -> Self { Error { kind: ErrorKind::Io, message: error.to_string(), } } } impl From for Error { fn from(error: serde_json::Error) -> Self { Error { kind: ErrorKind::Parsing, message: error.to_string(), } } } impl From for Error { fn from(error: std::string::FromUtf8Error) -> Self { Error { kind: ErrorKind::Other("FromUtf8Error"), message: error.to_string(), } } } impl From for io::Error { fn from(val: Error) -> Self { io::Error::other(val.message) } } #[cfg(feature = "nusb")] impl From for Error { fn from(error: nusb::Error) -> Self { Error { kind: ErrorKind::Nusb, message: error.to_string(), } } } cyme-2.2.6/src/icon.rs000066400000000000000000000727141506545537300145730ustar00rootroot00000000000000//! Icons and themeing of cyme output #[cfg(feature = "regex_icon")] use regex; use serde::{Deserialize, Serialize}; use serde_with::{DeserializeFromStr, SerializeDisplay}; use std::collections::HashMap; use std::fmt; use std::str::FromStr; use std::sync::LazyLock; use crate::display::Encoding; use crate::error::{Error, ErrorKind}; use crate::profiler::{Bus, Device}; use crate::usb::{BaseClass, Direction}; /// Serialize alphabetically for HashMaps so they don't change each generation fn sort_alphabetically( value: &T, serializer: S, ) -> Result { let value = serde_json::to_value(value).map_err(serde::ser::Error::custom)?; value.serialize(serializer) } /// Icon type enum is used as key in `HashMaps` #[derive(Debug, Clone, Hash, PartialEq, Eq, SerializeDisplay, DeserializeFromStr)] pub enum Icon { /// Vendor ID lookup Vid(u16), /// Vendor ID and Product ID exact match VidPid((u16, u16)), /// Use to mask on msb of product ID VidPidMsb((u16, u8)), /// Class classifier icon Classifier(BaseClass), /// Class classifier lookup with SubClass and Protocol ClassifierSubProtocol((BaseClass, u8, u8)), /// Pattern match device name icon Name(String), /// Icon for unknown vendors UnknownVendor, /// Icon for undefined classifier UndefinedClassifier, /// Icon to use when tree is being printed within an extending branch TreeEdge, /// Icon to use for non-last list item TreeLine, /// Icon to use at last item in list TreeCorner, /// Blanking icon for inset without edge TreeBlank, /// Icon at prepended before printing `Bus` TreeBusStart, /// Icon printed at end of tree before printing `Device` TreeDeviceTerminator, /// Icon printed at end of tree before printing configuration TreeConfigurationTerminator, /// Icon printed at end of tree before printing interface TreeInterfaceTerminator, /// Icon printed at end of tree before disconnected device TreeDisconnectedTerminator, /// Icon for endpoint direction Endpoint(Direction), /// Icon for profiled state Profiled, /// Icon for connected state Connected, /// Icon for disconnected state Disconnected, } impl FromStr for Icon { type Err = Error; fn from_str(s: &str) -> Result { let value_split: Vec<&str> = s.split('#').collect(); let enum_name = value_split[0]; // no value in string, match kebab-case if value_split.len() == 1 { match enum_name { "unknown-vendor" => Ok(Icon::UnknownVendor), "undefined-classifier" => Ok(Icon::UndefinedClassifier), "tree-edge" => Ok(Icon::TreeEdge), "tree-blank" => Ok(Icon::TreeBlank), "tree-line" => Ok(Icon::TreeLine), "tree-corner" => Ok(Icon::TreeCorner), "tree-bus-start" => Ok(Icon::TreeBusStart), "tree-device-terminator" => Ok(Icon::TreeDeviceTerminator), "tree-configuration-terminator" => Ok(Icon::TreeConfigurationTerminator), "tree-interface-terminator" => Ok(Icon::TreeInterfaceTerminator), "tree-disconnected-terminator" => Ok(Icon::TreeDisconnectedTerminator), "endpoint_in" => Ok(Icon::Endpoint(Direction::In)), "endpoint_out" => Ok(Icon::Endpoint(Direction::Out)), "profiled" => Ok(Icon::Profiled), "connected" => Ok(Icon::Connected), "disconnected" => Ok(Icon::Disconnected), _ => Err(Error::new( ErrorKind::Parsing, "Invalid Icon enum name or valued enum without value", )), } // name#pattern } else if matches!(enum_name, "name") { #[cfg(feature = "regex_icon")] match regex::Regex::new(value_split[1]) { Ok(_) => Ok(Icon::Name(value_split[1].to_string())), Err(_) => Err(Error::new( ErrorKind::Parsing, &format!( "Invalid regex pattern in Icon::Name enum string: {}", value_split[1] ), )), } #[cfg(not(feature = "regex_icon"))] Err(Error::new( ErrorKind::Parsing, "regex_icon feature not enabled for Icon::Name matching", )) // enum contains value } else { let (parse_ints, errors): (Vec>, Vec<_>) = value_split[1] .split(':') .map(|vs| u32::from_str_radix(vs.trim_start_matches("0x"), 16)) .partition(Result::is_ok); let numbers: Vec = parse_ints.into_iter().map(|v| v.unwrap() as u16).collect(); if !errors.is_empty() { return Err(Error::new( ErrorKind::Parsing, "Invalid value in enum string after #", )); } match value_split[0] { "vid" => match numbers.first() { Some(i) => Ok(Icon::Vid(*i)), None => Err(Error::new(ErrorKind::Parsing, "No value for enum after $")), }, "vid-pid" => match numbers.get(0..2) { Some(slice) => Ok(Icon::VidPid((slice[0], slice[1]))), None => Err(Error::new(ErrorKind::Parsing, "No value for enum after $")), }, "vid-pid-msb" => match numbers.get(0..2) { Some(slice) => Ok(Icon::VidPidMsb((slice[0], slice[1] as u8))), None => Err(Error::new(ErrorKind::Parsing, "No value for enum after $")), }, "classifier" => match numbers.first() { Some(i) => Ok(Icon::Classifier(BaseClass::from(*i as u8))), None => Err(Error::new(ErrorKind::Parsing, "No value for enum after $")), }, "classifier-sub-protocol" => match numbers.get(0..3) { Some(slice) => Ok(Icon::ClassifierSubProtocol(( BaseClass::from(slice[0] as u8), slice[1] as u8, slice[2] as u8, ))), None => Err(Error::new(ErrorKind::Parsing, "No value for enum after $")), }, _ => Err(Error::new( ErrorKind::Parsing, "Invalid Icon enum value holder", )), } } } } impl fmt::Display for Icon { /// Output is a Enum kebab case with # separating base16 : separated values, _ if String value /// /// ``` /// use cyme::icon::*; /// /// let icon: Icon = Icon::VidPid((0x1d50, 0x6018)); /// assert_eq!(format!("{}", icon), "vid-pid#1d50:6018"); /// /// let icon: Icon = Icon::UnknownVendor; /// assert_eq!(format!("{}", icon), "unknown-vendor"); /// ``` /// fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result { match self { Icon::Vid(v) => write!(f, "vid#{v:04x}"), Icon::VidPid((v, p)) => write!(f, "vid-pid#{v:04x}:{p:04x}"), Icon::VidPidMsb((v, p)) => write!(f, "vid-pid-msb#{v:04x}:{p:02x}"), Icon::Classifier(c) => write!(f, "classifier#{:02x}", u8::from(c.to_owned())), Icon::ClassifierSubProtocol(c) => write!( f, "classifier-sub-protocol#{:02x}:{:02x}:{:02x}", u8::from(c.0.to_owned()), c.1, c.2 ), Icon::Name(s) => write!(f, "name#{s}"), Icon::Endpoint(Direction::In) => write!(f, "endpoint_in"), Icon::Endpoint(Direction::Out) => write!(f, "endpoint_out"), _ => { let dbg_str = format!("{self:?}"); write!(f, "{}", heck::AsKebabCase(dbg_str)) } } } } /// Allows user supplied icons to replace or add to [`static@DEFAULT_ICONS`] and [`static@DEFAULT_UTF8_TREE`] #[derive(Debug, Serialize, Deserialize, PartialEq, Eq, Clone)] #[serde(rename_all = "kebab-case")] #[serde(deny_unknown_fields)] #[serde(default)] pub struct IconTheme { /// Will merge with [`static@DEFAULT_ICONS`] for user supplied #[serde(serialize_with = "sort_alphabetically")] pub user: Option>, /// Will merge with [`static@DEFAULT_UTF8_TREE`] for user supplied tree drawing #[serde(serialize_with = "sort_alphabetically")] pub tree: Option>, } /// Make default icons lazy_static and outside of IconTheme keeps them static but can be overridden user HashMap at runtime impl Default for IconTheme { fn default() -> Self { IconTheme { user: None, tree: None, } } } /// Default icons to draw tree can be overridden by user icons with IconTheme `tree` pub static DEFAULT_UTF8_TREE: LazyLock> = LazyLock::new(|| { HashMap::from([ (Icon::TreeEdge, "\u{251c}\u{2500}\u{2500}"), // "├──" (Icon::TreeLine, "\u{2502} "), // "│ " (Icon::TreeCorner, "\u{2514}\u{2500}\u{2500}"), // "└──" (Icon::TreeBlank, " "), // should be same char width as above (Icon::TreeBusStart, "\u{25CF}"), // "â—" (Icon::TreeDeviceTerminator, "\u{25CB}"), // "â—‹" (Icon::TreeConfigurationTerminator, "\u{2022}"), // "•" (Icon::TreeInterfaceTerminator, "\u{25E6}"), // "â—¦" (Icon::TreeDisconnectedTerminator, "\u{2715}"), // "×" (Icon::Endpoint(Direction::In), "\u{2192}"), // → (Icon::Endpoint(Direction::Out), "\u{2190}"), // ↠]) }); /// Ascii chars used by lsusb compatible mode or no utf-8 pub static DEFAULT_ASCII_TREE: LazyLock> = LazyLock::new(|| { HashMap::from([ (Icon::TreeEdge, "|__"), // same as corner (Icon::TreeLine, "| "), // no outside line but inset so starts under parent device (Icon::TreeCorner, "|__"), (Icon::TreeBlank, " "), // inset like line (Icon::TreeBusStart, "/: "), (Icon::TreeDeviceTerminator, "O"), (Icon::TreeConfigurationTerminator, "o"), (Icon::TreeInterfaceTerminator, "."), (Icon::TreeDisconnectedTerminator, "X"), (Icon::Endpoint(Direction::In), ">"), (Icon::Endpoint(Direction::Out), "<"), ]) }); /// Default icon lookup can be overridden by user icons with IconTheme `icons` /// /// Should probably keep fairly short but I've added things I use like debuggers, mcus as examples pub static DEFAULT_ICONS: LazyLock> = LazyLock::new(|| { HashMap::from([ (Icon::UnknownVendor, "\u{f287}"), // usb plug default  (Icon::Vid(0x05ac), "\u{f179}"), // apple ï…¹ (Icon::Vid(0x045e), "\u{f0372}"), // microsoft ó°² (Icon::Vid(0x18d1), "\u{f1a0}"), // google  (Icon::Vid(0x1D6B), "\u{f17c}"), // linux foundation ï…¼ (Icon::Vid(0x1d50), "\u{e771}"), // open source VID î± (Icon::VidPid((0x1915, 0x520c)), "\u{f00a3}"), // specialized ó°‚£ (Icon::VidPid((0x1915, 0x520d)), "\u{f00a3}"), // specialized ó°‚£ (Icon::VidPid((0x0483, 0x572B)), "\u{f00a3}"), // specialized ó°‚£ (Icon::Vid(0x046d), "\u{f037d}"), // logitech ó°½ (Icon::Vid(0x091e), "\u{e2a6}"), // garmin  (Icon::VidPid((0x1d50, 0x6018)), "\u{f188}"), // black magic probe  (Icon::Vid(0x1366), "\u{f188}"), // segger  (Icon::Vid(0xf1a0), "\u{f188}"), // arm  (Icon::VidPidMsb((0x0483, 0x37)), "\u{f188}"), // st-link  (Icon::VidPid((0x0483, 0xdf11)), "\u{f019}"), // STM DFU  (Icon::VidPid((0x1d50, 0x6017)), "\u{f188}"), // black magic probe DFU  ( Icon::ClassifierSubProtocol((BaseClass::ApplicationSpecificInterface, 0x01, 0x01)), "\u{f188}", ), // DFU  ( Icon::ClassifierSubProtocol((BaseClass::WirelessController, 0x01, 0x01)), "\u{f188}", ), // bluetooth DFU  (Icon::Vid(0x2341), "\u{f2db}"), // arduino ï‹› (Icon::Vid(0x239A), "\u{f2db}"), // adafruit ï‹› (Icon::Vid(0x2e8a), "\u{f315}"), // raspberry pi foundation  (Icon::Vid(0x0483), "\u{f2db}"), // stm ï‹› (Icon::Vid(0x1915), "\u{f2db}"), // nordic ï‹› (Icon::Vid(0x1fc9), "\u{f2db}"), // nxp ï‹› (Icon::Vid(0x1050), "\u{f084}"), // yubikey ï‚„ (Icon::Vid(0x0781), "\u{f129e}"), // sandisk 󱊞 #[cfg(feature = "regex_icon")] ( Icon::Name(r".*^[sS][dD]\s[cC]ard\s[rR]eader.*".to_string()), "\u{ef61}", ), // sd card reader  (Icon::VidPid((0x18D1, 0x2D05)), "\u{e70e}"), // android dev  (Icon::VidPid((0x18D1, 0xd00d)), "\u{e70e}"), // android  (Icon::VidPid((0x1d50, 0x606f)), "\u{f191d}"), // candlelight_fw gs_can ó±¤ (Icon::VidPidMsb((0x043e, 0x9a)), "\u{f0379}"), // lg monitor ó°¹ (Icon::Classifier(BaseClass::Audio), "\u{f001}"), // ï€ (Icon::Classifier(BaseClass::Image), "\u{f03e}"), //  (Icon::Classifier(BaseClass::Video), "\u{f03d}"), //  (Icon::Classifier(BaseClass::Printer), "\u{f02f}"), //  (Icon::Classifier(BaseClass::MassStorage), "\u{f0a0}"), // ï‚  (Icon::Classifier(BaseClass::Hub), "\u{f126}"), //  (Icon::Classifier(BaseClass::ContentSecurity), "\u{f084}"), // ï‚„ (Icon::Classifier(BaseClass::SmartCard), "\u{f084}"), // ï‚„ (Icon::Classifier(BaseClass::PersonalHealthcare), "\u{f21e}"), //  (Icon::Classifier(BaseClass::AudioVideo), "\u{f0841}"), // ó°¡ (Icon::Classifier(BaseClass::Billboard), "\u{f05a}"), // ïš (Icon::Classifier(BaseClass::I3cDevice), "\u{f493}"), // ï’“ (Icon::Classifier(BaseClass::Diagnostic), "\u{f489}"), // ï’‰ (Icon::Classifier(BaseClass::WirelessController), "\u{f1eb}"), //  (Icon::Classifier(BaseClass::Miscellaneous), "\u{f074}"), // ï´ (Icon::Classifier(BaseClass::CdcCommunications), "\u{e795}"), // serial îž• (Icon::Classifier(BaseClass::CdcData), "\u{e795}"), // serial îž• (Icon::Classifier(BaseClass::Hid), "\u{f030c}"), // 󰌌 (Icon::UndefinedClassifier, "\u{2636}"), //☶ (Icon::Profiled, "\u{f041a}"), // ó°š (Icon::Connected, "\u{f0c53}"), // 󰱓 (Icon::Disconnected, "\u{f015b}"), // ó°…› ]) }); impl IconTheme { /// New theme with defaults pub fn new() -> Self { Default::default() } /// Get tree building icon checks `Self` for user `tree` and tries to find `icon` there, otherwise uses [`static@DEFAULT_UTF8_TREE`] /// /// Also checks if user icon is valid for encoding, if not will return default for that encoding pub fn get_tree_icon(&self, icon: &Icon, encoding: &Encoding) -> String { // unwrap on DEFAULT_UTF8_TREE is ok here since should panic if missing from static list if let Some(user_tree) = self.tree.as_ref() { user_tree .get(icon) .map(|s| match encoding.str_is_valid(s) { true => s.to_owned(), false => get_default_tree_icon(icon, encoding), }) .unwrap_or(get_default_tree_icon(icon, encoding)) } else { get_default_tree_icon(icon, encoding) } } /// Drill through [`static@DEFAULT_ICONS`] first looking for `VidPid` -> `VidPidMsb` -> `Vid` -> `UnknownVendor` -> "" pub fn get_default_vidpid_icon(vid: u16, pid: u16) -> String { // try vid pid first DEFAULT_ICONS .get(&Icon::VidPid((vid, pid))) .unwrap_or( DEFAULT_ICONS .get(&Icon::VidPidMsb((vid, (pid >> 8) as u8))) .unwrap_or( DEFAULT_ICONS .get(&Icon::Vid(vid)) .unwrap_or(DEFAULT_ICONS.get(&Icon::UnknownVendor).unwrap_or(&"")), ), ) .to_string() } /// Drill through `Self` `icons` if present first looking for `VidPid` -> `VidPidMsb` -> `Vid` -> `UnknownVendor` -> `get_default_vidpid_icon` pub fn get_vidpid_icon(&self, vid: u16, pid: u16) -> String { if let Some(user_icons) = self.user.as_ref() { // try vid pid first user_icons .get(&Icon::VidPid((vid, pid))) .unwrap_or( user_icons .get(&Icon::VidPidMsb((vid, (pid >> 8) as u8))) .unwrap_or( user_icons.get(&Icon::Vid(vid)).unwrap_or( user_icons .get(&Icon::UnknownVendor) .unwrap_or(&IconTheme::get_default_vidpid_icon(vid, pid)), ), ), ) .to_owned() } else { IconTheme::get_default_vidpid_icon(vid, pid) } } /// Get icon for device from static default lookup pub fn get_default_device_icon(d: &Device) -> String { if let (Some(vid), Some(pid)) = (d.vendor_id, d.product_id) { IconTheme::get_default_vidpid_icon(vid, pid) } else { String::new() } } /// Get icon for Device `d` by checking `Self` using Name, Vendor ID and Product ID #[cfg(feature = "regex_icon")] pub fn get_device_icon(&self, d: &Device) -> String { // try name first since vidpid will return UnknownVendor default icon if not found // does mean regex will be built/checked for every device match self.get_name_icon(&d.name) { s if !s.is_empty() => s, _ => { if let (Some(vid), Some(pid)) = (d.vendor_id, d.product_id) { self.get_vidpid_icon(vid, pid) } else { String::new() } } } } /// Get icon for Device `d` by checking `Self` using Vendor ID and Product ID #[cfg(not(feature = "regex_icon"))] pub fn get_device_icon(&self, d: &Device) -> String { if let (Some(vid), Some(pid)) = (d.vendor_id, d.product_id) { self.get_vidpid_icon(vid, pid) } else { DEFAULT_ICONS .get(&Icon::UnknownVendor) .unwrap_or(&"") .to_string() } } /// Get icon for Bus `d` by checking `Self` using PCI Vendor and PCI Device pub fn get_bus_icon(&self, d: &Bus) -> String { if let (Some(vid), Some(pid)) = (d.pci_vendor, d.pci_device) { self.get_vidpid_icon(vid, pid) } else { DEFAULT_ICONS .get(&Icon::UnknownVendor) .unwrap_or(&"") .to_string() } } /// Drill through `DEFAULT_ICONS` first looking for `ClassifierSubProtocol` -> `Classifier` -> `UndefinedClassifier` -> "" pub fn get_default_classifier_icon(class: &BaseClass, sub: u8, protocol: u8) -> String { // try vid pid first DEFAULT_ICONS .get(&Icon::ClassifierSubProtocol(( class.to_owned(), sub, protocol, ))) .unwrap_or( DEFAULT_ICONS .get(&Icon::Classifier(class.to_owned())) .unwrap_or(DEFAULT_ICONS.get(&Icon::UndefinedClassifier).unwrap_or(&"")), ) .to_string() } /// Drill through `Self` icons first looking for `ClassifierSubProtocol` -> `Classifier` -> `UndefinedClassifier` -> get_default_classifier_icon pub fn get_classifier_icon(&self, class: &BaseClass, sub: u8, protocol: u8) -> String { if let Some(user_icons) = self.user.as_ref() { user_icons .get(&Icon::ClassifierSubProtocol(( class.to_owned(), sub, protocol, ))) .unwrap_or( user_icons .get(&Icon::Classifier(class.to_owned())) .unwrap_or(&IconTheme::get_default_classifier_icon( class, sub, protocol, )), ) .to_owned() } else { IconTheme::get_default_classifier_icon(class, sub, protocol) } } /// Get default icon for device based on descriptor name pattern `[Icon::Name]` pattern match #[cfg(feature = "regex_icon")] pub fn get_default_name_icon(name: &str) -> String { DEFAULT_ICONS .iter() .find(|(k, _)| { if let Icon::Name(s) = k { regex::Regex::new(s).is_ok_and(|r| r.is_match(name)) } else { false } }) .map(|(_, v)| v.to_owned()) .unwrap_or("") .to_string() } /// Get icon for device based on descriptor name pattern `[Icon::Name]` pattern match #[cfg(feature = "regex_icon")] pub fn get_name_icon(&self, name: &str) -> String { if let Some(user_icons) = self.user.as_ref() { user_icons .iter() .find(|(k, _)| { if let Icon::Name(s) = k { regex::Regex::new(s).is_ok_and(|r| r.is_match(name)) } else { false } }) .map(|(_, v)| v.to_owned()) .unwrap_or(String::new()) } else { IconTheme::get_default_name_icon(name) } } /// Get icon for event based on [`crate::profiler::DeviceEvent`] type pub fn get_event_icon(&self, event: &crate::profiler::DeviceEvent) -> String { use crate::profiler::DeviceEvent; match event { DeviceEvent::Profiled(_) => self .user .as_ref() .and_then(|u| u.get(&Icon::Profiled)) .unwrap_or( &DEFAULT_ICONS .get(&Icon::Profiled) .unwrap_or(&"") .to_string(), ) .to_string(), DeviceEvent::Connected(_) => self .user .as_ref() .and_then(|u| u.get(&Icon::Connected)) .unwrap_or( &DEFAULT_ICONS .get(&Icon::Connected) .unwrap_or(&"") .to_string(), ) .to_string(), DeviceEvent::Disconnected(_) => self .user .as_ref() .and_then(|u| u.get(&Icon::Disconnected)) .unwrap_or( &DEFAULT_ICONS .get(&Icon::Disconnected) .unwrap_or(&"") .to_string(), ) .to_string(), } } } /// Gets tree icon from [`static@DEFAULT_UTF8_TREE`] or [`static@DEFAULT_ASCII_TREE`] (depanding on [`Encoding`]) as `String` with `unwrap` because should panic if missing from there pub fn get_default_tree_icon(i: &Icon, encoding: &Encoding) -> String { match encoding { Encoding::Utf8 | Encoding::Glyphs => DEFAULT_UTF8_TREE.get(i).unwrap().to_string(), Encoding::Ascii => DEFAULT_ASCII_TREE.get(i).unwrap().to_string(), } } /// Gets tree icon from [`static@DEFAULT_ASCII_TREE`] as `String` with `unwrap` because should panic if missing from there pub fn get_ascii_tree_icon(i: &Icon) -> String { DEFAULT_ASCII_TREE.get(i).unwrap().to_string() } /// Returns clone of lazy_static defaults pub fn defaults() -> HashMap { DEFAULT_ICONS.clone() } /// Returns example list of icons with all [`Icon`] types pub fn example() -> HashMap { HashMap::from([ (Icon::UnknownVendor, "\u{f287}".into()), // usb plug default  (Icon::Vid(0x05ac), "\u{f179}".into()), // apple ï…¹ (Icon::VidPid((0x1d50, 0x6018)), "\u{f188}".into()), // black magic probe  (Icon::VidPidMsb((0x0483, 0x37)), "\u{f188}".into()), // st-link  ( Icon::ClassifierSubProtocol((BaseClass::ApplicationSpecificInterface, 0x01, 0x01)), "\u{f188}".into(), ), // DFU  (Icon::Vid(0x2e8a), "\u{f315}".into()), // raspberry pi foundation  ( Icon::Classifier(BaseClass::CdcCommunications), "\u{e795}".into(), ), // serial îž• (Icon::UndefinedClassifier, "\u{2636}".into()), //☶ #[cfg(feature = "regex_icon")] ( Icon::Name(r".*^[sS][dD]\s[cC]ard\s[rR]eader.*".to_string()), "\u{ef61}".into(), ), // sd card reader  ]) } /// Returns example theme with [`Icon`] types and default tree pub fn example_theme() -> IconTheme { let tree_strings: HashMap = DEFAULT_UTF8_TREE .iter() .map(|(k, v)| (k.to_owned(), v.to_string())) .collect(); IconTheme { user: Some(example()), tree: Some(tree_strings), } } #[cfg(test)] mod tests { use super::*; #[test] fn test_serialize_theme() { let theme = IconTheme { user: Some(HashMap::from([ (Icon::UnknownVendor, "\u{f287}".into()), // usb plug default  ])), ..Default::default() }; assert_eq!( serde_json::to_string(&theme).unwrap(), "{\"user\":{\"unknown-vendor\":\"\"},\"tree\":null}" ); } #[test] fn test_deserialize_theme() { let theme: IconTheme = serde_json::from_str("{\"user\":{\"unknown-vendor\":\"\"},\"tree\":null}").unwrap(); let actual_theme = IconTheme { user: Some(HashMap::from([ (Icon::UnknownVendor, "\u{f287}".into()), // usb plug default  ])), ..Default::default() }; assert_eq!(theme, actual_theme); } #[test] fn test_serialize_defaults() { serde_json::to_string(&defaults()).unwrap(); } #[test] fn test_serialize_example() { println!("{}", serde_json::to_string_pretty(&example()).unwrap()); } #[test] fn test_deserialize_icon_tuples() { let item: (Icon, &'static str) = (Icon::VidPid((0x1d50, 0x6018)), "\u{f188}"); let item_ser = serde_json::to_string(&item).unwrap(); assert_eq!(item_ser, r#"["vid-pid#1d50:6018",""]"#); let item: (Icon, &'static str) = (Icon::Endpoint(Direction::In), ">"); let item_ser = serde_json::to_string(&item).unwrap(); assert_eq!(item_ser, r#"["endpoint_in",">"]"#); let item: (Icon, &'static str) = ( Icon::ClassifierSubProtocol((BaseClass::Hid, 0x01, 0x0a)), "K", ); let item_ser = serde_json::to_string(&item).unwrap(); assert_eq!(item_ser, r#"["classifier-sub-protocol#03:01:0a","K"]"#); } #[test] fn icon_from_str() { let str = "vid#1d50"; let icon = Icon::from_str(str); assert_eq!(icon.unwrap(), Icon::Vid(7504)); let str = "vid-pid#1d50:6018"; let icon = Icon::from_str(str); assert_eq!(icon.unwrap(), Icon::VidPid((7504, 24600))); let str = "classifier#03"; let icon = Icon::from_str(str); assert_eq!(icon.unwrap(), Icon::Classifier(BaseClass::Hid)); let str = "classifier-sub-protocol#03:01:0a"; let icon = Icon::from_str(str); assert_eq!( icon.unwrap(), Icon::ClassifierSubProtocol((BaseClass::Hid, 1, 10)) ); let str = "endpoint_in"; let icon = Icon::from_str(str); assert_eq!(icon.unwrap(), Icon::Endpoint(Direction::In)); let str = "unknown-vendor"; let icon = Icon::from_str(str); assert_eq!(icon.unwrap(), Icon::UnknownVendor); if cfg!(feature = "regex_icon") { let str = "name#test"; let icon = Icon::from_str(str); assert_eq!(icon.unwrap(), Icon::Name("test".to_string())); let str = r"name#.*^[sS][dD]\s[cC]ard\s[rR]eader.*"; let icon = Icon::from_str(str); assert_eq!( icon.unwrap(), Icon::Name(r".*^[sS][dD]\s[cC]ard\s[rR]eader.*".to_string()) ); } } #[test] #[cfg(feature = "regex_icon")] fn icon_match_name() { let mut device = Device { name: "SD Card Reader".to_string(), ..Default::default() }; let theme = IconTheme { user: Some(HashMap::from([( Icon::Name(r".*^[sS][dD]\s[cC]ard\s[rR]eader.*".to_string()), "\u{ef61}".into(), )])), ..Default::default() }; let icon = theme.get_device_icon(&device); assert_eq!(icon, "\u{ef61}"); device.name = "sD Card reader 2".to_string(); let icon = theme.get_device_icon(&device); assert_eq!(icon, "\u{ef61}"); } } cyme-2.2.6/src/lib.rs000066400000000000000000000035441506545537300144040ustar00rootroot00000000000000//! List system USB buses and devices; a modern `lsusb` that attempts to maintain compatibility with, but also add new features. //! //! # Examples //! //! Profile USB devices on cross-platform systems: //! //! ```no_run //! use cyme::profiler; //! let sp_usb = profiler::get_spusb().unwrap(); //! ``` //! //! Profile USB devices with all extra descriptor data (requires opening devices) on cross-platform systems: //! //! ```no_run //! use cyme::profiler; //! let sp_usb = profiler::get_spusb_with_extra().unwrap(); //! ``` //! //! It's often useful to then flatten this into a list of devices ([`profiler::Device`]): //! //! ```no_run //! # use cyme::profiler; //! # let sp_usb = profiler::get_spusb().unwrap(); //! // flatten since we don't care tree/buses //! let devices = sp_usb.flattened_devices(); //! //! for device in devices { //! format!("{}", device); //! } //! ``` //! //! One can then print with the cyme display module: //! //! ```no_run //! # use cyme::profiler; //! # let sp_usb = profiler::get_spusb().unwrap(); //! # let devices = sp_usb.flattened_devices(); //! use cyme::display; //! // print with default [`display::PrintSettings`] //! display::DisplayWriter::default().print_flattened_devices(&devices, &display::PrintSettings::default()); //! ``` //! //! The [`profiler::SystemProfile`] struct contains system [`profiler::Bus`]s, which contain [`profiler::Device`]s as a USB tree. #![allow(dead_code)] #![warn(missing_docs)] pub mod colour; pub mod config; pub mod display; pub mod error; pub mod icon; pub mod lsusb; pub mod profiler; pub mod types; #[cfg(all(target_os = "linux", feature = "udev"))] pub mod udev; #[cfg(all(all(target_os = "linux", feature = "udevlib"), not(feature = "udev")))] #[path = "udev_ffi.rs"] pub mod udev; pub mod usb; // run any Rust code as doctest #[doc = include_str!("../README.md")] #[cfg(doctest)] pub struct ReadmeDoctests; cyme-2.2.6/src/lsusb.rs000066400000000000000000002375741506545537300150020ustar00rootroot00000000000000//! Methods to print system USB information in lsusb style //! //! Originally based on [libusb list_devices.rs example](https://github.com/dcuddeback/libusb-rs/blob/master/examples/list_devices.rs), attempts to mimic lsusb output. The [lsusb source code](https://github.com/gregkh/usbutils/blob/master/lsusb.c) was used as a reference for the styling and content; even odities/inconsistencies were kept! use crate::display::PrintSettings; use crate::error::{Error, ErrorKind}; use crate::profiler::{Device, SystemProfile}; use std::path::Path; use uuid::Uuid; use crate::usb::descriptors::audio; use crate::usb::descriptors::cdc; use crate::usb::descriptors::video; use crate::usb::descriptors::*; use crate::usb::*; mod audio_dumps; mod bos_dumps; pub mod names; mod video_dumps; use audio_dumps::*; use bos_dumps::*; use video_dumps::*; const TREE_LSUSB_BUS: &str = "/: "; const TREE_LSUSB_DEVICE: &str = "|__ "; const TREE_LSUSB_SPACE: &str = " "; const LSUSB_DUMP_WIDTH: usize = 25; const LSUSB_DUMP_INDENT_BASE: usize = 2; fn get_spaces(value_len: usize, field_len: usize, width: usize) -> String { if value_len >= width || value_len == usize::MAX { String::from(" ") } else { " ".repeat((width - value_len).saturating_sub(field_len).max(1)) } } /// Dump an array of value like lsusb fn dump_array(array: &[T], field_name: &str, indent: usize, width: usize) { for (i, b) in array.iter().enumerate() { dump_value(b, &format!("{field_name}({i:2})"), indent, width); } } /// Dump a bitmap value mapping as hex like lsusb fn dump_bitmap_array + Copy>( array: &[T], field_name: &str, indent: usize, width: usize, ) { for (i, b) in array.iter().enumerate() { dump_hex(*b, &format!("{field_name}({i:2})"), indent, width); } } /// Dump just indented string fn dump_string(field_name: &str, indent: usize) { println!("{:indent$}{}", "", field_name); } /// Dump a single value like lsusb fn dump_value(value: T, field_name: &str, indent: usize, width: usize) { let value = value.to_string(); let spaces = get_spaces(value.len(), field_name.len(), width); println!("{:indent$}{}{}{}", "", field_name, spaces, value); } /// Dump a single hex value like lsusb fn dump_hex>( value: T, field_name: &str, indent: usize, width: usize, ) { let value_as_u64: u64 = value.into(); let hex_value = format!( "0x{:0width$x}", value_as_u64, width = (std::mem::size_of::() * 2) ); dump_value(hex_value, field_name, indent, width); } /// Lookup the name of the value from passed function and dump it fn dump_name( value: T, names_f: fn(T) -> Option, field_name: &str, indent: usize, width: usize, ) { let value_string = value.to_string(); let spaces = get_spaces(value_string.len(), field_name.len(), width); let dump = format!("{:indent$}{}{}{}", "", field_name, spaces, value_string,); if let Some(name) = names_f(value) { println!("{dump} {name}"); } } /// Dumps the value and the string representation of the value to the right of width fn dump_value_string( value: T, field_name: &str, value_string: S, indent: usize, width: usize, ) { let value = value.to_string(); let spaces = get_spaces(value.len(), field_name.len(), width); println!( "{:indent$}{}{}{} {}", "", field_name, spaces, value, value_string, ); } /// Dumps a string starting at value position, right aligned fn dump_string_right(guid: T, field_name: &str, indent: usize, width: usize) { // 1 to account for space let spaces = get_spaces(1, field_name.len(), width); println!("{:indent$}{}{}{}", "", field_name, spaces, guid); } /// Dumps GUID enclosed in braces like lsusb fn dump_guid(guid: &Uuid, field_name: &str, indent: usize, width: usize) { dump_string_right(guid.braced().to_string(), field_name, indent, width); } /// Dumps junk descriptor bytes as hex like lsusb fn dump_junk(extra: &[u8], indent: usize, reported_len: usize, expected_len: usize) { if reported_len > expected_len && extra.len() >= reported_len { println!( "{:^indent$}junk at descriptor end: {}", "", extra[expected_len..reported_len] .iter() .map(|b| format!("{b:02x}")) .collect::>() .join(" ") ) } } /// Dumps unknown descriptor bytes as hex like lsusb fn dump_unrecognised(extra: &[u8], indent: usize) { println!( "{:^indent$}** UNRECOGNIZED: {}", "", extra .iter() .map(|b| format!("{b:02x}")) .collect::>() .join(" ") ) } /// Dumps strings matching the bits set in `bitmap` using `strings_f` function from LSB to MSB fn dump_bitmap_strings(bitmap: T, strings_f: fn(usize) -> Option<&'static str>, indent: usize) where T: std::fmt::Display + std::fmt::LowerHex + Copy + Into, { let bitmap_u64: u64 = bitmap.into(); let num_bits = std::mem::size_of::() * 8; for index in 0..num_bits { if (bitmap_u64 >> index) & 0x1 != 0 { if let Some(string) = strings_f(index) { println!("{:indent$}{}", "", string); } } } } /// Dumps strings matching the bits set in `bitmap` using `strings_f` function from MSB to LSB fn dump_bitmap_strings_invert( bitmap: T, strings_f: fn(usize) -> Option<&'static str>, indent: usize, ) where T: std::fmt::Display + std::fmt::LowerHex + Copy + Into, { let bitmap_u64: u64 = bitmap.into(); let num_bits = std::mem::size_of::() * 8; for index in (0..num_bits).rev() { if (bitmap_u64 >> index) & 0x1 != 0 { if let Some(string) = strings_f(index) { println!("{:indent$}{}", "", string); } } } } /// Dump a single value and the string representation of the value to the right of width fn dump_bitmap_strings_inline( value: V, bitmap: T, field_name: &str, strings_f: fn(usize) -> Option<&'static str>, indent: usize, width: usize, ) where T: std::fmt::Display + std::fmt::LowerHex + Copy + Into, V: std::fmt::Display, { let value = value.to_string(); let spaces = get_spaces(value.len(), field_name.len(), width); print!("{:indent$}{}{}{}", "", field_name, spaces, value,); let bitmap_u64: u64 = bitmap.into(); let num_bits = std::mem::size_of::() * 8; for index in 0..num_bits { if (bitmap_u64 >> index) & 0x1 != 0 { if let Some(string) = strings_f(index) { print!(" {string}"); } } } println!(); } fn get_guid(buf: &[u8]) -> String { if buf.len() < 16 { return String::from("INVALID GUID"); } format!("{{{:02x}{:02x}{:02x}{:02x}-{:02x}{:02x}-{:02x}{:02x}-{:02x}{:02x}-{:02x}{:02x}{:02x}{:02x}{:02x}{:02x}}}", buf[3], buf[2], buf[1], buf[0], buf[5], buf[4], buf[7], buf[6], buf[8], buf[9], buf[10], buf[11], buf[12], buf[13], buf[14], buf[15]) } /// Print [`SystemProfile`] as a lsusb style tree with the two optional `verbosity` levels pub fn print_tree(spusb: &SystemProfile, settings: &PrintSettings) { fn print_tree_devices(devices: &Vec, settings: &PrintSettings) { for device in devices { if device.is_root_hub() { log::debug!("lsusb tree skipping root_hub {device}"); continue; } // the const len should get compiled to const... let indent = (device.get_depth() * TREE_LSUSB_DEVICE.len()) + TREE_LSUSB_SPACE.len(); let device_tree_strings = device.to_lsusb_tree_strings(settings.verbosity); for strings in device_tree_strings { println!("{:>indent$}{}", TREE_LSUSB_DEVICE, strings[0]); for s in &strings[1..] { println!("{TREE_LSUSB_SPACE:>indent$}{s}"); } } // print all devices with this device - if hub for example device .devices .as_ref() .map_or((), |d| print_tree_devices(d, settings)) } } for bus in &spusb.buses { let bus_tree_strings = bus.to_lsusb_tree_string(settings.verbosity); println!("{}{}", TREE_LSUSB_BUS, bus_tree_strings[0]); for strings in &bus_tree_strings[1..] { println!("{TREE_LSUSB_SPACE}{strings}"); } // followed by devices if there are some bus.devices .as_ref() .map_or((), |d| print_tree_devices(d, settings)) } } /// Dump a single [`Device`] matching `dev_path` verbosely pub fn dump_one_device>(devices: &Vec<&Device>, dev_path: P) -> Result<(), Error> { for device in devices { if device.dev_path() == dev_path.as_ref() { // error if extra is none because we need it for vebose if device.extra.is_none() { return Err(Error::new( ErrorKind::Opening, &format!("Unable to open {}", dev_path.as_ref().display()), )); } print(&vec![device], true); return Ok(()); } } Err(Error::new( ErrorKind::NotFound, &format!("Unable to find {}", dev_path.as_ref().display()), )) } fn find_otg(extra: &[Descriptor]) -> Option<&OnTheGoDescriptor> { extra.iter().find_map(|d| match d { Descriptor::Otg(otg) => { log::debug!("Found OTG descriptor: {otg:?}"); dump_otg(otg, LSUSB_DUMP_INDENT_BASE); Some(otg) } _ => None, }) } /// Print USB devices in lsusb style flat dump /// /// `verbose` flag enables verbose printing like lsusb (configs, interfaces and endpoints) - a huge dump! pub fn print(devices: &Vec<&Device>, verbose: bool) { if !verbose { for device in devices { println!("{}", device.to_lsusb_string()); } } else { for device in devices { println!(); // new lines separate in verbose lsusb println!("{}", device.to_lsusb_string()); // print error regarding open if non-critical during probe like lsusb --verbose if device.profiler_error.is_some() { eprintln!("Couldn't open device, some information will be missing"); } match device.extra.as_ref() { None => log::warn!( "Device {device} does not contain extra data required for verbose print" ), Some(device_extra) => { dump_device(device); let mut otg = None; for config in &device_extra.configurations { dump_config(config, LSUSB_DUMP_INDENT_BASE); otg = config.extra.as_ref().map(|e| find_otg(e)); for interface in &config.interfaces { dump_interface(interface, LSUSB_DUMP_INDENT_BASE * 2); otg = config.extra.as_ref().map(|e| find_otg(e)); for endpoint in &interface.endpoints { dump_endpoint(endpoint, LSUSB_DUMP_INDENT_BASE * 3); otg = config.extra.as_ref().map(|e| find_otg(e)); } } } let has_ssp = if let Some(bos) = &device_extra.binary_object_store { let lpm_required: bool = device.bcd_usb.is_some_and(|v| u16::from(v) >= 0x0210); dump_bos_descriptor(bos, lpm_required, 0); bos.capabilities .iter() .any(|c| matches!(c, bos::BosCapability::SuperSpeedPlus(_))) } else { false }; if let Some(hub) = &device_extra.hub { let bcd = device.bcd_usb.map_or(0x0100, |v| v.into()); dump_hub(hub, device.protocol.unwrap_or(1), bcd, has_ssp, 0); } // lsusb do_dualspeed: dump_device_qualifier if let Some(qualifier) = &device_extra.qualifier { dump_device_qualifier(qualifier, 0); } if let Some(debug) = &device_extra.debug { dump_debug(debug, 0); } if let Some(status) = device_extra.status { dump_device_status( status, otg.is_some(), device.bcd_usb.is_some_and(|v| v.major() >= 3), 0, ); } } } } } } /// Dump a [`Device`] in style of lsusb --verbose fn dump_device(device: &Device) { let device_extra = device .extra .as_ref() .expect("Cannot print verbose without extra data"); let (class_name, sub_class_name, protocol_name) = match (device.base_class_code(), device.sub_class, device.protocol) { (Some(bc), Some(scid), Some(pid)) => ( names::class(bc), names::subclass(bc, scid), names::protocol(bc, scid, pid), ), (Some(bc), Some(scid), None) => (names::class(bc), names::subclass(bc, scid), None), (Some(bc), None, None) => (names::class(bc), None, None), (None, None, None) => (None, None, None), _ => unreachable!(), }; // print negotiated speed let speed_str = match device_extra.negotiated_speed { Some(Speed::LowSpeed) => "Low Speed (1Mbps)", Some(Speed::FullSpeed) => "Full Speed (12Mbps)", Some(Speed::HighSpeed) | Some(Speed::HighBandwidth) => "High Speed (480Mbps)", Some(Speed::SuperSpeed) => "SuperSpeed (5Gbps)", Some(Speed::SuperSpeedPlus) => "SuperSpeed+ (10Gbps)", Some(Speed::SuperSpeedPlusX2) => "SuperSpeed++ (20Gbps)", _ => "Unknown", }; println!("Negotiated speed: {speed_str}"); println!("Device Descriptor:"); // These are constants - length is 18 bytes for descriptor, type is 1 dump_value(18, "bLength", 2, LSUSB_DUMP_WIDTH); dump_value(1, "bDescriptorType", 2, LSUSB_DUMP_WIDTH); dump_value( device .bcd_usb .as_ref() .map_or(String::new(), |v| v.to_string()), "bcdUSB", 2, LSUSB_DUMP_WIDTH, ); dump_value_string( device.base_class_code().unwrap_or(0), "bDeviceClass", class_name.unwrap_or(String::from("[unknown]")), 2, LSUSB_DUMP_WIDTH, ); dump_value_string( device.sub_class.unwrap_or(0), "bDeviceSubClass", sub_class_name.unwrap_or(String::from("[unknown]")), 2, LSUSB_DUMP_WIDTH, ); dump_value_string( device.protocol.unwrap_or(0), "bDeviceProtocol", protocol_name.unwrap_or_default(), 2, LSUSB_DUMP_WIDTH, ); dump_value( device_extra.max_packet_size, "bMaxPacketSize0", 2, LSUSB_DUMP_WIDTH, ); dump_value_string( format!("0x{:04x}", device.vendor_id.unwrap_or(0)), "idVendor", device_extra.vendor.as_ref().unwrap_or( device .manufacturer .as_ref() .unwrap_or(&String::from("[unknown]")), ), 2, LSUSB_DUMP_WIDTH, ); dump_value_string( format!("0x{:04x}", device.product_id.unwrap_or(0)), "idProduct", device_extra.product_name.as_ref().unwrap_or(&device.name), 2, LSUSB_DUMP_WIDTH, ); dump_value( device .bcd_device .as_ref() .map_or(String::new(), |v| v.to_string()), "bcdDevice", 2, LSUSB_DUMP_WIDTH, ); dump_value_string( device_extra.string_indexes.1, "iManufacturer", device .manufacturer .as_ref() .unwrap_or(&String::from("[unknown]")), 2, LSUSB_DUMP_WIDTH, ); dump_value_string( device_extra.string_indexes.0, "iProduct", &device.name, 2, LSUSB_DUMP_WIDTH, ); dump_value_string( device_extra.string_indexes.2, "iSerial", device.serial_num.as_ref().unwrap_or(&String::new()), 2, LSUSB_DUMP_WIDTH, ); dump_value( device_extra.configurations.len(), "bNumConfigurations", 2, LSUSB_DUMP_WIDTH, ); } /// Dump a [`Configuration`] in style of lsusb --verbose fn dump_config(config: &Configuration, indent: usize) { dump_string("Configuration Descriptor:", indent); dump_value(config.length, "bLength", indent + 2, LSUSB_DUMP_WIDTH); dump_value(2, "bDescriptorType", indent + 2, LSUSB_DUMP_WIDTH); // type 2 for configuration dump_hex( config.total_length, "wTotalLength", indent + 2, LSUSB_DUMP_WIDTH, ); dump_value( config.interfaces.len(), "bNumInterfaces", indent + 2, LSUSB_DUMP_WIDTH, ); dump_value( config.number, "bConfigurationValue", indent + 2, LSUSB_DUMP_WIDTH, ); dump_value_string( config.string_index, "iConfiguration", &config.name, indent + 2, LSUSB_DUMP_WIDTH, ); dump_hex( config.attributes_value(), "bmAttributes", indent + 2, LSUSB_DUMP_WIDTH, ); // no attributes is bus powered if config.attributes.contains(&ConfigAttributes::SelfPowered) { dump_string("Self Powered", indent + 4); } if config.attributes.contains(&ConfigAttributes::BusPowered) { dump_string("(Bus Powered)", indent + 4); } if config.attributes.contains(&ConfigAttributes::RemoteWakeup) { dump_string("Remote Wakeup", indent + 4); } if config .attributes .contains(&ConfigAttributes::BatteryPowered) { dump_string("Battery Powered", indent + 4); } dump_value( format!("{}{}", config.max_power.value, config.max_power.unit), "MaxPower", indent + 2, LSUSB_DUMP_WIDTH + 2, ); // dump extra descriptors if let Some(dt_vec) = &config.extra { for dt in dt_vec { match dt { Descriptor::InterfaceAssociation(iad) => { dump_interface_association(iad, indent + 2); } Descriptor::Security(sec) => { dump_security(sec, indent + 2); } Descriptor::Encrypted(enc) => { dump_encryption_type(enc, indent + 2); } Descriptor::Unknown(junk) | Descriptor::Junk(junk) => { dump_unrecognised(junk, indent + 2); } _ => (), } } } } /// Dump a [`InterfaceAssociation`] in style of lsusb --verbose fn dump_interface(interface: &Interface, indent: usize) { let interface_name = names::class(interface.class.into()); let sub_class_name = names::subclass(interface.class.into(), interface.sub_class); let protocol_name = names::protocol( interface.class.into(), interface.sub_class, interface.protocol, ); dump_string("Interface Descriptor:", indent); dump_value(interface.length, "bLength", indent + 2, LSUSB_DUMP_WIDTH); dump_value(4, "bDescriptorType", indent + 2, LSUSB_DUMP_WIDTH); // type 4 for interface dump_value( interface.number, "bInterfaceNumber", indent + 2, LSUSB_DUMP_WIDTH, ); dump_value( interface.alt_setting, "bAlternateSetting", indent + 2, LSUSB_DUMP_WIDTH, ); dump_value( interface.endpoints.len(), "bNumEndpoints", indent + 2, LSUSB_DUMP_WIDTH, ); dump_value_string( u8::from(interface.class.to_owned()), "bInterfaceClass", interface_name.unwrap_or(String::from("[unknown]")), indent + 2, LSUSB_DUMP_WIDTH, ); dump_value_string( interface.sub_class, "bInterfaceSubClass", sub_class_name.unwrap_or(String::from("[unknown]")), indent + 2, LSUSB_DUMP_WIDTH, ); dump_value_string( interface.protocol, "bInterfaceProtocol", protocol_name.unwrap_or_default(), indent + 2, LSUSB_DUMP_WIDTH, ); dump_value_string( interface.string_index, "iInterface", interface.name.as_ref().unwrap_or(&String::new()), indent + 2, LSUSB_DUMP_WIDTH, ); // dump extra descriptors if let Some(dt_vec) = &interface.extra { for dt in dt_vec { match dt { // Should only be Device or Interface as we mask out the rest Descriptor::Device(cd) | Descriptor::Interface(cd) => match cd { ClassDescriptor::Hid(hidd) => dump_hid_device(hidd, indent + 4), ClassDescriptor::Ccid(ccid) => dump_ccid_desc(ccid, indent + 4), ClassDescriptor::Printer(pd) => dump_printer_desc(pd, indent + 4), ClassDescriptor::Communication(cd) => dump_comm_descriptor(cd, indent + 4), ClassDescriptor::Dfu(dfud) => dump_dfu_interface(dfud, indent + 4), ClassDescriptor::Midi(md, _) => dump_midistreaming_interface(md, indent + 4), ClassDescriptor::Audio(uacd, uacp) => match &uacd.descriptor_subtype { audio::UacType::Control(cs) => { dump_audiocontrol_interface(uacd, cs, uacp, indent + 4) } audio::UacType::Streaming(ss) => { dump_audiostreaming_interface(uacd, ss, uacp, indent + 4) } _ => (), }, ClassDescriptor::Video(vcd, p) => match &vcd.descriptor_subtype { video::UvcType::Control(cs) => { dump_videocontrol_interface(vcd, cs, *p, indent + 4) } video::UvcType::Streaming(ss) => { dump_videostreaming_interface(vcd, ss, *p, indent + 4); } }, ClassDescriptor::Generic(cc, gd) => match cc { Some((BaseClass::Audio, 3, _)) => { if let Ok(md) = audio::MidiDescriptor::try_from(gd.to_owned()) { dump_midistreaming_interface(&md, indent + 4); } } Some((BaseClass::Audio, s, p)) => { if let Ok(uacd) = audio::UacDescriptor::try_from((gd.to_owned(), *s, *p)) { let uacp = audio::UacProtocol::from(*p); match &uacd.descriptor_subtype { audio::UacType::Control(cs) => { dump_audiocontrol_interface(&uacd, cs, &uacp, indent + 4) } audio::UacType::Streaming(ss) => { dump_audiostreaming_interface(&uacd, ss, &uacp, indent + 4) } _ => (), } } } Some((BaseClass::Video, s, p)) => { if let Ok(uvcd) = video::UvcDescriptor::try_from((gd.to_owned(), *s, *p)) { match &uvcd.descriptor_subtype { video::UvcType::Control(cs) => { dump_videocontrol_interface(&uvcd, cs, *p, indent + 4); } video::UvcType::Streaming(ss) => { dump_videostreaming_interface(&uvcd, ss, *p, indent + 4); } } } } Some((BaseClass::ApplicationSpecificInterface, 1, _)) => { if let Ok(dfud) = DfuDescriptor::try_from(gd.to_owned()) { dump_dfu_interface(&dfud, indent + 4); } } _ => { let junk = Vec::from(cd.to_owned()); dump_unrecognised(&junk, indent + 4); } }, }, Descriptor::Unknown(junk) | Descriptor::Junk(junk) => { dump_unrecognised(junk, indent + 4); } _ => dump_unrecognised(&Vec::from(dt.to_owned()), indent + 4), } } } } /// Dump a [`Endpoint`] in style of lsusb --verbose fn dump_endpoint(endpoint: &Endpoint, indent: usize) { dump_string("Endpoint Descriptor:", indent); dump_value(endpoint.length, "bLength", indent + 2, LSUSB_DUMP_WIDTH); dump_value(5, "bDescriptorType", indent + 2, LSUSB_DUMP_WIDTH); // type 5 for endpoint dump_value_string( format!("0x{:02x}", endpoint.address.address), "bEndpointAddress", format!( "EP {} {}", endpoint.address.number, endpoint.address.direction.to_string().to_uppercase() ), indent + 2, LSUSB_DUMP_WIDTH, ); // this is printed as int even though it's a bitmap dump_value( endpoint.attributes(), "bmAttributes", indent + 2, LSUSB_DUMP_WIDTH, ); println!( "{:indent$}Transfer Type {:?}", "", endpoint.transfer_type, indent = indent + 4 ); println!( "{:indent$}Synch Type {:?}", "", endpoint.sync_type, indent = indent + 4 ); println!( "{:indent$}Usage Type {:?}", "", endpoint.usage_type, indent = indent + 4 ); dump_value_string( format!("0x{:04x}", endpoint.max_packet_size), "wMaxPacketSize", format!("{} bytes", endpoint.max_packet_string()), indent + 2, LSUSB_DUMP_WIDTH, ); dump_value(endpoint.interval, "bInterval", indent + 2, LSUSB_DUMP_WIDTH); // dump extra descriptors // kind of messy but it's out lsusb does it if let Some(dt_vec) = &endpoint.extra { for dt in dt_vec { match dt { Descriptor::Endpoint(cd) => match cd { ClassDescriptor::Audio(ad, _) => { dump_audiostreaming_endpoint(ad, indent + 2); } ClassDescriptor::Midi(md, _) => { dump_midistreaming_endpoint(md, indent + 2); } ClassDescriptor::Video(vd, _) => { dump_videocontrol_interrupt_endpoint(vd, indent + 2, LSUSB_DUMP_WIDTH); } // legacy as context should have been added to the descriptor ClassDescriptor::Generic(cc, gd) => match cc { Some((BaseClass::Audio, 2, p)) => { if let Ok(uacd) = audio::UacDescriptor::try_from((gd.to_owned(), 2, *p)) { dump_audiostreaming_endpoint(&uacd, indent + 2); } } Some((BaseClass::Audio, 3, _)) => { if let Ok(md) = audio::MidiDescriptor::try_from(gd.to_owned()) { dump_midistreaming_endpoint(&md, indent + 2); } } _ => (), }, _ => (), }, // Misplaced descriptors Descriptor::Device(cd) => match cd { ClassDescriptor::Ccid(ccid) => { dump_ccid_desc(ccid, indent); } _ => { println!( "{:indent$}DEVICE CLASS: {}", "", Vec::::from(cd.to_owned()) .iter() .map(|b| format!("{b:02x}")) .collect::>() .join(" "), indent = indent + 2 ); } }, Descriptor::Interface(cd) => match cd { ClassDescriptor::Generic(cc, gd) => match cc { Some((BaseClass::CdcData, _, _)) | Some((BaseClass::CdcCommunications, _, _)) => { if let Ok(cd) = gd.to_owned().try_into() { dump_comm_descriptor(&cd, indent) } } Some((BaseClass::MassStorage, _, _)) => { dump_pipe_desc(gd, indent + 2); } _ => { println!( "{:indent$}INTERFACE CLASS: {}", "", Vec::::from(cd.to_owned()) .iter() .map(|b| format!("{b:02x}")) .collect::>() .join(" "), indent = indent + 2 ); } }, ClassDescriptor::Communication(cd) => dump_comm_descriptor(cd, 6), _ => { println!( "{:indent$}INTERFACE CLASS: {}", "", Vec::::from(cd.to_owned()) .iter() .map(|b| format!("{b:02x}")) .collect::>() .join(" "), indent = indent + 2 ); } }, Descriptor::InterfaceAssociation(iad) => { dump_interface_association(iad, indent + 2); } Descriptor::SsEndpointCompanion(ss) => { println!( "{:indent$}bMaxBurst {:>14}", "", ss.max_burst, indent = indent + 2 ); match endpoint.transfer_type { TransferType::Bulk => { if ss.attributes & 0x1f != 0 { println!( "{:indent$}MaxStreams {:>13}", "", 1 << ss.attributes, indent = indent + 2 ); } } TransferType::Isochronous | TransferType::Interrupt => { if ss.attributes & 0x03 != 0 { println!( "{:indent$}Mult {:>19}", "", ss.attributes & 0x3, indent = indent + 2 ); } if let Some(bi) = ss.bytes_per_interval { println!( "{:indent$}wBytesPerInterval {:>6}", "", bi, indent = indent + 2 ); } } _ => (), } } Descriptor::Unknown(junk) | Descriptor::Junk(junk) => { dump_unrecognised(junk, indent + 2); } _ => (), } } } } fn dump_ccid_desc(ccid: &CcidDescriptor, indent: usize) { dump_string("ChipCard Interface Descriptor:", indent); dump_value(ccid.length, "bLength", indent + 2, LSUSB_DUMP_WIDTH); dump_value( ccid.descriptor_type, "bDescriptorType", indent + 2, LSUSB_DUMP_WIDTH, ); if ccid.version.major() != 1 || (ccid.version.minor() != 0 && ccid.version.minor() != 1) { dump_value_string( ccid.version, "bcdCCID", "(Warning: Only accurate for version 1.0/1.1)", indent + 2, LSUSB_DUMP_WIDTH, ); } else { dump_value(ccid.version, "bcdCCID", indent + 2, LSUSB_DUMP_WIDTH); } dump_value( ccid.max_slot_index, "bMaxSlotIndex", indent + 2, LSUSB_DUMP_WIDTH, ); dump_bitmap_strings_inline( ccid.voltage_support, ccid.voltage_support, "bVoltageSupport", |index| match index { 0 => Some("5.0V"), 1 => Some("3.0V"), 2 => Some("1.8V"), _ => None, }, indent + 2, LSUSB_DUMP_WIDTH, ); dump_bitmap_strings_inline( ccid.protocols, ccid.protocols, "dwProtocols", |index| match index { 0 => Some("T=0"), 1 => Some("T=1"), _ => Some("(Invalid values detected)"), }, indent + 2, LSUSB_DUMP_WIDTH, ); dump_value( ccid.default_clock, "dwDefaultClock", indent + 2, LSUSB_DUMP_WIDTH, ); dump_value( ccid.max_clock, "dwMaxiumumClock", indent + 2, LSUSB_DUMP_WIDTH, ); dump_value( ccid.num_clock_supported, "bNumClockSupported", indent + 2, LSUSB_DUMP_WIDTH, ); dump_value_string( ccid.data_rate, "dwDataRate", "bps", indent + 2, LSUSB_DUMP_WIDTH, ); dump_value_string( ccid.max_data_rate, "dwMaxDataRate", "bps", indent + 2, LSUSB_DUMP_WIDTH, ); dump_value( ccid.num_data_rates_supp, "bNumDataRatesSupp.", indent + 2, LSUSB_DUMP_WIDTH, ); dump_value(ccid.max_ifsd, "dwMaxIFSD", indent + 2, LSUSB_DUMP_WIDTH); dump_bitmap_strings_inline( format!("{:08X}", ccid.sync_protocols), ccid.sync_protocols, "dwSyncProtocols", |index| match index { 0 => Some("2-wire"), 1 => Some("3-wire"), 2 => Some("I2C"), _ => None, }, indent + 2, LSUSB_DUMP_WIDTH, ); dump_bitmap_strings_inline( format!("{:08X}", ccid.mechanical), ccid.mechanical, "dwMechanical", |index| match index { 0 => Some("accept"), 1 => Some("eject"), 2 => Some("capture"), 3 => Some("lock"), _ => None, }, indent + 2, LSUSB_DUMP_WIDTH, ); dump_value( format!("{:08X}", ccid.features), "dwFeatures", indent + 2, LSUSB_DUMP_WIDTH, ); dump_bitmap_strings( ccid.features, |index| match index { 0 => Some("Auto configuration based on ATR"), 1 => Some("Auto activation on insert"), 2 => Some("Auto voltage selection"), 3 => Some("Auto clock change"), 4 => Some("Auto baud rate change"), 5 => Some("Auto parameter negotiation made by CCID"), 6 => Some("Auto PPS made by CCID"), 7 => Some("CCID can set ICC in clock stop mode"), 8 => Some("NAD value other than 0x00 accepted (T=1)"), 9 => Some("Auto IFSD exchange"), 15 => Some("Character level exchange"), 16 => Some("TPDU level exchange"), // results in same as us & 0x00070000 == 0x02 in lsusb 17 => Some("Short APDU level exchange"), // results in same as us & 0x00070000 == 0x04 in lsusb 18 => Some("Short and extended APDU level exchange"), _ => None, }, indent + 4, ); if (ccid.features & (0x0040 | 0x0080)) != 0 { println!( "{:indent$}WARNING: conflicting negotiation features", "", indent = indent + 2 ); } if ccid.features & 0x00070000 != 0 { println!( "{:indent$}WARNING: conflicting exchange levels", "", indent = indent + 2 ); } dump_value( ccid.max_ccid_msg_len, "dwMaxCCIDMsgLen", indent + 2, LSUSB_DUMP_WIDTH, ); if ccid.class_get_response == 0xff { dump_value("echo", "bClassGetResponse", indent + 2, LSUSB_DUMP_WIDTH); } else { dump_value( format!("{:02X}", ccid.class_get_response), "bClassGetResponse", indent + 2, LSUSB_DUMP_WIDTH, ); } if ccid.class_envelope == 0xff { dump_value("echo", "bClassEnvelope", indent + 2, LSUSB_DUMP_WIDTH); } else { dump_value( format!("{:02X}", ccid.class_envelope), "bClassEnvelope", indent + 2, LSUSB_DUMP_WIDTH, ); } if ccid.lcd_layout == (0, 0) { dump_value("none", "wlcdLayout", indent + 2, LSUSB_DUMP_WIDTH); } else { dump_value_string( ccid.lcd_layout.0, "wlcdLayout", format!(" cols {} lines", ccid.lcd_layout.1), indent + 2, LSUSB_DUMP_WIDTH, ); } dump_bitmap_strings_inline( ccid.pin_support, ccid.pin_support, "bPINSupport", |index| match index { 0 => Some("verification"), 1 => Some("modification"), _ => None, }, indent + 2, LSUSB_DUMP_WIDTH, ); dump_value( ccid.max_ccid_busy_slots, "bMaxCCIDBusySlots", indent + 2, LSUSB_DUMP_WIDTH, ); } fn dump_printer_desc(pd: &PrinterDescriptor, indent: usize) { dump_string("Printer Interface Descriptor:", indent); dump_value(pd.length, "bLength", indent + 2, LSUSB_DUMP_WIDTH); dump_value( pd.descriptor_type, "bDescriptorType", indent + 2, LSUSB_DUMP_WIDTH, ); dump_value( pd.release_number, "bcdReleaseNumber", indent + 2, LSUSB_DUMP_WIDTH, ); dump_value( pd.descriptors.len(), "bcdNumDescriptors", indent + 2, LSUSB_DUMP_WIDTH, ); for desc in &pd.descriptors { // basic capabilities if desc.descriptor_type == 0x00 { dump_value( desc.versions_supported, "iIPPVersionsSupported", indent + 2, LSUSB_DUMP_WIDTH, ); dump_value_string( desc.uuid_string_index, "iIPPPrinterUUID", desc.uuid_string.as_ref().unwrap_or(&String::new()), indent + 2, LSUSB_DUMP_WIDTH, ); print!( "{:indent$}wBasicCapabilities 0x{:04x} ", "", desc.capabilities, indent = indent + 2 ); // capabilities if desc.capabilities & 0x0001 != 0 { print!(" Print"); } if desc.capabilities & 0x0002 != 0 { print!(" Scan"); } if desc.capabilities & 0x0004 != 0 { print!(" Fax"); } if desc.capabilities & 0x0008 != 0 { print!(" Other"); } if desc.capabilities & 0x0010 != 0 { print!(" HTTP-over-USB"); } if (desc.capabilities & 0x0060) != 0 { print!(" No-Auth"); } else if (desc.capabilities & 0x0060) != 0x20 { print!(" Username-Auth"); } else if (desc.capabilities & 0x0060) != 0x40 { print!(" Reserved-Auth"); } else if (desc.capabilities & 0x0060) != 0x60 { print!(" Negotiable-Auth"); } println!(); // vendor specific } else { dump_value_string( desc.descriptor_type, "UnknownCapabilities", desc.length, indent + 2, LSUSB_DUMP_WIDTH, ); } } } fn dump_bad_comm(cd: &cdc::CommunicationDescriptor, indent: usize) { let data = Into::>::into(cd.to_owned()); println!( "{:^indent$}INVALID CDC ({:#}): {}", "", cd.descriptor_subtype, data.iter() .map(|b| format!("{b:02x}")) .collect::>() .join(" ") ); } fn dump_comm_descriptor(cd: &cdc::CommunicationDescriptor, indent: usize) { match &cd.interface { cdc::CdcInterfaceDescriptor::Header(d) => { dump_string("CDC Header:", indent); dump_value(d.version, "bcdCDC", indent + 2, LSUSB_DUMP_WIDTH); } cdc::CdcInterfaceDescriptor::CallManagement(cd) => { dump_string("CDC Call Management:", indent); dump_hex( cd.capabilities, "bmCapabilities", indent + 2, LSUSB_DUMP_WIDTH, ); dump_bitmap_strings( cd.capabilities, |b| match b { 0 => Some("call management"), 1 => Some("dataInterface"), _ => None, }, indent + 4, ); } cdc::CdcInterfaceDescriptor::AbstractControlManagement(cd) => { dump_string("CDC ACM:", indent); dump_hex( cd.capabilities, "bmCapabilities", indent + 2, LSUSB_DUMP_WIDTH, ); dump_bitmap_strings_invert( cd.capabilities, |b| match b { 0 => Some("get/set/clear comm features"), 1 => Some("line coding and serial state"), 2 => Some("sends break"), 3 => Some("connection notifications"), _ => None, }, indent + 4, ); } cdc::CdcInterfaceDescriptor::Union(cd) => { dump_string("CDC Union:", indent); dump_value( cd.master_interface, "bMasterInterface", indent + 2, LSUSB_DUMP_WIDTH, ); println!( "{:indent$}bSlaveInterface {}", "", cd.slave_interface .iter() .map(|b| format!("{b:3}")) .collect::>() .join(" "), indent = indent + 2 ); } cdc::CdcInterfaceDescriptor::CountrySelection(cd) => { dump_string("Country Selection:", indent); dump_value_string( cd.country_code_date_index, "iCountryCodeRelDate", cd.country_code_date .as_ref() .unwrap_or(&String::from("(?)")), indent + 2, LSUSB_DUMP_WIDTH, ); for d in &cd.country_codes { dump_value( format!("{d:04x}"), "wCountryCode", indent + 2, LSUSB_DUMP_WIDTH, ); } } cdc::CdcInterfaceDescriptor::TelephoneOperations(d) => { dump_string("CDC Telephone operations:", indent); dump_hex( d.capabilities, "bmCapabilities", indent + 2, LSUSB_DUMP_WIDTH, ); dump_bitmap_strings_invert( d.capabilities, |b| match b { 0 => Some("simple mode"), 1 => Some("standalone mode"), 2 => Some("computer centric mode"), _ => None, }, indent + 4, ); } cdc::CdcInterfaceDescriptor::NetworkChannel(d) => { dump_string("Network Channel Terminal:", indent); dump_value(d.entity_id, "bEntityId", indent + 2, LSUSB_DUMP_WIDTH); dump_value_string( d.name_string_index, "iName", d.name.as_ref().unwrap_or(&String::from("(?)")), indent + 2, LSUSB_DUMP_WIDTH, ); dump_value( d.channel_index, "bChannelIndex", indent + 2, LSUSB_DUMP_WIDTH, ); dump_value( d.physical_interface, "bPhysicalInterface", indent + 2, LSUSB_DUMP_WIDTH, ); } cdc::CdcInterfaceDescriptor::EthernetNetworking(d) => { dump_string("CDC Ethernet:", indent); dump_value_string( d.mac_address_index, "iMacAddress", d.mac_address.as_ref().unwrap_or(&String::from("(?)")), indent + 2, LSUSB_DUMP_WIDTH, ); dump_hex( d.ethernet_statistics, "bmEthernetStatistics", indent + 2, LSUSB_DUMP_WIDTH, ); dump_value( d.max_segment_size, "wMaxSegmentSize", indent + 2, LSUSB_DUMP_WIDTH, ); dump_hex( d.num_multicast_filters, "wNumberMCFilters", indent + 2, LSUSB_DUMP_WIDTH, ); dump_hex( d.num_power_filters, "bNumberPowerFilters", indent + 2, LSUSB_DUMP_WIDTH, ); } cdc::CdcInterfaceDescriptor::WirelessHandsetControlModel(d) => { dump_string("CDC WHCM:", indent); dump_value(d.version, "bcdVersion", indent + 2, LSUSB_DUMP_WIDTH); } cdc::CdcInterfaceDescriptor::MobileDirectLineModelFunctional(d) => { dump_string("CDC MDLM:", indent); dump_value(d.version, "bcdVersion", indent + 2, LSUSB_DUMP_WIDTH); dump_guid(&d.guid, "bGUID", indent + 2, LSUSB_DUMP_WIDTH); } cdc::CdcInterfaceDescriptor::MobileDirectLineModelDetail(d) => { dump_string("CDC MDLM detail:", indent); dump_value( format!("{:02x}", d.guid_descriptor_type), "bGuidDescriptorType", indent + 2, LSUSB_DUMP_WIDTH, ); println!( "{:indent$}bDetailData {}", "", d.detail_data .iter() .map(|b| format!("{b:02x}")) .collect::>() .join(" "), indent = indent + 2 ); } cdc::CdcInterfaceDescriptor::DeviceManagement(d) => { dump_string("CDC MDLM:", indent); dump_value(d.version, "bcdVersion", indent + 2, LSUSB_DUMP_WIDTH); dump_value(d.max_command, "wMaxCommand", indent + 2, LSUSB_DUMP_WIDTH); } cdc::CdcInterfaceDescriptor::Obex(d) => { dump_string("CDC OBEX:", indent); dump_value(d.version, "bcdVersion", indent + 2, LSUSB_DUMP_WIDTH); } cdc::CdcInterfaceDescriptor::CommandSet(d) => { dump_string("CDC Command Set:", indent); dump_value(d.version, "bcdVersion", indent + 2, LSUSB_DUMP_WIDTH); dump_value_string( d.command_set_string_index, "iCommandSet", d.command_set_string .as_ref() .unwrap_or(&String::from("(?)")), indent + 2, LSUSB_DUMP_WIDTH, ); dump_guid(&d.guid, "bGUID", indent + 2, LSUSB_DUMP_WIDTH); } cdc::CdcInterfaceDescriptor::Ncm(d) => { dump_string("CDC NCM:", indent); dump_value(d.version, "bcdNcmVersion", indent + 2, LSUSB_DUMP_WIDTH); dump_hex( d.network_capabilities, "bmNetworkCapabilities", indent + 2, LSUSB_DUMP_WIDTH, ); dump_bitmap_strings_invert( d.network_capabilities, |b| match b { 0 => Some("packet filter"), 1 => Some("net address"), 2 => Some("encapsulated commands"), 3 => Some("max cd.datagram size"), 4 => Some("crc mode"), 5 => Some("8-byte ntb input size"), _ => None, }, indent + 4, ); } cdc::CdcInterfaceDescriptor::Mbim(d) => { dump_string("CDC MBIM:", indent); dump_value(d.version, "bcdMBIMVersion", indent + 2, LSUSB_DUMP_WIDTH); dump_value( d.max_control_message, "wMaxControlMessage", indent + 2, LSUSB_DUMP_WIDTH, ); dump_value( d.number_filters, "bNumberFilters", indent + 2, LSUSB_DUMP_WIDTH, ); dump_value( d.max_filter_size, "bMaxFilterSize", indent + 2, LSUSB_DUMP_WIDTH, ); dump_value( d.max_segment_size, "wMaxSegmentSize", indent + 2, LSUSB_DUMP_WIDTH, ); dump_hex( d.network_capabilities, "bmNetworkCapabilities", indent + 2, LSUSB_DUMP_WIDTH, ); dump_bitmap_strings_invert( d.network_capabilities, |b| match b { 3 => Some("max cd.datagram size"), 5 => Some("8-byte ntb input size"), _ => None, }, indent + 4, ); } cdc::CdcInterfaceDescriptor::MbimExtended(d) => { dump_string("CDC MBIM Extended:", indent); dump_value( d.version, "bcdMBIMExtendedVersion", indent + 2, LSUSB_DUMP_WIDTH, ); dump_value( d.max_outstanding_command_messages, "bMaxOutstandingCommandMessages", indent + 2, LSUSB_DUMP_WIDTH, ); dump_value(d.mtu, "wMTU", indent + 2, LSUSB_DUMP_WIDTH); } cdc::CdcInterfaceDescriptor::Invalid(_) => { dump_bad_comm(cd, indent); } _ => { println!( "{:^indent$}UNRECOGNIZED CDC: {}", "", Vec::::from(cd.to_owned()) .iter() .map(|b| format!("{b:02x}")) .collect::>() .join(" "), indent = indent ); } } } fn dump_dfu_interface(dfud: &DfuDescriptor, indent: usize) { // wider in lsusb but I prefer standard //const DFU_WIDTH: usize = 36; const DFU_WIDTH: usize = LSUSB_DUMP_WIDTH; dump_string("Device Firmware Upgrade Interface Descriptor:", indent); dump_value(dfud.length, "bLength", indent + 2, DFU_WIDTH); dump_value( dfud.descriptor_type, "bDescriptorType", indent + 2, DFU_WIDTH, ); dump_value(dfud.attributes, "bmAttributes", indent + 2, DFU_WIDTH); if dfud.attributes & 0xf0 != 0 { println!("{:indent$}(unknown attributes!)", "", indent = indent + 4); } if dfud.attributes & 0x08 != 0 { println!("{:indent$}Will Detach", "", indent = indent + 4); } else { println!("{:indent$}Will Not Detach", "", indent = indent + 4); } if dfud.attributes & 0x04 != 0 { println!( "{:indent$}Manifestation Intolerant", "", indent = indent + 4 ); } else { println!("{:indent$}Manifestation Tolerant", "", indent = indent + 4); } if dfud.attributes & 0x02 != 0 { println!("{:indent$}Upload Supported", "", indent = indent + 4); } else { println!("{:indent$}Upload Unsupported", "", indent = indent + 4); } if dfud.attributes & 0x01 != 0 { println!("{:indent$}Download Supported", "", indent = indent + 4); } else { println!("{:indent$}Download Unsupported", "", indent = indent + 4); } dump_value_string( dfud.detach_timeout, "wDetachTimeout", "milliseconds", indent + 2, DFU_WIDTH, ); dump_value_string( dfud.transfer_size, "wTransferSize", "bytes", indent + 2, DFU_WIDTH, ); if let Some(bcd) = dfud.dfu_version.as_ref() { dump_value(bcd, "bcdDFUVersion", indent + 2, DFU_WIDTH); } } fn dump_pipe_desc(gd: &GenericDescriptor, indent: usize) { if gd.length == 4 && gd.descriptor_type == 0x24 { let subtype_string = match gd.descriptor_subtype { 1 => "Command pipe", 2 => "Status pipe", 3 => "Data-in pipe", 4 => "Data-out pipe", 0 | 5..=0xdf | 0xf0..=0xff => "Reserved", 0xe0..=0xef => "Vendor-specific", }; println!( "{:indent$}{} (0x{:02x})", "", subtype_string, gd.descriptor_subtype, indent = indent ); } else { println!( "{:indent$}INTERFACE CLASS: {}", "", Vec::::from(gd.to_owned()) .iter() .map(|b| format!("{b:02x}")) .collect::>() .join(" "), indent = indent ); } } fn dump_security(sec: &SecurityDescriptor, indent: usize) { dump_string("Security Descriptor:", indent); dump_value(sec.length, "bLength", indent + 2, LSUSB_DUMP_WIDTH); dump_value( sec.descriptor_type, "bDescriptorType", indent + 2, LSUSB_DUMP_WIDTH, ); dump_hex( sec.total_length, "wTotalLength", indent + 2, LSUSB_DUMP_WIDTH, ); dump_value( sec.encryption_types, "bNumEncryptionTypes", indent + 2, LSUSB_DUMP_WIDTH, ); } fn dump_encryption_type(enc: &EncryptionDescriptor, indent: usize) { let enct_string = match enc.encryption_type as u8 { 0 => "UNSECURE", 1 => "WIRED", 2 => "CCM_1", 3 => "RSA_1", _ => "RESERVED", }; dump_string("Encryption Type:", indent); dump_value(enc.length, "bLength", indent + 2, LSUSB_DUMP_WIDTH); dump_value( enc.descriptor_type, "bDescriptorType", indent + 2, LSUSB_DUMP_WIDTH, ); dump_value_string( enc.encryption_type as u8, "bEncryptionType", enct_string, indent + 2, LSUSB_DUMP_WIDTH, ); dump_value( enc.encryption_value, "bEncryptionValue", indent + 2, LSUSB_DUMP_WIDTH, ); dump_value( enc.auth_key_index, "bAuthKeyIndex", indent + 2, LSUSB_DUMP_WIDTH, ); } fn dump_interface_association(iad: &InterfaceAssociationDescriptor, indent: usize) { dump_string("Interface Association:", indent); dump_value(iad.length, "bLength", indent + 2, LSUSB_DUMP_WIDTH); dump_value( iad.descriptor_type, "bDescriptorType", indent + 2, LSUSB_DUMP_WIDTH, ); dump_value( iad.first_interface, "bFirstInterface", indent + 2, LSUSB_DUMP_WIDTH, ); dump_value( iad.interface_count, "bInterfaceCount", indent + 2, LSUSB_DUMP_WIDTH, ); dump_value_string( iad.function_class, "bFunctionClass", names::class(iad.function_class).unwrap_or_default(), indent + 2, LSUSB_DUMP_WIDTH, ); dump_value_string( iad.function_sub_class, "bFunctionSubClass", names::subclass(iad.function_class, iad.function_sub_class).unwrap_or_default(), indent + 2, LSUSB_DUMP_WIDTH, ); dump_value_string( iad.function_protocol, "bFunctionProtocol", names::protocol( iad.function_class, iad.function_sub_class, iad.function_protocol, ) .unwrap_or_default(), indent + 2, LSUSB_DUMP_WIDTH, ); dump_value_string( iad.function_string_index, "iFunction", iad.function_string.as_ref().unwrap_or(&String::new()), indent + 2, LSUSB_DUMP_WIDTH, ); } fn dump_hid_device(hidd: &HidDescriptor, indent: usize) { dump_string("HID Device Descriptor:", indent); dump_value(hidd.length, "bLength", indent + 2, LSUSB_DUMP_WIDTH); dump_value( hidd.descriptor_type, "bDescriptorType", indent + 2, LSUSB_DUMP_WIDTH, ); dump_value(hidd.bcd_hid, "bcdHID", indent + 2, LSUSB_DUMP_WIDTH); dump_value_string( hidd.country_code, "bCountryCode", names::countrycode(hidd.country_code).unwrap_or_default(), indent + 2, LSUSB_DUMP_WIDTH, ); dump_value( hidd.descriptors.len(), "bNumDescriptors", indent + 2, LSUSB_DUMP_WIDTH, ); for desc in &hidd.descriptors { dump_value_string( desc.descriptor_type, "bDescriptorType", names::hid(desc.descriptor_type).unwrap_or_default(), indent + 2, LSUSB_DUMP_WIDTH, ); dump_value( desc.length, "wDescriptorLength", indent + 2, LSUSB_DUMP_WIDTH, ); } for desc in &hidd.descriptors { // only print report descriptor if desc.descriptor_type != 0x22 { continue; } match desc.data.as_ref() { Some(d) => { dump_report_desc(d, indent + 2); } None => { dump_string("Report Descriptors:", indent + 2); dump_string("** UNAVAILABLE **", indent + 4); } } } } fn dump_device_qualifier(dqd: &DeviceQualifierDescriptor, indent: usize) { dump_string("Device Qualifier (for other device speed):", indent); dump_value(dqd.length, "bLength", indent + 2, LSUSB_DUMP_WIDTH); dump_value( dqd.descriptor_type, "bDescriptorType", indent + 2, LSUSB_DUMP_WIDTH, ); dump_value(dqd.version, "bcdUSB", indent + 2, LSUSB_DUMP_WIDTH); let class: u8 = dqd.device_class as u8; dump_value_string( class, "bDeviceClass", names::class(class).unwrap_or(String::from("[unknown]")), indent + 2, LSUSB_DUMP_WIDTH, ); dump_value_string( dqd.device_subclass, "bDeviceSubClass", names::subclass(class, dqd.device_subclass).unwrap_or(String::from("[unknown]")), indent + 2, LSUSB_DUMP_WIDTH, ); dump_value_string( dqd.device_protocol, "bDeviceProtocol", names::protocol(class, dqd.device_subclass, dqd.device_protocol).unwrap_or_default(), indent + 2, LSUSB_DUMP_WIDTH, ); dump_value( dqd.max_packet_size, "bMaxPacketSize0", indent + 2, LSUSB_DUMP_WIDTH, ); dump_value( dqd.num_configurations, "bNumConfigurations", indent + 2, LSUSB_DUMP_WIDTH, ); } fn dump_debug(dd: &DebugDescriptor, indent: usize) { dump_string("Debug Descriptor:", indent); dump_value(dd.length, "bLength", indent + 2, LSUSB_DUMP_WIDTH); dump_value( dd.descriptor_type, "bDescriptorType", indent + 2, LSUSB_DUMP_WIDTH, ); dump_hex( dd.debug_in_endpoint, "bDebugInEndpoint", indent + 2, LSUSB_DUMP_WIDTH, ); dump_hex( dd.debug_out_endpoint, "bDebugOutEndpoint", indent + 2, LSUSB_DUMP_WIDTH, ); } fn dump_otg(otg: &OnTheGoDescriptor, indent: usize) { dump_string("OTG Descriptor:", indent); dump_value(otg.length, "bLength", indent + 2, LSUSB_DUMP_WIDTH); dump_value( otg.descriptor_type, "bDescriptorType", indent + 2, LSUSB_DUMP_WIDTH, ); dump_hex(otg.attributes, "bmAttributes", indent + 2, LSUSB_DUMP_WIDTH); if otg.attributes & 0x01 != 0 { dump_string("SRP (Session Request Protocol)", indent + 4); } if otg.attributes & 0x02 != 0 { dump_string("HNP (Host Negotiation Protocol)", indent + 4); } } const LINK_STATE_DESCRIPTIONS: [&str; 12] = [ "U0", "U1", "U2", "suspend", "SS.disabled", "Rx.Detect", "SS.Inactive", "Polling", "Recovery", "Hot Reset", "Compliance", "Loopback", ]; /// Dump a single value and the string representation of the value to the right of width fn bitmap_strings_port(bitmap: T, strings_f: fn(usize) -> Option<&'static str>) -> String where T: std::fmt::Display + std::fmt::LowerHex + Copy + Into, { let bitmap_u64: u64 = bitmap.into(); let num_bits = std::mem::size_of::() * 8; let mut ret = String::new(); for index in (0..num_bits).rev() { if (bitmap_u64 >> index) & 0x1 != 0 { if let Some(string) = strings_f(index) { ret.push_str(string); ret.push(' '); } } } ret } fn dump_hub(hd: &HubDescriptor, protocol: u8, bcd: u16, has_ssp: bool, indent: usize) { let is_ext_status = protocol == 3 && bcd >= 0x0310 && has_ssp; dump_string("Hub Descriptor:", indent); dump_value(hd.length, "bLength", indent + 2, LSUSB_DUMP_WIDTH); dump_value( hd.descriptor_type, "bDescriptorType", indent + 2, LSUSB_DUMP_WIDTH, ); dump_value(hd.num_ports, "nNbrPorts", indent + 2, LSUSB_DUMP_WIDTH); dump_hex( hd.characteristics, "wHubCharacteristic", indent + 2, LSUSB_DUMP_WIDTH, ); match hd.characteristics & 0x03 { 0 => println!("{:indent$}Ganged power switching", "", indent = indent + 4), 1 => println!( "{:indent$}Per-port power switching", "", indent = indent + 4 ), _ => println!( "{:indent$}No power switching (usb 1.0)", "", indent = indent + 4 ), } if hd.characteristics & 0x04 != 0 { println!("{:indent$}Compound device", "", indent = indent + 4); } match (hd.characteristics >> 3) & 0x03 { 0 => println!( "{:indent$}Ganged overcurrent protection", "", indent = indent + 4 ), 1 => println!( "{:indent$}Per-port overcurrent protection", "", indent = indent + 4 ), _ => println!( "{:indent$}No overcurrent protection", "", indent = indent + 4 ), } if (1..3).contains(&protocol) { let l = (hd.characteristics >> 5) & 0x03; dump_string( &format!("TT think time {} FS bits", (l + 1) * 8), indent + 4, ); } if protocol != 3 && hd.characteristics & (1 << 7) != 0 { dump_string("Port indicators", indent + 4); } dump_value_string( hd.power_on_to_power_good, "bPwrOn2PwrGood", "* 2 milli seconds", indent + 2, LSUSB_DUMP_WIDTH, ); if protocol == 3 { dump_value_string( (hd.control_current as u32) * 4, "bHubContrCurrent", "milli Ampere", indent + 2, LSUSB_DUMP_WIDTH, ); } else { dump_value_string( hd.control_current, "bHubContrCurrent", "milli Ampere", indent + 2, LSUSB_DUMP_WIDTH, ); } let offset = if protocol == 3 { dump_value_string( format!("0.{:1}", hd.latency().unwrap_or(0)), "bHubDecLat", "micro seconds", indent + 2, LSUSB_DUMP_WIDTH, ); dump_value_string( hd.delay().unwrap_or(0), "wHubDelay", "nano seconds", indent + 2, LSUSB_DUMP_WIDTH, ); 2 } else { 0 }; // determine the number of bytes needed to represent the number of ports let mut l = ((hd.num_ports >> 3) + 1) as usize; if l > 3 { l = 3; } dump_value( hd.data .iter() .skip(offset) .take(l) .map(|b| format!("0x{b:02x}")) .collect::>() .join(" "), "DeviceRemovable", indent + 2, LSUSB_DUMP_WIDTH, ); if protocol != 3 { dump_value( hd.data .iter() .skip(offset + l) .take(l) .map(|b| format!("0x{b:02x}")) .collect::>() .join(" "), "PortPwrCtrlMask", indent + 2, LSUSB_DUMP_WIDTH, ); } if let Some(ps) = hd.port_statuses.as_ref() { // + 1 in lsusb for some reason... dump_string("Hub Port Status:", indent + 1); for (i, p) in ps.iter().enumerate() { let port_status_string = format!( "Port {}: {:02x}{:02x}.{:02x}{:02x}", i + 1, p[3], p[2], p[1], p[0] ); if bcd < 0x0300 { let s2_string = bitmap_strings_port(p[2], |b| match b { 0 => Some("C_CONNECT"), 1 => Some("C_ENABLE"), 2 => Some("C_SUSPEND"), 3 => Some("C_OC"), 4 => Some("C_RESET"), _ => None, }); let s1_string = bitmap_strings_port(p[1], |b| match b { 0 => Some("power"), 1 => Some("lowspeed"), 2 => Some("highspeed"), 3 => Some("test"), 4 => Some("indicator"), _ => None, }); let s0_string = bitmap_strings_port(p[0], |b| match b { 0 => Some("connect"), 1 => Some("enable"), 2 => Some("suspend"), 3 => Some("oc"), 4 => Some("RESET"), 5 => Some("L1"), _ => None, }); dump_string( &format!("{port_status_string} {s2_string}{s1_string}{s0_string}"), indent + 3, ); } else { let link_state = (((p[0] & 0xe0) >> 5) + ((p[1] & 0x01) << 3)) as usize; let s2_string = bitmap_strings_port(p[2], |b| match b { 0 => Some("C_CONNECT"), 3 => Some("C_OC"), 4 => Some("C_RESET"), 5 => Some("C_BH_RESET"), 6 => Some("C_LINK_STATE"), 7 => Some("C_CONFIG_ERROR"), _ => None, }); let s1_string = format!( "{} {}", if p[1] & 0x1c == 0 { "5Gbps" } else { "Unknown Speed" }, if p[1] & 0x02 != 0 { "power " } else { " " }, ); let s0_string = bitmap_strings_port(p[0], |b| match b { 0 => Some("connect"), 1 => Some("enable"), 3 => Some("oc"), 4 => Some("RESET"), _ => None, }); if link_state < LINK_STATE_DESCRIPTIONS.len() { dump_string( &format!( "{} {}{}{}{}", port_status_string, s2_string, s1_string, LINK_STATE_DESCRIPTIONS[link_state], s0_string ), indent + 3, ); } else { dump_string( &format!("{port_status_string} {s2_string}{s1_string}{s0_string}"), indent + 3, ); } } if is_ext_status && (p[0] & 0x01 == 0x01) { dump_string( &format!( "Ext Status: {:02x}{:02x}{:02x}{:02x}", p[7], p[6], p[5], p[4] ), indent + 7, ); dump_string( &format!( "RX Speed Attribute ID: {} Lanes: {}", p[4] & 0x0f, (p[5] & 0x0f) + 1 ), indent + 7, ); dump_string( &format!( "TX Speed Attribute ID: {} Lanes: {}", (p[4] >> 4) & 0x0f, ((p[5] >> 4) & 0x0f) + 1 ), indent + 7, ); } } } } fn dump_device_status(status: u16, otg: bool, super_speed: bool, indent: usize) { dump_hex(status, "Device Status:", indent, LSUSB_DUMP_WIDTH); if status & 0x01 != 0 { println!("{:indent$}Self Powered", "", indent = indent + 2); } else { println!("{:indent$}(Bus Powered)", "", indent = indent + 2); } if status & 0x02 != 0 { println!("{:indent$}Remote Wakeup Enabled", "", indent = indent + 2); } if super_speed { if status & (1 << 2) != 0 { println!("{:indent$}U1 Enabled", "", indent = indent + 2); } if status & (1 << 3) != 0 { println!("{:indent$}U2 Enabled", "", indent = indent + 2); } if status & (1 << 4) != 0 { println!( "{:indent$}Latency Tolerance Messaging (LTM) Enabled", "", indent = indent + 2 ); } } if otg { if status & (1 << 3) != 0 { println!("{:indent$}HNP Enabled", "", indent = indent + 2); } if status & (1 << 4) != 0 { println!("{:indent$}HNP Capable", "", indent = indent + 2); } if status & (1 << 5) != 0 { println!("{:indent$}ALT port is HNP Capable", "", indent = indent + 2); } } if status & (1 << 6) != 0 { println!("{:indent$}Debug Mode", "", indent = indent + 2); } } /// Verbatim port of lsusb's dump_unit - not very Rust, don't judge! fn dump_unit(mut data: u16, len: usize, indent: usize) { let systems = |t: u16| match t { 0x01 => "SI Linear", 0x02 => "SI Rotation", 0x03 => "English Linear", 0x04 => "English Rotation", _ => "None", }; let units = |t: u16, i: usize| match (t, i) { (1, 1) => "Centimeter", (2, 1) => "Radians", (1, 2) | (2, 2) => "Gram", (1, 4) | (2, 4) => "Kelvin", (3, 1) => "Inch", (4, 1) => "Degrees", (1, i) | (2, i) | (3, i) | (4, i) => match i { 0x02 => "Slug", 0x03 => "Seconds", 0x04 => "Fahrenheit", 0x05 => "Ampere", 0x06 => "Camdela", _ => "None", }, (_, _) => "None", }; let sys = data & 0xf; data >>= 4; if sys > 4 { if sys == 0xf { println!("{:indent$}System: Vendor defined, Unit: (unknown)", ""); } else { println!("{:indent$}System: Reserved, Unit: (unknown)", ""); } return; } print!("{:indent$}System: {}, Unit: ", "", systems(sys)); let mut earlier_unit = 0; for i in 1..len * 2 { let nibble = data & 0xf; data >>= 4; if nibble != 0 { if earlier_unit > 0 { print!("*"); } print!("{}", units(sys, i)); earlier_unit += 1; /* This is a _signed_ nibble(!) */ if nibble != 1 { let mut val: i8 = (nibble as i8) & 0x7; if nibble & 0x08 != 0x00 { val = -((0x7 & !val) + 1); } print!("^{val}"); } } } if earlier_unit == 0 { print!("(None)"); } println!(); } /// Dumps HID report data ported directly from lsusb - it's not pretty but works... fn dump_report_desc(desc: &[u8], indent: usize) { // ported from lsusb - indented to 28 spaces for some reason... const REPORT_INDENT: usize = 12; let types = |t: u8| match t { 0x00 => "Main", 0x01 => "Global", 0x02 => "Local", _ => "reserved", }; dump_string( &format!("Report Descriptor: (length is {})", desc.len()), indent, ); let mut i = 0; while i < desc.len() { let b = desc[i]; let mut data = 0xffff; let mut hut = 0xff; let mut bsize = (b & 0x03) as usize; if bsize == 3 { bsize = 4; } let btype = b & (0x03 << 2); let btag = b & !0x03; // Item Header print!( "{:indent$}Item({:>6}): {}, data=", "", types(btype >> 2), names::report_tag(btag).unwrap_or_default(), indent = indent + 2 ); // Check for descriptor bounds if i + bsize >= desc.len() { println!("Error: Descriptor too short"); break; } if bsize > 0 { print!(" [ "); data = 0; for j in 0..bsize { data |= (desc[i + 1 + j] as u32) << (j * 8); print!("{:02x} ", desc[i + 1 + j]); } println!("] {data}"); } else { println!("none"); } match btag { // usage page 0x04 => { hut = data as u8; if let Some(hut) = names::huts(hut) { println!("{:indent$}{}", "", hut, indent = REPORT_INDENT); } } // usage, usage minimum, usage maximum 0x08 | 0x18 | 0x28 => { if let Some(hutus) = names::hutus(hut, data as u16) { println!("{:indent$}{}", "", hutus, indent = REPORT_INDENT); } } // unit exponent 0x54 => { println!( "{:indent$}Unit Exponent: {}", "", data as u8, indent = REPORT_INDENT ); } // unit 0x64 => dump_unit(data as u16, bsize, REPORT_INDENT), // collection 0xa0 => match data { 0x00 => println!("{:indent$}Physical", "", indent = REPORT_INDENT), 0x01 => println!("{:indent$}Application", "", indent = REPORT_INDENT), 0x02 => println!("{:indent$}Logical", "", indent = REPORT_INDENT), 0x03 => println!("{:indent$}Report", "", indent = REPORT_INDENT), 0x04 => println!("{:indent$}Named Array", "", indent = REPORT_INDENT), 0x05 => println!("{:indent$}Usage Switch", "", indent = REPORT_INDENT), 0x06 => println!("{:indent$}Usage Modifier", "", indent = REPORT_INDENT), _ => { if (data & 0x80) == 0x80 { println!("{:indent$}Vendor defined", "", indent = REPORT_INDENT) } else { println!("{:indent$}Unknown", "", indent = REPORT_INDENT) } } }, // input, output, feature 0x80 | 0x90 | 0xb0 => { let attributes_1 = format!( "{:indent$}{} {} {} {} {}", "", if data & 0x01 != 0 { "Constant" } else { "Data" }, if data & 0x02 != 0 { "Variable" } else { "Array" }, if data & 0x04 != 0 { "Relative" } else { "Absolute" }, if data & 0x08 != 0 { "Wrap" } else { "No_Wrap" }, if data & 0x10 != 0 { "Non_Linear" } else { "Linear" }, indent = REPORT_INDENT ); let attributes_2 = format!( "{:indent$}{} {} {} {}", "", if data & 0x20 != 0 { "No_Preferred_State" } else { "Preferred_State" }, if data & 0x40 != 0 { "Null_State" } else { "No_Null_Position" }, if data & 0x80 != 0 { "Volatile" } else { "Non_Volatile" }, if data & 0x100 != 0 { "Buffered Bytes" } else { "Bitfield" }, indent = REPORT_INDENT ); println!("{attributes_1}"); println!("{attributes_2}"); } _ => (), } i += 1 + bsize; } } #[cfg(test)] mod tests { use super::*; #[test] fn test_get_spaces() { assert_eq!(get_spaces(4, 10, LSUSB_DUMP_WIDTH), " "); assert_eq!(get_spaces(24, 10, 20), " "); assert_eq!(get_spaces(2, 17, 20), " "); assert_eq!(get_spaces(17, 2, 20), " "); assert_eq!(get_spaces(16, 2, 20), " "); } #[test] fn test_dump_value() { let bytes = [0x01; 32]; let bytes_string = bytes .iter() .map(|b| format!("{b:02x}")) .collect::>() .join(" "); // test no panic since is to stdout dump_value(bytes_string, "bmConfigured", 4, LSUSB_DUMP_WIDTH); } } cyme-2.2.6/src/lsusb/000077500000000000000000000000001506545537300144125ustar00rootroot00000000000000cyme-2.2.6/src/lsusb/audio_dumps.rs000066400000000000000000002004241506545537300172730ustar00rootroot00000000000000use crate::usb::descriptors::audio; use super::*; const UAC2_INTERFACE_HEADER_BMCONTROLS: [&str; 1] = ["Legacy"]; const UAC2_INPUT_TERMINAL_BMCONTROLS: [&str; 6] = [ "Copy Protect", "Connector", "Overload", "Cluster", "Underflow", "Overflow", ]; const UAC3_INPUT_TERMINAL_BMCONTROLS: [&str; 5] = [ "Insertion", "Overload", "Underflow", "Overflow", "Underflow", ]; const UAC2_OUTPUT_TERMINAL_BMCONTROLS: [&str; 5] = [ "Copy Protect", "Connector", "Overload", "Underflow", "Overflow", ]; const UAC3_OUTPUT_TERMINAL_BMCONTROLS: [&str; 4] = ["Insertion", "Overload", "Underflow", "Overflow"]; const UAC2_AS_INTERFACE_BMCONTROLS: [&str; 2] = ["Active Alternate Setting", "Valid Alternate Setting"]; const UAC3_AS_INTERFACE_BMCONTROLS: [&str; 3] = [ "Active Alternate Setting", "Valid Alternate Setting", "Audio Data Format Control", ]; const UAC2_AS_ISO_ENDPOINT_BMCONTROLS: [&str; 3] = ["Pitch", "Data Overrun", "Data Underrun"]; const UAC2_MIXER_UNIT_BMCONTROLS: [&str; 4] = ["Cluster", "Underflow", "Overflow", "Overflow"]; const UAC3_MIXER_UNIT_BMCONTROLS: [&str; 2] = ["Underflow", "Overflow"]; const UAC2_SELECTOR_UNIT_BMCONTROLS: [&str; 1] = ["Selector"]; const UAC1_FEATURE_UNIT_BMCONTROLS: [&str; 13] = [ "Mute", "Volume", "Bass", "Mid", "Treble", "Graphic Equalizer", "Automatic Gain", "Delay", "Bass Boost", "Loudness", "Input gain", "Input gain pad", "Phase invert", ]; const UAC2_EXTENSION_UNIT_BMCONTROLS: [&str; 4] = ["Enable", "Cluster", "Underflow", "Overflow"]; const UAC3_EXTENSION_UNIT_BMCONTROLS: [&str; 2] = ["Underflow", "Overflow"]; const UAC2_CLOCK_SOURCE_BMCONTROLS: [&str; 2] = ["Clock Frequency", "Clock Validity"]; const UAC2_CLOCK_SELECTOR_BMCONTROLS: [&str; 1] = ["Clock Selector"]; const UAC2_CLOCK_MULTIPLIER_BMCONTROLS: [&str; 2] = ["Clock Numerator", "Clock Denominator"]; const UAC3_PROCESSING_UNIT_UP_DOWN_BMCONTROLS: [&str; 3] = ["Mode Select", "Underflow", "Overflow"]; const UAC3_PROCESSING_UNIT_STEREO_EXTENDER_BMCONTROLS: [&str; 3] = ["Width", "Underflow", "Overflow"]; const UAC3_PROCESSING_UNIT_MULTI_FUNC_BMCONTROLS: [&str; 2] = ["Underflow", "Overflow"]; fn dump_bitmap_controls>( controls: T, control_descriptions: &[&'static str], desc_type: &audio::ControlType, indent: usize, ) { let controls: u32 = controls.into(); for (index, control) in control_descriptions.iter().enumerate() { match desc_type { audio::ControlType::BmControl1 => { if (controls >> index) & 0x1 != 0 { println!("{:indent$}{} Control", "", control, indent = indent); } } audio::ControlType::BmControl2 => { let c = ((controls >> (index * 2)) & 0x3) as u8; if c != 0 { println!( "{:indent$}{} Control ({})", "", control, audio::ControlSetting::from(c), indent = indent ) } } } } } fn dump_bitmap_controls_array + std::fmt::Display + Copy>( field_name: &str, controls: &[T], control_descriptions: &[&'static str], desc_type: &audio::ControlType, indent: usize, width: usize, ) { for (i, control) in controls.iter().enumerate() { let control = control.to_owned(); let control: u32 = control.into(); dump_value(control, &format!("{field_name}({i:2})"), indent, width); dump_bitmap_controls(control, control_descriptions, desc_type, indent + 2); } } fn dump_audio_mixer_unit1(mixer_unit: &audio::MixerUnit1, indent: usize, width: usize) { dump_value(mixer_unit.unit_id, "bUnitID", indent, width); dump_value(mixer_unit.nr_in_pins, "bNrInPins", indent, width); dump_array(&mixer_unit.source_ids, "baSourceID", indent, width); dump_value(mixer_unit.nr_channels, "bNrChannels", indent, width); dump_hex(mixer_unit.channel_config, "wChannelConfig", indent, width); let channel_names = audio::UacInterfaceDescriptor::get_channel_name_strings( &audio::UacProtocol::Uac1, mixer_unit.channel_config as u32, ); for name in channel_names.iter() { println!("{:indent$}{}", "", name, indent = indent + 2); } dump_value(mixer_unit.channel_names, "iChannelNames", indent, width); dump_bitmap_array(&mixer_unit.controls, "bmControls", indent, width); dump_value(mixer_unit.mixer, "iMixer", indent, width); } fn dump_audio_mixer_unit2(mixer_unit: &audio::MixerUnit2, indent: usize, width: usize) { dump_value(mixer_unit.unit_id, "bUnitID", indent, width); dump_value(mixer_unit.nr_in_pins, "bNrInPins", indent, width); dump_array(&mixer_unit.source_ids, "baSourceID", indent, width); dump_value(mixer_unit.nr_channels, "bNrChannels", indent, width); dump_hex(mixer_unit.channel_config, "bmChannelConfig", indent, width); let channel_names = audio::UacInterfaceDescriptor::get_channel_name_strings( &audio::UacProtocol::Uac2, mixer_unit.channel_config, ); for name in channel_names.iter() { println!("{:indent$}{}", "", name, indent = indent + 2); } dump_value(mixer_unit.channel_names, "iChannelNames", indent, width); dump_bitmap_array(&mixer_unit.mixer_controls, "bmMixerControls", indent, width); dump_hex(mixer_unit.controls, "bmControls", indent, width); dump_bitmap_controls( mixer_unit.controls as u32, &UAC2_MIXER_UNIT_BMCONTROLS, &audio::ControlType::BmControl2, indent + 2, ); dump_value(mixer_unit.mixer, "iMixer", indent, width); } fn dump_audio_mixer_unit3(mixer_unit: &audio::MixerUnit3, indent: usize, width: usize) { dump_value(mixer_unit.unit_id, "bUnitID", indent, width); dump_value(mixer_unit.nr_in_pins, "bNrInPins", indent, width); dump_array(&mixer_unit.source_ids, "baSourceID", indent, width); dump_value( mixer_unit.cluster_descr_id, "wClusterDescrID", indent, width, ); dump_bitmap_array(&mixer_unit.mixer_controls, "bmMixerControls", indent, width); dump_hex(mixer_unit.controls, "bmControls", indent, width); dump_bitmap_controls( mixer_unit.controls, &UAC3_MIXER_UNIT_BMCONTROLS, &audio::ControlType::BmControl2, indent + 2, ); dump_value(mixer_unit.mixer_descr_str, "wMixerDescrStr", indent, width); } fn dump_audio_power_domain(power_domain: &audio::PowerDomain, indent: usize, width: usize) { dump_value( power_domain.power_domain_id, "bPowerDomainID", indent, width, ); dump_value( power_domain.recovery_time_1, "waRecoveryTime(1)", indent, width, ); dump_value( power_domain.recovery_time_2, "waRecoveryTime(2)", indent, width, ); dump_value(power_domain.nr_entities, "bNrEntities", indent, width); dump_array(&power_domain.entity_ids, "baEntityID", indent, width); dump_value( power_domain.domain_descr_str, "wPDomainDescrStr", indent, width, ); } pub(crate) fn dump_audio_selector_unit1( selector_unit: &audio::SelectorUnit1, indent: usize, width: usize, ) { dump_value(selector_unit.unit_id, "bUnitID", indent, width); dump_value(selector_unit.nr_in_pins, "bNrInPins", indent, width); dump_array(&selector_unit.source_ids, "baSourceID", indent, width); dump_value_string( selector_unit.selector_index, "iSelector", selector_unit.selector.as_ref().unwrap_or(&"".into()), indent, width, ); } fn dump_audio_selector_unit2(selector_unit: &audio::SelectorUnit2, indent: usize, width: usize) { dump_value(selector_unit.unit_id, "bUnitID", indent, width); dump_value(selector_unit.nr_in_pins, "bNrInPins", indent, width); dump_array(&selector_unit.source_ids, "baSourceID", indent, width); dump_hex(selector_unit.controls, "bmControls", indent, width); dump_bitmap_controls( selector_unit.controls, &UAC2_SELECTOR_UNIT_BMCONTROLS, &audio::ControlType::BmControl2, indent + 2, ); dump_value_string( selector_unit.selector_index, "iSelector", selector_unit.selector.as_ref().unwrap_or(&"".into()), indent, width, ); } fn dump_audio_selector_unit3(selector_unit: &audio::SelectorUnit3, indent: usize, width: usize) { dump_value(selector_unit.unit_id, "bUnitID", indent, width); dump_value(selector_unit.nr_in_pins, "bNrInPins", indent, width); dump_array(&selector_unit.source_ids, "baSourceID", indent, width); dump_hex(selector_unit.controls, "bmControls", indent, width); dump_bitmap_controls( selector_unit.controls, &UAC2_SELECTOR_UNIT_BMCONTROLS, &audio::ControlType::BmControl2, indent + 2, ); dump_value( selector_unit.selector_descr_str, "wSelectorDescrStr", indent, width, ); } /// Dumps the contents of a UAC1 Processing Unit Descriptor fn dump_audio_processing_unit1(unit: &audio::ProcessingUnit1, indent: usize, width: usize) { dump_value(unit.unit_id, "bUnitID", indent, width); dump_value_string( unit.process_type, "wProcessType", unit.processing_type(), indent, width, ); dump_value(unit.nr_in_pins, "bNrInPins", indent, width); dump_array(&unit.source_ids, "baSourceID", indent, width); dump_value(unit.nr_channels, "bNrChannels", indent, width); dump_hex(unit.channel_config, "wChannelConfig", indent, width); let channel_names = audio::UacInterfaceDescriptor::get_channel_name_strings( &audio::UacProtocol::Uac1, unit.channel_config as u32, ); for name in channel_names.iter() { println!("{:indent$}{}", "", name, indent = indent + 2); } dump_value_string( unit.channel_names_index, "iChannelNames", unit.channel_names.as_ref().unwrap_or(&"".into()), indent, width, ); dump_value(unit.control_size, "bControlSize", indent, width); dump_bitmap_array(&unit.controls, "bmControls", indent, width); dump_value_string( unit.processing_index, "iProcessing", unit.processing.as_ref().unwrap_or(&"".into()), indent, width, ); if let Some(ref specific) = unit.specific { dump_value(specific.nr_modes, "bNrModes", indent, width); dump_bitmap_array(&specific.modes, "waModes", indent, width); } } /// Dumps the contents of a UAC2 Processing Unit Descriptor fn dump_audio_processing_unit2(unit: &audio::ProcessingUnit2, indent: usize, width: usize) { dump_value(unit.unit_id, "bUnitID", indent, width); dump_value_string( unit.process_type, "wProcessType", unit.processing_type(), indent, width, ); dump_value(unit.nr_in_pins, "bNrInPins", indent, width); dump_array(&unit.source_ids, "baSourceID", indent, width); dump_value(unit.nr_channels, "bNrChannels", indent, width); dump_hex(unit.channel_config, "bmChannelConfig", indent, width); let channel_names = audio::UacInterfaceDescriptor::get_channel_name_strings( &audio::UacProtocol::Uac2, unit.channel_config, ); for name in channel_names.iter() { println!("{:indent$}{}", "", name, indent = indent + 2); } dump_value_string( unit.channel_names_index, "iChannelNames", unit.channel_names.as_ref().unwrap_or(&"".into()), indent, width, ); dump_value(unit.controls, "bmControls", indent, width); dump_value_string( unit.processing_index, "iProcessing", unit.processing.as_ref().unwrap_or(&"".into()), indent, width, ); if let Some(ref specific) = unit.specific { match specific { audio::AudioProcessingUnit2Specific::UpDownMix(up_down_mix) => { dump_value(up_down_mix.nr_modes, "bNrModes", indent, width); dump_bitmap_array(&up_down_mix.modes, "daModes", indent, width); } audio::AudioProcessingUnit2Specific::DolbyPrologic(dolby_prologic) => { dump_value(dolby_prologic.nr_modes, "bNrModes", indent, width); dump_bitmap_array(&dolby_prologic.modes, "daModes", indent, width); } } } } /// Dumps the contents of a UAC3 Processing Unit Descriptor fn dump_audio_processing_unit3(unit: &audio::ProcessingUnit3, indent: usize, width: usize) { dump_value(unit.unit_id, "bUnitID", indent, width); dump_value_string( unit.process_type, "wProcessType", unit.processing_type(), indent, width, ); dump_value(unit.nr_in_pins, "bNrInPins", indent, width); dump_array(&unit.source_ids, "baSourceID", indent, width); dump_value( unit.processing_descr_str, "wProcessingDescrStr", indent, width, ); if let Some(ref specific) = unit.specific { match specific { audio::AudioProcessingUnit3Specific::UpDownMix(up_down_mix) => { dump_hex(up_down_mix.controls, "bmControls", indent, width); dump_bitmap_controls( up_down_mix.controls, &UAC3_PROCESSING_UNIT_UP_DOWN_BMCONTROLS, &audio::ControlType::BmControl2, indent + 2, ); dump_value(up_down_mix.nr_modes, "bNrModes", indent, width); dump_array( &up_down_mix.cluster_descr_ids, "waClusterDescrID", indent, width, ); } audio::AudioProcessingUnit3Specific::StereoExtender(stereo_extender) => { dump_hex(stereo_extender.controls, "bmControls", indent, width); dump_bitmap_controls( stereo_extender.controls, &UAC3_PROCESSING_UNIT_STEREO_EXTENDER_BMCONTROLS, &audio::ControlType::BmControl2, indent + 2, ); } audio::AudioProcessingUnit3Specific::MultiFunction(multi_function) => { dump_hex(multi_function.controls, "bmControls", indent, width); dump_bitmap_controls( multi_function.controls, &UAC3_PROCESSING_UNIT_MULTI_FUNC_BMCONTROLS, &audio::ControlType::BmControl2, indent + 2, ); dump_value( multi_function.cluster_descr_id, "wClusterDescrID", indent, width, ); dump_value(multi_function.algorithms, "bmAlgorithms", indent, width); if let Some(ref algorithms) = unit.algorithms() { for algorithm in algorithms.iter() { println!("{:indent$}{}", "", algorithm, indent = indent + 2); } } } } } } /// Dumps the contents of a UAC2 Effect Unit Descriptor fn dump_audio_effect_unit2(unit: &audio::EffectUnit2, indent: usize, width: usize) { dump_value(unit.unit_id, "bUnitID", indent, width); dump_value(unit.effect_type, "wEffectType", indent, width); dump_value(unit.source_id, "bSourceID", indent, width); dump_bitmap_array(&unit.controls, "bmaControls", indent, width); dump_value(unit.effect_index, "iEffects", indent, width); dump_value_string( unit.effect_index, "iEffects", unit.effect.as_ref().unwrap_or(&"".into()), indent, width, ); } /// Dumps the contents of a UAC3 Effect Unit Descriptor fn dump_audio_effect_unit3(unit: &audio::EffectUnit3, indent: usize, width: usize) { dump_value(unit.unit_id, "bUnitID", indent, width); dump_value(unit.effect_type, "wEffectType", indent, width); dump_value(unit.source_id, "bSourceID", indent, width); dump_bitmap_array(&unit.controls, "bmaControls", indent, width); dump_value(unit.effect_descr_str, "wEffectsDescrStr", indent, width); } /// Dumps the contents of a UAC1 Feature Unit Descriptor fn dump_audio_feature_unit1(unit: &audio::FeatureUnit1, indent: usize, width: usize) { dump_value(unit.unit_id, "bUnitID", indent, width); dump_value(unit.source_id, "bSourceID", indent, width); dump_value(unit.control_size, "bControlSize", indent, width); dump_bitmap_controls_array( "bmaControls", &unit.controls, &UAC1_FEATURE_UNIT_BMCONTROLS, &audio::ControlType::BmControl1, indent, width, ); dump_value_string( unit.feature_index, "iFeature", unit.feature.as_ref().unwrap_or(&"".into()), indent, width, ); } /// Dumps the contents of a UAC2 Feature Unit Descriptor fn dump_audio_feature_unit2(unit: &audio::FeatureUnit2, indent: usize, width: usize) { dump_value(unit.unit_id, "bUnitID", indent, width); dump_value(unit.source_id, "bSourceID", indent, width); dump_bitmap_controls_array( "bmaControls", &unit.controls, &UAC1_FEATURE_UNIT_BMCONTROLS, &audio::ControlType::BmControl1, indent, width, ); dump_value_string( unit.feature_index, "iFeature", unit.feature.as_ref().unwrap_or(&"".into()), indent, width, ); } /// Dumps the contents of a UAC3 Feature Unit Descriptor fn dump_audio_feature_unit3(unit: &audio::FeatureUnit3, indent: usize, width: usize) { dump_value(unit.unit_id, "bUnitID", indent, width); dump_value(unit.source_id, "bSourceID", indent, width); dump_bitmap_controls_array( "bmaControls", &unit.controls, &UAC1_FEATURE_UNIT_BMCONTROLS, &audio::ControlType::BmControl1, indent, width, ); dump_value(unit.feature_descr_str, "wFeatureDescrStr", indent, width); } /// Dumps the contents of a UAC1 Extension Unit Descriptor fn dump_audio_extension_unit1(unit: &audio::ExtensionUnit1, indent: usize, width: usize) { dump_value(unit.unit_id, "bUnitID", indent, width); dump_value(unit.extension_code, "wExtensionCode", indent, width); dump_value(unit.nr_in_pins, "bNrInPins", indent, width); dump_array(&unit.source_ids, "baSourceID", indent, width); dump_value(unit.nr_channels, "bNrChannels", indent, width); dump_hex(unit.channel_config, "wChannelConfig", indent, width); let channel_names = audio::UacInterfaceDescriptor::get_channel_name_strings( &audio::UacProtocol::Uac1, unit.channel_config as u32, ); for name in channel_names.iter() { println!("{:indent$}{}", "", name, indent = indent + 2); } dump_value(unit.channel_names_index, "iChannelNames", indent, width); dump_value_string( unit.channel_names_index, "iChannelNames", unit.channel_names.as_ref().unwrap_or(&"".into()), indent, width, ); dump_value(unit.control_size, "bControlSize", indent, width); dump_bitmap_array(&unit.controls, "bmControls", indent, width); dump_value_string( unit.extension_index, "iExtension", unit.extension.as_ref().unwrap_or(&"".into()), indent, width, ); } /// Dumps the contents of a UAC2 Extension Unit Descriptor fn dump_audio_extension_unit2(unit: &audio::ExtensionUnit2, indent: usize, width: usize) { dump_value(unit.unit_id, "bUnitID", indent, width); dump_value(unit.extension_code, "wExtensionCode", indent, width); dump_value(unit.nr_in_pins, "bNrInPins", indent, width); dump_array(&unit.source_ids, "baSourceID", indent, width); dump_value(unit.nr_channels, "bNrChannels", indent, width); dump_hex(unit.channel_config, "bmChannelConfig", indent, width); let channel_names = audio::UacInterfaceDescriptor::get_channel_name_strings( &audio::UacProtocol::Uac2, unit.channel_config, ); for name in channel_names.iter() { println!("{:indent$}{}", "", name, indent = indent + 2); } dump_value_string( unit.channel_names_index, "iChannelNames", unit.channel_names.as_ref().unwrap_or(&"".into()), indent, width, ); dump_hex(unit.controls, "bmControls", indent, width); dump_bitmap_controls( unit.controls, &UAC2_EXTENSION_UNIT_BMCONTROLS, &audio::ControlType::BmControl2, indent + 2, ); dump_value_string( unit.extension_index, "iExtension", unit.extension.as_ref().unwrap_or(&"".into()), indent, width, ); } /// Dumps the contents of a UAC3 Extension Unit Descriptor fn dump_audio_extension_unit3(unit: &audio::ExtensionUnit3, indent: usize, width: usize) { dump_value(unit.unit_id, "bUnitID", indent, width); dump_value(unit.extension_code, "wExtensionCode", indent, width); dump_value(unit.nr_in_pins, "bNrInPins", indent, width); dump_array(&unit.source_ids, "baSourceID", indent, width); dump_value( unit.extension_descr_str, "wExtensionDescrStr", indent, width, ); dump_hex(unit.controls, "bmControls", indent, width); dump_bitmap_controls( unit.controls, &UAC3_EXTENSION_UNIT_BMCONTROLS, &audio::ControlType::BmControl2, indent + 2, ); dump_value(unit.cluster_descr_id, "wClusterDescrID", indent, width); } /// Dumps the contents of a UAC2 Clock Source Descriptor fn dump_audio_clock_source2(source: &audio::ClockSource2, indent: usize, width: usize) { let uac2_clk_src_bmattr = |index: usize| -> Option<&'static str> { match index { 0 => Some("External"), 1 => Some("Internal fixed"), 2 => Some("Internal variable"), 3 => Some("Internal programmable"), _ => None, } }; dump_value(source.clock_id, "bClockID", indent, width); dump_hex(source.attributes, "bmAttributes", indent, width); dump_bitmap_strings(source.attributes, uac2_clk_src_bmattr, indent + 2); dump_hex(source.controls, "bmControls", indent, width); dump_bitmap_controls( source.controls, &UAC2_CLOCK_SOURCE_BMCONTROLS, &audio::ControlType::BmControl2, indent + 2, ); dump_value(source.assoc_terminal, "bAssocTerminal", indent, width); dump_value_string( source.clock_source_index, "iClockSource", source.clock_source.as_ref().unwrap_or(&"".into()), indent, width, ); } /// Dumps the contents of a UAC3 Clock Source Descriptor fn dump_audio_clock_source3(source: &audio::ClockSource3, indent: usize, width: usize) { let uac3_clk_src_bmattr = |index: usize| -> Option<&'static str> { match index { 0 => Some("External"), 1 => Some("Internal"), 2 => Some("(asynchronous)"), 3 => Some("(synchronized to SOF)"), _ => None, } }; dump_value(source.clock_id, "bClockID", indent, width); dump_hex(source.attributes, "bmAttributes", indent, width); dump_bitmap_strings(source.attributes, uac3_clk_src_bmattr, indent + 2); dump_hex(source.controls, "bmControls", indent, width); dump_bitmap_controls( source.controls, &UAC2_CLOCK_SOURCE_BMCONTROLS, &audio::ControlType::BmControl2, indent + 2, ); dump_value( source.reference_terminal, "bReferenceTerminal", indent, width, ); dump_value(source.clock_source_str, "wClockSourceStr", indent, width); } /// Dumps the contents of a UAC2 Clock Selector Descriptor fn dump_audio_clock_selector2(selector: &audio::ClockSelector2, indent: usize, width: usize) { dump_value(selector.clock_id, "bClockID", indent, width); dump_value(selector.nr_in_pins, "bNrInPins", indent, width); dump_array(&selector.csource_ids, "baCSourceID", indent, width); dump_hex(selector.controls, "bmControls", indent, width); dump_bitmap_controls( selector.controls, &UAC2_CLOCK_SELECTOR_BMCONTROLS, &audio::ControlType::BmControl2, indent + 2, ); dump_value_string( selector.clock_selector_index, "iClockSelector", selector.clock_selector.as_ref().unwrap_or(&"".into()), indent, width, ); } /// Dumps the contents of a UAC3 Clock Selector Descriptor fn dump_audio_clock_selector3(selector: &audio::ClockSelector3, indent: usize, width: usize) { dump_value(selector.clock_id, "bClockID", indent, width); dump_value(selector.nr_in_pins, "bNrInPins", indent, width); dump_array(&selector.csource_ids, "baCSourceID", indent, width); dump_hex(selector.controls, "bmControls", indent, width); dump_bitmap_controls( selector.controls, &UAC2_CLOCK_SELECTOR_BMCONTROLS, &audio::ControlType::BmControl2, indent + 2, ); dump_value( selector.cselector_descr_str, "wCSelectorDescrStr", indent, width, ); } /// Dumps the contents of a UAC2 Clock Multiplier Descriptor fn dump_audio_clock_multiplier2(multiplier: &audio::ClockMultiplier2, indent: usize, width: usize) { dump_value(multiplier.clock_id, "bClockID", indent, width); dump_value(multiplier.csource_id, "bCSourceID", indent, width); dump_hex(multiplier.controls, "bmControls", indent, width); dump_bitmap_controls( multiplier.controls, &UAC2_CLOCK_MULTIPLIER_BMCONTROLS, &audio::ControlType::BmControl2, indent + 2, ); dump_value_string( multiplier.clock_multiplier_index, "iClockMultiplier", multiplier.clock_multiplier.as_ref().unwrap_or(&"".into()), indent, width, ); } /// Dumps the contents of a UAC3 Clock Multiplier Descriptor fn dump_audio_clock_multiplier3(multiplier: &audio::ClockMultiplier3, indent: usize, width: usize) { dump_value(multiplier.clock_id, "bClockID", indent, width); dump_value(multiplier.csource_id, "bCSourceID", indent, width); dump_hex(multiplier.controls, "bmControls", indent, width); dump_bitmap_controls( multiplier.controls, &UAC2_CLOCK_MULTIPLIER_BMCONTROLS, &audio::ControlType::BmControl2, indent + 2, ); dump_value( multiplier.cmultiplier_descr_str, "wCMultiplierDescrStr", indent, width, ); } fn dump_audio_sample_rate_converter2( converter: &audio::SampleRateConverter2, indent: usize, width: usize, ) { dump_value(converter.unit_id, "bUnitID", indent, width); dump_value(converter.source_id, "bSourceID", indent, width); dump_value(converter.csource_in_id, "bCSourceInID", indent, width); dump_value(converter.csource_out_id, "bCSourceOutID", indent, width); dump_value_string( converter.src_index, "iSRC", converter.src.as_ref().unwrap_or(&"".into()), indent, width, ); } fn dump_audio_sample_rate_converter3( converter: &audio::SampleRateConverter3, indent: usize, width: usize, ) { dump_value(converter.unit_id, "bUnitID", indent, width); dump_value(converter.source_id, "bSourceID", indent, width); dump_value(converter.csource_in_id, "bCSourceInID", indent, width); dump_value(converter.csource_out_id, "bCSourceOutID", indent, width); dump_value(converter.src_descr_str, "wSRCDescrStr", indent, width); } fn dump_audio_header1(header: &audio::Header1, indent: usize, width: usize) { dump_value(header.version, "bcdADC", indent, width); dump_value(header.total_length, "wTotalLength", indent, width); dump_value(header.collection_bytes, "bInCollection", indent, width); dump_array(&header.interfaces, "baInterfaceNr", indent, width); } fn dump_audio_header2(header: &audio::Header2, indent: usize, width: usize) { dump_value(header.version, "bcdADC", indent, width); dump_value(header.total_length, "wTotalLength", indent, width); dump_hex(header.controls, "bmControls", indent, width); dump_bitmap_controls( header.controls as u32, &UAC2_INTERFACE_HEADER_BMCONTROLS, &audio::ControlType::BmControl2, indent + 2, ); } fn dump_audio_header3(header: &audio::Header3, indent: usize, width: usize) { dump_value(header.category, "bCategory", indent, width); dump_value(header.total_length, "wTotalLength", indent, width); dump_hex(header.controls, "bmControls", indent, width); dump_bitmap_controls( header.controls, &UAC2_INTERFACE_HEADER_BMCONTROLS, &audio::ControlType::BmControl2, indent + 2, ); } fn dump_audio_input_terminal1(ait: &audio::InputTerminal1, indent: usize, width: usize) { dump_value(ait.terminal_id, "bTerminalID", indent, width); println!( "{:indent$}wTerminalType {:5} {}", "", ait.terminal_type, names::videoterminal(ait.terminal_type).unwrap_or_default(), indent = indent ); dump_value(ait.assoc_terminal, "bAssocTerminal", indent, width); dump_value(ait.nr_channels, "bNrChannels", indent, width); dump_hex(ait.channel_config, "wChannelConfig", indent, width); let channel_names = audio::UacInterfaceDescriptor::get_channel_name_strings( &audio::UacProtocol::Uac1, ait.channel_config as u32, ); for name in channel_names.iter() { println!("{:indent$}{}", "", name, indent = indent + 2); } dump_value_string( ait.channel_names_index, "iChannelNames", ait.channel_names.as_ref().unwrap_or(&"".into()), indent, width, ); dump_value_string( ait.terminal_index, "iTerminal", ait.terminal.as_ref().unwrap_or(&"".into()), indent, width, ); } fn dump_audio_input_terminal2(ait: &audio::InputTerminal2, indent: usize, width: usize) { dump_value(ait.terminal_id, "bTerminalID", indent, width); dump_name( ait.terminal_type, names::videoterminal, "wTerminalType", indent, width, ); dump_value(ait.assoc_terminal, "bAssocTerminal", indent, width); dump_value(ait.nr_channels, "bNrChannels", indent, width); dump_hex(ait.channel_config, "wChannelConfig", indent, width); let channel_names = audio::UacInterfaceDescriptor::get_channel_name_strings( &audio::UacProtocol::Uac2, ait.channel_config, ); for name in channel_names.iter() { println!("{:indent$}{}", "", name, indent = indent + 2); } dump_value_string( ait.channel_names_index, "iChannelNames", ait.channel_names.as_ref().unwrap_or(&"".into()), indent, width, ); dump_hex(ait.controls, "bmControls", indent, width); dump_bitmap_controls( ait.controls, &UAC2_INPUT_TERMINAL_BMCONTROLS, &audio::ControlType::BmControl2, indent + 2, ); dump_value(ait.terminal_index, "iTerminal", indent, width); dump_value_string( ait.terminal_index, "iTerminal", ait.terminal.as_ref().unwrap_or(&"".into()), indent, width, ); } fn dump_audio_input_terminal3(ait: &audio::InputTerminal3, indent: usize, width: usize) { dump_value(ait.terminal_id, "bTerminalID", indent, width); dump_name( ait.terminal_type, names::videoterminal, "wTerminalType", indent, width, ); dump_value(ait.assoc_terminal, "bAssocTerminal", indent, width); dump_value(ait.csource_id, "bCSourceID", indent, width); dump_hex(ait.controls, "bmControls", indent, width); dump_bitmap_controls( ait.controls, &UAC3_INPUT_TERMINAL_BMCONTROLS, &audio::ControlType::BmControl2, indent + 2, ); dump_value(ait.cluster_descr_id, "wClusterDescrID", indent, width); dump_value( ait.ex_terminal_descr_id, "wExTerminalDescrID", indent, width, ); dump_value(ait.connectors_descr_id, "wConnectorDescrId", indent, width); dump_value(ait.terminal_descr_str, "wTerminalDescrStr", indent, width); } pub(crate) fn dump_audio_output_terminal1(a: &audio::OutputTerminal1, indent: usize, width: usize) { dump_value(a.terminal_id, "bTerminalID", indent, width); dump_name( a.terminal_type, names::videoterminal, "wTerminalType", indent, width, ); dump_value(a.assoc_terminal, "bAssocTerminal", indent, width); dump_value(a.source_id, "bSourceID", indent, width); dump_value_string( a.terminal_index, "iTerminal", a.terminal.as_ref().unwrap_or(&"".into()), indent, width, ); } fn dump_audio_output_terminal2(a: &audio::OutputTerminal2, indent: usize, width: usize) { dump_value(a.terminal_id, "bTerminalID", indent, width); dump_name( a.terminal_type, names::videoterminal, "wTerminalType", indent, width, ); dump_value(a.assoc_terminal, "bAssocTerminal", indent, width); dump_value(a.source_id, "bSourceID", indent, width); dump_hex(a.controls, "bmControls", indent, width); dump_bitmap_controls( a.controls, &UAC2_OUTPUT_TERMINAL_BMCONTROLS, &audio::ControlType::BmControl2, indent + 2, ); dump_value_string( a.terminal_index, "iTerminal", a.terminal.as_ref().unwrap_or(&"".into()), indent, width, ); } fn dump_audio_output_terminal3(a: &audio::OutputTerminal3, indent: usize, width: usize) { dump_value(a.terminal_id, "bTerminalID", indent, width); dump_name( a.terminal_type, names::videoterminal, "wTerminalType", indent, width, ); dump_value(a.assoc_terminal, "bAssocTerminal", indent, width); dump_value(a.c_source_id, "bCSourceID", indent, width); dump_hex(a.controls, "bmControls", indent, width); dump_bitmap_controls( a.controls, &UAC3_OUTPUT_TERMINAL_BMCONTROLS, &audio::ControlType::BmControl2, indent + 2, ); dump_value(a.ex_terminal_descr_id, "wExTerminalDescrID", indent, width); dump_value(a.connectors_descr_id, "wConnectorDescrId", indent, width); dump_value(a.terminal_descr_str, "wTerminalDescrStr", indent, width); } fn dump_extended_terminal_header(d: &audio::ExtendedTerminalHeader, indent: usize, width: usize) { dump_value(d.descriptor_id, "wDescriptorID", indent, width); dump_value(d.nr_channels, "bNrChannels", indent, width); } fn dump_audio_streaming_interface1(asi: &audio::StreamingInterface1, indent: usize, width: usize) { dump_value(asi.terminal_link, "bTerminalLink", indent, width); dump_value(asi.delay, "bDelay", indent, width); dump_value(asi.format_tag, "wFormatTag", indent, width); } fn dump_audio_streaming_interface2(asi: &audio::StreamingInterface2, indent: usize, width: usize) { dump_value(asi.terminal_link, "bTerminalLink", indent, width); dump_hex(asi.controls, "bmControls", indent, width); dump_bitmap_controls( asi.controls, &UAC2_AS_INTERFACE_BMCONTROLS, &audio::ControlType::BmControl2, indent + 2, ); dump_value(asi.format_type, "bFormatType", indent, width); dump_value(asi.nr_channels, "bNrChannels", indent, width); dump_hex(asi.channel_config, "bmChannelConfig", indent, width); let channel_names = audio::UacInterfaceDescriptor::get_channel_name_strings( &audio::UacProtocol::Uac2, asi.channel_config, ); for name in channel_names.iter() { println!("{:indent$}{}", "", name, indent = indent + 2); } dump_value_string( asi.channel_names_index, "iChannelNames", asi.channel_names.as_ref().unwrap_or(&"".into()), indent, width, ); } fn dump_audio_streaming_interface3(asi: &audio::StreamingInterface3, indent: usize, width: usize) { dump_value(asi.terminal_link, "bTerminalLink", indent, width); dump_hex(asi.controls, "bmControls", indent, width); dump_bitmap_controls( asi.controls, &UAC3_AS_INTERFACE_BMCONTROLS, &audio::ControlType::BmControl2, indent + 2, ); dump_value(asi.cluster_descr_id, "wClusterDescrID", indent, width); dump_hex(asi.formats, "bmFormats", indent, width); dump_value(asi.sub_slot_size, "bSubslotSize", indent, width); dump_value(asi.bit_resolution, "bBitResolution", indent, width); dump_hex(asi.aux_protocols, "bmAuxProtocols", indent, width); dump_value(asi.control_size, "bControlSize", indent, width); } fn dump_audio_data_streaming_endpoint1( ads: &audio::DataStreamingEndpoint1, indent: usize, width: usize, ) { let uac1_attrs = |a: usize| match a { 0 => Some("Sampling Frequency"), 1 => Some("Pitch"), 2 => Some("Audio Data Format Control"), 7 => Some("MaxPacketsOnly"), _ => None, }; dump_hex(ads.attributes, "bmAttributes", indent, width); dump_bitmap_strings(ads.attributes, uac1_attrs, indent + 2); dump_value(ads.lock_delay_units, "bLockDelayUnits", indent, width); dump_value(ads.lock_delay, "wLockDelay", indent, width); } fn dump_audio_data_streaming_endpoint2( ads: &audio::DataStreamingEndpoint2, indent: usize, width: usize, ) { let uac2_attrs = |attr: usize| match attr { 0x07 => Some("MaxPacketsOnly"), _ => None, }; dump_hex(ads.attributes, "bmAttributes", indent, width); dump_bitmap_strings(ads.attributes, uac2_attrs, indent + 2); dump_hex(ads.controls, "bmControls", indent, width); dump_bitmap_controls( ads.controls, &UAC2_AS_ISO_ENDPOINT_BMCONTROLS, &audio::ControlType::BmControl2, indent + 2, ); dump_value(ads.lock_delay_units, "bLockDelayUnits", indent, width); dump_value(ads.lock_delay, "wLockDelay", indent, width); } fn dump_audio_data_streaming_endpoint3( ads: &audio::DataStreamingEndpoint3, indent: usize, width: usize, ) { dump_hex(ads.controls, "bmControls", indent, width); dump_bitmap_controls( ads.controls, &UAC2_AS_ISO_ENDPOINT_BMCONTROLS, &audio::ControlType::BmControl2, indent + 2, ); dump_value(ads.lock_delay_units, "bLockDelayUnits", indent, width); dump_value(ads.lock_delay, "wLockDelay", indent, width); } fn dump_audio_streaming_format(af: &audio::StreamingFormat, indent: usize, width: usize) { dump_value_string( u8::from(af.format_type.to_owned()), "bFormatType", format!("({:#})", af.format_type), indent, width, ); match &af.interface { audio::StreamingFormatInterface::FormatTypeI1(asi) => { dump_format_type_i(asi, indent, width); } audio::StreamingFormatInterface::FormatTypeII1(asi) => { dump_format_type_ii(asi, indent, width); } audio::StreamingFormatInterface::FormatTypeIII1(asi) => { dump_format_type_iii(asi, indent, width); } audio::StreamingFormatInterface::FormatTypeI2(asi) => { dump_format_type_i_uac2(asi, indent, width); } audio::StreamingFormatInterface::FormatTypeII2(asi) => { dump_format_type_ii_uac2(asi, indent, width); } audio::StreamingFormatInterface::FormatTypeIII2(asi) => { dump_format_type_iii_uac2(asi, indent, width); } i => { let data: Vec = i.to_owned().into(); println!( "{:indent$}invalid desc format type: {}", "", data.iter() .map(|b| format!("{b:02x}")) .collect::>() .join(""), indent = indent ) } } } fn dump_audio_streaming_format_specific( af: &audio::StreamingFormatSpecific, indent: usize, width: usize, ) { let fmtptr = get_format_specific_string(af.format_tag); dump_value_string(af.format_tag, "wFormatTag", fmtptr, indent, width); match &af.interface { audio::StreamingFormatInterface::FormatSpecificAc3(fs) => { dump_format_specific_ac3(fs, indent, width); } audio::StreamingFormatInterface::FormatSpecificMpeg(fs) => { dump_format_specific_mpeg(fs, indent, width); } i => { let data: Vec = i.to_owned().into(); println!( "{:indent$}Invalid desc format type: {}", "", data.iter() .map(|b| format!("{b:02x}")) .collect::>() .join(""), indent = indent ) } } } fn dump_audio_subtype(uacid: &audio::UacInterfaceDescriptor, indent: usize) { match uacid { audio::UacInterfaceDescriptor::Header1(a) => { dump_audio_header1(a, indent, LSUSB_DUMP_WIDTH); } audio::UacInterfaceDescriptor::Header2(ach) => { dump_audio_header2(ach, indent, LSUSB_DUMP_WIDTH); } audio::UacInterfaceDescriptor::Header3(ach) => { dump_audio_header3(ach, indent, LSUSB_DUMP_WIDTH); } audio::UacInterfaceDescriptor::InputTerminal1(ait) => { dump_audio_input_terminal1(ait, indent, LSUSB_DUMP_WIDTH); } audio::UacInterfaceDescriptor::InputTerminal2(ait) => { dump_audio_input_terminal2(ait, indent, LSUSB_DUMP_WIDTH); } audio::UacInterfaceDescriptor::InputTerminal3(ait) => { dump_audio_input_terminal3(ait, indent, LSUSB_DUMP_WIDTH); } audio::UacInterfaceDescriptor::OutputTerminal1(a) => { dump_audio_output_terminal1(a, indent, LSUSB_DUMP_WIDTH); } audio::UacInterfaceDescriptor::OutputTerminal2(a) => { dump_audio_output_terminal2(a, indent, LSUSB_DUMP_WIDTH); } audio::UacInterfaceDescriptor::OutputTerminal3(a) => { dump_audio_output_terminal3(a, indent, LSUSB_DUMP_WIDTH); } audio::UacInterfaceDescriptor::ExtendedTerminalHeader(d) => { dump_extended_terminal_header(d, indent, LSUSB_DUMP_WIDTH); } audio::UacInterfaceDescriptor::PowerDomain(power_domain) => { dump_audio_power_domain(power_domain, indent, LSUSB_DUMP_WIDTH); } audio::UacInterfaceDescriptor::MixerUnit1(mixer_unit) => { dump_audio_mixer_unit1(mixer_unit, indent, LSUSB_DUMP_WIDTH); } audio::UacInterfaceDescriptor::MixerUnit2(mixer_unit) => { dump_audio_mixer_unit2(mixer_unit, indent, LSUSB_DUMP_WIDTH); } audio::UacInterfaceDescriptor::MixerUnit3(mixer_unit) => { dump_audio_mixer_unit3(mixer_unit, indent, LSUSB_DUMP_WIDTH); } audio::UacInterfaceDescriptor::SelectorUnit1(selector_unit) => { dump_audio_selector_unit1(selector_unit, indent, LSUSB_DUMP_WIDTH); } audio::UacInterfaceDescriptor::SelectorUnit2(selector_unit) => { dump_audio_selector_unit2(selector_unit, indent, LSUSB_DUMP_WIDTH); } audio::UacInterfaceDescriptor::SelectorUnit3(selector_unit) => { dump_audio_selector_unit3(selector_unit, indent, LSUSB_DUMP_WIDTH); } audio::UacInterfaceDescriptor::ProcessingUnit1(unit) => { dump_audio_processing_unit1(unit, indent, LSUSB_DUMP_WIDTH); } audio::UacInterfaceDescriptor::ProcessingUnit2(unit) => { dump_audio_processing_unit2(unit, indent, LSUSB_DUMP_WIDTH); } audio::UacInterfaceDescriptor::ProcessingUnit3(unit) => { dump_audio_processing_unit3(unit, indent, LSUSB_DUMP_WIDTH); } audio::UacInterfaceDescriptor::EffectUnit2(unit) => { dump_audio_effect_unit2(unit, indent, LSUSB_DUMP_WIDTH); } audio::UacInterfaceDescriptor::EffectUnit3(unit) => { dump_audio_effect_unit3(unit, indent, LSUSB_DUMP_WIDTH); } audio::UacInterfaceDescriptor::FeatureUnit1(unit) => { dump_audio_feature_unit1(unit, indent, LSUSB_DUMP_WIDTH); } audio::UacInterfaceDescriptor::FeatureUnit2(unit) => { dump_audio_feature_unit2(unit, indent, LSUSB_DUMP_WIDTH); } audio::UacInterfaceDescriptor::FeatureUnit3(unit) => { dump_audio_feature_unit3(unit, indent, LSUSB_DUMP_WIDTH); } audio::UacInterfaceDescriptor::ExtensionUnit1(unit) => { dump_audio_extension_unit1(unit, indent, LSUSB_DUMP_WIDTH); } audio::UacInterfaceDescriptor::ExtensionUnit2(unit) => { dump_audio_extension_unit2(unit, indent, LSUSB_DUMP_WIDTH); } audio::UacInterfaceDescriptor::ExtensionUnit3(unit) => { dump_audio_extension_unit3(unit, indent, LSUSB_DUMP_WIDTH); } audio::UacInterfaceDescriptor::ClockSource2(source) => { dump_audio_clock_source2(source, indent, LSUSB_DUMP_WIDTH); } audio::UacInterfaceDescriptor::ClockSource3(source) => { dump_audio_clock_source3(source, indent, LSUSB_DUMP_WIDTH); } audio::UacInterfaceDescriptor::ClockSelector2(selector) => { dump_audio_clock_selector2(selector, indent, LSUSB_DUMP_WIDTH); } audio::UacInterfaceDescriptor::ClockSelector3(selector) => { dump_audio_clock_selector3(selector, indent, LSUSB_DUMP_WIDTH); } audio::UacInterfaceDescriptor::ClockMultiplier2(multiplier) => { dump_audio_clock_multiplier2(multiplier, indent, LSUSB_DUMP_WIDTH); } audio::UacInterfaceDescriptor::ClockMultiplier3(multiplier) => { dump_audio_clock_multiplier3(multiplier, indent, LSUSB_DUMP_WIDTH); } audio::UacInterfaceDescriptor::SampleRateConverter2(converter) => { dump_audio_sample_rate_converter2(converter, indent, LSUSB_DUMP_WIDTH); } audio::UacInterfaceDescriptor::SampleRateConverter3(converter) => { dump_audio_sample_rate_converter3(converter, indent, LSUSB_DUMP_WIDTH); } audio::UacInterfaceDescriptor::StreamingInterface1(asi) => { dump_audio_streaming_interface1(asi, indent, LSUSB_DUMP_WIDTH); } audio::UacInterfaceDescriptor::StreamingInterface2(asi) => { dump_audio_streaming_interface2(asi, indent, LSUSB_DUMP_WIDTH); } audio::UacInterfaceDescriptor::StreamingInterface3(asi) => { dump_audio_streaming_interface3(asi, indent, LSUSB_DUMP_WIDTH); } audio::UacInterfaceDescriptor::StreamingFormat(fmt) => { dump_audio_streaming_format(fmt, indent, LSUSB_DUMP_WIDTH); } audio::UacInterfaceDescriptor::StreamingFormatSpecific(fmt) => { dump_audio_streaming_format_specific(fmt, indent, LSUSB_DUMP_WIDTH); } audio::UacInterfaceDescriptor::DataStreamingEndpoint1(ads) => { dump_audio_data_streaming_endpoint1(ads, indent, LSUSB_DUMP_WIDTH); } audio::UacInterfaceDescriptor::DatastreamingEndpoint2(ads) => { dump_audio_data_streaming_endpoint2(ads, indent, LSUSB_DUMP_WIDTH); } audio::UacInterfaceDescriptor::DataStreamingEndpoint3(ads) => { dump_audio_data_streaming_endpoint3(ads, indent, LSUSB_DUMP_WIDTH); } audio::UacInterfaceDescriptor::Undefined(data) | audio::UacInterfaceDescriptor::Invalid(data) => { println!( "{:indent$}Invalid desc subtype: {}", "", data.iter() .map(|b| format!("{b:02x}")) .collect::>() .join(" "), ); } _ => { log::warn!("Unsupported UAC interface descriptor: {uacid:?}"); } } } pub(crate) fn dump_audiocontrol_interface( uacd: &audio::UacDescriptor, uaci: &audio::ControlSubtype, protocol: &audio::UacProtocol, indent: usize, ) { dump_string("AudioControl Interface Descriptor", indent); dump_value(uacd.length, "bLength", indent + 2, LSUSB_DUMP_WIDTH); dump_value( uacd.descriptor_type, "bDescriptorType", indent + 2, LSUSB_DUMP_WIDTH, ); dump_value_string( uaci.to_owned() as u8, "bDescriptorSubtype", format!("({uaci:#})"), indent + 2, LSUSB_DUMP_WIDTH, ); match &uacd.interface { audio::UacInterfaceDescriptor::Invalid(_) => { println!( "{:indent$}Warning: {:#} descriptors are illegal for {}", "", uacd.descriptor_subtype, u8::from(protocol.to_owned()), indent = indent ); } uacid => dump_audio_subtype(uacid, indent + 2), } } fn get_format_specific_string(fmttag: u16) -> &'static str { const FMT_ITAG: [&str; 6] = [ "TYPE_I_UNDEFINED", "PCM", "PCM8", "IEEE_FLOAT", "ALAW", "MULAW", ]; const FMT_IITAG: [&str; 3] = ["TYPE_II_UNDEFINED", "MPEG", "AC-3"]; const FMT_IIITAG: [&str; 7] = [ "TYPE_III_UNDEFINED", "IEC1937_AC-3", "IEC1937_MPEG-1_Layer1", "IEC1937_MPEG-Layer2/3/NOEXT", "IEC1937_MPEG-2_EXT", "IEC1937_MPEG-2_Layer1_LS", "IEC1937_MPEG-2_Layer2/3_LS", ]; match fmttag { 0..=5 => FMT_ITAG[fmttag as usize], 0x1000..=0x1002 => FMT_IITAG[(fmttag & 0xfff) as usize], 0x2000..=0x2006 => FMT_IIITAG[(fmttag & 0xfff) as usize], _ => "undefined", } } fn dump_format_type_i(ft: &audio::FormatTypeI1, indent: usize, width: usize) { dump_value(ft.num_channels, "bNrChannels", indent, width); dump_value(ft.subframe_size, "bSubframeSize", indent, width); dump_value(ft.bit_resolution, "bBitResolution", indent, width); dump_value_string( u8::from(ft.sample_frequency_type.to_owned()), "bSamFreqType", ft.sample_frequency_type.to_string(), indent, width, ); match ft.sample_frequency_type { audio::SampleFrequencyType::Continuous => { dump_value( ft.sample_frequencies.first().unwrap_or(&0), "tLowerSamFreq", indent, width, ); dump_value( ft.sample_frequencies.get(1).unwrap_or(&0), "tUpperSamFreq", indent, width, ); } audio::SampleFrequencyType::Discrete(n) => { for i in 0..n { dump_value( ft.sample_frequencies[i as usize], &format!("tSamFreq[{i}]"), indent, width, ); } } } } fn dump_format_type_ii(ft: &audio::FormatTypeII1, indent: usize, width: usize) { dump_value(ft.max_bit_rate, "wMaxBitRate", indent, width); dump_value(ft.samples_per_frame, "wSamplesPerFrame", indent, width); dump_value_string( u8::from(ft.sample_frequency_type.to_owned()), "bSamFreqType", ft.sample_frequency_type.to_string(), indent, width, ); match ft.sample_frequency_type { audio::SampleFrequencyType::Continuous => { dump_value( ft.sample_frequencies.first().unwrap_or(&0), "tLowerSamFreq", indent, width, ); dump_value( ft.sample_frequencies.get(1).unwrap_or(&0), "tUpperSamFreq", indent, width, ); } audio::SampleFrequencyType::Discrete(n) => { for i in 0..n { dump_value( ft.sample_frequencies[i as usize], &format!("tSamFreq[{i}]"), indent, width, ); } } } } fn dump_format_type_iii(ft: &audio::FormatTypeIII1, indent: usize, width: usize) { dump_value(ft.num_channels, "bNrChannels", indent, width); dump_value(ft.subframe_size, "bSubframeSize", indent, width); dump_value(ft.bit_resolution, "bBitResolution", indent, width); dump_value_string( u8::from(ft.sample_frequency_type.to_owned()), "bSamFreqType", ft.sample_frequency_type.to_string(), indent, width, ); match ft.sample_frequency_type { audio::SampleFrequencyType::Continuous => { dump_value( ft.sample_frequencies.first().unwrap_or(&0), "tLowerSamFreq", indent, width, ); dump_value( ft.sample_frequencies.get(1).unwrap_or(&0), "tUpperSamFreq", indent, width, ); } audio::SampleFrequencyType::Discrete(n) => { for i in 0..n { dump_value( ft.sample_frequencies[i as usize], &format!("tSamFreq[{i}]"), indent, width, ); } } } } fn dump_format_type_i_uac2(ft: &audio::FormatTypeI2, indent: usize, width: usize) { dump_value(ft.sub_slot_size, "bSubslotSize", indent, width); dump_value(ft.bit_resolution, "bBitResolution", indent, width); } fn dump_format_type_ii_uac2(ft: &audio::FormatTypeII2, indent: usize, width: usize) { dump_value(ft.max_bit_rate, "wMaxBitRate", indent, width); dump_value(ft.slots_per_frame, "wSlotsPerFrame", indent, width); } fn dump_format_type_iii_uac2(ft: &audio::FormatTypeIII2, indent: usize, width: usize) { dump_value(ft.sub_slot_size, "bSubslotSize", indent, width); dump_value(ft.bit_resolution, "bBitResolution", indent, width); } fn dump_format_specific_mpeg(fs: &audio::FormatSpecificMpeg, indent: usize, width: usize) { dump_hex(fs.mpeg_capabilities, "bmMPEGCapabilities", indent, width); dump_bitmap_strings( fs.mpeg_capabilities as u8, |b| match b { 0 => Some("Layer I"), 1 => Some("Layer II"), 2 => Some("Layer III"), 3 => Some("MPEG-1 only"), 4 => Some("MPEG-1 dual-channel"), 5 => Some("MPEG-2 second stereo"), 6 => Some("MPEG-2 7.1 channel augmentation"), 7 => Some("Adaptive multi-channel prediction"), _ => None, }, indent + 2, ); println!( "{:indent$}MPEG-2 multilingual support: {}", "", match (fs.mpeg_capabilities >> 8) & 3 { 0 => "Not supported", 1 => "Supported at Fs", 2 => "Reserved", _ => "Supported at Fs and 1/2Fs", }, indent = indent + 2 ); dump_hex(fs.mpeg_features, "bmMPEGFeatures", indent, width); println!( "{:indent$}Internal Dynamic Range Control: {}", "", match (fs.mpeg_features >> 4) & 3 { 0 => "not supported", 1 => "supported but not scalable", 2 => "scalable, common boost and cut scaling value", _ => "scalable, separate boost and cut scaling value", }, indent = indent + 2 ); } fn dump_format_specific_ac3(fs: &audio::FormatSpecificAc3, indent: usize, width: usize) { dump_hex(fs.bsid, "bmBSID", indent, width); dump_hex(fs.ac3_features, "bmAC3Features", indent, width); dump_bitmap_strings( fs.ac3_features, |b| match b { 0 => Some("RF mode"), 1 => Some("Line mode"), 2 => Some("Custom0 mode"), 3 => Some("Custom1 mode"), _ => None, }, indent + 2, ); println!( "{:indent$}Internal Dynamic Range Control: {}", "", match (fs.ac3_features >> 4) & 3 { 0 => "not supported", 1 => "supported but not scalable", 2 => "scalable, common boost and cut scaling value", _ => "scalable, separate boost and cut scaling value", }, indent = indent + 2 ); } pub(crate) fn dump_audiostreaming_interface( uacd: &audio::UacDescriptor, uasi: &audio::StreamingSubtype, protocol: &audio::UacProtocol, indent: usize, ) { dump_string("AudioStreaming Interface Descriptor:", indent); dump_value(uacd.length, "bLength", indent + 2, LSUSB_DUMP_WIDTH); dump_value( uacd.descriptor_type, "bDescriptorType", indent + 2, LSUSB_DUMP_WIDTH, ); dump_value_string( uasi.to_owned() as u8, "bDescriptorSubtype", format!("({uasi:#})"), indent + 2, LSUSB_DUMP_WIDTH, ); match &uacd.interface { audio::UacInterfaceDescriptor::Invalid(_) => { println!( "{:indent$}Warning: {:#} descriptors are illegal for {}", "", uacd.descriptor_subtype, u8::from(protocol.to_owned()), indent = indent + 2 ); } uacid => dump_audio_subtype(uacid, indent + 2), } } pub(crate) fn dump_audiostreaming_endpoint(ad: &audio::UacDescriptor, indent: usize) { // audio streaming endpoint is only EP_GENERAL let subtype_string = match ad.descriptor_subtype { audio::UacType::Streaming(audio::StreamingSubtype::General) => "EP_GENERAL", // lowercase in lsusb _ => "invalid", }; dump_string("AudioStreaming Endpoint Descriptor:", indent); dump_value(ad.length, "bLength", indent + 2, LSUSB_DUMP_WIDTH); dump_value( ad.descriptor_type, "bDescriptorType", indent + 2, LSUSB_DUMP_WIDTH, ); dump_value_string( u8::from(ad.descriptor_subtype.to_owned()), "bDescriptorSubtype", format!("({subtype_string:#})"), indent + 2, LSUSB_DUMP_WIDTH, ); if matches!( ad.descriptor_subtype, audio::UacType::Streaming(audio::StreamingSubtype::General) ) { dump_audio_subtype(&ad.interface, indent + 2); } } pub(crate) fn dump_midistreaming_interface(md: &audio::MidiDescriptor, indent: usize) { let jack_types = |t: u8| match t { 0x00 => "Undefined", 0x01 => "Embedded", 0x02 => "External", _ => "Invalid", }; dump_string("MIDIStreaming Interface Descriptor:", indent); dump_value(md.length, "bLength", indent + 2, LSUSB_DUMP_WIDTH); dump_value( md.descriptor_type, "bDescriptorType", indent + 2, LSUSB_DUMP_WIDTH, ); dump_value_string( md.descriptor_subtype.to_owned() as u8, "bDescriptorSubtype", format!("({:#})", md.descriptor_subtype), indent + 2, LSUSB_DUMP_WIDTH, ); match &md.interface { audio::MidiInterfaceDescriptor::Header(d) => { dump_value(d.version, "bcdADC", indent + 2, LSUSB_DUMP_WIDTH); dump_hex(d.total_length, "wTotalLength", indent + 2, LSUSB_DUMP_WIDTH); } audio::MidiInterfaceDescriptor::InputJack(d) => { dump_value_string( d.jack_type, "bJackType", jack_types(d.jack_type), indent + 2, LSUSB_DUMP_WIDTH, ); dump_value(d.jack_id, "bJackID", indent + 2, LSUSB_DUMP_WIDTH); dump_value_string( d.jack_string_index, "iJack", d.jack_string.as_ref().unwrap_or(&"".into()), indent + 2, LSUSB_DUMP_WIDTH, ); } audio::MidiInterfaceDescriptor::OutputJack(d) => { dump_value_string( d.jack_type, "bJackType", jack_types(d.jack_type), indent + 2, LSUSB_DUMP_WIDTH, ); dump_value(d.jack_id, "bJackID", indent + 2, LSUSB_DUMP_WIDTH); dump_value( d.num_input_pins, "bNrInputPins", indent + 2, LSUSB_DUMP_WIDTH, ); for (i, p) in d.source_ids.iter() { dump_value( i, &format!("baSourceID({i:2})"), indent + 2, LSUSB_DUMP_WIDTH, ); dump_value( p, &format!("baSourcePin({i:2})"), indent + 2, LSUSB_DUMP_WIDTH, ); } dump_value_string( d.jack_string_index, "iJack", d.jack_string.as_ref().unwrap_or(&"".into()), indent + 2, LSUSB_DUMP_WIDTH, ); } audio::MidiInterfaceDescriptor::Element(d) => { dump_value(d.element_id, "bElementID", indent + 2, LSUSB_DUMP_WIDTH); dump_value( d.num_input_pins, "bNrInputPins", indent + 2, LSUSB_DUMP_WIDTH, ); for (i, p) in d.source_ids.iter() { dump_value( i, &format!("baSourceID({i:2})"), indent + 2, LSUSB_DUMP_WIDTH, ); dump_value( p, &format!("baSourcePin({i:2})"), indent + 2, LSUSB_DUMP_WIDTH, ); } dump_value( d.num_output_pins, "bNrOutputPins", indent + 2, LSUSB_DUMP_WIDTH, ); dump_value( d.in_terminal_link, "bInTerminalLink", indent + 2, LSUSB_DUMP_WIDTH, ); dump_value( d.out_terminal_link, "bOutTerminalLink", indent + 2, LSUSB_DUMP_WIDTH, ); dump_value(d.el_caps_size, "bElCapsSize", indent + 2, LSUSB_DUMP_WIDTH); dump_hex( d.element_caps, "bmElementCaps", indent + 2, LSUSB_DUMP_WIDTH, ); dump_bitmap_strings( d.element_caps, |b| match b { 0 => Some("Undefined"), 1 => Some("MIDI Clock"), 2 => Some("MTC (MIDI Time Code)"), 3 => Some("MMC (MIDI Machine Control)"), 4 => Some("GM1 (General MIDI v.1)"), 5 => Some("GM2 (General MIDI v.2)"), 6 => Some("GS MIDI Extension"), 7 => Some("XG MIDI Extension"), 8 => Some("EFX"), 9 => Some("MIDI Patch Bay"), 10 => Some("DLS1 (Downloadable Sounds Level 1)"), 11 => Some("DLS2 (Downloadable Sounds Level 2)"), _ => None, }, indent + 2, ); dump_value_string( d.element_string_index, "iElement", d.element_string.as_ref().unwrap_or(&String::new()), indent + 2, LSUSB_DUMP_WIDTH, ); } audio::MidiInterfaceDescriptor::Undefined(_) => (), invalid => { let data: Vec = invalid.to_owned().into(); println!( "{:indent$}Invalid desc subtype: {}", "", data.iter() .map(|b| format!("{b:02x}")) .collect::>() .join(" "), indent = indent + 2, ); } } } pub(crate) fn dump_midistreaming_endpoint(md: &audio::MidiDescriptor, indent: usize) { let subtype_string = match u8::from(md.descriptor_subtype.to_owned()) { 1 | 2 => "GENERAL", _ => "Invalid", }; dump_string("MIDIStreaming Endpoint Descriptor:", indent); dump_value(md.length, "bLength", indent + 2, LSUSB_DUMP_WIDTH); dump_value( md.descriptor_type, "bDescriptorType", indent + 2, LSUSB_DUMP_WIDTH, ); dump_value_string( u8::from(md.descriptor_subtype.to_owned()), "bDescriptorSubtype", subtype_string, indent + 2, LSUSB_DUMP_WIDTH, ); if let audio::MidiInterfaceDescriptor::Endpoint(ep) = &md.interface { dump_value( ep.num_jacks, "bNumEmbMIDIJack", indent + 2, LSUSB_DUMP_WIDTH, ); dump_array(&ep.jacks, "baAssocJackID", indent + 2, LSUSB_DUMP_WIDTH); } } cyme-2.2.6/src/lsusb/bos_dumps.rs000066400000000000000000000363421506545537300167630ustar00rootroot00000000000000use crate::usb::descriptors::bos; use super::*; fn dump_extension_capability(d: &bos::ExtensionCapability, lpm_requred: bool, indent: usize) { const BSEL_US: [u16; 16] = [ 125, 150, 200, 300, 400, 500, 1000, 2000, 3000, 4000, 5000, 6000, 7000, 8000, 9000, 10000, ]; dump_string("USB 2.0 Extension Device Capability:", indent); dump_value(d.length, "bLength", indent + 2, LSUSB_DUMP_WIDTH); dump_value( d.descriptor_type, "bDescriptorType", indent + 2, LSUSB_DUMP_WIDTH, ); dump_value( u8::from(d.capability_type.to_owned()), "bDevCapabilityType", indent + 2, LSUSB_DUMP_WIDTH, ); dump_hex(d.attributes, "bmAttributes", indent + 2, LSUSB_DUMP_WIDTH); if (lpm_requred || (d.attributes & 0x04 == 0x04)) && d.attributes & 0x02 == 0 { dump_string("(Missing must-be-set LPM bit!)", indent + 4); } else if !lpm_requred && d.attributes & 0x02 == 0 { dump_string("Link Power Management (LPM) not supported", indent + 4); } else if d.attributes & 0x04 == 0 { dump_string("HIRD Link Power Management (LPM) Supported", indent + 4); } else { dump_string("BESL Link Power Management (LPM) Supported", indent + 4); if d.attributes & 0x08 != 0 { let val = ((d.attributes & 0xf00) >> 8) as usize; dump_value_string( BSEL_US[val], "BESL value", "us", indent + 4, LSUSB_DUMP_WIDTH, ); } if d.attributes & 0x10 != 0 { let val = ((d.attributes & 0xf000) >> 12) as usize; dump_value_string( BSEL_US[val], "Deep BESL value", "us", indent + 4, LSUSB_DUMP_WIDTH, ); } } } fn dump_ss_capability(d: &bos::SuperSpeedCapability, indent: usize) { dump_string("SuperSpeed USB Device Capability:", indent); dump_value(d.length, "bLength", indent + 2, LSUSB_DUMP_WIDTH); dump_value( d.descriptor_type, "bDescriptorType", indent + 2, LSUSB_DUMP_WIDTH, ); dump_value( u8::from(d.capability_type.to_owned()), "bDevCapabilityType", indent + 2, LSUSB_DUMP_WIDTH, ); dump_hex(d.attributes, "bmAttributes", indent + 2, LSUSB_DUMP_WIDTH); dump_hex( d.speed_supported, "wSpeedsSupported", indent + 2, LSUSB_DUMP_WIDTH, ); dump_bitmap_strings( d.speed_supported, |b| match b { 0 => Some("Device can operate at Low Speed (1Mbps)"), 1 => Some("Device can operate at Full Speed (12Mbps)"), 2 => Some("Device can operate at High Speed (480Mbps)"), 3 => Some("Device can operate at SuperSpeed (5Gbps)"), _ => None, }, indent + 4, ); dump_value( d.functionality_supported, "bFunctionalitySupport", indent + 2, LSUSB_DUMP_WIDTH, ); match d.functionality_supported { 0 => dump_string( "Lowest fully-functional device speed is Low Speed (1Mbps)", indent + 4, ), 1 => dump_string( "Lowest fully-functional device speed is Full Speed (12Mbps)", indent + 4, ), 2 => dump_string( "Lowest fully-functional device speed is High Speed (480Mbps)", indent + 4, ), 3 => dump_string( "Lowest fully-functional device speed is SuperSpeed (5Gbps)", indent + 4, ), _ => dump_string( "Lowest fully-functional device speed is at an unknown speed!", indent + 4, ), } dump_value_string( d.u1_device_exit_latency, "bU1DevExitLat", "micro seconds", indent + 2, LSUSB_DUMP_WIDTH, ); dump_value_string( d.u2_device_exit_latency, "bU2DevExitLat", "micro seconds", indent + 2, LSUSB_DUMP_WIDTH, ); } fn dump_ss_plus_capability(d: &bos::SuperSpeedPlusCapability, indent: usize) { dump_string("SuperSpeedPlus USB Device Capability:", indent); dump_value(d.length, "bLength", indent + 2, LSUSB_DUMP_WIDTH); dump_value( d.descriptor_type, "bDescriptorType", indent + 2, LSUSB_DUMP_WIDTH, ); dump_value( u8::from(d.capability_type.to_owned()), "bDevCapabilityType", indent + 2, LSUSB_DUMP_WIDTH, ); dump_hex(d.attributes, "bmAttributes", indent + 2, LSUSB_DUMP_WIDTH); dump_string( &format!( "Sublink Speed Attribute count {}", d.sublink_speed_attribute_count() ), indent + 4, ); dump_string( &format!("Sublink Speed ID count {}", d.sublink_speed_id_count()), indent + 4, ); dump_hex( d.functionality_supported, "wFunctionalitySupport", indent + 2, LSUSB_DUMP_WIDTH, ); dump_string( &format!( "Min functional Speed Attribute ID: {}", d.functional_speed_attribute_id() ), indent + 4, ); dump_string( &format!("Min functional RX lanes: {}", d.functional_rx_lanes()), indent + 4, ); dump_string( &format!("Min functional TX lanes: {}", d.functional_tx_lanes()), indent + 4, ); let bitrate_prefix = [' ', 'K', 'M', 'G']; for (i, &ss_attr) in d.sublink_attributes.iter().enumerate() { dump_hex( ss_attr, &format!("bmSublinkSpeedAttr[{i}]"), indent, LSUSB_DUMP_WIDTH, ); dump_string( &format!( "Speed Attribute ID: {} {}{}b/s {} {} SuperSpeed{}", ss_attr & 0x0f, ss_attr >> 16, bitrate_prefix[((ss_attr >> 4) & 0x3) as usize], if (ss_attr & 0x40) != 0 { "Asymmetric" } else { "Symmetric" }, if (ss_attr & 0x80) != 0 { "TX" } else { "RX" }, if (ss_attr & 0x4000) != 0 { "Plus" } else { "" }, ), indent + 4, ); } } const VCONN_POWER_STRINGS: [&str; 8] = ["1W", "1.5W", "2W", "3W", "4W", "5W", "6W", "reserved"]; const ALT_MODE_STATE: [&str; 4] = [ "Unspecified Error", "Alternate Mode configuration not attempted", "Alternate Mode configuration attempted but unsuccessful", "Alternate Mode configuration successful", ]; fn dump_billboard_capability(d: &bos::BillboardCapability, indent: usize) { let vconn = if d.vconn_power & (1 << 15) != 0 { "VCONN power not required" } else if (d.vconn_power & 0x7) < 7 { VCONN_POWER_STRINGS[(d.vconn_power & 0x7) as usize] } else { "reserved" }; dump_string("Billboard Capability:", indent); dump_value(d.length, "bLength", indent + 2, LSUSB_DUMP_WIDTH); dump_value( d.descriptor_type, "bDescriptorType", indent + 2, LSUSB_DUMP_WIDTH, ); dump_value( u8::from(d.capability_type.to_owned()), "bDevCapabilityType", indent + 2, LSUSB_DUMP_WIDTH, ); dump_value_string( d.additional_info_url_index, "iAdditionalInfoURL", d.additional_info_url.as_ref().unwrap_or(&String::new()), indent + 2, LSUSB_DUMP_WIDTH, ); dump_value( d.number_of_alternate_modes, "bNumberOfAlternateModes", indent + 2, LSUSB_DUMP_WIDTH, ); dump_value( d.preferred_alternate_mode, "bPreferredAlternateMode", indent + 2, LSUSB_DUMP_WIDTH, ); dump_value_string( d.vconn_power, "VCONN Power", vconn, indent + 2, LSUSB_DUMP_WIDTH, ); let bytes_string = d .configured .iter() .map(|b| format!("{b:02x}")) .collect::>() .join(" "); dump_value(bytes_string, "bmConfigured", indent + 2, LSUSB_DUMP_WIDTH); dump_value(d.version, "bcdVersion", indent + 2, LSUSB_DUMP_WIDTH); dump_value( d.additional_failure_info, "bAdditionalFailureInfo", indent + 2, LSUSB_DUMP_WIDTH, ); dump_value(d.reserved, "bReserved", indent + 2, LSUSB_DUMP_WIDTH); dump_string("Alternate Modes supported by Device Container:", indent + 2); for (alt_mode, am) in d.alternate_modes.iter().enumerate() { let state = ((d.configured[alt_mode >> 2] >> ((alt_mode & 0x3) << 1)) & 0x3) as usize; dump_string( &format!("Alternate Mode {} : {}", alt_mode, ALT_MODE_STATE[state]), indent + 2, ); dump_hex( am.svid, &format!("wSVID[{alt_mode}]"), indent + 4, LSUSB_DUMP_WIDTH, ); dump_value( am.alternate_mode, &format!("bAlternateMode[{alt_mode}]"), indent + 4, LSUSB_DUMP_WIDTH, ); dump_value_string( am.alternate_mode_string_index, &format!("iAlternateModeString[{alt_mode}]"), am.alternate_mode_string.as_ref().unwrap_or(&String::new()), indent + 4, LSUSB_DUMP_WIDTH, ); } } fn dump_billboard_alt_mode_capability(d: &bos::BillboardAltModeCapability, indent: usize) { dump_string("Billboard Alternate Mode Capability:", indent); dump_value(d.length, "bLength", indent + 2, LSUSB_DUMP_WIDTH); dump_value( d.descriptor_type, "bDescriptorType", indent + 2, LSUSB_DUMP_WIDTH, ); dump_value( u8::from(d.capability_type.to_owned()), "bDevCapabilityType", indent + 2, LSUSB_DUMP_WIDTH, ); dump_value(d.index, "bIndex", indent + 2, LSUSB_DUMP_WIDTH); dump_hex( d.alternate_mode_vdo, "dwAlternateModeVdo", indent + 2, LSUSB_DUMP_WIDTH, ); } fn dump_platform_device_capability( d: &bos::PlatformDeviceCompatibility, data: bool, indent: usize, ) { dump_string("Platform Device Capability:", indent); dump_value(d.length, "bLength", indent + 2, LSUSB_DUMP_WIDTH); dump_value( d.descriptor_type, "bDescriptorType", indent + 2, LSUSB_DUMP_WIDTH, ); dump_value( d.compatibility_type.to_owned(), "bDevCapabilityType", indent + 2, LSUSB_DUMP_WIDTH, ); dump_value(d.reserved, "bReserved", indent + 2, LSUSB_DUMP_WIDTH); dump_guid( &d.guid, "PlatformCapabilityUUID", indent + 2, LSUSB_DUMP_WIDTH, ); // Dump the data if requested if data { for (i, b) in d.data.iter().enumerate() { dump_hex( *b, &format!("CapabilityData[{i}]"), indent + 2, LSUSB_DUMP_WIDTH, ); } } } fn dump_webusb_platform_capability(d: &bos::WebUsbPlatformCapability, indent: usize) { dump_platform_device_capability(&d.platform, false, indent); dump_string("WebUSB", indent + 4); dump_value(d.version, "bcdVersion", indent + 6, LSUSB_DUMP_WIDTH); dump_value(d.vendor_code, "bVendorCode", indent + 6, LSUSB_DUMP_WIDTH); dump_value_string( d.landing_page_index, "iLandingPage", d.url.as_ref().unwrap_or(&String::new()), indent + 6, LSUSB_DUMP_WIDTH, ); for (i, b) in d.platform.data.iter().enumerate() { dump_hex( *b, &format!("CapabilityData[{i}]"), indent + 2, LSUSB_DUMP_WIDTH, ); } } pub fn dump_container_id_capability(d: &bos::ContainerIdCapability, indent: usize) { dump_string("Container ID Device Capability:", indent); dump_value(d.length, "bLength", indent + 2, LSUSB_DUMP_WIDTH); dump_value( d.descriptor_type, "bDescriptorType", indent + 2, LSUSB_DUMP_WIDTH, ); dump_value( u8::from(d.capability_type.to_owned()), "bDevCapabilityType", indent + 2, LSUSB_DUMP_WIDTH, ); dump_value(d.reserved, "bReserved", indent + 2, LSUSB_DUMP_WIDTH); dump_guid(&d.container_id, "ContainerID", indent + 2, LSUSB_DUMP_WIDTH); } fn dump_usb3_dc_configuration_summary(d: &bos::ConfigurationSummaryCapability, indent: usize) { dump_string("Configuration Summary Device Capability:", indent); dump_value(d.length, "bLength", indent + 2, LSUSB_DUMP_WIDTH); dump_value( d.descriptor_type, "bDescriptorType", indent + 2, LSUSB_DUMP_WIDTH, ); dump_value( u8::from(d.capability_type.to_owned()), "bDevCapabilityType", indent + 2, LSUSB_DUMP_WIDTH, ); dump_value(d.version, "bcdVersion", indent + 2, LSUSB_DUMP_WIDTH); dump_value(d.class, "bClass", indent + 2, LSUSB_DUMP_WIDTH); dump_value(d.sub_class, "bSubClass", indent + 2, LSUSB_DUMP_WIDTH); dump_value(d.protocol, "bProtocol", indent + 2, LSUSB_DUMP_WIDTH); dump_value( d.configuration_count, "bConfigurationCount", indent + 2, LSUSB_DUMP_WIDTH, ); dump_array( &d.configured, "bConfigurationIndex", indent + 2, LSUSB_DUMP_WIDTH, ); } pub(crate) fn dump_bos_descriptor( bosd: &bos::BinaryObjectStoreDescriptor, lpm_requred: bool, indent: usize, ) { dump_string("Binary Object Store Descriptor:", indent); dump_value(bosd.length, "bLength", indent + 2, LSUSB_DUMP_WIDTH); dump_value( bosd.descriptor_type, "bDescriptorType", indent + 2, LSUSB_DUMP_WIDTH, ); dump_hex( bosd.total_length, "wTotalLength", indent + 2, LSUSB_DUMP_WIDTH, ); dump_value( bosd.num_device_capabilities, "bNumDeviceCaps", indent + 2, LSUSB_DUMP_WIDTH, ); for cap in &bosd.capabilities { match cap { bos::BosCapability::Usb2Extension(d) => { dump_extension_capability(d, lpm_requred, indent + 2); } bos::BosCapability::SuperSpeed(d) => { dump_ss_capability(d, indent + 2); } bos::BosCapability::SuperSpeedPlus(d) => { dump_ss_plus_capability(d, indent + 2); } bos::BosCapability::Billboard(d) => { dump_billboard_capability(d, indent + 2); } bos::BosCapability::BillboardAltMode(d) => { dump_billboard_alt_mode_capability(d, indent + 2); } bos::BosCapability::ContainerId(d) => { dump_container_id_capability(d, indent + 2); } bos::BosCapability::ConfigurationSummary(d) => { dump_usb3_dc_configuration_summary(d, indent + 2); } bos::BosCapability::Platform(d) => { dump_platform_device_capability(d, true, indent + 2); } bos::BosCapability::WebUsbPlatform(d) => { dump_webusb_platform_capability(d, indent + 2); } _ => { let data: Vec = cap.to_owned().into(); dump_unrecognised(data.as_slice(), indent + 2); } } } } cyme-2.2.6/src/lsusb/names.rs000066400000000000000000000117401506545537300160660ustar00rootroot00000000000000//! Port of names.c in usbutils that provides name lookups for USB data using udev, falling back to USB IDs repository. //! //! lsusb uses udev and the bundled hwdb (based on USB IDs) for name lookups. To attempt parity with lsusb, this module uses udev_hwdb if the feature is enabled, otherwise it will fall back to the USB IDs repository. Whilst they both get data from the same source, the bundled udev hwdb might be different due to release version/customisations. //! //! The function names match those found in the lsusb source code. #[allow(unused_imports)] use crate::error::{Error, ErrorKind}; use usb_ids::{self, FromId}; /// Get name of vendor from [`usb_ids::Vendor`] or `hwdb_get` if feature is enabled /// /// ``` /// use cyme::lsusb::names; /// assert_eq!(names::vendor(0x1d6b), Some("Linux Foundation".to_owned())); /// ``` pub fn vendor(vid: u16) -> Option { hwdb_get(&format!("usb:v{vid:04X}*"), "ID_VENDOR_FROM_DATABASE") .unwrap_or_else(|_| usb_ids::Vendor::from_id(vid).map(|v| v.name().to_owned())) } /// Get name of product from [`usb_ids::Device`] or `hwdb_get` if feature is enabled /// /// ``` /// use cyme::lsusb::names; /// assert_eq!(names::product(0x1d6b, 0x0003), Some("3.0 root hub".to_owned())); /// ``` pub fn product(vid: u16, pid: u16) -> Option { hwdb_get( &format!("usb:v{vid:04X}p{pid:04X}*"), "ID_MODEL_FROM_DATABASE", ) .unwrap_or_else(|_| usb_ids::Device::from_vid_pid(vid, pid).map(|v| v.name().to_owned())) } /// Get name of class from [`usb_ids::Class`] or `hwdb_get` if feature is enabled /// /// ``` /// use cyme::lsusb::names; /// assert_eq!(names::class(0x03), Some("Human Interface Device".to_owned())); /// ``` pub fn class(id: u8) -> Option { hwdb_get( &format!("usb:v*p*d*dc{id:02X}*"), "ID_USB_CLASS_FROM_DATABASE", ) .unwrap_or_else(|_| usb_ids::Class::from_id(id).map(|v| v.name().to_owned())) } /// Get name of sub class from [`usb_ids::SubClass`] or `hwdb_get` if feature is enabled /// /// ``` /// use cyme::lsusb::names; /// assert_eq!(names::subclass(0x02, 0x02), Some("Abstract (modem)".to_owned())); /// ``` pub fn subclass(cid: u8, scid: u8) -> Option { hwdb_get( &format!("usb:v*p*d*dc{cid:02X}dsc{scid:02X}*"), "ID_USB_SUBCLASS_FROM_DATABASE", ) .unwrap_or_else(|_| usb_ids::SubClass::from_cid_scid(cid, scid).map(|v| v.name().to_owned())) } /// Get name of protocol from [`usb_ids::Protocol`] or `hwdb_get` if feature is enabled /// /// ``` /// use cyme::lsusb::names; /// assert_eq!(names::protocol(0x02, 0x02, 0x05), Some("AT-commands (3G)".to_owned())); /// ``` pub fn protocol(cid: u8, scid: u8, pid: u8) -> Option { hwdb_get( &format!("usb:v*p*d*dc{cid:02X}dsc{scid:02X}dp{pid:02X}*"), "ID_USB_PROTOCOL_FROM_DATABASE", ) .unwrap_or_else(|_| { usb_ids::Protocol::from_cid_scid_pid(cid, scid, pid).map(|v| v.name().to_owned()) }) } /// Get HID descriptor type name from [`usb_ids::Hid`] pub fn hid(id: u8) -> Option { usb_ids::Hid::from_id(id).map(|v| v.name().to_owned()) } /// Get HID report tag name from [`usb_ids::HidItemType`] pub fn report_tag(id: u8) -> Option { usb_ids::HidItemType::from_id(id).map(|v| v.name().to_owned()) } /// Get name of [`usb_ids::HidUsagePage`] from id pub fn huts(id: u8) -> Option { usb_ids::HidUsagePage::from_id(id).map(|v| v.name().to_owned()) } /// Get name of [`usb_ids::HidUsage`] from page id and usage id pub fn hutus(page_id: u8, id: u16) -> Option { usb_ids::HidUsage::from_pageid_uid(page_id, id).map(|v| v.name().to_owned()) } /// Get name of [`usb_ids::Language`] from id pub fn langid(id: u16) -> Option { usb_ids::Language::from_id(id).map(|v| v.name().to_owned()) } /// Get name of [`usb_ids::Phy`] from id pub fn physdes(id: u8) -> Option { usb_ids::Phy::from_id(id).map(|v| v.name().to_owned()) } /// Get name of [`usb_ids::Bias`] from id pub fn bias(id: u8) -> Option { usb_ids::Bias::from_id(id).map(|v| v.name().to_owned()) } /// Get name of [`usb_ids::HidCountryCode`] from id pub fn countrycode(id: u8) -> Option { usb_ids::HidCountryCode::from_id(id).map(|v| v.name().to_owned()) } /// Get name of [`usb_ids::VideoTerminal`] from id pub fn videoterminal(id: u16) -> Option { usb_ids::VideoTerminal::from_id(id).map(|v| v.name().to_owned()) } /// Wrapper around [`crate::udev::hwdb_get`] so that it can be 'used' without feature /// /// Returns `Err` not `None` if feature is not enabled so that with unwrap_or hwdb can still return `None` if no match in db #[allow(unused_variables)] fn hwdb_get(modalias: &str, key: &'static str) -> Result, Error> { #[cfg(all(target_os = "linux", feature = "udev_hwdb"))] return crate::udev::hwdb::get(modalias, key); #[cfg(not(all(target_os = "linux", feature = "udev_hwdb")))] return Err(Error::new( ErrorKind::Unsupported, "hwdb_get requires 'udev_hwdb' feature", )); } cyme-2.2.6/src/lsusb/video_dumps.rs000066400000000000000000000611701506545537300173030ustar00rootroot00000000000000use crate::usb::descriptors::video; use super::*; // TODO - convert these to Rust enum like [`Uac1ChannelNames`] etc. const CAM_CTRL_NAMES: [&str; 22] = [ "Scanning Mode", "Auto-Exposure Mode", "Auto-Exposure Priority", "Exposure Time (Absolute)", "Exposure Time (Relative)", "Focus (Absolute)", "Focus (Relative)", "Iris (Absolute)", "Iris (Relative)", "Zoom (Absolute)", "Zoom (Relative)", "PanTilt (Absolute)", "PanTilt (Relative)", "Roll (Absolute)", "Roll (Relative)", "Reserved", "Reserved", "Focus, Auto", "Privacy", "Focus, Simple", "Window", "Region of Interest", ]; const CTRL_NAMES: [&str; 19] = [ "Brightness", "Contrast", "Hue", "Saturation", "Sharpness", "Gamma", "White Balance Temperature", "White Balance Component", "Backlight Compensation", "Gain", "Power Line Frequency", "Hue, Auto", "White Balance Temperature, Auto", "White Balance Component, Auto", "Digital Multiplier", "Digital Multiplier Limit", "Analog Video Standard", "Analog Video Lock Status", "Contrast, Auto", ]; const EN_CTRL_NAMES: [&str; 22] = [ "Scanning Mode", "Auto-Exposure Mode", "Auto-Exposure Priority", "Exposure Time (Absolute)", "Exposure Time (Relative)", "Focus (Absolute)", "Focus (Relative)", "Iris (Absolute)", "Iris (Relative)", "Zoom (Absolute)", "Zoom (Relative)", "PanTilt (Absolute)", "PanTilt (Relative)", "Roll (Absolute)", "Roll (Relative)", "Reserved", "Reserved", "Focus, Auto", "Privacy", "Focus, Simple", "Window", "Region of Interest", ]; const STD_NAMES: [&str; 6] = [ "None", "NTSC - 525/60", "PAL - 625/50", "SECAM - 625/50", "NTSC - 625/50", "PAL - 525/60", ]; fn dump_processing_unit(pu: &video::ProcessingUnit, protocol: u8, indent: usize, width: usize) { dump_value(pu.unit_id, "bUnitID", indent + 2, width); dump_value(pu.source_id, "bSourceID", indent + 2, width); dump_value(pu.max_multiplier, "wMaxMultiplier", indent + 2, width); dump_value(pu.control_size, "bControlSize", indent + 2, width); dump_hex(pu.controls, "bmControls", indent + 2, width); if protocol == 0x01 { for (i, n) in CTRL_NAMES.iter().enumerate().take(19) { if (pu.controls >> i) & 1 != 0 { dump_string(n, indent + 4); } } } else { for (i, n) in CTRL_NAMES.iter().enumerate().take(18) { if (pu.controls >> i) & 1 != 0 { dump_string(n, indent + 4); } } } dump_value_string( pu.processing_index, "iProcessing", pu.processing_index.to_string(), indent + 2, width, ); dump_hex(pu.video_standards, "bmVideoStandards", indent + 2, width); for (i, n) in STD_NAMES.iter().enumerate().take(6) { if (pu.video_standards >> i) & 1 != 0 { dump_string(n, indent + 4); } } } fn dump_extension_unit(eu: &video::ExtensionUnit, indent: usize, width: usize) { dump_value(eu.unit_id, "bUnitID", indent + 2, width); dump_guid( &eu.guid_extension_code, "guidExtensionCode", indent + 2, width, ); dump_value(eu.num_controls, "bNumControls", indent + 2, width); dump_value(eu.num_input_pins, "bNrInPins", indent + 2, width); for (i, source_id) in eu.source_ids.iter().enumerate() { dump_value(*source_id, &format!("baSourceID({i:2})"), indent + 2, width); } dump_value(eu.control_size, "bControlSize", indent + 2, width); for (i, control) in eu.controls.iter().enumerate() { dump_hex(*control, &format!("bmControls({i:2})"), indent + 2, width); } dump_value_string( eu.extension_index, "iExtension", eu.extension.as_ref().unwrap_or(&String::new()), indent + 2, width, ); } fn dump_encoding_unit(eu: &video::EncodingUnit, indent: usize, width: usize) { dump_value(eu.unit_id, "bUnitID", indent + 2, width); dump_value(eu.source_id, "bSourceID", indent + 2, width); dump_value_string( eu.encoding_index, "iEncoding", eu.encoding.as_ref().unwrap_or(&String::new()), indent + 2, width, ); dump_value(eu.control_size, "bControlSize", indent + 2, width); dump_hex(eu.controls, "bmControls", indent + 2, width); for (i, n) in EN_CTRL_NAMES.iter().enumerate().take(20) { if (eu.controls >> i) & 1 != 0 { dump_string(n, indent + 4); } } dump_hex(eu.controls_runtime, "bmControlsRuntime", indent + 2, width); for (i, n) in EN_CTRL_NAMES.iter().enumerate().take(20) { if (eu.controls_runtime >> i) & 1 != 0 { dump_string(n, indent + 4); } } } pub(crate) fn dump_videocontrol_interface( vcd: &video::UvcDescriptor, vct: &video::ControlSubtype, protocol: u8, indent: usize, ) { const DUMP_WIDTH: usize = 36; // wider in lsusb for long numbers dump_string("VideoControl Interface Descriptor:", indent); dump_value(vcd.length, "bLength", indent + 2, DUMP_WIDTH); dump_value( vcd.descriptor_type, "bDescriptorType", indent + 2, DUMP_WIDTH, ); dump_value_string( vct.to_owned() as u8, "bDescriptorSubtype", format!("({vct:#})"), indent + 2, DUMP_WIDTH, ); match &vcd.interface { video::UvcInterfaceDescriptor::Invalid(_) => { println!( "{:indent$}Warning: {:#} descriptors are illegal for {}", "", vct, protocol.to_owned(), indent = indent ); } uvcid => dump_video_subtype(uvcid, protocol, indent, DUMP_WIDTH), } } pub(crate) fn dump_videocontrol_interrupt_endpoint( epd: &video::UvcDescriptor, indent: usize, width: usize, ) { let subtype_byte = u8::from(epd.descriptor_subtype.to_owned()); let subtype_string = match subtype_byte { 0x03 => "EP_INTERRUPT", // lowercase in lsusb _ => "invalid", }; let bytes = Vec::::from(epd.interface.to_owned()); if epd.length < 5 { println!("{indent:indent$}Warning: Descriptor too short"); } if epd.descriptor_type != 0x01 { println!("{indent:indent$}Warning: Invalid descriptor type"); } dump_string("VideoControl Endpoint Descriptor:", indent); dump_value(epd.length, "bLength", indent + 2, width); dump_value(epd.descriptor_type, "bDescriptorType", indent + 2, width); dump_value_string( subtype_byte, "bDescriptorSubtype", format!("({subtype_string})"), indent + 2, width, ); if let (Some(first), Some(second)) = (bytes.first(), bytes.get(1)) { let wmax = u16::from_le_bytes([*first, *second]); dump_value(wmax, "wMaxTransferSize", indent + 2, width); } dump_junk(&bytes, indent + 2, epd.length as usize - 3, 2); } fn dump_video_input_header(ih: &video::InputHeader, indent: usize, width: usize) { dump_value(ih.num_formats, "bNumFormats", indent + 2, width); dump_hex(ih.total_length, "wTotalLength", indent + 2, width); dump_value_string( format!("0x{:02x}", ih.endpoint_address.address), "bEndpointAddress", ih.endpoint_address.to_string(), indent + 2, width, ); dump_value(ih.info, "bmInfo", indent + 2, width); dump_value(ih.terminal_link, "bTerminalLink", indent + 2, width); dump_value( ih.still_capture_method, "bStillCaptureMethod", indent + 2, width, ); dump_value(ih.trigger_support, "bTriggerSupport", indent + 2, width); dump_value(ih.trigger_usage, "bTriggerUsage", indent + 2, width); dump_value(ih.control_size, "bControlSize", indent + 2, width); for (i, b) in ih.controls.chunks(ih.control_size as usize).enumerate() { dump_value(b[0], &format!("bmaControls({i:2})"), indent + 2, width); } } fn dump_video_output_header(oh: &video::OutputHeader, indent: usize, width: usize) { dump_value(oh.num_formats, "bNumFormats", indent + 2, width); dump_hex(oh.total_length, "wTotalLength", indent + 2, width); dump_value_string( format!("0x{:02x}", oh.endpoint_address.address), "bEndpointAddress", oh.endpoint_address.to_string(), indent + 2, width, ); dump_value(oh.terminal_link, "bTerminalLink", indent + 2, width); dump_value(oh.control_size, "bControlSize", indent + 2, width); for (i, b) in oh.controls.chunks(oh.control_size as usize).enumerate() { dump_value(b[0], &format!("bmaControls({i:2})"), indent + 2, width); } } fn dump_video_color_format(cf: &video::ColorFormat, indent: usize, width: usize) { let color_primitives = |c: u8| match c { 1 => "BT.709,sRGB", 2 => "BT.470-2 (M)", 3 => "BT.470-2 (B,G)", 4 => "SMPTE 170M", 5 => "SMPTE 240M", _ => "Unspecified", }; let transfer_characteristics = |c: u8| match c { 1 => "BT.709", 2 => "BT.470-2 (M)", 3 => "BT.470-2 (B,G)", 4 => "SMPTE 170M", 5 => "SMPTE 240M", 6 => "Linear", 7 => "sRGB", _ => "Unspecified", }; let matrix_coefficients = |c: u8| match c { 1 => "BT.709", 2 => "FCC", 3 => "BT.470-2 (B,G)", 4 => "SMPTE 170M (BT.601)", 5 => "SMPTE 240M", _ => "Unspecified", }; dump_value_string( cf.color_primaries, "bColorPrimaries", format!("({})", color_primitives(cf.color_primaries)), indent + 2, width, ); dump_value_string( cf.transfer_characteristics, "bTransferCharacteristics", format!( "({})", transfer_characteristics(cf.transfer_characteristics) ), indent + 2, width, ); dump_value_string( cf.matrix_coefficients, "bMatrixCoefficients", format!("({})", matrix_coefficients(cf.matrix_coefficients)), indent + 2, width, ); } fn dump_format_stream_based(fs: &video::FormatStreamBased, indent: usize, width: usize) { dump_value(fs.format_index, "bFormatIndex", indent + 2, width); dump_guid(&fs.guid_format, "guidFormat", indent + 2, width); dump_value(fs.packet_length, "dwPacketLength", indent + 2, width); } fn dump_format_mpeg2ts(fmts: &video::FormatMPEG2TS, indent: usize, width: usize) { dump_value(fmts.format_index, "bFormatIndex", indent + 2, width); dump_value(fmts.data_offset, "bDataOffset", indent + 2, width); dump_value(fmts.packet_length, "bPacketLength", indent + 2, width); dump_value(fmts.stride_length, "bStrideLength", indent + 2, width); if let Some(guid) = &fmts.guid_stride_format { dump_guid(guid, "guidStrideFormat", indent + 2, width); } } fn dump_interlace_flags(interlace_flags: u8, indent: usize, width: usize) { let field_pattern = |f: u8| -> &'static str { match f { 0 => "Field 1 only", 1 => "Field 2 only", 2 => "Regular pattern of fields 1 and 2", 3 => "Random pattern of fields 1 and 2", _ => "Invalid", } }; dump_hex(interlace_flags, "bmInterlaceFlags", indent, width); dump_string( &format!( "Interlaced stream or variable: {}", if interlace_flags & 0x01 != 0 { "Yes" } else { "No" } ), indent + 2, ); dump_string( &format!( "Fields per frame: {}", if interlace_flags & 0x02 != 0 { "1" } else { "2" } ), indent + 2, ); dump_string( &format!( "Field 1 first: {}", if interlace_flags & 0x04 != 0 { "Yes" } else { "No" } ), indent + 2, ); dump_string( &format!( "Field pattern: {}", field_pattern((interlace_flags >> 4) & 0x03) ), indent + 2, ); } fn dump_format_mjpeg(fmjpeg: &video::FormatMJPEG, indent: usize, width: usize) { dump_value(fmjpeg.format_index, "bFormatIndex", indent + 2, width); dump_value( fmjpeg.num_frame_descriptors, "bNumFrameDescriptors", indent + 2, width, ); dump_value(fmjpeg.flags, "bmFlags", indent + 2, width); dump_string( &format!( "Fixed-size samples: {}", if fmjpeg.flags & 0x01 != 0 { "Yes" } else { "No" } ), indent + 2, ); dump_value( fmjpeg.default_frame_index, "bDefaultFrameIndex", indent + 2, width, ); dump_value(fmjpeg.aspect_ratio_x, "bAspectRatioX", indent + 2, width); dump_value(fmjpeg.aspect_ratio_y, "bAspectRatioY", indent + 2, width); dump_interlace_flags(fmjpeg.interlace_flags, indent + 2, width); dump_value(fmjpeg.copy_protect, "bCopyProtect", indent + 2, width); } fn dump_still_image_frame(sif: &video::StillImageFrame, indent: usize, width: usize) { dump_value_string( sif.endpoint_address.address, "bEndpointAddress", sif.endpoint_address.to_string(), indent + 2, width, ); dump_value( sif.num_image_size_patterns, "bNumImageSizePatterns", indent + 2, width, ); for (i, (w, h)) in sif.image_size_patterns.iter().enumerate() { dump_value(*w, &format!("wWidth({i:2})"), indent + 2, width); dump_value(*h, &format!("wHeight({i:2})"), indent + 2, width); } dump_value( sif.num_compression_patterns, "bNumCompressionPatterns", indent + 2, width, ); for (i, b) in sif.compression_patterns.iter().enumerate() { dump_value(*b, &format!("bCompression({i:2})"), indent + 2, width); } } fn dump_format_frame(fufb: &video::FormatFrame, indent: usize, width: usize) { dump_value(fufb.format_index, "bFormatIndex", indent + 2, width); dump_value( fufb.num_frame_descriptors, "bNumFrameDescriptors", indent + 2, width, ); dump_guid(&fufb.guid_format, "guidFormat", indent + 2, width); dump_value(fufb.bits_per_pixel, "bBitsPerPixel", indent + 2, width); dump_value( fufb.default_frame_index, "bDefaultFrameIndex", indent + 2, width, ); dump_value(fufb.aspect_ratio_x, "bAspectRatioX", indent + 2, width); dump_value(fufb.aspect_ratio_y, "bAspectRatioY", indent + 2, width); dump_hex(fufb.interlace_flags, "bmInterlaceFlags", indent + 2, width); dump_value(fufb.copy_protect, "bCopyProtect", indent + 2, width); dump_interlace_flags(fufb.interlace_flags, indent + 2, width); if let Some(variable_size) = fufb.variable_size { dump_value(variable_size, "bVariableSize", indent + 2, width); } } fn dump_frame(frame: &video::FrameCommon, indent: usize, dump_width: usize) { dump_value(frame.frame_index, "bFrameIndex", indent + 2, dump_width); dump_hex(frame.capabilities, "bmCapabilities", indent + 2, dump_width); if frame.capabilities & 0x01 != 0 { dump_string("Still image supported", indent + 4); } else { dump_string("Still image unsupported", indent + 4); } if frame.capabilities & 0x02 != 0 { dump_string("Fixed frame-rate", indent + 4); } dump_value(frame.width, "wWidth", indent + 2, dump_width); dump_value(frame.height, "wHeight", indent + 2, dump_width); dump_value(frame.min_bit_rate, "dwMinBitRate", indent + 2, dump_width); dump_value(frame.max_bit_rate, "dwMaxBitRate", indent + 2, dump_width); } fn dump_frame_uncompressed(frame: &video::FrameUncompressed, indent: usize, dump_width: usize) { dump_frame(&frame.common, indent, dump_width); dump_value( frame.max_video_frame_buffer_size, "dwMaxVideoFrameBufferSize", indent + 2, dump_width, ); dump_value( frame.default_frame_interval, "dwDefaultFrameInterval", indent + 2, dump_width, ); dump_value( frame.frame_interval_type, "bFrameIntervalType", indent + 2, dump_width, ); if frame.frame_interval_type == 0 { dump_value( frame.frame_intervals[0], "dwMinFrameInterval", indent + 2, dump_width, ); dump_value( frame.frame_intervals[1], "dwMaxFrameInterval", indent + 2, dump_width, ); dump_value( frame.frame_intervals[2], "dwFrameIntervalStep", indent + 2, dump_width, ); } else { for (i, interval) in frame.frame_intervals.iter().enumerate() { dump_value( *interval, &format!("dwFrameInterval({i:2})"), indent + 2, dump_width, ); } } } fn dump_frame_framebased(frame: &video::FrameFrameBased, indent: usize, dump_width: usize) { dump_frame(&frame.common, indent, dump_width); dump_value( frame.default_frame_interval, "dwDefaultFrameInterval", indent + 2, dump_width, ); dump_value( frame.frame_interval_type, "bFrameIntervalType", indent + 2, dump_width, ); dump_value( frame.bytes_per_line, "dwBytesPerLine", indent + 2, dump_width, ); if frame.frame_interval_type == 0 { dump_value( frame.frame_intervals[0], "dwMinFrameInterval", indent + 2, dump_width, ); dump_value( frame.frame_intervals[1], "dwMaxFrameInterval", indent + 2, dump_width, ); dump_value( frame.frame_intervals[2], "dwFrameIntervalStep", indent + 2, dump_width, ); } else { for (i, interval) in frame.frame_intervals.iter().enumerate() { dump_value( *interval, &format!("dwFrameInterval({i:2})"), indent + 2, dump_width, ); } } } fn dump_video_subtype( uvcid: &video::UvcInterfaceDescriptor, protocol: u8, indent: usize, width: usize, ) { match uvcid { video::UvcInterfaceDescriptor::Header(h) => { dump_value(h.version, "bcdUVC", indent + 2, width); dump_hex(h.total_length, "wTotalLength", indent + 2, width); dump_value( format!( "{:5}.{:06}MHz", h.clock_frequency / 1000000, h.clock_frequency % 1000000 ), "dwClockFrequency", indent + 2, width + 10, ); dump_value(h.collection_bytes, "bInCollection", indent + 2, width); dump_array(&h.interfaces, "baInterfaceNr", indent + 2, width); } video::UvcInterfaceDescriptor::InputTerminal(d) => { dump_value(d.terminal_id, "bTerminalID", indent + 2, width); dump_value_string( format!("0x{:04x}", d.terminal_type), "wTerminalType", names::videoterminal(d.terminal_type).unwrap_or_default(), indent + 2, width, ); dump_value(d.associated_terminal, "bAssocTerminal", indent + 2, width); dump_value_string( d.terminal_index, "iTerminal", d.terminal.as_ref().unwrap_or(&String::new()), indent + 2, width, ); if let Some(extra) = &d.extra { dump_value( extra.objective_focal_length_min, "wObjectiveFocalLengthMin", indent + 2, width, ); dump_value( extra.objective_focal_length_max, "wObjectiveFocalLengthMax", indent + 2, width, ); dump_value( extra.ocular_focal_length, "wOcularFocalLength", indent + 2, width, ); dump_value(extra.control_size, "bControlSize", indent + 2, width); dump_hex(extra.controls, "bmControls", indent + 2, width); if protocol == 0x01 { for (i, n) in CAM_CTRL_NAMES.iter().enumerate().take(22) { if (extra.controls >> i) & 1 != 0 { dump_string(n, indent + 4); } } } else { for (i, n) in CAM_CTRL_NAMES.iter().enumerate().take(19) { if (extra.controls >> i) & 1 != 0 { dump_string(n, indent + 4); } } } } } video::UvcInterfaceDescriptor::OutputTerminal(ot) => { dump_audio_output_terminal1(ot, indent, width); } video::UvcInterfaceDescriptor::SelectorUnit(su) => { dump_audio_selector_unit1(su, indent, width); } video::UvcInterfaceDescriptor::ProcessingUnit(pu) => { dump_processing_unit(pu, protocol, indent, width); } video::UvcInterfaceDescriptor::ExtensionUnit(eu) => { dump_extension_unit(eu, indent, width); } video::UvcInterfaceDescriptor::EncodingUnit(eu) => { dump_encoding_unit(eu, indent, width); } video::UvcInterfaceDescriptor::InputHeader(d) => { dump_video_input_header(d, indent, width); } video::UvcInterfaceDescriptor::OutputHeader(d) => { dump_video_output_header(d, indent, width); } video::UvcInterfaceDescriptor::StillImageFrame(d) => { dump_still_image_frame(d, indent, width); } video::UvcInterfaceDescriptor::FormatFrameBased(d) | video::UvcInterfaceDescriptor::FormatUncompressed(d) => { dump_format_frame(d, indent, width); } video::UvcInterfaceDescriptor::FrameUncompressed(d) | video::UvcInterfaceDescriptor::FrameMJPEG(d) => { dump_frame_uncompressed(d, indent, width); } video::UvcInterfaceDescriptor::FrameFrameBased(d) => { dump_frame_framebased(d, indent, width); } video::UvcInterfaceDescriptor::FormatMJPEG(d) => { dump_format_mjpeg(d, indent, width); } video::UvcInterfaceDescriptor::FormatMPEG2TS(d) => { dump_format_mpeg2ts(d, indent, width); } video::UvcInterfaceDescriptor::ColorFormat(d) => { dump_video_color_format(d, indent, width); } video::UvcInterfaceDescriptor::FormatStreamBased(d) => { dump_format_stream_based(d, indent, width); } video::UvcInterfaceDescriptor::Undefined(data) | video::UvcInterfaceDescriptor::Invalid(data) => { println!( "{:indent$}Invalid desc subtype: {}", "", data.iter() .map(|b| format!("{b:02x}")) .collect::>() .join(" "), indent = indent + 2, ); } _ => { log::warn!("Unhandled UVC interface descriptor: {uvcid:?}"); } } } pub(crate) fn dump_videostreaming_interface( vsd: &video::UvcDescriptor, vst: &video::StreamingSubtype, protocol: u8, indent: usize, ) { const DUMP_WIDTH: usize = 36; // wider in lsusb for long numbers dump_string("VideoStreaming Interface Descriptor:", indent); dump_value(vsd.length, "bLength", indent + 2, DUMP_WIDTH); dump_value( vsd.descriptor_type, "bDescriptorType", indent + 2, DUMP_WIDTH, ); dump_value_string( vst.to_owned() as u8, "bDescriptorSubtype", format!("({vst:#})"), indent + 2, DUMP_WIDTH, ); match &vsd.interface { video::UvcInterfaceDescriptor::Invalid(_) => { println!( "{:indent$}Warning: {:#} descriptors are illegal for {}", "", vst, protocol.to_owned(), indent = indent ); } uvcid => dump_video_subtype(uvcid, protocol, indent, DUMP_WIDTH), } } cyme-2.2.6/src/main.rs000066400000000000000000000730651506545537300145670ustar00rootroot00000000000000//! Where the magic happens for `cyme` binary! #[cfg(not(feature = "watch"))] use clap::Parser; #[cfg(feature = "watch")] use clap::{Parser, Subcommand}; use colored::*; use serde::{Deserialize, Serialize}; use serde_with::skip_serializing_none; use simple_logger::SimpleLogger; use std::collections::HashSet; use std::env; use std::path::{Path, PathBuf}; use terminal_size::terminal_size; use cyme::config::Config; use cyme::display::{self, Block, DeviceBlocks}; use cyme::error::{Error, ErrorKind, Result}; use cyme::lsusb; use cyme::profiler; use cyme::usb::BaseClass; #[cfg(feature = "watch")] mod watch; const MAX_VERBOSITY: u8 = 4; #[derive(Parser, Debug, Default, Serialize, Deserialize)] #[skip_serializing_none] #[command(author, version, about, long_about = None, max_term_width=80)] struct Args { /// Attempt to maintain compatibility with lsusb output #[arg(short, long, default_value_t = false)] lsusb: bool, /// Dump USB device hierarchy as a tree #[arg(short, long, default_value_t = false)] tree: bool, /// Show only devices with the specified vendor and product ID numbers (in hexadecimal) in format VID:[PID] #[arg(short = 'd', long)] vidpid: Option, /// Show only devices with specified device and/or bus numbers (in decimal) in format [[bus]:][devnum] #[arg(short, long)] show: Option, /// Selects which device lsusb will examine - supplied as Linux /dev/bus/usb/BBB/DDD style path #[arg(short = 'D', long)] device: Option, /// Filter on string contained in name #[arg(long)] filter_name: Option, /// Filter on string contained in serial #[arg(long)] filter_serial: Option, /// Filter on USB class code #[arg(long)] filter_class: Option, /// Verbosity level (repeat provides count): 1 prints device configurations; 2 prints interfaces; 3 prints interface endpoints; 4 prints everything and more blocks #[arg(short = 'v', long, default_value_t = 0, action = clap::ArgAction::Count)] verbose: u8, /// Specify the blocks which will be displayed for each device and in what order. Supply arg multiple times or csv to specify multiple blocks. /// /// Default blocks: --blocks bus-number,device-number,icon,vendor-id,product-id,name,serial,speed #[arg(short, long, value_enum, value_delimiter = ',', num_args = 1..)] blocks: Option>, /// Specify the blocks which will be displayed for each bus and in what order. Supply arg multiple times or csv to specify multiple blocks. /// /// Default blocks: --bus-blocks port-path,name,host-controller,host-controller-device #[arg(long, value_enum, value_delimiter = ',', num_args = 1..)] bus_blocks: Option>, /// Specify the blocks which will be displayed for each configuration and in what order. Supply arg multiple times or csv to specify multiple blocks. /// /// Default blocks: --config-blocks number,icon-attributes,max-power,name #[arg(long, value_enum, value_delimiter = ',', num_args = 1..)] config_blocks: Option>, /// Specify the blocks which will be displayed for each interface and in what order. Supply arg multiple times or csv to specify multiple blocks. /// /// Default blocks: --interface-blocks port-path,icon,alt-setting,base-class,sub-class --interface #[arg(long, value_enum, value_delimiter = ',', num_args = 1..)] interface_blocks: Option>, /// Specify the blocks which will be displayed for each endpoint and in what order. Supply arg multiple times or csv to specify multiple blocks. /// /// Default blocks: --endpoint-blocks number,direction,transfer-type,sync-type,usage-type,max-packet-size #[arg(long, value_enum, value_delimiter = ',', num_args = 1..)] endpoint_blocks: Option>, /// Operation to perform on the blocks supplied via --blocks, --bus-blocks, --config-blocks, --interface-blocks and --endpoint-blocks /// /// Default is 'new' for legacy, 'add' is probably more useful #[arg(long, value_enum, default_value_t = display::BlockOperation::New)] block_operation: display::BlockOperation, /// Print more blocks by default at each verbosity #[arg(short, long, default_value_t = false)] more: bool, /// Sort devices operation #[arg(long, value_enum, default_value_t = display::Sort::DeviceNumber)] sort_devices: display::Sort, /// Sort devices by bus number. If using any sort-devices other than no-sort, this happens automatically #[arg(long, default_value_t = false)] sort_buses: bool, /// Group devices by value when listing #[arg(long, value_enum, default_value_t = Default::default())] group_devices: display::Group, /// Hide empty buses when printing tree; those with no devices. // these are a bit confusing, could make value enum with hide_empty, hide... #[arg(long, default_value_t = false)] hide_buses: bool, /// Hide empty hubs when printing tree; those with no devices. When listing will hide hubs regardless of whether empty of not #[arg(long, default_value_t = false)] hide_hubs: bool, /// Show root hubs when listing; Linux only #[arg(long, default_value_t = false)] list_root_hubs: bool, /// Show base16 values as base10 decimal instead #[arg(long, default_value_t = false)] decimal: bool, /// Disable padding to align blocks - will cause --headings to become maligned #[arg(long, default_value_t = false)] no_padding: bool, /// Output coloring mode #[arg(long, value_enum, default_value_t = display::ColorWhen::Always, aliases = &["colour"])] color: display::ColorWhen, /// Disable coloured output, can also use NO_COLOR environment variable #[arg(long, default_value_t = false, hide = true, aliases = &["no_colour"])] no_color: bool, /// Output character encoding #[arg(long, value_enum, default_value_t = display::Encoding::Glyphs)] encoding: display::Encoding, /// Disables icons and utf-8 characters #[arg(long, default_value_t = false, hide = true)] ascii: bool, /// Disables all Block icons by not using any IconTheme. Providing custom XxxxBlocks without any icons is a nicer way to do this #[arg(long, default_value_t = false, hide = true)] no_icons: bool, /// When to print icon blocks #[arg(long, value_enum, default_value_t = display::IconWhen::Auto)] icon: display::IconWhen, /// Show block headings #[arg(long, default_value_t = false)] headings: bool, /// Output as json format after sorting, filters and tree settings are applied; without -tree will be flattened dump of devices #[arg(long, default_value_t = false, overrides_with = "lsusb")] json: bool, /// Read from json output rather than profiling system #[arg(long)] from_json: Option, /// Force pure libusb profiler on macOS rather than combining system_profiler output /// /// Has no effect on other platforms or when using nusb #[arg(short = 'F', long, default_value_t = false)] force_libusb: bool, /// Path to user config file to use for custom icons, colours and default settings #[arg(short = 'c', long)] config: Option, /// Turn debugging information on. Alternatively can use RUST_LOG env: INFO, DEBUG, TRACE #[arg(short = 'z', long, action = clap::ArgAction::Count)] // short -d taken by lsusb compat vid:pid debug: u8, /// Mask serial numbers with '*' or random chars #[arg(long)] mask_serials: Option, /// Generate cli completions and man page #[cfg(feature = "cli_generate")] #[arg(long, hide = true, exclusive = true)] gen: bool, /// Use the system_profiler command on macOS to get USB data /// /// If not using nusb this is the default for macOS, merging with libusb data for verbose output. nusb uses IOKit directly so does not use system_profiler by default #[arg(long, default_value_t = false)] system_profiler: bool, /// Watch sub-command #[cfg(feature = "watch")] #[command(subcommand)] command: Option, } #[cfg(feature = "watch")] #[derive(Subcommand, Debug, Serialize, Deserialize)] enum SubCommand { /// Watch for USB devices being connected and disconnected Watch, } /// Print in bold red and exit with error macro_rules! eprintexit { ($error:expr) => { // `stringify!` will convert the expression *as it is* into a string. eprintln!( "{}\n{}", "cyme encountered a runtime error:".bold().red(), $error.to_string().bold().red() ); std::process::exit(1); }; } /// Print in bold orange warning and log #[allow(unused_macros)] macro_rules! wprintln { ($error:expr) => { // `stringify!` will convert the expression *as it is* into a string. println!("{}", $error.to_string().bold().yellow()); log::warn!($error) }; } /// Merges non-Option Config with passed `Args` /// /// Args will override Config if set fn merge_config(c: &mut Config, a: &Args) { c.lsusb |= a.lsusb; c.tree |= a.tree; c.more |= a.more; c.hide_buses |= a.hide_buses; c.hide_hubs |= a.hide_hubs; c.list_root_hubs |= a.list_root_hubs; c.decimal |= a.decimal; c.no_padding |= a.no_padding; c.ascii |= a.ascii; c.headings |= a.headings; c.force_libusb |= a.force_libusb; c.no_icons |= a.no_icons; c.no_color |= a.no_color; if c.verbose == 0 { c.verbose = a.verbose; } } /// Parse the vidpid filter lsusb format: vid:Option fn parse_vidpid(s: &str) -> Result<(Option, Option)> { let vid_split: Vec<&str> = s.split(':').collect(); if vid_split.len() >= 2 { let vid: Option = vid_split .first() .filter(|v| !v.is_empty()) .map_or(Ok(None), |v| { u32::from_str_radix(v.trim().trim_start_matches("0x"), 16) .map(|v| Some(v as u16)) .map_err(|e| Error::new(ErrorKind::Parsing, &e.to_string())) })?; let pid: Option = vid_split .get(1) .filter(|v| !v.is_empty()) .map_or(Ok(None), |v| { u32::from_str_radix(v.trim().trim_start_matches("0x"), 16) .map(|v| Some(v as u16)) .map_err(|e| Error::new(ErrorKind::Parsing, &e.to_string())) })?; Ok((vid, pid)) } else { let vid: Option = u32::from_str_radix(s.trim().trim_start_matches("0x"), 16) .map(|v| Some(v as u16)) .map_err(|e| Error::new(ErrorKind::Parsing, &e.to_string()))?; Ok((vid, None)) } } /// Parse the show Option:device lsusb format fn parse_show(s: &str) -> Result<(Option, Option)> { if s.contains(':') { let split: Vec<&str> = s.split(':').collect(); let bus: Option = split .first() .filter(|v| !v.is_empty()) .map_or(Ok(None), |v| { v.parse::() .map(Some) .map_err(|e| Error::new(ErrorKind::Parsing, &e.to_string())) })?; let device = split .last() .filter(|v| !v.is_empty()) .map_or(Ok(None), |v| { v.parse::() .map(Some) .map_err(|e| Error::new(ErrorKind::Parsing, &e.to_string())) })?; Ok((bus, device)) } else { let device: Option = s .trim() .parse::() .map(Some) .map_err(|e| Error::new(ErrorKind::Parsing, &e.to_string()))?; Ok((None, device)) } } /// Parse devpath supplied by --device into a show format /// /// Could be a regex match r"^[\/|\w+\/]+(?'bus'\d{3})\/(?'devno'\d{3})$" but this saves another crate fn parse_devpath(s: &str) -> Result<(Option, Option)> { if s.contains('/') { let split: Vec<&str> = s.split('/').collect(); // second to last let bus: Option = split.get(split.len() - 2).map_or(Ok(None), |v| { v.parse::() .map(Some) .map_err(|e| Error::new(ErrorKind::Parsing, &e.to_string())) })?; // last let device = split.last().map_or(Ok(None), |v| { v.parse::() .map(Some) .map_err(|e| Error::new(ErrorKind::Parsing, &e.to_string())) })?; Ok((bus, device)) } else { Err(Error::new( ErrorKind::InvalidArg, &format!("Invalid device path {s}"), )) } } /// macOS can use system_profiler to get USB data and merge with libusb so separate function #[cfg(target_os = "macos")] fn get_system_profile_macos(args: &Args) -> Result { // if requested or only have libusb, use system_profiler and merge with libusb if args.system_profiler || !cfg!(feature = "nusb") { if !args.force_libusb && args.device.is_none() // device path requires extra && args.filter_class.is_none() // class filter requires extra && !((args.tree && args.lsusb) || args.verbose > 0 || args.more) { profiler::macos::get_spusb() .map_or_else(|e| { // For non-zero return, report but continue in this case if e.kind() == ErrorKind::SystemProfiler { eprintln!("Failed to run 'system_profiler -json SPUSBDataType', fallback to cyme profiler; Error({e})"); get_system_profile(args) } else { Err(e) } }, Ok) } else if !args.force_libusb { if cfg!(feature = "libusb") { log::warn!("Merging macOS system_profiler output with libusb for verbose data. Apple internal devices will not be obtained"); } profiler::macos::get_spusb_with_extra().map_or_else(|e| { // For non-zero return, report but continue in this case if e.kind() == ErrorKind::SystemProfiler { eprintln!("Failed to run 'system_profiler -json SPUSBDataType', fallback to cyme profiler; Error({e})"); get_system_profile(args) } else { Err(e) } }, Ok) } else { get_system_profile(args) } } else { get_system_profile(args) } } /// Detects and switches between verbose profiler (extra) and normal profiler fn get_system_profile(args: &Args) -> Result { if args.verbose > 0 || args.tree || args.device.is_some() || args.lsusb || args.more || args.filter_class.is_none() // class filter requires extra { profiler::get_spusb_with_extra() } else { profiler::get_spusb() } } fn print_lsusb( sp_usb: &profiler::SystemProfile, device: &Option, settings: &display::PrintSettings, ) -> Result<()> { // device specific overrides tree on lsusb if settings.tree && device.is_none() { if !cfg!(target_os = "linux") { log::warn!("Most of the data in a lsusb style tree is applicable to Linux only!"); } lsusb::print_tree(sp_usb, settings) } else { // can't print verbose if not using libusb if !(cfg!(feature = "libusb") || cfg!(feature = "nusb")) && (settings.verbosity > 0 || device.is_some()) { return Err(Error::new(ErrorKind::Unsupported, "nusb or libusb feature is required to do this, install with `cargo install --features nusb/libusb`")); } let devices = sp_usb.flattened_devices(); // even though we filtered using filter.show and using prepare, keep this here because it will match the exact Linux dev path and exit error if it doesn't match like lsusb if let Some(dev_path) = &device { lsusb::dump_one_device(&devices, dev_path)? } else { lsusb::print(&devices, settings.verbosity > 0); } }; Ok(()) } /// Generates extra CLI information for packaging #[cfg(feature = "cli_generate")] #[cold] fn print_man() -> Result<()> { use clap::CommandFactory; use clap_complete::generate_to; use clap_complete::shells::*; use std::fs; use std::path::PathBuf; let outdir = std::env::var_os("BUILD_SCRIPT_DIR") .or_else(|| std::env::var_os("OUT_DIR")) .unwrap_or_else(|| "./doc".into()); fs::create_dir_all(&outdir)?; println!("Generating CLI info to {outdir:?}"); let mut app = Args::command(); // completions let bin_name = "cyme"; generate_to(Bash, &mut app, bin_name, &outdir).expect("Failed to generate Bash completions"); generate_to(Fish, &mut app, bin_name, &outdir).expect("Failed to generate Fish completions"); generate_to(Zsh, &mut app, bin_name, &outdir).expect("Failed to generate Zsh completions"); generate_to(PowerShell, &mut app, bin_name, &outdir) .expect("Failed to generate PowerShell completions"); // man page let man = clap_mangen::Man::new(app); let mut buffer: Vec = Default::default(); man.render(&mut buffer)?; std::fs::write(PathBuf::from(&outdir).join("cyme.1"), buffer)?; // example config std::fs::write( PathBuf::from(&outdir).join("cyme_example_config.json"), serde_json::to_string_pretty(&Config::example())?, )?; Ok(()) } fn load_config>(path: Option

) -> Result { if let Some(p) = path { let config = Config::from_file(p); log::info!("Using user config {config:?}"); config } else { Config::sys() } } /// Set log level pub fn set_log_level(debug: u8) -> Result<()> { let mut builder = SimpleLogger::new(); let mut env_levels: HashSet<(String, log::LevelFilter)> = HashSet::new(); let global_level = match debug { 0 => { env_levels.insert(("udevrs".to_string(), log::LevelFilter::Off)); env_levels.insert(("nusb".to_string(), log::LevelFilter::Off)); log::LevelFilter::Error } 1 => { env_levels.insert(("udevrs".to_string(), log::LevelFilter::Warn)); env_levels.insert(("nusb".to_string(), log::LevelFilter::Warn)); env_levels.insert(("cyme".to_string(), log::LevelFilter::Info)); log::LevelFilter::Error } 2 => { env_levels.insert(("udevrs".to_string(), log::LevelFilter::Info)); env_levels.insert(("nusb".to_string(), log::LevelFilter::Info)); env_levels.insert(("cyme".to_string(), log::LevelFilter::Debug)); log::LevelFilter::Error } 3 => { env_levels.insert(("udevrs".to_string(), log::LevelFilter::Debug)); env_levels.insert(("nusb".to_string(), log::LevelFilter::Debug)); env_levels.insert(("cyme".to_string(), log::LevelFilter::Trace)); log::LevelFilter::Error } _ => log::LevelFilter::Trace, }; if let Ok(rust_log) = std::env::var("RUST_LOG") { rust_log .split(',') .filter(|s| !s.is_empty()) .map(|s| { let mut split = s.split('='); let k = split.next().unwrap(); let v = split.next().and_then(|s| s.parse().ok()); (k.to_string(), v) }) .filter(|(_, v)| v.is_some()) .map(|(k, v)| (k, v.unwrap())) .for_each(|(k, v)| { env_levels.replace((k, v)); }); } for (k, v) in env_levels { builder = builder.with_module_level(&k, v); } builder .with_utc_timestamps() .with_level(global_level) .env() .init() .map_err(|e| { Error::new( ErrorKind::Other("logger"), &format!("Failed to set log level: {e}"), ) })?; #[cfg(feature = "libusb")] profiler::libusb::set_log_level(debug); Ok(()) } /// Merge with arg blocks with config blocks (or default if None) depending on BlockOperation fn merge_blocks(config: &Config, args: &Args, settings: &mut display::PrintSettings) -> Result<()> { if let Some(blocks) = &args.blocks { let mut device_blocks = config.blocks.to_owned().unwrap_or(if settings.more { DeviceBlocks::default_blocks(true) } else if settings.tree { DeviceBlocks::default_device_tree_blocks() } else { DeviceBlocks::default_blocks(false) }); args.block_operation.run(&mut device_blocks, blocks)?; settings.device_blocks = Some(device_blocks); } if let Some(blocks) = &args.bus_blocks { settings.bus_blocks = Some(args.block_operation.new_or_op( config.bus_blocks.to_owned(), blocks, settings.more, )?); } if let Some(blocks) = &args.config_blocks { settings.config_blocks = Some(args.block_operation.new_or_op( settings.config_blocks.to_owned(), blocks, settings.more, )?); } if let Some(blocks) = &args.interface_blocks { settings.interface_blocks = Some(args.block_operation.new_or_op( settings.interface_blocks.to_owned(), blocks, settings.more, )?); } if let Some(blocks) = &args.endpoint_blocks { settings.endpoint_blocks = Some(args.block_operation.new_or_op( settings.endpoint_blocks.to_owned(), blocks, settings.more, )?); } Ok(()) } fn cyme() -> Result<()> { let mut args = Args::parse(); #[cfg(feature = "cli_generate")] if args.gen { print_man()?; std::process::exit(0); } // set the module debug level, will also check env if args.debug == 0 set_log_level(args.debug)?; let mut config = load_config(args.config.as_deref())?; // add any config ENV override if config.print_non_critical_profiler_stderr { std::env::set_var("CYME_PRINT_NON_CRITICAL_PROFILER_STDERR", "1"); } // legacy arg, hidden but still support with new format if args.ascii { args.encoding = display::Encoding::Ascii; } // legacy arg, hidden but still support with new format if args.no_color { args.color = display::ColorWhen::Never; } if args.verbose >= MAX_VERBOSITY { args.more = true; } merge_config(&mut config, &args); // set the output colouring match args.color { display::ColorWhen::Always => { env::set_var("NO_COLOR", "0"); colored::control::set_override(true); config.no_color = false; } display::ColorWhen::Never => { // set env to be sure too env::set_var("NO_COLOR", "1"); colored::control::set_override(false); config.no_color = true; } _ => (), }; let mut spusb = if let Some(file_path) = args.from_json.clone() { match profiler::read_json_dump(&file_path) { Ok(s) => s, Err(e) => { log::warn!( "Failed to read json dump, attempting as flattened with phony bus: Error({e})" ); profiler::read_flat_json_to_phony_bus(&file_path)? } } } else { #[cfg(target_os = "macos")] { get_system_profile_macos(&args)? } #[cfg(not(target_os = "macos"))] { get_system_profile(&args)? } }; let filter = if args.hide_hubs || args.hide_buses || args.vidpid.is_some() || args.show.is_some() || args.device.is_some() || args.filter_name.is_some() || args.filter_serial.is_some() || args.filter_class.is_some() { let mut f = profiler::Filter::new(); if let Some(vidpid) = &args.vidpid { let (vid, pid) = parse_vidpid(vidpid.as_str()).map_err(|e| { Error::new( ErrorKind::InvalidArg, &format!("Failed to parse vidpid '{vidpid}'; Error({e})"), ) })?; f.vid = vid; f.pid = pid; } // decode device devpath into the show filter since that is what it essentially will do if let Some(devpath) = &args.device { let (bus, number) = parse_devpath(devpath.as_str()).map_err(|e| { Error::new( ErrorKind::InvalidArg, &format!( "Failed to parse devpath '{devpath}', should end with 'BUS/DEVNO'; Error({e})" ), ) })?; f.bus = bus; f.number = number; } else if let Some(show) = &args.show { let (bus, number) = parse_show(show.as_str()).map_err(|e| { Error::new( ErrorKind::InvalidArg, &format!("Failed to parse show parameter '{show}'; Error({e})"), ) })?; f.bus = bus; f.number = number; } // no need to unwrap as these are Option f.name = args.filter_name.clone(); f.serial = args.filter_serial.clone(); f.class = args.filter_class; f.exclude_empty_hub = args.hide_hubs; f.exclude_empty_bus = args.hide_buses; // exclude root hubs unless: // * lsusb compat (shows root_hubs) // * json - for --from-json support // * list_root_hubs - user wants to see root hubs in list f.no_exclude_root_hub = args.lsusb || args.json || args.list_root_hubs; Some(f) } else { // exclude root hubs (on Linux) unless: // * lsusb compat (shows root_hubs) // * json - for --from-json support // * list_root_hubs - user wants to see root hubs in list if cfg!(target_os = "linux") { Some(profiler::Filter { no_exclude_root_hub: (args.lsusb || args.json || args.list_root_hubs), ..Default::default() }) } else { None } }; // create print settings from config - merged with arg flags above // then override with any clone args let mut settings = config.print_settings(Some(args.encoding)); settings.terminal_size = terminal_size().map(|(w, h)| (w.0, h.0)); settings.json = args.json; merge_blocks(&config, &args, &mut settings)?; if let Some(mask) = args.mask_serials { settings.mask_serials = Some(mask); } settings.group_devices = if args.group_devices == display::Group::Bus && args.tree { eprintln!("--group-devices with --tree is ignored; will print as tree"); display::Group::NoGroup } else { args.group_devices }; log::trace!("Returned system_profiler data\n\r{spusb:#?}"); #[cfg(feature = "watch")] if matches!(args.command, Some(SubCommand::Watch)) { if args.json { watch::watch_usb_devices_json(spusb, filter, settings)?; } else { watch::watch_usb_devices(spusb, filter, settings, config)?; } return Ok(()); } display::prepare(&mut spusb, filter.as_ref(), &settings); if args.lsusb { print_lsusb(&spusb, &args.device, &settings)?; } else { // check and report if was looking for args.device if args.device.is_some() && !spusb.buses.iter().any(|b| b.is_empty()) { return Err(Error::new( ErrorKind::NotFound, &format!("Unable to find device at {:?}", args.device.unwrap()), )); } display::print(&spusb, &settings); } Ok(()) } fn main() { cyme().unwrap_or_else(|e| { eprintexit!(e); }); } #[cfg(test)] mod tests { use super::*; #[ignore] #[test] fn test_output_args() { let mut args = Args { ..Default::default() }; args.blocks = Some(vec![display::DeviceBlocks::BusNumber]); println!("{}", serde_json::to_string_pretty(&args).unwrap()); } #[test] fn test_parse_vidpid() { assert_eq!( parse_vidpid("000A:0x000b").unwrap(), (Some(0x0A), Some(0x0b)) ); assert_eq!(parse_vidpid("000A:1").unwrap(), (Some(0x0A), Some(1))); assert_eq!(parse_vidpid("000A:").unwrap(), (Some(0x0A), None)); assert_eq!(parse_vidpid("0x000A").unwrap(), (Some(0x0A), None)); assert!(parse_vidpid("dfg:sdfd").is_err()); } #[test] fn test_parse_show() { assert_eq!(parse_show("1").unwrap(), (None, Some(1))); assert_eq!(parse_show("1:124").unwrap(), (Some(1), Some(124))); assert_eq!(parse_show("1:").unwrap(), (Some(1), None)); // too big assert!(parse_show("55233:12323").is_err()); assert!(parse_show("dfg:sdfd").is_err()); } #[test] fn test_parse_devpath() { assert_eq!( parse_devpath("/dev/bus/usb/001/003").unwrap(), (Some(1), Some(3)) ); assert_eq!( parse_devpath("/dev/bus/usb/004/003").unwrap(), (Some(4), Some(3)) ); assert_eq!( parse_devpath("/dev/bus/usb/004/3").unwrap(), (Some(4), Some(3)) ); assert_eq!(parse_devpath("004/3").unwrap(), (Some(4), Some(3))); assert!(parse_devpath("004/").is_err()); assert!(parse_devpath("sas/ssas").is_err()); } } cyme-2.2.6/src/profiler.rs000066400000000000000000001364761506545537300154730ustar00rootroot00000000000000//! System USB profiler for getting system USB information, devices and descriptors //! //! Get [`SystemProfile`] struct of system USB buses and devices with extra data like configs, interfaces and endpoints. The mod function will be based on the feature enabled, either `libusb` or `nusb`. To use a specific profiler, see the submodules [`libusb`], [`nusb`] and [`macos`]. //! //! ```no_run //! use cyme::profiler; //! //! let spusb = profiler::get_spusb_with_extra().unwrap(); //! // print with alternative styling (#) is using utf-8 icons //! println!("{:#}", spusb); //! ``` //! //! See [`types`] docs for what can be done with returned data, such as [`Filter`] use crate::error::Result; use itertools::Itertools; use std::collections::HashMap; use crate::error::{Error, ErrorKind}; #[cfg(all(target_os = "linux", any(feature = "udev", feature = "udevlib")))] use crate::udev; use crate::usb; const REQUEST_GET_DESCRIPTOR: u8 = 0x06; const REQUEST_GET_STATUS: u8 = 0x00; const REQUEST_WEBUSB_URL: u8 = 0x02; pub(crate) const SYSFS_USB_PREFIX: &str = "/sys/bus/usb/devices/"; pub(crate) const SYSFS_PCI_PREFIX: &str = "/sys/bus/pci/devices/"; // separate module but import all pub mod types; pub use types::*; #[cfg(feature = "libusb")] pub mod libusb; #[cfg(target_os = "macos")] pub mod macos; #[cfg(feature = "nusb")] pub mod nusb; #[cfg(all(feature = "nusb", feature = "watch"))] pub mod watch; /// Transfer direction #[derive(Clone, Copy, PartialEq, Eq, Debug)] #[repr(u8)] pub(crate) enum Direction { /// Host to device Out = 0, /// Device to host In = 1, } /// Specification defining the request. #[derive(Clone, Copy, PartialEq, Eq, Debug)] #[repr(u8)] pub(crate) enum ControlType { /// Request defined by the USB standard. Standard = 0, /// Request defined by the standard USB class specification. Class = 1, /// Non-standard request. Vendor = 2, } /// Entity targeted by the request. #[derive(Clone, Copy, PartialEq, Eq, Debug)] #[repr(u8)] pub(crate) enum Recipient { /// Request made to device as a whole. Device = 0, /// Request made to specific interface. Interface = 1, /// Request made to specific endpoint. Endpoint = 2, /// Other request. Other = 3, } /// Control request to USB device. #[derive(Clone, Copy, PartialEq, Eq, Debug)] pub(crate) struct ControlRequest { pub control_type: ControlType, pub recipient: Recipient, pub request: u8, pub value: u16, pub index: u16, pub length: usize, pub claim_interface: bool, } /// Device USB operations required by the [`Profiler`] pub(crate) trait UsbOperations { fn get_descriptor_string(&self, string_index: u8) -> Option; fn get_control_msg(&self, control_request: ControlRequest) -> Result>; } /// OS level USB Profiler trait for profiling USB devices pub(crate) trait Profiler where T: UsbOperations + std::fmt::Debug, Self: std::fmt::Debug, { /// Get the USB HID Report Descriptor with a Control request fn get_report_descriptor(device: &T, index: u16, length: u16) -> Result> { let control_request = ControlRequest { control_type: ControlType::Standard, recipient: Recipient::Interface, request: REQUEST_GET_DESCRIPTOR, value: (u8::from(usb::DescriptorType::Report) as u16) << 8, index, length: length as usize, // only claim interface on linux claim_interface: cfg!(target_os = "linux") || cfg!(target_os = "android"), }; device.get_control_msg(control_request) } /// Get the USB Hub Descriptor with a Control request, include hub port statuses fn get_hub_descriptor( device: &T, protocol: u8, bcd: u16, has_ssp: bool, ) -> Result { let is_ext_status = protocol == 3 && bcd >= 0x0310 && has_ssp; let value = if bcd >= 0x0300 { (u8::from(usb::DescriptorType::SuperSpeedHub) as u16) << 8 } else { (u8::from(usb::DescriptorType::Hub) as u16) << 8 }; let control = ControlRequest { control_type: ControlType::Class, request: REQUEST_GET_DESCRIPTOR, value, index: 0, recipient: Recipient::Device, length: 12, claim_interface: false, }; let data = match device.get_control_msg(control) { Ok(data) => data, Err(_) => { // if failed, try again with at least 9 bytes = min required for one port bitmask let control = ControlRequest { control_type: ControlType::Class, request: REQUEST_GET_DESCRIPTOR, value, index: 0, recipient: Recipient::Device, length: 9, claim_interface: false, }; device.get_control_msg(control)? } }; let mut hub = usb::HubDescriptor::try_from(data.as_slice())?; // get port statuses let mut port_statues: Vec<[u8; 8]> = Vec::with_capacity(hub.num_ports as usize); for p in 0..hub.num_ports { // Request EXT_PORT_STATUS for USB 3.1 SuperSpeedPlus hubs, PORT_STATUS otherwise let control = ControlRequest { control_type: ControlType::Class, request: REQUEST_GET_STATUS, value: if is_ext_status { 2 } else { 0 }, index: p as u16 + 1, recipient: Recipient::Other, length: if is_ext_status { 8 } else { 4 }, claim_interface: false, }; match device.get_control_msg(control) { Ok(mut data) => { if data.len() < 8 { let remaining = 8 - data.len(); data.extend(vec![0; remaining]); } port_statues.push(data.try_into().unwrap()); } Err(e) => { log::warn!( "Failed to get port {} status for {:?}: {}", p + 1, device, e ); return Ok(hub); } } } hub.port_statuses = Some(port_statues); Ok(hub) } /// Get the USB Device status with a Control request fn get_device_status(device: &T) -> Result { let control = ControlRequest { control_type: ControlType::Standard, request: REQUEST_GET_STATUS, value: 0, index: 0, recipient: Recipient::Device, length: 2, claim_interface: false, }; let data = device.get_control_msg(control)?; Ok(u16::from_le_bytes([data[0], data[1]])) } /// Get the USB Debug Descriptor with a Control request fn get_debug_descriptor(device: &T) -> Result { let control = ControlRequest { control_type: ControlType::Standard, request: REQUEST_GET_DESCRIPTOR, value: (u8::from(usb::DescriptorType::Debug) as u16) << 8, index: 0, recipient: Recipient::Device, length: 2, // macOS seems to require claim to prevent timeout claim_interface: cfg!(target_os = "macos"), }; let data = device.get_control_msg(control)?; usb::DebugDescriptor::try_from(data.as_slice()) } /// Get the USB Device Binary Object Store (BOS) Descriptor with a Control request fn get_bos_descriptor( device: &T, ) -> Result { let mut control = ControlRequest { control_type: ControlType::Standard, request: REQUEST_GET_DESCRIPTOR, value: (u8::from(usb::DescriptorType::Bos) as u16) << 8, index: 0, recipient: Recipient::Device, length: 5, claim_interface: false, }; let data = device.get_control_msg(control)?; let total_length = u16::from_le_bytes([data[2], data[3]]); log::debug!("{device:?} Attempt read BOS descriptor total length: {total_length}"); // now get full descriptor control.length = total_length as usize; let data = device.get_control_msg(control)?; log::debug!("{device:?} BOS descriptor data: {data:?}"); let mut bos = usb::descriptors::bos::BinaryObjectStoreDescriptor::try_from(data.as_slice())?; // get any extra descriptor data now with handle for c in bos.capabilities.iter_mut() { match c { usb::descriptors::bos::BosCapability::WebUsbPlatform(w) => { w.url = Self::get_webusb_url(device, w.vendor_code, w.landing_page_index).ok(); log::trace!("{:?} WebUSB URL: {:?}", device, w.url); } usb::descriptors::bos::BosCapability::Billboard(ref mut b) => { b.additional_info_url = device.get_descriptor_string(b.additional_info_url_index); for a in b.alternate_modes.iter_mut() { a.alternate_mode_string = device.get_descriptor_string(a.alternate_mode_string_index); } } _ => (), } } Ok(bos) } /// Get the USB Device Qualifier Descriptor with a Control request fn get_device_qualifier(device: &T) -> Result { let control = ControlRequest { control_type: ControlType::Standard, request: REQUEST_GET_DESCRIPTOR, value: (u8::from(usb::DescriptorType::DeviceQualifier) as u16) << 8, index: 0, recipient: Recipient::Device, length: 10, claim_interface: false, }; let data = device.get_control_msg(control)?; log::debug!("{device:?} Qualifier descriptor data: {data:?}"); usb::DeviceQualifierDescriptor::try_from(data.as_slice()) } /// Gets the WebUSB URL from the device, parsed and formatted as a URL /// /// https://github.com/gregkh/usbutils/blob/master/lsusb.c#L3261 fn get_webusb_url(device: &T, vendor_request: u8, index: u8) -> Result { let control = ControlRequest { control_type: ControlType::Vendor, request: vendor_request, value: index as u16, index: (REQUEST_WEBUSB_URL as u16) << 8, recipient: Recipient::Device, length: 3, claim_interface: false, }; let data = device.get_control_msg(control)?; log::trace!("WebUSB URL descriptor data: {data:?}"); let len = data[0] as usize; if data[1] != u8::from(usb::DescriptorType::String) { return Err(Error { kind: ErrorKind::Parsing, message: "Failed to parse WebUSB URL: Bad URL descriptor type".to_string(), }); } if data.len() < len { return Err(Error { kind: ErrorKind::Parsing, message: "Failed to parse WebUSB URL: Data length mismatch".to_string(), }); } let url = String::from_utf8(data[3..len].to_vec()).map_err(|e| Error { kind: ErrorKind::Parsing, message: format!("Failed to parse WebUSB URL: {e}"), })?; match data[2] { 0x00 => Ok(format!("http://{url}")), 0x01 => Ok(format!("https://{url}")), 0xFF => Ok(url), _ => Err(Error { kind: ErrorKind::Parsing, message: "Failed to parse WebUSB URL: Bad URL scheme".to_string(), }), } } /// Build fully described USB device descriptor with extra bytes /// /// Fully described is based on the [`usb::ClassCodeTriplet`] and [`usb::Descriptor`] types. Any string indexes (or data which requires a control message) will be fetched and added to the descriptor while the device is still available. fn build_descriptor_extra + Copy>( &self, device: &T, class_code: Option>, interface_number: Option, extra_bytes: &[u8], ) -> Result { // Get any extra descriptors into a known type and add any handle data while we have it let mut dt = match usb::Descriptor::try_from(extra_bytes) { Ok(d) => d, Err(e) => { log::debug!("{device:?} Failed to convert extra descriptor bytes: {e}"); return Err(e); } }; // Assign class context to interface since descriptor did not know it if let Some(interface_desc) = class_code { if let Err(e) = dt.update_with_class_context(interface_desc) { log::debug!("{device:?} Failed to update extra descriptor with class context: {e}"); } } // get any strings at string indexes while we have handle match dt { usb::Descriptor::InterfaceAssociation(ref mut iad) => { iad.function_string = device.get_descriptor_string(iad.function_string_index); } usb::Descriptor::Device(ref mut c) | usb::Descriptor::Interface(ref mut c) | usb::Descriptor::Endpoint(ref mut c) => match c { usb::ClassDescriptor::Printer(ref mut p) => { for pd in p.descriptors.iter_mut() { pd.uuid_string = device.get_descriptor_string(pd.uuid_string_index); } } usb::ClassDescriptor::Communication(ref mut cdc) => match cdc.interface { usb::descriptors::cdc::CdcInterfaceDescriptor::CountrySelection(ref mut d) => { d.country_code_date = device.get_descriptor_string(d.country_code_date_index); } usb::descriptors::cdc::CdcInterfaceDescriptor::NetworkChannel(ref mut d) => { d.name = device.get_descriptor_string(d.name_string_index); } usb::descriptors::cdc::CdcInterfaceDescriptor::EthernetNetworking( ref mut d, ) => { d.mac_address = device.get_descriptor_string(d.mac_address_index); } usb::descriptors::cdc::CdcInterfaceDescriptor::CommandSet(ref mut d) => { d.command_set_string = device.get_descriptor_string(d.command_set_string_index); } _ => (), }, // grab report descriptor data using usb_control_msg usb::ClassDescriptor::Hid(ref mut hd) => { for rd in hd.descriptors.iter_mut() { if let Some(index) = interface_number { rd.data = Self::get_report_descriptor(device, index as u16, rd.length).ok(); } } } usb::ClassDescriptor::Midi(ref mut md, _) => match md.interface { usb::descriptors::audio::MidiInterfaceDescriptor::InputJack(ref mut mh) => { mh.jack_string = device.get_descriptor_string(mh.jack_string_index); } usb::descriptors::audio::MidiInterfaceDescriptor::OutputJack(ref mut mh) => { mh.jack_string = device.get_descriptor_string(mh.jack_string_index); } usb::descriptors::audio::MidiInterfaceDescriptor::Element(ref mut mh) => { mh.element_string = device.get_descriptor_string(mh.element_string_index); } _ => (), }, usb::ClassDescriptor::Audio(ref mut ad, _) => match ad.interface { usb::descriptors::audio::UacInterfaceDescriptor::InputTerminal1(ref mut ah) => { ah.channel_names = device.get_descriptor_string(ah.channel_names_index); ah.terminal = device.get_descriptor_string(ah.terminal_index); } usb::descriptors::audio::UacInterfaceDescriptor::InputTerminal2(ref mut ah) => { ah.channel_names = device.get_descriptor_string(ah.channel_names_index); ah.terminal = device.get_descriptor_string(ah.terminal_index); } usb::descriptors::audio::UacInterfaceDescriptor::OutputTerminal1( ref mut ah, ) => { ah.terminal = device.get_descriptor_string(ah.terminal_index); } usb::descriptors::audio::UacInterfaceDescriptor::OutputTerminal2( ref mut ah, ) => { ah.terminal = device.get_descriptor_string(ah.terminal_index); } usb::descriptors::audio::UacInterfaceDescriptor::StreamingInterface2( ref mut ah, ) => { ah.channel_names = device.get_descriptor_string(ah.channel_names_index); } usb::descriptors::audio::UacInterfaceDescriptor::SelectorUnit1(ref mut ah) => { ah.selector = device.get_descriptor_string(ah.selector_index); } usb::descriptors::audio::UacInterfaceDescriptor::SelectorUnit2(ref mut ah) => { ah.selector = device.get_descriptor_string(ah.selector_index); } usb::descriptors::audio::UacInterfaceDescriptor::ProcessingUnit1( ref mut ah, ) => { ah.channel_names = device.get_descriptor_string(ah.channel_names_index); ah.processing = device.get_descriptor_string(ah.processing_index); } usb::descriptors::audio::UacInterfaceDescriptor::ProcessingUnit2( ref mut ah, ) => { ah.channel_names = device.get_descriptor_string(ah.channel_names_index); ah.processing = device.get_descriptor_string(ah.processing_index); } usb::descriptors::audio::UacInterfaceDescriptor::EffectUnit2(ref mut ah) => { ah.effect = device.get_descriptor_string(ah.effect_index); } usb::descriptors::audio::UacInterfaceDescriptor::FeatureUnit1(ref mut ah) => { ah.feature = device.get_descriptor_string(ah.feature_index); } usb::descriptors::audio::UacInterfaceDescriptor::FeatureUnit2(ref mut ah) => { ah.feature = device.get_descriptor_string(ah.feature_index); } usb::descriptors::audio::UacInterfaceDescriptor::ExtensionUnit1(ref mut ah) => { ah.channel_names = device.get_descriptor_string(ah.channel_names_index); ah.extension = device.get_descriptor_string(ah.extension_index); } usb::descriptors::audio::UacInterfaceDescriptor::ExtensionUnit2(ref mut ah) => { ah.channel_names = device.get_descriptor_string(ah.channel_names_index); ah.extension = device.get_descriptor_string(ah.extension_index); } usb::descriptors::audio::UacInterfaceDescriptor::ClockSource2(ref mut ah) => { ah.clock_source = device.get_descriptor_string(ah.clock_source_index); } usb::descriptors::audio::UacInterfaceDescriptor::ClockSelector2(ref mut ah) => { ah.clock_selector = device.get_descriptor_string(ah.clock_selector_index); } usb::descriptors::audio::UacInterfaceDescriptor::ClockMultiplier2( ref mut ah, ) => { ah.clock_multiplier = device.get_descriptor_string(ah.clock_multiplier_index); } usb::descriptors::audio::UacInterfaceDescriptor::SampleRateConverter2( ref mut ah, ) => { ah.src = device.get_descriptor_string(ah.src_index); } _ => (), }, usb::ClassDescriptor::Video(ref mut vd, _) => match vd.interface { usb::descriptors::video::UvcInterfaceDescriptor::InputTerminal(ref mut vh) => { vh.terminal = device.get_descriptor_string(vh.terminal_index); } usb::descriptors::video::UvcInterfaceDescriptor::OutputTerminal(ref mut vh) => { vh.terminal = device.get_descriptor_string(vh.terminal_index); } usb::descriptors::video::UvcInterfaceDescriptor::SelectorUnit(ref mut vh) => { vh.selector = device.get_descriptor_string(vh.selector_index); } usb::descriptors::video::UvcInterfaceDescriptor::ProcessingUnit(ref mut vh) => { vh.processing = device.get_descriptor_string(vh.processing_index); } usb::descriptors::video::UvcInterfaceDescriptor::ExtensionUnit(ref mut vh) => { vh.extension = device.get_descriptor_string(vh.extension_index); } usb::descriptors::video::UvcInterfaceDescriptor::EncodingUnit(ref mut vh) => { vh.encoding = device.get_descriptor_string(vh.encoding_index); } _ => (), }, _ => (), }, _ => (), } Ok(dt) } /// Build [`usb::Descriptor`]s from extra bytes of a Configuration Descriptor fn build_config_descriptor_extra( &self, device: &T, mut raw: Vec, ) -> Result> { let extra_len = raw.len(); let mut taken = 0; let mut ret = Vec::new(); // Iterate on chunks of the header length while taken < extra_len && extra_len >= 2 { let dt_len = raw[0] as usize; let dt = self.build_descriptor_extra::( device, None, None, &raw.drain(..dt_len).collect::>(), )?; log::debug!("{device:?} Config descriptor extra: {dt:?}"); ret.push(dt); taken += dt_len; } Ok(ret) } /// Build [`usb::Descriptor`]s from extra bytes of an Interface Descriptor fn build_interface_descriptor_extra + Copy>( &self, device: &T, class_code: usb::ClassCodeTriplet, interface_number: u8, mut raw: Vec, ) -> Result> { let extra_len = raw.len(); let mut taken = 0; let mut ret = Vec::new(); // Iterate on chunks of the header length while taken < extra_len && extra_len >= 2 { let dt_len = raw[0] as usize; let dt = self.build_descriptor_extra( device, Some(class_code), Some(interface_number), &raw.drain(..dt_len).collect::>(), )?; log::debug!("{device:?} Interface descriptor extra: {dt:?}"); ret.push(dt); taken += dt_len; } Ok(ret) } /// Build [`usb::Descriptor`]s from extra bytes of an Endpoint Descriptor fn build_endpoint_descriptor_extra + Copy>( &self, device: &T, class_code: usb::ClassCodeTriplet, interface_number: u8, mut raw: Vec, ) -> Result>> { let extra_len = raw.len(); let mut taken = 0; let mut ret = Vec::new(); // Iterate on chunks of the header length while taken < extra_len && extra_len >= 2 { let dt_len = raw[0] as usize; let dt = self.build_descriptor_extra( device, Some(class_code), Some(interface_number), &raw.drain(..dt_len).collect::>(), )?; log::debug!("{device:?} Endpoint descriptor extra: {dt:?}"); ret.push(dt); taken += dt_len; } Ok(Some(ret)) } /// Get [`Device`]s connected to the host, excluding root hubs fn get_devices(&mut self, with_extra: bool) -> Result>; /// Get root hubs connected to the host as [`Device`]s /// /// root hubs are pseudo devices and not always listed in the device list, so this is a separate function to get them. The data is used to help create [`Bus`]es; root hubs are an abstraction over Host Controller information. fn get_root_hubs(&mut self) -> Result>; /// Get the [`Bus`]s connected to the host for building the [`SystemProfile`] fn get_buses(&mut self) -> Result>; /// Create a new [`Bus`] from a root hub [`Device`] fn new_sp_bus(&self, bus_number: u8, root_hub: Option) -> Bus { root_hub .map(|rh| { rh.try_into().unwrap_or_else(|e| { log::warn!("Failed to convert root hub to Bus: {e:?}"); Bus::from(bus_number) }) }) .unwrap_or(Bus::from(bus_number)) } /// Build the [`SystemProfile`] from the Profiler get_devices and get_root_hubs (for buses) functions fn get_spusb(&mut self, with_extra: bool) -> Result { let mut spusb = SystemProfile { buses: Vec::new() }; log::info!("Building SystemProfile with {self:?}"); // temporary store of devices created when iterating through DeviceList let mut cache = self.get_devices(with_extra)?; cache.sort_by_key(|d| d.location_id.bus); log::trace!("Sorted devices {cache:#?}"); // get system buses let mut buses = self.get_buses()?; log::trace!("Buses {buses:#?}"); // group by bus number and then stick them into a bus in the returned SystemProfile for (key, group) in &cache.into_iter().group_by(|d| d.location_id.bus) { // create the bus if missing, we'll add devices at next step let mut new_bus = buses.remove(&key).unwrap_or(Bus::from(key)); // group into parent groups with parent path as key or trunk devices so they end up in same place let parent_groups = group.group_by(|d| d.parent_port_path().unwrap_or(d.trunk_port_path())); // now go through parent paths inserting devices owned by that parent // this is not perfect...if the sort of devices does not result in order of depth, it will panic because the parent of a device will not exist. But that won't happen, right... // sort key - ends_with to ensure root_hubs, which will have same str length as trunk devices will still be ahead for (parent_path, children) in parent_groups.into_iter().sorted_by_key(|x| x.0.depth()) { // if root devices, add them to bus if parent_path.is_root_hub() { // if parent_path == "-" { let devices = std::mem::take(&mut new_bus.devices); if let Some(mut d) = devices { for new_device in children { d.push(new_device); } new_bus.devices = Some(d); } else { new_bus.devices = Some(children.collect()); } // else find and add parent - this should work because we are sorted to accend the tree so parents should be created before their children } else { let parent_node = new_bus .get_node_mut(&parent_path) .expect("Parent node does not exist in new bus!"); let devices = std::mem::take(&mut parent_node.devices); if let Some(mut d) = devices { for new_device in children { d.push(new_device); } parent_node.devices = Some(d); } else { parent_node.devices = Some(children.collect()); } } } spusb.buses.push(new_bus); } // add empty buses if missing if !buses.is_empty() { for (_, bus) in buses { spusb.buses.push(bus); } spusb.buses.sort_by_key(|b| b.usb_bus_number); } Ok(spusb) } /// Fills a passed mutable `spusb` reference to fill using `get_spusb`. Will replace existing [`Device`]s found in the Profiler tree but leave others and the buses. /// /// The main use case for this is to merge with macOS `system_profiler` data, so that [`usb::DeviceExtra`] can be obtained but internal buses kept. One could also use it to update a static .json dump. fn fill_spusb(&mut self, spusb: &mut SystemProfile) -> Result<()> { let libusb_spusb = self.get_spusb(true)?; // merge if passed has any buses if !spusb.buses.is_empty() { for mut bus in libusb_spusb.buses { if let Some(existing) = spusb .buses .iter_mut() .find(|b| b.get_bus_number() == bus.get_bus_number()) { // just take the devices and put them in since nusb/libusb will be more verbose // bus macOS profiler will have accurate bus information existing.devices = std::mem::take(&mut bus.devices); } } } Ok(()) } } /// Get a USB device attribute String from sysfs on Linux #[allow(unused_variables)] fn get_sysfs_string(sysfs_name: &str, attr: &str) -> Option { log::trace!("Getting sysfs string at {sysfs_name}/{attr}"); #[cfg(any(target_os = "linux", target_os = "android"))] return std::fs::read_to_string(format!("{SYSFS_USB_PREFIX}{sysfs_name}/{attr}")) .ok() .map(|s| s.trim().to_string()); #[cfg(not(any(target_os = "linux", target_os = "android")))] return None; } #[allow(unused_variables)] fn get_sysfs_readlink(sysfs_name: &str, attr: &str) -> Option { #[cfg(any(target_os = "linux", target_os = "android"))] { // switch based on root_hub - if it is a root hub, we need to go up a directory to get the pci driver // https://github.com/gregkh/usbutils/blob/cda6883cade6ec67671d0c7de61e70eb992509a9/lsusb-t.c#L434 let path = if sysfs_name.starts_with("usb") && attr == "driver" { format!("{SYSFS_USB_PREFIX}{sysfs_name}/../{attr}") } else { format!("{SYSFS_USB_PREFIX}{sysfs_name}/{attr}") }; log::trace!("readlink at {path}"); std::fs::read_link(path) .ok() .and_then(|s| s.file_name().map(|f| f.to_string_lossy().to_string())) } #[cfg(not(any(target_os = "linux", target_os = "android")))] return None; } /// Get the USB driver name from udev on Linux if the feature is enabled #[allow(unused_variables)] fn get_udev_driver_name(port_path: &str) -> Result> { #[cfg(all(target_os = "linux", any(feature = "udev", feature = "udevlib")))] return udev::get_udev_driver_name(port_path); #[cfg(not(all(target_os = "linux", any(feature = "udev", feature = "udevlib"))))] return Ok(None); } /// Get the USB device syspath from udev on Linux if the feature is enabled #[allow(unused_variables)] fn get_udev_syspath(port_path: &str) -> Result> { #[cfg(all(target_os = "linux", any(feature = "udev", feature = "udevlib")))] return udev::get_udev_syspath(port_path); #[cfg(not(all(target_os = "linux", any(feature = "udev", feature = "udevlib"))))] return Ok(None); } /// Get the USB device syspath based on the default location "/sys/bus/usb/devices" on Linux #[allow(unused_variables)] fn get_syspath(port_path: &str) -> Option { #[cfg(any(target_os = "linux", target_os = "android"))] return Some(format!("{SYSFS_USB_PREFIX}{port_path}")); #[cfg(not(any(target_os = "linux", target_os = "android")))] return None; } /// Build [`SystemProfile`] by profiling system. Does not source [`usb::DeviceExtra`] - use [`get_spusb_with_extra`] for that; the extra operation is mostly moving data around so the only hit is to stack. /// /// Runs through [`Profiler::get_devices()`] creating a cache of [`Device`]. Then sorts into parent groups, where the [`Bus`] is created - with root hub information if available from [`Profiler::get_root_hubs()`] - and the tree built. /// /// The function will call which library is available based on the features enabled: 'nusb' or 'libusb'. If neither are enabled, it will return an error.If both are enabled, it will default to 'nusb'. /// /// Bus data on Windows is only available with 'nusb', and on this bus numbers are created in order of appearance since it is not a concept in the Windows USB stack. pub fn get_spusb() -> Result { #[cfg(all(feature = "libusb", not(feature = "nusb")))] { let mut profiler = libusb::LibUsbProfiler; >>::get_spusb( &mut profiler, false, ) } #[cfg(feature = "nusb")] { let mut profiler = nusb::NusbProfiler::new(); profiler.get_spusb(true) } #[cfg(all(not(feature = "libusb"), not(feature = "nusb")))] { Err(crate::error::Error::new( crate::error::ErrorKind::Unsupported, "nusb or libusb feature is required to do this, install with `cargo install --features nusb/libusb`", )) } } /// Build [`SystemProfile`] including [`usb::DeviceExtra`] - the main function to use for most use cases unless one does not want verbose data. The extra data requires opening the device to read device descriptors. /// /// See [`Profiler::get_spusb()`] for more information. pub fn get_spusb_with_extra() -> Result { #[cfg(all(feature = "libusb", not(feature = "nusb")))] { let mut profiler = libusb::LibUsbProfiler; >>::get_spusb( &mut profiler, true, ) } #[cfg(feature = "nusb")] { let mut profiler = nusb::NusbProfiler::new(); profiler.get_spusb(true) } #[cfg(all(not(feature = "libusb"), not(feature = "nusb")))] { Err(crate::error::Error::new( crate::error::ErrorKind::Unsupported, "nusb or libusb feature is required to do this, install with `cargo install --features nusb/libusb`", )) } } #[cfg(target_os = "windows")] mod platform { use super::*; use std::ffi::{OsStr, OsString}; /// Parse VID, PID, revision, subsys and ID from a Host Controller ID: https://learn.microsoft.com/en-us/windows-hardware/drivers/install/identifiers-for-pci-devices /// /// The subsys is a 32-bit value with SID in the high 16 bits and CID in the low 16 bits. fn parse_host_controller_id(s: &OsStr) -> Option<(u16, u16, u8, u32, Option)> { let s = s.to_str()?; let s = s.strip_prefix("PCI\\VEN_")?; let vid = u16::from_str_radix(s.get(0..4)?, 16).ok()?; let s = s.get(4..)?.strip_prefix("&DEV_")?; let pid = u16::from_str_radix(s.get(0..4)?, 16).ok()?; let s = s.get(4..)?.strip_prefix("&SUBSYS_")?; let sidcid = u32::from_str_radix(s.get(0..8)?, 16).ok()?; let s = s.get(8..)?.strip_prefix("&REV_")?; let rev = u8::from_str_radix(s.get(0..2)?, 16).ok()?; let id = s.get(2..)?.strip_prefix("\\").map(|s| s.to_owned()); Some((vid, pid, rev, sidcid, id)) } pub(crate) fn pci_info_from_parent(pci_path: &OsStr) -> Option { let pci_id = parse_host_controller_id(pci_path)?; Some(PciInfo { vendor_id: pci_id.0, product_id: pci_id.1, revision: pci_id.2 as u16, }) } pub(crate) fn pci_info_from_device(device: &Device) -> Option { device .serial_num .as_ref() .and_then(|s| pci_info_from_parent(&OsString::from(s))) } #[cfg(feature = "nusb")] pub(crate) fn pci_info_from_bus(bus_info: &::nusb::BusInfo) -> Option { pci_info_from_parent(bus_info.parent_instance_id()) } #[cfg(feature = "nusb")] pub(crate) fn from(bus: &::nusb::BusInfo) -> Bus { if let Some(pci_info) = platform::pci_info_from_bus(bus) { let (host_controller_vendor, host_controller_device) = match pci_ids::Device::from_vid_pid(pci_info.vendor_id, pci_info.product_id) { Some(d) => ( Some(d.vendor().name().to_string()), Some(d.name().to_string()), ), None => (None, None), }; Bus { usb_bus_number: None, name: bus.system_name().map(|s| s.to_string()).unwrap_or_default(), host_controller: bus.parent_instance_id().to_string_lossy().to_string(), host_controller_vendor, host_controller_device, pci_vendor: Some(pci_info.vendor_id), pci_device: Some(pci_info.product_id), pci_revision: Some(pci_info.revision), id: bus.bus_id().to_string(), ..Default::default() } } else { Bus { usb_bus_number: None, name: bus.system_name().map(|s| s.to_string()).unwrap_or_default(), host_controller: bus.parent_instance_id().to_string_lossy().to_string(), id: bus.bus_id().to_string(), ..Default::default() } } } #[test] fn test_parse_host_controller_id() { assert_eq!(parse_host_controller_id(OsStr::new("")), None); assert_eq!( parse_host_controller_id(OsStr::new( "PCI\\VEN_8086&DEV_2658&SUBSYS_04001AB8&REV_02\\3&11583659&0&E8" )), Some(( 0x8086, 0x2658, 2, 0x04001AB8, Some("3&11583659&0&E8".to_string()) )) ); assert_eq!( parse_host_controller_id(OsStr::new("PCI\\VEN_8086&DEV_2658")), None ); assert_eq!( parse_host_controller_id(OsStr::new("PCI\\VEN_8086&DEV_2658&SUBSYS_04001AB8&REV_02")), Some((0x8086, 0x2658, 2, 0x04001AB8, None)) ); } } #[cfg(any(target_os = "linux", target_os = "android"))] mod platform { use super::*; use std::fs; use std::path::PathBuf; use std::str::FromStr; // SysfsPath, parsing etc is taken from nusb crate (since not pub) and modified for our use #[derive(Debug, Clone)] struct SysfsPath(pub(crate) PathBuf); impl SysfsPath { pub(crate) fn exists(&self) -> bool { self.0.exists() } fn parse_attr(&self, attr: &str, parse: impl FnOnce(&str) -> Result) -> Result { let attr_path = self.0.join(attr); fs::read_to_string(&attr_path) .map_err(|e| Error::new(ErrorKind::Io, &e.to_string())) .and_then(|v| parse(v.trim())) } pub(crate) fn read_attr(&self, attr: &str) -> Result { self.parse_attr(attr, |s| { s.parse().map_err(|_| { Error::new(ErrorKind::Parsing, &format!("Failed to parse attr: {attr}")) }) }) } fn read_attr_hex(&self, attr: &str) -> Result { self.parse_attr(attr, |s| T::from_hex_str(s.strip_prefix("0x").unwrap_or(s))) } fn children(&self) -> impl Iterator { fs::read_dir(&self.0) .ok() .into_iter() .flatten() .filter_map(|f| f.ok()) .filter(|f| f.file_type().ok().is_some_and(|t| t.is_dir())) .map(|f| SysfsPath(f.path())) } } trait FromHexStr: Sized { fn from_hex_str(s: &str) -> Result; } impl FromHexStr for u8 { fn from_hex_str(s: &str) -> Result { u8::from_str_radix(s, 16).map_err(|_| Error::new(ErrorKind::Parsing, s)) } } impl FromHexStr for u16 { fn from_hex_str(s: &str) -> Result { u16::from_str_radix(s, 16).map_err(|_| Error::new(ErrorKind::Parsing, s)) } } impl std::fmt::Display for SysfsPath { fn fmt(&self, f: &mut std::fmt::Formatter) -> std::fmt::Result { self.0.display().fmt(f) } } impl From<&str> for SysfsPath { fn from(s: &str) -> Self { SysfsPath(PathBuf::from(s)) } } impl From for SysfsPath { fn from(s: String) -> Self { SysfsPath(PathBuf::from(s)) } } impl From for SysfsPath { fn from(p: PathBuf) -> Self { SysfsPath(p) } } impl std::ops::Deref for SysfsPath { type Target = PathBuf; fn deref(&self) -> &Self::Target { &self.0 } } impl From for PathBuf { fn from(s: SysfsPath) -> Self { s.0 } } fn pci_info_from_parent(pci_path: &SysfsPath) -> Option { Some(PciInfo { vendor_id: pci_path.read_attr_hex("vendor").ok()?, product_id: pci_path.read_attr_hex("device").ok()?, revision: pci_path.read_attr_hex("revision").ok()?, }) } pub(crate) fn pci_info_from_device(device: &Device) -> Option { device.serial_num.as_ref().and_then(|s| { let pci_path = SysfsPath::from(PathBuf::from(SYSFS_PCI_PREFIX).join(s)); log::debug!("Probing device {pci_path:?}"); pci_info_from_parent(&pci_path) }) } #[cfg(feature = "nusb")] pub(crate) fn pci_info_from_bus(bus_info: &::nusb::BusInfo) -> Option { let path = bus_info.sysfs_path(); let parent_path = path .parent() .and_then(|p| p.to_str()) .map(|s| s.to_string())?; let pci_path = SysfsPath::from(PathBuf::from(SYSFS_PCI_PREFIX).join(parent_path)); log::debug!("Probing bus parent device {pci_path:?}"); pci_info_from_parent(&pci_path) } #[cfg(feature = "nusb")] pub(crate) fn from(bus: &::nusb::BusInfo) -> Bus { if let Some(pci_info) = platform::pci_info_from_bus(bus) { let (host_controller_vendor, host_controller_device) = match pci_ids::Device::from_vid_pid(pci_info.vendor_id, pci_info.product_id) { Some(d) => ( Some(d.vendor().name().to_string()), Some(d.name().to_string()), ), None => (None, None), }; Bus { usb_bus_number: Some(bus.bus_id().parse::().expect( "Failed to parse bus_id: Linux bus_id should be a decimal string and not None", )), name: bus.system_name().map(|s| s.to_string()).unwrap_or_default(), host_controller: bus .root_hub() .manufacturer_string() .map(|s| s.to_string()) .unwrap_or_default(), host_controller_vendor, host_controller_device, pci_vendor: Some(pci_info.vendor_id), pci_device: Some(pci_info.product_id), pci_revision: Some(pci_info.revision), ..Default::default() } } else { Bus { usb_bus_number: Some(bus.bus_id().parse::().expect( "Failed to parse bus_id: Linux bus_id should be a decimal string and not None", )), name: bus.system_name().map(|s| s.to_string()).unwrap_or_default(), host_controller: bus .root_hub() .manufacturer_string() .map(|s| s.to_string()) .unwrap_or_default(), ..Default::default() } } } } #[cfg(target_os = "macos")] mod platform { use super::*; use macos::HostControllerInfo; impl From for PciInfo { fn from(pci_info: HostControllerInfo) -> Self { PciInfo { vendor_id: pci_info.vendor_id, product_id: pci_info.device_id, revision: pci_info.revision_id, } } } #[allow(unused_variables)] pub(crate) fn pci_info_from_device(device: &Device) -> Option { None } #[cfg(feature = "nusb")] pub(crate) fn pci_info_from_bus(bus_info: &::nusb::BusInfo) -> Option { bus_info .name() .and_then(|name| macos::get_controller(name).ok().map(|c| c.into())) } #[cfg(feature = "nusb")] pub(crate) fn from(bus: &::nusb::BusInfo) -> Bus { if let Some(pci_info) = platform::pci_info_from_bus(bus) { let (host_controller_vendor, host_controller_device) = match pci_ids::Device::from_vid_pid(pci_info.vendor_id, pci_info.product_id) { Some(d) => ( Some(d.vendor().name().to_string()), Some(d.name().to_string()), ), None => (None, None), }; Bus { usb_bus_number: Some(u8::from_str_radix(bus.bus_id(), 16).expect("Failed to parse bus_id: macOS bus_id should be a hexadecimal string and not None")), name: bus.class_name().to_string(), host_controller: bus.provider_class_name().to_string(), host_controller_vendor, host_controller_device, pci_vendor: Some(pci_info.vendor_id), pci_device: Some(pci_info.product_id), pci_revision: Some(pci_info.revision), ..Default::default() } } else { Bus { usb_bus_number: Some(u8::from_str_radix(bus.bus_id(), 16).expect("Failed to parse bus_id: macOS bus_id should be a hexadecimal string and not None")), name: bus.class_name().to_string(), host_controller: bus.provider_class_name().to_string(), ..Default::default() } } } } cyme-2.2.6/src/profiler/000077500000000000000000000000001506545537300151045ustar00rootroot00000000000000cyme-2.2.6/src/profiler/libusb.rs000066400000000000000000000652541506545537300167460ustar00rootroot00000000000000//! Uses rusb (upto date libusb fork) to get system USB information - same lib as lsusb. Requires 'libusb' feature. Uses [`crate::profiler::types`] types to hold data so that it is cross-compatible with macOS system_profiler command. use super::*; use crate::error::{Error, ErrorKind}; use crate::lsusb::names; use crate::types::NumericalUnit; use rusb as libusb; use usb_ids::{self, FromId}; #[derive(Debug)] pub(crate) struct LibUsbProfiler; pub(crate) struct UsbDevice { handle: libusb::DeviceHandle, language: libusb::Language, vidpid: (u16, u16), location: DeviceLocation, timeout: std::time::Duration, } impl std::fmt::Debug for UsbDevice { fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result { write!( f, "UsbDevice {{ vidpid: {:#04x}:{:#04x}, location: {:?} }}", self.vidpid.0, self.vidpid.1, self.location ) } } /// Set log level for rusb pub fn set_log_level(debug: u8) { let log_level = match debug { 0 => rusb::LogLevel::None, 1 => rusb::LogLevel::Warning, 2 => rusb::LogLevel::Info, _ => rusb::LogLevel::Debug, }; rusb::set_log_level(log_level); } impl ControlRequest { fn get_request_type_in(&self) -> u8 { libusb::request_type( libusb::Direction::In, self.control_type.into(), self.recipient.into(), ) } } impl From for libusb::RequestType { fn from(ct: ControlType) -> Self { match ct { ControlType::Standard => libusb::RequestType::Standard, ControlType::Class => libusb::RequestType::Class, ControlType::Vendor => libusb::RequestType::Vendor, } } } impl From for libusb::Recipient { fn from(r: Recipient) -> Self { match r { Recipient::Device => libusb::Recipient::Device, Recipient::Interface => libusb::Recipient::Interface, Recipient::Endpoint => libusb::Recipient::Endpoint, Recipient::Other => libusb::Recipient::Other, } } } impl From for Error { fn from(error: libusb::Error) -> Self { Error { kind: ErrorKind::LibUSB, message: format!( "Failed to gather system USB data from libusb: Error({})", &error.to_string() ), } } } /// Covert to our crate speed impl From for usb::Speed { fn from(libusb: libusb::Speed) -> Self { match libusb { libusb::Speed::SuperPlus => usb::Speed::SuperSpeedPlus, libusb::Speed::Super => usb::Speed::SuperSpeed, libusb::Speed::High => usb::Speed::HighSpeed, libusb::Speed::Full => usb::Speed::FullSpeed, libusb::Speed::Low => usb::Speed::LowSpeed, _ => usb::Speed::Unknown, } } } impl From for usb::Direction { fn from(libusb: libusb::Direction) -> Self { match libusb { libusb::Direction::Out => usb::Direction::Out, libusb::Direction::In => usb::Direction::In, } } } impl From for usb::TransferType { fn from(libusb: libusb::TransferType) -> Self { match libusb { libusb::TransferType::Control => usb::TransferType::Control, libusb::TransferType::Isochronous => usb::TransferType::Isochronous, libusb::TransferType::Bulk => usb::TransferType::Bulk, libusb::TransferType::Interrupt => usb::TransferType::Interrupt, } } } impl From for usb::UsageType { fn from(libusb: libusb::UsageType) -> Self { match libusb { libusb::UsageType::Data => usb::UsageType::Data, libusb::UsageType::Feedback => usb::UsageType::Feedback, libusb::UsageType::FeedbackData => usb::UsageType::FeedbackData, libusb::UsageType::Reserved => usb::UsageType::Reserved, } } } impl From for usb::SyncType { fn from(libusb: libusb::SyncType) -> Self { match libusb { libusb::SyncType::NoSync => usb::SyncType::None, libusb::SyncType::Asynchronous => usb::SyncType::Asynchronous, libusb::SyncType::Adaptive => usb::SyncType::Adaptive, libusb::SyncType::Synchronous => usb::SyncType::Synchronous, } } } impl From for usb::Version { fn from(libusb: libusb::Version) -> Self { usb::Version(libusb.major(), libusb.minor(), libusb.sub_minor()) } } /// Attempt to retrieve the current bConfigurationValue and iConfiguration for a device /// This will only return the current configuration, not all possible configurations /// If there are any failures in retrieving the data, None is returned #[allow(unused_variables)] fn get_sysfs_configuration_string(sysfs_name: &str) -> Option<(u8, String)> { #[cfg(target_os = "linux")] // Determine bConfigurationValue value on linux match get_sysfs_string(sysfs_name, "bConfigurationValue") { Some(s) => match s.parse::() { Ok(v) => { // Determine iConfiguration get_sysfs_string(sysfs_name, "configuration").map(|s| (v, s)) } Err(_) => None, }, None => None, } #[cfg(not(target_os = "linux"))] None } impl UsbOperations for UsbDevice { /// Get string descriptor from device /// /// Returns None if string_index is 0 - reserved for language codes fn get_descriptor_string(&self, string_index: u8) -> Option { if string_index == 0 { return None; } self.handle .read_string_descriptor(self.language, string_index, self.timeout) .map(|s| s.trim().trim_end_matches('\0').to_string()) .ok() } /// Get control message from device, ensuring message of [`ControlRequest`] length is read fn get_control_msg(&self, control_request: ControlRequest) -> Result> { let mut buf = vec![0; control_request.length]; if control_request.claim_interface { self.handle.claim_interface(control_request.index as u8)?; } let n = self .handle .read_control( control_request.get_request_type_in(), control_request.request, control_request.value, control_request.index, &mut buf, self.timeout, ) .map_err(|e| Error { kind: ErrorKind::LibUSB, message: format!("Failed to get control message: {e}"), })?; if n < control_request.length { log::warn!( "Failed to read full control message for {}: {} < {}", control_request.request, n, control_request.length ); Err(Error { kind: ErrorKind::LibUSB, message: "Control message too short".to_string(), }) } else { Ok(buf) } } } impl LibUsbProfiler { fn build_endpoints( &self, handle: &UsbDevice, interface_path: &usb::DevicePath, interface_desc: &libusb::InterfaceDescriptor, ) -> Vec { let mut ret: Vec = Vec::new(); for endpoint_desc in interface_desc.endpoint_descriptors() { let extra_desc = if let Some(extra) = endpoint_desc.extra() { self.build_endpoint_descriptor_extra( handle, ( interface_desc.class_code(), interface_desc.sub_class_code(), interface_desc.protocol_code(), ), interface_desc.interface_number(), extra.to_vec(), ) .ok() .flatten() } else { None }; let endpoint_path = usb::EndpointPath::new_with_device_path( interface_path.to_owned(), endpoint_desc.number(), ); ret.push(usb::Endpoint { address: usb::EndpointAddress { address: endpoint_desc.address(), number: endpoint_desc.number(), direction: usb::Direction::from(endpoint_desc.direction()), }, transfer_type: usb::TransferType::from(endpoint_desc.transfer_type()), sync_type: usb::SyncType::from(endpoint_desc.sync_type()), usage_type: usb::UsageType::from(endpoint_desc.usage_type()), max_packet_size: endpoint_desc.max_packet_size(), interval: endpoint_desc.interval(), length: endpoint_desc.length(), extra: extra_desc, internal: InternalData::default(), endpoint_path: Some(endpoint_path), }); } ret } fn build_interfaces( &self, handle: &UsbDevice, config_desc: &libusb::ConfigDescriptor, ) -> Result> { let mut ret: Vec = Vec::new(); for interface in config_desc.interfaces() { for interface_desc in interface.descriptors() { let device_path = usb::DevicePath::new_with_port_path( handle.location.clone().into(), Some(config_desc.number()), Some(interface_desc.interface_number()), Some(interface_desc.setting_number()), ); let path = device_path.to_string(); let interface = usb::Interface { name: get_sysfs_string(&path, "interface").or_else(|| { interface_desc .description_string_index() .and_then(|i| handle.get_descriptor_string(i)) }), string_index: interface_desc.description_string_index().unwrap_or(0), number: interface_desc.interface_number(), class: usb::BaseClass::from(interface_desc.class_code()), sub_class: interface_desc.sub_class_code(), protocol: interface_desc.protocol_code(), alt_setting: interface_desc.setting_number(), driver: get_sysfs_readlink(&path, "driver") .or_else(|| get_udev_driver_name(&path).ok().flatten()), syspath: get_syspath(&path).or_else(|| get_udev_syspath(&path).ok().flatten()), path, length: interface_desc.length(), endpoints: self.build_endpoints(handle, &device_path, &interface_desc), extra: self .build_interface_descriptor_extra( handle, ( interface_desc.class_code(), interface_desc.sub_class_code(), interface_desc.protocol_code(), ), interface_desc.interface_number(), interface_desc.extra().to_vec(), ) .ok(), internal: InternalData::default(), device_path: Some(device_path), }; ret.push(interface); } } Ok(ret) } fn build_configurations( &self, device: &libusb::Device, handle: &UsbDevice, device_desc: &libusb::DeviceDescriptor, sp_device: &Device, ) -> Result> { // Retrieve the current configuration (if available) let cur_config = get_sysfs_configuration_string(&sp_device.sysfs_name()); let mut ret: Vec = Vec::new(); for n in 0..device_desc.num_configurations() { let config_desc = match device.config_descriptor(n) { Ok(c) => c, Err(_) => continue, }; let mut attributes = Vec::new(); if config_desc.remote_wakeup() { attributes.push(usb::ConfigAttributes::RemoteWakeup); } if config_desc.self_powered() { attributes.push(usb::ConfigAttributes::SelfPowered); } else { attributes.push(usb::ConfigAttributes::BusPowered); } // Check if we have a cached iConfiguration string let config_name = if let Some((config_num, ref config_name)) = cur_config { // Configs start from 1, not 0 if config_num - 1 == n { Some(config_name.clone()) } else { None } } else { None }; ret.push(usb::Configuration { name: config_desc .description_string_index() .and_then(|i| handle.get_descriptor_string(i)) .or(config_name) .unwrap_or(String::new()), string_index: config_desc.description_string_index().unwrap_or(0), number: config_desc.number(), attributes, max_power: NumericalUnit { value: config_desc.max_power() as u32, unit: String::from("mA"), description: None, }, length: config_desc.length(), total_length: config_desc.total_length(), interfaces: self.build_interfaces(handle, &config_desc)?, extra: self .build_config_descriptor_extra(handle, config_desc.extra().to_vec()) .ok(), internal: Default::default(), }); } Ok(ret) } #[allow(unused_variables)] fn build_spdevice_extra( &self, device: &libusb::Device, handle: &UsbDevice, device_desc: &libusb::DeviceDescriptor, sp_device: &mut Device, ) -> Result { // attempt to get manufacturer and product strings from device itself sp_device.manufacturer = device_desc .manufacturer_string_index() .and_then(|i| handle.get_descriptor_string(i)); if let Some(name) = device_desc .product_string_index() .and_then(|i| handle.get_descriptor_string(i)) { sp_device.name = name; } sp_device.serial_num = device_desc .serial_number_string_index() .and_then(|i| handle.get_descriptor_string(i)); let sysfs_name = sp_device.sysfs_name(); let mut extra = usb::DeviceExtra { max_packet_size: device_desc.max_packet_size(), string_indexes: ( device_desc.product_string_index().unwrap_or(0), device_desc.manufacturer_string_index().unwrap_or(0), device_desc.serial_number_string_index().unwrap_or(0), ), driver: get_sysfs_readlink(&sysfs_name, "driver") .or_else(|| get_udev_driver_name(&sysfs_name).ok().flatten()), syspath: get_syspath(&sysfs_name) .or_else(|| get_udev_syspath(&sysfs_name).ok().flatten()), // These are idProduct, idVendor in lsusb - from udev_hwdb/usb-ids vendor: names::vendor(device_desc.vendor_id()).or_else(|| { usb_ids::Vendor::from_id(device_desc.vendor_id()).map(|v| v.name().to_owned()) }), product_name: names::product(device_desc.vendor_id(), device_desc.product_id()) .or_else(|| { usb_ids::Device::from_vid_pid(device_desc.vendor_id(), device_desc.product_id()) .map(|v| v.name().to_owned()) }), configurations: self.build_configurations(device, handle, device_desc, sp_device)?, status: Self::get_device_status(handle).ok(), debug: Self::get_debug_descriptor(handle).ok(), binary_object_store: None, qualifier: None, hub: None, negotiated_speed: Some(usb::Speed::from(device.speed())), }; // Get device specific stuff: bos, hub, dualspeed, debug and status if device_desc.usb_version() >= rusb::Version::from_bcd(0x0201) { extra.binary_object_store = Self::get_bos_descriptor(handle).ok(); } if device_desc.usb_version() >= rusb::Version::from_bcd(0x0200) { extra.qualifier = Self::get_device_qualifier(handle).ok(); } if device_desc.class_code() == usb::BaseClass::Hub as u8 { let has_ssp = if let Some(bos) = &extra.binary_object_store { bos.capabilities .iter() .any(|c| matches!(c, usb::descriptors::bos::BosCapability::SuperSpeedPlus(_))) } else { false }; let bcd = sp_device.bcd_usb.map_or(0x0100, |v| v.into()); extra.hub = Self::get_hub_descriptor(handle, device_desc.protocol_code(), bcd, has_ssp).ok(); } Ok(extra) } fn open_device( &self, device: &libusb::Device, device_desc: &libusb::DeviceDescriptor, ) -> Result> { let timeout = std::time::Duration::from_secs(1); let handle = device.open()?; let language = match handle.read_languages(timeout) { Ok(l) => { if l.is_empty() { return Err(Error { kind: ErrorKind::LibUSB, message: format!( "Languages for {device:?} are empty, will be unable to obtain all data" ), }); } l[0] } Err(e) => { return Err(Error { kind: ErrorKind::LibUSB, message: format!( "Could not read languages for {device:?}, will be unable to obtain all data: {e}" ), }); } }; Ok(UsbDevice { handle, language, vidpid: (device_desc.vendor_id(), device_desc.product_id()), location: DeviceLocation { bus: device.bus_number(), number: device.address(), tree_positions: device.port_numbers()?, }, timeout, }) } /// Builds a [`Device`] from a [`libusb::Device`] by using `device_descriptor()` and intrograting for configuration strings. Optionally with `with_extra` will gather full device information, including from udev if feature is present. /// /// [`Device.profiler_error`] `Option` will contain any non-critical error during gather of `with_extra` data - normally due to permissions preventing open of device descriptors. fn build_spdevice( &self, device: &libusb::Device, with_extra: bool, ) -> Result { // TODO: this is actually negotiated speed not device speed // need to read from device descriptor let speed = match usb::Speed::from(device.speed()) { usb::Speed::Unknown => None, v => Some(DeviceSpeed::SpeedValue(v)), }; let device_desc = device.device_descriptor()?; let mut sp_device = Device { vendor_id: Some(device_desc.vendor_id()), product_id: Some(device_desc.product_id()), device_speed: speed, location_id: DeviceLocation { bus: device.bus_number(), number: device.address(), tree_positions: device.port_numbers()?, }, bcd_device: Some(device_desc.device_version().into()), bcd_usb: Some(device_desc.usb_version().into()), class: Some(usb::BaseClass::from(device_desc.class_code())), sub_class: Some(device_desc.sub_class_code()), protocol: Some(device_desc.protocol_code()), last_event: Some(Default::default()), ..Default::default() }; // sysfs cache sp_device.name = get_sysfs_string(&sp_device.sysfs_name(), "product") // udev-hwdb .or_else(|| names::product(device_desc.vendor_id(), device_desc.product_id())) // usb-ids .or_else(|| { usb_ids::Device::from_vid_pid(device_desc.vendor_id(), device_desc.product_id()) .map(|device| device.name().to_owned()) }) // empty .unwrap_or_default(); // sysfs cache sp_device.manufacturer = get_sysfs_string(&sp_device.sysfs_name(), "manufacturer") // udev-hwdb .or_else(|| names::vendor(device_desc.vendor_id())) // udev, usb-ids if error // usb-ids .or_else(|| { usb_ids::Vendor::from_id(device_desc.vendor_id()) .map(|vendor| vendor.name().to_owned()) }); sp_device.serial_num = get_sysfs_string(&sp_device.sysfs_name(), "serial"); if with_extra { if let Ok(handle) = self.open_device(device, &device_desc) { sp_device.profiler_error = { match self.build_spdevice_extra( device, &handle, &device_desc, &mut sp_device, ) { Ok(extra) => { sp_device.extra = Some(extra); None } Err(e) => { Some(format!( "Failed to get some extra data for {sp_device}, probably requires elevated permissions: {e}" )) } } } } else { log::warn!("Failed to open device {device:?} for extra data"); let sysfs_name = sp_device.sysfs_name(); sp_device.profiler_error = Some("Failed to open device for extra data".to_string()); sp_device.extra = Some(usb::DeviceExtra { max_packet_size: device_desc.max_packet_size(), string_indexes: ( device_desc.product_string_index().unwrap_or(0), device_desc.manufacturer_string_index().unwrap_or(0), device_desc.serial_number_string_index().unwrap_or(0), ), driver: get_sysfs_readlink(&sysfs_name, "driver") .or_else(|| get_udev_driver_name(&sysfs_name).ok().flatten()), syspath: get_syspath(&sysfs_name) .or_else(|| get_udev_syspath(&sysfs_name).ok().flatten()), vendor: names::vendor(device_desc.vendor_id()).or_else(|| { usb_ids::Vendor::from_id(device_desc.vendor_id()) .map(|v| v.name().to_owned()) }), product_name: names::product(device_desc.vendor_id(), device_desc.product_id()) .or_else(|| { usb_ids::Device::from_vid_pid( device_desc.vendor_id(), device_desc.product_id(), ) .map(|v| v.name().to_owned()) }), configurations: Vec::new(), status: None, debug: None, binary_object_store: None, qualifier: None, hub: None, negotiated_speed: Some(usb::Speed::from(device.speed())), }); } } Ok(sp_device) } } impl Profiler> for LibUsbProfiler { fn get_devices(&mut self, with_extra: bool) -> Result> { let mut devices = Vec::new(); // run through devices building Device types - not root_hubs (port number 0) for device in libusb::DeviceList::new()? .iter() .filter(|d| d.port_number() != 0) { match self.build_spdevice(&device, with_extra) { Ok(sp_device) => { devices.push(sp_device.to_owned()); let print_stderr = std::env::var_os("CYME_PRINT_NON_CRITICAL_PROFILER_STDERR").is_some(); // print any non-critical error during extra capture sp_device.profiler_error.iter().for_each(|e| { if print_stderr { eprintln!("{e}"); } else { log::warn!("Non-critical error during profile: {e}"); } }); } Err(e) => eprintln!("Failed to get data for {device:?}: {e}"), } } Ok(devices) } #[cfg(target_os = "linux")] fn get_root_hubs(&mut self) -> Result> { let mut ret = HashMap::new(); for device in libusb::DeviceList::new()? .iter() .filter(|d| d.port_number() == 0) { if let Ok(mut sp_device) = self.build_spdevice(&device, true) { // put self in as first device; root_hubs included in list on Linux sp_device.devices = Some(vec![sp_device.clone()]); ret.insert(sp_device.location_id.bus, sp_device); } } Ok(ret) } #[cfg(not(target_os = "linux"))] fn get_root_hubs(&mut self) -> Result> { Ok(HashMap::new()) } fn get_buses(&mut self) -> Result> { >>::get_root_hubs(self).map(|hubs| { hubs.into_iter() .filter_map(|(k, d)| Some((k, Bus::try_from(d).ok()?))) .collect() }) } } pub(crate) fn fill_spusb(spusb: &mut SystemProfile) -> Result<()> { let mut profiler = LibUsbProfiler; >>::fill_spusb(&mut profiler, spusb) } cyme-2.2.6/src/profiler/macos.rs000066400000000000000000000235611506545537300165630ustar00rootroot00000000000000//! macOS specific code for USB device profiling. //! //! Includes parser for macOS `system_profiler` command -json output with SPUSBDataType. Merged with libusb or nusb for extra data. Also includes IOKit functions for obtaining host controller data - helper code taken from [nusb](https://github.com/kevinmehall/nusb). //! //! `system_profiler`: Bus and Device structs are used as deserializers for serde. The JSON output with the -json flag is not really JSON; all values are String regardless of contained data so it requires some extra work. Additionally, some values differ slightly from the non json output such as the speed - it is a description rather than numerical. use super::*; use std::process::Command; use core_foundation::{ base::{CFType, TCFType}, data::CFData, string::CFString, ConcreteCFType, }; use io_kit_sys::{ kIOMasterPortDefault, kIORegistryIterateParents, kIORegistryIterateRecursively, keys::kIOServicePlane, ret::kIOReturnSuccess, IOIteratorNext, IOObjectRelease, IORegistryEntryGetRegistryEntryID, IORegistryEntrySearchCFProperty, IOServiceGetMatchingServices, IOServiceNameMatching, }; pub(crate) struct IoObject(u32); impl IoObject { // Safety: `handle` must be an IOObject handle. Ownership is transferred. pub unsafe fn new(handle: u32) -> IoObject { IoObject(handle) } pub fn get(&self) -> u32 { self.0 } } impl Drop for IoObject { fn drop(&mut self) { unsafe { IOObjectRelease(self.0); } } } pub(crate) struct IoService(IoObject); impl IoService { // Safety: `handle` must be an IOService handle. Ownership is transferred. pub unsafe fn new(handle: u32) -> IoService { IoService(IoObject(handle)) } pub fn get(&self) -> u32 { self.0 .0 } } pub(crate) struct IoServiceIterator(IoObject); impl IoServiceIterator { // Safety: `handle` must be an IoIterator of IoService. Ownership is transferred. pub unsafe fn new(handle: u32) -> IoServiceIterator { IoServiceIterator(IoObject::new(handle)) } } impl Iterator for IoServiceIterator { type Item = IoService; fn next(&mut self) -> Option { unsafe { let handle = IOIteratorNext(self.0.get()); if handle != 0 { Some(IoService::new(handle)) } else { None } } } } pub(crate) struct HostControllerInfo { pub(crate) name: String, pub(crate) class_name: String, pub(crate) io_name: String, pub(crate) registry_id: u64, pub(crate) vendor_id: u16, pub(crate) device_id: u16, pub(crate) revision_id: u16, pub(crate) class_code: u32, pub(crate) subsystem_vendor_id: Option, pub(crate) subsystem_id: Option, } impl std::fmt::Debug for HostControllerInfo { fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result { f.debug_struct("PciControllerInfo") .field("name", &self.name) .field("class_name", &self.class_name) .field("io_name", &self.io_name) .field("registry_id", &format!("{:08x}", self.registry_id)) .field("vendor_id", &format!("{:04x}", self.vendor_id)) .field("device_id", &format!("{:04x}", self.device_id)) .field("revision_id", &format!("{:04x}", self.revision_id)) .field("class_code", &format!("{:08x}", self.class_code)) .field("subsystem_vendor_id", &self.subsystem_vendor_id) .field("subsystem_id", &self.subsystem_id) .finish() } } pub(crate) fn get_registry_id(device: &IoService) -> Option { unsafe { let mut out = 0; let r = IORegistryEntryGetRegistryEntryID(device.get(), &mut out); if r == kIOReturnSuccess { Some(out) } else { // not sure this can actually fail. log::debug!("IORegistryEntryGetRegistryEntryID failed with {r}"); None } } } fn get_property(device: &IoService, property: &'static str) -> Option { unsafe { let cf_property = CFString::from_static_string(property); let raw = IORegistryEntrySearchCFProperty( device.get(), kIOServicePlane as *mut i8, cf_property.as_CFTypeRef() as *const _, std::ptr::null(), kIORegistryIterateRecursively | kIORegistryIterateParents, ); if raw.is_null() { log::debug!("Device does not have property `{property}`"); return None; } let res = CFType::wrap_under_create_rule(raw).downcast_into(); if res.is_none() { log::debug!("Failed to convert device property `{property}`"); } res } } fn get_string_property(device: &IoService, property: &'static str) -> Option { get_property::(device, property).map(|s| s.to_string()) } fn get_byte_array_property(device: &IoService, property: &'static str) -> Option> { let d = get_property::(device, property)?; Some(d.bytes().to_vec()) } fn get_ascii_array_property(device: &IoService, property: &'static str) -> Option { let d = get_property::(device, property)?; Some( d.bytes() .iter() .map(|b| *b as char) .filter(|c| *c != '\0') .collect(), ) } pub(crate) fn probe_controller(device: IoService) -> Option { let registry_id = get_registry_id(&device)?; log::debug!("Probing controller {registry_id:08x}"); // name is a CFData of ASCII characters let name = get_ascii_array_property(&device, "name")?; let class_name = get_string_property(&device, "IOClass")?; let io_name = get_string_property(&device, "IOName")?; let vendor_id = get_byte_array_property(&device, "vendor-id").map(|v| u16::from_le_bytes([v[0], v[1]]))?; let device_id = get_byte_array_property(&device, "device-id").map(|v| u16::from_le_bytes([v[0], v[1]]))?; let revision_id = get_byte_array_property(&device, "revision-id") .map(|v| u16::from_le_bytes([v[0], v[1]]))?; let class_code = get_byte_array_property(&device, "class-code") .map(|v| u32::from_le_bytes([v[0], v[1], v[2], v[3]]))?; let subsystem_vendor_id = get_byte_array_property(&device, "subsystem-vendor-id") .map(|v| u16::from_le_bytes([v[0], v[1]])); let subsystem_id = get_byte_array_property(&device, "subsystem-id").map(|v| u16::from_le_bytes([v[0], v[1]])); Some(HostControllerInfo { name, class_name, io_name, registry_id, vendor_id, device_id, revision_id, class_code, subsystem_vendor_id, subsystem_id, }) } pub(crate) fn get_controller(name: &str) -> Result { unsafe { let dictionary = IOServiceNameMatching(name.as_ptr() as *const i8); if dictionary.is_null() { return Err(Error::new(ErrorKind::IoKit, "IOServiceMatching failed")); } let mut iterator = 0; let r = IOServiceGetMatchingServices(kIOMasterPortDefault, dictionary, &mut iterator); if r != kIOReturnSuccess { return Err(Error::new(ErrorKind::IoKit, &r.to_string())); } IoServiceIterator::new(iterator) .next() .and_then(probe_controller) .ok_or(Error::new( ErrorKind::IoKit, &format!("No controller found for {name}"), )) } } /// Runs the system_profiler command for SPUSBDataType and parses the json stdout into a [`SystemProfile`]. /// /// Ok result not contain [`usb::DeviceExtra`] because system_profiler does not provide this. Use `get_spusb_with_extra` to combine with libusb output for [`Device`]s with `extra` pub fn get_spusb() -> Result { let output = Command::new("system_profiler") .args(["-timeout", "5", "-json", "SPUSBDataType"]) .output()?; if output.status.success() { serde_json::from_str(String::from_utf8(output.stdout)?.as_str()) .map_err(|e| { Error::new( ErrorKind::Parsing, &format!("Failed to parse 'system_profiler -json SPUSBDataType'; Error({e})"), ) // map to get pci.ids host controller data }) .map(|mut sp: SystemProfile| { for bus in sp.buses.iter_mut() { bus.fill_host_controller_from_ids(); } sp }) } else { log::error!( "system_profiler returned non-zero stderr: {:?}, stdout: {:?}", String::from_utf8(output.stderr)?, String::from_utf8(output.stdout)? ); Err(Error::new( ErrorKind::SystemProfiler, "system_profiler returned non-zero, use '--force-libusb' to bypass", )) } } /// Runs `get_spusb` and then adds in data obtained from libusb. Requires 'libusb' feature. /// /// `system_profiler` captures Apple buses (essentially root_hubs) that are not captured by libusb (but are captured by nusb); this method merges the two to so the bus information is kept. pub fn get_spusb_with_extra() -> Result { #[cfg(all(feature = "libusb", not(feature = "nusb")))] { get_spusb().and_then(|mut spusb| { crate::profiler::libusb::fill_spusb(&mut spusb)?; Ok(spusb) }) } #[cfg(feature = "nusb")] { get_spusb().and_then(|mut spusb| { crate::profiler::nusb::fill_spusb(&mut spusb)?; Ok(spusb) }) } #[cfg(all(not(feature = "libusb"), not(feature = "nusb")))] { Err(Error::new( ErrorKind::Unsupported, "nusb or libusb feature is required to do this, install with `cargo install --features nusb/libusb`", )) } } cyme-2.2.6/src/profiler/nusb.rs000066400000000000000000001006541506545537300164270ustar00rootroot00000000000000//! Uses nusb (pure Rust) to get system USB information. Requires 'nusb' feature. Uses [`crate::profiler::types`] types to hold data so that it is cross-compatible with macOS system_profiler command. use super::*; use crate::error::{Error, ErrorKind}; use crate::lsusb::names; use crate::types::NumericalUnit; use ::nusb::{self, MaybeFuture}; use usb_ids::{self, FromId}; #[derive(Debug)] pub(crate) struct NusbProfiler { #[cfg(target_os = "windows")] bus_id_map: HashMap, } pub(crate) struct UsbDevice { handle: nusb::Device, language: u16, vidpid: (u16, u16), location: DeviceLocation, timeout: std::time::Duration, } impl std::fmt::Debug for UsbDevice { fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result { write!( f, "UsbDevice {{ vidpid: {:#04x}:{:#04x}, location: {:?} }}", self.vidpid.0, self.vidpid.1, self.location ) } } impl From for nusb::transfer::ControlIn { fn from(request: ControlRequest) -> Self { nusb::transfer::ControlIn { control_type: request.control_type.into(), request: request.request, value: request.value, index: request.index, recipient: request.recipient.into(), length: request.length as u16, } } } impl From for nusb::transfer::ControlType { fn from(control: ControlType) -> Self { match control { ControlType::Standard => nusb::transfer::ControlType::Standard, ControlType::Class => nusb::transfer::ControlType::Class, ControlType::Vendor => nusb::transfer::ControlType::Vendor, } } } impl From for nusb::transfer::Recipient { fn from(recipient: Recipient) -> Self { match recipient { Recipient::Device => nusb::transfer::Recipient::Device, Recipient::Interface => nusb::transfer::Recipient::Interface, Recipient::Endpoint => nusb::transfer::Recipient::Endpoint, Recipient::Other => nusb::transfer::Recipient::Other, } } } /// Covert to our crate speed impl From for usb::Speed { fn from(nusb: nusb::Speed) -> Self { match nusb { nusb::Speed::SuperPlus => usb::Speed::SuperSpeedPlus, nusb::Speed::Super => usb::Speed::SuperSpeed, nusb::Speed::High => usb::Speed::HighSpeed, nusb::Speed::Full => usb::Speed::FullSpeed, nusb::Speed::Low => usb::Speed::LowSpeed, _ => usb::Speed::Unknown, } } } /// Convert a bus into a root hub device - following the same sort of abstraction as Linux impl From<&nusb::BusInfo> for Device { fn from(bus: &nusb::BusInfo) -> Self { #[cfg(any(target_os = "linux", target_os = "android"))] { // should use profiler for extra data not this into bus.root_hub().into() } #[cfg(target_os = "windows")] { let (bcd_device, protocol) = match bus.controller_type() { Some(nusb::UsbControllerType::XHCI) => (Some(0x300), Some(0x03)), Some(nusb::UsbControllerType::EHCI) => (Some(0x200), Some(0x01)), Some(nusb::UsbControllerType::OHCI) => (Some(0x110), Some(0x00)), Some(nusb::UsbControllerType::VHCI) => (Some(0x000), Some(0x00)), _ => (None, None), }; let (vendor_id, product_id) = if let Some(pci_info) = platform::pci_info_from_bus(bus) { (Some(pci_info.vendor_id), Some(pci_info.product_id)) } else { (None, None) }; Device { vendor_id, product_id, device_speed: None, location_id: DeviceLocation { bus: 0, number: 0, tree_positions: vec![], }, bcd_device: bcd_device.map(usb::Version::from_bcd), bcd_usb: None, class: Some(usb::BaseClass::Hub), sub_class: Some(0), protocol, name: bus.system_name().map(|s| s.to_string()).unwrap_or_default(), manufacturer: None, // serial number is the PCI instance on Linux serial_num: Some(bus.parent_instance_id().to_string_lossy().to_string()), last_event: Some(Default::default()), ..Default::default() } } #[cfg(target_os = "macos")] { let (bcd_device, protocol) = match bus.controller_type() { Some(nusb::UsbControllerType::XHCI) => (Some(0x300), Some(0x03)), Some(nusb::UsbControllerType::EHCI) => (Some(0x200), Some(0x01)), Some(nusb::UsbControllerType::OHCI) => (Some(0x110), Some(0x00)), Some(nusb::UsbControllerType::VHCI) => (Some(0x000), Some(0x00)), _ => (None, None), }; Device { vendor_id: None, product_id: None, device_speed: None, location_id: DeviceLocation { // macOS bus_id is a hex string bus: u8::from_str_radix(bus.bus_id(), 16).expect( "Failed to parse bus_id: macOS bus_id should be a hex string and not None", ), number: 0, tree_positions: vec![], }, bcd_device: bcd_device.map(usb::Version::from_bcd), bcd_usb: None, class: Some(usb::BaseClass::Hub), sub_class: Some(0), protocol, name: bus.class_name().to_string(), manufacturer: Some(bus.provider_class_name().to_string()), serial_num: bus.name().map(|s| s.to_string()), last_event: Some(Default::default()), ..Default::default() } } } } impl From<&nusb::BusInfo> for Bus { fn from(bus: &nusb::BusInfo) -> Self { platform::from(bus) } } impl From<&nusb::DeviceInfo> for Device { fn from(device_info: &nusb::DeviceInfo) -> Self { let device_speed = device_info.speed().map(|s| { let s = usb::Speed::from(s); DeviceSpeed::SpeedValue(s) }); let manufacturer = device_info .manufacturer_string() .map(|s| s.to_string()) .or_else(|| names::vendor(device_info.vendor_id())) .or_else(|| { usb_ids::Vendor::from_id(device_info.vendor_id()).map(|v| v.name().to_string()) }); let name = device_info .product_string() .map(|s| s.to_string()) .or_else(|| names::product(device_info.vendor_id(), device_info.product_id())) .or_else(|| { usb_ids::Device::from_vid_pid(device_info.vendor_id(), device_info.product_id()) .map(|d| d.name().to_string()) }) .unwrap_or_default(); let serial_num = device_info.serial_number().map(|s| s.to_string()); let bus_no = if cfg!(target_os = "macos") { // macOS bus_id is a hex string u8::from_str_radix(device_info.bus_id(), 16) .expect("Failed to parse bus_id: macOS bus_id should be a hex string and not None") } else if cfg!(target_os = "linux") || cfg!(target_os = "android") { // Linux bus_id is a string decimal device_info.bus_id().parse::().expect( "Failed to parse bus_id: Linux bus_id should be a decimal string and not None", ) } else { // Windows bus_id is a string string so 0 0 }; Device { vendor_id: Some(device_info.vendor_id()), product_id: Some(device_info.product_id()), device_speed, location_id: DeviceLocation { bus: bus_no, number: device_info.device_address(), tree_positions: device_info.port_chain().to_vec(), }, bcd_device: Some(usb::Version::from_bcd(device_info.device_version())), // gets added on the extra read bcd_usb: None, class: Some(usb::BaseClass::from(device_info.class())), sub_class: Some(device_info.subclass()), protocol: Some(device_info.protocol()), id: Some(device_info.id()), name, manufacturer, serial_num, last_event: Some(DeviceEvent::default()), ..Default::default() } } } impl UsbDevice { #[allow(unused_variables)] fn control_in(&self, control_request: &ControlRequest, force_claim: bool) -> Result> { let nusb_control: nusb::transfer::ControlIn = (*control_request).into(); // Windows *ALWAYS* needs to claim the interface and self.handle.control_in_blocking isn't defined #[cfg(target_os = "windows")] let ret = { // requires detech_and_claim_interface on Linux if mod is loaded // not nice though just for profiling - maybe add a flag to claim or not? let interface = self .handle .claim_interface(control_request.index as u8) .wait()?; interface.control_in(nusb_control, self.timeout).wait() }; #[cfg(not(target_os = "windows"))] let ret = { if control_request.claim_interface | force_claim { // requires detech_and_claim_interface on Linux if mod is loaded // not nice though just for profiling - maybe add a flag to claim or not? let interface: nusb::Interface = self .handle .claim_interface(control_request.index as u8) .wait()?; interface.control_in(nusb_control, self.timeout).wait() } else { self.handle.control_in(nusb_control, self.timeout).wait() } }; ret.map_err(|e| match e { nusb::transfer::TransferError::Stall => Error { kind: ErrorKind::TransferStall, message: "Endpoint in a STALL condition".to_string(), }, _ => Error { kind: ErrorKind::Nusb, message: format!("Failed to get control message: {e}"), }, }) } /// Retry control request if it fails due to STALL - following a claim interface and clear halt fn control_in_retry(&self, control_request: &ControlRequest) -> Result> { match self.control_in(control_request, false) { Ok(n) => Ok(n), Err(Error { kind: ErrorKind::TransferStall, .. }) => self.control_in(control_request, true).map_err(|e| Error { kind: ErrorKind::Nusb, message: format!("Failed to get control message: {e}"), }), Err(e) => Err(Error { kind: ErrorKind::Nusb, message: format!("Failed to get control message: {e}"), }), } } } impl UsbOperations for UsbDevice { fn get_descriptor_string(&self, string_index: u8) -> Option { // 0 is not a valid string index - nusb uses NonZeroU8, we allow for invalid values if string_index == 0 { return None; } self.handle .get_string_descriptor( std::num::NonZeroU8::new(string_index).expect("string_index should not be 0"), self.language, self.timeout, ) .wait() .map(|s| s.chars().filter(|c| !c.is_control()).collect()) .ok() } fn get_control_msg(&self, control_request: ControlRequest) -> Result> { let data = self.control_in_retry(&control_request)?; let n = data.len(); if n < control_request.length { log::warn!( "{:?} Failed to get full control message: read {} of {} bytes", self, n, control_request.length ); return Err(Error { kind: ErrorKind::Nusb, message: format!( "{:?} Failed to get full control message: read {} of {} bytes", self, n, control_request.length ), }); } Ok(data) } } impl NusbProfiler { pub fn new() -> Self { Self { #[cfg(target_os = "windows")] bus_id_map: HashMap::new(), } } fn build_endpoints( &self, device: &UsbDevice, interface_path: &usb::DevicePath, interface_desc: &nusb::descriptors::InterfaceDescriptor, ) -> Vec { let mut ret: Vec = Vec::new(); for endpoint in interface_desc.endpoints() { let endpoint_desc = endpoint.as_bytes(); let endpoint_extra = endpoint .descriptors() // no filter as all _should_ be endpoint descriptors at this point .flat_map(|d| d.to_vec()) .collect::>(); let endpoint_path = usb::EndpointPath::new_with_device_path( interface_path.to_owned(), endpoint.address(), ); ret.push(usb::Endpoint { address: usb::EndpointAddress::from(endpoint.address()), transfer_type: usb::TransferType::from(endpoint.attributes()), sync_type: usb::SyncType::from(endpoint.attributes()), usage_type: usb::UsageType::from(endpoint.attributes()), max_packet_size: endpoint.max_packet_size() as u16, interval: endpoint.interval(), length: endpoint_desc[0], extra: self .build_endpoint_descriptor_extra( device, ( interface_desc.class(), interface_desc.subclass(), interface_desc.protocol(), ), interface_desc.interface_number(), endpoint_extra, ) .ok() .flatten(), internal: InternalData::default(), endpoint_path: Some(endpoint_path), }); } ret } fn build_interfaces( &self, device: &UsbDevice, config: &nusb::descriptors::ConfigurationDescriptor, ) -> Result> { let mut ret: Vec = Vec::new(); for interface in config.interfaces() { for interface_alt in interface.alt_settings() { let device_path = usb::DevicePath::new_with_port_path( device.location.to_owned().into(), Some(config.configuration_value()), Some(interface_alt.interface_number()), Some(interface_alt.alternate_setting()), ); let path = device_path.to_string(); let interface_desc = interface_alt.as_bytes(); let interface_extra = interface_alt .descriptors() // only want device and interface descriptors - nusb has everything trailing including endpoint .take_while(|d| d.descriptor_type() != 0x05) .flat_map(|d| d.to_vec()) .collect::>(); let interface = usb::Interface { name: get_sysfs_string(&path, "interface").or_else(|| { interface_alt .string_index() .and_then(|i| device.get_descriptor_string(i.into())) }), string_index: interface_alt.string_index().map(|i| i.into()).unwrap_or(0), number: interface_alt.interface_number(), class: usb::BaseClass::from(interface_alt.class()), sub_class: interface_alt.subclass(), protocol: interface_alt.protocol(), alt_setting: interface_alt.alternate_setting(), driver: get_sysfs_readlink(&path, "driver") .or_else(|| get_udev_driver_name(&path).ok().flatten()), syspath: get_syspath(&path).or_else(|| get_udev_syspath(&path).ok().flatten()), length: interface_desc[0], endpoints: self.build_endpoints(device, &device_path, &interface_alt), extra: self .build_interface_descriptor_extra( device, ( interface_alt.class(), interface_alt.subclass(), interface_alt.protocol(), ), interface_alt.interface_number(), interface_extra, ) .ok(), path: path.to_string(), device_path: Some(device_path), internal: InternalData::default(), }; ret.push(interface); } } Ok(ret) } fn build_configurations(&self, device: &UsbDevice) -> Result> { let mut ret: Vec = Vec::new(); for c in device.handle.configurations() { let mut attributes = Vec::new(); if c.attributes() & 0x10 != 0 { attributes.push(usb::ConfigAttributes::BatteryPowered); } if c.attributes() & 0x20 != 0 { attributes.push(usb::ConfigAttributes::RemoteWakeup); } if c.attributes() & 0x40 != 0 { attributes.push(usb::ConfigAttributes::SelfPowered); } else { attributes.push(usb::ConfigAttributes::BusPowered); } let config_desc = c.as_bytes(); let config_extra = c .descriptors() // nusb has everything trailing so take until interfaces .take_while(|d| d.descriptor_type() != 0x04) .flat_map(|d| d.to_vec()) .collect::>(); let total_length = u16::from_le_bytes(config_desc[2..4].try_into().unwrap()); ret.push(usb::Configuration { name: c .string_index() .and_then(|i| device.get_descriptor_string(i.into())) .unwrap_or_default(), string_index: c.string_index().map(|i| i.into()).unwrap_or(0), number: c.configuration_value(), attributes, max_power: NumericalUnit { // *2 because nusb returns in 2mA units value: (c.max_power() as u32 * 2), unit: String::from("mA"), description: None, }, length: config_desc.len() as u8, total_length, interfaces: self.build_interfaces(device, &c)?, extra: self .build_config_descriptor_extra(device, config_extra) .ok(), internal: InternalData::default(), }); } Ok(ret) } fn build_spdevice_extra( &self, device: &UsbDevice, sp_device: &mut Device, ) -> Result { // nusb has this cached in handle.device_descriptor - convert to our type let device_desc: usb::DeviceDescriptor = usb::DeviceDescriptor::try_from(device.handle.device_descriptor().as_bytes())?; sp_device.bcd_usb = Some(device_desc.usb_version); // try to get strings from device descriptors // if missing if sp_device.name.is_empty() { if let Some(name) = device.get_descriptor_string(device_desc.product_string_index) { sp_device.name = name; } } if sp_device.manufacturer.is_none() { if let Some(manufacturer) = device.get_descriptor_string(device_desc.manufacturer_string_index) { sp_device.manufacturer = Some(manufacturer); } } if sp_device.serial_num.is_none() { if let Some(serial) = device.get_descriptor_string(device_desc.serial_number_string_index) { sp_device.serial_num = Some(serial); } } let sysfs_name = sp_device.sysfs_name(); let mut extra = usb::DeviceExtra { max_packet_size: device_desc.max_packet_size, string_indexes: ( device_desc.product_string_index, device_desc.manufacturer_string_index, device_desc.serial_number_string_index, ), driver: get_sysfs_readlink(&sysfs_name, "driver") .or_else(|| get_udev_driver_name(&sysfs_name).ok().flatten()), syspath: get_syspath(&sysfs_name) .or_else(|| get_udev_syspath(&sysfs_name).ok().flatten()), // These are idProduct, idVendor in lsusb - from udev_hwdb/usb-ids - not device descriptor vendor: names::vendor(device_desc.vendor_id).or_else(|| { usb_ids::Vendor::from_id(device_desc.vendor_id).map(|v| v.name().to_owned()) }), product_name: names::product(device_desc.vendor_id, device_desc.product_id).or_else( || { usb_ids::Device::from_vid_pid(device_desc.vendor_id, device_desc.product_id) .map(|v| v.name().to_owned()) }, ), configurations: self.build_configurations(device)?, status: Self::get_device_status(device).ok(), debug: Self::get_debug_descriptor(device).ok(), binary_object_store: None, qualifier: None, hub: None, negotiated_speed: device.handle.speed().map(usb::Speed::from), }; // Get device specific stuff: bos, hub, dualspeed, debug and status if device_desc.usb_version >= usb::Version::from_bcd(0x0201) { extra.binary_object_store = Self::get_bos_descriptor(device).ok(); } if device_desc.usb_version >= usb::Version::from_bcd(0x0200) { extra.qualifier = Self::get_device_qualifier(device).ok(); } if device_desc.device_class == usb::BaseClass::Hub as u8 { let has_ssp = if let Some(bos) = &extra.binary_object_store { bos.capabilities .iter() .any(|c| matches!(c, usb::descriptors::bos::BosCapability::SuperSpeedPlus(_))) } else { false }; let bcd = sp_device.bcd_usb.map_or(0x0100, |v| v.into()); extra.hub = Self::get_hub_descriptor(device, device_desc.device_protocol, bcd, has_ssp).ok(); } Ok(extra) } pub(crate) fn build_spdevice( &mut self, device_info: &nusb::DeviceInfo, with_extra: bool, ) -> Result { let mut sp_device: Device = device_info.into(); let generic_extra = |sysfs_name: &str| { usb::DeviceExtra { max_packet_size: 0, // ...extra will update with actual // nusb doesn't have these cached string_indexes: (0, 0, 0), driver: get_sysfs_readlink(sysfs_name, "driver") .or_else(|| get_udev_driver_name(sysfs_name).ok().flatten()), syspath: get_syspath(sysfs_name) .or_else(|| get_udev_syspath(sysfs_name).ok().flatten()), vendor: names::vendor(device_info.vendor_id()).or_else(|| { usb_ids::Vendor::from_id(device_info.vendor_id()).map(|v| v.name().to_owned()) }), product_name: names::product(device_info.vendor_id(), device_info.product_id()) .or_else(|| { usb_ids::Device::from_vid_pid( device_info.vendor_id(), device_info.product_id(), ) .map(|v| v.name().to_owned()) }), configurations: vec![], status: None, debug: None, binary_object_store: None, qualifier: None, hub: None, negotiated_speed: None, } }; if with_extra { if let Ok(device) = device_info.open().wait() { // get the first language - probably US English let languages: Vec = device .get_string_descriptor_supported_languages(std::time::Duration::from_secs(1)) .wait() .map(|i| i.collect()) .unwrap_or_default(); let language = languages .first() .copied() .unwrap_or(nusb::descriptors::language_id::US_ENGLISH); sp_device.profiler_error = { let usb_device = UsbDevice { handle: device, language, vidpid: (device_info.vendor_id(), device_info.product_id()), location: sp_device.location_id.to_owned(), timeout: std::time::Duration::from_secs(1), }; match self.build_spdevice_extra(&usb_device, &mut sp_device) { Ok(extra) => { sp_device.extra = Some(extra); None } Err(e) => { sp_device.extra = Some(generic_extra(&sp_device.sysfs_name())); Some(format!("Failed to get some extra data for {sp_device}, probably requires elevated permissions: {e}")) } } }; } else { log::warn!("Failed to open device for extra data: {:04x}:{:04x}. Ensure user has USB access permissions: https://docs.rs/nusb/latest/nusb", device_info.vendor_id(), device_info.product_id()); sp_device.profiler_error = Some( "Failed to open device, extra data incomplete and possibly inaccurate" .to_string(), ); sp_device.extra = Some(generic_extra(&sp_device.sysfs_name())); } } Ok(sp_device) } } impl Profiler for NusbProfiler { fn get_devices(&mut self, with_extra: bool) -> Result> { let mut devices = Vec::new(); for device in nusb::list_devices().wait()? { match self.build_spdevice(&device, with_extra) { #[allow(unused_mut)] Ok(mut sp_device) => { #[cfg(target_os = "windows")] { // Windows doesn't have a bus number for root hubs, so we use the index // and assign devices based on serial number if let Some(existing_no) = self.bus_id_map.get(device.bus_id()) { sp_device.location_id.bus = *existing_no; } else { let bus = self.bus_id_map.len() as u8; self.bus_id_map.insert(device.bus_id().to_owned(), bus); sp_device.location_id.bus = bus; } } devices.push(sp_device.to_owned()); let print_stderr = std::env::var_os("CYME_PRINT_NON_CRITICAL_PROFILER_STDERR").is_some(); // print any non-critical error during extra capture sp_device.profiler_error.iter().for_each(|e| { if print_stderr { eprintln!("{e}"); } else { log::warn!("Non-critical error during profile of {device:?}: {e}"); } }); } Err(e) => eprintln!("Failed to get data for {device:?}: {e}"), } } Ok(devices) } #[cfg(any(target_os = "linux", target_os = "android"))] fn get_root_hubs(&mut self) -> Result> { let mut root_hubs = HashMap::new(); for bus in nusb::list_buses().wait()? { let device = bus.root_hub(); // get with extra data only on Linux as others _really_ don't exist match self.build_spdevice(device, true) { #[allow(unused_mut)] Ok(mut sp_device) => { if !sp_device.is_root_hub() { return Err(Error::new( ErrorKind::InvalidDevice, &format!( "Device {sp_device} returned by nusb::list_root_hubs is not a root hub!" ), )); } let print_stderr = std::env::var_os("CYME_PRINT_NON_CRITICAL_PROFILER_STDERR").is_some(); // print any non-critical error during extra capture sp_device.profiler_error.iter().for_each(|e| { if print_stderr { eprintln!("{e}"); } else { log::warn!("Non-critical error during profile of {sp_device}: {e}"); } }); root_hubs.insert(sp_device.location_id.bus, sp_device); } Err(e) => eprintln!("Failed to get data for {device:?}: {e}"), } } Ok(root_hubs) } #[cfg(not(any(target_os = "linux", target_os = "android")))] fn get_root_hubs(&mut self) -> Result> { let mut root_hubs = HashMap::new(); for bus in nusb::list_buses().wait()? { #[allow(unused_mut)] let mut device: Device = Device::from(&bus); #[cfg(target_os = "windows")] { if let Some(existing_no) = self.bus_id_map.get(bus.bus_id()) { device.location_id.bus = *existing_no; } else { let bus_no = self.bus_id_map.len() as u8; self.bus_id_map.insert(bus.bus_id().to_owned(), bus_no); device.location_id.bus = bus_no; } } root_hubs.insert(device.location_id.bus, device); } Ok(root_hubs) } fn get_buses(&mut self) -> Result> { let mut buses = HashMap::new(); for nusb_bus in nusb::list_buses().wait()? { #[allow(unused_mut)] let mut bus: Bus = Bus::from(&nusb_bus); // Windows doesn't have a bus number for root hubs, so we track the bus_id string #[cfg(target_os = "windows")] { if let Some(existing_no) = self.bus_id_map.get(nusb_bus.bus_id()) { bus.usb_bus_number = Some(*existing_no); } else { let bus_no = self.bus_id_map.len() as u8; self.bus_id_map.insert(nusb_bus.bus_id().to_owned(), bus_no); bus.usb_bus_number = Some(bus_no); } } // add root hub to devices like lsusb on Linux since they are displayed like devices #[cfg(any(target_os = "linux", target_os = "android"))] { let sp_device = self.build_spdevice(nusb_bus.root_hub(), true)?; bus.devices = Some(vec![sp_device]); } buses.insert( bus.usb_bus_number .expect("Bus has no usb_bus_number, unable to use as key"), bus, ); } Ok(buses) } } pub(crate) fn fill_spusb(spusb: &mut SystemProfile) -> Result<()> { let mut profiler = NusbProfiler::new(); profiler.fill_spusb(spusb) } cyme-2.2.6/src/profiler/types.rs000066400000000000000000002546701506545537300166340ustar00rootroot00000000000000//! USB data structures for system profiling of USB devices and their descriptors. //! //! Originally based on serde deserialization of `system_profiler -json` output but now used as data structures for all platforms. Not all fields are used on all platforms or are completely logically in hindsight but it works. Naming is also based on `system_profiler` (SP..) and not very Rustian... use colored::*; use serde::de::{self, MapAccess, SeqAccess, Visitor}; use serde::{Deserialize, Deserializer, Serialize}; use serde_with::{skip_serializing_none, DeserializeFromStr, SerializeDisplay}; use std::cmp::Ordering; use std::fmt; use std::fs; use std::io::Read; use std::path::{Path, PathBuf}; use std::str::FromStr; use super::*; use crate::error::{Error, ErrorKind}; use crate::types::NumericalUnit; use crate::usb::*; /// Root JSON returned from system_profiler and used as holder for all static USB bus data #[derive(Debug, Serialize, Deserialize)] pub struct SystemProfile { /// system buses #[serde(rename(deserialize = "SPUSBDataType"), alias = "buses")] pub buses: Vec, } impl SystemProfile { /// Returns total number of devices across all buses pub fn len(&self) -> usize { self.buses.iter().map(|b| b.len()).sum() } /// Whether all buses are empty pub fn is_empty(&self) -> bool { self.buses.iter().all(|b| b.is_empty()) } /// Flattens all [`Bus`]es by calling `into_flattened_devices` on each /// /// In place operation so it mutates the data and tree structure is lost. Location data is still present in each device. pub fn into_flattened(&mut self) { for bus in &mut self.buses { bus.into_flattened_devices(); } } /// Returns a flattened Vec of references to all [`Device`]s in each of the `buses` pub fn flattened_devices(&self) -> Vec<&Device> { let mut ret = Vec::with_capacity(self.len()); for bus in &self.buses { ret.extend(bus.flattened_devices()); } ret } /// Returns reference to [`Bus`] `number` if it exists in data pub fn get_bus(&self, number: u8) -> Option<&Bus> { self.buses.iter().find(|b| b.usb_bus_number == Some(number)) } /// Returns mutable reference to [`Bus`] `number` if it exists in data pub fn get_bus_mut(&mut self, number: u8) -> Option<&mut Bus> { self.buses .iter_mut() .find(|b| b.usb_bus_number == Some(number)) } /// Search for reference to [`Device`] at [`PortPath`] on correct bus number if present else all buses pub fn get_node(&self, port_path: &PortPath) -> Option<&Device> { let bus_no = port_path.bus(); // the logic of getting bus is required because bus_no is Optional; there may be valid port part on a bus with no number if let Some(bus) = self.get_bus(bus_no) { if let Some(node) = bus.get_node(port_path) { return Some(node); } } else { for bus in self.buses.iter() { if let Some(node) = bus.get_node(port_path) { return Some(node); } } } None } /// Search for mutable reference to [`Device`] at [`PortPath`] on correct bus number if present else all buses pub fn get_node_mut(&mut self, port_path: &PortPath) -> Option<&mut Device> { let bus_no = port_path.bus(); if self.buses.iter().any(|b| b.usb_bus_number == Some(bus_no)) { if let Some(bus) = self.get_bus_mut(bus_no) { if let Some(node) = bus.get_node_mut(port_path) { return Some(node); } } } else { for bus in self.buses.iter_mut() { if let Some(node) = bus.get_node_mut(port_path) { return Some(node); } } } None } /// Search for reference to [`Device`] at `port_path` as Path pub fn get_node_by_path>(&self, path: P) -> Option<&Device> { UsbPath::from(path.as_ref()) .port_path() .and_then(|pp| self.get_node(&pp)) } /// Search for mutable reference to [`Device`] at `port_path` as Path pub fn get_node_path_by_path_mut>(&mut self, path: P) -> Option<&mut Device> { UsbPath::from(path.as_ref()) .port_path() .and_then(|pp| self.get_node_mut(&pp)) } /// Search for reference to [`Device`] at port path as string pub fn get_node_by_str(&self, path: &str) -> Option<&Device> { PortPath::try_from(path) .ok() .and_then(|pp| self.get_node(&pp)) } /// Search for mutable reference to [`Device`] at port path as string pub fn get_node_str_mut(&mut self, path: &str) -> Option<&mut Device> { PortPath::try_from(path) .ok() .and_then(|pp| self.get_node_mut(&pp)) } /// Get reference to [`Configuration`] at `port_path` and `config` if present pub fn get_config(&self, port_path: &PortPath, config: u8) -> Option<&Configuration> { self.get_node(port_path).and_then(|d| d.get_config(config)) } /// Get mutable reference to [`Configuration`] at [`PortPath`] and `config` if present pub fn get_config_mut( &mut self, port_path: &PortPath, config: u8, ) -> Option<&mut Configuration> { self.get_node_mut(port_path) .and_then(|d| d.get_config_mut(config)) } /// Get reference to [`Interface`] at `port_path`, `config` and `interface` if present in [`DevicePath`] pub fn get_interface(&self, device_path: &DevicePath) -> Option<&Interface> { if let (Some(config), Some(interface)) = (device_path.configuration(), device_path.interface()) { self.get_node(device_path.port_path()) .and_then(|d| d.get_interface(config, interface, device_path.alt_setting())) } else { None } } /// Get mutable reference to [`Interface`] at `port_path`, `config` and `interface` if present in [`DevicePath`] pub fn get_interface_mut(&mut self, device_path: &DevicePath) -> Option<&mut Interface> { if let (Some(config), Some(interface)) = (device_path.configuration(), device_path.interface()) { self.get_node_mut(device_path.port_path()) .and_then(|d| d.get_interface_mut(config, interface, device_path.alt_setting())) } else { None } } /// Get reference to [`Endpoint`] at `port_path`, `config`, `interface` and `endpoint` if present pub fn get_endpoint(&self, endpoint_path: &EndpointPath) -> Option<&Endpoint> { if let (Some(config), Some(interface), endpoint) = ( endpoint_path.device_path().configuration(), endpoint_path.device_path().interface(), endpoint_path.endpoint(), ) { self.get_node(endpoint_path.device_path().port_path()) .and_then(|d| { d.get_endpoint( config, interface, endpoint_path.device_path().alt_setting(), endpoint, ) }) } else { None } } /// Get mutable reference to [`Endpoint`] at `port_path`, `config`, `interface` and `endpoint` if present pub fn get_endpoint_mut(&mut self, endpoint_path: &EndpointPath) -> Option<&mut Endpoint> { if let (Some(config), Some(interface), endpoint) = ( endpoint_path.device_path().configuration(), endpoint_path.device_path().interface(), endpoint_path.endpoint(), ) { self.get_node_mut(endpoint_path.device_path().port_path()) .and_then(|d| { d.get_endpoint_mut( config, interface, endpoint_path.device_path().alt_setting(), endpoint, ) }) } else { None } } #[cfg(feature = "nusb")] /// Search for [`::nusb::DeviceId`] in branches of bus and return reference pub fn get_id(&self, id: &::nusb::DeviceId) -> Option<&Device> { for bus in self.buses.iter() { if let Some(node) = bus.get_id(id) { return Some(node); } } None } #[cfg(feature = "nusb")] /// Search for [`::nusb::DeviceId`] in branches of bus and returns a mutable reference if found pub fn get_id_mut(&mut self, id: &::nusb::DeviceId) -> Option<&mut Device> { for bus in self.buses.iter_mut() { if let Some(node) = bus.get_id_mut(id) { return Some(node); } } None } /// Replace a [`Device`] in the correct [`Bus`] and parent device based on its location_id /// /// If the device was existing, it will be replaced with the old device and returned as `Ok`, else `Err` if the device was not found. pub fn replace(&mut self, mut new: Device) -> Result { if let Some(existing) = self.get_node_mut(&new.port_path()) { let devices = std::mem::take(&mut existing.devices); new.devices = devices; // config, interface and endpoint will loose internal but not worried about that new.internal = existing.internal.clone(); // assume all was expanded if manually expanded // could drill down copying each internal above but not sure worth it if new.is_expanded() { new.set_all_expanded(true); } let ret = std::mem::replace(existing, new); Ok(ret) } else { Err(Error::new( ErrorKind::NotFound, "Device not found to replace", )) } } /// Insert a [`Device`] into the correct [`Bus`] and parent device based on its location_id /// /// If the device was existing, it will be replaced with the new device and returned as `Some` (without child devices), else `None`. `None` will also be returned if the device parent is not found. pub fn insert(&mut self, new: Device) -> Option { // check existing device and replace if found if self.get_node_mut(&new.port_path()).is_some() { return self.replace(new).ok(); // else we have to stick into tree at correct place } else if new.is_trunk_device() { let bus = self.get_bus_mut(new.location_id.bus).unwrap(); if let Some(bd) = bus.devices.as_mut() { bd.push(new); } else { bus.devices = Some(vec![new]); } } else if let Some(parent_path) = new.parent_port_path() { if let Some(parent) = self.get_node_mut(&parent_path) { if let Some(bd) = parent.devices.as_mut() { bd.push(new); } else { parent.devices = Some(vec![new]); } } } None } } impl<'a> IntoIterator for &'a SystemProfile { type Item = &'a Device; type IntoIter = std::vec::IntoIter; fn into_iter(self) -> std::vec::IntoIter { self.flattened_devices().into_iter() } } impl fmt::Display for SystemProfile { fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result { for v in &self.buses { if f.alternate() { if f.sign_plus() { writeln!(f, "{v:+#}")?; } else { writeln!(f, "{v:#}")?; } } else if f.sign_plus() { write!(f, "{v:+}")?; } else { write!(f, "{v:}")?; } } Ok(()) } } /// Deprecated alias for [`SystemProfile`] #[deprecated(since = "2.0.0", note = "Use SystemProfile instead")] pub type SPUSBDataType = SystemProfile; #[derive(Debug, Clone)] pub(crate) struct PciInfo { pub vendor_id: u16, pub product_id: u16, pub revision: u16, } /// USB bus returned from system_profiler but now used for other platforms. /// /// It is a merging of the PCI Host Controller information and root hub device data (if present). Essentially a root hub but not as a pseudo device but an explicit type - since the root hub is a bit confusing in that sense. #[skip_serializing_none] #[derive(Debug, Clone, Default, Serialize, Deserialize)] pub struct Bus { /// System internal bus name based on Root Hub device name /// /// Normally something generic like 'Root Hub', 'USB 3.0 Bus' #[serde(rename(deserialize = "_name"), alias = "name")] pub name: String, /// System internal bus provider name pub host_controller: String, /// Vendor name of PCI Host Controller from pci.ids pub host_controller_vendor: Option, /// Device name of PCI Host Controller from pci.ids pub host_controller_device: Option, /// PCI vendor ID (VID) #[serde(default, deserialize_with = "deserialize_option_number_from_string")] pub pci_vendor: Option, /// PCI device ID (PID) #[serde(default, deserialize_with = "deserialize_option_number_from_string")] pub pci_device: Option, #[serde(default, deserialize_with = "deserialize_option_number_from_string")] /// PCI Revsision ID pub pci_revision: Option, /// Number of bus on system #[serde(default, deserialize_with = "deserialize_option_number_from_string")] pub usb_bus_number: Option, /// [`Device`]s on the [`Bus`]. Since a device can have devices too, need to walk down all devices to get all devices on the bus /// /// On Linux, the root hub is also included in this list #[serde(rename(deserialize = "_items"), alias = "devices")] pub devices: Option>, /// Bus ID is a string on Windows and required to match inserted devices after profiling #[cfg(all(target_os = "windows", feature = "nusb"))] #[serde(skip)] pub id: String, /// Internal data for tracking events and other data #[serde(skip)] pub(crate) internal: InternalData, } /// Deprecated alias for [`Bus`] #[deprecated(since = "2.0.0", note = "Use Bus instead")] pub type USBBus = Bus; impl TryFrom for Bus { type Error = Error; fn try_from(device: Device) -> Result { if !device.is_root_hub() { return Err(Error::new( ErrorKind::InvalidArg, "Device is not a root hub", )); } // attempt to get PCI info from platform let (pci_vendor, pci_device, pci_revision) = match platform::pci_info_from_device(&device) { Some(v) => (Some(v.vendor_id), Some(v.product_id), Some(v.revision)), None => (None, None, None), }; let (host_controller_vendor, host_controller_device) = if let (Some(v), Some(p)) = (pci_vendor, pci_device) { log::debug!("looking up PCI IDs: {v:04x}:{p:04x}"); match pci_ids::Device::from_vid_pid(v, p) { Some(d) => ( Some(d.vendor().name().to_string()), Some(d.name().to_string()), ), None => (None, None), } } else { (None, None) }; Ok(Bus { name: device.name, host_controller: device.manufacturer.unwrap_or_default(), host_controller_vendor, host_controller_device, pci_device: pci_device.filter(|v| *v != 0xffff && *v != 0), pci_vendor: pci_vendor.filter(|v| *v != 0xffff && *v != 0), pci_revision: pci_revision.filter(|v| *v != 0xffff && *v != 0), usb_bus_number: Some(device.location_id.bus), devices: device.devices, ..Default::default() }) } } impl<'a> IntoIterator for &'a Bus { type Item = &'a Device; type IntoIter = std::vec::IntoIter; fn into_iter(self) -> std::vec::IntoIter { self.flattened_devices().into_iter() } } /// A generic Bus from a u8 bus number - used if Bus profiling is not available impl From for Bus { fn from(bus: u8) -> Self { Bus { name: format!("USB Bus {bus:03}"), host_controller: String::from("USB Host Controller"), usb_bus_number: Some(bus), ..Default::default() } } } /// Returns of Vec of devices in the Bus as a reference impl Bus { /// Returns total number of devices in the bus pub fn len(&self) -> usize { self.devices .as_ref() .map_or(0, |d| d.iter().map(|dd| dd.len()).sum()) } /// Flattens the bus by copying each device into a new devices `Vec` /// /// Unlike the `flattened_devices` which returns references that may still contain a `Vec` of `Device`, this function makes those `None` too since it is doing a hard copy. /// /// Not very pretty or efficient, probably a better way... pub fn into_flattened_devices(&mut self) { if let Some(mut devices) = self.devices.take() { let mut new_devices: Vec = Vec::new(); while let Some(device) = devices.pop() { new_devices.extend(device.into_flattened()) } self.devices = Some(new_devices) } } /// Returns a flattened `Vec` of references to all `Device`s on the bus /// /// Note that whilst `Vec` of references is flat, the `Device`s still contain a `devices` `Vec` where the references point; recursive functions on the returned `Vec` will produce weird results pub fn flattened_devices(&self) -> Vec<&Device> { if let Some(devices) = &self.devices { devices.iter().flat_map(|d| d.flatten()).collect() } else { Vec::new() } } /// Whether the bus has no [`Device`]s pub fn is_empty(&self) -> bool { match &self.devices { Some(d) => d.is_empty() || d.iter().all(|dd| dd.internal.hidden), None => true, } } /// Whether the bus has just empty hubs pub fn has_empty_hubs(&self) -> bool { match &self.devices { Some(d) => d.iter().all(|dd| dd.is_hub() && !dd.has_devices()), None => false, } } /// usb_bus_number is not always present in system_profiler output so try to get from first device instead pub fn get_bus_number(&self) -> Option { self.usb_bus_number.or_else(|| { self.devices .as_ref() .and_then(|d| d.first().map(|dd| dd.location_id.bus)) }) } /// syspath style path to bus pub fn path(&self) -> Option { self.get_bus_number().map(|n| get_trunk_path(n, &[]).into()) } /// sysfs style path to bus interface pub fn interface(&self) -> Option { self.get_bus_number() .map(|n| DevicePath::new(n, vec![0], Some(1), Some(0), None)) } /// Remove the root_hub if existing in bus pub fn remove_root_hub_device(&mut self) { self.devices .iter_mut() .for_each(|devs| devs.retain(|d| !d.is_root_hub())); } /// Gets the device that is the root_hub associated with this bus - Linux only but exists in case of using --from-json pub fn get_root_hub_device(&self) -> Option<&Device> { self.interface().and_then(|i| self.get_node(i.port_path())) } /// Gets a mutable device that is the root_hub associated with this bus - Linux only but exists in case of using --from-json pub fn get_root_hub_device_mut(&mut self) -> Option<&mut Device> { self.interface() .and_then(|i| self.get_node_mut(i.port_path())) } /// Search for [`Device`] in branches of bus and return reference pub fn get_node(&self, port_path: &PortPath) -> Option<&Device> { if let Some(devices) = self.devices.as_ref() { for dev in devices { if let Some(node) = dev.get_node(port_path) { log::debug!("Found {node}"); return Some(node); } } } None } /// Search for [`Device`] in branches of bus and return mutable if found pub fn get_node_mut(&mut self, port_path: &PortPath) -> Option<&mut Device> { if let Some(devices) = self.devices.as_mut() { for dev in devices { if let Some(node) = dev.get_node_mut(port_path) { log::debug!("Found {node}"); return Some(node); } } } None } /// Search for [`Device`] in branches of bus by Path and return reference pub fn get_node_by_path>(&self, port_path: P) -> Option<&Device> { UsbPath::from(port_path.as_ref()) .port_path() .and_then(|pp| self.get_node(&pp)) } /// Search for [`Device`] in branches of bus by Path and return mutable reference pub fn get_node_path_by_path_mut>( &mut self, port_path: P, ) -> Option<&mut Device> { UsbPath::from(port_path.as_ref()) .port_path() .and_then(|pp| self.get_node_mut(&pp)) } /// Search for reference to [`Device`] at port path as string pub fn get_node_by_str(&self, path: &str) -> Option<&Device> { PortPath::try_from(path) .ok() .and_then(|pp| self.get_node(&pp)) } /// Search for mutable reference to [`Device`] at port path as string pub fn get_node_str_mut(&mut self, path: &str) -> Option<&mut Device> { PortPath::try_from(path) .ok() .and_then(|pp| self.get_node_mut(&pp)) } /// Get reference to [`Configuration`] at [`PortPath`] and `config` if present pub fn get_config(&self, port_path: &PortPath, config: u8) -> Option<&Configuration> { self.get_node(port_path).and_then(|d| d.get_config(config)) } /// Get mutable reference to [`Configuration`] at [`PortPath`] and `config` if present pub fn get_config_mut( &mut self, port_path: &PortPath, config: u8, ) -> Option<&mut Configuration> { self.get_node_mut(port_path) .and_then(|d| d.get_config_mut(config)) } /// Get reference to [`Interface`] at [`DevicePath`] if config and interface are present pub fn get_interface(&self, device_path: &DevicePath) -> Option<&Interface> { if let (Some(config), Some(interface)) = (device_path.configuration(), device_path.interface()) { self.get_node(device_path.port_path()) .and_then(|d| d.get_interface(config, interface, device_path.alt_setting())) } else { None } } /// Get mutable reference to [`Interface`] at [`DevicePath`] if config and interface are present pub fn get_interface_mut(&mut self, device_path: &DevicePath) -> Option<&mut Interface> { if let (Some(config), Some(interface)) = (device_path.configuration(), device_path.interface()) { self.get_node_mut(device_path.port_path()) .and_then(|d| d.get_interface_mut(config, interface, device_path.alt_setting())) } else { None } } /// Get reference to [`Endpoint`] at [`EndpointPath`] if config and interface are present pub fn get_endpoint(&self, endpoint_path: &EndpointPath) -> Option<&Endpoint> { if let (Some(config), Some(interface), endpoint) = ( endpoint_path.device_path().configuration(), endpoint_path.device_path().interface(), endpoint_path.endpoint(), ) { self.get_node(endpoint_path.device_path().port_path()) .and_then(|d| { d.get_endpoint( config, interface, endpoint_path.device_path().alt_setting(), endpoint, ) }) } else { None } } /// Get mutable reference to [`Endpoint`] at [`EndpointPath`] if config and interface are present pub fn get_endpoint_mut(&mut self, endpoint_path: &EndpointPath) -> Option<&mut Endpoint> { if let (Some(config), Some(interface), endpoint) = ( endpoint_path.device_path().configuration(), endpoint_path.device_path().interface(), endpoint_path.endpoint(), ) { self.get_node_mut(endpoint_path.device_path().port_path()) .and_then(|d| { d.get_endpoint_mut( config, interface, endpoint_path.device_path().alt_setting(), endpoint, ) }) } else { None } } #[cfg(feature = "nusb")] /// Search for [`::nusb::DeviceId`] in branches of bus and return reference pub fn get_id(&self, id: &::nusb::DeviceId) -> Option<&Device> { if let Some(devices) = self.devices.as_ref() { for dev in devices { if let Some(node) = dev.get_id(id) { return Some(node); } } } None } #[cfg(feature = "nusb")] /// Search for [`::nusb::DeviceId`] in branches of bus and returns a mutable reference if found pub fn get_id_mut(&mut self, id: &::nusb::DeviceId) -> Option<&mut Device> { if let Some(devices) = self.devices.as_mut() { for dev in devices { if let Some(node) = dev.get_id_mut(id) { return Some(node); } } } None } /// Generate a String from self like lsusb default list device pub fn to_lsusb_string(&self) -> String { format!( "Bus {:03} Device 000: ID {:04x}:{:04x} {} {}", self.get_bus_number().unwrap_or(0xff), self.pci_vendor.unwrap_or(0xffff), self.pci_device.unwrap_or(0xffff), self.name, self.host_controller, ) } /// Generate a Vec of Strings from self in lsusb tree self in order of verbosity /// /// Only Linux systems with a root_hub will contain accurate data, others are mainly for styling pub fn to_lsusb_tree_string(&self, verbosity: u8) -> Vec { let mut ret: Vec = Vec::with_capacity(verbosity as usize); if let Some(root_device) = self.get_root_hub_device() { let speed = match &root_device.device_speed { Some(v) => match v { DeviceSpeed::SpeedValue(v) => v.to_lsusb_speed(), DeviceSpeed::Description(_) => String::new(), }, None => String::from(""), }; // no fallback for lsusb tree mode let (driver, vendor, product, ports) = match &root_device.extra { Some(v) => ( v.driver.to_owned().unwrap_or(String::from("[none]")), v.vendor.to_owned().unwrap_or(String::from("[unknown]")), v.product_name .to_owned() .unwrap_or(String::from("[unknown]")), v.hub.to_owned().map(|h| h.num_ports), ), None => ( String::from("[none]"), String::from("[unknown]"), String::from("[unknown]"), None, ), }; let driver_string = if let Some(ports) = ports { format!("{driver}/{ports}p") } else { driver }; ret.push(format!( "Bus {:03}.Port 001: Dev 001, Class=root_hub, Driver={}, {}", self.get_bus_number().unwrap_or(0xff), driver_string, speed )); if verbosity > 0 { ret.push(format!( "ID {:04x}:{:04x} {} {}", self.pci_vendor.unwrap_or(0xFFFF), self.pci_device.unwrap_or(0xFFFF), vendor, product )); } if verbosity > 1 { ret.push(format!( "/sys/bus/usb/devices/usb{} {}", self.get_bus_number().unwrap_or(0xff), get_dev_path(self.get_bus_number().unwrap_or(0xff), None).display() )); } } else { log::warn!("Failed to get root_device in bus"); ret.push(format!( "Bus {:03}.Port 001: Dev 001, Class=root_hub, Driver=[none],", self.get_bus_number().unwrap_or(0xff), )); if verbosity > 0 { ret.push(format!( "ID {:04x}:{:04x} {} {}", self.pci_vendor.unwrap_or(0xFFFF), self.pci_device.unwrap_or(0xFFFF), self.host_controller, self.name, )); } if verbosity > 1 { ret.push(format!( "/sys/bus/usb/devices/usb{} {}", self.get_bus_number().unwrap_or(0xff), get_dev_path(self.get_bus_number().unwrap_or(0xff), None).display() )); } } ret } pub(crate) fn fill_host_controller_from_ids(&mut self) { if let (Some(v), Some(p)) = (self.pci_vendor, self.pci_device) { if let Some(d) = pci_ids::Device::from_vid_pid(v, p) { self.host_controller_vendor = Some(d.vendor().name().to_string()); self.host_controller_device = Some(d.name().to_string()); } } } /// Should the bus be hidden when printing pub fn is_hidden(&self) -> bool { self.internal.hidden } /// Should the bus be expanded when printing pub fn is_expanded(&self) -> bool { self.internal.expanded } /// Toggle the expanded state of the bus pub fn toggle_expanded(&mut self) { self.internal.expanded = !self.internal.expanded; } /// Set the expanded state of the bus and all devices pub fn set_all_expanded(&mut self, expanded: bool) { self.internal.expanded = expanded; if let Some(devices) = self.devices.as_mut() { for dev in devices { dev.set_all_expanded(expanded); } } } } /// Recursively writeln! of all [`Device`] references pub fn write_devices_recursive(f: &mut fmt::Formatter, devices: &Vec) -> fmt::Result { for device in devices { // don't print root hubs in tree if f.sign_plus() && device.is_root_hub() { continue; } // print the device details if f.alternate() { if f.sign_plus() { writeln!(f, "{device:+#}")?; } else { writeln!(f, "{device:#}")?; } } else if f.sign_plus() { writeln!(f, "{device:+}")?; } else { writeln!(f, "{device}")?; } // print all devices with this device - if hub for example device .devices .as_ref() .map_or(Ok(()), |d| write_devices_recursive(f, d))? } Ok(()) } impl fmt::Display for Bus { fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result { // use plus formatter to add tree let tree: &str = if !f.sign_plus() { "" } else if f.alternate() { "\u{25CF} " } else { "/: " }; // write the bus details - alternative for coloured and apple info style if f.alternate() { writeln!( f, "{:}{:} {:} {:}:{:} Revision: 0x{:04x}", tree.bright_black().bold(), self.name.blue(), self.host_controller.green(), format!("0x{:04x}", self.pci_vendor.unwrap_or(0xffff)) .yellow() .bold(), format!("0x{:04x}", self.pci_device.unwrap_or(0xffff)).yellow(), self.pci_revision.unwrap_or(0xffff), )?; } else if f.sign_plus() { writeln!( f, "{}{}", tree, self.to_lsusb_tree_string(0).first().unwrap() )?; } else { writeln!(f, "{}", self.to_lsusb_string())? } // followed by devices if there are some self.devices .as_ref() .map_or(Ok(()), |d| write_devices_recursive(f, d)) } } /// location_id `String` from system_profiler is "LocationReg / DeviceNo" /// The LocationReg has the tree structure (0xbbdddddd): /// /// 0x -- always /// bb -- bus number in hexadecimal /// dddddd -- up to six levels for the tree, each digit represents its /// position on that level #[derive(Debug, Default, Clone, PartialEq, Serialize, Eq)] pub struct DeviceLocation { /// Number of bus attached too pub bus: u8, /// Length is depth in tree and position at each branch, empty is bus controller pub tree_positions: Vec, /// Device number on bus, generally not related to tree pub number: u8, } /// Converts from macOS system_profiler string to `DeviceLocation` impl FromStr for DeviceLocation { type Err = Error; fn from_str(s: &str) -> Result { let location_split: Vec<&str> = s.split('/').collect(); match (location_split.first(), location_split.get(1)) { (Some(reg), Some(dev)) => { let reg = reg.trim().trim_start_matches("0x"); let tree_positions: Vec = reg .get(2..) .unwrap_or("0") .trim_end_matches('0') .chars() .map(|v| v.to_digit(10).unwrap_or(0) as u8) .collect(); // bus no is msb let bus = (u32::from_str_radix(reg, 16) .map_err(|v| Error::new(ErrorKind::Parsing, &v.to_string()))? >> 24) as u8; let number = dev.trim().parse::().map_err(|v| { Error::new( ErrorKind::Parsing, &format!("Invalid device number: {dev} {v}"), ) })?; Ok(DeviceLocation { bus, tree_positions, number, }) } (Some(reg), None) => { let reg = reg.trim().trim_start_matches("0x"); let tree_positions: Vec = reg .get(2..) .unwrap_or("0") .trim_end_matches('0') .chars() .map(|v| v.to_digit(10).unwrap_or(0) as u8) .collect(); // bus no is msb let bus = (u32::from_str_radix(reg, 16) .map_err(|v| Error::new(ErrorKind::Parsing, &v.to_string()))? >> 24) as u8; // make it up but unique let number = tree_positions.iter().sum(); Ok(DeviceLocation { bus, tree_positions, number, }) } _ => Err(Error::new(ErrorKind::Parsing, "Invalid location_id")), } } } impl From for PortPath { fn from(location: DeviceLocation) -> Self { PortPath::new(location.bus, location.tree_positions) } } impl<'de> Deserialize<'de> for DeviceLocation { fn deserialize(deserializer: D) -> core::result::Result where D: Deserializer<'de>, { #[derive(Deserialize)] #[serde(field_identifier, rename_all = "snake_case")] enum Field { Bus, Number, TreePositions, } struct DeviceLocationVisitor; impl<'de> Visitor<'de> for DeviceLocationVisitor { type Value = DeviceLocation; fn expecting(&self, formatter: &mut fmt::Formatter) -> fmt::Result { formatter.write_str("a string with 0xLOCATION_REG/DEVICE_NO") } fn visit_seq(self, mut seq: V) -> core::result::Result where V: SeqAccess<'de>, { let bus = seq .next_element()? .ok_or_else(|| de::Error::invalid_length(0, &self))?; let tree_positions = seq .next_element()? .ok_or_else(|| de::Error::invalid_length(1, &self))?; let number = seq .next_element()? .ok_or_else(|| de::Error::invalid_length(2, &self))?; Ok(DeviceLocation { bus, number, tree_positions, }) } fn visit_map(self, mut map: V) -> core::result::Result where V: MapAccess<'de>, { let mut bus = None; let mut number = None; let mut tree_positions = None; while let Some(key) = map.next_key()? { match key { Field::Bus => { if bus.is_some() { return Err(de::Error::duplicate_field("bus")); } bus = Some(map.next_value()?); } Field::Number => { if number.is_some() { return Err(de::Error::duplicate_field("number")); } number = Some(map.next_value()?); } Field::TreePositions => { if tree_positions.is_some() { return Err(de::Error::duplicate_field("tree_positions")); } tree_positions = Some(map.next_value()?); } } } let bus = bus.ok_or_else(|| de::Error::missing_field("bus"))?; let number = number.ok_or_else(|| de::Error::missing_field("number"))?; let tree_positions = tree_positions.ok_or_else(|| de::Error::missing_field("tree_positions"))?; Ok(DeviceLocation { bus, number, tree_positions, }) } fn visit_string(self, value: String) -> core::result::Result where E: de::Error, { DeviceLocation::from_str(value.as_str()).map_err(serde::de::Error::custom) } fn visit_str(self, value: &str) -> core::result::Result where E: de::Error, { DeviceLocation::from_str(value).map_err(serde::de::Error::custom) } } deserializer.deserialize_any(DeviceLocationVisitor) } } /// Used for macOS system_profiler dump. Speed is a snake_case string and in case we can't match to a [`Speed`], this allows the String to be stored and not panic #[derive(Debug, Clone, PartialEq, DeserializeFromStr, SerializeDisplay)] pub enum DeviceSpeed { /// Value as Deserialized into [`Speed`] SpeedValue(Speed), /// Failed to Deserialize so just the description provided by system_profiler Description(String), } impl fmt::Display for DeviceSpeed { fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result { match self { DeviceSpeed::SpeedValue(v) => { let dv = NumericalUnit::::from(v); if f.alternate() && dv.description.is_some() { write!(f, "{}", dv.description.unwrap()) } else { write!(f, "{dv:.1}") } } DeviceSpeed::Description(v) => { // don't print the description unless alt so it still fits in block if f.alternate() { write!(f, "{v}") } else { write!(f, "{:5} {:4}", "-", "-") } } } } } impl FromStr for DeviceSpeed { type Err = Error; fn from_str(s: &str) -> Result { // try to match speed enum else provide string description provided in system_profiler dump match Speed::from_str(s) { Ok(v) => Ok(DeviceSpeed::SpeedValue(v)), Err(_) => Ok(DeviceSpeed::Description(s.to_owned())), } } } /// Events used by the watch feature #[derive(Debug, Clone, Copy, PartialEq, Serialize, Deserialize)] #[serde(rename_all = "snake_case")] pub enum DeviceEvent { /// Device profiled at time Profiled(chrono::DateTime), /// Device connected at time Connected(chrono::DateTime), /// Device disconnected at time Disconnected(chrono::DateTime), } impl fmt::Display for DeviceEvent { fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result { match self { DeviceEvent::Profiled(t) => write!(f, "P: {}", t.format("%y-%m-%d %H:%M:%S")), DeviceEvent::Connected(t) => write!(f, "C: {}", t.format("%y-%m-%d %H:%M:%S")), DeviceEvent::Disconnected(t) => { write!(f, "D: {}", t.format("%y-%m-%d %H:%M:%S")) } } } } impl Default for DeviceEvent { fn default() -> Self { DeviceEvent::Profiled(chrono::Local::now()) } } impl DeviceEvent { /// Get the time of the event pub fn time(&self) -> chrono::DateTime { match self { DeviceEvent::Profiled(t) => *t, DeviceEvent::Connected(t) => *t, DeviceEvent::Disconnected(t) => *t, } } /// Format the event time using the provided format string pub fn format(&self, fmt: &str) -> String { self.time().format(fmt).to_string() } } #[derive(Debug, Default, Clone, Serialize, Deserialize)] /// Internal data used by cyme for display pub struct InternalData { pub(crate) expanded: bool, pub(crate) hidden: bool, } /// USB device data based on JSON object output from system_profiler but now used for other platforms /// /// Designed to hold static data for the device, obtained from system_profiler Deserializer or cyme::lsusb. Fields should probably be non-pub with getters/setters but treat them as read-only. #[skip_serializing_none] #[derive(Debug, Default, Clone, Serialize, Deserialize)] pub struct Device { /// The device product name as reported in descriptor or using usb_ids if None #[serde(rename(deserialize = "_name"), alias = "name")] pub name: String, #[serde(default, deserialize_with = "deserialize_option_number_from_string")] /// Unique vendor identifier - purchased from USB IF pub vendor_id: Option, #[serde(default, deserialize_with = "deserialize_option_number_from_string")] /// Vendor unique product identifier pub product_id: Option, /// [`DeviceLocation`] information of position within bus pub location_id: DeviceLocation, /// Device serial number as reported by descriptor pub serial_num: Option, /// The device manufacturer as provided in descriptor or using usb_ids if None pub manufacturer: Option, #[serde( default, serialize_with = "version_serializer", deserialize_with = "deserialize_option_version_from_string" )] /// The device release number set by the developer as a [`Version`] pub bcd_device: Option, #[serde( default, serialize_with = "version_serializer", deserialize_with = "deserialize_option_version_from_string" )] /// The highest version of USB the device supports as a [`Version`] pub bcd_usb: Option, #[serde(default, deserialize_with = "deserialize_option_number_from_string")] /// macOS system_profiler only - actually bus current in mA not power! pub bus_power: Option, #[serde(default, deserialize_with = "deserialize_option_number_from_string")] /// macOS system_profiler only - actually bus current used in mA not power! pub bus_power_used: Option, /// Advertised device capable speed /// /// See [`DeviceExtra`] for negotiated speed pub device_speed: Option, #[serde(default, deserialize_with = "deserialize_option_number_from_string")] /// macOS system_profiler only - actually bus current used in mA not power! pub extra_current_used: Option, /// Devices can be hub and have devices attached so need to walk each device's devices... #[serde(rename(deserialize = "_items"), alias = "devices")] pub devices: Option>, // below are not in macOS system profiler but useful enough to have outside of extra /// USB device class pub class: Option, /// USB sub-class pub sub_class: Option, /// USB protocol pub protocol: Option, /// Extra data obtained by libusb/udev exploration #[serde(default)] pub extra: Option, /// Internal to store any non-critical errors captured whilst profiling, unable to open for example #[serde(skip)] pub profiler_error: Option, /// Unique ID assigned by system #[serde(skip)] #[cfg(feature = "nusb")] pub id: Option<::nusb::DeviceId>, /// Last event that occurred on device pub last_event: Option, /// Internal data for cyme #[serde(skip)] pub internal: InternalData, } /// Deprecated alias for [`Device`] #[deprecated(since = "2.0.0", note = "Use Device instead")] pub type USBDevice = Device; #[cfg(feature = "nusb")] impl PartialEq for Device { fn eq(&self, other: &Self) -> bool { (self.id == other.id) && self.id.is_some() } } impl Device { /// Does the device have child devices; `devices` is Some and > 0 pub fn has_devices(&self) -> bool { match &self.devices { Some(d) => !d.is_empty() && !d.iter().all(|dd| dd.internal.hidden), None => false, } } /// Returns total number of devices in the tree including self fn len(&self) -> usize { 1 + self .devices .as_ref() .map_or(0, |d| d.iter().map(|dd| dd.len()).sum()) } /// Does the device have an interface with `class` pub fn has_interface_class(&self, c: &BaseClass) -> bool { if let Some(extra) = self.extra.as_ref() { extra .configurations .iter() .any(|conf| conf.interfaces.iter().any(|i| i.class == *c)) } else { false } } /// Gets root_hub [`Device`] if it is one pub fn get_root_hub(&self) -> Option<&Device> { if self.is_root_hub() { Some(self) } else { None } } /// Gets mutable root_hub [`Device`] if it is one pub fn get_root_hub_mut(&mut self) -> Option<&mut Device> { if self.is_root_hub() { Some(self) } else { None } } /// Recursively walk all [`Device`] from self, looking for the one with [`PortPath`] and returning reference pub fn get_node(&self, port_path: &PortPath) -> Option<&Device> { if port_path.is_root_hub() { return self.get_root_hub(); } let search_depth = port_path.depth(); let current_depth = self.get_depth(); let self_port_path = self.port_path(); log::debug!( "Get node @ {port_path}: exploring {self_port_path} ({self}); depth {current_depth}/{search_depth}" ); // should not be looking for nodes below us unless root match current_depth.cmp(&search_depth) { Ordering::Greater => return None, Ordering::Equal => { if self_port_path == *port_path { return Some(self); } else { return None; } } Ordering::Less => {} } // else walk through devices recursively running function and returning if found if let Some(devices) = self.devices.as_ref() { for dev in devices { if let Some(node) = dev.get_node(port_path) { return Some(node); } } } None } /// Recursively walk all [`Device`] from self, looking for the one with [`PortPath`] and returning mutable pub fn get_node_mut(&mut self, port_path: &PortPath) -> Option<&mut Device> { if port_path.is_root_hub() { return self.get_root_hub_mut(); } let search_depth = port_path.depth(); let current_depth = self.get_depth(); let self_port_path = self.port_path(); log::debug!( "Get node @ {port_path}: exploring {self_port_path} ({self}); depth {current_depth}/{search_depth}" ); // should not be looking for nodes below us match current_depth.cmp(&search_depth) { Ordering::Greater => return None, Ordering::Equal => { if self_port_path == *port_path { return Some(self); } else { return None; } } Ordering::Less => {} } // else walk through devices recursively running function and returning if found if let Some(devices) = self.devices.as_mut() { for dev in devices { if let Some(node) = dev.get_node_mut(port_path) { return Some(node); } } } None } /// Find the [`Device`] by it's Path pub fn get_node_by_path>(&self, path: P) -> Option<&Device> { UsbPath::from(path.as_ref()) .port_path() .and_then(|pp| self.get_node(&pp)) } /// Find the mutable [`Device`] by it's Path pub fn get_node_mut_by_path>(&mut self, path: P) -> Option<&mut Device> { UsbPath::from(path.as_ref()) .port_path() .and_then(|pp| self.get_node_mut(&pp)) } /// Search for reference to [`Device`] at port path as string pub fn get_node_by_str(&self, path: &str) -> Option<&Device> { PortPath::try_from(path) .ok() .and_then(|pp| self.get_node(&pp)) } /// Search for mutable reference to [`Device`] at port path as string pub fn get_node_str_mut(&mut self, path: &str) -> Option<&mut Device> { PortPath::try_from(path) .ok() .and_then(|pp| self.get_node_mut(&pp)) } /// Get the [`Configuration`] with number `config` from the device's extra data pub fn get_config(&self, config: u8) -> Option<&Configuration> { self.extra .as_ref() .and_then(|e| e.configurations.iter().find(|c| c.number == config)) } /// Get the mutable [`Configuration`] with number `config` from the device's extra data pub fn get_config_mut(&mut self, config: u8) -> Option<&mut Configuration> { self.extra .as_mut() .and_then(|e| e.configurations.iter_mut().find(|c| c.number == config)) } /// Get the [`Interface`] with number `interface` from the device's extra data pub fn get_interface(&self, config: u8, interface: u8, alt_setting: u8) -> Option<&Interface> { self.get_config(config).and_then(|c| { c.interfaces .iter() .find(|i| i.number == interface && i.alt_setting == alt_setting) }) } /// Get the mutable [`Interface`] with number `interface` from the device's extra data pub fn get_interface_mut( &mut self, config: u8, interface: u8, alt_setting: u8, ) -> Option<&mut Interface> { self.get_config_mut(config).and_then(|c| { c.interfaces .iter_mut() .find(|i| i.number == interface && i.alt_setting == alt_setting) }) } /// Get the [`Endpoint`] with number `endpoint` from the device's extra data pub fn get_endpoint( &self, config: u8, interface: u8, alt_setting: u8, endpoint_address: u8, ) -> Option<&Endpoint> { self.get_interface(config, interface, alt_setting) .and_then(|i| { i.endpoints .iter() .find(|e| e.address.address == endpoint_address) }) } /// Get the mutable [`Endpoint`] with number `endpoint` from the device's extra data pub fn get_endpoint_mut( &mut self, config: u8, interface: u8, alt_setting: u8, endpoint_address: u8, ) -> Option<&mut Endpoint> { self.get_interface_mut(config, interface, alt_setting) .and_then(|i| { i.endpoints .iter_mut() .find(|e| e.address.address == endpoint_address) }) } /// Returns position on branch (parent), which is the last number in `tree_positions` also sometimes referred to as port pub fn get_branch_position(&self) -> u8 { // root hub could be [] or [0] but we want to return 0 self.location_id.tree_positions.last().copied().unwrap_or(0) } /// The number of [`Device`] deep; branch depth pub fn get_depth(&self) -> usize { self.location_id.tree_positions.len() } /// Returns `true` if device is a hub based on device name - not perfect but most hubs advertise as a hub in name - or class code if it has one pub fn is_hub(&self) -> bool { self.name.to_lowercase().contains("hub") || self.class.as_ref().is_some_and(|c| *c == BaseClass::Hub) } /// [`PortPath`] of the [`Device`] pub fn port_path(&self) -> PortPath { self.location_id.clone().into() } /// Linux style port path where it can be found on system device path - normally /sys/bus/usb/devices pub fn sysfs_path(&self) -> PathBuf { UsbPath::from(self.port_path()).to_sysfs_path() } /// [`PortPath`] of parent [`Device`]; one above in tree pub fn parent_port_path(&self) -> Option { self.port_path().parent() } /// [`PortPath`] of trunk [`Device`]; first in tree pub fn trunk_port_path(&self) -> PortPath { self.port_path().trunk() } /// Linux devpath to [`Device`] pub fn dev_path(&self) -> PathBuf { get_dev_path(self.location_id.bus, Some(self.location_id.number)) } /// Linux sysfs name of [`Device`] pub fn sysfs_name(&self) -> String { get_sysfs_name(self.location_id.bus, &self.location_id.tree_positions) } /// Trunk device is first in tree pub fn is_trunk_device(&self) -> bool { self.location_id.tree_positions.len() == 1 } /// Root hub is a specific device on Linux, essentially the bus but sits in device tree because of system_profiler legacy pub fn is_root_hub(&self) -> bool { self.location_id.tree_positions.is_empty() || self.location_id.tree_positions == [0] } /// From lsusb.c: Attempt to get friendly vendor and product names from the udev hwdb. If either or both are not present, instead populate those from the device's own string descriptors pub fn get_vendor_product_with_fallback(&self) -> (String, String) { match &self.extra { Some(v) => ( v.vendor .to_owned() .unwrap_or(self.manufacturer.to_owned().unwrap_or_default()), v.product_name .to_owned() .unwrap_or(self.name.trim().to_owned()), ), None => ( self.manufacturer.to_owned().unwrap_or_default(), self.name.trim().to_owned(), ), } } /// Generate a String from self like lsusb default list device /// ``` /// let d = cyme::profiler::Device{ /// name: String::from("Test device"), /// manufacturer: Some(String::from("Test Devices Inc.")), /// vendor_id: Some(0x1234), /// product_id: Some(0x4321), /// location_id: cyme::profiler::DeviceLocation { bus: 1, number: 4, tree_positions: vec![1, 2, 3] }, /// ..Default::default() /// }; /// assert_eq!(d.to_lsusb_string(), "Bus 001 Device 004: ID 1234:4321 Test Devices Inc. Test device"); /// ``` pub fn to_lsusb_string(&self) -> String { let (vendor, product) = self.get_vendor_product_with_fallback(); format!( "Bus {:03} Device {:03}: ID {:04x}:{:04x} {} {}", self.location_id.bus, self.location_id.number, self.vendor_id.unwrap_or(0xffff), self.product_id.unwrap_or(0xffff), vendor, product, ) } /// Generate a Vec of Vec from self like lsusb tree mode in order of verbosity /// /// Each device contains of Vec of interfaces pub fn to_lsusb_tree_strings(&self, verbosity: u8) -> Vec> { let mut ret = Vec::new(); let speed = match &self.device_speed { Some(v) => match v { DeviceSpeed::SpeedValue(v) => v.to_lsusb_speed(), DeviceSpeed::Description(_) => String::new(), }, None => String::from(""), }; // no fallback for lsusb tree mode let (driver, vendor, product) = match &self.extra { Some(v) => ( v.driver.to_owned().unwrap_or(String::from("[none]")), v.vendor.to_owned().unwrap_or(String::from("[unknown]")), v.product_name .to_owned() .unwrap_or(String::from("[unknown]")), ), None => ( String::from("[none]"), String::from("[unknown]"), String::from("[unknown]"), ), }; let get_istrings = || match ( &self.name, self.manufacturer.as_ref(), self.serial_num.as_ref(), ) { (n, Some(m), Some(s)) => { format!("Manufactuer={n} Product={m} Serial={s}") } (n, Some(m), None) => { format!("Manufactuer={n} Product={m}") } (n, None, Some(s)) => { format!("Product={n} Serial={s}") } (n, None, None) => { format!("Product={n}") } }; if let Some(extra) = self.extra.as_ref() { let ports = extra.hub.as_ref().map(|hub| hub.num_ports); for config in &extra.configurations { for interface in &config.interfaces { let mut device_strings = Vec::with_capacity(verbosity as usize); let interface_driver = interface .driver .as_ref() .map_or(String::from("[none]"), |d| d.to_string()); // if there are ports (device is hub), add them to the driver string let driver_string = if let Some(p) = ports { format!("{interface_driver}/{p}p") } else { interface_driver }; device_strings.push(format!( "Port {:03}: Dev {:03}, If {}, Class={}, Driver={}, {}", self.get_branch_position(), self.location_id.number, interface.number, interface.class.to_lsusb_string(), driver_string, speed )); if verbosity > 0 { device_strings.push(format!( "ID {:04x}:{:04x} {} {}", self.vendor_id.unwrap_or(0xFFFF), self.product_id.unwrap_or(0xFFFF), vendor, product, )); } if verbosity > 1 { device_strings.push(format!( "{}/{} {}", "/sys/bus/usb/devices", self.port_path(), self.dev_path().display(), )); } if verbosity > 2 { device_strings.push(get_istrings()); } ret.push(device_strings); } } } else { log::warn!("Rendering {self} lsusb tree without extra data because it is missing. No configurations or interfaces will be shown"); let mut device_strings = Vec::with_capacity(verbosity as usize); device_strings.push(format!( "Port {:03}: Dev {:03}, If {}, Class={}, Driver={}, {}", self.get_branch_position(), self.location_id.number, 0, self.class .as_ref() .map_or(String::from("[unknown]"), |c| c.to_lsusb_string()), driver, speed )); if verbosity > 0 { device_strings.push(format!( "ID {:04x}:{:04x} {} {}", self.vendor_id.unwrap_or(0xFFFF), self.product_id.unwrap_or(0xFFFF), // these are actually usb_ids vendor/product but don't have those without extra self.manufacturer .as_ref() .unwrap_or(&String::from("[unknown]")), self.name, )); } if verbosity > 1 { device_strings.push(format!( "{}/{} {}", "/sys/bus/usb/devices", self.port_path(), self.dev_path().display(), )); } if verbosity > 2 { device_strings.push(get_istrings()); } ret.push(device_strings); } ret } /// Gets the base class code byte from [`BaseClass`] pub fn base_class_code(&self) -> Option { self.class.as_ref().map(|c| u8::from(*c)) } /// Name of class from Linux USB IDs repository pub fn class_name(&self) -> Option<&str> { match self.base_class_code() { Some(cid) => usb_ids::Classes::iter() .find(|c| c.id() == cid) .map(|c| c.name()), None => None, } } /// Name of sub class from Linux USB IDs repository pub fn sub_class_name(&self) -> Option<&str> { match (self.base_class_code(), self.sub_class) { (Some(cid), Some(sid)) => { usb_ids::SubClass::from_cid_scid(cid, sid).map(|sc| sc.name()) } _ => None, } } /// Name of protocol from Linux USB IDs repository pub fn protocol_name(&self) -> Option<&str> { match (self.base_class_code(), self.sub_class, self.protocol) { (Some(cid), Some(sid), Some(pid)) => { usb_ids::Protocol::from_cid_scid_pid(cid, sid, pid).map(|p| p.name()) } _ => None, } } /// Returns fully defined USB [`Class`] based on base_class, sub_class and protocol triplet pub fn fully_defined_class(&self) -> Option { self.class .map(|c| (c, self.sub_class.unwrap_or(0), self.protocol.unwrap_or(0)).into()) } /// Recursively gets all devices in a [`Device`] and flattens them into a Vec of references, including self pub fn flatten(&self) -> Vec<&Device> { let mut ret: Vec<&Device> = Vec::with_capacity(self.len()); ret.push(self); if let Some(d) = self.devices.as_ref() { for child in d { ret.extend(child.flatten()); } } ret } /// Recursively gets all devices in a [`Device`] and flattens them into a Vec of mutable references, **excluding** self pub fn flatten_mut(&mut self) -> Vec<&mut Device> { if let Some(d) = self.devices.as_mut() { d.iter_mut() .flat_map(|d| d.flatten_mut()) .collect::>() } else { Vec::new() } } /// Recursively gets all devices in a [`Device`] and flattens them into a Vec, including self /// /// Similar to `flatten` but flattens in place rather than returning references so is destructive pub fn into_flattened(mut self) -> Vec { let mut ret: Vec = Vec::with_capacity(self.len()); if let Some(mut d) = self.devices.take() { while let Some(child) = d.pop() { ret.extend(child.into_flattened()); } } ret.insert(0, self); ret } /// Recursively searches for a device with a specific [`::nusb::DeviceId`] and returns a reference #[cfg(feature = "nusb")] pub fn get_id(&self, id: &::nusb::DeviceId) -> Option<&Self> { if self.id == Some(*id) { return Some(self); } if let Some(devices) = self.devices.as_ref() { for dev in devices { if let Some(node) = dev.get_id(id) { return Some(node); } } } None } /// Recursively searches for a device with a specific [`::nusb::DeviceId`] and returns a mutable reference #[cfg(feature = "nusb")] pub fn get_id_mut(&mut self, id: &::nusb::DeviceId) -> Option<&mut Self> { if self.id == Some(*id) { return Some(self); } if let Some(devices) = self.devices.as_mut() { for dev in devices { if let Some(node) = dev.get_id_mut(id) { return Some(node); } } } None } /// Get last event that occurred on device pub fn last_event(&self) -> Option { self.last_event } /// Has the device disconnected based last event being disconnected /// /// Logic rather than is_connected since Profiled event is not certain still present pub fn is_disconnected(&self) -> bool { matches!(self.last_event, Some(DeviceEvent::Disconnected(_))) } /// Should the device be hidden when printing pub fn is_hidden(&self) -> bool { self.internal.hidden } /// Should the device be displayed expanded in a tree pub fn is_expanded(&self) -> bool { self.internal.expanded } /// Toggle the expanded state of the device pub fn toggle_expanded(&mut self) { self.internal.expanded = !self.internal.expanded; } /// Set the expanded state of the device and all configurations, interfaces and endpoints pub fn set_all_expanded(&mut self, expanded: bool) { self.internal.expanded = expanded; if let Some(extra) = self.extra.as_mut() { for config in &mut extra.configurations { config.set_all_expanded(expanded); } } } } impl fmt::Display for Device { fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result { let mut spaces = if f.sign_plus() { self.location_id.tree_positions.len() * 4 } else { 0 }; // map speed from text back to data rate if tree let speed = match &self.device_speed { Some(v) => v.to_string(), None => String::from(""), }; // tree chars to prepend if plus formatted let tree: &str = if !f.sign_plus() { "" } else if f.alternate() { "\u{2514}\u{2500}\u{2500} " } else { "|__ " }; // alternate for coloured, slightly different format to lsusb if f.alternate() { write!( f, "{:>spaces$}{}/{} {}:{} {} {} {}", tree.bright_black(), format!("{:03}", self.location_id.bus).cyan(), format!("{:03}", self.location_id.number).magenta(), format!("0x{:04x}", self.vendor_id.unwrap_or(0)) .yellow() .bold(), format!("0x{:04x}", self.product_id.unwrap_or(0)).yellow(), self.name.trim().bold().blue(), self.serial_num .as_ref() .unwrap_or(&String::from("None")) .trim() .green(), speed.purple() ) } else { // show what we can for lsusb style tree, driver and class can be just , if f.sign_plus() { // add 3 because lsusb is aligned with parent if spaces > 0 { spaces += 3; } let interface_strs: Vec = self .to_lsusb_tree_strings(0) .iter() .map(|s| format!("{:>spaces$}{}", tree, s[0])) .collect(); write!(f, "{}", interface_strs.join("\n\r")) } else { write!(f, "{}", self.to_lsusb_string()) } } } } impl<'a> IntoIterator for &'a Device { type Item = &'a Device; type IntoIter = std::vec::IntoIter; fn into_iter(self) -> std::vec::IntoIter { if let Some(d) = self.devices.as_ref() { d.iter() .flat_map(|d| d.flatten()) .collect::>() .into_iter() } else { Vec::new().into_iter() } } } impl<'a> IntoIterator for &'a mut Device { type Item = &'a mut Device; type IntoIter = std::vec::IntoIter; fn into_iter(self) -> std::vec::IntoIter { self.flatten_mut().into_iter() } } /// Used to filter devices within buses /// /// The tree to a [`Device`] is kept even if parent branches are not matches. To avoid this, one must flatten the devices first. #[derive(Debug, Default, Serialize, Deserialize)] pub struct Filter { /// Retain only devices with vendor id matching this pub vid: Option, /// Retain only devices with product id matching this pub pid: Option, /// Retain only devices on this bus pub bus: Option, /// Retain only devices with this device number pub number: Option, /// Retain only devices with name.contains(name) pub name: Option, /// retain only devices with serial.contains(serial) pub serial: Option, /// retain only device of BaseClass class pub class: Option, /// Exclude empty buses in the tree pub exclude_empty_bus: bool, /// Exclude empty hubs in the tree pub exclude_empty_hub: bool, /// Don't exclude Linux root_hub devices - this is inverse because they are pseudo [`Bus`]'s in the tree pub no_exclude_root_hub: bool, /// Case sensitive matching for strings. False will be unless capital letter in query pub case_sensitive: bool, } /// Deprecated alias for [`Filter`] #[deprecated(since = "2.0.0", note = "Use Filter instead")] pub type USBFilter = Filter; /// Filter devices with name /// /// ``` /// use cyme::profiler::*; /// /// # let mut spusb = read_json_dump(&"./tests/data/system_profiler_dump.json").unwrap(); /// let filter = Filter { /// name: Some(String::from("Black Magic Probe")), /// ..Default::default() /// }; /// filter.retain_buses(&mut spusb.buses); /// let flattened = spusb.flattened_devices(); /// // node was on a hub so that will remain with it /// assert_eq!(flattened.len(), 2); /// // get the node from path known before for purpose of test /// let device = spusb.get_node_by_str("20-3.3"); /// assert_eq!(device.unwrap().name, "Black Magic Probe v1.8.2"); /// ``` /// /// Filter devices with vid and pid /// ``` /// use cyme::profiler::*; /// /// # let mut spusb = read_json_dump(&"./tests/data/system_profiler_dump.json").unwrap(); /// let filter = Filter { /// vid: Some(0x1d50), /// pid: Some(0x6018), /// ..Default::default() /// }; /// filter.retain_buses(&mut spusb.buses); /// let flattened = spusb.flattened_devices(); /// // node was on a hub so that will remain with it /// assert_eq!(flattened.len(), 2); /// // get the node from path known before for purpose of test /// let device = spusb.get_node_by_str("20-3.3"); /// assert_eq!(device.unwrap().vendor_id.unwrap(), 0x1d50); /// ``` /// /// Filter a flattened tree to exclude hubs /// /// ``` /// use cyme::profiler::*; /// /// # let mut spusb = read_json_dump(&"./tests/data/system_profiler_dump.json").unwrap(); /// let filter = Filter { /// number: Some(6), /// bus: Some(20), /// ..Default::default() /// }; /// let mut flattened = spusb.flattened_devices(); /// filter.retain_flattened_devices_ref(&mut flattened); /// // now no hub /// assert_eq!(flattened.len(), 1); /// assert_eq!(flattened.first().unwrap().name, "Black Magic Probe v1.8.2"); /// ``` /// /// Filter devices with class /// /// ``` /// use cyme::profiler::*; /// /// # let mut spusb = read_json_dump(&"./tests/data/cyme_libusb_merge_macos_tree.json").unwrap(); /// let filter = Filter { /// class: Some(cyme::usb::BaseClass::CdcCommunications), /// ..Default::default() /// }; /// let mut flattened = spusb.flattened_devices(); /// filter.retain_flattened_devices_ref(&mut flattened); /// // black magic probe has CDCCommunications serial /// let device = spusb.get_node_by_str("20-3.3"); /// assert_eq!(device.unwrap().name, "Black Magic Probe v1.8.2"); /// ``` /// impl Filter { /// Creates a new filter with defaults pub fn new() -> Self { Default::default() } fn string_match(&self, pattern: &Option, query: Option<&String>) -> bool { if let (Some(p), Some(q)) = (pattern, query) { let case_sensitive = if !self.case_sensitive { p.chars().any(|c| c.is_uppercase()) } else { self.case_sensitive }; if !case_sensitive { q.to_lowercase().contains(p.to_lowercase().as_str()) } else { q.contains(p.as_str()) } } else { true } } /// Checks whether `device` passes through filter pub fn is_match(&self, device: &Device) -> bool { (Some(device.location_id.bus) == self.bus || self.bus.is_none()) && (Some(device.location_id.number) == self.number || self.number.is_none()) && (device.vendor_id == self.vid || self.vid.is_none()) && (device.product_id == self.pid || self.pid.is_none()) && (self.string_match(&self.name, Some(&device.name))) && (self.string_match(&self.serial, device.serial_num.as_ref())) && self.class.as_ref().is_none_or(|fc| { device.class.as_ref() == Some(fc) || device.has_interface_class(fc) }) && !(self.exclude_empty_hub && device.is_hub() && !device.has_devices()) && (!device.is_root_hub() || self.no_exclude_root_hub) } /// Checks whether `bus` passes through filter pub fn is_bus_match(&self, bus: &Bus) -> bool { (bus.usb_bus_number == self.bus || self.bus.is_none() || bus.usb_bus_number.is_none()) && !(self.exclude_empty_bus && bus.is_empty()) } /// Recursively looks down tree for any `device` matching filter /// /// Important because a simple check of trunk device might remove a matching device further down the tree pub fn exists_in_tree(&self, device: &Device) -> bool { // if device itself is a match, just return now and don't bother going keeper if self.is_match(device) { return true; } match &device.devices { Some(devs) => devs.iter().any(|d| self.exists_in_tree(d)), None => false, } } /// Recursively retain only `Bus` in `buses` with `Device` matching filter pub fn retain_buses(&self, buses: &mut Vec) { // filter any empty or number matches buses.retain(|b| self.is_bus_match(b)); for bus in buses.iter_mut() { bus.devices.iter_mut().for_each(|d| self.retain_devices(d)); } // check bus match again in case empty after device filter buses.retain(|b| self.is_bus_match(b)); } /// Recursively hide `Bus` in `buses` with `Device` matching filter pub fn hide_buses(&self, buses: &mut [Bus]) { buses .iter_mut() .for_each(|b| b.internal.hidden = !self.is_bus_match(b)); for bus in buses.iter_mut() { bus.devices.iter_mut().for_each(|d| self.hide_devices(d)); } buses .iter_mut() .for_each(|b| b.internal.hidden = !self.is_bus_match(b)); } /// Recursively retain only `Device` in `devices` matching filter /// /// Note that non-matching parents will still be retained if they have a matching `Device` within their branches pub fn retain_devices(&self, devices: &mut Vec) { devices.retain(|d| self.exists_in_tree(d)); for d in devices { d.devices.iter_mut().for_each(|d| self.retain_devices(d)); } } /// Recursively retain only `Device` in `devices` matching filter pub fn hide_devices(&self, devices: &mut [Device]) { devices .iter_mut() .for_each(|d| d.internal.hidden = !self.exists_in_tree(d)); for d in devices { d.devices.iter_mut().for_each(|d| self.hide_devices(d)); } } /// Retains only `&Device` in `devices` which match filter /// /// Does not check down tree so should be used to flattened devices only (`get_all_devices`). Will remove hubs if `hide_hubs` since when flattened they will have no devices pub fn retain_flattened_devices_ref(&self, devices: &mut Vec<&Device>) { devices.retain(|d| self.is_match(d)) } } /// Reads a json dump at `file_path` with serde deserializer - either from `system_profiler` or from `cyme --json` /// /// Must be a full tree including buses. Use `read_flat_json_dump` for devices only pub fn read_json_dump>(file_path: P) -> Result { let mut file = fs::File::options().read(true).open(file_path.as_ref())?; let mut data = String::new(); file.read_to_string(&mut data)?; let json_dump: SystemProfile = serde_json::from_str(&data).map_err(|e| { Error::new( ErrorKind::Parsing, &format!( "Failed to parse dump at {:?}; Error({})", file_path.as_ref().display(), e ), ) })?; Ok(json_dump) } /// Reads a flat json dump (devices no buses) at `file_path` with serde deserializer - either from `system_profiler` or from `cyme --json` pub fn read_flat_json_dump>(file_path: P) -> Result> { let mut file = fs::File::options().read(true).open(file_path.as_ref())?; let mut data = String::new(); file.read_to_string(&mut data)?; let json_dump: Vec = serde_json::from_str(&data).map_err(|e| { Error::new( ErrorKind::Parsing, &format!( "Failed to parse dump at {:?}; Error({})", file_path.as_ref().display(), e ), ) })?; Ok(json_dump) } /// Reads a flat json dump (devices no buses) at `file_path` with serde deserializer from `cyme --json` and converts to `SPUSBDataType` /// /// This is useful for converting a flat json dump to a full tree for use with `Filter`. Bus information is phony however. pub fn read_flat_json_to_phony_bus>(file_path: P) -> Result { let devices = read_flat_json_dump(file_path)?; let bus = Bus { name: String::from("Phony Flat JSON Import Bus"), host_controller: String::from("Phony Host Controller"), host_controller_vendor: None, host_controller_device: None, pci_device: None, pci_vendor: None, pci_revision: None, usb_bus_number: None, devices: Some(devices), ..Default::default() }; Ok(SystemProfile { buses: vec![bus] }) } /// Deserializes an option number from String (base10 or base16 encoding) or a number /// /// Modified from https://github.com/vityafx/serde-aux/blob/master/src/field_attributes.rs with addition of base16 encoding fn deserialize_option_number_from_string<'de, T, D>( deserializer: D, ) -> core::result::Result, D::Error> where D: Deserializer<'de>, T: FromStr + serde::Deserialize<'de>, ::Err: fmt::Display, { #[derive(Deserialize)] #[serde(untagged)] enum NumericOrNull<'a, T> { Str(&'a str), FromStr(T), Null, } match NumericOrNull::::deserialize(deserializer)? { NumericOrNull::Str(mut s) => match s { "" => Ok(None), _ => { // -json returns apple_vendor_id in vendor_id for some reason not base16 like normal if s.contains("apple_vendor_id") { s = "0x05ac"; } // the vendor_id can be appended with manufacturer name for some reason...split with space to get just base16 encoding let vendor_vec: Vec<&str> = s.split(' ').collect(); if s.contains("0x") { let removed_0x = vendor_vec[0].trim_start_matches("0x"); let base16_num = u64::from_str_radix(removed_0x.trim(), 16); let result = match base16_num { Ok(num) => T::from_str(num.to_string().as_str()), Err(e) => return Err(serde::de::Error::custom(e)), }; result.map(Some).map_err(serde::de::Error::custom) } else { T::from_str(s.trim()) .map(Some) .map_err(serde::de::Error::custom) } } }, NumericOrNull::FromStr(i) => Ok(Some(i)), NumericOrNull::Null => Ok(None), } } fn deserialize_option_version_from_string<'de, D>( deserializer: D, ) -> core::result::Result, D::Error> where D: Deserializer<'de>, { #[derive(Deserialize)] #[serde(untagged)] enum VersionOrNull { #[serde(deserialize_with = "deserialize_version")] From(Version), Null, } match VersionOrNull::deserialize(deserializer)? { VersionOrNull::From(i) => Ok(Some(i)), VersionOrNull::Null => Ok(None), } } fn deserialize_version<'de, D>(deserializer: D) -> core::result::Result where D: serde::de::Deserializer<'de>, { struct VersionVisitor; impl serde::de::Visitor<'_> for VersionVisitor { type Value = Version; fn expecting(&self, formatter: &mut fmt::Formatter) -> fmt::Result { formatter.write_str("BCD version base16 encoding [MM.mP] where MM is Major, m is Minor and P is sub-minor") } fn visit_f32(self, value: f32) -> core::result::Result where E: serde::de::Error, { Version::try_from(value) .map_err(|_| E::invalid_value(serde::de::Unexpected::Float(value.into()), &self)) } fn visit_str(self, value: &str) -> core::result::Result where E: serde::de::Error, { Version::from_str(value) .map_err(|_| E::invalid_value(serde::de::Unexpected::Str(value), &self)) } } deserializer.deserialize_any(VersionVisitor) } fn version_serializer(version: &Option, s: S) -> core::result::Result where S: serde::ser::Serializer, { match version { Some(v) => s.serialize_str(&v.to_string()), None => s.serialize_none(), } } #[cfg(test)] mod tests { use super::*; #[test] fn test_deserialize_device() { let device_json = "{ \"_name\" : \"Arduino Zero\", \"bcd_device\" : \"1.00\", \"bus_power\" : \"500\", \"bus_power_used\" : \"500\", \"device_speed\" : \"full_speed\", \"extra_current_used\" : \"0\", \"location_id\" : \"0x02110000 / 3\", \"manufacturer\" : \"Arduino LLC\", \"product_id\" : \"0x804d\", \"serial_num\" : \"6DC00ADC5053574C342E3120FF122422\", \"vendor_id\" : \"0x2341\" }"; let device: Device = serde_json::from_str(device_json).unwrap(); assert_eq!(device.name, "Arduino Zero"); assert_eq!(device.bcd_device, Some(Version(1, 0, 0))); assert_eq!(device.bus_power, Some(500)); assert_eq!(device.bus_power_used, Some(500)); assert_eq!( device.device_speed, Some(DeviceSpeed::SpeedValue(Speed::FullSpeed)) ); assert_eq!(device.extra_current_used, Some(0)); assert_eq!( device.location_id, DeviceLocation { bus: 2, tree_positions: vec![1, 1], number: 3, } ); assert_eq!(device.manufacturer, Some("Arduino LLC".to_string())); assert_eq!(device.product_id, Some(0x804d)); assert_eq!(device.vendor_id, Some(0x2341)); } #[test] fn test_deserialize_bus() { let device_json = "{ \"_name\" : \"USB31Bus\", \"host_controller\" : \"AppleUSBXHCITR\", \"pci_device\" : \"0x15f0 \", \"pci_revision\" : \"0x0006 \", \"pci_vendor\" : \"0x8086 \", \"usb_bus_number\" : \"0x00 \" }"; let device: Bus = serde_json::from_str(device_json).unwrap(); assert_eq!(device.name, "USB31Bus"); assert_eq!(device.host_controller, "AppleUSBXHCITR"); assert_eq!(device.pci_device, Some(0x15f0)); assert_eq!(device.pci_revision, Some(0x0006)); assert_eq!(device.pci_vendor, Some(0x8086)); assert_eq!(device.usb_bus_number, Some(0x00)); } #[test] fn test_json_dump_read_not_panic() { read_json_dump("./tests/data/system_profiler_dump.json").unwrap(); } } cyme-2.2.6/src/profiler/watch.rs000066400000000000000000000125411506545537300165630ustar00rootroot00000000000000//! Leverages the usb HotplugEvent to create a stream of system USB devices //! //! See the watch cli for a usage example. use super::nusb::NusbProfiler; use super::{Device, DeviceEvent, SystemProfile}; use crate::error::Error; use ::nusb::hotplug::HotplugEvent; use ::nusb::watch_devices; use chrono::Local; use futures_lite::stream::Stream; use std::pin::Pin; use std::sync::{Arc, Mutex}; use std::task::{Context, Poll}; /// Builder for [`SystemProfileStream`] #[derive(Default)] pub struct SystemProfileStreamBuilder { spusb: Option, verbose: bool, } impl SystemProfileStreamBuilder { /// Create a new [`SystemProfileStreamBuilder`] pub fn new() -> Self { Self { spusb: None, verbose: true, } } /// Set the verbosity of the stream /// /// When set to true, the stream will include full device descriptors for verbose printing pub fn is_verbose(mut self, verbose: bool) -> Self { self.verbose = verbose; self } /// Set the initial [`SystemProfile`] for the stream pub fn with_spusb(mut self, spusb: SystemProfile) -> Self { self.spusb = Some(spusb); self } /// Build the [`SystemProfileStream`] pub fn build(self) -> Result { let spusb = if let Some(spusb) = self.spusb { Arc::new(Mutex::new(spusb)) } else if self.verbose { Arc::new(Mutex::new(super::get_spusb_with_extra()?)) } else { Arc::new(Mutex::new(super::get_spusb()?)) }; let mut new = SystemProfileStream::new(spusb)?; new.verbose = self.verbose; Ok(new) } } /// A stream that yields an updated [`SystemProfile`] when a USB device is connected or disconnected pub struct SystemProfileStream { spusb: Arc>, watch_stream: Pin + Send>>, verbose: bool, } impl SystemProfileStream { /// Create a new [`SystemProfileStream`] with a initial [`SystemProfile`] pub fn new(spusb: Arc>) -> Result { let watch_stream = Box::pin(watch_devices()?); Ok(Self { spusb, watch_stream, verbose: true, }) } /// Get the [`SystemProfile`] from the stream pub fn get_profile(&self) -> Arc> { Arc::clone(&self.spusb) } /// Re-profile the system USB devices /// /// Last events will be lost pub fn reprofile(&self) -> Arc> { if self.verbose { Arc::new(Mutex::new(super::get_spusb_with_extra().unwrap())) } else { Arc::new(Mutex::new(super::get_spusb().unwrap())) } } } impl Stream for SystemProfileStream { type Item = Arc>; fn poll_next(self: Pin<&mut Self>, cx: &mut Context<'_>) -> Poll> { let extra = self.verbose; let this = self.get_mut(); let mut profiler = NusbProfiler::new(); match Pin::new(&mut this.watch_stream).poll_next(cx) { Poll::Ready(Some(event)) => { let mut spusb = this.spusb.lock().unwrap(); match event { HotplugEvent::Connected(device) => { let mut cyme_device: Device = profiler.build_spdevice(&device, extra).unwrap(); cyme_device.last_event = Some(DeviceEvent::Connected(Local::now())); // Windows bus number is a string ID so we need to find the bus based on this and assign the bus number created during cyme profiling #[cfg(target_os = "windows")] { if let Some(existing_bus) = spusb.buses.iter().find(|b| b.id == device.bus_id()) { log::debug!( "Win found bus for connected device ({cyme_device}): {0}", existing_bus.id ); if let Some(existing_number) = existing_bus.get_bus_number() { log::debug!( "Assigning bus number {existing_number} to device {cyme_device}", ); cyme_device.location_id.bus = existing_number; } } else { log::error!( "Win no bus found for connected device, seeking bus_id: {}", device.bus_id() ); } } spusb.insert(cyme_device); } HotplugEvent::Disconnected(id) => { if let Some(device) = spusb.get_id_mut(&id) { device.last_event = Some(DeviceEvent::Disconnected(Local::now())); } } } Poll::Ready(Some(Arc::clone(&this.spusb))) } Poll::Ready(None) => Poll::Ready(None), Poll::Pending => Poll::Pending, } } } cyme-2.2.6/src/types.rs000066400000000000000000000252341506545537300150020ustar00rootroot00000000000000//! Types used in crate non-specific to a module use std::fmt; use std::str::FromStr; use serde::de::{self, MapAccess, SeqAccess, Visitor}; use serde::{Deserialize, Deserializer, Serialize}; use crate::error::{self, Error, ErrorKind}; /// A numerical `value` converted from a String, which includes a `unit` and `description` /// /// Serialized string is of format "\[value\] \[unit\]" where u32 of f32 is supported /// /// ``` /// use std::str::FromStr; /// use cyme::types::NumericalUnit; /// /// let s: &'static str = "100.0 W"; /// let nu = NumericalUnit::from_str(s).unwrap(); /// assert_eq!(nu, NumericalUnit{ value: 100.0, unit: "W".into(), description: None }); /// /// let s: &'static str = "59 mA"; /// let nu = NumericalUnit::from_str(s).unwrap(); /// assert_eq!(nu, NumericalUnit{ value: 59, unit: "mA".into(), description: None }); /// ``` #[derive(Debug, Default, Clone, PartialEq, Serialize)] pub struct NumericalUnit { /// Numerical value pub value: T, /// SI unit for the numerical value pub unit: String, /// Description of numerical value pub description: Option, } impl fmt::Display for NumericalUnit { fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result { if let Some(width) = f.width() { let actual_width = width - self.unit.len() - 1; write!(f, "{:actual_width$} {:}", self.value, self.unit) } else { write!(f, "{:} {:}", self.value, self.unit) } } } impl fmt::Display for NumericalUnit { fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result { // If we received a precision, we use it. if let Some(width) = f.width() { let actual_width = width - self.unit.len() - 1; write!( f, "{1:actual_width$.*} {2}", f.precision().unwrap_or(2), self.value, self.unit ) } else { write!( f, "{1:.*} {2}", f.precision().unwrap_or(2), self.value, self.unit ) } } } impl FromStr for NumericalUnit { type Err = Error; fn from_str(s: &str) -> error::Result { let value_split: Vec<&str> = s.trim().split(' ').collect(); if value_split.len() >= 2 { Ok(NumericalUnit { value: value_split[0] .trim() .parse::() .map_err(|e| Error::new(ErrorKind::Parsing, &e.to_string()))?, unit: value_split[1].trim().to_string(), description: None, }) } else { Err(Error::new( ErrorKind::Decoding, "string split does not contain [u32] [unit]", )) } } } impl FromStr for NumericalUnit { type Err = Error; fn from_str(s: &str) -> error::Result { let value_split: Vec<&str> = s.trim().split(' ').collect(); if value_split.len() >= 2 { Ok(NumericalUnit { value: value_split[0] .trim() .parse::() .map_err(|e| Error::new(ErrorKind::Parsing, &e.to_string()))?, unit: value_split[1].trim().to_string(), description: None, }) } else { Err(Error::new( ErrorKind::Decoding, "string split does not contain [f32] [unit]", )) } } } impl<'de> Deserialize<'de> for NumericalUnit { fn deserialize(deserializer: D) -> Result where D: Deserializer<'de>, { #[derive(Deserialize)] #[serde(field_identifier, rename_all = "lowercase")] #[serde(untagged)] enum Field { Value, Unit, Description, } struct DeviceNumericalUnitU32Visitor; impl<'de> Visitor<'de> for DeviceNumericalUnitU32Visitor { type Value = NumericalUnit; fn expecting(&self, formatter: &mut fmt::Formatter) -> fmt::Result { formatter.write_str("a string with format '[int] [unit]'") } fn visit_seq(self, mut seq: V) -> Result, V::Error> where V: SeqAccess<'de>, { let value = seq .next_element()? .ok_or_else(|| de::Error::invalid_length(0, &self))?; let unit = seq .next_element()? .ok_or_else(|| de::Error::invalid_length(1, &self))?; let description = seq .next_element() .ok() .ok_or_else(|| de::Error::invalid_length(2, &self))?; Ok(NumericalUnit:: { value, unit, description, }) } fn visit_map(self, mut map: V) -> Result, V::Error> where V: MapAccess<'de>, { let mut value = None; let mut unit = None; let mut description = None; while let Some(key) = map.next_key()? { match key { Field::Value => { if value.is_some() { return Err(de::Error::duplicate_field("value")); } value = Some(map.next_value()?); } Field::Unit => { if unit.is_some() { return Err(de::Error::duplicate_field("unit")); } unit = Some(map.next_value()?); } Field::Description => { if description.is_some() { return Err(de::Error::duplicate_field("description")); } description = map.next_value().ok(); } } } let value = value.ok_or_else(|| de::Error::missing_field("value"))?; let unit = unit.ok_or_else(|| de::Error::missing_field("unit"))?; Ok(NumericalUnit:: { value, unit, description, }) } fn visit_string(self, value: String) -> Result where E: de::Error, { NumericalUnit::from_str(value.as_str()).map_err(E::custom) } fn visit_str(self, value: &str) -> Result where E: de::Error, { NumericalUnit::from_str(value).map_err(E::custom) } } deserializer.deserialize_any(DeviceNumericalUnitU32Visitor) } } impl<'de> Deserialize<'de> for NumericalUnit { fn deserialize(deserializer: D) -> Result where D: Deserializer<'de>, { #[derive(Deserialize)] #[serde(field_identifier, rename_all = "lowercase")] #[serde(untagged)] enum Field { Value, Unit, #[serde(deserialize_with = "deserialize_description")] Description, } struct DeviceNumericalUnitF32Visitor; impl<'de> Visitor<'de> for DeviceNumericalUnitF32Visitor { type Value = NumericalUnit; fn expecting(&self, formatter: &mut fmt::Formatter) -> fmt::Result { formatter.write_str("a string with format '[float] [unit]'") } fn visit_seq(self, mut seq: V) -> Result, V::Error> where V: SeqAccess<'de>, { let value = seq .next_element()? .ok_or_else(|| de::Error::invalid_length(0, &self))?; let unit = seq .next_element()? .ok_or_else(|| de::Error::invalid_length(1, &self))?; let description = seq .next_element() .ok() .ok_or_else(|| de::Error::invalid_length(2, &self))?; Ok(NumericalUnit:: { value, unit, description, }) } fn visit_map(self, mut map: V) -> Result, V::Error> where V: MapAccess<'de>, { let mut value = None; let mut unit = None; let mut description = None; while let Some(key) = map.next_key()? { match key { Field::Value => { if value.is_some() { return Err(de::Error::duplicate_field("value")); } value = Some(map.next_value()?); } Field::Unit => { if unit.is_some() { return Err(de::Error::duplicate_field("unit")); } unit = Some(map.next_value()?); } Field::Description => { if description.is_some() { return Err(de::Error::duplicate_field("description")); } description = map.next_value().ok(); } } } let value = value.ok_or_else(|| de::Error::missing_field("value"))?; let unit = unit.ok_or_else(|| de::Error::missing_field("unit"))?; Ok(NumericalUnit:: { value, unit, description, }) } fn visit_string(self, value: String) -> Result where E: de::Error, { NumericalUnit::from_str(value.as_str()).map_err(E::custom) } fn visit_str(self, value: &str) -> Result where E: de::Error, { NumericalUnit::from_str(value).map_err(E::custom) } } deserializer.deserialize_any(DeviceNumericalUnitF32Visitor) } } cyme-2.2.6/src/udev.rs000066400000000000000000000117401506545537300145760ustar00rootroot00000000000000//! Utilities to get device information using udev - only supported on Linux. Requires 'udev' feature. use udevrs::{udev_new, UdevDevice, UdevHwdb}; use crate::error::{Error, ErrorKind}; /// Contains data returned by [`get_udev_info()`]. #[derive(Debug, Clone, PartialEq, Default)] pub struct UdevInfo { /// The driver name for the device pub driver: Option, /// The syspath for the device pub syspath: Option, } fn get_device(port_path: &str) -> Result { UdevDevice::new_from_subsystem_sysname(udev_new(), "usb", port_path).map_err(|e| { log::error!("Failed to get udev info for device at {port_path}: Error({e})"); Error::new( ErrorKind::Udev, &format!("Failed to get udev info for device at {port_path}: Error({e})"), ) }) } /// Lookup the driver and syspath for a device given the `port_path`. Returns [`UdevInfo`] containing both. /// /// ```no_run /// use cyme::udev::get_udev_info; /// /// let udevi = get_udev_info("1-0:1.0").unwrap(); /// assert_eq!(udevi.driver, Some("hub".into())); /// assert_eq!(udevi.syspath.unwrap().contains("usb1/1-0:1.0"), true); /// ``` pub fn get_udev_info(port_path: &str) -> Result { let mut device = get_device(port_path)?; Ok({ UdevInfo { driver: device.get_driver().map(|s| s.trim().to_string()), syspath: Some(device.syspath().trim().to_string()), } }) } /// Lookup the driver name for a device given the `port_path`. /// /// ```no_run /// use cyme::udev::get_udev_driver_name; /// let driver = get_udev_driver_name("1-0:1.0").unwrap(); /// assert_eq!(driver, Some("hub".into())); /// ``` pub fn get_udev_driver_name(port_path: &str) -> Result, Error> { let mut device = get_device(port_path)?; Ok(device.get_driver().map(|s| s.trim().to_string())) } /// Lookup the syspath for a device given the `port_path`. /// /// ```no_run /// use cyme::udev::get_udev_syspath; /// let syspath = get_udev_syspath("1-0:1.0").unwrap(); /// assert_eq!(syspath.unwrap().contains("usb1/1-0:1.0"), true); /// ``` pub fn get_udev_syspath(port_path: &str) -> Result, Error> { let device = get_device(port_path)?; Ok(Some(device.syspath().trim().to_string())) } /// Lookup a udev attribute given the `port_path` and `attribute`. /// /// This only works on Linux and not all devices have all attributes. /// These attributes are generally readable by all users. /// /// NOTE: In general you should read from sysfs directly as it does not /// depend on the udev feature. See `get_sysfs_string()` in profiler.rs /// /// ```no_run /// use cyme::udev::get_udev_attribute; /// /// let interface_class = get_udev_attribute("1-0:1.0", "bInterfaceClass").unwrap(); /// assert_eq!(interface_class, Some("09".into())); /// ``` pub fn get_udev_attribute + std::fmt::Display + Into>( port_path: &str, attribute: T, ) -> Result, Error> { let mut device = get_device(port_path)?; Ok(device .get_sysattr_value(&attribute.into()) .map(|s| s.trim().to_string())) } /// Utilities to get device information using udev hwdb - only supported on Linux. Requires 'udev' feature. pub mod hwdb { use super::*; /// Lookup an entry in the udev hwdb given the `modalias` and `key`. /// /// Should act like https://github.com/gregkh/usbutils/blob/master/names.c#L115 /// /// ``` /// use cyme::udev; /// /// let modalias = "usb:v1D6Bp0001"; /// let vendor = udev::hwdb::get(&modalias, "ID_VENDOR_FROM_DATABASE").unwrap(); /// /// assert_eq!(vendor, Some("Linux Foundation".into())); /// /// let modalias = "usb:v1366p0101"; /// let vendor = udev::hwdb::get(&modalias, "ID_MODEL_FROM_DATABASE").unwrap(); /// /// assert_eq!(vendor, Some("J-Link PLUS".into())); /// ``` pub fn get(modalias: &str, key: &'static str) -> Result, Error> { let mut hwdb = UdevHwdb::new(udev_new()).map_err(|e| { log::error!("Failed to get hwdb: Error({e})"); Error::new(ErrorKind::Udev, &format!("Failed to get hwdb: Error({e})")) })?; Ok(udevrs::udev_hwdb_query_one(&mut hwdb, modalias, key).map(|s| s.trim().to_string())) } } #[cfg(test)] mod tests { use super::*; /// Tests can obtain driver and syspath for root_hub on bus 1 - only do if we have USB #[cfg_attr(not(feature = "usb_test"), ignore)] #[test] fn test_udev_info() { let udevi = get_udev_info("1-0:1.0").unwrap(); assert_eq!(udevi.driver, Some("hub".into())); assert!(udevi.syspath.unwrap().contains("1-0:1.0")); } /// Tests can lookup bInterfaceClass of the root hub, which is always 09 #[cfg_attr(not(feature = "usb_test"), ignore)] #[test] fn test_udev_attribute() { let interface_class = get_udev_attribute("1-0:1.0", "bInterfaceClass").unwrap(); assert_eq!(interface_class, Some("09".into())); } } cyme-2.2.6/src/udev_ffi.rs000066400000000000000000000132471506545537300154260ustar00rootroot00000000000000//! Utilities to get device information using udev libudev FFI - only supported on Linux. Requires 'udev_ffi' feature. use std::path::Path; use udevlib; use crate::error::{Error, ErrorKind}; /// Contains data returned by [`get_udev_info()`]. #[derive(Debug, Clone, PartialEq, Default)] pub struct UdevInfo { /// The driver name for the device pub driver: Option, /// The syspath for the device pub syspath: Option, } fn get_device(port_path: &str) -> Result { udevlib::Device::from_subsystem_sysname(String::from("usb"), port_path.to_string()).map_err( |e| { log::error!( "Failed to get udev info for device at {}: Error({})", port_path, e ); Error::new( ErrorKind::Udev, &format!( "Failed to get udev info for device at {}: Error({})", port_path, e ), ) }, ) } /// Lookup the driver and syspath for a device given the `port_path`. Returns [`UdevInfo`] containing both. /// /// ```no_run /// use cyme::udev::get_udev_info; /// /// let udevi = get_udev_info("1-0:1.0").unwrap(); /// assert_eq!(udevi.driver, Some("hub".into())); /// assert_eq!(udevi.syspath.unwrap().contains("usb1/1-0:1.0"), true); /// ``` pub fn get_udev_info(port_path: &str) -> Result { let device = get_device(port_path)?; Ok({ UdevInfo { driver: device .driver() .map(|s| s.to_str().unwrap_or("").to_string()), syspath: device.syspath().to_str().map(|s| s.to_string()), } }) } /// Lookup the driver name for a device given the `port_path`. /// /// ```no_run /// use cyme::udev::get_udev_driver_name; /// let driver = get_udev_driver_name("1-0:1.0").unwrap(); /// assert_eq!(driver, Some("hub".into())); /// ``` pub fn get_udev_driver_name(port_path: &str) -> Result, Error> { let device = get_device(port_path)?; Ok(device .driver() .map(|s| s.to_str().unwrap_or("").to_string())) } /// Lookup the syspath for a device given the `port_path`. /// /// ```no_run /// use cyme::udev::get_udev_syspath; /// let syspath = get_udev_syspath("1-0:1.0").unwrap(); /// assert_eq!(syspath.unwrap().contains("usb1/1-0:1.0"), true); /// ``` pub fn get_udev_syspath(port_path: &str) -> Result, Error> { let device = get_device(port_path)?; Ok(device.syspath().to_str().map(|s| s.to_string())) } /// Lookup a udev attribute given the `port_path` and `attribute`. /// /// This only works on Linux and not all devices have all attributes. /// These attributes are generally readable by all users. /// /// NOTE: In general you should read from sysfs directly as it does not /// depend on the udev feature. See `get_sysfs_string()` in lsusb.rs /// /// ```no_run /// use cyme::udev::get_udev_attribute; /// /// let interface_class = get_udev_attribute("1-0:1.0", "bInterfaceClass").unwrap(); /// assert_eq!(interface_class, Some("09".into())); /// ``` pub fn get_udev_attribute + std::fmt::Display>( port_path: &str, attribute: T, ) -> Result, Error> { let path: String = format!("/sys/bus/usb/devices/{}", port_path); let device = udevlib::Device::from_syspath(Path::new(&path)).map_err(|e| { Error::new( ErrorKind::Udev, &format!( "Failed to get udev attribute {} for device at {}: Error({})", attribute, path, e ), ) })?; Ok(device .attribute_value(attribute) .map(|s| s.to_str().unwrap_or("").to_string())) } /// udev hwdb lookup functions /// /// Protected by the `udev_hwdb` feature because 'libudev-sys' excludes hwdb ffi bindings if native udev does not support hwdb #[cfg(feature = "udev_hwdb")] pub mod hwdb { use super::*; /// Lookup an entry in the udev hwdb given the `modalias` and `key`. /// /// Should act like https://github.com/gregkh/usbutils/blob/master/names.c#L115 /// /// ``` /// use cyme::udev; /// /// let modalias = "usb:v1D6Bp0001"; /// let vendor = udev::hwdb::get(&modalias, "ID_VENDOR_FROM_DATABASE").unwrap(); /// /// assert_eq!(vendor, Some("Linux Foundation".into())); /// /// let modalias = "usb:v*p*d*dc03dsc01dp01*"; /// let vendor = udev::hwdb::get(&modalias, "ID_USB_PROTOCOL_FROM_DATABASE").unwrap(); /// /// assert_eq!(vendor, Some("Keyboard".into())); /// ``` pub fn get(modalias: &str, key: &'static str) -> Result, Error> { let hwdb = udevlib::Hwdb::new().map_err(|e| { Error::new( ErrorKind::Udev, &format!("Failed to get hwdb: Error({})", e), ) })?; Ok(hwdb .query_one(&modalias.to_string(), &key.to_string()) .map(|s| s.to_str().unwrap_or("").to_string())) } } #[cfg(test)] mod tests { use super::*; /// Tests can obtain driver and syspath for root_hub on bus 1 - only do if we have USB #[cfg_attr(not(feature = "usb_test"), ignore)] #[test] fn test_udev_info() { let udevi = get_udev_info("1-0:1.0").unwrap(); assert_eq!(udevi.driver, Some("hub".into())); assert!(udevi.syspath.unwrap().contains("usb1/1-0:1.0")); } /// Tests can lookup bInterfaceClass of the root hub, which is always 09 #[cfg_attr(not(feature = "usb_test"), ignore)] #[test] fn test_udev_attribute() { let interface_class = get_udev_attribute("1-0:1.0", "bInterfaceClass").unwrap(); assert_eq!(interface_class, Some("09".into())); } } cyme-2.2.6/src/usb.rs000066400000000000000000001415751506545537300144360ustar00rootroot00000000000000//! Defines for USB, mainly thosed covered at [usb.org](https://www.usb.org) //! //! Also referring to [beyondlogic](https://beyondlogic.org/usbnutshell/usb5.shtml) //! //! There are some repeated/copied Enum defines from rusb in order to control Serialize/Deserialize and add impl use clap::ValueEnum; use itertools::Itertools; use serde::{Deserialize, Serialize}; use serde_with::skip_serializing_none; use std::convert::TryFrom; use std::fmt; use std::path::PathBuf; use std::str::FromStr; pub mod descriptors; pub use descriptors::*; pub mod path; pub use path::*; use crate::error::{self, Error, ErrorKind}; use crate::profiler::InternalData; use crate::types::NumericalUnit; /// The version value (for BCD and USB) is in binary coded decimal with a format of 0xJJMN where JJ is the major version number, M is the minor version number and N is the sub minor version number. e.g. USB 2.0 is reported as 0x0200, USB 1.1 as 0x0110 and USB 1.0 as 0x0100. The type is a mirror of the one from [rusb](https://docs.rs/rusb/latest/rusb/) in order to impl Display, From etc. /// /// /// ``` /// let version = cyme::usb::Version(2, 0, 1); /// ``` /// /// Represents the version 2.0.1, or in `String` representation it is base16 encoded: /// /// ``` /// # let version = cyme::usb::Version(2, 0, 1); /// assert_eq!(version.to_string(), "2.01"); /// let version = cyme::usb::Version(155, 15, 1); /// assert_eq!(version.to_string(), "9b.f1"); /// ``` /// #[derive(Debug, PartialEq, Eq, Clone, Copy, Hash, PartialOrd, Ord, Serialize, Deserialize)] pub struct Version(pub u8, pub u8, pub u8); impl Version { /// Extracts a version from a binary coded decimal (BCD) field. BCD fields exist in USB /// descriptors as 16-bit integers encoding a version as `0xJJMN`, where `JJ` is the major /// version, `M` is the minor version, and `N` is the sub minor version. For example, 2.0 is /// encoded as `0x0200` and 1.1 is encoded as `0x0110`. pub fn from_bcd(mut raw: u16) -> Self { let sub_minor: u8 = (raw & 0x000F) as u8; raw >>= 4; let minor: u8 = (raw & 0x000F) as u8; raw >>= 4; let mut major: u8 = (raw & 0x000F) as u8; raw >>= 4; major += (10 * raw) as u8; Version(major, minor, sub_minor) } /// Returns the major version. pub fn major(self) -> u8 { let Version(major, _, _) = self; major } /// Returns the minor version. pub fn minor(self) -> u8 { let Version(_, minor, _) = self; minor } /// Returns the sub minor version. pub fn sub_minor(self) -> u8 { let Version(_, _, sub_minor) = self; sub_minor } } impl std::fmt::Display for Version { /// Output is a base16 encoding of Major.MinorSub /// /// ``` /// assert_eq!(cyme::usb::Version(155, 0, 0).to_string(), "9b.00"); /// assert_eq!(cyme::usb::Version(2, 0, 1).to_string(), "2.01"); /// ``` /// fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result { write!( f, "{:x}.{:x}{:x}", self.major(), self.minor() & 0x0F, self.sub_minor() & 0x0F ) } } impl FromStr for Version { type Err = Error; fn from_str(s: &str) -> error::Result { let (parse_ints, _): (Vec>, Vec<_>) = s .split('.') .map(|vs| u8::from_str_radix(vs, 16)) .partition(Result::is_ok); let numbers: Vec = parse_ints.into_iter().map(|v| v.unwrap()).collect(); match numbers.get(0..2) { Some(slice) => Ok(Version(slice[0], (slice[1] & 0xF0) >> 4, slice[1] & 0x0F)), None => Err(Error::new( ErrorKind::Decoding, &format!("No two base16 encoded versions in {s}"), )), } } } /// For legacy import where I thought the value was a f32... impl TryFrom for Version { type Error = Error; fn try_from(f: f32) -> error::Result { let s = format!("{f:2.2}"); let (parse_ints, _): (Vec>, Vec<_>) = s .split('.') .map(|vs| vs.parse::()) .partition(Result::is_ok); let numbers: Vec = parse_ints.into_iter().map(|v| v.unwrap()).collect(); match numbers.get(0..2) { Some(slice) => Ok(Version(slice[0], (slice[1] & 0xF0) >> 4, slice[1] & 0x0F)), None => Err(Error::new( ErrorKind::Decoding, &format!("Failed to parse float into MM.mP {f}"), )), } } } impl From for u16 { fn from(v: Version) -> Self { let Version(major, minor, sub_minor) = v; ((major as u16) << 8) | ((minor as u16) << 4) | (sub_minor as u16) } } /// Configuration attributes #[derive(Debug, Clone, PartialEq, Eq, Hash, Serialize, Deserialize)] #[non_exhaustive] pub enum ConfigAttributes { /// Device is bus powered BusPowered, /// Device powers itself not from bus SelfPowered, /// Supports remote wake-up RemoteWakeup, /// Device is battery powered BatteryPowered, } impl fmt::Display for ConfigAttributes { fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result { write!(f, "{self:?}") } } impl ConfigAttributes { /// Converts a HashSet of [`ConfigAttributes`] into a ';' separated string /// /// ``` /// use cyme::usb::ConfigAttributes; /// /// assert_eq!(ConfigAttributes::attributes_to_string(&vec![ConfigAttributes::RemoteWakeup, ConfigAttributes::SelfPowered]), "RemoteWakeup;SelfPowered"); /// ``` pub fn attributes_to_string(attributes: &[ConfigAttributes]) -> String { let vec: Vec = attributes.iter().map(|a| a.to_string()).collect(); vec.join(";") } } /// Explains how the `BaseClass` is used #[derive(Debug)] pub enum DescriptorUsage { /// Describes device Device, /// Describes interface Interface, /// Can be used to describe both Both, } /// USB class code defines [ref](https://www.usb.org/defined-class-codes) /// /// Technically this is the 'Base Class' - the 'Class Code' is the full triplet of (Base Class, Sub Class, Protocol). #[derive(Debug, ValueEnum, Default, Clone, Copy, Hash, PartialEq, Eq, Serialize, Deserialize)] #[serde(rename_all = "kebab-case")] #[non_exhaustive] #[repr(u8)] pub enum BaseClass { #[default] /// Device class is unspecified, interface descriptors are used to determine needed drivers UseInterfaceDescriptor = 0x00, /// Speaker, microphone, sound card, MIDI Audio = 0x01, /// The modern serial interface; appears as a UART/RS232 port on most systems #[serde(alias = "c-d-c-communications", alias = "CDC Communications")] CdcCommunications = 0x02, /// Human Interface Device; game controllers, keyboards, mice etc. Also commonly used as a device data interface rather then creating something from scratch #[serde(alias = "h-i-d", alias = "HID")] Hid = 0x03, /// Force feedback joystick Physical = 0x05, /// Still imaging device; scanners, cameras Image = 0x06, /// Laser printer, inkjet printer, CNC machine Printer = 0x07, /// Mass storage devices (MSD): USB flash drive, memory card reader, digital audio player, digital camera, external drive MassStorage = 0x08, /// High speed USB hub Hub = 0x09, /// Used together with class 02h (Communications and CDC Control) above #[serde(alias = "c-d-c-data", alias = "CDC Data")] CdcData = 0x0a, /// USB smart card reader SmartCard = 0x0b, /// Fingerprint reader ContentSecurity = 0x0d, /// Webcam Video = 0x0e, /// Pulse monitor (watch) PersonalHealthcare = 0x0f, /// Webcam, TV AudioVideo = 0x10, /// Describes USB-C alternate modes supported by device Billboard = 0x11, /// An interface to expose and configure the USB Type-C capabilities of Connectors on USB Hubs or Alternate Mode Adapters #[serde(alias = "u-s-b-type-c-bridge", alias = "USB TypeC Bridge")] UsbTypeCBridge = 0x12, /// This base class is defined for devices that conform to the “VESA USB BDP Device Specification†found at the VESA website. This specification defines the usable set of SubClass and Protocol values. Values outside of this defined spec are reserved. These class codes can only be used in Interface Descriptors. #[serde(alias = "b-d-p", alias = "BDP")] Bdp = 0x13, /// This base class is defined for devices that conform to the “MCTP over USB†found at the DMTF website as DSP0283. This specification defines the usable set of SubClass and Protocol values. Values outside of this defined spec are reserved. These class codes can only be used in Interface Descriptors. #[serde(alias = "m-c-t-p", alias = "MCTP")] Mctp = 0x14, /// An interface to expose and configure I3C function within a USB device to allow interaction between host software and the I3C device, to drive transaction on the I3C bus to/from target devices #[serde(alias = "i-3-c-device", alias = "I3C Device")] I3cDevice = 0x3c, /// Trace and debugging equipment Diagnostic = 0xdc, /// Wireless controllers: Bluetooth adaptors, Microsoft RNDIS WirelessController = 0xe0, /// This base class is defined for miscellaneous device definitions. Some matching SubClass and Protocols are defined on the USB-IF website Miscellaneous = 0xef, /// This base class is defined for devices that conform to several class specifications found on the USB-IF website ApplicationSpecificInterface = 0xfe, /// This base class is defined for vendors to use as they please VendorSpecificClass = 0xff, } impl fmt::Display for BaseClass { fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result { write!(f, "{self:?}") } } impl From for BaseClass { fn from(b: u8) -> BaseClass { match b { 0x00 => BaseClass::UseInterfaceDescriptor, 0x01 => BaseClass::Audio, 0x02 => BaseClass::CdcCommunications, 0x03 => BaseClass::Hid, 0x05 => BaseClass::Physical, 0x06 => BaseClass::Image, 0x07 => BaseClass::Printer, 0x08 => BaseClass::MassStorage, 0x09 => BaseClass::Hub, 0x0a => BaseClass::CdcData, 0x0b => BaseClass::SmartCard, 0x0d => BaseClass::ContentSecurity, 0x0e => BaseClass::Video, 0x0f => BaseClass::PersonalHealthcare, 0x10 => BaseClass::AudioVideo, 0x11 => BaseClass::Billboard, 0x12 => BaseClass::UsbTypeCBridge, 0x13 => BaseClass::Bdp, 0x14 => BaseClass::Mctp, 0x3c => BaseClass::I3cDevice, 0xdc => BaseClass::Diagnostic, 0xe0 => BaseClass::WirelessController, 0xef => BaseClass::Miscellaneous, 0xfe => BaseClass::ApplicationSpecificInterface, 0xff => BaseClass::VendorSpecificClass, _ => BaseClass::UseInterfaceDescriptor, } } } impl From for u8 { fn from(val: BaseClass) -> Self { // set as repr(u8) so this will do the conversion val as u8 } } impl From for BaseClass { fn from(c: ClassCode) -> Self { match c { ClassCode::Generic(c) => c, ClassCode::FullSpeedHub => BaseClass::Hub, ClassCode::HighSpeedHubSingleTt => BaseClass::Hub, ClassCode::HighSpeedHubMultiTt => BaseClass::Hub, ClassCode::AudioVideoControlInterface => BaseClass::Audio, ClassCode::AudioVideoDataVideo => BaseClass::Audio, ClassCode::AudioVideoDataAudio => BaseClass::Audio, ClassCode::MctpManagementController => BaseClass::Mctp, ClassCode::MctpHostInterfaceEndpoint => BaseClass::Mctp, ClassCode::Usb2ComplianceDevice => BaseClass::Diagnostic, ClassCode::DebugTargetVendorDefined => BaseClass::Diagnostic, ClassCode::GnuRemoteDebugCommandSet => BaseClass::Diagnostic, ClassCode::VendorDefinedTraceDbC => BaseClass::Diagnostic, ClassCode::VendorDefinedDfxDbC => BaseClass::Diagnostic, ClassCode::VendorDefinedTraceGPDvC => BaseClass::Diagnostic, ClassCode::GnuProtocolGpDvC => BaseClass::Diagnostic, ClassCode::VendorDefinedDfxDvC => BaseClass::Diagnostic, ClassCode::VendorDefinedTraceDvC => BaseClass::Diagnostic, ClassCode::BluetoothProgrammingInterface => BaseClass::WirelessController, ClassCode::UwbRadioControlInterface => BaseClass::WirelessController, ClassCode::RemoteNdis => BaseClass::WirelessController, ClassCode::BluetoothAmpController => BaseClass::WirelessController, ClassCode::HostWireAdaptor => BaseClass::WirelessController, ClassCode::DeviceWireAdaptor => BaseClass::WirelessController, ClassCode::DeviceWireAdaptorIsochronous => BaseClass::WirelessController, ClassCode::ActiveSync => BaseClass::Miscellaneous, ClassCode::PalmSync => BaseClass::Miscellaneous, ClassCode::InterfaceAssociationDescriptor => BaseClass::Miscellaneous, ClassCode::WireAdaptorMultifunctionPeripheral => BaseClass::Miscellaneous, ClassCode::CableBasedAssociationFramework => BaseClass::Miscellaneous, ClassCode::RndisOverEthernet => BaseClass::Miscellaneous, ClassCode::RndisOverWifi => BaseClass::Miscellaneous, ClassCode::RndisOverWiMax => BaseClass::Miscellaneous, ClassCode::RndisOverWwan => BaseClass::Miscellaneous, ClassCode::RndisForRawIpv4 => BaseClass::Miscellaneous, ClassCode::RndisForRawIpv6 => BaseClass::Miscellaneous, ClassCode::RndisForGprs => BaseClass::Miscellaneous, ClassCode::Usb3VisionControlInterface => BaseClass::Miscellaneous, ClassCode::Usb3VisionEventInterface => BaseClass::Miscellaneous, ClassCode::Usb3VisionStreamingInterface => BaseClass::Miscellaneous, ClassCode::StepStreamTransport => BaseClass::Miscellaneous, ClassCode::StepRawStreamTransport => BaseClass::Miscellaneous, ClassCode::CommandInterfaceIad => BaseClass::Miscellaneous, ClassCode::CommandInterfaceId => BaseClass::Miscellaneous, ClassCode::MediaInterfaceId => BaseClass::Miscellaneous, ClassCode::DeviceFirmwareUpgrade => BaseClass::ApplicationSpecificInterface, ClassCode::IrdaBridge => BaseClass::ApplicationSpecificInterface, ClassCode::UsbTestMeasurement => BaseClass::ApplicationSpecificInterface, ClassCode::UsbTestMeasurementUsbTmc488 => BaseClass::ApplicationSpecificInterface, } } } impl BaseClass { /// How the BaseClass is used [`DescriptorUsage`] pub fn usage(&self) -> DescriptorUsage { match self { BaseClass::UseInterfaceDescriptor | BaseClass::Hub | BaseClass::Billboard => { DescriptorUsage::Device } BaseClass::CdcCommunications | BaseClass::Diagnostic | BaseClass::Miscellaneous | BaseClass::VendorSpecificClass => DescriptorUsage::Both, _ => DescriptorUsage::Interface, } } /// lsusb is explicit for some in styling of tree /// ``` /// # use cyme::usb::BaseClass; /// /// assert_eq!(BaseClass::Hid.to_lsusb_string(), "Human Interface Device"); /// ``` pub fn to_lsusb_string(&self) -> String { match self { BaseClass::Hid => "Human Interface Device".into(), BaseClass::CdcCommunications => "Communications".into(), _ => self.to_title_case(), } } /// Converts Pascal case enum to space separated on capitals /// ``` /// # use cyme::usb::BaseClass; /// /// assert_eq!(BaseClass::UseInterfaceDescriptor.to_title_case(), "Use Interface Descriptor"); /// assert_eq!(BaseClass::CdcData.to_title_case(), "CDC Data"); /// ``` pub fn to_title_case(&self) -> String { let title = heck::AsTitleCase(self.to_string()).to_string(); let split: Vec<&str> = title.split(' ').collect(); let first = split.first().unwrap_or(&""); // keep capitalised abbreviations match first.to_owned() { "Cdc" | "Usb" | "I3c" | "Hid" | "Bdp" | "Mctp" => { title.replace(first, &first.to_uppercase()) } _ => title, } } } impl From for DescriptorUsage { fn from(c: BaseClass) -> DescriptorUsage { c.usage() } } /// Fully defined USB-IF class based on (Base Class, Sub Class, Protocol) Class Code triplet /// /// #[derive(Debug, Clone, Copy, Hash, PartialEq, Eq, Serialize, Deserialize)] #[serde(rename_all = "kebab-case")] #[non_exhaustive] pub enum ClassCode { /// Generic devices just have a 'Base Class'. It is a device without a defining SubClass or Protocol Generic(BaseClass), /// Full speed Hub FullSpeedHub, /// Hi-speed hub with single TT HighSpeedHubSingleTt, /// Hi-speed hub with multiple TTs HighSpeedHubMultiTt, /// Audio/Video Device – AVControl Interface AudioVideoControlInterface, /// Audio/Video Device – AVData Video Streaming Interface AudioVideoDataVideo, /// Audio/Video Device – AVData Audio Streaming Interface AudioVideoDataAudio, /// MCTP Management-controller and Managed-Device endpoints MctpManagementController, /// MCTP Host Interface endpoint MctpHostInterfaceEndpoint, /// USB2 Compliance Device. Definition for this device can be found at Usb2ComplianceDevice, /// Debug Target vendor defined. Please see for more info. DebugTargetVendorDefined, /// GNU Remote Debug Command Set. Please see for more info. GnuRemoteDebugCommandSet, /// Vendor defined Trace protocol on DbC. VendorDefinedTraceDbC, /// Vendor defined Dfx protocol on DbC. VendorDefinedDfxDbC, /// Vendor defined Trace protocol over General Purpose (GP) endpoint on DvC. VendorDefinedTraceGPDvC, /// GNU Protocol protocol over General Purpose (GP) endpoint on DvC. /// /// GnuProtocolGpDvC, /// Vendor defined Dfx protocol on DvC. VendorDefinedDfxDvC, /// Vendor defined Trace protocol on DvC. VendorDefinedTraceDvC, /// Bluetooth Programming Interface. Get specific information from www.bluetooth.com. BluetoothProgrammingInterface, /// UWB Radio Control Interface. Definition for this is found in the Wireless USB Specification in Chapter 8. UwbRadioControlInterface, /// Remote NDIS. Information can be found at: RemoteNdis, /// Bluetooth AMP Controller. Get specific information from www.bluetooth.com. BluetoothAmpController, /// Host Wire Adapter Control/Data interface. Definition can be found in the Wireless USB Specification in Chapter 8. HostWireAdaptor, /// Device Wire Adapter Control/Data interface. Definition can be found in the Wireless USB Specification in Chapter 8. DeviceWireAdaptor, /// Device Wire Adapter Isochronous interface. Definition can be found in the Wireless USB Specification in Chapter 8. DeviceWireAdaptorIsochronous, /// Active Sync device. This class code can be used in either Device or Interface Descriptors. Contact Microsoft for more information on this class. ActiveSync, /// Palm Sync. This class code can be used in either Device or Interface Descriptors. PalmSync, /// Interface Association Descriptor. The usage of this class code triple is defined in the Interface Association Descriptor ECN that is provided on www.usb.org . This class code may only be used in Device Descriptors. InterfaceAssociationDescriptor, /// Wire Adapter Multifunction Peripheral programming interface. Definition can be found in the Wireless USB Specification in Chapter 8. This class code may only be used in Device Descriptors. WireAdaptorMultifunctionPeripheral, /// Cable Based Association Framework. This is defined in the Association Model addendum to the Wireless USB specification. This class code may only be used in Interface Descriptors. CableBasedAssociationFramework, /// RNDIS over Ethernet. /// /// Connecting a host to the Internet via Ethernet mobile device. The device appears to the host as an Ethernet gateway device. This class code may only be used in Interface Descriptors. RndisOverEthernet, /// RNDIS over WiFi. /// /// Connecting a host to the Internet via WiFi enabled mobile device. The device represents itself to the host as an 802.11 compliant network device. This class code may only be used in Interface Descriptors. RndisOverWifi, /// RNDIS over WiMAX /// /// Connecting a host to the Internet via WiMAX enabled mobile device. The device is represented to the host as an 802.16 network device. /// /// This class code may only be used in Interface Descriptors. RndisOverWiMax, /// RNDIS over WWAN /// /// Connecting a host to the Internet via a device using mobile broadband, i.e. WWAN (GSM/CDMA). /// /// This class code may only be used in Interface Descriptors. RndisOverWwan, /// RNDIS for Raw IPv4 /// /// Connecting a host to the Internet using raw IPv4 via non-Ethernet mobile device. Devices that provide raw IPv4, not in an Ethernet packet, may use this form to in lieu of other stock types. /// /// This class code may only be used in Interface Descriptors. RndisForRawIpv4, /// RNDIS for Raw IPv6 /// /// Connecting a host to the Internet using raw IPv6 via non-Ethernet mobile device. Devices that provide raw IPv6, not in an Ethernet packet, may use this form to in lieu of other stock types. /// /// This class code may only be used in Interface Descriptors. RndisForRawIpv6, /// RNDIS for GPRS /// /// Connecting a host to the Internet over GPRS mobile device using the device’s cellular radio RndisForGprs, /// USB3 Vision Control Interface Usb3VisionControlInterface, /// USB3 Vision Event Interface Usb3VisionEventInterface, /// USB3 Vision Streaming Interface Usb3VisionStreamingInterface, /// STEP. Stream Transport Efficient Protocol for content protection. StepStreamTransport, /// STEP RAW. Stream Transport Efficient Protocol for Raw content protection. StepRawStreamTransport, /// Command Interface in IAD CommandInterfaceIad, /// Command Interface in Interface Descriptor CommandInterfaceId, /// Media Interface in Interface Descriptor MediaInterfaceId, /// Device Firmware Upgrade. Device class definition provided on www.usb.org . DeviceFirmwareUpgrade, /// IRDA Bridge device. Device class definition provided on www.usb.org . IrdaBridge, /// USB Test and Measurement Device. Definition provided in the USB Test and Measurement Class spec found on www.usb.org . UsbTestMeasurement, /// USB Test and Measurement Device conforming to the USBTMC USB488 Subclass Specification found on www.usb.org. UsbTestMeasurementUsbTmc488, } /// A fully defined Class Code requires a (Base Class, Sub Class, Protocol) triplet pub type ClassCodeTriplet = (T, u8, u8); impl From> for ClassCode where T: Into, { fn from(triplet: ClassCodeTriplet) -> Self { match (triplet.0.into(), triplet.1, triplet.2) { (BaseClass::Hub, 0x00, 0x00) => ClassCode::FullSpeedHub, (BaseClass::Hub, 0x00, 0x01) => ClassCode::HighSpeedHubSingleTt, (BaseClass::Hub, 0x00, 0x02) => ClassCode::HighSpeedHubMultiTt, (BaseClass::Audio, 0x01, 0x00) => ClassCode::AudioVideoControlInterface, (BaseClass::Audio, 0x02, 0x00) => ClassCode::AudioVideoDataVideo, (BaseClass::Audio, 0x03, 0x00) => ClassCode::AudioVideoDataAudio, (BaseClass::Mctp, 0x00, 0x01) => ClassCode::MctpManagementController, (BaseClass::Mctp, 0x00, 0x02) => ClassCode::MctpHostInterfaceEndpoint, (BaseClass::Diagnostic, 0x01, 0x01) => ClassCode::Usb2ComplianceDevice, (BaseClass::Diagnostic, 0x02, 0x00) => ClassCode::DebugTargetVendorDefined, (BaseClass::Diagnostic, 0x02, 0x01) => ClassCode::GnuRemoteDebugCommandSet, (BaseClass::Diagnostic, 0x03, 0x01) => ClassCode::VendorDefinedTraceDbC, (BaseClass::Diagnostic, 0x04, 0x01) => ClassCode::VendorDefinedDfxDbC, (BaseClass::Diagnostic, 0x05, 0x00) => ClassCode::VendorDefinedTraceGPDvC, (BaseClass::Diagnostic, 0x05, 0x01) => ClassCode::GnuProtocolGpDvC, (BaseClass::Diagnostic, 0x06, 0x01) => ClassCode::VendorDefinedDfxDvC, (BaseClass::Diagnostic, 0x07, 0x01) => ClassCode::VendorDefinedTraceDvC, (BaseClass::WirelessController, 0x01, 0x01) => ClassCode::BluetoothProgrammingInterface, (BaseClass::WirelessController, 0x01, 0x02) => ClassCode::UwbRadioControlInterface, (BaseClass::WirelessController, 0x01, 0x03) => ClassCode::RemoteNdis, (BaseClass::WirelessController, 0x01, 0x04) => ClassCode::BluetoothAmpController, (BaseClass::WirelessController, 0x02, 0x01) => ClassCode::HostWireAdaptor, (BaseClass::WirelessController, 0x02, 0x02) => ClassCode::DeviceWireAdaptor, (BaseClass::WirelessController, 0x02, 0x03) => ClassCode::DeviceWireAdaptorIsochronous, (BaseClass::Miscellaneous, 0x01, 0x01) => ClassCode::ActiveSync, (BaseClass::Miscellaneous, 0x01, 0x02) => ClassCode::PalmSync, (BaseClass::Miscellaneous, 0x02, 0x01) => ClassCode::InterfaceAssociationDescriptor, (BaseClass::Miscellaneous, 0x02, 0x02) => ClassCode::WireAdaptorMultifunctionPeripheral, (BaseClass::Miscellaneous, 0x03, 0x01) => ClassCode::CableBasedAssociationFramework, (BaseClass::Miscellaneous, 0x04, 0x01) => ClassCode::RndisOverEthernet, (BaseClass::Miscellaneous, 0x04, 0x02) => ClassCode::RndisOverWifi, (BaseClass::Miscellaneous, 0x04, 0x03) => ClassCode::RndisOverWiMax, (BaseClass::Miscellaneous, 0x04, 0x04) => ClassCode::RndisOverWwan, (BaseClass::Miscellaneous, 0x04, 0x05) => ClassCode::RndisForRawIpv4, (BaseClass::Miscellaneous, 0x04, 0x06) => ClassCode::RndisForRawIpv6, (BaseClass::Miscellaneous, 0x04, 0x07) => ClassCode::RndisForGprs, (BaseClass::Miscellaneous, 0x05, 0x00) => ClassCode::Usb3VisionControlInterface, (BaseClass::Miscellaneous, 0x05, 0x01) => ClassCode::Usb3VisionEventInterface, (BaseClass::Miscellaneous, 0x05, 0x02) => ClassCode::Usb3VisionStreamingInterface, (BaseClass::Miscellaneous, 0x06, 0x01) => ClassCode::StepStreamTransport, (BaseClass::Miscellaneous, 0x06, 0x02) => ClassCode::StepRawStreamTransport, // (BaseClass::Miscellaneous, 0x07, 0x01) => DeviceClass::CommandInterfaceIAD, (BaseClass::Miscellaneous, 0x07, 0x01) => ClassCode::CommandInterfaceId, (BaseClass::Miscellaneous, 0x07, 0x02) => ClassCode::MediaInterfaceId, (BaseClass::ApplicationSpecificInterface, 0x01, 0x01) => { ClassCode::DeviceFirmwareUpgrade } (BaseClass::ApplicationSpecificInterface, 0x02, 0x00) => ClassCode::IrdaBridge, (BaseClass::ApplicationSpecificInterface, 0x03, 0x00) => ClassCode::UsbTestMeasurement, (BaseClass::ApplicationSpecificInterface, 0x03, 0x01) => { ClassCode::UsbTestMeasurementUsbTmc488 } (c, _, _) => ClassCode::Generic(c), } } } impl fmt::Display for ClassCode { fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result { write!(f, "{self:?}") } } impl From for ClassCode { fn from(class: BaseClass) -> Self { ClassCode::Generic(class) } } impl ClassCode { // TODO ensure this is correct fn usage(&self) -> DescriptorUsage { match self { ClassCode::Generic(c) => c.usage(), _ => DescriptorUsage::Interface, } } } /// USB Speed is also defined in libusb but this one allows us to provide updates and custom impl #[derive(Debug, Clone, PartialEq, Serialize, Deserialize)] #[non_exhaustive] #[serde(untagged, rename_all = "snake_case")] #[allow(missing_docs)] pub enum Speed { Unknown, LowSpeed, FullSpeed, HighSpeed, HighBandwidth, SuperSpeed, SuperSpeedPlus, SuperSpeedPlusX2, } impl FromStr for Speed { type Err = Error; fn from_str(s: &str) -> error::Result { Ok(match s { "20000" | "20.0 Gb/s" | "super_speed_plus_plus" | "super++" => Speed::SuperSpeedPlusX2, "10000" | "10.0 Gb/s" | "super_speed_plus" | "super+" => Speed::SuperSpeedPlus, "5000" | "5.0 Gb/s" | "super_speed" | "super" => Speed::SuperSpeed, "480" | "480.0 Mb/s" | "high_speed" | "high_bandwidth" | "high" => Speed::HighSpeed, "12" | "12.0 Mb/s" | "full_speed" | "full" => Speed::FullSpeed, "1.5" | "1.5 Mb/s" | "low_speed" | "low" => Speed::LowSpeed, _ => Speed::Unknown, }) } } /// Convert from byte returned from device descriptor impl From for Speed { fn from(b: u8) -> Self { match b { 6 => Speed::SuperSpeedPlusX2, 5 => Speed::SuperSpeedPlus, 4 => Speed::SuperSpeed, 3 => Speed::HighSpeed, 2 => Speed::FullSpeed, 1 => Speed::LowSpeed, _ => Speed::Unknown, } } } impl fmt::Display for Speed { fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result { write!( f, "{}", match self { Speed::SuperSpeedPlusX2 => "super_speed_plus_plus", Speed::SuperSpeedPlus => "super_speed_plus", Speed::SuperSpeed => "super_speed", Speed::HighSpeed | Speed::HighBandwidth => "high_speed", Speed::FullSpeed => "full_speed", Speed::LowSpeed => "low_speed", Speed::Unknown => "unknown", // _ => todo!("Unsupported speed"), } ) } } impl From<&Speed> for NumericalUnit { fn from(speed: &Speed) -> NumericalUnit { match speed { Speed::SuperSpeedPlusX2 => NumericalUnit { value: 20.0, unit: String::from("Gb/s"), description: Some(speed.to_string()), }, Speed::SuperSpeedPlus => NumericalUnit { value: 10.0, unit: String::from("Gb/s"), description: Some(speed.to_string()), }, Speed::SuperSpeed => NumericalUnit { value: 5.0, unit: String::from("Gb/s"), description: Some(speed.to_string()), }, Speed::HighSpeed | Speed::HighBandwidth => NumericalUnit { value: 480.0, unit: String::from("Mb/s"), description: Some(speed.to_string()), }, Speed::FullSpeed => NumericalUnit { value: 12.0, unit: String::from("Mb/s"), description: Some(speed.to_string()), }, Speed::LowSpeed => NumericalUnit { value: 1.5, unit: String::from("Mb/s"), description: Some(speed.to_string()), }, Speed::Unknown => NumericalUnit { value: 0.0, unit: String::from("Mb/s"), description: Some(speed.to_string()), }, } } } impl Speed { /// lsusb speed is always in Mb/s and shown just a M prefix /// /// ``` /// # use cyme::usb::Speed; /// /// assert_eq!(Speed::SuperSpeedPlus.to_lsusb_speed(), "10000M"); /// assert_eq!(Speed::FullSpeed.to_lsusb_speed(), "12M"); /// ``` pub fn to_lsusb_speed(&self) -> String { let dv = NumericalUnit::::from(self); let prefix = dv.unit.chars().next().unwrap_or('M'); match prefix { // see you when we have Tb/s buses :P 'G' => format!("{:.0}{}", dv.value * 1000.0, 'M'), _ => format!("{:.0}{}", dv.value, prefix), } } } /// Transfer and [`Endpoint`] direction #[derive(Debug, Clone, Copy, Hash, PartialEq, Eq, Serialize, Deserialize)] pub enum Direction { /// Direction for write (host to device) transfers. Out, /// Direction for read (device to host) transfers. In, } impl fmt::Display for Direction { fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result { if f.alternate() { match self { Direction::Out => write!(f, "OUT"), Direction::In => write!(f, "IN"), } } else { write!(f, "{self:?}") } } } /// Transfer type for [`Endpoint`] #[derive(Debug, Clone, Serialize, Deserialize)] #[repr(u8)] pub enum TransferType { /// Control endpoint. Control, /// Isochronous endpoint. Isochronous, /// Bulk endpoint. Bulk, /// Interrupt endpoint. Interrupt, } impl fmt::Display for TransferType { fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result { write!(f, "{self:?}") } } impl From for TransferType { fn from(b: u8) -> Self { match b & 0x03 { 0 => TransferType::Control, 1 => TransferType::Isochronous, 2 => TransferType::Bulk, 3 => TransferType::Interrupt, _ => unreachable!(), } } } /// Isochronous synchronization mode for [`Endpoint`] #[derive(Debug, Clone, Serialize, Deserialize)] #[repr(u8)] pub enum SyncType { /// No synchronisation. None, /// Asynchronous. Asynchronous, /// Adaptive. Adaptive, /// Synchronous. Synchronous, } impl fmt::Display for SyncType { fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result { write!(f, "{self:?}") } } impl From for SyncType { fn from(b: u8) -> Self { match (b & 0x0c) >> 2 { 0 => SyncType::None, 1 => SyncType::Asynchronous, 2 => SyncType::Adaptive, 3 => SyncType::Synchronous, _ => unreachable!(), } } } /// Isochronous usage type for [`Endpoint`] #[derive(Debug, Clone, Serialize, Deserialize)] #[repr(u8)] #[non_exhaustive] pub enum UsageType { /// Data endpoint. Data, /// Feedback endpoint. Feedback, /// Explicit feedback data endpoint. FeedbackData, /// Reserved. Reserved, } impl fmt::Display for UsageType { fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result { write!(f, "{self:?}") } } impl From for UsageType { fn from(b: u8) -> Self { match (b & 0x30) >> 4 { 0 => UsageType::Data, 1 => UsageType::Feedback, 2 => UsageType::FeedbackData, 3 => UsageType::Reserved, _ => unreachable!(), } } } // these are for backwards compatible json defaults /// The USB device descriptor is actually a fixed length fn default_device_desc_length() -> u8 { 18 } /// The USB configuration descriptor is variable but most are 9 bytes fn default_configuration_desc_length() -> u8 { 9 } /// The USB interface descriptor is variable but most are 9 bytes fn default_interface_desc_length() -> u8 { 9 } /// True for most endpoints other than audio fn default_endpoint_desc_length() -> u8 { 7 } /// Address information for a [`Endpoint`] // This struct could be one byte with getters using mask but this saves a custom Serialize impl for system_profiler #[derive(Debug, Clone, Copy, Hash, PartialEq, Eq, Serialize, Deserialize)] pub struct EndpointAddress { /// Endpoint address byte pub address: u8, /// Endpoint number on [`Interface`] 0..3b pub number: u8, /// Data transfer direction 7b pub direction: Direction, } impl From for EndpointAddress { fn from(b: u8) -> Self { EndpointAddress { address: b, // 0..3b number: b & 0x0f, direction: if b & 0x80 == 0 { Direction::Out } else { Direction::In }, } } } impl From for u8 { fn from(addr: EndpointAddress) -> u8 { addr.address } } impl From for EndpointAddress { fn from(path: EndpointPath) -> Self { path.endpoint_address() } } impl fmt::Display for EndpointAddress { fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result { write!(f, "EP {} {}", self.number, self.direction) } } /// Endpoint for a [`Interface`] #[derive(Debug, Clone, Serialize, Deserialize)] pub struct Endpoint { /// Endpoint length in bytes #[serde(default = "default_endpoint_desc_length")] // for backwards compatible json pub length: u8, /// Address information for endpoint pub address: EndpointAddress, /// Type of data transfer endpoint accepts pub transfer_type: TransferType, /// Synchronisation type (Iso mode) pub sync_type: SyncType, /// Usage type (Iso mode) pub usage_type: UsageType, /// Maximum packet size in bytes endpoint can send/receive - encoded with multiplier, use `max_packet_string` for packet information pub max_packet_size: u16, /// Interval for polling endpoint data transfers. Value in frame counts. Ignored for Bulk & Control Endpoints. Isochronous must equal 1 and field may range from 1 to 255 for interrupt endpoints. pub interval: u8, /// Extra descriptors data based on type #[serde(default)] // default for legacy json pub extra: Option>, #[serde(skip)] pub(crate) internal: InternalData, /// Option because of legacy json de compatibility /// /// Allows lookup back to parent pub(crate) endpoint_path: Option, } /// Deprecated alias for [`Endpoint`] #[deprecated(since = "2.0.0", note = "Use Endpoint instead")] pub type USBEndpoint = Endpoint; impl Endpoint { /// Decodes the max packet value into a multiplier and number of bytes like lsusb pub fn max_packet_string(&self) -> String { format!( "{}x {}", ((self.max_packet_size >> 11) & 3) + 1, self.max_packet_size & 0x7ff ) } /// Returns the attributes byte for the endpoint pub fn attributes(&self) -> u8 { self.transfer_type.to_owned() as u8 | ((self.sync_type.to_owned() as u8) << 2) | ((self.usage_type.to_owned() as u8) << 4) } /// Should the endpoint be displayed expanded in a tree pub fn is_expanded(&self) -> bool { self.internal.expanded } /// Set the expanded state of the endpoint pub fn set_expanded(&mut self, expanded: bool) { self.internal.expanded = expanded; } /// Toggle the expanded state of the endpoint pub fn toggle_expanded(&mut self) { self.internal.expanded = !self.internal.expanded; } /// Get [`EndpointPath`] for endpoint which includes [`DevicePath`] pub fn endpoint_path(&self) -> Option { self.endpoint_path.to_owned() } } /// Interface within a [`Configuration`] #[derive(Debug, Clone, Serialize, Deserialize)] pub struct Interface { /// Name from descriptor pub name: Option, /// Index of name string in descriptor - only useful for lsusb verbose print #[serde(default)] pub string_index: u8, /// Interface number pub number: u8, /// Interface port path - could be generated from device but stored here for ease pub path: String, /// Class of interface provided by USB IF pub class: BaseClass, /// Sub-class of interface provided by USB IF pub sub_class: u8, /// Prototol code for interface provided by USB IF pub protocol: u8, /// Interfaces can have the same number/path but an alternate setting defined here pub alt_setting: u8, /// Driver obtained from udev on Linux only pub driver: Option, /// syspath obtained from udev on Linux only pub syspath: Option, /// An interface can have many endpoints pub endpoints: Vec, /// Size of interface descriptor in bytes #[serde(default = "default_interface_desc_length")] pub length: u8, /// Extra descriptors for interface based on type #[serde(default)] // default for legacy json pub extra: Option>, #[serde(skip)] pub(crate) internal: InternalData, /// [`DevicePath`] to interface /// /// This is option for legacy json de compatibility. In hindsight this would have been used and syspath, path derived from it pub(crate) device_path: Option, } /// Deprecated alias for [`Interface`] #[deprecated(since = "2.0.0", note = "Use Interface instead")] pub type USBInterface = Interface; impl Interface { /// Linux sysfs name of [`Interface`] /// /// The port path with config.interface, for example '1-1.2:1.0' pub fn sysfs_name(&self) -> String { self.path.to_owned() } /// Linux sysfs path to [`Interface`] /// /// The [`sysfs_name`] with the sysfs path prefix from udev on Linux, else None pub fn sysfs_path(&self) -> Option { self.syspath.as_ref().map(PathBuf::from) } /// [`DevicePath`] to interface /// /// Option for legacy json deserialize compatibility - should be present in > 2.1.3. Will attempt to parse from `path` if not present pub fn device_path(&self) -> Option { // will be present unless legacy json import if let Some(ref dp) = self.device_path { Some(dp.to_owned()) } else { // try to parse from path let mut dp = DevicePath::from_str(&self.path).ok()?; // set alt setting since not in str path dp.set_alt_setting(self.alt_setting); Some(dp) } } /// Name of class from Linux USB IDs repository pub fn class_name(&self) -> Option<&str> { usb_ids::Classes::iter() .find(|c| c.id() == u8::from(self.class)) .map(|c| c.name()) } /// Name of sub class from Linux USB IDs repository pub fn sub_class_name(&self) -> Option<&str> { usb_ids::SubClass::from_cid_scid(u8::from(self.class), self.sub_class).map(|sc| sc.name()) } /// Name of protocol from Linux USB IDs repository pub fn protocol_name(&self) -> Option<&str> { usb_ids::Protocol::from_cid_scid_pid(u8::from(self.class), self.sub_class, self.protocol) .map(|p| p.name()) } /// Returns fully defined USB [`Class`] based on base_class, sub_class and protocol triplet pub fn fully_defined_class(&self) -> ClassCode { (self.class, self.sub_class, self.protocol).into() } /// Should the interface be displayed expanded in a tree pub fn is_expanded(&self) -> bool { self.internal.expanded } /// Toggle the expanded state of the interface pub fn toggle_expanded(&mut self) { self.internal.expanded = !self.internal.expanded; } /// Set the expanded state of the interface and all its endpoints pub fn set_all_expanded(&mut self, expanded: bool) { self.internal.expanded = expanded; for endpoint in self.endpoints.iter_mut() { endpoint.set_expanded(expanded); } } } /// Devices can have multiple configurations, each with different attributes and interfaces #[derive(Debug, Clone, Serialize, Deserialize)] pub struct Configuration { /// Name from string descriptor pub name: String, /// Index of name string in descriptor - only useful for lsusb verbose print #[serde(default)] pub string_index: u8, /// Number of config, bConfigurationValue; value to set to enable to configuration pub number: u8, /// Interfaces available for this configuruation pub interfaces: Vec, /// Attributes of configuration, bmAttributes - was a HashSet since attributes should be unique but caused issues printing out of order pub attributes: Vec, /// Maximum power consumption in mA pub max_power: NumericalUnit, /// Size of configuration descriptor in bytes #[serde(default = "default_configuration_desc_length")] pub length: u8, /// Total length of configuration descriptor in bytes including all interfaces and endpoints #[serde(default)] pub total_length: u16, /// Extra descriptors for configuration based on type #[serde(default)] // default for legacy json pub extra: Option>, #[serde(skip)] pub(crate) internal: InternalData, } /// Deprecated alias for [`Configuration`] #[deprecated(since = "2.0.0", note = "Use Configuration instead")] pub type USBConfiguration = Configuration; impl Configuration { /// Converts attributes into a ';' separated String pub fn attributes_string(&self) -> String { ConfigAttributes::attributes_to_string(&self.attributes) } /// Convert attributes back to reg value pub fn attributes_value(&self) -> u8 { let mut ret: u8 = 0x80; // always set reserved bit for attr in self.attributes.iter() { match attr { ConfigAttributes::SelfPowered => ret |= 0x40, ConfigAttributes::RemoteWakeup => ret |= 0x20, ConfigAttributes::BatteryPowered => ret |= 0x10, _ => (), } } ret } /// Should the configuration be displayed expanded in a tree pub fn is_expanded(&self) -> bool { self.internal.expanded } /// Toggle the expanded state of the configuration pub fn toggle_expanded(&mut self) { self.internal.expanded = !self.internal.expanded; } /// Set the expanded state of the configuration and all its interfaces pub fn set_all_expanded(&mut self, expanded: bool) { self.internal.expanded = expanded; for interface in self.interfaces.iter_mut() { interface.set_all_expanded(expanded); } } /// Gets the [`DevicePath`] for the configuration based on first [`Interface`] fn device_path(&self) -> Option { self.interfaces.first().and_then(|i| i.device_path()) } /// Gets the [`PortPath`] for the configuration based on first [`Interface`] pub fn parent_port_path(&self) -> Option { self.device_path().map(|p| p.port_path().to_owned()) } /// Gets the [`ConfigurationPath`] for the configuration based on [`Self::parent_port_path`] and configuration number pub fn configuration_path(&self) -> Option { self.parent_port_path().map(|p| (p, self.number)) } } /// Extra USB device data for verbose printing #[skip_serializing_none] #[derive(Debug, Clone, Serialize, Deserialize)] pub struct DeviceExtra { /// Maximum packet size in bytes pub max_packet_size: u8, /// Driver obtained from udev on Linux only pub driver: Option, /// syspath obtained from udev on Linux only pub syspath: Option, /// Vendor name from usb_ids VID lookup pub vendor: Option, /// Product name from usb_ids VIDPID lookup pub product_name: Option, /// Tuple of indexes to strings (iProduct, iManufacturer, iSerialNumber) - only useful for the lsusb verbose print #[serde(default)] pub string_indexes: (u8, u8, u8), /// USB devices can be have a number of configurations pub configurations: Vec, /// Device status pub status: Option, /// Debug descriptor if present pub debug: Option, /// Binary Object Store (BOS) descriptor if present pub binary_object_store: Option, /// Device qualifier descriptor if present pub qualifier: Option, /// Hub descriptor if present (is a hub) pub hub: Option, /// Speed that the device is operating at pub negotiated_speed: Option, } /// Deprecated alias for [`DeviceExtra`] #[deprecated(since = "2.0.0", note = "Use DeviceExtra instead")] pub type USBDeviceExtra = DeviceExtra; #[cfg(test)] mod tests { use super::*; #[test] fn test_version_to_string() { assert_eq!(Version(155, 0, 0).to_string(), "9b.00"); // leading not padded assert_eq!(Version(10, 4, 15).to_string(), "a.4f"); assert_eq!(Version(2, 0, 1).to_string(), "2.01"); } #[test] fn test_version_from_f32() { assert_eq!(Version::try_from(155.0).unwrap(), Version(155, 0, 0)); assert_eq!(Version::try_from(101.0).unwrap(), Version(101, 0, 0)); assert_eq!(Version::try_from(2.01).unwrap(), Version(2, 0, 1)); assert_eq!(Version::try_from(2.31).unwrap(), Version(2, 1, 15)); } } cyme-2.2.6/src/usb/000077500000000000000000000000001506545537300140535ustar00rootroot00000000000000cyme-2.2.6/src/usb/descriptors.rs000066400000000000000000001310521506545537300167640ustar00rootroot00000000000000//! Defines for USB parsed device descriptors; extends the `usb` module. use serde::{Deserialize, Serialize}; use std::convert::TryFrom; use super::*; use crate::error::{self, Error, ErrorKind}; pub mod audio; pub mod bos; pub mod cdc; pub mod video; /// USB descriptor types #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[non_exhaustive] #[repr(u8)] #[allow(missing_docs)] #[serde(rename_all = "kebab-case")] pub enum DescriptorType { Device = 0x01, Config = 0x02, String = 0x03, Interface = 0x04, Endpoint = 0x05, DeviceQualifier = 0x06, OtherSpeedConfiguration = 0x07, InterfacePower = 0x08, Otg = 0x09, Debug = 0x0a, InterfaceAssociation = 0x0b, Security = 0x0c, Key = 0x0d, Encrypted = 0x0e, Bos = 0x0f, DeviceCapability = 0x10, WirelessEndpointCompanion = 0x11, WireAdaptor = 0x21, Report = 0x22, Physical = 0x23, Pipe = 0x24, Hub = 0x29, SuperSpeedHub = 0x2a, SsEndpointCompanion = 0x30, SsIsocEndpointCompanion = 0x31, Unknown(u8), } impl From for DescriptorType { fn from(b: u8) -> Self { match b { 0x01 => DescriptorType::Device, 0x02 => DescriptorType::Config, 0x03 => DescriptorType::String, 0x04 => DescriptorType::Interface, 0x05 | 0x25 => DescriptorType::Endpoint, 0x06 => DescriptorType::DeviceQualifier, 0x07 => DescriptorType::OtherSpeedConfiguration, 0x08 => DescriptorType::InterfacePower, 0x09 => DescriptorType::Otg, 0x0a => DescriptorType::Debug, 0x0b => DescriptorType::InterfaceAssociation, 0x0c => DescriptorType::Security, 0x0d => DescriptorType::Key, 0x0e => DescriptorType::Encrypted, 0x0f => DescriptorType::Bos, 0x10 => DescriptorType::DeviceCapability, 0x11 => DescriptorType::WirelessEndpointCompanion, 0x21 => DescriptorType::WireAdaptor, 0x22 => DescriptorType::Report, 0x23 => DescriptorType::Physical, 0x24 => DescriptorType::Pipe, 0x29 => DescriptorType::Hub, 0x2a => DescriptorType::SuperSpeedHub, 0x30 => DescriptorType::SsEndpointCompanion, 0x31 => DescriptorType::SsIsocEndpointCompanion, _ => DescriptorType::Unknown(b), } } } impl From for u8 { fn from(dt: DescriptorType) -> Self { match dt { DescriptorType::Device => 0x01, DescriptorType::Config => 0x02, DescriptorType::String => 0x03, DescriptorType::Interface => 0x04, DescriptorType::Endpoint => 0x05, DescriptorType::DeviceQualifier => 0x06, DescriptorType::OtherSpeedConfiguration => 0x07, DescriptorType::InterfacePower => 0x08, DescriptorType::Otg => 0x09, DescriptorType::Debug => 0x0a, DescriptorType::InterfaceAssociation => 0x0b, DescriptorType::Security => 0x0c, DescriptorType::Key => 0x0d, DescriptorType::Encrypted => 0x0e, DescriptorType::Bos => 0x0f, DescriptorType::DeviceCapability => 0x10, DescriptorType::WirelessEndpointCompanion => 0x11, DescriptorType::WireAdaptor => 0x21, DescriptorType::Report => 0x22, DescriptorType::Physical => 0x23, DescriptorType::Pipe => 0x24, DescriptorType::Hub => 0x29, DescriptorType::SuperSpeedHub => 0x2a, DescriptorType::SsEndpointCompanion => 0x30, DescriptorType::SsIsocEndpointCompanion => 0x31, DescriptorType::Unknown(b) => b, } } } #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct DeviceDescriptor { pub length: u8, pub descriptor_type: u8, pub usb_version: Version, pub device_class: u8, pub device_sub_class: u8, pub device_protocol: u8, pub max_packet_size: u8, pub vendor_id: u16, pub product_id: u16, pub device_version: Version, pub manufacturer_string_index: u8, pub product_string_index: u8, pub serial_number_string_index: u8, pub num_configurations: u8, } impl TryFrom<&[u8]> for DeviceDescriptor { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 18 { return Err(Error::new_descriptor_len( "DeviceDescriptor", 18, value.len(), )); } Ok(DeviceDescriptor { length: value[0], descriptor_type: value[1], usb_version: Version::from_bcd(u16::from_le_bytes([value[2], value[3]])), device_class: value[4], device_sub_class: value[5], device_protocol: value[6], max_packet_size: value[7], vendor_id: u16::from_le_bytes([value[8], value[9]]), product_id: u16::from_le_bytes([value[10], value[11]]), device_version: Version::from_bcd(u16::from_le_bytes([value[12], value[13]])), manufacturer_string_index: value[14], product_string_index: value[15], serial_number_string_index: value[16], num_configurations: value[17], }) } } impl From for Vec { fn from(dd: DeviceDescriptor) -> Self { let mut ret = vec![dd.length, dd.descriptor_type]; ret.extend(u16::from(dd.usb_version).to_le_bytes()); ret.push(dd.device_class); ret.push(dd.device_sub_class); ret.push(dd.device_protocol); ret.push(dd.max_packet_size); ret.extend(dd.vendor_id.to_le_bytes()); ret.extend(dd.product_id.to_le_bytes()); ret.extend(u16::from(dd.device_version).to_le_bytes()); ret.push(dd.manufacturer_string_index); ret.push(dd.product_string_index); ret.push(dd.serial_number_string_index); ret.push(dd.num_configurations); ret } } /// USB descriptor encloses type specific descriptor structs /// /// Not all descriptors are implemented #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[non_exhaustive] #[allow(missing_docs)] #[serde(rename_all = "kebab-case")] pub enum Descriptor { Device(ClassDescriptor), Config(ClassDescriptor), String(String), Interface(ClassDescriptor), Endpoint(ClassDescriptor), DeviceQualifier(DeviceQualifierDescriptor), Otg(OnTheGoDescriptor), Debug(DebugDescriptor), InterfaceAssociation(InterfaceAssociationDescriptor), Security(SecurityDescriptor), Encrypted(EncryptionDescriptor), Bos(bos::BinaryObjectStoreDescriptor), Report(HidReportDescriptor), Hub(HubDescriptor), SuperSpeedHub(HubDescriptor), SsEndpointCompanion(SsEndpointCompanionDescriptor), // these are internal Unknown(Vec), Junk(Vec), } impl Descriptor { /// Returns the [`DescriptorType`] of the descriptor pub fn descriptor_type(&self) -> DescriptorType { match self { Descriptor::Device(_) => DescriptorType::Device, Descriptor::Config(_) => DescriptorType::Config, Descriptor::String(_) => DescriptorType::String, Descriptor::Interface(_) => DescriptorType::Interface, Descriptor::Endpoint(_) => DescriptorType::Endpoint, Descriptor::DeviceQualifier(_) => DescriptorType::DeviceQualifier, Descriptor::Otg(_) => DescriptorType::Otg, Descriptor::Debug(_) => DescriptorType::Debug, Descriptor::InterfaceAssociation(_) => DescriptorType::InterfaceAssociation, Descriptor::Security(_) => DescriptorType::Security, Descriptor::Encrypted(_) => DescriptorType::Encrypted, Descriptor::Bos(_) => DescriptorType::Bos, Descriptor::Report(_) => DescriptorType::Report, Descriptor::Hub(_) => DescriptorType::Hub, Descriptor::SuperSpeedHub(_) => DescriptorType::SuperSpeedHub, Descriptor::SsEndpointCompanion(_) => DescriptorType::SsEndpointCompanion, Descriptor::Unknown(d) => DescriptorType::Unknown(d.get(1).copied().unwrap_or(0)), Descriptor::Junk(d) => DescriptorType::Unknown(d.get(1).copied().unwrap_or(0)), } } } impl TryFrom<&[u8]> for Descriptor { type Error = Error; fn try_from(v: &[u8]) -> error::Result { if v.len() < 2 { return Err(Error::new_descriptor_len("Descriptor", 2, v.len())); } // junk length if v[0] < 2 { return Ok(Descriptor::Junk(v.to_vec())); } match v[1].into() { DescriptorType::Device => Ok(Descriptor::Device(ClassDescriptor::try_from(v)?)), DescriptorType::Config => Ok(Descriptor::Config(ClassDescriptor::try_from(v)?)), DescriptorType::String => { Ok(Descriptor::String(String::from_utf8_lossy(v).to_string())) } DescriptorType::Interface => Ok(Descriptor::Interface(ClassDescriptor::try_from(v)?)), DescriptorType::Endpoint => Ok(Descriptor::Endpoint(ClassDescriptor::try_from(v)?)), DescriptorType::DeviceQualifier => Ok(Descriptor::DeviceQualifier( DeviceQualifierDescriptor::try_from(v)?, )), DescriptorType::Otg => Ok(Descriptor::Otg(OnTheGoDescriptor::try_from(v)?)), DescriptorType::Debug => Ok(Descriptor::Debug(DebugDescriptor::try_from(v)?)), DescriptorType::InterfaceAssociation => Ok(Descriptor::InterfaceAssociation( InterfaceAssociationDescriptor::try_from(v)?, )), DescriptorType::Security => Ok(Descriptor::Security(SecurityDescriptor::try_from(v)?)), DescriptorType::Encrypted => { Ok(Descriptor::Encrypted(EncryptionDescriptor::try_from(v)?)) } DescriptorType::Bos => Ok(Descriptor::Bos(bos::BinaryObjectStoreDescriptor::try_from( v, )?)), DescriptorType::Report => Ok(Descriptor::Report(HidReportDescriptor::try_from(v)?)), DescriptorType::Hub => Ok(Descriptor::Hub(HubDescriptor::try_from(v)?)), DescriptorType::SuperSpeedHub => { Ok(Descriptor::SuperSpeedHub(HubDescriptor::try_from(v)?)) } DescriptorType::SsEndpointCompanion => Ok(Descriptor::SsEndpointCompanion( SsEndpointCompanionDescriptor::try_from(v)?, )), _ => { // try masking off the request type for misplaced descriptors let masked = v[1] & !0x20; match masked.into() { DescriptorType::Device => Ok(Descriptor::Device(ClassDescriptor::try_from(v)?)), DescriptorType::Config => Ok(Descriptor::Config(ClassDescriptor::try_from(v)?)), DescriptorType::String => { Ok(Descriptor::String(String::from_utf8_lossy(v).to_string())) } DescriptorType::Interface => { Ok(Descriptor::Interface(ClassDescriptor::try_from(v)?)) } DescriptorType::Endpoint => { Ok(Descriptor::Endpoint(ClassDescriptor::try_from(v)?)) } _ => Ok(Descriptor::Unknown(v.to_vec())), } } } } } impl From for Vec { fn from(dt: Descriptor) -> Self { match dt { Descriptor::Device(d) => d.into(), Descriptor::Config(c) => c.into(), Descriptor::String(s) => s.into_bytes(), Descriptor::Interface(i) => i.into(), Descriptor::Endpoint(e) => e.into(), Descriptor::DeviceQualifier(dq) => dq.into(), Descriptor::Debug(d) => d.into(), Descriptor::InterfaceAssociation(ia) => ia.into(), Descriptor::Security(s) => s.into(), Descriptor::Encrypted(e) => e.into(), Descriptor::Bos(b) => b.into(), Descriptor::Report(r) => r.into(), Descriptor::Hub(h) => h.into(), Descriptor::Otg(o) => o.into(), Descriptor::SuperSpeedHub(h) => h.into(), Descriptor::SsEndpointCompanion(s) => s.into(), Descriptor::Unknown(u) => u, Descriptor::Junk(j) => j, } } } impl Descriptor { /// Uses [`ClassCodeTriplet`] to update the [`ClassDescriptor`] with [`BaseClass`] for class specific descriptors pub fn update_with_class_context + Copy>( &mut self, class_triplet: ClassCodeTriplet, ) -> Result<(), Error> { match self { Descriptor::Device(d) => d.update_with_class_context(class_triplet), Descriptor::Config(c) => c.update_with_class_context(class_triplet), Descriptor::Interface(i) => i.update_with_class_context(class_triplet), Descriptor::Endpoint(e) => e.update_with_class_context(class_triplet), _ => Ok(()), } } } /// Device Capability Type Codes (Wireless USB spec and USB 3.0 bus spec) #[derive(Debug, Clone, Copy, Hash, PartialEq, Eq, Serialize, Deserialize)] #[non_exhaustive] #[allow(missing_docs)] #[repr(u8)] pub enum DeviceCapability { WirelessUsb = 0x01, Usb20Extension = 0x02, Superspeed = 0x03, ContainerId = 0x04, Platform = 0x05, SuperSpeedPlus = 0x0a, BillBoard = 0x0d, BillboardAltMode = 0x0f, ConfigurationSummary = 0x10, } /// Extra USB device data for unknown descriptors #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] pub struct DescriptorData(pub Vec); /// The Interface Association Descriptor is a specific type of USB descriptor used to associate a group of interfaces with a particular function or feature of a USB device /// /// It helps organize and convey the relationship between different interfaces within a single device configuration. #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct InterfaceAssociationDescriptor { pub length: u8, pub descriptor_type: u8, pub first_interface: u8, pub interface_count: u8, pub function_class: u8, pub function_sub_class: u8, pub function_protocol: u8, pub function_string_index: u8, pub function_string: Option, } impl TryFrom<&[u8]> for InterfaceAssociationDescriptor { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 8 { return Err(Error::new_descriptor_len( "InterfaceAssociationDescriptor", 8, value.len(), )); } Ok(InterfaceAssociationDescriptor { length: value[0], descriptor_type: value[1], first_interface: value[2], interface_count: value[3], function_class: value[4], function_sub_class: value[5], function_protocol: value[6], function_string_index: value[7], function_string: None, }) } } impl From for Vec { fn from(iad: InterfaceAssociationDescriptor) -> Self { vec![ iad.length, iad.descriptor_type, iad.first_interface, iad.interface_count, iad.function_class, iad.function_sub_class, iad.function_protocol, iad.function_string_index, ] } } /// USB SS Endpoint Companion descriptor #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct SsEndpointCompanionDescriptor { pub length: u8, pub descriptor_type: u8, pub max_burst: u8, pub attributes: u8, pub bytes_per_interval: Option, } impl TryFrom<&[u8]> for SsEndpointCompanionDescriptor { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 4 { return Err(Error::new_descriptor_len( "SsEndpointCompanionDescriptor", 4, value.len(), )); } Ok(SsEndpointCompanionDescriptor { length: value[0], descriptor_type: value[1], max_burst: value[2], attributes: value[3], bytes_per_interval: value.get(4..6).map(|b| u16::from_le_bytes([b[0], b[1]])), }) } } impl From for Vec { fn from(sec: SsEndpointCompanionDescriptor) -> Self { let mut ret = vec![ sec.length, sec.descriptor_type, sec.max_burst, sec.attributes, ]; if let Some(bpi) = sec.bytes_per_interval { ret.extend(bpi.to_le_bytes()); } ret } } /// USB security descriptor #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct SecurityDescriptor { pub length: u8, pub descriptor_type: u8, pub total_length: u16, pub encryption_types: u8, } impl TryFrom<&[u8]> for SecurityDescriptor { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 5 { return Err(Error::new_descriptor_len( "SecurityDescriptor", 5, value.len(), )); } Ok(SecurityDescriptor { length: value[0], descriptor_type: value[1], total_length: u16::from_le_bytes([value[2], value[3]]), encryption_types: value[4], }) } } impl From for Vec { fn from(sd: SecurityDescriptor) -> Self { let mut ret = Vec::new(); ret.push(sd.length); ret.push(sd.descriptor_type); ret.extend(sd.total_length.to_le_bytes()); ret.push(sd.encryption_types); ret } } /// Encryption type for [`SecurityDescriptor`] #[derive(Debug, Clone, Copy, Hash, PartialEq, Eq, Serialize, Deserialize)] #[repr(u8)] #[non_exhaustive] #[allow(missing_docs)] #[serde(rename_all = "kebab-case")] pub enum EncryptionType { Unsecure, Wired, Ccm1, Rsa1, Reserved, } impl From for EncryptionType { fn from(b: u8) -> Self { match b { 0x00 => EncryptionType::Unsecure, 0x01 => EncryptionType::Wired, 0x02 => EncryptionType::Ccm1, 0x03 => EncryptionType::Rsa1, _ => EncryptionType::Reserved, } } } impl From for u8 { fn from(et: EncryptionType) -> Self { match et { EncryptionType::Unsecure => 0x00, EncryptionType::Wired => 0x01, EncryptionType::Ccm1 => 0x02, EncryptionType::Rsa1 => 0x03, EncryptionType::Reserved => 0xff, } } } /// USB encryption descriptor #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct EncryptionDescriptor { pub length: u8, pub descriptor_type: u8, pub encryption_type: EncryptionType, pub encryption_value: u8, pub auth_key_index: u8, } impl TryFrom<&[u8]> for EncryptionDescriptor { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 5 { return Err(Error::new_descriptor_len( "EncryptionDescriptor", 5, value.len(), )); } Ok(EncryptionDescriptor { length: value[0], descriptor_type: value[1], encryption_type: EncryptionType::from(value[2]), encryption_value: value[3], auth_key_index: value[4], }) } } impl From for Vec { fn from(ed: EncryptionDescriptor) -> Self { vec![ ed.length, ed.descriptor_type, u8::from(ed.encryption_type), ed.encryption_value, ed.auth_key_index, ] } } /// USB base class descriptor #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[serde(rename_all = "kebab-case")] pub enum ClassDescriptor { /// USB HID extra descriptor Hid(HidDescriptor), /// USB Communication extra descriptor Communication(cdc::CommunicationDescriptor), /// USB CCID (Smart Card) extra descriptor Ccid(CcidDescriptor), /// USB Printer extra descriptor Printer(PrinterDescriptor), /// USB MIDI extra descriptor /// /// For legacy purposes, MIDI is defined as a SubClass (3) of Audio Class [1](https://www.usb.org/sites/default/files/USB%20MIDI%20v2_0.pdf) but we define at as a separate ClassDescriptor Midi(audio::MidiDescriptor, u8), /// USB Audio extra descriptor Audio(audio::UacDescriptor, audio::UacProtocol), /// USB Video extra descriptor Video(video::UvcDescriptor, u8), /// Device Firmware Upgrade (DFU) descriptor Dfu(DfuDescriptor), /// Generic descriptor with `Option` /// /// Used for most descriptors and allows for TryFrom without knowing the [`BaseClass`] Generic(Option>, GenericDescriptor), } impl TryFrom<&[u8]> for ClassDescriptor { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 3 { return Err(Error::new_descriptor_len("ClassDescriptor", 3, value.len())); } Ok(ClassDescriptor::Generic( None, GenericDescriptor::try_from(value)?, )) } } impl From for Vec { fn from(cd: ClassDescriptor) -> Self { match cd { ClassDescriptor::Generic(_, gd) => gd.into(), ClassDescriptor::Hid(hd) => hd.into(), ClassDescriptor::Ccid(cd) => cd.into(), ClassDescriptor::Printer(pd) => pd.into(), ClassDescriptor::Communication(cd) => cd.into(), ClassDescriptor::Midi(md, _) => md.into(), ClassDescriptor::Audio(ad, _) => ad.into(), ClassDescriptor::Video(vd, _) => vd.into(), ClassDescriptor::Dfu(dd) => dd.into(), } } } impl ClassDescriptor { /// Uses [`ClassCodeTriplet`] to update the [`ClassDescriptor`] with [`BaseClass`] and descriptor if it is not [`GenericDescriptor`] pub fn update_with_class_context + Copy>( &mut self, triplet: ClassCodeTriplet, ) -> Result<(), Error> { if let ClassDescriptor::Generic(_, gd) = self { match (triplet.0.into(), triplet.1, triplet.2) { (BaseClass::Hid, _, _) => { *self = ClassDescriptor::Hid(HidDescriptor::try_from(gd.to_owned())?) } (BaseClass::SmartCard, _, _) => { *self = ClassDescriptor::Ccid(CcidDescriptor::try_from(gd.to_owned())?) } (BaseClass::Printer, _, _) => { *self = ClassDescriptor::Printer(PrinterDescriptor::try_from(gd.to_owned())?) } (BaseClass::CdcCommunications, _, _) | (BaseClass::CdcData, _, _) => { *self = ClassDescriptor::Communication(cdc::CommunicationDescriptor::try_from( gd.to_owned(), )?) } // For legacy purposes, MIDI is defined as a SubClass of Audio Class // but we define at as a separate ClassDescriptor (BaseClass::Audio, 3, p) => { *self = ClassDescriptor::Midi(audio::MidiDescriptor::try_from(gd.to_owned())?, p) } // UAC (BaseClass::Audio, s, p) => { *self = ClassDescriptor::Audio( // endpoint is included in UacInterfaceDescriptor::try_from audio::UacDescriptor::try_from((gd.to_owned(), s, p))?, audio::UacProtocol::from(p), ) } (BaseClass::Video, s, p) => { *self = ClassDescriptor::Video( video::UvcDescriptor::try_from((gd.to_owned(), s, p))?, p, ) } (BaseClass::ApplicationSpecificInterface, 1, _) => { *self = ClassDescriptor::Dfu(DfuDescriptor::try_from(gd.to_owned())?) } ct => *self = ClassDescriptor::Generic(Some(ct), gd.to_owned()), } } Ok(()) } } /// USB HID report descriptor /// /// Similar to [`GenericDescriptor`] but with a wLength rather than bLength and no sub-type #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct HidReportDescriptor { pub descriptor_type: u8, pub length: u16, pub data: Option>, } impl TryFrom<&[u8]> for HidReportDescriptor { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 3 { return Err(Error::new_descriptor_len( "HidReportDescriptor", 3, value.len(), )); } if value[0] != 0x22 { return Err(Error::new( ErrorKind::InvalidArg, "HID report descriptor must have descriptor type 0x22", )); } let length = u16::from_le_bytes([value[1], value[2]]); Ok(HidReportDescriptor { descriptor_type: value[0], length, data: value.get(3..3 + length as usize).map(|d| d.to_vec()), }) } } impl From for Vec { fn from(hd: HidReportDescriptor) -> Self { let mut ret = Vec::new(); ret.push(hd.descriptor_type); ret.extend(hd.length.to_le_bytes()); if let Some(data) = hd.data { ret.extend(data); } ret } } /// USB generic descriptor /// /// Used for most [`ClassDescriptor`]s #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct GenericDescriptor { pub length: u8, pub descriptor_type: u8, pub descriptor_subtype: u8, pub data: Option>, } impl TryFrom<&[u8]> for GenericDescriptor { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 3 { return Err(Error::new_descriptor_len( "GenericDescriptor", 3, value.len(), )); } let length = value[0]; if length as usize > value.len() { return Err(Error::new_descriptor_len( "GenericDescriptor reported", length as usize, value.len(), )); } Ok(GenericDescriptor { length, descriptor_type: value[1], descriptor_subtype: value[2], data: value.get(3..).map(|d| d.to_vec()), }) } } impl From for Vec { fn from(gd: GenericDescriptor) -> Self { let mut ret = Vec::new(); ret.push(gd.length); ret.push(gd.descriptor_type); ret.push(gd.descriptor_subtype); if let Some(data) = gd.data { ret.extend(data); } ret } } impl GenericDescriptor { /// Returns the reported length of the data pub fn len(&self) -> usize { self.length as usize } /// Returns true if the reported length of the data is 0 pub fn is_empty(&self) -> bool { self.len() == 0 } /// Returns the expected length of the data based on the length field minus the bytes taken by struct fields pub fn expected_data_length(&self) -> usize { if self.len() < 3 { 0 } else { self.len() - 3 } } /// Returns the (cloned) data as a `Vec` pub fn to_vec(&self) -> Vec { self.clone().into() } } /// USB HID descriptor #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct HidDescriptor { pub length: u8, pub descriptor_type: u8, pub bcd_hid: Version, pub country_code: u8, pub descriptors: Vec, } impl TryFrom<&[u8]> for HidDescriptor { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 6 { return Err(Error::new_descriptor_len("HidDescriptor", 6, value.len())); } let num_descriptors = value[5] as usize; let mut descriptors_vec = value[6..].to_vec(); let mut descriptors = Vec::::with_capacity(num_descriptors); for _ in 0..num_descriptors { if descriptors_vec.len() < 3 { return Err(Error::new_descriptor_len( "HidReportDescriptor", 3, descriptors_vec.len(), )); } // Report data requires read of report from device so allow HidReportDescriptor creation but with no data descriptors.push(descriptors_vec.drain(..3).as_slice().try_into()?); } Ok(HidDescriptor { length: value[0], descriptor_type: value[1], bcd_hid: Version::from_bcd(u16::from_le_bytes([value[2], value[3]])), country_code: value[4], descriptors, }) } } impl TryFrom for HidDescriptor { type Error = Error; fn try_from(gd: GenericDescriptor) -> error::Result { let gd_vec: Vec = gd.into(); HidDescriptor::try_from(&gd_vec[..]) } } impl From for Vec { fn from(hd: HidDescriptor) -> Self { let mut ret = Vec::new(); ret.push(hd.length); ret.push(hd.descriptor_type); ret.extend(u16::from(hd.bcd_hid).to_le_bytes()); ret.push(hd.country_code); for desc in hd.descriptors { ret.extend(Vec::::from(desc)); } ret } } /// USB CCID (Smart Card) descriptor #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct CcidDescriptor { pub length: u8, pub descriptor_type: u8, pub version: Version, pub max_slot_index: u8, pub voltage_support: u8, pub protocols: u32, pub default_clock: u32, pub max_clock: u32, pub num_clock_supported: u8, pub data_rate: u32, pub max_data_rate: u32, pub num_data_rates_supp: u8, pub max_ifsd: u32, pub sync_protocols: u32, pub mechanical: u32, pub features: u32, pub max_ccid_msg_len: u32, pub class_get_response: u8, pub class_envelope: u8, pub lcd_layout: (u8, u8), pub pin_support: u8, pub max_ccid_busy_slots: u8, } impl TryFrom<&[u8]> for CcidDescriptor { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 54 { return Err(Error::new_descriptor_len("CcidDescriptor", 54, value.len())); } let lcd_layout = (value[50], value[51]); Ok(CcidDescriptor { length: value[0], descriptor_type: value[1], version: Version::from_bcd(u16::from_le_bytes([value[2], value[3]])), max_slot_index: value[4], voltage_support: value[5], protocols: u32::from_le_bytes([value[6], value[7], value[8], value[9]]), default_clock: u32::from_le_bytes([value[10], value[11], value[12], value[13]]), max_clock: u32::from_le_bytes([value[14], value[15], value[16], value[17]]), num_clock_supported: value[18], data_rate: u32::from_le_bytes([value[19], value[20], value[21], value[22]]), max_data_rate: u32::from_le_bytes([value[23], value[24], value[25], value[26]]), num_data_rates_supp: value[27], max_ifsd: u32::from_le_bytes([value[28], value[29], value[30], value[31]]), sync_protocols: u32::from_le_bytes([value[32], value[33], value[34], value[35]]), mechanical: u32::from_le_bytes([value[36], value[37], value[38], value[39]]), features: u32::from_le_bytes([value[40], value[41], value[42], value[43]]), max_ccid_msg_len: u32::from_le_bytes([value[44], value[45], value[46], value[47]]), class_get_response: value[48], class_envelope: value[49], lcd_layout, pin_support: value[52], max_ccid_busy_slots: value[53], }) } } impl TryFrom for CcidDescriptor { type Error = Error; fn try_from(gd: GenericDescriptor) -> error::Result { let gd_vec: Vec = gd.into(); CcidDescriptor::try_from(&gd_vec[..]) } } impl From for Vec { fn from(cd: CcidDescriptor) -> Self { let mut ret = Vec::new(); ret.push(cd.length); ret.push(cd.descriptor_type); ret.extend(u16::from(cd.version).to_le_bytes()); ret.push(cd.max_slot_index); ret.push(cd.voltage_support); ret.extend(cd.protocols.to_le_bytes()); ret.extend(cd.default_clock.to_le_bytes()); ret.extend(cd.max_clock.to_le_bytes()); ret.push(cd.num_clock_supported); ret.extend(cd.data_rate.to_le_bytes()); ret.extend(cd.max_data_rate.to_le_bytes()); ret.push(cd.num_data_rates_supp); ret.extend(cd.max_ifsd.to_le_bytes()); ret.extend(cd.sync_protocols.to_le_bytes()); ret.extend(cd.mechanical.to_le_bytes()); ret.extend(cd.features.to_le_bytes()); ret.extend(cd.max_ccid_msg_len.to_le_bytes()); ret.push(cd.class_get_response); ret.push(cd.class_envelope); ret.push(cd.lcd_layout.0); ret.push(cd.lcd_layout.1); ret.push(cd.pin_support); ret.push(cd.max_ccid_busy_slots); ret } } /// USB printer descriptor #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct PrinterDescriptor { pub length: u8, pub descriptor_type: u8, pub release_number: u8, pub descriptors: Vec, } impl TryFrom<&[u8]> for PrinterDescriptor { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 5 { return Err(Error::new_descriptor_len( "PrinterDescriptor", 5, value.len(), )); } let num_descriptors = value[3] as usize; let mut descriptors_vec = value[4..].to_vec(); let mut descriptors = Vec::::with_capacity(num_descriptors); for _ in 0..num_descriptors { if descriptors_vec.len() < 2 { return Err(Error::new_descriptor_len( "PrinterReportDescriptor", 2, descriptors_vec.len(), )); } // +2 for length and descriptor type let len = descriptors_vec[1] as usize + 2; if descriptors_vec.len() < len { break; } descriptors.push(descriptors_vec.drain(..len).as_slice().try_into()?); } Ok(PrinterDescriptor { length: value[0], descriptor_type: value[1], release_number: value[2], descriptors, }) } } impl TryFrom for PrinterDescriptor { type Error = Error; fn try_from(gd: GenericDescriptor) -> error::Result { let gd_vec: Vec = gd.into(); PrinterDescriptor::try_from(&gd_vec[..]) } } impl From for Vec { fn from(pd: PrinterDescriptor) -> Self { let mut ret = Vec::new(); ret.push(pd.length); ret.push(pd.descriptor_type); ret.push(pd.release_number); for desc in pd.descriptors { ret.extend(Vec::::from(desc)); } ret } } /// USB printer report descriptor #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct PrinterReportDescriptor { pub length: u8, pub descriptor_type: u8, pub capabilities: u16, pub versions_supported: u8, pub uuid_string_index: u8, pub uuid_string: Option, pub data: Option>, } impl TryFrom<&[u8]> for PrinterReportDescriptor { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 6 { return Err(Error::new_descriptor_len( "PrinterReportDescriptor", 6, value.len(), )); } Ok(PrinterReportDescriptor { length: value[0], descriptor_type: value[1], capabilities: u16::from_le_bytes([value[2], value[3]]), versions_supported: value[4], uuid_string_index: value[5], uuid_string: None, data: value.get(6..).map(|d| d.to_vec()), }) } } impl From for Vec { fn from(prd: PrinterReportDescriptor) -> Self { let mut ret = Vec::new(); ret.push(prd.descriptor_type); ret.push(prd.length); ret.extend(prd.capabilities.to_le_bytes()); ret.push(prd.versions_supported); ret.push(prd.uuid_string_index); ret } } #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct HubDescriptor { pub length: u8, pub descriptor_type: u8, pub num_ports: u8, pub characteristics: u16, pub power_on_to_power_good: u8, pub control_current: u8, pub data: Vec, pub port_statuses: Option>, } impl TryFrom<&[u8]> for HubDescriptor { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 9 { return Err(Error::new_descriptor_len("HubDescriptor", 9, value.len())); } Ok(HubDescriptor { length: value[0], descriptor_type: value[1], num_ports: value[2], characteristics: u16::from_le_bytes([value[3], value[4]]), power_on_to_power_good: value[5], control_current: value[6], data: value[7..].to_vec(), port_statuses: None, }) } } impl From for Vec { fn from(hd: HubDescriptor) -> Self { let mut ret = Vec::new(); ret.push(hd.length); ret.push(hd.descriptor_type); ret.push(hd.num_ports); ret.extend(hd.characteristics.to_le_bytes()); ret.push(hd.power_on_to_power_good); ret.push(hd.control_current); ret.extend(hd.data); ret } } impl HubDescriptor { /// Type 3 devices have a delay field, which is a combination of latency in nano seconds pub fn delay(&self) -> Option { match (self.latency(), self.data.get(1)) { (Some(l), Some(d)) => Some((*d as u16) << (4 + l)), _ => None, } } /// Type 3 devices have a latency field pub fn latency(&self) -> Option { self.data.first().copied() } } #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct DfuDescriptor { pub length: u8, pub descriptor_type: u8, pub attributes: u8, pub detach_timeout: u16, pub transfer_size: u16, // not all have version pub dfu_version: Option, } impl TryFrom<&[u8]> for DfuDescriptor { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 7 { return Err(Error::new_descriptor_len("DfuDescriptor", 7, value.len())); } let dfu_version = if value.len() >= 9 { Some(Version::from_bcd(u16::from_le_bytes([value[7], value[8]]))) } else { None }; Ok(DfuDescriptor { length: value[0], descriptor_type: value[1], attributes: value[2], detach_timeout: u16::from_le_bytes([value[3], value[4]]), transfer_size: u16::from_le_bytes([value[5], value[6]]), dfu_version, }) } } impl From for Vec { fn from(dd: DfuDescriptor) -> Self { let mut ret = Vec::new(); ret.push(dd.length); ret.push(dd.descriptor_type); ret.push(dd.attributes); ret.extend(dd.detach_timeout.to_le_bytes()); ret.extend(dd.transfer_size.to_le_bytes()); if let Some(v) = dd.dfu_version { ret.extend(u16::from(v).to_le_bytes()); } ret } } impl TryFrom for DfuDescriptor { type Error = Error; fn try_from(gd: GenericDescriptor) -> error::Result { let gd_vec: Vec = gd.into(); DfuDescriptor::try_from(&gd_vec[..]) } } #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct DebugDescriptor { pub length: u8, pub descriptor_type: u8, pub debug_in_endpoint: u8, pub debug_out_endpoint: u8, } impl TryFrom<&[u8]> for DebugDescriptor { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 4 { return Err(Error::new_descriptor_len("DebugDescriptor", 4, value.len())); } if value[1] != 0x0a { return Err(Error::new( ErrorKind::InvalidArg, "Debug descriptor must have descriptor type 0x0a", )); } Ok(DebugDescriptor { length: value[0], descriptor_type: value[1], debug_in_endpoint: value[2], debug_out_endpoint: value[3], }) } } impl From for Vec { fn from(dd: DebugDescriptor) -> Self { vec![ dd.length, dd.descriptor_type, dd.debug_in_endpoint, dd.debug_out_endpoint, ] } } #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct DeviceQualifierDescriptor { pub length: u8, pub descriptor_type: u8, pub version: Version, pub device_class: BaseClass, pub device_subclass: u8, pub device_protocol: u8, pub max_packet_size: u8, pub num_configurations: u8, } impl TryFrom<&[u8]> for DeviceQualifierDescriptor { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 9 { return Err(Error::new_descriptor_len( "DeviceQualifierDescriptor", 9, value.len(), )); } if value[1] != 0x06 { return Err(Error::new( ErrorKind::InvalidArg, "Device Qualifier descriptor must have descriptor type 0x06", )); } Ok(DeviceQualifierDescriptor { length: value[0], descriptor_type: value[1], version: Version::from_bcd(u16::from_le_bytes([value[2], value[3]])), device_class: BaseClass::from(value[4]), device_subclass: value[5], device_protocol: value[6], max_packet_size: value[7], num_configurations: value[8], }) } } impl From for Vec { fn from(dqd: DeviceQualifierDescriptor) -> Self { let mut ret = Vec::new(); ret.push(dqd.length); ret.push(dqd.descriptor_type); ret.extend(u16::from(dqd.version).to_le_bytes()); ret.push(dqd.device_class.into()); ret.push(dqd.device_subclass); ret.push(dqd.device_protocol); ret.push(dqd.max_packet_size); ret.push(dqd.num_configurations); ret } } #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct OnTheGoDescriptor { pub length: u8, pub descriptor_type: u8, pub attributes: u8, } impl TryFrom<&[u8]> for OnTheGoDescriptor { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() != 3 { return Err(Error::new_descriptor_len( "OnTheGoDescriptor", 3, value.len(), )); } if value[1] != 0x09 { return Err(Error::new( ErrorKind::InvalidArg, "On-The-Go descriptor must have descriptor type 0x09", )); } Ok(OnTheGoDescriptor { length: value[0], descriptor_type: value[1], attributes: value[2], }) } } impl From for Vec { fn from(otg: OnTheGoDescriptor) -> Self { vec![otg.length, otg.descriptor_type, otg.attributes] } } cyme-2.2.6/src/usb/descriptors/000077500000000000000000000000001506545537300164145ustar00rootroot00000000000000cyme-2.2.6/src/usb/descriptors/audio.rs000066400000000000000000004727011506545537300200760ustar00rootroot00000000000000//! Defines for the USB Audio Class (UAC) interface descriptors and MIDI use serde::{Deserialize, Serialize}; use std::convert::TryFrom; use std::fmt; use strum::VariantArray; use strum_macros::VariantArray; use super::*; use crate::error::{self, Error, ErrorKind}; /// bSubtype for MIDI interface descriptors #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] #[repr(u8)] #[non_exhaustive] #[serde(rename_all = "kebab-case")] pub enum MidiSubtype { Undefined = 0x00, Header = 0x01, InputJack = 0x02, OutputJack = 0x03, Element = 0x04, } impl fmt::Display for MidiSubtype { fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result { // lsusb style if f.alternate() { match self { MidiSubtype::Undefined => write!(f, "Invalid"), MidiSubtype::InputJack => write!(f, "MIDI_IN_JACK"), MidiSubtype::OutputJack => write!(f, "MIDI_OUT_JACK"), _ => write!(f, "{}", heck::AsShoutySnakeCase(format!("{self:?}"))), } } else { write!(f, "{self:?}") } } } impl From for MidiSubtype { fn from(b: u8) -> Self { match b { 0x00 => MidiSubtype::Undefined, 0x01 => MidiSubtype::Header, 0x02 => MidiSubtype::InputJack, 0x03 => MidiSubtype::OutputJack, 0x04 => MidiSubtype::Element, _ => MidiSubtype::Undefined, } } } impl From for u8 { fn from(b: MidiSubtype) -> Self { b as u8 } } impl MidiSubtype { /// Get the [`MidiInterfaceDescriptor`] from the descriptor data for this subtype pub fn get_interface_descriptor(&self, data: &[u8]) -> Result { MidiInterfaceDescriptor::from_midi_interface(self, data) } } #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct MidiDescriptor { pub length: u8, pub descriptor_type: u8, pub descriptor_subtype: MidiSubtype, pub interface: MidiInterfaceDescriptor, } impl TryFrom<&[u8]> for MidiDescriptor { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 4 { return Err(Error::new_descriptor_len("MidiDescriptor", 4, value.len())); } let length = value[0]; if length as usize > value.len() { return Err(Error::new_descriptor_len( "MidiDescriptor reported", length as usize, value.len(), )); } let descriptor_type = DescriptorType::from(value[1]); let descriptor_subtype = MidiSubtype::from(value[2]); let interface = MidiInterfaceDescriptor::from_midi_descriptor( &descriptor_type, &descriptor_subtype, &value[3..], ) .unwrap_or_else(|_| { log::warn!( "Failed to parse MIDI interface descriptor for {:?} {:?}: {:?}", descriptor_type, descriptor_subtype, &value[3..] ); MidiInterfaceDescriptor::Invalid(value[3..].to_vec()) }); Ok(MidiDescriptor { length, descriptor_type: value[1], descriptor_subtype, interface, }) } } impl From for Vec { fn from(md: MidiDescriptor) -> Self { let mut ret = Vec::new(); ret.push(md.length); ret.push(md.descriptor_type); ret.push(md.descriptor_subtype as u8); let data: Vec = md.interface.into(); ret.extend(&data); ret } } impl TryFrom for MidiDescriptor { type Error = Error; fn try_from(gd: GenericDescriptor) -> error::Result { let gd_vec: Vec = gd.into(); MidiDescriptor::try_from(&gd_vec[..]) } } impl TryFrom for GenericDescriptor { type Error = Error; fn try_from(md: MidiDescriptor) -> error::Result { let data: Vec = md.into(); GenericDescriptor::try_from(data.as_slice()) } } #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct Header { pub version: Version, pub total_length: u16, } impl TryFrom<&[u8]> for Header { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 4 { return Err(Error::new_descriptor_len("Header", 4, value.len())); } Ok(Header { version: Version::from_bcd(u16::from_le_bytes([value[0], value[1]])), total_length: u16::from_le_bytes([value[2], value[3]]), }) } } impl From

for Vec { fn from(h: Header) -> Self { let mut ret = Vec::new(); ret.extend_from_slice(&(u16::from(h.version)).to_le_bytes()); ret.extend_from_slice(&h.total_length.to_le_bytes()); ret } } #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct InputJack { pub jack_type: u8, pub jack_id: u8, pub jack_string_index: u8, pub jack_string: Option, } impl TryFrom<&[u8]> for InputJack { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 3 { return Err(Error::new_descriptor_len("InputJack", 3, value.len())); } Ok(InputJack { jack_type: value[0], jack_id: value[1], jack_string_index: value[2], jack_string: None, }) } } impl From for Vec { fn from(ij: InputJack) -> Self { vec![ij.jack_type, ij.jack_id, ij.jack_string_index] } } #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct OutputJack { pub jack_type: u8, pub jack_id: u8, pub num_input_pins: u8, pub source_ids: Vec<(u8, u8)>, pub jack_string_index: u8, pub jack_string: Option, } impl TryFrom<&[u8]> for OutputJack { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 4 { return Err(Error::new_descriptor_len("OutputJack", 4, value.len())); } let num_input_pins = value[2] as usize; // + 1 for the jack_string_index if value.len() < 3 + num_input_pins * 2 + 1 { return Err(Error::new( ErrorKind::InvalidDescriptor, "OutputJack descriptor reported number of source pins too long for buffer", )); } let mut source_ids = Vec::with_capacity(num_input_pins); for chunk in value[3..3 + num_input_pins * 2].chunks_exact(2) { source_ids.push((chunk[0], chunk[1])); } Ok(OutputJack { jack_type: value[0], jack_id: value[1], num_input_pins: value[2], source_ids, jack_string_index: value[3 + num_input_pins * 2], jack_string: None, }) } } impl From for Vec { fn from(oj: OutputJack) -> Self { let mut ret = vec![oj.jack_type, oj.jack_id, oj.num_input_pins]; for (a, b) in oj.source_ids { ret.push(a); ret.push(b); } ret.push(oj.jack_string_index); ret } } #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct Element { pub element_id: u8, pub num_input_pins: u8, pub source_ids: Vec<(u8, u8)>, pub num_output_pins: u8, pub in_terminal_link: u8, pub out_terminal_link: u8, pub el_caps_size: u8, pub element_caps: u16, pub element_string_index: u8, pub element_string: Option, } impl TryFrom<&[u8]> for Element { type Error = Error; fn try_from(value: &[u8]) -> Result { if value.len() < 8 { return Err(Error::new_descriptor_len("Element", 8, value.len())); } let element_id = value[0]; let num_input_pins = value[1] as usize; let expected_len = 6 + 2 * num_input_pins; if value.len() < expected_len { return Err(Error::new( ErrorKind::InvalidDescriptor, "Element descriptor reported number of input pins too long for buffer", )); } let mut source_ids = Vec::with_capacity(num_input_pins); for chunk in value[2..2 + num_input_pins * 2].chunks_exact(2) { source_ids.push((chunk[0], chunk[1])); } let j = 2 + num_input_pins * 2; let num_output_pins = value[j]; let in_terminal_link = value[j + 1]; let out_terminal_link = value[j + 2]; let el_caps_size = value[j + 3]; let capsize = el_caps_size as usize; if value.len() < j + 4 + capsize + 1 { return Err(Error::new( ErrorKind::InvalidDescriptor, "Element descriptor reported caps size too long for buffer", )); } let mut element_caps: u16 = 0; for i in 0..capsize { element_caps |= (value[j + 4 + i] as u16) << (i * 8); } let element_string_index = value[j + 4 + capsize]; let element_string = None; Ok(Element { element_id, num_input_pins: value[1], source_ids, num_output_pins, in_terminal_link, out_terminal_link, el_caps_size, element_caps, element_string_index, element_string, }) } } impl From for Vec { fn from(el: Element) -> Self { let mut ret = Vec::new(); ret.push(el.element_id); ret.push(el.num_input_pins); for (source_id, source_pin) in el.source_ids { ret.push(source_id); ret.push(source_pin); } ret.push(el.num_output_pins); ret.push(el.in_terminal_link); ret.push(el.out_terminal_link); ret.push(el.el_caps_size); for i in 0..el.el_caps_size { ret.push((el.element_caps >> (i * 8)) as u8); } ret.push(el.element_string_index); ret } } #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct MidiEndpointDescriptor { pub num_jacks: u8, pub jacks: Vec, } impl TryFrom<&[u8]> for MidiEndpointDescriptor { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.is_empty() { return Err(Error::new_descriptor_len("MidiEndpointDescriptor", 1, 0)); } let num_jacks = value[0] as usize; if value.len() < 1 + num_jacks { return Err(Error::new( ErrorKind::InvalidDescriptor, "MidiEndpointDescriptor descriptor reported number of jacks too long for buffer", )); } let jacks = value[1..1 + num_jacks].to_vec(); Ok(MidiEndpointDescriptor { num_jacks: value[0], jacks, }) } } impl From for Vec { fn from(md: MidiEndpointDescriptor) -> Self { let mut ret = vec![md.num_jacks]; ret.extend(md.jacks); ret } } #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] #[non_exhaustive] #[serde(rename_all = "kebab-case")] pub enum MidiInterfaceDescriptor { Header(Header), InputJack(InputJack), OutputJack(OutputJack), Element(Element), Endpoint(MidiEndpointDescriptor), Invalid(Vec), Undefined(Vec), } impl MidiInterfaceDescriptor { /// Try to parse the MIDI interface descriptor from the main descriptor data pub fn from_midi_descriptor( descriptor_type: &DescriptorType, subtype: &MidiSubtype, data: &[u8], ) -> Result { match descriptor_type { DescriptorType::Endpoint => Self::from_midi_endpoint(data), _ => subtype.get_interface_descriptor(data), } } /// Try to parse the MIDI interface descriptor for an Endpoint from the provided data pub fn from_midi_endpoint(data: &[u8]) -> Result { MidiEndpointDescriptor::try_from(data).map(MidiInterfaceDescriptor::Endpoint) } /// Try to parse the MIDI interface descriptor for an Interface from the provided data pub fn from_midi_interface(subtype: &MidiSubtype, data: &[u8]) -> Result { match subtype { MidiSubtype::Header => Header::try_from(data).map(MidiInterfaceDescriptor::Header), MidiSubtype::InputJack => { InputJack::try_from(data).map(MidiInterfaceDescriptor::InputJack) } MidiSubtype::OutputJack => { OutputJack::try_from(data).map(MidiInterfaceDescriptor::OutputJack) } MidiSubtype::Element => Element::try_from(data).map(MidiInterfaceDescriptor::Element), MidiSubtype::Undefined => Ok(MidiInterfaceDescriptor::Undefined(data.to_vec())), } } } impl From for Vec { fn from(mid: MidiInterfaceDescriptor) -> Self { match mid { MidiInterfaceDescriptor::Header(a) => a.into(), MidiInterfaceDescriptor::InputJack(a) => a.into(), MidiInterfaceDescriptor::OutputJack(a) => a.into(), MidiInterfaceDescriptor::Element(a) => a.into(), MidiInterfaceDescriptor::Endpoint(a) => a.into(), MidiInterfaceDescriptor::Invalid(a) => a, MidiInterfaceDescriptor::Undefined(a) => a, } } } impl TryFrom for MidiEndpointDescriptor { type Error = Error; fn try_from(gd: GenericDescriptor) -> error::Result { let gd_vec: Vec = gd.into(); MidiEndpointDescriptor::try_from(gd_vec.as_slice()) } } /// Base USB Audio Class (UAC) interface descriptor that contains [`UacType`] and [`UacInterfaceDescriptor`] #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct UacDescriptor { pub length: u8, pub descriptor_type: u8, pub descriptor_subtype: UacType, pub interface: UacInterfaceDescriptor, } /// Try from ([`GenericDescriptor`], SubClass, Protocol) impl TryFrom<(GenericDescriptor, u8, u8)> for UacDescriptor { type Error = Error; fn try_from((gd, subc, p): (GenericDescriptor, u8, u8)) -> error::Result { let length = gd.length; let descriptor_type = gd.descriptor_type; let descriptor_subtype: UacType = (subc, gd.descriptor_subtype, p).try_into()?; let interface = descriptor_subtype.uac_descriptor_from_generic(gd, p)?; Ok(UacDescriptor { length, descriptor_type, descriptor_subtype, interface, }) } } impl From for Vec { fn from(acd: UacDescriptor) -> Self { let mut ret: Vec = Vec::new(); ret.push(acd.length); ret.push(acd.descriptor_type); ret.push(u8::from(acd.descriptor_subtype)); let data: Vec = acd.interface.into(); ret.extend(&data); ret } } impl TryFrom for GenericDescriptor { type Error = Error; fn try_from(ud: UacDescriptor) -> error::Result { let data: Vec = ud.into(); GenericDescriptor::try_from(data.as_slice()) } } impl UacDescriptor { /// Get the [`UacProtocol`] for the attached UAC interface pub fn get_protocol(&self) -> UacProtocol { self.interface.get_protocol() } } /// USB Audio Class (UAC) interface descriptors /// /// Ported from /// /// Possibly much nicer way to define all these for more generic printing; enum types like desc-def.c wrapping the int values so they can be acted on in a more generic way #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[non_exhaustive] #[allow(missing_docs)] #[serde(rename_all = "kebab-case")] pub enum UacInterfaceDescriptor { // Audio Controls bSubClass Header1(Header1), Header2(Header2), Header3(Header3), InputTerminal1(InputTerminal1), InputTerminal2(InputTerminal2), InputTerminal3(InputTerminal3), OutputTerminal1(OutputTerminal1), OutputTerminal2(OutputTerminal2), OutputTerminal3(OutputTerminal3), ExtendedTerminalHeader(ExtendedTerminalHeader), PowerDomain(PowerDomain), MixerUnit1(MixerUnit1), MixerUnit2(MixerUnit2), MixerUnit3(MixerUnit3), SelectorUnit1(SelectorUnit1), SelectorUnit2(SelectorUnit2), SelectorUnit3(SelectorUnit3), ProcessingUnit1(ProcessingUnit1), ProcessingUnit2(ProcessingUnit2), ProcessingUnit3(ProcessingUnit3), EffectUnit2(EffectUnit2), EffectUnit3(EffectUnit3), FeatureUnit1(FeatureUnit1), FeatureUnit2(FeatureUnit2), FeatureUnit3(FeatureUnit3), ExtensionUnit1(ExtensionUnit1), ExtensionUnit2(ExtensionUnit2), ExtensionUnit3(ExtensionUnit3), ClockSource2(ClockSource2), ClockSource3(ClockSource3), ClockSelector2(ClockSelector2), ClockSelector3(ClockSelector3), ClockMultiplier2(ClockMultiplier2), ClockMultiplier3(ClockMultiplier3), SampleRateConverter2(SampleRateConverter2), SampleRateConverter3(SampleRateConverter3), // Audio Streaming bSubClass StreamingInterface1(StreamingInterface1), StreamingInterface2(StreamingInterface2), StreamingInterface3(StreamingInterface3), StreamingFormat(StreamingFormat), StreamingFormatSpecific(StreamingFormatSpecific), // Isochronous Audio Data Stream Endpoint DataStreamingEndpoint1(DataStreamingEndpoint1), DatastreamingEndpoint2(DataStreamingEndpoint2), DataStreamingEndpoint3(DataStreamingEndpoint3), /// Invalid descriptor for failing to parse matched Invalid(Vec), /// Generic descriptor for known but unsupported descriptors Generic(Vec), /// Undefined descriptor Undefined(Vec), } impl From for Vec { fn from(val: UacInterfaceDescriptor) -> Self { match val { UacInterfaceDescriptor::Header1(a) => a.into(), UacInterfaceDescriptor::Header2(a) => a.into(), UacInterfaceDescriptor::Header3(a) => a.into(), UacInterfaceDescriptor::InputTerminal1(a) => a.into(), UacInterfaceDescriptor::InputTerminal2(a) => a.into(), UacInterfaceDescriptor::InputTerminal3(a) => a.into(), UacInterfaceDescriptor::OutputTerminal1(a) => a.into(), UacInterfaceDescriptor::OutputTerminal2(a) => a.into(), UacInterfaceDescriptor::OutputTerminal3(a) => a.into(), UacInterfaceDescriptor::ExtendedTerminalHeader(a) => a.into(), UacInterfaceDescriptor::PowerDomain(a) => a.into(), UacInterfaceDescriptor::MixerUnit1(a) => a.into(), UacInterfaceDescriptor::MixerUnit2(a) => a.into(), UacInterfaceDescriptor::MixerUnit3(a) => a.into(), UacInterfaceDescriptor::SelectorUnit1(a) => a.into(), UacInterfaceDescriptor::SelectorUnit2(a) => a.into(), UacInterfaceDescriptor::SelectorUnit3(a) => a.into(), UacInterfaceDescriptor::ProcessingUnit1(a) => a.into(), UacInterfaceDescriptor::ProcessingUnit2(a) => a.into(), UacInterfaceDescriptor::ProcessingUnit3(a) => a.into(), UacInterfaceDescriptor::EffectUnit2(a) => a.into(), UacInterfaceDescriptor::EffectUnit3(a) => a.into(), UacInterfaceDescriptor::FeatureUnit1(a) => a.into(), UacInterfaceDescriptor::FeatureUnit2(a) => a.into(), UacInterfaceDescriptor::FeatureUnit3(a) => a.into(), UacInterfaceDescriptor::ExtensionUnit1(a) => a.into(), UacInterfaceDescriptor::ExtensionUnit2(a) => a.into(), UacInterfaceDescriptor::ExtensionUnit3(a) => a.into(), UacInterfaceDescriptor::ClockSource2(a) => a.into(), UacInterfaceDescriptor::ClockSource3(a) => a.into(), UacInterfaceDescriptor::ClockSelector2(a) => a.into(), UacInterfaceDescriptor::ClockSelector3(a) => a.into(), UacInterfaceDescriptor::ClockMultiplier2(a) => a.into(), UacInterfaceDescriptor::ClockMultiplier3(a) => a.into(), UacInterfaceDescriptor::SampleRateConverter2(a) => a.into(), UacInterfaceDescriptor::SampleRateConverter3(a) => a.into(), UacInterfaceDescriptor::StreamingInterface1(a) => a.into(), UacInterfaceDescriptor::StreamingInterface2(a) => a.into(), UacInterfaceDescriptor::StreamingInterface3(a) => a.into(), UacInterfaceDescriptor::StreamingFormat(a) => a.into(), UacInterfaceDescriptor::StreamingFormatSpecific(a) => a.into(), UacInterfaceDescriptor::DataStreamingEndpoint1(a) => a.into(), UacInterfaceDescriptor::DatastreamingEndpoint2(a) => a.into(), UacInterfaceDescriptor::DataStreamingEndpoint3(a) => a.into(), UacInterfaceDescriptor::Invalid(a) => a, UacInterfaceDescriptor::Generic(a) => a, UacInterfaceDescriptor::Undefined(a) => a, } } } /// USB Audio Class (UAC) protocol 1 channel names based on the "wChannelConfig" field /// /// Decoded as bitstring; each bit corresponds to a channel name #[derive(Debug, Clone, Copy, Hash, PartialEq, Eq, Serialize, Deserialize, VariantArray)] #[allow(missing_docs)] #[serde(rename_all = "kebab-case")] pub enum Uac1ChannelNames { LeftFront, RightFront, CenterFront, LowFrequencyEnhancement, LeftSurround, RightSurround, LeftOfCenter, RightOfCenter, Surround, SideLeft, SideRight, Top, } impl fmt::Display for Uac1ChannelNames { fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result { match self { Uac1ChannelNames::LeftFront => write!(f, "Left Front (L)"), Uac1ChannelNames::RightFront => write!(f, "Right Front (R)"), Uac1ChannelNames::CenterFront => write!(f, "Center Front (C)"), Uac1ChannelNames::LowFrequencyEnhancement => { write!(f, "Low Frequency Enhancement (LFE)") } Uac1ChannelNames::LeftSurround => write!(f, "Left Surround (LS)"), Uac1ChannelNames::RightSurround => write!(f, "Right Surround (RS)"), Uac1ChannelNames::LeftOfCenter => write!(f, "Left of Center (LC)"), Uac1ChannelNames::RightOfCenter => write!(f, "Right of Center (RC)"), Uac1ChannelNames::Surround => write!(f, "Surround (S)"), Uac1ChannelNames::SideLeft => write!(f, "Side Left (SL)"), Uac1ChannelNames::SideRight => write!(f, "Side Right (SR)"), Uac1ChannelNames::Top => write!(f, "Top (T)"), } } } impl Uac1ChannelNames { /// Get the supported [`Uac1ChannelNames`] from the bitmap value pub fn from_bitmap>(bitmap: T) -> Vec { let mut ret = Vec::new(); let bitmap = bitmap.into(); for (i, s) in Uac1ChannelNames::VARIANTS.iter().enumerate() { if bitmap & (1 << i) != 0 { ret.push(*s); } } ret } } /// USB Audio Class (UAC) protocol 2 supported channel names based on the "wChannelConfig" bitmap #[derive(Debug, Clone, Copy, Hash, PartialEq, Eq, Serialize, Deserialize, VariantArray)] #[allow(missing_docs)] #[serde(rename_all = "kebab-case")] pub enum Uac2ChannelNames { FrontLeft, FrontRight, FrontCenter, LowFrequencyEffects, BackLeft, BackRight, FrontLeftOfCenter, FrontRightOfCenter, BackCenter, SideLeft, SideRight, TopCenter, TopFrontLeft, TopFrontCenter, TopFrontRight, TopBackLeft, TopBackCenter, TopBackRight, TopFrontLeftOfCenter, TopFrontRightOfCenter, LeftLowFrequencyEffects, RightLowFrequencyEffects, TopSideLeft, TopSideRight, BottomCenter, BackLeftOfCenter, BackRightOfCenter, } impl fmt::Display for Uac2ChannelNames { fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result { match self { Uac2ChannelNames::FrontLeft => write!(f, "Front Left (FL)"), Uac2ChannelNames::FrontRight => write!(f, "Front Right (FR)"), Uac2ChannelNames::FrontCenter => write!(f, "Front Center (FC)"), Uac2ChannelNames::LowFrequencyEffects => write!(f, "Low Frequency Effects (LFE)"), Uac2ChannelNames::BackLeft => write!(f, "Back Left (BL)"), Uac2ChannelNames::BackRight => write!(f, "Back Right (BR)"), Uac2ChannelNames::FrontLeftOfCenter => write!(f, "Front Left of Center (FLC)"), Uac2ChannelNames::FrontRightOfCenter => write!(f, "Front Right of Center (FRC)"), Uac2ChannelNames::BackCenter => write!(f, "Back Center (BC)"), Uac2ChannelNames::SideLeft => write!(f, "Side Left (SL)"), Uac2ChannelNames::SideRight => write!(f, "Side Right (SR)"), Uac2ChannelNames::TopCenter => write!(f, "Top Center (TC)"), Uac2ChannelNames::TopFrontLeft => write!(f, "Top Front Left (TFL)"), Uac2ChannelNames::TopFrontCenter => write!(f, "Top Front Center (TFC)"), Uac2ChannelNames::TopFrontRight => write!(f, "Top Front Right (TFR)"), Uac2ChannelNames::TopBackLeft => write!(f, "Top Back Left (TBL)"), Uac2ChannelNames::TopBackCenter => write!(f, "Top Back Center (TBC)"), Uac2ChannelNames::TopBackRight => write!(f, "Top Back Right (TBR)"), Uac2ChannelNames::TopFrontLeftOfCenter => write!(f, "Top Front Left of Center (TFLC)"), Uac2ChannelNames::TopFrontRightOfCenter => { write!(f, "Top Front Right of Center (TFRC)") } Uac2ChannelNames::LeftLowFrequencyEffects => { write!(f, "Left Low Frequency Effects (LLFE)") } Uac2ChannelNames::RightLowFrequencyEffects => { write!(f, "Right Low Frequency Effects (RLFE)") } Uac2ChannelNames::TopSideLeft => write!(f, "Top Side Left (TSL)"), Uac2ChannelNames::TopSideRight => write!(f, "Top Side Right (TSR)"), Uac2ChannelNames::BottomCenter => write!(f, "Bottom Center (BC)"), Uac2ChannelNames::BackLeftOfCenter => write!(f, "Back Left of Center (BLC)"), Uac2ChannelNames::BackRightOfCenter => write!(f, "Back Right of Center (BRC)"), } } } impl Uac2ChannelNames { /// Get the supported [`Uac2ChannelNames`] from the bitmap value pub fn from_bitmap>(bitmap: T) -> Vec { let mut ret = Vec::new(); let bitmap = bitmap.into(); for (i, s) in Uac2ChannelNames::VARIANTS.iter().enumerate() { if bitmap & (1 << i) != 0 { ret.push(*s); } } ret } } /// USB Audio Class (UAC) channel names based on the "wChannelConfig" field #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] #[serde(rename_all = "kebab-case")] pub enum ChannelNames { /// UAC1 channel names Uac1(Uac1ChannelNames), /// UAC2 channel names Uac2(Uac2ChannelNames), } impl fmt::Display for ChannelNames { fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result { match self { ChannelNames::Uac1(c) => write!(f, "{c}"), ChannelNames::Uac2(c) => write!(f, "{c}"), } } } impl ChannelNames { /// Get the supported [`ChannelNames`] from the bitmap value pub fn from_bitmap>(protocol: &UacProtocol, bitmap: T) -> Vec { match protocol { UacProtocol::Uac1 => Uac1ChannelNames::from_bitmap(bitmap) .iter() .map(|c| ChannelNames::Uac1(*c)) .collect(), UacProtocol::Uac2 => Uac2ChannelNames::from_bitmap(bitmap) .iter() .map(|c| ChannelNames::Uac2(*c)) .collect(), _ => Vec::new(), } } } impl UacInterfaceDescriptor { /// Get the UAC AC interface descriptor from the UAC AC interface pub fn from_uac_ac_interface( uac_interface: &ControlSubtype, protocol: &UacProtocol, data: &[u8], ) -> Result { match uac_interface { ControlSubtype::Header => match protocol { UacProtocol::Uac1 => Header1::try_from(data).map(UacInterfaceDescriptor::Header1), UacProtocol::Uac2 => Header2::try_from(data).map(UacInterfaceDescriptor::Header2), UacProtocol::Uac3 => Header3::try_from(data).map(UacInterfaceDescriptor::Header3), _ => Ok(UacInterfaceDescriptor::Invalid(data.to_vec())), }, ControlSubtype::InputTerminal => match protocol { UacProtocol::Uac1 => { InputTerminal1::try_from(data).map(UacInterfaceDescriptor::InputTerminal1) } UacProtocol::Uac2 => { InputTerminal2::try_from(data).map(UacInterfaceDescriptor::InputTerminal2) } UacProtocol::Uac3 => { InputTerminal3::try_from(data).map(UacInterfaceDescriptor::InputTerminal3) } _ => Ok(UacInterfaceDescriptor::Invalid(data.to_vec())), }, ControlSubtype::OutputTerminal => match protocol { UacProtocol::Uac1 => { OutputTerminal1::try_from(data).map(UacInterfaceDescriptor::OutputTerminal1) } UacProtocol::Uac2 => { OutputTerminal2::try_from(data).map(UacInterfaceDescriptor::OutputTerminal2) } UacProtocol::Uac3 => { OutputTerminal3::try_from(data).map(UacInterfaceDescriptor::OutputTerminal3) } _ => Ok(UacInterfaceDescriptor::Invalid(data.to_vec())), }, ControlSubtype::ExtendedTerminal => match protocol { UacProtocol::Uac3 => ExtendedTerminalHeader::try_from(data) .map(UacInterfaceDescriptor::ExtendedTerminalHeader), _ => Ok(UacInterfaceDescriptor::Invalid(data.to_vec())), }, ControlSubtype::PowerDomain => match protocol { UacProtocol::Uac3 => { PowerDomain::try_from(data).map(UacInterfaceDescriptor::PowerDomain) } _ => Ok(UacInterfaceDescriptor::Invalid(data.to_vec())), }, ControlSubtype::MixerUnit => match protocol { UacProtocol::Uac1 => { MixerUnit1::try_from(data).map(UacInterfaceDescriptor::MixerUnit1) } UacProtocol::Uac2 => { MixerUnit2::try_from(data).map(UacInterfaceDescriptor::MixerUnit2) } UacProtocol::Uac3 => { MixerUnit3::try_from(data).map(UacInterfaceDescriptor::MixerUnit3) } _ => Ok(UacInterfaceDescriptor::Invalid(data.to_vec())), }, ControlSubtype::SelectorUnit => match protocol { UacProtocol::Uac1 => { SelectorUnit1::try_from(data).map(UacInterfaceDescriptor::SelectorUnit1) } UacProtocol::Uac2 => { SelectorUnit2::try_from(data).map(UacInterfaceDescriptor::SelectorUnit2) } UacProtocol::Uac3 => { SelectorUnit3::try_from(data).map(UacInterfaceDescriptor::SelectorUnit3) } _ => Ok(UacInterfaceDescriptor::Invalid(data.to_vec())), }, ControlSubtype::ProcessingUnit => match protocol { UacProtocol::Uac1 => { ProcessingUnit1::try_from(data).map(UacInterfaceDescriptor::ProcessingUnit1) } UacProtocol::Uac2 => { ProcessingUnit2::try_from(data).map(UacInterfaceDescriptor::ProcessingUnit2) } UacProtocol::Uac3 => { ProcessingUnit3::try_from(data).map(UacInterfaceDescriptor::ProcessingUnit3) } _ => Ok(UacInterfaceDescriptor::Invalid(data.to_vec())), }, ControlSubtype::EffectUnit => match protocol { UacProtocol::Uac2 => { EffectUnit2::try_from(data).map(UacInterfaceDescriptor::EffectUnit2) } UacProtocol::Uac3 => { EffectUnit3::try_from(data).map(UacInterfaceDescriptor::EffectUnit3) } _ => Ok(UacInterfaceDescriptor::Invalid(data.to_vec())), }, ControlSubtype::FeatureUnit => match protocol { UacProtocol::Uac1 => { FeatureUnit1::try_from(data).map(UacInterfaceDescriptor::FeatureUnit1) } UacProtocol::Uac2 => { FeatureUnit2::try_from(data).map(UacInterfaceDescriptor::FeatureUnit2) } UacProtocol::Uac3 => { FeatureUnit3::try_from(data).map(UacInterfaceDescriptor::FeatureUnit3) } _ => Ok(UacInterfaceDescriptor::Invalid(data.to_vec())), }, ControlSubtype::ExtensionUnit => match protocol { UacProtocol::Uac1 => { ExtensionUnit1::try_from(data).map(UacInterfaceDescriptor::ExtensionUnit1) } UacProtocol::Uac2 => { ExtensionUnit2::try_from(data).map(UacInterfaceDescriptor::ExtensionUnit2) } UacProtocol::Uac3 => { ExtensionUnit3::try_from(data).map(UacInterfaceDescriptor::ExtensionUnit3) } _ => Ok(UacInterfaceDescriptor::Invalid(data.to_vec())), }, ControlSubtype::ClockSource => match protocol { UacProtocol::Uac2 => { ClockSource2::try_from(data).map(UacInterfaceDescriptor::ClockSource2) } UacProtocol::Uac3 => { ClockSource3::try_from(data).map(UacInterfaceDescriptor::ClockSource3) } _ => Ok(UacInterfaceDescriptor::Invalid(data.to_vec())), }, ControlSubtype::ClockSelector => match protocol { UacProtocol::Uac2 => { ClockSelector2::try_from(data).map(UacInterfaceDescriptor::ClockSelector2) } UacProtocol::Uac3 => { ClockSelector3::try_from(data).map(UacInterfaceDescriptor::ClockSelector3) } _ => Ok(UacInterfaceDescriptor::Invalid(data.to_vec())), }, ControlSubtype::ClockMultiplier => { match protocol { UacProtocol::Uac2 => ClockMultiplier2::try_from(data) .map(UacInterfaceDescriptor::ClockMultiplier2), UacProtocol::Uac3 => ClockMultiplier3::try_from(data) .map(UacInterfaceDescriptor::ClockMultiplier3), _ => Ok(UacInterfaceDescriptor::Invalid(data.to_vec())), } } ControlSubtype::SampleRateConverter => match protocol { UacProtocol::Uac2 => SampleRateConverter2::try_from(data) .map(UacInterfaceDescriptor::SampleRateConverter2), UacProtocol::Uac3 => SampleRateConverter3::try_from(data) .map(UacInterfaceDescriptor::SampleRateConverter3), _ => Ok(UacInterfaceDescriptor::Invalid(data.to_vec())), }, ControlSubtype::Undefined => Ok(UacInterfaceDescriptor::Undefined(data.to_vec())), _ => Ok(UacInterfaceDescriptor::Generic(data.to_vec())), } } /// Get the UAC AS interface descriptor from the UAC AS interface pub fn from_uac_as_interface( uac_interface: &StreamingSubtype, protocol: &UacProtocol, data: &[u8], ) -> Result { match uac_interface { // Can be DataStreamingEndpoint or StreamingInterface so check the length // since we have no Class context here StreamingSubtype::General => match protocol { UacProtocol::Uac1 => { if data.len() == DataStreamingEndpoint1::size() { DataStreamingEndpoint1::try_from(data) .map(UacInterfaceDescriptor::DataStreamingEndpoint1) } else { StreamingInterface1::try_from(data) .map(UacInterfaceDescriptor::StreamingInterface1) } } UacProtocol::Uac2 => { if data.len() == DataStreamingEndpoint2::size() { DataStreamingEndpoint2::try_from(data) .map(UacInterfaceDescriptor::DatastreamingEndpoint2) } else { StreamingInterface2::try_from(data) .map(UacInterfaceDescriptor::StreamingInterface2) } } UacProtocol::Uac3 => { if data.len() == DataStreamingEndpoint3::size() { DataStreamingEndpoint3::try_from(data) .map(UacInterfaceDescriptor::DataStreamingEndpoint3) } else { StreamingInterface3::try_from(data) .map(UacInterfaceDescriptor::StreamingInterface3) } } _ => Ok(UacInterfaceDescriptor::Invalid(data.to_vec())), }, StreamingSubtype::FormatType => StreamingFormat::from_uac_as_interface(protocol, data) .map(UacInterfaceDescriptor::StreamingFormat), StreamingSubtype::FormatSpecific => { StreamingFormatSpecific::from_uac_as_interface(protocol, data) .map(UacInterfaceDescriptor::StreamingFormatSpecific) } StreamingSubtype::Undefined => Ok(UacInterfaceDescriptor::Undefined(data.to_vec())), //_ => Ok(UacInterfaceDescriptor::Generic(data.to_vec())), } } /// Get the UAC Audio Data Endpoint descriptor from the UAC AS interface pub fn from_uac_as_iso_data_endpoint( protocol: &UacProtocol, data: &[u8], ) -> Result { match protocol { UacProtocol::Uac1 => DataStreamingEndpoint1::try_from(data) .map(UacInterfaceDescriptor::DataStreamingEndpoint1), UacProtocol::Uac2 => DataStreamingEndpoint2::try_from(data) .map(UacInterfaceDescriptor::DatastreamingEndpoint2), UacProtocol::Uac3 => DataStreamingEndpoint3::try_from(data) .map(UacInterfaceDescriptor::DataStreamingEndpoint3), // Only endpoint _ => Ok(UacInterfaceDescriptor::Invalid(data.to_vec())), } } /// Get bitmap string from the descriptor bit field; each bit corresponds to a string in the array pub fn get_bitmap_string + Copy>(bitmap: T, strings: &[&str]) -> Vec { let mut ret = Vec::new(); for (i, s) in strings.iter().enumerate() { if bitmap.into() & (1 << i) != 0 { ret.push(s.to_string()); } } ret } /// Get the [`ChannelNames`] from the descriptor "wChannelConfig" field bitmap pub fn get_channel_names + Copy>(&self, channel_config: T) -> Vec { match self.get_protocol() { UacProtocol::Uac1 => Uac1ChannelNames::from_bitmap(channel_config) .iter() .map(|c| ChannelNames::Uac1(*c)) .collect(), UacProtocol::Uac2 => Uac2ChannelNames::from_bitmap(channel_config) .iter() .map(|c| ChannelNames::Uac2(*c)) .collect(), _ => Vec::new(), } } /// Get USB Audio Device Class channel names from the descriptor "wChannelConfig" field bitmap string based on the protocol pub fn get_channel_name_strings + Copy>( protocol: &UacProtocol, channel_config: T, ) -> Vec { match protocol { UacProtocol::Uac1 => Uac1ChannelNames::from_bitmap(channel_config) .iter() .map(|c| c.to_string()) .collect(), UacProtocol::Uac2 => Uac2ChannelNames::from_bitmap(channel_config) .iter() .map(|c| c.to_string()) .collect(), _ => Vec::new(), } } /// Get the [`LockDelayUnits`] from the descriptor if it has the field pub fn get_lock_delay_units(&self) -> Option { match self { UacInterfaceDescriptor::DataStreamingEndpoint1(ep) => { Some(LockDelayUnits::from(ep.lock_delay_units)) } UacInterfaceDescriptor::DatastreamingEndpoint2(ep) => { Some(LockDelayUnits::from(ep.lock_delay_units)) } UacInterfaceDescriptor::DataStreamingEndpoint3(ep) => { Some(LockDelayUnits::from(ep.lock_delay_units)) } _ => None, } } /// Get the [`UacProtocol`] version for the interface descriptor pub fn get_protocol(&self) -> UacProtocol { match self { UacInterfaceDescriptor::Header1(_) | UacInterfaceDescriptor::InputTerminal1(_) | UacInterfaceDescriptor::OutputTerminal1(_) | UacInterfaceDescriptor::MixerUnit1(_) | UacInterfaceDescriptor::SelectorUnit1(_) | UacInterfaceDescriptor::ProcessingUnit1(_) | UacInterfaceDescriptor::FeatureUnit1(_) | UacInterfaceDescriptor::ExtensionUnit1(_) => UacProtocol::Uac1, UacInterfaceDescriptor::Header2(_) | UacInterfaceDescriptor::InputTerminal2(_) | UacInterfaceDescriptor::OutputTerminal2(_) | UacInterfaceDescriptor::MixerUnit2(_) | UacInterfaceDescriptor::SelectorUnit2(_) | UacInterfaceDescriptor::ProcessingUnit2(_) | UacInterfaceDescriptor::EffectUnit2(_) | UacInterfaceDescriptor::FeatureUnit2(_) | UacInterfaceDescriptor::ExtensionUnit2(_) | UacInterfaceDescriptor::ClockSource2(_) | UacInterfaceDescriptor::ClockSelector2(_) | UacInterfaceDescriptor::ClockMultiplier2(_) | UacInterfaceDescriptor::SampleRateConverter2(_) | UacInterfaceDescriptor::StreamingInterface2(_) | UacInterfaceDescriptor::DatastreamingEndpoint2(_) => UacProtocol::Uac2, UacInterfaceDescriptor::Header3(_) | UacInterfaceDescriptor::InputTerminal3(_) | UacInterfaceDescriptor::OutputTerminal3(_) | UacInterfaceDescriptor::MixerUnit3(_) | UacInterfaceDescriptor::SelectorUnit3(_) | UacInterfaceDescriptor::ProcessingUnit3(_) | UacInterfaceDescriptor::EffectUnit3(_) | UacInterfaceDescriptor::FeatureUnit3(_) | UacInterfaceDescriptor::ExtensionUnit3(_) | UacInterfaceDescriptor::ClockSource3(_) | UacInterfaceDescriptor::ClockSelector3(_) | UacInterfaceDescriptor::ClockMultiplier3(_) | UacInterfaceDescriptor::SampleRateConverter3(_) | UacInterfaceDescriptor::StreamingInterface3(_) | UacInterfaceDescriptor::DataStreamingEndpoint3(_) | UacInterfaceDescriptor::ExtendedTerminalHeader(_) | UacInterfaceDescriptor::PowerDomain(_) => UacProtocol::Uac3, _ => UacProtocol::Unknown(0xff), } } } /// USB Audio Class (UAC) protocol byte defines the version of the UAC #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[repr(u8)] #[allow(missing_docs)] #[serde(rename_all = "kebab-case")] pub enum UacProtocol { Uac1 = 0x00, Uac2 = 0x20, Uac3 = 0x30, Unknown(u8), } impl From for UacProtocol { fn from(b: u8) -> Self { match b { 0x00 => UacProtocol::Uac1, 0x20 => UacProtocol::Uac2, 0x30 => UacProtocol::Uac3, b => UacProtocol::Unknown(b), } } } impl From for u8 { fn from(up: UacProtocol) -> u8 { match up { UacProtocol::Uac1 => 0x00, UacProtocol::Uac2 => 0x20, UacProtocol::Uac3 => 0x30, UacProtocol::Unknown(b) => b, } } } impl std::fmt::Display for UacProtocol { fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result { match self { UacProtocol::Uac1 => write!(f, "UAC1"), UacProtocol::Uac2 => write!(f, "UAC2"), UacProtocol::Uac3 => write!(f, "UAC3"), UacProtocol::Unknown(_) => write!(f, "Unknown"), } } } /// USB Audio Class (UAC) subtype based on the bDescriptorSubtype #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[serde(rename_all = "kebab-case")] pub enum UacType { /// Audio Control (AC) subtype Control(ControlSubtype), /// Audio Streaming (AS) subtype Streaming(StreamingSubtype), /// MIDI subtype Midi(MidiSubtype), } /// From a tuple of (SubClass, DescriptorSub, Protocol) get the UAC subtype impl TryFrom<(u8, u8, u8)> for UacType { type Error = Error; fn try_from((sub_class, descriptor_sub, protocol): (u8, u8, u8)) -> error::Result { match (sub_class, descriptor_sub, protocol) { (1, d, p) => Ok(UacType::Control(ControlSubtype::get_uac_subtype(d, p))), (2, d, _) => Ok(UacType::Streaming(StreamingSubtype::from(d))), (3, d, _) => Ok(UacType::Midi(MidiSubtype::from(d))), _ => Err(Error::new(ErrorKind::InvalidArg, "Invalid UAC subtype")), } } } impl From for u8 { fn from(us: UacType) -> u8 { match us { UacType::Control(aci) => aci as u8, UacType::Streaming(asi) => asi as u8, UacType::Midi(mi) => mi as u8, } } } impl fmt::Display for UacType { fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result { if f.alternate() { match self { UacType::Control(aci) => write!(f, "{aci:#}"), UacType::Streaming(asi) => write!(f, "{asi:#}"), UacType::Midi(mi) => write!(f, "{mi:#}"), } } else { match self { UacType::Control(aci) => write!(f, "{aci}"), UacType::Streaming(asi) => write!(f, "{asi}"), UacType::Midi(mi) => write!(f, "{mi}"), } } } } impl UacType { /// Get the [`UacInterfaceDescriptor`] based on UAC subtype, [`UacProtocol`] and raw data pub fn get_uac_descriptor( &self, protocol: u8, data: &[u8], ) -> Result { match self { UacType::Control(aci) => aci.get_descriptor(&UacProtocol::from(protocol), data), UacType::Streaming(asi) => asi.get_descriptor(&UacProtocol::from(protocol), data), UacType::Midi(_) => Err(Error::new( ErrorKind::InvalidArg, "Midi descriptor to UAC not supported, use MidiInterfaceDescriptor", )), } } /// Get the [`UacInterfaceDescriptor`] from a generic descriptor pub fn uac_descriptor_from_generic( &self, gd: GenericDescriptor, protocol: u8, ) -> Result { match gd.data { Some(data) => match self.get_uac_descriptor(protocol, &data) { Ok(d) => Ok(d), Err(e) => { log::warn!("Error parsing UVC descriptor: {e}"); Ok(UacInterfaceDescriptor::Invalid(data)) } }, None => Err(Error::new( ErrorKind::InvalidArg, "GenericDescriptor data is None", )), } } } /// USB Audio Class (UAC) interface Audio Control (AC) types based on bDescriptorSubtype #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[repr(u8)] #[allow(missing_docs)] #[serde(rename_all = "kebab-case")] pub enum ControlSubtype { Undefined = 0x00, Header = 0x01, InputTerminal = 0x02, OutputTerminal = 0x03, ExtendedTerminal = 0x04, MixerUnit = 0x05, SelectorUnit = 0x06, FeatureUnit = 0x07, EffectUnit = 0x08, ProcessingUnit = 0x09, ExtensionUnit = 0x0a, ClockSource = 0x0b, ClockSelector = 0x0c, ClockMultiplier = 0x0d, SampleRateConverter = 0x0e, Connectors = 0x0f, PowerDomain = 0x10, } impl std::fmt::Display for ControlSubtype { fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result { if f.alternate() { // uppercase with _ instead of space for lsusb dump match self { ControlSubtype::Undefined => write!(f, "unknown"), _ => write!(f, "{}", heck::AsShoutySnakeCase(format!("{self:?}"))), } } else { write!(f, "{self:?}") } } } impl From for ControlSubtype { fn from(b: u8) -> Self { match b { 0x00 => ControlSubtype::Undefined, 0x01 => ControlSubtype::Header, 0x02 => ControlSubtype::InputTerminal, 0x03 => ControlSubtype::OutputTerminal, 0x04 => ControlSubtype::ExtendedTerminal, 0x05 => ControlSubtype::MixerUnit, 0x06 => ControlSubtype::SelectorUnit, 0x07 => ControlSubtype::FeatureUnit, 0x08 => ControlSubtype::EffectUnit, 0x09 => ControlSubtype::ProcessingUnit, 0x0a => ControlSubtype::ExtensionUnit, 0x0b => ControlSubtype::ClockSource, 0x0c => ControlSubtype::ClockSelector, 0x0d => ControlSubtype::ClockMultiplier, 0x0e => ControlSubtype::SampleRateConverter, 0x0f => ControlSubtype::Connectors, 0x10 => ControlSubtype::PowerDomain, _ => ControlSubtype::Undefined, } } } impl ControlSubtype { /// UAC1, UAC2, and UAC3 define bDescriptorSubtype differently for the /// AudioControl interface, so we need to do some ugly remapping: pub fn get_uac_subtype(subtype: u8, protocol: u8) -> Self { match protocol { // UAC1 0x00 => match subtype { 0x04 => ControlSubtype::MixerUnit, 0x05 => ControlSubtype::SelectorUnit, 0x06 => ControlSubtype::FeatureUnit, 0x07 => ControlSubtype::ProcessingUnit, 0x08 => ControlSubtype::ExtensionUnit, _ => Self::from(subtype), }, // UAC2 0x20 => match subtype { 0x04 => ControlSubtype::MixerUnit, 0x05 => ControlSubtype::SelectorUnit, 0x06 => ControlSubtype::FeatureUnit, 0x07 => ControlSubtype::EffectUnit, 0x08 => ControlSubtype::ProcessingUnit, 0x09 => ControlSubtype::ExtensionUnit, 0x0a => ControlSubtype::ClockSource, 0x0b => ControlSubtype::ClockSelector, 0x0c => ControlSubtype::ClockMultiplier, 0x0d => ControlSubtype::SampleRateConverter, _ => Self::from(subtype), }, // no re-map for UAC3.. _ => Self::from(subtype), } } /// Get the UAC interface descriptor from the UAC interface pub fn get_descriptor( &self, protocol: &UacProtocol, data: &[u8], ) -> Result { UacInterfaceDescriptor::from_uac_ac_interface(self, protocol, data) } } /// USB Audio Class (UAC) interface Audio Streaming (AS) types based on bDescriptorSubtype #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[repr(u8)] #[allow(missing_docs)] #[serde(rename_all = "kebab-case")] pub enum StreamingSubtype { Undefined = 0x00, General = 0x01, FormatType = 0x02, FormatSpecific = 0x03, } impl From for StreamingSubtype { fn from(b: u8) -> Self { match b { 0x00 => StreamingSubtype::Undefined, 0x01 => StreamingSubtype::General, 0x02 => StreamingSubtype::FormatType, 0x03 => StreamingSubtype::FormatSpecific, _ => StreamingSubtype::Undefined, } } } impl fmt::Display for StreamingSubtype { fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result { if f.alternate() { // uppercase with _ instead of space for lsusb dump write!(f, "{}", heck::AsShoutySnakeCase(format!("{self:?}"))) } else { write!(f, "{self:?}") } } } impl StreamingSubtype { /// Get the UAC interface descriptor from the UAC interface pub fn get_descriptor( &self, protocol: &UacProtocol, data: &[u8], ) -> Result { UacInterfaceDescriptor::from_uac_as_interface(self, protocol, data) } } #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] #[repr(u8)] #[serde(rename_all = "kebab-case")] pub enum StreamingFormatType { TypeI = 0x01, TypeII = 0x02, TypeIII = 0x03, TypeIV = 0x04, Undefined(u8), } impl From for StreamingFormatType { fn from(b: u8) -> Self { match b { 0x01 => StreamingFormatType::TypeI, 0x02 => StreamingFormatType::TypeII, 0x03 => StreamingFormatType::TypeIII, 0x04 => StreamingFormatType::TypeIV, b => StreamingFormatType::Undefined(b), } } } impl From for u8 { fn from(sft: StreamingFormatType) -> u8 { match sft { StreamingFormatType::TypeI => 0x01, StreamingFormatType::TypeII => 0x02, StreamingFormatType::TypeIII => 0x03, StreamingFormatType::TypeIV => 0x04, StreamingFormatType::Undefined(b) => b, } } } impl fmt::Display for StreamingFormatType { fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result { if f.alternate() { match self { StreamingFormatType::TypeI => write!(f, "FORMAT_TYPE_I"), StreamingFormatType::TypeII => write!(f, "FORMAT_TYPE_II"), StreamingFormatType::TypeIII => write!(f, "FORMAT_TYPE_III"), StreamingFormatType::TypeIV => write!(f, "FORMAT_TYPE_IV"), StreamingFormatType::Undefined(_) => write!(f, "invalid"), } } else { write!(f, "{self:?}") } } } #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub enum SampleFrequencyType { Continuous, Discrete(u8), } impl From for SampleFrequencyType { fn from(b: u8) -> Self { match b { 0x00 => SampleFrequencyType::Continuous, b => SampleFrequencyType::Discrete(b), } } } impl From for u8 { fn from(sft: SampleFrequencyType) -> u8 { match sft { SampleFrequencyType::Continuous => 0x00, SampleFrequencyType::Discrete(b) => b, } } } impl fmt::Display for SampleFrequencyType { fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result { match self { SampleFrequencyType::Continuous => write!(f, "Continuous"), SampleFrequencyType::Discrete(_) => write!(f, "Discrete"), } } } #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub enum StreamingFormatInterface { FormatTypeI1(FormatTypeI1), FormatTypeII1(FormatTypeII1), FormatTypeIII1(FormatTypeIII1), FormatTypeI2(FormatTypeI2), FormatTypeII2(FormatTypeII2), FormatTypeIII2(FormatTypeIII2), FormatSpecificMpeg(FormatSpecificMpeg), FormatSpecificAc3(FormatSpecificAc3), Invalid(Vec), Undefined(Vec), } impl From for Vec { fn from(sfi: StreamingFormatInterface) -> Vec { match sfi { StreamingFormatInterface::FormatTypeI1(ft) => ft.into(), StreamingFormatInterface::FormatTypeII1(ft) => ft.into(), StreamingFormatInterface::FormatTypeIII1(ft) => ft.into(), StreamingFormatInterface::FormatTypeI2(ft) => ft.into(), StreamingFormatInterface::FormatTypeII2(ft) => ft.into(), StreamingFormatInterface::FormatTypeIII2(ft) => ft.into(), StreamingFormatInterface::FormatSpecificMpeg(ft) => ft.into(), StreamingFormatInterface::FormatSpecificAc3(ft) => ft.into(), StreamingFormatInterface::Invalid(data) => data, StreamingFormatInterface::Undefined(data) => data, } } } #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct StreamingFormat { pub format_type: StreamingFormatType, pub interface: StreamingFormatInterface, } impl StreamingFormat { /// Get the StreamingFormat from the UAC AS interface pub fn from_uac_as_interface(protocol: &UacProtocol, data: &[u8]) -> Result { if data.is_empty() { return Err(Error::new_descriptor_len("StreamingFormat", 1, data.len())); } let format_type = StreamingFormatType::from(data[0]); match protocol { UacProtocol::Uac1 => match format_type { StreamingFormatType::TypeI => { FormatTypeI1::try_from(&data[1..]).map(|ft| StreamingFormat { format_type, interface: StreamingFormatInterface::FormatTypeI1(ft), }) } StreamingFormatType::TypeII => { FormatTypeII1::try_from(&data[1..]).map(|ft| StreamingFormat { format_type, interface: StreamingFormatInterface::FormatTypeII1(ft), }) } StreamingFormatType::TypeIII => { FormatTypeIII1::try_from(&data[1..]).map(|ft| StreamingFormat { format_type, interface: StreamingFormatInterface::FormatTypeIII1(ft), }) } _ => Ok(StreamingFormat { format_type, interface: StreamingFormatInterface::Undefined(data[1..].to_vec()), }), }, UacProtocol::Uac2 => match format_type { StreamingFormatType::TypeI => { FormatTypeI2::try_from(&data[1..]).map(|ft| StreamingFormat { format_type, interface: StreamingFormatInterface::FormatTypeI2(ft), }) } StreamingFormatType::TypeII => { FormatTypeII2::try_from(&data[1..]).map(|ft| StreamingFormat { format_type, interface: StreamingFormatInterface::FormatTypeII2(ft), }) } StreamingFormatType::TypeIII => { FormatTypeIII2::try_from(&data[1..]).map(|ft| StreamingFormat { format_type, interface: StreamingFormatInterface::FormatTypeIII2(ft), }) } _ => Ok(StreamingFormat { format_type, interface: StreamingFormatInterface::Undefined(data[1..].to_vec()), }), }, _ => Ok(StreamingFormat { format_type, interface: StreamingFormatInterface::Invalid(data[1..].to_vec()), }), } } } impl From for Vec { fn from(sf: StreamingFormat) -> Vec { let mut data = vec![sf.format_type.into()]; data.extend_from_slice(&Vec::::from(sf.interface)); data } } #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct StreamingFormatSpecific { pub format_tag: u16, pub interface: StreamingFormatInterface, } impl StreamingFormatSpecific { /// Get the StreamingFormatSpecific from the UAC AS interface pub fn from_uac_as_interface(_protocol: &UacProtocol, data: &[u8]) -> Result { StreamingFormatSpecific::try_from(data) } } impl TryFrom<&[u8]> for StreamingFormatSpecific { type Error = Error; fn try_from(value: &[u8]) -> Result { if value.len() < 2 { return Err(Error::new_descriptor_len( "StreamingFormatSpecific", 2, value.len(), )); } let format_tag = u16::from_le_bytes([value[0], value[1]]); let format = match format_tag { 0x1001 => StreamingFormatInterface::FormatSpecificMpeg(FormatSpecificMpeg::try_from( &value[2..], )?), 0x1002 => StreamingFormatInterface::FormatSpecificAc3(FormatSpecificAc3::try_from( &value[2..], )?), _ => StreamingFormatInterface::Undefined(value[2..].to_vec()), }; Ok(StreamingFormatSpecific { format_tag, interface: format, }) } } impl From for Vec { fn from(sfs: StreamingFormatSpecific) -> Vec { let mut data = Vec::new(); data.extend_from_slice(&sfs.format_tag.to_le_bytes()); data.extend_from_slice(&Vec::::from(sfs.interface)); data } } #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct FormatTypeI1 { pub num_channels: u8, pub subframe_size: u8, pub bit_resolution: u8, pub sample_frequency_type: SampleFrequencyType, pub sample_frequencies: Vec, } impl TryFrom<&[u8]> for FormatTypeI1 { type Error = Error; fn try_from(value: &[u8]) -> Result { if value.len() < 4 { return Err(Error::new_descriptor_len("FormatTypeI", 4, value.len())); } let nr_channels = value[0]; let subframe_size = value[1]; let bit_resolution = value[2]; let sam_freq_type: SampleFrequencyType = value[3].into(); let mut sam_freqs = Vec::new(); match sam_freq_type { SampleFrequencyType::Continuous => { if value.len() < 10 { return Err(Error::new( ErrorKind::InvalidDescriptor, "Descriptor too short for continuous sample frequency", )); } sam_freqs.push(u32::from_le_bytes([value[4], value[5], value[6], 0])); sam_freqs.push(u32::from_le_bytes([value[7], value[8], value[9], 0])); } SampleFrequencyType::Discrete(b) => { for i in 0..b { let index = 4 + (i as usize * 3); if value.len() < index + 3 { return Err(Error::new( ErrorKind::InvalidDescriptor, "Descriptor too short for discrete sample frequency", )); } sam_freqs.push(u32::from_le_bytes([ value[index], value[index + 1], value[index + 2], 0, ])); } } } Ok(FormatTypeI1 { num_channels: nr_channels, subframe_size, bit_resolution, sample_frequency_type: sam_freq_type, sample_frequencies: sam_freqs, }) } } impl From for Vec { fn from(ft: FormatTypeI1) -> Vec { let mut data = vec![ft.num_channels, ft.subframe_size, ft.bit_resolution]; data.push(ft.sample_frequency_type.into()); for sf in ft.sample_frequencies { data.extend_from_slice(&sf.to_le_bytes()); } data } } #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct FormatTypeII1 { pub max_bit_rate: u16, pub samples_per_frame: u16, pub sample_frequency_type: SampleFrequencyType, pub sample_frequencies: Vec, } impl TryFrom<&[u8]> for FormatTypeII1 { type Error = Error; fn try_from(value: &[u8]) -> Result { if value.len() < 5 { return Err(Error::new_descriptor_len("FormatTypeII", 5, value.len())); } let max_bit_rate = u16::from_le_bytes([value[0], value[1]]); let samples_per_frame = u16::from_le_bytes([value[2], value[3]]); let sam_freq_type: SampleFrequencyType = value[4].into(); let mut sam_freqs = Vec::new(); match sam_freq_type { SampleFrequencyType::Continuous => { if value.len() < 11 { return Err(Error::new( ErrorKind::InvalidDescriptor, "Descriptor too short for continuous sample frequency", )); } sam_freqs.push(u32::from_le_bytes([value[5], value[6], value[7], 0])); sam_freqs.push(u32::from_le_bytes([value[8], value[9], value[10], 0])); } SampleFrequencyType::Discrete(b) => { for i in 0..b { let index = 5 + (i as usize * 3); if value.len() < index + 3 { return Err(Error::new( ErrorKind::InvalidDescriptor, "Descriptor too short for discrete sample frequency", )); } sam_freqs.push(u32::from_le_bytes([ value[index], value[index + 1], value[index + 2], 0, ])); } } } Ok(FormatTypeII1 { max_bit_rate, samples_per_frame, sample_frequency_type: sam_freq_type, sample_frequencies: sam_freqs, }) } } impl From for Vec { fn from(ft: FormatTypeII1) -> Vec { let mut data = Vec::new(); data.extend_from_slice(&ft.max_bit_rate.to_le_bytes()); data.extend_from_slice(&ft.samples_per_frame.to_le_bytes()); data.push(ft.sample_frequency_type.into()); for sf in ft.sample_frequencies { data.extend_from_slice(&sf.to_le_bytes()); } data } } #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct FormatTypeIII1 { pub num_channels: u8, pub subframe_size: u8, pub bit_resolution: u8, pub sample_frequency_type: SampleFrequencyType, pub sample_frequencies: Vec, } impl TryFrom<&[u8]> for FormatTypeIII1 { type Error = Error; fn try_from(value: &[u8]) -> Result { let sam_freq_type: SampleFrequencyType = match value.get(4) { Some(&sam_freq_type) => sam_freq_type.into(), None => return Err(Error::new_descriptor_len("FormatTypeIII", 4, value.len())), }; let expected_len = match sam_freq_type { SampleFrequencyType::Continuous => 10, SampleFrequencyType::Discrete(b) => 4 + (b as usize * 3), }; if value.len() < expected_len { return Err(Error::new_descriptor_len( "FormatTypeIII", expected_len, value.len(), )); } let nr_channels = value[0]; let subframe_size = value[1]; let bit_resolution = value[2]; let mut sam_freqs = Vec::new(); match sam_freq_type { SampleFrequencyType::Continuous => { sam_freqs.push(u32::from_le_bytes([value[4], value[5], value[6], 0])); sam_freqs.push(u32::from_le_bytes([value[7], value[8], value[9], 0])); } SampleFrequencyType::Discrete(b) => { for i in 0..b { let index = 4 + (i as usize * 3); sam_freqs.push(u32::from_le_bytes([ value[index], value[index + 1], value[index + 2], 0, ])); } } } Ok(FormatTypeIII1 { num_channels: nr_channels, subframe_size, bit_resolution, sample_frequency_type: sam_freq_type, sample_frequencies: sam_freqs, }) } } impl From for Vec { fn from(ft: FormatTypeIII1) -> Vec { let mut data = vec![ft.num_channels, ft.subframe_size, ft.bit_resolution]; data.push(ft.sample_frequency_type.into()); for sf in ft.sample_frequencies { data.extend_from_slice(&sf.to_le_bytes()); } data } } #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct FormatTypeI2 { pub sub_slot_size: u8, pub bit_resolution: u8, } impl TryFrom<&[u8]> for FormatTypeI2 { type Error = Error; fn try_from(value: &[u8]) -> Result { if value.len() < 2 { return Err(Error::new_descriptor_len("FormatTypeI2", 2, value.len())); } Ok(FormatTypeI2 { sub_slot_size: value[0], bit_resolution: value[1], }) } } impl From for Vec { fn from(ft: FormatTypeI2) -> Vec { vec![ft.sub_slot_size, ft.bit_resolution] } } #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct FormatTypeII2 { pub max_bit_rate: u16, pub slots_per_frame: u16, } impl TryFrom<&[u8]> for FormatTypeII2 { type Error = Error; fn try_from(value: &[u8]) -> Result { if value.len() < 4 { return Err(Error::new_descriptor_len("FormatTypeII2", 4, value.len())); } Ok(FormatTypeII2 { max_bit_rate: u16::from_le_bytes([value[0], value[1]]), slots_per_frame: u16::from_le_bytes([value[2], value[3]]), }) } } impl From for Vec { fn from(ft: FormatTypeII2) -> Vec { let mut data = Vec::new(); data.extend_from_slice(&ft.max_bit_rate.to_le_bytes()); data.extend_from_slice(&ft.slots_per_frame.to_le_bytes()); data } } #[allow(missing_docs)] pub type FormatTypeIII2 = FormatTypeI2; #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct FormatSpecificMpeg { pub mpeg_capabilities: u16, pub mpeg_features: u8, } impl TryFrom<&[u8]> for FormatSpecificMpeg { type Error = Error; fn try_from(value: &[u8]) -> Result { if value.len() < 3 { return Err(Error::new_descriptor_len( "FormatSpecificMpeg", 3, value.len(), )); } Ok(FormatSpecificMpeg { mpeg_capabilities: u16::from_le_bytes([value[0], value[1]]), mpeg_features: value[2], }) } } impl From for Vec { fn from(ft: FormatSpecificMpeg) -> Vec { let mut data = Vec::new(); data.push(ft.mpeg_features); data.extend_from_slice(&ft.mpeg_capabilities.to_le_bytes()); data } } #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct FormatSpecificAc3 { pub bsid: u32, pub ac3_features: u8, } impl TryFrom<&[u8]> for FormatSpecificAc3 { type Error = Error; fn try_from(value: &[u8]) -> Result { if value.len() < 5 { return Err(Error::new_descriptor_len( "FormatSpecificAc3", 5, value.len(), )); } Ok(FormatSpecificAc3 { bsid: u32::from_le_bytes([value[0], value[1], value[2], value[3]]), ac3_features: value[4], }) } } impl From for Vec { fn from(ft: FormatSpecificAc3) -> Vec { let mut data = Vec::new(); data.extend_from_slice(&ft.bsid.to_le_bytes()); data.push(ft.ac3_features); data } } /// The control setting for a UAC bmControls byte #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[repr(u8)] #[allow(missing_docs)] #[serde(rename_all = "kebab-case")] pub enum ControlSetting { ReadOnly = 0b01, IllegalValue = 0b10, ReadWrite = 0b11, } impl From for ControlSetting { fn from(b: u8) -> Self { match b { 0b01 => ControlSetting::ReadOnly, 0b10 => ControlSetting::IllegalValue, 0b11 => ControlSetting::ReadWrite, _ => ControlSetting::IllegalValue, } } } impl fmt::Display for ControlSetting { fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result { match self { ControlSetting::ReadOnly => write!(f, "read-only"), ControlSetting::IllegalValue => write!(f, "ILLEGAL VALUE (0b10)"), ControlSetting::ReadWrite => write!(f, "read/write"), } } } /// UAC bmControl can be 1 bit for just the control type or 2 bits for control type and whether it's read-only #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] #[serde(rename_all = "kebab-case")] pub enum ControlType { BmControl1, BmControl2, } /// UAC1: 4.3.2 Class-Specific AC Interface Descriptor; Table 4-2. #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct Header1 { pub version: Version, pub total_length: u16, pub collection_bytes: u8, pub interfaces: Vec, } impl TryFrom<&[u8]> for Header1 { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 6 { return Err(Error::new_descriptor_len("Header1", 6, value.len())); } let total_length = u16::from_le_bytes([value[2], value[3]]); let collection_bytes = value[4]; let interfaces = value[5..].to_vec(); Ok(Header1 { version: Version::from_bcd(u16::from_le_bytes([value[0], value[1]])), total_length, collection_bytes, interfaces, }) } } impl From for Vec { fn from(val: Header1) -> Self { let mut data = Vec::new(); data.extend_from_slice(&(u16::from(val.version)).to_le_bytes()); data.extend_from_slice(&val.total_length.to_le_bytes()); data.push(val.collection_bytes); data.extend_from_slice(&val.interfaces); data } } /// UAC2: 4.7.2 Class-Specific AC Interface Descriptor; Table 4-5. #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct Header2 { pub version: Version, pub category: u8, pub total_length: u16, pub controls: u8, } impl TryFrom<&[u8]> for Header2 { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 6 { return Err(Error::new_descriptor_len("Header2", 6, value.len())); } let total_length = u16::from_le_bytes([value[3], value[4]]); let controls = value[5]; Ok(Header2 { version: Version::from_bcd(u16::from_le_bytes([value[0], value[1]])), category: value[2], total_length, controls, }) } } impl From for Vec { fn from(val: Header2) -> Self { let mut data = Vec::new(); data.extend_from_slice(&(u16::from(val.version)).to_le_bytes()); data.push(val.category); data.extend_from_slice(&val.total_length.to_le_bytes()); data.push(val.controls); data } } /// UAC3: 4.5.2 Class-Specific AC Interface Descriptor; Table 4-15. #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct Header3 { pub category: u8, pub total_length: u16, pub controls: u32, } impl TryFrom<&[u8]> for Header3 { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 7 { return Err(Error::new_descriptor_len("Header3", 7, value.len())); } let total_length = u16::from_le_bytes([value[1], value[2]]); let controls = u32::from_le_bytes([value[3], value[4], value[5], value[6]]); Ok(Header3 { category: value[0], total_length, controls, }) } } impl From for Vec { fn from(val: Header3) -> Self { let mut data = Vec::new(); data.push(val.category); data.extend_from_slice(&val.total_length.to_le_bytes()); data.extend_from_slice(&val.controls.to_le_bytes()); data } } /// UAC1: 4.3.2.1 Input Terminal Descriptor; Table 4-3. #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct InputTerminal1 { pub terminal_id: u8, pub terminal_type: u16, pub assoc_terminal: u8, pub nr_channels: u8, pub channel_config: u16, pub channel_names_index: u8, pub channel_names: Option, pub terminal_index: u8, pub terminal: Option, } impl TryFrom<&[u8]> for InputTerminal1 { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 9 { return Err(Error::new_descriptor_len("InputTerminal1", 9, value.len())); } Ok(InputTerminal1 { terminal_id: value[0], terminal_type: u16::from_le_bytes([value[1], value[2]]), assoc_terminal: value[3], nr_channels: value[4], channel_config: u16::from_le_bytes([value[5], value[6]]), channel_names_index: value[7], channel_names: None, terminal_index: value[8], terminal: None, }) } } impl From for Vec { fn from(val: InputTerminal1) -> Self { let mut data = Vec::new(); data.push(val.terminal_id); data.extend_from_slice(&val.terminal_type.to_le_bytes()); data.push(val.assoc_terminal); data.push(val.nr_channels); data.extend_from_slice(&val.channel_config.to_le_bytes()); data.push(val.channel_names_index); data.push(val.terminal_index); data } } /// UAC2: 4.7.2.4 Input Terminal Descriptor; Table 4-9. #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct InputTerminal2 { pub terminal_id: u8, pub terminal_type: u16, pub assoc_terminal: u8, pub csource_id: u8, pub nr_channels: u8, pub channel_config: u32, pub channel_names_index: u8, pub channel_names: Option, pub controls: u16, pub terminal_index: u8, pub terminal: Option, } impl TryFrom<&[u8]> for InputTerminal2 { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 14 { return Err(Error::new_descriptor_len("InputTerminal2", 14, value.len())); } Ok(InputTerminal2 { terminal_id: value[0], terminal_type: u16::from_le_bytes([value[1], value[2]]), assoc_terminal: value[3], csource_id: value[4], nr_channels: value[5], channel_config: u32::from_le_bytes([value[6], value[7], value[8], value[9]]), channel_names_index: value[10], channel_names: None, controls: u16::from_le_bytes([value[11], value[12]]), terminal_index: value[13], terminal: None, }) } } impl From for Vec { fn from(val: InputTerminal2) -> Self { let mut data = Vec::new(); data.push(val.terminal_id); data.extend_from_slice(&val.terminal_type.to_le_bytes()); data.push(val.assoc_terminal); data.push(val.csource_id); data.push(val.nr_channels); data.extend_from_slice(&val.channel_config.to_le_bytes()); data.push(val.channel_names_index); data.extend_from_slice(&val.controls.to_le_bytes()); data.push(val.terminal_index); data } } /// UAC3: 4.5.2.1 Input Terminal Descriptor; Table 4-16. #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct InputTerminal3 { pub terminal_id: u8, pub terminal_type: u16, pub assoc_terminal: u8, pub csource_id: u8, pub controls: u32, pub cluster_descr_id: u16, pub ex_terminal_descr_id: u16, pub connectors_descr_id: u16, pub terminal_descr_str: u16, } impl TryFrom<&[u8]> for InputTerminal3 { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 17 { return Err(Error::new_descriptor_len("InputTerminal3", 17, value.len())); } Ok(InputTerminal3 { terminal_id: value[0], terminal_type: u16::from_le_bytes([value[1], value[2]]), assoc_terminal: value[3], csource_id: value[4], controls: u32::from_le_bytes([value[5], value[6], value[7], value[8]]), cluster_descr_id: u16::from_le_bytes([value[9], value[10]]), ex_terminal_descr_id: u16::from_le_bytes([value[11], value[12]]), connectors_descr_id: u16::from_le_bytes([value[13], value[14]]), terminal_descr_str: u16::from_le_bytes([value[15], value[16]]), }) } } impl From for Vec { fn from(val: InputTerminal3) -> Self { let mut data = Vec::new(); data.push(val.terminal_id); data.extend_from_slice(&val.terminal_type.to_le_bytes()); data.push(val.assoc_terminal); data.push(val.csource_id); data.extend_from_slice(&val.controls.to_le_bytes()); data.extend_from_slice(&val.cluster_descr_id.to_le_bytes()); data.extend_from_slice(&val.ex_terminal_descr_id.to_le_bytes()); data.extend_from_slice(&val.connectors_descr_id.to_le_bytes()); data.extend_from_slice(&val.terminal_descr_str.to_le_bytes()); data } } /// UAC1: 4.3.2.2 Output Terminal Descriptor; Table 4-4. #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct OutputTerminal1 { pub terminal_id: u8, pub terminal_type: u16, pub assoc_terminal: u8, pub source_id: u8, pub terminal_index: u8, pub terminal: Option, } impl TryFrom<&[u8]> for OutputTerminal1 { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 6 { return Err(Error::new_descriptor_len("OutputTerminal1", 6, value.len())); } Ok(OutputTerminal1 { terminal_id: value[0], terminal_type: u16::from_le_bytes([value[1], value[2]]), assoc_terminal: value[3], source_id: value[4], terminal_index: value[5], terminal: None, }) } } impl From for Vec { fn from(val: OutputTerminal1) -> Self { let mut data = Vec::new(); data.push(val.terminal_id); data.extend_from_slice(&val.terminal_type.to_le_bytes()); data.push(val.assoc_terminal); data.push(val.source_id); data.push(val.terminal_index); data } } /// UAC2: 4.7.2.5 Output Terminal Descriptor; Table 4-10. #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct OutputTerminal2 { pub terminal_id: u8, pub terminal_type: u16, pub assoc_terminal: u8, pub source_id: u8, pub c_source_id: u8, pub controls: u16, pub terminal_index: u8, pub terminal: Option, } impl TryFrom<&[u8]> for OutputTerminal2 { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 9 { return Err(Error::new_descriptor_len("OutputTerminal2", 9, value.len())); } Ok(OutputTerminal2 { terminal_id: value[0], terminal_type: u16::from_le_bytes([value[1], value[2]]), assoc_terminal: value[3], source_id: value[4], c_source_id: value[5], controls: u16::from_le_bytes([value[6], value[7]]), terminal_index: value[8], terminal: None, }) } } impl From for Vec { fn from(val: OutputTerminal2) -> Self { let mut data = Vec::new(); data.push(val.terminal_id); data.extend_from_slice(&val.terminal_type.to_le_bytes()); data.push(val.assoc_terminal); data.push(val.source_id); data.push(val.c_source_id); data.extend_from_slice(&val.controls.to_le_bytes()); data.push(val.terminal_index); data } } /// UAC3: 4.5.2.2 Output Terminal Descriptor; Table 4-17. #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct OutputTerminal3 { pub terminal_id: u8, pub terminal_type: u16, pub assoc_terminal: u8, pub source_id: u8, pub c_source_id: u8, pub controls: u32, pub ex_terminal_descr_id: u16, pub connectors_descr_id: u16, pub terminal_descr_str: u16, } impl TryFrom<&[u8]> for OutputTerminal3 { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 16 { return Err(Error::new_descriptor_len( "OutputTerminal3", 16, value.len(), )); } Ok(OutputTerminal3 { terminal_id: value[0], terminal_type: u16::from_le_bytes([value[1], value[2]]), assoc_terminal: value[3], source_id: value[4], c_source_id: value[5], controls: u32::from_le_bytes([value[6], value[7], value[8], value[9]]), ex_terminal_descr_id: u16::from_le_bytes([value[10], value[11]]), connectors_descr_id: u16::from_le_bytes([value[12], value[13]]), terminal_descr_str: u16::from_le_bytes([value[14], value[15]]), }) } } impl From for Vec { fn from(val: OutputTerminal3) -> Self { let mut data = Vec::new(); data.push(val.terminal_id); data.extend_from_slice(&val.terminal_type.to_le_bytes()); data.push(val.assoc_terminal); data.push(val.source_id); data.push(val.c_source_id); data.extend_from_slice(&val.controls.to_le_bytes()); data.extend_from_slice(&val.ex_terminal_descr_id.to_le_bytes()); data.extend_from_slice(&val.connectors_descr_id.to_le_bytes()); data.extend_from_slice(&val.terminal_descr_str.to_le_bytes()); data } } /// UAC3: 4.5.2.3.1 Extended Terminal Header Descriptor; Table 4-18. #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct ExtendedTerminalHeader { pub descriptor_id: u8, pub nr_channels: u8, } impl TryFrom<&[u8]> for ExtendedTerminalHeader { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 2 { return Err(Error::new_descriptor_len( "ExtendedTerminalHeader", 2, value.len(), )); } Ok(ExtendedTerminalHeader { descriptor_id: value[0], nr_channels: value[1], }) } } impl From for Vec { fn from(val: ExtendedTerminalHeader) -> Self { vec![val.descriptor_id, val.nr_channels] } } /// UAC3: 4.5.2.15 Power Domain Descriptor; Table 4-46. */ #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct PowerDomain { pub power_domain_id: u8, pub recovery_time_1: u16, pub recovery_time_2: u16, pub nr_entities: u8, pub entity_ids: Vec, pub domain_descr_str: u16, } impl TryFrom<&[u8]> for PowerDomain { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 8 { return Err(Error::new_descriptor_len("PowerDomain", 8, value.len())); } let nr_entities = value[5] as usize; let expected_len = 8 + nr_entities; if value.len() < expected_len { return Err(Error::new( ErrorKind::InvalidDescriptor, "PowerDomain3 descriptor too short for the number of entities", )); } Ok(PowerDomain { power_domain_id: value[0], recovery_time_1: u16::from_le_bytes([value[1], value[2]]), recovery_time_2: u16::from_le_bytes([value[3], value[4]]), nr_entities: value[5], entity_ids: value[6..6 + nr_entities].to_vec(), domain_descr_str: u16::from_le_bytes([value[6 + nr_entities], value[7 + nr_entities]]), }) } } impl From for Vec { fn from(val: PowerDomain) -> Self { let mut data = Vec::new(); data.push(val.power_domain_id); data.extend_from_slice(&val.recovery_time_1.to_le_bytes()); data.extend_from_slice(&val.recovery_time_2.to_le_bytes()); data.push(val.nr_entities); data.extend_from_slice(&val.entity_ids); data.extend_from_slice(&val.domain_descr_str.to_le_bytes()); data } } /// UAC1: 4.3.2.3 Mixer Unit Descriptor; Table 4-5. #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct MixerUnit1 { pub unit_id: u8, pub nr_in_pins: u8, pub source_ids: Vec, pub nr_channels: u8, pub channel_config: u16, pub channel_names: u8, pub controls: Vec, pub mixer: u8, } impl TryFrom<&[u8]> for MixerUnit1 { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 7 { return Err(Error::new_descriptor_len("MixerUnit1", 7, value.len())); } let nr_in_pins = value[1] as usize; // The number of channels is after the source IDs so depends on the number of input pins let nr_channels = *value .get(2 + nr_in_pins) .ok_or_else(|| Error::new_descriptor_len("MixerUnit1", 2 + nr_in_pins, value.len()))? as usize; let expected_len = 7 + nr_in_pins + nr_channels; if value.len() < expected_len { return Err(Error::new( ErrorKind::InvalidDescriptor, "MixerUnit1 descriptor too short for the number of pins and channels", )); } Ok(MixerUnit1 { unit_id: value[0], nr_in_pins: value[1], source_ids: value[2..2 + nr_in_pins].to_vec(), nr_channels: value[2 + nr_in_pins], channel_config: u16::from_le_bytes([value[3 + nr_in_pins], value[4 + nr_in_pins]]), channel_names: value[5 + nr_in_pins], controls: value[6 + nr_in_pins..6 + nr_in_pins + nr_channels].to_vec(), mixer: value[6 + nr_in_pins + nr_channels], }) } } impl From for Vec { fn from(val: MixerUnit1) -> Self { let mut data = Vec::new(); data.push(val.unit_id); data.push(val.nr_in_pins); data.extend_from_slice(&val.source_ids); data.push(val.nr_channels); data.extend_from_slice(&val.channel_config.to_le_bytes()); data.push(val.channel_names); data.extend_from_slice(&val.controls); data.push(val.mixer); data } } /// UAC2: 4.7.2.6 Mixer Unit Descriptor; Table 4-11. #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct MixerUnit2 { pub unit_id: u8, pub nr_in_pins: u8, pub source_ids: Vec, pub nr_channels: u8, pub channel_config: u32, pub channel_names: u8, pub mixer_controls: Vec, pub controls: u8, pub mixer: u8, } impl TryFrom<&[u8]> for MixerUnit2 { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 10 { return Err(Error::new_descriptor_len("MixerUnit2", 10, value.len())); } let nr_in_pins = value[1] as usize; // The number of channels is after the source IDs so depends on the number of input pins let nr_channels = *value .get(2 + nr_in_pins) .ok_or_else(|| Error::new_descriptor_len("MixerUnit1", 2 + nr_in_pins, value.len()))? as usize; let expected_len = 10 + nr_in_pins + nr_channels; if value.len() < expected_len { return Err(Error::new( ErrorKind::InvalidDescriptor, "MixerUnit2 descriptor too short for the number of pins and channels", )); } Ok(MixerUnit2 { unit_id: value[0], nr_in_pins: value[1], source_ids: value[2..2 + nr_in_pins].to_vec(), nr_channels: value[2 + nr_in_pins], channel_config: u32::from_le_bytes([ value[3 + nr_in_pins], value[4 + nr_in_pins], value[5 + nr_in_pins], value[6 + nr_in_pins], ]), channel_names: value[7 + nr_in_pins], mixer_controls: value[8 + nr_in_pins..8 + nr_in_pins + nr_channels].to_vec(), controls: value[8 + nr_in_pins + nr_channels], mixer: value[9 + nr_in_pins + nr_channels], }) } } impl From for Vec { fn from(val: MixerUnit2) -> Self { let mut data = Vec::new(); data.push(val.unit_id); data.push(val.nr_in_pins); data.extend_from_slice(&val.source_ids); data.push(val.nr_channels); data.extend_from_slice(&val.channel_config.to_le_bytes()); data.push(val.channel_names); data.extend_from_slice(&val.mixer_controls); data.push(val.controls); data.push(val.mixer); data } } /// UAC3: 4.5.2.5 Mixer Unit Descriptor; Table 4-29. #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct MixerUnit3 { pub unit_id: u8, pub nr_in_pins: u8, pub source_ids: Vec, pub cluster_descr_id: u16, pub mixer_controls: Vec, pub controls: u32, pub mixer_descr_str: u16, } impl TryFrom<&[u8]> for MixerUnit3 { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 11 { return Err(Error::new_descriptor_len("MixerUnit3", 11, value.len())); } let nr_in_pins = value[1] as usize; let expected_len = 11 + nr_in_pins; if value.len() < expected_len { return Err(Error::new( ErrorKind::InvalidDescriptor, "MixerUnit3 descriptor too short for the number of pins", )); } Ok(MixerUnit3 { unit_id: value[0], nr_in_pins: value[1], source_ids: value[2..2 + nr_in_pins].to_vec(), cluster_descr_id: u16::from_le_bytes([value[2 + nr_in_pins], value[3 + nr_in_pins]]), mixer_controls: value[4 + nr_in_pins..4 + nr_in_pins + 1].to_vec(), controls: u32::from_le_bytes([ value[5 + nr_in_pins], value[6 + nr_in_pins], value[7 + nr_in_pins], value[8 + nr_in_pins], ]), mixer_descr_str: u16::from_le_bytes([value[9 + nr_in_pins], value[10 + nr_in_pins]]), }) } } impl From for Vec { fn from(val: MixerUnit3) -> Self { let mut data = Vec::new(); data.push(val.unit_id); data.push(val.nr_in_pins); data.extend_from_slice(&val.source_ids); data.extend_from_slice(&val.cluster_descr_id.to_le_bytes()); data.extend_from_slice(&val.mixer_controls); data.extend_from_slice(&val.controls.to_le_bytes()); data.extend_from_slice(&val.mixer_descr_str.to_le_bytes()); data } } #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct StreamingInterface1 { pub terminal_link: u8, pub delay: u8, pub format_tag: u16, } impl TryFrom<&[u8]> for StreamingInterface1 { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 4 { return Err(Error::new_descriptor_len( "StreamingInterface1", 4, value.len(), )); } Ok(StreamingInterface1 { terminal_link: value[0], delay: value[1], format_tag: u16::from_le_bytes([value[2], value[3]]), }) } } impl From for Vec { fn from(val: StreamingInterface1) -> Self { let mut data = Vec::new(); data.push(val.terminal_link); data.push(val.delay); data.extend_from_slice(&val.format_tag.to_le_bytes()); data } } #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct StreamingInterface2 { pub terminal_link: u8, pub controls: u8, // BmControl2 pub format_type: u8, pub formats: u32, pub nr_channels: u8, pub channel_config: u32, pub channel_names_index: u8, pub channel_names: Option, } impl TryFrom<&[u8]> for StreamingInterface2 { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 13 { return Err(Error::new_descriptor_len( "StreamingInterface2", 13, value.len(), )); } Ok(StreamingInterface2 { terminal_link: value[0], controls: value[1], format_type: value[2], formats: u32::from_le_bytes([value[3], value[4], value[5], value[6]]), nr_channels: value[7], channel_config: u32::from_le_bytes([value[8], value[9], value[10], value[11]]), channel_names_index: value[12], channel_names: None, }) } } impl From for Vec { fn from(val: StreamingInterface2) -> Self { let mut data = Vec::new(); data.push(val.terminal_link); data.push(val.controls); data.push(val.format_type); data.extend_from_slice(&val.formats.to_le_bytes()); data.push(val.nr_channels); data.extend_from_slice(&val.channel_config.to_le_bytes()); data.push(val.channel_names_index); data } } #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct StreamingInterface3 { pub terminal_link: u8, pub controls: u32, // BmControl2 pub cluster_descr_id: u16, pub formats: u64, pub sub_slot_size: u8, pub bit_resolution: u8, pub aux_protocols: u16, pub control_size: u8, } impl TryFrom<&[u8]> for StreamingInterface3 { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 20 { return Err(Error::new_descriptor_len( "StreamingInterface3", 20, value.len(), )); } Ok(StreamingInterface3 { terminal_link: value[0], controls: u32::from_le_bytes([value[1], value[2], value[3], value[4]]), cluster_descr_id: u16::from_le_bytes([value[5], value[6]]), formats: u64::from_le_bytes([ value[7], value[8], value[9], value[10], value[11], value[12], value[13], value[14], ]), sub_slot_size: value[15], bit_resolution: value[16], aux_protocols: u16::from_le_bytes([value[17], value[18]]), control_size: value[19], }) } } impl From for Vec { fn from(val: StreamingInterface3) -> Self { let mut data = Vec::new(); data.push(val.terminal_link); data.extend_from_slice(&val.controls.to_le_bytes()); data.extend_from_slice(&val.cluster_descr_id.to_le_bytes()); data.extend_from_slice(&val.formats.to_le_bytes()); data.push(val.sub_slot_size); data.push(val.bit_resolution); data.extend_from_slice(&val.aux_protocols.to_le_bytes()); data.push(val.control_size); data } } #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[repr(u8)] #[allow(missing_docs)] #[serde(rename_all = "kebab-case")] pub enum LockDelayUnits { Undefined, Milliseconds, DecodedPcmSamples, } impl From for LockDelayUnits { fn from(b: u8) -> Self { match b { 0 => LockDelayUnits::Undefined, 1 => LockDelayUnits::Milliseconds, 2 => LockDelayUnits::DecodedPcmSamples, _ => LockDelayUnits::Undefined, } } } impl fmt::Display for LockDelayUnits { fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result { match self { LockDelayUnits::Undefined => write!(f, "Undefined"), LockDelayUnits::Milliseconds => write!(f, "Milliseconds"), LockDelayUnits::DecodedPcmSamples => write!(f, "Decoded PCM samples"), } } } /// Isochronous Audio Data Stream Endpoint for UAC1 #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct DataStreamingEndpoint1 { pub attributes: u8, pub lock_delay_units: u8, pub lock_delay: u16, } impl DataStreamingEndpoint1 { const EXPECTED_LENGTH: usize = 4; /// Get the expected length of the descriptor pub fn size() -> usize { Self::EXPECTED_LENGTH } /// Get the lock delay units pub fn lock_delay_units(&self) -> LockDelayUnits { self.lock_delay_units.into() } } impl TryFrom<&[u8]> for DataStreamingEndpoint1 { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < Self::size() { return Err(Error::new_descriptor_len( "DataStreamingEndpoint1", Self::size(), value.len(), )); } Ok(DataStreamingEndpoint1 { attributes: value[0], lock_delay_units: value[1], lock_delay: u16::from_le_bytes([value[2], value[3]]), }) } } impl From for Vec { fn from(val: DataStreamingEndpoint1) -> Self { vec![ val.attributes, val.lock_delay_units, val.lock_delay.to_le_bytes()[0], val.lock_delay.to_le_bytes()[1], ] } } /// Isochronous Audio Data Stream Endpoint for UAC2 #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct DataStreamingEndpoint2 { pub attributes: u8, pub controls: u8, pub lock_delay_units: u8, pub lock_delay: u16, } impl DataStreamingEndpoint2 { const EXPECTED_LENGTH: usize = 5; /// Get the expected length of the descriptor pub fn size() -> usize { Self::EXPECTED_LENGTH } /// Get the lock delay units pub fn lock_delay_units(&self) -> LockDelayUnits { self.lock_delay_units.into() } } impl TryFrom<&[u8]> for DataStreamingEndpoint2 { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < Self::size() { return Err(Error::new_descriptor_len( "DataStreamingEndpoint2", Self::size(), value.len(), )); } Ok(DataStreamingEndpoint2 { attributes: value[0], controls: value[1], lock_delay_units: value[2], lock_delay: u16::from_le_bytes([value[3], value[4]]), }) } } impl From for Vec { fn from(val: DataStreamingEndpoint2) -> Self { vec![ val.attributes, val.controls, val.lock_delay_units, val.lock_delay.to_le_bytes()[0], val.lock_delay.to_le_bytes()[1], ] } } /// Isochronous Audio Data Stream Endpoint for UAC3 #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct DataStreamingEndpoint3 { pub controls: u32, pub lock_delay_units: u8, pub lock_delay: u16, } impl DataStreamingEndpoint3 { const EXPECTED_LENGTH: usize = 7; /// Get the expected length of the descriptor pub fn size() -> usize { Self::EXPECTED_LENGTH } /// Get the lock delay units pub fn lock_delay_units(&self) -> LockDelayUnits { self.lock_delay_units.into() } } impl TryFrom<&[u8]> for DataStreamingEndpoint3 { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < Self::size() { return Err(Error::new_descriptor_len( "DataStreamingEndpoint3", Self::size(), value.len(), )); } Ok(DataStreamingEndpoint3 { controls: u32::from_le_bytes([value[0], value[1], value[2], value[3]]), lock_delay_units: value[4], lock_delay: u16::from_le_bytes([value[5], value[6]]), }) } } impl From for Vec { fn from(val: DataStreamingEndpoint3) -> Self { let mut data = Vec::new(); data.extend_from_slice(&val.controls.to_le_bytes()); data.push(val.lock_delay_units); data.extend_from_slice(&val.lock_delay.to_le_bytes()); data } } #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct SelectorUnit1 { pub unit_id: u8, pub nr_in_pins: u8, pub source_ids: Vec, pub selector_index: u8, pub selector: Option, } impl TryFrom<&[u8]> for SelectorUnit1 { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 3 { return Err(Error::new_descriptor_len("SelectorUnit1", 3, value.len())); } let nr_in_pins = value[1] as usize; let expected_length = 3 + nr_in_pins; if value.len() < expected_length { return Err(Error::new( ErrorKind::InvalidDescriptor, "SelectorUnit1 descriptor too short", )); } let source_ids = value[2..(2 + nr_in_pins)].to_vec(); Ok(SelectorUnit1 { unit_id: value[0], nr_in_pins: value[1], source_ids, selector_index: value[2 + nr_in_pins], selector: None, }) } } impl From for Vec { fn from(val: SelectorUnit1) -> Self { let mut data = Vec::new(); data.push(val.unit_id); data.push(val.nr_in_pins); data.extend_from_slice(&val.source_ids); data.push(val.selector_index); data } } #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct SelectorUnit2 { pub unit_id: u8, pub nr_in_pins: u8, pub source_ids: Vec, pub controls: u8, pub selector_index: u8, pub selector: Option, } impl TryFrom<&[u8]> for SelectorUnit2 { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 4 { return Err(Error::new_descriptor_len("SelectorUnit2", 4, value.len())); } let nr_in_pins = value[1] as usize; let expected_length = 4 + nr_in_pins; if value.len() < expected_length { return Err(Error::new( ErrorKind::InvalidDescriptor, "SelectorUnit2 descriptor too short", )); } let source_ids = value[2..(2 + nr_in_pins)].to_vec(); Ok(SelectorUnit2 { unit_id: value[0], nr_in_pins: value[1], source_ids, controls: value[2 + nr_in_pins], selector_index: value[3 + nr_in_pins], selector: None, }) } } impl From for Vec { fn from(val: SelectorUnit2) -> Self { let mut data = Vec::new(); data.push(val.unit_id); data.push(val.nr_in_pins); data.extend_from_slice(&val.source_ids); data.push(val.controls); data.push(val.selector_index); data } } #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct SelectorUnit3 { pub unit_id: u8, pub nr_in_pins: u8, pub source_ids: Vec, pub controls: u32, pub selector_descr_str: u16, } impl TryFrom<&[u8]> for SelectorUnit3 { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 8 { return Err(Error::new_descriptor_len("SelectorUnit3", 8, value.len())); } let nr_in_pins = value[1] as usize; let expected_length = 8 + nr_in_pins; if value.len() < expected_length { return Err(Error::new( ErrorKind::InvalidDescriptor, "SelectorUnit3 descriptor too short", )); } let source_ids = value[2..(2 + nr_in_pins)].to_vec(); let controls = u32::from_le_bytes([ value[2 + nr_in_pins], value[3 + nr_in_pins], value[4 + nr_in_pins], value[5 + nr_in_pins], ]); Ok(SelectorUnit3 { unit_id: value[0], nr_in_pins: value[1], source_ids, controls, selector_descr_str: u16::from_le_bytes([value[6 + nr_in_pins], value[7 + nr_in_pins]]), }) } } impl From for Vec { fn from(val: SelectorUnit3) -> Self { let mut data = Vec::new(); data.push(val.unit_id); data.push(val.nr_in_pins); data.extend_from_slice(&val.source_ids); data.extend_from_slice(&val.controls.to_le_bytes()); data.extend_from_slice(&val.selector_descr_str.to_le_bytes()); data } } #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] #[serde(rename_all = "kebab-case")] pub enum AudioProcessingUnitType { Undefined, UpDownMix, DolbyPrologic, StereoExtender3d, StereoExtender, Reverberation, Chorus, DynRangeComp, MultiFunction, } impl From<(UacProtocol, u16)> for AudioProcessingUnitType { fn from((protocol, b): (UacProtocol, u16)) -> Self { match protocol { UacProtocol::Uac1 => match b { 0 => AudioProcessingUnitType::Undefined, 1 => AudioProcessingUnitType::UpDownMix, 2 => AudioProcessingUnitType::DolbyPrologic, 3 => AudioProcessingUnitType::StereoExtender3d, 4 => AudioProcessingUnitType::Reverberation, 5 => AudioProcessingUnitType::Chorus, 6 => AudioProcessingUnitType::DynRangeComp, _ => AudioProcessingUnitType::Undefined, }, UacProtocol::Uac2 => match b { 0 => AudioProcessingUnitType::Undefined, 1 => AudioProcessingUnitType::UpDownMix, 2 => AudioProcessingUnitType::DolbyPrologic, 3 => AudioProcessingUnitType::StereoExtender, _ => AudioProcessingUnitType::Undefined, }, UacProtocol::Uac3 => match b { 0 => AudioProcessingUnitType::Undefined, 1 => AudioProcessingUnitType::UpDownMix, 2 => AudioProcessingUnitType::StereoExtender, 3 => AudioProcessingUnitType::MultiFunction, _ => AudioProcessingUnitType::Undefined, }, _ => AudioProcessingUnitType::Undefined, } } } impl fmt::Display for AudioProcessingUnitType { fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result { match self { AudioProcessingUnitType::Undefined => write!(f, "Undefined"), AudioProcessingUnitType::UpDownMix => write!(f, "Up/Down-mix"), AudioProcessingUnitType::DolbyPrologic => write!(f, "Dolby Prologic"), AudioProcessingUnitType::StereoExtender3d => write!(f, "3D Stereo Extender"), AudioProcessingUnitType::StereoExtender => write!(f, "Stereo Extender"), AudioProcessingUnitType::Reverberation => write!(f, "Reverberation"), AudioProcessingUnitType::Chorus => write!(f, "Chorus"), AudioProcessingUnitType::DynRangeComp => write!(f, "Dyn Range Comp"), AudioProcessingUnitType::MultiFunction => write!(f, "Multi-Function"), } } } /// UAC1: Up/Down-mix and Dolby Prologic proc unit descriptor extensions Table 4-9, Table 4-10. #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct AudioProcessingUnitExtended1 { pub nr_modes: u8, pub modes: Vec, } impl TryFrom<&[u8]> for AudioProcessingUnitExtended1 { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 3 { return Err(Error::new_descriptor_len( "AudioProcessingUnitExtended1", 3, value.len(), )); } let nr_modes = value[0]; let modes = (1..value.len()) .step_by(2) .map(|i| u16::from_le_bytes([value[i], value[i + 1]])) .collect(); Ok(AudioProcessingUnitExtended1 { nr_modes, modes }) } } impl From for Vec { fn from(val: AudioProcessingUnitExtended1) -> Self { let mut data = Vec::new(); data.push(val.nr_modes); for mode in val.modes { data.extend_from_slice(&mode.to_le_bytes()); } data } } /// UAC1: 4.3.2.6 Processing Unit Descriptor; Table 4-8. #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct ProcessingUnit1 { pub unit_id: u8, pub process_type: u16, pub nr_in_pins: u8, pub source_ids: Vec, pub nr_channels: u8, pub channel_config: u16, pub channel_names_index: u8, pub channel_names: Option, pub control_size: u8, pub controls: Vec, pub processing_index: u8, pub processing: Option, pub specific: Option, } impl TryFrom<&[u8]> for ProcessingUnit1 { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 10 { return Err(Error::new_descriptor_len( "ProcessingUnit1", 10, value.len(), )); } let nr_in_pins = value[3]; let control_size = *value.get(8 + nr_in_pins as usize).ok_or_else(|| { Error::new_descriptor_len("ProcessingUnit1", 10 + nr_in_pins as usize, value.len()) })?; let expected_length = 10 + nr_in_pins as usize + control_size as usize; if value.len() < expected_length { return Err(Error::new( ErrorKind::InvalidDescriptor, "ProcessingUnit1 descriptor too short for the number of pins and controls", )); } let specific = match value[1] { 1 | 2 => Some(AudioProcessingUnitExtended1::try_from( &value[expected_length..], )?), _ => None, }; Ok(ProcessingUnit1 { unit_id: value[0], process_type: u16::from_le_bytes([value[1], value[2]]), nr_in_pins, source_ids: value[4..4 + nr_in_pins as usize].to_vec(), nr_channels: value[4 + nr_in_pins as usize], channel_config: u16::from_le_bytes([ value[5 + nr_in_pins as usize], value[6 + nr_in_pins as usize], ]), channel_names_index: value[7 + nr_in_pins as usize], channel_names: None, control_size, controls: value [9 + nr_in_pins as usize..9 + nr_in_pins as usize + control_size as usize] .to_vec(), processing_index: value[expected_length - 1], processing: None, specific, }) } } impl From for Vec { fn from(val: ProcessingUnit1) -> Self { let mut data = Vec::new(); data.push(val.unit_id); data.extend_from_slice(&val.process_type.to_le_bytes()); data.push(val.nr_in_pins); data.extend_from_slice(&val.source_ids); data.push(val.nr_channels); data.extend_from_slice(&val.channel_config.to_le_bytes()); data.push(val.channel_names_index); data.push(val.control_size); data.extend_from_slice(&val.controls); if let Some(specific) = val.specific { let specific_data: Vec = specific.into(); data.extend_from_slice(&specific_data); } data.push(val.processing_index); data } } impl ProcessingUnit1 { /// Returns the [`AudioProcessingUnitType`] of the processing unit. pub fn processing_type(&self) -> AudioProcessingUnitType { (UacProtocol::Uac1, self.process_type).into() } } /// UAC2: 4.7.2.11.1 Up/Down-mix Processing Unit Descriptor; Table 4-21. #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct AudioProcessingUnit2UpDownMix { pub nr_modes: u8, pub modes: Vec, } impl TryFrom<&[u8]> for AudioProcessingUnit2UpDownMix { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 5 { return Err(Error::new_descriptor_len( "AudioProcessingUnit2UpDownMix", 5, value.len(), )); } let nr_modes = value[0]; let modes = (1..value.len()) .step_by(4) .map(|i| u32::from_le_bytes([value[i], value[i + 1], value[i + 2], value[i + 3]])) .collect(); Ok(AudioProcessingUnit2UpDownMix { nr_modes, modes }) } } impl From for Vec { fn from(val: AudioProcessingUnit2UpDownMix) -> Self { let mut data = Vec::new(); data.push(val.nr_modes); for mode in val.modes { data.extend_from_slice(&mode.to_le_bytes()); } data } } /// UAC2: 4.7.2.11.2 Dolby prologic Processing Unit Descriptor; Table 4-22. #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct AudioProcessingUnit2DolbyPrologic { pub nr_modes: u8, pub modes: Vec, } impl TryFrom<&[u8]> for AudioProcessingUnit2DolbyPrologic { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 5 { return Err(Error::new_descriptor_len( "AudioProcessingUnit2DolbyPrologic", 5, value.len(), )); } let nr_modes = value[0]; let modes = (1..value.len()) .step_by(4) .map(|i| u32::from_le_bytes([value[i], value[i + 1], value[i + 2], value[i + 3]])) .collect(); Ok(AudioProcessingUnit2DolbyPrologic { nr_modes, modes }) } } impl From for Vec { fn from(val: AudioProcessingUnit2DolbyPrologic) -> Self { let mut data = Vec::new(); data.push(val.nr_modes); for mode in val.modes { data.extend_from_slice(&mode.to_le_bytes()); } data } } #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] #[serde(rename_all = "kebab-case")] pub enum AudioProcessingUnit2Specific { UpDownMix(AudioProcessingUnit2UpDownMix), DolbyPrologic(AudioProcessingUnit2DolbyPrologic), } impl From for Vec { fn from(val: AudioProcessingUnit2Specific) -> Self { match val { AudioProcessingUnit2Specific::UpDownMix(up_down_mix) => up_down_mix.into(), AudioProcessingUnit2Specific::DolbyPrologic(dolby_prologic) => dolby_prologic.into(), } } } /// UAC3: 4.5.2.10.1 Up/Down-mix Processing Unit Descriptor; Table 4-39. #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct AudioProcessingUnit3UpDownMix { pub controls: u32, pub nr_modes: u8, pub cluster_descr_ids: Vec, } impl TryFrom<&[u8]> for AudioProcessingUnit3UpDownMix { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 7 { return Err(Error::new_descriptor_len( "AudioProcessingUnit3UpDownMix", 7, value.len(), )); } let nr_modes = value[4]; let cluster_descr_ids = (5..value.len()) .step_by(2) .map(|i| u16::from_le_bytes([value[i], value[i + 1]])) .collect(); Ok(AudioProcessingUnit3UpDownMix { controls: u32::from_le_bytes([value[0], value[1], value[2], value[3]]), nr_modes, cluster_descr_ids, }) } } impl From for Vec { fn from(val: AudioProcessingUnit3UpDownMix) -> Self { let mut data = Vec::new(); data.extend_from_slice(&val.controls.to_le_bytes()); data.push(val.nr_modes); for cluster_descr_id in val.cluster_descr_ids { data.extend_from_slice(&cluster_descr_id.to_le_bytes()); } data } } /// UAC3: 4.5.2.10.2 Stereo Extender Processing Unit Descriptor; Table 4-40. #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct AudioProcessingUnit3StereoExtender { pub controls: u32, } impl TryFrom<&[u8]> for AudioProcessingUnit3StereoExtender { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 4 { return Err(Error::new_descriptor_len( "AudioProcessingUnit3StereoExtender", 4, value.len(), )); } Ok(AudioProcessingUnit3StereoExtender { controls: u32::from_le_bytes([value[0], value[1], value[2], value[3]]), }) } } impl From for Vec { fn from(val: AudioProcessingUnit3StereoExtender) -> Self { val.controls.to_le_bytes().to_vec() } } /// UAC3: 4.5.2.10.3 Multi Function Processing Unit Descriptor; Table 4-41. #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct AudioProcessingUnit3MultiFunction { pub controls: u32, pub cluster_descr_id: u16, pub algorithms: u32, } impl TryFrom<&[u8]> for AudioProcessingUnit3MultiFunction { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 10 { return Err(Error::new_descriptor_len( "AudioProcessingUnit3MultiFunction", 10, value.len(), )); } Ok(AudioProcessingUnit3MultiFunction { controls: u32::from_le_bytes([value[0], value[1], value[2], value[3]]), cluster_descr_id: u16::from_le_bytes([value[4], value[5]]), algorithms: u32::from_le_bytes([value[6], value[7], value[8], value[9]]), }) } } impl From for Vec { fn from(val: AudioProcessingUnit3MultiFunction) -> Self { let mut data = Vec::new(); data.extend_from_slice(&val.controls.to_le_bytes()); data.extend_from_slice(&val.cluster_descr_id.to_le_bytes()); data.extend_from_slice(&val.algorithms.to_le_bytes()); data } } #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] #[serde(rename_all = "kebab-case")] pub enum AudioProcessingUnit3Specific { UpDownMix(AudioProcessingUnit3UpDownMix), StereoExtender(AudioProcessingUnit3StereoExtender), MultiFunction(AudioProcessingUnit3MultiFunction), } impl From for Vec { fn from(val: AudioProcessingUnit3Specific) -> Self { match val { AudioProcessingUnit3Specific::UpDownMix(up_down_mix) => up_down_mix.into(), AudioProcessingUnit3Specific::StereoExtender(stereo_extender) => stereo_extender.into(), AudioProcessingUnit3Specific::MultiFunction(multi_function) => multi_function.into(), } } } /// UAC2: 4.7.2.11 Processing Unit Descriptor; Table 4-20. #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct ProcessingUnit2 { pub unit_id: u8, pub process_type: u16, pub nr_in_pins: u8, pub source_ids: Vec, pub nr_channels: u8, pub channel_config: u32, pub channel_names_index: u8, pub channel_names: Option, pub controls: u16, pub processing_index: u8, pub processing: Option, pub specific: Option, } impl TryFrom<&[u8]> for ProcessingUnit2 { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 13 { return Err(Error::new_descriptor_len( "ProcessingUnit2", 13, value.len(), )); } let nr_in_pins = value[3] as usize; let expected_length = 13 + nr_in_pins; if value.len() < expected_length { return Err(Error::new( ErrorKind::InvalidDescriptor, "ProcessingUnit2 descriptor too short for the number of pins and controls", )); } let specific = match value[1] { 1 => Some(AudioProcessingUnit2Specific::UpDownMix( AudioProcessingUnit2UpDownMix::try_from(&value[expected_length..])?, )), 2 => Some(AudioProcessingUnit2Specific::DolbyPrologic( AudioProcessingUnit2DolbyPrologic::try_from(&value[expected_length..])?, )), _ => None, }; Ok(ProcessingUnit2 { unit_id: value[0], process_type: u16::from_le_bytes([value[1], value[2]]), nr_in_pins: nr_in_pins as u8, source_ids: value[4..4 + nr_in_pins].to_vec(), nr_channels: value[4 + nr_in_pins], channel_config: u32::from_le_bytes([ value[5 + nr_in_pins], value[6 + nr_in_pins], value[7 + nr_in_pins], value[8 + nr_in_pins], ]), channel_names_index: value[9 + nr_in_pins], channel_names: None, controls: u16::from_le_bytes([value[10 + nr_in_pins], value[11 + nr_in_pins]]), processing_index: value[12 + nr_in_pins], processing: None, specific, }) } } impl From for Vec { fn from(val: ProcessingUnit2) -> Self { let mut data = Vec::new(); data.push(val.unit_id); data.extend_from_slice(&val.process_type.to_le_bytes()); data.push(val.nr_in_pins); data.extend_from_slice(&val.source_ids); data.push(val.nr_channels); data.extend_from_slice(&val.channel_config.to_le_bytes()); data.push(val.channel_names_index); data.extend_from_slice(&val.controls.to_le_bytes()); if let Some(specific) = val.specific { let specific_data: Vec = specific.into(); data.extend_from_slice(&specific_data); } data.push(val.processing_index); data } } impl ProcessingUnit2 { /// Returns the [`AudioProcessingUnitType`] of the processing unit. pub fn processing_type(&self) -> AudioProcessingUnitType { (UacProtocol::Uac2, self.process_type).into() } } #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] #[serde(rename_all = "kebab-case")] pub enum AudioProcessingMultiFunction { AlgorithmUndefined, BeamForming, AcousticEchoCancellation, ActiveNoiseCancellation, BlindSourceSeparation, NoiseSuppression, } impl std::fmt::Display for AudioProcessingMultiFunction { fn fmt(&self, f: &mut std::fmt::Formatter) -> std::fmt::Result { if f.alternate() { match self { AudioProcessingMultiFunction::AlgorithmUndefined => { write!(f, "Algorithm Undefined.") } AudioProcessingMultiFunction::BeamForming => write!(f, "Beam Forming."), AudioProcessingMultiFunction::AcousticEchoCancellation => { write!(f, "Acoustic Echo Cancellation.") } AudioProcessingMultiFunction::ActiveNoiseCancellation => { write!(f, "Active Noise Cancellation.") } AudioProcessingMultiFunction::BlindSourceSeparation => { write!(f, "Blind Source Separation.") } AudioProcessingMultiFunction::NoiseSuppression => { write!(f, "Noise Suppression/Reduction.") } } } else { match self { AudioProcessingMultiFunction::AlgorithmUndefined => { write!(f, "Algorithm Undefined") } AudioProcessingMultiFunction::BeamForming => write!(f, "Beam Forming"), AudioProcessingMultiFunction::AcousticEchoCancellation => { write!(f, "Acoustic Echo Cancellation") } AudioProcessingMultiFunction::ActiveNoiseCancellation => { write!(f, "Active Noise Cancellation") } AudioProcessingMultiFunction::BlindSourceSeparation => { write!(f, "Blind Source Separation") } AudioProcessingMultiFunction::NoiseSuppression => { write!(f, "Noise Suppression/Reduction") } } } } } impl AudioProcessingMultiFunction { /// Returns the [`AudioProcessingMultiFunction`]s supported from the bitmap value pub fn functions_from_bitmap(bitmap: u32) -> Vec { let mut functions = Vec::new(); if bitmap & 0x01 != 0 { functions.push(AudioProcessingMultiFunction::AlgorithmUndefined); } if bitmap & 0x02 != 0 { functions.push(AudioProcessingMultiFunction::BeamForming); } if bitmap & 0x04 != 0 { functions.push(AudioProcessingMultiFunction::AcousticEchoCancellation); } if bitmap & 0x08 != 0 { functions.push(AudioProcessingMultiFunction::ActiveNoiseCancellation); } if bitmap & 0x10 != 0 { functions.push(AudioProcessingMultiFunction::BlindSourceSeparation); } if bitmap & 0x20 != 0 { functions.push(AudioProcessingMultiFunction::NoiseSuppression); } functions } } /// UAC3: 4.5.2.10 Processing Unit Descriptor; Table 4-38. #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct ProcessingUnit3 { pub unit_id: u8, pub process_type: u16, pub nr_in_pins: u8, pub source_ids: Vec, pub processing_descr_str: u16, pub specific: Option, } impl TryFrom<&[u8]> for ProcessingUnit3 { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 7 { return Err(Error::new_descriptor_len("ProcessingUnit3", 7, value.len())); } let nr_in_pins = value[3]; let expected_length = 7 + nr_in_pins as usize; if value.len() < expected_length { return Err(Error::new( ErrorKind::InvalidArg, "ProcessingUnit3 descriptor too short for the number of pins and controls", )); } let specific = match value[1] { 1 => Some(AudioProcessingUnit3Specific::UpDownMix( AudioProcessingUnit3UpDownMix::try_from(&value[expected_length..])?, )), 2 => Some(AudioProcessingUnit3Specific::StereoExtender( AudioProcessingUnit3StereoExtender::try_from(&value[expected_length..])?, )), 3 => Some(AudioProcessingUnit3Specific::MultiFunction( AudioProcessingUnit3MultiFunction::try_from(&value[expected_length..])?, )), _ => None, }; Ok(ProcessingUnit3 { unit_id: value[0], process_type: u16::from_le_bytes([value[1], value[2]]), nr_in_pins, source_ids: value[4..4 + nr_in_pins as usize].to_vec(), processing_descr_str: u16::from_le_bytes([ value[5 + nr_in_pins as usize], value[6 + nr_in_pins as usize], ]), specific, }) } } impl From for Vec { fn from(val: ProcessingUnit3) -> Self { let mut data = Vec::new(); data.push(val.unit_id); data.extend_from_slice(&val.process_type.to_le_bytes()); data.push(val.nr_in_pins); data.extend_from_slice(&val.source_ids); data.extend_from_slice(&val.processing_descr_str.to_le_bytes()); if let Some(specific) = val.specific { let specific_data: Vec = specific.into(); data.extend_from_slice(&specific_data); } data } } impl ProcessingUnit3 { /// Returns the [`AudioProcessingUnitType`] of the processing unit. pub fn processing_type(&self) -> AudioProcessingUnitType { (UacProtocol::Uac3, self.process_type).into() } /// Returns the [`AudioProcessingMultiFunction`] supported by the processing unit. pub fn algorithms(&self) -> Option> { match &self.specific { Some(AudioProcessingUnit3Specific::MultiFunction( AudioProcessingUnit3MultiFunction { algorithms, .. }, )) => Some(AudioProcessingMultiFunction::functions_from_bitmap( *algorithms, )), _ => None, } } } /// UAC2: 4.7.2.10 Effect Unit Descriptor; Table 4-15. #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct EffectUnit2 { pub unit_id: u8, pub effect_type: u16, pub source_id: u8, pub controls: Vec, pub effect_index: u8, pub effect: Option, } impl TryFrom<&[u8]> for EffectUnit2 { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 9 { return Err(Error::new_descriptor_len("EffectUnit2", 9, value.len())); } let controls = (4..value.len() - 1) .step_by(4) .map(|i| u32::from_le_bytes([value[i], value[i + 1], value[i + 2], value[i + 3]])) .collect(); Ok(EffectUnit2 { unit_id: value[0], effect_type: u16::from_le_bytes([value[1], value[2]]), source_id: value[3], controls, effect_index: value[value.len() - 1], effect: None, }) } } impl From for Vec { fn from(val: EffectUnit2) -> Self { let mut data = Vec::new(); data.push(val.unit_id); data.extend_from_slice(&val.effect_type.to_le_bytes()); data.push(val.source_id); for control in val.controls { data.extend_from_slice(&control.to_le_bytes()); } data.push(val.effect_index); data } } /// UAC3: 4.5.2.9 Effect Unit Descriptor; Table 4-33. #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct EffectUnit3 { pub unit_id: u8, pub effect_type: u16, pub source_id: u8, pub controls: Vec, pub effect_descr_str: u16, } impl TryFrom<&[u8]> for EffectUnit3 { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 10 { return Err(Error::new_descriptor_len("EffectUnit3", 10, value.len())); } let controls = (4..value.len() - 2) .step_by(4) .map(|i| u32::from_le_bytes([value[i], value[i + 1], value[i + 2], value[i + 3]])) .collect(); Ok(EffectUnit3 { unit_id: value[0], effect_type: u16::from_le_bytes([value[1], value[2]]), source_id: value[3], controls, effect_descr_str: u16::from_le_bytes([value[value.len() - 2], value[value.len() - 1]]), }) } } impl From for Vec { fn from(val: EffectUnit3) -> Self { let mut data = Vec::new(); data.push(val.unit_id); data.extend_from_slice(&val.effect_type.to_le_bytes()); data.push(val.source_id); for control in val.controls { data.extend_from_slice(&control.to_le_bytes()); } data.extend_from_slice(&val.effect_descr_str.to_le_bytes()); data } } /// UAC1: 4.3.2.5 Feature Unit Descriptor; Table 4-7. #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct FeatureUnit1 { pub unit_id: u8, pub source_id: u8, pub control_size: u8, pub controls: Vec, pub feature_index: u8, pub feature: Option, } impl TryFrom<&[u8]> for FeatureUnit1 { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 4 { return Err(Error::new_descriptor_len("FeatureUnit1", 4, value.len())); } let control_size = value[2]; let expected_length = 4 + control_size as usize; if value.len() < expected_length { return Err(Error::new( ErrorKind::InvalidDescriptor, "Audio Feature Unit 1 descriptor too short for the number of controls", )); } let controls = value[3..(3 + control_size as usize)].to_vec(); Ok(FeatureUnit1 { unit_id: value[0], source_id: value[1], control_size, controls, feature_index: value[3 + control_size as usize], feature: None, }) } } impl From for Vec { fn from(val: FeatureUnit1) -> Self { let mut data = Vec::new(); data.push(val.unit_id); data.push(val.source_id); data.push(val.control_size); data.extend_from_slice(&val.controls); data.push(val.feature_index); data } } /// UAC2: 4.7.2.8 Feature Unit Descriptor; Table 4-13. #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct FeatureUnit2 { pub unit_id: u8, pub source_id: u8, pub controls: [u8; 4], pub feature_index: u8, pub feature: Option, } impl TryFrom<&[u8]> for FeatureUnit2 { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 8 { return Err(Error::new_descriptor_len("FeatureUnit2", 8, value.len())); } Ok(FeatureUnit2 { unit_id: value[0], source_id: value[1], controls: value[2..6].try_into().unwrap(), feature_index: value[7], feature: None, }) } } impl From for Vec { fn from(val: FeatureUnit2) -> Self { let mut data = Vec::new(); data.push(val.unit_id); data.push(val.source_id); data.extend_from_slice(&val.controls); data.push(val.feature_index); data } } /// UAC3: 4.5.2.7 Feature Unit Descriptor; Table 4-31. #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct FeatureUnit3 { pub unit_id: u8, pub source_id: u8, pub controls: [u8; 4], pub feature_descr_str: u16, } impl TryFrom<&[u8]> for FeatureUnit3 { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 8 { return Err(Error::new_descriptor_len("FeatureUnit3", 8, value.len())); } Ok(FeatureUnit3 { unit_id: value[0], source_id: value[1], controls: value[2..6].try_into().unwrap(), feature_descr_str: u16::from_le_bytes([value[6], value[7]]), }) } } impl From for Vec { fn from(val: FeatureUnit3) -> Self { let mut data = Vec::new(); data.push(val.unit_id); data.push(val.source_id); data.extend_from_slice(&val.controls); data.extend_from_slice(&val.feature_descr_str.to_le_bytes()); data } } /// UAC1: 4.3.2.7 Extension Unit Descriptor; Table 4-15. #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct ExtensionUnit1 { pub unit_id: u8, pub extension_code: u16, pub nr_in_pins: u8, pub source_ids: Vec, pub nr_channels: u8, pub channel_config: u16, pub channel_names_index: u8, pub channel_names: Option, pub control_size: u8, pub controls: Vec, pub extension_index: u8, pub extension: Option, } impl TryFrom<&[u8]> for ExtensionUnit1 { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 10 { return Err(Error::new_descriptor_len("ExtensionUnit1", 10, value.len())); } let nr_in_pins = value[3] as usize; let control_size = value[8 + nr_in_pins]; let expected_length = 10 + nr_in_pins + control_size as usize; if value.len() < expected_length { return Err(Error::new( ErrorKind::InvalidDescriptor, "ExtensionUnit1 descriptor too short for the number of pins and controls", )); } let source_ids = value[4..(4 + nr_in_pins)].to_vec(); let controls = value[(9 + nr_in_pins)..(9 + nr_in_pins + control_size as usize)].to_vec(); Ok(ExtensionUnit1 { unit_id: value[0], extension_code: u16::from_le_bytes([value[1], value[2]]), nr_in_pins: value[3], source_ids, nr_channels: value[4 + nr_in_pins], channel_config: u16::from_le_bytes([value[5 + nr_in_pins], value[6 + nr_in_pins]]), channel_names_index: value[7 + nr_in_pins], channel_names: None, control_size, controls, extension_index: value[expected_length - 1], extension: None, }) } } impl From for Vec { fn from(val: ExtensionUnit1) -> Self { let mut data = Vec::new(); data.push(val.unit_id); data.extend_from_slice(&val.extension_code.to_le_bytes()); data.push(val.nr_in_pins); data.extend_from_slice(&val.source_ids); data.push(val.nr_channels); data.extend_from_slice(&val.channel_config.to_le_bytes()); data.push(val.channel_names_index); data.push(val.control_size); data.extend_from_slice(&val.controls); data.push(val.extension_index); data } } /// UAC2: 4.7.2.12 Extension Unit Descriptor; Table 4-24. #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct ExtensionUnit2 { pub unit_id: u8, pub extension_code: u16, pub nr_in_pins: u8, pub source_ids: Vec, pub nr_channels: u8, pub channel_config: u32, pub channel_names_index: u8, pub channel_names: Option, pub controls: u8, pub extension_index: u8, pub extension: Option, } impl TryFrom<&[u8]> for ExtensionUnit2 { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 12 { return Err(Error::new_descriptor_len("ExtensionUnit2", 12, value.len())); } let nr_in_pins = value[3] as usize; let expected_length = 12 + nr_in_pins; if value.len() < expected_length { return Err(Error::new( ErrorKind::InvalidDescriptor, "ExtensionUnit2 descriptor too short for the number of pins and controls", )); } let source_ids = value[4..(4 + nr_in_pins)].to_vec(); Ok(ExtensionUnit2 { unit_id: value[0], extension_code: u16::from_le_bytes([value[1], value[2]]), nr_in_pins: value[3], source_ids, nr_channels: value[4 + nr_in_pins], channel_config: u32::from_le_bytes([ value[5 + nr_in_pins], value[6 + nr_in_pins], value[7 + nr_in_pins], value[8 + nr_in_pins], ]), channel_names_index: value[9 + nr_in_pins], channel_names: None, controls: value[10 + nr_in_pins], extension_index: value[11 + nr_in_pins], extension: None, }) } } impl From for Vec { fn from(val: ExtensionUnit2) -> Self { let mut data = Vec::new(); data.push(val.unit_id); data.extend_from_slice(&val.extension_code.to_le_bytes()); data.push(val.nr_in_pins); data.extend_from_slice(&val.source_ids); data.push(val.nr_channels); data.extend_from_slice(&val.channel_config.to_le_bytes()); data.push(val.channel_names_index); data.push(val.controls); data.push(val.extension_index); data } } /// UAC3: 4.5.2.11 Extension Unit Descriptor; Table 4-42. #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct ExtensionUnit3 { pub unit_id: u8, pub extension_code: u16, pub nr_in_pins: u8, pub source_ids: Vec, pub extension_descr_str: u16, pub controls: u32, pub cluster_descr_id: u16, } impl TryFrom<&[u8]> for ExtensionUnit3 { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 12 { return Err(Error::new_descriptor_len("ExtensionUnit3", 12, value.len())); } let nr_in_pins = value[3] as usize; let expected_length = 12 + nr_in_pins; if value.len() < expected_length { return Err(Error::new( ErrorKind::InvalidDescriptor, "ExtensionUnit3 descriptor too short for the number of pins and controls", )); } let source_ids = value[4..(4 + nr_in_pins)].to_vec(); Ok(ExtensionUnit3 { unit_id: value[0], extension_code: u16::from_le_bytes([value[1], value[2]]), nr_in_pins: value[3], source_ids, extension_descr_str: u16::from_le_bytes([value[4 + nr_in_pins], value[5 + nr_in_pins]]), controls: u32::from_le_bytes([ value[6 + nr_in_pins], value[7 + nr_in_pins], value[8 + nr_in_pins], value[9 + nr_in_pins], ]), cluster_descr_id: u16::from_le_bytes([value[10 + nr_in_pins], value[11 + nr_in_pins]]), }) } } impl From for Vec { fn from(val: ExtensionUnit3) -> Self { let mut data = Vec::new(); data.push(val.unit_id); data.extend_from_slice(&val.extension_code.to_le_bytes()); data.push(val.nr_in_pins); data.extend_from_slice(&val.source_ids); data.extend_from_slice(&val.extension_descr_str.to_le_bytes()); data.extend_from_slice(&val.controls.to_le_bytes()); data.extend_from_slice(&val.cluster_descr_id.to_le_bytes()); data } } /// UAC2: 4.7.2.1 Clock Source Descriptor; Table 4-6. #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct ClockSource2 { pub clock_id: u8, pub attributes: u8, pub controls: u8, pub assoc_terminal: u8, pub clock_source_index: u8, pub clock_source: Option, } impl TryFrom<&[u8]> for ClockSource2 { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 5 { return Err(Error::new_descriptor_len("ClockSource2", 5, value.len())); } Ok(ClockSource2 { clock_id: value[0], attributes: value[1], controls: value[2], assoc_terminal: value[3], clock_source_index: value[4], clock_source: None, }) } } impl From for Vec { fn from(val: ClockSource2) -> Self { vec![ val.clock_id, val.attributes, val.controls, val.assoc_terminal, val.clock_source_index, ] } } /// UAC3: 4.5.2.12 Clock Source Descriptor; Table 4-43. #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct ClockSource3 { pub clock_id: u8, pub attributes: u8, pub controls: u32, pub reference_terminal: u8, pub clock_source_str: u16, } impl TryFrom<&[u8]> for ClockSource3 { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 9 { return Err(Error::new_descriptor_len("ClockSource3", 9, value.len())); } Ok(ClockSource3 { clock_id: value[0], attributes: value[1], controls: u32::from_le_bytes([value[2], value[3], value[4], value[5]]), reference_terminal: value[6], clock_source_str: u16::from_le_bytes([value[7], value[8]]), }) } } impl From for Vec { fn from(val: ClockSource3) -> Self { let mut data = Vec::new(); data.push(val.clock_id); data.push(val.attributes); data.extend_from_slice(&val.controls.to_le_bytes()); data.push(val.reference_terminal); data.extend_from_slice(&val.clock_source_str.to_le_bytes()); data } } /// UAC2: 4.7.2.2 Clock Selector Descriptor; Table 4-7. #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct ClockSelector2 { pub clock_id: u8, pub nr_in_pins: u8, pub csource_ids: Vec, pub controls: u8, pub clock_selector_index: u8, pub clock_selector: Option, } impl TryFrom<&[u8]> for ClockSelector2 { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 4 { return Err(Error::new_descriptor_len("ClockSelector2", 4, value.len())); } let nr_in_pins = value[1] as usize; let expected_length = 4 + nr_in_pins; if value.len() < expected_length { return Err(Error::new( ErrorKind::InvalidDescriptor, "ClockSelector2 descriptor too short for the number of pins and controls", )); } let csource_ids = value[2..(2 + nr_in_pins)].to_vec(); Ok(ClockSelector2 { clock_id: value[0], nr_in_pins: value[1], csource_ids, controls: value[2 + nr_in_pins], clock_selector_index: value[3 + nr_in_pins], clock_selector: None, }) } } impl From for Vec { fn from(val: ClockSelector2) -> Self { let mut data = Vec::new(); data.push(val.clock_id); data.push(val.nr_in_pins); data.extend_from_slice(&val.csource_ids); data.push(val.controls); data.push(val.clock_selector_index); data } } /// UAC3: 4.5.2.13 Clock Selector Descriptor; Table 4-44. #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct ClockSelector3 { pub clock_id: u8, pub nr_in_pins: u8, pub csource_ids: Vec, pub controls: u32, pub cselector_descr_str: u16, } impl TryFrom<&[u8]> for ClockSelector3 { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 8 { return Err(Error::new_descriptor_len("ClockSelector3", 8, value.len())); } let nr_in_pins = value[1] as usize; let expected_length = 8 + nr_in_pins; if value.len() < expected_length { return Err(Error::new( ErrorKind::InvalidDescriptor, "ClockSelector3 descriptor too short for the number of pins and controls", )); } let csource_ids = value[2..(2 + nr_in_pins)].to_vec(); let controls = u32::from_le_bytes([ value[2 + nr_in_pins], value[3 + nr_in_pins], value[4 + nr_in_pins], value[5 + nr_in_pins], ]); Ok(ClockSelector3 { clock_id: value[0], nr_in_pins: value[1], csource_ids, controls, cselector_descr_str: u16::from_le_bytes([value[6 + nr_in_pins], value[7 + nr_in_pins]]), }) } } impl From for Vec { fn from(val: ClockSelector3) -> Self { let mut data = Vec::new(); data.push(val.clock_id); data.push(val.nr_in_pins); data.extend_from_slice(&val.csource_ids); data.extend_from_slice(&val.controls.to_le_bytes()); data.extend_from_slice(&val.cselector_descr_str.to_le_bytes()); data } } /// UAC2: 4.7.2.3 Clock Multiplier Descriptor; Table 4-8. #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct ClockMultiplier2 { pub clock_id: u8, pub csource_id: u8, pub controls: u8, pub clock_multiplier_index: u8, pub clock_multiplier: Option, } impl TryFrom<&[u8]> for ClockMultiplier2 { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 4 { return Err(Error::new_descriptor_len( "ClockMultiplier2", 4, value.len(), )); } Ok(ClockMultiplier2 { clock_id: value[0], csource_id: value[1], controls: value[2], clock_multiplier_index: value[3], clock_multiplier: None, }) } } impl From for Vec { fn from(val: ClockMultiplier2) -> Self { vec![ val.clock_id, val.csource_id, val.controls, val.clock_multiplier_index, ] } } /// UAC3: 4.5.2.14 Clock Multiplier Descriptor; Table 4-45. #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct ClockMultiplier3 { pub clock_id: u8, pub csource_id: u8, pub controls: u32, pub cmultiplier_descr_str: u16, } impl TryFrom<&[u8]> for ClockMultiplier3 { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 8 { return Err(Error::new_descriptor_len( "ClockMultiplier3", 8, value.len(), )); } Ok(ClockMultiplier3 { clock_id: value[0], csource_id: value[1], controls: u32::from_le_bytes([value[2], value[3], value[4], value[5]]), cmultiplier_descr_str: u16::from_le_bytes([value[6], value[7]]), }) } } impl From for Vec { fn from(val: ClockMultiplier3) -> Self { let mut data = Vec::new(); data.push(val.clock_id); data.push(val.csource_id); data.extend_from_slice(&val.controls.to_le_bytes()); data.extend_from_slice(&val.cmultiplier_descr_str.to_le_bytes()); data } } /// UAC2: 4.7.2.9 Sampling Rate Converter Descriptor; Table 4-14. #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct SampleRateConverter2 { pub unit_id: u8, pub source_id: u8, pub csource_in_id: u8, pub csource_out_id: u8, pub src_index: u8, pub src: Option, } impl TryFrom<&[u8]> for SampleRateConverter2 { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 5 { return Err(Error::new_descriptor_len( "SampleRateConverter2", 5, value.len(), )); } Ok(SampleRateConverter2 { unit_id: value[0], source_id: value[1], csource_in_id: value[2], csource_out_id: value[3], src_index: value[4], src: None, }) } } impl From for Vec { fn from(val: SampleRateConverter2) -> Self { vec![ val.unit_id, val.source_id, val.csource_in_id, val.csource_out_id, val.src_index, ] } } /// UAC3: 4.5.2.8 Sampling Rate Converter Descriptor; Table 4-32. #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct SampleRateConverter3 { pub unit_id: u8, pub source_id: u8, pub csource_in_id: u8, pub csource_out_id: u8, pub src_descr_str: u16, } impl TryFrom<&[u8]> for SampleRateConverter3 { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 6 { return Err(Error::new_descriptor_len( "SampleRateConverter3", 6, value.len(), )); } Ok(SampleRateConverter3 { unit_id: value[0], source_id: value[1], csource_in_id: value[2], csource_out_id: value[3], src_descr_str: u16::from_le_bytes([value[4], value[5]]), }) } } impl From for Vec { fn from(val: SampleRateConverter3) -> Self { let mut data = vec![ val.unit_id, val.source_id, val.csource_in_id, val.csource_out_id, ]; data.extend_from_slice(&val.src_descr_str.to_le_bytes()); data } } cyme-2.2.6/src/usb/descriptors/bos.rs000066400000000000000000000635671506545537300175660ustar00rootroot00000000000000//! Binary Object Store (BOS) descriptor types and capabilities parsing use serde::{Deserialize, Serialize}; use std::convert::TryFrom; use uuid::{uuid, Uuid}; use super::*; use crate::error::{self, Error, ErrorKind}; const WEBUSB_GUID: Uuid = uuid!("{3408b638-09a9-47a0-8bfd-a0768815b665}"); /// The Binary Object Store descriptor type codes as defined in the USB 3.0 spec. #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[repr(u8)] #[allow(missing_docs)] #[non_exhaustive] pub enum BosType { WirelessUsb = 0x01, Usb2Extension = 0x02, SuperSpeed = 0x03, ContainerId = 0x04, PlatformCapability = 0x05, SuperSpeedPlus = 0x0a, Billboard = 0x0d, BillboardAltMode = 0x0f, ConfigurationSummary = 0x10, Unknown(u8), } impl From for BosType { fn from(value: u8) -> Self { match value { 0x01 => BosType::WirelessUsb, 0x02 => BosType::Usb2Extension, 0x03 => BosType::SuperSpeed, 0x04 => BosType::ContainerId, 0x05 => BosType::PlatformCapability, 0x0a => BosType::SuperSpeedPlus, 0x0d => BosType::Billboard, 0x0f => BosType::BillboardAltMode, 0x10 => BosType::ConfigurationSummary, _ => BosType::Unknown(value), } } } impl From for u8 { fn from(value: BosType) -> Self { match value { BosType::WirelessUsb => 0x01, BosType::Usb2Extension => 0x02, BosType::SuperSpeed => 0x03, BosType::ContainerId => 0x04, BosType::PlatformCapability => 0x05, BosType::SuperSpeedPlus => 0x0a, BosType::Billboard => 0x0d, BosType::BillboardAltMode => 0x0f, BosType::ConfigurationSummary => 0x10, BosType::Unknown(v) => v, } } } #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub enum BosCapability { Generic(GenericCapability), Usb2Extension(ExtensionCapability), SuperSpeed(SuperSpeedCapability), SuperSpeedPlus(SuperSpeedPlusCapability), Billboard(BillboardCapability), BillboardAltMode(BillboardAltModeCapability), ConfigurationSummary(ConfigurationSummaryCapability), ContainerId(ContainerIdCapability), Platform(PlatformDeviceCompatibility), WebUsbPlatform(WebUsbPlatformCapability), } impl TryFrom<&[u8]> for BosCapability { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 3 { return Err(Error::new_descriptor_len("BosCapability", 3, value.len())); } match value[2].into() { BosType::Unknown(_) => Err(Error::new( ErrorKind::InvalidArg, "BOS capability descriptor has unknown capability type", )), BosType::Usb2Extension => Ok(BosCapability::Usb2Extension( ExtensionCapability::try_from(value)?, )), BosType::SuperSpeed => Ok(BosCapability::SuperSpeed(SuperSpeedCapability::try_from( value, )?)), BosType::SuperSpeedPlus => Ok(BosCapability::SuperSpeedPlus( SuperSpeedPlusCapability::try_from(value)?, )), BosType::Billboard => Ok(BosCapability::Billboard(BillboardCapability::try_from( value, )?)), BosType::BillboardAltMode => Ok(BosCapability::BillboardAltMode( BillboardAltModeCapability::try_from(value)?, )), BosType::ConfigurationSummary => Ok(BosCapability::ConfigurationSummary( ConfigurationSummaryCapability::try_from(value)?, )), BosType::ContainerId => Ok(BosCapability::ContainerId( ContainerIdCapability::try_from(value)?, )), BosType::PlatformCapability => { let pdc = PlatformDeviceCompatibility::try_from(value)?; // WebUSB is a special case of PlatformCapability with a specific GUID: https://developer.chrome.com/docs/capabilities/build-for-webusb if pdc.guid == WEBUSB_GUID { Ok(BosCapability::WebUsbPlatform( WebUsbPlatformCapability::try_from(value)?, )) } else { Ok(BosCapability::Platform(pdc)) } } _ => Ok(BosCapability::Generic(GenericCapability::try_from(value)?)), } } } impl From for Vec { fn from(bcd: BosCapability) -> Self { match bcd { BosCapability::Generic(gcd) => Vec::::from(gcd), BosCapability::Usb2Extension(ebd) => Vec::::from(ebd), BosCapability::SuperSpeed(ssc) => Vec::::from(ssc), BosCapability::SuperSpeedPlus(sspc) => Vec::::from(sspc), BosCapability::Billboard(bc) => Vec::::from(bc), BosCapability::BillboardAltMode(bac) => Vec::::from(bac), BosCapability::ConfigurationSummary(ucs) => Vec::::from(ucs), BosCapability::ContainerId(cic) => Vec::::from(cic), BosCapability::Platform(pdc) => Vec::::from(pdc), BosCapability::WebUsbPlatform(wpc) => Vec::::from(wpc), } } } #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct BinaryObjectStoreDescriptor { pub length: u8, pub descriptor_type: u8, pub total_length: u16, pub num_device_capabilities: u8, pub capabilities: Vec, } impl TryFrom<&[u8]> for BinaryObjectStoreDescriptor { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 5 { return Err(Error::new_descriptor_len( "BinaryObjectStoreDescriptor", 5, value.len(), )); } let length = value[0]; let descriptor_type = value[1]; let total_length = u16::from_le_bytes([value[2], value[3]]); let num_device_capabilities = value[4]; if value.len() < total_length as usize { return Err(Error::new_descriptor_len( "BinaryObjectStoreDescriptor total_length", total_length as usize, value.len(), )); } if total_length <= 5 && value[4] > 0 { return Err(Error::new( ErrorKind::InvalidDescriptor, "Binary Object Store descriptor reported num_device_capabilities but no data", )); } let mut capabilities = Vec::new(); let mut offset = 5; // probably a Rustier way to do this with drain but this works.. // already checked that the total length is correct while offset < total_length as usize { let cd_len = value[offset] as usize; if value.len() < offset + cd_len { // break if we're going to read past the end of the buffer rather than Err so all is not lost... log::warn!("BOS capability has invalid length, breaking"); break; } match BosCapability::try_from(&value[offset..offset + cd_len]) { Ok(c) => capabilities.push(c), // allow to continue parsing even if one fails Err(e) => log::warn!("Failed to parse BOS capability: {e:?}"), } offset += cd_len; } Ok(BinaryObjectStoreDescriptor { length, descriptor_type, total_length, num_device_capabilities, capabilities, }) } } impl From for Vec { fn from(bosd: BinaryObjectStoreDescriptor) -> Self { let mut ret = Vec::new(); ret.push(bosd.length); ret.push(bosd.descriptor_type); ret.extend(bosd.total_length.to_le_bytes()); ret.push(bosd.num_device_capabilities); for cap in bosd.capabilities { ret.extend(Vec::::from(cap)); } ret } } #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct GenericCapability { pub length: u8, pub descriptor_type: u8, pub capability_type: BosType, pub data: Vec, } impl TryFrom<&[u8]> for GenericCapability { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 3 { return Err(Error::new_descriptor_len( "GenericCapability", 3, value.len(), )); } Ok(GenericCapability { length: value[0], descriptor_type: value[1], capability_type: value[2].into(), data: value[3..].to_vec(), }) } } impl From for Vec { fn from(gbd: GenericCapability) -> Self { let mut ret = Vec::new(); ret.push(gbd.length); ret.push(gbd.descriptor_type); ret.push(u8::from(gbd.capability_type)); ret.extend(gbd.data); ret } } #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct PlatformDeviceCompatibility { pub length: u8, pub descriptor_type: u8, pub compatibility_type: u8, pub reserved: u8, pub guid: Uuid, pub data: Vec, } impl TryFrom<&[u8]> for PlatformDeviceCompatibility { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 20 { return Err(Error::new_descriptor_len( "PlatformDeviceCompatibility", 20, value.len(), )); } Ok(PlatformDeviceCompatibility { length: value[0], descriptor_type: value[1], compatibility_type: value[2], reserved: value[3], guid: Uuid::from_slice_le(&value[4..20]).map_err(|_| { Error::new( ErrorKind::InvalidDescriptor, "Platform Device Compatibility descriptor has invalid GUID", ) })?, data: value[20..].to_vec(), }) } } impl From for Vec { fn from(pdc: PlatformDeviceCompatibility) -> Self { let mut ret = vec![ pdc.length, pdc.descriptor_type, pdc.compatibility_type, pdc.reserved, ]; ret.extend(pdc.guid.to_bytes_le()); ret.extend(pdc.data); ret } } #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct WebUsbPlatformCapability { pub platform: PlatformDeviceCompatibility, pub version: Version, pub vendor_code: u8, pub landing_page_index: u8, pub url: Option, } impl TryFrom<&[u8]> for WebUsbPlatformCapability { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 24 { return Err(Error::new_descriptor_len( "WebUsbPlatformCapability", 24, value.len(), )); } let platform = PlatformDeviceCompatibility::try_from(value)?; Ok(WebUsbPlatformCapability { platform, version: Version::from_bcd(u16::from_le_bytes([value[20], value[21]])), vendor_code: value[22], landing_page_index: value[23], url: None, }) } } impl From for Vec { fn from(wpc: WebUsbPlatformCapability) -> Self { // platform has all the data in data field wpc.platform.into() } } #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct ExtensionCapability { pub length: u8, pub descriptor_type: u8, pub capability_type: BosType, pub attributes: u32, } impl TryFrom<&[u8]> for ExtensionCapability { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 7 { return Err(Error::new_descriptor_len( "ExtensionCapability", 7, value.len(), )); } Ok(ExtensionCapability { length: value[0], descriptor_type: value[1], capability_type: value[2].into(), attributes: u32::from_le_bytes([value[3], value[4], value[5], value[6]]), }) } } impl From for Vec { fn from(ebd: ExtensionCapability) -> Self { let mut ret = Vec::new(); ret.push(ebd.length); ret.push(ebd.descriptor_type); ret.push(u8::from(ebd.capability_type)); ret.extend(ebd.attributes.to_le_bytes()); ret } } #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct SuperSpeedCapability { pub length: u8, pub descriptor_type: u8, pub capability_type: BosType, pub attributes: u8, pub speed_supported: u16, pub functionality_supported: u8, pub u1_device_exit_latency: u8, pub u2_device_exit_latency: u16, } impl TryFrom<&[u8]> for SuperSpeedCapability { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 10 { return Err(Error::new_descriptor_len( "SuperSpeedCapability", 10, value.len(), )); } Ok(SuperSpeedCapability { length: value[0], descriptor_type: value[1], capability_type: value[2].into(), attributes: value[3], speed_supported: u16::from_le_bytes([value[4], value[5]]), functionality_supported: value[6], u1_device_exit_latency: value[7], u2_device_exit_latency: u16::from_le_bytes([value[8], value[9]]), }) } } impl From for Vec { fn from(ssc: SuperSpeedCapability) -> Self { let mut ret = vec![ ssc.length, ssc.descriptor_type, u8::from(ssc.capability_type), ssc.attributes, ]; ret.extend(ssc.speed_supported.to_le_bytes()); ret.push(ssc.functionality_supported); ret.push(ssc.u1_device_exit_latency); ret.extend(ssc.u2_device_exit_latency.to_le_bytes()); ret } } #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct SuperSpeedPlusCapability { pub length: u8, pub descriptor_type: u8, pub capability_type: BosType, pub attributes: u32, pub functionality_supported: u16, pub sublink_attributes: Vec, } impl TryFrom<&[u8]> for SuperSpeedPlusCapability { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 12 { return Err(Error::new_descriptor_len( "SuperSpeedPlusCapability", 12, value.len(), )); } let sublink_speed_attr_count = (value[4] & 0x1f) as usize + 1; let mut sublink_attributes = Vec::with_capacity(sublink_speed_attr_count); if value.len() < 12 + sublink_speed_attr_count * 4 { return Err(Error::new_descriptor_len( "SuperSpeedPlusCapability sublink_attributes", 12 + sublink_speed_attr_count * 4, value.len(), )); } for chunk in value[12..12 + sublink_speed_attr_count].chunks_exact(4) { sublink_attributes.push(u32::from_le_bytes([chunk[0], chunk[1], chunk[2], chunk[3]])); } Ok(SuperSpeedPlusCapability { length: value[0], descriptor_type: value[1], capability_type: value[2].into(), attributes: u32::from_le_bytes([value[4], value[5], value[6], value[7]]), functionality_supported: u16::from_le_bytes([value[8], value[9]]), sublink_attributes, }) } } impl From for Vec { fn from(sspc: SuperSpeedPlusCapability) -> Self { let mut ret = Vec::new(); ret.push(sspc.length); ret.push(sspc.descriptor_type); ret.push(u8::from(sspc.capability_type)); ret.extend(sspc.attributes.to_le_bytes()); ret.extend(sspc.functionality_supported.to_le_bytes()); for attr in sspc.sublink_attributes { ret.extend(attr.to_le_bytes()); } ret } } impl SuperSpeedPlusCapability { /// Returns the number of sublink speed attributes supported by this device. pub fn sublink_speed_attribute_count(&self) -> usize { self.attributes as usize & (0x1f + 1) } /// Returns the number of sublink speed IDs supported by this device. pub fn sublink_speed_id_count(&self) -> usize { ((self.attributes as usize) >> 5) & (0xf + 1) } /// Returns the minimum functional speed attribute ID supported by this device. pub fn functional_speed_attribute_id(&self) -> usize { (self.functionality_supported as usize) & 0x0f } /// Returns the minimum number of functional RX lanes supported by this device. pub fn functional_rx_lanes(&self) -> usize { ((self.functionality_supported as usize) >> 8) & 0x0f } /// Returns the minimum number of functional TX lanes supported by this device. pub fn functional_tx_lanes(&self) -> usize { ((self.functionality_supported as usize) >> 12) & 0x0f } } #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct BillboardCapability { pub length: u8, pub descriptor_type: u8, pub capability_type: BosType, pub additional_info_url_index: u8, pub additional_info_url: Option, pub number_of_alternate_modes: u8, pub preferred_alternate_mode: u8, pub vconn_power: u16, pub configured: [u8; 32], pub version: Version, pub additional_failure_info: u8, pub reserved: u8, pub alternate_modes: Vec, } #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct AlternateMode { pub svid: u16, pub alternate_mode: u8, pub alternate_mode_string_index: u8, pub alternate_mode_string: Option, } impl TryFrom<&[u8]> for BillboardCapability { type Error = Error; fn try_from(value: &[u8]) -> Result { if value.len() < 48 { return Err(Error::new_descriptor_len( "BillboardCapability", 48, value.len(), )); } let number_of_alternate_modes = value[4]; if number_of_alternate_modes > 0x34 { return Err(Error::new( ErrorKind::InvalidDescriptor, "Invalid number of alternate modes in Billboard Capability descriptor", )); } if value.len() < (44 + number_of_alternate_modes as usize * 4) { return Err(Error::new( ErrorKind::InvalidDescriptor, "Billboard Capability descriptor too short for alternate modes", )); } let mut alternate_modes = Vec::with_capacity(number_of_alternate_modes as usize); let mut i = 44; for _ in 0..number_of_alternate_modes { alternate_modes.push(AlternateMode { svid: u16::from_le_bytes([value[i], value[i + 1]]), alternate_mode: value[i + 2], alternate_mode_string_index: value[i + 3], alternate_mode_string: None, }); i += 4; } let version = if value[41] == 0 { Version::from_bcd(u16::from_le_bytes([value[40], 1])) } else { Version::from_bcd(u16::from_le_bytes([value[40], value[41]])) }; Ok(BillboardCapability { length: value[0], descriptor_type: value[1], capability_type: value[2].into(), additional_info_url_index: value[3], additional_info_url: None, number_of_alternate_modes, preferred_alternate_mode: value[5], vconn_power: u16::from_le_bytes([value[6], value[7]]), configured: value[8..40].try_into().expect("bmConfigured slice error"), version, additional_failure_info: value[42], reserved: value[43], alternate_modes, }) } } impl From for Vec { fn from(bc: BillboardCapability) -> Self { let mut ret = vec![ bc.length, bc.descriptor_type, u8::from(bc.capability_type), bc.additional_info_url_index, bc.number_of_alternate_modes, bc.preferred_alternate_mode, ]; ret.extend_from_slice(&bc.vconn_power.to_le_bytes()); ret.extend_from_slice(&bc.configured); ret.extend_from_slice(&(u16::from(bc.version)).to_le_bytes()); ret.push(bc.additional_failure_info); ret.push(bc.reserved); for alt_mode in bc.alternate_modes { ret.extend_from_slice(&alt_mode.svid.to_le_bytes()); ret.push(alt_mode.alternate_mode); ret.push(alt_mode.alternate_mode_string_index); } ret } } #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct BillboardAltModeCapability { pub length: u8, pub descriptor_type: u8, pub capability_type: BosType, pub index: u8, pub alternate_mode_vdo: u32, } impl TryFrom<&[u8]> for BillboardAltModeCapability { type Error = Error; fn try_from(value: &[u8]) -> Result { if value.len() != 8 { return Err(Error::new_descriptor_len( "BillboardAltModeCapability", 8, value.len(), )); } Ok(BillboardAltModeCapability { length: value[0], descriptor_type: value[1], capability_type: value[2].into(), index: value[3], alternate_mode_vdo: u32::from_le_bytes([value[4], value[5], value[6], value[7]]), }) } } impl From for Vec { fn from(bac: BillboardAltModeCapability) -> Self { let mut ret = vec![ bac.length, bac.descriptor_type, u8::from(bac.capability_type), bac.index, ]; ret.extend_from_slice(&bac.alternate_mode_vdo.to_le_bytes()); ret } } #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct ContainerIdCapability { pub length: u8, pub descriptor_type: u8, pub capability_type: BosType, pub reserved: u8, pub container_id: Uuid, } impl TryFrom<&[u8]> for ContainerIdCapability { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 20 { return Err(Error::new_descriptor_len( "ContainerIdCapability", 20, value.len(), )); } Ok(ContainerIdCapability { length: value[0], descriptor_type: value[1], capability_type: value[2].into(), reserved: value[3], container_id: Uuid::from_slice_le(&value[4..20]).map_err(|_| { Error::new( ErrorKind::InvalidDescriptor, "Container ID BOS descriptor has invalid GUID", ) })?, }) } } impl From for Vec { fn from(cic: ContainerIdCapability) -> Self { let mut ret = vec![ cic.length, cic.descriptor_type, u8::from(cic.capability_type), cic.reserved, ]; ret.extend(cic.container_id.to_bytes_le()); ret } } #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct ConfigurationSummaryCapability { pub length: u8, pub descriptor_type: u8, pub capability_type: BosType, pub version: Version, pub class: u8, pub sub_class: u8, pub protocol: u8, pub configuration_count: u8, pub configurations: u8, pub configured: Vec, } impl TryFrom<&[u8]> for ConfigurationSummaryCapability { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 10 { return Err(Error::new_descriptor_len( "ConfigurationSummaryCapability", 10, value.len(), )); } let configured_count = value[7]; if value.len() < 10 + configured_count as usize { return Err(Error::new_descriptor_len( "ConfigurationSummaryCapability configured_count", 10 + configured_count as usize, value.len(), )); } Ok(ConfigurationSummaryCapability { length: value[0], descriptor_type: value[1], capability_type: value[2].into(), version: Version::from_bcd(u16::from_le_bytes([value[3], value[4]])), class: value[5], sub_class: value[6], protocol: value[7], configuration_count: configured_count, configurations: value[8], configured: value[9..].to_vec(), }) } } impl From for Vec { fn from(ucs: ConfigurationSummaryCapability) -> Self { let mut ret = Vec::new(); ret.push(ucs.length); ret.push(ucs.descriptor_type); ret.push(u8::from(ucs.capability_type)); ret.extend_from_slice(&u16::from(ucs.version).to_le_bytes()); ret.push(ucs.class); ret.push(ucs.sub_class); ret.push(ucs.protocol); ret.push(ucs.configuration_count); ret.push(ucs.configurations); ret.extend(ucs.configured); ret } } cyme-2.2.6/src/usb/descriptors/cdc.rs000066400000000000000000000642731506545537300175270ustar00rootroot00000000000000//! Defines for the USB Communication Device Class (CDC) descriptors use serde::{Deserialize, Serialize}; use std::convert::TryFrom; use uuid::Uuid; use super::*; use crate::error::{self, Error, ErrorKind}; /// USB Communication Device Class (CDC) types /// /// Used to differentiate between different CDC descriptors #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[repr(u8)] #[non_exhaustive] #[allow(missing_docs)] #[serde(rename_all = "kebab-case")] pub enum CdcType { Header = 0x00, CallManagement = 0x01, AbstractControlManagement = 0x02, DirectLineManagement = 0x03, TelephoneRinger = 0x04, TelephoneCall = 0x05, Union = 0x06, CountrySelection = 0x07, TelephoneOperationalModes = 0x08, UsbTerminal = 0x09, NetworkChannel = 0x0a, ProtocolUnit = 0x0b, ExtensionUnit = 0x0c, MultiChannel = 0x0d, CapiControl = 0x0e, EthernetNetworking = 0x0f, AtmNetworking = 0x10, WirelessHandsetControlModel = 0x11, MobileDirectLineModelFunctional = 0x12, MobileDirectLineModelDetail = 0x13, DeviceManagement = 0x14, Obex = 0x15, CommandSet = 0x16, CommandSetDetail = 0x17, TelephoneControlModel = 0x18, ObexCommandSet = 0x19, Ncm = 0x1a, Mbim = 0x1b, MbimExtended = 0x1c, Unknown = 0xff, } impl std::fmt::Display for CdcType { fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result { // lsusb style if f.alternate() { match self { CdcType::Header => write!(f, "Header"), CdcType::CallManagement => write!(f, "Call Management"), CdcType::AbstractControlManagement => write!(f, "ACM"), CdcType::DirectLineManagement => write!(f, "DLM"), CdcType::TelephoneRinger => write!(f, "Telephone Ringer"), CdcType::TelephoneCall => write!(f, "Telephone Call"), CdcType::Union => write!(f, "Union"), CdcType::CountrySelection => write!(f, "Country Selection"), CdcType::TelephoneOperationalModes => write!(f, "Telephone Operations"), CdcType::UsbTerminal => write!(f, "USB Terminal"), CdcType::NetworkChannel => write!(f, "Network Channel Terminal"), CdcType::ProtocolUnit => write!(f, "Protocol Unit"), CdcType::ExtensionUnit => write!(f, "Extension Unit"), CdcType::MultiChannel => write!(f, "Multi Channel"), CdcType::CapiControl => write!(f, "CAPI Control"), CdcType::EthernetNetworking => write!(f, "Ethernet"), CdcType::AtmNetworking => write!(f, "ATM Networking"), CdcType::WirelessHandsetControlModel => write!(f, "WHCM version"), CdcType::MobileDirectLineModelFunctional => { write!(f, "MDLM") } CdcType::MobileDirectLineModelDetail => write!(f, "MDLM detail"), CdcType::DeviceManagement => write!(f, "Device Management"), CdcType::Obex => write!(f, "OBEX"), CdcType::CommandSet => write!(f, "Command Set"), CdcType::CommandSetDetail => write!(f, "Command Set Detail"), CdcType::TelephoneControlModel => write!(f, "Telephone Control Model"), CdcType::ObexCommandSet => write!(f, "OBEX Command Set"), CdcType::Ncm => write!(f, "NCM"), CdcType::Mbim => write!(f, "MBIM"), CdcType::MbimExtended => write!(f, "MBIM Extended"), CdcType::Unknown => write!(f, ""), } } else { write!(f, "{self:?}") } } } impl From for CdcType { fn from(b: u8) -> Self { match b { 0x00 => CdcType::Header, 0x01 => CdcType::CallManagement, 0x02 => CdcType::AbstractControlManagement, 0x03 => CdcType::DirectLineManagement, 0x04 => CdcType::TelephoneRinger, 0x05 => CdcType::TelephoneCall, 0x06 => CdcType::Union, 0x07 => CdcType::CountrySelection, 0x08 => CdcType::TelephoneOperationalModes, 0x09 => CdcType::UsbTerminal, 0x0a => CdcType::NetworkChannel, 0x0b => CdcType::ProtocolUnit, 0x0c => CdcType::ExtensionUnit, 0x0d => CdcType::MultiChannel, 0x0e => CdcType::CapiControl, 0x0f => CdcType::EthernetNetworking, 0x10 => CdcType::AtmNetworking, 0x11 => CdcType::WirelessHandsetControlModel, 0x12 => CdcType::MobileDirectLineModelFunctional, 0x13 => CdcType::MobileDirectLineModelDetail, 0x14 => CdcType::DeviceManagement, 0x15 => CdcType::Obex, 0x16 => CdcType::CommandSet, 0x17 => CdcType::CommandSetDetail, 0x18 => CdcType::TelephoneControlModel, 0x19 => CdcType::ObexCommandSet, 0x1a => CdcType::Ncm, 0x1b => CdcType::Mbim, 0x1c => CdcType::MbimExtended, _ => CdcType::Unknown, } } } #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct Header { pub version: Version, } impl TryFrom<&[u8]> for Header { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 2 { return Err(Error::new_descriptor_len("Header", 2, value.len())); } let version = Version::from_bcd(u16::from_le_bytes([value[0], value[1]])); Ok(Header { version }) } } impl From
for Vec { fn from(h: Header) -> Self { u16::from(h.version).to_le_bytes().to_vec() } } #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct CallManagement { pub capabilities: u8, pub data_interface: u8, } impl TryFrom<&[u8]> for CallManagement { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 2 { return Err(Error::new_descriptor_len("CallManagement", 2, value.len())); } Ok(CallManagement { capabilities: value[0], data_interface: value[1], }) } } impl From for Vec { fn from(cm: CallManagement) -> Self { vec![cm.capabilities, cm.data_interface] } } #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct AbstractControlManagement { pub capabilities: u8, } impl TryFrom<&[u8]> for AbstractControlManagement { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.is_empty() { return Err(Error::new_descriptor_len( "AbstractControlManagement", 1, value.len(), )); } Ok(AbstractControlManagement { capabilities: value[0], }) } } impl From for Vec { fn from(acm: AbstractControlManagement) -> Self { vec![acm.capabilities] } } #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct Union { pub master_interface: u8, pub slave_interface: Vec, } impl TryFrom<&[u8]> for Union { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 2 { return Err(Error::new_descriptor_len("Union", 2, value.len())); } Ok(Union { master_interface: value[0], slave_interface: value[1..].to_vec(), }) } } impl From for Vec { fn from(u: Union) -> Self { let mut ret = vec![u.master_interface]; ret.extend(u.slave_interface); ret } } #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct CountrySelection { pub country_code_date_index: u8, pub country_code_date: Option, pub country_codes: Vec, } impl TryFrom<&[u8]> for CountrySelection { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 3 { return Err(Error::new_descriptor_len( "CountrySelection", 3, value.len(), )); } let country_code_date_index = value[0]; let country_codes = value[1..] .chunks_exact(2) .map(|c| u16::from_le_bytes([c[0], c[1]])) .collect(); Ok(CountrySelection { country_code_date_index, country_code_date: None, country_codes, }) } } impl From for Vec { fn from(cs: CountrySelection) -> Self { let mut ret = vec![cs.country_code_date_index]; for code in cs.country_codes { ret.extend(code.to_le_bytes().iter()); } ret } } #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct TelephoneOperations { pub capabilities: u8, } impl TryFrom<&[u8]> for TelephoneOperations { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.is_empty() { return Err(Error::new_descriptor_len( "TelephoneOperations", 1, value.len(), )); } Ok(TelephoneOperations { capabilities: value[0], }) } } impl From for Vec { fn from(to: TelephoneOperations) -> Self { vec![to.capabilities] } } #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct NetworkChannel { pub entity_id: u8, pub name_string_index: u8, pub name: Option, pub channel_index: u8, pub physical_interface: u8, } impl TryFrom<&[u8]> for NetworkChannel { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 4 { return Err(Error::new_descriptor_len("NetworkChannel", 4, value.len())); } Ok(NetworkChannel { entity_id: value[0], name_string_index: value[1], name: None, channel_index: value[2], physical_interface: value[3], }) } } impl From for Vec { fn from(nc: NetworkChannel) -> Self { vec![ nc.entity_id, nc.name_string_index, nc.channel_index, nc.physical_interface, ] } } #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct EthernetNetworking { pub mac_address_index: u8, pub mac_address: Option, pub ethernet_statistics: u32, pub max_segment_size: u16, pub num_multicast_filters: u16, pub num_power_filters: u8, } impl TryFrom<&[u8]> for EthernetNetworking { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 10 { return Err(Error::new_descriptor_len("Ethernet", 10, value.len())); } Ok(EthernetNetworking { mac_address_index: value[0], mac_address: None, ethernet_statistics: u32::from_le_bytes([value[1], value[2], value[3], value[4]]), max_segment_size: u16::from_le_bytes([value[5], value[6]]), num_multicast_filters: u16::from_le_bytes([value[7], value[8]]), num_power_filters: value[9], }) } } impl From for Vec { fn from(en: EthernetNetworking) -> Self { let mut ret = vec![en.mac_address_index]; ret.extend(en.ethernet_statistics.to_le_bytes().iter()); ret.extend(en.max_segment_size.to_le_bytes().iter()); ret.extend(en.num_multicast_filters.to_le_bytes().iter()); ret.push(en.num_power_filters); ret } } // just BCD version #[allow(missing_docs)] pub type WirelessHandsetControlModel = Header; #[allow(missing_docs)] pub type Obex = Header; #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct MobileDirectLineModelFunctional { pub version: Version, pub guid: Uuid, } impl TryFrom<&[u8]> for MobileDirectLineModelFunctional { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 18 { return Err(Error::new_descriptor_len( "MobileDirectLineModelFunctional", 18, value.len(), )); } let version = Version::from_bcd(u16::from_le_bytes([value[0], value[1]])); let guid = Uuid::from_slice_le(&value[2..18]) .map_err(|e| Error::new(ErrorKind::InvalidDescriptor, &format!("Invalid GUID: {e}")))?; Ok(MobileDirectLineModelFunctional { version, guid }) } } impl From for Vec { fn from(md: MobileDirectLineModelFunctional) -> Self { let mut ret = u16::from(md.version).to_le_bytes().to_vec(); ret.extend(md.guid.to_bytes_le()); ret } } #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct MobileDirectLineModelDetail { pub guid_descriptor_type: u8, pub detail_data: Vec, } impl TryFrom<&[u8]> for MobileDirectLineModelDetail { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 2 { return Err(Error::new_descriptor_len( "MobileDirectLineModelDetail", 2, value.len(), )); } Ok(MobileDirectLineModelDetail { guid_descriptor_type: value[0], detail_data: value[1..].to_vec(), }) } } impl From for Vec { fn from(md: MobileDirectLineModelDetail) -> Self { let mut ret = vec![md.guid_descriptor_type]; ret.extend(md.detail_data); ret } } #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct DeviceManagement { pub version: Version, pub max_command: u16, } impl TryFrom<&[u8]> for DeviceManagement { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 4 { return Err(Error::new_descriptor_len( "DeviceManagement", 4, value.len(), )); } let version = Version::from_bcd(u16::from_le_bytes([value[0], value[1]])); let max_command = u16::from_le_bytes([value[2], value[3]]); Ok(DeviceManagement { version, max_command, }) } } impl From for Vec { fn from(dm: DeviceManagement) -> Self { let mut ret = u16::from(dm.version).to_le_bytes().to_vec(); ret.extend(dm.max_command.to_le_bytes()); ret } } #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct CommandSet { pub version: Version, pub command_set_string_index: u8, pub command_set_string: Option, pub guid: Uuid, } impl TryFrom<&[u8]> for CommandSet { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 19 { return Err(Error::new_descriptor_len("CommandSet", 19, value.len())); } let version = Version::from_bcd(u16::from_le_bytes([value[0], value[1]])); let command_set_string_index = value[2]; let guid = Uuid::from_slice_le(&value[3..19]) .map_err(|e| Error::new(ErrorKind::InvalidDescriptor, &format!("Invalid GUID: {e}")))?; Ok(CommandSet { version, command_set_string_index, command_set_string: None, guid, }) } } impl From for Vec { fn from(cs: CommandSet) -> Self { let mut ret = u16::from(cs.version).to_le_bytes().to_vec(); ret.push(cs.command_set_string_index); ret.extend(cs.guid.to_bytes_le()); ret } } #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct Ncm { pub version: Version, pub network_capabilities: u8, } impl TryFrom<&[u8]> for Ncm { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 3 { return Err(Error::new_descriptor_len("NCM", 3, value.len())); } let version = Version::from_bcd(u16::from_le_bytes([value[0], value[1]])); let network_capabilities = value[2]; Ok(Ncm { version, network_capabilities, }) } } impl From for Vec { fn from(ncm: Ncm) -> Self { let mut ret = u16::from(ncm.version).to_le_bytes().to_vec(); ret.push(ncm.network_capabilities); ret } } #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct Mbim { pub version: Version, pub max_control_message: u16, pub number_filters: u8, pub max_filter_size: u8, pub max_segment_size: u16, pub network_capabilities: u8, } impl TryFrom<&[u8]> for Mbim { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 9 { return Err(Error::new_descriptor_len("MBIM", 9, value.len())); } let version = Version::from_bcd(u16::from_le_bytes([value[0], value[1]])); let max_control_message = u16::from_le_bytes([value[2], value[3]]); let number_filters = value[4]; let max_filter_size = value[5]; let max_segment_size = u16::from_le_bytes([value[6], value[7]]); let network_capabilities = value[8]; Ok(Mbim { version, max_control_message, number_filters, max_filter_size, max_segment_size, network_capabilities, }) } } impl From for Vec { fn from(mbim: Mbim) -> Self { let mut ret = u16::from(mbim.version).to_le_bytes().to_vec(); ret.extend(mbim.max_control_message.to_le_bytes().iter()); ret.push(mbim.number_filters); ret.push(mbim.max_filter_size); ret.extend(mbim.max_segment_size.to_le_bytes().iter()); ret.push(mbim.network_capabilities); ret } } #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct MbimExtended { pub version: Version, pub max_outstanding_command_messages: u8, pub mtu: u16, } impl TryFrom<&[u8]> for MbimExtended { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 6 { return Err(Error::new_descriptor_len("MBIM Extended", 6, value.len())); } let version = Version::from_bcd(u16::from_le_bytes([value[0], value[1]])); let mtu = u16::from_le_bytes([value[3], value[4]]); Ok(MbimExtended { version, max_outstanding_command_messages: value[2], mtu, }) } } impl From for Vec { fn from(mbim_ext: MbimExtended) -> Self { let mut ret = u16::from(mbim_ext.version).to_le_bytes().to_vec(); ret.push(mbim_ext.max_outstanding_command_messages); ret.extend(mbim_ext.mtu.to_le_bytes().iter()); ret } } #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] #[non_exhaustive] #[serde(rename_all = "kebab-case")] pub enum CdcInterfaceDescriptor { Header(Header), CallManagement(CallManagement), AbstractControlManagement(AbstractControlManagement), Union(Union), CountrySelection(CountrySelection), TelephoneOperations(TelephoneOperations), NetworkChannel(NetworkChannel), EthernetNetworking(EthernetNetworking), WirelessHandsetControlModel(WirelessHandsetControlModel), Obex(Obex), MobileDirectLineModelFunctional(MobileDirectLineModelFunctional), MobileDirectLineModelDetail(MobileDirectLineModelDetail), DeviceManagement(DeviceManagement), CommandSet(CommandSet), Ncm(Ncm), Mbim(Mbim), MbimExtended(MbimExtended), Invalid(Vec), Undefined(Vec), } impl CdcInterfaceDescriptor { /// Create a [`CdcInterfaceDescriptor`] from CDC descriptor data pub fn from_cdc_descriptor( _descriptor_type: &DescriptorType, subtype: &CdcType, data: &[u8], ) -> error::Result { match subtype { CdcType::Header => Header::try_from(data).map(CdcInterfaceDescriptor::Header), CdcType::CallManagement => { CallManagement::try_from(data).map(CdcInterfaceDescriptor::CallManagement) } CdcType::AbstractControlManagement => AbstractControlManagement::try_from(data) .map(CdcInterfaceDescriptor::AbstractControlManagement), CdcType::Union => Union::try_from(data).map(CdcInterfaceDescriptor::Union), CdcType::CountrySelection => { CountrySelection::try_from(data).map(CdcInterfaceDescriptor::CountrySelection) } CdcType::TelephoneOperationalModes => { TelephoneOperations::try_from(data).map(CdcInterfaceDescriptor::TelephoneOperations) } CdcType::NetworkChannel => { NetworkChannel::try_from(data).map(CdcInterfaceDescriptor::NetworkChannel) } CdcType::EthernetNetworking => { EthernetNetworking::try_from(data).map(CdcInterfaceDescriptor::EthernetNetworking) } CdcType::WirelessHandsetControlModel => { Header::try_from(data).map(CdcInterfaceDescriptor::WirelessHandsetControlModel) } CdcType::Obex => Header::try_from(data).map(CdcInterfaceDescriptor::Obex), CdcType::MobileDirectLineModelFunctional => { MobileDirectLineModelFunctional::try_from(data) .map(CdcInterfaceDescriptor::MobileDirectLineModelFunctional) } CdcType::MobileDirectLineModelDetail => MobileDirectLineModelDetail::try_from(data) .map(CdcInterfaceDescriptor::MobileDirectLineModelDetail), CdcType::DeviceManagement => { DeviceManagement::try_from(data).map(CdcInterfaceDescriptor::DeviceManagement) } CdcType::CommandSet => { CommandSet::try_from(data).map(CdcInterfaceDescriptor::CommandSet) } CdcType::Ncm => Ncm::try_from(data).map(CdcInterfaceDescriptor::Ncm), CdcType::Mbim => Mbim::try_from(data).map(CdcInterfaceDescriptor::Mbim), CdcType::MbimExtended => { MbimExtended::try_from(data).map(CdcInterfaceDescriptor::MbimExtended) } _ => Ok(CdcInterfaceDescriptor::Undefined(data.to_vec())), } } } impl From for Vec { fn from(cd: CdcInterfaceDescriptor) -> Self { match cd { CdcInterfaceDescriptor::Header(h) => h.into(), CdcInterfaceDescriptor::CallManagement(cm) => cm.into(), CdcInterfaceDescriptor::AbstractControlManagement(acm) => acm.into(), CdcInterfaceDescriptor::Union(u) => u.into(), CdcInterfaceDescriptor::CountrySelection(cs) => cs.into(), CdcInterfaceDescriptor::TelephoneOperations(to) => to.into(), CdcInterfaceDescriptor::NetworkChannel(nc) => nc.into(), CdcInterfaceDescriptor::EthernetNetworking(en) => en.into(), CdcInterfaceDescriptor::WirelessHandsetControlModel(whcm) => whcm.into(), CdcInterfaceDescriptor::Obex(obex) => obex.into(), CdcInterfaceDescriptor::MobileDirectLineModelFunctional(md) => md.into(), CdcInterfaceDescriptor::MobileDirectLineModelDetail(md) => md.into(), CdcInterfaceDescriptor::DeviceManagement(dm) => dm.into(), CdcInterfaceDescriptor::CommandSet(cs) => cs.into(), CdcInterfaceDescriptor::Ncm(ncm) => ncm.into(), CdcInterfaceDescriptor::Mbim(mbim) => mbim.into(), CdcInterfaceDescriptor::MbimExtended(mbim_ext) => mbim_ext.into(), CdcInterfaceDescriptor::Invalid(data) => data, CdcInterfaceDescriptor::Undefined(data) => data, } } } /// USB Communication Device Class (CDC) descriptor /// /// Can be used by CDCData and CDCCommunications #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct CommunicationDescriptor { pub length: u8, pub descriptor_type: u8, pub descriptor_subtype: CdcType, pub interface: CdcInterfaceDescriptor, } impl TryFrom<&[u8]> for CommunicationDescriptor { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 4 { return Err(Error::new_descriptor_len( "CommunicationDescriptor", 4, value.len(), )); } let communication_type = CdcType::from(value[2]); let interface = CdcInterfaceDescriptor::from_cdc_descriptor( &DescriptorType::Interface, &communication_type, &value[3..], ) .unwrap_or_else(|e| { log::warn!( "Failed to parse CDC interface descriptor for {communication_type:?}: {e:?}" ); CdcInterfaceDescriptor::Invalid(value[3..].to_vec()) }); Ok(CommunicationDescriptor { length: value[0], descriptor_type: value[1], descriptor_subtype: communication_type, interface, }) } } impl From for Vec { fn from(cd: CommunicationDescriptor) -> Self { let mut ret = Vec::new(); ret.push(cd.length); ret.push(cd.descriptor_type); ret.push(cd.descriptor_subtype as u8); let data = Vec::::from(cd.interface); ret.extend(data); ret } } impl TryFrom for CommunicationDescriptor { type Error = Error; fn try_from(gd: GenericDescriptor) -> error::Result { let gd_vec: Vec = gd.into(); CommunicationDescriptor::try_from(&gd_vec[..]) } } cyme-2.2.6/src/usb/descriptors/video.rs000066400000000000000000001322771506545537300201040ustar00rootroot00000000000000//! Defines for the USB Video Class (UVC) interface descriptors use serde::{Deserialize, Serialize}; use std::convert::TryFrom; use uuid::Uuid; use super::audio; use super::*; use crate::error::{self, Error, ErrorKind}; #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] #[repr(u8)] #[non_exhaustive] #[serde(rename_all = "kebab-case")] pub enum ControlSubtype { Undefined = 0x00, Header = 0x01, InputTerminal = 0x02, OutputTerminal = 0x03, SelectorUnit = 0x04, ProcessingUnit = 0x05, ExtensionUnit = 0x06, EncodingUnit = 0x07, } impl std::fmt::Display for ControlSubtype { fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result { // lsusb style if f.alternate() { match self { ControlSubtype::Undefined => write!(f, "unknown"), _ => write!(f, "{}", heck::AsShoutySnakeCase(format!("{self:?}"))), } } else { write!(f, "{self:?}") } } } impl From for ControlSubtype { fn from(b: u8) -> Self { match b { 0x00 => ControlSubtype::Undefined, 0x01 => ControlSubtype::Header, 0x02 => ControlSubtype::InputTerminal, 0x03 => ControlSubtype::OutputTerminal, 0x04 => ControlSubtype::SelectorUnit, 0x05 => ControlSubtype::ProcessingUnit, 0x06 => ControlSubtype::ExtensionUnit, 0x07 => ControlSubtype::EncodingUnit, _ => ControlSubtype::Undefined, } } } #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] #[repr(u8)] #[non_exhaustive] #[serde(rename_all = "kebab-case")] pub enum StreamingSubtype { Undefined = 0x00, InputHeader = 0x01, OutputHeader = 0x02, StillImageFrame = 0x03, FormatUncompressed = 0x04, FrameUncompressed = 0x05, FormatMJPEG = 0x06, FrameMJPEG = 0x07, FormatFrameBased = 0x10, FrameFrameBased = 0x11, FormatStreamBased = 0x12, FormatMPEG2TS = 0x0a, ColorFormat = 0x0d, } impl std::fmt::Display for StreamingSubtype { fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result { // lsusb style if f.alternate() { match self { StreamingSubtype::Undefined => write!(f, "unknown"), _ => write!(f, "{}", heck::AsShoutySnakeCase(format!("{self:?}"))), } } else { write!(f, "{self:?}") } } } impl From for StreamingSubtype { fn from(b: u8) -> Self { match b { 0x00 => StreamingSubtype::Undefined, 0x01 => StreamingSubtype::InputHeader, 0x02 => StreamingSubtype::OutputHeader, 0x03 => StreamingSubtype::StillImageFrame, 0x04 => StreamingSubtype::FormatUncompressed, 0x05 => StreamingSubtype::FrameUncompressed, 0x06 => StreamingSubtype::FormatMJPEG, 0x07 => StreamingSubtype::FrameMJPEG, 0x10 => StreamingSubtype::FormatFrameBased, 0x11 => StreamingSubtype::FrameFrameBased, 0x12 => StreamingSubtype::FormatStreamBased, 0x0a => StreamingSubtype::FormatMPEG2TS, 0x0d => StreamingSubtype::ColorFormat, _ => StreamingSubtype::Undefined, } } } /// USB Video Class (UVC) subtype based on the bDescriptorSubtype #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[serde(rename_all = "kebab-case")] pub enum UvcType { /// Video Control Interface Control(ControlSubtype), /// Video Streaming Interface Streaming(StreamingSubtype), } impl std::fmt::Display for UvcType { fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result { if f.alternate() { match self { UvcType::Control(c) => write!(f, "{c:#}"), UvcType::Streaming(s) => write!(f, "{s:#}"), } } else { match self { UvcType::Control(c) => write!(f, "{c}"), UvcType::Streaming(s) => write!(f, "{s}"), } } } } /// From a tuple of (SubClass, DescriptorSub, Protocol) get the UAC subtype impl TryFrom<(u8, u8, u8)> for UvcType { type Error = Error; fn try_from(value: (u8, u8, u8)) -> error::Result { match value.0 { 1 => Ok(UvcType::Control(ControlSubtype::from(value.1))), 2 => Ok(UvcType::Streaming(StreamingSubtype::from(value.1))), _ => Err(Error::new( ErrorKind::InvalidArg, "Invalid UVC descriptor type", )), } } } impl From for u8 { fn from(uvc: UvcType) -> Self { match uvc { UvcType::Control(c) => c as u8, UvcType::Streaming(s) => s as u8, } } } impl UvcType { /// Get the UVC descriptor from protocol and descriptor interface data pub fn get_uvc_descriptor( &self, _protocol: u8, data: &[u8], ) -> error::Result { match self { UvcType::Control(c) => match c { ControlSubtype::Header => { Ok(UvcInterfaceDescriptor::Header(Header::try_from(data)?)) } ControlSubtype::InputTerminal => Ok(UvcInterfaceDescriptor::InputTerminal( InputTerminal::try_from(data)?, )), ControlSubtype::OutputTerminal => Ok(UvcInterfaceDescriptor::OutputTerminal( OutputTerminal::try_from(data)?, )), ControlSubtype::SelectorUnit => Ok(UvcInterfaceDescriptor::SelectorUnit( SelectorUnit::try_from(data)?, )), ControlSubtype::ProcessingUnit => Ok(UvcInterfaceDescriptor::ProcessingUnit( ProcessingUnit::try_from(data)?, )), ControlSubtype::ExtensionUnit => Ok(UvcInterfaceDescriptor::ExtensionUnit( ExtensionUnit::try_from(data)?, )), ControlSubtype::EncodingUnit => Ok(UvcInterfaceDescriptor::EncodingUnit( EncodingUnit::try_from(data)?, )), ControlSubtype::Undefined => Ok(UvcInterfaceDescriptor::Undefined(data.to_vec())), }, UvcType::Streaming(s) => match s { StreamingSubtype::InputHeader => Ok(UvcInterfaceDescriptor::InputHeader( InputHeader::try_from(data)?, )), StreamingSubtype::OutputHeader => Ok(UvcInterfaceDescriptor::OutputHeader( OutputHeader::try_from(data)?, )), StreamingSubtype::StillImageFrame => Ok(UvcInterfaceDescriptor::StillImageFrame( StillImageFrame::try_from(data)?, )), StreamingSubtype::FrameUncompressed => Ok( UvcInterfaceDescriptor::FrameUncompressed(FrameUncompressed::try_from(data)?), ), StreamingSubtype::FrameMJPEG => Ok(UvcInterfaceDescriptor::FrameMJPEG( FrameMJPEG::try_from(data)?, )), StreamingSubtype::FrameFrameBased => Ok(UvcInterfaceDescriptor::FrameFrameBased( FrameFrameBased::try_from(data)?, )), StreamingSubtype::FormatMJPEG => Ok(UvcInterfaceDescriptor::FormatMJPEG( FormatMJPEG::try_from(data)?, )), StreamingSubtype::FormatFrameBased => Ok(UvcInterfaceDescriptor::FormatFrameBased( FormatFrame::try_from(data)?, )), StreamingSubtype::FormatUncompressed => Ok( UvcInterfaceDescriptor::FormatUncompressed(FormatFrame::try_from(data)?), ), StreamingSubtype::FormatStreamBased => Ok( UvcInterfaceDescriptor::FormatStreamBased(FormatStreamBased::try_from(data)?), ), StreamingSubtype::FormatMPEG2TS => Ok(UvcInterfaceDescriptor::FormatMPEG2TS( FormatMPEG2TS::try_from(data)?, )), StreamingSubtype::ColorFormat => Ok(UvcInterfaceDescriptor::ColorFormat( ColorFormat::try_from(data)?, )), StreamingSubtype::Undefined => Ok(UvcInterfaceDescriptor::Undefined(data.to_vec())), }, } } /// Get the UVC descriptor from a generic descriptor and protocol pub fn uvc_descriptor_from_generic( &self, gd: GenericDescriptor, _protocol: u8, ) -> error::Result { match gd.data { Some(data) => match self.get_uvc_descriptor(_protocol, &data) { Ok(v) => Ok(v), Err(e) => { log::warn!("Error parsing UVC descriptor: {e}"); Ok(UvcInterfaceDescriptor::Invalid(data)) } }, None => Err(Error::new( ErrorKind::InvalidArg, "No data in generic descriptor", )), } } } #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct UvcDescriptor { pub length: u8, pub descriptor_type: u8, pub descriptor_subtype: UvcType, pub interface: UvcInterfaceDescriptor, } /// Try from ([`GenericDescriptor`], SubClass, Protocol) impl TryFrom<(GenericDescriptor, u8, u8)> for UvcDescriptor { type Error = Error; fn try_from((gd, subc, p): (GenericDescriptor, u8, u8)) -> error::Result { let length = gd.length; let descriptor_type = gd.descriptor_type; let descriptor_subtype: UvcType = (subc, gd.descriptor_subtype, p).try_into()?; let interface = descriptor_subtype.uvc_descriptor_from_generic(gd.to_owned(), p)?; Ok(UvcDescriptor { length, descriptor_type, descriptor_subtype, interface, }) } } impl From for Vec { fn from(vcd: UvcDescriptor) -> Self { let mut ret = Vec::new(); ret.push(vcd.length); ret.push(vcd.descriptor_type); ret.push(u8::from(vcd.descriptor_subtype)); let data: Vec = vcd.interface.into(); ret.extend(data); ret } } #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub enum UvcInterfaceDescriptor { // Control Header(Header), InputTerminal(InputTerminal), OutputTerminal(OutputTerminal), SelectorUnit(SelectorUnit), ProcessingUnit(ProcessingUnit), ExtensionUnit(ExtensionUnit), EncodingUnit(EncodingUnit), // Streaming InputHeader(InputHeader), OutputHeader(OutputHeader), StillImageFrame(StillImageFrame), FrameUncompressed(FrameUncompressed), FrameMJPEG(FrameMJPEG), FrameFrameBased(FrameFrameBased), FormatUncompressed(FormatFrame), FormatFrameBased(FormatFrame), FormatStreamBased(FormatStreamBased), FormatMJPEG(FormatMJPEG), FormatMPEG2TS(FormatMPEG2TS), ColorFormat(ColorFormat), /// Invalid descriptor for failing to parse matched Invalid(Vec), /// Generic descriptor for known but unsupported descriptors Generic(Vec), /// Undefined descriptor Undefined(Vec), } impl From for Vec { fn from(uvc: UvcInterfaceDescriptor) -> Self { match uvc { UvcInterfaceDescriptor::Header(h) => h.into(), UvcInterfaceDescriptor::InputTerminal(it) => it.into(), UvcInterfaceDescriptor::OutputTerminal(ot) => ot.into(), UvcInterfaceDescriptor::SelectorUnit(su) => su.into(), UvcInterfaceDescriptor::ProcessingUnit(pu) => pu.into(), UvcInterfaceDescriptor::ExtensionUnit(eu) => eu.into(), UvcInterfaceDescriptor::EncodingUnit(eu) => eu.into(), UvcInterfaceDescriptor::InputHeader(ih) => ih.into(), UvcInterfaceDescriptor::OutputHeader(oh) => oh.into(), UvcInterfaceDescriptor::StillImageFrame(sif) => sif.into(), UvcInterfaceDescriptor::FrameFrameBased(ff) => ff.into(), UvcInterfaceDescriptor::FrameUncompressed(fu) | UvcInterfaceDescriptor::FrameMJPEG(fu) => fu.into(), UvcInterfaceDescriptor::FormatUncompressed(fmt) | UvcInterfaceDescriptor::FormatFrameBased(fmt) => fmt.into(), UvcInterfaceDescriptor::FormatStreamBased(fsb) => fsb.into(), UvcInterfaceDescriptor::FormatMJPEG(fmt) => fmt.into(), UvcInterfaceDescriptor::FormatMPEG2TS(fmts) => fmts.into(), UvcInterfaceDescriptor::ColorFormat(cf) => cf.into(), UvcInterfaceDescriptor::Invalid(data) => data, UvcInterfaceDescriptor::Generic(data) => data, UvcInterfaceDescriptor::Undefined(data) => data, } } } #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct Header { pub version: Version, pub total_length: u16, pub clock_frequency: u32, pub collection_bytes: u8, pub interfaces: Vec, } impl TryFrom<&[u8]> for Header { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 10 { return Err(Error::new_descriptor_len("Video Control", 10, value.len())); } let version = Version::from_bcd(u16::from_le_bytes([value[0], value[1]])); let total_length = u16::from_le_bytes([value[2], value[3]]); let clock_frequency = u32::from_le_bytes([value[4], value[5], value[6], value[7]]); let collection_bytes = value[8]; let interfaces = value[9..].to_vec(); Ok(Header { version, total_length, clock_frequency, collection_bytes, interfaces, }) } } impl From
for Vec { fn from(h: Header) -> Self { let mut ret = Vec::new(); ret.extend_from_slice(&(u16::from(h.version)).to_le_bytes()); ret.extend_from_slice(&h.total_length.to_le_bytes()); ret.extend_from_slice(&h.clock_frequency.to_le_bytes()); ret.push(h.collection_bytes); ret.extend(h.interfaces); ret } } #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct TerminalExtra { pub objective_focal_length_min: u16, pub objective_focal_length_max: u16, pub ocular_focal_length: u16, pub control_size: u8, pub controls: u32, } impl TryFrom<&[u8]> for TerminalExtra { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 8 { return Err(Error::new_descriptor_len("TerminalExtra", 8, value.len())); } let objective_focal_length_min = u16::from_le_bytes([value[0], value[1]]); let objective_focal_length_max = u16::from_le_bytes([value[2], value[3]]); let ocular_focal_length = u16::from_le_bytes([value[4], value[5]]); let control_size = value[6]; if value.len() < 7 + control_size as usize { return Err(Error::new( ErrorKind::InvalidDescriptor, &format!( "Terminal Extra descriptor too short for control size {} < {}", value.len(), 7 + control_size ), )); } let mut controls: u32 = 0; for i in 0..control_size.min(3) as usize { controls |= (value[7 + i] as u32) << (i * 8); } Ok(TerminalExtra { objective_focal_length_min, objective_focal_length_max, ocular_focal_length, control_size, controls, }) } } impl From for Vec { fn from(te: TerminalExtra) -> Self { let mut ret = Vec::new(); ret.extend_from_slice(&te.objective_focal_length_min.to_le_bytes()); ret.extend_from_slice(&te.objective_focal_length_max.to_le_bytes()); ret.extend_from_slice(&te.ocular_focal_length.to_le_bytes()); ret.push(te.control_size); for i in 0..te.control_size.min(3) { ret.push((te.controls >> (i * 8)) as u8); } ret } } #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct InputTerminal { pub terminal_id: u8, pub terminal_type: u16, pub associated_terminal: u8, pub terminal_index: u8, pub terminal: Option, pub extra: Option, } impl TryFrom<&[u8]> for InputTerminal { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 5 { return Err(Error::new_descriptor_len("InputTerminal", 5, value.len())); } let terminal_id = value[0]; let terminal_type = u16::from_le_bytes([value[1], value[2]]); let associated_terminal = value[3]; let terminal_string_index = value[4]; let terminal_string = None; let extra = if terminal_type == 0x0201 && value.len() > 5 { Some(TerminalExtra::try_from(&value[5..])?) } else { None }; Ok(InputTerminal { terminal_id, terminal_type, associated_terminal, terminal_index: terminal_string_index, terminal: terminal_string, extra, }) } } impl From for Vec { fn from(it: InputTerminal) -> Self { let mut ret = Vec::new(); ret.push(it.terminal_id); ret.extend_from_slice(&it.terminal_type.to_le_bytes()); ret.push(it.associated_terminal); ret.push(it.terminal_index); if let Some(extra) = it.extra { let extra: Vec = extra.into(); ret.extend(extra); } ret } } /// Output Terminal descriptor; same as [`audio::OutputTerminal1`] pub type OutputTerminal = audio::OutputTerminal1; /// Selector Unit descriptor; same as [`audio::SelectorUnit1`] pub type SelectorUnit = audio::SelectorUnit1; #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct ProcessingUnit { pub unit_id: u8, pub source_id: u8, pub max_multiplier: u16, pub control_size: u8, pub controls: u32, pub processing_index: u8, pub processing: Option, pub video_standards: u8, } impl TryFrom<&[u8]> for ProcessingUnit { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 7 { return Err(Error::new_descriptor_len("ProcessingUnit", 7, value.len())); } let unit_id = value[0]; let source_id = value[1]; let max_multiplier = u16::from_le_bytes([value[2], value[3]]); let control_size = value[4]; // 5 + 2 for bytes after if value.len() < 7 + control_size as usize { return Err(Error::new( ErrorKind::InvalidArg, &format!( "Processing Unit descriptor too short for control size {} < {}", value.len(), 7 + control_size ), )); } let mut controls: u32 = 0; for i in 0..control_size.min(3) as usize { controls |= (value[5 + i] as u32) << (i * 8); } let processing_string_index = value[5 + control_size as usize]; let video_standards = value[6 + control_size as usize]; Ok(ProcessingUnit { unit_id, source_id, max_multiplier, control_size, controls, processing_index: processing_string_index, processing: None, video_standards, }) } } impl From for Vec { fn from(pu: ProcessingUnit) -> Self { let mut ret = Vec::new(); ret.push(pu.unit_id); ret.push(pu.source_id); ret.extend_from_slice(&pu.max_multiplier.to_le_bytes()); ret.push(pu.control_size); for i in 0..pu.control_size.min(3) { ret.push((pu.controls >> (i * 8)) as u8); } ret.push(pu.processing_index); ret.push(pu.video_standards); ret } } #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct ExtensionUnit { pub unit_id: u8, pub guid_extension_code: Uuid, pub num_controls: u8, pub num_input_pins: u8, pub source_ids: Vec, pub control_size: u8, pub controls: Vec, pub extension_index: u8, pub extension: Option, } impl TryFrom<&[u8]> for ExtensionUnit { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 21 { return Err(Error::new_descriptor_len("ExtensionUnit", 21, value.len())); } let unit_id = value[0]; let guid_extension_code = Uuid::from_slice_le(&value[1..17]).map_err(|e| { Error::new( ErrorKind::InvalidDescriptor, &format!("Invalid GUID Extension Code: {e}"), ) })?; let num_controls = value[17]; let num_input_pins = value[18]; let p = num_input_pins as usize; if value.len() < 19 + p + 1 { return Err(Error::new( ErrorKind::InvalidDescriptor, &format!( "Extension Unit descriptor too short for input pins {} < {}", value.len(), 19 + p + 1 ), )); } let source_ids = value[19..19 + p].to_vec(); let control_size = value[19 + p]; if value.len() < 20 + p + 1 + control_size as usize { return Err(Error::new( ErrorKind::InvalidDescriptor, &format!( "Extension Unit descriptor too short for control size {} < {}", value.len(), 20 + p + 1 + control_size as usize ), )); } let controls = value[20 + p..20 + p + control_size as usize].to_vec(); let extension_string_index = value[20 + p + control_size as usize]; Ok(ExtensionUnit { unit_id, guid_extension_code, num_controls, num_input_pins, source_ids, control_size, controls, extension_index: extension_string_index, extension: None, }) } } impl From for Vec { fn from(eu: ExtensionUnit) -> Self { let mut ret = Vec::new(); ret.push(eu.unit_id); ret.extend(eu.guid_extension_code.to_bytes_le()); ret.push(eu.num_controls); ret.push(eu.num_input_pins); ret.extend_from_slice(&eu.source_ids); ret.push(eu.control_size); ret.extend_from_slice(&eu.controls); ret.push(eu.extension_index); ret } } #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct EncodingUnit { pub unit_id: u8, pub source_id: u8, pub encoding_index: u8, pub encoding: Option, pub control_size: u8, pub controls: u32, pub controls_runtime: u32, } impl TryFrom<&[u8]> for EncodingUnit { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 4 { return Err(Error::new_descriptor_len("EncodingUnit", 4, value.len())); } let unit_id = value[0]; let source_id = value[1]; let encoding_string_index = value[2]; let control_size = value[3] as usize; if value.len() < 3 + 2 * control_size { return Err(Error::new( ErrorKind::InvalidDescriptor, &format!( "Encoding Unit descriptor too short for control size {} < {}", value.len(), 3 + 2 * control_size ), )); } let mut controls: u32 = 0; for i in 0..control_size.min(3) { controls |= (value[4 + i] as u32) << (i * 8); } let mut controls_runtime: u32 = 0; for i in 0..control_size.min(3) { controls_runtime |= (value[4 + i + control_size] as u32) << (i * 8); } Ok(EncodingUnit { unit_id, source_id, encoding_index: encoding_string_index, encoding: None, control_size: value[3], controls, controls_runtime, }) } } impl From for Vec { fn from(eu: EncodingUnit) -> Self { let mut ret = vec![eu.unit_id, eu.source_id, eu.encoding_index, eu.control_size]; for i in 0..eu.control_size.min(3) { ret.push((eu.controls >> (i * 8)) as u8); } for i in 0..eu.control_size.min(3) { ret.push((eu.controls_runtime >> (i * 8)) as u8); } ret } } /* Streaming Interface Descriptors */ #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct InputHeader { pub num_formats: u8, pub total_length: u16, pub endpoint_address: EndpointAddress, pub info: u8, pub terminal_link: u8, pub still_capture_method: u8, pub trigger_support: u8, pub trigger_usage: u8, pub control_size: u8, pub controls: Vec, } impl TryFrom<&[u8]> for InputHeader { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 10 { return Err(Error::new_descriptor_len("InputHeader", 10, value.len())); } let num_formats = value[0]; let total_length = u16::from_le_bytes([value[1], value[2]]); let endpoint_address = EndpointAddress::from(value[3]); let info = value[4]; let terminal_link = value[5]; let still_capture_method = value[6]; let trigger_support = value[7]; let trigger_usage = value[8]; let control_size = value[9]; if value.len() < 10 + num_formats as usize * control_size as usize { return Err(Error::new( ErrorKind::InvalidDescriptor, "Input Header descriptor too short for reported formats", )); } let controls = value[10..].to_vec(); Ok(InputHeader { num_formats, total_length, endpoint_address, info, terminal_link, still_capture_method, trigger_support, trigger_usage, control_size, controls, }) } } impl From for Vec { fn from(ih: InputHeader) -> Self { let mut ret = Vec::new(); ret.push(ih.num_formats); ret.extend_from_slice(&ih.total_length.to_le_bytes()); ret.push(ih.endpoint_address.into()); ret.push(ih.info); ret.push(ih.terminal_link); ret.push(ih.still_capture_method); ret.push(ih.trigger_support); ret.push(ih.trigger_usage); ret.push(ih.control_size); ret.extend(ih.controls); ret } } #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct OutputHeader { pub num_formats: u8, pub total_length: u16, pub endpoint_address: EndpointAddress, pub terminal_link: u8, pub control_size: u8, pub controls: Vec, } impl TryFrom<&[u8]> for OutputHeader { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 6 { return Err(Error::new_descriptor_len("OutputHeader", 6, value.len())); } let num_formats = value[0]; let total_length = u16::from_le_bytes([value[1], value[2]]); let endpoint_address = EndpointAddress::from(value[3]); let terminal_link = value[4]; let control_size = value[5]; if value.len() < 6 + num_formats as usize * control_size as usize { return Err(Error::new( ErrorKind::InvalidDescriptor, &format!( "Output Header descriptor too short for formats {} < {}", value.len(), 7 + num_formats as usize * control_size as usize ), )); } let controls = value[6..].to_vec(); Ok(OutputHeader { num_formats, total_length, endpoint_address, terminal_link, control_size, controls, }) } } impl From for Vec { fn from(oh: OutputHeader) -> Self { let mut ret = Vec::new(); ret.push(oh.num_formats); ret.extend_from_slice(&oh.total_length.to_le_bytes()); ret.push(oh.endpoint_address.into()); ret.push(oh.terminal_link); ret.push(oh.control_size); ret.extend(oh.controls); ret } } #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct StillImageFrame { pub endpoint_address: EndpointAddress, pub num_image_size_patterns: u8, pub image_size_patterns: Vec<(u16, u16)>, pub num_compression_patterns: u8, pub compression_patterns: Vec, } impl TryFrom<&[u8]> for StillImageFrame { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 3 { return Err(Error::new_descriptor_len("StillImageFrame", 3, value.len())); } let endpoint_address = EndpointAddress::from(value[0]); let num_image_size_patterns = value[1]; let mut image_size_patterns = Vec::new(); let mut offset = 2; if offset + num_image_size_patterns as usize * 4 > value.len() { return Err(Error::new( ErrorKind::InvalidDescriptor, "Still Image Frame descriptor too short for image size patterns", )); } for b in value[offset..].chunks_exact(4) { let width = u16::from_le_bytes([b[0], b[1]]); let height = u16::from_le_bytes([b[2], b[3]]); image_size_patterns.push((width, height)); offset += 4; } let num_compression_patterns = value[offset]; offset += 1; if offset + num_compression_patterns as usize > value.len() { return Err(Error::new( ErrorKind::InvalidDescriptor, "Still Image Frame descriptor too short for compression patterns", )); } let compression_patterns = value[offset..offset + num_compression_patterns as usize].to_vec(); Ok(StillImageFrame { endpoint_address, num_image_size_patterns, image_size_patterns, num_compression_patterns, compression_patterns, }) } } impl From for Vec { fn from(sif: StillImageFrame) -> Self { let mut ret = Vec::new(); ret.push(sif.endpoint_address.into()); ret.push(sif.num_image_size_patterns); for (width, height) in sif.image_size_patterns { ret.extend_from_slice(&width.to_le_bytes()); ret.extend_from_slice(&height.to_le_bytes()); } ret.push(sif.num_compression_patterns); ret.extend(sif.compression_patterns); ret } } #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct ColorFormat { pub color_primaries: u8, pub transfer_characteristics: u8, pub matrix_coefficients: u8, } impl TryFrom<&[u8]> for ColorFormat { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 3 { return Err(Error::new_descriptor_len("ColorFormat", 3, value.len())); } let color_primaries = value[0]; let transfer_characteristics = value[1]; let matrix_coefficients = value[2]; Ok(ColorFormat { color_primaries, transfer_characteristics, matrix_coefficients, }) } } impl From for Vec { fn from(cf: ColorFormat) -> Self { vec![ cf.color_primaries, cf.transfer_characteristics, cf.matrix_coefficients, ] } } #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct FormatStreamBased { pub format_index: u8, pub guid_format: Uuid, pub packet_length: u8, } impl TryFrom<&[u8]> for FormatStreamBased { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 18 { return Err(Error::new_descriptor_len( "FormatStreamBased", 18, value.len(), )); } let format_index = value[0]; let guid_format = Uuid::from_slice_le(&value[1..17]).map_err(|e| { Error::new( ErrorKind::InvalidDescriptor, &format!("Invalid GUID Format: {e}"), ) })?; let packet_length = value[17]; Ok(FormatStreamBased { format_index, guid_format, packet_length, }) } } impl From for Vec { fn from(fsb: FormatStreamBased) -> Self { let mut ret = Vec::new(); ret.push(fsb.format_index); ret.extend(fsb.guid_format.to_bytes_le()); ret.push(fsb.packet_length); ret } } #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct FormatMPEG2TS { pub format_index: u8, pub data_offset: u8, pub packet_length: u8, pub stride_length: u8, pub guid_stride_format: Option, } impl TryFrom<&[u8]> for FormatMPEG2TS { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 4 { return Err(Error::new_descriptor_len("FormatMPEG2TS", 4, value.len())); } let format_index = value[0]; let data_offset = value[1]; let packet_length = value[2]; let stride_length = value[3]; let guid_stride_format = if value.len() < 20 { None } else { Uuid::from_slice_le(&value[4..20]).ok() }; Ok(FormatMPEG2TS { format_index, data_offset, packet_length, stride_length, guid_stride_format, }) } } impl From for Vec { fn from(fmts: FormatMPEG2TS) -> Self { let mut ret = vec![ fmts.format_index, fmts.data_offset, fmts.packet_length, fmts.stride_length, ]; if let Some(guid) = fmts.guid_stride_format { ret.extend(guid.to_bytes_le()); } ret } } #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct FormatMJPEG { pub format_index: u8, pub num_frame_descriptors: u8, pub flags: u8, pub default_frame_index: u8, pub aspect_ratio_x: u8, pub aspect_ratio_y: u8, pub interlace_flags: u8, pub copy_protect: u8, } impl TryFrom<&[u8]> for FormatMJPEG { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 8 { return Err(Error::new_descriptor_len("FormatMJPEG", 8, value.len())); } let format_index = value[0]; let num_frame_descriptors = value[1]; let flags = value[2]; let default_frame_index = value[3]; let aspect_ratio_x = value[4]; let aspect_ratio_y = value[5]; let interlace_flags = value[6]; let copy_protect = value[7]; Ok(FormatMJPEG { format_index, num_frame_descriptors, flags, default_frame_index, aspect_ratio_x, aspect_ratio_y, interlace_flags, copy_protect, }) } } impl From for Vec { fn from(fmjpeg: FormatMJPEG) -> Self { vec![ fmjpeg.format_index, fmjpeg.num_frame_descriptors, fmjpeg.flags, fmjpeg.default_frame_index, fmjpeg.aspect_ratio_x, fmjpeg.aspect_ratio_y, fmjpeg.interlace_flags, fmjpeg.copy_protect, ] } } #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct FormatFrame { pub format_index: u8, pub num_frame_descriptors: u8, pub guid_format: Uuid, pub bits_per_pixel: u8, pub default_frame_index: u8, pub aspect_ratio_x: u8, pub aspect_ratio_y: u8, pub interlace_flags: u8, pub copy_protect: u8, pub variable_size: Option, } impl TryFrom<&[u8]> for FormatFrame { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 24 { return Err(Error::new_descriptor_len("FormatFrame", 24, value.len())); } let format_index = value[0]; let num_frame_descriptors = value[1]; let guid_format = Uuid::from_slice_le(&value[2..18]).map_err(|e| { Error::new( ErrorKind::InvalidDescriptor, &format!("Invalid GUID Format: {e}"), ) })?; let bits_per_pixel = value[18]; let default_frame_index = value[19]; let aspect_ratio_x = value[20]; let aspect_ratio_y = value[21]; let interlace_flags = value[22]; let copy_protect = value[23]; // only present on frame based let variable_size = value.get(24).copied(); Ok(FormatFrame { format_index, num_frame_descriptors, guid_format, bits_per_pixel, default_frame_index, aspect_ratio_x, aspect_ratio_y, interlace_flags, copy_protect, variable_size, }) } } impl From for Vec { fn from(fufb: FormatFrame) -> Self { let mut ret = Vec::new(); ret.push(fufb.format_index); ret.push(fufb.num_frame_descriptors); ret.extend_from_slice(&fufb.guid_format.to_bytes_le()); ret.push(fufb.bits_per_pixel); ret.push(fufb.default_frame_index); ret.push(fufb.aspect_ratio_x); ret.push(fufb.aspect_ratio_y); ret.push(fufb.interlace_flags); ret.push(fufb.copy_protect); if let Some(variable_size) = fufb.variable_size { ret.push(variable_size); } ret } } #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct FrameCommon { pub frame_index: u8, pub capabilities: u8, pub width: u16, pub height: u16, pub min_bit_rate: u32, pub max_bit_rate: u32, } impl TryFrom<&[u8]> for FrameCommon { type Error = Error; fn try_from(value: &[u8]) -> error::Result { if value.len() < 14 { return Err(Error::new_descriptor_len("FrameCommon", 14, value.len())); } let frame_index = value[0]; let capabilities = value[1]; let width = u16::from_le_bytes([value[2], value[3]]); let height = u16::from_le_bytes([value[4], value[5]]); let min_bit_rate = u32::from_le_bytes([value[6], value[7], value[8], value[9]]); let max_bit_rate = u32::from_le_bytes([value[10], value[11], value[12], value[13]]); Ok(FrameCommon { frame_index, capabilities, width, height, min_bit_rate, max_bit_rate, }) } } impl From for Vec { fn from(fc: FrameCommon) -> Self { let mut ret = Vec::new(); ret.push(fc.frame_index); ret.push(fc.capabilities); ret.extend_from_slice(&fc.width.to_le_bytes()); ret.extend_from_slice(&fc.height.to_le_bytes()); ret.extend_from_slice(&fc.min_bit_rate.to_le_bytes()); ret.extend_from_slice(&fc.max_bit_rate.to_le_bytes()); ret } } #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct FrameUncompressed { pub common: FrameCommon, pub max_video_frame_buffer_size: u32, pub default_frame_interval: u32, pub frame_interval_type: u8, pub frame_intervals: Vec, } impl TryFrom<&[u8]> for FrameUncompressed { type Error = Error; fn try_from(value: &[u8]) -> error::Result { let common: FrameCommon = FrameCommon::try_from(value)?; if value.len() < 24 { return Err(Error::new_descriptor_len( "FrameUncompressed", 24, value.len(), )); } let max_video_frame_buffer_size = u32::from_le_bytes([value[14], value[15], value[16], value[17]]); let default_frame_interval = u32::from_le_bytes([value[18], value[19], value[20], value[21]]); let frame_interval_type = value[22]; let frame_intervals = if frame_interval_type == 0 && value.len() >= 35 { vec![ u32::from_le_bytes([value[23], value[24], value[25], value[26]]), u32::from_le_bytes([value[27], value[28], value[29], value[30]]), u32::from_le_bytes([value[31], value[32], value[33], value[34]]), ] } else { if value.len() < 23 + frame_interval_type as usize * 4 { return Err(Error::new( ErrorKind::InvalidDescriptor, &format!( "FrameUncompressed descriptor too short for frame intervals {} < {}", value.len(), 22 + frame_interval_type as usize * 4 ), )); } value[23..] .chunks_exact(4) .take(frame_interval_type as usize) .map(|chunk| u32::from_le_bytes([chunk[0], chunk[1], chunk[2], chunk[3]])) .collect() }; Ok(FrameUncompressed { common, default_frame_interval, frame_interval_type, max_video_frame_buffer_size, frame_intervals, }) } } impl From for Vec { fn from(fu: FrameUncompressed) -> Self { let mut ret = Vec::from(fu.common); ret.extend_from_slice(&fu.max_video_frame_buffer_size.to_le_bytes()); ret.extend_from_slice(&fu.default_frame_interval.to_le_bytes()); ret.push(fu.frame_interval_type); for interval in fu.frame_intervals { ret.extend_from_slice(&interval.to_le_bytes()); } ret } } #[allow(missing_docs)] pub type FrameMJPEG = FrameUncompressed; #[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)] #[allow(missing_docs)] pub struct FrameFrameBased { pub common: FrameCommon, pub default_frame_interval: u32, pub frame_interval_type: u8, pub bytes_per_line: u32, pub frame_intervals: Vec, } impl TryFrom<&[u8]> for FrameFrameBased { type Error = Error; fn try_from(value: &[u8]) -> error::Result { let common: FrameCommon = FrameCommon::try_from(value)?; if value.len() < 24 { return Err(Error::new_descriptor_len( "FrameFrameBased", 24, value.len(), )); } let default_frame_interval = u32::from_le_bytes([value[14], value[15], value[16], value[17]]); let frame_interval_type = value[18]; let bytes_per_line = u32::from_le_bytes([value[19], value[20], value[21], value[22]]); let frame_intervals = if frame_interval_type == 0 && value.len() >= 35 { vec![ u32::from_le_bytes([value[23], value[24], value[25], value[26]]), u32::from_le_bytes([value[27], value[28], value[29], value[30]]), u32::from_le_bytes([value[31], value[32], value[33], value[34]]), ] } else { if value.len() < 23 + frame_interval_type as usize * 4 { return Err(Error::new( ErrorKind::InvalidDescriptor, &format!( "FrameFrameBased descriptor too short for frame intervals {} < {}", value.len(), 23 + frame_interval_type as usize * 4 ), )); } value[23..] .chunks_exact(4) .take(frame_interval_type as usize) .map(|chunk| u32::from_le_bytes([chunk[0], chunk[1], chunk[2], chunk[3]])) .collect() }; Ok(FrameFrameBased { common, default_frame_interval, frame_interval_type, bytes_per_line, frame_intervals, }) } } impl From for Vec { fn from(ffb: FrameFrameBased) -> Self { let mut ret = Vec::from(ffb.common); ret.extend_from_slice(&ffb.default_frame_interval.to_le_bytes()); ret.push(ffb.frame_interval_type); ret.extend_from_slice(&ffb.bytes_per_line.to_le_bytes()); for interval in ffb.frame_intervals { ret.extend_from_slice(&interval.to_le_bytes()); } ret } } cyme-2.2.6/src/usb/path.rs000066400000000000000000000725071506545537300153700ustar00rootroot00000000000000//! Helper functions for USB sysfs style paths //! //! Used for Linux sysfs but also cyme retrieval of USB device information within the [`crate::profiler`] module and [`crate::usb`] module use serde::{Deserialize, Serialize}; use std::fmt; use std::path::{Path, PathBuf}; use super::*; use crate::profiler::SYSFS_USB_PREFIX; /// Represents a USB path in sysfs but used cross-platform to represent paths to USB devices, interfaces and endpoints #[derive(Debug, Clone, Serialize, Deserialize, PartialEq, Eq)] pub struct UsbPath(PathBuf); impl fmt::Display for UsbPath { fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result { write!(f, "{}", self.0.display()) } } impl AsRef for UsbPath { fn as_ref(&self) -> &Path { &self.0 } } impl From for UsbPath { fn from(path: PathBuf) -> Self { Self(path) } } impl From<&Path> for UsbPath { fn from(path: &Path) -> Self { Self(path.to_path_buf()) } } impl UsbPath { /// Create a new USB path pub fn new>(path: P) -> Self { Self(path.as_ref().to_path_buf()) } /// Get the inner path pub fn path(&self) -> &Path { &self.0 } /// Get the parent of the device /// /// ``` /// use cyme::usb::UsbPath; /// use std::path::Path; /// /// let path = UsbPath::new("/sys/bus/usb/devices/1-1.3:1.0/ep_81"); /// assert_eq!(path.parent(), Some(Path::new("/sys/bus/usb/devices"))); /// let path = UsbPath::new("/sys/bus/usb/devices/1-1.3:1.0"); /// assert_eq!(path.parent(), Some(Path::new("/sys/bus/usb/devices"))); /// let path = UsbPath::new("/sys/bus/usb/devices/usb1"); /// assert_eq!(path.parent(), Some(Path::new("/sys/bus/usb/devices"))); /// let path = UsbPath::new("1-1.3:1.0"); /// assert_eq!(path.parent(), None); /// ``` pub fn parent(&self) -> Option<&Path> { // find : in path, work backwards from index to find next / and return path 0..index let path_str = self.path().to_str()?; let index = path_str.rfind('-').or_else(|| path_str.rfind("usb"))?; let index = path_str[..index].rfind('/')?; Some(Path::new(&path_str[..index])) } /// Is the path to a bus controller (root hub); device starts with "usb" in sysfs /// /// ``` /// use cyme::usb::UsbPath; /// let path = UsbPath::new("/sys/bus/usb/devices/usb1"); /// assert!(path.is_bus_controller()); /// let path = UsbPath::new("/sys/bus/usb/devices/1-1.3:1.0"); /// assert!(!path.is_bus_controller()); pub fn is_bus_controller(&self) -> bool { self.sysfs_device() .map(|f| f.starts_with("usb")) .unwrap_or(false) } /// Does the path belong to a root hub /// /// Trunk ends with "-0" in sysfs, e.g. "1-0" or usbX (bus controller). Only root hubs can be port 0 /// /// ``` /// use cyme::usb::UsbPath; /// let path = UsbPath::new("/sys/bus/usb/devices/2-0"); /// assert!(path.is_root_hub()); /// let path = UsbPath::new("/sys/bus/usb/devices/1-0:1.0"); /// assert!(path.is_root_hub()); /// let path = UsbPath::new("/sys/bus/usb/devices/1-1.3:1.0"); /// assert!(!path.is_root_hub()); /// ``` pub fn is_root_hub(&self) -> bool { self.sysfs_trunk() .map(|f| f.ends_with("-0")) .unwrap_or(self.is_bus_controller()) } /// Extract bus number from path /// /// ``` /// use cyme::usb::UsbPath; /// let path = UsbPath::new("/sys/bus/usb/devices/1-1.3:1.0/ep_81"); /// assert_eq!(path.bus(), Some(1)); /// let path = UsbPath::new("1-1.3:1.0"); /// assert_eq!(path.bus(), Some(1)); /// let path = UsbPath::new("usb1"); /// assert_eq!(path.bus(), Some(1)); /// ``` pub fn bus(&self) -> Option { self.port_path().map(|f| f.bus) } /// Extract trunk path from path /// /// The trunk path is the path to the first device on the bus /// /// ``` /// use cyme::usb::UsbPath; /// let path = UsbPath::new("/sys/bus/usb/devices/1-1.3:1.0/ep_81"); /// assert_eq!(path.sysfs_trunk(), Some("1-1")); /// let path = UsbPath::new("1-1.3:1.0"); /// assert_eq!(path.sysfs_trunk(), Some("1-1")); /// let path = UsbPath::new("1-2"); /// assert_eq!(path.sysfs_trunk(), Some("1-2")); /// let path = UsbPath::new("usb1"); /// assert_eq!(path.sysfs_trunk(), Some("usb1")); pub fn sysfs_trunk(&self) -> Option<&str> { self.sysfs_name() .and_then(|f| f.split_once('.').map(|f| f.0).or(Some(f))) } /// The device path could be a base device or a device interface representing a device /// /// It is the path to the device on the bus with any configuration.interface but without any endpoint. On Linux sysfs, this should be a directory with descriptors etc for the interface or device. /// /// If one is looking for the the device without any the interface, use [`UsbPath::sysfs_port_path`] /// /// ``` /// use cyme::usb::UsbPath; /// use std::path::Path; /// let path = UsbPath::new("/sys/bus/usb/devices/1-1.3:1.0/ep_81"); /// assert_eq!(path.sysfs_device_path(), Some(Path::new("/sys/bus/usb/devices/1-1.3:1.0"))); /// let path = UsbPath::new("/sys/bus/usb/devices/1-1.3"); /// assert_eq!(path.sysfs_device_path(), Some(Path::new("/sys/bus/usb/devices/1-1.3"))); /// let path = UsbPath::new("/sys/bus/usb/devices/1-1"); /// assert_eq!(path.sysfs_device_path(), Some(Path::new("/sys/bus/usb/devices/1-1"))); /// let path = UsbPath::new("1-1.3:1.0"); /// assert_eq!(path.sysfs_device_path(), Some(Path::new("1-1.3:1.0"))); /// ``` pub fn sysfs_device_path(&self) -> Option<&Path> { let path_str = self.path().to_str().unwrap(); let index = path_str.rfind('-').or_else(|| path_str.rfind("usb"))?; // now look for next / from index let end_index = path_str[index..] .find('/') .map(|f| f.saturating_add(index)) .unwrap_or(path_str.len()); Some(Path::new(&path_str[..end_index])) } fn sysfs_device_str(&self) -> Option<&str> { self.sysfs_device_path()? .file_name() .and_then(|f| f.to_str()) } /// Extract just the device filename from [`UsbPath::sysfs_device_path`] /// /// Unlike [`UsbPath::sysfs_name`] this could be a fully described configuration.interface directory pub fn sysfs_device(&self) -> Option<&str> { // validate is valid sysfs USB device if self.device_path().is_some() { self.sysfs_device_str() } else { None } } /// Extract [`DevicePath`] from path pub fn device_path(&self) -> Option { self.sysfs_device_str().and_then(|f| f.parse().ok()) } /// Extract device port path from path /// /// The port path is the path to the device on the bus without any configuration.interface. On Linux sysfs, this is the path to the device directory with base device descriptors etc. Use [`UsbPath::sysfs_device_path`] to get the full described path if present. /// /// ``` /// use cyme::usb::UsbPath; /// use std::path::Path; /// /// let path = UsbPath::new("/sys/bus/usb/devices/1-1.3:1.0/ep_81"); /// assert_eq!(path.sysfs_port_path(), Some(Path::new("/sys/bus/usb/devices/1-1.3"))); /// let path = UsbPath::new("1-1.3:1.0"); /// assert_eq!(path.sysfs_port_path(), Some(Path::new("1-1.3"))); /// let path = UsbPath::new("1-2"); /// assert_eq!(path.sysfs_port_path(), Some(Path::new("1-2"))); /// // root hub /// let path = UsbPath::new("/sys/bus/usb/devices/usb1"); /// assert_eq!(path.sysfs_port_path(), Some(Path::new("/sys/bus/usb/devices/usb1"))); /// ``` pub fn sysfs_port_path(&self) -> Option<&Path> { self.sysfs_device_path() .and_then(|f| f.to_str()) .and_then(|f| f.split_once(':').map(|f| f.0).or(Some(f))) .map(Path::new) } fn sysfs_port_str(&self) -> Option<&str> { self.sysfs_port_path() .and_then(|f| f.file_name().and_then(|f| f.to_str())) } /// Extract port path from path /// /// On Linux sysfs, this is the path to the device directory with base device descriptors etc - the device sysfs name. pub fn sysfs_name(&self) -> Option<&str> { if self.port_path().is_some() { self.sysfs_port_str() } else { None } } /// Extract [`PortPath`] from path pub fn port_path(&self) -> Option { self.sysfs_port_str().and_then(|f| f.parse().ok()) } /// Extract configuration number from path /// /// ``` /// use cyme::usb::UsbPath; /// /// let path = UsbPath::new("/sys/bus/usb/devices/1-1.3:1.0"); /// assert_eq!(path.configuration(), Some(1)); /// let path = UsbPath::new("/sys/bus/usb/devices/1-1.3"); /// assert_eq!(path.configuration(), None); /// ``` pub fn configuration(&self) -> Option { self.device_path().and_then(|f| f.config) } /// Extract interface number from path /// /// ``` /// use cyme::usb::UsbPath; /// /// let path = UsbPath::new("/sys/bus/usb/devices/1-1.3:1.0"); /// assert_eq!(path.interface(), Some(0)); /// ``` pub fn interface(&self) -> Option { self.device_path().and_then(|f| f.interface) } fn endpoint_path_str(&self) -> Option<&str> { let path_str = self.path().to_str()?; let index = path_str.rfind("ep_")?; let end_index = path_str[index..] .find('/') .map(|f| f.saturating_add(index)) .unwrap_or(path_str.len()); Some(&path_str[index..end_index]) } /// Extract the [`EndpointPath`] from path pub fn endpoint_path(&self) -> Option { Some(EndpointPath::new_with_device_path( self.device_path()?, self.endpoint()?, )) } /// Extract endpoint number from path /// /// ``` /// use cyme::usb::UsbPath; /// let path = UsbPath::new("/sys/bus/usb/devices/1-1.3:1.0/ep_81"); /// assert_eq!(path.endpoint(), Some(81)); pub fn endpoint(&self) -> Option { self.endpoint_path_str() .and_then(|f| f.strip_prefix("ep_")) .and_then(|f| f.parse().ok()) } /// Convert to sysfs path for reading sysfs properties /// /// If the path is already a sysfs path, it will be returned as is /// /// ``` /// use cyme::usb::UsbPath; /// use std::path::Path; /// let path = UsbPath::new("/sys/bus/usb/devices/1-1.3:1.0/ep_81"); /// assert_eq!(path.to_sysfs_path(), Path::new("/sys/bus/usb/devices/1-1.3:1.0/ep_81")); /// let path = UsbPath::new("1-1.3:1.0"); /// assert_eq!(path.to_sysfs_path(), Path::new("/sys/bus/usb/devices/1-1.3:1.0")); pub fn to_sysfs_path(&self) -> PathBuf { if self.path().starts_with(SYSFS_USB_PREFIX) { self.path().to_path_buf() } else { Path::new(SYSFS_USB_PREFIX).join(self.path()) } } } /// Port path to a device #[derive(Debug, Clone, Serialize, Deserialize, PartialEq, Eq)] pub struct PortPath { /// Bus number bus: u8, /// Port numbers through bus to device ports: Vec, } impl FromStr for PortPath { type Err = Error; fn from_str(s: &str) -> error::Result { // root hub if let Some(s) = s.strip_prefix("usb") { let num = s .parse::() .map_err(|_| Error::new(ErrorKind::Parsing, &format!("Invalid bus number: {s}")))?; Ok(Self { bus: num, ports: vec![], }) } else { // strip out any config.interface, then split by '-' let mut parts = s.split(':').next().unwrap_or(s).split('-'); let bus = parts .next() .ok_or_else(|| Error::new(ErrorKind::Parsing, &format!("No bus number: {s}")))? .parse() .map_err(|_| Error::new(ErrorKind::Parsing, &format!("Invalid bus number: {s}")))?; let ports = parts .next() .ok_or_else(|| Error::new(ErrorKind::Parsing, &format!("No port number: {s}")))? .split('.') .map(|p| p.parse()) .collect::, _>>() .map_err(|_| { Error::new(ErrorKind::Parsing, &format!("Invalid port number: {s}")) })?; Ok(Self { bus, ports }) } } } impl fmt::Display for PortPath { fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result { // root hut if self.ports.is_empty() { if f.alternate() { write!(f, "usb{}", self.bus) } else { write!(f, "{}-0", self.bus) } } else { write!(f, "{}-{}", self.bus, self.ports.iter().format(".")) } } } impl TryFrom<&Path> for PortPath { type Error = Error; fn try_from(s: &Path) -> error::Result { s.file_name() .and_then(|f| f.to_str()) .ok_or_else(|| Error::new(ErrorKind::InvalidPath, "Invalid path")) .and_then(|f| f.parse()) } } impl TryFrom<&str> for PortPath { type Error = Error; fn try_from(s: &str) -> error::Result { s.parse() } } impl From for UsbPath { fn from(p: PortPath) -> Self { UsbPath::new(p.to_string()) } } impl From<&PortPath> for UsbPath { fn from(p: &PortPath) -> Self { UsbPath::new(p.to_string()) } } impl PortPath { /// Create a new port path from bus number and port tree positions pub fn new(bus: u8, ports: Vec) -> Self { Self { bus, ports } } /// Get the bus number pub fn bus(&self) -> u8 { self.bus } /// Get the port tree positions pub fn ports(&self) -> &[u8] { &self.ports } /// Get the parent port path; one branch up the tree /// /// ``` /// use cyme::usb::PortPath; /// let path = PortPath::new(1, vec![1, 3, 4, 5]); /// assert_eq!(path.parent(), Some(PortPath::new(1, vec![1, 3, 4]))); /// let path = PortPath::new(1, vec![]); /// assert_eq!(path.parent(), None); /// ``` pub fn parent(&self) -> Option { if self.ports.is_empty() { None } else { Some(Self { bus: self.bus, ports: self.ports[..self.ports.len() - 1].to_vec(), }) } } /// Get the trunk port path; the first device in the tree /// /// ``` /// use cyme::usb::PortPath; /// let path = PortPath::new(1, vec![1, 3, 5, 6]); /// assert_eq!(path.trunk(), PortPath::new(1, vec![1])); /// let path = PortPath::new(1, vec![2]); /// assert_eq!(path.trunk(), PortPath::new(1, vec![2])); /// // root hub /// let path = PortPath::new(2, vec![]); /// assert_eq!(path.trunk(), PortPath::new(2, vec![])); /// ``` pub fn trunk(&self) -> Self { if self.ports.is_empty() { Self { bus: self.bus, ports: vec![], } } else { Self { bus: self.bus, ports: vec![self.ports[0]], } } } /// Get the branch depth in the port tree - length of ports vector pub fn depth(&self) -> usize { self.ports.len() } /// Is the port path to a root hub pub fn is_root_hub(&self) -> bool { self.ports.is_empty() || self.ports == [0] } } /// Helper type for defining the location of a [`Configuration`] /// /// A configuration does not exist in sysfs without an interface so this is used internally to get a [`Configuration`] from a [`PortPath`] pub type ConfigurationPath = (PortPath, u8); /// Device path to a device /// /// A device path is a port path with optional configuration and interface numbers. It is used to represent a device in sysfs, which could mean a base device or a device interface. #[derive(Debug, Clone, Serialize, Deserialize, PartialEq, Eq)] pub struct DevicePath { port_path: PortPath, config: Option, interface: Option, alt_setting: Option, } impl FromStr for DevicePath { type Err = Error; fn from_str(s: &str) -> error::Result { let (p, ci) = s.split_once(':').unwrap_or((s, "")); let port_path = p.parse()?; let mut parts = ci.split('.'); // make sure both config and interface are present if one is match ( parts.next().and_then(|f| f.parse::().ok()), parts.next().and_then(|f| f.parse::().ok()), ) { (Some(config), Some(interface)) => Ok(Self { port_path, config: Some(config), interface: Some(interface), alt_setting: None, }), _ => Ok(Self { port_path, config: None, interface: None, alt_setting: None, }), } } } impl fmt::Display for DevicePath { fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result { write!(f, "{}", self.port_path)?; // only write config.interface if both are present // one does not get path with just config or interface if let (Some(config), Some(interface)) = (self.config, self.interface) { write!(f, ":{config}")?; write!(f, ".{interface}")?; } Ok(()) } } impl TryFrom<&Path> for DevicePath { type Error = Error; fn try_from(s: &Path) -> error::Result { s.file_name() .and_then(|f| f.to_str()) .ok_or_else(|| Error::new(ErrorKind::InvalidPath, "Invalid path")) .and_then(|f| f.parse()) } } impl From for PortPath { fn from(d: DevicePath) -> Self { d.port_path } } impl From for DevicePath { fn from(p: PortPath) -> Self { Self { port_path: p, config: None, interface: None, alt_setting: None, } } } impl From<&DevicePath> for UsbPath { fn from(d: &DevicePath) -> Self { UsbPath::new(d.to_string()) } } impl From for UsbPath { fn from(d: DevicePath) -> Self { UsbPath::new(d.to_string()) } } impl DevicePath { /// Create a new device path from [`PortPath`], configuration and interface pub fn new_with_port_path( port_path: PortPath, config: Option, interface: Option, alt_setting: Option, ) -> Self { Self { port_path, config, interface, alt_setting, } } /// Create a new device path from bus number, port tree positions, configuration and interface pub fn new( bus: u8, ports: Vec, config: Option, interface: Option, alt_setting: Option, ) -> Self { Self { port_path: PortPath::new(bus, ports), config, interface, alt_setting, } } /// Get the port path pub fn port_path(&self) -> &PortPath { &self.port_path } /// Get the configuration number pub fn configuration(&self) -> Option { self.config } /// Get the interface number pub fn interface(&self) -> Option { self.interface } /// Get the interface alternate setting /// /// If not set, it defaults to 0 pub fn alt_setting(&self) -> u8 { self.alt_setting.unwrap_or(0) } /// Set the interface alternate setting pub fn set_alt_setting(&mut self, alt: u8) { self.alt_setting = Some(alt); } } /// Path to an endpoint on a device #[derive(Debug, Clone, Serialize, Deserialize, PartialEq, Eq)] pub struct EndpointPath { device_path: DevicePath, endpoint: u8, } impl FromStr for EndpointPath { type Err = Error; fn from_str(s: &str) -> error::Result { let mut parts = s.split("/ep_"); if let (Some(d), Some(e)) = (parts.next(), parts.next()) { let device_path: DevicePath = d.parse()?; // thought about this but there are actually base device (1-1) with ep_00 so it is valid, just not used by cyme //if device_path.configuration().is_none() || device_path.interface().is_none() { // return Err(Error::new( // ErrorKind::Parsing, // &format!("Invalid endpoint path {}: requires config.interface", s), // )); //} let endpoint = e .parse() .map_err(|_| Error::new(ErrorKind::Parsing, &format!("Invalid endpoint: {e}")))?; Ok(Self { device_path, endpoint, }) } else { Err(Error::new( ErrorKind::Parsing, &format!("Invalid endpoint path: {s}"), )) } } } impl TryFrom<&Path> for EndpointPath { type Error = Error; fn try_from(s: &Path) -> error::Result { s.to_str() .ok_or_else(|| Error::new(ErrorKind::InvalidPath, "Invalid path")) .and_then(|f| f.parse()) } } impl fmt::Display for EndpointPath { fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result { write!(f, "{}", self.device_path)?; write!(f, "/ep_{}", self.endpoint) } } impl From for UsbPath { fn from(ep: EndpointPath) -> Self { UsbPath::new(ep.device_path.to_string()) } } impl EndpointPath { /// Create a new endpoint path from [`PortPath`], configuration, interface and endpoint number pub fn new_with_device_path(device_path: DevicePath, endpoint: u8) -> Self { Self { device_path, endpoint, } } /// Create a new endpoint path from [`PortPath`], configuration, interface and endpoint number pub fn new_with_port_path( port_path: PortPath, config: u8, interface: u8, alt_setting: u8, endpoint: u8, ) -> Self { Self { device_path: DevicePath::new_with_port_path( port_path, Some(config), Some(interface), Some(alt_setting), ), endpoint, } } /// Create a new endpoint path from bus number, port tree positions, configuration, interface and endpoint number pub fn new( bus: u8, ports: Vec, config: u8, interface: u8, alt_setting: u8, endpoint: u8, ) -> Self { Self { device_path: DevicePath::new( bus, ports, Some(config), Some(interface), Some(alt_setting), ), endpoint, } } /// Get the device path pub fn device_path(&self) -> &DevicePath { &self.device_path } /// Get the endpoint address byte pub fn endpoint(&self) -> u8 { self.endpoint } /// Get the [`EndpointAddress`] from the endpoint number pub fn endpoint_address(&self) -> EndpointAddress { EndpointAddress::from(self.endpoint) } } /// Builds a replica of sysfs path; excludes config.interface /// /// ``` /// use cyme::usb::get_port_path; /// /// assert_eq!(get_port_path(1, &[1, 3, 2]), String::from("1-1.3.2")); /// assert_eq!(get_port_path(1, &[2]), String::from("1-2")); /// // special case for root_hub /// assert_eq!(get_port_path(2, &[]), String::from("2-0")); /// ``` /// /// [ref](http://gajjarpremal.blogspot.com/2015/04/sysfs-structures-for-linux-usb.html) /// The names that begin with "usb" refer to USB controllers. More accurately, they refer to the "root hub" associated with each controller. The number is the USB bus number. In the example there is only one controller, so its bus is number 1. Hence the name "usb1". /// /// "1-0:1.0" is a special case. It refers to the root hub's interface. This acts just like the interface in an actual hub an almost every respect; see below. /// All the other entries refer to genuine USB devices and their interfaces. The devices are named by a scheme like this: /// /// bus-port.port.port ... pub fn get_port_path(bus: u8, ports: &[u8]) -> String { if ports.is_empty() { // special case for root_hub format!("{bus:}-0") } else { format!("{:}-{}", bus, ports.iter().format(".")) } } /// Parent path is path to parent device /// ``` /// use cyme::usb::get_parent_path; /// /// assert_eq!(get_parent_path(1, &[1, 3, 4, 5]), Some(String::from("1-1.3.4"))); /// ``` pub fn get_parent_path(bus: u8, ports: &[u8]) -> Option { if ports.is_empty() { None } else { Some(get_port_path(bus, &ports[..ports.len() - 1])) } } /// Trunk path is path to trunk device on bus /// ``` /// use cyme::usb::get_trunk_path; /// /// assert_eq!(get_trunk_path(1, &[1, 3, 5, 6]), String::from("1-1")); /// // special case for root_hub /// assert_eq!(get_trunk_path(1, &[]), String::from("1-0")); /// ``` pub fn get_trunk_path(bus: u8, ports: &[u8]) -> String { if ports.is_empty() { // special case for root_hub format!("{bus:}-0") } else { format!("{:}-{}", bus, ports[0]) } } /// Build replica of sysfs path with interface /// /// ``` /// use cyme::usb::get_interface_path; /// /// assert_eq!(get_interface_path(1, &[1, 3], 1, 0), String::from("1-1.3:1.0")); /// // bus /// assert_eq!(get_interface_path(1, &[], 1, 0), String::from("1-0:1.0")); /// ``` pub fn get_interface_path(bus: u8, ports: &[u8], config: u8, interface: u8) -> String { format!("{}:{}.{}", get_port_path(bus, ports), config, interface) } /// Build replica of sysfs path to endpoint /// /// ``` /// use cyme::usb::get_endpoint_path; /// use std::path::PathBuf; /// /// assert_eq!(get_endpoint_path(1, &[1, 3], 1, 0, 81), PathBuf::from("1-1.3:1.0/ep_81")); /// ``` pub fn get_endpoint_path( bus: u8, ports: &[u8], config: u8, interface: u8, endpoint: u8, ) -> PathBuf { format!( "{}/ep_{}", get_interface_path(bus, ports, config, interface), endpoint ) .into() } /// Build replica of Linux dev path from libusb.c *devbususb for getting device with -D /// /// It's /dev/bus/usb/BUS/DEVNO /// /// Supply `device_no` as None for bus /// /// ``` /// use cyme::usb::get_dev_path; /// use std::path::PathBuf; /// /// assert_eq!(get_dev_path(1, Some(3)), PathBuf::from("/dev/bus/usb/001/003")); /// assert_eq!(get_dev_path(1, Some(2)), PathBuf::from("/dev/bus/usb/001/002")); /// // special case for bus /// assert_eq!(get_dev_path(1, None), PathBuf::from("/dev/bus/usb/001/001")); /// ``` pub fn get_dev_path(bus: u8, device_no: Option) -> PathBuf { if let Some(devno) = device_no { format!("/dev/bus/usb/{bus:03}/{devno:03}").into() } else { format!("/dev/bus/usb/{bus:03}/001").into() } } /// Builds a replica of sysfs name for reading sysfs_props ala: /// /// Like `get_port_path` but root_hubs use the USB controller name (usbX) rather than interface /// /// ``` /// use cyme::usb::get_sysfs_name; /// /// assert_eq!(get_sysfs_name(1, &vec![1, 3, 2]), String::from("1-1.3.2")); /// assert_eq!(get_sysfs_name(1, &vec![2]), String::from("1-2")); /// // special case for root_hub /// assert_eq!(get_sysfs_name(2, &vec![]), String::from("usb2")); /// ``` pub fn get_sysfs_name(bus: u8, ports: &[u8]) -> String { if ports.is_empty() { // special case for root_hub format!("usb{bus}") } else { get_port_path(bus, ports) } } #[cfg(test)] mod test { use super::*; #[test] fn test_port_path_parse() { assert_eq!( "1-1.3.4".parse::(), Ok(PortPath { bus: 1, ports: vec![1, 3, 4] }) ); assert_eq!( "1-1.3".parse::(), Ok(PortPath { bus: 1, ports: vec![1, 3] }) ); assert_eq!( "1-2".parse::(), Ok(PortPath { bus: 1, ports: vec![2] }) ); assert_eq!( "1-0:1-0".parse::(), Ok(PortPath { bus: 1, ports: vec![0] }) ); assert_eq!( "usb1".parse::(), Ok(PortPath { bus: 1, ports: vec![] }) ); } #[test] fn test_port_path_display() { assert_eq!( PortPath { bus: 1, ports: vec![1, 3, 4] } .to_string(), "1-1.3.4" ); assert_eq!( PortPath { bus: 1, ports: vec![1, 3] } .to_string(), "1-1.3" ); assert_eq!( PortPath { bus: 1, ports: vec![2] } .to_string(), "1-2" ); assert_eq!( PortPath { bus: 1, ports: vec![0] } .to_string(), "1-0" ); assert_eq!( PortPath { bus: 1, ports: vec![] } .to_string(), "1-0" ); } } cyme-2.2.6/src/watch.rs000066400000000000000000001572701506545537300147520ustar00rootroot00000000000000//! Watch for USB devices being connected and disconnected. use cansi::v3::{categorise_text, construct_text_no_codes}; use clap::ValueEnum; use colored::*; use crossterm::{ cursor, event::{ self, Event, KeyCode, KeyEvent, KeyEventKind, KeyModifiers, MouseEvent, MouseEventKind, }, execute, style::Print, terminal, }; use futures_lite::stream::StreamExt; use std::env; use std::io::stdout; use std::io::Write; use std::sync::{mpsc, Arc, Mutex}; use std::thread; use super::parse_vidpid; use cyme::config::Config; use cyme::display::*; use cyme::error::{Error, ErrorKind, Result}; use cyme::profiler::{watch::SystemProfileStreamBuilder, Filter, SystemProfile}; #[derive(Debug, Clone)] #[allow(dead_code)] enum WatchEvent { ScrollUp(usize), ScrollUpHalf, ScrollUpPage, ScrollDown(usize), ScrollDownHalf, ScrollDownPage, MoveUp(usize), MoveDown(usize), EditFilter(FilterField), ToggleBuses, ToggleHubs, ExpandSelected, PushFilter(char), PopFilter, EditBlock(BlockType), MoveBlockUp(usize), MoveBlockDown(usize), ToggleBlock, Error(String), Resize, DrawDevices, DrawEditBlocks, WriteEditBlocks, ConfirmSave(String), SaveConfig, Draw, ShowHelp, Enter, Esc, Quit, } /// Distinguish which set of blocks we’re editing #[derive(Debug, Clone, Copy, strum_macros::Display)] enum BlockType { Device, Bus, Config, Interface, Endpoint, } impl BlockType { fn next(&self) -> Self { match self { BlockType::Bus => BlockType::Device, BlockType::Device => BlockType::Config, BlockType::Config => BlockType::Interface, BlockType::Interface => BlockType::Endpoint, BlockType::Endpoint => BlockType::Bus, } } fn prev(&self) -> Self { match self { BlockType::Bus => BlockType::Endpoint, BlockType::Device => BlockType::Bus, BlockType::Config => BlockType::Device, BlockType::Interface => BlockType::Config, BlockType::Endpoint => BlockType::Interface, } } fn key_number(&self) -> char { match self { BlockType::Bus => '1', BlockType::Device => '2', BlockType::Config => '3', BlockType::Interface => '4', BlockType::Endpoint => '5', } } } #[derive(Debug, Clone)] enum State { Normal, EditingFilter { field: FilterField, buffer: Option, original: Option, }, BlockEditor { block_type: BlockType, selected_index: usize, // Box would be nice with downcast back to print_settings concrete type // Block is currently not dyn-compatible however so serialize and deserialize works... blocks: Vec<(ColoredString, bool)>, }, Help, Error(String), Confirm(String, WatchEvent), } #[derive(Debug, Clone)] enum FilterField { Name, Serial, VidPid, Class, } #[derive(Debug)] struct Display { buffer: Vec, spusb: Arc>, print_settings: Arc>, filter: Filter, state: Arc>, /// Size of current window terminal_size: (u16, u16), /// Currently selected line /// /// Already accounts for header and footer selected_line: Option, /// Number of rows available for output available_rows: usize, /// Maximum offset for scrolling max_offset: usize, /// Number of lines in the buffer lines: usize, /// Current scroll offset scroll_offset: usize, /// Line context provides lookup for selected item line_context: Vec, /// Selected line context selected_item: Option, } fn set_filter(field: &FilterField, value: Option, filter: &mut Filter) -> Result<()> { match field { FilterField::Name => filter.name = value, FilterField::Serial => filter.serial = value, FilterField::VidPid => match value { Some(s) => { let (vid, pid) = parse_vidpid(&s)?; filter.vid = vid; filter.pid = pid; } None => { filter.vid = None; filter.pid = None; } }, FilterField::Class => match value { Some(s) => { filter.class = Some( cyme::usb::BaseClass::from_str(&s, true) .map_err(|e| Error::new(ErrorKind::Parsing, &e.to_string()))?, ); } None => filter.class = None, }, }; Ok(()) } fn strip_ansi_codes(input: &str) -> String { let decolored = categorise_text(input); construct_text_no_codes(&decolored) } fn print_json( spusb: &mut SystemProfile, filter: Option<&Filter>, print_settings: &PrintSettings, ) -> Result<()> { cyme::display::prepare(spusb, filter, print_settings); let json = serde_json::to_string(&spusb)?; println!("{json}"); Ok(()) } pub fn watch_usb_devices_json( spusb: SystemProfile, filter: Option, print_settings: PrintSettings, ) -> Result<()> { // pass spusb to stream builder, will get Arc> back below let mut profile_stream = SystemProfileStreamBuilder::new() .with_spusb(spusb) .is_verbose(print_settings.verbosity > 0) .build() .map_err(|e| Error::new(ErrorKind::Nusb, &e.to_string()))?; let (tx, rx) = mpsc::channel::(); let print_settings = Arc::new(Mutex::new(print_settings)); let spusb = profile_stream.get_profile(); // first draw queue event tx.send(WatchEvent::DrawDevices).unwrap(); // Thread to listen for USB profiling events let tx_clone = tx.clone(); thread::spawn(move || { futures_lite::future::block_on(async { while profile_stream.next().await.is_some() { tx_clone.send(WatchEvent::DrawDevices).unwrap(); } }); }); loop { match rx.recv() { Ok(WatchEvent::DrawDevices) => { let print_settings = print_settings.lock().unwrap(); print_json(&mut spusb.lock().unwrap(), filter.as_ref(), &print_settings)?; } Ok(_) => { // ignore other events } Err(_) => { break; } } } Ok(()) } pub fn watch_usb_devices( spusb: SystemProfile, filter: Option, mut print_settings: PrintSettings, mut config: Config, ) -> Result<()> { // set print mode to dynamic so we can update the display without re-running the profiler // non-destructively hides devices that don't match the filter etc. print_settings.print_mode = PrintMode::Dynamic; // make sure we have blocks if print_settings.device_blocks.is_none() { print_settings.device_blocks = Some(DeviceBlocks::default_watch_blocks( print_settings.verbosity > 0, print_settings.tree, )); } print_settings.bus_blocks = print_settings.bus_blocks.or(Some(BusBlocks::default_blocks( print_settings.verbosity > 0, ))); print_settings.config_blocks = print_settings .config_blocks .or(Some(ConfigurationBlocks::default_blocks( print_settings.verbosity > 0, ))); print_settings.interface_blocks = print_settings .interface_blocks .or(Some(InterfaceBlocks::default_blocks( print_settings.verbosity > 0, ))); print_settings.endpoint_blocks = print_settings .endpoint_blocks .or(Some(EndpointBlocks::default_blocks( print_settings.verbosity > 0, ))); let mut stdout = stdout(); execute!( stdout, // alternative screen like other terminal apps so main screen buffer isn't cleared terminal::EnterAlternateScreen, cursor::Hide, terminal::Clear(terminal::ClearType::All) ) .map_err(|e| Error::new(ErrorKind::Other("crossterm"), &e.to_string()))?; terminal::enable_raw_mode()?; // pass spusb to stream builder, will get Arc> back below let mut profile_stream = SystemProfileStreamBuilder::new() .with_spusb(spusb) .is_verbose(true) // because print_settings can change verbosity, always capture full device data .build() .map_err(|e| Error::new(ErrorKind::Nusb, &e.to_string()))?; let (tx, rx) = mpsc::channel::(); let print_settings = Arc::new(Mutex::new(print_settings)); let input_mode = Arc::new(Mutex::new(State::Normal)); // first draw tx.send(WatchEvent::DrawDevices).unwrap(); let mut display = Display { buffer: Vec::new(), // get a reference to the SystemProfile now since profile_stream can't be moved // main thread needs to draw with SystemProfile outside of the stream spusb: profile_stream.get_profile(), print_settings: print_settings.clone(), filter: filter.unwrap_or_default(), state: input_mode.clone(), terminal_size: terminal::size().unwrap_or((80, 24)), lines: 0, available_rows: 0, max_offset: 0, scroll_offset: 0, selected_line: None, selected_item: None, line_context: Vec::new(), }; // Thread to listen for USB profiling events let tx_clone = tx.clone(); // Flag to stop threads when exiting main loop and prevent sending on closed channel let stop_flag = Arc::new(Mutex::new(false)); let stop_clone = stop_flag.clone(); thread::spawn(move || { futures_lite::future::block_on(async { while profile_stream.next().await.is_some() { // local spusb Arc> is updated since we have a reference to it if *stop_clone.lock().unwrap() { break; } tx_clone.send(WatchEvent::DrawDevices).unwrap(); } }); }); // Thread to listen for terminal events let stop_clone = stop_flag.clone(); thread::spawn(move || loop { let send_wrapper = |e: WatchEvent| { if *stop_clone.lock().unwrap() { return true; } tx.send(e).unwrap(); false }; match event::read().unwrap() { Event::Resize(_, _) => { if send_wrapper(WatchEvent::Resize) { break; } } Event::Mouse(MouseEvent { kind, .. }) => match kind { MouseEventKind::ScrollUp => { if send_wrapper(WatchEvent::ScrollUp(1)) { break; } } MouseEventKind::ScrollDown => { if send_wrapper(WatchEvent::ScrollDown(1)) { break; } } _ => (), }, Event::Key(key_event) => { if *stop_clone.lock().unwrap() { break; } input_mode.lock().unwrap().process_key_event( key_event, tx.clone(), print_settings.clone(), ); } _ => (), } if *stop_clone.lock().unwrap() { break; } }); // Main event loop // manages the display and listens for events loop { match rx.recv() { Ok(WatchEvent::ScrollUp(n)) => { display.scroll_offset = display.scroll_offset.saturating_sub(n); display.scroll_check_selected_visable(); } Ok(WatchEvent::ScrollUpHalf) => { display.scroll_offset = display .scroll_offset .saturating_sub(display.available_rows / 2); display.scroll_check_selected_visable(); } Ok(WatchEvent::ScrollUpPage) => { display.scroll_offset = display.scroll_offset.saturating_sub(display.available_rows); display.scroll_check_selected_visable(); } Ok(WatchEvent::ScrollDown(n)) => { display.scroll_offset = display .max_offset .min(display.scroll_offset.saturating_add(n)); display.scroll_check_selected_visable(); } Ok(WatchEvent::ScrollDownHalf) => { display.scroll_offset = display.max_offset.min( display .scroll_offset .saturating_add(display.available_rows / 2), ); display.scroll_check_selected_visable(); } Ok(WatchEvent::ScrollDownPage) => { display.scroll_offset = display .max_offset .min(display.scroll_offset.saturating_add(display.max_offset)); display.scroll_check_selected_visable(); } Ok(WatchEvent::MoveUp(n)) => { display.move_up(n); if let Some(l) = display.selected_line { if l < display.scroll_offset { display.scroll_offset = display .scroll_offset .saturating_sub(display.scroll_offset - l); } } } Ok(WatchEvent::MoveDown(n)) => { display.move_down(n); if let Some(l) = display.selected_line { if l >= display.scroll_offset + display.available_rows { display.scroll_offset = display.scroll_offset.saturating_add( l - (display.scroll_offset + display.available_rows) + 1, ); } } } Ok(WatchEvent::ExpandSelected) => { display.toggle_selected(false); } Ok(WatchEvent::EditFilter(field)) => { let original = match field { FilterField::Name => display.filter.name.clone(), FilterField::Serial => display.filter.serial.clone(), FilterField::VidPid => match (display.filter.vid, display.filter.pid) { (Some(vid), Some(pid)) => Some(format!("{vid:04x}:{pid:04x}")), (Some(vid), None) => Some(format!("{vid:04x}")), _ => None, }, FilterField::Class => display.filter.class.map(|c| c.to_string()), }; *display.state.lock().unwrap() = State::EditingFilter { field, buffer: original.clone(), original, }; } Ok(WatchEvent::PushFilter(c)) => { let mut input_mode = display.state.lock().unwrap(); if let State::EditingFilter { field, buffer, .. } = &mut *input_mode { buffer.get_or_insert_with(String::new).push(c); match field { FilterField::Serial | FilterField::Name => { if let Err(e) = set_filter(field, buffer.clone(), &mut display.filter) { *input_mode = State::Error(e.to_string()); } } _ => (), } } } Ok(WatchEvent::PopFilter) => { let mut input_mode = display.state.lock().unwrap(); if let State::EditingFilter { field, buffer, .. } = &mut *input_mode { if let Some(b) = buffer { let ret = b.pop(); if b.is_empty() | ret.is_none() { buffer.take(); } }; match field { FilterField::Serial | FilterField::Name => { if let Err(e) = set_filter(field, buffer.clone(), &mut display.filter) { *input_mode = State::Error(e.to_string()); } } _ => (), } } } Ok(WatchEvent::ToggleBuses) => { display.filter.exclude_empty_bus = !display.filter.exclude_empty_bus; } Ok(WatchEvent::ToggleHubs) => { display.filter.exclude_empty_hub = !display.filter.exclude_empty_hub; } Ok(WatchEvent::Enter) => { let new_mode = match &*display.state.lock().unwrap() { State::EditingFilter { field, buffer, .. } => { if let Err(e) = set_filter(field, buffer.to_owned(), &mut display.filter) { State::Error(e.to_string()) } else { State::Normal } } State::Normal => { display.toggle_selected(true); State::Normal } _ => State::Normal, }; *display.state.lock().unwrap() = new_mode; display.prepare_devices(); display.draw_devices()?; } Ok(WatchEvent::Error(msg)) => { *display.state.lock().unwrap() = State::Error(msg); display.draw()?; } Ok(WatchEvent::ConfirmSave(msg)) => { *display.state.lock().unwrap() = State::Confirm(msg, WatchEvent::SaveConfig); display.draw()?; } Ok(WatchEvent::Resize) => { // resize needs to redraw devices as columns may have changed but not block editor if !matches!(&*display.state.lock().unwrap(), State::BlockEditor { .. }) { display.print_settings.lock().unwrap().terminal_size = terminal::size().ok(); display.draw_devices()?; } display.draw()?; } Ok(WatchEvent::DrawDevices) => { display.prepare_devices(); display.draw_devices()?; } Ok(WatchEvent::EditBlock(block_type)) => { display.prepare_edit_blocks(block_type); } Ok(WatchEvent::MoveBlockUp(n)) => { if let State::BlockEditor { selected_index, blocks, .. } = &mut *display.state.lock().unwrap() { if *selected_index != 0 { blocks.swap(*selected_index, selected_index.saturating_sub(n)); *selected_index = selected_index.saturating_sub(n); display.selected_line = Some(*selected_index); } } } Ok(WatchEvent::MoveBlockDown(n)) => { if let State::BlockEditor { selected_index, blocks, .. } = &mut *display.state.lock().unwrap() { if *selected_index < blocks.len() - 1 { blocks.swap(*selected_index, selected_index.saturating_add(n)); *selected_index = selected_index.saturating_add(n); display.selected_line = Some(*selected_index); } } } Ok(WatchEvent::ToggleBlock) => { if let State::BlockEditor { selected_index, blocks, .. } = &mut *display.state.lock().unwrap() { if *selected_index < blocks.len() { blocks[*selected_index].1 = !blocks[*selected_index].1; } } } Ok(WatchEvent::DrawEditBlocks) => { display.draw_edit_blocks()?; } Ok(WatchEvent::WriteEditBlocks) => { display.write_edit_blocks(); } Ok(WatchEvent::SaveConfig) => { config.merge_print_settings(&display.print_settings.lock().unwrap()); if let Err(e) = config.save() { *display.state.lock().unwrap() = State::Error(e.to_string()); display.prepare_devices(); display.draw_devices()?; } } Ok(WatchEvent::ShowHelp) => { *display.state.lock().unwrap() = State::Help; display.draw_help()?; } Ok(WatchEvent::Draw) => { display.draw()?; } Ok(WatchEvent::Esc) => { let new_mode = match &*display.state.lock().unwrap() { // clear selected item State::Normal => { display.selected_line = None; display.selected_item = None; State::Normal } State::EditingFilter { field, original, .. } => match set_filter(field, original.to_owned(), &mut display.filter) { Ok(_) => State::Normal, Err(e) => { // original must be bad so clear it set_filter(field, None, &mut display.filter)?; State::Error(e.to_string()) } }, _ => State::Normal, }; *display.state.lock().unwrap() = new_mode; display.prepare_devices(); display.draw_devices()?; } Ok(WatchEvent::Quit) => { *stop_flag.lock().unwrap() = true; break; } Err(_) => { break; } } } execute!( stdout, terminal::Clear(terminal::ClearType::All), terminal::LeaveAlternateScreen, cursor::Show, ) .map_err(|e| Error::new(ErrorKind::Other("crossterm"), &e.to_string()))?; terminal::disable_raw_mode()?; Ok(()) } impl State { fn process_normal_mode( event: KeyEvent, tx: mpsc::Sender, print_settings: Arc>, ) { let KeyEvent { code, modifiers, .. } = event; match (code, modifiers) { (KeyCode::Enter, _) => { tx.send(WatchEvent::Enter).unwrap(); } (KeyCode::Char(' '), _) => { tx.send(WatchEvent::ExpandSelected).unwrap(); tx.send(WatchEvent::DrawDevices).unwrap(); } (KeyCode::Char('?'), _) => { tx.send(WatchEvent::ShowHelp).unwrap(); } (KeyCode::Char('q'), _) => { tx.send(WatchEvent::Quit).unwrap(); } (KeyCode::Char('v'), _) => { let mut print_settings = print_settings.lock().unwrap(); print_settings.verbosity = (print_settings.verbosity + 1) % 4; tx.send(WatchEvent::DrawDevices).unwrap(); } (KeyCode::Char('t'), _) => { let mut print_settings = print_settings.lock().unwrap(); print_settings.tree = !print_settings.tree; tx.send(WatchEvent::DrawDevices).unwrap(); } (KeyCode::Char('h'), _) => { let mut print_settings = print_settings.lock().unwrap(); print_settings.headings = !print_settings.headings; tx.send(WatchEvent::DrawDevices).unwrap(); } (KeyCode::Char('o'), _) => { let mut print_settings = print_settings.lock().unwrap(); print_settings.decimal = !print_settings.decimal; tx.send(WatchEvent::DrawDevices).unwrap(); } (KeyCode::Char('p'), _) => { let mut print_settings = print_settings.lock().unwrap(); match print_settings.sort_devices { Sort::BranchPosition => print_settings.sort_devices = Sort::DeviceNumber, _ => print_settings.sort_devices = Sort::BranchPosition, } tx.send(WatchEvent::DrawDevices).unwrap(); } (KeyCode::Char('a'), _) => { let mut print_settings = print_settings.lock().unwrap(); match print_settings.encoding { Encoding::Glyphs => print_settings.encoding = Encoding::Ascii, _ => print_settings.encoding = Encoding::Glyphs, } tx.send(WatchEvent::DrawDevices).unwrap(); } (KeyCode::Char('j'), KeyModifiers::NONE) | (KeyCode::Down, _) => { tx.send(WatchEvent::MoveDown(1)).unwrap(); tx.send(WatchEvent::Draw).unwrap(); } (KeyCode::Char('k'), KeyModifiers::NONE) | (KeyCode::Up, _) => { tx.send(WatchEvent::MoveUp(1)).unwrap(); tx.send(WatchEvent::Draw).unwrap(); } (KeyCode::Char('/'), _) => { tx.send(WatchEvent::EditFilter(FilterField::Name)).unwrap(); tx.send(WatchEvent::DrawDevices).unwrap(); } (KeyCode::Char('\\'), _) => { tx.send(WatchEvent::ToggleBuses).unwrap(); tx.send(WatchEvent::DrawDevices).unwrap(); } (KeyCode::Char(';'), _) => { tx.send(WatchEvent::ToggleHubs).unwrap(); tx.send(WatchEvent::DrawDevices).unwrap(); } (KeyCode::Char('#'), _) => { tx.send(WatchEvent::EditFilter(FilterField::VidPid)) .unwrap(); tx.send(WatchEvent::DrawDevices).unwrap(); } (KeyCode::Char('c'), _) => { tx.send(WatchEvent::EditFilter(FilterField::Class)).unwrap(); tx.send(WatchEvent::DrawDevices).unwrap(); } (KeyCode::Char('s'), KeyModifiers::NONE) => { tx.send(WatchEvent::EditFilter(FilterField::Serial)) .unwrap(); tx.send(WatchEvent::DrawDevices).unwrap(); } (KeyCode::Char('b'), _) => { tx.send(WatchEvent::EditBlock(BlockType::Device)).unwrap(); tx.send(WatchEvent::DrawEditBlocks).unwrap(); } (KeyCode::Char('s'), KeyModifiers::CONTROL) => { tx.send(WatchEvent::ConfirmSave( "Save current settings to global config?".into(), )) .unwrap(); } (KeyCode::Char('d'), KeyModifiers::NONE) => { tx.send(WatchEvent::ScrollDownHalf).unwrap(); tx.send(WatchEvent::Draw).unwrap(); } (KeyCode::Char('u'), KeyModifiers::NONE) => { tx.send(WatchEvent::ScrollUpHalf).unwrap(); tx.send(WatchEvent::Draw).unwrap(); } _ => (), }; } fn process_key_event( &self, event: KeyEvent, tx: mpsc::Sender, print_settings: Arc>, ) { let KeyEvent { code, modifiers, kind, .. } = event; if !matches!(kind, KeyEventKind::Press) { return; } match (code, modifiers) { // global keys (KeyCode::Char('c'), KeyModifiers::CONTROL) => { // will stop current context or exit the program tx.send(WatchEvent::Quit).unwrap(); } (KeyCode::Esc, _) => { tx.send(WatchEvent::Esc).unwrap(); } (KeyCode::Char('d'), KeyModifiers::CONTROL) | (KeyCode::PageDown, _) => { tx.send(WatchEvent::ScrollDownPage).unwrap(); tx.send(WatchEvent::Draw).unwrap(); } (KeyCode::Char('u'), KeyModifiers::CONTROL) | (KeyCode::PageUp, _) => { tx.send(WatchEvent::ScrollUpPage).unwrap(); tx.send(WatchEvent::Draw).unwrap(); } // others based on mode _ => match self { State::Normal | State::Help => { Self::process_normal_mode(event, tx, print_settings); } State::EditingFilter { field, .. } => match (code, modifiers) { // only re-draw devices for string filter changes - others only once fully entered (KeyCode::Char(c), _) => { tx.send(WatchEvent::PushFilter(c)).unwrap(); match field { FilterField::Serial | FilterField::Name => { tx.send(WatchEvent::DrawDevices).unwrap() } _ => tx.send(WatchEvent::Draw).unwrap(), } } (KeyCode::Backspace, _) => { tx.send(WatchEvent::PopFilter).unwrap(); match field { FilterField::Serial | FilterField::Name => { tx.send(WatchEvent::DrawDevices).unwrap() } _ => tx.send(WatchEvent::Draw).unwrap(), } } (KeyCode::Enter, _) => { tx.send(WatchEvent::Enter).unwrap(); } _ => {} }, State::BlockEditor { block_type, .. } => match (code, modifiers) { (KeyCode::Char('q'), _) => { tx.send(WatchEvent::Esc).unwrap(); } (KeyCode::Up, _) | (KeyCode::Char('k'), _) => { tx.send(WatchEvent::MoveUp(1)).unwrap(); tx.send(WatchEvent::DrawEditBlocks).unwrap(); } (KeyCode::Down, _) | (KeyCode::Char('j'), _) => { tx.send(WatchEvent::MoveDown(1)).unwrap(); tx.send(WatchEvent::DrawEditBlocks).unwrap(); } (KeyCode::Tab, KeyModifiers::NONE) | (KeyCode::Char('b'), _) => { tx.send(WatchEvent::EditBlock(block_type.next())).unwrap(); tx.send(WatchEvent::DrawEditBlocks).unwrap(); } (KeyCode::Tab, KeyModifiers::SHIFT) => { tx.send(WatchEvent::EditBlock(block_type.prev())).unwrap(); tx.send(WatchEvent::DrawEditBlocks).unwrap(); } (KeyCode::Char('1'), _) => { tx.send(WatchEvent::EditBlock(BlockType::Bus)).unwrap(); tx.send(WatchEvent::DrawEditBlocks).unwrap(); } (KeyCode::Char('2'), _) => { tx.send(WatchEvent::EditBlock(BlockType::Device)).unwrap(); tx.send(WatchEvent::DrawEditBlocks).unwrap(); } (KeyCode::Char('3'), _) => { tx.send(WatchEvent::EditBlock(BlockType::Config)).unwrap(); tx.send(WatchEvent::DrawEditBlocks).unwrap(); } (KeyCode::Char('4'), _) => { tx.send(WatchEvent::EditBlock(BlockType::Interface)) .unwrap(); tx.send(WatchEvent::DrawEditBlocks).unwrap(); } (KeyCode::Char('5'), _) => { tx.send(WatchEvent::EditBlock(BlockType::Endpoint)).unwrap(); tx.send(WatchEvent::DrawEditBlocks).unwrap(); } (KeyCode::Char(' '), _) => { tx.send(WatchEvent::ToggleBlock).unwrap(); tx.send(WatchEvent::DrawEditBlocks).unwrap(); } (KeyCode::Enter, _) => { tx.send(WatchEvent::WriteEditBlocks).unwrap(); tx.send(WatchEvent::Enter).unwrap(); } (KeyCode::Char('<'), _) | (KeyCode::Char(','), _) | (KeyCode::Char('h'), _) | (KeyCode::Left, _) | (KeyCode::Char('['), _) => { tx.send(WatchEvent::MoveBlockUp(1)).unwrap(); tx.send(WatchEvent::DrawEditBlocks).unwrap(); } (KeyCode::Char('>'), _) | (KeyCode::Char('.'), _) | (KeyCode::Char('l'), _) | (KeyCode::Right, _) | (KeyCode::Char(']'), _) => { tx.send(WatchEvent::MoveBlockDown(1)).unwrap(); tx.send(WatchEvent::DrawEditBlocks).unwrap(); } //(KeyCode::Char('d'), KeyModifiers::CONTROL) => { // tx.send(WatchEvent::WriteDefaultBlocks).unwrap(); // tx.send(WatchEvent::DrawEditBlocks).unwrap(); //} _ => (), }, State::Confirm(_, n) => match (code, modifiers) { // abort (KeyCode::Char('n'), _) | (KeyCode::Esc, _) | (KeyCode::Char('N'), _) => { tx.send(WatchEvent::Esc).unwrap(); } _ => { tx.send(n.clone()).unwrap(); tx.send(WatchEvent::Esc).unwrap(); } }, // others (error etc.) exit current on any key e => { log::debug!("Exiting state {:?} on other key event", e); tx.send(WatchEvent::Quit).unwrap(); } }, } } } impl Display { fn toggle_selected(&self, all: bool) { match self.selected_item.as_ref() { Some(LineItem::Device(path)) => { if let Some(node) = self.spusb.lock().unwrap().get_node_mut(path) { if all { node.set_all_expanded(!node.is_expanded()); } else { node.toggle_expanded(); } } } Some(LineItem::Config(path)) => { if let Some(config) = self.spusb.lock().unwrap().get_config_mut(&path.0, path.1) { if all { config.set_all_expanded(!config.is_expanded()); } else { config.toggle_expanded(); } } } Some(LineItem::Interface(path)) => { if let Some(interface) = self.spusb.lock().unwrap().get_interface_mut(path) { if all { interface.set_all_expanded(!interface.is_expanded()); } else { interface.toggle_expanded(); } } } Some(LineItem::Endpoint(path)) => { if let Some(endpoint) = self.spusb.lock().unwrap().get_endpoint_mut(path) { endpoint.toggle_expanded(); } } _ => (), } } fn prepare_devices(&mut self) { let print_settings = self.print_settings.lock().unwrap(); let mut spusb = self.spusb.lock().unwrap(); cyme::display::prepare(&mut spusb, Some(&self.filter), &print_settings); } fn move_up(&mut self, n: usize) { match &mut *self.state.lock().unwrap() { State::BlockEditor { selected_index, .. } => { *selected_index = selected_index.saturating_sub(n); self.selected_line = Some(*selected_index); } State::Normal => { let li = self .line_context .iter() .enumerate() .rev() .skip( self.line_context.len().saturating_sub( self.selected_line .unwrap_or(n) .saturating_sub(n.saturating_sub(1)), ), ) .find(|(_, l)| !(matches!(l, LineItem::None) || matches!(l, LineItem::Bus(_)))); if let Some((i, item)) = li { self.selected_line = Some(i); self.selected_item = Some(item.clone()); } } _ => (), }; log::debug!( "Selected line: {:?} ({:?})", self.selected_line, self.selected_item ); } fn move_down(&mut self, n: usize) { match &mut *self.state.lock().unwrap() { State::BlockEditor { selected_index, blocks, .. } => { *selected_index = selected_index .saturating_add(n) .min(blocks.len().saturating_sub(1)); self.selected_line = Some(*selected_index); } State::Normal => { let li = self .line_context .iter() .enumerate() .skip(self.selected_line.map_or(n, |i| i.saturating_add(n))) .find(|(_, l)| !(matches!(l, LineItem::None) || matches!(l, LineItem::Bus(_)))); if let Some((i, item)) = li { self.selected_line = Some(i); self.selected_item = Some(item.clone()); } } _ => (), } log::debug!( "Selected line: {:?} ({:?})", self.selected_line, self.selected_item ); } /// Shifts selected line into view when scrolling fn scroll_check_selected_visable(&mut self) { if let Some(l) = self.selected_line { if l < self.scroll_offset { self.move_down(self.scroll_offset - l); } else if l >= self.scroll_offset + self.available_rows { self.move_up(l - (self.scroll_offset + self.available_rows) + 1); } } } fn draw_devices(&mut self) -> Result<()> { // use a Vec buffer instead of stdout // so we can scroll the output with offset self.buffer.clear(); let mut dw = DisplayWriter::new(&mut self.buffer); dw.set_raw_mode(true); { let spusb = self.spusb.lock().unwrap(); let print_settings = self.print_settings.lock().unwrap(); dw.print_sp_usb(&spusb, &print_settings); } self.line_context = dw.line_context().to_owned(); // find selected device if let Some(selected_device) = self.selected_item.as_ref() { if let Some((i, _)) = self .line_context .iter() .enumerate() .find(|(_, l)| *l == selected_device) { self.selected_line = Some(i); } } else { self.selected_line = None; } self.draw() } fn draw_help(&mut self) -> Result<()> { self.buffer.clear(); writeln!( self.buffer, r#" {} v{} - USB Device Watcher vim bindings where possible! [q]/[Esc]: Exit program/abort mode [v]: Cycle verbosity [t]: Toggle tree [h]: Toggle headings [o]: Toggle decimal/hex [p]: Cycle sort mode [b]: Enter block editor [/]: Edit name filter [s]: Edit serial filter [#]: Edit VID:PID filter [c]: Edit class filter [j]/[k], Up/Down: Move selection [u]/[d], PgUp/PgDn Ctrl+u/Ctrl+d: Scroll page [CR]: Expand selected/Accept or commit changes [space]: Toggle selected [C-s]: Save current display settings to cyme config.json [C-c]: Exit program [?]: Show this help "#, env!("CARGO_PKG_NAME"), env!("CARGO_PKG_VERSION") )?; // Then just call `draw()` to show the new buffer self.draw() } fn draw_header(&mut self, writer: &mut W) -> Result<()> { let (term_width, _) = self.terminal_size; let mut header = match &*self.state.lock().unwrap() { State::BlockEditor { block_type, .. } => { format!( " EDITING BLOCKS: [{}] {}", block_type.key_number(), block_type ) } _ => { format!( " FILTERS Name={:?} Serial={:?} VID:PID={}:{} Class={:?}", self.filter.name, self.filter.serial, self.filter .vid .map_or("".to_string(), |v| format!("{v:04x}")), self.filter .pid .map_or("".to_string(), |p| format!("{p:04x}")), self.filter.class ) } }; truncate_string(&mut header, term_width as usize); execute!( writer, cursor::MoveTo(0, 0), terminal::Clear(terminal::ClearType::CurrentLine), Print( format!("{:(&mut self, writer: &mut W) -> Result<()> { let (term_width, term_height) = self.terminal_size; let footer = match &*self.state.lock().unwrap() { State::EditingFilter { field, buffer, .. } => { let mut footer = match field { FilterField::Name => "Filter Name: ".to_string(), FilterField::Serial => "Filter Serial: ".to_string(), FilterField::VidPid => "Filter VID:PID: ".to_string(), FilterField::Class => "Filter Class: ".to_string(), }; if let Some(buffer) = buffer { footer.push_str(buffer); } format!("{: format!("{: format!("{: { let mut footer = String::from(" [Up/Down]-Navigate [Space]-Toggle [<]/[>]-Move [Tab]-Switch [Enter]-Accept [q]-Exit"); truncate_string(&mut footer, term_width as usize); format!("{: { let print_settings = self.print_settings.lock().unwrap(); let verbosity = if print_settings.verbosity == 3 { String::from("0") } else { (print_settings.verbosity + 1).to_string() }; let mut footer = format!( " [q]-Quit [b]-Edit Blocks [v]-Verbosity-(→{}) [t]-Tree-(→{}) [h]-Headings-(→{}) [o]-Decimal-(→{}) [p]-Sort-(→{})", verbosity, if print_settings.tree { "X" } else { "O" }, if print_settings.headings { "X" } else { "O" }, if print_settings.decimal { "X" } else { "O" }, if print_settings.sort_devices == Sort::BranchPosition { "D#" } else { "P#" } ); truncate_string(&mut footer, term_width as usize); format!("{: = match block_type { BlockType::Device => { let enabled_blocks = print_settings.device_blocks.as_ref().unwrap(); enabled_blocks .iter() .map(|b| (b, true)) .chain( DeviceBlocks::all_blocks() .iter() .filter(|b| !enabled_blocks.contains(b)) .map(|b| (b, false)), ) .map(|(b, enabled)| { let cs = if let Some(ct) = ct.as_ref() { let block = b.to_possible_value().unwrap().get_name().to_string(); b.colour(&block, ct) } else { b.to_possible_value().unwrap().get_name().into() }; (cs, enabled) }) .collect() } BlockType::Bus => { let enabled_blocks = print_settings.bus_blocks.as_ref().unwrap(); enabled_blocks .iter() .map(|b| (b, true)) .chain( BusBlocks::all_blocks() .iter() .filter(|b| !enabled_blocks.contains(b)) .map(|b| (b, false)), ) .map(|(b, enabled)| { let cs = if let Some(ct) = ct.as_ref() { let block = b.to_possible_value().unwrap().get_name().to_string(); b.colour(&block, ct) } else { b.to_possible_value().unwrap().get_name().into() }; (cs, enabled) }) .collect() } BlockType::Config => { let enabled_blocks = print_settings.config_blocks.as_ref().unwrap(); enabled_blocks .iter() .map(|b| (b, true)) .chain( ConfigurationBlocks::all_blocks() .iter() .filter(|b| !enabled_blocks.contains(b)) .map(|b| (b, false)), ) .map(|(b, enabled)| { let cs = if let Some(ct) = ct.as_ref() { let block = b.to_possible_value().unwrap().get_name().to_string(); b.colour(&block, ct) } else { b.to_possible_value().unwrap().get_name().into() }; (cs, enabled) }) .collect() } BlockType::Interface => { let enabled_blocks = print_settings.interface_blocks.as_ref().unwrap(); enabled_blocks .iter() .map(|b| (b, true)) .chain( InterfaceBlocks::all_blocks() .iter() .filter(|b| !enabled_blocks.contains(b)) .map(|b| (b, false)), ) .map(|(b, enabled)| { let cs = if let Some(ct) = ct.as_ref() { let block = b.to_possible_value().unwrap().get_name().to_string(); b.colour(&block, ct) } else { b.to_possible_value().unwrap().get_name().into() }; (cs, enabled) }) .collect() } BlockType::Endpoint => { let enabled_blocks = print_settings.endpoint_blocks.as_ref().unwrap(); enabled_blocks .iter() .map(|b| (b, true)) .chain( EndpointBlocks::all_blocks() .iter() .filter(|b| !enabled_blocks.contains(b)) .map(|b| (b, false)), ) .map(|(b, enabled)| { let cs = if let Some(ct) = ct.as_ref() { let block = b.to_possible_value().unwrap().get_name().to_string(); b.colour(&block, ct) } else { b.to_possible_value().unwrap().get_name().into() }; (cs, enabled) }) .collect() } }; let index = if let State::BlockEditor { selected_index, .. } = &mut *self.state.lock().unwrap() { (*selected_index).min(blocks.len() - 1) } else { 0 }; let new_mode = State::BlockEditor { block_type, selected_index: index, blocks, }; // set selected line for block editor self.selected_line = Some(index); *self.state.lock().unwrap() = new_mode; } fn write_edit_blocks(&mut self) { if let State::BlockEditor { block_type, blocks, .. } = &*self.state.lock().unwrap() { let mut print_settings = self.print_settings.lock().unwrap(); match block_type { BlockType::Device => { print_settings.device_blocks = Some( blocks .iter() .filter(|(_, enabled)| *enabled) .map(|b| DeviceBlocks::from_str(&b.0, true).unwrap()) .collect(), ); } BlockType::Bus => { print_settings.bus_blocks = Some( blocks .iter() .filter(|(_, enabled)| *enabled) .map(|b| BusBlocks::from_str(&b.0, true).unwrap()) .collect(), ); } BlockType::Config => { print_settings.config_blocks = Some( blocks .iter() .filter(|(_, enabled)| *enabled) .map(|b| ConfigurationBlocks::from_str(&b.0, true).unwrap()) .collect(), ); } BlockType::Interface => { print_settings.interface_blocks = Some( blocks .iter() .filter(|(_, enabled)| *enabled) .map(|b| InterfaceBlocks::from_str(&b.0, true).unwrap()) .collect(), ); } BlockType::Endpoint => { print_settings.endpoint_blocks = Some( blocks .iter() .filter(|(_, enabled)| *enabled) .map(|b| EndpointBlocks::from_str(&b.0, true).unwrap()) .collect(), ); } } }; } fn draw_edit_blocks(&mut self) -> Result<()> { self.buffer.clear(); if let State::BlockEditor { selected_index, blocks, .. } = &mut *self.state.lock().unwrap() { for (i, (block, enabled)) in blocks.iter().enumerate() { let block_string = if i == *selected_index { block.clone().normal().to_string() } else { block.to_string() }; if *enabled { writeln!(self.buffer, " [x] {block_string}")?; } else { writeln!(self.buffer, " [ ] {block_string}")?; } } } self.draw() } fn draw(&mut self) -> Result<()> { let mut stdout = stdout(); self.terminal_size = terminal::size().unwrap_or((80, 24)); let (_, term_height) = self.terminal_size; // two for header and footer self.available_rows = term_height.saturating_sub(2) as usize; execute!( stdout, cursor::MoveTo(0, 0), terminal::Clear(terminal::ClearType::All), ) .map_err(|e| Error::new(ErrorKind::Other("crossterm"), &e.to_string()))?; self.draw_header(&mut stdout)?; // convert buffer to string and split into lines let output = String::from_utf8_lossy(&self.buffer); let lines: Vec = output.lines().map(|line| line.to_string()).collect(); self.lines = lines.len(); self.max_offset = self.lines.saturating_sub(self.available_rows); // clamp ensures if output contracts fully scrolled, one doesn't have to *overscroll* back self.scroll_offset = (self.scroll_offset).min(self.max_offset); // print the visible portion of the buffer for (i, line) in lines .iter() .enumerate() .skip(self.scroll_offset) .take(self.available_rows) { if self.selected_line == Some(i) && !matches!(&*self.state.lock().unwrap(), State::Help) { let stripped_line = strip_ansi_codes(line); // use '>' to indicate selected line if no color // not that pretty but works... if self.print_settings.lock().unwrap().colours.is_none() || env::var("NO_COLOR").is_ok_and(|v| v == "1") { let mut indicated = stripped_line.chars().skip(1).collect::(); indicated.insert(0, '>'); write!(stdout, "{}\n\r", indicated.bold().on_bright_purple())?; } else { write!(stdout, "{}\n\r", stripped_line.bold().on_bright_purple())?; } } else { write!(stdout, "{line}\n\r")?; } } // status bar with key bindings self.draw_footer(&mut stdout)?; stdout.flush()?; Ok(()) } } cyme-2.2.6/tests/000077500000000000000000000000001506545537300136355ustar00rootroot00000000000000cyme-2.2.6/tests/common/000077500000000000000000000000001506545537300151255ustar00rootroot00000000000000cyme-2.2.6/tests/common/mod.rs000066400000000000000000000266561506545537300162710ustar00rootroot00000000000000//! Runs tests using actual binary, adapted from 'fd' method: https://github.com/sharkdp/fd/blob/master/tests/testenv/mod.rs #![allow(dead_code)] use serde_json::json; use std::env; use std::fs::File; use std::io::{BufReader, Read}; use std::path::PathBuf; use std::process; // #[cfg(windows)] // use std::os::windows; // if changing content of DeviceX structs, update the tests data with `--from-json TEST_DUMP --json TEST_ARGS > file.json` /// Dump from the `system_profiler` command on macOS pub const SYSTEM_PROFILER_DUMP_PATH: &str = "./tests/data/system_profiler_dump.json"; /// Dump using macOS system_profiler so no [`DeviceExtra`] pub const CYME_SP_TREE_DUMP: &str = "./tests/data/cyme_sp_macos_tree.json"; /// Dump using macOS system_profiler and libusb merge so with [`DeviceExtra`] pub const CYME_LIBUSB_MERGE_MACOS_TREE_DUMP: &str = "./tests/data/cyme_libusb_merge_macos_tree.json"; /// Dump using macOS force libusb merge so with [`DeviceExtra`] but not Apple internal buses pub const CYME_LIBUSB_MACOS_TREE_DUMP: &str = "./tests/data/cyme_libusb_macos_tree.json"; /// Dump using Linux with libusb so with [`DeviceExtra`] pub const CYME_LIBUSB_LINUX_TREE_DUMP: &str = "./tests/data/cyme_libusb_linux_tree.json"; /// Output of lsusb --tree pub const LSUSB_TREE_OUTPUT: &str = "./tests/data/lsusb_tree.txt"; /// Output of lsusb --tree -vvv pub const LSUSB_TREE_OUTPUT_VERBOSE: &str = "./tests/data/lsusb_tree_verbose.txt"; /// Output of lsusb pub const LSUSB_OUTPUT: &str = "./tests/data/lsusb_list.txt"; /// Output of lsusb --verbose pub const LSUSB_OUTPUT_VERBOSE: &str = "./tests/data/lsusb_verbose.txt"; pub fn read_dump(file_name: &str) -> BufReader { let f = File::open(file_name).expect("Unable to open json dump file"); BufReader::new(f) } pub fn read_dump_to_string(file_name: &str) -> String { let mut ret = String::new(); let mut br = read_dump(file_name); br.read_to_string(&mut ret) .unwrap_or_else(|_| panic!("Failed to read {file_name}")); ret } pub fn sp_data_from_system_profiler() -> cyme::profiler::SystemProfile { let mut br = read_dump(SYSTEM_PROFILER_DUMP_PATH); let mut data = String::new(); br.read_to_string(&mut data).expect("Unable to read string"); serde_json::from_str::(&data).unwrap() } pub fn sp_data_from_libusb_linux() -> cyme::profiler::SystemProfile { let mut br = read_dump(CYME_LIBUSB_LINUX_TREE_DUMP); let mut data = String::new(); br.read_to_string(&mut data).expect("Unable to read string"); serde_json::from_str::(&data).unwrap() } /// Environment for the integration tests. pub struct TestEnv { /// Path to the *cyme* executable. cyme_exe: PathBuf, /// Normalize each line by sorting the whitespace-separated words normalize_line: bool, /// Strip whitespace at start strip_start: bool, } /// Find the *cyme* executable. fn find_cyme_exe() -> PathBuf { // Tests exe is in target/debug/deps, the *cyme* exe is in target/debug let root = env::current_exe() .expect("tests executable") .parent() .expect("tests executable directory") .parent() .expect("cyme executable directory") .to_path_buf(); let exe_name = if cfg!(windows) { "cyme.exe" } else { "cyme" }; root.join(exe_name) } /// Format an error message for when *cyme* did not exit successfully. fn format_exit_error(args: &[&str], output: &process::Output) -> String { format!( "`cyme {}` did not exit successfully.\nstdout:\n---\n{}---\nstderr:\n---\n{}---", args.join(" "), String::from_utf8_lossy(&output.stdout), String::from_utf8_lossy(&output.stderr) ) } /// Format an error message for when the output of *cyme* did not match the expected output. fn format_output_error(args: &[&str], expected: &str, actual: &str) -> String { // Generate diff text. let diff_text = diff::lines(expected, actual) .into_iter() .map(|diff| match diff { diff::Result::Left(l) => format!("-{l}"), diff::Result::Both(l, _) => format!(" {l}"), diff::Result::Right(r) => format!("+{r}"), }) .collect::>() .join("\n"); format!( concat!( "`cyme {}` did not produce the expected output.\n", "Showing diff between expected and actual:\n{}\n" ), args.join(" "), diff_text ) } /// Normalize the output for comparison. fn normalize_output(s: &str, trim_start: bool, normalize_line: bool) -> String { // Split into lines and normalize separators. let mut lines = s .replace('\0', "NULL\n") .lines() .map(|line| { let line = if trim_start { line.trim_start() } else { line }; if normalize_line { let mut words: Vec<_> = line.split_whitespace().collect(); words.sort_unstable(); return words.join(" "); } line.to_string() }) .collect::>(); lines.sort(); lines.join("\n") } /// Trim whitespace from the beginning of each line. fn trim_lines(s: &str) -> String { s.lines() .map(|line| line.trim_start()) .fold(String::new(), |mut str, line| { str.push_str(line); str.push('\n'); str }) } impl TestEnv { pub fn new() -> TestEnv { let cyme_exe = find_cyme_exe(); TestEnv { cyme_exe, normalize_line: false, strip_start: false, } } pub fn normalize_line(self, normalize: bool, strip_start: bool) -> TestEnv { TestEnv { cyme_exe: self.cyme_exe, normalize_line: normalize, strip_start, } } /// Get the path of the cyme executable. #[cfg_attr(windows, allow(unused))] pub fn test_exe(&self) -> &PathBuf { &self.cyme_exe } /// Assert that calling *cyme* in the specified path under the root working directory, /// and with the specified arguments produces the expected output. pub fn assert_success_and_get_output( &self, dump_file: Option<&str>, args: &[&str], ) -> process::Output { // Setup *cyme* command. let mut cmd = process::Command::new(&self.cyme_exe); if let Some(dump) = dump_file { cmd.arg("--from-json").arg(dump).args(args); } else { cmd.arg("--json").args(args); } // Run *cyme*. let output = cmd.output().expect("cyme output"); // Check for exit status. if !output.status.success() { panic!("{}", format_exit_error(args, &output)); } output } pub fn assert_success_and_get_normalized_output( &self, dump_file: Option<&str>, args: &[&str], ) -> String { let output = self.assert_success_and_get_output(dump_file, args); normalize_output( &String::from_utf8_lossy(&output.stdout), self.strip_start, self.normalize_line, ) } /// Assert that calling *cyme* with the specified arguments produces the expected output. pub fn assert_output( &self, dump_file: Option<&str>, args: &[&str], expected: &str, contains: bool, ) { // Don't touch if doing contains let (expected, actual) = if contains { let output = self.assert_success_and_get_output(dump_file, args); ( expected.to_string(), String::from_utf8_lossy(&output.stdout).to_string(), ) // Normalize both expected and actual output. } else { ( normalize_output(expected, self.strip_start, self.normalize_line), self.assert_success_and_get_normalized_output(dump_file, args), ) }; // Compare actual output to expected output. if contains { if !actual.contains(&expected) { panic!("{}", format_output_error(args, &expected, &actual)); } } else if expected != actual { panic!("{}", format_output_error(args, &expected, &actual)); } } pub fn assert_output_json(&self, dump_file: Option<&str>, args: &[&str], expected: &str) { // Normalize both expected and actual output. let output = self.assert_success_and_get_output(dump_file, args); let actual = String::from_utf8_lossy(&output.stdout).to_string(); // Compare actual output to expected output. assert_json_diff::assert_json_include!(actual: json!(actual), expected: json!(expected)); } /// Parses output back to [`cyme::profiler::SystemProfile`] and checks device with `port_path` exists in it pub fn assert_output_contains_port_path( &self, dump_file: Option<&str>, args: &[&str], port_path: &str, ) { // Normalize both expected and actual output. let output = self.assert_success_and_get_output(dump_file, args); let actual = String::from_utf8_lossy(&output.stdout).to_string(); let spdata_out = serde_json::from_str::(&actual).unwrap(); let port_path = cyme::usb::PortPath::try_from(port_path).unwrap(); assert!(spdata_out.get_node(&port_path).is_some()); } /// Similar to assert_output, but able to handle non-utf8 output #[cfg(all(unix, not(target_os = "macos")))] pub fn assert_output_raw(&self, dump_file: Option<&str>, args: &[&str], expected: &[u8]) { let output = self.assert_success_and_get_output(dump_file, args); assert_eq!(expected, &output.stdout[..]); } /// Assert that calling *cyme* with the specified arguments produces the expected error, /// and does not succeed. pub fn assert_failure_with_error( &self, dump_file: Option<&str>, args: &[&str], expected: &str, ) { let status = self.assert_error(dump_file, args, Some(expected)); if status.success() { panic!("error '{expected}' did not occur."); } } /// Assert that calling *cyme* with the specified arguments does not succeed. pub fn assert_failure(&self, dump_file: Option<&str>, args: &[&str]) { let status = self.assert_error(dump_file, args, None); if status.success() { panic!("Failure did not occur as expected."); } } fn assert_error( &self, dump_file: Option<&str>, args: &[&str], expected: Option<&str>, ) -> process::ExitStatus { // Setup *cyme* command. let mut cmd = process::Command::new(&self.cyme_exe); if let Some(dump) = dump_file { cmd.arg("--from-json").arg(dump).args(args); } else { cmd.arg("--json").args(args); } // Run *cyme*. let output = cmd.output().expect("cyme output"); if let Some(expected) = expected { // Normalize both expected and actual output. let expected_error = trim_lines(expected); let actual_err = trim_lines(&String::from_utf8_lossy(&output.stderr)); // Compare actual output to expected output. if !actual_err.trim_start().starts_with(&expected_error) { panic!( "{}", format_output_error(args, &expected_error, &actual_err) ); } } output.status } } cyme-2.2.6/tests/data/000077500000000000000000000000001506545537300145465ustar00rootroot00000000000000cyme-2.2.6/tests/data/config_missing_args.json000066400000000000000000000011341506545537300214520ustar00rootroot00000000000000{ "blocks": [ "bus-number", "device-number", "icon", "vendor-id", "product-id", "name", "serial", "speed" ], "bus-blocks": [ "name", "host-controller" ], "config-blocks": [ "number", "name", "icon-attributes", "max-power" ], "interface-blocks": [ "port-path", "icon", "alt-setting", "class-code", "sub-class", "protocol", "name" ], "endpoint-blocks": [ "number", "direction", "transfer-type", "sync-type", "usage-type", "max-packet-size" ], "tree": false, "more": false } cyme-2.2.6/tests/data/config_no_theme.json000066400000000000000000000015531506545537300205700ustar00rootroot00000000000000{ "blocks": [ "bus-number", "device-number", "icon", "vendor-id", "product-id", "name", "serial", "speed" ], "bus-blocks": [ "name", "host-controller" ], "config-blocks": [ "number", "name", "icon-attributes", "max-power" ], "interface-blocks": [ "port-path", "icon", "alt-setting", "class-code", "sub-class", "protocol", "name" ], "endpoint-blocks": [ "number", "direction", "transfer-type", "sync-type", "usage-type", "max-packet-size" ], "max-variable-string-len": null, "no-auto-width": false, "mask-serials": null, "lsusb": false, "tree": false, "verbose": 0, "more": false, "hide-buses": false, "hide-hubs": false, "decimal": false, "no-padding": false, "ascii": false, "headings": false, "force-libusb": false } cyme-2.2.6/tests/data/cyme_libusb_linux.json000066400000000000000000000646331506545537300211710ustar00rootroot00000000000000[ { "name": "Virtual Printer (/Users/john/Parallels/Arch.pvm/parallel.txt)", "vendor_id": 8250, "product_id": 65530, "location_id": { "bus": 1, "tree_positions": [ 6 ], "number": 3 }, "serial_num": "SN0000", "manufacturer": "Parallels", "bcd_device": "1.00", "bcd_usb": "2.00", "device_speed": "480.0 Mb/s", "class": "use-interface-descriptor", "sub_class": 0, "protocol": 0, "extra": { "max_packet_size": 64, "driver": "usb", "syspath": "/sys/devices/pci0000:00/0000:00:1d.7/usb1/1-6", "vendor": "PARALLELS", "string_indexes": [ 2, 1, 3 ], "configurations": [ { "name": "Parallels", "string_index": 1, "number": 1, "interfaces": [ { "name": "Virtual USB Printer Interface", "string_index": 4, "number": 0, "path": "1-6:1.0", "class": "printer", "sub_class": 1, "protocol": 1, "alt_setting": 0, "driver": "usblp", "syspath": "/sys/devices/pci0000:00/0000:00:1d.7/usb1/1-6/1-6:1.0", "endpoints": [ { "address": { "address": 1, "number": 1, "direction": "Out" }, "transfer_type": "Bulk", "sync_type": "None", "usage_type": "Data", "max_packet_size": 512, "interval": 0 } ] } ], "attributes": [ "SelfPowered" ], "max_power": { "value": 0, "unit": "mA", "description": null } } ] } }, { "name": "Virtual Mouse", "vendor_id": 8250, "product_id": 65532, "location_id": { "bus": 1, "tree_positions": [ 2 ], "number": 2 }, "serial_num": "PW3.0", "manufacturer": "Parallels", "bcd_device": "1.00", "bcd_usb": "2.00", "device_speed": "480.0 Mb/s", "class": "use-interface-descriptor", "sub_class": 0, "protocol": 0, "extra": { "max_packet_size": 64, "driver": "usb", "syspath": "/sys/devices/pci0000:00/0000:00:1d.7/usb1/1-2", "vendor": "PARALLELS", "string_indexes": [ 2, 1, 3 ], "configurations": [ { "name": "Parallels", "string_index": 1, "number": 1, "interfaces": [ { "name": "Absolute Coordinate Interface", "string_index": 4, "number": 0, "path": "1-2:1.0", "class": "h-i-d", "sub_class": 0, "protocol": 2, "alt_setting": 0, "driver": "usbhid", "syspath": "/sys/devices/pci0000:00/0000:00:1d.7/usb1/1-2/1-2:1.0", "endpoints": [ { "address": { "address": 129, "number": 1, "direction": "In" }, "transfer_type": "Interrupt", "sync_type": "None", "usage_type": "Data", "max_packet_size": 64, "interval": 4 } ] }, { "name": "Relative Coordinate Interface", "string_index": 5, "number": 1, "path": "1-2:1.1", "class": "h-i-d", "sub_class": 0, "protocol": 2, "alt_setting": 0, "driver": "usbhid", "syspath": "/sys/devices/pci0000:00/0000:00:1d.7/usb1/1-2/1-2:1.1", "endpoints": [ { "address": { "address": 130, "number": 2, "direction": "In" }, "transfer_type": "Interrupt", "sync_type": "None", "usage_type": "Data", "max_packet_size": 64, "interval": 4 } ] } ], "attributes": [ "SelfPowered" ], "max_power": { "value": 0, "unit": "mA", "description": null } } ] } }, { "name": "EHCI Host Controller", "vendor_id": 7531, "product_id": 2, "location_id": { "bus": 1, "tree_positions": [], "number": 1 }, "serial_num": "0000:00:1d.7", "manufacturer": "Linux 6.0.10-arch2-1 ehci_hcd", "bcd_device": "6.00", "bcd_usb": "2.00", "device_speed": "480.0 Mb/s", "class": "hub", "sub_class": 0, "protocol": 0, "extra": { "max_packet_size": 64, "driver": "hub", "syspath": "/sys/devices/pci0000:00/0000:00:1d.7/usb1/1-0:1.0", "vendor": "Linux Foundation", "product_name": "2.0 root hub", "string_indexes": [ 2, 3, 1 ], "configurations": [ { "name": "", "string_index": 0, "number": 1, "interfaces": [ { "name": "", "string_index": 0, "number": 0, "path": "1-0:1.0", "class": "hub", "sub_class": 0, "protocol": 0, "alt_setting": 0, "driver": "hub", "syspath": "/sys/devices/pci0000:00/0000:00:1d.7/usb1/1-0:1.0", "endpoints": [ { "address": { "address": 129, "number": 1, "direction": "In" }, "transfer_type": "Interrupt", "sync_type": "None", "usage_type": "Data", "max_packet_size": 4, "interval": 12 } ] } ], "attributes": [ "RemoteWakeup", "SelfPowered" ], "max_power": { "value": 0, "unit": "mA", "description": null } } ] } }, { "name": "Virtual USB1.1 HUB", "vendor_id": 8250, "product_id": 65534, "location_id": { "bus": 2, "tree_positions": [ 2 ], "number": 22 }, "serial_num": "PW3.0", "manufacturer": "Parallels", "bcd_device": "1.01", "bcd_usb": "2.00", "device_speed": "12.0 Mb/s", "class": "hub", "sub_class": 0, "protocol": 0, "extra": { "max_packet_size": 8, "driver": "usb", "syspath": "/sys/devices/pci0000:00/0000:00:1d.0/usb2/2-2", "vendor": "PARALLELS", "string_indexes": [ 2, 1, 3 ], "configurations": [ { "name": "", "string_index": 0, "number": 1, "interfaces": [ { "name": "", "string_index": 0, "number": 0, "path": "2-2:1.0", "class": "hub", "sub_class": 0, "protocol": 0, "alt_setting": 0, "driver": "hub", "syspath": "/sys/devices/pci0000:00/0000:00:1d.0/usb2/2-2/2-2:1.0", "endpoints": [ { "address": { "address": 129, "number": 1, "direction": "In" }, "transfer_type": "Interrupt", "sync_type": "None", "usage_type": "Data", "max_packet_size": 4, "interval": 255 } ] } ], "attributes": [ "SelfPowered" ], "max_power": { "value": 0, "unit": "mA", "description": null } } ] } }, { "name": "Black Magic Probe v1.8.2", "vendor_id": 7504, "product_id": 24600, "location_id": { "bus": 2, "tree_positions": [ 2, 8 ], "number": 24 }, "serial_num": "97B6A11D", "manufacturer": "Black Magic Debug", "bcd_device": "1.00", "bcd_usb": "2.00", "device_speed": "12.0 Mb/s", "class": "miscellaneous", "sub_class": 2, "protocol": 1, "extra": { "max_packet_size": 32, "driver": "usb", "syspath": "/sys/devices/pci0000:00/0000:00:1d.0/usb2/2-2/2-2.8", "vendor": "OpenMoko, Inc.", "product_name": "Black Magic Debug Probe (Application)", "string_indexes": [ 2, 1, 3 ], "configurations": [ { "name": "", "string_index": 0, "number": 1, "interfaces": [ { "name": "Black Magic GDB Server", "string_index": 4, "number": 0, "path": "2-2.8:1.0", "class": "c-d-c-communications", "sub_class": 2, "protocol": 0, "alt_setting": 0, "driver": "cdc_acm", "syspath": "/sys/devices/pci0000:00/0000:00:1d.0/usb2/2-2/2-2.8/2-2.8:1.0", "endpoints": [ { "address": { "address": 130, "number": 2, "direction": "In" }, "transfer_type": "Interrupt", "sync_type": "None", "usage_type": "Data", "max_packet_size": 16, "interval": 255 } ] }, { "name": "", "string_index": 0, "number": 1, "path": "2-2.8:1.1", "class": "c-d-c-data", "sub_class": 0, "protocol": 0, "alt_setting": 0, "driver": "cdc_acm", "syspath": "/sys/devices/pci0000:00/0000:00:1d.0/usb2/2-2/2-2.8/2-2.8:1.1", "endpoints": [ { "address": { "address": 1, "number": 1, "direction": "Out" }, "transfer_type": "Bulk", "sync_type": "None", "usage_type": "Data", "max_packet_size": 64, "interval": 1 }, { "address": { "address": 129, "number": 1, "direction": "In" }, "transfer_type": "Bulk", "sync_type": "None", "usage_type": "Data", "max_packet_size": 64, "interval": 1 } ] }, { "name": "Black Magic UART Port", "string_index": 5, "number": 2, "path": "2-2.8:1.2", "class": "c-d-c-communications", "sub_class": 2, "protocol": 0, "alt_setting": 0, "driver": "cdc_acm", "syspath": "/sys/devices/pci0000:00/0000:00:1d.0/usb2/2-2/2-2.8/2-2.8:1.2", "endpoints": [ { "address": { "address": 132, "number": 4, "direction": "In" }, "transfer_type": "Interrupt", "sync_type": "None", "usage_type": "Data", "max_packet_size": 16, "interval": 255 } ] }, { "name": "", "string_index": 0, "number": 3, "path": "2-2.8:1.3", "class": "c-d-c-data", "sub_class": 0, "protocol": 0, "alt_setting": 0, "driver": "cdc_acm", "syspath": "/sys/devices/pci0000:00/0000:00:1d.0/usb2/2-2/2-2.8/2-2.8:1.3", "endpoints": [ { "address": { "address": 3, "number": 3, "direction": "Out" }, "transfer_type": "Bulk", "sync_type": "None", "usage_type": "Data", "max_packet_size": 32, "interval": 1 }, { "address": { "address": 131, "number": 3, "direction": "In" }, "transfer_type": "Bulk", "sync_type": "None", "usage_type": "Data", "max_packet_size": 64, "interval": 1 } ] }, { "name": "Black Magic DFU", "string_index": 6, "number": 4, "path": "2-2.8:1.4", "class": "application-specific-interface", "sub_class": 1, "protocol": 1, "alt_setting": 0, "driver": null, "syspath": "/sys/devices/pci0000:00/0000:00:1d.0/usb2/2-2/2-2.8/2-2.8:1.4", "endpoints": [] }, { "name": "Black Magic Trace Capture", "string_index": 7, "number": 5, "path": "2-2.8:1.5", "class": "vendor-specific-class", "sub_class": 255, "protocol": 255, "alt_setting": 0, "driver": null, "syspath": "/sys/devices/pci0000:00/0000:00:1d.0/usb2/2-2/2-2.8/2-2.8:1.5", "endpoints": [ { "address": { "address": 133, "number": 5, "direction": "In" }, "transfer_type": "Bulk", "sync_type": "None", "usage_type": "Data", "max_packet_size": 64, "interval": 0 } ] } ], "attributes": [], "max_power": { "value": 100, "unit": "mA", "description": null } } ] } }, { "name": "J-Link", "vendor_id": 4966, "product_id": 4176, "location_id": { "bus": 2, "tree_positions": [ 2, 1 ], "number": 23 }, "serial_num": "001050027328", "manufacturer": "SEGGER", "bcd_device": "1.00", "bcd_usb": "2.00", "device_speed": "12.0 Mb/s", "class": "miscellaneous", "sub_class": 2, "protocol": 1, "extra": { "max_packet_size": 64, "driver": "usb", "syspath": "/sys/devices/pci0000:00/0000:00:1d.0/usb2/2-2/2-2.1", "vendor": "SEGGER", "string_indexes": [ 2, 1, 3 ], "configurations": [ { "name": "Configuration", "string_index": 4, "number": 1, "interfaces": [ { "name": "CDC", "string_index": 5, "number": 0, "path": "2-2.1:1.0", "class": "c-d-c-communications", "sub_class": 2, "protocol": 1, "alt_setting": 0, "driver": "cdc_acm", "syspath": "/sys/devices/pci0000:00/0000:00:1d.0/usb2/2-2/2-2.1/2-2.1:1.0", "endpoints": [ { "address": { "address": 130, "number": 2, "direction": "In" }, "transfer_type": "Interrupt", "sync_type": "None", "usage_type": "Data", "max_packet_size": 64, "interval": 1 } ] }, { "name": "CDC DATA interface", "string_index": 6, "number": 1, "path": "2-2.1:1.1", "class": "c-d-c-data", "sub_class": 0, "protocol": 0, "alt_setting": 0, "driver": "cdc_acm", "syspath": "/sys/devices/pci0000:00/0000:00:1d.0/usb2/2-2/2-2.1/2-2.1:1.1", "endpoints": [ { "address": { "address": 129, "number": 1, "direction": "In" }, "transfer_type": "Bulk", "sync_type": "None", "usage_type": "Data", "max_packet_size": 64, "interval": 1 }, { "address": { "address": 1, "number": 1, "direction": "Out" }, "transfer_type": "Bulk", "sync_type": "None", "usage_type": "Data", "max_packet_size": 64, "interval": 1 } ] }, { "name": "CDC", "string_index": 7, "number": 2, "path": "2-2.1:1.2", "class": "c-d-c-communications", "sub_class": 2, "protocol": 1, "alt_setting": 0, "driver": "cdc_acm", "syspath": "/sys/devices/pci0000:00/0000:00:1d.0/usb2/2-2/2-2.1/2-2.1:1.2", "endpoints": [ { "address": { "address": 132, "number": 4, "direction": "In" }, "transfer_type": "Interrupt", "sync_type": "None", "usage_type": "Data", "max_packet_size": 64, "interval": 1 } ] }, { "name": "CDC DATA interface", "string_index": 8, "number": 3, "path": "2-2.1:1.3", "class": "c-d-c-data", "sub_class": 0, "protocol": 0, "alt_setting": 0, "driver": "cdc_acm", "syspath": "/sys/devices/pci0000:00/0000:00:1d.0/usb2/2-2/2-2.1/2-2.1:1.3", "endpoints": [ { "address": { "address": 131, "number": 3, "direction": "In" }, "transfer_type": "Bulk", "sync_type": "None", "usage_type": "Data", "max_packet_size": 64, "interval": 1 }, { "address": { "address": 2, "number": 2, "direction": "Out" }, "transfer_type": "Bulk", "sync_type": "None", "usage_type": "Data", "max_packet_size": 64, "interval": 1 } ] }, { "name": "BULK interface", "string_index": 9, "number": 4, "path": "2-2.1:1.4", "class": "vendor-specific-class", "sub_class": 255, "protocol": 255, "alt_setting": 0, "driver": null, "syspath": "/sys/devices/pci0000:00/0000:00:1d.0/usb2/2-2/2-2.1/2-2.1:1.4", "endpoints": [ { "address": { "address": 133, "number": 5, "direction": "In" }, "transfer_type": "Bulk", "sync_type": "None", "usage_type": "Data", "max_packet_size": 64, "interval": 1 }, { "address": { "address": 3, "number": 3, "direction": "Out" }, "transfer_type": "Bulk", "sync_type": "None", "usage_type": "Data", "max_packet_size": 64, "interval": 1 } ] } ], "attributes": [], "max_power": { "value": 100, "unit": "mA", "description": null } } ] } }, { "name": "UHCI Host Controller", "vendor_id": 7531, "product_id": 1, "location_id": { "bus": 2, "tree_positions": [], "number": 1 }, "serial_num": "0000:00:1d.0", "manufacturer": "Linux 6.0.10-arch2-1 uhci_hcd", "bcd_device": "6.00", "bcd_usb": "1.10", "device_speed": "12.0 Mb/s", "class": "hub", "sub_class": 0, "protocol": 0, "extra": { "max_packet_size": 64, "driver": "hub", "syspath": "/sys/devices/pci0000:00/0000:00:1d.0/usb2/2-0:1.0", "vendor": "Linux Foundation", "product_name": "1.1 root hub", "string_indexes": [ 2, 3, 1 ], "configurations": [ { "name": "", "string_index": 0, "number": 1, "interfaces": [ { "name": "", "string_index": 0, "number": 0, "path": "2-0:1.0", "class": "hub", "sub_class": 0, "protocol": 0, "alt_setting": 0, "driver": "hub", "syspath": "/sys/devices/pci0000:00/0000:00:1d.0/usb2/2-0:1.0", "endpoints": [ { "address": { "address": 129, "number": 1, "direction": "In" }, "transfer_type": "Interrupt", "sync_type": "None", "usage_type": "Data", "max_packet_size": 2, "interval": 255 } ] } ], "attributes": [ "RemoteWakeup", "SelfPowered" ], "max_power": { "value": 0, "unit": "mA", "description": null } } ] } }, { "name": "xHCI Host Controller", "vendor_id": 7531, "product_id": 2, "location_id": { "bus": 3, "tree_positions": [], "number": 1 }, "serial_num": "0000:00:1d.6", "manufacturer": "Linux 6.0.10-arch2-1 xhci-hcd", "bcd_device": "6.00", "bcd_usb": "2.00", "device_speed": "480.0 Mb/s", "class": "hub", "sub_class": 0, "protocol": 1, "extra": { "max_packet_size": 64, "driver": "hub", "syspath": "/sys/devices/pci0000:00/0000:00:1d.6/usb3/3-0:1.0", "vendor": "Linux Foundation", "product_name": "2.0 root hub", "string_indexes": [ 2, 3, 1 ], "configurations": [ { "name": "", "string_index": 0, "number": 1, "interfaces": [ { "name": "", "string_index": 0, "number": 0, "path": "3-0:1.0", "class": "hub", "sub_class": 0, "protocol": 0, "alt_setting": 0, "driver": "hub", "syspath": "/sys/devices/pci0000:00/0000:00:1d.6/usb3/3-0:1.0", "endpoints": [ { "address": { "address": 129, "number": 1, "direction": "In" }, "transfer_type": "Interrupt", "sync_type": "None", "usage_type": "Data", "max_packet_size": 4, "interval": 12 } ] } ], "attributes": [ "RemoteWakeup", "SelfPowered" ], "max_power": { "value": 0, "unit": "mA", "description": null } } ] } }, { "name": "xHCI Host Controller", "vendor_id": 7531, "product_id": 3, "location_id": { "bus": 4, "tree_positions": [], "number": 1 }, "serial_num": "0000:00:1d.6", "manufacturer": "Linux 6.0.10-arch2-1 xhci-hcd", "bcd_device": "6.00", "bcd_usb": "3.10", "device_speed": "10.0 Gb/s", "class": "hub", "sub_class": 0, "protocol": 3, "extra": { "max_packet_size": 9, "driver": "hub", "syspath": "/sys/devices/pci0000:00/0000:00:1d.6/usb4/4-0:1.0", "vendor": "Linux Foundation", "product_name": "3.0 root hub", "string_indexes": [ 2, 3, 1 ], "configurations": [ { "name": "", "string_index": 0, "number": 1, "interfaces": [ { "name": "", "string_index": 0, "number": 0, "path": "4-0:1.0", "class": "hub", "sub_class": 0, "protocol": 0, "alt_setting": 0, "driver": "hub", "syspath": "/sys/devices/pci0000:00/0000:00:1d.6/usb4/4-0:1.0", "endpoints": [ { "address": { "address": 129, "number": 1, "direction": "In" }, "transfer_type": "Interrupt", "sync_type": "None", "usage_type": "Data", "max_packet_size": 4, "interval": 12 } ] } ], "attributes": [ "SelfPowered", "RemoteWakeup" ], "max_power": { "value": 0, "unit": "mA", "description": null } } ] } } ] cyme-2.2.6/tests/data/cyme_libusb_linux_tree.json000066400000000000000000001211121506545537300221720ustar00rootroot00000000000000{ "buses": [ { "name": "EHCI Host Controller", "host_controller": "Linux 6.0.10-arch2-1 ehci_hcd", "pci_vendor": 7531, "pci_device": 2, "usb_bus_number": 1, "devices": [ { "name": "EHCI Host Controller", "vendor_id": 7531, "product_id": 2, "location_id": { "bus": 1, "tree_positions": [], "number": 1 }, "serial_num": "0000:00:1d.7", "manufacturer": "Linux 6.0.10-arch2-1 ehci_hcd", "bcd_device": "6.00", "bcd_usb": "2.00", "device_speed": "480.0 Mb/s", "class": "hub", "sub_class": 0, "protocol": 0, "extra": { "max_packet_size": 64, "driver": "hub", "syspath": "/sys/devices/pci0000:00/0000:00:1d.7/usb1/1-0:1.0", "vendor": "Linux Foundation", "product_name": "2.0 root hub", "string_indexes": [ 2, 3, 1 ], "configurations": [ { "name": "", "string_index": 0, "number": 1, "interfaces": [ { "name": "", "string_index": 0, "number": 0, "path": "1-0:1.0", "class": "hub", "sub_class": 0, "protocol": 0, "alt_setting": 0, "driver": "hub", "syspath": "/sys/devices/pci0000:00/0000:00:1d.7/usb1/1-0:1.0", "endpoints": [ { "length": 7, "address": { "address": 129, "number": 1, "direction": "In" }, "transfer_type": "Interrupt", "sync_type": "None", "usage_type": "Data", "max_packet_size": 4, "interval": 12, "extra": null, "endpoint_path": null } ], "length": 9, "extra": null, "device_path": null } ], "attributes": [ "SelfPowered", "RemoteWakeup" ], "max_power": { "value": 0, "unit": "mA", "description": null }, "length": 9, "total_length": 0, "extra": null } ] } }, { "name": "Virtual Mouse", "vendor_id": 8250, "product_id": 65532, "location_id": { "bus": 1, "tree_positions": [ 2 ], "number": 2 }, "serial_num": "PW3.0", "manufacturer": "Parallels", "bcd_device": "1.00", "bcd_usb": "2.00", "device_speed": "480.0 Mb/s", "class": "use-interface-descriptor", "sub_class": 0, "protocol": 0, "extra": { "max_packet_size": 64, "driver": "usb", "syspath": "/sys/devices/pci0000:00/0000:00:1d.7/usb1/1-2", "vendor": "PARALLELS", "string_indexes": [ 2, 1, 3 ], "configurations": [ { "name": "Parallels", "string_index": 1, "number": 1, "interfaces": [ { "name": "Absolute Coordinate Interface", "string_index": 4, "number": 0, "path": "1-2:1.0", "class": "hid", "sub_class": 0, "protocol": 2, "alt_setting": 0, "driver": "usbhid", "syspath": "/sys/devices/pci0000:00/0000:00:1d.7/usb1/1-2/1-2:1.0", "endpoints": [ { "length": 7, "address": { "address": 129, "number": 1, "direction": "In" }, "transfer_type": "Interrupt", "sync_type": "None", "usage_type": "Data", "max_packet_size": 64, "interval": 4, "extra": null, "endpoint_path": null } ], "length": 9, "extra": null, "device_path": null }, { "name": "Relative Coordinate Interface", "string_index": 5, "number": 1, "path": "1-2:1.1", "class": "hid", "sub_class": 0, "protocol": 2, "alt_setting": 0, "driver": "usbhid", "syspath": "/sys/devices/pci0000:00/0000:00:1d.7/usb1/1-2/1-2:1.1", "endpoints": [ { "length": 7, "address": { "address": 130, "number": 2, "direction": "In" }, "transfer_type": "Interrupt", "sync_type": "None", "usage_type": "Data", "max_packet_size": 64, "interval": 4, "extra": null, "endpoint_path": null } ], "length": 9, "extra": null, "device_path": null } ], "attributes": [ "SelfPowered" ], "max_power": { "value": 0, "unit": "mA", "description": null }, "length": 9, "total_length": 0, "extra": null } ] } }, { "name": "Virtual Printer (/Users/john/Parallels/Arch.pvm/parallel.txt)", "vendor_id": 8250, "product_id": 65530, "location_id": { "bus": 1, "tree_positions": [ 6 ], "number": 3 }, "serial_num": "SN0000", "manufacturer": "Parallels", "bcd_device": "1.00", "bcd_usb": "2.00", "device_speed": "480.0 Mb/s", "class": "use-interface-descriptor", "sub_class": 0, "protocol": 0, "extra": { "max_packet_size": 64, "driver": "usb", "syspath": "/sys/devices/pci0000:00/0000:00:1d.7/usb1/1-6", "vendor": "PARALLELS", "string_indexes": [ 2, 1, 3 ], "configurations": [ { "name": "Parallels", "string_index": 1, "number": 1, "interfaces": [ { "name": "Virtual USB Printer Interface", "string_index": 4, "number": 0, "path": "1-6:1.0", "class": "printer", "sub_class": 1, "protocol": 1, "alt_setting": 0, "driver": "usblp", "syspath": "/sys/devices/pci0000:00/0000:00:1d.7/usb1/1-6/1-6:1.0", "endpoints": [ { "length": 7, "address": { "address": 1, "number": 1, "direction": "Out" }, "transfer_type": "Bulk", "sync_type": "None", "usage_type": "Data", "max_packet_size": 512, "interval": 0, "extra": null, "endpoint_path": null } ], "length": 9, "extra": null, "device_path": null } ], "attributes": [ "SelfPowered" ], "max_power": { "value": 0, "unit": "mA", "description": null }, "length": 9, "total_length": 0, "extra": null } ] } } ] }, { "name": "UHCI Host Controller", "host_controller": "Linux 6.0.10-arch2-1 uhci_hcd", "pci_vendor": 7531, "pci_device": 1, "usb_bus_number": 2, "devices": [ { "name": "UHCI Host Controller", "vendor_id": 7531, "product_id": 1, "location_id": { "bus": 2, "tree_positions": [], "number": 1 }, "serial_num": "0000:00:1d.0", "manufacturer": "Linux 6.0.10-arch2-1 uhci_hcd", "bcd_device": "6.00", "bcd_usb": "1.10", "device_speed": "12.0 Mb/s", "class": "hub", "sub_class": 0, "protocol": 0, "extra": { "max_packet_size": 64, "driver": "hub", "syspath": "/sys/devices/pci0000:00/0000:00:1d.0/usb2/2-0:1.0", "vendor": "Linux Foundation", "product_name": "1.1 root hub", "string_indexes": [ 2, 3, 1 ], "configurations": [ { "name": "", "string_index": 0, "number": 1, "interfaces": [ { "name": "", "string_index": 0, "number": 0, "path": "2-0:1.0", "class": "hub", "sub_class": 0, "protocol": 0, "alt_setting": 0, "driver": "hub", "syspath": "/sys/devices/pci0000:00/0000:00:1d.0/usb2/2-0:1.0", "endpoints": [ { "length": 7, "address": { "address": 129, "number": 1, "direction": "In" }, "transfer_type": "Interrupt", "sync_type": "None", "usage_type": "Data", "max_packet_size": 2, "interval": 255, "extra": null, "endpoint_path": null } ], "length": 9, "extra": null, "device_path": null } ], "attributes": [ "RemoteWakeup", "SelfPowered" ], "max_power": { "value": 0, "unit": "mA", "description": null }, "length": 9, "total_length": 0, "extra": null } ] } }, { "name": "Virtual USB1.1 HUB", "vendor_id": 8250, "product_id": 65534, "location_id": { "bus": 2, "tree_positions": [ 2 ], "number": 22 }, "serial_num": "PW3.0", "manufacturer": "Parallels", "bcd_device": "1.01", "bcd_usb": "2.00", "device_speed": "12.0 Mb/s", "devices": [ { "name": "J-Link", "vendor_id": 4966, "product_id": 4176, "location_id": { "bus": 2, "tree_positions": [ 2, 1 ], "number": 23 }, "serial_num": "001050027328", "manufacturer": "SEGGER", "bcd_device": "1.00", "bcd_usb": "2.00", "device_speed": "12.0 Mb/s", "class": "miscellaneous", "sub_class": 2, "protocol": 1, "extra": { "max_packet_size": 64, "driver": "usb", "syspath": "/sys/devices/pci0000:00/0000:00:1d.0/usb2/2-2/2-2.1", "vendor": "SEGGER", "string_indexes": [ 2, 1, 3 ], "configurations": [ { "name": "Configuration", "string_index": 4, "number": 1, "interfaces": [ { "name": "CDC", "string_index": 5, "number": 0, "path": "2-2.1:1.0", "class": "cdc-communications", "sub_class": 2, "protocol": 1, "alt_setting": 0, "driver": "cdc_acm", "syspath": "/sys/devices/pci0000:00/0000:00:1d.0/usb2/2-2/2-2.1/2-2.1:1.0", "endpoints": [ { "length": 7, "address": { "address": 130, "number": 2, "direction": "In" }, "transfer_type": "Interrupt", "sync_type": "None", "usage_type": "Data", "max_packet_size": 64, "interval": 1, "extra": null, "endpoint_path": null } ], "length": 9, "extra": null, "device_path": null }, { "name": "CDC DATA interface", "string_index": 6, "number": 1, "path": "2-2.1:1.1", "class": "cdc-data", "sub_class": 0, "protocol": 0, "alt_setting": 0, "driver": "cdc_acm", "syspath": "/sys/devices/pci0000:00/0000:00:1d.0/usb2/2-2/2-2.1/2-2.1:1.1", "endpoints": [ { "length": 7, "address": { "address": 129, "number": 1, "direction": "In" }, "transfer_type": "Bulk", "sync_type": "None", "usage_type": "Data", "max_packet_size": 64, "interval": 1, "extra": null, "endpoint_path": null }, { "length": 7, "address": { "address": 1, "number": 1, "direction": "Out" }, "transfer_type": "Bulk", "sync_type": "None", "usage_type": "Data", "max_packet_size": 64, "interval": 1, "extra": null, "endpoint_path": null } ], "length": 9, "extra": null, "device_path": null }, { "name": "CDC", "string_index": 7, "number": 2, "path": "2-2.1:1.2", "class": "cdc-communications", "sub_class": 2, "protocol": 1, "alt_setting": 0, "driver": "cdc_acm", "syspath": "/sys/devices/pci0000:00/0000:00:1d.0/usb2/2-2/2-2.1/2-2.1:1.2", "endpoints": [ { "length": 7, "address": { "address": 132, "number": 4, "direction": "In" }, "transfer_type": "Interrupt", "sync_type": "None", "usage_type": "Data", "max_packet_size": 64, "interval": 1, "extra": null, "endpoint_path": null } ], "length": 9, "extra": null, "device_path": null }, { "name": "CDC DATA interface", "string_index": 8, "number": 3, "path": "2-2.1:1.3", "class": "cdc-data", "sub_class": 0, "protocol": 0, "alt_setting": 0, "driver": "cdc_acm", "syspath": "/sys/devices/pci0000:00/0000:00:1d.0/usb2/2-2/2-2.1/2-2.1:1.3", "endpoints": [ { "length": 7, "address": { "address": 131, "number": 3, "direction": "In" }, "transfer_type": "Bulk", "sync_type": "None", "usage_type": "Data", "max_packet_size": 64, "interval": 1, "extra": null, "endpoint_path": null }, { "length": 7, "address": { "address": 2, "number": 2, "direction": "Out" }, "transfer_type": "Bulk", "sync_type": "None", "usage_type": "Data", "max_packet_size": 64, "interval": 1, "extra": null, "endpoint_path": null } ], "length": 9, "extra": null, "device_path": null }, { "name": "BULK interface", "string_index": 9, "number": 4, "path": "2-2.1:1.4", "class": "vendor-specific-class", "sub_class": 255, "protocol": 255, "alt_setting": 0, "driver": null, "syspath": "/sys/devices/pci0000:00/0000:00:1d.0/usb2/2-2/2-2.1/2-2.1:1.4", "endpoints": [ { "length": 7, "address": { "address": 133, "number": 5, "direction": "In" }, "transfer_type": "Bulk", "sync_type": "None", "usage_type": "Data", "max_packet_size": 64, "interval": 1, "extra": null, "endpoint_path": null }, { "length": 7, "address": { "address": 3, "number": 3, "direction": "Out" }, "transfer_type": "Bulk", "sync_type": "None", "usage_type": "Data", "max_packet_size": 64, "interval": 1, "extra": null, "endpoint_path": null } ], "length": 9, "extra": null, "device_path": null } ], "attributes": [], "max_power": { "value": 100, "unit": "mA", "description": null }, "length": 9, "total_length": 0, "extra": null } ] } }, { "name": "Black Magic Probe v1.8.2", "vendor_id": 7504, "product_id": 24600, "location_id": { "bus": 2, "tree_positions": [ 2, 8 ], "number": 24 }, "serial_num": "97B6A11D", "manufacturer": "Black Magic Debug", "bcd_device": "1.00", "bcd_usb": "2.00", "device_speed": "12.0 Mb/s", "class": "miscellaneous", "sub_class": 2, "protocol": 1, "extra": { "max_packet_size": 32, "driver": "usb", "syspath": "/sys/devices/pci0000:00/0000:00:1d.0/usb2/2-2/2-2.8", "vendor": "OpenMoko, Inc.", "product_name": "Black Magic Debug Probe (Application)", "string_indexes": [ 2, 1, 3 ], "configurations": [ { "name": "", "string_index": 0, "number": 1, "interfaces": [ { "name": "Black Magic GDB Server", "string_index": 4, "number": 0, "path": "2-2.8:1.0", "class": "cdc-communications", "sub_class": 2, "protocol": 0, "alt_setting": 0, "driver": "cdc_acm", "syspath": "/sys/devices/pci0000:00/0000:00:1d.0/usb2/2-2/2-2.8/2-2.8:1.0", "endpoints": [ { "length": 7, "address": { "address": 130, "number": 2, "direction": "In" }, "transfer_type": "Interrupt", "sync_type": "None", "usage_type": "Data", "max_packet_size": 16, "interval": 255, "extra": null, "endpoint_path": null } ], "length": 9, "extra": null, "device_path": null }, { "name": "", "string_index": 0, "number": 1, "path": "2-2.8:1.1", "class": "cdc-data", "sub_class": 0, "protocol": 0, "alt_setting": 0, "driver": "cdc_acm", "syspath": "/sys/devices/pci0000:00/0000:00:1d.0/usb2/2-2/2-2.8/2-2.8:1.1", "endpoints": [ { "length": 7, "address": { "address": 1, "number": 1, "direction": "Out" }, "transfer_type": "Bulk", "sync_type": "None", "usage_type": "Data", "max_packet_size": 64, "interval": 1, "extra": null, "endpoint_path": null }, { "length": 7, "address": { "address": 129, "number": 1, "direction": "In" }, "transfer_type": "Bulk", "sync_type": "None", "usage_type": "Data", "max_packet_size": 64, "interval": 1, "extra": null, "endpoint_path": null } ], "length": 9, "extra": null, "device_path": null }, { "name": "Black Magic UART Port", "string_index": 5, "number": 2, "path": "2-2.8:1.2", "class": "cdc-communications", "sub_class": 2, "protocol": 0, "alt_setting": 0, "driver": "cdc_acm", "syspath": "/sys/devices/pci0000:00/0000:00:1d.0/usb2/2-2/2-2.8/2-2.8:1.2", "endpoints": [ { "length": 7, "address": { "address": 132, "number": 4, "direction": "In" }, "transfer_type": "Interrupt", "sync_type": "None", "usage_type": "Data", "max_packet_size": 16, "interval": 255, "extra": null, "endpoint_path": null } ], "length": 9, "extra": null, "device_path": null }, { "name": "", "string_index": 0, "number": 3, "path": "2-2.8:1.3", "class": "cdc-data", "sub_class": 0, "protocol": 0, "alt_setting": 0, "driver": "cdc_acm", "syspath": "/sys/devices/pci0000:00/0000:00:1d.0/usb2/2-2/2-2.8/2-2.8:1.3", "endpoints": [ { "length": 7, "address": { "address": 3, "number": 3, "direction": "Out" }, "transfer_type": "Bulk", "sync_type": "None", "usage_type": "Data", "max_packet_size": 32, "interval": 1, "extra": null, "endpoint_path": null }, { "length": 7, "address": { "address": 131, "number": 3, "direction": "In" }, "transfer_type": "Bulk", "sync_type": "None", "usage_type": "Data", "max_packet_size": 64, "interval": 1, "extra": null, "endpoint_path": null } ], "length": 9, "extra": null, "device_path": null }, { "name": "Black Magic DFU", "string_index": 6, "number": 4, "path": "2-2.8:1.4", "class": "application-specific-interface", "sub_class": 1, "protocol": 1, "alt_setting": 0, "driver": null, "syspath": "/sys/devices/pci0000:00/0000:00:1d.0/usb2/2-2/2-2.8/2-2.8:1.4", "endpoints": [], "length": 9, "extra": null, "device_path": null }, { "name": "Black Magic Trace Capture", "string_index": 7, "number": 5, "path": "2-2.8:1.5", "class": "vendor-specific-class", "sub_class": 255, "protocol": 255, "alt_setting": 0, "driver": null, "syspath": "/sys/devices/pci0000:00/0000:00:1d.0/usb2/2-2/2-2.8/2-2.8:1.5", "endpoints": [ { "length": 7, "address": { "address": 133, "number": 5, "direction": "In" }, "transfer_type": "Bulk", "sync_type": "None", "usage_type": "Data", "max_packet_size": 64, "interval": 0, "extra": null, "endpoint_path": null } ], "length": 9, "extra": null, "device_path": null } ], "attributes": [], "max_power": { "value": 100, "unit": "mA", "description": null }, "length": 9, "total_length": 0, "extra": null } ] } } ], "class": "hub", "sub_class": 0, "protocol": 0, "extra": { "max_packet_size": 8, "driver": "usb", "syspath": "/sys/devices/pci0000:00/0000:00:1d.0/usb2/2-2", "vendor": "PARALLELS", "string_indexes": [ 2, 1, 3 ], "configurations": [ { "name": "", "string_index": 0, "number": 1, "interfaces": [ { "name": "", "string_index": 0, "number": 0, "path": "2-2:1.0", "class": "hub", "sub_class": 0, "protocol": 0, "alt_setting": 0, "driver": "hub", "syspath": "/sys/devices/pci0000:00/0000:00:1d.0/usb2/2-2/2-2:1.0", "endpoints": [ { "length": 7, "address": { "address": 129, "number": 1, "direction": "In" }, "transfer_type": "Interrupt", "sync_type": "None", "usage_type": "Data", "max_packet_size": 4, "interval": 255, "extra": null, "endpoint_path": null } ], "length": 9, "extra": null, "device_path": null } ], "attributes": [ "SelfPowered" ], "max_power": { "value": 0, "unit": "mA", "description": null }, "length": 9, "total_length": 0, "extra": null } ] } } ] }, { "name": "xHCI Host Controller", "host_controller": "Linux 6.0.10-arch2-1 xhci-hcd", "pci_vendor": 7531, "pci_device": 2, "usb_bus_number": 3, "devices": [ { "name": "xHCI Host Controller", "vendor_id": 7531, "product_id": 2, "location_id": { "bus": 3, "tree_positions": [], "number": 1 }, "serial_num": "0000:00:1d.6", "manufacturer": "Linux 6.0.10-arch2-1 xhci-hcd", "bcd_device": "6.00", "bcd_usb": "2.00", "device_speed": "480.0 Mb/s", "class": "hub", "sub_class": 0, "protocol": 1, "extra": { "max_packet_size": 64, "driver": "hub", "syspath": "/sys/devices/pci0000:00/0000:00:1d.6/usb3/3-0:1.0", "vendor": "Linux Foundation", "product_name": "2.0 root hub", "string_indexes": [ 2, 3, 1 ], "configurations": [ { "name": "", "string_index": 0, "number": 1, "interfaces": [ { "name": "", "string_index": 0, "number": 0, "path": "3-0:1.0", "class": "hub", "sub_class": 0, "protocol": 0, "alt_setting": 0, "driver": "hub", "syspath": "/sys/devices/pci0000:00/0000:00:1d.6/usb3/3-0:1.0", "endpoints": [ { "length": 7, "address": { "address": 129, "number": 1, "direction": "In" }, "transfer_type": "Interrupt", "sync_type": "None", "usage_type": "Data", "max_packet_size": 4, "interval": 12, "extra": null, "endpoint_path": null } ], "length": 9, "extra": null, "device_path": null } ], "attributes": [ "RemoteWakeup", "SelfPowered" ], "max_power": { "value": 0, "unit": "mA", "description": null }, "length": 9, "total_length": 0, "extra": null } ] } } ] }, { "name": "xHCI Host Controller", "host_controller": "Linux 6.0.10-arch2-1 xhci-hcd", "pci_vendor": 7531, "pci_device": 3, "usb_bus_number": 4, "devices": [ { "name": "xHCI Host Controller", "vendor_id": 7531, "product_id": 3, "location_id": { "bus": 4, "tree_positions": [], "number": 1 }, "serial_num": "0000:00:1d.6", "manufacturer": "Linux 6.0.10-arch2-1 xhci-hcd", "bcd_device": "6.00", "bcd_usb": "3.10", "device_speed": "10.0 Gb/s", "class": "hub", "sub_class": 0, "protocol": 3, "extra": { "max_packet_size": 9, "driver": "hub", "syspath": "/sys/devices/pci0000:00/0000:00:1d.6/usb4/4-0:1.0", "vendor": "Linux Foundation", "product_name": "3.0 root hub", "string_indexes": [ 2, 3, 1 ], "configurations": [ { "name": "", "string_index": 0, "number": 1, "interfaces": [ { "name": "", "string_index": 0, "number": 0, "path": "4-0:1.0", "class": "hub", "sub_class": 0, "protocol": 0, "alt_setting": 0, "driver": "hub", "syspath": "/sys/devices/pci0000:00/0000:00:1d.6/usb4/4-0:1.0", "endpoints": [ { "length": 7, "address": { "address": 129, "number": 1, "direction": "In" }, "transfer_type": "Interrupt", "sync_type": "None", "usage_type": "Data", "max_packet_size": 4, "interval": 12, "extra": null, "endpoint_path": null } ], "length": 9, "extra": null, "device_path": null } ], "attributes": [ "RemoteWakeup", "SelfPowered" ], "max_power": { "value": 0, "unit": "mA", "description": null }, "length": 9, "total_length": 0, "extra": null } ] } } ] } ] } cyme-2.2.6/tests/data/cyme_libusb_macos_tree.json000066400000000000000000002733131506545537300221500ustar00rootroot00000000000000{ "buses": [ { "name": "Unknown", "host_controller": "Unknown", "usb_bus_number": 0, "devices": [ { "name": "4-Port USB 3.0 Hub", "vendor_id": 3034, "product_id": 1041, "location_id": { "bus": 0, "tree_positions": [ 1 ], "number": 1 }, "serial_num": "", "manufacturer": "Generic", "bcd_device": "1.17", "bcd_usb": "3.00", "device_speed": "5.0 Gb/s", "devices": [ { "name": "4-Port USB 3.0 Hub", "vendor_id": 3034, "product_id": 1041, "location_id": { "bus": 0, "tree_positions": [ 1, 1 ], "number": 2 }, "serial_num": "", "manufacturer": "Generic", "bcd_device": "1.17", "bcd_usb": "3.00", "device_speed": "5.0 Gb/s", "class": "hub", "sub_class": 0, "protocol": 3, "extra": { "max_packet_size": 9, "vendor": "Realtek Semiconductor Corp.", "product_name": "Hub", "string_indexes": [ 2, 1, 0 ], "configurations": [ { "name": "USB3.0 Hub", "string_index": 4, "number": 1, "interfaces": [ { "name": "Interrupt In Interface", "string_index": 5, "number": 0, "path": "0-1.1:1.0", "class": "hub", "sub_class": 0, "protocol": 0, "alt_setting": 0, "driver": null, "syspath": null, "endpoints": [ { "length": 7, "address": { "address": 129, "number": 1, "direction": "In" }, "transfer_type": "Interrupt", "sync_type": "None", "usage_type": "Feedback", "max_packet_size": 2, "interval": 8 } ], "length": 9 } ], "attributes": [ "RemoteWakeup", "SelfPowered" ], "max_power": { "value": 0, "unit": "mA", "description": null }, "length": 9, "total_length": 0 } ] } } ], "class": "hub", "sub_class": 0, "protocol": 3, "extra": { "max_packet_size": 9, "vendor": "Realtek Semiconductor Corp.", "product_name": "Hub", "string_indexes": [ 2, 1, 0 ], "configurations": [ { "name": "USB3.0 Hub", "string_index": 4, "number": 1, "interfaces": [ { "name": "Interrupt In Interface", "string_index": 5, "number": 0, "path": "0-1:1.0", "class": "hub", "sub_class": 0, "protocol": 0, "alt_setting": 0, "driver": null, "syspath": null, "endpoints": [ { "length": 7, "address": { "address": 129, "number": 1, "direction": "In" }, "transfer_type": "Interrupt", "sync_type": "None", "usage_type": "Feedback", "max_packet_size": 2, "interval": 8 } ], "length": 9 } ], "attributes": [ "RemoteWakeup", "SelfPowered" ], "max_power": { "value": 0, "unit": "mA", "description": null }, "length": 9, "total_length": 0 } ] } } ] }, { "name": "Unknown", "host_controller": "Unknown", "usb_bus_number": 2, "devices": [ { "name": "USB3.1 Hub", "vendor_id": 1086, "product_id": 39520, "location_id": { "bus": 2, "tree_positions": [ 3 ], "number": 2 }, "serial_num": "", "manufacturer": "LG Electronics Inc.", "bcd_device": "34.50", "bcd_usb": "3.10", "device_speed": "5.0 Gb/s", "devices": [ { "name": "Extreme SSD", "vendor_id": 1921, "product_id": 21900, "location_id": { "bus": 2, "tree_positions": [ 3, 2 ], "number": 8 }, "serial_num": "************************", "manufacturer": "SanDisk", "bcd_device": "a.12", "bcd_usb": "3.10", "device_speed": "5.0 Gb/s", "class": "use-interface-descriptor", "sub_class": 0, "protocol": 0, "extra": { "max_packet_size": 9, "vendor": "SanDisk Corp.", "product_name": "Extreme Portable SSD", "string_indexes": [ 3, 2, 1 ], "configurations": [ { "name": "", "string_index": 0, "number": 1, "interfaces": [ { "name": "", "string_index": 0, "number": 0, "path": "2-3.2:1.0", "class": "mass-storage", "sub_class": 6, "protocol": 80, "alt_setting": 0, "driver": null, "syspath": null, "endpoints": [ { "length": 7, "address": { "address": 129, "number": 1, "direction": "In" }, "transfer_type": "Bulk", "sync_type": "None", "usage_type": "Data", "max_packet_size": 1024, "interval": 0 }, { "length": 7, "address": { "address": 2, "number": 2, "direction": "Out" }, "transfer_type": "Bulk", "sync_type": "None", "usage_type": "Data", "max_packet_size": 1024, "interval": 0 } ], "length": 9 }, { "name": "", "string_index": 0, "number": 0, "path": "2-3.2:1.0", "class": "mass-storage", "sub_class": 6, "protocol": 98, "alt_setting": 1, "driver": null, "syspath": null, "endpoints": [ { "length": 7, "address": { "address": 129, "number": 1, "direction": "In" }, "transfer_type": "Bulk", "sync_type": "None", "usage_type": "Data", "max_packet_size": 1024, "interval": 0 }, { "length": 7, "address": { "address": 2, "number": 2, "direction": "Out" }, "transfer_type": "Bulk", "sync_type": "None", "usage_type": "Data", "max_packet_size": 1024, "interval": 0 }, { "length": 7, "address": { "address": 131, "number": 3, "direction": "In" }, "transfer_type": "Bulk", "sync_type": "None", "usage_type": "Data", "max_packet_size": 1024, "interval": 0 }, { "length": 7, "address": { "address": 4, "number": 4, "direction": "Out" }, "transfer_type": "Bulk", "sync_type": "None", "usage_type": "Data", "max_packet_size": 1024, "interval": 0 } ], "length": 9 } ], "attributes": [], "max_power": { "value": 224, "unit": "mA", "description": null }, "length": 9, "total_length": 0 } ] } }, { "name": "Belkin USB-C LAN", "vendor_id": 3034, "product_id": 33107, "location_id": { "bus": 2, "tree_positions": [ 3, 1 ], "number": 7 }, "serial_num": "************", "manufacturer": "Belkin", "bcd_device": "1e.00", "bcd_usb": "3.00", "device_speed": "5.0 Gb/s", "class": "use-interface-descriptor", "sub_class": 0, "protocol": 0, "extra": { "max_packet_size": 9, "vendor": "Realtek Semiconductor Corp.", "product_name": "RTL8153 Gigabit Ethernet Adapter", "string_indexes": [ 2, 1, 6 ], "configurations": [ { "name": "", "string_index": 0, "number": 1, "interfaces": [ { "name": "", "string_index": 0, "number": 0, "path": "2-3.1:1.0", "class": "vendor-specific-class", "sub_class": 255, "protocol": 0, "alt_setting": 0, "driver": null, "syspath": null, "endpoints": [ { "length": 7, "address": { "address": 129, "number": 1, "direction": "In" }, "transfer_type": "Bulk", "sync_type": "None", "usage_type": "Data", "max_packet_size": 1024, "interval": 0 }, { "length": 7, "address": { "address": 2, "number": 2, "direction": "Out" }, "transfer_type": "Bulk", "sync_type": "None", "usage_type": "Data", "max_packet_size": 1024, "interval": 0 }, { "length": 7, "address": { "address": 131, "number": 3, "direction": "In" }, "transfer_type": "Interrupt", "sync_type": "None", "usage_type": "Data", "max_packet_size": 2, "interval": 8 } ], "length": 9 } ], "attributes": [ "RemoteWakeup" ], "max_power": { "value": 64, "unit": "mA", "description": null }, "length": 9, "total_length": 0 }, { "name": "", "string_index": 0, "number": 2, "interfaces": [ { "name": "CDC Communications Control", "string_index": 5, "number": 0, "path": "2-3.1:2.0", "class": "c-d-c-communications", "sub_class": 6, "protocol": 0, "alt_setting": 0, "driver": null, "syspath": null, "endpoints": [ { "length": 7, "address": { "address": 131, "number": 3, "direction": "In" }, "transfer_type": "Interrupt", "sync_type": "None", "usage_type": "Data", "max_packet_size": 16, "interval": 8 } ], "length": 9 }, { "name": "", "string_index": 0, "number": 1, "path": "2-3.1:2.1", "class": "c-d-c-data", "sub_class": 0, "protocol": 0, "alt_setting": 0, "driver": null, "syspath": null, "endpoints": [], "length": 9 }, { "name": "Ethernet Data", "string_index": 4, "number": 1, "path": "2-3.1:2.1", "class": "c-d-c-data", "sub_class": 0, "protocol": 0, "alt_setting": 1, "driver": null, "syspath": null, "endpoints": [ { "length": 7, "address": { "address": 129, "number": 1, "direction": "In" }, "transfer_type": "Bulk", "sync_type": "None", "usage_type": "Data", "max_packet_size": 1024, "interval": 0 }, { "length": 7, "address": { "address": 2, "number": 2, "direction": "Out" }, "transfer_type": "Bulk", "sync_type": "None", "usage_type": "Data", "max_packet_size": 1024, "interval": 0 } ], "length": 9 } ], "attributes": [ "RemoteWakeup" ], "max_power": { "value": 64, "unit": "mA", "description": null }, "length": 9, "total_length": 0 } ] } }, { "name": "", "vendor_id": 1086, "product_id": 39537, "location_id": { "bus": 2, "tree_positions": [ 3, 4 ], "number": 6 }, "serial_num": "", "manufacturer": "LG Electronics USA, Inc.", "bcd_device": "1.00", "bcd_usb": "3.00", "device_speed": "5.0 Gb/s", "devices": [ { "name": "LG UltraFine Display Camera", "vendor_id": 1086, "product_id": 39528, "location_id": { "bus": 2, "tree_positions": [ 3, 4, 3 ], "number": 9 }, "serial_num": "", "manufacturer": "LG Electronlcs Inc.", "bcd_device": "2.23", "bcd_usb": "3.00", "device_speed": "5.0 Gb/s", "class": "miscellaneous", "sub_class": 2, "protocol": 1, "extra": { "max_packet_size": 9, "vendor": "LG Electronics USA, Inc.", "string_indexes": [ 2, 1, 0 ], "configurations": [ { "name": "USB-3.0", "string_index": 3, "number": 1, "interfaces": [ { "name": "", "string_index": 0, "number": 0, "path": "2-3.4.3:1.0", "class": "video", "sub_class": 1, "protocol": 0, "alt_setting": 0, "driver": null, "syspath": null, "endpoints": [ { "length": 7, "address": { "address": 130, "number": 2, "direction": "In" }, "transfer_type": "Interrupt", "sync_type": "None", "usage_type": "Data", "max_packet_size": 64, "interval": 1 } ], "length": 9 }, { "name": "", "string_index": 0, "number": 1, "path": "2-3.4.3:1.1", "class": "video", "sub_class": 2, "protocol": 0, "alt_setting": 0, "driver": null, "syspath": null, "endpoints": [], "length": 9 }, { "name": "", "string_index": 0, "number": 1, "path": "2-3.4.3:1.1", "class": "video", "sub_class": 2, "protocol": 0, "alt_setting": 1, "driver": null, "syspath": null, "endpoints": [ { "length": 7, "address": { "address": 131, "number": 3, "direction": "In" }, "transfer_type": "Isochronous", "sync_type": "None", "usage_type": "Data", "max_packet_size": 1024, "interval": 1 } ], "length": 9 }, { "name": "", "string_index": 0, "number": 2, "path": "2-3.4.3:1.2", "class": "h-i-d", "sub_class": 0, "protocol": 0, "alt_setting": 0, "driver": null, "syspath": null, "endpoints": [ { "length": 7, "address": { "address": 5, "number": 5, "direction": "Out" }, "transfer_type": "Interrupt", "sync_type": "None", "usage_type": "Data", "max_packet_size": 1024, "interval": 1 }, { "length": 7, "address": { "address": 133, "number": 5, "direction": "In" }, "transfer_type": "Interrupt", "sync_type": "None", "usage_type": "Data", "max_packet_size": 1024, "interval": 1 } ], "length": 9 } ], "attributes": [ "RemoteWakeup" ], "max_power": { "value": 24, "unit": "mA", "description": null }, "length": 9, "total_length": 0 } ] } } ], "class": "hub", "sub_class": 0, "protocol": 3, "extra": { "max_packet_size": 9, "vendor": "LG Electronics USA, Inc.", "string_indexes": [ 0, 0, 0 ], "configurations": [ { "name": "", "string_index": 0, "number": 1, "interfaces": [ { "name": "", "string_index": 0, "number": 0, "path": "2-3.4:1.0", "class": "hub", "sub_class": 0, "protocol": 0, "alt_setting": 0, "driver": null, "syspath": null, "endpoints": [ { "length": 7, "address": { "address": 129, "number": 1, "direction": "In" }, "transfer_type": "Interrupt", "sync_type": "None", "usage_type": "Feedback", "max_packet_size": 2, "interval": 8 } ], "length": 9 } ], "attributes": [ "RemoteWakeup", "SelfPowered" ], "max_power": { "value": 0, "unit": "mA", "description": null }, "length": 9, "total_length": 0 } ] } }, { "name": "USB3.0 Hub", "vendor_id": 8457, "product_id": 2071, "location_id": { "bus": 2, "tree_positions": [ 3, 3 ], "number": 4 }, "serial_num": "", "manufacturer": "VIA Labs, Inc.", "bcd_device": "4.53", "bcd_usb": "3.10", "device_speed": "5.0 Gb/s", "class": "hub", "sub_class": 0, "protocol": 3, "extra": { "max_packet_size": 9, "vendor": "VIA Labs, Inc.", "string_indexes": [ 2, 1, 0 ], "configurations": [ { "name": "", "string_index": 0, "number": 1, "interfaces": [ { "name": "", "string_index": 0, "number": 0, "path": "2-3.3:1.0", "class": "hub", "sub_class": 0, "protocol": 0, "alt_setting": 0, "driver": null, "syspath": null, "endpoints": [ { "length": 7, "address": { "address": 129, "number": 1, "direction": "In" }, "transfer_type": "Interrupt", "sync_type": "None", "usage_type": "Feedback", "max_packet_size": 2, "interval": 8 } ], "length": 9 } ], "attributes": [ "RemoteWakeup", "SelfPowered" ], "max_power": { "value": 0, "unit": "mA", "description": null }, "length": 9, "total_length": 0 } ] } } ], "class": "hub", "sub_class": 0, "protocol": 3, "extra": { "max_packet_size": 9, "vendor": "LG Electronics USA, Inc.", "string_indexes": [ 2, 1, 0 ], "configurations": [ { "name": "", "string_index": 0, "number": 1, "interfaces": [ { "name": "", "string_index": 0, "number": 0, "path": "2-3:1.0", "class": "hub", "sub_class": 0, "protocol": 0, "alt_setting": 0, "driver": null, "syspath": null, "endpoints": [ { "length": 7, "address": { "address": 131, "number": 3, "direction": "In" }, "transfer_type": "Interrupt", "sync_type": "None", "usage_type": "Feedback", "max_packet_size": 2, "interval": 8 } ], "length": 9 } ], "attributes": [ "RemoteWakeup", "SelfPowered" ], "max_power": { "value": 0, "unit": "mA", "description": null }, "length": 9, "total_length": 0 } ] } }, { "name": "USB2.1 Hub", "vendor_id": 1086, "product_id": 39521, "location_id": { "bus": 2, "tree_positions": [ 2 ], "number": 1 }, "serial_num": "", "manufacturer": "LG Electronics Inc.", "bcd_device": "34.50", "bcd_usb": "2.10", "device_speed": "480.0 Mb/s", "devices": [ { "name": "USB2.0 Hub", "vendor_id": 8457, "product_id": 10263, "location_id": { "bus": 2, "tree_positions": [ 2, 3 ], "number": 5 }, "serial_num": "", "manufacturer": "VIA Labs, Inc.", "bcd_device": "4.53", "bcd_usb": "2.10", "device_speed": "480.0 Mb/s", "devices": [ { "name": "Specialized TCU2", "vendor_id": 6421, "product_id": 21004, "location_id": { "bus": 2, "tree_positions": [ 2, 3, 1 ], "number": 23 }, "serial_num": "************", "manufacturer": "Specialized", "bcd_device": "1.00", "bcd_usb": "2.00", "device_speed": "12.0 Mb/s", "class": "use-interface-descriptor", "sub_class": 0, "protocol": 0, "extra": { "max_packet_size": 64, "vendor": "Nordic Semiconductor ASA", "string_indexes": [ 2, 1, 3 ], "configurations": [ { "name": "Default configuration", "string_index": 4, "number": 1, "interfaces": [ { "name": "", "string_index": 0, "number": 0, "path": "2-2.3.1:1.0", "class": "h-i-d", "sub_class": 0, "protocol": 0, "alt_setting": 0, "driver": null, "syspath": null, "endpoints": [ { "length": 7, "address": { "address": 129, "number": 1, "direction": "In" }, "transfer_type": "Interrupt", "sync_type": "None", "usage_type": "Data", "max_packet_size": 64, "interval": 10 }, { "length": 7, "address": { "address": 1, "number": 1, "direction": "Out" }, "transfer_type": "Interrupt", "sync_type": "None", "usage_type": "Data", "max_packet_size": 64, "interval": 10 } ], "length": 9 } ], "attributes": [ "RemoteWakeup", "SelfPowered" ], "max_power": { "value": 500, "unit": "mA", "description": null }, "length": 9, "total_length": 0 } ] } }, { "name": "J-Link", "vendor_id": 4966, "product_id": 257, "location_id": { "bus": 2, "tree_positions": [ 2, 3, 3 ], "number": 20 }, "serial_num": "************", "manufacturer": "SEGGER", "bcd_device": "1.00", "bcd_usb": "2.00", "device_speed": "480.0 Mb/s", "class": "use-interface-descriptor", "sub_class": 0, "protocol": 0, "extra": { "max_packet_size": 64, "vendor": "SEGGER", "product_name": "J-Link PLUS", "string_indexes": [ 2, 1, 3 ], "configurations": [ { "name": "Configuration", "string_index": 4, "number": 1, "interfaces": [ { "name": "BULK interface", "string_index": 5, "number": 0, "path": "2-2.3.3:1.0", "class": "vendor-specific-class", "sub_class": 255, "protocol": 255, "alt_setting": 0, "driver": null, "syspath": null, "endpoints": [ { "length": 7, "address": { "address": 129, "number": 1, "direction": "In" }, "transfer_type": "Bulk", "sync_type": "None", "usage_type": "Data", "max_packet_size": 512, "interval": 1 }, { "length": 7, "address": { "address": 1, "number": 1, "direction": "Out" }, "transfer_type": "Bulk", "sync_type": "None", "usage_type": "Data", "max_packet_size": 512, "interval": 1 } ], "length": 9 } ], "attributes": [], "max_power": { "value": 100, "unit": "mA", "description": null }, "length": 9, "total_length": 0 } ] } }, { "name": "USB Billboard Device", "vendor_id": 8457, "product_id": 34839, "location_id": { "bus": 2, "tree_positions": [ 2, 3, 5 ], "number": 12 }, "serial_num": "****************", "manufacturer": "VIA Labs, Inc.", "bcd_device": "0.01", "bcd_usb": "2.01", "device_speed": "480.0 Mb/s", "class": "application-specific-interface", "sub_class": 0, "protocol": 0, "extra": { "max_packet_size": 64, "vendor": "VIA Labs, Inc.", "string_indexes": [ 2, 1, 3 ], "configurations": [ { "name": "0000000000000001", "string_index": 3, "number": 1, "interfaces": [ { "name": "0000000000000001", "string_index": 3, "number": 0, "path": "2-2.3.5:1.0", "class": "billboard", "sub_class": 0, "protocol": 0, "alt_setting": 0, "driver": null, "syspath": null, "endpoints": [], "length": 9 } ], "attributes": [ "RemoteWakeup" ], "max_power": { "value": 100, "unit": "mA", "description": null }, "length": 9, "total_length": 0 } ] } } ], "class": "hub", "sub_class": 0, "protocol": 2, "extra": { "max_packet_size": 64, "vendor": "VIA Labs, Inc.", "string_indexes": [ 2, 1, 0 ], "configurations": [ { "name": "", "string_index": 0, "number": 1, "interfaces": [ { "name": "", "string_index": 0, "number": 0, "path": "2-2.3:1.0", "class": "hub", "sub_class": 0, "protocol": 1, "alt_setting": 0, "driver": null, "syspath": null, "endpoints": [ { "length": 7, "address": { "address": 129, "number": 1, "direction": "In" }, "transfer_type": "Interrupt", "sync_type": "None", "usage_type": "Data", "max_packet_size": 1, "interval": 12 } ], "length": 9 }, { "name": "", "string_index": 0, "number": 0, "path": "2-2.3:1.0", "class": "hub", "sub_class": 0, "protocol": 2, "alt_setting": 1, "driver": null, "syspath": null, "endpoints": [ { "length": 7, "address": { "address": 129, "number": 1, "direction": "In" }, "transfer_type": "Interrupt", "sync_type": "None", "usage_type": "Data", "max_packet_size": 1, "interval": 12 } ], "length": 9 } ], "attributes": [ "RemoteWakeup", "SelfPowered" ], "max_power": { "value": 0, "unit": "mA", "description": null }, "length": 9, "total_length": 0 } ] } }, { "name": "", "vendor_id": 1086, "product_id": 39539, "location_id": { "bus": 2, "tree_positions": [ 2, 4 ], "number": 3 }, "serial_num": "************", "manufacturer": "LG Electronics USA, Inc.", "bcd_device": "1.00", "bcd_usb": "2.10", "device_speed": "480.0 Mb/s", "devices": [ { "name": "LG UltraFine Display Controls", "vendor_id": 1086, "product_id": 39536, "location_id": { "bus": 2, "tree_positions": [ 2, 4, 2 ], "number": 11 }, "serial_num": "", "manufacturer": "LG Electronics Inc.", "bcd_device": "4.13", "bcd_usb": "2.00", "device_speed": "12.0 Mb/s", "class": "use-interface-descriptor", "sub_class": 0, "protocol": 0, "extra": { "max_packet_size": 64, "vendor": "LG Electronics USA, Inc.", "string_indexes": [ 2, 1, 0 ], "configurations": [ { "name": "", "string_index": 0, "number": 1, "interfaces": [ { "name": "HID I2C", "string_index": 5, "number": 0, "path": "2-2.4.2:1.0", "class": "h-i-d", "sub_class": 0, "protocol": 0, "alt_setting": 0, "driver": null, "syspath": null, "endpoints": [ { "length": 7, "address": { "address": 129, "number": 1, "direction": "In" }, "transfer_type": "Interrupt", "sync_type": "None", "usage_type": "Data", "max_packet_size": 64, "interval": 1 }, { "length": 7, "address": { "address": 1, "number": 1, "direction": "Out" }, "transfer_type": "Interrupt", "sync_type": "None", "usage_type": "Data", "max_packet_size": 64, "interval": 1 } ], "length": 9 }, { "name": "HID BRIGHTNESS", "string_index": 6, "number": 1, "path": "2-2.4.2:1.1", "class": "h-i-d", "sub_class": 0, "protocol": 0, "alt_setting": 0, "driver": null, "syspath": null, "endpoints": [ { "length": 7, "address": { "address": 130, "number": 2, "direction": "In" }, "transfer_type": "Interrupt", "sync_type": "None", "usage_type": "Data", "max_packet_size": 6, "interval": 9 }, { "length": 7, "address": { "address": 2, "number": 2, "direction": "Out" }, "transfer_type": "Interrupt", "sync_type": "None", "usage_type": "Data", "max_packet_size": 6, "interval": 9 } ], "length": 9 }, { "name": "HID ALS", "string_index": 7, "number": 2, "path": "2-2.4.2:1.2", "class": "h-i-d", "sub_class": 0, "protocol": 0, "alt_setting": 0, "driver": null, "syspath": null, "endpoints": [ { "length": 7, "address": { "address": 131, "number": 3, "direction": "In" }, "transfer_type": "Interrupt", "sync_type": "None", "usage_type": "Data", "max_packet_size": 6, "interval": 100 }, { "length": 7, "address": { "address": 3, "number": 3, "direction": "Out" }, "transfer_type": "Interrupt", "sync_type": "None", "usage_type": "Data", "max_packet_size": 6, "interval": 100 } ], "length": 9 } ], "attributes": [ "SelfPowered" ], "max_power": { "value": 0, "unit": "mA", "description": null }, "length": 9, "total_length": 0 } ] } }, { "name": "LG UltraFine Display Audio", "vendor_id": 1086, "product_id": 39526, "location_id": { "bus": 2, "tree_positions": [ 2, 4, 1 ], "number": 10 }, "serial_num": "", "manufacturer": "LG Electronics Inc.", "bcd_device": "0.03", "bcd_usb": "2.00", "device_speed": "480.0 Mb/s", "class": "use-interface-descriptor", "sub_class": 0, "protocol": 0, "extra": { "max_packet_size": 64, "vendor": "LG Electronics USA, Inc.", "string_indexes": [ 1, 3, 0 ], "configurations": [ { "name": "LG UltraFine Display Audio", "string_index": 4, "number": 1, "interfaces": [ { "name": "LG UltraFine Display Audio", "string_index": 6, "number": 0, "path": "2-2.4.1:1.0", "class": "audio", "sub_class": 1, "protocol": 0, "alt_setting": 0, "driver": null, "syspath": null, "endpoints": [], "length": 9 }, { "name": "", "string_index": 0, "number": 1, "path": "2-2.4.1:1.1", "class": "audio", "sub_class": 2, "protocol": 0, "alt_setting": 0, "driver": null, "syspath": null, "endpoints": [], "length": 9 }, { "name": "", "string_index": 0, "number": 1, "path": "2-2.4.1:1.1", "class": "audio", "sub_class": 2, "protocol": 0, "alt_setting": 1, "driver": null, "syspath": null, "endpoints": [ { "length": 7, "address": { "address": 132, "number": 4, "direction": "In" }, "transfer_type": "Isochronous", "sync_type": "Asynchronous", "usage_type": "Data", "max_packet_size": 147, "interval": 4 } ], "length": 9 }, { "name": "", "string_index": 0, "number": 2, "path": "2-2.4.1:1.2", "class": "audio", "sub_class": 2, "protocol": 0, "alt_setting": 0, "driver": null, "syspath": null, "endpoints": [], "length": 9 }, { "name": "", "string_index": 0, "number": 2, "path": "2-2.4.1:1.2", "class": "audio", "sub_class": 2, "protocol": 0, "alt_setting": 1, "driver": null, "syspath": null, "endpoints": [ { "length": 7, "address": { "address": 7, "number": 7, "direction": "Out" }, "transfer_type": "Isochronous", "sync_type": "Adaptive", "usage_type": "Data", "max_packet_size": 294, "interval": 4 } ], "length": 9 } ], "attributes": [ "SelfPowered" ], "max_power": { "value": 0, "unit": "mA", "description": null }, "length": 9, "total_length": 0 } ] } } ], "class": "hub", "sub_class": 0, "protocol": 2, "extra": { "max_packet_size": 64, "vendor": "LG Electronics USA, Inc.", "string_indexes": [ 0, 0, 1 ], "configurations": [ { "name": "", "string_index": 0, "number": 1, "interfaces": [ { "name": "", "string_index": 0, "number": 0, "path": "2-2.4:1.0", "class": "hub", "sub_class": 0, "protocol": 1, "alt_setting": 0, "driver": null, "syspath": null, "endpoints": [ { "length": 7, "address": { "address": 129, "number": 1, "direction": "In" }, "transfer_type": "Interrupt", "sync_type": "None", "usage_type": "Data", "max_packet_size": 1, "interval": 12 } ], "length": 9 }, { "name": "", "string_index": 0, "number": 0, "path": "2-2.4:1.0", "class": "hub", "sub_class": 0, "protocol": 2, "alt_setting": 1, "driver": null, "syspath": null, "endpoints": [ { "length": 7, "address": { "address": 129, "number": 1, "direction": "In" }, "transfer_type": "Interrupt", "sync_type": "None", "usage_type": "Data", "max_packet_size": 1, "interval": 12 } ], "length": 9 } ], "attributes": [ "RemoteWakeup", "SelfPowered" ], "max_power": { "value": 0, "unit": "mA", "description": null }, "length": 9, "total_length": 0 } ] } } ], "class": "hub", "sub_class": 0, "protocol": 2, "extra": { "max_packet_size": 64, "vendor": "LG Electronics USA, Inc.", "string_indexes": [ 2, 1, 0 ], "configurations": [ { "name": "", "string_index": 0, "number": 1, "interfaces": [ { "name": "", "string_index": 0, "number": 0, "path": "2-2:1.0", "class": "hub", "sub_class": 0, "protocol": 1, "alt_setting": 0, "driver": null, "syspath": null, "endpoints": [ { "length": 7, "address": { "address": 129, "number": 1, "direction": "In" }, "transfer_type": "Interrupt", "sync_type": "None", "usage_type": "Data", "max_packet_size": 1, "interval": 12 } ], "length": 9 }, { "name": "", "string_index": 0, "number": 0, "path": "2-2:1.0", "class": "hub", "sub_class": 0, "protocol": 2, "alt_setting": 1, "driver": null, "syspath": null, "endpoints": [ { "length": 7, "address": { "address": 129, "number": 1, "direction": "In" }, "transfer_type": "Interrupt", "sync_type": "None", "usage_type": "Data", "max_packet_size": 1, "interval": 12 } ], "length": 9 } ], "attributes": [ "RemoteWakeup", "SelfPowered" ], "max_power": { "value": 100, "unit": "mA", "description": null }, "length": 9, "total_length": 0 } ] } } ] }, { "name": "Unknown", "host_controller": "Unknown", "usb_bus_number": 20, "devices": [ { "name": "AirPods Max", "vendor_id": 1452, "product_id": 4361, "location_id": { "bus": 20, "tree_positions": [ 1 ], "number": 4 }, "serial_num": "************", "manufacturer": "Apple Inc.", "bcd_device": "65.00", "bcd_usb": "2.01", "device_speed": "12.0 Mb/s", "class": "use-interface-descriptor", "sub_class": 0, "protocol": 0, "extra": { "max_packet_size": 64, "vendor": "Apple, Inc.", "string_indexes": [ 2, 1, 3 ], "configurations": [ { "name": "", "string_index": 0, "number": 1, "interfaces": [ { "name": "", "string_index": 0, "number": 0, "path": "20-1:1.0", "class": "h-i-d", "sub_class": 0, "protocol": 0, "alt_setting": 0, "driver": null, "syspath": null, "endpoints": [ { "length": 7, "address": { "address": 130, "number": 2, "direction": "In" }, "transfer_type": "Interrupt", "sync_type": "None", "usage_type": "Data", "max_packet_size": 64, "interval": 1 }, { "length": 7, "address": { "address": 2, "number": 2, "direction": "Out" }, "transfer_type": "Interrupt", "sync_type": "None", "usage_type": "Data", "max_packet_size": 16, "interval": 1 } ], "length": 9 } ], "attributes": [ "SelfPowered" ], "max_power": { "value": 500, "unit": "mA", "description": null }, "length": 9, "total_length": 0 } ] } }, { "name": "4-Port USB 2.0 Hub", "vendor_id": 3034, "product_id": 21521, "location_id": { "bus": 20, "tree_positions": [ 3 ], "number": 1 }, "serial_num": "", "manufacturer": "Generic", "bcd_device": "1.17", "bcd_usb": "2.10", "device_speed": "480.0 Mb/s", "devices": [ { "name": "Black Magic Probe v1.8.2", "vendor_id": 7504, "product_id": 24600, "location_id": { "bus": 20, "tree_positions": [ 3, 3 ], "number": 6 }, "serial_num": "********", "manufacturer": "Black Magic Debug", "bcd_device": "1.00", "bcd_usb": "2.00", "device_speed": "12.0 Mb/s", "class": "miscellaneous", "sub_class": 2, "protocol": 1, "extra": { "max_packet_size": 32, "vendor": "OpenMoko, Inc.", "product_name": "Black Magic Debug Probe (Application)", "string_indexes": [ 2, 1, 3 ], "configurations": [ { "name": "", "string_index": 0, "number": 1, "interfaces": [ { "name": "Black Magic GDB Server", "string_index": 4, "number": 0, "path": "20-3.3:1.0", "class": "c-d-c-communications", "sub_class": 2, "protocol": 0, "alt_setting": 0, "driver": null, "syspath": null, "endpoints": [ { "length": 7, "address": { "address": 130, "number": 2, "direction": "In" }, "transfer_type": "Interrupt", "sync_type": "None", "usage_type": "Data", "max_packet_size": 16, "interval": 255 } ], "length": 9 }, { "name": "", "string_index": 0, "number": 1, "path": "20-3.3:1.1", "class": "c-d-c-data", "sub_class": 0, "protocol": 0, "alt_setting": 0, "driver": null, "syspath": null, "endpoints": [ { "length": 7, "address": { "address": 1, "number": 1, "direction": "Out" }, "transfer_type": "Bulk", "sync_type": "None", "usage_type": "Data", "max_packet_size": 64, "interval": 1 }, { "length": 7, "address": { "address": 129, "number": 1, "direction": "In" }, "transfer_type": "Bulk", "sync_type": "None", "usage_type": "Data", "max_packet_size": 64, "interval": 1 } ], "length": 9 }, { "name": "Black Magic UART Port", "string_index": 5, "number": 2, "path": "20-3.3:1.2", "class": "c-d-c-communications", "sub_class": 2, "protocol": 0, "alt_setting": 0, "driver": null, "syspath": null, "endpoints": [ { "length": 7, "address": { "address": 132, "number": 4, "direction": "In" }, "transfer_type": "Interrupt", "sync_type": "None", "usage_type": "Data", "max_packet_size": 16, "interval": 255 } ], "length": 9 }, { "name": "", "string_index": 0, "number": 3, "path": "20-3.3:1.3", "class": "c-d-c-data", "sub_class": 0, "protocol": 0, "alt_setting": 0, "driver": null, "syspath": null, "endpoints": [ { "length": 7, "address": { "address": 3, "number": 3, "direction": "Out" }, "transfer_type": "Bulk", "sync_type": "None", "usage_type": "Data", "max_packet_size": 32, "interval": 1 }, { "length": 7, "address": { "address": 131, "number": 3, "direction": "In" }, "transfer_type": "Bulk", "sync_type": "None", "usage_type": "Data", "max_packet_size": 64, "interval": 1 } ], "length": 9 }, { "name": "Black Magic DFU", "string_index": 6, "number": 4, "path": "20-3.3:1.4", "class": "application-specific-interface", "sub_class": 1, "protocol": 1, "alt_setting": 0, "driver": null, "syspath": null, "endpoints": [], "length": 9 }, { "name": "Black Magic Trace Capture", "string_index": 7, "number": 5, "path": "20-3.3:1.5", "class": "vendor-specific-class", "sub_class": 255, "protocol": 255, "alt_setting": 0, "driver": null, "syspath": null, "endpoints": [ { "length": 7, "address": { "address": 133, "number": 5, "direction": "In" }, "transfer_type": "Bulk", "sync_type": "None", "usage_type": "Data", "max_packet_size": 64, "interval": 0 } ], "length": 9 } ], "attributes": [], "max_power": { "value": 100, "unit": "mA", "description": null }, "length": 9, "total_length": 0 } ] } }, { "name": "4-Port USB 2.0 Hub", "vendor_id": 3034, "product_id": 21521, "location_id": { "bus": 20, "tree_positions": [ 3, 1 ], "number": 2 }, "serial_num": "", "manufacturer": "Generic", "bcd_device": "1.17", "bcd_usb": "2.10", "device_speed": "480.0 Mb/s", "devices": [ { "name": "Android", "vendor_id": 1478, "product_id": 37009, "location_id": { "bus": 20, "tree_positions": [ 3, 1, 3 ], "number": 5 }, "serial_num": "*******************", "manufacturer": "Android", "bcd_device": "3.18", "bcd_usb": "2.00", "device_speed": "480.0 Mb/s", "class": "use-interface-descriptor", "sub_class": 0, "protocol": 0, "extra": { "max_packet_size": 64, "vendor": "Qualcomm, Inc.", "product_name": "Intex Aqua Fish & Jolla C Diagnostic Mode", "string_indexes": [ 2, 1, 3 ], "configurations": [ { "name": "", "string_index": 0, "number": 1, "interfaces": [ { "name": "", "string_index": 0, "number": 0, "path": "20-3.1.3:1.0", "class": "vendor-specific-class", "sub_class": 255, "protocol": 255, "alt_setting": 0, "driver": null, "syspath": null, "endpoints": [ { "length": 7, "address": { "address": 129, "number": 1, "direction": "In" }, "transfer_type": "Bulk", "sync_type": "None", "usage_type": "Data", "max_packet_size": 512, "interval": 0 }, { "length": 7, "address": { "address": 1, "number": 1, "direction": "Out" }, "transfer_type": "Bulk", "sync_type": "None", "usage_type": "Data", "max_packet_size": 512, "interval": 0 } ], "length": 9 }, { "name": "", "string_index": 0, "number": 1, "path": "20-3.1.3:1.1", "class": "vendor-specific-class", "sub_class": 0, "protocol": 0, "alt_setting": 0, "driver": null, "syspath": null, "endpoints": [ { "length": 7, "address": { "address": 131, "number": 3, "direction": "In" }, "transfer_type": "Interrupt", "sync_type": "None", "usage_type": "Data", "max_packet_size": 10, "interval": 9 }, { "length": 7, "address": { "address": 130, "number": 2, "direction": "In" }, "transfer_type": "Bulk", "sync_type": "None", "usage_type": "Data", "max_packet_size": 512, "interval": 0 }, { "length": 7, "address": { "address": 2, "number": 2, "direction": "Out" }, "transfer_type": "Bulk", "sync_type": "None", "usage_type": "Data", "max_packet_size": 512, "interval": 0 } ], "length": 9 }, { "name": "", "string_index": 0, "number": 2, "path": "20-3.1.3:1.2", "class": "vendor-specific-class", "sub_class": 255, "protocol": 255, "alt_setting": 0, "driver": null, "syspath": null, "endpoints": [ { "length": 7, "address": { "address": 133, "number": 5, "direction": "In" }, "transfer_type": "Interrupt", "sync_type": "None", "usage_type": "Data", "max_packet_size": 8, "interval": 9 }, { "length": 7, "address": { "address": 132, "number": 4, "direction": "In" }, "transfer_type": "Bulk", "sync_type": "None", "usage_type": "Data", "max_packet_size": 512, "interval": 0 }, { "length": 7, "address": { "address": 3, "number": 3, "direction": "Out" }, "transfer_type": "Bulk", "sync_type": "None", "usage_type": "Data", "max_packet_size": 512, "interval": 0 } ], "length": 9 }, { "name": "ADB Interface", "string_index": 8, "number": 3, "path": "20-3.1.3:1.3", "class": "vendor-specific-class", "sub_class": 66, "protocol": 1, "alt_setting": 0, "driver": null, "syspath": null, "endpoints": [ { "length": 7, "address": { "address": 4, "number": 4, "direction": "Out" }, "transfer_type": "Bulk", "sync_type": "None", "usage_type": "Data", "max_packet_size": 512, "interval": 0 }, { "length": 7, "address": { "address": 134, "number": 6, "direction": "In" }, "transfer_type": "Bulk", "sync_type": "None", "usage_type": "Data", "max_packet_size": 512, "interval": 0 } ], "length": 9 } ], "attributes": [], "max_power": { "value": 500, "unit": "mA", "description": null }, "length": 9, "total_length": 0 } ] } } ], "class": "hub", "sub_class": 0, "protocol": 2, "extra": { "max_packet_size": 64, "vendor": "Realtek Semiconductor Corp.", "product_name": "RTS5411 Hub", "string_indexes": [ 2, 1, 0 ], "configurations": [ { "name": "", "string_index": 0, "number": 1, "interfaces": [ { "name": "", "string_index": 0, "number": 0, "path": "20-3.1:1.0", "class": "hub", "sub_class": 0, "protocol": 1, "alt_setting": 0, "driver": null, "syspath": null, "endpoints": [ { "length": 7, "address": { "address": 129, "number": 1, "direction": "In" }, "transfer_type": "Interrupt", "sync_type": "None", "usage_type": "Data", "max_packet_size": 1, "interval": 12 } ], "length": 9 }, { "name": "", "string_index": 0, "number": 0, "path": "20-3.1:1.0", "class": "hub", "sub_class": 0, "protocol": 2, "alt_setting": 1, "driver": null, "syspath": null, "endpoints": [ { "length": 7, "address": { "address": 129, "number": 1, "direction": "In" }, "transfer_type": "Interrupt", "sync_type": "None", "usage_type": "Data", "max_packet_size": 1, "interval": 12 } ], "length": 9 } ], "attributes": [ "RemoteWakeup", "SelfPowered" ], "max_power": { "value": 0, "unit": "mA", "description": null }, "length": 9, "total_length": 0 } ] } } ], "class": "hub", "sub_class": 0, "protocol": 2, "extra": { "max_packet_size": 64, "vendor": "Realtek Semiconductor Corp.", "product_name": "RTS5411 Hub", "string_indexes": [ 2, 1, 0 ], "configurations": [ { "name": "", "string_index": 0, "number": 1, "interfaces": [ { "name": "", "string_index": 0, "number": 0, "path": "20-3:1.0", "class": "hub", "sub_class": 0, "protocol": 1, "alt_setting": 0, "driver": null, "syspath": null, "endpoints": [ { "length": 7, "address": { "address": 129, "number": 1, "direction": "In" }, "transfer_type": "Interrupt", "sync_type": "None", "usage_type": "Data", "max_packet_size": 1, "interval": 12 } ], "length": 9 }, { "name": "", "string_index": 0, "number": 0, "path": "20-3:1.0", "class": "hub", "sub_class": 0, "protocol": 2, "alt_setting": 1, "driver": null, "syspath": null, "endpoints": [ { "length": 7, "address": { "address": 129, "number": 1, "direction": "In" }, "transfer_type": "Interrupt", "sync_type": "None", "usage_type": "Data", "max_packet_size": 1, "interval": 12 } ], "length": 9 } ], "attributes": [ "RemoteWakeup", "SelfPowered" ], "max_power": { "value": 0, "unit": "mA", "description": null }, "length": 9, "total_length": 0 } ] } } ] } ] } cyme-2.2.6/tests/data/cyme_libusb_merge_macos_tree.json000066400000000000000000003015411506545537300233220ustar00rootroot00000000000000{ "buses": [ { "name": "USB31Bus", "host_controller": "AppleIntelCNLUSBXHCI", "pci_device": 41837, "pci_revision": 16, "pci_vendor": 32902, "devices": [ { "name": "AirPods Max", "vendor_id": 1452, "product_id": 4361, "location_id": { "bus": 20, "tree_positions": [ 1 ], "number": 4 }, "serial_num": "************", "manufacturer": "Apple Inc.", "bcd_device": "65.00", "bcd_usb": "2.01", "device_speed": "12.0 Mb/s", "class": "use-interface-descriptor", "sub_class": 0, "protocol": 0, "extra": { "max_packet_size": 64, "vendor": "Apple, Inc.", "string_indexes": [ 2, 1, 3 ], "configurations": [ { "name": "", "string_index": 0, "number": 1, "interfaces": [ { "name": "", "string_index": 0, "number": 0, "path": "20-1:1.0", "class": "h-i-d", "sub_class": 0, "protocol": 0, "alt_setting": 0, "driver": null, "syspath": null, "endpoints": [ { "length": 7, "address": { "address": 130, "number": 2, "direction": "In" }, "transfer_type": "Interrupt", "sync_type": "None", "usage_type": "Data", "max_packet_size": 64, "interval": 1 }, { "length": 7, "address": { "address": 2, "number": 2, "direction": "Out" }, "transfer_type": "Interrupt", "sync_type": "None", "usage_type": "Data", "max_packet_size": 16, "interval": 1 } ], "length": 9 } ], "attributes": [ "SelfPowered" ], "max_power": { "value": 500, "unit": "mA", "description": null }, "length": 9, "total_length": 0 } ] } }, { "name": "4-Port USB 2.0 Hub", "vendor_id": 3034, "product_id": 21521, "location_id": { "bus": 20, "tree_positions": [ 3 ], "number": 1 }, "serial_num": "", "manufacturer": "Generic", "bcd_device": "1.17", "bcd_usb": "2.10", "device_speed": "480.0 Mb/s", "devices": [ { "name": "Black Magic Probe v1.8.2", "vendor_id": 7504, "product_id": 24600, "location_id": { "bus": 20, "tree_positions": [ 3, 3 ], "number": 6 }, "serial_num": "********", "manufacturer": "Black Magic Debug", "bcd_device": "1.00", "bcd_usb": "2.00", "device_speed": "12.0 Mb/s", "class": "miscellaneous", "sub_class": 2, "protocol": 1, "extra": { "max_packet_size": 32, "vendor": "OpenMoko, Inc.", "product_name": "Black Magic Debug Probe (Application)", "string_indexes": [ 2, 1, 3 ], "configurations": [ { "name": "", "string_index": 0, "number": 1, "interfaces": [ { "name": "Black Magic GDB Server", "string_index": 4, "number": 0, "path": "20-3.3:1.0", "class": "c-d-c-communications", "sub_class": 2, "protocol": 0, "alt_setting": 0, "driver": null, "syspath": null, "endpoints": [ { "length": 7, "address": { "address": 130, "number": 2, "direction": "In" }, "transfer_type": "Interrupt", "sync_type": "None", "usage_type": "Data", "max_packet_size": 16, "interval": 255 } ], "length": 9 }, { "name": "", "string_index": 0, "number": 1, "path": "20-3.3:1.1", "class": "c-d-c-data", "sub_class": 0, "protocol": 0, "alt_setting": 0, "driver": null, "syspath": null, "endpoints": [ { "length": 7, "address": { "address": 1, "number": 1, "direction": "Out" }, "transfer_type": "Bulk", "sync_type": "None", "usage_type": "Data", "max_packet_size": 64, "interval": 1 }, { "length": 7, "address": { "address": 129, "number": 1, "direction": "In" }, "transfer_type": "Bulk", "sync_type": "None", "usage_type": "Data", "max_packet_size": 64, "interval": 1 } ], "length": 9 }, { "name": "Black Magic UART Port", "string_index": 5, "number": 2, "path": "20-3.3:1.2", "class": "c-d-c-communications", "sub_class": 2, "protocol": 0, "alt_setting": 0, "driver": null, "syspath": null, "endpoints": [ { "length": 7, "address": { "address": 132, "number": 4, "direction": "In" }, "transfer_type": "Interrupt", "sync_type": "None", "usage_type": "Data", "max_packet_size": 16, "interval": 255 } ], "length": 9 }, { "name": "", "string_index": 0, "number": 3, "path": "20-3.3:1.3", "class": "c-d-c-data", "sub_class": 0, "protocol": 0, "alt_setting": 0, "driver": null, "syspath": null, "endpoints": [ { "length": 7, "address": { "address": 3, "number": 3, "direction": "Out" }, "transfer_type": "Bulk", "sync_type": "None", "usage_type": "Data", "max_packet_size": 32, "interval": 1 }, { "length": 7, "address": { "address": 131, "number": 3, "direction": "In" }, "transfer_type": "Bulk", "sync_type": "None", "usage_type": "Data", "max_packet_size": 64, "interval": 1 } ], "length": 9 }, { "name": "Black Magic DFU", "string_index": 6, "number": 4, "path": "20-3.3:1.4", "class": "application-specific-interface", "sub_class": 1, "protocol": 1, "alt_setting": 0, "driver": null, "syspath": null, "endpoints": [], "length": 9 }, { "name": "Black Magic Trace Capture", "string_index": 7, "number": 5, "path": "20-3.3:1.5", "class": "vendor-specific-class", "sub_class": 255, "protocol": 255, "alt_setting": 0, "driver": null, "syspath": null, "endpoints": [ { "length": 7, "address": { "address": 133, "number": 5, "direction": "In" }, "transfer_type": "Bulk", "sync_type": "None", "usage_type": "Data", "max_packet_size": 64, "interval": 0 } ], "length": 9 } ], "attributes": [], "max_power": { "value": 100, "unit": "mA", "description": null }, "length": 9, "total_length": 0 } ] } }, { "name": "4-Port USB 2.0 Hub", "vendor_id": 3034, "product_id": 21521, "location_id": { "bus": 20, "tree_positions": [ 3, 1 ], "number": 2 }, "serial_num": "", "manufacturer": "Generic", "bcd_device": "1.17", "bcd_usb": "2.10", "device_speed": "480.0 Mb/s", "devices": [ { "name": "Android", "vendor_id": 1478, "product_id": 37009, "location_id": { "bus": 20, "tree_positions": [ 3, 1, 3 ], "number": 5 }, "serial_num": "*******************", "manufacturer": "Android", "bcd_device": "3.18", "bcd_usb": "2.00", "device_speed": "480.0 Mb/s", "class": "use-interface-descriptor", "sub_class": 0, "protocol": 0, "extra": { "max_packet_size": 64, "vendor": "Qualcomm, Inc.", "product_name": "Intex Aqua Fish & Jolla C Diagnostic Mode", "string_indexes": [ 2, 1, 3 ], "configurations": [ { "name": "", "string_index": 0, "number": 1, "interfaces": [ { "name": "", "string_index": 0, "number": 0, "path": "20-3.1.3:1.0", "class": "vendor-specific-class", "sub_class": 255, "protocol": 255, "alt_setting": 0, "driver": null, "syspath": null, "endpoints": [ { "length": 7, "address": { "address": 129, "number": 1, "direction": "In" }, "transfer_type": "Bulk", "sync_type": "None", "usage_type": "Data", "max_packet_size": 512, "interval": 0 }, { "length": 7, "address": { "address": 1, "number": 1, "direction": "Out" }, "transfer_type": "Bulk", "sync_type": "None", "usage_type": "Data", "max_packet_size": 512, "interval": 0 } ], "length": 9 }, { "name": "", "string_index": 0, "number": 1, "path": "20-3.1.3:1.1", "class": "vendor-specific-class", "sub_class": 0, "protocol": 0, "alt_setting": 0, "driver": null, "syspath": null, "endpoints": [ { "length": 7, "address": { "address": 131, "number": 3, "direction": "In" }, "transfer_type": "Interrupt", "sync_type": "None", "usage_type": "Data", "max_packet_size": 10, "interval": 9 }, { "length": 7, "address": { "address": 130, "number": 2, "direction": "In" }, "transfer_type": "Bulk", "sync_type": "None", "usage_type": "Data", "max_packet_size": 512, "interval": 0 }, { "length": 7, "address": { "address": 2, "number": 2, "direction": "Out" }, "transfer_type": "Bulk", "sync_type": "None", "usage_type": "Data", "max_packet_size": 512, "interval": 0 } ], "length": 9 }, { "name": "", "string_index": 0, "number": 2, "path": "20-3.1.3:1.2", "class": "vendor-specific-class", "sub_class": 255, "protocol": 255, "alt_setting": 0, "driver": null, "syspath": null, "endpoints": [ { "length": 7, "address": { "address": 133, "number": 5, "direction": "In" }, "transfer_type": "Interrupt", "sync_type": "None", "usage_type": "Data", "max_packet_size": 8, "interval": 9 }, { "length": 7, "address": { "address": 132, "number": 4, "direction": "In" }, "transfer_type": "Bulk", "sync_type": "None", "usage_type": "Data", "max_packet_size": 512, "interval": 0 }, { "length": 7, "address": { "address": 3, "number": 3, "direction": "Out" }, "transfer_type": "Bulk", "sync_type": "None", "usage_type": "Data", "max_packet_size": 512, "interval": 0 } ], "length": 9 }, { "name": "ADB Interface", "string_index": 8, "number": 3, "path": "20-3.1.3:1.3", "class": "vendor-specific-class", "sub_class": 66, "protocol": 1, "alt_setting": 0, "driver": null, "syspath": null, "endpoints": [ { "length": 7, "address": { "address": 4, "number": 4, "direction": "Out" }, "transfer_type": "Bulk", "sync_type": "None", "usage_type": "Data", "max_packet_size": 512, "interval": 0 }, { "length": 7, "address": { "address": 134, "number": 6, "direction": "In" }, "transfer_type": "Bulk", "sync_type": "None", "usage_type": "Data", "max_packet_size": 512, "interval": 0 } ], "length": 9 } ], "attributes": [], "max_power": { "value": 500, "unit": "mA", "description": null }, "length": 9, "total_length": 0 } ] } } ], "class": "hub", "sub_class": 0, "protocol": 2, "extra": { "max_packet_size": 64, "vendor": "Realtek Semiconductor Corp.", "product_name": "RTS5411 Hub", "string_indexes": [ 2, 1, 0 ], "configurations": [ { "name": "", "string_index": 0, "number": 1, "interfaces": [ { "name": "", "string_index": 0, "number": 0, "path": "20-3.1:1.0", "class": "hub", "sub_class": 0, "protocol": 1, "alt_setting": 0, "driver": null, "syspath": null, "endpoints": [ { "length": 7, "address": { "address": 129, "number": 1, "direction": "In" }, "transfer_type": "Interrupt", "sync_type": "None", "usage_type": "Data", "max_packet_size": 1, "interval": 12 } ], "length": 9 }, { "name": "", "string_index": 0, "number": 0, "path": "20-3.1:1.0", "class": "hub", "sub_class": 0, "protocol": 2, "alt_setting": 1, "driver": null, "syspath": null, "endpoints": [ { "length": 7, "address": { "address": 129, "number": 1, "direction": "In" }, "transfer_type": "Interrupt", "sync_type": "None", "usage_type": "Data", "max_packet_size": 1, "interval": 12 } ], "length": 9 } ], "attributes": [ "RemoteWakeup", "SelfPowered" ], "max_power": { "value": 0, "unit": "mA", "description": null }, "length": 9, "total_length": 0 } ] } } ], "class": "hub", "sub_class": 0, "protocol": 2, "extra": { "max_packet_size": 64, "vendor": "Realtek Semiconductor Corp.", "product_name": "RTS5411 Hub", "string_indexes": [ 2, 1, 0 ], "configurations": [ { "name": "", "string_index": 0, "number": 1, "interfaces": [ { "name": "", "string_index": 0, "number": 0, "path": "20-3:1.0", "class": "hub", "sub_class": 0, "protocol": 1, "alt_setting": 0, "driver": null, "syspath": null, "endpoints": [ { "length": 7, "address": { "address": 129, "number": 1, "direction": "In" }, "transfer_type": "Interrupt", "sync_type": "None", "usage_type": "Data", "max_packet_size": 1, "interval": 12 } ], "length": 9 }, { "name": "", "string_index": 0, "number": 0, "path": "20-3:1.0", "class": "hub", "sub_class": 0, "protocol": 2, "alt_setting": 1, "driver": null, "syspath": null, "endpoints": [ { "length": 7, "address": { "address": 129, "number": 1, "direction": "In" }, "transfer_type": "Interrupt", "sync_type": "None", "usage_type": "Data", "max_packet_size": 1, "interval": 12 } ], "length": 9 } ], "attributes": [ "RemoteWakeup", "SelfPowered" ], "max_power": { "value": 0, "unit": "mA", "description": null }, "length": 9, "total_length": 0 } ] } } ] }, { "name": "USB31Bus", "host_controller": "AppleUSBXHCITR", "pci_device": 5612, "pci_revision": 6, "pci_vendor": 32902, "usb_bus_number": 1 }, { "name": "USB31Bus", "host_controller": "AppleUSBXHCITR", "pci_device": 5612, "pci_revision": 6, "pci_vendor": 32902, "usb_bus_number": 0, "devices": [ { "name": "4-Port USB 3.0 Hub", "vendor_id": 3034, "product_id": 1041, "location_id": { "bus": 0, "tree_positions": [ 1 ], "number": 1 }, "serial_num": "", "manufacturer": "Generic", "bcd_device": "1.17", "bcd_usb": "3.00", "device_speed": "5.0 Gb/s", "devices": [ { "name": "4-Port USB 3.0 Hub", "vendor_id": 3034, "product_id": 1041, "location_id": { "bus": 0, "tree_positions": [ 1, 1 ], "number": 2 }, "serial_num": "", "manufacturer": "Generic", "bcd_device": "1.17", "bcd_usb": "3.00", "device_speed": "5.0 Gb/s", "class": "hub", "sub_class": 0, "protocol": 3, "extra": { "max_packet_size": 9, "vendor": "Realtek Semiconductor Corp.", "product_name": "Hub", "string_indexes": [ 2, 1, 0 ], "configurations": [ { "name": "USB3.0 Hub", "string_index": 4, "number": 1, "interfaces": [ { "name": "Interrupt In Interface", "string_index": 5, "number": 0, "path": "0-1.1:1.0", "class": "hub", "sub_class": 0, "protocol": 0, "alt_setting": 0, "driver": null, "syspath": null, "endpoints": [ { "length": 7, "address": { "address": 129, "number": 1, "direction": "In" }, "transfer_type": "Interrupt", "sync_type": "None", "usage_type": "Feedback", "max_packet_size": 2, "interval": 8 } ], "length": 9 } ], "attributes": [ "RemoteWakeup", "SelfPowered" ], "max_power": { "value": 0, "unit": "mA", "description": null }, "length": 9, "total_length": 0 } ] } } ], "class": "hub", "sub_class": 0, "protocol": 3, "extra": { "max_packet_size": 9, "vendor": "Realtek Semiconductor Corp.", "product_name": "Hub", "string_indexes": [ 2, 1, 0 ], "configurations": [ { "name": "USB3.0 Hub", "string_index": 4, "number": 1, "interfaces": [ { "name": "Interrupt In Interface", "string_index": 5, "number": 0, "path": "0-1:1.0", "class": "hub", "sub_class": 0, "protocol": 0, "alt_setting": 0, "driver": null, "syspath": null, "endpoints": [ { "length": 7, "address": { "address": 129, "number": 1, "direction": "In" }, "transfer_type": "Interrupt", "sync_type": "None", "usage_type": "Feedback", "max_packet_size": 2, "interval": 8 } ], "length": 9 } ], "attributes": [ "RemoteWakeup", "SelfPowered" ], "max_power": { "value": 0, "unit": "mA", "description": null }, "length": 9, "total_length": 0 } ] } } ] }, { "name": "USB31Bus", "host_controller": "AppleUSBXHCITR", "pci_device": 5616, "pci_revision": 6, "pci_vendor": 32902, "devices": [ { "name": "USB3.1 Hub", "vendor_id": 1086, "product_id": 39520, "location_id": { "bus": 2, "tree_positions": [ 3 ], "number": 2 }, "serial_num": "", "manufacturer": "LG Electronics Inc.", "bcd_device": "34.50", "bcd_usb": "3.10", "device_speed": "5.0 Gb/s", "devices": [ { "name": "Extreme SSD", "vendor_id": 1921, "product_id": 21900, "location_id": { "bus": 2, "tree_positions": [ 3, 2 ], "number": 8 }, "serial_num": "************************", "manufacturer": "SanDisk", "bcd_device": "a.12", "bcd_usb": "3.10", "device_speed": "5.0 Gb/s", "class": "use-interface-descriptor", "sub_class": 0, "protocol": 0, "extra": { "max_packet_size": 9, "vendor": "SanDisk Corp.", "product_name": "Extreme Portable SSD", "string_indexes": [ 3, 2, 1 ], "configurations": [ { "name": "", "string_index": 0, "number": 1, "interfaces": [ { "name": "", "string_index": 0, "number": 0, "path": "2-3.2:1.0", "class": "mass-storage", "sub_class": 6, "protocol": 80, "alt_setting": 0, "driver": null, "syspath": null, "endpoints": [ { "length": 7, "address": { "address": 129, "number": 1, "direction": "In" }, "transfer_type": "Bulk", "sync_type": "None", "usage_type": "Data", "max_packet_size": 1024, "interval": 0 }, { "length": 7, "address": { "address": 2, "number": 2, "direction": "Out" }, "transfer_type": "Bulk", "sync_type": "None", "usage_type": "Data", "max_packet_size": 1024, "interval": 0 } ], "length": 9 }, { "name": "", "string_index": 0, "number": 0, "path": "2-3.2:1.0", "class": "mass-storage", "sub_class": 6, "protocol": 98, "alt_setting": 1, "driver": null, "syspath": null, "endpoints": [ { "length": 7, "address": { "address": 129, "number": 1, "direction": "In" }, "transfer_type": "Bulk", "sync_type": "None", "usage_type": "Data", "max_packet_size": 1024, "interval": 0 }, { "length": 7, "address": { "address": 2, "number": 2, "direction": "Out" }, "transfer_type": "Bulk", "sync_type": "None", "usage_type": "Data", "max_packet_size": 1024, "interval": 0 }, { "length": 7, "address": { "address": 131, "number": 3, "direction": "In" }, "transfer_type": "Bulk", "sync_type": "None", "usage_type": "Data", "max_packet_size": 1024, "interval": 0 }, { "length": 7, "address": { "address": 4, "number": 4, "direction": "Out" }, "transfer_type": "Bulk", "sync_type": "None", "usage_type": "Data", "max_packet_size": 1024, "interval": 0 } ], "length": 9 } ], "attributes": [], "max_power": { "value": 224, "unit": "mA", "description": null }, "length": 9, "total_length": 0 } ] } }, { "name": "Belkin USB-C LAN", "vendor_id": 3034, "product_id": 33107, "location_id": { "bus": 2, "tree_positions": [ 3, 1 ], "number": 7 }, "serial_num": "************", "manufacturer": "Belkin", "bcd_device": "1e.00", "bcd_usb": "3.00", "device_speed": "5.0 Gb/s", "class": "use-interface-descriptor", "sub_class": 0, "protocol": 0, "extra": { "max_packet_size": 9, "vendor": "Realtek Semiconductor Corp.", "product_name": "RTL8153 Gigabit Ethernet Adapter", "string_indexes": [ 2, 1, 6 ], "configurations": [ { "name": "", "string_index": 0, "number": 1, "interfaces": [ { "name": "", "string_index": 0, "number": 0, "path": "2-3.1:1.0", "class": "vendor-specific-class", "sub_class": 255, "protocol": 0, "alt_setting": 0, "driver": null, "syspath": null, "endpoints": [ { "length": 7, "address": { "address": 129, "number": 1, "direction": "In" }, "transfer_type": "Bulk", "sync_type": "None", "usage_type": "Data", "max_packet_size": 1024, "interval": 0 }, { "length": 7, "address": { "address": 2, "number": 2, "direction": "Out" }, "transfer_type": "Bulk", "sync_type": "None", "usage_type": "Data", "max_packet_size": 1024, "interval": 0 }, { "length": 7, "address": { "address": 131, "number": 3, "direction": "In" }, "transfer_type": "Interrupt", "sync_type": "None", "usage_type": "Data", "max_packet_size": 2, "interval": 8 } ], "length": 9 } ], "attributes": [ "RemoteWakeup" ], "max_power": { "value": 64, "unit": "mA", "description": null }, "length": 9, "total_length": 0 }, { "name": "", "string_index": 0, "number": 2, "interfaces": [ { "name": "CDC Communications Control", "string_index": 5, "number": 0, "path": "2-3.1:2.0", "class": "c-d-c-communications", "sub_class": 6, "protocol": 0, "alt_setting": 0, "driver": null, "syspath": null, "endpoints": [ { "length": 7, "address": { "address": 131, "number": 3, "direction": "In" }, "transfer_type": "Interrupt", "sync_type": "None", "usage_type": "Data", "max_packet_size": 16, "interval": 8 } ], "length": 9 }, { "name": "", "string_index": 0, "number": 1, "path": "2-3.1:2.1", "class": "c-d-c-data", "sub_class": 0, "protocol": 0, "alt_setting": 0, "driver": null, "syspath": null, "endpoints": [], "length": 9 }, { "name": "Ethernet Data", "string_index": 4, "number": 1, "path": "2-3.1:2.1", "class": "c-d-c-data", "sub_class": 0, "protocol": 0, "alt_setting": 1, "driver": null, "syspath": null, "endpoints": [ { "length": 7, "address": { "address": 129, "number": 1, "direction": "In" }, "transfer_type": "Bulk", "sync_type": "None", "usage_type": "Data", "max_packet_size": 1024, "interval": 0 }, { "length": 7, "address": { "address": 2, "number": 2, "direction": "Out" }, "transfer_type": "Bulk", "sync_type": "None", "usage_type": "Data", "max_packet_size": 1024, "interval": 0 } ], "length": 9 } ], "attributes": [ "RemoteWakeup" ], "max_power": { "value": 64, "unit": "mA", "description": null }, "length": 9, "total_length": 0 } ] } }, { "name": "", "vendor_id": 1086, "product_id": 39537, "location_id": { "bus": 2, "tree_positions": [ 3, 4 ], "number": 6 }, "serial_num": "", "manufacturer": "LG Electronics USA, Inc.", "bcd_device": "1.00", "bcd_usb": "3.00", "device_speed": "5.0 Gb/s", "devices": [ { "name": "LG UltraFine Display Camera", "vendor_id": 1086, "product_id": 39528, "location_id": { "bus": 2, "tree_positions": [ 3, 4, 3 ], "number": 9 }, "serial_num": "", "manufacturer": "LG Electronlcs Inc.", "bcd_device": "2.23", "bcd_usb": "3.00", "device_speed": "5.0 Gb/s", "class": "miscellaneous", "sub_class": 2, "protocol": 1, "extra": { "max_packet_size": 9, "vendor": "LG Electronics USA, Inc.", "string_indexes": [ 2, 1, 0 ], "configurations": [ { "name": "USB-3.0", "string_index": 3, "number": 1, "interfaces": [ { "name": "", "string_index": 0, "number": 0, "path": "2-3.4.3:1.0", "class": "video", "sub_class": 1, "protocol": 0, "alt_setting": 0, "driver": null, "syspath": null, "endpoints": [ { "length": 7, "address": { "address": 130, "number": 2, "direction": "In" }, "transfer_type": "Interrupt", "sync_type": "None", "usage_type": "Data", "max_packet_size": 64, "interval": 1 } ], "length": 9 }, { "name": "", "string_index": 0, "number": 1, "path": "2-3.4.3:1.1", "class": "video", "sub_class": 2, "protocol": 0, "alt_setting": 0, "driver": null, "syspath": null, "endpoints": [], "length": 9 }, { "name": "", "string_index": 0, "number": 1, "path": "2-3.4.3:1.1", "class": "video", "sub_class": 2, "protocol": 0, "alt_setting": 1, "driver": null, "syspath": null, "endpoints": [ { "length": 7, "address": { "address": 131, "number": 3, "direction": "In" }, "transfer_type": "Isochronous", "sync_type": "None", "usage_type": "Data", "max_packet_size": 1024, "interval": 1 } ], "length": 9 }, { "name": "", "string_index": 0, "number": 2, "path": "2-3.4.3:1.2", "class": "h-i-d", "sub_class": 0, "protocol": 0, "alt_setting": 0, "driver": null, "syspath": null, "endpoints": [ { "length": 7, "address": { "address": 5, "number": 5, "direction": "Out" }, "transfer_type": "Interrupt", "sync_type": "None", "usage_type": "Data", "max_packet_size": 1024, "interval": 1 }, { "length": 7, "address": { "address": 133, "number": 5, "direction": "In" }, "transfer_type": "Interrupt", "sync_type": "None", "usage_type": "Data", "max_packet_size": 1024, "interval": 1 } ], "length": 9 } ], "attributes": [ "RemoteWakeup" ], "max_power": { "value": 24, "unit": "mA", "description": null }, "length": 9, "total_length": 0 } ] } } ], "class": "hub", "sub_class": 0, "protocol": 3, "extra": { "max_packet_size": 9, "vendor": "LG Electronics USA, Inc.", "string_indexes": [ 0, 0, 0 ], "configurations": [ { "name": "", "string_index": 0, "number": 1, "interfaces": [ { "name": "", "string_index": 0, "number": 0, "path": "2-3.4:1.0", "class": "hub", "sub_class": 0, "protocol": 0, "alt_setting": 0, "driver": null, "syspath": null, "endpoints": [ { "length": 7, "address": { "address": 129, "number": 1, "direction": "In" }, "transfer_type": "Interrupt", "sync_type": "None", "usage_type": "Feedback", "max_packet_size": 2, "interval": 8 } ], "length": 9 } ], "attributes": [ "RemoteWakeup", "SelfPowered" ], "max_power": { "value": 0, "unit": "mA", "description": null }, "length": 9, "total_length": 0 } ] } }, { "name": "USB3.0 Hub", "vendor_id": 8457, "product_id": 2071, "location_id": { "bus": 2, "tree_positions": [ 3, 3 ], "number": 4 }, "serial_num": "", "manufacturer": "VIA Labs, Inc.", "bcd_device": "4.53", "bcd_usb": "3.10", "device_speed": "5.0 Gb/s", "class": "hub", "sub_class": 0, "protocol": 3, "extra": { "max_packet_size": 9, "vendor": "VIA Labs, Inc.", "string_indexes": [ 2, 1, 0 ], "configurations": [ { "name": "", "string_index": 0, "number": 1, "interfaces": [ { "name": "", "string_index": 0, "number": 0, "path": "2-3.3:1.0", "class": "hub", "sub_class": 0, "protocol": 0, "alt_setting": 0, "driver": null, "syspath": null, "endpoints": [ { "length": 7, "address": { "address": 129, "number": 1, "direction": "In" }, "transfer_type": "Interrupt", "sync_type": "None", "usage_type": "Feedback", "max_packet_size": 2, "interval": 8 } ], "length": 9 } ], "attributes": [ "RemoteWakeup", "SelfPowered" ], "max_power": { "value": 0, "unit": "mA", "description": null }, "length": 9, "total_length": 0 } ] } } ], "class": "hub", "sub_class": 0, "protocol": 3, "extra": { "max_packet_size": 9, "vendor": "LG Electronics USA, Inc.", "string_indexes": [ 2, 1, 0 ], "configurations": [ { "name": "", "string_index": 0, "number": 1, "interfaces": [ { "name": "", "string_index": 0, "number": 0, "path": "2-3:1.0", "class": "hub", "sub_class": 0, "protocol": 0, "alt_setting": 0, "driver": null, "syspath": null, "endpoints": [ { "length": 7, "address": { "address": 131, "number": 3, "direction": "In" }, "transfer_type": "Interrupt", "sync_type": "None", "usage_type": "Feedback", "max_packet_size": 2, "interval": 8 } ], "length": 9 } ], "attributes": [ "RemoteWakeup", "SelfPowered" ], "max_power": { "value": 0, "unit": "mA", "description": null }, "length": 9, "total_length": 0 } ] } }, { "name": "USB2.1 Hub", "vendor_id": 1086, "product_id": 39521, "location_id": { "bus": 2, "tree_positions": [ 2 ], "number": 1 }, "serial_num": "", "manufacturer": "LG Electronics Inc.", "bcd_device": "34.50", "bcd_usb": "2.10", "device_speed": "480.0 Mb/s", "devices": [ { "name": "USB2.0 Hub", "vendor_id": 8457, "product_id": 10263, "location_id": { "bus": 2, "tree_positions": [ 2, 3 ], "number": 5 }, "serial_num": "", "manufacturer": "VIA Labs, Inc.", "bcd_device": "4.53", "bcd_usb": "2.10", "device_speed": "480.0 Mb/s", "devices": [ { "name": "Specialized TCU2", "vendor_id": 6421, "product_id": 21004, "location_id": { "bus": 2, "tree_positions": [ 2, 3, 1 ], "number": 23 }, "serial_num": "************", "manufacturer": "Specialized", "bcd_device": "1.00", "bcd_usb": "2.00", "device_speed": "12.0 Mb/s", "class": "use-interface-descriptor", "sub_class": 0, "protocol": 0, "extra": { "max_packet_size": 64, "vendor": "Nordic Semiconductor ASA", "string_indexes": [ 2, 1, 3 ], "configurations": [ { "name": "Default configuration", "string_index": 4, "number": 1, "interfaces": [ { "name": "", "string_index": 0, "number": 0, "path": "2-2.3.1:1.0", "class": "h-i-d", "sub_class": 0, "protocol": 0, "alt_setting": 0, "driver": null, "syspath": null, "endpoints": [ { "length": 7, "address": { "address": 129, "number": 1, "direction": "In" }, "transfer_type": "Interrupt", "sync_type": "None", "usage_type": "Data", "max_packet_size": 64, "interval": 10 }, { "length": 7, "address": { "address": 1, "number": 1, "direction": "Out" }, "transfer_type": "Interrupt", "sync_type": "None", "usage_type": "Data", "max_packet_size": 64, "interval": 10 } ], "length": 9 } ], "attributes": [ "RemoteWakeup", "SelfPowered" ], "max_power": { "value": 500, "unit": "mA", "description": null }, "length": 9, "total_length": 0 } ] } }, { "name": "J-Link", "vendor_id": 4966, "product_id": 257, "location_id": { "bus": 2, "tree_positions": [ 2, 3, 3 ], "number": 20 }, "serial_num": "************", "manufacturer": "SEGGER", "bcd_device": "1.00", "bcd_usb": "2.00", "device_speed": "480.0 Mb/s", "class": "use-interface-descriptor", "sub_class": 0, "protocol": 0, "extra": { "max_packet_size": 64, "vendor": "SEGGER", "product_name": "J-Link PLUS", "string_indexes": [ 2, 1, 3 ], "configurations": [ { "name": "Configuration", "string_index": 4, "number": 1, "interfaces": [ { "name": "BULK interface", "string_index": 5, "number": 0, "path": "2-2.3.3:1.0", "class": "vendor-specific-class", "sub_class": 255, "protocol": 255, "alt_setting": 0, "driver": null, "syspath": null, "endpoints": [ { "length": 7, "address": { "address": 129, "number": 1, "direction": "In" }, "transfer_type": "Bulk", "sync_type": "None", "usage_type": "Data", "max_packet_size": 512, "interval": 1 }, { "length": 7, "address": { "address": 1, "number": 1, "direction": "Out" }, "transfer_type": "Bulk", "sync_type": "None", "usage_type": "Data", "max_packet_size": 512, "interval": 1 } ], "length": 9 } ], "attributes": [], "max_power": { "value": 100, "unit": "mA", "description": null }, "length": 9, "total_length": 0 } ] } }, { "name": "USB Billboard Device", "vendor_id": 8457, "product_id": 34839, "location_id": { "bus": 2, "tree_positions": [ 2, 3, 5 ], "number": 12 }, "serial_num": "****************", "manufacturer": "VIA Labs, Inc.", "bcd_device": "0.01", "bcd_usb": "2.01", "device_speed": "480.0 Mb/s", "class": "application-specific-interface", "sub_class": 0, "protocol": 0, "extra": { "max_packet_size": 64, "vendor": "VIA Labs, Inc.", "string_indexes": [ 2, 1, 3 ], "configurations": [ { "name": "0000000000000001", "string_index": 3, "number": 1, "interfaces": [ { "name": "0000000000000001", "string_index": 3, "number": 0, "path": "2-2.3.5:1.0", "class": "billboard", "sub_class": 0, "protocol": 0, "alt_setting": 0, "driver": null, "syspath": null, "endpoints": [], "length": 9 } ], "attributes": [ "RemoteWakeup" ], "max_power": { "value": 100, "unit": "mA", "description": null }, "length": 9, "total_length": 0 } ] } } ], "class": "hub", "sub_class": 0, "protocol": 2, "extra": { "max_packet_size": 64, "vendor": "VIA Labs, Inc.", "string_indexes": [ 2, 1, 0 ], "configurations": [ { "name": "", "string_index": 0, "number": 1, "interfaces": [ { "name": "", "string_index": 0, "number": 0, "path": "2-2.3:1.0", "class": "hub", "sub_class": 0, "protocol": 1, "alt_setting": 0, "driver": null, "syspath": null, "endpoints": [ { "length": 7, "address": { "address": 129, "number": 1, "direction": "In" }, "transfer_type": "Interrupt", "sync_type": "None", "usage_type": "Data", "max_packet_size": 1, "interval": 12 } ], "length": 9 }, { "name": "", "string_index": 0, "number": 0, "path": "2-2.3:1.0", "class": "hub", "sub_class": 0, "protocol": 2, "alt_setting": 1, "driver": null, "syspath": null, "endpoints": [ { "length": 7, "address": { "address": 129, "number": 1, "direction": "In" }, "transfer_type": "Interrupt", "sync_type": "None", "usage_type": "Data", "max_packet_size": 1, "interval": 12 } ], "length": 9 } ], "attributes": [ "RemoteWakeup", "SelfPowered" ], "max_power": { "value": 0, "unit": "mA", "description": null }, "length": 9, "total_length": 0 } ] } }, { "name": "", "vendor_id": 1086, "product_id": 39539, "location_id": { "bus": 2, "tree_positions": [ 2, 4 ], "number": 3 }, "serial_num": "************", "manufacturer": "LG Electronics USA, Inc.", "bcd_device": "1.00", "bcd_usb": "2.10", "device_speed": "480.0 Mb/s", "devices": [ { "name": "LG UltraFine Display Controls", "vendor_id": 1086, "product_id": 39536, "location_id": { "bus": 2, "tree_positions": [ 2, 4, 2 ], "number": 11 }, "serial_num": "", "manufacturer": "LG Electronics Inc.", "bcd_device": "4.13", "bcd_usb": "2.00", "device_speed": "12.0 Mb/s", "class": "use-interface-descriptor", "sub_class": 0, "protocol": 0, "extra": { "max_packet_size": 64, "vendor": "LG Electronics USA, Inc.", "string_indexes": [ 2, 1, 0 ], "configurations": [ { "name": "", "string_index": 0, "number": 1, "interfaces": [ { "name": "HID I2C", "string_index": 5, "number": 0, "path": "2-2.4.2:1.0", "class": "h-i-d", "sub_class": 0, "protocol": 0, "alt_setting": 0, "driver": null, "syspath": null, "endpoints": [ { "length": 7, "address": { "address": 129, "number": 1, "direction": "In" }, "transfer_type": "Interrupt", "sync_type": "None", "usage_type": "Data", "max_packet_size": 64, "interval": 1 }, { "length": 7, "address": { "address": 1, "number": 1, "direction": "Out" }, "transfer_type": "Interrupt", "sync_type": "None", "usage_type": "Data", "max_packet_size": 64, "interval": 1 } ], "length": 9 }, { "name": "HID BRIGHTNESS", "string_index": 6, "number": 1, "path": "2-2.4.2:1.1", "class": "h-i-d", "sub_class": 0, "protocol": 0, "alt_setting": 0, "driver": null, "syspath": null, "endpoints": [ { "length": 7, "address": { "address": 130, "number": 2, "direction": "In" }, "transfer_type": "Interrupt", "sync_type": "None", "usage_type": "Data", "max_packet_size": 6, "interval": 9 }, { "length": 7, "address": { "address": 2, "number": 2, "direction": "Out" }, "transfer_type": "Interrupt", "sync_type": "None", "usage_type": "Data", "max_packet_size": 6, "interval": 9 } ], "length": 9 }, { "name": "HID ALS", "string_index": 7, "number": 2, "path": "2-2.4.2:1.2", "class": "h-i-d", "sub_class": 0, "protocol": 0, "alt_setting": 0, "driver": null, "syspath": null, "endpoints": [ { "length": 7, "address": { "address": 131, "number": 3, "direction": "In" }, "transfer_type": "Interrupt", "sync_type": "None", "usage_type": "Data", "max_packet_size": 6, "interval": 100 }, { "length": 7, "address": { "address": 3, "number": 3, "direction": "Out" }, "transfer_type": "Interrupt", "sync_type": "None", "usage_type": "Data", "max_packet_size": 6, "interval": 100 } ], "length": 9 } ], "attributes": [ "SelfPowered" ], "max_power": { "value": 0, "unit": "mA", "description": null }, "length": 9, "total_length": 0 } ] } }, { "name": "LG UltraFine Display Audio", "vendor_id": 1086, "product_id": 39526, "location_id": { "bus": 2, "tree_positions": [ 2, 4, 1 ], "number": 10 }, "serial_num": "", "manufacturer": "LG Electronics Inc.", "bcd_device": "0.03", "bcd_usb": "2.00", "device_speed": "480.0 Mb/s", "class": "use-interface-descriptor", "sub_class": 0, "protocol": 0, "extra": { "max_packet_size": 64, "vendor": "LG Electronics USA, Inc.", "string_indexes": [ 1, 3, 0 ], "configurations": [ { "name": "LG UltraFine Display Audio", "string_index": 4, "number": 1, "interfaces": [ { "name": "LG UltraFine Display Audio", "string_index": 6, "number": 0, "path": "2-2.4.1:1.0", "class": "audio", "sub_class": 1, "protocol": 0, "alt_setting": 0, "driver": null, "syspath": null, "endpoints": [], "length": 9 }, { "name": "", "string_index": 0, "number": 1, "path": "2-2.4.1:1.1", "class": "audio", "sub_class": 2, "protocol": 0, "alt_setting": 0, "driver": null, "syspath": null, "endpoints": [], "length": 9 }, { "name": "", "string_index": 0, "number": 1, "path": "2-2.4.1:1.1", "class": "audio", "sub_class": 2, "protocol": 0, "alt_setting": 1, "driver": null, "syspath": null, "endpoints": [ { "length": 7, "address": { "address": 132, "number": 4, "direction": "In" }, "transfer_type": "Isochronous", "sync_type": "Asynchronous", "usage_type": "Data", "max_packet_size": 147, "interval": 4 } ], "length": 9 }, { "name": "", "string_index": 0, "number": 2, "path": "2-2.4.1:1.2", "class": "audio", "sub_class": 2, "protocol": 0, "alt_setting": 0, "driver": null, "syspath": null, "endpoints": [], "length": 9 }, { "name": "", "string_index": 0, "number": 2, "path": "2-2.4.1:1.2", "class": "audio", "sub_class": 2, "protocol": 0, "alt_setting": 1, "driver": null, "syspath": null, "endpoints": [ { "length": 7, "address": { "address": 7, "number": 7, "direction": "Out" }, "transfer_type": "Isochronous", "sync_type": "Adaptive", "usage_type": "Data", "max_packet_size": 294, "interval": 4 } ], "length": 9 } ], "attributes": [ "SelfPowered" ], "max_power": { "value": 0, "unit": "mA", "description": null }, "length": 9, "total_length": 0 } ] } } ], "class": "hub", "sub_class": 0, "protocol": 2, "extra": { "max_packet_size": 64, "vendor": "LG Electronics USA, Inc.", "string_indexes": [ 0, 0, 1 ], "configurations": [ { "name": "", "string_index": 0, "number": 1, "interfaces": [ { "name": "", "string_index": 0, "number": 0, "path": "2-2.4:1.0", "class": "hub", "sub_class": 0, "protocol": 1, "alt_setting": 0, "driver": null, "syspath": null, "endpoints": [ { "length": 7, "address": { "address": 129, "number": 1, "direction": "In" }, "transfer_type": "Interrupt", "sync_type": "None", "usage_type": "Data", "max_packet_size": 1, "interval": 12 } ], "length": 9 }, { "name": "", "string_index": 0, "number": 0, "path": "2-2.4:1.0", "class": "hub", "sub_class": 0, "protocol": 2, "alt_setting": 1, "driver": null, "syspath": null, "endpoints": [ { "length": 7, "address": { "address": 129, "number": 1, "direction": "In" }, "transfer_type": "Interrupt", "sync_type": "None", "usage_type": "Data", "max_packet_size": 1, "interval": 12 } ], "length": 9 } ], "attributes": [ "RemoteWakeup", "SelfPowered" ], "max_power": { "value": 0, "unit": "mA", "description": null }, "length": 9, "total_length": 0 } ] } } ], "class": "hub", "sub_class": 0, "protocol": 2, "extra": { "max_packet_size": 64, "vendor": "LG Electronics USA, Inc.", "string_indexes": [ 2, 1, 0 ], "configurations": [ { "name": "", "string_index": 0, "number": 1, "interfaces": [ { "name": "", "string_index": 0, "number": 0, "path": "2-2:1.0", "class": "hub", "sub_class": 0, "protocol": 1, "alt_setting": 0, "driver": null, "syspath": null, "endpoints": [ { "length": 7, "address": { "address": 129, "number": 1, "direction": "In" }, "transfer_type": "Interrupt", "sync_type": "None", "usage_type": "Data", "max_packet_size": 1, "interval": 12 } ], "length": 9 }, { "name": "", "string_index": 0, "number": 0, "path": "2-2:1.0", "class": "hub", "sub_class": 0, "protocol": 2, "alt_setting": 1, "driver": null, "syspath": null, "endpoints": [ { "length": 7, "address": { "address": 129, "number": 1, "direction": "In" }, "transfer_type": "Interrupt", "sync_type": "None", "usage_type": "Data", "max_packet_size": 1, "interval": 12 } ], "length": 9 } ], "attributes": [ "RemoteWakeup", "SelfPowered" ], "max_power": { "value": 100, "unit": "mA", "description": null }, "length": 9, "total_length": 0 } ] } } ] }, { "name": "T2Bus", "host_controller": "AppleUSBVHCIBCE", "devices": [ { "name": "Touch Bar Backlight", "vendor_id": 1452, "product_id": 33026, "location_id": { "bus": 128, "tree_positions": [ 7 ], "number": 7 }, "serial_num": "****************", "manufacturer": "Apple Inc.", "bcd_device": "2.01" }, { "name": "Touch Bar Display", "vendor_id": 1452, "product_id": 33538, "location_id": { "bus": 128, "tree_positions": [ 6 ], "number": 6 }, "serial_num": "****************", "manufacturer": "Apple Inc.", "bcd_device": "2.01" }, { "name": "Apple Internal Keyboard / Trackpad", "vendor_id": 1452, "product_id": 636, "location_id": { "bus": 128, "tree_positions": [ 5 ], "number": 5 }, "serial_num": "*********************", "manufacturer": "Apple Inc.", "bcd_device": "9.27" }, { "name": "Headset", "vendor_id": 1452, "product_id": 33027, "location_id": { "bus": 128, "tree_positions": [ 4 ], "number": 4 }, "serial_num": "************", "manufacturer": "Apple", "bcd_device": "2.03" }, { "name": "Ambient Light Sensor", "vendor_id": 1452, "product_id": 33378, "location_id": { "bus": 128, "tree_positions": [ 3 ], "number": 3 }, "serial_num": "************", "manufacturer": "Apple Inc.", "bcd_device": "2.01" }, { "name": "FaceTime HD Camera (Built-in)", "vendor_id": 1452, "product_id": 34068, "location_id": { "bus": 128, "tree_positions": [ 2 ], "number": 2 }, "serial_num": "*****************", "manufacturer": "Apple Inc.", "bcd_device": "2.01" }, { "name": "Apple T2 Controller", "vendor_id": 1452, "product_id": 33331, "location_id": { "bus": 128, "tree_positions": [ 1 ], "number": 1 }, "serial_num": "****************", "manufacturer": "Apple Inc.", "bcd_device": "2.01" } ] } ] } cyme-2.2.6/tests/data/cyme_sp_macos_tree.json000066400000000000000000000364611506545537300213130ustar00rootroot00000000000000{ "buses": [ { "name": "USB31Bus", "host_controller": "AppleIntelCNLUSBXHCI", "pci_device": 41837, "pci_revision": 16, "pci_vendor": 32902, "devices": [ { "name": "4-Port USB 2.0 Hub", "vendor_id": 3034, "product_id": 21521, "location_id": { "bus": 20, "tree_positions": [ 3 ], "number": 1 }, "manufacturer": "Generic", "bcd_device": "1.17", "bus_power": 500, "bus_power_used": 0, "device_speed": "480.0 Mb/s", "extra_current_used": 0, "devices": [ { "name": "4-Port USB 2.0 Hub", "vendor_id": 3034, "product_id": 21521, "location_id": { "bus": 20, "tree_positions": [ 3, 1 ], "number": 2 }, "manufacturer": "Generic", "bcd_device": "1.17", "bus_power": 500, "bus_power_used": 0, "device_speed": "480.0 Mb/s", "extra_current_used": 0, "devices": [ { "name": "Android", "vendor_id": 1478, "product_id": 37009, "location_id": { "bus": 20, "tree_positions": [ 3, 1, 3 ], "number": 5 }, "serial_num": "*******************", "manufacturer": "Android", "bcd_device": "3.18", "bus_power": 500, "bus_power_used": 500, "device_speed": "480.0 Mb/s", "extra_current_used": 0 } ] } ] }, { "name": "AirPods Max", "vendor_id": 1452, "product_id": 4361, "location_id": { "bus": 20, "tree_positions": [ 1 ], "number": 4 }, "serial_num": "************", "manufacturer": "Apple Inc.", "bcd_device": "9b.00", "bus_power": 500, "bus_power_used": 500, "device_speed": "12.0 Mb/s", "extra_current_used": 1600 } ] }, { "name": "USB31Bus", "host_controller": "AppleUSBXHCITR", "pci_device": 5612, "pci_revision": 6, "pci_vendor": 32902, "usb_bus_number": 1 }, { "name": "USB31Bus", "host_controller": "AppleUSBXHCITR", "pci_device": 5612, "pci_revision": 6, "pci_vendor": 32902, "usb_bus_number": 0, "devices": [ { "name": "4-Port USB 3.0 Hub", "vendor_id": 3034, "product_id": 1041, "location_id": { "bus": 0, "tree_positions": [ 1 ], "number": 1 }, "manufacturer": "Generic", "bcd_device": "1.17", "bus_power": 900, "bus_power_used": 0, "device_speed": "5.0 Gb/s", "extra_current_used": 0, "devices": [ { "name": "4-Port USB 3.0 Hub", "vendor_id": 3034, "product_id": 1041, "location_id": { "bus": 0, "tree_positions": [ 1, 1 ], "number": 2 }, "manufacturer": "Generic", "bcd_device": "1.17", "bus_power": 900, "bus_power_used": 0, "device_speed": "5.0 Gb/s", "extra_current_used": 0 } ] } ] }, { "name": "USB31Bus", "host_controller": "AppleUSBXHCITR", "pci_device": 5616, "pci_revision": 6, "pci_vendor": 32902, "devices": [ { "name": "USB3.1 Hub", "vendor_id": 1086, "product_id": 39520, "location_id": { "bus": 2, "tree_positions": [ 3 ], "number": 2 }, "manufacturer": "LG Electronics Inc.", "bcd_device": "52.50", "bus_power": 900, "bus_power_used": 0, "device_speed": "5.0 Gb/s", "extra_current_used": 0, "devices": [ { "name": "USB3.0 Hub ", "vendor_id": 8457, "product_id": 2071, "location_id": { "bus": 2, "tree_positions": [ 3, 3 ], "number": 4 }, "manufacturer": "VIA Labs, Inc. ", "bcd_device": "4.53", "bus_power": 900, "bus_power_used": 0, "device_speed": "5.0 Gb/s", "extra_current_used": 0 }, { "name": "Extreme SSD", "vendor_id": 1921, "product_id": 21900, "location_id": { "bus": 2, "tree_positions": [ 3, 2 ], "number": 8 }, "serial_num": "************************", "manufacturer": "SanDisk", "bcd_device": "10.12", "bus_power": 900, "bus_power_used": 896, "device_speed": "5.0 Gb/s", "extra_current_used": 0 }, { "name": "Belkin USB-C LAN", "vendor_id": 3034, "product_id": 33107, "location_id": { "bus": 2, "tree_positions": [ 3, 1 ], "number": 7 }, "serial_num": "************", "manufacturer": "Belkin", "bcd_device": "30.00", "bus_power": 900, "bus_power_used": 256, "device_speed": "5.0 Gb/s", "extra_current_used": 0 }, { "name": "hub_device", "vendor_id": 1086, "product_id": 39537, "location_id": { "bus": 2, "tree_positions": [ 3, 4 ], "number": 6 }, "bcd_device": "1.00", "bus_power": 900, "bus_power_used": 0, "device_speed": "5.0 Gb/s", "extra_current_used": 0, "devices": [ { "name": "LG UltraFine Display Camera", "vendor_id": 1086, "product_id": 39528, "location_id": { "bus": 2, "tree_positions": [ 3, 4, 3 ], "number": 9 }, "manufacturer": "LG Electronlcs Inc.", "bcd_device": "2.23", "bus_power": 900, "bus_power_used": 96, "device_speed": "5.0 Gb/s", "extra_current_used": 0 } ] } ] }, { "name": "USB2.1 Hub", "vendor_id": 1086, "product_id": 39521, "location_id": { "bus": 2, "tree_positions": [ 2 ], "number": 1 }, "manufacturer": "LG Electronics Inc.", "bcd_device": "52.50", "bus_power": 500, "bus_power_used": 100, "device_speed": "480.0 Mb/s", "extra_current_used": 0, "devices": [ { "name": "USB2.0 Hub ", "vendor_id": 8457, "product_id": 10263, "location_id": { "bus": 2, "tree_positions": [ 2, 3 ], "number": 5 }, "manufacturer": "VIA Labs, Inc. ", "bcd_device": "4.53", "bus_power": 500, "bus_power_used": 0, "device_speed": "480.0 Mb/s", "extra_current_used": 0, "devices": [ { "name": "J-Link", "vendor_id": 4966, "product_id": 257, "location_id": { "bus": 2, "tree_positions": [ 2, 3, 3 ], "number": 8 }, "serial_num": "************", "manufacturer": "SEGGER", "bcd_device": "1.00" }, { "name": "Specialized TCU2", "vendor_id": 6421, "product_id": 21004, "location_id": { "bus": 2, "tree_positions": [ 2, 3, 1 ], "number": 15 }, "serial_num": "************", "manufacturer": "Specialized", "bcd_device": "1.00", "bus_power": 500, "bus_power_used": 500, "device_speed": "12.0 Mb/s", "extra_current_used": 0 }, { "name": "USB Billboard Device ", "vendor_id": 8457, "product_id": 34839, "location_id": { "bus": 2, "tree_positions": [ 2, 3, 5 ], "number": 12 }, "serial_num": "****************", "manufacturer": "VIA Labs, Inc. ", "bcd_device": "0.01", "bus_power": 500, "device_speed": "480.0 Mb/s", "extra_current_used": 0 } ] }, { "name": "hub_device", "vendor_id": 1086, "product_id": 39539, "location_id": { "bus": 2, "tree_positions": [ 2, 4 ], "number": 3 }, "serial_num": "************", "bcd_device": "1.00", "bus_power": 500, "bus_power_used": 0, "device_speed": "480.0 Mb/s", "extra_current_used": 0, "devices": [ { "name": "LG UltraFine Display Controls", "vendor_id": 1086, "product_id": 39536, "location_id": { "bus": 2, "tree_positions": [ 2, 4, 2 ], "number": 11 }, "manufacturer": "LG Electronics Inc.", "bcd_device": "4.13", "bus_power": 500, "bus_power_used": 0, "device_speed": "12.0 Mb/s", "extra_current_used": 0 }, { "name": "LG UltraFine Display Audio", "vendor_id": 1086, "product_id": 39526, "location_id": { "bus": 2, "tree_positions": [ 2, 4, 1 ], "number": 10 }, "manufacturer": "LG Electronics Inc.", "bcd_device": "0.03", "bus_power": 500, "bus_power_used": 0, "device_speed": "480.0 Mb/s", "extra_current_used": 0 } ] } ] } ] }, { "name": "T2Bus", "host_controller": "AppleUSBVHCIBCE", "devices": [ { "name": "Touch Bar Backlight", "vendor_id": 1452, "product_id": 33026, "location_id": { "bus": 128, "tree_positions": [ 7 ], "number": 7 }, "serial_num": "****************", "manufacturer": "Apple Inc.", "bcd_device": "2.01" }, { "name": "Touch Bar Display", "vendor_id": 1452, "product_id": 33538, "location_id": { "bus": 128, "tree_positions": [ 6 ], "number": 6 }, "serial_num": "****************", "manufacturer": "Apple Inc.", "bcd_device": "2.01" }, { "name": "Apple Internal Keyboard / Trackpad", "vendor_id": 1452, "product_id": 636, "location_id": { "bus": 128, "tree_positions": [ 5 ], "number": 5 }, "serial_num": "*********************", "manufacturer": "Apple Inc.", "bcd_device": "9.27" }, { "name": "Headset", "vendor_id": 1452, "product_id": 33027, "location_id": { "bus": 128, "tree_positions": [ 4 ], "number": 4 }, "serial_num": "************", "manufacturer": "Apple", "bcd_device": "2.03" }, { "name": "Ambient Light Sensor", "vendor_id": 1452, "product_id": 33378, "location_id": { "bus": 128, "tree_positions": [ 3 ], "number": 3 }, "serial_num": "************", "manufacturer": "Apple Inc.", "bcd_device": "2.01" }, { "name": "FaceTime HD Camera (Built-in)", "vendor_id": 1452, "product_id": 34068, "location_id": { "bus": 128, "tree_positions": [ 2 ], "number": 2 }, "serial_num": "*****************", "manufacturer": "Apple Inc.", "bcd_device": "2.01" }, { "name": "Apple T2 Controller", "vendor_id": 1452, "product_id": 33331, "location_id": { "bus": 128, "tree_positions": [ 1 ], "number": 1 }, "serial_num": "****************", "manufacturer": "Apple Inc.", "bcd_device": "2.01" } ] } ] } cyme-2.2.6/tests/data/cyme_sp_tree_json_dump.json000066400000000000000000000246541506545537300222100ustar00rootroot00000000000000{ "buses": [ { "name": "Unknown", "host_controller": "Unknown", "usb_bus_number": 0, "devices": [ { "name": "4-Port USB 3.0 Hub", "vendor_id": 3034, "product_id": 1041, "location_id": { "bus": 0, "tree_positions": [ 1 ], "number": 1 }, "serial_num": "", "manufacturer": "Generic", "bcd_device": 1.17, "bcd_usb": 3.0, "device_speed": "5.0 Gb/s", "devices": [ { "name": "4-Port USB 3.0 Hub", "vendor_id": 3034, "product_id": 1041, "location_id": { "bus": 0, "tree_positions": [ 1, 1 ], "number": 2 }, "serial_num": "", "manufacturer": "Generic", "bcd_device": 1.17, "bcd_usb": 3.0, "device_speed": "5.0 Gb/s", "class": "hub", "sub_class": 0, "protocol": 3 } ], "class": "hub", "sub_class": 0, "protocol": 3 } ] }, { "name": "Unknown", "host_controller": "Unknown", "usb_bus_number": 2, "devices": [ { "name": "USB3.1 Hub", "vendor_id": 1086, "product_id": 39520, "location_id": { "bus": 2, "tree_positions": [ 3 ], "number": 2 }, "serial_num": "", "manufacturer": "LG Electronics Inc.", "bcd_device": 52.5, "bcd_usb": 3.1, "device_speed": "5.0 Gb/s", "devices": [ { "name": "USB3.0 Hub", "vendor_id": 8457, "product_id": 2071, "location_id": { "bus": 2, "tree_positions": [ 3, 3 ], "number": 8 }, "serial_num": "", "manufacturer": "VIA Labs, Inc.", "bcd_device": 4.53, "bcd_usb": 3.1, "device_speed": "5.0 Gb/s", "class": "hub", "sub_class": 0, "protocol": 3 }, { "name": "Extreme SSD", "vendor_id": 1921, "product_id": 21900, "location_id": { "bus": 2, "tree_positions": [ 3, 2 ], "number": 6 }, "serial_num": "323030323247343032303739", "manufacturer": "SanDisk", "bcd_device": 10.12, "bcd_usb": 3.1, "device_speed": "5.0 Gb/s", "class": "use-interface-descriptor", "sub_class": 0, "protocol": 0 }, { "name": "Belkin USB-C LAN", "vendor_id": 3034, "product_id": 33107, "location_id": { "bus": 2, "tree_positions": [ 3, 1 ], "number": 5 }, "serial_num": "B2C1A1000000", "manufacturer": "Belkin", "bcd_device": 30.0, "bcd_usb": 3.0, "device_speed": "5.0 Gb/s", "class": "use-interface-descriptor", "sub_class": 0, "protocol": 0 }, { "name": "", "vendor_id": 1086, "product_id": 39537, "location_id": { "bus": 2, "tree_positions": [ 3, 4 ], "number": 4 }, "serial_num": "", "manufacturer": "LG Electronics USA, Inc.", "bcd_device": 1.0, "bcd_usb": 3.0, "device_speed": "5.0 Gb/s", "devices": [ { "name": "LG UltraFine Display Camera", "vendor_id": 1086, "product_id": 39528, "location_id": { "bus": 2, "tree_positions": [ 3, 4, 3 ], "number": 9 }, "serial_num": "", "manufacturer": "LG Electronlcs Inc.", "bcd_device": 2.23, "bcd_usb": 3.0, "device_speed": "5.0 Gb/s", "class": "miscellaneous", "sub_class": 2, "protocol": 1 } ], "class": "hub", "sub_class": 0, "protocol": 3 } ], "class": "hub", "sub_class": 0, "protocol": 3 }, { "name": "USB2.1 Hub", "vendor_id": 1086, "product_id": 39521, "location_id": { "bus": 2, "tree_positions": [ 2 ], "number": 1 }, "serial_num": "", "manufacturer": "LG Electronics Inc.", "bcd_device": 52.5, "bcd_usb": 2.1, "device_speed": "480.0 Mb/s", "devices": [ { "name": "USB2.0 Hub", "vendor_id": 8457, "product_id": 10263, "location_id": { "bus": 2, "tree_positions": [ 2, 3 ], "number": 7 }, "serial_num": "", "manufacturer": "VIA Labs, Inc.", "bcd_device": 4.53, "bcd_usb": 2.1, "device_speed": "480.0 Mb/s", "devices": [ { "name": "USB Billboard Device", "vendor_id": 8457, "product_id": 34839, "location_id": { "bus": 2, "tree_positions": [ 2, 3, 5 ], "number": 12 }, "serial_num": "0000000000000001", "manufacturer": "VIA Labs, Inc.", "bcd_device": 0.01, "bcd_usb": 2.01, "device_speed": "480.0 Mb/s", "class": "application-specific-interface", "sub_class": 0, "protocol": 0 } ], "class": "hub", "sub_class": 0, "protocol": 2 }, { "name": "", "vendor_id": 1086, "product_id": 39539, "location_id": { "bus": 2, "tree_positions": [ 2, 4 ], "number": 3 }, "serial_num": "AA0A2871A7D0", "manufacturer": "LG Electronics USA, Inc.", "bcd_device": 1.0, "bcd_usb": 2.1, "device_speed": "480.0 Mb/s", "devices": [ { "name": "LG UltraFine Display Audio", "vendor_id": 1086, "product_id": 39526, "location_id": { "bus": 2, "tree_positions": [ 2, 4, 1 ], "number": 11 }, "serial_num": "", "manufacturer": "LG Electronics Inc.", "bcd_device": 0.03, "bcd_usb": 2.0, "device_speed": "480.0 Mb/s", "class": "use-interface-descriptor", "sub_class": 0, "protocol": 0 }, { "name": "LG UltraFine Display Controls", "vendor_id": 1086, "product_id": 39536, "location_id": { "bus": 2, "tree_positions": [ 2, 4, 2 ], "number": 10 }, "serial_num": "", "manufacturer": "LG Electronics Inc.", "bcd_device": 4.13, "bcd_usb": 2.0, "device_speed": "12.0 Mb/s", "class": "use-interface-descriptor", "sub_class": 0, "protocol": 0 } ], "class": "hub", "sub_class": 0, "protocol": 2 } ], "class": "hub", "sub_class": 0, "protocol": 2 } ] }, { "name": "Unknown", "host_controller": "Unknown", "usb_bus_number": 20, "devices": [ { "name": "4-Port USB 2.0 Hub", "vendor_id": 3034, "product_id": 21521, "location_id": { "bus": 20, "tree_positions": [ 3 ], "number": 1 }, "serial_num": "", "manufacturer": "Generic", "bcd_device": 1.17, "bcd_usb": 2.1, "device_speed": "480.0 Mb/s", "devices": [ { "name": "4-Port USB 2.0 Hub", "vendor_id": 3034, "product_id": 21521, "location_id": { "bus": 20, "tree_positions": [ 3, 1 ], "number": 2 }, "serial_num": "", "manufacturer": "Generic", "bcd_device": 1.17, "bcd_usb": 2.1, "device_speed": "480.0 Mb/s", "class": "hub", "sub_class": 0, "protocol": 2 } ], "class": "hub", "sub_class": 0, "protocol": 2 } ] } ] } cyme-2.2.6/tests/data/lsusb_list.txt000066400000000000000000000011411506545537300174670ustar00rootroot00000000000000Bus 001 Device 003: ID 203a:fffa PARALLELS Virtual Printer (/Users/john/Parallels/Arch.pvm/parallel.txt) Bus 001 Device 002: ID 203a:fffc PARALLELS Virtual Mouse Bus 001 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub Bus 002 Device 022: ID 203a:fffe PARALLELS Virtual USB1.1 HUB Bus 002 Device 024: ID 1d50:6018 OpenMoko, Inc. Black Magic Debug Probe (Application) Bus 002 Device 023: ID 1366:1050 SEGGER J-Link Bus 002 Device 001: ID 1d6b:0001 Linux Foundation 1.1 root hub Bus 003 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub Bus 004 Device 001: ID 1d6b:0003 Linux Foundation 3.0 root hub cyme-2.2.6/tests/data/lsusb_tree.txt000066400000000000000000000026161506545537300174630ustar00rootroot00000000000000/: Bus 001.Port 001: Dev 001, Class=root_hub, Driver=hub, 480M |__ Port 002: Dev 002, If 0, Class=Human Interface Device, Driver=usbhid, 480M |__ Port 002: Dev 002, If 1, Class=Human Interface Device, Driver=usbhid, 480M |__ Port 006: Dev 003, If 0, Class=Printer, Driver=usblp, 480M /: Bus 002.Port 001: Dev 001, Class=root_hub, Driver=hub, 12M |__ Port 002: Dev 022, If 0, Class=Hub, Driver=hub, 12M |__ Port 001: Dev 023, If 0, Class=Communications, Driver=cdc_acm, 12M |__ Port 001: Dev 023, If 1, Class=CDC Data, Driver=cdc_acm, 12M |__ Port 001: Dev 023, If 2, Class=Communications, Driver=cdc_acm, 12M |__ Port 001: Dev 023, If 3, Class=CDC Data, Driver=cdc_acm, 12M |__ Port 001: Dev 023, If 4, Class=Vendor Specific Class, Driver=[none], 12M |__ Port 008: Dev 024, If 0, Class=Communications, Driver=cdc_acm, 12M |__ Port 008: Dev 024, If 1, Class=CDC Data, Driver=cdc_acm, 12M |__ Port 008: Dev 024, If 2, Class=Communications, Driver=cdc_acm, 12M |__ Port 008: Dev 024, If 3, Class=CDC Data, Driver=cdc_acm, 12M |__ Port 008: Dev 024, If 4, Class=Application Specific Interface, Driver=[none], 12M |__ Port 008: Dev 024, If 5, Class=Vendor Specific Class, Driver=[none], 12M /: Bus 003.Port 001: Dev 001, Class=root_hub, Driver=hub, 480M /: Bus 004.Port 001: Dev 001, Class=root_hub, Driver=hub, 10000M cyme-2.2.6/tests/data/lsusb_tree_verbose.txt000066400000000000000000000112131506545537300212010ustar00rootroot00000000000000/: Bus 001.Port 001: Dev 001, Class=root_hub, Driver=hub, 480M ID 1d6b:0002 Linux Foundation 2.0 root hub /sys/bus/usb/devices/usb1 /dev/bus/usb/001/001 |__ Port 002: Dev 002, If 0, Class=Human Interface Device, Driver=usbhid, 480M ID 203a:fffc PARALLELS [unknown] /sys/bus/usb/devices/1-2 /dev/bus/usb/001/002 Manufactuer=Virtual Mouse Product=Parallels Serial=PW3.0 |__ Port 002: Dev 002, If 1, Class=Human Interface Device, Driver=usbhid, 480M ID 203a:fffc PARALLELS [unknown] /sys/bus/usb/devices/1-2 /dev/bus/usb/001/002 Manufactuer=Virtual Mouse Product=Parallels Serial=PW3.0 |__ Port 006: Dev 003, If 0, Class=Printer, Driver=usblp, 480M ID 203a:fffa PARALLELS [unknown] /sys/bus/usb/devices/1-6 /dev/bus/usb/001/003 Manufactuer=Virtual Printer (/Users/john/Parallels/Arch.pvm/parallel.txt) Product=Parallels Serial=SN0000 /: Bus 002.Port 001: Dev 001, Class=root_hub, Driver=hub, 12M ID 1d6b:0001 Linux Foundation 1.1 root hub /sys/bus/usb/devices/usb2 /dev/bus/usb/002/001 |__ Port 002: Dev 022, If 0, Class=Hub, Driver=hub, 12M ID 203a:fffe PARALLELS [unknown] /sys/bus/usb/devices/2-2 /dev/bus/usb/002/022 Manufactuer=Virtual USB1.1 HUB Product=Parallels Serial=PW3.0 |__ Port 001: Dev 023, If 0, Class=Communications, Driver=cdc_acm, 12M ID 1366:1050 SEGGER [unknown] /sys/bus/usb/devices/2-2.1 /dev/bus/usb/002/023 Manufactuer=J-Link Product=SEGGER Serial=001050027328 |__ Port 001: Dev 023, If 1, Class=CDC Data, Driver=cdc_acm, 12M ID 1366:1050 SEGGER [unknown] /sys/bus/usb/devices/2-2.1 /dev/bus/usb/002/023 Manufactuer=J-Link Product=SEGGER Serial=001050027328 |__ Port 001: Dev 023, If 2, Class=Communications, Driver=cdc_acm, 12M ID 1366:1050 SEGGER [unknown] /sys/bus/usb/devices/2-2.1 /dev/bus/usb/002/023 Manufactuer=J-Link Product=SEGGER Serial=001050027328 |__ Port 001: Dev 023, If 3, Class=CDC Data, Driver=cdc_acm, 12M ID 1366:1050 SEGGER [unknown] /sys/bus/usb/devices/2-2.1 /dev/bus/usb/002/023 Manufactuer=J-Link Product=SEGGER Serial=001050027328 |__ Port 001: Dev 023, If 4, Class=Vendor Specific Class, Driver=[none], 12M ID 1366:1050 SEGGER [unknown] /sys/bus/usb/devices/2-2.1 /dev/bus/usb/002/023 Manufactuer=J-Link Product=SEGGER Serial=001050027328 |__ Port 008: Dev 024, If 0, Class=Communications, Driver=cdc_acm, 12M ID 1d50:6018 OpenMoko, Inc. Black Magic Debug Probe (Application) /sys/bus/usb/devices/2-2.8 /dev/bus/usb/002/024 Manufactuer=Black Magic Probe v1.8.2 Product=Black Magic Debug Serial=97B6A11D |__ Port 008: Dev 024, If 1, Class=CDC Data, Driver=cdc_acm, 12M ID 1d50:6018 OpenMoko, Inc. Black Magic Debug Probe (Application) /sys/bus/usb/devices/2-2.8 /dev/bus/usb/002/024 Manufactuer=Black Magic Probe v1.8.2 Product=Black Magic Debug Serial=97B6A11D |__ Port 008: Dev 024, If 2, Class=Communications, Driver=cdc_acm, 12M ID 1d50:6018 OpenMoko, Inc. Black Magic Debug Probe (Application) /sys/bus/usb/devices/2-2.8 /dev/bus/usb/002/024 Manufactuer=Black Magic Probe v1.8.2 Product=Black Magic Debug Serial=97B6A11D |__ Port 008: Dev 024, If 3, Class=CDC Data, Driver=cdc_acm, 12M ID 1d50:6018 OpenMoko, Inc. Black Magic Debug Probe (Application) /sys/bus/usb/devices/2-2.8 /dev/bus/usb/002/024 Manufactuer=Black Magic Probe v1.8.2 Product=Black Magic Debug Serial=97B6A11D |__ Port 008: Dev 024, If 4, Class=Application Specific Interface, Driver=[none], 12M ID 1d50:6018 OpenMoko, Inc. Black Magic Debug Probe (Application) /sys/bus/usb/devices/2-2.8 /dev/bus/usb/002/024 Manufactuer=Black Magic Probe v1.8.2 Product=Black Magic Debug Serial=97B6A11D |__ Port 008: Dev 024, If 5, Class=Vendor Specific Class, Driver=[none], 12M ID 1d50:6018 OpenMoko, Inc. Black Magic Debug Probe (Application) /sys/bus/usb/devices/2-2.8 /dev/bus/usb/002/024 Manufactuer=Black Magic Probe v1.8.2 Product=Black Magic Debug Serial=97B6A11D /: Bus 003.Port 001: Dev 001, Class=root_hub, Driver=hub, 480M ID 1d6b:0002 Linux Foundation 2.0 root hub /sys/bus/usb/devices/usb3 /dev/bus/usb/003/001 /: Bus 004.Port 001: Dev 001, Class=root_hub, Driver=hub, 10000M ID 1d6b:0003 Linux Foundation 3.0 root hub /sys/bus/usb/devices/usb4 /dev/bus/usb/004/001 cyme-2.2.6/tests/data/lsusb_verbose.txt000066400000000000000000000671551506545537300202020ustar00rootroot00000000000000 Bus 001 Device 003: ID 203a:fffa PARALLELS Virtual Printer (/Users/john/Parallels/Arch.pvm/parallel.txt) Device Descriptor: bLength 18 bDescriptorType 1 bcdUSB 2.00 bDeviceClass 0 bDeviceSubClass 0 bDeviceProtocol 0 bMaxPacketSize0 64 idVendor 0x203a PARALLELS idProduct 0xfffa bcdDevice 1.00 iManufacturer 1 Parallels iProduct 2 Virtual Printer (/Users/john/Parallels/Arch.pvm/parallel.txt) iSerial 3 SN0000 bNumConfigurations 1 Configuration Descriptor: bLength 9 bDescriptorType 2 wTotalLength 0x0019 bNumInterfaces 1 bConfigurationValue 1 iConfiguration 1 Parallels bmAttributes 0xc0 Self Powered MaxPower 0mA Interface Descriptor: bLength 9 bDescriptorType 4 bInterfaceNumber 0 bAlternateSetting 0 bNumEndpoints 1 bInterfaceClass 7 Printer bInterfaceSubClass 1 Printer bInterfaceProtocol 1 Unidirectional iInterface 4 Virtual USB Printer Interface Endpoint Descriptor: bLength 7 bDescriptorType 5 bEndpointAddress 0x01 EP 1 OUT bmAttributes 2 Transfer Type Bulk Synch Type None Usage Type Data wMaxPacketSize 0x0200 1x 512 bytes bInterval 0 Device Qualifier (for other device speed): bLength 10 bDescriptorType 6 bcdUSB 2.00 bDeviceClass 0 bDeviceSubClass 0 bDeviceProtocol 0 bMaxPacketSize0 64 bNumConfigurations 0 Device Status: 0x0001 Self Powered Bus 001 Device 002: ID 203a:fffc PARALLELS Virtual Mouse Device Descriptor: bLength 18 bDescriptorType 1 bcdUSB 2.00 bDeviceClass 0 bDeviceSubClass 0 bDeviceProtocol 0 bMaxPacketSize0 64 idVendor 0x203a PARALLELS idProduct 0xfffc bcdDevice 1.00 iManufacturer 1 Parallels iProduct 2 Virtual Mouse iSerial 3 PW3.0 bNumConfigurations 1 Configuration Descriptor: bLength 9 bDescriptorType 2 wTotalLength 0x003b bNumInterfaces 2 bConfigurationValue 1 iConfiguration 1 bmAttributes 0xc0 Self Powered MaxPower 0mA Interface Descriptor: bLength 9 bDescriptorType 4 bInterfaceNumber 0 bAlternateSetting 0 bNumEndpoints 1 bInterfaceClass 3 Human Interface Device bInterfaceSubClass 0 bInterfaceProtocol 2 Mouse iInterface 4 HID Device Descriptor: bLength 9 bDescriptorType 33 bcdHID 1.10 bCountryCode 0 Not supported bNumDescriptors 1 bDescriptorType 34 Report wDescriptorLength 126 Report Descriptors: ** UNAVAILABLE ** Endpoint Descriptor: bLength 7 bDescriptorType 5 bEndpointAddress 0x81 EP 1 IN bmAttributes 3 Transfer Type Interrupt Synch Type None Usage Type Data wMaxPacketSize 0x0040 1x 64 bytes bInterval 4 Interface Descriptor: bLength 9 bDescriptorType 4 bInterfaceNumber 1 bAlternateSetting 0 bNumEndpoints 1 bInterfaceClass 3 Human Interface Device bInterfaceSubClass 0 bInterfaceProtocol 2 Mouse iInterface 5 HID Device Descriptor: bLength 9 bDescriptorType 33 bcdHID 1.10 bCountryCode 0 Not supported bNumDescriptors 1 bDescriptorType 34 Report wDescriptorLength 127 Report Descriptors: ** UNAVAILABLE ** Endpoint Descriptor: bLength 7 bDescriptorType 5 bEndpointAddress 0x82 EP 2 IN bmAttributes 3 Transfer Type Interrupt Synch Type None Usage Type Data wMaxPacketSize 0x0040 1x 64 bytes bInterval 4 Bus 001 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub Device Descriptor: bLength 18 bDescriptorType 1 bcdUSB 2.00 bDeviceClass 9 Hub bDeviceSubClass 0 bDeviceProtocol 0 Full speed (or root) hub bMaxPacketSize0 64 idVendor 0x1d6b Linux Foundation idProduct 0x0002 2.0 root hub bcdDevice 6.00 iManufacturer 3 Linux 6.0.9-arch1-1 ehci_hcd iProduct 2 EHCI Host Controller iSerial 1 0000:00:1d.7 bNumConfigurations 1 Configuration Descriptor: bLength 9 bDescriptorType 2 wTotalLength 0x0019 bNumInterfaces 1 bConfigurationValue 1 iConfiguration 0 bmAttributes 0xe0 Self Powered Remote Wakeup MaxPower 0mA Interface Descriptor: bLength 9 bDescriptorType 4 bInterfaceNumber 0 bAlternateSetting 0 bNumEndpoints 1 bInterfaceClass 9 Hub bInterfaceSubClass 0 bInterfaceProtocol 0 Full speed (or root) hub iInterface 0 Endpoint Descriptor: bLength 7 bDescriptorType 5 bEndpointAddress 0x81 EP 1 IN bmAttributes 3 Transfer Type Interrupt Synch Type None Usage Type Data wMaxPacketSize 0x0004 1x 4 bytes bInterval 12 Bus 004 Device 001: ID 1d6b:0003 Linux Foundation 3.0 root hub Device Descriptor: bLength 18 bDescriptorType 1 bcdUSB 3.10 bDeviceClass 9 Hub bDeviceSubClass 0 bDeviceProtocol 3 bMaxPacketSize0 9 idVendor 0x1d6b Linux Foundation idProduct 0x0003 3.0 root hub bcdDevice 6.00 iManufacturer 3 Linux 6.0.9-arch1-1 xhci-hcd iProduct 2 xHCI Host Controller iSerial 1 0000:00:1d.6 bNumConfigurations 1 Configuration Descriptor: bLength 9 bDescriptorType 2 wTotalLength 0x001f bNumInterfaces 1 bConfigurationValue 1 iConfiguration 0 bmAttributes 0xe0 Self Powered Remote Wakeup MaxPower 0mA Interface Descriptor: bLength 9 bDescriptorType 4 bInterfaceNumber 0 bAlternateSetting 0 bNumEndpoints 1 bInterfaceClass 9 Hub bInterfaceSubClass 0 bInterfaceProtocol 0 Full speed (or root) hub iInterface 0 Endpoint Descriptor: bLength 7 bDescriptorType 5 bEndpointAddress 0x81 EP 1 IN bmAttributes 3 Transfer Type Interrupt Synch Type None Usage Type Data wMaxPacketSize 0x0004 1x 4 bytes bInterval 12 bMaxBurst 0 Bus 003 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub Device Descriptor: bLength 18 bDescriptorType 1 bcdUSB 2.00 bDeviceClass 9 Hub bDeviceSubClass 0 bDeviceProtocol 1 Single TT bMaxPacketSize0 64 idVendor 0x1d6b Linux Foundation idProduct 0x0002 2.0 root hub bcdDevice 6.00 iManufacturer 3 Linux 6.0.9-arch1-1 xhci-hcd iProduct 2 xHCI Host Controller iSerial 1 0000:00:1d.6 bNumConfigurations 1 Configuration Descriptor: bLength 9 bDescriptorType 2 wTotalLength 0x0019 bNumInterfaces 1 bConfigurationValue 1 iConfiguration 0 bmAttributes 0xe0 Self Powered Remote Wakeup MaxPower 0mA Interface Descriptor: bLength 9 bDescriptorType 4 bInterfaceNumber 0 bAlternateSetting 0 bNumEndpoints 1 bInterfaceClass 9 Hub bInterfaceSubClass 0 bInterfaceProtocol 0 Full speed (or root) hub iInterface 0 Endpoint Descriptor: bLength 7 bDescriptorType 5 bEndpointAddress 0x81 EP 1 IN bmAttributes 3 Transfer Type Interrupt Synch Type None Usage Type Data wMaxPacketSize 0x0004 1x 4 bytes bInterval 12 Bus 002 Device 004: ID 1366:1050 SEGGER J-Link Device Descriptor: bLength 18 bDescriptorType 1 bcdUSB 2.00 bDeviceClass 239 Miscellaneous Device bDeviceSubClass 2 bDeviceProtocol 1 Interface Association bMaxPacketSize0 64 idVendor 0x1366 SEGGER idProduct 0x1050 bcdDevice 1.00 iManufacturer 1 SEGGER iProduct 2 J-Link iSerial 3 001050027328 bNumConfigurations 1 Configuration Descriptor: bLength 9 bDescriptorType 2 wTotalLength 0x00a4 bNumInterfaces 5 bConfigurationValue 1 iConfiguration 4 Configuration bmAttributes 0x80 (Bus Powered) MaxPower 100mA Interface Association: bLength 8 bDescriptorType 11 bFirstInterface 0 bInterfaceCount 2 bFunctionClass 2 Communications bFunctionSubClass 2 Abstract (modem) bFunctionProtocol 0 iFunction 5 CDC Interface Descriptor: bLength 9 bDescriptorType 4 bInterfaceNumber 0 bAlternateSetting 0 bNumEndpoints 1 bInterfaceClass 2 Communications bInterfaceSubClass 2 Abstract (modem) bInterfaceProtocol 1 AT-commands (v.25ter) iInterface 5 CDC CDC Header: bcdCDC 1.10 CDC Call Management: bmCapabilities 0x03 call management use DataInterface bDataInterface 1 CDC ACM: bmCapabilities 0x06 sends break line coding and serial state CDC Union: bMasterInterface 0 bSlaveInterface 1 Endpoint Descriptor: bLength 7 bDescriptorType 5 bEndpointAddress 0x82 EP 2 IN bmAttributes 3 Transfer Type Interrupt Synch Type None Usage Type Data wMaxPacketSize 0x0040 1x 64 bytes bInterval 1 Interface Descriptor: bLength 9 bDescriptorType 4 bInterfaceNumber 1 bAlternateSetting 0 bNumEndpoints 2 bInterfaceClass 10 CDC Data bInterfaceSubClass 0 bInterfaceProtocol 0 iInterface 6 CDC DATA interface Endpoint Descriptor: bLength 7 bDescriptorType 5 bEndpointAddress 0x81 EP 1 IN bmAttributes 2 Transfer Type Bulk Synch Type None Usage Type Data wMaxPacketSize 0x0040 1x 64 bytes bInterval 1 Endpoint Descriptor: bLength 7 bDescriptorType 5 bEndpointAddress 0x01 EP 1 OUT bmAttributes 2 Transfer Type Bulk Synch Type None Usage Type Data wMaxPacketSize 0x0040 1x 64 bytes bInterval 1 Interface Association: bLength 8 bDescriptorType 11 bFirstInterface 2 bInterfaceCount 2 bFunctionClass 2 Communications bFunctionSubClass 2 Abstract (modem) bFunctionProtocol 0 iFunction 7 CDC Interface Descriptor: bLength 9 bDescriptorType 4 bInterfaceNumber 2 bAlternateSetting 0 bNumEndpoints 1 bInterfaceClass 2 Communications bInterfaceSubClass 2 Abstract (modem) bInterfaceProtocol 1 AT-commands (v.25ter) iInterface 7 CDC CDC Header: bcdCDC 1.10 CDC Call Management: bmCapabilities 0x03 call management use DataInterface bDataInterface 3 CDC ACM: bmCapabilities 0x06 sends break line coding and serial state CDC Union: bMasterInterface 2 bSlaveInterface 3 Endpoint Descriptor: bLength 7 bDescriptorType 5 bEndpointAddress 0x84 EP 4 IN bmAttributes 3 Transfer Type Interrupt Synch Type None Usage Type Data wMaxPacketSize 0x0040 1x 64 bytes bInterval 1 Interface Descriptor: bLength 9 bDescriptorType 4 bInterfaceNumber 3 bAlternateSetting 0 bNumEndpoints 2 bInterfaceClass 10 CDC Data bInterfaceSubClass 0 bInterfaceProtocol 0 iInterface 8 CDC DATA interface Endpoint Descriptor: bLength 7 bDescriptorType 5 bEndpointAddress 0x83 EP 3 IN bmAttributes 2 Transfer Type Bulk Synch Type None Usage Type Data wMaxPacketSize 0x0040 1x 64 bytes bInterval 1 Endpoint Descriptor: bLength 7 bDescriptorType 5 bEndpointAddress 0x02 EP 2 OUT bmAttributes 2 Transfer Type Bulk Synch Type None Usage Type Data wMaxPacketSize 0x0040 1x 64 bytes bInterval 1 Interface Descriptor: bLength 9 bDescriptorType 4 bInterfaceNumber 4 bAlternateSetting 0 bNumEndpoints 2 bInterfaceClass 255 Vendor Specific Class bInterfaceSubClass 255 Vendor Specific Subclass bInterfaceProtocol 255 Vendor Specific Protocol iInterface 9 BULK interface Endpoint Descriptor: bLength 7 bDescriptorType 5 bEndpointAddress 0x85 EP 5 IN bmAttributes 2 Transfer Type Bulk Synch Type None Usage Type Data wMaxPacketSize 0x0040 1x 64 bytes bInterval 1 Endpoint Descriptor: bLength 7 bDescriptorType 5 bEndpointAddress 0x03 EP 3 OUT bmAttributes 2 Transfer Type Bulk Synch Type None Usage Type Data wMaxPacketSize 0x0040 1x 64 bytes bInterval 1 Device Status: 0x0000 (Bus Powered) Bus 002 Device 003: ID 1d50:6018 OpenMoko, Inc. Black Magic Debug Probe (Application) Device Descriptor: bLength 18 bDescriptorType 1 bcdUSB 2.00 bDeviceClass 239 Miscellaneous Device bDeviceSubClass 2 bDeviceProtocol 1 Interface Association bMaxPacketSize0 32 idVendor 0x1d50 OpenMoko, Inc. idProduct 0x6018 Black Magic Debug Probe (Application) bcdDevice 1.00 iManufacturer 1 Black Magic Debug iProduct 2 Black Magic Probe v1.8.2 iSerial 3 97B6A11D bNumConfigurations 1 Configuration Descriptor: bLength 9 bDescriptorType 2 wTotalLength 0x00bf bNumInterfaces 6 bConfigurationValue 1 iConfiguration 0 bmAttributes 0x80 (Bus Powered) MaxPower 100mA Interface Association: bLength 8 bDescriptorType 11 bFirstInterface 0 bInterfaceCount 2 bFunctionClass 2 Communications bFunctionSubClass 2 Abstract (modem) bFunctionProtocol 0 iFunction 4 Interface Descriptor: bLength 9 bDescriptorType 4 bInterfaceNumber 0 bAlternateSetting 0 bNumEndpoints 1 bInterfaceClass 2 Communications bInterfaceSubClass 2 Abstract (modem) bInterfaceProtocol 0 iInterface 4 CDC Header: bcdCDC 1.10 CDC Call Management: bmCapabilities 0x00 bDataInterface 1 CDC ACM: bmCapabilities 0x02 line coding and serial state CDC Union: bMasterInterface 0 bSlaveInterface 1 Endpoint Descriptor: bLength 7 bDescriptorType 5 bEndpointAddress 0x82 EP 2 IN bmAttributes 3 Transfer Type Interrupt Synch Type None Usage Type Data wMaxPacketSize 0x0010 1x 16 bytes bInterval 255 Interface Descriptor: bLength 9 bDescriptorType 4 bInterfaceNumber 1 bAlternateSetting 0 bNumEndpoints 2 bInterfaceClass 10 CDC Data bInterfaceSubClass 0 bInterfaceProtocol 0 iInterface 0 Endpoint Descriptor: bLength 7 bDescriptorType 5 bEndpointAddress 0x01 EP 1 OUT bmAttributes 2 Transfer Type Bulk Synch Type None Usage Type Data wMaxPacketSize 0x0040 1x 64 bytes bInterval 1 Endpoint Descriptor: bLength 7 bDescriptorType 5 bEndpointAddress 0x81 EP 1 IN bmAttributes 2 Transfer Type Bulk Synch Type None Usage Type Data wMaxPacketSize 0x0040 1x 64 bytes bInterval 1 Interface Association: bLength 8 bDescriptorType 11 bFirstInterface 2 bInterfaceCount 2 bFunctionClass 2 Communications bFunctionSubClass 2 Abstract (modem) bFunctionProtocol 0 iFunction 5 Interface Descriptor: bLength 9 bDescriptorType 4 bInterfaceNumber 2 bAlternateSetting 0 bNumEndpoints 1 bInterfaceClass 2 Communications bInterfaceSubClass 2 Abstract (modem) bInterfaceProtocol 0 iInterface 5 CDC Header: bcdCDC 1.10 CDC Call Management: bmCapabilities 0x00 bDataInterface 3 CDC ACM: bmCapabilities 0x02 line coding and serial state CDC Union: bMasterInterface 2 bSlaveInterface 3 Endpoint Descriptor: bLength 7 bDescriptorType 5 bEndpointAddress 0x84 EP 4 IN bmAttributes 3 Transfer Type Interrupt Synch Type None Usage Type Data wMaxPacketSize 0x0010 1x 16 bytes bInterval 255 Interface Descriptor: bLength 9 bDescriptorType 4 bInterfaceNumber 3 bAlternateSetting 0 bNumEndpoints 2 bInterfaceClass 10 CDC Data bInterfaceSubClass 0 bInterfaceProtocol 0 iInterface 0 Endpoint Descriptor: bLength 7 bDescriptorType 5 bEndpointAddress 0x03 EP 3 OUT bmAttributes 2 Transfer Type Bulk Synch Type None Usage Type Data wMaxPacketSize 0x0020 1x 32 bytes bInterval 1 Endpoint Descriptor: bLength 7 bDescriptorType 5 bEndpointAddress 0x83 EP 3 IN bmAttributes 2 Transfer Type Bulk Synch Type None Usage Type Data wMaxPacketSize 0x0040 1x 64 bytes bInterval 1 Interface Association: bLength 8 bDescriptorType 11 bFirstInterface 4 bInterfaceCount 1 bFunctionClass 254 Application Specific Interface bFunctionSubClass 1 Device Firmware Update bFunctionProtocol 1 iFunction 6 Interface Descriptor: bLength 9 bDescriptorType 4 bInterfaceNumber 4 bAlternateSetting 0 bNumEndpoints 0 bInterfaceClass 254 Application Specific Interface bInterfaceSubClass 1 Device Firmware Update bInterfaceProtocol 1 iInterface 6 Device Firmware Upgrade Interface Descriptor: bLength 9 bDescriptorType 33 bmAttributes 9 Will Detach Manifestation Intolerant Upload Unsupported Download Supported wDetachTimeout 255 milliseconds wTransferSize 1024 bytes bcdDFUVersion 1.1a Interface Association: bLength 8 bDescriptorType 11 bFirstInterface 5 bInterfaceCount 1 bFunctionClass 255 Vendor Specific Class bFunctionSubClass 255 Vendor Specific Subclass bFunctionProtocol 255 Vendor Specific Protocol iFunction 7 Interface Descriptor: bLength 9 bDescriptorType 4 bInterfaceNumber 5 bAlternateSetting 0 bNumEndpoints 1 bInterfaceClass 255 Vendor Specific Class bInterfaceSubClass 255 Vendor Specific Subclass bInterfaceProtocol 255 Vendor Specific Protocol iInterface 7 Endpoint Descriptor: bLength 7 bDescriptorType 5 bEndpointAddress 0x85 EP 5 IN bmAttributes 2 Transfer Type Bulk Synch Type None Usage Type Data wMaxPacketSize 0x0040 1x 64 bytes bInterval 0 Bus 002 Device 002: ID 203a:fffe PARALLELS Virtual USB1.1 HUB Device Descriptor: bLength 18 bDescriptorType 1 bcdUSB 2.00 bDeviceClass 9 Hub bDeviceSubClass 0 bDeviceProtocol 0 Full speed (or root) hub bMaxPacketSize0 8 idVendor 0x203a PARALLELS idProduct 0xfffe bcdDevice 1.01 iManufacturer 1 Parallels iProduct 2 Virtual USB1.1 HUB iSerial 3 PW3.0 bNumConfigurations 1 Configuration Descriptor: bLength 9 bDescriptorType 2 wTotalLength 0x0019 bNumInterfaces 1 bConfigurationValue 1 iConfiguration 0 bmAttributes 0xc0 Self Powered MaxPower 0mA Interface Descriptor: bLength 9 bDescriptorType 4 bInterfaceNumber 0 bAlternateSetting 0 bNumEndpoints 1 bInterfaceClass 9 Hub bInterfaceSubClass 0 bInterfaceProtocol 0 Full speed (or root) hub iInterface 0 Endpoint Descriptor: bLength 7 bDescriptorType 5 bEndpointAddress 0x81 EP 1 IN bmAttributes 3 Transfer Type Interrupt Synch Type None Usage Type Data wMaxPacketSize 0x0004 1x 4 bytes bInterval 255 Bus 002 Device 001: ID 1d6b:0001 Linux Foundation 1.1 root hub Device Descriptor: bLength 18 bDescriptorType 1 bcdUSB 1.10 bDeviceClass 9 Hub bDeviceSubClass 0 bDeviceProtocol 0 Full speed (or root) hub bMaxPacketSize0 64 idVendor 0x1d6b Linux Foundation idProduct 0x0001 1.1 root hub bcdDevice 6.00 iManufacturer 3 Linux 6.0.9-arch1-1 uhci_hcd iProduct 2 UHCI Host Controller iSerial 1 0000:00:1d.0 bNumConfigurations 1 Configuration Descriptor: bLength 9 bDescriptorType 2 wTotalLength 0x0019 bNumInterfaces 1 bConfigurationValue 1 iConfiguration 0 bmAttributes 0xe0 Self Powered Remote Wakeup MaxPower 0mA Interface Descriptor: bLength 9 bDescriptorType 4 bInterfaceNumber 0 bAlternateSetting 0 bNumEndpoints 1 bInterfaceClass 9 Hub bInterfaceSubClass 0 bInterfaceProtocol 0 Full speed (or root) hub iInterface 0 Endpoint Descriptor: bLength 7 bDescriptorType 5 bEndpointAddress 0x81 EP 1 IN bmAttributes 3 Transfer Type Interrupt Synch Type None Usage Type Data wMaxPacketSize 0x0002 1x 2 bytes bInterval 255 cyme-2.2.6/tests/data/system_profiler_dump.json000066400000000000000000000350711506545537300217220ustar00rootroot00000000000000{ "SPUSBDataType" : [ { "_items" : [ { "_items" : [ { "_name" : "Black Magic Probe v1.8.2", "bcd_device" : "1.00", "bus_power" : "500", "bus_power_used" : "100", "device_speed" : "full_speed", "extra_current_used" : "0", "location_id" : "0x14330000 / 6", "manufacturer" : "Black Magic Debug", "product_id" : "0x6018", "serial_num" : "********", "vendor_id" : "0x1d50" }, { "_items" : [ { "_name" : "Android", "bcd_device" : "3.18", "bus_power" : "500", "bus_power_used" : "500", "device_speed" : "high_speed", "extra_current_used" : "0", "location_id" : "0x14313000 / 5", "manufacturer" : "Android", "product_id" : "0x9091", "serial_num" : "*******************", "vendor_id" : "0x05c6 (Qualcomm, Inc)" } ], "_name" : "4-Port USB 2.0 Hub", "bcd_device" : "1.17", "bus_power" : "500", "bus_power_used" : "0", "device_speed" : "high_speed", "extra_current_used" : "0", "location_id" : "0x14310000 / 2", "manufacturer" : "Generic", "product_id" : "0x5411", "vendor_id" : "0x0bda (Realtek Semiconductor Corp.)" } ], "_name" : "4-Port USB 2.0 Hub", "bcd_device" : "1.17", "bus_power" : "500", "bus_power_used" : "0", "device_speed" : "high_speed", "extra_current_used" : "0", "location_id" : "0x14300000 / 1", "manufacturer" : "Generic", "product_id" : "0x5411", "vendor_id" : "0x0bda (Realtek Semiconductor Corp.)" }, { "_name" : "AirPods Max", "bcd_device" : "9b.00", "bus_power" : "500", "bus_power_used" : "500", "device_speed" : "full_speed", "extra_current_used" : "1600", "location_id" : "0x14100000 / 4", "manufacturer" : "Apple Inc.", "product_id" : "0x1109", "serial_num" : "************", "sleep_current" : "2100", "vendor_id" : "apple_vendor_id" } ], "_name" : "USB31Bus", "host_controller" : "AppleIntelCNLUSBXHCI", "pci_device" : "0xa36d ", "pci_revision" : "0x0010 ", "pci_vendor" : "0x8086 " }, { "_name" : "USB31Bus", "host_controller" : "AppleUSBXHCITR", "pci_device" : "0x15ec ", "pci_revision" : "0x0006 ", "pci_vendor" : "0x8086 ", "usb_bus_number" : "0x01 " }, { "_items" : [ { "_items" : [ { "_name" : "4-Port USB 3.0 Hub", "bcd_device" : "1.17", "bus_power" : "900", "bus_power_used" : "0", "device_speed" : "super_speed", "extra_current_used" : "0", "location_id" : "0x00110000 / 2", "manufacturer" : "Generic", "product_id" : "0x0411", "vendor_id" : "0x0bda (Realtek Semiconductor Corp.)" } ], "_name" : "4-Port USB 3.0 Hub", "bcd_device" : "1.17", "bus_power" : "900", "bus_power_used" : "0", "device_speed" : "super_speed", "extra_current_used" : "0", "location_id" : "0x00100000 / 1", "manufacturer" : "Generic", "product_id" : "0x0411", "vendor_id" : "0x0bda (Realtek Semiconductor Corp.)" } ], "_name" : "USB31Bus", "host_controller" : "AppleUSBXHCITR", "pci_device" : "0x15ec ", "pci_revision" : "0x0006 ", "pci_vendor" : "0x8086 ", "usb_bus_number" : "0x00 " }, { "_items" : [ { "_items" : [ { "_name" : "USB3.0 Hub ", "bcd_device" : "4.53", "bus_power" : "900", "bus_power_used" : "0", "device_speed" : "super_speed", "extra_current_used" : "0", "location_id" : "0x02330000 / 4", "manufacturer" : "VIA Labs, Inc. ", "product_id" : "0x0817", "vendor_id" : "0x2109 (VIA Labs, Inc.)" }, { "_name" : "Extreme SSD", "bcd_device" : "10.12", "bus_power" : "900", "bus_power_used" : "896", "device_speed" : "super_speed", "extra_current_used" : "0", "location_id" : "0x02320000 / 8", "manufacturer" : "SanDisk", "Media" : [ { "_name" : "Extreme SSD", "bsd_name" : "disk2", "Logical Unit" : 0, "partition_map_type" : "guid_partition_map_type", "removable_media" : "no", "size" : "1 TB", "size_in_bytes" : 1000204140544, "smart_status" : "Verified", "USB Interface" : 0, "volumes" : [ { "_name" : "EFI", "bsd_name" : "disk2s1", "file_system" : "MS-DOS FAT32", "iocontent" : "EFI", "size" : "209.7 MB", "size_in_bytes" : 209715200, "volume_uuid" : "0E239BC6-F960-3107-89CF-1C97F78BB46B" }, { "_name" : "disk2s2", "bsd_name" : "disk2s2", "iocontent" : "Apple_APFS", "size" : "999.99 GB", "size_in_bytes" : 999994384384 } ] } ], "product_id" : "0x558c", "serial_num" : "************************", "vendor_id" : "0x0781 (SanDisk Corporation)" }, { "_name" : "Belkin USB-C LAN", "bcd_device" : "30.00", "bus_power" : "900", "bus_power_used" : "256", "device_speed" : "super_speed", "extra_current_used" : "0", "location_id" : "0x02310000 / 7", "manufacturer" : "Belkin", "product_id" : "0x8153", "serial_num" : "************", "vendor_id" : "0x0bda (Realtek Semiconductor Corp.)" }, { "_items" : [ { "_name" : "LG UltraFine Display Camera", "bcd_device" : "2.23", "bus_power" : "900", "bus_power_used" : "96", "device_speed" : "super_speed", "extra_current_used" : "0", "location_id" : "0x02343000 / 9", "manufacturer" : "LG Electronlcs Inc.", "product_id" : "0x9a68", "vendor_id" : "0x043e (LG Electronics USA Inc.)" } ], "_name" : "hub_device", "bcd_device" : "1.00", "bus_power" : "900", "bus_power_used" : "0", "device_speed" : "super_speed", "extra_current_used" : "0", "location_id" : "0x02340000 / 6", "product_id" : "0x9a71", "vendor_id" : "0x043e (LG Electronics USA Inc.)" } ], "_name" : "USB3.1 Hub", "bcd_device" : "52.50", "bus_power" : "900", "bus_power_used" : "0", "device_speed" : "super_speed", "extra_current_used" : "0", "location_id" : "0x02300000 / 2", "manufacturer" : "LG Electronics Inc.", "product_id" : "0x9a60", "vendor_id" : "0x043e (LG Electronics USA Inc.)" }, { "_items" : [ { "_items" : [ { "_name" : "J-Link", "bcd_device" : "1.00", "bus_power" : "500", "bus_power_used" : "100", "device_speed" : "high_speed", "extra_current_used" : "0", "location_id" : "0x02233000 / 20", "manufacturer" : "SEGGER", "product_id" : "0x0101", "serial_num" : "************", "vendor_id" : "0x1366" }, { "_name" : "Specialized TCU2", "bcd_device" : "1.00", "bus_power" : "500", "bus_power_used" : "500", "device_speed" : "full_speed", "extra_current_used" : "0", "location_id" : "0x02231000 / 23", "manufacturer" : "Specialized", "product_id" : "0x520c", "serial_num" : "************", "vendor_id" : "0x1915 (Nordic Semiconductor ASA)" }, { "_name" : "USB Billboard Device ", "bcd_device" : "0.01", "bus_power" : "500", "device_speed" : "high_speed", "extra_current_used" : "0", "location_id" : "0x02235000 / 12", "manufacturer" : "VIA Labs, Inc. ", "product_id" : "0x8817", "serial_num" : "****************", "vendor_id" : "0x2109 (VIA Labs, Inc.)" } ], "_name" : "USB2.0 Hub ", "bcd_device" : "4.53", "bus_power" : "500", "bus_power_used" : "0", "device_speed" : "high_speed", "extra_current_used" : "0", "location_id" : "0x02230000 / 5", "manufacturer" : "VIA Labs, Inc. ", "product_id" : "0x2817", "vendor_id" : "0x2109 (VIA Labs, Inc.)" }, { "_items" : [ { "_name" : "LG UltraFine Display Controls", "bcd_device" : "4.13", "bus_power" : "500", "bus_power_used" : "0", "device_speed" : "full_speed", "extra_current_used" : "0", "location_id" : "0x02242000 / 11", "manufacturer" : "LG Electronics Inc.", "product_id" : "0x9a70", "vendor_id" : "0x043e (LG Electronics USA Inc.)" }, { "_name" : "LG UltraFine Display Audio", "bcd_device" : "0.03", "bus_power" : "500", "bus_power_used" : "0", "device_speed" : "high_speed", "extra_current_used" : "0", "location_id" : "0x02241000 / 10", "manufacturer" : "LG Electronics Inc.", "product_id" : "0x9a66", "vendor_id" : "0x043e (LG Electronics USA Inc.)" } ], "_name" : "hub_device", "bcd_device" : "1.00", "bus_power" : "500", "bus_power_used" : "0", "device_speed" : "high_speed", "extra_current_used" : "0", "location_id" : "0x02240000 / 3", "product_id" : "0x9a73", "serial_num" : "************", "vendor_id" : "0x043e (LG Electronics USA Inc.)" } ], "_name" : "USB2.1 Hub", "bcd_device" : "52.50", "bus_power" : "500", "bus_power_used" : "100", "device_speed" : "high_speed", "extra_current_used" : "0", "location_id" : "0x02200000 / 1", "manufacturer" : "LG Electronics Inc.", "product_id" : "0x9a61", "vendor_id" : "0x043e (LG Electronics USA Inc.)" } ], "_name" : "USB31Bus", "host_controller" : "AppleUSBXHCITR", "pci_device" : "0x15f0 ", "pci_revision" : "0x0006 ", "pci_vendor" : "0x8086 " }, { "_items" : [ { "_name" : "Touch Bar Backlight", "bcd_device" : "2.01", "location_id" : "0x80700000", "manufacturer" : "Apple Inc.", "product_id" : "0x8102", "serial_num" : "****************", "vendor_id" : "apple_vendor_id" }, { "_name" : "Touch Bar Display", "bcd_device" : "2.01", "location_id" : "0x80600000", "manufacturer" : "Apple Inc.", "product_id" : "0x8302", "serial_num" : "****************", "vendor_id" : "apple_vendor_id" }, { "_name" : "Apple Internal Keyboard / Trackpad", "bcd_device" : "9.27", "location_id" : "0x80500000", "manufacturer" : "Apple Inc.", "product_id" : "0x027c", "serial_num" : "*********************", "vendor_id" : "apple_vendor_id" }, { "_name" : "Headset", "bcd_device" : "2.03", "location_id" : "0x80400000", "manufacturer" : "Apple", "product_id" : "0x8103", "serial_num" : "************", "vendor_id" : "apple_vendor_id" }, { "_name" : "Ambient Light Sensor", "bcd_device" : "2.01", "location_id" : "0x80300000", "manufacturer" : "Apple Inc.", "product_id" : "0x8262", "serial_num" : "************", "vendor_id" : "apple_vendor_id" }, { "_name" : "FaceTime HD Camera (Built-in)", "bcd_device" : "2.01", "location_id" : "0x80200000", "manufacturer" : "Apple Inc.", "product_id" : "0x8514", "serial_num" : "*****************", "vendor_id" : "apple_vendor_id" }, { "_name" : "Apple T2 Controller", "bcd_device" : "2.01", "location_id" : "0x80100000", "manufacturer" : "Apple Inc.", "product_id" : "0x8233", "serial_num" : "****************", "vendor_id" : "apple_vendor_id" } ], "_name" : "T2Bus", "host_controller" : "AppleUSBVHCIBCE" } ] } cyme-2.2.6/tests/integration_test.rs000066400000000000000000000105571506545537300175750ustar00rootroot00000000000000//! These test cyme CLI by reading from json but also output as json so that we can check without worrying about formatting //! //! It is slightly the dog wagging the tail but is as integration as it gets! Could improve by adding some tests for actual format like --block, --padding args etc mod common; #[test] fn test_run() { let te = common::TestEnv::new(); // just run and check it doesn't exit with error without --from-json arg te.assert_success_and_get_output(None, &[]); } #[test] #[cfg(target_os = "macos")] fn test_run_force_libusb() { let te = common::TestEnv::new(); // just run and check it doesn't exit with error without --from-json arg te.assert_success_and_get_output(None, &["--force-libusb"]); } #[test] fn test_list() { let te = common::TestEnv::new(); let mut comp_sp = common::sp_data_from_libusb_linux(); comp_sp.into_flattened(); let devices = comp_sp.flattened_devices(); let comp = serde_json::to_string_pretty(&devices).unwrap(); // TODO not sure why assert_output_json doesn't work, might help to have module which shows diff te.assert_output( Some(common::CYME_LIBUSB_LINUX_TREE_DUMP), &["--json"], &comp, false, ); } #[test] fn test_list_filtering() { let te = common::TestEnv::new(); let mut comp_sp = common::sp_data_from_libusb_linux(); let filter = cyme::profiler::Filter { name: Some("Black Magic".into()), no_exclude_root_hub: true, ..Default::default() }; comp_sp.into_flattened(); let mut devices = comp_sp.flattened_devices(); filter.retain_flattened_devices_ref(&mut devices); let comp = serde_json::to_string_pretty(&devices).unwrap(); te.assert_output( Some(common::CYME_LIBUSB_LINUX_TREE_DUMP), &["--json", "--filter-name", "Black Magic"], &comp, false, ); te.assert_output( Some(common::CYME_LIBUSB_LINUX_TREE_DUMP), &["--json", "--vidpid", "1d50"], &comp, false, ); te.assert_output( Some(common::CYME_LIBUSB_LINUX_TREE_DUMP), &["--json", "--vidpid", "1d50:6018"], &comp, false, ); te.assert_failure( Some(common::CYME_LIBUSB_LINUX_TREE_DUMP), &["--json", "--vidpid", "1d50:unhappy"], ); te.assert_output( Some(common::CYME_LIBUSB_LINUX_TREE_DUMP), &["--json", "--filter-serial", "97B6A11D"], &comp, false, ); let mut comp_sp = common::sp_data_from_libusb_linux(); let mut filter = cyme::profiler::Filter { bus: Some(2), no_exclude_root_hub: true, ..Default::default() }; comp_sp.into_flattened(); let mut devices = comp_sp.flattened_devices(); filter.retain_flattened_devices_ref(&mut devices); let comp = serde_json::to_string_pretty(&devices).unwrap(); te.assert_output( Some(common::CYME_LIBUSB_LINUX_TREE_DUMP), &["--json", "--show", "2:"], &comp, false, ); te.assert_failure( Some(common::CYME_LIBUSB_LINUX_TREE_DUMP), &["--json", "--show", "f"], ); filter.number = Some(23); filter.retain_flattened_devices_ref(&mut devices); let comp = serde_json::to_string_pretty(&devices).unwrap(); te.assert_output( Some(common::CYME_LIBUSB_LINUX_TREE_DUMP), &["--json", "--show", "2:23"], &comp, false, ); te.assert_failure( Some(common::CYME_LIBUSB_LINUX_TREE_DUMP), &["--json", "--show", "blah"], ); } #[test] // windows line ending messes this up #[cfg(not(target_os = "windows"))] fn test_tree() { let te = common::TestEnv::new(); let comp = common::read_dump_to_string(common::CYME_LIBUSB_LINUX_TREE_DUMP); te.assert_output_json( Some(common::CYME_LIBUSB_LINUX_TREE_DUMP), &["--json", "--tree"], &comp, ); } #[test] fn test_tree_filtering() { let te = common::TestEnv::new(); let mut comp_sp = common::sp_data_from_libusb_linux(); let filter = cyme::profiler::Filter { name: Some("Black Magic".into()), ..Default::default() }; filter.retain_buses(&mut comp_sp.buses); let comp = serde_json::to_string_pretty(&comp_sp).unwrap(); te.assert_output( Some(common::CYME_LIBUSB_LINUX_TREE_DUMP), &["--json", "--tree", "--vidpid", "1d50"], &comp, false, ); } cyme-2.2.6/tests/integration_test_lsusb_display.rs000066400000000000000000000104671506545537300225320ustar00rootroot00000000000000mod common; /// Tests lsusb with no args compatibility mode #[test] fn test_lsusb_list() { let te = common::TestEnv::new(); let comp = common::read_dump_to_string(common::LSUSB_OUTPUT); te.assert_output( Some(common::CYME_LIBUSB_LINUX_TREE_DUMP), &["--lsusb"], comp.as_str(), false, ); } /// Tests lsusb --tree compatibility mode #[test] fn test_lsusb_tree() { let te = common::TestEnv::new(); let comp = common::read_dump_to_string(common::LSUSB_TREE_OUTPUT); te.assert_output( Some(common::CYME_LIBUSB_LINUX_TREE_DUMP), &["--lsusb", "--tree"], comp.as_str(), false, ); } /// Tests lsusb --tree fully verbose compatibility mode #[test] fn test_lsusb_tree_verbose() { let te = common::TestEnv::new(); let comp = common::read_dump_to_string(common::LSUSB_TREE_OUTPUT_VERBOSE); te.assert_output( Some(common::CYME_LIBUSB_LINUX_TREE_DUMP), &["--lsusb", "--tree", "-vvv"], comp.as_str(), false, ); } /// Tests lsusb -d vidpid filter #[test] fn test_lsusb_vidpid() { let te = common::TestEnv::new(); te.assert_output( Some(common::CYME_LIBUSB_LINUX_TREE_DUMP), &["--lsusb", "--vidpid", "1d50"], "Bus 002 Device 024: ID 1d50:6018 OpenMoko, Inc. Black Magic Debug Probe (Application)", false, ); te.assert_output( Some(common::CYME_LIBUSB_LINUX_TREE_DUMP), &["--lsusb", "--vidpid", "1d50:"], "Bus 002 Device 024: ID 1d50:6018 OpenMoko, Inc. Black Magic Debug Probe (Application)", false, ); te.assert_output( Some(common::CYME_LIBUSB_LINUX_TREE_DUMP), &["--lsusb", "--vidpid", "1d50:6018"], "Bus 002 Device 024: ID 1d50:6018 OpenMoko, Inc. Black Magic Debug Probe (Application)", false, ); te.assert_output( Some(common::CYME_LIBUSB_LINUX_TREE_DUMP), &["--lsusb", "--vidpid", "1d6b:"], r#"Bus 001 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub Bus 002 Device 001: ID 1d6b:0001 Linux Foundation 1.1 root hub Bus 003 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub Bus 004 Device 001: ID 1d6b:0003 Linux Foundation 3.0 root hub"#, true, ); te.assert_failure( Some(common::CYME_LIBUSB_LINUX_TREE_DUMP), &["--lsusb", "--vidpid", "dfgdfg"], ); } /// Tests lsusb -s bus:devno filter #[test] fn test_lsusb_show() { let te = common::TestEnv::new(); te.assert_output( Some(common::CYME_LIBUSB_LINUX_TREE_DUMP), &["--lsusb", "--show", "24"], "Bus 002 Device 024: ID 1d50:6018 OpenMoko, Inc. Black Magic Debug Probe (Application)", false, ); te.assert_output( Some(common::CYME_LIBUSB_LINUX_TREE_DUMP), &["--lsusb", "--show", "2:24"], "Bus 002 Device 024: ID 1d50:6018 OpenMoko, Inc. Black Magic Debug Probe (Application)", false, ); te.assert_output( Some(common::CYME_LIBUSB_LINUX_TREE_DUMP), &["--lsusb", "--show", "2:"], r#"Bus 002 Device 022: ID 203a:fffe PARALLELS Virtual USB1.1 HUB Bus 002 Device 024: ID 1d50:6018 OpenMoko, Inc. Black Magic Debug Probe (Application) Bus 002 Device 023: ID 1366:1050 SEGGER J-Link Bus 002 Device 001: ID 1d6b:0001 Linux Foundation 1.1 root hub"#, false, ); te.assert_failure( Some(common::CYME_LIBUSB_LINUX_TREE_DUMP), &["--lsusb", "--show", "d"], ); } /// Only tests contains first line...full verbose is not exactly the same but too difficult to match! #[test] fn test_lsusb_device() { let te = common::TestEnv::new(); te.assert_output( Some(common::CYME_LIBUSB_LINUX_TREE_DUMP), &["--lsusb", "--device", "/dev/bus/usb/002/024"], "Bus 002 Device 024: ID 1d50:6018 OpenMoko, Inc. Black Magic Debug Probe (Application)", true, ); te.assert_output( Some(common::CYME_LIBUSB_LINUX_TREE_DUMP), &["--lsusb", "--device", "/dev/bus/usb/002/001"], "Bus 002 Device 001: ID 1d6b:0001 Linux Foundation 1.1 root hub", true, ); te.assert_failure( Some(common::CYME_LIBUSB_LINUX_TREE_DUMP), &["--lsusb", "--device", "/dev/blah/002/001"], ); te.assert_failure( Some(common::CYME_LIBUSB_LINUX_TREE_DUMP), &["--lsusb", "--device", "/dev/bus/usb/002"], ); }