libreboot / lbwww (public) (License: Unspecified) (since 2023-04-11) (hash sha1)
libreboot website (markdown files). https://libreboot.org/
Clone URLs: https://rocketgit.com/user/libreboot/lbwww ssh://rocketgit@ssh.rocketgit.com/user/libreboot/lbwww git://git.rocketgit.com/user/libreboot/lbwww
25.04 25.06 master
List of commits:
Subject Hash Author Date (UTC)
docs/install/spi: remove repetition (ch341a) 9a3fcc68afe213e897d23165aa6da2ec20527976 Leah Rowe 2025-02-17 20:57:37
subtle improvement to CBW2 reference 8725126ec23241582766ed7a996805e357e139fc Leah Rowe 2025-02-15 16:29:15
20241206rev9 notes fda7faffcd674f1f223a5e9f66d0aea90512cb78 Leah Rowe 2025-02-12 23:15:15
list firmware-action on other.md fa485ebbe6f9a2970b6f2175f66300f9e8e7aa6e Leah Rowe 2025-02-09 14:45:15
other.md: fix TF-A link d0c1908702d86077185840f04818567d737c435f Leah Rowe 2025-02-09 13:39:41
add example to gen docs 24d1145ca447d76c6e842cf50d15f9d42d6a754e Leah Rowe 2025-02-08 14:34:38
git: Remove ich9util mentions 6f6ccc1ea9b844d3cfbe9e1b8404b2e43518ac21 Runxi Yu 2025-02-07 15:01:57
freedom-status: Remove ich9util mentions 7307e9eb33106fc03fa0ed64d9d79184ee80b80c Runxi Yu 2025-02-07 14:58:52
faq: Remove ich9util mentions dd993be62fd053768e4826a550fcaa649128c0ef Runxi Yu 2025-02-07 14:48:37
docs/install/{r4,t4,t5,x2}00: Remove ich9util mentions 6b1b5745497cbedf16eb000f53129293c59a8893 Runxi Yu 2025-02-07 14:42:03
docs/install/mac_address: Remove ich9utils mentions dd0bf75198cfccde04c0ce984d584d5edd0744ef Runxi Yu 2025-02-07 14:40:23
docs/install/ich9utils.desc: Note deprecation 4e7473b822bdb6d73da594c8a6ddb0293a5ffc9a Runxi Yu 2025-02-07 14:38:21
contrib: Update the ich9gen section in Steve's contribs 46ab4acf3ab962305d5522a71b44cba45714e534 Runxi Yu 2025-02-07 14:36:26
T480: mention pulseaudio vs pipewire 84219b20eb0a207910805dca658dbe6b3fe1e70e Leah Rowe 2025-02-06 20:13:17
Some clarification and improvements 363fdf2d5e019e6c93b2715e71825916049184a1 arielenter 2025-02-04 16:50:26
Misc typo fixes. cf64fdd4090d049c05855df68479c89b04106c10 Steffen Pankratz 2025-01-27 15:06:09
add spi to other.md f628901f61918fea7fd95dd9f65d859ff7881f72 Leah Rowe 2025-01-26 11:58:47
mention fossy 987afae58a40ebebb9bca57a81e92f98bdfdd3f3 Leah Rowe 2025-01-25 18:37:44
expand other.md 5cf2ddde7395a9f98ba4cebc6f493b00fb58af7f Leah Rowe 2025-01-25 18:31:03
shorter descriptions 3b90750b4b6ea0e8c9682ca517bb76800e6a5e2a Leah Rowe 2025-01-25 15:04:38
Commit 9a3fcc68afe213e897d23165aa6da2ec20527976 - docs/install/spi: remove repetition (ch341a)
Signed-off-by: Leah Rowe <leah@libreboot.org>
Author: Leah Rowe
Author date (UTC): 2025-02-17 20:57
Committer name: Leah Rowe
Committer date (UTC): 2025-02-17 20:57
Parent(s): 8725126ec23241582766ed7a996805e357e139fc
Signer:
Signing key:
Signing status: N
Tree: 120a8fb226b2b98035e40a5326d9ba9783216545
File Lines added Lines deleted
site/docs/install/spi.md 3 19
File site/docs/install/spi.md changed (mode: 100644) (index e8b9f54..a6b8e09)
... ... Higher speeds might work nicely, on Pico 2.
214 214 Do not buy CH341A! Do not buy CH341A!
215 215 ------------------ ------------------
216 216
217 This section was heavily expanded, on 19 January 2025, because we see many
218 people online still talking about the CH341a. Therefore, the hatred has been
219 amplified. Please read this section carefully, to know why we advise against
220 use of this particular programmer.
221
222 217 NOR flashes on libreboot systems run on 3.3V DC or 1.8V DC, and this includes NOR flashes on libreboot systems run on 3.3V DC or 1.8V DC, and this includes
223 218 data lines. CH341A can have 5V logic levels on data lines, which can damage your data lines. CH341A can have 5V logic levels on data lines, which can damage your
224 219 SPI flash and also the southbridge that it's connected to, plus anything else SPI flash and also the southbridge that it's connected to, plus anything else
 
