General feedback for Misty II App and Overview pages

[mbdmbd]

For file https://github.com/MistyCommunity/Documentation/blob/master/src/content/tools-%26-apps/mobile/misty-app.md

Just letting you know the screen shots don't seem to match the current app version (e.g., The home screen shot at https://docs.mistyrobotics.com/tools-&-apps/mobile/misty-app/#getting-information-about-misty has a grid of buttons with WiFi info, forums, etc which don't show up on the iOS app as of writing this (9/7/19).

I'm in a hotel, and connecting to a password protected wifi network (not an open network, no captive portals) and when I connect Misty II to the network I am getting a dialog box that says

Wifi Network Mismatch
Your phone and Misty are currently on different wifi networks. Some app functions won't be available. Would you like to change Misty's wifi network?

I tried to change it a few times but keep getting the same dialog box, When I gave up and said 'no'. the IP address allocated to Misty II was on the same /24 subnet:

My phone:
IP: 10.43.0.200
Subnet: 255.255.255.0
Router: 10.43.0.1

Misty II:
IP 10.43.0.184

When I go into 'My Misty' in the app, I see Connectivity details, but no values for the fields under the 'Software' and 'Hardware' sections. I'm unsure why this is happening, but mentioning it here as I'm unsure if there is any need to mention this in the docs. Possibly more of a support issue. Feel free to have someone contact me if they want to try some more diagnostics to work it out.

Possibly related to number two above, following the steps at https://docs.mistyrobotics.com/tools-&-apps/mobile/misty-app/#updating-misty, I don't have an option in the Settings tab to update. The only options under the Misty section are 'Disconnect from Misty' and 'WiFi'.

---

For file https://github.com/MistyCommunity/Documentation/blob/master/src/content/misty-ii/robot/misty-ii.md

At https://docs.mistyrobotics.com/misty-ii/robot/misty-ii/#unpacking-your-misty-ii, when I was unpacking Misty II (and at points when I was looking underneath for the power switch, I found the head was heavy enough to swivel freely around. I wasn't (am not) sure if this is expected behaviour or not. If I hold Misty II by the base and turn it at a 30-45 degree angle, should the head be moving? If so, it might be worth mentioning that this is normal (and advise not to go too crazy shaking the robot)...

The docs at https://docs.mistyrobotics.com/misty-ii/robot/misty-ii/#wired-charging say

You can also charge Misty by plugging the power supply directly into the power port. Misty's power port is on the bottom of Misty, next to her power switch.

But, the barrel power connector is a different size and doesn't fit. It was suggested that I'm trying to plug in the wireless charger power supply, and that I probably don't have the standalone power supply, and that they are different barrel sizes on purpose because they are very different voltages. The guide suggests there is a "charging station AC power supply", and I received on AC adapter, so perhaps this should be explained.

At https://docs.mistyrobotics.com/misty-ii/robot/misty-ii/#wireless-charging step one instructs how to connect the AC adapter. When I received mine, it was already connected. Unsure what the norm here of it will vary, but might be worth noting.

When I placed Misty II on the wireless charging pad I didn't expect to hear fans whirr up. I've since been told that they will be on for as long as Misty is charging. It would probably be worth noting that after/around step five of https://docs.mistyrobotics.com/misty-ii/robot/misty-ii/#wireless-charging

Related to 2), but at at https://docs.mistyrobotics.com/misty-ii/robot/misty-ii/#wired-charging it indicates I can use the AC adapter to charge Misty II directly, when I can't with what was supplied. Some clarification might be needed if I am meant to buy/have a different AC adapter

At https://docs.mistyrobotics.com/misty-ii/robot/misty-ii/#hardware-notifications it talks about working out whether Misty II is charging or charged based on the mode of the orange LED. It would be nice to be have an idea how long charging should take. It would also be nice if there was some kind of indication (progress bar or percentage on Misty's eye display? How rapidly Misty blinks?)

I know this is pedantic, but when you asked for feedback I said I might be :).

The spelling of Wi-Fi is:

• "Wifi" in the app error (in the first section above where I was getting one)
• "WiFi" at https://docs.mistyrobotics.com/misty-ii/robot/misty-ii/#connectivity
• "Wi-Fi" at https://docs.mistyrobotics.com/misty-ii/robot/misty-ii/#connecting-to-wi-fi and throughout https://docs.mistyrobotics.com/tools-&-apps/mobile/misty-app/#connecting-misty-to-bluetooth-and-wi-fi

