OSKR Users - Robot Onboarding for Escape Pod

Vector Robot Configuration

Here we will learn how to use OSKR to point Vector to the Escape Pod.

Before continuing, please be familiar with the current Known Issues and Limitations. See Known Issues and Limitations

Basic Requirements:
-SSH Access to Vector (Note: Vector must be on OSKR firmware to continue.)
-Escape Pod Invitation Email
-Bluetooth-Equipped Laptop / Desktop PC
-Google Chrome Browser ( Note that Firefox or other browsers will not work. Chrome must be used.)

  1. License your Vector:
    1. Check your email for an Escape Pod license invitation. Use the linked form to submit your email address and serial number to Digital Dream Labs- please be sure to use the email address that your purchase was made with.
      1. Note: If using Gmail, be sure to check your Updates and Promotions tabs!
    2. You will receive an email with a text file that contains your license string.
    3. If you have not already done so, CLICK HERE to complete the setup for your Raspberry Pi- this will need to be done to continue in the process. You can continue through Steps 2 and 3 while waiting for your license string.
    4. Open a new tab in your browser and connect to https://escapepod.local:8443
    5. Click “Add A License To Start”
    6. Submit license code into the text box on the “Licenses” Screen, and click "Save".
  2. Install the required binaries
    1. SSH into your Vector and mount as read-write:
      $ mount -o remount rw /
    2. CREATE BACKUPS of existing vic-cloud and vic-gateway files in /anki/bin:
      $ mv /anki/bin/vic-cloud /anki/bin/vic-cloud.orig
      $ mv /anki/bin/vic-gateway /anki/bin/vic-gateway.orig
    3. From a command line window on your local computer, use scp to transfer the downloaded vic-cloud and vic-gateway files from your computer to Vector. If you do not have these, please check your email and you will find these links in the License Submission Form. We are going to transfer these from your PC into the /anki/bin directory on the robot. Be sure to start this process inside the local computer directory where the vic-cloud and vic-gateway files are stored, or provide an absolute path to vic-cloud and vic-gateway files:
      $ scp -i <SSH key path> vic-cloud root@<IP>:/anki/bin
      $ scp -i <SSH key path> vic-gateway root@<IP>:/anki/bin
      1. Note: Be sure to change "<SSH key path>" to the path where your Vector's SSH key is stored. Change "<IP>" to the internal IP address of your Vector robot.
    4. Switch back to the command line window inside Vector. Using SSH, set permissions and ownership of the files we just transferred to him:
      $ cd /anki/bin
      $ chown cloud:anki /anki/bin/vic-cloud
      $ chown net:anki /anki/bin/vic-gateway
      $ chmod 755 /anki/bin/vic-gateway
      $ chmod 755 /anki/bin/vic-cloud
  3. Replace existing server_config.json contents:
    1. Change directory to find the file: $ cd /anki/data/assets/cozmo_resources/config/
    2. Change permissions of the server_config.json file to enable editing: $ chmod u+w /anki/data/assets/cozmo_resources/config/server_config.json
    3. CREATE BACKUP of existing server_config.json: $ cp /anki/data/assets/cozmo_resources/config/server_config.json /anki/data/assets/cozmo_resources/config/server_config.json.orig
    4. Edit server_config.json to point to Escape Pod: $ nano /anki/data/assets/cozmo_resources/config/server_config.json
      The contents should be as follows:
      { "jdocs": "escapepod.local:8084", "tms": "escapepod.local:8084", "chipper": "escapepod.local:8084", "check": "escapepod.local:8080/ok", "logfiles": "s3://anki-device-logs-prod/victor", "appkey": "oDoa0quieSeir6goowai7f" }
    5. Use "Ctrl+X" to escape Nano and use "y" to save changes. When asked what name you want to give the file, press Enter to leave it as is.
  4. Perform Clear User Data:
    1. Place Vector on his Charger.
    2. Double tap his Back button.
    3. Gently lift his arm assembly all the way up, then lower it back down.
    4. Rotate one of his treads until “Clear User Data” is highlighted.
    5. Gently lift his arm assembly all the way up, then lower it back down.
    6. Confirm the wipe by rotating Vector's tread again to select "Confirm".
    7. Gently lift his arm assembly all the way up, then lower it back down.

      Vector will reboot and the ddl.io/v onboarding screen will appear.
  5. Roll through Vector-Web-Setup to finalize onboarding
    (Remember: You will need to use Google Chrome with a Bluetooth-supported PC for this step).
    1. Connect to https://escapepod.local:8443/ and click on “Onboarding” in the top right corner.
      1. Notes:
        1. Windows Users: You will encounter a certificate security error. This is normal and to be expected. Click "Advanced" and then click "Proceed to escapepod.local:8443" to continue.
        2. Mac Users: Security error is normal and to be expected. Click on a blank space in the page and type "thisisunsafe" and this site will be added to your safe sites list.
    2. With Vector on his Charger, double tap his back button.
    3. Click "Pair with Vector", then select the correct Vector name from the dialog box that appears.
    4. Set the desired settings, then click "Activate Your Robot!"
    5. Have fun! Submit feedback, including bugs, ideas, and suggestions to: escapepodbeta@digitaldreamlabs.com

Still need help? Contact Us Contact Us