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)]
— (current)
Line 1: Line 1:
-====== How To : Install the SAGA SDCard Driver ====== 
  
-{{:​microsd.png?​64|}} 
- 
-===== 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. 
- 
- 
----- 
- 
- 
-===== Important notes ===== 
- 
-{{:​warning-icon.png?​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 : 
- 
-  - ''​MountList''​ attributes such as ''​LowCyl'',​ ''​HighCyl''​ and some others must be explicitely 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. 
-  - 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]]. 
- 
----- 
- 
-===== 1) Install the required files ===== 
- 
-{{:​install-icon.png?​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 : 
-==== 1.1) Install the SAGA SD Driver package ==== 
- 
-  - Run the installer provided in the [[http://​www.apollo-accelerators.com/#​download|SAGADriver LHA Package]]. 
- 
- 
-==== 1.2) Install SCSIQuery (optional) ==== 
- 
-  - Download [[http://​aminet.net/​package/​disk/​misc/​SCSIQuery|SCSIQuery]],​ available on Aminet. 
-  - Copy the file ''​SCSIQuery/​SCSIQuery''​ to ''​C:​SCSIQuery''​ 
- 
-==== 1.3) Install PFS3 All-In-One (recommended filesystem) ==== 
- 
-  - Download [[http://​aminet.net/​package/​disk/​misc/​pfs3aio|PFS3AIO]],​ available on Aminet. 
-  - 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. 
-  - Copy the file ''​PFS3/​tools/​pfsformat''​ to ''​C:​pfsformat''​. 
-  - Optionally, you can copy the other PFS tools (''​pfsdoctor'',​ ''​setfnsize'',​ ...). 
- 
-==== 1.4) Check for Installed files ==== 
- 
-  - 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 MicroSD card ===== 
- 
-{{:​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. 
- 
-  - Make sure you have all the required files installed on your System (see previous chapter). 
-  - Insert a ''​MicroSD card''​ in the dedicated Vampire ''​MicroSD slot''​. 
-  - Open a CLI (''​newcli''​). 
-  - Type ''​SDDiag''​ and ''​RETURN''​. 
-  - If you have an error, then your MicroSD will **NOT** works with the driver. 
-  - If you have informations such as ''​Block Size'',​ ''​Blocks''​ and ''​Capacity'',​ then the MicroSD should work with the driver. 
-  - Additionnaly,​ type in the ''​CLI'',​ ''​SCSIQuery''​ to double-check the geometry of your SDCard. 
-  - Check if ''​Capacity in blocks''​ is same as ''​Blocks''​ shown in ''​SDDiag''​. 
-  - Check if ''​Block length''​ is 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]]. 
- 
-{{:​vampire051.png}} 
- 
----- 
- 
- 
-===== 3) Prepare the MicroSD card ===== 
- 
-{{:​settings-icon.png?​48|}} 
- 
-**Different methods for different uses** 
- 
-  - Prepare the disk on ''​Vampire''​ using ''​HDToolBox''​ with a given ''​FileSystem'',​ and ''​GiggleDisk''​. 
-  - Prepare the disk on ''​WinUAE''​ or ''​FS-UAE''​ using ''​HDToolBox''​ with a given ''​FileSystem''​. 
-  - Prepare the disk on ''​Windows''​ or ''​Linux''​ using ''​FAT95''​ FileSystem. 
- 
-**The following guide will explains how to prepare a MicroSD card** ​ 
- 
-  - From your Amiga equipped with ''​Vampire''​ board. 
-  - Using ''​AmigaOS3.1''​. 
-  - Using ''​HDToolBox''​ version 45.6. 
-  - Using a single partition. 
-  - Using ''​PFS''​ FileSystem (requires ''​L:​pfs3_aio-handler''​ version 18.5). 
-  - Using ''​SYS:​System/​SDMount''​ (requires ''​C:​GiggleDisk''​ version 1.19). 
-  - Using ''​C:​pfs3format''​ version 1.1. 
- 
-**Prepare the MicroSD card with ''​HDToolBox''​** 
- 
-  - Open a CLI (''​newcli''​). 
-  - Type ''​SYS:​Tools/​HDToolBox device=sagasd.device''​ and RETURN. 
-  - ''​HDToolBox''​ should open the GUI and shows ''​SAGASD'',​ ''​Vampire SAGA-SD''​. 
-  - Click on this item in the list and then click the ''​Install Drive''​ button. 
-  - Confirm the Warning requester. 
-  - Click ''​New''​ in the requester if the disk have already a RDB. 
-  - 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. 
-  - Click ''​Install''​ button and wait a small delay. 
-  - Click ''​Partition Drive''​ button. 
-  - Select '​1'​ in the ''​Default Setup''​ ComboBox, for a single partition. 
-  - Change ''​Buffers''​ to '​150'​. 
-  - Change ''​Partition Name''​ to ''​SD0''​. 
-  - Ensure ''​Bootable''​ is **NOT** checked. 
-  - Click ''​Add / Update''​ button. 
-  - Delete all items (FileSystems) in list. 
-  - Click ''​Add new File System...''​ and select ''​L:​pfs3_aio-handler''​. 
-  - Modify the Identifier ''​0x444F5303''​ by ''​0x50445303''​. 
-  - Ensure ''​Version''​ is '​18.0'​. 
-  - Click ''​Ok''​ button. 
-  - Click ''​Change...''​ button. 
-  - Select ''​PDS\03''​ in the ''​File System''​ ComboBox. 
-  - Click ''​Save''​ button. 
-  - Click ''​Exit''​ button. 
-  - Reboot. 
- 
-**Create the MountList with ''​SDMount''​** 
- 
-  - Open a CLI (''​newcli''​). 
-  - 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|}} 
- 
-Under ''​MIT License''​ driver sources : 
- 
-  * [[https://​github.com/​ezrec/​saga-drivers/​tree/​master/​sagasd.device|sagasd.device host]] 
-  * [[https://​github.com/​ezrec/​saga-drivers/​commits/​master/​sagasd.device|sagasd.device history]] 
- 
----- 
- 
-===== 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 ===== 
- 
-{{:​icon_planning.png?​48|}} 
- 
-  - Make it works :) - Done since ''​sagasd.device''​ version 0.9+ in addition to ''​SILVER5''​+ core. 
-  - Fix all remaining bugs spotted by testers - Some are fixed, but there can still be some. 
-  - 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. 
- 
----- 
- 
- 
-[[start|Home]] |  
-[[links|Links]] |  
-[[saga_core|SAGA]] | 
-[[install_driver_rtg|SAGA RTG]] | 
-[[install_driver_sd|SAGA SD]] | 
Last modified: le 2020/08/02 12:37