Calico Download

From IPRE Wiki
Jump to: navigation, search

This page describes the downloading and running of the Calico Editor and Shell. The Calico IDE is a cross-platform environment for learning about computing. This is part of the Calico Project.

If you are using Calico with the Scribbler robot, please see Optional: Using Calico with Scribbler Robots below. Other robots can also be used. See Calico Myro for additional information.

Upgrade

Once you have installed Calico and it is running fine, you can check here for upgrades. Just unzip the Calico-*.zip file. Mac users who have already installed the Frameworks previously can use the the Calico*-mac.zip (not the -mac-all.zip).

If you are using a robot, you might need to upgrade the robot's software, too. See Firmware Upgrade for more details.

For a list of what has changed in newer versions, see Calico: Whats New.

Download and Install

Which operating system are you running?

Windows

To run Calico on Windows:

  1. Install Calico Software
    1. Go to http://myro.roboteducation.org/~dblank/download/?C=N;O=D;P=*-windows-all.zip
    2. Get the highest-numbered number that ends in "-windows-all.zip"
    3. Unzip it, and put the contents on, say, your desktop
  2. Start Calico
    1. In the folder Calico, run the file calico.bat

Macintosh

Also see these updated instructions on installing for Mac: http://calico-users.1054103.n5.nabble.com/Calico-users-Updated-instructions-for-Calico-on-El-Capitan-td5706851.html

