Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
Next revision Both sides next revision
install_driver_sd [2017/02/05 21:18]
tuko [1.2) Install GiggleDisk]
install_driver_sd [2019/11/05 03:25]
muaddib
Line 1: Line 1:
-====== ​How To : Install the SAGA SDCard Driver ​======+====== ​Mounting a MicroSD Card ======
  
-{{:​microsd.png?​64|}}+{{:​microsd.png?​nolink&64|}}
  
 ===== Overview ===== ===== Overview =====
  
-''​Jason Mac Mullan''​ kindly develops and maintains the SAGA SDCard Driver to be used with the ''​MicroSD slot''​ of the ''​Vampire''​ boards. See [[saga_core_sdcard|SAGA SDCard Core]] article for more technical informations. This device can be used as an additional disk for use with your ''​AmigaOS 3.x''​ setup. The driver is still in a ''​beta''​ stage. Always **BACKUP** your data before use such piece of software, until you are sure all works as expected.+''​Jason Mac Mullan''​ kindly develops and maintains the SAGA SDCard Driver to be used with the ''​MicroSD slot''​ of the ''​Vampire''​ boards. This device can be used as an additional disk for use with your ''​AmigaOS 3.x''​ setup.
  
 +  * The driver is still in a ''​beta''​ stage. Always **BACK UP** your data before using such a piece of software, until you are sure that everything works as expected.
  
-----+<​html><​div class="​dokuwiki"></​html>​ 
 +<wrap tip>It is possible to insert standard-size SD cards into the ''​MicroSD slot''​ using a simple adapter (explained [[vampire:​microsd|here]]). Therefore, for brevity, the "​Micro"​ prefix will be omitted and only "SD card" will be used in this article.</​wrap>​ 
 +<​html></​div></​html>​
  
 +----
  
 ===== Important notes ===== ===== Important notes =====
  
-{{:​warning-icon.png?​48|}}+{{:​warning-icon.png?​nolink&48|}}
  
-The current SAGA SD Driver does **NOT** implement - in current version - the ''​AUTOMATIC''​ disk drive geometry methods that would allow AmigaOS DOSDrivers MountLists to use some handy default values. As a consequence,​ keep in mind that :+The current SAGA SD Driver does **NOT** implement - in its current version - the ''​AUTOMATIC''​ disk drive geometry methods that would allow AmigaOS DOSDrivers MountLists to use some handy default values. As a consequence,​ keep in mind that:
  
-  - ''​MountList''​ attributes such as ''​LowCyl'',​ ''​HighCyl''​ and some others must be explicitely ​specified. For example, ''​LowCyl = 0''​ will **NOT** work ! +  - ''​MountList''​ attributes such as ''​LowCyl'',​ ''​HighCyl''​ and some others must be explicitly ​specified. For example, ''​LowCyl = 0''​ will **NOT** work! 
-  - Each MicroSD ​card must use its own MountList. **NEVER** use a MountList dedicated to a given SD card with another SD card. +  - Each SD card must use its own MountList. **NEVER** use a MountList dedicated to a given SD card with another SD card. 
-  - Use third-party program ​to create correct ''​MountList''​ by reading the lowlevel geometry of the disk, such as [[http://​aminet.net/​package/​disk/​misc/​giggledisk|GiggleDisk]].+  - Use third-party program, such as [[http://​aminet.net/​package/​disk/​misc/​giggledisk|GiggleDisk]], to create correct ''​MountList''​ by reading the lowlevel geometry of the disk.
  
 ---- ----
Line 25: Line 29:
 ===== 1) Install the required files ===== ===== 1) Install the required files =====
  
-{{:​install-icon.png?​48|}}+{{:​install-icon.png?​nolink&48|}}
  
