t1650 flashing guide

Signed-off-by: Leah Rowe <leah@libreboot.org>

site/docs/hardware/hp8470p.md

@@ -104,7 +104,7 @@ Flash a ROM image (hardware)
 This is to prevent short circuiting and power surges while flashing.**
 
 For general information, please refer to [25xx NOR flash
-instructions](../install/spi.md) - that page refers to use of socketed flash.
+instructions](../install/spi.md).
 
 At this present time, disassembly instructions are unavailable from the
 Libreboot project, but you can search for HP's own hardware maintenance manual

site/docs/hardware/index.md

@@ -50,6 +50,7 @@ libreboot currently supports the following systems in this release:
 -   [Acer G43T-AM3](acer_g43t-am3.md)
 -   [Apple iMac 5,2](imac52.md)
 -   [ASUS KCMA-D8 motherboard](kcma-d8.md)
+-   [Dell Precision T1650](t1650.md)
 -   [Gigabyte GA-G41M-ES2L motherboard](ga-g41m-es2l.md)
 -   [HP Elite 8200 SFF/MT](hp8200sff.md) (HP 6200 Pro Business probably works too)
 -   [HP Elite 8300 USDT](hp8300usdt.md)

site/docs/hardware/index.zh-cn.md

@@ -37,6 +37,7 @@ x-toc-enable: true
 -   [Acer G43T-AM3](acer_g43t-am3.md)
 -   [Apple iMac 5,2](imac52.md)
 -   [ASUS KCMA-D8 主板](kcma-d8.md)
+-   [Dell Precision T1650](t1650.md)
 -   [Gigabyte GA-G41M-ES2L 主板](ga-g41m-es2l.md)
 -   [HP Elite 8200 SFF/MT](hp8200sff.md)（HP 6200 Pro Business 多半也能用）
 -   [HP Elite 8300 USDT](hp8300usdt.md)

site/docs/hardware/t1650.md