To run Calico on the Mac:

  1. Install Mono 3
    1. Recommend installing Mono 3 from here: http://www.mono-project.com/download/
    2. Using the Mono Runtime Environment (MRE) should be fine
  2. Install Calico Software
    1. Go to http://myro.roboteducation.org/~dblank/download/?C=N;O=D;P=*-mac*.zip
    2. The first time you install Calico, get the highest-numbered X.Y.Z Calico-X.Y.X-mac-all.zip as it includes the Frameworks. Future updates you can get the Calico-X.Y.Z-mac.zip version (no "all") as you only need to install the Frameworks once.
    3. Unzip it, and put the contents on, say, your desktop
    4. Move the contents of the Calico/Frameworks folder to /Library/Frameworks/
      • In Mac OS X 10.8, you will have to go to the "Finder" menu, select "Preferences" and check the "Show these items on the desktop: Hard Disk" check box to be able to view your Macintosh HD on the desktop. Copy the SDL and Mono framework folders from the Calico/Frameworks folder into your Macintosh HD / Library / Frameworks folder.
      • Alternatively, in the terminal you can do this with a command such as: sudo cp -a Calico/Frameworks/* /Library/Frameworks/
  3. Note: You may have to change your security settings to allow programs downloaded from the web to run. Go to System settings-->Security and Privacy. Click the lock to make changes and then choose "Anywhere" under "Allow applications from . . ."
  4. Start Calico
    1. In the folder Calico, run the file calico.app

Linux

To run Calico on Linux:

  1. Install Mono
    1. Use your package manager to install Mono and other support packages:
      1. mono-complete espeak graphviz libsdl libsdl-mixer libsdl-image libsdl-sound
      2. You might also need a package called either: libmono-i18n2.0-cil (Debian/Ubuntu-based systems) or mono-locale-extras (RedHat/Fedora-based systems)
      3. Ubuntu 12.10: sudo apt-get install mono-complete espeak graphviz libmono-i18n2.0-cil libsdl-net1.2 libsdl-mixer1.2 libsdl-image1.2 libsdl-sound1.2 libtaoframework-sdl1.2-cil
      4. Ubuntu 16.04: sudo apt-get install mono-complete espeak graphviz mono-reference-assemblies-2.0 mono-devel libsdl-net1.2 libsdl-mixer1.2 libsdl-image1.2 libsdl-sound1.2 libtaoframework-sdl1.2-cil
      5. Developers will also need to install: libgtk2.0-cil-dev libglib2.0-cil-dev
  2. Install Calico Software
    1. Go to http://myro.roboteducation.org/~dblank/download/?C=N;O=D;P=*-linux.zip
    2. Get the highest-numbered number that ends in "-linux.zip".
    3. Unzip it, and put the contents on, say, your desktop
  3. Start Calico
    1. In the folder Calico, run the file ./calico

Optional: Using Calico with Scribbler Robots

Before using the robot, you need to make sure that the software (called "firmware") on the Scribbler robot and the IPRE Fluke is up to date. You can do that through the upgrade.py program found here: Firmware Upgrade.

One of the uses of Calico is to control a Scribbler or Scribbler2 robots with a Fluke control board over Bluetooth wireless. To do so, you will need to:

  1. Setup a bluetooth wireless connection between your computer and the Fluke control board
  2. Upgrade the robot and Fluke firmware If you have an older robot or Fluke, then you will need to upgrade their "firmware". Firmware is software that is loaded once onto a device, and remains persistent even when you turn the device off. Both the Fluke and the Scribbler/Scribbler2 have firmware.
  3. Start Calico, import the Myro library, and make your robot move


Students:
If your instructor has upgraded your scribbler & fluke board for you, then you should just see the Calico_Myro_for_Students page.


Windows XP Instructions


Windows 7 Instructions: Video

  • Setting up a bluetooth wireless connection on Windows 7 Video Tutorial
  • Installing and running the Firmware Upgrade tool on Windows 7 (including installing python, pyserial, and the upgrade tool as well as using it: Text Instructions and a Video Tutorial
    • Starting Calico, importing the Myro library, and make your robot move on Windows 7: Video Tutorial

Windows 7 Instructions: Text

  1. Turn on your robot (black switch on front of robot, turn from 0 to 1)
  2. Take the Bluetooth adaptor that is attached to your robot by velcro, and insert it into a USB slot on the front of your computer
  3. After a few seconds, click on the up-triangle at the bottom-right of your screen and then click on the Bluetooth symbol
  4. Select "Show Bluetooth Devices"
  5. Click the "Add a device" button
  6. Find the device id that matches the number on the sticker on the front of your robot, under "BetterBots" and click it (might look like "04B3")
  7. Click "Next", then "Close"
  8. In the Devices window, right-click on the new icon for your robot (eg, "Fluke2-04B3"), and select "Properties"
  9. Look in the "Services" tab, and remember the communication port (eg, "COM4")
  10. Installing and running the Firmware Upgrade tool on Windows 7 (including installing python, pyserial, and the upgrade tool as well as using it: Text Instructions and a Video Tutorial
    • Starting Calico, importing the Myro library, and make your robot move on Windows 7: Video Tutorial

Having Bluetooth Connection issues on Windows? Read the Known Bluetooth Problems page.



Mac OSX Instructions

  1. Attach the IPRE Fluke to the scribbler
  2. Turn on the scribbler
  3. Go to Bluetooth preferences in Setup
  4. New: (since OSX Mavericks)
    1. Click pair next to the Fluke- or IPRE- device
    2. That will connect briefly, then disconnect
    3. You now have a device named /dev/tty.Fluke2-XXXX-Fluke2 if you have a Fluke 2 or /dev/tty.IPRE-xxxxxx if you have a Fluke 1 (double-check the name in terminal)
  5. Old: (pre OSX Mavericks)
    1. Click on the bluetooth icon in the upper right of your toolbar, select "Set up Bluetooth Device"
    2. Follow the wizard, select "Any device" as the device type
    3. Select the IPRE-XXXXXX or Fluke2-XXXX where XXXXXX is your Fluke's serial number
    4. Enter the Passkey/PIN code (1234 for the fluke1, no PIN required for Fluke2)
    5. From the bluetooth menu in the toolbar select "Open Bluetooth Preference"
    6. Highlight the IPRE bluetooth connection name
    7. Select Edit Serial Ports (little gear picture)
      1. Add a serial port to the Fluke via the "+" button if you don't have one already
      2. If you already have a serial port listed, change the port name to "scribbler" all lowercase
      3. Click Apply
    8. Select Edit Serial Ports again
      1. Select the "Require pairing for security" button
      2. Click Apply
  6. You should now have a device like "/dev/tty.scribbler" that is the serial port to the scribbler. Confirm the actual name using the terminal application.


Linux Instructions

  • Follow the directions on Bluetooth setup on Linux
  • If you are getting "Permission Denied" error messages when attempting to access the bluetooth serial port, you may need to set up the default permissions on your rfcomm devices following these directions by Henry Walker.
  • There is a conflict between the Modem Manager and the Fluke that can cause problems connecting. Typically the symptoms involve failing to connect on the first attempt, but success on subsequent attempts. Follow these directions to address this issue.

Testing Your Robot Connection

  • Open Calico
  • In the shell, type:


    from Myro import *
    init("your port name") <--replace with the appropriate name for your port (COM# for Windows, /dev/tty.xxxxx for Mac, etc.)

Firmware Upgrade