/*
/////////////////////////////////////////////////////////////////////////////
// $Header$
//
// Copyright (c) 2000 - Rosimildo da Silva
//
// MODULE DESCRIPTION:
// Wrapper API around the ioctls calls for the Micro FrameBuffer
// interface for Embedded Systems
//
// All functions returns 0 on success. Any other value should be
// decoded as an error. A list of errors will be created over time.
//
// MODIFICATION/HISTORY:
//
// $Log$
// Revision 1.3 2004/04/15 13:24:46 ralf
// Remove stray white spaces.
//
// Revision 1.2 2003/07/08 08:38:48 ralf
// 2003-07-08 Ralf Corsepius <corsepiu@faw.uni-ulm.de>
//
// * capture/capture-cli.c: Add config-header support.
// * capture/capture.c: Add config-header support.
// * cpuuse/cpuuse.c: Add config-header support.
// * devnull/devnull.c: Add config-header support.
// * dummy/dummy.c: Add config-header support.
// * dumpbuf/dumpbuf.c: Add config-header support.
// * monitor/mon-command.c: Add config-header support.
// * monitor/mon-config.c: Add config-header support.
// * monitor/mon-dname.c: Add config-header support.
// * monitor/mon-driver.c: Add config-header support.
// * monitor/mon-extension.c: Add config-header support.
// * monitor/mon-itask.c: Add config-header support.
// * monitor/mon-manager.c: Add config-header support.
// * monitor/mon-monitor.c: Add config-header support.
// * monitor/mon-mpci.c: Add config-header support.
// * monitor/mon-object.c: Add config-header support.
// * monitor/mon-prmisc.c: Add config-header support.
// * monitor/mon-queue.c: Add config-header support.
// * monitor/mon-server.c: Add config-header support.
// * monitor/mon-symbols.c: Add config-header support.
// * monitor/mon-task.c: Add config-header support.
// * mw-fb/mw_fb.c: Add config-header support.
// * mw-fb/mw_uid.c: Add config-header support.
// * rtmonuse/rtmonuse.c: Add config-header support.
// * serdbg/serdbg.c: Add config-header support.
// * serdbg/serdbgio.c: Add config-header support.
// * serdbg/termios_printk.c: Add config-header support.
// * shell/cmds.c: Add config-header support.
// * stackchk/check.c: Add config-header support.
// * untar/untar.c: Add config-header support.
//
// Revision 1.1 2000/08/30 08:21:24 joel
// 2000-08-26 Rosimildo da Silva <rdasilva@connecttel.com>
//
// * Added generic Micro FrameBuffer interface for MicroWindows.
// This interface allows MicroWindows to under RTEMS. A sample
// driver has been developed for the pc386 BSP. See
// pc386/fb_vga.c as a sample.
// * Added Uniform Input Device interface for MicroWindows.
// See PC386 bsp for sample drivers for mouse and keyboard (console).
// * mw-bf: New directory.
// * Makefile.am, configure.in, wrapup/Makefile.am: Account for mw-fb.
// * mw-fb/Makefile.am: New file.
// * mw-fb/mw_fb.c: New file.
// * mw-fb/mw_fb.h: New file.
// * mw-fb/mw_uid.c: New file.
// * mw-fb/mw_uid.h: New file.
//
//
/////////////////////////////////////////////////////////////////////////////
*/
#ifdef HAVE_CONFIG_H
#include "config.h"
#endif
#include <sys/ioctl.h>
#include <rtems/mw_fb.h>
/*
* This function returns the information regarding the display.
* It is called just after the driver be opened to get all needed
* information about the driver. No change in the mode of operation
* of the driver is done with this call.
*/
int ufb_get_screen_info( int fd, struct fb_screeninfo *info )
{
return ioctl( fd, FB_SCREENINFO, ( void *)info);
}
/*
* Returns the mode of the graphics subsystem
*/
int ufb_get_mode( int fd, int *mode )
{
struct fb_exec_function exec;
exec.func_no = FB_FUNC_GET_MODE;
exec.param = ( void *)mode;
return ioctl( fd, FB_EXEC_FUNCTION , ( void *)&exec );
}
/*
* Returns the current collor pallete
*/
int ufb_get_palette( int fd, struct fb_cmap *color )
{
return ioctl( fd, FB_GETPALETTE, ( void *)color );
}
/*
* Set the current collor pallete
*/
int ufb_set_palette( int fd, struct fb_cmap *color )
{
return ioctl( fd, FB_SETPALETTE, ( void *)color );
}
/*
* Does all necessary initialization to put the device in
* graphics mode
*/
int ufb_enter_graphics( int fd, int mode )
{
struct fb_exec_function exec;
exec.func_no = FB_FUNC_ENTER_GRAPHICS;
exec.param = ( void *)mode;
return ioctl( fd, FB_EXEC_FUNCTION , ( void *)&exec );
}
/*
* Switch the device back to the default mode of operation.
* In most cases it put the device back to plain text mode.
*/
int ufb_exit_graphics( int fd )
{
struct fb_exec_function exec;
exec.func_no = FB_FUNC_EXIT_GRAPHICS;
exec.param = 0;
return ioctl( fd, FB_EXEC_FUNCTION , ( void *)&exec );
}
/*
* Tell the driver that the "virtual buffer" is dirty, and an update
* of it to the real device, maybe a serial/parallel LCD or whatever
* is required
*/
int ufb_buffer_is_dirty( int fd )
{
struct fb_exec_function exec;
exec.func_no = FB_FUNC_IS_DIRTY;
exec.param = 0;
return ioctl( fd, FB_EXEC_FUNCTION , ( void *)&exec );
}
/*
* This function maps the physical ( kernel mode ) address of the framebuffer device
* and maps it to the user space address.
*/
int ufb_mmap_to_user_space( int fd, void **fb_addr, void *physical_addr, unsigned long size )
{
#ifdef __rtems__
/* RTEMS runs in ring 0, and there is no distinction between
user space and kernel space, so we just return the same
pointer to the caller.
*/
*fb_addr = physical_addr;
return 0;
#else
/* other kernels might want to map it to the user space,
maybe using mmap()
*/
return 0;
#endif
}
/*
* This function unmaps memory of the FB from the user's space
*/
int ufb_unmmap_from_user_space( int fd, void *addr )
{
return 0;
}