1.\" $OpenBSD: xp.4,v 1.2 2017/02/11 23:08:43 jmc Exp $ 2.\" 3.\" Copyright (c) 2017 Kenji Aoyama. 4.\" 5.\" Permission to use, copy, modify, and distribute this software for any 6.\" purpose with or without fee is hereby granted, provided that the above 7.\" copyright notice and this permission notice appear in all copies. 8.\" 9.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES 10.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF 11.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR 12.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES 13.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN 14.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF 15.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. 16.Dd $Mdocdate: February 11 2017 $ 17.Dt XP 4 luna88k 18.Os 19.Sh NAME 20.Nm xp 21.Nd HD647180X I/O processor 22.Sh SYNOPSIS 23.Cd "xp0 at mainbus0" 24.Sh DESCRIPTION 25The file 26.Pa /dev/xp 27is an 28.Xr mmap 2 29capable interface to the memory area of the HD647180X I/O processor 30(so-called "XP") on LUNA-88K and LUNA-88K2. 31Byte offsets in this file are interpreted as relative memory addresses 32of the I/O processor. 33The range should be between 0x0 and 0xffff. 34.Pp 35The following 36.Xr ioctl 2 37call applies to 38.Pa /dev/xp : 39.Bl -tag -width 4n 40.It Dv XPIOCDOWNLD Fa "struct xp_download" 41Load binary and reset I/O processor. 42.Bd -literal -offset indent 43struct xp_download { 44 u_int size; 45 u_char *data; 46}; 47.Ed 48.Pp 49The 50.Va size 51member specifies the loading binary size, in bytes. 52The 53.Va data 54member points to the binary image. 55.El 56.Sh FILES 57.Bl -tag -width /dev/xp -compact 58.It Pa /dev/xp 59.El 60.Sh ERRORS 61.Bl -tag -width Er 62.It Bq Er EINVAL 63The specified size is 0 or more than the I/O processor's memory size. 64.It Bq Er ENOMEM 65Memory could not be allocated for loading. 66.El 67.Sh SEE ALSO 68.Xr ioctl 2 69.Sh HISTORY 70The 71.Pa /dev/xp 72file first appeared in 73.Ox 6.1 . 74