Quelle  openprom.h   Sprache: C

/* SPDX-License-Identifier: GPL-2.0 */
#ifndef __SPARC_OPENPROM_H
#define __SPARC_OPENPROM_H

/* openprom.h:  Prom structures and defines for access to the OPENBOOT
 *              prom routines and data areas.
 *
 * Copyright (C) 1995,1996 David S. Miller (davem@caip.rutgers.edu)
 */

/* Empirical constants... */
#define LINUX_OPPROM_MAGIC      0x10010407

#ifndef __ASSEMBLY__
#include <linux/of.h>

/* V0 prom device operations. */
struct linux_dev_v0_funcs {
 int (*v0_devopen)(char *device_str);
 int (*v0_devclose)(int dev_desc);
 int (*v0_rdblkdev)(int dev_desc, int num_blks, int blk_st, char *buf);
 int (*v0_wrblkdev)(int dev_desc, int num_blks, int blk_st, char *buf);
 int (*v0_wrnetdev)(int dev_desc, int num_bytes, char *buf);
 int (*v0_rdnetdev)(int dev_desc, int num_bytes, char *buf);
 int (*v0_rdchardev)(int dev_desc, int num_bytes, int dummy, char *buf);
 int (*v0_wrchardev)(int dev_desc, int num_bytes, int dummy, char *buf);
 int (*v0_seekdev)(int dev_desc, long logical_offst, int from);
};

/* V2 and later prom device operations. */
struct linux_dev_v2_funcs {
 phandle (*v2_inst2pkg)(int d); /* Convert ihandle to phandle */
 char * (*v2_dumb_mem_alloc)(char *va, unsigned int sz);
 void (*v2_dumb_mem_free)(char *va, unsigned int sz);

 /* To map devices into virtual I/O space. */
 char * (*v2_dumb_mmap)(char *virta, int which_io, unsigned int paddr, unsigned int sz);
 void (*v2_dumb_munmap)(char *virta, unsigned int size);

 int (*v2_dev_open)(char *devpath);
 void (*v2_dev_close)(int d);
 int (*v2_dev_read)(int d, char *buf, int nbytes);
 int (*v2_dev_write)(int d, const char *buf, int nbytes);
 int (*v2_dev_seek)(int d, int hi, int lo);

 /* Never issued (multistage load support) */
 void (*v2_wheee2)(void);
 void (*v2_wheee3)(void);
};

struct linux_mlist_v0 {
 struct linux_mlist_v0 *theres_more;
 unsigned int start_adr;
 unsigned int num_bytes;
};

struct linux_mem_v0 {
 struct linux_mlist_v0 **v0_totphys;
 struct linux_mlist_v0 **v0_prommap;
 struct linux_mlist_v0 **v0_available; /* What we can use */
};

/* Arguments sent to the kernel from the boot prompt. */
struct linux_arguments_v0 {
 char *argv[8];
 char args[100];
 char boot_dev[2];
 int boot_dev_ctrl;
 int boot_dev_unit;
 int dev_partition;
 char *kernel_file_name;
 void *aieee1;           /* XXX */
};

/* V2 and up boot things. */
struct linux_bootargs_v2 {
 char **bootpath;
 char **bootargs;
 int *fd_stdin;
 int *fd_stdout;
};

/* The top level PROM vector. */
struct linux_romvec {
 /* Version numbers. */
 unsigned int pv_magic_cookie;
 unsigned int pv_romvers;
 unsigned int pv_plugin_revision;
 unsigned int pv_printrev;

 /* Version 0 memory descriptors. */
 struct linux_mem_v0 pv_v0mem;

 /* Node operations. */
 struct linux_nodeops *pv_nodeops;

 char **pv_bootstr;
 struct linux_dev_v0_funcs pv_v0devops;

 char *pv_stdin;
 char *pv_stdout;
#define PROMDEV_KBD 0  /* input from keyboard */
#define PROMDEV_SCREEN 0  /* output to screen */
#define PROMDEV_TTYA 1  /* in/out to ttya */
#define PROMDEV_TTYB 2  /* in/out to ttyb */

 /* Blocking getchar/putchar.  NOT REENTRANT! (grr) */
 int (*pv_getchar)(void);
 void (*pv_putchar)(int ch);

 /* Non-blocking variants. */
 int (*pv_nbgetchar)(void);
 int (*pv_nbputchar)(int ch);

 void (*pv_putstr)(char *str, int len);

 /* Miscellany. */
 void (*pv_reboot)(char *bootstr);
 void (*pv_printf)(__const__ char *fmt, ...);
 void (*pv_abort)(void);
 __volatile__ int *pv_ticks;
 void (*pv_halt)(void);
 void (**pv_synchook)(void);