@@ -0,0 +1,189 @@
+---
+title: Dell Precision T1650
+x-toc-enable: true
+...
+
+**[PLEASE READ THESE INSTRUCTIONS BEFORE INSTALLING](../../news/safety.md),
+OR YOU MIGHT BRICK YOUR MACHINE: [SAFETY PRECAUTIONS](../../news/safety.md)**
+
+<div class="specs">
+<center>
+<img tabindex=1 alt="Dell Precision T1650" class="p" src="https://av.libreboot.org/t1650/t1650.jpg" /><span class="f"><img src="https://av.libreboot.org/t1650/t1650.jpg" /></span>
+</center>
+
+| ***Specifications***       |                                                |
+|----------------------------|------------------------------------------------|
+| **Manufacturer**           | Dell                                           |
+| **Name**                   | Precision T1650                                |
+| **Variants**               | Precision T1650                                |
+| **Released**               | 2012                                           |
+| **Chipset**                | Intel QM77                                     |
+| **CPU**                    | Intel Ivy Bridge                               |
+| **Graphics**               | Discrete graphics, or Intel HD Graphics model
+                               depending on CPU model                         | 
+| **Memory**                 | DDR3 DIMMs (max 32GB, 2x16GB), ECC memory supported    |
+| **Architecture**           | x86_64                                         |
+| **Original boot firmware** | HP UEFI firmware                               |
+| **Intel ME/AMD PSP**       | Present. Can be disabled with me_cleaner.      |
+| **Flash chip**             | SOIC-16 16MiB (128Mbit)                        |
+
+
+```
+W+: Works without blobs; 
+N: Doesn't work; 
+W*: Works with blobs; 
+U: Untested; 
+P+: Partially works; 
+P*: Partially works with blobs
+?: UNKNOWN AT THIS TIME
+```
+
+| ***Features***                                    |    |
+|---------------------------------------------------|----|
+| **Internal flashing with original boot firmware** | ?  |
+| **Display (if Intel GPU)**                        | W+ |
+| **Display (discrete CPU, SeaBIOS payload only)**  | W* |
+| **Audio**                                         | W+ |
+| **RAM Init**                                      | W+ |
+
+| ***Payloads supported***   |           |
+|----------------------------|-----------|
+| **GRUB (libgfxinit only)** | Works     |
+| **SeaBIOS**                | Works     |
+| **SeaBIOS with GRUB**      | Works     |
+</div>
+Introduction
+============
+
+**Unavailable in Libreboot 20230625 or earlier. You must [compile from
+source](../build/), or use the next release after Libreboot 20230625.**
+
+Official information about the laptop can be found here:
+<https://i.dell.com/sites/csdocuments/Shared-Content_data-Sheets_Documents/en/uk/Dell_Precision_T1650_Spec_Sheet.pdf>
+
+This is similar code-wise to [Dell
+OptiPlex 9010](https://doc.coreboot.org/mainboard/dell/optiplex_9010.html)
+which coreboot supports.
+
+Build ROM image from source
+---------------------------
+
+The build target, when building from source, is thus:
+
+	./build boot roms t1650_12mb
+
+Installation
+============
+
+Insert binary files
+-------------------
+
+If you're using a release ROM, please ensure that you've inserted extra firmware
+required refer to the [guide](../install/ivy_has_common.md) for that. (failure
+to adhere to this advice will result in a bricked machine)
+
+Libreboot's build system automatically downloads and processes these files if
+you build Libreboot from source, but the same logic that it uses must be re-run
+if you're using a release image.
+
+Set MAC address
+---------------
+
+This platform uses an Intel Flash Descriptor, and defines an Intel GbE NVM
+region. As such, release/build ROMs will contain the same MAC address. To
+change the MAC address, please read [nvmutil documentation](../install/nvmutil.md).
+
+WARNING about GPU compatibility
+-------------------------------
+
+At the time of testing this board, I didn't have a CPU with graphics built in,
+so I could only use discrete graphics on the PCI-E slot (in my case, Nvidia
+Quadro K420 running under the nouveau driver in Linux).
+
+If you want to use onboard graphics, you must have a CPU that has a GPU built
+into it. You can find a list here:
+
+<https://en.wikipedia.org/wiki/Ivy_Bridge_(microarchitecture)>
+
+Because of this, Libreboot currently only provides ROM images where SeaBIOS
+is the first payload, and SeaBIOS is relied upon the execute the VGA ROM that's
+stored on the graphics card. However, coreboot's libgfxinit is also enabled,
+so onboard graphics *should* work if you don't have a graphics card installed.
+
+Coreboot has libre initialisation code for Intel graphics, but libre
+initialisation code is not available for most graphics cards. This machine can
+take any graphics card that fits in the PCI-E slot.
+
+GRUB *also* works, from SeaBIOS when the machine is booted in text mode. Both
+coreboot GRUB, and BIOS GRUB provided by your (Linux) distro. It's done this
+way (SeaBIOS first) because Libreboot's configuration does not tell *coreboot*
+to execute VGA Option ROMs, and it's important that we try to prevent bricks
+whenever possible.
+
+Flash a ROM image (software)
+-----------------
+
+If you're already running Libreboot, and you don't have flash protection
+turned on, [internal flashing](../install/) is possible.
+
+Flash a ROM image (hardware)
+-----------------
+
+**REMOVE all power sources and connectors from the machine, before doing this.
+This is to prevent short circuiting and power surges while flashing.**
+
+For general information, please refer to [25xx NOR flash
+instructions](../install/spi.md) - that page refers to use of socketed flash.
+
+This machine is somewhat cumbersome to flash, because it has a SOIC-8 flash
+for the first 8MB part, and 4MB SOIC8. You can split up your 12MB ROM image
+like so:
+
+	dd if=libreboot.rom of=4mb.rom bs=1M skip=8
+	dd if=libreboot.rom of=8mb.rom bs=1M count=8
+
+You *could* laboriously switch clips, but I flash lots of machines all the
+time so I did *this* (don't try this at home - I wasn't at home when I tried
+it):
+
+![Do not try this at home](https://av.libreboot.org/t1650/rpi_two_clips.jpg)
+
+I just use one and insulate the other one that I'm not using. If the wires are
+short enough, induction won't be a problem, but these are highspeed signals. You
+have to keep the wires short! (but not shorted)
+
+The side cover comes off easily, and you can find the flash ICs next to the RAM.
+
+Here's the SOIC8 IC being flashed:
+
+![SOIC8 flash IC on T1650](https://av.libreboot.org/t1650/t1650_soic8.jpg)
+
+and here is the SOIC16 IC being flashed:
+
+![SOIC16 flash IC on T1650](https://av.libreboot.org/t1650/t1650_soic16.jpg)
+
+Here is SeaBIOS after a successful boot attempt:
+
+![SeaBIOS on T1650](https://av.libreboot.org/t1650/t1650_seabios.jpg)
+
+Here is GRUB:
+
+![GRUB on T1650](https://av.libreboot.org/t1650/t1650_grub.jpg)
+
+MemTest86+:
+
+![MemTest86+ on T1650](https://av.libreboot.org/t1650/t1650_memtest86plus.jpg)
+
+The Debian installer:
+
+![Debian installation](https://av.libreboot.org/t1650/t1650_debian_installer.jpg)
+
+and here is Mozilla Firefox in Debian booted on T1650, showing the Libreboot
+flashing instructions [in Chinese](../install/spi.zh-cn.md):
+
+![Libreboot flashing instructions](https://av.libreboot.org/t1650/t1650_libreboot_website.jpg)
+
+Other aspects of the machine are not much to write home about. It's a standard
+desktop PC form factor, and you can just run whatever you want on it.
+
+Enjoy!

site/docs/install/index.md

@@ -560,6 +560,11 @@ chips, but it is hard to find now.  A custom flasher may be made such as
 [flashrom serprog stm32](https://github.com/wosk/stm32-vserprog-lpc) or
 [teensy flasher](https://www.flashrom.org/Teensy_3.1_SPI_%2B_LPC/FWH_Flasher)
 
+TARGET: DELL Precision T1650 desktop
+------------------------------------
+
+Refer to the [T1650 hardware page](../hardware/t1650.md).
+
 TARGET: Apple Macbook2,1, Macbook1,1 and iMac5,2 (i945 platform)
 ----------------------------------------------------------------
 

site/news/safety.md

@@ -5,6 +5,9 @@
 Introduction
 ============
 
+**UPDATE (16 August 2023): This also applies to the recently added Dell
+Precision T1650 mainboard.**
+
 As I write this post, [Libreboot 20230625](libreboot20230625.md) recently came
 out. There's technically nothing unsafe about the release itself, but certain
 users have been bricking their machines, on the following mainboards: