3.2 Usage and limitations
The filenames used on the filesystem of the cassiopei are limited to a maximum number of 80
characters. When this number is exceeded problems will occur when it is selected by the Cassiopei.
Do not worry, your filesystem or Cassiopei will not explode or melt, but what you will experience
is perhaps not what you might expect at first. The problem is the storage reserved for filenames.
The filesystem allows for filenames of up to 255 characters. But the Cassiopei does not have that
much memory available to handle such long filenames. So when you browse through the list of
files, the limit is set to a length of 80 characters, and the filename will be truncated to a length of
that size. So when the user selects such a file the Cassiopei will eventually not be able to find that
file, because it's name is truncated and therefore cannot be loaded, because it will search for the
truncated name, which does not exist, so there never will be a filename match. Simply use a
filename that is shorter then the max size and you'll be fine.
The Cassiopei does not automatically sort the files in alphabetical order when browsing through the
list of files. This simply takes to much memory and processing time. Instead all files are shown in
the order that they are put onto the card. If this is undesirable then there is a little trick. Simply
place the SD-card into a computer, move the files from the desired folder of your SD-card to a
folder on your Windows PC. Then select all the files and move them back to the folder on the SD-
card. The computer will copy alphabetically and therefore store the files in the correct order on the
filesystem. Making it look like you want.
However keep in mind that when you add a new file that this trick needs to be done again, as the
new file will be at the bottom of the list as it is added last to the filesystem.
If for any reason you want to change to a different SD-card then you can simply copy/move all files
from your current card, to a temporary folder on your PC. Then move all these files to the new
(bigger) card. This way you preserve all the settings and required files that the Cassiopei needs.
And you will have no trouble with your new card.
SD-cards are like any other media, not perfect. Some will last a lifetime, other won't or simply get
lost. Therefor it is a good thing not to put your entire collection ONLY on your SD-card. Always
make sure you have a backup of those precious files!
3.3 Required folders in the root of the SD-card
The SD-card used for the Cassiopei should have the following structure as described in this chapter.
The root of the card should hold the following folder:
_SYSTEM_
<- contains Cassiopei related files (settingsfile and webserver related files)
C16
<- contains Computer specific (C16) files
C64
<- contains Computer specific (C64) files
C128
<- contains Computer specific (C128) files
PET20XX
<- contains Computer specific (PET/CBM2000) files
PET30XX
<- contains Computer specific (PET/CBM3000) files
PET40XX
<- contains Computer specific (PET/CBM4000) files
PET80XX
<- contains Computer specific (PET/CBM8000) files
PLUS4
<- contains Computer specific (Plus 4) files
VIC20
<- contains Computer specific (VIC20) files
2019-10-27
Page 21 of 76
CASSIOPEI v2.0
Summary of Contents for CASSIOPEI
Page 1: ...CASSIOPEIv2 0 USER MANUAL this manual is intended for firmware version V20191027 or higher...
Page 62: ......
Page 69: ......