Karoshi MSX Community

Para configurar dicho entorno lo primero será descargarse ambas aplicaciones desde los siguientes enlaces:

• Editor ConTEXT (http://www.contexteditor.org/downloads.html)
• Ensamblador asMSX v0.12g (http://karoshi.msxgamesbox.com/index.php?topic=834.0)

El editor lo instalaremos de forma habitual y el ensamblador lo descomprimiremos en el directorio dentro del cual vayamos a trabajar con el MSX.
A continuación habrá que descargar el paquete de utilidades que acompaña este tutorial: ConTEXT+asMSX (http://www.telefonica.net/web2/msxpage/others/ConTEXT_asMSX.zip). Tras descomprimirlo habrá que configurar el archivo BAT, exec.bat, de manera que la ruta designada para el emulador MSX que queramos usar quede definida mediante la variable de entorno MSXEMU:

set MSXEMU="f:\Ordenadores\MSX\Emulators\openMSX\openmsx.exe"

Originalmente el emulador OpenMSX (que es el que uso en esta etapa del desarrollo) viene configurado tal como figura, evidentemente el texto entrecomillado habrá que cambiarlo en función de donde tengamos instalado dicho emulador.

Hecho esto ya podremos proceder a configurar el ConTEXT siguiendo los pasos que se detallan a continuación:

1) Copiar el archivo de sintaxis para el asMSX, Z80.chl, en el directorio Highlighters del ConTEXT (habitualmente en C:\Archivos de programa\ConTEXT\Highlighters). Existe un problema de coincidencia de extensiones con los archivos de ensamblador para x86 :P; así que si estamos seguros de que no vamos a programar en ensamblador para x86, lo mejor es eliminar el archivo x86 Assembler.chl que se encuentra también en dicha carpeta; así permitiremos que el ConTEXT reconozca los archivos con extensión .asm como nativos de MSX exclusivamente (ahorrándonos el tener que seleccionar la sintaxis manualmente) :)

2) Los archivos Z80.hlp, wrdsk.exe y exec.bat (una vez modificado con la ruta del emulador) también procedentes del paquete descargado, los copiaremos en la carpeta en la que hemos descomprimido el asMSX.

3) Arrancaremos el ConTEXT y navegaremos por los menus hasta la pantalla de opciones de entorno: Options->Environment Options->Miscellaneous. LLegados aquí, en la lista de lenguajes que nos aparece debe de haber una entrada correspondiente al asMSX Z80 Assembler, la seleccionamos, pinchamos en Edit y buscamos el archivo Z80.hlp allá donde lo hayamos dejado. Con esto abremos configurado una ayuda en línea para comandos del Z80 muy simple; pero útil :). Esta ayuda se invoca pulsando F1 con el mnemónico seleccionado en nuestro código fuente.

4) Continuando con la configuración, ahora abrimos un nuevo dialogo: Options->Environment Options->Execute Keys. Pinchamos en Add y en la caja que nos aparece escribimos "asm", hecho esto nos aparecerá en el arbol de la izquierda la extensión que acabamos de introducir con las cuatro teclas de función configurables que usa el ConTEXT, a cada una de ellas le vamos a poder asignar la aplicación que queramos.

5) Seleccionamos la tecla F9 (o la que queramos) y rellenamos los campos tal como sigue:

(http://img104.imagevenue.com/loc631/th_43163_ConTEXT_options_122_631lo.jpg) (http://img104.imagevenue.com/img.php?image=43163_ConTEXT_options_122_631lo.jpg)

Con esto habremos asignado el asMSX a la tecla F9 y ya podremos compilar nuestro listado de ensamblador directamente pulsando dicha tecla o pinchando en el icono que el ConTEXT dispone para ella.
Otra de las funcionalidades que se añade mediante esta configuración es que tras una compilación con fallos, haciendo doble click sobre cualquiera de las lineas de error que en la ventana inferior del ConTEXT puedan aparecen (la "Ouput Console"), el editor nos posicionará automáticamente sobre la línea responsable del error.


Ahora, para probar que todo funciona, se puede crear en el ConTEXT un nuevo documento, copiar y pegar el listado del snippet Interlaced SC1 with 64 columns (http://karoshi.msxgamesbox.com/index.php?topic=154.0) tal como está y grabar dicho documento con el nombre que queramos; pero siempre con extension .asm.
Una vez grabado, pulsamos F9 y tras aparecer los resultados de la compilación en la ventana inferior, el OpenMSX debería arrancar la ROM generada y nosotros poder ver los resultados inmediatamente.

Espero no haber metido mucho la pata, muchas cosas las he hecho de memoria. Por supuesto si algo falla no teneis más que preguntar...

Copyrights:

• El asMSX todos sabemos de quién es; pero por si alguien todavía no lo sabe diré que el perpetrador es Eduardo Robsy Petrus
• La utilidad wrdsk.exe pertenece a la suite de utilidades de disco (en su versión 1.6) programada por Arnold Metselaar (arnoldm).
• El archivo de ayuda Z80.hlp mío no es desde luego; pero desgraciadamente ya no recuerdo de donde lo saqué...:P

Nota: Como extra, en el archivo que os habeis descargado, también está incluido el archivo de sintaxis para el MSX-BASIC, por si alguien también quiere entretenerse un rato con eso (el concurso de Konamito está calentito ;))

Que grande!

muchas gracias Jl, seguro que a mas de uno nos va a venir de maravilla.
Oye y ya puestos... no tendras un archivo tipo "msx-basic.hlp"??
para completar tu super pack digo... ::)

