Edbot

Support Template

System requirements

The Edbot Software was designed to run on a Windows PC or laptop.

To run the Edbot Software, your PC or laptop will need:

  • Microsoft Windows Vista/7/8/8.1/10

  • 1 GHz or faster 32-bit (x86) or 64-bit (x64) processor

  • 1 GB RAM (32-bit) or 2 GB RAM (64-bit)

  • 16 GB available hard disk space (32-bit) or 20 GB (64-bit)

  • DirectX 9 graphics device with WDDM 1.0 or higher driver

To set up an Edbot server you will additionally require:

  • Internet access for initial Edbot activation

  • Bluetooth connectivity

  • Your product key

Software download

Edbot Software

Visit the Edbot support site to download the latest version of the Edbot Software:

Programming languages

Download and install the programming languages you've chosen to use with your Edbot.

Scratch 2

The Edbot Software works with both the online and offline versions of Scratch 2. Please note we provide multi-lingual Edbot block translations. !!!!LINK!!!! However these can only be installed in the offline version. Scratch 2 offline can be downloaded from:

Python 3

We provide an Edbot module for use with Python 3. Download the Python 3 Windows installer for your architecture from:

When you run the installer make sure you install pip, the Python installer and select the option to configure the PATH variable.

The Edbot Python module requires the ws4py package. More information on ws4py can be found here:

Install ws4py after the Python installation has completed by opening a command prompt and typing:

> pip install ws4py

Technical information

Edbot server

An Edbot connects to a Bluetooth enabled computer. The Edbot Software running on this computer is configured as a server. This server can support multiple Edbots. You can configure more than one Edbot server on a network, but each Edbot should be connected to one and only one server.

As a server the Edbot Software:

  • Connects to Edbots - it connects to any number of Edbots using a Bluetooth wireless connection.

  • Handles requests - it handles requests from your program to control each connected Edbot.

  • Controls access - it assigns control of each connected Ebot to the selected client.

Edbot client

The Edbot Software automatically runs in client mode looking for Edbot servers on the network. This is true whether the software is configured as an Edbot server or not. This mode is specifically designed to forward Scratch requests to the Edbot server. You should run the Edbot Software on all computers where Scratch is used. If you aren't using Scratch then you only need to run an Edbot server.

Licensing

You will receive your product key via email from Robots in Schools when you purchase your Edbot.

After successful activation, the product key is permanently associated with that specific Edbot.

The same product key can be used on a different computer on a different network with the same Edbot. This flexible licensing approach allows the Edbot to be used in different locations.

Example setups

See topology diagrams below for more information.

Edbot architecture

The Edbot Software is a client/server application developed using Java. The main components are:

  • Main control window - provides a list of configured and discovered Edbots and a message pane.

  • Server setup window - used to configure an Edbot server which handles API and plugin requests.

  • Plugins window - used to configure languages such as Scratch which are unable to use the Edbot API.

See architecture diagram below for more information.

  • + *

Network settings

Port Numbers

Edbot clients connect to the Edbot server via a system service port number. The default for HTTP is TCP/IP port number 8080. This works for standard client/server networks. However, if your network setup requires an alternative port number for the Edbot service, the Edbot server port number is edited in:

Edbot server >App > Server Setup > Settings.

See example screen shot below.

Firewalls

If your network is operating a firewall, it may have closed or restricted access to system service ports to increase network security. The Edbot service requires the permission to accept incoming requests from client computers. To grant permission the system service port must be opened.

To do this go to the Ports and Services section in your firewall application and add Edbot server as a system service with the TCP/IP port number set in Server Port.

Install Edbot Software

Install Edbot Software on all computers that will access your Edbot.

After downloading the latest version of Edbot, run the installation program and follow the on screen instructions to install Edbot on your computer.

Network installation

If installing across a network, depending on your setup, you may be able to run an unattended software install using the following setup command line parameters:

*/SP /verysilent *

The installation does not require a restart.

Enter [Edbot installation program name] /? at the command line for more help.

