/*
* Copyright (c) 2000 The NetBSD Foundation, Inc.
* All rights reserved.
*
* This code is derived from software contributed to The NetBSD Foundation
* by Wayne Knowles
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
* 1. Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
* 2. Redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in the
* documentation and/or other materials provided with the distribution.
*
* THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
* ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
* TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
* PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
* BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
* CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
* SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
* INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
* CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
* ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
* POSSIBILITY OF SUCH DAMAGE.
*/
/*
* Entry points into PROM firmware functions for MIPS machines
*/
/*
* transferred to on hardware reset, configures MIPS boards,
* runs diags, check for appropriate auto boot action in
* "bootmode" environment variable and performs that action.
*/
void (*prom_reset)(void) __attribute__((__noreturn__));
/*
* called to use prom to boot new image. After the booted
* program returns control can either be returned to the
* original caller of the exec routine or to the prom monitor.
* (to return to the original caller, the new program must
* not destroy any text, data, or stack of the parent. the
* new programs stack continues on the parents stack.
*/
int (*prom_exec)(void);
/* re-enter the prom command parser, do not reset prom state */
void (*prom_restart)(void) __attribute__((__noreturn__));
/* reinitialize prom state and re-enter the prom command parser */
void (*prom_reinit)(void) __attribute__((__noreturn__));
/* reboot machine using current bootmode setting. No diags */
void (*prom_reboot)(void) __attribute__((__noreturn__));
/* perform an autoboot sequence, no configuration or diags run */
void (*prom_autoboot)(void) __attribute__((__noreturn__));
/*
* these routines access prom "saio" routines, and may be used
* by standalone programs that would like to use prom io
*/
int (*prom_open)(char *, int, ...);
int (*prom_read)(int, void *, int);
int (*prom_write)(int, void *, int);
int (*prom_ioctl)(int, long, ...);
int (*prom_close)(int);
int (*prom_getchar)(void);
int (*prom_putchar)(int c);
void (*prom_showchar)(int c);
char * (*prom_gets)(char *s);
void (*prom_puts)(const char *);
int (*prom_printf)(const char *, ...);
/*
* read-modify-write routine use special CPU board circuitry to
* accomplish vme bus r-m-w cycles.
*/
void (*prom_orw_rmw)(void);
void (*prom_orh_rmw)(void);
void (*prom_orb_rmw)(void);
void (*prom_andw_rmw)(void);
void (*prom_andh_rmw)(void);
void (*prom_andb_rmw)(void);
/*
* cache control entry points
* flushcache is called without arguments and invalidates entire
* contents of both i and d caches
* clearcache is called with a base address and length (where
* address is either K0, K1, or physical) and clears both
* i and d cache for entries that alias to specified address
* range.
*/
void (*prom_flushcache)(void);
void (*prom_clearcache)(void *, size_t);
/*
* clear existing fault handlers
* used by clients that link to prom on situations where client has
* interrupted out of prom code and wish to reenter without being
* tripped up by any pending prom timers set earlier.
*/
void (*prom_clearnofault)(void);
void (*prom_notimpl)(void);
/*
* PROM_NVGET, PROM_NVSET will get/set information in the NVRAM.
* Both of these routines take indexes as opposed to addresses
* to guarantee portability between various platforms
*/
int (*prom_nvget)(int);
void (*prom_nvset)(void);
};
extern struct mips_prom *callv;
extern void prom_init(void);
#endif /* _LOCORE */
/*
* Macro to help call a prom function
*/
#define MIPS_PROM(func) (callv->prom_##func)
/*
* Return the address for a given prom function number
*/
#define MIPS_PROM_ENTRY(x) (0xbfc00000+((x)*8))
/*
* MIPS PROM firmware functions:
*
* MIPS_PROM_RESET Run diags, check bootmode, reinit.
* MIPS_PROM_EXEC Load new program image.
* MIPS_PROM_RESTART Re-enter monitor command loop.
* MIPS_PROM_REINIT Re-init monitor, then cmd loop.
* MIPS_PROM_REBOOT Check bootmode, no config.
* MIPS_PROM_AUTOBOOT Autoboot the system.
*
* The following routines access PROM saio routines and may be used by
* standalone programs that would like to use PROM I/O:
*
* MIPS_PROM_OPEN Open a file.
* MIPS_PROM_READ Read from a file.
* MIPS_PROM_WRITE Write to a file.
* MIPS_PROM_IOCTL Ioctl on a file.
* MIPS_PROM_CLOSE Close a file.
* MIPS_PROM_GETCHAR Read character from console.
* MIPS_PROM_PUTCHAR Put character on console.
* MIPS_PROM_SHOWCHAR Show a char visibly.
* MIPS_PROM_GETS gets with editing.
* MIPS_PROM_PUTS Put string to console.
* MIPS_PROM_PRINTF Kernel style printf to console.
*
* PROM protocol entry points:
*
* MIPS_PROM_INITPROTO Initialize protocol.
* MIPS_PROM_PROTOENABLE Enable protocol mode.
* MIPS_PROM_PROTODISABLE Disable protocol mode.
* MIPS_PROM_GETPKT Get protocol packet.
* MIPS_PROM_PUTPKT Put protocol packet.
*
* Atomic Read-Modify-Write functions
*
* MIPS_PROM_RMW_OR32 r-m-w OR word.
* MIPS_PROM_RMW_OR16 r-m-w OR halfword.
* MIPS_PROM_RMW_OR8 r-m-w OR or byte.
* MIPS_PROM_RMW_AND32 r-m-w AND word.
* MIPS_PROM_RMW_AND16 r-m-w AND halfword.
* MIPS_PROM_RMW_AND8 r-m-w AND byte.
*
* MIPS_PROM_FLUSHCACHE Flush entire cache ().
* MIPS_PROM_CLEARCACHE Clear I & D cache in range (addr, len).
* MIPS_PROM_SETJMP Save registers in a buffer.
* MIPS_PROM_LONGJMP Get register back from buffer.
* MIPS_PROM_BEVUTLB utlbmiss boot exception vector
* MIPS_PROM_GETENV Gets a string from system environment.
* MIPS_PROM_SETENV Sets a string in system environment.
* MIPS_PROM_ATOB Converts ascii string to number.
* MIPS_PROM_STRCMP Compares strings (strcmp).
* MIPS_PROM_STRLEN Length of string (strlen).
* MIPS_PROM_STRCPY Copies string (strcpy).
* MIPS_PROM_STRCAT Appends string (strcat).
* MIPS_PROM_PARSER Command parser.
* MIPS_PROM_RANGE Address range parser
* MIPS_PROM_ARGVIZE Parses string to argc,argv.
* MIPS_PROM_HELP Help on prom commands.
* MIPS_PROM_DUMP Dump memory command.
* MIPS_PROM_SETENVCMD Setenv command.
* MIPS_PROM_UNSETENVCMD Unsetenv command.
* MIPS_PROM_PRINTENV Print environment command.
* MIPS_PROM_BEVEXCEPT General boot exception vector
* MIPS_PROM_ENABLE Performs prom enable command.
* MIPS_PROM_DISABLE Performs prom disable command.
* MIPS_PROM_CLEARNOFAULT Clear existing fault handlers.
* MIPS_PROM_NOTIMPL Guaranteed to be not implemented
* MIPS_PROM_NVGET Read bytes from NVRAM
* MIPS_PROM_NVSET Write bytes to NVRAM
*/
