Pk howto - Revision history

Felix at 03:24, 6 September 2006

2006-09-06T03:24:50Z

Felix at 03:24, 6 September 2006

2006-09-06T03:24:00Z

Felix at 03:15, 6 September 2006

2006-09-06T03:15:02Z

Felix at 02:57, 6 September 2006

2006-09-06T02:57:00Z

New page

The typical Phantom development flow is

development of the title -> compilation -> creating the disk structure -> mkisofs -> blessiso -> sign

all steps are obvious besides, may be, creating of the disk structure.

here is the sample disk structure
/
|
+---Phantom.sys
|
|
+---foo
| |
| |
| +--- foo2.elf
|
+--- autostart.cmd

where -- '''Phantom.sys''' is directory, supplied with Phantom SDK, just copy it to the root of the disk; foo -- sample directory, foo2.elf -- sample file executable file, autostart.cmd -- script, executed upon disk booting.

In order to sucessfully initialize Phantom SDK one should include following lines in the begining of the autostart.cmd

!kernel.complete
!graphics.load
!sound.load
!hardware.complete
!hardware.authorize
!device.load
!device.createevents
/foo/foo2.elf

where foo2.elf -- is name of your main executable, which should start upon disk boot-up.

@@ Line 50: / Line 50: @@
+  {
     int maintask;// this will be our task handler
-//
+  //
-//
+  //
     pg_init(); // init of graphics subsystem
     pc_init(); // init of control subsystem
     ps_init(); // init of systemwide parameters, including libc
-//
+  //
     maintask=pk_createtask(task1,100);//task creation -- priority is set to average (255 - max. 0 - min)
-//
+  //
-//
+  //
     while(maintask) // waiting for task completion -- the handler of destroyed task will be 0
       pk_yield();   // yield CPU time to any one.... be nice to others
-//
+  //
     pk_destroytask(main); //perform suicide :)
+  }
-//
+ //
-//
+ //
   int task1(void * param1,void * param2)
+  {
      int m_vbl; /// our vbl handler
      int m_bitmap; // our bitmap handler
-//
+ //
      m_vbl=pg_createvbl(VBL_DEFAULT); // create standard vbl
-//
+ //
      m_bitmap=pg_createbitmap(320,240,16); // create bitmap, 320x240 pixels with 16 bit colors
-//
+ //
      pg_attachstream(m_bitmap,stdio);      // attach our stdio stream, to appear on bitmap as text
      pg_vblattachbitmap(m_vbl,m_bitmap);   // attach our bitmap to our vbl -- currently no other parameters
      pg_applyvbl(m_vbl);                   // attach our vbl into system display list -- enables our display
-//
+ //
      printf("Hello world\n");
      printf("(c) 2006 Felix.\n");          // :)
-//
+ //
      while(pc_padhit(0)==0)          //wait for any button press on joypad 0
        pk_yield();                   //be nice to others
-//
+ //
      pg_attachstream(m_bitmap,0);    // remove stream attachement
      pg_removevbl(m_vbl);            // remove our vbl from system display list --- at this point all user will see is a blank screen
@@ Line 90: / Line 90: @@
      pg_destroybitmap(m_bitmap);          // destroy our bitmap
      pg_destroyvbl(m_vbl);                // destroy our vbl
-//
+ //
      pk_destroytask(task1);              // perform suicide
+  }

@@ Line 42: / Line 42: @@
   #include <phantom.h>
   #include <stdio.h>
+ //
   int task1(void * param1,void * param2);
+  //
+ //our main
   void main()
+  {
-    int maintask;
+    int maintask;// this will be our task handler
+//
-    pg_init();
+//
-    pc_init();
+    pg_init(); // init of graphics subsystem
-    ps_init();
+    pc_init(); // init of control subsystem
+    ps_init(); // init of systemwide parameters, including libc
-    maintask=pk_createtask(task1,100);
+//
+    maintask=pk_createtask(task1,100);//task creation -- priority is set to average (255 - max. 0 - min)
-    while(maintask)
+//
-      pk_yield();
+//
+    while(maintask) // waiting for task completion -- the handler of destroyed task will be 0
-    pk_destroytask(main);
+      pk_yield();   // yield CPU time to any one.... be nice to others
+  }
+//
   int task1(void * param1,void * param2)