... ... resistors) performed, on the black CH341A:\
278 273 <img tabindex=1 src="https://av.libreboot.org/ch341a/0001_th.jpg" /><span class="f"><img src="https://av.libreboot.org/ch341a/0001.jpg" /></span> <img tabindex=1 src="https://av.libreboot.org/ch341a/0001_th.jpg" /><span class="f"><img src="https://av.libreboot.org/ch341a/0001.jpg" /></span>
279 274
280 275 The green version (not shown above) may come with 3.3v logic already wired, but The green version (not shown above) may come with 3.3v logic already wired, but
281 still needs to have pull-up resistors placed for WP/HOLD.
276 still needs to have pull-up resistors placed for WP/HOLD. Some of them may have
277 switchable voltage instead, via a physical toggle on the board.
282 278
283 279 Disclaimer: A few (not many, but wily) people have criticised this section of the Disclaimer: A few (not many, but wily) people have criticised this section of the
284 280 documentation, due to a misconception about what it really means and also because documentation, due to a misconception about what it really means and also because
 
... ... chip selects at once; it's just better, in every way. And the Raspberry Pi is
317 313 completely reprogrammable, so you can use it for something else when you're completely reprogrammable, so you can use it for something else when you're
318 314 done, e.g. UART dongle, or if you're wily enough, [PlayStation 1 Optical Disc done, e.g. UART dongle, or if you're wily enough, [PlayStation 1 Optical Disc
319 315 Emulator](https://github.com/paulocode/picostation) - the Pico is simply a Emulator](https://github.com/paulocode/picostation) - the Pico is simply a
320 highly versatile tool, much better value for money than the piece of junk
321 CH341a.
316 highly versatile tool, much better value for money.
322 317
323 318 There is only one instance where the CH341a is *good*, and that is when you're There is only one instance where the CH341a is *good*, and that is when you're
324 319 actually flashing a loose (not soldered) chip, in the ZIF socket on the CH341a actually flashing a loose (not soldered) chip, in the ZIF socket on the CH341a
 
... ... also newer models that have a voltage switch and logic level shifter already
337 332 on the board, which can be very useful. *Clip-based* flashing (ISP / in-system on the board, which can be very useful. *Clip-based* flashing (ISP / in-system
338 333 programming) is, specifically, what we advise against using the CH341a for. programming) is, specifically, what we advise against using the CH341a for.
339 334
340 Even if you *are* doing socket-based flashing, we still suggest buying the Pico
341 instead, though the Pico doesn't come with a ZIF socket; you can wire the Pico
342 to a breadboard instead, if you want to use a socket for flashing. Then you
343 will also have a good ISP device, and the overall cost covering both use-case
344 scenarios is *lower* (cheaper part cost) than buying a CH341a *and* Pico; and
345 the Pico can also emulate the PlayStation Optical Disc Drive in your
346 playstation to boot from SD card instead of your dead CD drive, or could even
347 be a [JTAG adapter](https://hackaday.com/2022/04/11/need-a-jtag-adapter-use-your-pico/) -
348 again, the Pico is a reprogrammable device! Whereas, the CH341a is a fixed-function
349 device (and performs poorly).
350
351 335 Why pay $10 for a CH341a when you can pay $10 for a Raspberry Pi Pico which is Why pay $10 for a CH341a when you can pay $10 for a Raspberry Pi Pico which is
352 336 electrically and functionally superior in every way? And the Pico is completely electrically and functionally superior in every way? And the Pico is completely
353 337 open source, right down to the boot rom. open source, right down to the boot rom.
Hints:
Before first commit, do not forget to setup your git environment:
git config --global user.name "your_name_here"
git config --global user.email "your@email_here"

Clone this repository using HTTP(S):
git clone https://rocketgit.com/user/libreboot/lbwww

Clone this repository using ssh (do not forget to upload a key first):
git clone ssh://rocketgit@ssh.rocketgit.com/user/libreboot/lbwww

Clone this repository using git:
git clone git://git.rocketgit.com/user/libreboot/lbwww

You are allowed to anonymously push to this repository.
This means that your pushed commits will automatically be transformed into a merge request:
... clone the repository ...
... make some changes and some commits ...
git push origin main