Upon launch, the Edbot Software will scan for Edbot robots and Edbot clients and display results in the Messages pane at the bottom of the window. See example screen shot below.

Install programming languages

Install the programming languages you plan to use, for example, Scratch or Python, on all computers that will access your Edbot. This provides the tools and libraries to write programs.

Connect your Edbot robot to the Edbot server

Connect Edbot via Bluetooth

To do this, your Edbot server will need to have Bluetooth enabled. Some computers, such as laptops have Bluetooth built in. If your computer is not Bluetooth enabled, you can plug a USB Bluetooth adapter into the USB port on your computer.

Turn on and login to the Edbot server computer.

Turn on your Edbot robot using the on/off toggle switch located at the back of the shoulder area. At initial start-up all Edbot’s servo LEDs will flash red once and its Bluetooth LED, located in the shoulder area, will blink blue continuously. Your Edbot is now discoverable to Bluetooth devices.

On a Windows 7 computer select the Start > Control Panel > Hardware and Sound > *Device Manager. *

Locate Bluetooth in the list of devices and right click.

On the dropdown menu click Enable and close Device Manager.

Select the Start > Control Panel > Hardware and Sound > Add a Device.

Select ROBOTIS BT-210 and click Next.

The ROBOTIS BT-210 will need to be paired with your computer, this means you need to enter a four digit code to connect.

Click Pair and enter the passcode 0000.

Click Next.

Your Edbot will be listed as ROBOTIS BT-210 Paired.

Your computer and Edbot will usually automatically connect anytime the two devices are in range of each other with Bluetooth turned on.

When successfully connected the flashing blue LED on Edbot will change to steady blue LED. If your Edbot does not connect automatically see Section 8 Troubleshooting.

Name your Edbot

During the configuration you will be asked to name your new Edbot. Choose the name carefully because it will be its name for life. The name you choose will be encrypted and linked to all the programmes written for your Edbot – like a finger print!

There is no limit to the length of the name, however, a short name (less than 10 characters) is recommended. You could name your Edbot after a famous character, make up an acronym based on your school name or take inspiration from Roald Dahl and make up a new word, use your imagination and have fun with this. To get you thinking, here are the names of some famous robotic characters:

  • Wall-E (Waste Allocator Load Lifter – Earth class)

  • R2-D2 (Robotic 2nd generation Droid series 2)

Or more humanoid robots like

  • C-3PO

  • Data from Start Trek

Configure your Edbot

On the Edbot server double click on the Edbot icon on the desktop to start the application.

On the Edbot server turn on Bluetooth.

Take your Edbot out of its protective case and turn on. Lie your Edbot flat.

Your Edbot will connect via Bluetooth automatically.

Select App > Server Setup…

Your Edbot should be listed by its unique MAC address.

Click the Configure… button and follow the instructions to activate your Edbot.

Carefully enter your chosen name for your Edbot. Take care to check for spelling mistakes – remember this will be your Edbot’s name for life. Click OK to complete the configuration.

Your Edbot will be listed by its name.

Click Apply to save the Server Setup settings.

Start Programming

Turn on and login to the Edbot server computer, in a classroom setting turn on all student computers and log in.

On the Edbot server computer turn on Bluetooth.

Take your Edbot out of its protective case and turn on. Lie your Edbot flat.

Your Edbot will connect via Bluetooth automatically.

Start the Edbot server

On the Edbot server computer double click on the Edbot icon on the desktop to start the Edbot Software. It will scan your computer for Edbot robots and connect. See example screen below.

Your Edbot will be listed. Now Edbot’s joints will be active and ready to receive programmed commands. This means Edbot will stand by itself. In this state, lift your Edbot by the head and stand on its feet on a flat surface.

Give students access to Edbot

On the student computers double click on the Edbot icon on the desktop to start the Edbot Software. The Edbot server software will automatically scan the network and find the student computers.

