# Platform Specific Utilities

Copyright © 2006 Sony Computer Entertainment Inc.
Copyright © 2006 Sony Corp.

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.2 or any later version published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license is included in the section entitled "GNU Free Documentation License".

DISCLAIMER

THIS DOCUMENT IS PROVIDED "AS IS," AND COPYRIGHT HOLDERS MAKE NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT, OR TITLE; THAT THE CONTENTS OF THE DOCUMENT ARE SUITABLE FOR ANY PURPOSE; NOR THAT THE IMPLEMENTATION OF SUCH CONTENTS WILL NOT INFRINGE ANY THIRD PARTY PATENTS, COPYRIGHTS, TRADEMARKS OR OTHER RIGHTS.
COPYRIGHT HOLDERS WILL NOT BE LIABLE FOR ANY DIRECT, INDIRECT, SPECIAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF ANY USE OF THE DOCUMENT OR THE PERFORMANCE OR IMPLEMENTATION OF THE CONTENTS THEREOF.

This note explains PS3 platform specific utilities which come with the release of Linux on PS3.

## ps3videomode: switch video mode dynamically

This command shows current video settings such as resolution, frame rate, color space, and so on, and switches them dynamically.

usage:

  ps3videomode [options]

options:

      --help,  -h         print this message
      --video, -v <ID>    set video mode ID
      --full,  -f         use full screen mode
      --dither,-d         use dither ON mode

      Video mode ID:
        0:automode
        YUV 60Hz  1:480i  2:480p  3:720p  4:1080i  5:1080p
        YUV 50Hz  6:576i  7:576p  8:720p  9:1080i 10:1080p
        RGB 60Hz 33:480i 34:480p 35:720p 36:1080i 37:1080p
        RGB 50Hz 38:576i 39:576p 40:720p 41:1080i 42:1080p
        VESA     11:WXGA 12:SXGA 13:WUXGA

        full screen mode: <video mode ID> + 128
        dither ON mode  : <video mode ID> + 2048

      If no arguments are given, ps3videomode displays the current video mode.

example:

  ps3videomode -v 3 -f (720p 60Hz with full screen mode.)
  ps3videomode -v 131 (Same as above.)
note:
  - VESA resolutions are only valid for HDMI port.
  - The signal from HDMI port supports RGB color space regardless of video mode ID.
  - Don’t change the display resolution while sound is playing.
  - Don’t change the display resolution on X-Window. If you did, you need to restart the Xserver, because of current ps3fb driver doesn't use fixed size frame buffer. It is needed that 'line_length' of frame buffer is used as fixed value to realize changing resolution via X.
  - If you want to boot linux as specified video mode, you may use kernel parameter. It has been described on other section about How to Use Kboot.

## boot-game-os: shutdown linux and switch to game os

This command switches boot flag in “other-os flash area” to boot game os, and reboot onto game os. This command requires root privilege.

usage:

      boot-game-os

## other-os-flash-util: other-os flash area manipulation utility

This command is other-os flash area manipulation utility program. It's easy to destroy a boot loader(kboot) stored in the other-os flash area. Pleaase handle this command with caure Usually, there is no need for using this command directly. If you want just to boot game os, you should use boot-game-os command.

usage:

      other-os-flash-util [-b|-B] [-g|-r] flash_device [boot_loader_img]
      other-os-flash-util -s flash_device
      other-os-flash-util -d flash_device

options:

      -s show current settings
      -d print difference of clock time between game os and linux
      -b change boot flag : boot game os
      -B change boot flag : boot linux
      -g change boot loader format flag : compressed by gzip
      -r change boot loader format flag : not compressed

## find-other-os-flash: find out other-os flash

This command find out device file corresponding to other-os flash area, and print path of it. This is convenient when you use other-os-flash-util.

usage:

      find-os-flash-other

---