Quien quiera realmente aprender GIT le recomendamos leer el libro oficial: http://git-scm.com/book/en/v2

Trabajar con GIT implica hacerlo de manera automatizada y facilitar el trabajo colaborativo en el repositorio. Es indispensable si se va a colaborar con el proyecto, y no sólo hacer uso de él. Para hacerlo, se va a proceder a realizar una copia local del repositorio (Clonar), para ello se va a trabajar en una carpeta en 'C:\CIAA' de manera que no quede dentro de “Mis Documentos” (por defecto para GitHub) por los inconvenientes que a veces puede traer el caracter de espacio en los path de compilación.

Para ello abrimos el GIT Shell instalado desde GitHub y hacemos lo siguiente:

cd /           ☜ Para ir al root, típicamente C:\
mkdir CIAA     ☜ Creamos la carpeta CIAA
cd CIAA        ☜ Accedemos a la carpeta CIAA

Este punto nuestro Path debería ser C:\CIAA>. Pasamos a clonar el repositorio

git clone --recursive https://github.com/ciaa/Firmware.git

Es importante no olvidar la opción recursive, ya que esta le indica a git que descargue los submódulos del repositorio. En caso de que no hayamos incluido la opción recursive, debemos ejecutar:

git submodule init
git submodule update

Si todo anduvo bien, a continuación deberíamos ver cómo progresa la descarga del repositorio. Una vez finalizada la descarga podemos ingresar a la carpeta Firmware que se ha creado con la copia local del repositorio.

cd Firmware

• Ver el contenido de la carpeta en consola (también ya puede usarse el explorador de windows normal porque está en nuesta PC!) listamos el directorio

ls            ☜ También podría usar el comando dir

Si todo anduvo bien veríamos algo como lo siguiente

Por último, si el repositorio se ha actualizado y queremos actualizar también nuestra copia local con estos cambios, hay que hacer un 'pull' del mismo una vez que nos encontremos en el path nuestra copia local, para el ejemplo 'C:\CIAA\Firmware'

git pull

Para este ejemplo, como recién acabamos de hacer una copia local el repositorio se encuentra actualizado. Caso contrario se actualizará con los cambios.

Si hicimos algún cambio en la copia local podemos ver los cambios mediante el comando status:

git status    ☜ Muestra los cambios en el repositorio

Cuando necesitemos volver a sincronizar nuestro repositorio local con el de la CIAA, deberemos hacer nuevamente un 'pull', pero si tenemos cambios hechos que entran en conflicto con la actualización, GIT nos avisará que antes de hacerla que debe indicarse qué se hace con los cambios. Si lo que hicimos fueron solamente pruebas que no importa perder, y sólo queremos tener nuevamente la última copia del repositorio descartamos los cambios mediantes el comando 'checkout':

git checkout -f         ☜ Fuerza a descartar los cambios

Ahora si podremos hacer un 'pull' del repositorio

Antes de hacerlo en Linux debe estar seguro que tiene 'git' instalado en su sistema. De no tenerlo, deberá hacer

sudo apt-get install git    ☜ Descarga e instala 'git'

A continuación puede seguir el procedimiento mencionado para Windows, con las consideraciones del caso para crear/moverse por los directorios.

El git tiene un branch llamado master que es el principal. Es una buena práctica que el master siempre este listo como para una posible release, por lo que salvo muy pequenios cambios siempre es importante trabajar en un branch.

Para trabajar con branches lo primero es crear una:

git branch branchname

Luego se pueden listar los branches:

server:~/ciaa/Firmware2$ git branch -a
* block
  master
  modbus
  mybranch
  new_osek_port
  osek_mac

El * indica el branch actual.

Para cambiar de branches será necesario hacer:

git checkout newbranch

Es importante no realizar cambios en el master a menos de no estar MUY seguro de lo que uno hace. Por favor hacerlo siempre sobre branches.

Luego de editar uno o más archivos se puede utilizar el siguiente commando para ver el estado rel repoitorio:

server:~/ciaa/Firmware2$ git status
# On branch block
# Changes not staged for commit:
#   (use "git add <file>..." to update what will be committed)
#   (use "git checkout -- <file>..." to discard changes in working directory)
#
#	modified:   modules/posix/inc/ciaaBlockDevices.h
#	modified:   modules/posix/src/ciaaBlockDevices.c
#
# Untracked files:
#   (use "git add <file>..." to include in what will be committed)
#
#	FLASH.BIN
no changes added to commit (use "git add" and/or "git commit -a")

Para poder subir cambios al repo hay que primero utiliar el comando add

git add modules/posix/inc/ciaaBlockDevices.h

y luego

git commit -m"#<ticket> commentario"

Es una buena práctica no solo indicar un comentario sino el ticket por la cual se realiza el cambio.

para no tener que hacer git add con cada archivo se puede tambien utilizar

git add -u

Una vez realizados los cambios los mismos se encuentran en el repo pero únicamente en la copia local. Para subir los mismos al servidor se debe utilizar el comando

git push

en el caso de ser un nuevo branch hay que indicar que uno quiere subirlo al servidor:

git push origin branchname

A la hora de llevar a cabo trabajos o proyectos utilizando como plataforma el CIAA-Firmware se recomienda trabajar con la última release y no sobre la rama master del repositorio.

Las releases se identifican con etiquetas o tags. Para conocerlas se debe ejecutar:

server:~/ciaa/Firmware$ git tag
0.0.1
0.2.0
0.3.0
0.3.0-rc1
0.3.0-rc2
0.4.0
0.4.1
0.5.0
0.6.0
0.6.1
0.7.0-alpha
1.0.0
KSKD_1.0.2

Suponiendo que la última release correponde al tag 1.0.0 (como sucede en este caso), se procede de la siguiente manera:

git checkout tags/1.0.0
git submodules update

Listo! Todo configurado para trabajar sobre la última versión del CIAA-Firmware.