Esta entrada no es un tutorial sobre cómo utilizar la
librería FatFs de ELM-Chan,
tan solo voy a dar las indicaciones necesarias para poder utilizar el
port que he realizado para los microcontroladores PSoC de Cypress.
Si necesitas saber más sobre la librería o el uso de
sus funciones, en internet puedes encontrar abundante información
sobre su uso y uno de los mejores sitios es la propia página de la
librería: ELM-Chan.
Sobre el Port.
El motivo para realizar el port de la librería fué la necesidad de implementar la grabación de datos en tarjetas SD con un micro de Cypress de la familia PSoC 4, para posteriormente tratar esos datos en un PC de sobremesa.
Partiendo de la versión R0.11a, que en el
momento de escribir esta entrada, es la última versión disponible y
la más moderna; los cambios necesarios para hacer funcionar la
librería con el micro PSoC 4 fueron mínimos. No fueron necesarios
cambios en ninguno de los archivos principales de la librería y se
realizaron cambios únicamente en el archivo “sdcard.c” que es el
que implementa el acceso a bajo nivel a las tarjetas SD. De hecho,
los cambios fueron tan sencillos que al final decidí comprobar que
funcionaban también en micros de la familia PSoC 4M e incluso hice
un port para los micros de la familia PSoC 5LP.
El port de la librería así como algunas aplicaciones
desarrolladas para pruebas puedes descargarlos de Github.
Cómo utilizar la librería.
Para utilizar la librería en tu proyecto sigue los
pasos que te indico a continuación:
-
Añade un módulo de comunicaciones SPI al esquema de tu proyecto y configúralo como maestro en modo CPHA = 0, CPOL = 0.
-
Añade una salida digital que será utilizada para la señal de selección del bus SPI. Para el buen funcionamiento de la librería, esta señal tendrá que ser controlada por el código de la librería en lugar de dejar al hardware y a la API que lo hagan. En PSoC 4 puedes hacerlo de dos manera distintas: añadir una salida digital, o reutilizar una de las señales SS del propio módulo SPI. Para utilizar esta última manera, habrá que desconectar la señal SS del módulo SPI del HSIOM (High Speed I/O Matrix). Si no sabes a qué me refiero, mira los ejemplos y consulta el manual de referencia de PSoC 4.
-
Añade los archivos que hay dentro de la carpeta PSoC_FatFs_Library del repositorio a tu proyecto.
-
Si vas a configurar la librería con funciones de escritura y quieres que la fecha y hora de los archivos sean los correctos tendrás que implementar por tí mismo un reloj de tiempo real (más información sobre RTC aquí).
-
Añade los “#includes” necesarios en la parte que corresponda de tu código (mira los ejemplos).
-
Retoca los valores de las macros que hay al principio del archivo “sdcard.c”:
-
SPI_NAME. En esta macro, pon el nombre que le hayas dado al módulo SPI en el esquema de tu proyecto. Gracias a esta macro, si decides cambiar el nombre del módulo SPI en el esquema, no tendrás que retocar los nombres de todas las funciones relativas al bus SPI dentro del código de “sdcard.c”, solo tendrás que cambiar el valor asignado a esta macro.
-
mmSPI_SS_Write(value). Función de la API correspondiente a la línea que hayas utilizado para la señal SS del bus SPI. Ejemplo: supón que añades en el esquema una salida digital a la que llamas SS. La api proveerá una función llamada SS_Write(valor) que permitira, desde el firmware fijar el valor lógico de esa salida. Esta es la función que has de asignar a esta macro. El motivo es el mismo que para la macro anterior.
-
CS_DELAY_US. Retardo en microsegundos desde que se activa la señal SS del bus SPI hasta que empieza el envío de datos.
-
M_DELAY_US. Retardo utilizado internamente en “sdcard.c”.
-
Retardo CS_DELAY_US
