Page 1
MB86290 Series Map Driver Operation Manual
August 15 ‘01
(Rev.1.0)
Page 2
All Right Reserved.
The information contained in this document has been carefully checked and is believed to be reliable. However ,
Fujitsu Limited assumes no responsibility for inaccuracies. The information conveyed in this document does not
convey any license under the copyrights, patent rights or trademarks cl aimed and owned by Fujits u Limited, or it s
subsidiaries. Fujitsu Limited reserves the right to change products or specifications without notice. No part of the
publication may be copied reproduced in any form or by any means, or transferred to any third party without prior
written consent of Fujitsu Limited.
Copyright © FUJITSU LIMITED 1998-2001
Page 3
Revision history
Date Rev. Page Change
August 15, 2001 1.0 3 First release
(Revision history:1/1)
Page 4
Index
Index
IndexIndex
1.
1. FUNCTIONAL OVERVIEW
FUNCT IONA L O VER V IEW................................
1.1.
FUNCTIONAL OVERVIEWFUNCTIONAL OVERVIEW
2.
2. CONFIGURA T ION
CONFI GU RATION................................
2.2.
CONFIGURA T IONCONFIGURA T ION
3.
3. OPERA TION PROC EDURE
OPERATION PROC ED UR E................................
3.3.
OPERA TION PROC EDUREOPERA TION PROC EDURE
1. INSTA LLATION OF KERNEL DRIVER.........................................................................................................1
2. PROGRAMMI NG OF APPLICA TI ON SOFTWARE..........................................................................................1
3. PROGRAM SAMPLES.................................................................................................................................2
4. MAP DRIVER COMMAND OVERVIEW .......................................................................................................2
5. MAP DRIVER COMMAND INTERFACE SPECIFICATIONS ..........................................................................3
................................................................
................................................................
................................................................
................................................................
................................................................
................................................................
................................................................
................................................................
................................................................
................................................................
.............................................................
................................................................
................................................................
................................................................
..............................................
................................................................
.............................1111
..........................................................
.............................................
................................................................
..............1111
............................
.............1111
..........................
ii
Page 5
1.
1. Functional Overview
Functional Overview
1.1.
Functional OverviewFunctional Overview
This driver is software to access to MB86290 Series r egisters, from W indows NT 4.0/2000 application programs.
This driver consists of two drivers, the kernel driver(WinDriver(*1)) which operates in kernel mode, and the map
driver(Map Driver ) which oper ates in user mode. Map Dr iver cooper ates with W inD river and op erates.
(*1)WinDriver is the driver of a XLsoft corporation.
2.
2. Configuration
Configuration
2.2.
ConfigurationConfiguration
APPLICATION
User Mode
Kernel Mode
WinDriver
(windrvr.sys)
Map Driver
(mapdrv.dll)
3.
3. Operation Procedure
Operation Procedure
3.3.
Operation ProcedureOperation Procedure
1.
1. Installation of kernel driver
Installation of kernel driver
1.1.
Installation of kernel driverInstallation of kernel driver
(1) Install the kernel driver (windrvr.sys) at first. Copy the “windrvr.sys” file to the following Windows NT4.0/2000 system directory:
(2) Please open DOS command prompt, move to mapdrv directory, and input the following commands.
WDREG.EXE install
A kernel driver is started automatically.
2.
2. Programming of applicatio n sof tware
Programming of applicatio n sof tware
2.2.
Programming of applicatio n sof tware Programming of applicatio n sof tware
(1) The Map Dri ver funct ion accessed to a regis ter is used . The fil es to be used are “ma pdrv.d ll” a nd “ma pdrv.l ib”.
(2) Every application program must call initialization routine (Open_Cremson) first, and at the completion of it’s operation a close
operation routine (Close_Cremson) must be called. If this closing process is not executed, this utility can never be used after it.
(3) In order to perform READ/WRITE of a register, please call the Map Driver function which gets the top address of each register, and
READ/WRITE of the value of the address added with offset value. Details of these commands are described in chapter 5 “Map Driver
command interface specifications”.
(4) If app licati on program i s attemp ted to execu te withou t start ing the kernel driver, a n error occurs.
1
Page 6
3.
3. Program sa
Program samples
3.3.
Program saProgram sa
A program sample to read data from MMR register (address offset 0xfffc) of the host interface is shown as follows:
#include "gdc.h"
#include <stdio.h>
extern int Open_Cremson(void );
extern void Close_Cremson(void );
extern GDC_ULONG Get_HostAddress(void);
void main(){
int ret;
ret = Open_Cremson();
if(ret != GDC_TRUE){
return;
} else {
data = *((GDC_ULONG *)Get_HostAddress() + (0xfffc>>2));
printf("register = %08x¥n",data);
}
Close_Cremson();
}
mples
mplesmples
GDC_ULONG data;
4.
4. Map Driver comm
Map Driver command overview
4.4.
Map Driver commMap Driver comm
# Command name Description
1 Open_Cremson Opens the Map Driver
2 Close_Cremson Closes the Map Driver
3 Get_FrameAddress Gets the top address of th e frame memory
4 Get_HostAddress Gets the top address of the host interface regist ers
5 Get_DisplayAddress Gets the top address of the display control registers
6 Get_DrawingAddress Gets the top address of drawing control register s
and overview
and overviewand overview
2
Page 7
5.
5. Map Driver command in terf ace sp ecif ication s
Map Driver command in terf ace sp ecif ication s
5.5.
Map Driver command in terf ace sp ecif ication sMap Driver command in terf ace sp ecif ication s
(1) Open_Cremson
a. Format int Open_C remson (v oid)
b. Parameter None
c. Return value Normal : GDC_TRUE
Abnormal end : GDC_FALSE
d. Function Opens the Map D river. Unless this comma nd is s uccessful ly executed , no other comman d is ap pli cable.
(2) Close_Cremson
a. Format void Close_Cremson (void)
b. Parameter None
c. Return value None
d. Function Closes the Map Driver. If an application program is completed unless calling this command,
no more utility command could be used..
(3) Get_FrameAddress
a. Format GDC_ULONG Get _FrameAdd ress (v oid)
b. Parameter None
c. Return value Top address of the frame buffer
d. Function Gets the top ad dress of the fra me memory
(4) Get_HostAddress
a. Format GDC_ULONG Get_HostAddress (void)
b. Parameter None
c. Return value Top address of the host interfa ce registers
d. Function Gets the top add ress of t he host in terface regi sters
(5) Get_DisplayAddress
a. Format GDC_ULONG Get_DisplayAddress (void)
b. Parameter None
c. Return value Top address of the display control registers
d. Function Gets the top add ress of t he dis play control regis ters
(6) Get_DrawingAddress
a. Format GDC_ULONG Get_DrawingAddress (void)
b. Parameter None
c. Return value Top address of the drawing control registers
d. Function Gets the top add ress of t he dra wing cont rol registers
3
Loading...