Compare commits

...

8 Commits

5 changed files with 61 additions and 50 deletions
Unified View
  1. BIN
      1.jpeg
  2. BIN
      2.jpeg
  3. +20
    -0
      Ejemplo.c
  4. +18
    -0
      Makefile
  5. +23
    -50
      Readme.md

BIN
1.jpeg View File

Before After
Width: 453  |  Height: 342  |  Size: 25 KiB

BIN
2.jpeg View File

Before After
Width: 455  |  Height: 345  |  Size: 24 KiB

+ 20
- 0
Ejemplo.c View File

@ -0,0 +1,20 @@
#include <msp430fr6989.h>
void main(void)
{
WDTCTL = WDTPW | WDTHOLD; // stop watchdog timer
PM5CTL0 = 0x0000; // disable high impedance mode
P1DIR = 0x01; //set up bit 0 of P1 as output
P1OUT = 0x00; //initialize bit 0 of P1 to 0
for(;;){ //loop
volatile unsigned int i;
P1OUT ^= 0x01; //toggle bit 0 of P1
//Delay
for(i=40000; i>0;){
i--;
__no_operation();
}
}
}

+ 18
- 0
Makefile View File

@ -0,0 +1,18 @@
OBJECTS=Ejemplo.o
GCC_DIR = /home/user/msp430-gcc/bin
SUPPORT_FILE_DIRECTORY = /home/user/msp430-gcc/include
DEVICE = msp430fr6989
CC = $(GCC_DIR)/msp430-elf-gcc
GDB = $(GCC_DIR)/msp430-elf-gdb
CFLAGS = -I $(SUPPORT_FILE_DIRECTORY) -mmcu=$(DEVICE) -O2 -g
LFLAGS = -L $(SUPPORT_FILE_DIRECTORY) -T $(DEVICE).ld
all: ${OBJECTS}
$(CC) $(CFLAGS) $(LFLAGS) $? -o $(DEVICE).out
debug: all
$(GDB) $(DEVICE).out

Guía de usuario MSP430 GCC Toolchain.md → Readme.md View File