[johnathanDOS]

Great stuff, @mbdmbd - thanks for taking the time to provide such detailed feedback! I've addressed each point below, please let us know if you've additional questions or comments.

---

For file https://github.com/MistyCommunity/Documentation/blob/master/src/content/tools-%26-apps/mobile/misty-app.md

Just letting you know the screen shots don't seem to match the current app version

Thanks for catching this. We'll schedule time soon to sweep through and make sure all of these screenshots are up-to-date!

When I connect Misty II to the network I am getting a dialog box that says:

Wifi Network Mismatch
Your phone and Misty are currently on different wifi networks. Some app functions won't be available. Would you like to change Misty's wifi network?

The un-helpfulness of this alert is a known issue with the app 🙁 It's leftover from a time when the app used more Wi-Fi functionality (whereas now, most functionality between the robot and the app happens via bluetooth). We're looking at ways to improve the UX here, and should have an update for the app soon.

The only options under the Misty section are 'Disconnect from Misty' and 'WiFi'.

We'll look into this when we check through the screenshots, thank you!

---

For file https://github.com/MistyCommunity/Documentation/blob/master/src/content/misty-ii/robot/misty-ii.md

At https://docs.mistyrobotics.com/misty-ii/robot/misty-ii/#unpacking-your-misty-ii, when I was unpacking Misty II (and at points when I was looking underneath for the power switch, I found the head was heavy enough to swivel freely around. I wasn't (am not) sure if this is expected behaviour or not. If I hold Misty II by the base and turn it at a 30-45 degree angle, should the head be moving? If so, it might be worth mentioning that this is normal (and advise not to go too crazy shaking the robot)...

The robot's current functionality is such that Misty's head swivels freely unless you issue a command to move her head (which engages the pitch/roll/yaw motors in her neck and prevents the head from moving). You can "release" these motors by issuing a "Halt" command, which disengages the robot's motors. But as you said, it's not clear from the outset just how the robot's head should swivel by default, and what kind of motion is safe. I do think this is worth adding to our docs, will put a task in for it!

The docs at https://docs.mistyrobotics.com/misty-ii/robot/misty-ii/#wired-charging say

You can also charge Misty by plugging the power supply directly into the power port. Misty's power port is on the bottom of Misty, next to her power switch.

But, the barrel power connector is a different size and doesn't fit.

Regarding this and your other notes on the charging section, it looks like we failed to update this section with some of the changes from an earlier prototype version of Misty II. The information here is pretty important, and we've already made an update to the documentation to reflect the new default setup for the wireless charging station, and to warn readers that the chargers should not be used interchangeably. We've also added a note on the functionality of the fans during charging. Related to your comments here, can I ask, did your robot arrive with an extra AC adapter for charging Misty II, or did you just receive the one charger (for the wireless charging pad)?

At https://docs.mistyrobotics.com/misty-ii/robot/misty-ii/#hardware-notifications it talks about working out whether Misty II is charging or charged based on the mode of the orange LED. It would be nice to be have an idea how long charging should take. It would also be nice if there was some kind of indication (progress bar or percentage on Misty's eye display? How rapidly Misty blinks?)

Additional charging information / notifications would be helpful here. I'll pass on this suggestion to our product team. Feel free to post any insights like this to the Wishlist section of the Community Forums (I see you've already been active there!) -- I know our product team plans to review the comments there on a regular basis.

The spelling of Wi-Fi is:

"Wifi" in the app error (in the first section above where I was getting one)
"WiFi" at https://docs.mistyrobotics.com/misty-ii/robot/misty-ii/#connectivity
"Wi-Fi" at https://docs.mistyrobotics.com/misty-ii/robot/misty-ii/#connecting-to-wi-fi and throughout https://docs.mistyrobotics.com/tools-&-apps/mobile/misty-app/#connecting-misty-to-bluetooth-and-wi-fi

Love this level of detail! I believe we've fixed the inconsistencies in the docs, and I'll pass along a request to update the copy in the mobile app to reflect the conventions we've standardized around.

[mbdmbd]

Related to your comments here, can I ask, did your robot arrive with an extra AC adapter for charging Misty II, or did you just receive the one charger (for the wireless charging pad)?

I just received the one charger that was inserted into and used by the wireless charging pad. I’ve noticed today that I received a shipping notification for another AC adapter, so maybe that was you? If so, thanks!