 /* Evaluate a forth string, not different proto for V0 and V2->up. */
 union {
  void (*v0_eval)(int len, char *str);
  void (*v2_eval)(char *str);
 } pv_fortheval;

 struct linux_arguments_v0 **pv_v0bootargs;

 /* Get ether address. */
 unsigned int (*pv_enaddr)(int d, char *enaddr);

 struct linux_bootargs_v2 pv_v2bootargs;
 struct linux_dev_v2_funcs pv_v2devops;

 int filler[15];

 /* This one is sun4c/sun4 only. */
 void (*pv_setctxt)(int ctxt, char *va, int pmeg);

 /* Prom version 3 Multiprocessor routines. This stuff is crazy.
 * No joke. Calling these when there is only one cpu probably
 * crashes the machine, have to test this. :-)
 */

 /* v3_cpustart() will start the cpu 'whichcpu' in mmu-context
 * 'thiscontext' executing at address 'prog_counter'
 */
 int (*v3_cpustart)(unsigned int whichcpu, int ctxtbl_ptr,
      int thiscontext, char *prog_counter);

 /* v3_cpustop() will cause cpu 'whichcpu' to stop executing
 * until a resume cpu call is made.
 */
 int (*v3_cpustop)(unsigned int whichcpu);

 /* v3_cpuidle() will idle cpu 'whichcpu' until a stop or
 * resume cpu call is made.
 */
 int (*v3_cpuidle)(unsigned int whichcpu);

 /* v3_cpuresume() will resume processor 'whichcpu' executing
 * starting with whatever 'pc' and 'npc' were left at the
 * last 'idle' or 'stop' call.
 */
 int (*v3_cpuresume)(unsigned int whichcpu);
};

/* Routines for traversing the prom device tree. */
struct linux_nodeops {
 phandle (*no_nextnode)(phandle node);
 phandle (*no_child)(phandle node);
 int (*no_proplen)(phandle node, const char *name);
 int (*no_getprop)(phandle node, const char *name, char *val);
 int (*no_setprop)(phandle node, const char *name, char *val, int len);
 char * (*no_nextprop)(phandle node, char *name);
};

/* More fun PROM structures for device probing. */
#if defined(__sparc__) && defined(__arch64__)
#define PROMREG_MAX     24
#define PROMVADDR_MAX   16
#define PROMINTR_MAX    32
#else
#define PROMREG_MAX     16
#define PROMVADDR_MAX   16
#define PROMINTR_MAX    15
#endif

struct linux_prom_registers {
 unsigned int which_io; /* hi part of physical address */
 unsigned int phys_addr; /* The physical address of this register */
 unsigned int reg_size; /* How many bytes does this register take up? */
};

struct linux_prom64_registers {
 unsigned long phys_addr;
 unsigned long reg_size;
};

struct linux_prom_irqs {
 int pri;    /* IRQ priority */
 int vector; /* This is foobar, what does it do? */
};

/* Element of the "ranges" vector */
struct linux_prom_ranges {
 unsigned int ot_child_space;
 unsigned int ot_child_base;  /* Bus feels this */
 unsigned int ot_parent_space;
 unsigned int ot_parent_base;  /* CPU looks from here */
 unsigned int or_size;
};

/*
 * Ranges and reg properties are a bit different for PCI.
 */
#if defined(__sparc__) && defined(__arch64__)
struct linux_prom_pci_registers {
 unsigned int phys_hi;
 unsigned int phys_mid;
 unsigned int phys_lo;

 unsigned int size_hi;
 unsigned int size_lo;
};
#else
struct linux_prom_pci_registers {
 /*
 * We don't know what information this field contain.
 * We guess, PCI device function is in bits 15:8
 * So, ...
 */
 unsigned int which_io;  /* Let it be which_io */

 unsigned int phys_hi;
 unsigned int phys_lo;

 unsigned int size_hi;
 unsigned int size_lo;
};

#endif

struct linux_prom_pci_ranges {
 unsigned int child_phys_hi; /* Only certain bits are encoded here. */
 unsigned int child_phys_mid;
 unsigned int child_phys_lo;

 unsigned int parent_phys_hi;
 unsigned int parent_phys_lo;

 unsigned int size_hi;
 unsigned int size_lo;
};

struct linux_prom_pci_intmap {
 unsigned int phys_hi;
 unsigned int phys_mid;
 unsigned int phys_lo;

 unsigned int interrupt;

 int          cnode;
 unsigned int cinterrupt;
};

struct linux_prom_pci_intmask {
 unsigned int phys_hi;
 unsigned int phys_mid;
 unsigned int phys_lo;
 unsigned int interrupt;
};

#endif /* !(__ASSEMBLY__) */

#endif /* !(__SPARC_OPENPROM_H) */