-The installation of the SDCard on the Vampire requires some files, provided ​on the SAGA driver package and some additional tools available on Aminet. Please, follow step by step the following procedure ​: +The installation of the SDCard on the Vampire requires some files, provided ​in the SAGA driver package and some additional tools available on Aminet. Please, follow ​the following procedure ​step by step:
-==== 1.1) Install the SAGA SD Driver package ====+
  
-  - Run the installer provided in the [[http://​www.apollo-accelerators.com/#​download|SAGADriver LHA Package]].+==== 1.1) Install ​the SAGA SD Driver ====
  
 +  - Run the installer provided in the [[saga:​updates|SAGADriver package]].
  
-==== 1.2b) Install SCSIQuery (optional) ====+==== 1.2) Install SCSIQuery (optional) ====
  
   - Download [[http://​aminet.net/​package/​disk/​misc/​SCSIQuery|SCSIQuery]],​ available on Aminet.   - Download [[http://​aminet.net/​package/​disk/​misc/​SCSIQuery|SCSIQuery]],​ available on Aminet.
   - Copy the file ''​SCSIQuery/​SCSIQuery''​ to ''​C:​SCSIQuery''​   - Copy the file ''​SCSIQuery/​SCSIQuery''​ to ''​C:​SCSIQuery''​
  
-==== 1.3) Install ​PFS3 All-In-One (recommended ​filesystem====+==== 1.3) Install ​the desired ​filesystem ====
  
 +Recommended filesystem: PFS3 All-In-One
   - Download [[http://​aminet.net/​package/​disk/​misc/​pfs3aio|PFS3AIO]],​ available on Aminet.   - Download [[http://​aminet.net/​package/​disk/​misc/​pfs3aio|PFS3AIO]],​ available on Aminet.
   - Copy the file ''​pfs3_aio-handler''​ to ''​L:​pfs3_aio-handler''​.   - Copy the file ''​pfs3_aio-handler''​ to ''​L:​pfs3_aio-handler''​.
   - Download [[http://​aminet.net/​package/​disk/​misc/​PFS3_53|PFS3_53]],​ available on Aminet.   - Download [[http://​aminet.net/​package/​disk/​misc/​PFS3_53|PFS3_53]],​ available on Aminet.
   - Copy the file ''​PFS3/​tools/​pfsformat''​ to ''​C:​pfsformat''​.   - Copy the file ''​PFS3/​tools/​pfsformat''​ to ''​C:​pfsformat''​.
-  - Optionally, you can copy the other PFS tools (''​pfsdoctor'',​ ''​setfnsize'',​ ...).+  - Optionally, you can copy the other PFS tools (''​pfsdoctor'',​ ''​setfnsize'',​ ...) to ''​C:''​.
  
-==== 1.4Check for Installed files ====+Other filesystems to consider: 
 +  * [[http://​aminet.net/​package/​disk/​misc/​SFS|SFS]] 
 +  * [[http://​aminet.net/​package/​disk/​misc/​fat95|FAT95]] (already included in the SAGA driver package) 
 +  * [[http://​aminet.net/​package/​disk/​misc/​ext2fs_0.41|ext2/​ext3]]
  
-  - Reboot your computer +==== 1.4) Reboot your computer ​====
-  - Check if the following files are installed in the System drive : +
- +
-^ Filename ^ >Version //​FileName//​ FULL ^ +
-| ''​C:​GiggleDisk'' ​      | GiggleDisk 1.19 (21/​05/​2005) by Guido Mersmann - Amiga 68K Version |  +
-| ''​C:​pfsformat'' ​       | Format 1.1 (17/​05/​1999) by Michiel Pelt and copyright 1999 Great Effect Development |  +
-| ''​C:​SCSIQuery'' ​       | SCSIQuery 1.33 (22/​11/​1999) (c) THOR |  +
-| ''​C:​SDDiag'' ​          | SDDiag 0.8n (28/​04/​2016) (c) The AROS Development Team |  +
-| ''​DEVS:​sagasd.device''​ | sagasd.device 0.9 (16/​05/​2016) |  +
-| ''​L:​pfs_aio-handler'' ​ | pfs3_aio-handler 18.5 (14/​05/​2014) |  +
-| ''​SYS:​System/​SDMount''​ | //no information//​ |  +
- +
-{{:​vampire049.png|}}+
  
 ---- ----
  
 +===== 2) Check the SD card =====
  
-===== 2) Check the MicroSD card ===== +{{:​sdcard.png?​nolink&48|}}
- +
-{{:​sdcard.png?​48|}}+
  
-The SAGA SD Driver (''​sagasd.device''​) provides method ​for ''​READ GEOMETRY''​ of the disk. First step is to check if the MicroSD ​card that will be used is compatible or not.+The SAGA SD Driver (''​sagasd.device''​) provides ​method ​to ''​READ GEOMETRY''​ of the disk. First step is to check if your SD card is compatible or not.
  
-  ​- Make sure you have all the required files installed on your System (see previous chapter). +  - Insert ​your card into the dedicated Vampire ''​MicroSD slot''​.
-  ​- Insert ​a ''​MicroSD ​card''​ in the dedicated Vampire ''​MicroSD slot''​.+
   - Open a CLI (''​newcli''​).   - Open a CLI (''​newcli''​).
-  - Type ''​SDDiag''​ and ''​RETURN''​. +  - Type ''​SDDiag''​. 
-  ​- ​If you have an error, then your MicroSD ​will **NOT** ​works with the driver. +    ​* ​If you get an error, then your card will **NOT** ​work with the driver. 
-  ​- ​If you have informations ​such as ''​Block Size'',​ ''​Blocks''​ and ''​Capacity'',​ then the MicroSD ​should work with the driver. +    ​* ​If you get information ​such as ''​Block Size'',​ ''​Blocks''​ and ''​Capacity'',​ then your card should work with the driver. 
-  - Additionnaly, type in the ''​CLI'', ​''​SCSIQuery''​ to double-check the geometry of your SDCard. +  - Additionally, type ''​SCSIQuery''​ to double-check the geometry of your SDCard. 
-  ​- ​Check if ''​Capacity in blocks''​ is same as ''​Blocks''​ shown in ''​SDDiag''​. +    ​* ​Check if ''​Capacity in blocks''​ is the same as ''​Blocks''​ shown in ''​SDDiag''​. 
-  ​- ​Check if ''​Block length''​ is same as ''​Block Size''​ shown in ''​SDDiag''​. +    ​* ​Check if ''​Block length''​ is the same as ''​Block Size''​ shown in ''​SDDiag''​. 
-  ​- ​If there is differences,​ something is wrong and should be reported in the [[http://forum.apollo-accelerators.com|APOLLO ​Forum]].+    ​* ​If there are differences,​ something is wrong and should be reported in the [[http://www.apollo-core.com/​knowledge.php|Apollo ​Forum]].
  
-{{:​vampire051.png}}+{{:​vampire051.png?direct}}
  
 ---- ----
  
  
-===== 3) Prepare the MicroSD ​card =====+===== 3) Prepare the SD card =====
  
-{{:​settings-icon.png?​48|}}+{{:​settings-icon.png?​nolink&48|}}
  
-**Different ​methods ​for different uses**+**Different ​options ​for different uses:**
  
-  ​Prepare the disk on ''​Vampire''​ using ''​HDToolBox''​ with a given ''​FileSystem'',​ and ''​GiggleDisk''​. +  ​Prepare the card on ''​Vampire''​ using ''​HDToolBox''​ with a given ''​FileSystem''​
-  ​Prepare the disk on ''​WinUAE''​ or ''​FS-UAE''​ using ''​HDToolBox''​ with a given ''​FileSystem''​. +    * See "​Tutorial:​ Preparing the SD card on a Vampire"​ below for a detailed guide
-  ​Prepare the disk on ''​Windows''​ or ''​Linux''​ using ''​FAT95'' ​FileSystem.+  ​Prepare the card on ''​WinUAE''​ or ''​FS-UAE''​ using ''​HDToolBox''​ with a given ''​FileSystem''​. 
 +  ​Prepare the card on ''​Windows''​ or ''​Linux''​ using ''​FAT95''​, ''​ext2''​ or ''​ext3''​ FileSystems.
  
-**The following guide will explains how to prepare a MicroSD ​card** +===== 4) Prepare and run MountLists for the SD card =====
  
-  - From your Amiga equipped with ''​Vampire'' ​board+  - Open a CLI (''​newcli''​)
-  - Using ''​AmigaOS3.1''​. +  - Type ''​Execute SYS:​System/​SDMountOnOff''​. 
-  - Using ''​HDToolBox'' ​version 45.6+    * This script uses ''​C:​GiggleDisk''​ to read the SD partitions table, and creates one MountList per partition in ''​T:​SDMount''​ directory. 
-  - Using a single partition+    * GiggleDisk should detect each partition'​s FileSystem automatically,​ as long as you have that filesystem installed. 
-  - Using ''​PFS''​ FileSystem (requires ​''​L:​pfs3_aio-handler'' ​version 18.5). +    * The script then attempts to mount each partition
-  - Using ''​SYS:​System/SDMount'' ​(requires ​''​C:GiggleDisk'' ​version 1.19)+  - Type ''​CD T:SDMount''​. 
-  - Using ''​C:​pfs3format'' ​version 1.1.+  - Type ''​Dir''​
 +  - Type ''​Ed SD0''​. 
 +    * Ensure that the ''​FileSystem''​ attribute has been set correctly. 
 +    * Repeat this verification for the other partitions in that directory ​(''​SD1'',​ ''​SD2''​, etc.). 
 +  - Type ''​Copy ALL TO SYS:Storage/​DOSDrivers/'' ​to store the MountLists permanently. 
 +  - After every reboot, you will need to re-mount the SD partitions by running ​''​Mount SYS:Storage/​DOSDrivers/​SD?​''​. ​If you want to mount them automatically during boot, type ''​Copy ALL TO DEVS:​DOSDrivers/''​
 +  - Reboot. 
 +  - If the partitions have not already been formatted, they will appear ​''​Uninitialized'' ​after mounting them, and you will need to format them.
  
-**Prepare ​the MicroSD ​card with ''​HDToolBox''​**+---- 
 + 
 +===== Tutorial: Preparing ​the SD card on a Vampire ===== 
 + 
 +For this tutorial, we will create a single partition, and format it with the PFS3 filesystem.
  
   - Open a CLI (''​newcli''​).   - Open a CLI (''​newcli''​).
-  - Type ''​SYS:​Tools/​HDToolBox device=sagasd.device'' ​and RETURN+  - Type ''​SYS:​Tools/​HDToolBox device=sagasd.device''​. 
-  - ''​HDToolBox''​ should open the GUI and shows ''​SAGASD'',​ ''​Vampire SAGA-SD''​.+  - ''​HDToolBox''​ should open the GUI and show ''​SAGASD'',​ ''​Vampire SAGA-SD''​.
   - Click on this item in the list and then click the ''​Install Drive''​ button.   - Click on this item in the list and then click the ''​Install Drive''​ button.
   - Confirm the Warning requester.   - Confirm the Warning requester.
-  - Click ''​New''​ in the requester if the disk have already ​RDB.+  - Click ''​New''​ in the requester if the disk already ​has an RDB.
   - The program now shows the Drive Definition for SAGASD.   - The program now shows the Drive Definition for SAGASD.
-  - Informations are read by the ''​sagasd.device''​ and should be correct, no need to modify ​them+    * Information is read by the ''​sagasd.device''​ and should be correct, no need to modify ​anything
-  - Click ''​Install''​ button and wait a small delay.+  - Click ''​Install''​ button and wait for a small delay.
   - Click ''​Partition Drive''​ button.   - Click ''​Partition Drive''​ button.
   - Select '​1'​ in the ''​Default Setup''​ ComboBox, for a single partition.   - Select '​1'​ in the ''​Default Setup''​ ComboBox, for a single partition.
Line 124: Line 130:
   - Ensure ''​Bootable''​ is **NOT** checked.   - Ensure ''​Bootable''​ is **NOT** checked.
   - Click ''​Add / Update''​ button.   - Click ''​Add / Update''​ button.
-  - Delete all items (FileSystems) in list.+  - Delete all items (FileSystems) in the list.
   - Click ''​Add new File System...''​ and select ''​L:​pfs3_aio-handler''​.   - Click ''​Add new File System...''​ and select ''​L:​pfs3_aio-handler''​.
-  - Modify the Identifier ''​0x444F5303'' ​by ''​0x50445303''​.+  - Modify the Identifier ''​0x444F5303'' ​to ''​0x50445303''​.
   - Ensure ''​Version''​ is '​18.0'​.   - Ensure ''​Version''​ is '​18.0'​.
   - Click ''​Ok''​ button.   - Click ''​Ok''​ button.
Line 134: Line 140:
   - Click ''​Exit''​ button.   - Click ''​Exit''​ button.
   - Reboot.   - Reboot.
- +  ​Follow ​the instructions under "​Prepare ​and run MountLists for the SD card" above
-**Create the MountList with ''​SDMount''​** +    For formatting ​the mounted partition, open a CLI (''​newcli''​) and type ''​C:​PFSFormat DEVICE=SD0 NAME=SDCARD1 QUICK FNSIZE=107''​. 
- +      ​* ​ALWAYS use ''​QUICK'' ​option ​on SDCard devices (true for all non-mechanical devices, including CompactFlash). 
-  ​Open a CLI (''​newcli''​). +      ​* ​''​FNSIZE''​ stands for '​FileName Size'max is 107 chars with PFS.
-  - Type ''​Execute SYS:​System/​SDMount''​ and RETURN. +
-  - Type ''​CD T:​SDMount''​ and RETURN. +
-  - Type ''​Dir''​ and RETURN. +
-  - This script use ''​C:​GiggleDisk''​ to read the MicroSD partitions table, +
-  - and creates one MountList per partition in ''​T:​SDMount''​ directory. +
-  - Type ''​Ed SD0''​ and RETURN. +
-  - Ensure that ''​FileSystem''​ attribute is ''​FileSystem = L:​pfs3_aio-handler''​. +
-  - Save and exit if needed. +
-  - Type ''​Copy ALL TO SYS:​Storage/​DOSDrivers/''​. +
-  - Better Reboot, especially if you modified ​the MountList+
- +
-**Quick format ​the partitions with ''​pfsformat''​** +
- +
-  - Open a CLI (''​newcli''​)+
-  - Type ''​Mount SYS:​Storage/​DOSDrivers/​SD0'' ​and RETURN. +
-  - Now, we have ''​SD0:''​ mounted and is ready to be formatted. +
-  - A icon ''​SD0:​Unitialized''​ might appears or not on your Workbench desktop. +
-  - Type ''​C:​PFSFormat DEVICE=sagasd.device ​NAME=SDCARD1 QUICK FNSIZE=107'' ​and RETURN+
-  ​- ​ALWAYS use ''​QUICK'' ​command ​on SDCard devices (true for all non-mechanical devices, including CompactFlash). +
-  ​- ​''​FNSIZE''​ stands for '​FileName Size'max is 107 chars with PFS+
-  - Wait until QUICK Format is finished. +
-  - Optionally, copy ''​SYS:​Storage/​DOSDrivers/​SD0''​ (including the .info) to ''​DEVS:​DOSDrivers/''​ to mount them at boot.+
  
 ---- ----
-===== SAGA SD Driver Sources ===== 
  
-{{:​sourcecode.jpg?​48|}}+===== Additional information =====
  
-Under ''​MIT License''​ driver sources ​+  * Peripheral information[[vampire:​microsd|MicroSD Slot]] 
- +  * Technical information:​ [[saga:​sdcard|SAGA SDCard Core]] 
-  * [[https://​github.com/​ezrec/​saga-drivers/​tree/​master/​sagasd.device|sagasd.device ​host]] +  * SAGA SD Driver sources: ​[[https://​github.com/​ezrec/​saga-drivers/​tree/​master/​sagasd.device|sagasd.device]] 
-  * [[https://github.com/ezrec/saga-drivers/commits/master/sagasd.device|sagasd.device history]]+    * Covered under the ''​MIT License''​. 
 +  * Forum: ​[[http://www.apollo-core.com/knowledge.php?​b=1&​note=912|SAGA SD Driver News]] 
 +  * Video: [[https://vimeo.com/166234723|Vampire 600 V2 - PFSDoctor test with the Silver5 core]] 
 +  * Video: [[https://vimeo.com/​164901762|Vampire 600 V2 - SD-Card Filesystem Test]]
  
 ---- ----
- 
-===== Additional informations ===== 
- 
-  * Forum : [[http://​www.apollo-core.com/​knowledge.php?​b=1&​note=912|SAGA SD Driver News]] 
-  * Video : [[https://​vimeo.com/​166234723|Vampire 600 V2 - PFSDoctor test with the Silver5 core]] 
-  * Video : [[https://​vimeo.com/​164901762|Vampire 600 V2 - SD-Card Filesystem Test]] 
- 
----- 
-===== Additional tools ===== 
- 
-  * [[http://​aminet.net/​package/​disk/​misc/​giggledisk|GiggleDisk]] 
-  * [[http://​aminet.net/​package/​disk/​misc/​SCSIQuery|SCSIQuery]] 
-  * [[http://​aminet.net/​package/​disk/​misc/​pfs3aio|PFS3 AIO]] 
-  * [[http://​aminet.net/​package/​disk/​misc/​PFS3_53|PFS3]] 
-  * [[http://​aminet.net/​package/​disk/​misc/​SFS|SFS]] 
-  * [[http://​aminet.net/​package/​disk/​misc/​fat95|FAT95]] 
- 
----- 
- 
-===== Additional hardware ===== 
- 
-=== SDCard to MicroSD adapter === 
- 
-{{:​sdadapter.jpg?​100|}} 
- 
-=== SDCard to MicroSD adapter/​extender === 
- 
-{{:​microsdextender.jpg?​100|}} 
- 
- 
----- 
- 
  
 ===== Roadmap ===== ===== Roadmap =====
  
-{{:​icon_planning.png?​48|}}+{{:​icon_planning.png?​nolink&48|}}
  
-  ​- Make it works :) - Done since ''​sagasd.device''​ version 0.9+ in addition to ''​SILVER5''​+ core. +  - Add ''​Automatic disk drive geometry'',​ for much friendlier usage
-  - Fix all remaining bugs spotted by testers - Some are fixed, but there can still be some. +  - Handle on-the-fly ''​Removable disk''​. Such feature is **NOT** supported natively by ''​AmigaOS3.x''​.
-  ​- Add ''​Automatic disk drive geometry'',​ for much more friendly use+
-  - Handle on the fly ''​Removable disk''​. Such feature is **NOT** supported natively by ''​AmigaOS3.x''​.+
   - Make it ''​Romable''​ so that the OS can boot from SD.   - Make it ''​Romable''​ so that the OS can boot from SD.
  
 ---- ----
  
 +<​php>​tpl_youarehere();</​php>​
  
-[[start|Home]] |  
-[[links|Links]] |  
-[[saga_core|SAGA]] | 
-[[install_driver_rtg|SAGA RTG]] | 
-[[install_driver_sd|SAGA SD]] | 
Last modified: le 1970/01/01 01:00