@ -10,6 +10,7 @@ Galván.A , Chávez.G , Julio,2022.
This manual aims to describe the setup and basic operations of the MSP430 GCC toolchain to know how to use the open-source GCC compiler for microcontrollers to build an example for an MSP430 target device using the command terminal of Linux. It will also be shown how to debug software with the GDB Agent and the GNU Debugger tools so that the program that was built can be uploaded to the target device successfully. This manual aims to describe the setup and basic operations of the MSP430 GCC toolchain to know how to use the open-source GCC compiler for microcontrollers to build an example for an MSP430 target device using the command terminal of Linux. It will also be shown how to debug software with the GDB Agent and the GNU Debugger tools so that the program that was built can be uploaded to the target device successfully.
[^]: This user guide was tested in the following distributions of Linux: **Ubuntu 22.04 LTS** and **Debian 11** using a **MSP430FR6989** microcontroller.
------ ------
[TOC] [TOC]
@ -32,13 +33,13 @@ El paquete GCC de código abierto es un depurador completo y una cadena de herra
El primer paso es bastante sencillo, consiste en abrir la terminal de comando y direccionarse a la carpeta en donde se guardará el archivo que contenga el programa a ejecutar. El primer paso es bastante sencillo, consiste en abrir la terminal de comando y direccionarse a la carpeta en donde se guardará el archivo que contenga el programa a ejecutar.
Con el comando **cd** se puede entrar a alguna carpeta en específico como lo puede ser la carpeta de **Descargas**, Ejemplo: Con el comando **cd** se puede entrar a alguna carpeta en específico como lo puede ser la carpeta de **Descargas**, Ejemplo:
```c
```bash
$ cd Descargas $ cd Descargas
``` ```
Antes de continuar con el siguiente paso se debe dirigir a la página oficial de TI (Texas Instruments) yendo directamente a la siguiente página [https://www.ti.com/tool/MSP430\-GCC\-OPENSOURCE](). En la pestaña de *descargas* se debe seleccionar la opción más factible para su computadora en este caso **Mitto Systems GCC 64-bit Linux installer incl. support files**. Una vez descargada, en la carpeta de descargas se debe buscar el nombre del archivo y posteriormente, en la terminal de comando se debe colocar lo siguiente: "**sudo chmod +x <installer>.run** y el comando **./<installer>**", lo cual permitirá instalar el programa. A continuación se muestra un ejemplo, donde **msp430-gcc-full-linux-X64-installer-9.3.1.2.run**, es el nombre del archivo que se descargó (installer). Antes de continuar con el siguiente paso se debe dirigir a la página oficial de TI (Texas Instruments) yendo directamente a la siguiente página [https://www.ti.com/tool/MSP430\-GCC\-OPENSOURCE](). En la pestaña de *descargas* se debe seleccionar la opción más factible para su computadora en este caso **Mitto Systems GCC 64-bit Linux installer incl. support files**. Una vez descargada, en la carpeta de descargas se debe buscar el nombre del archivo y posteriormente, en la terminal de comando se debe colocar lo siguiente: "**sudo chmod +x <installer>.run** y el comando **./<installer>**", lo cual permitirá instalar el programa. A continuación se muestra un ejemplo, donde **msp430-gcc-full-linux-X64-installer-9.3.1.2.run**, es el nombre del archivo que se descargó (installer).
```c
```bash
$ sudo chmod +x msp430-gcc-full-linux-X64-installer-9.3.1.2.run $ sudo chmod +x msp430-gcc-full-linux-X64-installer-9.3.1.2.run
$ ./msp430-gcc-full-linux-X64-installer-9.3.1.2.run $ ./msp430-gcc-full-linux-X64-installer-9.3.1.2.run
``` ```
@ -59,7 +60,7 @@ Se debe crear una carpeta en donde se colocará el código y los archivos necesa
> Comando para encontrar carpetas dentro de la carpeta en la que se encuentra **dir**. > Comando para encontrar carpetas dentro de la carpeta en la que se encuentra **dir**.
> Comando para entrar en carpeta **cd**. > Comando para entrar en carpeta **cd**.
```c
```bash
$ mkdir Programa1 $ mkdir Programa1
$ dir $ dir
$ cd Programa1 $ cd Programa1
@ -95,41 +96,13 @@ Para crear un archivo **.c** se debe posicionar en el directorio en el que lo de
Comando para editar/crear el archivo **.c**. Comando para editar/crear el archivo **.c**.
```c
$ pico Ejemplo.c
```
A continuación, se muestra el programa copiado en la ventana que se abrió con el comando *pico*.
```c
#include <msp430fr6989.h>
void main(void)
{
WDTCTL = WDTPW | WDTHOLD; // stop watchdog timer
PM5CTL0 = 0x0000; // disable high impedance mode
P1DIR = 0x01; //set up bit 0 of P1 as output
P1OUT = 0x00; //initialize bit 0 of P1 to 0
for(;;){ //loop
volatile unsigned int i;
P1OUT ^= 0x01; //toggle bit 0 of P1
//Delay
for(i=40000; i>0;){
i--;
__no_operation();
}
}
}
[ 26 líneas leídas ]
^G Ayuda ^O Guardar ^W Buscar ^K Cortar ^T Ejecutar ^C Ubicación M-U Deshacer M-A Poner marca M-] A llave M-Q Anterior ^B Atrás ^◂ Palabr ant
^X Salir ^R Leer fich. ^\ Reemplazar ^U Pegar ^J Justificar ^/ Ir a línea M-E Rehacer M-6 Copiar ^Q Buscar atrás M-W Siguiente ^F Adelante ^▸ Palabra Siguiente
[^]: Este ejemplo fue realizado con el editor de texto **pico**, pero se puede utilizar cualquier otro editor de su preferencia.
```bash
$ pico Ejemplo.c
``` ```
Una vez copiado el código, se teclea **Ctrl + X** para salir, posteriormente se guarda el archivo tecleando **S** y por último se teclea **Enter** para regresar a la terminal de comandos.
Una vez copiado el código en el archivo **.c**, se teclea `Ctrl + X` para salir, posteriormente se guarda el archivo tecleando `S` y por último se teclea `Enter` para regresar a la terminal de comandos.
#### Compilación de un programa desde la termial de Linux #### Compilación de un programa desde la termial de Linux
@ -137,7 +110,7 @@ El programa se puede compilar manualmente desde la terminal indicando las rutas
Ejemplo de compilación de un programa desde la terminal (primer método): Ejemplo de compilación de un programa desde la terminal (primer método):
```c
```bash
$ ./msp430-elf-gcc -I ~/msp430-gcc/include -L ~/msp430-gcc/include -T ~/msp430-gcc/include/msp430fr6989.ld -mmcu=msp430fr6989 -O2 -g ~/Documentos/Programa1/Ejemplo.c -o ~/Documentos/Programa1/Ejemplo.o $ ./msp430-elf-gcc -I ~/msp430-gcc/include -L ~/msp430-gcc/include -T ~/msp430-gcc/include/msp430fr6989.ld -mmcu=msp430fr6989 -O2 -g ~/Documentos/Programa1/Ejemplo.c -o ~/Documentos/Programa1/Ejemplo.o
``` ```
@ -161,8 +134,8 @@ Donde:
1. Crear un directorio para el nuevo proyecto. 1. Crear un directorio para el nuevo proyecto.
2. Insertar el archivo .c que contiene el programa que se subirá a la tarjeta. Para crear un archivo .c vea el apartado **Creación de un archivo .c**. 2. Insertar el archivo .c que contiene el programa que se subirá a la tarjeta. Para crear un archivo .c vea el apartado **Creación de un archivo .c**.
3. Dentro de la carpeta que se instaló (msp430-gcc), hay un directorio llamado **examples** que contiene ejemplos predeterminados. Copiar uno de los archivos **Makefile** de los proyectos de ejemplo dentro del directorio de su nuevo proyecto, en este caso, dentro de la carpeta **Programa1**.
4. Abrir el archivo **Makefile** que copió y cambiar el formato de estructura actual por el que se muestra a continuación. En la variable **OBJECTS** se debe colocar el nombre del programa que se va a subir (archivo .c) respetando la terminación **.o**. En la variable **DEVICE** se debe colocar el nombre del microcontrolador que se usará.
3. Dentro de la carpeta que se instaló (msp430-gcc), hay un directorio llamado **examples** que contiene ejemplos predeterminados. Copiar uno de los archivos `Makefile` de los proyectos de ejemplo dentro del directorio de su nuevo proyecto, en este caso, dentro de la carpeta **Programa1**.
4. Abrir el archivo `Makefile` que copió y cambiar el formato de estructura actual por el que se muestra a continuación. En la variable **OBJECTS** se debe colocar el nombre del programa que se va a subir (archivo .c) respetando la terminación **.o**. En la variable **DEVICE** se debe colocar el nombre del microcontrolador que se usará.
5. Colocar las rutas de instalación correpondientes para las variables **GCC\_DIR** y **SUPPORT\_FILE\_DIRECTORY**. Las direcciones para las variables son **../../../bin** y **../../../include** respectivamente como se muestra en el siguiente ejemplo. 5. Colocar las rutas de instalación correpondientes para las variables **GCC\_DIR** y **SUPPORT\_FILE\_DIRECTORY**. Las direcciones para las variables son **../../../bin** y **../../../include** respectivamente como se muestra en el siguiente ejemplo.
Estructura de archivo Makefile: Estructura de archivo Makefile:
@ -203,7 +176,7 @@ En Windows, se proporciona una consola y una versión de aplicación GUI del age
Abra una terminal de comando y dirijase al directorio de instalación, una vez hecho, ejecute lo siguiente: Abra una terminal de comando y dirijase al directorio de instalación, una vez hecho, ejecute lo siguiente:
```c
```bash
$ ./bin/gdb\_agent\_console msp430.dat $ ./bin/gdb\_agent\_console msp430.dat
``` ```
@ -227,11 +200,11 @@ msp430 Waiting for client
##### Ejecutar un programa en el debugger ##### Ejecutar un programa en el debugger
1. Abra otra terminal de comando y dirijase a la ruta donde se encuentra el directorio con el archivo **.c** y el **Makefile** del programa que quiere cargar a la tarjeta.
1. Abra otra terminal de comando y dirijase a la ruta donde se encuentra el directorio con el archivo **.c** y el `Makefile` del programa que quiere cargar a la tarjeta.
2. Escriba el comando **make debug**. Este comando inicia el GDB y espera que se introduzcan comandos, esto es indicado por el puntero **(gdb)**. 2. Escriba el comando **make debug**. Este comando inicia el GDB y espera que se introduzcan comandos, esto es indicado por el puntero **(gdb)**.
```c
```bash
$ make debug $ make debug
/home/usuario/msp430-gcc/bin/msp430-elf-gcc -I /home/usuario/msp430-gcc/include -mmcu=msp430fr6989 -O2 -g -L /home/usuario/msp430-gcc/include -T msp430fr6989.ld Ejemplo.o -o msp430fr6989.out /home/usuario/msp430-gcc/bin/msp430-elf-gcc -I /home/usuario/msp430-gcc/include -mmcu=msp430fr6989 -O2 -g -L /home/usuario/msp430-gcc/include -T msp430fr6989.ld Ejemplo.o -o msp430fr6989.out
/home/usuario/msp430-gcc/bin/msp430-elf-gdb msp430fr6989.out /home/usuario/msp430-gcc/bin/msp430-elf-gdb msp430fr6989.out
@ -258,7 +231,7 @@ msp430 Waiting for client
4. Escriba el comando **target remote :55000** y presione enter para conectar el GDB con el GDB Agent que se encuentra en la otra terminal de comando que se dejó abierta. En la otra terminal se podrá observar en la consola del GDB Agent que se conectó un dispositivo/cliente. 4. Escriba el comando **target remote :55000** y presione enter para conectar el GDB con el GDB Agent que se encuentra en la otra terminal de comando que se dejó abierta. En la otra terminal se podrá observar en la consola del GDB Agent que se conectó un dispositivo/cliente.
```c
```bash
Reading symbols from msp430fr6989.out... Reading symbols from msp430fr6989.out...
(gdb) target remote :55000 (gdb) target remote :55000
Remote debugging using :55000 Remote debugging using :55000
@ -285,7 +258,7 @@ msp430 Waiting for client
5. Escriba **load** y presione enter para cargar el programa binario al dispositivo MSP430 que esté usando. 5. Escriba **load** y presione enter para cargar el programa binario al dispositivo MSP430 que esté usando.
```c
```bash
(gdb) load (gdb) load
Loading section .upper.data, size 0x2 lma 0x4400 Loading section .upper.data, size 0x2 lma 0x4400
Loading section .text, size 0x3c lma 0x4402 Loading section .text, size 0x3c lma 0x4402
@ -297,14 +270,14 @@ msp430 Waiting for client
6. Escriba el comando **continue** para correr el programa o en su defecto escriba **step** para compilar el programa paso por paso. 6. Escriba el comando **continue** para correr el programa o en su defecto escriba **step** para compilar el programa paso por paso.
```c
```bash
(gdb) continue (gdb) continue
Continuing. Continuing.
``` ```
7. Para parar la ejecución teclee **Ctrl + C** (^C), y para salir del GDB escriba **q**, presione enter y posteriormente escriba **y** y presione enter.
7. Para parar la ejecución teclee `Ctrl + C` (^C), y para salir del GDB escriba `q`, presione enter y posteriormente escriba `y` y presione enter.
```c
```bash
^C ^C
Program stopped. Program stopped.
main () at Ejemplo.c:15 main () at Ejemplo.c:15
@ -326,14 +299,14 @@ msp430 Waiting for client
**Error Make debug* **Error Make debug*
```c
```bash
$ make debug $ make debug
Make: *** There is no rule to build the 'debug' target. Tall Make: *** There is no rule to build the 'debug' target. Tall
``` ```
Instalar make para solucionar el problema mediante el comando : Instalar make para solucionar el problema mediante el comando :
```c
```bash
sudo apt-get install make sudo apt-get install make
``` ```
@ -341,14 +314,14 @@ sudo apt-get install make
**Error 127 makefile debug* **Error 127 makefile debug*
```c
```bash
/home/usuario/msp430-gcc/bin/msp430-elf-gdb:error while loading shared libraries: libncursesw.so.5: cannot open shared object file: No such file or directory /home/usuario/msp430-gcc/bin/msp430-elf-gdb:error while loading shared libraries: libncursesw.so.5: cannot open shared object file: No such file or directory
make: *** [Makefile: debug] Error 127 make: *** [Makefile: debug] Error 127
``` ```
Instalar la libreria *libncursesw.so.5* para solucionar el problema, en caso de que continúe el problema, instalar *libncursesw5-dev* mediante el comando : Instalar la libreria *libncursesw.so.5* para solucionar el problema, en caso de que continúe el problema, instalar *libncursesw5-dev* mediante el comando :
```c
```bash
sudo apt-get install libncursesw5 sudo apt-get install libncursesw5
sudo apt-get inatall libncursesw5-dev (opcional) sudo apt-get inatall libncursesw5-dev (opcional)
``` ```

Loading…
Cancel
Save