nixos/modules/hardware/usb-modeswitch.nix

   1 { config, lib, pkgs, ... }:
   2
   3 with lib;
   4
   5 {
   6   ###### interface
   7
   8   options = {
   9
  10     hardware.usb-modeswitch = {
  11       enable = mkOption {
  12         type = types.bool;
  13         default = false;
  14         description = lib.mdDoc ''
  15           Enable this option to support certain USB WLAN and WWAN adapters.
  16
  17           These network adapters initial present themselves as Flash Drives containing their drivers.
  18           This option enables automatic switching to the networking mode.
  19         '';
  20       };
  21     };
  22   };
  23
  24   ###### implementation
  25
  26   imports = [
  27     (mkRenamedOptionModule ["hardware" "usbWwan" ] ["hardware" "usb-modeswitch" ])
  28   ];
  29
  30   config = mkIf config.hardware.usb-modeswitch.enable {
  31     # Attaches device specific handlers.
  32     services.udev.packages = with pkgs; [ usb-modeswitch-data ];
  33
  34     # Triggered by udev, usb-modeswitch creates systemd services via a
  35     # template unit in the usb-modeswitch package.
  36     systemd.packages = with pkgs; [ usb-modeswitch ];
  37
  38     # The systemd service requires the usb-modeswitch-data. The
  39     # usb-modeswitch package intends to discover this via the
  40     # filesystem at /usr/share/usb_modeswitch, and merge it with user
  41     # configuration in /etc/usb_modeswitch.d. Configuring the correct
  42     # path in the package is difficult, as it would cause a cyclic
  43     # dependency.
  44     environment.etc."usb_modeswitch.d".source = "${pkgs.usb-modeswitch-data}/share/usb_modeswitch";
  45   };
  46 }