summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorSolomon Peachy <pizza@shaftnet.org>2024-09-21 12:48:32 -0400
committerSolomon Peachy <pizza@shaftnet.org>2024-09-21 13:01:45 -0400
commitbabc1e57e1e1ce9779a1cd8c58005c79a168a8a5 (patch)
tree928f514c69d93477bf971e1f8c255d425a3f6526
parent5d6e4981788c7e9a2fdd710d598cd10cb8f6b6dc (diff)
downloadrockbox-babc1e57e1e1ce9779a1cd8c58005c79a168a8a5.tar.gz
rockbox-babc1e57e1e1ce9779a1cd8c58005c79a168a8a5.zip
manual: Add a blurb about Windows format tool limitations
Change-Id: I8b51ad4d92910f5b143da02b0db90a851c68f41d
-rw-r--r--manual/getting_started/installation.tex22
1 files changed, 13 insertions, 9 deletions
diff --git a/manual/getting_started/installation.tex b/manual/getting_started/installation.tex
index 633f8ac4ad..01e47babcd 100644
--- a/manual/getting_started/installation.tex
+++ b/manual/getting_started/installation.tex
@@ -270,9 +270,6 @@ of before installing.
270 270
271\subsection{Storage/Capacity Limits} 271\subsection{Storage/Capacity Limits}
272 272
273\note{As of this writing, no Rockbox-capable device can handle
274 total drive capacities exceeding than 2TiB.}
275
276\opt{disk_storage}{ 273\opt{disk_storage}{
277Rockbox supports larger drive capacities when used on devices 274Rockbox supports larger drive capacities when used on devices
278that use ATA storage and GPT partitioning, but due to the limitations 275that use ATA storage and GPT partitioning, but due to the limitations
@@ -280,14 +277,22 @@ of the FAT32 filesystem, individual paritions cannot exceed 2TiB. Additionally,
280there are typically underlying platform limitations that 277there are typically underlying platform limitations that
281make it difficult, if not impossible, to boot from a GPT-partitioned 278make it difficult, if not impossible, to boot from a GPT-partitioned
282drive. 279drive.
280
281\note{In practice, no Rockbox-capable device can handle total drive capacities exceeding 2TiB.}
283} 282}
284 283
285\opt{sd_storage}{ 284\opt{sd_storage}{
285\item
286 Rockbox does not currently support SDUC cards, ie those with capacities
287 exceeding 2TiB. However, this is purely a software limitation with
288 Rockbox's SD card drivers, and will be addressed in a future release.
289
286 \note{SD cards exceeding 32GiB are pre-formated using the exFAT filesystem with GPT paritioning. 290 \note{SD cards exceeding 32GiB are pre-formated using the exFAT filesystem with GPT paritioning.
287 Before they can be used with Rockbox, they must be reformatted with FAT32.} 291 Before they can be used with Rockbox, they must be reformatted with FAT32.}
292}
288 293
289 Rockbox does not currently support SDUC cards with capacities exceeding 2TiB. However, this is purely 294\opt{disk_storage,sd_storage}{
290 a software limitation with Rockbox's SD card drivers, and will be addressed in a future release. 295\note{The disk format utility included with all versions Microsoft Windows released to date will refuse to create/format FAT32 partitons exceeding 32GiB, so users of larger storage devices will need an alternative tool. Options include GParted Live\footnote{\url{https://gparted.org/}}\opt{ipod}{ or performing a restore using iTunes on Windows}. \opt{sd_storage}{Addtionally, devices that support removable storage typically have a built-in format tool that can be used.}}
291} 296}
292 297
293\opt{disk_storage}{ 298\opt{disk_storage}{
@@ -313,10 +318,9 @@ drive.
313 increase the overall storage capacity. While typically described as JBOD\footnote{Just a Bunch Of Disks}, this is not accurate as each 318 increase the overall storage capacity. While typically described as JBOD\footnote{Just a Bunch Of Disks}, this is not accurate as each
314 card is not individually accessable. Instead, the adapter claims to be to be a single logical drive 319 card is not individually accessable. Instead, the adapter claims to be to be a single logical drive
315 that is the combined capacity of the individual cards in a RAID0-like manner. This also means that if any 320 that is the combined capacity of the individual cards in a RAID0-like manner. This also means that if any
316 one card fails, you lose everything. Combined with the poor quality of most SD cards and the lack of support 321 one card fails, data on all other cards is most likely permenantly lost. Combined with the poor quality of most SD cards and the lack of support
317 for proper power management, this means use of multiple SD cards in one of these adapters is the reliable and most 322 for proper power management, this means use of multiple SD cards in one of these adapters is the least reliable/robust and most power hungry solution of all. Finally, in another violation of the ATA specification, these ATA-SD adapters fail
318 power hungry solution of all. Finally, in another violation of the ATA specification, these ATA<->SD adapters fail 323 to properly support addresses exceeding 32 bits, meaning that no matter which combination of cards is used, they simply will
319 to support addresses exceeding 32 bits, meaning that no matter which combination of cards is used, they simply will
320 not work if their combined capacity exceeds 2TiB. 324 not work if their combined capacity exceeds 2TiB.
321\item 325\item
322 All of these flash/SSD mods take up less physical space in the device enclosure than the original hard drive, so care 326 All of these flash/SSD mods take up less physical space in the device enclosure than the original hard drive, so care