macOS serial bus controller.
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
include Add unformatted table header Jan 14, 2018
src Implement BASIC_LIST_HEADER Jan 14, 2018
tools Add 'make clean' workaround Dec 17, 2017
.gitignore Update .gitignore Dec 22, 2017
LICENSE Add license Dec 15, 2017
Makefile Add 'make clean' workaround Dec 17, 2017
README.md Update Examples section Jan 13, 2018

README.md

sbctl

sbctl is a macOS serial bus controller.

Installation

There are two installation methods: Homebrew and manual.

Homebrew

brew tap nickolasburr/pfa
brew install sbctl

Manual

make
make install

Commands

  • list, ls: List all known serial devices.
  • get, show: Get information about device.
  • set: Set, modify properties of device.
  • unset, rm: Remove properties of device.
  • [--]help: Show usage information.
  • [--]version: Show current release version.

Options

Options are command-specific and can be found via sbctl <COMMAND> [-h|--help].

Examples

List all known USB devices.

sbctl ls --usb

 ###   Spec   Mode   Type   Bus   Address   Port   Power [mA]   Speed [Mbps]   Serial Number   Device ID   Vendor   Product Description
 01    usb    usb    ---    029   000       ---    0            480            ---             000         Apple    Root Hub Simulation
 02    usb    usb    ---    026   000       ---    0            480            ---             000         Apple    Root Hub Simulation
 03    usb    usb    ---    029   001       01     500          480            ---             000         ---      ---
 04    usb    usb    ---    026   001       01     500          480            ---             000         ---      ---
 05    usb    usb    ---    029   002       08     500          480            ---             000         ---      ---
 06    usb    usb    ---    029   004       01     500          12             ---             016         Apple    BRCM20702 Hub
 07    usb    usb    ---    029   005       03     500          12             ---             048         Apple    Apple Internal Keyb
 08    usb    usb    ---    029   007       03     500          12             ---             019         Apple    Bluetooth USB Host
 09    usb    usb    ---    026   002       02     500          480            ---             000         ---      ---
 10    usb    usb    ---    026   003       01     500          480            ---             016         ---      ---
 11    usb    usb    ---    026   004       03     500          480            ---             048         ---      ---
 12    usb    usb    ---    026   005       02     500          480            ---             032         ---      ---
 13    usb    usb    ---    026   006       04     500          480            ---             064         ---      ---
 14    usb    usb    ---    026   007       02     500          480            000000000000    018         Apple    Keyboard Hub
 15    usb    usb    ---    026   008       03     500          12             KFV49920        019         Matrox   DualHead2Go SE
 16    usb    usb    ---    026   009       04     500          12             ---             052         Logite   USB Receiver
 17    usb    usb    ---    026   010       02     500          1.5            ---             018         Apple    Apple Keyboard
 18    usb    usb    ---    029   003       02     500          1.5            ---             032         Apple    IR Receiver

List all known devices with Thunderbolt support.

