/*
* CDDL HEADER START
*
* The contents of this file are subject to the terms of the
* Common Development and Distribution License (the "License").
* You may not use this file except in compliance with the License.
*
* You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
* See the License for the specific language governing permissions
* and limitations under the License.
*
* When distributing Covered Code, include this CDDL HEADER in each
* file and include the License file at usr/src/OPENSOLARIS.LICENSE.
* If applicable, add the following below this CDDL HEADER, with the
* fields enclosed by brackets "[]" replaced with your own identifying
* information: Portions Copyright [yyyy] [name of copyright owner]
*
* CDDL HEADER END
*/
/*
* Copyright 2007 Sun Microsystems, Inc. All rights reserved.
* Use is subject to license terms.
*/
#ifndef _SYS_PROM_PLAT_H
#define _SYS_PROM_PLAT_H
#pragma ident "%Z%%M% %I% %E% SMI"
#include <sys/feature_tests.h>
#ifdef __cplusplus
extern "C" {
#endif
#if !defined(_LONGLONG_TYPE)
#error "This header won't work without long long support"
#endif
/*
* This file contains external platform-specific promif interface definitions.
*
* This version of the file is for the IEEE 1275-1994 compliant sun4u prom.
*/
/*
*
* Routines with fine-grained memory and MMU control are platform-dependent.
*
* MMU node virtualized "mode" arguments and results for Spitfire MMU:
*
* The default virtualized "mode" for client program mappings created
* by the firmware is as follows:
*
* G (global) Clear
* L (locked) Clear
* W (write) Set
* R (read - soft) Set (Prom is not required to implement soft bits)
* X (exec - soft) Set (Prom is not required to implement soft bits)
* CV,CP (Cacheable) Set if memory page, Clear if IO page
* E (side effects) Clear if memory page; Set if IO page
* IE (Invert endian.) Clear
*
* The following fields are initialized as follows in the TTE-data for any
* mappings created by the firmware on behalf of the client program:
*
* P (Priviledged) Set
* V (Valid) Set
* NFO (No Fault Only) Clear
* Context 0
* Soft bits < private to the firmware implementation >
*
* Page size of Prom mappings are typically 8k, "modify" cannot change
* page sizes. Mappings created by "map" are 8k pages.
*
* If the virtualized "mode" is -1, the defaults as shown above are used,
* otherwise the virtualized "mode" is set (and returned) based on the
* following virtualized "mode" abstractions. The mmu node "translations"
* property contains the actual tte-data, not the virtualized "mode".
*
* Note that client programs may not create locked mappings by setting
* the LOCKED bit. There are Spitfire specific client interfaces to create
* and remove locked mappings. (SUNW,{i,d}tlb-load).
* The LOCKED bit is defined here since it may be returned by the
* "translate" method.
*
* The PROM is not required to implement the Read and eXecute soft bits,
* and is not required to track them for the client program. They may be
* set on calls to "map" and "modfify" and may be ignored by the firmware,
* and are not necessarily returned from "translate".
*
* The TTE soft bits are private to the firmware. No assumptions may
* be made regarding the contents of the TTE soft bits.
*
* Changing a mapping from cacheable to non-cacheable implies a flush
* or invalidate operation, if necessary.
*
* NB: The "map" MMU node method should NOT be used to create IO device
* mappings. The correct way to do this is to call the device's parent
* "map-in" method using the CALL-METHOD client interface service.
*/
/*
* NB: These are not implemented in PROM version P1.0 ...
*/
/*
* resource allocation group: OBP only. (mapping functions are platform
* dependent because they use physical address arguments.)
*/
/*
* prom_alloc is platform dependent and has historical semantics
* associated with the align argument and the return value.
* prom_malloc is the generic memory allocator.
*/
unsigned long long *physaddr);
unsigned long long physaddr);
unsigned long long physaddr);
unsigned long long physaddr);
extern int prom_phys_installed_len(void);
extern int prom_phys_avail_len(void);
extern int prom_virt_avail_len(void);
extern int prom_phys_installed(caddr_t);
extern int prom_phys_avail(caddr_t);
extern int prom_virt_avail(caddr_t);
/*
* prom_retain allocates or returns retained physical memory
* identified by the arguments of name string "id", "size" and "align".
*/
unsigned long long *physaddr);
/*
* prom_translate_virt returns the physical address and virtualized "mode"
* for the given virtual address. After the call, if *valid is non-zero,
* a mapping to 'virt' exists and the physical address and virtualized
* "mode" were returned to the caller.
*/
/*
* prom_modify_mapping changes the "mode" of an existing mapping or
* repeated mappings. virt is the virtual address whose "mode" is to
* be changed; size is some multiple of the fundamental pagesize.
* This method cannot be used to change the pagesize of an MMU mapping,
* nor can it be used to Lock a translation into the i or d tlb.
*/
/*
* Client interfaces for managing the {i,d}tlb handoff to client programs.
*/
extern int prom_itlb_load(int index,
extern int prom_dtlb_load(int index,
/*
* Administrative group: OBP only and SMCC platform specific.
* XXX: IDPROM related stuff should be replaced with specific data-oriented
* XXX: functions.
*/
/*
* CPU Control Group: MP's only.
*/
extern int prom_stopcpu_bycpuid(int);
extern void promsafe_pause_cpus(void);
/*
* Set trap table
*/
extern void prom_set_mmfsa_traptable(void *tba_addr,
/*
* Power-off
*/
extern void prom_power_off(void);
/*
* sun4v API versioning group
*/
/*
* The client program implementation is required to provide a wrapper
* to the client handler, for the 32 bit client program to 64 bit cell-sized
* client interface handler (switch stack, etc.). This function is not
* to be used externally!
*/
/*
* The 'format' of the "translations" property in the 'mmu' node ...
*/
struct translation {
};
#ifdef __cplusplus
}
#endif
#endif /* _SYS_PROM_PLAT_H */