Robot Not a Dev? Pre-order Now
Not a Dev?

Misty Community Forum

2019.04.17 Release Notes

Welcome, Misty Developers!

We’re excited to announce the next system update for Misty I and Misty II robots. This update overhauls the endpoint structures and method names for many of the commands in Misty’s REST and on-robot JavaScript APIs to more accurately reflect the architecture and functionality of Misty’s API. After Misty updates, if your code uses the old version of an endpoint or a method name that has changed, you will need to update your code before it will work with Misty’s new software. We’ve shared a few resources that we hope will make it easier to update your skill code.

Other changes this release include the ability to store skill data that persists across reboots and system updates, improvements to Misty’s skill architecture and the skill upload process, an early version of Misty’s native obstacle avoidance system, and many other enhancements. See below for a comprehensive list of what’s new.

Additionally, Misty’s Companion App has been updated with improvements to the Wi-Fi connection process, changes to various styling and image elements, the removal of non-working mapping functionality, and other upgrades to ensure the app is compatible with Misty’s new REST endpoints. You should receive an email when you can download this update.


Note: Misty checks for updates each time she boots up. She must have a charged battery or be connected to power to successfully download and install the update.

Because this release is being delivered as an over-the-air ("OTA") update, Misty will automatically update herself sometime within the next 24 hours. You also have the option of checking to see if the update is available and initiating the process yourself via the 1.1.13.0 version of the API Explorer.

Important: Misty reboots once during a system update. All commands except Halt and Stop are disabled while Misty is updating. Please do not disconnect Misty from her power source until her eyes are fully open again.

As always, we look forward to your feedback!

Note: If you have issues with a system upgrade or need technical assistance for other reasons, for the quickest response you can:

  • Post a message to the Support category here in the Community forums. Mention @support with your post.
  • Post a message in MistyCommunity Slack in the technical_support channel.

Release Contents

  • Misty I
    • Window IoT Core OS: version 10.0.17134 or higher - No updates
    • Android OS: (7) No updates
    • Home Robot app: version 1.1.14.0
    • MC firmware: version 1.1.14.3
    • RT firmware: version 1.1.14.3
    • Sensory Service app: version 1.1.14.3
  • Misty II
    • Window IoT Core OS: version 10.0.17134 or higher - No updates
    • Android OS: (8) No updates
    • Home Robot app: version 2.0.3.0
    • MC firmware: version 2.0.3.5
    • RT firmware: version 2.0.3.5
    • Sensory Service app: version 2.0.3.5
  • Companion App - Updates (major changes listed)
    iOS v1.2.0 (1.2.1)
    Android v1.2.0 (1)
    • Removed mapping functionality
    • Updates for compatibility with API changes
    • Changes to Wi-Fi onboarding process
    • Various styling and image updates
  • Tools
    • Blockly: Updates for compatibility with API changes
    • API Explorer: Updates for compatibility with API changes
  • Misty Community GitHub: Updates for compatibility with API changes (forthcoming)
  • Misty Sample Skills GitHub: Updates for compatibility with API changes (forthcoming)
  • Docs (major changes listed)
    • Updated and restructured REST and On-Robot JavaScript API reference documentation to reflect API changes
    • New features documented
    • Updated tutorials for compatibility with API changes

New Features

  • Ability to configure data stored by on-robot skills to persist across reboots and system updates.
    • Use the misty.Set() method to store data and determine the long term storage rules for that data.
    • Define rules in a skill’s JSON meta file to determine how long data stored with the misty.Set() method should remain available after the skill is complete.
  • Ability to subscribe to the AudioPlayComplete data stream to execute callback functions when Misty finishes playing an audio file.
  • Ability to delete on-robot skills from Misty with the DeleteSkill command.
  • Ability to upload the image and audio assets used in your skill code in the same .zip file as your code and meta files.
    • Misty associates the images and audio assets you upload this way with the skill’s unique ID.
    • By default, these files are removed from Misty when you delete the skill from your robot.
  • Ability to remove a single face from the list of known faces (rather than clearing the entire list) with the ForgetFace command.

Bug Fixes & Improvements

  • The endpoint structures and method names for many commands in Misty’s REST and on-robot JavaScript APIs have been changed to more accurately reflect the design and functionality of Misty’s API. Several event names have also been changed.
  • Misty’s BatteryCharge, SelfState, and TimeOfFlight WebSocket data streams now include more (and more accurate) data.
  • A solution is now available for an issue where skills that use infinite loops continue to run in the background, even after timing out or being explicitly cancelled.
  • When you upload a skill, Misty now checks your files and throws an error if there are issues with the upload. See the documentation for a comprehensive list of the checks performed.
  • HTTP error responses now return as JSON objects.
  • Updated the firmware for the Occipital Structure Core Depth Sensor.
  • Improved reliability of communication between Misty’s headboard and CAN bus.
  • When a system update fails, Misty now displays a message on her screen with a prompt to contact support.
  • The SendExternalRequest command can now handle the video/mp4 return type.
  • Various improvements to the process for connecting to Wi-Fi through the Misty Companion App.
  • Non-working functionality (such as mapping) has been removed from the Companion App.
  • The API Explorer and Blockly have been updated to work with Misty’s modified WebSocket names and REST API endpoints.

New Known Issues

This list includes the new issues we know about related to this system update. For the list of all known issues with Misty’s software, see the Known Issues category.

Skill Management

  • There is an issue with the current software where Misty returns an error when you try to upload a skill .zip file that was created on a Mac. Additionally, Misty becomes unable to load or start skills after the failed upload attempt. Mac users can work around this issue by using an online file compression tool or using the terminal to create .zip files and preventing additional files from being created in the compressed folder.

Companion App

  • The app displays an error message incorrectly stating that Misty and the device are not on the same Wi-Fi network. This message can be safely ignored.
  • The Companion App crashes when logging in through Auth0 through Firefox web browsers on a mobile device.

Movement

  • There is an issue in the current software where Misty ignores the velocity values for head movement commands, and all head movement occurs at a single, unchangeable speed.

Battery

  • There is a known issue with some prototype robots where the system’s internal battery check returns incorrect values for the battery voltage and charging information. This can prevent an available system update from initiating.
1 Like

Looks good, Johnathan!

1 Like

Hello, Misty Developers!

We’ve discovered an issue with some prototype robots where the system’s internal battery check returns incorrect values for the battery voltage and charging information. This can prevent an available system update from initiating. If your robot does not automatically install the 4.17.19 system update, you can override battery checks and manually prompt an update by following these steps:

  1. Turn on your robot and connect it to power.
  2. Connect your robot to the 1.1.13.0 version of the Misty API Explorer and scroll to the section titled “System Updates”.
  3. Toggle the “Override Update & Battery Check” switch to the on position.
  4. Click “Perform System Update”.
1 Like