Friday, October 30, 2015

Working on the iRis project

Here a step-by-step guide to work on git for the iRis project.
If you are new on git and github, read this article first.

The iRis project is on github, so if somebody wants to join it, or just follow the progress, can clone the git repo for iRis.

Let start from the link for the iRis github, that is Public :

Clone iRis

Use git to clone the iRis project, with the command :

  • git clone
That's it !
On your directory, will exist a directory called iRis, containing the code for iRis.

Update iRis

Now that you have iRis on your machine, to keep iRis updated is even easier.
Simply go in the iRis directory and issue the command : git pull

  • cd ~/SteveProjects/iRis
  • git pull
That's it !  If the code on the github is changed, it will be updated on your machine

Working on iRis

Compiling iRis

The code for iRis is developed using GCC for the MSP430.
In order to compile it is necessary to install on the machine the MSP430 Gcc cross compiler.

Once installed the compiler, simply go in the directory iRis and issue :

make clean; make

Testing iRis

In order to test iRis is necessary to have a MSP430 Launchpad, a MSP430g2452 and a interface board.
Connect the board via USB.

Open a terminal, go in the iRis directory and issue the command:

sudo mspdebug rf2500

If everything is OK, the board is recognized.
If so, load the program in the MSP430:

prog iris.elf

then start it with:


Commit iRis

If you want to collaborate to iRis, you can modify the code on your machine, and keep track of the modifications locally, using git.
Issuing the command git status returns the status of the modifications made to the code.

Every time you modify a file, git status will indicate a modification.
Every time you will have to add it with:

git add file_name

git add * will add all the modified files.

Then it will be possible to commit the file with:

git commit file_name

All these operations are LOCAL to your machine !

If you are a registered collaborator to the iRis project, then you should be able to "push" your modifications in the github:

git push

No comments:

Post a Comment