Falls family Crypto & RNG Compatible Property

1. Introduction

    FWARC/2006/567 initially defined "compatible" properties for the Niagara
    Cryptographic Provider (NCP), Niagara-2 Cryptographic Provider (N2CP) and
    Niagara-2 Random Number Generator (N2RNG) for Niagara-1, Niagara-2 and
    Victoria Falls processors.

    FWARC/2007/071 later updated the "compatible" properties for N2CP.
    This case defines the "compatible" properties for the new RF/KT
    processor.

    Existing:
	    Driver Name	Binding		CPU
	    -----------	-------		---
	    ncp		SUNW,sun4v-ncp	N1
	    ncp		SUNW,n2-mau	N2
	    ncp		SUNW,vf-mau	VF
	    n2cp	SUNW,n2-cwq	N2
	    n2cp	SUNW,vf-cwq	VF
	    n2rng	SUNW,n2-rng	N2
	    n2rng	SUNW,vf-rng	VF

    Proposed Additions:
	    Driver Name	Binding		CPU
	    -----------	-------		---
	    ncp		SUNW,kt-mau	RF/KT
	    n2cp	SUNW,kt-cwq	RF/KT
	    n2rng	SUNW,kt-rng	RF/KT


2. Property Definitions

2.1. Machine Description: NCP/N2CP/N2RNG virtual-device node

    Ref: FWARC/2005/173	(ino)
         FWARC/2006/072	(name, device-type, cfg-handle, compatible)

    This will be a change to ONLY the "compatible" field of the
    respective virtual-device MD nodes.  Note that these MD nodes exist
    in the source base on a per-platform basis.

2.1.1. NCP virtual-device compatible property

	Name		Tag		Req	Description
	----		---		---	-----------
	compatible	PROP_DATA	Y	An array of string names
						for this node.  Value to
						be defined as one of:
						"SUNW,sun4v-ncp",  /* N1 */
						"SUNW,n2-mau",     /* N2 */
						"SUNW,vf-mau",     /* VF */
						"SUNW,kt-mau".     /* RF/KT */

2.1.2. N2CP virtual-device compatible property

	Name		Tag		Req	Description
	----		---		---	-----------
	compatible	PROP_DATA	Y	An array of string names
						for this node.  Value to
						be defined as one of:
						"SUNW,n2-cwq",    /* N2 */
						"SUNW,vf-cwq",    /* VF */
						"SUNW,kt-cwq".    /* KT/RF */

2.1.3. N2RNG virtual-device compatible property

	Name		Tag		Req	Description
	----		---		---	-----------
	compatible	PROP_DATA	Y	An array of string names
						for this node.  Value to
						be defined as one of:
						"SUNW,n2-rng",    /* N2 */
						"SUNW,vf-rng",    /* VF */
						"SUNW,kt-rng".    /* RF/KT */


2.2.  OpenBoot: NCP/N2CP/N2RNG virtual-device node

    This will be a change to ONLY the "compatible" property of
    the respective OBP device nodes.  Only that property is highlighted
    here as the remaining properties will remain unchanged.

2.2.1.	NCP Properties

	"compatible"			S
		Type:		Prop-encoded-array of prop-encoded-strings
		Contents:	Standard property name, defined devices
				with which this device is compatible.
		Value:		"SUNW,sun4v-ncp",	/* N1 */
				"SUNW,n2-mau",		/* N2 */
				"SUNW,vf-mau",		/* VF */
				"SUNW,kt-mau".		/* RF/KT */

2.2.2.	N2CP Properties

	"compatible"			S
		Type:		Prop-encoded-array of prop-encoded-strings
		Contents:	Standard property name, defined devices
				with which this device is compatible.
		Value:		"SUNW,n2-cwq",		/* N2 */
				"SUNW,vf-cwq",		/* VF */
				"SUNW,kt-cwq".		/* RF/KT */

2.2.3.	N2RNG Properties

	"compatible"			S
		Type:		Prop-encoded-array of prop-encoded-strings
		Contents:	Standard property name, defined devices
				with which this device is compatible.
		Value:		"SUNW,n2-rng",		/* N2 */
				"SUNW,vf-rng",		/* VF */
				"SUNW,kt-rng".		/* RF/KT */

3. References

    PSARC/2005/125 Niagara Crypto Provider
    FWARC/2006/174 NCS HV API update
    FWARC/2006/425 NCS HV API update #2
    FWARC/2006/481 Niagara-2 Random Number Generator HV API
    FWARC/2006/567 Niagara Crypto & RNG compatible property update
    FWARC/2007/071 Niagara2 Crypto Name Property Update
    FWARC/2008/296 Crypto Dynamic Reconfiguration Domain Services 1.0
    Niagara PRM, v1.8 (Oct 28, 2005), Chp 20 Modular Arithmetic
    Niagara-2 PRM, v1.2 (Mar 3, 2006), Chp 15 Stream Processing Unit
    Bugid 6475000 Asymmetric (RSA) Operation fails the known answer test