How to port emulegOS

Home page / Lego® / Robotics / emulegOS / Porting Guide

Disclaimer
This page is not connected with or endorsed by The LEGO Company. LEGO, LEGOLAND, LEGO SYSTEM, LEGO TECHNIC, DUPLO, LEGO PRIMO and LEGO MINDSTORMS are trademarks of The LEGO Company.

How to port emulegOS

We tried and designed emulegOS for maximum portability. Here you find some hints to help you in this task.

The core of emulegOS, the emuLegOs.cpp (and . h ) files should not need any conversion at all. The same for the Program and RealWorld units that are simply wrappers for the final user’s code.

emurcx.cpp contains the WinMain entry point of the application. This file should be quite plain to convert.

emurcx.bpp is the makefile in the Borland C++Builder style. Probably you better start your makefile or project file from scratch.

Main.cpp, Main.h and Main.dfm contain the user interface. Here is where the hard work is. Actually you don’t need to mimic our graphic choices for your interface. What you really have to do is to create some functions to pass to emuLegOs as callbacks to make it update your interface when something happens.


			
			// Called to update sensor status on Rcx emulator
			

			void (*updateSensorStatus)(int) = NULL;
			

			void setCallbackUpdateSensorStatus( void (*_updateSensorStatus)(int) );
			

			

			// Called to update motor direction on Rcx emulator
			

			void (*updateMotorDir)(int, MotorDirection) = NULL;
			

			void setCallbackUpdateMotorDir( void (*_updateMotorDir) ( int , MotorDirection
			) );
			

			

			// Called to update motor speed on Rcx emulator
			

			void (*updateMotorSpeed) ( int, unsigned char ) = NULL;
			

			void setCallbackUpdateMotorSpeed( void (*_updateMotorSpeed) ( int, unsigned
			char ) );
			

			

			// Called to update raw sensor values on Rcx emulator
			

			void (*updateSensorRawValues) ( int, unsigned, int ) = NULL;
			

			void setCallbackUpdateSensorRawValues( void (*_updateSensorRawValues) ( int,
			unsigned, int ) );
			

			

			// Called to update lcd on Rcx emulator
			

			void (*updateLcd) ( string ) = NULL;
			

			void setCallbackUpdateLcd( void (*_updateLcd) ( string ) );
			

			

			// Called to show some error message during program emulation
			

			void (*showErrorMessage) ( string ) = NULL;
			

			void setCallbackShowErrorMessage( void (*_showErrorMessage) ( string ) )

About updating the sensor values from the interface, we chose the approach to directly modify the sensor[] public array defined in emuLegOs.h .

Don’t forget you need a copy of the pthreads library. If you stay with the Windows OS the supplied one is OK.

Have luck.