CasperFS510-HowTo.txt
http://www.kameda-lab.org/_local/imagelab.tsukuba.ac.jp/ubuntu1204/
http://www.kameda-lab.org/_local/imagelab.tsukuba.ac.jp/ubuntu1204/cartridges/510E64/CasperFS510-HowTo.txt

kameda[at]iit.tsukuba.ac.jp
2012/10/08, 04:09 JST	first version.

==============================
(1) Install
==============================

(ReCasper:1) 

What you need to prepare
- A USB memory stick (8GB or larger required)
- One Windows PC (Use it to cook USB and boot test) 
- One PC with NVidia graphic card (

(ReCasper:2-a, download)

You need to download :
- Universal USB Installer(windows executable)
  http://www.pendrivelinux.com/universal-usb-installer-easy-as-1-2-3/
- Ubuntu 12.04.1 LTS : ubuntu-12.04.1-desktop-amd64.iso
  http://releases.ubuntu.com/12.04/
- CasperFS510.zip
  http://www.kameda-lab.org/_local/imagelab.tsukuba.ac.jp/ubuntu1204/cartridges/510E64/CasperFS510.zip
- Unzip CasperFS510.zip and you will have four files.
     CasperFS510/filesystem.manifest
     CasperFS510/filesystem.manifest-desktop
     CasperFS510/filesystem.size
     CasperFS510/filesystem.squashfs

(ReCasper:2-b, do)

Then do :
- Plug the USB stick the PC, and run the universal USB installer.
        Step1: Desktop Ubuntu12.4.X
        Step2: Specify the ubuntu-12.04.1-desktop-amd64.iso at your directory
        Step3: Check-box On ("We will format")
        Step4: 0MB - 4089MB
        Go! (It will take several minutes) 
        ---
        Size problem:
          When you use 8GB, any casper-rw size should be OK.
          When you use 4GB, the max room is about 1100MB (depending on the definition of "4GB").
          For example, it should be less than 1130MB at one of my 4GB memory sticks.
        ---

(ReCasper:3) 

Replace casper/filesystem.* on the USB memory by the downloaded ones.
Suppose your USB memory stick is at E:

- Delete the pre-installed files below
  E:\casper\filesystem.*

- Copy the downloaded files (below) to E:\casper
       filesystem.manifest
       filesystem.manifest-desktop
       filesystem.size
       filesystem.squashfs

And now the USB memory stick is ready to boot.

==============================
(2) Boot
==============================

The hardest part for some people would be here.

- Power off the target PC.
- Plug in the USB memory stick.
- I strongly recommend you to take off any other USB storage devices!
  (internal SATA HDD is OK, Casper won't use it)
- Power on
- GET TO THE BIOS MENU and choose the boot device to the USB memory stick.
  ... If you have "boot options" (or quick boot menu or whatever), it would be easy.
  ... Usually Func-2? Func-11? Del? it depends.
  ... Secured PC might not be allowed to boot from USB. Ask your administrator.

- If you successfully choose your USB memory stick, you will see
  "Installer boot menu"
  with a simple (but nice) black/white screen.
  Do wait for 5 seconds, it will automatically boot up (or choose "Run Ubuntu from this USB").
- You should see the Unity Desktop screen in a minute or so. Welcome to the Casper Cartridge!

[Warning : Calm down, wait for 10 or 20 more seconds :-)]

- Sometimes Ubuntu is not still ready even after you see the normal Unity Desktop.
- (It happens when your PC is not fast, your USB memory stick is not fast, ... whatever).
- I recommend you to wait for 30 seconds or so before you start working.
- (This delay is obvious when you want to use DASH, left side bar.)

[Warning : DO SHUT DOWN on exit]

- After you boot the system, the Ubuntu behaviour is exactly same as the one installed on HDD.
  (This is NOT like CDROM-boot!)
- That means, YOU NEED TO gracefully SHUT DOWN the system to turn off the system.
- Do not power off suddenly!
- Do not plug out your USB memory stick suddenly!
- SHUT-DOWN can be done in normal procedure, just click the top-right icon and select "shut down".

==============================
(3) Some DO NOTs !!
==============================

[Package Update]

- Do not update the packages from GUI tools,
    No updates from the top-right icon
    No updates from "Ubuntu Software Center"
  (They could be fine, but I never tried.)
- I prefer to that from terminal.
$ sudo apt-get update
- Anyway, as this is not a permanently running system, 
  you don't need to update so much.

==============================
(4) Demos !
==============================

(4-1) My samples

My cheap samples could be found at /home/ubuntu/GoGoCasper .

(4-2) Demos from software packages 

Some demos could be found in these directories.

/home/ubuntu/ARToolKit-Casper/ARToolKitPlus-2.3.0/sample/
/home/ubuntu/Uchiyamakers-Casper/DRDM/DRDM-Casper/
/home/ubuntu/OpenNI-Casper/OpenNI/Platform/Linux/Bin/x64-Release/
/home/ubuntu/OpenNI-Casper/NITE-Bin-Dev-Linux-x86-v1.5.2.21/Samples/Bin/x64-Release/
/home/ubuntu/PCL-Casper/PCL-1.6.0-Source/build20120923/bin/
/home/ubuntu/PTAM-Casper/PTAMM-Casper/
/home/ubuntu/PTAM-Casper/PTAMM-TrakMark/

(4-3) Let's compile too

$ cd /home/ubuntu/OpenCV-Casper/OpenCV-2.4.2/build20121008/
$ make -j2
$ cd bin/
$ ./lkdemo


==============================
(5) Citation ?
==============================

The related articles could be found at:

[1]
A Study of Camera Tracking Evaluation on TrakMark Data-Set
Masayuki Hayashi, Itaru Kitahara, Yoshinari Kameda, Yuichi Ohta (University of Tsukuba)
The 2nd International Workshop on Benchmark Test Schemes for AR/MR Geometric Registration and Tracking Method (TrakMark2011)
in conjunction with ISMAR2011.
http://ypcex.naist.jp/trakmark/workshop11/

[2]
Uniform Software Environment for AR Performance Evaluation based on USB bootable Linux
Yoshinari Kameda, Itaru Kitahara, Yuichi Ohta (University of Tsukuba)
The 3rd International Workshop on Benchmark Test Schemes for AR/MR Geometric Registration and Tracking Method (TrakMark2012)
in conjunction with ICPR2012.
http://ypcex.naist.jp/trakmark/workshop12/

--- End of HowTo ---