trlo_setup_map_hardware

Section: TRLO II Manual (3)
Updated: January 2, 2014
Index Return to Main Contents

NAME

trlo_setup_map_hardware, trlo_setup_check_version, trlo_unmap_hardware - Setup aceess to a TRLO II module.

SYNOPSIS

#include "trlo_functions.h"

volatile trlo_register_map *
  trlo_setup_map_hardware(int vmvk, void **unmapinfo);


void trlo_setup_check_version(volatile trlo_register_map *hardware);

void trlo_unmap_hardware(void *unmapinfo);

Link with -ltrlo_ctrl.

DESCRIPTION

The trlo_setup_map_hardware() function maps the direct access hardware memory to be able to communicate with a VULOM/TRIDI running the TRLO II firmware. vmvk holds the address of the module as given by the two HEX switches. unmapinfo is a pointer to a pointer to optionally store unmap information. It may be NULL.

The returned pointer is used by all other read and control functions. Can also be used directly with the definitions in trlo_defs.h. Note that this function calls trlo_setup_check_version().

The trlo_setup_check_version() function checks that the module/firmware accessible at the virtual address hardware has the same version as the library. This can be used if the memory mapping has been provided elsewhere, without invoking trlo_setup_map_hardware()

trlo_unmap_hardware() is used to release memory mapped by trlo_setup_map_hardware() unmapinfo shall be the pointer value received.

RETURN VALUE

Virtual address pointer to access the module/firmware. (They may terminate the program via error reporting routines.)

AUTHOR

Håkan T. Johansson <f96hajo@chalmers.se>

This document was created by man2html, using the manual pages.
Time: 06:59:52 GMT, November 12, 2023