The computer that is currently controlling your Edbot will be displayed next to your Edbot name. Click on the arrow next to the computer name to open the drop-down box listing all the student computers available.

If your Edbot or a student computer is not listed click the Scan button .

To change control to a different computer, simply select another name from the drop-down list. With access to Edbot the student can run their program and the instructions will be sent directly to Edbot, which will perform the student programmed motions.

If any student computers are missing from the list, check that they are logged into the network correctly and are running the Edbot Software.

For detailed information about programming your Edbot with Scratch see the Programming your Edbot with Scratch manual.

For detailed information about programming your Edbot with Python see the Programming your Edbot with Python manual.

Troubleshooting

Start-up LEDs not flashing – check batteries

Servo motors with a steady red LED on start-up – this indicates a problem with the servo motor. Turn the Edbot off, when the servo motors have become passive, gently manipulate the affected servo back and forth, and turn on again. If the servo motor still has a steady red LED on start-up repeat the process, turn the Edbot off, remove the batteries, gently manipulate the affected servo back and forth, refit the batteries and turn on again. This should clear the issue, if the problem persists report it to Robots in Schools Ltd.

Edbot not connecting to Edbot server via Bluetooth – check the following settings:

  • Check Edbot server has Bluetooth connectivity turned on.

  • Check Edbot is turned on and blue LED is flashing.

  • Check Edbot is within Bluetooth transmission range of 10 metres (30 feet).

  • Run a scan for Bluetooth devices.

  • If Bluetooth on Edbot server requests a pairing code, enter 0000.

Glossary

Word/phrase Definition

Bluetooth

Bluetooth is a way of exchanging data wirelessly over short distances using radio transmissions.

C++

A free, compiled, object oriented programming language. An intermediate level language, as it encapsulates both high and low level language features.

Client/server

A network design in which each computer or process on the network is either a client or a server. Servers are powerful computers or processes dedicated to managing tasks and services. Clients are less powerful computers or processes that request services from the server.

Edbot

Robotis mini robot

Edbot Software

Application used on both Edbot Server and Edbot Client that has three main functions: connects to Edbots using Bluetooth, transfers programs to Edbots, and controls client access to Edbots.

Edbot Client

A computer running the Edbot Software with NO Edbot robots connected via Bluetooth.

Edbot Server

A computer running the Edbot Software AND connected to one or more Edbot robots via Bluetooth.

Includes the facility to allocate access to Edbot Clients to send programs to an Edbot robot.

Java

A free, compiled, object-oriented programming language. Designed for the internet to help users interact with Web pages, it runs in a virtual environment which means it can run on any operating system.

Mac address

The media access control address (MAC address) of a computer is a unique identifier assigned to network interfaces for communications.

Off-Line Programming

A programming method where the task program is defined on devices or computers separate from the robot for later input of programming information to the robot.

On-Line Programming

A means of programming a robot while the robot is functioning. This becomes important in manufacturing and assembly line production due to keeping productivity high while the robot is being programmed for other tasks.

Program

A sequence of instructions that causes action from a computer or system controller.

Programmable Robot

A feature that allows a robot to be instructed to perform a sequence of steps and then to perform this sequence in a repetitive manner. It can then be reprogrammed to perform a different sequence of steps if desired.

Python

A free, interpreted, object-oriented programming language. Python is said to be easy to learn because of its clear syntax and readability.

Robot

A re-programmable, multifunctional device designed to move through variable programmed motions for the performance of a variety of tasks. Common elements which make up a robot are: microcontroller, servo motors, and sensors.

Scratch

A free educational programming language, designed to be fun and easy to learn. It is designed for an age range of 8 – 16. Users create programs by dragging blocks of code and attaching them to other blocks like a jigsaw puzzle.

Student

School student minimum age 6 (UK school year 5)

Wireless

Device communications in which electromagnetic waves (rather than some form of wire) carry the signal over part or all of the communication path.



Edbot is a registered trademark of Robots in Schools Ltd.
Copyright © Robots in Schools Ltd. All rights reserved.