--- wikisrc/ports/evbarm/raspberry_pi.mdwn	2017/10/08 23:20:38	1.51
+++ wikisrc/ports/evbarm/raspberry_pi.mdwn	2017/10/14 14:53:46	1.53
@@ -10,7 +10,40 @@ Initial, limited, Raspberry Pi support w
 
 <small>([Raspberry Pi image](http://www.flickr.com/photos/42325803@N07/8118758647/) by Christopher Lee used under CC-By-2.0 license)</small>
 
+# What works
+
+## NetBSD 7 before July, 2017
+
+ - RaspberryPi 1, and 2 (including SMP)
+ - multi-user boot with root on SD card
+ - serial or graphics console (with EDID query / parsing)
+ - DMA controller driver and sdhc(4) support
+ - Audio: works. man page missing.
+ - I²C: works, could use enhancements, man page
+ - GPIO
+ - RNG
+ - SPI: could use enhancements, man page
+ - GPU (VCHIQ) - 3D and video decode. man page missing.
+ - USB (host) - dwctwo(4)
+ - USB Ethernet - usmsc(4)
+ - X windows.
+
+## NetBSD 7 after July, 2017 and NetBSD 8
+
+ - Raspberry Pi 3 (excluding WiFi and bluetooth)
+
+## NetBSD current
+
+ - Raspberry Pi 3 bluetooth
+ - Raspberry Pi 3 new SD host controller driver
+
+# What needs work
+
+ - USB (host); isochronous transfers.
+ - WiFi
+
 # Installation
+
  - The automatic nightly builds  on [nyftp.netbsd.org](http://nyftp.netbsd.org/pub/NetBSD-daily/) provide image files that can be used for installation. The Raspberry Pi and Pi 2 ports are part of the NetBSD 7 release.
     - The 'evbarm-earmv6hf/binary/gzimg/' directory contains an rpi.img file that can be used as a single image for both boards.
     - The 'evbarm-earmv7hf/binary/gzimg/' directory, as of August 6th 2015, contains an armv7.img file that is optimized for Raspberry Pi 2.
@@ -32,7 +65,8 @@ Initial, limited, Raspberry Pi support w
 
       In minicom, run "minicom -s" and set hardware flow control to "no"
 
-# Installation with sshramdisk image
+## Installation with sshramdisk image
+
  - You may use the  rpi_inst.img.gz file created by an evbarm build.
  - Connect Ethernet Cable to RPI.
  - After starting DHCP client, SSH login to with user "sysinst", and password "netbsd".
@@ -40,27 +74,8 @@ Initial, limited, Raspberry Pi support w
    - Also for after the sysinst is done and the system reboots
  - sysinst started!
 
-# Updating the firmware
-
-You probably don't want to do this. Firmware updates can break things,
-and the latest firmware that's been tested is already included in the
-NetBSD build you installed.
-
-If you're feeling adventurous (or are the port maintainer), here's what
-to test whenever you try new firmware:
-
-- Audio
-- OMXPlayer (and [[!template id=man name="vchiq"]])
-- Serial/framebuffer console
-- CPU frequency scaling
-
-That goes for all of `rpi[0123]`.
+## Updating the kernel
 
-Upstream firmware releases are
-[on GitHub](https://github.com/raspberrypi/firmware/releases).
-Copy all files except `kernel*.img` into `/boot` and reboot.
-
-# Updating the kernel
  - Build a new kernel, e.g. using build.sh. It will tell you where the ELF version of the kernel is, e.g.
 
          ...
@@ -73,6 +88,9 @@ Copy all files except `kernel*.img` into
  - reboot
 
 # Wireless Networking
+
+  Note that the built-in WiFi in the RPI3 is not yet supported.
+
  - A Realtek 802.11n USB adaptor configures as urtwn(4).
    - Configure with wpa_supplicant in /etc/rc.conf -
 
@@ -115,32 +133,26 @@ $ retroarch-joyconfig -o gamepad.cfg
 $ retroarch --appendconfig gamepad.cfg -L /usr/pkg/lib/libretro/gambatte_libretro.so game.gbc
 """]]
 
-# What works
+# Developer notes
 
-## NetBSD 7 before July, 2017
+These notes are for people working on improvements to RPI support in NetBSD.
 
- - RaspberryPi 1, and 2 (including SMP)
- - multi-user boot with root on SD card
- - serial or graphics console (with EDID query / parsing)
- - DMA controller driver and sdhc(4) support
- - Audio: works. man page missing.
- - I²C: works, could use enhancements, man page
- - GPIO
- - RNG
- - SPI: could use enhancements, man page
- - GPU (VCHIQ) - 3D and video decode. man page missing.
- - USB (host) - dwctwo(4)
- - USB Ethernet - usmsc(4)
- - X windows.
+## Updating the firmware
 
-## NetBSD 7 after July, 2017 and NetBSD 8
+You probably don't want to do this. Firmware updates can break things,
+and the latest firmware that's been tested is already included in the
+NetBSD build you installed.
 
- - Raspberry Pi 3 (including wifi and SMP)
+If you're feeling adventurous (or are the port maintainer), here's what
+to test whenever you try new firmware:
 
-## NetBSD current
+- Audio
+- OMXPlayer (and [[!template id=man name="vchiq"]])
+- Serial/framebuffer console
+- CPU frequency scaling
 
- - Raspberry Pi 3 bluetooth
- - Raspberry Pi 3 new SD host controller driver
+That goes for all of `rpi[0123]`.
 
-# What needs work
- - USB (host); isochronous transfers.
+Upstream firmware releases are
+[on GitHub](https://github.com/raspberrypi/firmware/releases).
+Copy all files except `kernel*.img` into `/boot` and reboot.