Skip to content

Latest commit

 

History

History
125 lines (99 loc) · 7.05 KB

README.md

File metadata and controls

125 lines (99 loc) · 7.05 KB
Raw

Rasware2013

Description

This is a generic robotics library and demo project for the EK-LM4F120XL Stellaris Launchpad, built on top of Stellarisware. It is intended to be used for our 2013 Robotathon as well as general purpose robotics projects within our organization. Authored by the IEEE - Robotics and Automation Society Student Branch at the University of Texas at Austin. For documentation, see Rasware2013's Github wiki.

Robotathon Setup Instructions

Get started with Git

  1. Create a free GitHub account on github.com
  2. Follow GitHub's great instructions for installing Git on your computer.
  3. If you want to learn more about Git, you can read the GitPro book online for free (and legally, too!) at http://git-scm.com/book

Fork Rasware (only one Robotathon team member should do this step)

  1. Once logged into GitHub, go to ut-ras's Rasware2013.
  2. Fork the project's code through the button on the top right. This will copy the project to your own account.
  3. On the team's forked repository Github page, go to Settings->Collaborators and add each team member as a collaborator

The remainder of the instructions will depend on what type of system you're running.

Setup for Windows (WIP)

Install TortiseGIT

  1. Go to Google Code
  2. Download the correct architecture according to your machine (If you don't know, Right Click in My Computer, click Properties, and check wht System Type is)
  3. Run the executable with default values

Install Stellarisware

  1. Go to TI and create a new account.
  2. Go to TI, and download SW-LM3S-LM4F.exe.
  3. When complete, run the installer with the default installation paths.

Install Keil uVision

  1. Go to TI and download EK-TM4C123GXL-KEIL.exe.
  2. Extact the archive
  3. Navigate to Tools/Keil/ and run the installer.

Install drivers for the Launchpad

Note: for windows 8, the drivers are unsigned, so installing them requires you to activate special permissions. Basically follow this process: http://www.tabletroms.com/forums/visual-land-tablets/5894-how-install-unsigned-drivers-windows-8-a.html. (Or else the Device Manager just won't let you install drivers.)

  1. Plug in a Stellaris Launchpad to your computer with a usb cord.
  2. Windows should fail at installing divers.
  3. Go to the Device Manager on your computer. 4.For each listing with a yellow warning, right-click and select Update Driver.
  4. Click Browse my Computer and navigate to the unzipped archive folder.
  5. Once all of the drivers are installed, not the COM port number that appears in the Device manager. It should read Stellaris Virtual Serial Port (COM__).

Install PuTTY

  1. Go to http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html.
  2. Under "for Windows on Intel x86" click on putty.exe to save putty to your computer.

Download Code

  1. Choose a directory to work in
  2. Right click on directory, and select Git Clone
  3. Enter your forked repo's url, and press enter

Compile and run RASDemo

  1. Open Rasware2013/RASDemo/RASDemo.uvproj with Keil uVision. This is an example project we made to demostrate how to get a lot of useful peripherals working with the Launchpad, like motors and line sensors.
  2. With the Launchpad plugged into your computer, in Keil do Project->Build Target and then Flash->Download. This compiles and loads the project onto the Launchpad.
  3. Open PuTTY and connect to the board
    1. Click the "serial" radio button
    2. Under "serial line" type "COM#" where # was the COM port number shown in the Device Manager
    3. Under "speed" type "115200"
    4. Under "Saved Settings" type "Rasware2013" and then click "Save".
    5. Now the settings are saved in PuTTY. In the future, just open PuTTY and double click "Rasware2013" under "Saved Settings". [TODO: finish this section once RASDemo is done]

Starting your own project

[TODO: Make a starter project for RASLets to use?]

Committing code back to the repo

  1. While in the directory, right click and select Git Commit
  2. Write useful commit comments. See link. Your teammates will thank you.
  3. You will be promted to do a Git Push. Do so. At this point, you've only made changes to the repo on your machine. The Git Push uploads the changes to GitHub.
  4. If you need to log in, check with a mentor to resetup

Setup for Linux (WIP)

Install Git, Screen, OpenOCD

  • Archlinux : pacman -S git screen openocd
  • Ubuntu/Debian : apt-get install git screen openocd

Install Cross Compiler, Debugger

  • Archlinux : install from you favorite AUR wrapper, for example pak -S arm-none-eabi-gcc arm-none-eabi-gdb
  • Ubuntu/Debian : I don't use either of these Distro's so I would like someone else to help fill in this section (even if that just means donating there computer to me for a few hours).

Install Stellarisware

  1. Go to TI and create a new account.
  2. Go to TI, and download SW-LM3S-LM4F.exe.
  3. When complete, extract the "executable" with unzip. for example by running : unzip -d StellarisWare SW-LM3S-LM4F.exe
  4. Write down the path to StellarisWare
  5. Change the makedefs file in the StellairWare directory so that it uses the FPU.
    • Original line: 
      FPU=-mfpu=fpv4-sp-d16 -mfloat-abi=soft-fp
    • Replace with: 
      FPU=-mfpu=fpv4-sp-d16 -mfloat-abi=hard

Install drivers for the Launchpad

  1. copy the 75-lm4f.rules file to /etc/udev/rules.d (requires sudo)
  2. force a re-read of the udev rules by the udev daemon : udevadm control --reload (again, sudo required)
  3. plug in the Launchpad. you should now see the file /dev/lm4f appear.

Compile and run RASDemo

  1. modify the makefile variable 'SW_PATH' to point to the location of StellarisWare.
  2. run the command make uart from the RASDemo directory

Committing code back to the repo

  1. While in the directory, run git status.
  2. Now add at least one of the files marked as modified with git add.
  3. Run git commit to commit these changes.
  4. Write useful commit comments. See link. Your teammates will thank you.
  5. You should now run a git push to make your changes avalable through the GitHub.
  6. If you need to log in, check with a mentor to resetup