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
install_driver_sd [2017/02/05 21:18]
tuko [1.2b) Install SCSIQuery (optional)]
install_driver_sd [2019/11/05 03:44]
muaddib removed
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.2) Install SCSIQuery (optional) ==== ==== 1.2) Install SCSIQuery (optional) ====
Line 38: Line 42:
   - 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