File	Date	Author	Commit
bin	2010-09-14	Peter A. Bigot	[c127b2] Merge branches 'pab/iid', 'pab/ula', 'pab/odira...
cc430demos	2010-07-18	Peter A. Bigot	[ecd8b0] Merge remote branch 'dmm/dmm/bsl' into next
etc	2010-02-19	Peter A. Bigot	[c33caa] Merge remote branch 'old/pab/cc430' into pab/cc430
include	2010-10-02	Peter A. Bigot	[b62f63] Merge branch 'pab/version' into pu
lib	2010-05-03	Peter A. Bigot	[0957bd] Remove local copy of standard pyserial package
schemas	2010-10-02	Peter A. Bigot	[b62f63] Merge branch 'pab/version' into pu
tinyos	2010-10-02	Peter A. Bigot	[b62f63] Merge branch 'pab/version' into pu
.gitignore	2010-09-06	Peter A. Bigot	[cf6649] Remove outdated script; ignore output from unit...
COPYRIGHT	2010-02-19	Peter A. Bigot	[c33caa] Merge remote branch 'old/pab/cc430' into pab/cc430
README	2010-05-01	Peter A. Bigot	[659fc3] Merge remote branch 'sf/dmm/ds1825' into pu2
RELEASES.txt	2010-10-03	Peter A. Bigot	[fb6ec8] Update version numbers
VERSION	2010-10-02	Peter A. Bigot	[b62f63] Merge branch 'pab/version' into pu

Read Me

OSIAN - Open Source IPv6 Automation Network
===========================================

See http://www.openosian.net/

OSIAN is a companion to TinyOS.  With OSIAN installed in /opt/osian and
given a working TinyOS environment, run the following commands to add OSIAN
support:

  OSIAN_ROOT=/opt/osian
  TOSMAKE_PATH=${OSIAN_ROOT}/tinyos/support/make
  export OSIAN_ROOT TOSMAKE_PATH
  export PATH=$PATH:${OSIAN_ROOT}/bin

OSIAN adds the following target platforms:

  surf

To build normal TinyOS applications for these platforms, the normal TinyOS
process applies:

  make surf

To build any application in OSIAN, add the OSIAN extra:

  make osian surf
  
This will reference directories within /opt/osian which are
required at compile time.


OSIAN Directory Structure
-------------------------

Below are some notable directories within OSIAN:

/opt/osian
  -- The baseline OSIAN directory you're reading this from
  
/opt/osian/cc430demos
  -- Contains C-code CC430 demos outside of TinyOS
  
/opt/osian/etc
  -- Similar to the Linux /etc directory, storing useful
     scripts and configurations
     
/opt/osian/schemas
  -- Contains OSIAN Device Identifier scripts and information
  -- See http://www.openosian.net/wiki/OSIAN_Device_Identifier for more info
  
/opt/osian/tinyos
  -- Contains a directory structure for OSIAN similar to the
     TinyOS directory structure
     
/opt/osian/tinyos/tmpmsp430
  -- This directory contains temporary platform and chip code
     that will someday live in the TinyOS core
     
/opt/osian/tinyos/apps
  -- This is where future OSIAN applications will go. 
     Right now there are basic applications and tests to demonstrate
     capabilities of SuRF board hardware, which will be separated
     from the OSIAN repository in the future as it moves into TinyOS.
     
/opt/osian/tinyos/tos/platforms/surf
  -- This is the platform definition for SuRF. This will
     be separated from the OSIAN repository in the future as it
     moves into TinyOS
     

OSIAN git Commands
------------------

OSIAN follows the practices of git with respect to branch naming and update
policies.  See: http://www.kernel.org/pub/software/scm/git/docs/howto/maintain-git.txt

For the latest OSIAN updates, run the following command:
$ git pull

To see a list of available remote branches, use:
$ git branch -a

To make local changes in a way suitable for submitting back to the OSIAN
project, create a local branch based on upstream master:
$ git branch mychanges origin/master
$ git checkout mychanges