sbctl ls --thun

 ###   Spec   Mode   Type   Bus   Address   Port   Power [mA]   Speed [Mbps]   Serial Number   Device ID   Vendor   Product Description
 19    pci    thun   port   006   ---       06     ---          10000          ---             021         ---      Thunderbolt Native
 20    pci    thun   port   006   ---       01     ---          10000          ---             021         ---      Thunderbolt Port
 21    pci    thun   port   006   ---       03     ---          10000          ---             021         ---      Thunderbolt Port
 22    pci    thun   port   006   ---       01     ---          10000          ---             021         ---      Thunderbolt Port
 23    pci    thun   port   006   ---       02     ---          10000          ---             021         ---      Thunderbolt Port
 24    pci    thun   port   006   ---       04     ---          10000          ---             021         ---      Thunderbolt Port
 25    pci    thun   port   006   ---       06     ---          10000          ---             021         ---      PCIe Adapter
 26    pci    thun   port   006   ---       07     ---          10000          ---             021         ---      PCIe Adapter
 27    pci    thun   port   006   ---       08     ---          10000          ---             021         ---      PCIe Adapter
 28    pci    thun   port   006   ---       10     ---          10000          ---             021         ---      DP or HDMI Adapter
 29    pci    thun   port   006   ---       02     ---          10000          ---             021         ---      Thunderbolt Port
 30    pci    thun   port   006   ---       07     ---          10000          ---             021         ---      PCIe Adapter
 31    pci    thun   port   006   ---       08     ---          10000          ---             021         ---      PCIe Adapter
 32    pci    thun   port   006   ---       09     ---          10000          ---             021         ---      PCIe Adapter
 33    pci    thun   port   006   ---       10     ---          10000          ---             021         ---      PCIe Adapter
 34    pci    thun   port   006   ---       12     ---          10000          ---             021         ---      DP or HDMI Adapter
 35    pci    thun   port   006   ---       13     ---          10000          ---             021         ---      DP or HDMI Adapter
 36    pci    thun   brid   000   ---       ---    ---          ---            ---             ---         ---      pci8086,154
 37    pci    thun   brid   000   ---       ---    ---          ---            ---             ---         ---      pci-bridge
 38    pci    thun   brid   000   ---       ---    ---          ---            ---             ---         ---      display
 39    pci    thun   brid   000   ---       ---    ---          ---            ---             ---         ---      pci8086,1e31
 40    pci    thun   brid   000   ---       ---    ---          ---            ---             ---         ---      pci8086,1e3a
 41    pci    thun   brid   000   ---       ---    ---          ---            ---             ---         ---      pci8086,1e2d
 42    pci    thun   brid   000   ---       ---    ---          ---            ---             ---         ---      pci8086,1e20
 43    pci    thun   brid   000   ---       ---    ---          ---            ---             ---         ---      pci-bridge
 44    pci    thun   brid   000   ---       ---    ---          ---            ---             ---         ---      pci-bridge
 45    pci    thun   brid   000   ---       ---    ---          ---            ---             ---         ---      pci-bridge
 46    pci    thun   brid   000   ---       ---    ---          ---            ---             ---         ---      pci8086,1e26
 47    pci    thun   brid   000   ---       ---    ---          ---            ---             ---         ---      pci8086,1e03
 48    pci    thun   brid   000   ---       ---    ---          ---            ---             ---         ---      pci8086,1e22
 49    pci    thun   brid   001   ---       ---    ---          ---            ---             ---         ---      ethernet
 50    pci    thun   brid   000   ---       ---    ---          ---            ---             ---         ---      pci8086,1e57
 51    pci    thun   brid   002   ---       ---    ---          ---            ---             ---         ---      pci14e4,4331
 52    pci    thun   brid   003   ---       ---    ---          ---            ---             ---         ---      pci11c1,5901
 53    pci    thun   brid   001   ---       ---    ---          ---            ---             ---         ---      pci14e4,16bc
 54    pci    thun   brid   004   ---       ---    ---          ---            ---             ---         ---      pci-bridge
 55    pci    thun   brid   005   ---       ---    ---          ---            ---             ---         ---      pci-bridge
 56    pci    thun   brid   005   ---       ---    ---          ---            ---             ---         ---      pci-bridge
 57    pci    thun   brid   005   ---       ---    ---          ---            ---             ---         ---      pci-bridge
 58    pci    thun   brid   005   ---       ---    ---          ---            ---             ---         ---      pci-bridge
 59    pci    thun   brid   005   ---       ---    ---          ---            ---             ---         ---      pci-bridge
 60    pci    thun   brid   006   ---       ---    ---          ---            ---             ---         ---      pci8086,1513
 61    pci    thun   brid   191   ---       ---    ---          ---            ---             ---         ---      pci-bridge
 62    pci    thun   brid   192   ---       ---    ---          ---            ---             ---         ---      pci-bridge
 63    pci    thun   brid   192   ---       ---    ---          ---            ---             ---         ---      pci-bridge
 64    pci    thun   brid   192   ---       ---    ---          ---            ---             ---         ---      pci-bridge
 65    pci    thun   brid   193   ---       ---    ---          ---            ---             ---         ---      pci10de,fb9
 66    pci    thun   brid   193   ---       ---    ---          ---            ---             ---         ---      display
 67    pci    thun   swit   006   ---       06     ---          10000          ---             021         Apple    MacBook Pro
 68    pci    thun   swit   006   ---       03     ---          20000          ---             021         inXtr    AKiTiO Thunder 2 Bo

Get device at index 15

sbctl get %15

 DualHead2Go SE

 Spec: usb
 Mode: usb
 Type: ---

 Bus: 026
 Address: 008
 Port: 03
 Power: 500mA
 Speed: 12Mbps [Full]

 Serial: KFV49920
 Device ID: 19
 Vendor: Matrox