This is an old revision of the document!


Mounting a MicroSD Card

Overview

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.

<wrap tip>It is possible to insert standard-size SD cards into the MicroSD slot using a simple adapter (explained here). Therefore, for brevity, the “Micro” prefix will be omitted and only “SD card” will be used in this article.</wrap>


Important notes

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:

  1. MountList attributes such as LowCyl, HighCyl and some others must be explicitly specified. For example, LowCyl = 0 will NOT work!
  2. Each SD card must use its own MountList. NEVER use a MountList dedicated to a given SD card with another SD card.
  3. Use a third-party program, such as GiggleDisk, to create correct MountList by reading the lowlevel geometry of the disk.

1) Install the required files

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

  1. Run the installer provided in the SAGADriver package.

1.2) Install SCSIQuery (optional)

  1. Download SCSIQuery, available on Aminet.
  2. Copy the file SCSIQuery/SCSIQuery to C:SCSIQuery

1.3) Install the desired filesystem

Recommended filesystem: PFS3 All-In-One

  1. Download PFS3AIO, available on Aminet.
  2. Copy the file pfs3_aio-handler to L:pfs3_aio-handler.
  3. Download PFS3_53, available on Aminet.
  4. Copy the file PFS3/tools/pfsformat to C:pfsformat.
  5. Optionally, you can copy the other PFS tools (pfsdoctor, setfnsize, …) to C:.

Other filesystems to consider:

1.4) Reboot your computer


2) Check the SD card

The SAGA SD Driver (sagasd.device) provides a method to READ GEOMETRY of the disk. First step is to check if your SD card is compatible or not.

  1. Insert your card into the dedicated Vampire MicroSD slot.
  2. Open a CLI (newcli).
  3. Type SDDiag.
    • If you get an error, then your card will NOT work with the driver.
    • If you get information such as Block Size, Blocks and Capacity, then your card should work with the driver.
  4. Additionally, type SCSIQuery to double-check the geometry of your SDCard.
    • Check if Capacity in blocks is the same as Blocks shown in SDDiag.
    • Check if Block length is the same as Block Size shown in SDDiag.
    • If there are differences, something is wrong and should be reported in the Apollo Forum.


3) Prepare the SD card

Different options for different uses:

  • Prepare the card on Vampire using HDToolBox with a given FileSystem.
    • See “Tutorial: Preparing the SD card on a Vampire” below for a detailed guide.
  • 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.

4) Prepare and run MountLists for the SD card

  1. Open a CLI (newcli).
  2. Type Execute SYS:System/SDMountOnOff.
    • This script uses C:GiggleDisk to read the SD partitions table, and creates one MountList per partition in T:SDMount directory.
    • GiggleDisk should detect each partition's FileSystem automatically, as long as you have that filesystem installed.
    • The script then attempts to mount each partition.
  3. Type CD T:SDMount.
  4. Type Dir.
  5. 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.).
  6. Type Copy ALL TO SYS:Storage/DOSDrivers/ to store the MountLists permanently.
  7. 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/.
  8. Reboot.
  9. If the partitions have not already been formatted, they will appear Uninitialized after mounting them, and you will need to format them.

Tutorial: Preparing the SD card on a Vampire

For this tutorial, we will create a single partition, and format it with the PFS3 filesystem.

  1. Open a CLI (newcli).
  2. Type SYS:Tools/HDToolBox device=sagasd.device.
  3. HDToolBox should open the GUI and show SAGASD, Vampire SAGA-SD.
  4. Click on this item in the list and then click the Install Drive button.
  5. Confirm the Warning requester.
  6. Click New in the requester if the disk already has an RDB.
  7. The program now shows the Drive Definition for SAGASD.
    • Information is read by the sagasd.device and should be correct, no need to modify anything.
  8. Click Install button and wait for a small delay.
  9. Click Partition Drive button.
  10. Select '1' in the Default Setup ComboBox, for a single partition.
  11. Change Buffers to '150'.
  12. Change Partition Name to SD0.
  13. Ensure Bootable is NOT checked.
  14. Click Add / Update button.
  15. Delete all items (FileSystems) in the list.
  16. Click Add new File System… and select L:pfs3_aio-handler.
  17. Modify the Identifier 0x444F5303 to 0x50445303.
  18. Ensure Version is '18.0'.
  19. Click Ok button.
  20. Click Change… button.
  21. Select PDS\03 in the File System ComboBox.
  22. Click Save button.
  23. Click Exit button.
  24. Reboot.
  25. Follow the instructions under “Prepare and run MountLists for the SD card” above.
    • 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).
      • FNSIZE stands for 'FileName Size'; max is 107 chars with PFS.

Additional information


Roadmap

  1. Add Automatic disk drive geometry, for much friendlier usage.
  2. Handle on-the-fly Removable disk. Such feature is NOT supported natively by AmigaOS3.x.
  3. Make it Romable so that the OS can boot from SD.

You are here: start » install_driver_sd

Last modified: le 2020/08/02 12:37