saludos!

Gracias por el aporte!

Si no recuerdo mal, el archivo Z80.hlp, en formato ayuda de Windows, acompañaba la distribución del RuMSX, programado por Rudolf Lechleitner. Aunque me puedo estar columpiando...

 Sólo agregar que lo he descargado con Ubuntu Linux y se instala perfectamente ( a través de Wine).
 Me falta hacer mas pruebas.
 Esto pinta estupendo.

Robsy efectivamente no se columpia :). Tienes un archivo HLP del MSX-BASIC (y otros muchos bastante interesantes) en el paquete de documentación extra que se puede descargar junto al RuMSX en su página (http://www.lexlechz.at/), sección "Download software", apartado RuMSX. El enlace a descargar es "Optional: MSX-Documentation and Manuals (V0.40), 1204KB".
El archivo con el MSX-BASIC es el SOFTWARE.CHM.


Tratándose de un simple editor supongo que irá perfecto. Robsy estaba utilizando ya un editor nativo de Linux, ¿el GEdit quizá?, lo digo porque para los que usan Linux estaría bien conocer las posibilidades.

No lo he probado aún, pero al parecer existe un plugin que permite combinar muy bien gedit y openMSX, junto con - eventualmente - asMSX o el ensamblador que prefiráis. El problema es que no hay aún versión nativa de asMSX para Linux. Es decir, sí que la hay pero no ha sido distribuida aún.  :(

Tranquilo, ya la habrá :). De momento el asMSX sigue siendo el único ensamblador orientado especialmente a MSX; así que estaría bien que finalmente Linux también disfrutara de él ;)

Respecto al plugin, pues efectivamente, debes referirte a este que he encontrado:

OpenMSX Control Plugin for Gedit (http://msx.jannone.org/openMSXcontrol/)

Que además es de nuestro amigo Rafael Jannone (al loro del "Computerliebe" que suena de fondo :D).

Respecto a las plantillas de coloreado de sintaxis, no he encontrado nada; pero supongo que tiene que haberlas...

Uhmmm, y el tniasm y el sjasm?

En lo que respecta a especialización MSX no le llegan al asMSX ni a la suela de los zapatos... ;D

Y ojo, no estoy diciendo que ninguno sea mejor o peor que el otro, yo los he probado todos y reconozco que me decanté para proyectos grandes por el sjASM aun a sabiendas que iba a tener que hacer a mano unas cuantas cosillas que el asMSX me daba hechas :(.

Yo utilizo en tniasm y me va muy bien. No me llevo sorpresas desagradables.

Sobre el sjasm... nunca lo he utilizado, no sé qué decir.

Sobre el asmsx, que es el que utiliza la mayor parte de la gente de por aquí. Especialmente útil la forma sencilla de crear megarón (con cocacola); totalmente transparente al coder.

Muy buena esta entrada. Yo he modificado el exec.bat para que funcione con el blueMSX. Ademas en la configuracion del 'short-cut' he dado la posiblidad de que el codigo que queremos compilar no este en el mismo directorio que el asmsx.
(http://jesus.ferreira.googlepages.com/context_asmsx.png)
http://jesus.ferreira.googlepages.com/exec.7z (http://jesus.ferreira.googlepages.com/exec.7z)

S2

¿Podrías editar el código del exe para que funcione con el blueMSX?... a mí no me sale !!!
 ;)

No debería ser muy difícil, tan solo cambiar el ejecutable y lanzarlo con los parámetros correspondientes. Yo me he acostumbrado a hacerlo con el OpenMSX, el BlueMSX lo uso especialmente por el depurador; pero no frecuentemente, es demasiado pesado.

Le echaré un vistazo a ver como va, ahora mismo no me acuerdo de los parámetros de linea de comando del Blue... :)

Bueno, cuando puedas, ¿ok?...
Por cierto, ahora mismo lo tengo configurado para el OpenMSX, tal y como lo describes en el post, pero no me reconoce la máquina 8245, tengo que quitar ese parámetro del exe para que funcione.
¿me hace falta algún ficherito con los "datos" del philips para el OpenMSX???
 :P

Estoy empeñado en hacer un "hola mundo" (si, ya sé que es una tontería... pero para mí...) en CM... para empezar de una vez...  A ver si me sale... sé que será mi lanzamiento en la programación de CM para MSX...
 ;)

Exacto, cuestión de configurar el OpenMSX adecuadamente. Si no recuerdo mal, había que meter las roms del 8245 que necesita el Open en la carpeta correspondiente en share/machines. Si no tienes el 8245, puedes sustituirlo por cualquier modelo del que si que tengas las ROMs (CBIOS te arranca ROMs; así que puedes usar esas configuraciones básicas).


Pues ya sabes, por algo se empieza y que no te de vergüenza preguntar si encuentras algún problema ;)

Tienes un privado...

OK, muchas gracias !!!
 ;)