1/* SPDX-License-Identifier: GPL-2.0-or-later */
2/*
3 *	include/asm-mips/dec/prom.h
4 *
5 *	DECstation PROM interface.
6 *
7 *	Copyright (C) 2002  Maciej W. Rozycki
8 *
9 *	Based on arch/mips/dec/prom/prom.h by the Anonymous.
10 */
11#ifndef _ASM_DEC_PROM_H
12#define _ASM_DEC_PROM_H
13
14#include <linux/types.h>
15
16#include <asm/addrspace.h>
17
18/*
19 * PMAX/3MAX PROM entry points for DS2100/3100's and DS5000/2xx's.
20 * Many of these will work for MIPSen as well!
21 */
22#define VEC_RESET		(u64 *)CKSEG1ADDR(0x1fc00000)
23							/* Prom base address */
24
25#define PMAX_PROM_ENTRY(x)	(VEC_RESET + (x))	/* Prom jump table */
26
27#define PMAX_PROM_HALT		PMAX_PROM_ENTRY(2)	/* valid on MIPSen */
28#define PMAX_PROM_AUTOBOOT	PMAX_PROM_ENTRY(5)	/* valid on MIPSen */
29#define PMAX_PROM_OPEN		PMAX_PROM_ENTRY(6)
30#define PMAX_PROM_READ		PMAX_PROM_ENTRY(7)
31#define PMAX_PROM_CLOSE		PMAX_PROM_ENTRY(10)
32#define PMAX_PROM_LSEEK		PMAX_PROM_ENTRY(11)
33#define PMAX_PROM_GETCHAR	PMAX_PROM_ENTRY(12)
34#define PMAX_PROM_PUTCHAR	PMAX_PROM_ENTRY(13)	/* 12 on MIPSen */
35#define PMAX_PROM_GETS		PMAX_PROM_ENTRY(15)
36#define PMAX_PROM_PRINTF	PMAX_PROM_ENTRY(17)
37#define PMAX_PROM_GETENV	PMAX_PROM_ENTRY(33)	/* valid on MIPSen */
38
39
40/*
41 * Magic number indicating REX PROM available on DECstation.  Found in
42 * register a2 on transfer of control to program from PROM.
43 */
44#define REX_PROM_MAGIC		0x30464354
45
46/* KN04 and KN05 are REX PROMs, so only do the check for R3k systems.  */
47static inline bool prom_is_rex(u32 magic)
48{
49	return !IS_ENABLED(CONFIG_CPU_R3000) || magic == REX_PROM_MAGIC;
50}
51
52/*
53 * 3MIN/MAXINE PROM entry points for DS5000/1xx's, DS5000/xx's and
54 * DS5000/2x0.
55 */
56#define REX_PROM_GETBITMAP	0x84/4	/* get mem bitmap */
57#define REX_PROM_GETCHAR	0x24/4	/* getch() */
58#define REX_PROM_GETENV		0x64/4	/* get env. variable */
59#define REX_PROM_GETSYSID	0x80/4	/* get system id */
60#define REX_PROM_GETTCINFO	0xa4/4
61#define REX_PROM_PRINTF		0x30/4	/* printf() */
62#define REX_PROM_SLOTADDR	0x6c/4	/* slotaddr */
63#define REX_PROM_BOOTINIT	0x54/4	/* open() */
64#define REX_PROM_BOOTREAD	0x58/4	/* read() */
65#define REX_PROM_CLEARCACHE	0x7c/4
66
67
68/*
69 * Used by rex_getbitmap().
70 */
71typedef struct {
72	int pagesize;
73	unsigned char bitmap[];
74} memmap;
75
76
77/*
78 * Function pointers as read from a PROM's callback vector.
79 */
80extern int (*__rex_bootinit)(void);
81extern int (*__rex_bootread)(void);
82extern int (*__rex_getbitmap)(memmap *);
83extern unsigned long *(*__rex_slot_address)(int);
84extern void *(*__rex_gettcinfo)(void);
85extern int (*__rex_getsysid)(void);
86extern void (*__rex_clear_cache)(void);
87
88extern int (*__prom_getchar)(void);
89extern char *(*__prom_getenv)(char *);
90extern int (*__prom_printf)(char *, ...);
91
92extern int (*__pmax_open)(char*, int);
93extern int (*__pmax_lseek)(int, long, int);
94extern int (*__pmax_read)(int, void *, int);
95extern int (*__pmax_close)(int);
96
97
98#ifdef CONFIG_64BIT
99
100/*
101 * On MIPS64 we have to call PROM functions via a helper
102 * dispatcher to accommodate ABI incompatibilities.
103 */
104#define __DEC_PROM_O32(fun, arg) fun arg __asm__(#fun); \
105				 __asm__(#fun " = call_o32")
106
107int __DEC_PROM_O32(_rex_bootinit, (int (*)(void), void *));
108int __DEC_PROM_O32(_rex_bootread, (int (*)(void), void *));
109int __DEC_PROM_O32(_rex_getbitmap, (int (*)(memmap *), void *, memmap *));
110unsigned long *__DEC_PROM_O32(_rex_slot_address,
111			     (unsigned long *(*)(int), void *, int));
112void *__DEC_PROM_O32(_rex_gettcinfo, (void *(*)(void), void *));
113int __DEC_PROM_O32(_rex_getsysid, (int (*)(void), void *));
114void __DEC_PROM_O32(_rex_clear_cache, (void (*)(void), void *));
115
116int __DEC_PROM_O32(_prom_getchar, (int (*)(void), void *));
117char *__DEC_PROM_O32(_prom_getenv, (char *(*)(char *), void *, char *));
118int __DEC_PROM_O32(_prom_printf, (int (*)(char *, ...), void *, char *, ...));
119
120
121#define rex_bootinit()		_rex_bootinit(__rex_bootinit, NULL)
122#define rex_bootread()		_rex_bootread(__rex_bootread, NULL)
123#define rex_getbitmap(x)	_rex_getbitmap(__rex_getbitmap, NULL, x)
124#define rex_slot_address(x)	_rex_slot_address(__rex_slot_address, NULL, x)
125#define rex_gettcinfo()		_rex_gettcinfo(__rex_gettcinfo, NULL)
126#define rex_getsysid()		_rex_getsysid(__rex_getsysid, NULL)
127#define rex_clear_cache()	_rex_clear_cache(__rex_clear_cache, NULL)
128
129#define prom_getchar()		_prom_getchar(__prom_getchar, NULL)
130#define prom_getenv(x)		_prom_getenv(__prom_getenv, NULL, x)
131#define prom_printf(x...)	_prom_printf(__prom_printf, NULL, x)
132
133#else /* !CONFIG_64BIT */
134
135/*
136 * On plain MIPS we just call PROM functions directly.
137 */
138#define rex_bootinit		__rex_bootinit
139#define rex_bootread		__rex_bootread
140#define rex_getbitmap		__rex_getbitmap
141#define rex_slot_address	__rex_slot_address
142#define rex_gettcinfo		__rex_gettcinfo
143#define rex_getsysid		__rex_getsysid
144#define rex_clear_cache		__rex_clear_cache
145
146#define prom_getchar		__prom_getchar
147#define prom_getenv		__prom_getenv
148#define prom_printf		__prom_printf
149
150#define pmax_open		__pmax_open
151#define pmax_lseek		__pmax_lseek
152#define pmax_read		__pmax_read
153#define pmax_close		__pmax_close
154
155#endif /* !CONFIG_64BIT */
156
157
158extern void prom_meminit(u32);
159extern void prom_identify_arch(u32);
160extern void prom_init_cmdline(s32, s32 *, u32);
161
162extern void register_prom_console(void);
163extern void unregister_prom_console(void);
164
165#endif /* _ASM_DEC_PROM_H */
166