+  {
-     int m_vbl;
+     int m_vbl; /// our vbl handler
-     int m_bitmap;
+     int m_bitmap; // our bitmap handler
+//
-     m_vbl=pg_createvbl(VBL_DEFAULT);
+     m_vbl=pg_createvbl(VBL_DEFAULT); // create standard vbl
-     m_bitmap=pg_createbitmap(320,240,16);
+//
-     pg_attachstream(m_bitmap,stdio);
+     m_bitmap=pg_createbitmap(320,240,16); // create bitmap, 320x240 pixels with 16 bit colors
-     pg_vblattachbitmap(m_vbl,m_bitmap);
+//
-     pg_applyvbl(m_vbl);
+     pg_attachstream(m_bitmap,stdio);      // attach our stdio stream, to appear on bitmap as text
+     pg_vblattachbitmap(m_vbl,m_bitmap);   // attach our bitmap to our vbl -- currently no other parameters
      printf("Hello world\n");
-     printf("(c) 2006 Felix.\n");
+     printf("(c) 2006 Felix.\n");          // :)
+//
-     while(pc_padhit(0)==0)
+     while(pc_padhit(0)==0)          //wait for any button press on joypad 0
-       pk_yield();
+       pk_yield();                   //be nice to others
+//
-     pg_attachstream(m_bitmap,0);
+     pg_attachstream(m_bitmap,0);    // remove stream attachement
-     pg_removevbl(m_vbl);
+     pg_removevbl(m_vbl);            // remove our vbl from system display list --- at this point all user will see is a blank screen
-     pg_vblremovebitmap(m_bitmap);
+     pg_vblremovebitmap(m_vbl,m_bitmap);   // remove our bitmap from our vbl
-     pg_destroybitmap(m_bitmap);
+     pg_destroybitmap(m_bitmap);          // destroy our bitmap
-     pg_destroyvbl(m_vbl);
+     pg_destroyvbl(m_vbl);                // destroy our vbl
+//
-     pk_destroytask(task1);
+     pk_destroytask(task1);              // perform suicide
+  }

←Older revision		Revision as of 03:15, 6 September 2006
Line 36:		Line 36:

	where foo2.elf -- is name of your main executable, which should start upon disk boot-up.		where foo2.elf -- is name of your main executable, which should start upon disk boot-up.
		+
		+	And here is the sample "Hello world" program.
		+
		+
		+	#include <phantom.h>
		+	#include <stdio.h>
		+
		+	int task1(void * param1,void * param2);
		+
		+
		+	void main()
		+	{
		+	int maintask;
		+
		+	pg_init();
		+	pc_init();
		+	ps_init();
		+
		+	maintask=pk_createtask(task1,100);
		+
		+	while(maintask)
		+	pk_yield();
		+
		+	pk_destroytask(main);
		+	}
		+
		+	int task1(void * param1,void * param2)
		+	{
		+	int m_vbl;
		+	int m_bitmap;
		+
		+	m_vbl=pg_createvbl(VBL_DEFAULT);
		+	m_bitmap=pg_createbitmap(320,240,16);
		+	pg_attachstream(m_bitmap,stdio);
		+	pg_vblattachbitmap(m_vbl,m_bitmap);
		+	pg_applyvbl(m_vbl);
		+
		+	printf("Hello world\n");
		+	printf("(c) 2006 Felix.\n");
		+
		+	while(pc_padhit(0)==0)
		+	pk_yield();
		+
		+	pg_attachstream(m_bitmap,0);
		+	pg_removevbl(m_vbl);
		+	pg_vblremovebitmap(m_bitmap);
		+	pg_destroybitmap(m_bitmap);
		+	pg_destroyvbl(m_vbl);
		+
		+	pk_destroytask(task1);
		+	}