Troubleshooting - Torrekie/Battman GitHub Wiki

Battman Error Handling and Troubleshooting

When Battman fails to open a connection to the Apple System Management Controller (SMC), it presents one of several error alerts. This page explains each failure case, its meaning, and how to resolve it.

1. IOMasterPort Open Failed

Alert Title: IOMainPort Open Failed Description: Battman could not acquire the IOMasterPort, a prerequisite for all SMC operations.

Possible Causes:

  • System API change or corruption
  • Unprivileged/Broken installation
  • Incompatible macOS/iOS version

Troubleshooting Steps:

  1. Verify your macOS/iOS version is supported by Battman.
  2. Reinstall and try again.
  3. Ensure Battman is installed correctly (see Installation Guide).

2. AppleSMC Unsupported

Alert Title: AppleSMC Unsupported Description: Your device does not expose an AppleSMC service. Battman requires AppleSMC to read and control power parameters.

Possible Causes:

  • Running on non-Apple hardware (hackintosh or unsupported Mac/iPhone model)
  • AppleSMC.kext not loaded
  • Device/OS without shipped AppleSMC.kext

Troubleshooting Steps:

  1. Confirm you are on supported Apple hardware.
  2. We cannot do anything if your hardware is not supported by AppleSMC.kext, please file a issue to let us know, which helps us to update the documentations.

3. AppleSMC Open Failed

Alert Title: AppleSMC Open Failed Description: Battman found the AppleSMC service but could not open it due to permission or entitlements issues.

Possible Causes:

  • Missing entitlements in app executable
  • Running an unsigned or improperly signed build of Battman

Troubleshooting Steps:

  1. Ensure Battman is installed correctly (see Installation Guide).

For further assistance, please open an issue.