Changes between Version 14 and Version 15 of almosOnTsarDoc

Timestamp:

Aug 21, 2012, 2:10:06 AM (13 years ago)

Author:

almaless

Comment:

--

almosOnTsarDoc

@@ -36 +36 @@
 == Start the simulation ==
 
-Before any use of the distribution package you need to set some environment variables:
+Before '''any use''' of the distribution package you need to set some environment variables:
 
 {{{
@@ -86 +86 @@
  4. Go to your ''DISTRIB/test/pfX'' directory and run the TSAR simulator
  
-Some example of applications source code can be found in ''DISTRIB/test/apps''. Lets try the ''hello_world'' one. The ''main'' function of this application asks the system for the number of online cores (''count'') and then it fires ''count'' threads before it synchronizes on their end. Each fired thread executes the ''thread_func'' function which prints a "Hello World" message.
+Some example of applications source code can be found in ''DISTRIB/apps''. Lets try the ''hello_world'' one. The ''main'' function of this application asks the system for the number of online cores (''count'') and then it fires ''count'' threads before it synchronizes on their end. Each fired thread executes the ''thread_func'' function which prints a "Hello World" message.
 
 To Cross-compile the application using ALMOS headers and static libraries:
 
 {{{
-$ cd DISTRIB/test/apps
+$ cd DISTRIB/apps/hello_world
 $ make TARGET=tsar
 }}}
 
-The result is the ''./hello'' program. To install this program into ALMOS file system (''hdd-img.bin''). Just type:
+The result is the ''./hello'' program for ALMOS. To install this program into ALMOS's file system (''hdd-img.bin''). Just type:
 
 {{{
@@ -126 +126 @@
 That is it ... you are done !!
 
+In a normal situation your application may have some bugs and you need to validate it. The recommended and most convenient method is to test and validate your application on Linux before corss-compiling it for ALMOS. Lets go back to ''DISTRIB/apps/hello_world'' and clean the directory before compiling the same application for Linux:
+
+{{{
+$ cd ''DISTRIB/apps/hello_world''
+$ make realclean
+$ make TARGET=linux
+}}}
+
+This will generate the ''./hello'' program for Linux. To run it, just type:
+
+{{{
+$ ./hello
+}}}
+
+Now, lets take a look to the Makefile:
+
+{{{
+$ cat ./Makefile
+
+FILES=main
+BIN=hello
+ADD-CFLAGS=-O3
+
+HDD=$(ALMOS_TEST)/pf1/hdd-img.bin
+
+include $(ALMOS_TOP)/include/appli.mk
+
+install:
+        mcopy -i $(HDD) $(BIN) ::bin/.
+}}}
+
+The ''ALMOS_TEST'' and ''ALMOS_TOP'' are an environment variables exported by sourcing the ''DISTRIB/SourceMe'' file from the ''DISTRIB'' directory. The fist one is equivalent to ''DISTRIB/test'' directory while the second is equivalent to ''DISTRIB/almos''.
+
+The ''mcopy'' command enables you to copy a file from your host machine file system to a FAT file system image and in particular to the ''hdd-image.bin''. ''mdir'' and ''mdel'' are another two useful utilities from the ''mtools'' package (see man mtools).
+
 == Running without interactive mode ==