Veo muchos ejemplos de código y tutoriales, pero ¿dónde está documentado que los símbolos (defines) como P1OUT y P1DIR están disponibles y cuál es su semántica?
Veo una lista con comentarios de una frase en los archivos de cabecera, pero eso es lo mismo que navegar por el código fuente. Lo que busco es un documento técnico: una referencia de la API o, al menos, una guía del programador.
Estos se definen en los includes. Para CCS, el valor por defecto es el msp430.h creado por TI, que luego intenta incluir el archivo específico para su dispositivo de destino a través de if defines. Ese archivo (es decir, msp4430g2553.h) es el que alberga las referencias específicas como P1OUT o P1DIR que coincide con la dirección de registro específica definida en la hoja de datos y la guía de familia de su dispositivo de destino. En su mayor parte, los nombres deberían coincidir con la Guía de Familia, y son muy consistentes entre dispositivos.
De la Guía del usuario de CCS:
Utilice 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. El uso de estos archivos es recomendable y puede simplificar mucho la tarea de desarrollar un programa. Para incluir el archivo .h correspondiente al dispositivo de destino, añada la línea #include para C
y .cdecls C,LIST, "msp430xyyy" para el código de montaje, donde xyyy especifica el número de pieza del MSP430.
Aquí hay una copia en línea del 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 de incluir la cabecera del dispositivo de destino específico.
Los nombres de estas definiciones coinciden con los nombres de los registros. Los registros pueden consultarse en la hoja de datos de su modelo de MSP430 o en la guía del usuario de la familia. Por ejemplo, en el caso del MSP430FR5739 (1) el P1OUT y P1DIR se describen en la sección 8.4 de su guía del usuario de la familia (slau272b) .
(1) No tiene nada de especial. Sólo el más cercano a mí en el momento de escribir.
(2) P1OUT y P1DIR son sólo nombres de registro. Nadie los llama API en el [sub]mundo de la programación de bajo nivel.
Además, busca el lugar donde se definen en el código fuente. Es posible que haya comentarios.
La hoja de datos y la guía del usuario de la familia (cuando la hay) son lectura obligatoria . Hay que leerlos, o al menos hojearlos. No hay excusa para no leerlos.
I-Ciencias es una comunidad de estudiantes y amantes de la ciencia en la que puedes resolver tus problemas y dudas.
Puedes consultar las preguntas de otros usuarios, hacer tus propias preguntas o resolver las de los demás.
