Introduction

This repository supports the automatic transfer of code from Eclipse to the Link robot controller.

Defaults: (replace as appropriate for your system)

• 192.168.1.45 - the IP address of your Link
• DemoBot - a name for your robot
• *C:\tools\link_eclipse* - the location for your Tools directory

• OS X users might use /opt/tools/link_eclipse/
• ProTip: put the Tools directory in a place available to all users

Assumptions:

• You have Java installed
• You have Eclipse installed
• You have Python 2.7 installed (if using Python)
• You have the Eclipse PyDev plug-in installed (if using Python)
• You know how to open a terminal or cmd window
• You know how to open a text file and copy the contents into an Eclipse editor window

Download the Link_Eclipse Toolset

• In a browser, open http://github.com/kipr/link_eclipse
• On the right pane, click [Download ZIP]
• Save the file to a directory can find
• Open that directory and extract/unzip into C:\tools\

• If this worked correctly there should be files in C:\tools\link_eclipse-master\

• Rename C:\tools\link_eclipse-master\ to C:\tools\link_eclipse\

• (remove the -master from the end)

Note: Instructions are provided to install Link transfer software for both Java and Python. You do not need to install both, but using both in the same Eclipse instance is supported. The instructions for each are provided below and can be run without reference to each other.

Python Instructions

Setup Secure Shell (Only required the first time you connect to the Link)

• Open a terminal window
• Change directory to the Tools directory cd \tools\link_eclipse\
• Log into the Link putty -ssh root@192.168.1.45
• Accept the security certificate yes

Setup Eclipse

• Start Eclipse
• Click [Run -> External Tools -> External Tools Configurations...]
• Right click [Program -> New]
• Name: Send Python to DemoBot

• you can name it anything you want

• Location: C:\tools\link_eclipse\win_python.bat

• The [Browse File System...] button saves typing

• Working Directory: C:\tools\link_eclipse\

• Again the [Browse File System...] is your friend

• Arguments: 192.168.1.45 ${project_name} ${project_loc}

• don't change anything except the IP address!

• Click [Apply]
• Click [Close]

Setup the Project

• Click [File -> New -> Other...]
• Wizards: PyDev Project
• Click [Next]
• Project name: DemoBot
• Project type: [Python]
• Grammer Version: [2.7]
• Interpreter: [Default]
• Click radio button: [Create 'src' folder and add it to the PYTHONPATH]
• Click [Finish]

Add Kovan Library

• Click [Window - Preferences]
• Click [PyDev - Interpreters - Python Interpreter]
• In Libraries tab, click [New Folder]
• Browse to `C:\tools\link-eclipse\
• Click [Ok]
• Click [Ok]

Create main.py

• Expand [DemoBot] (in PyDev Package Explorer on left side of screen)
• Right click [src -> New -> PyDev Module]
• Package: (leave blank)

• Packages are currently not supported.

• Name: main

• (IMPORTANT: the python script you want to run first must be named main)

• Click [Finish]
• Template: [Empty]
• Click [Ok]

Populate main.py

• Copy the following code into the main.py window:

from kovan import msleep
from kovan import motor
from kovan import ao

import os
import sys

# set print to unbuffered
sys.stdout = os.fdopen(sys.stdout.fileno(),'w',0)

def main() :
    print "Starting...."
    testMotors()
    print "Finished"

def testMotors() :
    motor(1,100)
    motor(3,100)
    msleep(500)
    ao()


if __name__ == "__main__":
    main()

• Click [File - Save]

Test Download

• With the [main.py] window open
• Click [Run - External Tools - External Configurations...]
• In the left pane, click [Send Python to DemoBot]
• Click [Run]
• Look for the following transfer message in the console window

• main.py | 0 kB | 0.3 kB/s | ETA: 00:00:00 | 100%

• Launch your code on the Link [Programs - DemoBot - Run]

Java Instructions

Setup Secure Shell

• Open a terminal window
• Change directory to the Tools directory `cd \tools\link_eclipse\
• Log into the Link putty -ssh root@192.168.1.45
• Accept the security certificate yes

Setup Eclipse

• Start Eclipse
• Click [Run -> External Tools -> External Tools Configurations...]
• Right click [Program -> New]
• Name: Send Java to DemoBot
• Location: C:\tools\link_eclipse\java_win.bat
• Working Directory: C:\tools\link_eclipse\
• Arguments: 192.168.1.45 ${project_name} ${workspace_loc}${project_path}
• Click [Apply]
• Click [Close]

This needs work!!

Setup the Project

• Click [File -> New -> Other...]
• Wizards: PyDev Project
• Click [Next]
• Project name: DemoBot
• Click radio button: [Create 'src' folder and add it to the PYTHONPATH]
• Click [Finish]
• Click [Windows - Preferences]
• Click [PyDev - Interpreters - Python Interpreter]
• In Libraries tab, click [New Folder]
• Browse to Tools Directory
• Click [Ok]
• Click [Ok]
• Right click on the Project -> Properties
• Click on Java Build Path
• Click on Libraries
• Click Add External JARs...
• Set it to the provided libkovan.jar in the link_eclipse folder

Create main.py

• Expand [DemoBot] (in PyDev Package Explorer on left side of screen)
• Right click [src -> New -> PyDev Module]
• Package: (leave blank)
• Name: main

• (IMPORTANT: the python script you want to run first must be named main.py)

• Click [Finish]
• Click [Ok]
• Open [C:\tools\link_eclipse\example.py] and copy the contents into the Eclipse window

• ProTip: It might be easier copy this file from GitHub

Test Download

• With the [main.py] window open
• Click the [Run External Tool] button on the toolbar

• it is just to the right of the normal [Run] button

• Look for a one line transfer message in the console window