Troubleshooting

Common connection and usage problems, and how to fix them.

Companion app can't find the device

Connecting fails with an error message

The companion app shows the Bluetooth error text below the Connect button. Include it in a bug report. These errors are common:

Bluetooth adapter is off / Bluetooth is disabled

Turn Bluetooth on for your phone and try again.

connection timed out

The device did not respond in time. Move closer, check that it is powered on, and retry.

connection cancelled

The connection attempt was interrupted, often by tapping a device in the list twice. Retry.

device not migrated

The device connected but does not support the companion app. Update its firmware.

bonding failed

Pairing itself was rejected. Forget the device from your phone's Bluetooth settings and try connecting again from scratch.

stale pairing could not be removed

The device lost its pairing, for example after a reflash, and the app could not remove the old one. Forget the device in your phone's Bluetooth settings, then connect again.

Device not appearing in Pokémon GO's pairing scan

Autospin or Autocatch isn't triggering

Frequent disconnects or slow responses

The device restarts on its own

Open the app and look for the Crash report card. Tap Share report and add it to a bug report. A weak power supply can also restart the device: try another cable or charger.

Pokémon GO will not connect while the app is open

The app lets go of the device when you switch away from it. Switch to Pokémon GO and connect there. Then open the app and connect again.

The app stopped reconnecting

After a dropped connection, the app tries again for about two minutes. If the device stays out of range or switched off for longer, the app gives up. Tap Scan and pick the device.

The pairing prompt still shows

Check these in order:

  1. The Skip the pairing prompt switch in the app is on. If it is off, turn it on and switch on PGP Companion pairing assistant in your phone's Accessibility settings.
  2. Your phone may block the setting. Open the app's info, tap the three dots, choose Allow restricted settings, then try again.
  3. Some phone brands word the prompt differently. The assistant may not recognize it. Tap Pair yourself. Pairing works the same.

No game alerts arrive

Check these in order:

  1. The Alert me about Pokémon GO switch in Settings is on.
  2. The app has notification access. Tap Notification access settings and switch the app on.
  3. In your phone's app settings, allow notifications for PGPemu.
  4. Pokémon GO shows its own notification while it is connected to the device. Allow it in your phone's settings.

After a Pokémon GO update, alerts can stop until the app is updated too.

The app says to update the device firmware

The device runs firmware older than the app supports. Reflash it over USB with the latest release, then connect the app again.

The app says to hold the board button

The device only accepts a firmware update after you allow it on the device itself. Hold the button on the board for 3 seconds, let go, then start the update again within 2 minutes. Holding it for 10 seconds or more forgets all pairings instead. Pokémon GO must not be connected to the device during an update.

Starting over from scratch

If the steps above do not fix a stuck device, tap Forget all pairings in the Danger zone. It erases every pairing and setting but keeps the device's identity. No phone handy? Hold the board button for 10 seconds while the device is on, and it does the same. Afterwards, remove the device from your phone's Bluetooth settings if it still shows up, then pair again.

As a last resort, Reset session secrets erases the device's identity too. The device stops working until you import your secrets file again from the app, as described in Set up a device with no secrets.

Still stuck?

Refresh the dumps in Diagnostics, tap Share report, and paste the result into a bug report.