Troubleshooting
Common connection and usage problems, and how to fix them.
Companion app can't find the device
- Make sure the device is powered on and its light is blinking. What the light patterns mean.
- Turn Bluetooth on for your phone, and grant the app's Bluetooth permission if you denied it earlier. When that is the problem, the app shows a message under the scan button, with a Turn on Bluetooth button or, after you chose "Don't ask again", an Open app settings button.
- Tap Scan again. The list fills only while a scan runs.
- Move closer. Bluetooth range shrinks through walls and at distance.
- Check that Advertising is on. With Advertising off, the device does not show up in a scan.
- If the device holds as many connections as its Max connections limit allows, it accepts no new one. Disconnect something first, or raise the limit from a connected client.
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
- Confirm that Advertising is on. The Settings tab and the Status card show it.
- Check that the device is not at its Max connections limit.
- Turn Bluetooth off and back on for your phone, and restart the Pokémon GO app.
- Some phones need Bluetooth scanning permission for Pokémon GO. Check its app permissions if the scan is empty.
Autospin or Autocatch isn't triggering
- Open Device profiles and confirm the SPIN or CATCH dot is lit for the profile that matches your connected Pokémon GO account.
- If your item bag is full, your Pokémon box is full, or you are out of Poké Balls, the device does not press the button for that action. Clear space or restock in the game. The device does not pause or resume on its own.
- Each account keeps its own setting. If you turned Autospin or Autocatch off for an account, it stays off when that account reconnects. Tap the dot to turn it back on. With CATCH new, the device presses only for Pokémon you have not caught yet, so it skips the others.
- If several accounts share the device, check that you toggle the profile of the right connection slot.
Frequent disconnects or slow responses
- Keep the device within Bluetooth range. Distance and obstructions are the most common cause.
- The Verbose log level slows the device. Switch back to Debug or Info when you finish diagnosing.
- Many connected phones can slow the device. Check Client states to see what is connected.
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:
- 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.
- Your phone may block the setting. Open the app's info, tap the three dots, choose Allow restricted settings, then try again.
- 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:
- The Alert me about Pokémon GO switch in Settings is on.
- The app has notification access. Tap Notification access settings and switch the app on.
- In your phone's app settings, allow notifications for PGPemu.
- 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.