cpu/mc1322x/README.subtree

   1 The Contiki MC1322x port includes libmc1322x as a subtree. This makes
   2 pulling updates to libmc1322x easy, but pushing changes from contiki
   3 to libmc1322x is not so easy. However, this should not stop you from
   4 implementing core features in contiki first, (especially if you are in
   5 a bind). The way to do this is to make files prefixed with contiki-*
   6 in cpu/mc1322x and add them to Makefile.mc1322x.
   7
   8 For instance, if you need a routine called sleep, but libmc1322x
   9 doesn't have that yet, you could implement sleep in
  10 contiki-crm.c. Feel free to use as many contiki specific things in
  11 here as you want. We can pull these changes directly into the contiki
  12 tree. There is nothing stopping you from making changes to the lib
  13 files --- in fact you should if that is the right thing to do (and
  14 then push your changes upstream). The subtree merge should make it
  15 easy to still pull updates.
  16
  17 You'll also notice that the libmc1322x build system is still
  18 present. This allows you to cd ./tests and make all of the libmc1322x
  19 unit tests as normal. This is a handy way to perform a sainity check
  20 on all of the mc1322x specific code.
  21
  22 The subtree was set up as follows:
  23
  24 From:
  25 http://www.kernel.org/pub/software/scm/git/docs/howto/using-merge-subtree.html
  26
  27 Moved mc1322x.lds to mc1322x.lds.contiki
  28
  29 Setup with:
  30
  31 git remote add -f libmc1322x git://git.devl.org/git/malvira/libmc1322x.git
  32 git read-tree --prefix=cpu/mc1322x -u libmc1322x/master
  33 git commit -m "Merge libmc1322x as a subdirectory"
  34
  35
  36 And to do subsequent merges from libmc1322x do:
  37
  38 git pull -s subtree libmc1322x master
  39