i.MX Yocto Project: How can I contribute to the community?

Document created by Leonardo Sandoval Gonzalez Employee on Jul 30, 2013
Version 1Show Document
  • View in full screen mode

The Yocto Project is open-source, so anyone can contribute. No matter what your contribution is (bug fixing or new metadata), contributions are sent through patches to a community list. Many eyes will look into your patch and at some point it is either rejected or accepted. Follow these steps to contribute:



  • Make sure you have previously configured your personal info


$ git config --global user.name "Your Name Here"

$ git config --global user.email "your_email@example.com"



  • Download `master` branches


fsl-community-bsp $ repo init \

  -u https://github.com/Freescale/fsl-community-bsp-platform \

  -b master


  • Update


fsl-community-bsp $ repo sync



Create local branches so your work is *not* done on master


fsl-community-bsp $ repo start <branch name> --all


Where `<branch name>` is any name you want to give to your local branch (e.g. `fix_uboot_recipe`, `new_gstreamer_recipe`, etc.)


  • Make your changes in any Freescale related folder (e.g. sources/meta-fsl-arm). In case you modified a recipe (.bb) or include (.inc) file, do not forget to *bump* (increase the

value by one) either the `PR` or `INC_PR` value


  • Commit your changes using `git`. In this example we assume your change is on `meta-fsl-arm` folder


sources/meta-fsl-arm $ git add <file 1> <file 2>

sources/meta-fsl-arm $ git commit


On the commit's log, the title must start with the filename change or introduced, then a brief description of the patch's goal, following with a long description. Make sure you follow the standards

(type ` git log --pretty=oneline` to see previous commits)


  • Create a patch


sources/meta-fsl-arm $ git format-patch -s  --subject-prefix='<meta-fsl-arm][PATCH' -1


Where the last parameter (`-1`) indicate to patch last commit. In case you want to create patches for older commits, just indicate the correct index.

If your patch is done in other folder, just make sure you change the `--subject-prefix` value.


  • Send your patch or patches with


git send-email --to meta-freescale@yoctoproject.org <patch>



where `<patch>` is the file created by `git format-patch`.


  • Keep track of patch's responses on the mailing list. In case you need to rework your patch, repeat the steps but this time the patch's subject changes to `--subject-prefix='<meta-fsl-*][PATCH v2'`


  • Once your patch has been approved, you can delete your working branches


fsl-community-bsp $ repo abandon <branch name>