Skip to content

Commit

Permalink
feat(suite): more meaningful troubleshooting tips for unreadeble device
Browse files Browse the repository at this point in the history
  • Loading branch information
mroz22 committed Dec 2, 2024
1 parent 0205ed5 commit e024cd8
Showing 1 changed file with 13 additions and 10 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -120,16 +120,7 @@ export const DeviceUnreadable = ({ device }: DeviceUnreadableProps) => {
}

// generic troubleshooting tips
const items = [
// closing other apps and reloading should be the first step. Either we might have made a bug and let two apps to talk
// to device at the same time or there might be another application in the wild not really playing according to our rules
TROUBLESHOOTING_TIP_RECONNECT,
// if on web - try installing desktop. this takes you to using bridge which should be more powerful than WebUSB
TROUBLESHOOTING_TIP_SUITE_DESKTOP,
// unfortunately we have seen reports that even old bridge might not be enough for some Windows users. So the only chance
// is using another computer, or maybe it would be better to say another OS
TROUBLESHOOTING_TIP_DIFFERENT_COMPUTER,
];
const items = [];

// only for unreadable HID devices
if (
Expand All @@ -141,6 +132,10 @@ export const DeviceUnreadable = ({ device }: DeviceUnreadableProps) => {
// If even this did not work, go to support or knowledge base
// 'If the last time you updated your device firmware was in 2019 and earlier please follow instructions in <a>the knowledge base</a>',
items.push(TROUBLESHOOTING_TIP_UNREADABLE_HID);
// if on web - try installing desktop. this takes you to using bridge which should be more powerful than WebUSB.
// at the time of writing this, there is still an option to opt-in for legacy bridge in suite-desktop which can
// communicate with this device. see the next troubleshooting point
items.push(TROUBLESHOOTING_TIP_SUITE_DESKTOP);
// you might have a very old device which is no longer supported current bridge
// if on desktop - try toggling between the 2 bridges we have available
items.push(TROUBLESHOOTING_TIP_SUITE_DESKTOP_TOGGLE_BRIDGE);
Expand All @@ -149,6 +144,14 @@ export const DeviceUnreadable = ({ device }: DeviceUnreadableProps) => {
// this should be rather exceptional case that happens only when sessions synchronization is broken or other app
// is not cooperating with us
items.push(TROUBLESHOOTING_TIP_CLOSE_ALL_TABS);
// closing other apps and reloading should be the first step. Either we might have made a bug and let two apps to talk
// to device at the same time or there might be another application in the wild not really playing according to our rules
items.push(TROUBLESHOOTING_TIP_RECONNECT);
// if on web - try installing desktop. this takes you to using bridge which should be more powerful than WebUSB
items.push(TROUBLESHOOTING_TIP_SUITE_DESKTOP);
// unfortunately we have seen reports that even old bridge might not be enough for some Windows users. So the only chance
// is using another computer, or maybe it would be better to say another OS
items.push(TROUBLESHOOTING_TIP_DIFFERENT_COMPUTER);
}

return (
Expand Down

0 comments on commit e024cd8

Please sign in to comment.