Skip to content

Latest commit

 

History

History
45 lines (31 loc) · 3.08 KB

README.md

File metadata and controls

45 lines (31 loc) · 3.08 KB

Behavior Based Robotics Platform for LEGO Mindstorms EV3 using ARM Assembly Language

History

The ev3dev-arm-bbr platform is inspired by nxos-armdebug, a bare-metal OS developed for the LEGO Mindstorms NXT platform. While it is not possible to port nxos-armdebug directly to ev3dev since the I/O driver model implemented for the Linux-based EV3 platform is so different, the goal of providing a structured software framework for exploring C and ARM Assembly Language programming on the EV3 platform remains the same. The I/O interfacing in ev3dev-arm-bbr is handled by the C-based ev3dev-c Library developed by Vitaly Kravtsov (in4lio).

nxos-armdebug itself was based on the NxOS project started by David Anderson and others, a from-the-ground-up development of a bare-metal OS for the NXT platform. ARM Assembly Language support was added to NxOS to simplify the programming and debugging of ARM Assembly programs by TC Wan and Nicholas Schodet.

Behavior Based Robotics

Behavior Based Robotics (BBR) is a concept introduced by Rodney Brooks and expanded upon to support robotic systems development using low complexity devices, such as the microcontrollers found in the EV3.

The book by Joseph L. Jones and Daniel Roth, Robot Programming: A practical guide to Behavior-Based Robotics, ISBN 0-07-142778-3, is a good introduction to the use of BBR for implementing actual robots. The BBR portion of ev3dev-arm-bbr implements the behavior/arbiter/actuator concepts to simplify the development of BBR-based robotic software.

Getting Started

To download ev3dev-arm-bbr, you will need to use the following command since there are submodules that are referenced by the main project:

$ git clone --recurse-submodules https://github.com/tcwan/ev3dev-arm-bbr

Updating dependent libraries

ev3dev-arm-bbr is dependent on the ev3dev-c library. In order to avoid breaking changes, updating of ev3dev-c is not automatic. To perform an update, the following steps must be taken:

In general, to sync with the upstream ev3dev-c and forget local modifications made to the submodule, you can just delete the submodule directory and retrieve it again.

[In ev3dev-arm-bbr top level directory]
$ rm -rf ev3dev-c       # Remove old submodule contents (WARNING: This will remove all locally modified files in the submodule)
$ scripts/updatelibs.sh # Retrieve clean instance of submodule from upstream

If you need to select a specific branch or commit for the ev3dev-c library, then do the following:

[In ev3dev-arm-bbr top level directory]
$ scripts/updatelibs.sh    # Retrieve updates to submodule from upstream
$ cd ev3dev-c
[Determine the latest commit from `git log`]
$ git checkout <commit id> # to select the latest commit for ev3dev-c
$ cd ..
$ git commit ev3dev-c      # to commit updated ev3dev-c module to project