Feature Request: Expose Device Setting and Network Mapping Internally #264

# /// script
# dependencies = [
#   "python_ics>=1!26.3",
# ]
# ///
from enum import Enum, IntEnum

import ics
from ics.structures.s_device_settings import s_device_settings
from ics.structures.e_device_settings_type import e_device_settings_type

setting_map = {
    e_device_settings_type.DeviceFire2SettingsType: "cyan",
    e_device_settings_type.DeviceRADGigastarSettingsType: "radgigastar",
    e_device_settings_type.DeviceRADMoon2SettingsType: "radmoon2",
    e_device_settings_type.DeviceVCAN412SettingsType: "vcan412",
    e_device_settings_type.DeviceFire3SettingsType: "fire3",
    e_device_settings_type.DeviceRed2SettingsType: "red2",
}

channel_order_b = (1, 8, *range(2, 8), *range(9, 17))

SettingMapA = Enum("SettingMap", [f"DWCAN_{channel:02}" for channel in range(1, 17)])
SettingMapB = IntEnum(
    "SettingMap", [f"DWCAN_{channel:02}" for channel in channel_order_b]
)

device_settings_to_netid_map = {
    ics.svcan412_settings.svcan412_settings: SettingMapA,
    ics.s_fire3_settings.s_fire3_settings: SettingMapB,
    ics.s_red2_settings.s_red2_settings: SettingMapA,
    ics.srad_gigastar_settings.srad_gigastar_settings: SettingMapB,
}


def get_device_specific_settings(s: s_device_settings) -> object:
    if s.DeviceSettingType not in setting_map:
        raise KeyError(
            f"Error: {s.DeviceSettingType} is not a known type in setting_map"
        )
    return getattr(s.Settings, setting_map[s.DeviceSettingType])


def main():
    devices = ics.find_devices()

    for device in devices:
        ics.open_device(device)
        print(
            f"Opened Device {device} (Open Client handles: {device.NumberOfClients})..."
        )
        try:
            print("Loading default settings...")
            ics.load_default_settings(device)

            print("Reading settings...")
            settings = ics.get_device_settings(device)
            device_specific_settings = get_device_specific_settings(settings)

            net_id_map = device_settings_to_netid_map.get(
                type(device_specific_settings), Enum("SettingMap", [])
            )


            # Trying to display TqSeg1 for DWCAN_02 and DWCAN_08
            for net_id in ("DWCAN_02", "DWCAN_08"):
                if net_id not in net_id_map.__members__:
                    print(f"{net_id} not found in net_id_map.")
                    continue

                channel_id = net_id_map[net_id].value
                channel_attr = f"can{channel_id}"

                if not hasattr(device_specific_settings, channel_attr):
                    print(f"{net_id} not found in device settings.")
                    continue

                channel_settings = getattr(device_specific_settings, channel_attr)
                print(f"{net_id} ({channel_attr}) TqSeg1: {channel_settings.TqSeg1}")

        finally:
            print(f"Closing Device {device}...")
            device.close()


if __name__ == "__main__":
    main()