Veo muchos ejemplos de código y tutoriales, pero ¿dónde está documentado que los símbolos (definiciones) como P1OUT y P1DIR están disponibles y cuáles son sus semánticas?
Veo una lista con comentarios de una sola frase en los archivos de encabezado, pero eso es lo mismo que navegar a través del código fuente. Estoy buscando un documento técnico: una referencia a la API o al menos una Guía del programador.
Los nombres de estos definidos coinciden con los nombres de los registros. Los registros se pueden consultar en la hoja de datos para su modelo de MSP430 o en la guía del usuario de la familia. Por ejemplo, en el caso de MSP430FR5739 (1) , P1OUT y P1DIR se describen en la sección 8.4 de su guía de usuario familiar (slau272b) .
(1) No tiene nada de especial. El más cercano a mí en el momento de escribir.
(2) P1OUT y P1DIR son solo nombres de registro. Nadie los llama API en el mundo [bajo] de la programación de bajo nivel.
También, busque el lugar donde se definen en el código fuente. Puede haber comentarios.
La hoja de datos y la guía del usuario de la familia (cuando hay una) son lectura obligatoria . Tienes que leerlos, o al menos hojearlos. No hay excusa para no leerlos.
Estos se definen en los incluye. Para CCS, el valor predeterminado es el msp430.h creado por TI, que luego intenta incluir el archivo específico para su dispositivo de destino a través de si lo define. Ese archivo (es decir, msp4430g2553.h) es el que alberga las referencias específicas como P1OUT o P1DIR que coinciden con la dirección de registro específica tal como se define en la Hoja de datos y la Guía de la familia del dispositivo de destino. En su mayor parte, los nombres deben coincidir con la Guía de la familia, y son muy consistentes entre los dispositivos.
De la Guía del usuario de CCS:
Use los archivos .h para simplificar el desarrollo del código.
CCS se suministra con archivos para cada dispositivo que definen los registros del dispositivo y los nombres de los bits. Se recomienda usar estos archivos y puede simplificar enormemente la tarea de desarrollar un programa. Para incluir el archivo .h correspondiente al dispositivo de destino, agregue la línea #include para C
y .cdecls C, LISTA, "msp430xyyy" para el código de ensamblaje, donde xyyy especifica el número de pieza del MSP430.
Aquí hay una copia en línea de la msp430g2553.h de CCS. Muy bien comentado y fácil de leer.
IAR, además de tener las versiones msp430.h, también incluye io430.h, que es creado por IAR y tiene algunas diferencias o características adicionales. También actúa de la misma manera para incluir el encabezado del dispositivo de destino específico.
Sí, existe una API. Se les conoce como driverlib. Descargue el Code composer studio, luego instale MSP430ware y podrá ver los detalles de la biblioteca de controladores.
Lea otras preguntas en las etiquetas c msp430 texas-instruments ti-ccstudio iar