DEVELOPER'S ZONE
   ▷ DOWNLOAD
   ▷ Dev. Forum
CONTACT US


-Sales
 Tel : +82-31-243-3745
 Fax : +82-31-243-3708
 Email:Gameplus@gmail.com

 -Customer Support
 Tel : +82-31-243-3745
 Fax : +82-31-243-3708
 Email:Gameplus@gmail.com

 -ADDRESS

 GamePlus CO. Ltd.
 164-57,Yeonghwa-dong,
 Jangan-Gu,Suwon-si,
 Gyeonggi-do KOREA
 

Dev. Forum < HitBox3 >
  1. Introduction
   1.1 Document Introductin
  2. API Functions
   2.1 3D Graphic
   2.2 Sound
   2.3 I/O
   2.4 BackUp
   2.5 RTC
   2.6 NetWork
   2.7 Math Funtion
  3. Basic Command for Embedded Linux
   3.1 Basic Command
 
 



1.Introduction
  1.1 Document Introduction

- This document is related with Acrade 2D, 3D Game board HitBox3. It will describe H/W and S/W and specifically, how to use the HitBox Developer Suite (Development Kit) and API. And also the Strong points and basic instructions of HitBox3 Enbedded Linux.



2. API Functions
  2.1 3D Graphic

- Description
   The 3D Core of HitBox3 supports 1024*768 resolution and 16bit color And also 2 Multi-Texting, perspective correction, sub texel accuracy, bilinear filtering, Mpeg video Texture, W-Based picel fog, alpha blending, digthering and etc. are Suppored. And HitBox3 has GTE(Geometric Transform Engine) which is very similar with Vertex shader.

3D Graphic is provided used as drviver under Linux environment. and the driver is divided as Hardware Control prat and Graphic Memory Controller. And these can be used through api Library, which supplied together.


For the GTE, please refer to the complier and manual, provided togther. After creating code through complier, the function supplied to API can be used.


- Functions

  gp_init_3dclose_3d// driver related
 
gp_set_render_stategp_set_blend_factorgp_set_color_key
gp_set_mipmap_biasgp_set_fog_colorgp_set_fog_maxz
gp_set_fog_tablegp_set_viewport 
 
// vertex operations  
gp_vbuf gp_create_vertex_bufgp_release_vertex_bufgp_lock_vertex_buf
gp_unlock_vertex_bufgp_set_vertex_buf0gp_set_vertex_buf1
gp_set_vertex_buf2ggp_set_vertex_buf3 
 
// texture operations  
gp_tex gp_create_texturegp_release_texturegp_set_texture0
gp_set_texture1gp_set_texture0_blendgp_set_texture1_blend
 
// gte operation  
gp_set_gte_codegp_set_gte_const 
 
// screen operation  
gp_clear_screengp_async_flipgp_sync_flip
gp_3d_screen_enablegp_3d_screen_disable 
 
// zbuffer operation  
gp_clear_zbuffergp_set_zbuffergp_set_zfunc
 
// tse operation // bmp operation 
gp_tseloadbmp 




  2.2 Sound

- Description
   HitBox3 uses OpenAL for Sound. So please refer to following documents.


- Provided Documents
   OpenAL1-1Spec.pdf
   OpenAL_Programmmers_Guide.pdf



  2.3 I/O

- Description
   HitBox3 has total 48ea. of I/O. Those are input 24 ( jamma 16 + sensor 8 ) and output ( motor 24).

   Jamma and Sensor receive each input, and output. And when the system starts, motor are all in enable condition.

- Functions

  gp_io_initgp_io_close// driver related
 
gp_get_jammagp_get_sensor// related with response and setting of each bit
gp_set_motor1gp_motor2 
 
  gp_motor_out gp_hop_out // CON out Related
gp_gift_outgp_lamp_out 
gp_push_outgp_bill_out 
 
gp_sensor_ingp_hop_in // CON in Related
gp_gift_ingp_bill_in 
 
// In Related  
gp_input_p1gp_input_p2gp_input_p3
gp_input_p4gp_input_p5gp_input_p6
gp_input_p7gp_input_p8gp_input_p9
gp_input_p10gp_input_p11gp_input_p12
gp_input_b1gp_input_b2gp_input_b3
gp_input_b4gp_input_b5gp_input_b6
gp_input_b7gp_input_b8gp_input_b9
gp_input_b10gp_input_b11gp_input_b12
 
// Out Related  
gp_output_p1gp_output_p2gp_output_p3
gp_output_p4gp_output_p5gp_output_p6
gp_output_p7gp_output_p8gp_output_p9
gp_output_p10gp_output_p11gp_output_p12
gp_output_b1gp_output_b2gp_output_b3
gp_output_b4gp_output_b5gp_output_b6
gp_output_b7gp_output_b8gp_output_b9
gp_output_b10gp_output_b11gp_output_b12




  2.4 Backup Memory

- Description
   HitBox3 has 128kbyte of backup memory and each block has 61339byte. There are total 2 blocks. And when data is written on backup memory, it is stored on the two blocks at the same time.

   The unit of each page os 64byte and there is one checksum data on each page. When a user write data on backup memory, page calculate the location automatically. So the user doesn't have to convern about the checksum table.

   Checksum table is updated only when the backup memory is written. And in case of reading, check the correspondence of checksum table and backup data then provide the message whether the data has problem or not.



- Funtions

  gp_backup_init
gp_backup_close
gp_checksum_table
gp_read_backup_mem
gp_write_backup_mem
gp_read_check_page
gp_writeh_check_page




  2.5 RTC

- Description
   HitBox3 provide with RTC (Real Time Control ) through DS1337. Read and Write os possible through 12C.

    When you set RTC and system time, you should not use Linux date command but system date and RTC will be different.

* The rtc_time structure, whitch are used for each function, is defind at rtc.h and those are as follows,

struct rtc_time {
       int tm_sec;
       int tm_min;
       int tm_hour;
       int tm_mday;
       int tm_mon;
       int tm_year;
       int tm_wday;
       int tm_yday;
       int tm_isdst;
};


- Function
gp_rtc_init
gp_rtc_close
gp_get_rtc
gp_set_rtc
  2.6 NetWork

- Description
    HitBox3 LAN use cs8900 Network chip. For basic use, user can use Linux function. But at first activation, you should notify to Hitbox3 that you use LAN.


- Function

gp_dhcp_enable
gp_fix_ip_enable
  2.7 Math Function

- Description
    HitBox3 uses ARM 920T CPU. This CPU has excellent performances but it does not supports float operation. So compiler should do float operation instead but because it is very complicated and heavy, HitBox3 provides separate function for float operation.


-Function

gp_sin
gp_cos
gp_tan
gp_sqrt
3. Basic Command Embeded Linux.
  3.1 Basic Command

  There will be no problem, if you know 2 instruction code in case you execute a program on hitbox3. But for faster work process and to use the good points of Linux, it will boe helpful that you know some basic instruction codes.
 


    



Copyright (C) Since1996 Gameplus Co. Ltd. ALL RIGHT RESERVED.
Product
    - Hit Box3
    - Hit Box2
    - Hit Box2-S
    - GP 100
    - ZENIETH Duo
Special features of
GAMEPLUS' Game Platform

1. Stability - Gameplus' products do not have any problems when they are run for a long time
2. Full protection
3. Stability of back-up memory
4. Our own development suit
5. Possibilities of mass production
6. Possibilities of changing the product design according to the consumer's request