Pandora Wiki - User contributions [en]

Pandian

2014-04-10T14:21:16Z

Stackshadow: /* Up-To-Date Home directory */

[[File:Post-3032-0-90501200-1380479048.png|thumbnail|Logo]]

'''Pandian is an debian-based armhf desktop and CLI distro for your Pandora.'''
Ideas, Bugs, or feature-requests? Report to:
https://www.evilbrain.de/review/index.php?project=4

=== Main Features ===
* The debian way.
* Access to all packages from Debian software repositories.
* Pandian hosts its own Debian repo http://pandian.openpandora.org with up to date scripts, all settings and extra programs.
* armhf-build, which means '''f'''loat operations are relegated to special '''h'''ardware rather than taxing the main cpu with them (as with softfloat)

== '''Pandian''' - '''MARK 2''' The newest release ==
Second version of Pandian 
'''Full Debian GNU/Linux based on sid branch with LXDE desktop environment (normal) or CLI (minimal-) build.''' 
'''hardfloat armv7l''' yule release '''Date: 29.12.2013'''
[http://boards.openpandora.org/topic/15302-pandian-mark2/ forum link]

=== '''Installation''' requirements===
* '''Pandora''' ;) All versions fine?
* '''SD card''' minimum 2GB ( was tested with 4GB )
* '''PC''' Linux|GNU, BSD, Mac, or Windows for putting the install on the aforementioned SD-card.

==== '''Download''' a version of Pandian ====
There are two different versions of the "MARK2" release:
{| class="wikitable"
|-
! Version !! Description !! Includes !! Link !! Size !! Checksums (sha256)
|-
| '''base''' || pandian for advanced users, without any Desktop environment but with basic network-tools ( iw, ceni ) || ceni ( network-manager) network-manager MediaPlayer ( mpd ) iw (wireless-tools) || [http://www.filedropper.com/pandian-mark2-base-hf2014-01-05 filedropper: pandian-mark2-base-hf2014-01-05.7z] [http://pandian.openpandora.org/releases/pandian-mark2-base-hf_2014-01-05.7z pandian.openpandora.org: pandian-mark2-base-hf_2014-01-05.7z] || 161MB || pandian-mark2-base-hf_2014-01-05.'''7z'''↓ b11ffe9cc4fd6111775d0b48c133b1e1afcf6865de784b9865db0cea29674d85 pandian-mark2-base-hf_2014-01-05.'''img'''↓ c1903423a5b5e0d04563f14526e8161fbe77a102e64d5d571bcf3b87870fa211
|-
| '''normal''' || pandian for regular users, with full Desktop environment (LXDE) || network-manager MediaPlayer ( mpd with gurlp ) nub-support calibrator-application medit Text editor. mpd audio player backend, glurp as frontend || [http://www.filedropper.com/pandian-mark2-hf2014-01-02 filedropper: pandian-mark2-hf2014-01-02] [http://pandian.openpandora.org/releases/pandian-mark2-hf_2014-01-02.7z pandian.openpandora.org: pandian-mark2-hf_2014-01-02.7z] || 394MB || pandian-mark2-hf_2014-01-02.'''7z'''↓ 3731d70a4d8ec59e79a046f34f69c5c809be73e38cfc91a5b580478b8f8c222f pandian-mark2-hf_2014-01-02.'''img'''↓ 83b8d3fa5bd0588cfb8b11cfe6b827819e6311e98396a6e32c46c9692f072e96
|}
Notes:
* It is trivial to change from LXDE to [[Xfce]] (or any other desktop environment), adding a new user interface atop the minimal install is more advanced as manual setup of USB-Networking or wifi is needed to do so.
* All images have automount ( for USB-Sticks, external Hard-Drives etc. ) and ALSA sound support

==== '''Verify''' that your download is OK ====
* After you download the version you picked, verify its checksum to make sure the integrity of the downloaded file matches (in being an exact copy the one on the server)

#open up a terminal
# "'''sha256sum ~/downloads/pandian/<image.7Z>'''" (input where you have the file and the one you chose to download)
# make sure it matches the given md5sum, if not, try to download another copy. This step isnt mandatory, but its there to make sure everything is fine before we proceed.

==== '''Unzip''' the downloaded image ====
*Unzipping 7z archives
# Open up a terminal (or do it your way)
# Enter"'''7zr e <image.7z>'''"
# You now have an unzipped image

==== (Optional) '''Preparation''', find out where to install ====

This step helps you find out where the SD card is mounted. 

If you have an build in SD-Card-Reader this is normally /dev/mmcblk0p1 ( in Debian )
If you have an USB-Card-Reader this is something like /dev/sdc ( in Debian )
* Open an Terminal and input "'''lsblk'''"
* You will get a list with the actual Block-Devices
* The SD-Card should be of type 'disk'

You can also try gparted to see which devices you have and identify the SD-card from there

==== '''Install''' the image to the SD-Card ====
{{warning
| Warning, this will destroy everything on the device ! So please be very sure which device is you SD-Card !
}}
# Here it will be /dev/sd'''x'''

(note that the x after the sd is the drive letter, it could be ''sd'''b''''' sd'''c''''' or ''sd'''d''''' and so on, lets say its sd'''c'''. Which means c is the drive letter for the SD-card and that sd- a and -b are in use for other things. 
 
When writing to the device, make sure not to include the following number, which is the partition ''sdc'''1''''' ''sdc'''2''''' etc. since we are using the base card here) 
 
This means considerations for partitions and filesystem are taken care of, so no need to worry about that. Do ''not'' pick the wrong drive however, since dd will happily write the image to somewhere it isn't supposed to if you just give it root privileges and hit enter.) 
 
#Copy image to SD-Card with "'''dd if=<image.img> of=/dev/sdx'''"

You now have Pandian installed on your SD card and its ready to go. :) However after copying the image to the SD-Card resizing the partitionspartitions is needed to fully utilize the space, since by default the install is limited to 2GB. (If your card is bigger Pandian is still limited to those 2GB)

====(Optional) '''Resize''' SD-Card ====

* This can be done with gparted on linux|gnu
* start gparted

[[File:Gparted resize 001.png|800px|thumbnail|none|The actual partitions of the SD-CARD. Please select the correct device at the top right corner.]]
[[File:Gparted resize 002.png|800px|thumbnail|none|Rightclick to the second partition and select Resize/Move]]
[[File:Gparted resize 003.png|400px|thumbnail|none|You see the actual Size of this partition]]
[[File:Gparted resize 004.png|400px|thumbnail|none|Move the slider to the right, or set "Free space following" to 0]]
[[File:Gparted resize 005.png|800px|thumbnail|none|After you press the "Resize/Move" button, you get the preview of the new partition structure]]
[[File:Gparted resize 006.png|800px|thumbnail|none|When you press "Apply all operations", youve got a warning that you can loss your Data. THIS IS THE LAST CHANGE TO CHECK IF YOU SELECTED THE CORRECT DEVICE.

 Press Apply if everything is correct.]]

* After everything is fine, you have a fresh install of Pandian on you SD-Card
 

=== '''Startup''' wizard ===
* Upon first boot of Pandian, there is a first-start-wizard which guides you through some basic settings.
These are: Locale, timezone, time and date, password for admin and user setup and finally calibration of the touchscreen.
The script is located in /usr/sbin/pdSetup should you need to run it again.

==== Navigation ====
* Inside a dialog you can navigate with the cross/dpad
* Hit space to select a checkbox
* Moving between <Ok> and <Cancel> can be down with the use of TAB ( Tap Fn then tap Space )
* Acknowledge with Enter

*All done, enjoy :)

[[File:PandianDesktop.png|frameless]]

=== '''Network''' connection instructions:===

====normal ====
* Use network-manager

====minimal====
* Use ceni network manager

===(Optional) '''Update''' of Pandian system ===
* After you setup your Pandora, it is useful to update your system. It is a rolling release, which means since the image was made, the system is forever updated with new packages.
* open a terminal
* get root ( command is: "su" )
* enter "apt-get update" to download package information from the repositories
* enter "apt-get upgrade" to update all packages that are out of date
(pandian packages are also updated this way :)
* Note: to update only the pandian-packages enter "apt-get install pandian-full"

==== Up-To-Date Home directory ====
Normally files inside users home get overwritten ( if you say yes ) during upgrade. 
Since an change of this behavior, files inside the users home don't get changed anymore by pandian packages. 
Now settings of fluxbox and xinit/xinitrc are links. So The user can just unlink some of the settings and write there own, without getting overwritten from an upgrade. 
 
To get up-to-date with the fixes in pandian, you can initialize the home directory to default state. 
To do this, just run in an terminal ( as USER ):
* cp -a /etc/skel/. /home/<YourUserName>/

==== '''Upgrade Warnings''' ====
* if mpd is running, upgrade will fail. How to fix this:
** Open an terminal
** Login as root ( command "su" )
** Enter root password
** stop mpd with: /etc/init.d/mpd stop
** Kill it ( to be sure ): killall mpd
** upgrade again: apt-get dist-upgrade

==== Upgrade from "minimal" to "normal" ====
It is possible to upgrade from the "minimal"-image to the "normal"-image.
This can simlpy be done by installing the pandian-lxde debian package
* get an connection to the internet(tm) with ceni
* open an terminal
* get root ( with command: "su" )
* update package list with: "apt-get update"
* install pandian-lxde with "apt-get install pandian-lxde"
* after everything is finished login with the user you setup before
* open an terminal
* get root ( with command: "su" )
* load keymap with "xmodmap /etc/skel/.pndXmodmap"
* the easiest way is to activate the first-start-wizard with "insserv firstuse"
* reboot and go through the wizard

===(Optional) '''Information''' ===

=== Additional Users/Groups ===
There are additional Users/Groups added to the standard debian-users
==== Groups ====
* admin
:This superuser privilege is used by sudo for admin task like shutdown etc.
* mpd
:This user/group has access to mpd-related files ( socket, pid-files )

==== Power-Modes ====
===== LID-Close =====
* If the lid is closed only the screen will be disabled
===== Low-Power-Mode / Shutdown =====
[[File:Lead Photo For Power modes0-2920264867079787.jpg|thumbnail|right|Switch]]
* Switch to left: Pandora will go to low power mode ( reduce CPU, Disable LID, Pause processes )
* Switch to right: Shutdown the pandora

==== pdcmd ====
* This script handles all system-related stuff, like lid, low-power, usb or wifi.
* This should run as root
 
Usage:
{| class="wikitable"
|-
! Command !! What's done
|-
| /usr/sbin/pdcmd LCDBright + || Increase the light of the lid
|-
| /usr/sbin/pdcmd LCDBright - || Decrease the light of the lid
|-
| /usr/sbin/pdcmd LCDBright 10 || Set the Brightness of the lid to 10
|-
| /usr/sbin/pdcmd LCDTrigger || Trigger the lid ( WARNING: THIS DISABLES THE LID ! )
|-
| /usr/sbin/pdcmd USBNetTrigger || Enable the USB-Networking (module g_ether). If usbnetworking is on, it will disable it
|-
| /usr/sbin/pdcmd USBHostTrigger || Enable the USB-Host (module ehci-hcd). If USB-Host is on, it will disable it
|-
| /usr/sbin/pdcmd WLANTrigger || Enable Wifi. If Wifi is enabled it will be disabled
|}

==== Several tweaks ====

==== '''Fluxbox''' ====
Fluxbox is the actual Desktop Environment for pandian. It is simple fast and easy to configure.

===== custom menu =====
You can setup your own menu-entry's for fluxbox:
* open an terminal ( or an editor ) as root
* create a new file in ./fluxbox/menu-mymenu
( Note: the menu -filename must be named menu-* )
* run: "gen-menu-fluxbox <username>" as normal user, to generate the menu-file
* your new menu is ready for use

===== autostart =====
You can setup your own autostart script in ~/.fluxbox/startup-*
for example you can use: ~/.fluxbox/startup-mystart
Nothing else must be done, just logout and login to test it ( or reboot )
===== Fixing broken keyboard layout =====
If your Pandian has a German keyboard layout, you might have some trouble because it does absolutely not fit US layout on the Pandora.
There is a work around this isse.

*Make sure, the file .pndXmodmap is read in on startup. Open the file ''.xsessionrc'' in your ''home'' directory and, if not existent, add following lines at the bottom of the file
setxkbmap en_US
xmodmap /home/yourUsername/.pndXmodmap
*There must be the absolute path (no "~/").

===== Making the Pandora Button work like the Windows key =====
Many users complained, their Pandora Button has no function in Pandian. This can be changed by mapping the button as ''"mod4"''.

*Insert in the last line of the .pndXmodmap from your ''home'' directory:
add mod4 = XF86MenuKB

===== Openbox =====
Pandian comes with an unconfigured Openbox as a possible session. Here are some config templates.

====== Use the Pandora key to start the menu ======
*If not existent,
cp /etc/xdg/openbox/rc.xml /home/yourUserName/.config/openbox/
* Open the rc.xml with a text editor and search for the section <keyboard>.
* Insert the new keybind:
<keybind key="XF86MenuKB">
<action name="ShowMenu">
<menu>root-menu</menu>
</action>
</keybind>

===== Intuitive Openbox configuration template =====
Prerequisites:
*mapped 'Pandora key' as 'Windows key'(see above)
*optional: use tint2 as panel

Features:
*Changing window by '''[Ctrl] + [up]/[down]'''
*Changing workspace by '''[Ctrl] + [left]/[right]'''
*Closing window by '''[Ctrl] + [Q]'''
*Screenshot (window): '''[Ctrl] + [Shift] + [Alt] + [F11]'''
*Screenshot (whole desktop): '''[Ctrl] + [Shift] + [Alt] + [F12]'''
*and some more

'''Download:'''
[https://www.dropbox.com/s/ud0muusrxq9g9va/rc.xml rc.xml]

===== Intuitive Openbox menu template =====
Features:
*Most important programms in root menu
*menu entries for WLAN, USB host and low power mode
'''Download:'''
[https://www.dropbox.com/s/fqjxg5xoymg5fep/menu.xml menu.xml]

== Mounting internal NAND to /mnt ==

Pandora internal NAND exposes a raw flash interfaces. For such devices, the
Linux kernel exposes a special MTD abstraction and "mtd aware" filesystems may
give a better performance. Pandora uses UBIFS, which needs UBI volume
management to work.

# Install mtd-utils
# Run the following commands

<syntaxhighlight lang="bash">
# Attach mtd device 4 to UBI volume management 0
ubiattach -m 4 -d 0
# Mount first partition of the UBI group 0 to /mnt
mount -t ubifs /dev/ubi0_0 /mnt
# Attach mtd device 3 to UBI volume management 1
ubiattach -m 3 -d 1
# Mount first partition of the UBI group 1 to /mnt
mount -t ubifs /dev/ubi1_0 /mnt/boot
</syntaxhighlight>

== Old releases ==

=== Mark2 minimal-hf2014-01-02 ===

{| class="wikitable"
|-
! Version !! Description !! Included !! Link !! Checksums (sha256)
|-
| minimal || pandian without any Desktop environment but with the basic pandian package || nano || [http://www.filedropper.com/pandian-mark2-minimal-hf2014-01-02 filedropper: pandian-mark2-minimal-hf2014-01-02] [http://pandian.openpandora.org/releases/pandian-mark2-minimal-hf_2014-01-02.7z pandian.openpandora.org: pandian-mark2-minimal-hf_2014-01-02.7z] || pandian-mark2-minimal-hf_2014-01-02.'''7z'''↓ a35106473e54c55d64c7eae2088d8c267b605baf17d5338b8e2938dbfe3c01ca pandian-mark2-minimal-hf_2014-01-02.'''img'''↓ c68a42c1aef0238c1dd6ff33b628a2c0dea812a7b5b2d906afb185f93f940f84
|-
| minimal-networking fix|| HotFix for pandian-mark2-minimal-hf_2014-01-02 [[#Network_Fix_for_pandian-minimal|Instructions]] || dhcp, network manager || [http://www.filedropper.com/pandian-mark2-minimal-networking2014-01-02tar filedropper: pandian-mark2-minimal-networking_2014-01-02.tar.gz] [http://pandian.openpandora.org/releases/pandian-mark2-minimal-networking_2014-01-02.tar.gz pandian.openpandora.org: pandian-mark2-minimal-networking_2014-01-02.tar.gz] ||pandian-mark2-minimal-networking_2014-01-02.'''tar.gz'''↓ 4cf802391360e5bf183e9d4b5fe8b6f407b3e476baec7b5b0aa7340796680ae6
|}

===== Network Fix for pandian-minimal =====
If you download the '''pandian-mark2-minimal-hf_2014-01-02''' image there is a lack of tools for setup wifi networking. 
'''Note: For the actual download of pandian-minimal, wifi-network-tools are included'''
* Therefore download the fix and place it on the SD-Card where pandian is installed. (you need to have local superuser privileges on your own system as the SD contents aren't owned by your user)
* Boot pandian-minimal
* login with user: "root"
* switch to root-directory: "cd /"
* untar the network-fix: "tar -xf /path-where-file-is-located/pandian-mark2-minimal-networking_2014-01-03.tar.gz"
* setup the fix with command "pdMinimalNetwork"

* after the script is finished, run "ceni" and setup your wifi-connection

=== 01 ===
'''Full debian GNU/Linux 7.2 codename Wheezy (stable) with LXDE desktop environment 
hardfloat armv7l released Date: 29.09.2013'''
[http://boards.openpandora.org/topic/14482-pandian-01/ forum link]
===Features===

* Hard-Float-ABI
* Ext4 Root for better performance
* Working Touch-Screen
* Working Nubs
* Screen-Off on LID-Close
* Low-Power-Mode
* WLAN
* Music ( with Sonata/MPD )
* Automount

=== Upcoming/Ideas ===

* Assistant for tzdata
* libpnd - PND-Support
* OpenGL not tested yet
* Aptitude
* Minimal-Network-Installation
* Pandian-Debian-Repository for special packages ( libpnd, touch-screen-calibrator )
* of course, in-system-documentation ( Documentation on the pandora )

Download [http://www.share-online.biz/dl/TPMFFXTM2AU here]

[http://boards.openpandora.org/topic/14482-pandian-01 Forum thread]

=== Installation ===

note: It is assumed here, that the card-reader load the card as /dev/sdc.
Please check before which device is your SD-card !
This can be checked with gparted. Minimum requirement 2GB SD-card.

# Download Image ( as 7z )
# Verify md5-checksum: pandian-stable-hf_2013-09-29.001.7z '''2a85bbb40bbe7c6e8f92f058e150951a''' pandian-stable-hf_2013-09-29.001.img '''e62d101dc708de49af1ca7743e2df2bd'''
# Unzip with 7z ( in Linux with 7zr e <image.7z> )
# Copy image to SD-Card ( dd if=<image.img> of=/dev/sdx ) Don't specify "bs="

Username: ''Pandian'' 
Root password: ''Root'' (change after intsallation as per instructions below)

#Open a terminal
#Type "su"
#Type "passwd"
#Enter your new root password when prompted, and then again to confirm.
#Dont forget your password

=== Resize ===
Default installation is limited to 2GB, if you want to expand it, you can, provided you have installed it on a bigger SD-card and want to make use of the space.

* Size will be changed with parted
* parted /dev/sdx
* show size with "print free"

# (parted) print free # Model: USB Mass Storage Device (scsi)
# Disk /dev/sdc: 7965MB# Sector size (logical/physical): 512B/512B# Partition Table: msdos

{| class="wikitable"
|-
| Number || Start || End || Size || Type || File system || Flags
|-
| || 32,3kB || 1049kB || 1016kB || || Free Space ||
|-
| 1 || 1049kB || 53,5MB || 52,4MB || primary || fat32 ||
|-
| 2 || 53,5MB || 1933MB || 1879MB || primary || ext4 ||
|-
| || 1933MB || 7965MB || 6032MB || || Free Space ||
|}

we would like to resize the second partition to the nearly end ( -512MB for swap )
# (parted) resizepart # Partition number? 2 # Warning: Partition /dev/sdc2 is being used. Are you sure you want to continue?# Yes/No? YES # End? [1933MB]? 7453MB this is how the partitions looks like after

(parted) print free * Model: USB Mass Storage Device (scsi)* Disk /dev/sdc: 7965MB* Sector size (logical/physical): 512B/512B* Partition Table: msdos

{| class="wikitable"
|-
| Number || Start || End || Size || Type || File system || Flags
|-
| || 32,3kB || 1049kB || 1016kB || || Free Space ||
|-
| 1 || 1049kB || 53,5MB || 52,4MB || primary || fat32 ||
|-
| 2 || 53,5MB || '''7453'''MB || '''7400'''MB || primary || ext4 ||
|-
| || '''7453'''MB || 7965MB || '''512'''MB || || Free Space ||
|}

create Swap (optional)

(parted) mkpart primary linux-swap
Start? 7453MB
End? 7965MB

this is how the partitions looks like after

(parted) print free * Model: USB Mass Storage Device (scsi)* Disk /dev/sdc: 7965MB* Sector size (logical/physical): 512B/512B* Partition Table: msdos

{| class="wikitable"
|-
| Number || Start || End || Size || Type || File system || Flags
|-
| || 32,3kB || 1049kB || 1016kB || || Free Space ||
|-
| 1 || 1049kB || 53,5MB || 52,4MB || primary || fat32 ||
|-
| 2 || 53,5MB || 7453MB || 7400MB || primary || ext4 ||
|-
| || '''7453MB''' || '''7453MB''' || '''278kB''' || || '''Free Space'''||
|-
| || 7453MB || 7965MB || 512MB || '''primary''' || Free Space ||
|}
disregard the 4th entry, the new resized partition is the last one.

resize filesystem
*resize2fs /dev/sdc2

create swap

*mkswap /dev/sdc3

[[Category:Documentation]]
[[Category:Operating system]]
[[Category:Software]]

Pandian

2014-04-10T14:20:38Z

Stackshadow: /* (Optional) Update of Pandian system */ Add update of home directory

[[File:Post-3032-0-90501200-1380479048.png|thumbnail|Logo]]

'''Pandian is an debian-based armhf desktop and CLI distro for your Pandora.'''
Ideas, Bugs, or feature-requests? Report to:
https://www.evilbrain.de/review/index.php?project=4

=== Main Features ===
* The debian way.
* Access to all packages from Debian software repositories.
* Pandian hosts its own Debian repo http://pandian.openpandora.org with up to date scripts, all settings and extra programs.
* armhf-build, which means '''f'''loat operations are relegated to special '''h'''ardware rather than taxing the main cpu with them (as with softfloat)

== '''Pandian''' - '''MARK 2''' The newest release ==
Second version of Pandian 
'''Full Debian GNU/Linux based on sid branch with LXDE desktop environment (normal) or CLI (minimal-) build.''' 
'''hardfloat armv7l''' yule release '''Date: 29.12.2013'''
[http://boards.openpandora.org/topic/15302-pandian-mark2/ forum link]

=== '''Installation''' requirements===
* '''Pandora''' ;) All versions fine?
* '''SD card''' minimum 2GB ( was tested with 4GB )
* '''PC''' Linux|GNU, BSD, Mac, or Windows for putting the install on the aforementioned SD-card.

==== '''Download''' a version of Pandian ====
There are two different versions of the "MARK2" release:
{| class="wikitable"
|-
! Version !! Description !! Includes !! Link !! Size !! Checksums (sha256)
|-
| '''base''' || pandian for advanced users, without any Desktop environment but with basic network-tools ( iw, ceni ) || ceni ( network-manager) network-manager MediaPlayer ( mpd ) iw (wireless-tools) || [http://www.filedropper.com/pandian-mark2-base-hf2014-01-05 filedropper: pandian-mark2-base-hf2014-01-05.7z] [http://pandian.openpandora.org/releases/pandian-mark2-base-hf_2014-01-05.7z pandian.openpandora.org: pandian-mark2-base-hf_2014-01-05.7z] || 161MB || pandian-mark2-base-hf_2014-01-05.'''7z'''↓ b11ffe9cc4fd6111775d0b48c133b1e1afcf6865de784b9865db0cea29674d85 pandian-mark2-base-hf_2014-01-05.'''img'''↓ c1903423a5b5e0d04563f14526e8161fbe77a102e64d5d571bcf3b87870fa211
|-
| '''normal''' || pandian for regular users, with full Desktop environment (LXDE) || network-manager MediaPlayer ( mpd with gurlp ) nub-support calibrator-application medit Text editor. mpd audio player backend, glurp as frontend || [http://www.filedropper.com/pandian-mark2-hf2014-01-02 filedropper: pandian-mark2-hf2014-01-02] [http://pandian.openpandora.org/releases/pandian-mark2-hf_2014-01-02.7z pandian.openpandora.org: pandian-mark2-hf_2014-01-02.7z] || 394MB || pandian-mark2-hf_2014-01-02.'''7z'''↓ 3731d70a4d8ec59e79a046f34f69c5c809be73e38cfc91a5b580478b8f8c222f pandian-mark2-hf_2014-01-02.'''img'''↓ 83b8d3fa5bd0588cfb8b11cfe6b827819e6311e98396a6e32c46c9692f072e96
|}
Notes:
* It is trivial to change from LXDE to [[Xfce]] (or any other desktop environment), adding a new user interface atop the minimal install is more advanced as manual setup of USB-Networking or wifi is needed to do so.
* All images have automount ( for USB-Sticks, external Hard-Drives etc. ) and ALSA sound support

==== '''Verify''' that your download is OK ====
* After you download the version you picked, verify its checksum to make sure the integrity of the downloaded file matches (in being an exact copy the one on the server)

#open up a terminal
# "'''sha256sum ~/downloads/pandian/<image.7Z>'''" (input where you have the file and the one you chose to download)
# make sure it matches the given md5sum, if not, try to download another copy. This step isnt mandatory, but its there to make sure everything is fine before we proceed.

==== '''Unzip''' the downloaded image ====
*Unzipping 7z archives
# Open up a terminal (or do it your way)
# Enter"'''7zr e <image.7z>'''"
# You now have an unzipped image

==== (Optional) '''Preparation''', find out where to install ====

This step helps you find out where the SD card is mounted. 

If you have an build in SD-Card-Reader this is normally /dev/mmcblk0p1 ( in Debian )
If you have an USB-Card-Reader this is something like /dev/sdc ( in Debian )
* Open an Terminal and input "'''lsblk'''"
* You will get a list with the actual Block-Devices
* The SD-Card should be of type 'disk'

You can also try gparted to see which devices you have and identify the SD-card from there

==== '''Install''' the image to the SD-Card ====
{{warning
| Warning, this will destroy everything on the device ! So please be very sure which device is you SD-Card !
}}
# Here it will be /dev/sd'''x'''

(note that the x after the sd is the drive letter, it could be ''sd'''b''''' sd'''c''''' or ''sd'''d''''' and so on, lets say its sd'''c'''. Which means c is the drive letter for the SD-card and that sd- a and -b are in use for other things. 
 
When writing to the device, make sure not to include the following number, which is the partition ''sdc'''1''''' ''sdc'''2''''' etc. since we are using the base card here) 
 
This means considerations for partitions and filesystem are taken care of, so no need to worry about that. Do ''not'' pick the wrong drive however, since dd will happily write the image to somewhere it isn't supposed to if you just give it root privileges and hit enter.) 
 
#Copy image to SD-Card with "'''dd if=<image.img> of=/dev/sdx'''"

You now have Pandian installed on your SD card and its ready to go. :) However after copying the image to the SD-Card resizing the partitionspartitions is needed to fully utilize the space, since by default the install is limited to 2GB. (If your card is bigger Pandian is still limited to those 2GB)

====(Optional) '''Resize''' SD-Card ====

* This can be done with gparted on linux|gnu
* start gparted

[[File:Gparted resize 001.png|800px|thumbnail|none|The actual partitions of the SD-CARD. Please select the correct device at the top right corner.]]
[[File:Gparted resize 002.png|800px|thumbnail|none|Rightclick to the second partition and select Resize/Move]]
[[File:Gparted resize 003.png|400px|thumbnail|none|You see the actual Size of this partition]]
[[File:Gparted resize 004.png|400px|thumbnail|none|Move the slider to the right, or set "Free space following" to 0]]
[[File:Gparted resize 005.png|800px|thumbnail|none|After you press the "Resize/Move" button, you get the preview of the new partition structure]]
[[File:Gparted resize 006.png|800px|thumbnail|none|When you press "Apply all operations", youve got a warning that you can loss your Data. THIS IS THE LAST CHANGE TO CHECK IF YOU SELECTED THE CORRECT DEVICE.

 Press Apply if everything is correct.]]

* After everything is fine, you have a fresh install of Pandian on you SD-Card
 

=== '''Startup''' wizard ===
* Upon first boot of Pandian, there is a first-start-wizard which guides you through some basic settings.
These are: Locale, timezone, time and date, password for admin and user setup and finally calibration of the touchscreen.
The script is located in /usr/sbin/pdSetup should you need to run it again.

==== Navigation ====
* Inside a dialog you can navigate with the cross/dpad
* Hit space to select a checkbox
* Moving between <Ok> and <Cancel> can be down with the use of TAB ( Tap Fn then tap Space )
* Acknowledge with Enter

*All done, enjoy :)

[[File:PandianDesktop.png|frameless]]

=== '''Network''' connection instructions:===

====normal ====
* Use network-manager

====minimal====
* Use ceni network manager

===(Optional) '''Update''' of Pandian system ===
* After you setup your Pandora, it is useful to update your system. It is a rolling release, which means since the image was made, the system is forever updated with new packages.
* open a terminal
* get root ( command is: "su" )
* enter "apt-get update" to download package information from the repositories
* enter "apt-get upgrade" to update all packages that are out of date
(pandian packages are also updated this way :)
* Note: to update only the pandian-packages enter "apt-get install pandian-full"

==== Up-To-Date Home directory ====
Normally files inside users home get overwritten ( if you say yes ) during upgrade.
Since an change of this behavior, files inside the users home don't get changed anymore by pandian packages.
Now settings of fluxbox and xinit/xinitrc are links. So The user can just unlink some of the settings and write there own, without getting overwritten from an upgrade.

To get up-to-date with the fixes in pandian, you can initialize the home directory to default state.
To do this, just run in an terminal ( as USER ):
* cp -a /etc/skel/. /home/<YourUserName>/

==== '''Upgrade Warnings''' ====
* if mpd is running, upgrade will fail. How to fix this:
** Open an terminal
** Login as root ( command "su" )
** Enter root password
** stop mpd with: /etc/init.d/mpd stop
** Kill it ( to be sure ): killall mpd
** upgrade again: apt-get dist-upgrade

==== Upgrade from "minimal" to "normal" ====
It is possible to upgrade from the "minimal"-image to the "normal"-image.
This can simlpy be done by installing the pandian-lxde debian package
* get an connection to the internet(tm) with ceni
* open an terminal
* get root ( with command: "su" )
* update package list with: "apt-get update"
* install pandian-lxde with "apt-get install pandian-lxde"
* after everything is finished login with the user you setup before
* open an terminal
* get root ( with command: "su" )
* load keymap with "xmodmap /etc/skel/.pndXmodmap"
* the easiest way is to activate the first-start-wizard with "insserv firstuse"
* reboot and go through the wizard

===(Optional) '''Information''' ===

=== Additional Users/Groups ===
There are additional Users/Groups added to the standard debian-users
==== Groups ====
* admin
:This superuser privilege is used by sudo for admin task like shutdown etc.
* mpd
:This user/group has access to mpd-related files ( socket, pid-files )

==== Power-Modes ====
===== LID-Close =====
* If the lid is closed only the screen will be disabled
===== Low-Power-Mode / Shutdown =====
[[File:Lead Photo For Power modes0-2920264867079787.jpg|thumbnail|right|Switch]]
* Switch to left: Pandora will go to low power mode ( reduce CPU, Disable LID, Pause processes )
* Switch to right: Shutdown the pandora

==== pdcmd ====
* This script handles all system-related stuff, like lid, low-power, usb or wifi.
* This should run as root
 
Usage:
{| class="wikitable"
|-
! Command !! What's done
|-
| /usr/sbin/pdcmd LCDBright + || Increase the light of the lid
|-
| /usr/sbin/pdcmd LCDBright - || Decrease the light of the lid
|-
| /usr/sbin/pdcmd LCDBright 10 || Set the Brightness of the lid to 10
|-
| /usr/sbin/pdcmd LCDTrigger || Trigger the lid ( WARNING: THIS DISABLES THE LID ! )
|-
| /usr/sbin/pdcmd USBNetTrigger || Enable the USB-Networking (module g_ether). If usbnetworking is on, it will disable it
|-
| /usr/sbin/pdcmd USBHostTrigger || Enable the USB-Host (module ehci-hcd). If USB-Host is on, it will disable it
|-
| /usr/sbin/pdcmd WLANTrigger || Enable Wifi. If Wifi is enabled it will be disabled
|}

==== Several tweaks ====

==== '''Fluxbox''' ====
Fluxbox is the actual Desktop Environment for pandian. It is simple fast and easy to configure.

===== custom menu =====
You can setup your own menu-entry's for fluxbox:
* open an terminal ( or an editor ) as root
* create a new file in ./fluxbox/menu-mymenu
( Note: the menu -filename must be named menu-* )
* run: "gen-menu-fluxbox <username>" as normal user, to generate the menu-file
* your new menu is ready for use

===== autostart =====
You can setup your own autostart script in ~/.fluxbox/startup-*
for example you can use: ~/.fluxbox/startup-mystart
Nothing else must be done, just logout and login to test it ( or reboot )
===== Fixing broken keyboard layout =====
If your Pandian has a German keyboard layout, you might have some trouble because it does absolutely not fit US layout on the Pandora.
There is a work around this isse.

*Make sure, the file .pndXmodmap is read in on startup. Open the file ''.xsessionrc'' in your ''home'' directory and, if not existent, add following lines at the bottom of the file
setxkbmap en_US
xmodmap /home/yourUsername/.pndXmodmap
*There must be the absolute path (no "~/").

===== Making the Pandora Button work like the Windows key =====
Many users complained, their Pandora Button has no function in Pandian. This can be changed by mapping the button as ''"mod4"''.

*Insert in the last line of the .pndXmodmap from your ''home'' directory:
add mod4 = XF86MenuKB

===== Openbox =====
Pandian comes with an unconfigured Openbox as a possible session. Here are some config templates.

====== Use the Pandora key to start the menu ======
*If not existent,
cp /etc/xdg/openbox/rc.xml /home/yourUserName/.config/openbox/
* Open the rc.xml with a text editor and search for the section <keyboard>.
* Insert the new keybind:
<keybind key="XF86MenuKB">
<action name="ShowMenu">
<menu>root-menu</menu>
</action>
</keybind>

===== Intuitive Openbox configuration template =====
Prerequisites:
*mapped 'Pandora key' as 'Windows key'(see above)
*optional: use tint2 as panel

Features:
*Changing window by '''[Ctrl] + [up]/[down]'''
*Changing workspace by '''[Ctrl] + [left]/[right]'''
*Closing window by '''[Ctrl] + [Q]'''
*Screenshot (window): '''[Ctrl] + [Shift] + [Alt] + [F11]'''
*Screenshot (whole desktop): '''[Ctrl] + [Shift] + [Alt] + [F12]'''
*and some more

'''Download:'''
[https://www.dropbox.com/s/ud0muusrxq9g9va/rc.xml rc.xml]

===== Intuitive Openbox menu template =====
Features:
*Most important programms in root menu
*menu entries for WLAN, USB host and low power mode
'''Download:'''
[https://www.dropbox.com/s/fqjxg5xoymg5fep/menu.xml menu.xml]

== Mounting internal NAND to /mnt ==

Pandora internal NAND exposes a raw flash interfaces. For such devices, the
Linux kernel exposes a special MTD abstraction and "mtd aware" filesystems may
give a better performance. Pandora uses UBIFS, which needs UBI volume
management to work.

# Install mtd-utils
# Run the following commands

<syntaxhighlight lang="bash">
# Attach mtd device 4 to UBI volume management 0
ubiattach -m 4 -d 0
# Mount first partition of the UBI group 0 to /mnt
mount -t ubifs /dev/ubi0_0 /mnt
# Attach mtd device 3 to UBI volume management 1
ubiattach -m 3 -d 1
# Mount first partition of the UBI group 1 to /mnt
mount -t ubifs /dev/ubi1_0 /mnt/boot
</syntaxhighlight>

== Old releases ==

=== Mark2 minimal-hf2014-01-02 ===

{| class="wikitable"
|-
! Version !! Description !! Included !! Link !! Checksums (sha256)
|-
| minimal || pandian without any Desktop environment but with the basic pandian package || nano || [http://www.filedropper.com/pandian-mark2-minimal-hf2014-01-02 filedropper: pandian-mark2-minimal-hf2014-01-02] [http://pandian.openpandora.org/releases/pandian-mark2-minimal-hf_2014-01-02.7z pandian.openpandora.org: pandian-mark2-minimal-hf_2014-01-02.7z] || pandian-mark2-minimal-hf_2014-01-02.'''7z'''↓ a35106473e54c55d64c7eae2088d8c267b605baf17d5338b8e2938dbfe3c01ca pandian-mark2-minimal-hf_2014-01-02.'''img'''↓ c68a42c1aef0238c1dd6ff33b628a2c0dea812a7b5b2d906afb185f93f940f84
|-
| minimal-networking fix|| HotFix for pandian-mark2-minimal-hf_2014-01-02 [[#Network_Fix_for_pandian-minimal|Instructions]] || dhcp, network manager || [http://www.filedropper.com/pandian-mark2-minimal-networking2014-01-02tar filedropper: pandian-mark2-minimal-networking_2014-01-02.tar.gz] [http://pandian.openpandora.org/releases/pandian-mark2-minimal-networking_2014-01-02.tar.gz pandian.openpandora.org: pandian-mark2-minimal-networking_2014-01-02.tar.gz] ||pandian-mark2-minimal-networking_2014-01-02.'''tar.gz'''↓ 4cf802391360e5bf183e9d4b5fe8b6f407b3e476baec7b5b0aa7340796680ae6
|}

===== Network Fix for pandian-minimal =====
If you download the '''pandian-mark2-minimal-hf_2014-01-02''' image there is a lack of tools for setup wifi networking. 
'''Note: For the actual download of pandian-minimal, wifi-network-tools are included'''
* Therefore download the fix and place it on the SD-Card where pandian is installed. (you need to have local superuser privileges on your own system as the SD contents aren't owned by your user)
* Boot pandian-minimal
* login with user: "root"
* switch to root-directory: "cd /"
* untar the network-fix: "tar -xf /path-where-file-is-located/pandian-mark2-minimal-networking_2014-01-03.tar.gz"
* setup the fix with command "pdMinimalNetwork"

* after the script is finished, run "ceni" and setup your wifi-connection

=== 01 ===
'''Full debian GNU/Linux 7.2 codename Wheezy (stable) with LXDE desktop environment 
hardfloat armv7l released Date: 29.09.2013'''
[http://boards.openpandora.org/topic/14482-pandian-01/ forum link]
===Features===

* Hard-Float-ABI
* Ext4 Root for better performance
* Working Touch-Screen
* Working Nubs
* Screen-Off on LID-Close
* Low-Power-Mode
* WLAN
* Music ( with Sonata/MPD )
* Automount

=== Upcoming/Ideas ===

* Assistant for tzdata
* libpnd - PND-Support
* OpenGL not tested yet
* Aptitude
* Minimal-Network-Installation
* Pandian-Debian-Repository for special packages ( libpnd, touch-screen-calibrator )
* of course, in-system-documentation ( Documentation on the pandora )

Download [http://www.share-online.biz/dl/TPMFFXTM2AU here]

[http://boards.openpandora.org/topic/14482-pandian-01 Forum thread]

=== Installation ===

note: It is assumed here, that the card-reader load the card as /dev/sdc.
Please check before which device is your SD-card !
This can be checked with gparted. Minimum requirement 2GB SD-card.

# Download Image ( as 7z )
# Verify md5-checksum: pandian-stable-hf_2013-09-29.001.7z '''2a85bbb40bbe7c6e8f92f058e150951a''' pandian-stable-hf_2013-09-29.001.img '''e62d101dc708de49af1ca7743e2df2bd'''
# Unzip with 7z ( in Linux with 7zr e <image.7z> )
# Copy image to SD-Card ( dd if=<image.img> of=/dev/sdx ) Don't specify "bs="

Username: ''Pandian'' 
Root password: ''Root'' (change after intsallation as per instructions below)

#Open a terminal
#Type "su"
#Type "passwd"
#Enter your new root password when prompted, and then again to confirm.
#Dont forget your password

=== Resize ===
Default installation is limited to 2GB, if you want to expand it, you can, provided you have installed it on a bigger SD-card and want to make use of the space.

* Size will be changed with parted
* parted /dev/sdx
* show size with "print free"

# (parted) print free # Model: USB Mass Storage Device (scsi)
# Disk /dev/sdc: 7965MB# Sector size (logical/physical): 512B/512B# Partition Table: msdos

{| class="wikitable"
|-
| Number || Start || End || Size || Type || File system || Flags
|-
| || 32,3kB || 1049kB || 1016kB || || Free Space ||
|-
| 1 || 1049kB || 53,5MB || 52,4MB || primary || fat32 ||
|-
| 2 || 53,5MB || 1933MB || 1879MB || primary || ext4 ||
|-
| || 1933MB || 7965MB || 6032MB || || Free Space ||
|}

we would like to resize the second partition to the nearly end ( -512MB for swap )
# (parted) resizepart # Partition number? 2 # Warning: Partition /dev/sdc2 is being used. Are you sure you want to continue?# Yes/No? YES # End? [1933MB]? 7453MB this is how the partitions looks like after

(parted) print free * Model: USB Mass Storage Device (scsi)* Disk /dev/sdc: 7965MB* Sector size (logical/physical): 512B/512B* Partition Table: msdos

{| class="wikitable"
|-
| Number || Start || End || Size || Type || File system || Flags
|-
| || 32,3kB || 1049kB || 1016kB || || Free Space ||
|-
| 1 || 1049kB || 53,5MB || 52,4MB || primary || fat32 ||
|-
| 2 || 53,5MB || '''7453'''MB || '''7400'''MB || primary || ext4 ||
|-
| || '''7453'''MB || 7965MB || '''512'''MB || || Free Space ||
|}

create Swap (optional)

(parted) mkpart primary linux-swap
Start? 7453MB
End? 7965MB

this is how the partitions looks like after

(parted) print free * Model: USB Mass Storage Device (scsi)* Disk /dev/sdc: 7965MB* Sector size (logical/physical): 512B/512B* Partition Table: msdos

{| class="wikitable"
|-
| Number || Start || End || Size || Type || File system || Flags
|-
| || 32,3kB || 1049kB || 1016kB || || Free Space ||
|-
| 1 || 1049kB || 53,5MB || 52,4MB || primary || fat32 ||
|-
| 2 || 53,5MB || 7453MB || 7400MB || primary || ext4 ||
|-
| || '''7453MB''' || '''7453MB''' || '''278kB''' || || '''Free Space'''||
|-
| || 7453MB || 7965MB || 512MB || '''primary''' || Free Space ||
|}
disregard the 4th entry, the new resized partition is the last one.

resize filesystem
*resize2fs /dev/sdc2

create swap

*mkswap /dev/sdc3

[[Category:Documentation]]
[[Category:Operating system]]
[[Category:Software]]

Pandian

2014-04-10T14:08:28Z

Stackshadow: /* Several tweaks */

[[File:Post-3032-0-90501200-1380479048.png|thumbnail|Logo]]

'''Pandian is an debian-based armhf desktop and CLI distro for your Pandora.'''
Ideas, Bugs, or feature-requests? Report to:
https://www.evilbrain.de/review/index.php?project=4

=== Main Features ===
* The debian way.
* Access to all packages from Debian software repositories.
* Pandian hosts its own Debian repo http://pandian.openpandora.org with up to date scripts, all settings and extra programs.
* armhf-build, which means '''f'''loat operations are relegated to special '''h'''ardware rather than taxing the main cpu with them (as with softfloat)

== '''Pandian''' - '''MARK 2''' The newest release ==
Second version of Pandian 
'''Full Debian GNU/Linux based on sid branch with LXDE desktop environment (normal) or CLI (minimal-) build.''' 
'''hardfloat armv7l''' yule release '''Date: 29.12.2013'''
[http://boards.openpandora.org/topic/15302-pandian-mark2/ forum link]

=== '''Installation''' requirements===
* '''Pandora''' ;) All versions fine?
* '''SD card''' minimum 2GB ( was tested with 4GB )
* '''PC''' Linux|GNU, BSD, Mac, or Windows for putting the install on the aforementioned SD-card.

==== '''Download''' a version of Pandian ====
There are two different versions of the "MARK2" release:
{| class="wikitable"
|-
! Version !! Description !! Includes !! Link !! Size !! Checksums (sha256)
|-
| '''base''' || pandian for advanced users, without any Desktop environment but with basic network-tools ( iw, ceni ) || ceni ( network-manager) network-manager MediaPlayer ( mpd ) iw (wireless-tools) || [http://www.filedropper.com/pandian-mark2-base-hf2014-01-05 filedropper: pandian-mark2-base-hf2014-01-05.7z] [http://pandian.openpandora.org/releases/pandian-mark2-base-hf_2014-01-05.7z pandian.openpandora.org: pandian-mark2-base-hf_2014-01-05.7z] || 161MB || pandian-mark2-base-hf_2014-01-05.'''7z'''↓ b11ffe9cc4fd6111775d0b48c133b1e1afcf6865de784b9865db0cea29674d85 pandian-mark2-base-hf_2014-01-05.'''img'''↓ c1903423a5b5e0d04563f14526e8161fbe77a102e64d5d571bcf3b87870fa211
|-
| '''normal''' || pandian for regular users, with full Desktop environment (LXDE) || network-manager MediaPlayer ( mpd with gurlp ) nub-support calibrator-application medit Text editor. mpd audio player backend, glurp as frontend || [http://www.filedropper.com/pandian-mark2-hf2014-01-02 filedropper: pandian-mark2-hf2014-01-02] [http://pandian.openpandora.org/releases/pandian-mark2-hf_2014-01-02.7z pandian.openpandora.org: pandian-mark2-hf_2014-01-02.7z] || 394MB || pandian-mark2-hf_2014-01-02.'''7z'''↓ 3731d70a4d8ec59e79a046f34f69c5c809be73e38cfc91a5b580478b8f8c222f pandian-mark2-hf_2014-01-02.'''img'''↓ 83b8d3fa5bd0588cfb8b11cfe6b827819e6311e98396a6e32c46c9692f072e96
|}
Notes:
* It is trivial to change from LXDE to [[Xfce]] (or any other desktop environment), adding a new user interface atop the minimal install is more advanced as manual setup of USB-Networking or wifi is needed to do so.
* All images have automount ( for USB-Sticks, external Hard-Drives etc. ) and ALSA sound support

==== '''Verify''' that your download is OK ====
* After you download the version you picked, verify its checksum to make sure the integrity of the downloaded file matches (in being an exact copy the one on the server)

#open up a terminal
# "'''sha256sum ~/downloads/pandian/<image.7Z>'''" (input where you have the file and the one you chose to download)
# make sure it matches the given md5sum, if not, try to download another copy. This step isnt mandatory, but its there to make sure everything is fine before we proceed.

==== '''Unzip''' the downloaded image ====
*Unzipping 7z archives
# Open up a terminal (or do it your way)
# Enter"'''7zr e <image.7z>'''"
# You now have an unzipped image

==== (Optional) '''Preparation''', find out where to install ====

This step helps you find out where the SD card is mounted. 

If you have an build in SD-Card-Reader this is normally /dev/mmcblk0p1 ( in Debian )
If you have an USB-Card-Reader this is something like /dev/sdc ( in Debian )
* Open an Terminal and input "'''lsblk'''"
* You will get a list with the actual Block-Devices
* The SD-Card should be of type 'disk'

You can also try gparted to see which devices you have and identify the SD-card from there

==== '''Install''' the image to the SD-Card ====
{{warning
| Warning, this will destroy everything on the device ! So please be very sure which device is you SD-Card !
}}
# Here it will be /dev/sd'''x'''

(note that the x after the sd is the drive letter, it could be ''sd'''b''''' sd'''c''''' or ''sd'''d''''' and so on, lets say its sd'''c'''. Which means c is the drive letter for the SD-card and that sd- a and -b are in use for other things. 
 
When writing to the device, make sure not to include the following number, which is the partition ''sdc'''1''''' ''sdc'''2''''' etc. since we are using the base card here) 
 
This means considerations for partitions and filesystem are taken care of, so no need to worry about that. Do ''not'' pick the wrong drive however, since dd will happily write the image to somewhere it isn't supposed to if you just give it root privileges and hit enter.) 
 
#Copy image to SD-Card with "'''dd if=<image.img> of=/dev/sdx'''"

You now have Pandian installed on your SD card and its ready to go. :) However after copying the image to the SD-Card resizing the partitionspartitions is needed to fully utilize the space, since by default the install is limited to 2GB. (If your card is bigger Pandian is still limited to those 2GB)

====(Optional) '''Resize''' SD-Card ====

* This can be done with gparted on linux|gnu
* start gparted

[[File:Gparted resize 001.png|800px|thumbnail|none|The actual partitions of the SD-CARD. Please select the correct device at the top right corner.]]
[[File:Gparted resize 002.png|800px|thumbnail|none|Rightclick to the second partition and select Resize/Move]]
[[File:Gparted resize 003.png|400px|thumbnail|none|You see the actual Size of this partition]]
[[File:Gparted resize 004.png|400px|thumbnail|none|Move the slider to the right, or set "Free space following" to 0]]
[[File:Gparted resize 005.png|800px|thumbnail|none|After you press the "Resize/Move" button, you get the preview of the new partition structure]]
[[File:Gparted resize 006.png|800px|thumbnail|none|When you press "Apply all operations", youve got a warning that you can loss your Data. THIS IS THE LAST CHANGE TO CHECK IF YOU SELECTED THE CORRECT DEVICE.

 Press Apply if everything is correct.]]

* After everything is fine, you have a fresh install of Pandian on you SD-Card
 

=== '''Startup''' wizard ===
* Upon first boot of Pandian, there is a first-start-wizard which guides you through some basic settings.
These are: Locale, timezone, time and date, password for admin and user setup and finally calibration of the touchscreen.
The script is located in /usr/sbin/pdSetup should you need to run it again.

==== Navigation ====
* Inside a dialog you can navigate with the cross/dpad
* Hit space to select a checkbox
* Moving between <Ok> and <Cancel> can be down with the use of TAB ( Tap Fn then tap Space )
* Acknowledge with Enter

*All done, enjoy :)

[[File:PandianDesktop.png|frameless]]

=== '''Network''' connection instructions:===

====normal ====
* Use network-manager

====minimal====
* Use ceni network manager

===(Optional) '''Update''' of Pandian system ===
* After you setup your Pandora, it is useful to update your system. It is a rolling release, which means since the image was made, the system is forever updated with new packages.
* open a terminal
* get root ( command is: "su" )
* enter "apt-get update" to download package information from the repositories
* enter "apt-get upgrade" to update all packages that are out of date
(pandian packages are also updated this way :)
* Note: to update only the pandian-packages enter "apt-get install pandian-full"

==== '''Upgrade Warnings''' ====
* if mpd is running, upgrade will fail. How to fix this:
** Open an terminal
** Login as root ( command "su" )
** Enter root password
** stop mpd with: /etc/init.d/mpd stop
** Kill it ( to be sure ): killall mpd
** upgrade again: apt-get dist-upgrade

==== Upgrade from "minimal" to "normal" ====
It is possible to upgrade from the "minimal"-image to the "normal"-image.
This can simlpy be done by installing the pandian-lxde debian package
* get an connection to the internet(tm) with ceni
* open an terminal
* get root ( with command: "su" )
* update package list with: "apt-get update"
* install pandian-lxde with "apt-get install pandian-lxde"
* after everything is finished login with the user you setup before
* open an terminal
* get root ( with command: "su" )
* load keymap with "xmodmap /etc/skel/.pndXmodmap"
* the easiest way is to activate the first-start-wizard with "insserv firstuse"
* reboot and go through the wizard

===(Optional) '''Information''' ===

=== Additional Users/Groups ===
There are additional Users/Groups added to the standard debian-users
==== Groups ====
* admin
:This superuser privilege is used by sudo for admin task like shutdown etc.
* mpd
:This user/group has access to mpd-related files ( socket, pid-files )

==== Power-Modes ====
===== LID-Close =====
* If the lid is closed only the screen will be disabled
===== Low-Power-Mode / Shutdown =====
[[File:Lead Photo For Power modes0-2920264867079787.jpg|thumbnail|right|Switch]]
* Switch to left: Pandora will go to low power mode ( reduce CPU, Disable LID, Pause processes )
* Switch to right: Shutdown the pandora

==== pdcmd ====
* This script handles all system-related stuff, like lid, low-power, usb or wifi.
* This should run as root
 
Usage:
{| class="wikitable"
|-
! Command !! What's done
|-
| /usr/sbin/pdcmd LCDBright + || Increase the light of the lid
|-
| /usr/sbin/pdcmd LCDBright - || Decrease the light of the lid
|-
| /usr/sbin/pdcmd LCDBright 10 || Set the Brightness of the lid to 10
|-
| /usr/sbin/pdcmd LCDTrigger || Trigger the lid ( WARNING: THIS DISABLES THE LID ! )
|-
| /usr/sbin/pdcmd USBNetTrigger || Enable the USB-Networking (module g_ether). If usbnetworking is on, it will disable it
|-
| /usr/sbin/pdcmd USBHostTrigger || Enable the USB-Host (module ehci-hcd). If USB-Host is on, it will disable it
|-
| /usr/sbin/pdcmd WLANTrigger || Enable Wifi. If Wifi is enabled it will be disabled
|}

==== Several tweaks ====

==== '''Fluxbox''' ====
Fluxbox is the actual Desktop Environment for pandian. It is simple fast and easy to configure.

===== custom menu =====
You can setup your own menu-entry's for fluxbox:
* open an terminal ( or an editor ) as root
* create a new file in ./fluxbox/menu-mymenu
( Note: the menu -filename must be named menu-* )
* run: "gen-menu-fluxbox <username>" as normal user, to generate the menu-file
* your new menu is ready for use

===== autostart =====
You can setup your own autostart script in ~/.fluxbox/startup-*
for example you can use: ~/.fluxbox/startup-mystart
Nothing else must be done, just logout and login to test it ( or reboot )
===== Fixing broken keyboard layout =====
If your Pandian has a German keyboard layout, you might have some trouble because it does absolutely not fit US layout on the Pandora.
There is a work around this isse.

*Make sure, the file .pndXmodmap is read in on startup. Open the file ''.xsessionrc'' in your ''home'' directory and, if not existent, add following lines at the bottom of the file
setxkbmap en_US
xmodmap /home/yourUsername/.pndXmodmap
*There must be the absolute path (no "~/").

===== Making the Pandora Button work like the Windows key =====
Many users complained, their Pandora Button has no function in Pandian. This can be changed by mapping the button as ''"mod4"''.

*Insert in the last line of the .pndXmodmap from your ''home'' directory:
add mod4 = XF86MenuKB

===== Openbox =====
Pandian comes with an unconfigured Openbox as a possible session. Here are some config templates.

====== Use the Pandora key to start the menu ======
*If not existent,
cp /etc/xdg/openbox/rc.xml /home/yourUserName/.config/openbox/
* Open the rc.xml with a text editor and search for the section <keyboard>.
* Insert the new keybind:
<keybind key="XF86MenuKB">
<action name="ShowMenu">
<menu>root-menu</menu>
</action>
</keybind>

===== Intuitive Openbox configuration template =====
Prerequisites:
*mapped 'Pandora key' as 'Windows key'(see above)
*optional: use tint2 as panel

Features:
*Changing window by '''[Ctrl] + [up]/[down]'''
*Changing workspace by '''[Ctrl] + [left]/[right]'''
*Closing window by '''[Ctrl] + [Q]'''
*Screenshot (window): '''[Ctrl] + [Shift] + [Alt] + [F11]'''
*Screenshot (whole desktop): '''[Ctrl] + [Shift] + [Alt] + [F12]'''
*and some more

'''Download:'''
[https://www.dropbox.com/s/ud0muusrxq9g9va/rc.xml rc.xml]

===== Intuitive Openbox menu template =====
Features:
*Most important programms in root menu
*menu entries for WLAN, USB host and low power mode
'''Download:'''
[https://www.dropbox.com/s/fqjxg5xoymg5fep/menu.xml menu.xml]

== Mounting internal NAND to /mnt ==

Pandora internal NAND exposes a raw flash interfaces. For such devices, the
Linux kernel exposes a special MTD abstraction and "mtd aware" filesystems may
give a better performance. Pandora uses UBIFS, which needs UBI volume
management to work.

# Install mtd-utils
# Run the following commands

<syntaxhighlight lang="bash">
# Attach mtd device 4 to UBI volume management 0
ubiattach -m 4 -d 0
# Mount first partition of the UBI group 0 to /mnt
mount -t ubifs /dev/ubi0_0 /mnt
# Attach mtd device 3 to UBI volume management 1
ubiattach -m 3 -d 1
# Mount first partition of the UBI group 1 to /mnt
mount -t ubifs /dev/ubi1_0 /mnt/boot
</syntaxhighlight>

== Old releases ==

=== Mark2 minimal-hf2014-01-02 ===

{| class="wikitable"
|-
! Version !! Description !! Included !! Link !! Checksums (sha256)
|-
| minimal || pandian without any Desktop environment but with the basic pandian package || nano || [http://www.filedropper.com/pandian-mark2-minimal-hf2014-01-02 filedropper: pandian-mark2-minimal-hf2014-01-02] [http://pandian.openpandora.org/releases/pandian-mark2-minimal-hf_2014-01-02.7z pandian.openpandora.org: pandian-mark2-minimal-hf_2014-01-02.7z] || pandian-mark2-minimal-hf_2014-01-02.'''7z'''↓ a35106473e54c55d64c7eae2088d8c267b605baf17d5338b8e2938dbfe3c01ca pandian-mark2-minimal-hf_2014-01-02.'''img'''↓ c68a42c1aef0238c1dd6ff33b628a2c0dea812a7b5b2d906afb185f93f940f84
|-
| minimal-networking fix|| HotFix for pandian-mark2-minimal-hf_2014-01-02 [[#Network_Fix_for_pandian-minimal|Instructions]] || dhcp, network manager || [http://www.filedropper.com/pandian-mark2-minimal-networking2014-01-02tar filedropper: pandian-mark2-minimal-networking_2014-01-02.tar.gz] [http://pandian.openpandora.org/releases/pandian-mark2-minimal-networking_2014-01-02.tar.gz pandian.openpandora.org: pandian-mark2-minimal-networking_2014-01-02.tar.gz] ||pandian-mark2-minimal-networking_2014-01-02.'''tar.gz'''↓ 4cf802391360e5bf183e9d4b5fe8b6f407b3e476baec7b5b0aa7340796680ae6
|}

===== Network Fix for pandian-minimal =====
If you download the '''pandian-mark2-minimal-hf_2014-01-02''' image there is a lack of tools for setup wifi networking. 
'''Note: For the actual download of pandian-minimal, wifi-network-tools are included'''
* Therefore download the fix and place it on the SD-Card where pandian is installed. (you need to have local superuser privileges on your own system as the SD contents aren't owned by your user)
* Boot pandian-minimal
* login with user: "root"
* switch to root-directory: "cd /"
* untar the network-fix: "tar -xf /path-where-file-is-located/pandian-mark2-minimal-networking_2014-01-03.tar.gz"
* setup the fix with command "pdMinimalNetwork"

* after the script is finished, run "ceni" and setup your wifi-connection

=== 01 ===
'''Full debian GNU/Linux 7.2 codename Wheezy (stable) with LXDE desktop environment 
hardfloat armv7l released Date: 29.09.2013'''
[http://boards.openpandora.org/topic/14482-pandian-01/ forum link]
===Features===

* Hard-Float-ABI
* Ext4 Root for better performance
* Working Touch-Screen
* Working Nubs
* Screen-Off on LID-Close
* Low-Power-Mode
* WLAN
* Music ( with Sonata/MPD )
* Automount

=== Upcoming/Ideas ===

* Assistant for tzdata
* libpnd - PND-Support
* OpenGL not tested yet
* Aptitude
* Minimal-Network-Installation
* Pandian-Debian-Repository for special packages ( libpnd, touch-screen-calibrator )
* of course, in-system-documentation ( Documentation on the pandora )

Download [http://www.share-online.biz/dl/TPMFFXTM2AU here]

[http://boards.openpandora.org/topic/14482-pandian-01 Forum thread]

=== Installation ===

note: It is assumed here, that the card-reader load the card as /dev/sdc.
Please check before which device is your SD-card !
This can be checked with gparted. Minimum requirement 2GB SD-card.

# Download Image ( as 7z )
# Verify md5-checksum: pandian-stable-hf_2013-09-29.001.7z '''2a85bbb40bbe7c6e8f92f058e150951a''' pandian-stable-hf_2013-09-29.001.img '''e62d101dc708de49af1ca7743e2df2bd'''
# Unzip with 7z ( in Linux with 7zr e <image.7z> )
# Copy image to SD-Card ( dd if=<image.img> of=/dev/sdx ) Don't specify "bs="

Username: ''Pandian'' 
Root password: ''Root'' (change after intsallation as per instructions below)

#Open a terminal
#Type "su"
#Type "passwd"
#Enter your new root password when prompted, and then again to confirm.
#Dont forget your password

=== Resize ===
Default installation is limited to 2GB, if you want to expand it, you can, provided you have installed it on a bigger SD-card and want to make use of the space.

* Size will be changed with parted
* parted /dev/sdx
* show size with "print free"

# (parted) print free # Model: USB Mass Storage Device (scsi)
# Disk /dev/sdc: 7965MB# Sector size (logical/physical): 512B/512B# Partition Table: msdos

{| class="wikitable"
|-
| Number || Start || End || Size || Type || File system || Flags
|-
| || 32,3kB || 1049kB || 1016kB || || Free Space ||
|-
| 1 || 1049kB || 53,5MB || 52,4MB || primary || fat32 ||
|-
| 2 || 53,5MB || 1933MB || 1879MB || primary || ext4 ||
|-
| || 1933MB || 7965MB || 6032MB || || Free Space ||
|}

we would like to resize the second partition to the nearly end ( -512MB for swap )
# (parted) resizepart # Partition number? 2 # Warning: Partition /dev/sdc2 is being used. Are you sure you want to continue?# Yes/No? YES # End? [1933MB]? 7453MB this is how the partitions looks like after

(parted) print free * Model: USB Mass Storage Device (scsi)* Disk /dev/sdc: 7965MB* Sector size (logical/physical): 512B/512B* Partition Table: msdos

{| class="wikitable"
|-
| Number || Start || End || Size || Type || File system || Flags
|-
| || 32,3kB || 1049kB || 1016kB || || Free Space ||
|-
| 1 || 1049kB || 53,5MB || 52,4MB || primary || fat32 ||
|-
| 2 || 53,5MB || '''7453'''MB || '''7400'''MB || primary || ext4 ||
|-
| || '''7453'''MB || 7965MB || '''512'''MB || || Free Space ||
|}

create Swap (optional)

(parted) mkpart primary linux-swap
Start? 7453MB
End? 7965MB

this is how the partitions looks like after

(parted) print free * Model: USB Mass Storage Device (scsi)* Disk /dev/sdc: 7965MB* Sector size (logical/physical): 512B/512B* Partition Table: msdos

{| class="wikitable"
|-
| Number || Start || End || Size || Type || File system || Flags
|-
| || 32,3kB || 1049kB || 1016kB || || Free Space ||
|-
| 1 || 1049kB || 53,5MB || 52,4MB || primary || fat32 ||
|-
| 2 || 53,5MB || 7453MB || 7400MB || primary || ext4 ||
|-
| || '''7453MB''' || '''7453MB''' || '''278kB''' || || '''Free Space'''||
|-
| || 7453MB || 7965MB || 512MB || '''primary''' || Free Space ||
|}
disregard the 4th entry, the new resized partition is the last one.

resize filesystem
*resize2fs /dev/sdc2

create swap

*mkswap /dev/sdc3

[[Category:Documentation]]
[[Category:Operating system]]
[[Category:Software]]

Pandian

2014-04-10T14:07:38Z

Stackshadow: /* Fluxbox tweaks */

[[File:Post-3032-0-90501200-1380479048.png|thumbnail|Logo]]

'''Pandian is an debian-based armhf desktop and CLI distro for your Pandora.'''
Ideas, Bugs, or feature-requests? Report to:
https://www.evilbrain.de/review/index.php?project=4

=== Main Features ===
* The debian way.
* Access to all packages from Debian software repositories.
* Pandian hosts its own Debian repo http://pandian.openpandora.org with up to date scripts, all settings and extra programs.
* armhf-build, which means '''f'''loat operations are relegated to special '''h'''ardware rather than taxing the main cpu with them (as with softfloat)

== '''Pandian''' - '''MARK 2''' The newest release ==
Second version of Pandian 
'''Full Debian GNU/Linux based on sid branch with LXDE desktop environment (normal) or CLI (minimal-) build.''' 
'''hardfloat armv7l''' yule release '''Date: 29.12.2013'''
[http://boards.openpandora.org/topic/15302-pandian-mark2/ forum link]

=== '''Installation''' requirements===
* '''Pandora''' ;) All versions fine?
* '''SD card''' minimum 2GB ( was tested with 4GB )
* '''PC''' Linux|GNU, BSD, Mac, or Windows for putting the install on the aforementioned SD-card.

==== '''Download''' a version of Pandian ====
There are two different versions of the "MARK2" release:
{| class="wikitable"
|-
! Version !! Description !! Includes !! Link !! Size !! Checksums (sha256)
|-
| '''base''' || pandian for advanced users, without any Desktop environment but with basic network-tools ( iw, ceni ) || ceni ( network-manager) network-manager MediaPlayer ( mpd ) iw (wireless-tools) || [http://www.filedropper.com/pandian-mark2-base-hf2014-01-05 filedropper: pandian-mark2-base-hf2014-01-05.7z] [http://pandian.openpandora.org/releases/pandian-mark2-base-hf_2014-01-05.7z pandian.openpandora.org: pandian-mark2-base-hf_2014-01-05.7z] || 161MB || pandian-mark2-base-hf_2014-01-05.'''7z'''↓ b11ffe9cc4fd6111775d0b48c133b1e1afcf6865de784b9865db0cea29674d85 pandian-mark2-base-hf_2014-01-05.'''img'''↓ c1903423a5b5e0d04563f14526e8161fbe77a102e64d5d571bcf3b87870fa211
|-
| '''normal''' || pandian for regular users, with full Desktop environment (LXDE) || network-manager MediaPlayer ( mpd with gurlp ) nub-support calibrator-application medit Text editor. mpd audio player backend, glurp as frontend || [http://www.filedropper.com/pandian-mark2-hf2014-01-02 filedropper: pandian-mark2-hf2014-01-02] [http://pandian.openpandora.org/releases/pandian-mark2-hf_2014-01-02.7z pandian.openpandora.org: pandian-mark2-hf_2014-01-02.7z] || 394MB || pandian-mark2-hf_2014-01-02.'''7z'''↓ 3731d70a4d8ec59e79a046f34f69c5c809be73e38cfc91a5b580478b8f8c222f pandian-mark2-hf_2014-01-02.'''img'''↓ 83b8d3fa5bd0588cfb8b11cfe6b827819e6311e98396a6e32c46c9692f072e96
|}
Notes:
* It is trivial to change from LXDE to [[Xfce]] (or any other desktop environment), adding a new user interface atop the minimal install is more advanced as manual setup of USB-Networking or wifi is needed to do so.
* All images have automount ( for USB-Sticks, external Hard-Drives etc. ) and ALSA sound support

==== '''Verify''' that your download is OK ====
* After you download the version you picked, verify its checksum to make sure the integrity of the downloaded file matches (in being an exact copy the one on the server)

#open up a terminal
# "'''sha256sum ~/downloads/pandian/<image.7Z>'''" (input where you have the file and the one you chose to download)
# make sure it matches the given md5sum, if not, try to download another copy. This step isnt mandatory, but its there to make sure everything is fine before we proceed.

==== '''Unzip''' the downloaded image ====
*Unzipping 7z archives
# Open up a terminal (or do it your way)
# Enter"'''7zr e <image.7z>'''"
# You now have an unzipped image

==== (Optional) '''Preparation''', find out where to install ====

This step helps you find out where the SD card is mounted. 

If you have an build in SD-Card-Reader this is normally /dev/mmcblk0p1 ( in Debian )
If you have an USB-Card-Reader this is something like /dev/sdc ( in Debian )
* Open an Terminal and input "'''lsblk'''"
* You will get a list with the actual Block-Devices
* The SD-Card should be of type 'disk'

You can also try gparted to see which devices you have and identify the SD-card from there

==== '''Install''' the image to the SD-Card ====
{{warning
| Warning, this will destroy everything on the device ! So please be very sure which device is you SD-Card !
}}
# Here it will be /dev/sd'''x'''

(note that the x after the sd is the drive letter, it could be ''sd'''b''''' sd'''c''''' or ''sd'''d''''' and so on, lets say its sd'''c'''. Which means c is the drive letter for the SD-card and that sd- a and -b are in use for other things. 
 
When writing to the device, make sure not to include the following number, which is the partition ''sdc'''1''''' ''sdc'''2''''' etc. since we are using the base card here) 
 
This means considerations for partitions and filesystem are taken care of, so no need to worry about that. Do ''not'' pick the wrong drive however, since dd will happily write the image to somewhere it isn't supposed to if you just give it root privileges and hit enter.) 
 
#Copy image to SD-Card with "'''dd if=<image.img> of=/dev/sdx'''"

You now have Pandian installed on your SD card and its ready to go. :) However after copying the image to the SD-Card resizing the partitionspartitions is needed to fully utilize the space, since by default the install is limited to 2GB. (If your card is bigger Pandian is still limited to those 2GB)

====(Optional) '''Resize''' SD-Card ====

* This can be done with gparted on linux|gnu
* start gparted

[[File:Gparted resize 001.png|800px|thumbnail|none|The actual partitions of the SD-CARD. Please select the correct device at the top right corner.]]
[[File:Gparted resize 002.png|800px|thumbnail|none|Rightclick to the second partition and select Resize/Move]]
[[File:Gparted resize 003.png|400px|thumbnail|none|You see the actual Size of this partition]]
[[File:Gparted resize 004.png|400px|thumbnail|none|Move the slider to the right, or set "Free space following" to 0]]
[[File:Gparted resize 005.png|800px|thumbnail|none|After you press the "Resize/Move" button, you get the preview of the new partition structure]]
[[File:Gparted resize 006.png|800px|thumbnail|none|When you press "Apply all operations", youve got a warning that you can loss your Data. THIS IS THE LAST CHANGE TO CHECK IF YOU SELECTED THE CORRECT DEVICE.

 Press Apply if everything is correct.]]

* After everything is fine, you have a fresh install of Pandian on you SD-Card
 

=== '''Startup''' wizard ===
* Upon first boot of Pandian, there is a first-start-wizard which guides you through some basic settings.
These are: Locale, timezone, time and date, password for admin and user setup and finally calibration of the touchscreen.
The script is located in /usr/sbin/pdSetup should you need to run it again.

==== Navigation ====
* Inside a dialog you can navigate with the cross/dpad
* Hit space to select a checkbox
* Moving between <Ok> and <Cancel> can be down with the use of TAB ( Tap Fn then tap Space )
* Acknowledge with Enter

*All done, enjoy :)

[[File:PandianDesktop.png|frameless]]

=== '''Network''' connection instructions:===

====normal ====
* Use network-manager

====minimal====
* Use ceni network manager

===(Optional) '''Update''' of Pandian system ===
* After you setup your Pandora, it is useful to update your system. It is a rolling release, which means since the image was made, the system is forever updated with new packages.
* open a terminal
* get root ( command is: "su" )
* enter "apt-get update" to download package information from the repositories
* enter "apt-get upgrade" to update all packages that are out of date
(pandian packages are also updated this way :)
* Note: to update only the pandian-packages enter "apt-get install pandian-full"

==== '''Upgrade Warnings''' ====
* if mpd is running, upgrade will fail. How to fix this:
** Open an terminal
** Login as root ( command "su" )
** Enter root password
** stop mpd with: /etc/init.d/mpd stop
** Kill it ( to be sure ): killall mpd
** upgrade again: apt-get dist-upgrade

==== Upgrade from "minimal" to "normal" ====
It is possible to upgrade from the "minimal"-image to the "normal"-image.
This can simlpy be done by installing the pandian-lxde debian package
* get an connection to the internet(tm) with ceni
* open an terminal
* get root ( with command: "su" )
* update package list with: "apt-get update"
* install pandian-lxde with "apt-get install pandian-lxde"
* after everything is finished login with the user you setup before
* open an terminal
* get root ( with command: "su" )
* load keymap with "xmodmap /etc/skel/.pndXmodmap"
* the easiest way is to activate the first-start-wizard with "insserv firstuse"
* reboot and go through the wizard

===(Optional) '''Information''' ===

=== Additional Users/Groups ===
There are additional Users/Groups added to the standard debian-users
==== Groups ====
* admin
:This superuser privilege is used by sudo for admin task like shutdown etc.
* mpd
:This user/group has access to mpd-related files ( socket, pid-files )

==== Power-Modes ====
===== LID-Close =====
* If the lid is closed only the screen will be disabled
===== Low-Power-Mode / Shutdown =====
[[File:Lead Photo For Power modes0-2920264867079787.jpg|thumbnail|right|Switch]]
* Switch to left: Pandora will go to low power mode ( reduce CPU, Disable LID, Pause processes )
* Switch to right: Shutdown the pandora

==== pdcmd ====
* This script handles all system-related stuff, like lid, low-power, usb or wifi.
* This should run as root
 
Usage:
{| class="wikitable"
|-
! Command !! What's done
|-
| /usr/sbin/pdcmd LCDBright + || Increase the light of the lid
|-
| /usr/sbin/pdcmd LCDBright - || Decrease the light of the lid
|-
| /usr/sbin/pdcmd LCDBright 10 || Set the Brightness of the lid to 10
|-
| /usr/sbin/pdcmd LCDTrigger || Trigger the lid ( WARNING: THIS DISABLES THE LID ! )
|-
| /usr/sbin/pdcmd USBNetTrigger || Enable the USB-Networking (module g_ether). If usbnetworking is on, it will disable it
|-
| /usr/sbin/pdcmd USBHostTrigger || Enable the USB-Host (module ehci-hcd). If USB-Host is on, it will disable it
|-
| /usr/sbin/pdcmd WLANTrigger || Enable Wifi. If Wifi is enabled it will be disabled
|}

==== Several tweaks ====
===== Fixing broken keyboard layout =====
If your Pandian has a German keyboard layout, you might have some trouble because it does absolutely not fit US layout on the Pandora.
There is a work around this isse.

*Make sure, the file .pndXmodmap is read in on startup. Open the file ''.xsessionrc'' in your ''home'' directory and, if not existent, add following lines at the bottom of the file
setxkbmap en_US
xmodmap /home/yourUsername/.pndXmodmap
*There must be the absolute path (no "~/").

===== Making the Pandora Button work like the Windows key =====
Many users complained, their Pandora Button has no function in Pandian. This can be changed by mapping the button as ''"mod4"''.

*Insert in the last line of the .pndXmodmap from your ''home'' directory:
add mod4 = XF86MenuKB

===== Openbox =====
Pandian comes with an unconfigured Openbox as a possible session. Here are some config templates.

====== Use the Pandora key to start the menu ======
*If not existent,
cp /etc/xdg/openbox/rc.xml /home/yourUserName/.config/openbox/
* Open the rc.xml with a text editor and search for the section <keyboard>.
* Insert the new keybind:
<keybind key="XF86MenuKB">
<action name="ShowMenu">
<menu>root-menu</menu>
</action>
</keybind>

===== Intuitive Openbox configuration template =====
Prerequisites:
*mapped 'Pandora key' as 'Windows key'(see above)
*optional: use tint2 as panel

Features:
*Changing window by '''[Ctrl] + [up]/[down]'''
*Changing workspace by '''[Ctrl] + [left]/[right]'''
*Closing window by '''[Ctrl] + [Q]'''
*Screenshot (window): '''[Ctrl] + [Shift] + [Alt] + [F11]'''
*Screenshot (whole desktop): '''[Ctrl] + [Shift] + [Alt] + [F12]'''
*and some more

'''Download:'''
[https://www.dropbox.com/s/ud0muusrxq9g9va/rc.xml rc.xml]

===== Intuitive Openbox menu template =====
Features:
*Most important programms in root menu
*menu entries for WLAN, USB host and low power mode
'''Download:'''
[https://www.dropbox.com/s/fqjxg5xoymg5fep/menu.xml menu.xml]

== Mounting internal NAND to /mnt ==

Pandora internal NAND exposes a raw flash interfaces. For such devices, the
Linux kernel exposes a special MTD abstraction and "mtd aware" filesystems may
give a better performance. Pandora uses UBIFS, which needs UBI volume
management to work.

# Install mtd-utils
# Run the following commands

<syntaxhighlight lang="bash">
# Attach mtd device 4 to UBI volume management 0
ubiattach -m 4 -d 0
# Mount first partition of the UBI group 0 to /mnt
mount -t ubifs /dev/ubi0_0 /mnt
# Attach mtd device 3 to UBI volume management 1
ubiattach -m 3 -d 1
# Mount first partition of the UBI group 1 to /mnt
mount -t ubifs /dev/ubi1_0 /mnt/boot
</syntaxhighlight>

== Old releases ==

=== Mark2 minimal-hf2014-01-02 ===

{| class="wikitable"
|-
! Version !! Description !! Included !! Link !! Checksums (sha256)
|-
| minimal || pandian without any Desktop environment but with the basic pandian package || nano || [http://www.filedropper.com/pandian-mark2-minimal-hf2014-01-02 filedropper: pandian-mark2-minimal-hf2014-01-02] [http://pandian.openpandora.org/releases/pandian-mark2-minimal-hf_2014-01-02.7z pandian.openpandora.org: pandian-mark2-minimal-hf_2014-01-02.7z] || pandian-mark2-minimal-hf_2014-01-02.'''7z'''↓ a35106473e54c55d64c7eae2088d8c267b605baf17d5338b8e2938dbfe3c01ca pandian-mark2-minimal-hf_2014-01-02.'''img'''↓ c68a42c1aef0238c1dd6ff33b628a2c0dea812a7b5b2d906afb185f93f940f84
|-
| minimal-networking fix|| HotFix for pandian-mark2-minimal-hf_2014-01-02 [[#Network_Fix_for_pandian-minimal|Instructions]] || dhcp, network manager || [http://www.filedropper.com/pandian-mark2-minimal-networking2014-01-02tar filedropper: pandian-mark2-minimal-networking_2014-01-02.tar.gz] [http://pandian.openpandora.org/releases/pandian-mark2-minimal-networking_2014-01-02.tar.gz pandian.openpandora.org: pandian-mark2-minimal-networking_2014-01-02.tar.gz] ||pandian-mark2-minimal-networking_2014-01-02.'''tar.gz'''↓ 4cf802391360e5bf183e9d4b5fe8b6f407b3e476baec7b5b0aa7340796680ae6
|}

===== Network Fix for pandian-minimal =====
If you download the '''pandian-mark2-minimal-hf_2014-01-02''' image there is a lack of tools for setup wifi networking. 
'''Note: For the actual download of pandian-minimal, wifi-network-tools are included'''
* Therefore download the fix and place it on the SD-Card where pandian is installed. (you need to have local superuser privileges on your own system as the SD contents aren't owned by your user)
* Boot pandian-minimal
* login with user: "root"
* switch to root-directory: "cd /"
* untar the network-fix: "tar -xf /path-where-file-is-located/pandian-mark2-minimal-networking_2014-01-03.tar.gz"
* setup the fix with command "pdMinimalNetwork"

* after the script is finished, run "ceni" and setup your wifi-connection

=== 01 ===
'''Full debian GNU/Linux 7.2 codename Wheezy (stable) with LXDE desktop environment 
hardfloat armv7l released Date: 29.09.2013'''
[http://boards.openpandora.org/topic/14482-pandian-01/ forum link]
===Features===

* Hard-Float-ABI
* Ext4 Root for better performance
* Working Touch-Screen
* Working Nubs
* Screen-Off on LID-Close
* Low-Power-Mode
* WLAN
* Music ( with Sonata/MPD )
* Automount

=== Upcoming/Ideas ===

* Assistant for tzdata
* libpnd - PND-Support
* OpenGL not tested yet
* Aptitude
* Minimal-Network-Installation
* Pandian-Debian-Repository for special packages ( libpnd, touch-screen-calibrator )
* of course, in-system-documentation ( Documentation on the pandora )

Download [http://www.share-online.biz/dl/TPMFFXTM2AU here]

[http://boards.openpandora.org/topic/14482-pandian-01 Forum thread]

=== Installation ===

note: It is assumed here, that the card-reader load the card as /dev/sdc.
Please check before which device is your SD-card !
This can be checked with gparted. Minimum requirement 2GB SD-card.

# Download Image ( as 7z )
# Verify md5-checksum: pandian-stable-hf_2013-09-29.001.7z '''2a85bbb40bbe7c6e8f92f058e150951a''' pandian-stable-hf_2013-09-29.001.img '''e62d101dc708de49af1ca7743e2df2bd'''
# Unzip with 7z ( in Linux with 7zr e <image.7z> )
# Copy image to SD-Card ( dd if=<image.img> of=/dev/sdx ) Don't specify "bs="

Username: ''Pandian'' 
Root password: ''Root'' (change after intsallation as per instructions below)

#Open a terminal
#Type "su"
#Type "passwd"
#Enter your new root password when prompted, and then again to confirm.
#Dont forget your password

=== Resize ===
Default installation is limited to 2GB, if you want to expand it, you can, provided you have installed it on a bigger SD-card and want to make use of the space.

* Size will be changed with parted
* parted /dev/sdx
* show size with "print free"

# (parted) print free # Model: USB Mass Storage Device (scsi)
# Disk /dev/sdc: 7965MB# Sector size (logical/physical): 512B/512B# Partition Table: msdos

{| class="wikitable"
|-
| Number || Start || End || Size || Type || File system || Flags
|-
| || 32,3kB || 1049kB || 1016kB || || Free Space ||
|-
| 1 || 1049kB || 53,5MB || 52,4MB || primary || fat32 ||
|-
| 2 || 53,5MB || 1933MB || 1879MB || primary || ext4 ||
|-
| || 1933MB || 7965MB || 6032MB || || Free Space ||
|}

we would like to resize the second partition to the nearly end ( -512MB for swap )
# (parted) resizepart # Partition number? 2 # Warning: Partition /dev/sdc2 is being used. Are you sure you want to continue?# Yes/No? YES # End? [1933MB]? 7453MB this is how the partitions looks like after

(parted) print free * Model: USB Mass Storage Device (scsi)* Disk /dev/sdc: 7965MB* Sector size (logical/physical): 512B/512B* Partition Table: msdos

{| class="wikitable"
|-
| Number || Start || End || Size || Type || File system || Flags
|-
| || 32,3kB || 1049kB || 1016kB || || Free Space ||
|-
| 1 || 1049kB || 53,5MB || 52,4MB || primary || fat32 ||
|-
| 2 || 53,5MB || '''7453'''MB || '''7400'''MB || primary || ext4 ||
|-
| || '''7453'''MB || 7965MB || '''512'''MB || || Free Space ||
|}

create Swap (optional)

(parted) mkpart primary linux-swap
Start? 7453MB
End? 7965MB

this is how the partitions looks like after

(parted) print free * Model: USB Mass Storage Device (scsi)* Disk /dev/sdc: 7965MB* Sector size (logical/physical): 512B/512B* Partition Table: msdos

{| class="wikitable"
|-
| Number || Start || End || Size || Type || File system || Flags
|-
| || 32,3kB || 1049kB || 1016kB || || Free Space ||
|-
| 1 || 1049kB || 53,5MB || 52,4MB || primary || fat32 ||
|-
| 2 || 53,5MB || 7453MB || 7400MB || primary || ext4 ||
|-
| || '''7453MB''' || '''7453MB''' || '''278kB''' || || '''Free Space'''||
|-
| || 7453MB || 7965MB || 512MB || '''primary''' || Free Space ||
|}
disregard the 4th entry, the new resized partition is the last one.

resize filesystem
*resize2fs /dev/sdc2

create swap

*mkswap /dev/sdc3

[[Category:Documentation]]
[[Category:Operating system]]
[[Category:Software]]

Pandian

2014-04-10T14:05:44Z

Stackshadow: Update information for update pandian only

[[File:Post-3032-0-90501200-1380479048.png|thumbnail|Logo]]

'''Pandian is an debian-based armhf desktop and CLI distro for your Pandora.'''
Ideas, Bugs, or feature-requests? Report to:
https://www.evilbrain.de/review/index.php?project=4

=== Main Features ===
* The debian way.
* Access to all packages from Debian software repositories.
* Pandian hosts its own Debian repo http://pandian.openpandora.org with up to date scripts, all settings and extra programs.
* armhf-build, which means '''f'''loat operations are relegated to special '''h'''ardware rather than taxing the main cpu with them (as with softfloat)

== '''Pandian''' - '''MARK 2''' The newest release ==
Second version of Pandian 
'''Full Debian GNU/Linux based on sid branch with LXDE desktop environment (normal) or CLI (minimal-) build.''' 
'''hardfloat armv7l''' yule release '''Date: 29.12.2013'''
[http://boards.openpandora.org/topic/15302-pandian-mark2/ forum link]

=== '''Installation''' requirements===
* '''Pandora''' ;) All versions fine?
* '''SD card''' minimum 2GB ( was tested with 4GB )
* '''PC''' Linux|GNU, BSD, Mac, or Windows for putting the install on the aforementioned SD-card.

==== '''Download''' a version of Pandian ====
There are two different versions of the "MARK2" release:
{| class="wikitable"
|-
! Version !! Description !! Includes !! Link !! Size !! Checksums (sha256)
|-
| '''base''' || pandian for advanced users, without any Desktop environment but with basic network-tools ( iw, ceni ) || ceni ( network-manager) network-manager MediaPlayer ( mpd ) iw (wireless-tools) || [http://www.filedropper.com/pandian-mark2-base-hf2014-01-05 filedropper: pandian-mark2-base-hf2014-01-05.7z] [http://pandian.openpandora.org/releases/pandian-mark2-base-hf_2014-01-05.7z pandian.openpandora.org: pandian-mark2-base-hf_2014-01-05.7z] || 161MB || pandian-mark2-base-hf_2014-01-05.'''7z'''↓ b11ffe9cc4fd6111775d0b48c133b1e1afcf6865de784b9865db0cea29674d85 pandian-mark2-base-hf_2014-01-05.'''img'''↓ c1903423a5b5e0d04563f14526e8161fbe77a102e64d5d571bcf3b87870fa211
|-
| '''normal''' || pandian for regular users, with full Desktop environment (LXDE) || network-manager MediaPlayer ( mpd with gurlp ) nub-support calibrator-application medit Text editor. mpd audio player backend, glurp as frontend || [http://www.filedropper.com/pandian-mark2-hf2014-01-02 filedropper: pandian-mark2-hf2014-01-02] [http://pandian.openpandora.org/releases/pandian-mark2-hf_2014-01-02.7z pandian.openpandora.org: pandian-mark2-hf_2014-01-02.7z] || 394MB || pandian-mark2-hf_2014-01-02.'''7z'''↓ 3731d70a4d8ec59e79a046f34f69c5c809be73e38cfc91a5b580478b8f8c222f pandian-mark2-hf_2014-01-02.'''img'''↓ 83b8d3fa5bd0588cfb8b11cfe6b827819e6311e98396a6e32c46c9692f072e96
|}
Notes:
* It is trivial to change from LXDE to [[Xfce]] (or any other desktop environment), adding a new user interface atop the minimal install is more advanced as manual setup of USB-Networking or wifi is needed to do so.
* All images have automount ( for USB-Sticks, external Hard-Drives etc. ) and ALSA sound support

==== '''Verify''' that your download is OK ====
* After you download the version you picked, verify its checksum to make sure the integrity of the downloaded file matches (in being an exact copy the one on the server)

#open up a terminal
# "'''sha256sum ~/downloads/pandian/<image.7Z>'''" (input where you have the file and the one you chose to download)
# make sure it matches the given md5sum, if not, try to download another copy. This step isnt mandatory, but its there to make sure everything is fine before we proceed.

==== '''Unzip''' the downloaded image ====
*Unzipping 7z archives
# Open up a terminal (or do it your way)
# Enter"'''7zr e <image.7z>'''"
# You now have an unzipped image

==== (Optional) '''Preparation''', find out where to install ====

This step helps you find out where the SD card is mounted. 

If you have an build in SD-Card-Reader this is normally /dev/mmcblk0p1 ( in Debian )
If you have an USB-Card-Reader this is something like /dev/sdc ( in Debian )
* Open an Terminal and input "'''lsblk'''"
* You will get a list with the actual Block-Devices
* The SD-Card should be of type 'disk'

You can also try gparted to see which devices you have and identify the SD-card from there

==== '''Install''' the image to the SD-Card ====
{{warning
| Warning, this will destroy everything on the device ! So please be very sure which device is you SD-Card !
}}
# Here it will be /dev/sd'''x'''

(note that the x after the sd is the drive letter, it could be ''sd'''b''''' sd'''c''''' or ''sd'''d''''' and so on, lets say its sd'''c'''. Which means c is the drive letter for the SD-card and that sd- a and -b are in use for other things. 
 
When writing to the device, make sure not to include the following number, which is the partition ''sdc'''1''''' ''sdc'''2''''' etc. since we are using the base card here) 
 
This means considerations for partitions and filesystem are taken care of, so no need to worry about that. Do ''not'' pick the wrong drive however, since dd will happily write the image to somewhere it isn't supposed to if you just give it root privileges and hit enter.) 
 
#Copy image to SD-Card with "'''dd if=<image.img> of=/dev/sdx'''"

You now have Pandian installed on your SD card and its ready to go. :) However after copying the image to the SD-Card resizing the partitionspartitions is needed to fully utilize the space, since by default the install is limited to 2GB. (If your card is bigger Pandian is still limited to those 2GB)

====(Optional) '''Resize''' SD-Card ====

* This can be done with gparted on linux|gnu
* start gparted

[[File:Gparted resize 001.png|800px|thumbnail|none|The actual partitions of the SD-CARD. Please select the correct device at the top right corner.]]
[[File:Gparted resize 002.png|800px|thumbnail|none|Rightclick to the second partition and select Resize/Move]]
[[File:Gparted resize 003.png|400px|thumbnail|none|You see the actual Size of this partition]]
[[File:Gparted resize 004.png|400px|thumbnail|none|Move the slider to the right, or set "Free space following" to 0]]
[[File:Gparted resize 005.png|800px|thumbnail|none|After you press the "Resize/Move" button, you get the preview of the new partition structure]]
[[File:Gparted resize 006.png|800px|thumbnail|none|When you press "Apply all operations", youve got a warning that you can loss your Data. THIS IS THE LAST CHANGE TO CHECK IF YOU SELECTED THE CORRECT DEVICE.

 Press Apply if everything is correct.]]

* After everything is fine, you have a fresh install of Pandian on you SD-Card
 

=== '''Startup''' wizard ===
* Upon first boot of Pandian, there is a first-start-wizard which guides you through some basic settings.
These are: Locale, timezone, time and date, password for admin and user setup and finally calibration of the touchscreen.
The script is located in /usr/sbin/pdSetup should you need to run it again.

==== Navigation ====
* Inside a dialog you can navigate with the cross/dpad
* Hit space to select a checkbox
* Moving between <Ok> and <Cancel> can be down with the use of TAB ( Tap Fn then tap Space )
* Acknowledge with Enter

*All done, enjoy :)

[[File:PandianDesktop.png|frameless]]

=== '''Network''' connection instructions:===

====normal ====
* Use network-manager

====minimal====
* Use ceni network manager

=== '''Fluxbox''' tweaks ===
Fluxbox is the actual Desktop Environment for pandian. It is simple fast and easy to configure.

==== custom menu ====
You can setup your own menu-entry's for fluxbox:
* open an terminal ( or an editor ) as root
* create a new file in ./fluxbox/menu-mymenu
( Note: the menu -filename must be named menu-* )
* run: "gen-menu-fluxbox <username>" as normal user, to generate the menu-file
* your new menu is ready for use

==== autostart ====
You can setup your own autostart script in ~/.fluxbox/startup-*
for example you can use: ~/.fluxbox/startup-mystart
Nothing else must be done, just logout and login to test it ( or reboot )

===(Optional) '''Update''' of Pandian system ===
* After you setup your Pandora, it is useful to update your system. It is a rolling release, which means since the image was made, the system is forever updated with new packages.
* open a terminal
* get root ( command is: "su" )
* enter "apt-get update" to download package information from the repositories
* enter "apt-get upgrade" to update all packages that are out of date
(pandian packages are also updated this way :)
* Note: to update only the pandian-packages enter "apt-get install pandian-full"

==== '''Upgrade Warnings''' ====
* if mpd is running, upgrade will fail. How to fix this:
** Open an terminal
** Login as root ( command "su" )
** Enter root password
** stop mpd with: /etc/init.d/mpd stop
** Kill it ( to be sure ): killall mpd
** upgrade again: apt-get dist-upgrade

==== Upgrade from "minimal" to "normal" ====
It is possible to upgrade from the "minimal"-image to the "normal"-image.
This can simlpy be done by installing the pandian-lxde debian package
* get an connection to the internet(tm) with ceni
* open an terminal
* get root ( with command: "su" )
* update package list with: "apt-get update"
* install pandian-lxde with "apt-get install pandian-lxde"
* after everything is finished login with the user you setup before
* open an terminal
* get root ( with command: "su" )
* load keymap with "xmodmap /etc/skel/.pndXmodmap"
* the easiest way is to activate the first-start-wizard with "insserv firstuse"
* reboot and go through the wizard

===(Optional) '''Information''' ===

=== Additional Users/Groups ===
There are additional Users/Groups added to the standard debian-users
==== Groups ====
* admin
:This superuser privilege is used by sudo for admin task like shutdown etc.
* mpd
:This user/group has access to mpd-related files ( socket, pid-files )

==== Power-Modes ====
===== LID-Close =====
* If the lid is closed only the screen will be disabled
===== Low-Power-Mode / Shutdown =====
[[File:Lead Photo For Power modes0-2920264867079787.jpg|thumbnail|right|Switch]]
* Switch to left: Pandora will go to low power mode ( reduce CPU, Disable LID, Pause processes )
* Switch to right: Shutdown the pandora

==== pdcmd ====
* This script handles all system-related stuff, like lid, low-power, usb or wifi.
* This should run as root
 
Usage:
{| class="wikitable"
|-
! Command !! What's done
|-
| /usr/sbin/pdcmd LCDBright + || Increase the light of the lid
|-
| /usr/sbin/pdcmd LCDBright - || Decrease the light of the lid
|-
| /usr/sbin/pdcmd LCDBright 10 || Set the Brightness of the lid to 10
|-
| /usr/sbin/pdcmd LCDTrigger || Trigger the lid ( WARNING: THIS DISABLES THE LID ! )
|-
| /usr/sbin/pdcmd USBNetTrigger || Enable the USB-Networking (module g_ether). If usbnetworking is on, it will disable it
|-
| /usr/sbin/pdcmd USBHostTrigger || Enable the USB-Host (module ehci-hcd). If USB-Host is on, it will disable it
|-
| /usr/sbin/pdcmd WLANTrigger || Enable Wifi. If Wifi is enabled it will be disabled
|}

==== Several tweaks ====
===== Fixing broken keyboard layout =====
If your Pandian has a German keyboard layout, you might have some trouble because it does absolutely not fit US layout on the Pandora.
There is a work around this isse.

*Make sure, the file .pndXmodmap is read in on startup. Open the file ''.xsessionrc'' in your ''home'' directory and, if not existent, add following lines at the bottom of the file
setxkbmap en_US
xmodmap /home/yourUsername/.pndXmodmap
*There must be the absolute path (no "~/").

===== Making the Pandora Button work like the Windows key =====
Many users complained, their Pandora Button has no function in Pandian. This can be changed by mapping the button as ''"mod4"''.

*Insert in the last line of the .pndXmodmap from your ''home'' directory:
add mod4 = XF86MenuKB

===== Openbox =====
Pandian comes with an unconfigured Openbox as a possible session. Here are some config templates.

====== Use the Pandora key to start the menu ======
*If not existent,
cp /etc/xdg/openbox/rc.xml /home/yourUserName/.config/openbox/
* Open the rc.xml with a text editor and search for the section <keyboard>.
* Insert the new keybind:
<keybind key="XF86MenuKB">
<action name="ShowMenu">
<menu>root-menu</menu>
</action>
</keybind>

===== Intuitive Openbox configuration template =====
Prerequisites:
*mapped 'Pandora key' as 'Windows key'(see above)
*optional: use tint2 as panel

Features:
*Changing window by '''[Ctrl] + [up]/[down]'''
*Changing workspace by '''[Ctrl] + [left]/[right]'''
*Closing window by '''[Ctrl] + [Q]'''
*Screenshot (window): '''[Ctrl] + [Shift] + [Alt] + [F11]'''
*Screenshot (whole desktop): '''[Ctrl] + [Shift] + [Alt] + [F12]'''
*and some more

'''Download:'''
[https://www.dropbox.com/s/ud0muusrxq9g9va/rc.xml rc.xml]

===== Intuitive Openbox menu template =====
Features:
*Most important programms in root menu
*menu entries for WLAN, USB host and low power mode
'''Download:'''
[https://www.dropbox.com/s/fqjxg5xoymg5fep/menu.xml menu.xml]

== Mounting internal NAND to /mnt ==

Pandora internal NAND exposes a raw flash interfaces. For such devices, the
Linux kernel exposes a special MTD abstraction and "mtd aware" filesystems may
give a better performance. Pandora uses UBIFS, which needs UBI volume
management to work.

# Install mtd-utils
# Run the following commands

<syntaxhighlight lang="bash">
# Attach mtd device 4 to UBI volume management 0
ubiattach -m 4 -d 0
# Mount first partition of the UBI group 0 to /mnt
mount -t ubifs /dev/ubi0_0 /mnt
# Attach mtd device 3 to UBI volume management 1
ubiattach -m 3 -d 1
# Mount first partition of the UBI group 1 to /mnt
mount -t ubifs /dev/ubi1_0 /mnt/boot
</syntaxhighlight>

== Old releases ==

=== Mark2 minimal-hf2014-01-02 ===

{| class="wikitable"
|-
! Version !! Description !! Included !! Link !! Checksums (sha256)
|-
| minimal || pandian without any Desktop environment but with the basic pandian package || nano || [http://www.filedropper.com/pandian-mark2-minimal-hf2014-01-02 filedropper: pandian-mark2-minimal-hf2014-01-02] [http://pandian.openpandora.org/releases/pandian-mark2-minimal-hf_2014-01-02.7z pandian.openpandora.org: pandian-mark2-minimal-hf_2014-01-02.7z] || pandian-mark2-minimal-hf_2014-01-02.'''7z'''↓ a35106473e54c55d64c7eae2088d8c267b605baf17d5338b8e2938dbfe3c01ca pandian-mark2-minimal-hf_2014-01-02.'''img'''↓ c68a42c1aef0238c1dd6ff33b628a2c0dea812a7b5b2d906afb185f93f940f84
|-
| minimal-networking fix|| HotFix for pandian-mark2-minimal-hf_2014-01-02 [[#Network_Fix_for_pandian-minimal|Instructions]] || dhcp, network manager || [http://www.filedropper.com/pandian-mark2-minimal-networking2014-01-02tar filedropper: pandian-mark2-minimal-networking_2014-01-02.tar.gz] [http://pandian.openpandora.org/releases/pandian-mark2-minimal-networking_2014-01-02.tar.gz pandian.openpandora.org: pandian-mark2-minimal-networking_2014-01-02.tar.gz] ||pandian-mark2-minimal-networking_2014-01-02.'''tar.gz'''↓ 4cf802391360e5bf183e9d4b5fe8b6f407b3e476baec7b5b0aa7340796680ae6
|}

===== Network Fix for pandian-minimal =====
If you download the '''pandian-mark2-minimal-hf_2014-01-02''' image there is a lack of tools for setup wifi networking. 
'''Note: For the actual download of pandian-minimal, wifi-network-tools are included'''
* Therefore download the fix and place it on the SD-Card where pandian is installed. (you need to have local superuser privileges on your own system as the SD contents aren't owned by your user)
* Boot pandian-minimal
* login with user: "root"
* switch to root-directory: "cd /"
* untar the network-fix: "tar -xf /path-where-file-is-located/pandian-mark2-minimal-networking_2014-01-03.tar.gz"
* setup the fix with command "pdMinimalNetwork"

* after the script is finished, run "ceni" and setup your wifi-connection

=== 01 ===
'''Full debian GNU/Linux 7.2 codename Wheezy (stable) with LXDE desktop environment 
hardfloat armv7l released Date: 29.09.2013'''
[http://boards.openpandora.org/topic/14482-pandian-01/ forum link]
===Features===

* Hard-Float-ABI
* Ext4 Root for better performance
* Working Touch-Screen
* Working Nubs
* Screen-Off on LID-Close
* Low-Power-Mode
* WLAN
* Music ( with Sonata/MPD )
* Automount

=== Upcoming/Ideas ===

* Assistant for tzdata
* libpnd - PND-Support
* OpenGL not tested yet
* Aptitude
* Minimal-Network-Installation
* Pandian-Debian-Repository for special packages ( libpnd, touch-screen-calibrator )
* of course, in-system-documentation ( Documentation on the pandora )

Download [http://www.share-online.biz/dl/TPMFFXTM2AU here]

[http://boards.openpandora.org/topic/14482-pandian-01 Forum thread]

=== Installation ===

note: It is assumed here, that the card-reader load the card as /dev/sdc.
Please check before which device is your SD-card !
This can be checked with gparted. Minimum requirement 2GB SD-card.

# Download Image ( as 7z )
# Verify md5-checksum: pandian-stable-hf_2013-09-29.001.7z '''2a85bbb40bbe7c6e8f92f058e150951a''' pandian-stable-hf_2013-09-29.001.img '''e62d101dc708de49af1ca7743e2df2bd'''
# Unzip with 7z ( in Linux with 7zr e <image.7z> )
# Copy image to SD-Card ( dd if=<image.img> of=/dev/sdx ) Don't specify "bs="

Username: ''Pandian'' 
Root password: ''Root'' (change after intsallation as per instructions below)

#Open a terminal
#Type "su"
#Type "passwd"
#Enter your new root password when prompted, and then again to confirm.
#Dont forget your password

=== Resize ===
Default installation is limited to 2GB, if you want to expand it, you can, provided you have installed it on a bigger SD-card and want to make use of the space.

* Size will be changed with parted
* parted /dev/sdx
* show size with "print free"

# (parted) print free # Model: USB Mass Storage Device (scsi)
# Disk /dev/sdc: 7965MB# Sector size (logical/physical): 512B/512B# Partition Table: msdos

{| class="wikitable"
|-
| Number || Start || End || Size || Type || File system || Flags
|-
| || 32,3kB || 1049kB || 1016kB || || Free Space ||
|-
| 1 || 1049kB || 53,5MB || 52,4MB || primary || fat32 ||
|-
| 2 || 53,5MB || 1933MB || 1879MB || primary || ext4 ||
|-
| || 1933MB || 7965MB || 6032MB || || Free Space ||
|}

we would like to resize the second partition to the nearly end ( -512MB for swap )
# (parted) resizepart # Partition number? 2 # Warning: Partition /dev/sdc2 is being used. Are you sure you want to continue?# Yes/No? YES # End? [1933MB]? 7453MB this is how the partitions looks like after

(parted) print free * Model: USB Mass Storage Device (scsi)* Disk /dev/sdc: 7965MB* Sector size (logical/physical): 512B/512B* Partition Table: msdos

{| class="wikitable"
|-
| Number || Start || End || Size || Type || File system || Flags
|-
| || 32,3kB || 1049kB || 1016kB || || Free Space ||
|-
| 1 || 1049kB || 53,5MB || 52,4MB || primary || fat32 ||
|-
| 2 || 53,5MB || '''7453'''MB || '''7400'''MB || primary || ext4 ||
|-
| || '''7453'''MB || 7965MB || '''512'''MB || || Free Space ||
|}

create Swap (optional)

(parted) mkpart primary linux-swap
Start? 7453MB
End? 7965MB

this is how the partitions looks like after

(parted) print free * Model: USB Mass Storage Device (scsi)* Disk /dev/sdc: 7965MB* Sector size (logical/physical): 512B/512B* Partition Table: msdos

{| class="wikitable"
|-
| Number || Start || End || Size || Type || File system || Flags
|-
| || 32,3kB || 1049kB || 1016kB || || Free Space ||
|-
| 1 || 1049kB || 53,5MB || 52,4MB || primary || fat32 ||
|-
| 2 || 53,5MB || 7453MB || 7400MB || primary || ext4 ||
|-
| || '''7453MB''' || '''7453MB''' || '''278kB''' || || '''Free Space'''||
|-
| || 7453MB || 7965MB || 512MB || '''primary''' || Free Space ||
|}
disregard the 4th entry, the new resized partition is the last one.

resize filesystem
*resize2fs /dev/sdc2

create swap

*mkswap /dev/sdc3

[[Category:Documentation]]
[[Category:Operating system]]
[[Category:Software]]

Pandian

2014-03-31T17:29:47Z

Stackshadow: added Fluxbox twaks

[[File:Post-3032-0-90501200-1380479048.png|thumbnail|Logo]]

'''Pandian is an debian-based armhf desktop and CLI distro for your Pandora.'''
Ideas, Bugs, or feature-requests? Report to:
https://www.evilbrain.de/review/index.php?project=4

=== Main Features ===
* The debian way.
* Access to all packages from Debian software repositories.
* Pandian hosts its own Debian repo http://pandian.openpandora.org with up to date scripts, all settings and extra programs.
* armhf-build, which means '''f'''loat operations are relegated to special '''h'''ardware rather than taxing the main cpu with them (as with softfloat)

== '''Pandian''' - '''MARK 2''' The newest release ==
Second version of Pandian 
'''Full Debian GNU/Linux based on sid branch with LXDE desktop environment (normal) or CLI (minimal-) build.''' 
'''hardfloat armv7l''' yule release '''Date: 29.12.2013'''
[http://boards.openpandora.org/topic/15302-pandian-mark2/ forum link]

=== '''Installation''' requirements===
* '''Pandora''' ;) All versions fine?
* '''SD card''' minimum 2GB ( was tested with 4GB )
* '''PC''' Linux|GNU, BSD, Mac, or Windows for putting the install on the aforementioned SD-card.

==== '''Download''' a version of Pandian ====
There are two different versions of the "MARK2" release:
{| class="wikitable"
|-
! Version !! Description !! Includes !! Link !! Size !! Checksums (sha256)
|-
| '''base''' || pandian for advanced users, without any Desktop environment but with basic network-tools ( iw, ceni ) || ceni ( network-manager) network-manager MediaPlayer ( mpd ) iw (wireless-tools) || [http://www.filedropper.com/pandian-mark2-base-hf2014-01-05 filedropper: pandian-mark2-base-hf2014-01-05.7z] [http://pandian.openpandora.org/releases/pandian-mark2-base-hf_2014-01-05.7z pandian.openpandora.org: pandian-mark2-base-hf_2014-01-05.7z] || 161MB || pandian-mark2-base-hf_2014-01-05.'''7z'''↓ b11ffe9cc4fd6111775d0b48c133b1e1afcf6865de784b9865db0cea29674d85 pandian-mark2-base-hf_2014-01-05.'''img'''↓ c1903423a5b5e0d04563f14526e8161fbe77a102e64d5d571bcf3b87870fa211
|-
| '''normal''' || pandian for regular users, with full Desktop environment (LXDE) || network-manager MediaPlayer ( mpd with gurlp ) nub-support calibrator-application medit Text editor. mpd audio player backend, glurp as frontend || [http://www.filedropper.com/pandian-mark2-hf2014-01-02 filedropper: pandian-mark2-hf2014-01-02] [http://pandian.openpandora.org/releases/pandian-mark2-hf_2014-01-02.7z pandian.openpandora.org: pandian-mark2-hf_2014-01-02.7z] || 394MB || pandian-mark2-hf_2014-01-02.'''7z'''↓ 3731d70a4d8ec59e79a046f34f69c5c809be73e38cfc91a5b580478b8f8c222f pandian-mark2-hf_2014-01-02.'''img'''↓ 83b8d3fa5bd0588cfb8b11cfe6b827819e6311e98396a6e32c46c9692f072e96
|}
Notes:
* It is trivial to change from LXDE to [[Xfce]] (or any other desktop environment), adding a new user interface atop the minimal install is more advanced as manual setup of USB-Networking or wifi is needed to do so.
* All images have automount ( for USB-Sticks, external Hard-Drives etc. ) and ALSA sound support

==== '''Verify''' that your download is OK ====
* After you download the version you picked, verify its checksum to make sure the integrity of the downloaded file matches (in being an exact copy the one on the server)

#open up a terminal
# "'''sha256sum ~/downloads/pandian/<image.7Z>'''" (input where you have the file and the one you chose to download)
# make sure it matches the given md5sum, if not, try to download another copy. This step isnt mandatory, but its there to make sure everything is fine before we proceed.

==== '''Unzip''' the downloaded image ====
*Unzipping 7z archives
# Open up a terminal (or do it your way)
# Enter"'''7zr e <image.7z>'''"
# You now have an unzipped image

==== (Optional) '''Preparation''', find out where to install ====

This step helps you find out where the SD card is mounted. 

If you have an build in SD-Card-Reader this is normally /dev/mmcblk0p1 ( in Debian )
If you have an USB-Card-Reader this is something like /dev/sdc ( in Debian )
* Open an Terminal and input "'''lsblk'''"
* You will get a list with the actual Block-Devices
* The SD-Card should be of type 'disk'

You can also try gparted to see which devices you have and identify the SD-card from there

==== '''Install''' the image to the SD-Card ====
{{warning
| Warning, this will destroy everything on the device ! So please be very sure which device is you SD-Card !
}}
# Here it will be /dev/sd'''x'''

(note that the x after the sd is the drive letter, it could be ''sd'''b''''' sd'''c''''' or ''sd'''d''''' and so on, lets say its sd'''c'''. Which means c is the drive letter for the SD-card and that sd- a and -b are in use for other things. 
 
When writing to the device, make sure not to include the following number, which is the partition ''sdc'''1''''' ''sdc'''2''''' etc. since we are using the base card here) 
 
This means considerations for partitions and filesystem are taken care of, so no need to worry about that. Do ''not'' pick the wrong drive however, since dd will happily write the image to somewhere it isn't supposed to if you just give it root privileges and hit enter.) 
 
#Copy image to SD-Card with "'''dd if=<image.img> of=/dev/sdx'''"

You now have Pandian installed on your SD card and its ready to go. :) However after copying the image to the SD-Card resizing the partitionspartitions is needed to fully utilize the space, since by default the install is limited to 2GB. (If your card is bigger Pandian is still limited to those 2GB)

====(Optional) '''Resize''' SD-Card ====

* This can be done with gparted on linux|gnu
* start gparted

[[File:Gparted resize 001.png|800px|thumbnail|none|The actual partitions of the SD-CARD. Please select the correct device at the top right corner.]]
[[File:Gparted resize 002.png|800px|thumbnail|none|Rightclick to the second partition and select Resize/Move]]
[[File:Gparted resize 003.png|400px|thumbnail|none|You see the actual Size of this partition]]
[[File:Gparted resize 004.png|400px|thumbnail|none|Move the slider to the right, or set "Free space following" to 0]]
[[File:Gparted resize 005.png|800px|thumbnail|none|After you press the "Resize/Move" button, you get the preview of the new partition structure]]
[[File:Gparted resize 006.png|800px|thumbnail|none|When you press "Apply all operations", youve got a warning that you can loss your Data. THIS IS THE LAST CHANGE TO CHECK IF YOU SELECTED THE CORRECT DEVICE.

 Press Apply if everything is correct.]]

* After everything is fine, you have a fresh install of Pandian on you SD-Card
 

=== '''Startup''' wizard ===
* Upon first boot of Pandian, there is a first-start-wizard which guides you through some basic settings.
These are: Locale, timezone, time and date, password for admin and user setup and finally calibration of the touchscreen.
The script is located in /usr/sbin/pdSetup should you need to run it again.

==== Navigation ====
* Inside a dialog you can navigate with the cross/dpad
* Hit space to select a checkbox
* Moving between <Ok> and <Cancel> can be down with the use of TAB ( Tap Fn then tap Space )
* Acknowledge with Enter

*All done, enjoy :)

[[File:PandianDesktop.png|frameless]]

=== '''Network''' connection instructions:===

====normal ====
* Use network-manager

====minimal====
* Use ceni network manager

=== '''Fluxbox''' tweaks ===
Fluxbox is the actual Desktop Environment for pandian. It is simple fast and easy to configure.

==== custom menu ====
You can setup your own menu-entry's for fluxbox:
* open an terminal ( or an editor ) as root
* create a new file in ./fluxbox/menu-mymenu
( Note: the menu -filename must be named menu-* )
* run: "gen-menu-fluxbox <username>" as normal user, to generate the menu-file
* your new menu is ready for use

==== autostart ====
You can setup your own autostart script in ~/.fluxbox/startup-*
for example you can use: ~/.fluxbox/startup-mystart
Nothing else must be done, just logout and login to test it ( or reboot )

===(Optional) '''Update''' of Pandian system ===
* After you setup your Pandora, it is useful to update your system. It is a rolling release, which means since the image was made, the system is forever updated with new packages.
* open a terminal
* get root ( command is: "su" )
* enter "apt-get update" to download package information from the repositories
* enter "apt-get upgrade" to update all packages that are out of date
(pandian packages are also updated this way :)
* Note: to update only the pandian-packages enter "apt-get upgrade pandian*"

==== '''Upgrade Warnings''' ====
* if mpd is running, upgrade will fail. How to fix this:
** Open an terminal
** Login as root ( command "su" )
** Enter root password
** stop mpd with: /etc/init.d/mpd stop
** Kill it ( to be sure ): killall mpd
** upgrade again: apt-get dist-upgrade

==== Upgrade from "minimal" to "normal" ====
It is possible to upgrade from the "minimal"-image to the "normal"-image.
This can simlpy be done by installing the pandian-lxde debian package
* get an connection to the internet(tm) with ceni
* open an terminal
* get root ( with command: "su" )
* update package list with: "apt-get update"
* install pandian-lxde with "apt-get install pandian-lxde"
* after everything is finished login with the user you setup before
* open an terminal
* get root ( with command: "su" )
* load keymap with "xmodmap /etc/skel/.pndXmodmap"
* the easiest way is to activate the first-start-wizard with "insserv firstuse"
* reboot and go through the wizard

===(Optional) '''Information''' ===

=== Additional Users/Groups ===
There are additional Users/Groups added to the standard debian-users
==== Groups ====
* admin
:This superuser privilege is used by sudo for admin task like shutdown etc.
* mpd
:This user/group has access to mpd-related files ( socket, pid-files )

==== Power-Modes ====
===== LID-Close =====
* If the lid is closed only the screen will be disabled
===== Low-Power-Mode / Shutdown =====
[[File:Lead Photo For Power modes0-2920264867079787.jpg|thumbnail|right|Switch]]
* Switch to left: Pandora will go to low power mode ( reduce CPU, Disable LID, Pause processes )
* Switch to right: Shutdown the pandora

==== pdcmd ====
* This script handles all system-related stuff, like lid, low-power, usb or wifi.
* This should run as root
 
Usage:
{| class="wikitable"
|-
! Command !! What's done
|-
| /usr/sbin/pdcmd LCDBright + || Increase the light of the lid
|-
| /usr/sbin/pdcmd LCDBright - || Decrease the light of the lid
|-
| /usr/sbin/pdcmd LCDBright 10 || Set the Brightness of the lid to 10
|-
| /usr/sbin/pdcmd LCDTrigger || Trigger the lid ( WARNING: THIS DISABLES THE LID ! )
|-
| /usr/sbin/pdcmd USBNetTrigger || Enable the USB-Networking (module g_ether). If usbnetworking is on, it will disable it
|-
| /usr/sbin/pdcmd USBHostTrigger || Enable the USB-Host (module ehci-hcd). If USB-Host is on, it will disable it
|-
| /usr/sbin/pdcmd WLANTrigger || Enable Wifi. If Wifi is enabled it will be disabled
|}

==== Several tweaks ====
===== Fixing broken keyboard layout =====
If your Pandian has a German keyboard layout, you might have some trouble because it does absolutely not fit US layout on the Pandora.
There is a work around this isse.

*Make sure, the file .pndXmodmap is read in on startup. Open the file ''.xsessionrc'' in your ''home'' directory and, if not existent, add following lines at the bottom of the file
setxkbmap en_US
xmodmap /home/yourUsername/.pndXmodmap
*There must be the absolute path (no "~/").

===== Making the Pandora Button work like the Windows key =====
Many users complained, their Pandora Button has no function in Pandian. This can be changed by mapping the button as ''"mod4"''.

*Insert in the last line of the .pndXmodmap from your ''home'' directory:
add mod4 = XF86MenuKB

===== Openbox =====
Pandian comes with an unconfigured Openbox as a possible session. Here are some config templates.

====== Use the Pandora key to start the menu ======
*If not existent,
cp /etc/xdg/openbox/rc.xml /home/yourUserName/.config/openbox/
* Open the rc.xml with a text editor and search for the section <keyboard>.
* Insert the new keybind:
<keybind key="XF86MenuKB">
<action name="ShowMenu">
<menu>root-menu</menu>
</action>
</keybind>

===== Intuitive Openbox configuration template =====
Prerequisites:
*mapped 'Pandora key' as 'Windows key'(see above)
*optional: use tint2 as panel

Features:
*Changing window by '''[Ctrl] + [up]/[down]'''
*Changing workspace by '''[Ctrl] + [left]/[right]'''
*Closing window by '''[Ctrl] + [Q]'''
*Screenshot (window): '''[Ctrl] + [Shift] + [Alt] + [F11]'''
*Screenshot (whole desktop): '''[Ctrl] + [Shift] + [Alt] + [F12]'''
*and some more

'''Download:'''
[https://www.dropbox.com/s/ud0muusrxq9g9va/rc.xml rc.xml]

===== Intuitive Openbox menu template =====
Features:
*Most important programms in root menu
*menu entries for WLAN, USB host and low power mode
'''Download:'''
[https://www.dropbox.com/s/fqjxg5xoymg5fep/menu.xml menu.xml]

== Mounting internal NAND to /mnt ==

Pandora internal NAND exposes a raw flash interfaces. For such devices, the
Linux kernel exposes a special MTD abstraction and "mtd aware" filesystems may
give a better performance. Pandora uses UBIFS, which needs UBI volume
management to work.

# Install mtd-utils
# Run the following commands

<syntaxhighlight lang="bash">
# Attach mtd device 4 to UBI volume management 0
ubiattach -m 4 -d 0
# Mount first partition of the UBI group 0 to /mnt
mount -t ubifs /dev/ubi0_0 /mnt
# Attach mtd device 3 to UBI volume management 1
ubiattach -m 3 -d 1
# Mount first partition of the UBI group 1 to /mnt
mount -t ubifs /dev/ubi1_0 /mnt/boot
</syntaxhighlight>

== Old releases ==

=== Mark2 minimal-hf2014-01-02 ===

{| class="wikitable"
|-
! Version !! Description !! Included !! Link !! Checksums (sha256)
|-
| minimal || pandian without any Desktop environment but with the basic pandian package || nano || [http://www.filedropper.com/pandian-mark2-minimal-hf2014-01-02 filedropper: pandian-mark2-minimal-hf2014-01-02] [http://pandian.openpandora.org/releases/pandian-mark2-minimal-hf_2014-01-02.7z pandian.openpandora.org: pandian-mark2-minimal-hf_2014-01-02.7z] || pandian-mark2-minimal-hf_2014-01-02.'''7z'''↓ a35106473e54c55d64c7eae2088d8c267b605baf17d5338b8e2938dbfe3c01ca pandian-mark2-minimal-hf_2014-01-02.'''img'''↓ c68a42c1aef0238c1dd6ff33b628a2c0dea812a7b5b2d906afb185f93f940f84
|-
| minimal-networking fix|| HotFix for pandian-mark2-minimal-hf_2014-01-02 [[#Network_Fix_for_pandian-minimal|Instructions]] || dhcp, network manager || [http://www.filedropper.com/pandian-mark2-minimal-networking2014-01-02tar filedropper: pandian-mark2-minimal-networking_2014-01-02.tar.gz] [http://pandian.openpandora.org/releases/pandian-mark2-minimal-networking_2014-01-02.tar.gz pandian.openpandora.org: pandian-mark2-minimal-networking_2014-01-02.tar.gz] ||pandian-mark2-minimal-networking_2014-01-02.'''tar.gz'''↓ 4cf802391360e5bf183e9d4b5fe8b6f407b3e476baec7b5b0aa7340796680ae6
|}

===== Network Fix for pandian-minimal =====
If you download the '''pandian-mark2-minimal-hf_2014-01-02''' image there is a lack of tools for setup wifi networking. 
'''Note: For the actual download of pandian-minimal, wifi-network-tools are included'''
* Therefore download the fix and place it on the SD-Card where pandian is installed. (you need to have local superuser privileges on your own system as the SD contents aren't owned by your user)
* Boot pandian-minimal
* login with user: "root"
* switch to root-directory: "cd /"
* untar the network-fix: "tar -xf /path-where-file-is-located/pandian-mark2-minimal-networking_2014-01-03.tar.gz"
* setup the fix with command "pdMinimalNetwork"

* after the script is finished, run "ceni" and setup your wifi-connection

=== 01 ===
'''Full debian GNU/Linux 7.2 codename Wheezy (stable) with LXDE desktop environment 
hardfloat armv7l released Date: 29.09.2013'''
[http://boards.openpandora.org/topic/14482-pandian-01/ forum link]
===Features===

* Hard-Float-ABI
* Ext4 Root for better performance
* Working Touch-Screen
* Working Nubs
* Screen-Off on LID-Close
* Low-Power-Mode
* WLAN
* Music ( with Sonata/MPD )
* Automount

=== Upcoming/Ideas ===

* Assistant for tzdata
* libpnd - PND-Support
* OpenGL not tested yet
* Aptitude
* Minimal-Network-Installation
* Pandian-Debian-Repository for special packages ( libpnd, touch-screen-calibrator )
* of course, in-system-documentation ( Documentation on the pandora )

Download [http://www.share-online.biz/dl/TPMFFXTM2AU here]

[http://boards.openpandora.org/topic/14482-pandian-01 Forum thread]

=== Installation ===

note: It is assumed here, that the card-reader load the card as /dev/sdc.
Please check before which device is your SD-card !
This can be checked with gparted. Minimum requirement 2GB SD-card.

# Download Image ( as 7z )
# Verify md5-checksum: pandian-stable-hf_2013-09-29.001.7z '''2a85bbb40bbe7c6e8f92f058e150951a''' pandian-stable-hf_2013-09-29.001.img '''e62d101dc708de49af1ca7743e2df2bd'''
# Unzip with 7z ( in Linux with 7zr e <image.7z> )
# Copy image to SD-Card ( dd if=<image.img> of=/dev/sdx ) Don't specify "bs="

Username: ''Pandian'' 
Root password: ''Root'' (change after intsallation as per instructions below)

#Open a terminal
#Type "su"
#Type "passwd"
#Enter your new root password when prompted, and then again to confirm.
#Dont forget your password

=== Resize ===
Default installation is limited to 2GB, if you want to expand it, you can, provided you have installed it on a bigger SD-card and want to make use of the space.

* Size will be changed with parted
* parted /dev/sdx
* show size with "print free"

# (parted) print free # Model: USB Mass Storage Device (scsi)
# Disk /dev/sdc: 7965MB# Sector size (logical/physical): 512B/512B# Partition Table: msdos

{| class="wikitable"
|-
| Number || Start || End || Size || Type || File system || Flags
|-
| || 32,3kB || 1049kB || 1016kB || || Free Space ||
|-
| 1 || 1049kB || 53,5MB || 52,4MB || primary || fat32 ||
|-
| 2 || 53,5MB || 1933MB || 1879MB || primary || ext4 ||
|-
| || 1933MB || 7965MB || 6032MB || || Free Space ||
|}

we would like to resize the second partition to the nearly end ( -512MB for swap )
# (parted) resizepart # Partition number? 2 # Warning: Partition /dev/sdc2 is being used. Are you sure you want to continue?# Yes/No? YES # End? [1933MB]? 7453MB this is how the partitions looks like after

(parted) print free * Model: USB Mass Storage Device (scsi)* Disk /dev/sdc: 7965MB* Sector size (logical/physical): 512B/512B* Partition Table: msdos

{| class="wikitable"
|-
| Number || Start || End || Size || Type || File system || Flags
|-
| || 32,3kB || 1049kB || 1016kB || || Free Space ||
|-
| 1 || 1049kB || 53,5MB || 52,4MB || primary || fat32 ||
|-
| 2 || 53,5MB || '''7453'''MB || '''7400'''MB || primary || ext4 ||
|-
| || '''7453'''MB || 7965MB || '''512'''MB || || Free Space ||
|}

create Swap (optional)

(parted) mkpart primary linux-swap
Start? 7453MB
End? 7965MB

this is how the partitions looks like after

(parted) print free * Model: USB Mass Storage Device (scsi)* Disk /dev/sdc: 7965MB* Sector size (logical/physical): 512B/512B* Partition Table: msdos

{| class="wikitable"
|-
| Number || Start || End || Size || Type || File system || Flags
|-
| || 32,3kB || 1049kB || 1016kB || || Free Space ||
|-
| 1 || 1049kB || 53,5MB || 52,4MB || primary || fat32 ||
|-
| 2 || 53,5MB || 7453MB || 7400MB || primary || ext4 ||
|-
| || '''7453MB''' || '''7453MB''' || '''278kB''' || || '''Free Space'''||
|-
| || 7453MB || 7965MB || 512MB || '''primary''' || Free Space ||
|}
disregard the 4th entry, the new resized partition is the last one.

resize filesystem
*resize2fs /dev/sdc2

create swap

*mkswap /dev/sdc3

[[Category:Documentation]]
[[Category:Operating system]]
[[Category:Software]]

Pandian

2014-03-22T11:17:48Z

Stackshadow: /* Upgrade Warnings */

[[File:Post-3032-0-90501200-1380479048.png|thumbnail|Logo]]

'''Pandian is an debian-based armhf desktop and CLI distro for your Pandora.'''
Ideas, Bugs, or feature-requests? Report to:
https://www.evilbrain.de/review/index.php?project=4

=== Main Features ===
* The debian way.
* Access to all packages from Debian software repositories.
* Pandian hosts its own Debian repo http://pandian.openpandora.org with up to date scripts, all settings and extra programs.
* armhf-build, which means '''f'''loat operations are relegated to special '''h'''ardware rather than taxing the main cpu with them (as with softfloat)

== '''Pandian''' - '''MARK 2''' The newest release ==
Second version of Pandian 
'''Full Debian GNU/Linux based on sid branch with LXDE desktop environment (normal) or CLI (minimal-) build.''' 
'''hardfloat armv7l''' yule release '''Date: 29.12.2013'''
[http://boards.openpandora.org/topic/15302-pandian-mark2/ forum link]

=== '''Installation''' requirements===
* '''Pandora''' ;) All versions fine?
* '''SD card''' minimum 2GB ( was tested with 4GB )
* '''PC''' Linux|GNU, BSD, Mac, or Windows for putting the install on the aforementioned SD-card.

==== '''Download''' a version of Pandian ====
There are two different versions of the "MARK2" release:
{| class="wikitable"
|-
! Version !! Description !! Includes !! Link !! Size !! Checksums (sha256)
|-
| '''base''' || pandian for advanced users, without any Desktop environment but with basic network-tools ( iw, ceni ) || ceni ( network-manager) network-manager MediaPlayer ( mpd ) iw (wireless-tools) || [http://www.filedropper.com/pandian-mark2-base-hf2014-01-05 filedropper: pandian-mark2-base-hf2014-01-05.7z] [http://pandian.openpandora.org/releases/pandian-mark2-base-hf_2014-01-05.7z pandian.openpandora.org: pandian-mark2-base-hf_2014-01-05.7z] || 161MB || pandian-mark2-base-hf_2014-01-05.'''7z'''↓ b11ffe9cc4fd6111775d0b48c133b1e1afcf6865de784b9865db0cea29674d85 pandian-mark2-base-hf_2014-01-05.'''img'''↓ c1903423a5b5e0d04563f14526e8161fbe77a102e64d5d571bcf3b87870fa211
|-
| '''normal''' || pandian for regular users, with full Desktop environment (LXDE) || network-manager MediaPlayer ( mpd with gurlp ) nub-support calibrator-application medit Text editor. mpd audio player backend, glurp as frontend || [http://www.filedropper.com/pandian-mark2-hf2014-01-02 filedropper: pandian-mark2-hf2014-01-02] [http://pandian.openpandora.org/releases/pandian-mark2-hf_2014-01-02.7z pandian.openpandora.org: pandian-mark2-hf_2014-01-02.7z] || 394MB || pandian-mark2-hf_2014-01-02.'''7z'''↓ 3731d70a4d8ec59e79a046f34f69c5c809be73e38cfc91a5b580478b8f8c222f pandian-mark2-hf_2014-01-02.'''img'''↓ 83b8d3fa5bd0588cfb8b11cfe6b827819e6311e98396a6e32c46c9692f072e96
|}
Notes:
* It is trivial to change from LXDE to [[Xfce]] (or any other desktop environment), adding a new user interface atop the minimal install is more advanced as manual setup of USB-Networking or wifi is needed to do so.
* All images have automount ( for USB-Sticks, external Hard-Drives etc. ) and ALSA sound support

==== '''Verify''' that your download is OK ====
* After you download the version you picked, verify its checksum to make sure the integrity of the downloaded file matches (in being an exact copy the one on the server)

#open up a terminal
# "'''sha256sum ~/downloads/pandian/<image.7Z>'''" (input where you have the file and the one you chose to download)
# make sure it matches the given md5sum, if not, try to download another copy. This step isnt mandatory, but its there to make sure everything is fine before we proceed.

==== '''Unzip''' the downloaded image ====
*Unzipping 7z archives
# Open up a terminal (or do it your way)
# Enter"'''7zr e <image.7z>'''"
# You now have an unzipped image

==== (Optional) '''Preparation''', find out where to install ====

This step helps you find out where the SD card is mounted. 

If you have an build in SD-Card-Reader this is normally /dev/mmcblk0p1 ( in Debian )
If you have an USB-Card-Reader this is something like /dev/sdc ( in Debian )
* Open an Terminal and input "'''lsblk'''"
* You will get a list with the actual Block-Devices
* The SD-Card should be of type 'disk'

You can also try gparted to see which devices you have and identify the SD-card from there

==== '''Install''' the image to the SD-Card ====
{{warning
| Warning, this will destroy everything on the device ! So please be very sure which device is you SD-Card !
}}
# Here it will be /dev/sd'''x'''

(note that the x after the sd is the drive letter, it could be ''sd'''b''''' sd'''c''''' or ''sd'''d''''' and so on, lets say its sd'''c'''. Which means c is the drive letter for the SD-card and that sd- a and -b are in use for other things. 
 
When writing to the device, make sure not to include the following number, which is the partition ''sdc'''1''''' ''sdc'''2''''' etc. since we are using the base card here) 
 
This means considerations for partitions and filesystem are taken care of, so no need to worry about that. Do ''not'' pick the wrong drive however, since dd will happily write the image to somewhere it isn't supposed to if you just give it root privileges and hit enter.) 
 
#Copy image to SD-Card with "'''dd if=<image.img> of=/dev/sdx'''"

You now have Pandian installed on your SD card and its ready to go. :) However after copying the image to the SD-Card resizing the partitionspartitions is needed to fully utilize the space, since by default the install is limited to 2GB. (If your card is bigger Pandian is still limited to those 2GB)

====(Optional) '''Resize''' SD-Card ====

* This can be done with gparted on linux|gnu
* start gparted

[[File:Gparted resize 001.png|800px|thumbnail|none|The actual partitions of the SD-CARD. Please select the correct device at the top right corner.]]
[[File:Gparted resize 002.png|800px|thumbnail|none|Rightclick to the second partition and select Resize/Move]]
[[File:Gparted resize 003.png|400px|thumbnail|none|You see the actual Size of this partition]]
[[File:Gparted resize 004.png|400px|thumbnail|none|Move the slider to the right, or set "Free space following" to 0]]
[[File:Gparted resize 005.png|800px|thumbnail|none|After you press the "Resize/Move" button, you get the preview of the new partition structure]]
[[File:Gparted resize 006.png|800px|thumbnail|none|When you press "Apply all operations", youve got a warning that you can loss your Data. THIS IS THE LAST CHANGE TO CHECK IF YOU SELECTED THE CORRECT DEVICE.

 Press Apply if everything is correct.]]

* After everything is fine, you have a fresh install of Pandian on you SD-Card
 

=== '''Startup''' wizard ===
* Upon first boot of Pandian, there is a first-start-wizard which guides you through some basic settings.
These are: Locale, timezone, time and date, password for admin and user setup and finally calibration of the touchscreen.
The script is located in /usr/sbin/pdSetup should you need to run it again.

==== Navigation ====
* Inside a dialog you can navigate with the cross/dpad
* Hit space to select a checkbox
* Moving between <Ok> and <Cancel> can be down with the use of TAB ( Tap Fn then tap Space )
* Acknowledge with Enter

*All done, enjoy :)

[[File:PandianDesktop.png|frameless]]

=== '''Network''' connection instructions:===

====normal ====
* Use network-manager

====minimal====
* Use ceni network manager

===(Optional) '''Update''' of Pandian system ===
* After you setup your Pandora, it is useful to update your system. It is a rolling release, which means since the image was made, the system is forever updated with new packages.
* open a terminal
* get root ( command is: "su" )
* enter "apt-get update" to download package information from the repositories
* enter "apt-get upgrade" to update all packages that are out of date
(pandian packages are also updated this way :)
* Note: to update only the pandian-packages enter "apt-get upgrade pandian*"

==== '''Upgrade Warnings''' ====
* if mpd is running, upgrade will fail. How to fix this:
** Open an terminal
** Login as root ( command "su" )
** Enter root password
** stop mpd with: /etc/init.d/mpd stop
** Kill it ( to be sure ): killall mpd
** upgrade again: apt-get dist-upgrade

==== Upgrade from "minimal" to "normal" ====
It is possible to upgrade from the "minimal"-image to the "normal"-image.
This can simlpy be done by installing the pandian-lxde debian package
* get an connection to the internet(tm) with ceni
* open an terminal
* get root ( with command: "su" )
* update package list with: "apt-get update"
* install pandian-lxde with "apt-get install pandian-lxde"
* after everything is finished login with the user you setup before
* open an terminal
* get root ( with command: "su" )
* load keymap with "xmodmap /etc/skel/.pndXmodmap"
* the easiest way is to activate the first-start-wizard with "insserv firstuse"
* reboot and go through the wizard

===(Optional) '''Information''' ===

=== Additional Users/Groups ===
There are additional Users/Groups added to the standard debian-users
==== Groups ====
* admin
:This superuser privilege is used by sudo for admin task like shutdown etc.
* mpd
:This user/group has access to mpd-related files ( socket, pid-files )

==== Power-Modes ====
===== LID-Close =====
* If the lid is closed only the screen will be disabled
===== Low-Power-Mode / Shutdown =====
[[File:Lead Photo For Power modes0-2920264867079787.jpg|thumbnail|right|Switch]]
* Switch to left: Pandora will go to low power mode ( reduce CPU, Disable LID, Pause processes )
* Switch to right: Shutdown the pandora

==== pdcmd ====
* This script handles all system-related stuff, like lid, low-power, usb or wifi.
* This should run as root
 
Usage:
{| class="wikitable"
|-
! Command !! What's done
|-
| /usr/sbin/pdcmd LCDBright + || Increase the light of the lid
|-
| /usr/sbin/pdcmd LCDBright - || Decrease the light of the lid
|-
| /usr/sbin/pdcmd LCDBright 10 || Set the Brightness of the lid to 10
|-
| /usr/sbin/pdcmd LCDTrigger || Trigger the lid ( WARNING: THIS DISABLES THE LID ! )
|-
| /usr/sbin/pdcmd USBNetTrigger || Enable the USB-Networking (module g_ether). If usbnetworking is on, it will disable it
|-
| /usr/sbin/pdcmd USBHostTrigger || Enable the USB-Host (module ehci-hcd). If USB-Host is on, it will disable it
|-
| /usr/sbin/pdcmd WLANTrigger || Enable Wifi. If Wifi is enabled it will be disabled
|}

==== Several tweaks ====
===== Fixing broken keyboard layout =====
If your Pandian has a German keyboard layout, you might have some trouble because it does absolutely not fit US layout on the Pandora.
There is a work around this isse.

*Make sure, the file .pndXmodmap is read in on startup. Open the file ''.xsessionrc'' in your ''home'' directory and, if not existent, add following lines at the bottom of the file
setxkbmap en_US
xmodmap /home/yourUsername/.pndXmodmap
*There must be the absolute path (no "~/").

===== Making the Pandora Button work like the Windows key =====
Many users complained, their Pandora Button has no function in Pandian. This can be changed by mapping the button as ''"mod4"''.

*Insert in the last line of the .pndXmodmap from your ''home'' directory:
add mod4 = XF86MenuKB

===== Openbox =====
Pandian comes with an unconfigured Openbox as a possible session. Here are some config templates.

====== Use the Pandora key to start the menu ======
*If not existent,
cp /etc/xdg/openbox/rc.xml /home/yourUserName/.config/openbox/
* Open the rc.xml with a text editor and search for the section <keyboard>.
* Insert the new keybind:
<keybind key="XF86MenuKB">
<action name="ShowMenu">
<menu>root-menu</menu>
</action>
</keybind>

===== Intuitive Openbox configuration template =====
Prerequisites:
*mapped 'Pandora key' as 'Windows key'(see above)
*optional: use tint2 as panel

Features:
*Changing window by '''[Ctrl] + [up]/[down]'''
*Changing workspace by '''[Ctrl] + [left]/[right]'''
*Closing window by '''[Ctrl] + [Q]'''
*Screenshot (window): '''[Ctrl] + [Shift] + [Alt] + [F11]'''
*Screenshot (whole desktop): '''[Ctrl] + [Shift] + [Alt] + [F12]'''
*and some more

'''Download:'''
[https://www.dropbox.com/s/ud0muusrxq9g9va/rc.xml rc.xml]

===== Intuitive Openbox menu template =====
Features:
*Most important programms in root menu
*menu entries for WLAN, USB host and low power mode
'''Download:'''
[https://www.dropbox.com/s/fqjxg5xoymg5fep/menu.xml menu.xml]

== Mounting internal NAND to /mnt ==

Pandora internal NAND exposes a raw flash interfaces. For such devices, the
Linux kernel exposes a special MTD abstraction and "mtd aware" filesystems may
give a better performance. Pandora uses UBIFS, which needs UBI volume
management to work.

# Install mtd-utils
# Run the following commands

<syntaxhighlight lang="bash">
# Attach mtd device 4 to UBI volume management 0
ubiattach -m 4 -d 0
# Mount first partition of the UBI group 0 to /mnt
mount -t ubifs /dev/ubi0_0 /mnt
# Attach mtd device 3 to UBI volume management 1
ubiattach -m 3 -d 1
# Mount first partition of the UBI group 1 to /mnt
mount -t ubifs /dev/ubi1_0 /mnt/boot
</syntaxhighlight>

== Old releases ==

=== Mark2 minimal-hf2014-01-02 ===

{| class="wikitable"
|-
! Version !! Description !! Included !! Link !! Checksums (sha256)
|-
| minimal || pandian without any Desktop environment but with the basic pandian package || nano || [http://www.filedropper.com/pandian-mark2-minimal-hf2014-01-02 filedropper: pandian-mark2-minimal-hf2014-01-02] [http://pandian.openpandora.org/releases/pandian-mark2-minimal-hf_2014-01-02.7z pandian.openpandora.org: pandian-mark2-minimal-hf_2014-01-02.7z] || pandian-mark2-minimal-hf_2014-01-02.'''7z'''↓ a35106473e54c55d64c7eae2088d8c267b605baf17d5338b8e2938dbfe3c01ca pandian-mark2-minimal-hf_2014-01-02.'''img'''↓ c68a42c1aef0238c1dd6ff33b628a2c0dea812a7b5b2d906afb185f93f940f84
|-
| minimal-networking fix|| HotFix for pandian-mark2-minimal-hf_2014-01-02 [[#Network_Fix_for_pandian-minimal|Instructions]] || dhcp, network manager || [http://www.filedropper.com/pandian-mark2-minimal-networking2014-01-02tar filedropper: pandian-mark2-minimal-networking_2014-01-02.tar.gz] [http://pandian.openpandora.org/releases/pandian-mark2-minimal-networking_2014-01-02.tar.gz pandian.openpandora.org: pandian-mark2-minimal-networking_2014-01-02.tar.gz] ||pandian-mark2-minimal-networking_2014-01-02.'''tar.gz'''↓ 4cf802391360e5bf183e9d4b5fe8b6f407b3e476baec7b5b0aa7340796680ae6
|}

===== Network Fix for pandian-minimal =====
If you download the '''pandian-mark2-minimal-hf_2014-01-02''' image there is a lack of tools for setup wifi networking. 
'''Note: For the actual download of pandian-minimal, wifi-network-tools are included'''
* Therefore download the fix and place it on the SD-Card where pandian is installed. (you need to have local superuser privileges on your own system as the SD contents aren't owned by your user)
* Boot pandian-minimal
* login with user: "root"
* switch to root-directory: "cd /"
* untar the network-fix: "tar -xf /path-where-file-is-located/pandian-mark2-minimal-networking_2014-01-03.tar.gz"
* setup the fix with command "pdMinimalNetwork"

* after the script is finished, run "ceni" and setup your wifi-connection

=== 01 ===
'''Full debian GNU/Linux 7.2 codename Wheezy (stable) with LXDE desktop environment 
hardfloat armv7l released Date: 29.09.2013'''
[http://boards.openpandora.org/topic/14482-pandian-01/ forum link]
===Features===

* Hard-Float-ABI
* Ext4 Root for better performance
* Working Touch-Screen
* Working Nubs
* Screen-Off on LID-Close
* Low-Power-Mode
* WLAN
* Music ( with Sonata/MPD )
* Automount

=== Upcoming/Ideas ===

* Assistant for tzdata
* libpnd - PND-Support
* OpenGL not tested yet
* Aptitude
* Minimal-Network-Installation
* Pandian-Debian-Repository for special packages ( libpnd, touch-screen-calibrator )
* of course, in-system-documentation ( Documentation on the pandora )

Download [http://www.share-online.biz/dl/TPMFFXTM2AU here]

[http://boards.openpandora.org/topic/14482-pandian-01 Forum thread]

=== Installation ===

note: It is assumed here, that the card-reader load the card as /dev/sdc.
Please check before which device is your SD-card !
This can be checked with gparted. Minimum requirement 2GB SD-card.

# Download Image ( as 7z )
# Verify md5-checksum: pandian-stable-hf_2013-09-29.001.7z '''2a85bbb40bbe7c6e8f92f058e150951a''' pandian-stable-hf_2013-09-29.001.img '''e62d101dc708de49af1ca7743e2df2bd'''
# Unzip with 7z ( in Linux with 7zr e <image.7z> )
# Copy image to SD-Card ( dd if=<image.img> of=/dev/sdx ) Don't specify "bs="

Username: ''Pandian'' 
Root password: ''Root'' (change after intsallation as per instructions below)

#Open a terminal
#Type "su"
#Type "passwd"
#Enter your new root password when prompted, and then again to confirm.
#Dont forget your password

=== Resize ===
Default installation is limited to 2GB, if you want to expand it, you can, provided you have installed it on a bigger SD-card and want to make use of the space.

* Size will be changed with parted
* parted /dev/sdx
* show size with "print free"

# (parted) print free # Model: USB Mass Storage Device (scsi)
# Disk /dev/sdc: 7965MB# Sector size (logical/physical): 512B/512B# Partition Table: msdos

{| class="wikitable"
|-
| Number || Start || End || Size || Type || File system || Flags
|-
| || 32,3kB || 1049kB || 1016kB || || Free Space ||
|-
| 1 || 1049kB || 53,5MB || 52,4MB || primary || fat32 ||
|-
| 2 || 53,5MB || 1933MB || 1879MB || primary || ext4 ||
|-
| || 1933MB || 7965MB || 6032MB || || Free Space ||
|}

we would like to resize the second partition to the nearly end ( -512MB for swap )
# (parted) resizepart # Partition number? 2 # Warning: Partition /dev/sdc2 is being used. Are you sure you want to continue?# Yes/No? YES # End? [1933MB]? 7453MB this is how the partitions looks like after

(parted) print free * Model: USB Mass Storage Device (scsi)* Disk /dev/sdc: 7965MB* Sector size (logical/physical): 512B/512B* Partition Table: msdos

{| class="wikitable"
|-
| Number || Start || End || Size || Type || File system || Flags
|-
| || 32,3kB || 1049kB || 1016kB || || Free Space ||
|-
| 1 || 1049kB || 53,5MB || 52,4MB || primary || fat32 ||
|-
| 2 || 53,5MB || '''7453'''MB || '''7400'''MB || primary || ext4 ||
|-
| || '''7453'''MB || 7965MB || '''512'''MB || || Free Space ||
|}

create Swap (optional)

(parted) mkpart primary linux-swap
Start? 7453MB
End? 7965MB

this is how the partitions looks like after

(parted) print free * Model: USB Mass Storage Device (scsi)* Disk /dev/sdc: 7965MB* Sector size (logical/physical): 512B/512B* Partition Table: msdos

{| class="wikitable"
|-
| Number || Start || End || Size || Type || File system || Flags
|-
| || 32,3kB || 1049kB || 1016kB || || Free Space ||
|-
| 1 || 1049kB || 53,5MB || 52,4MB || primary || fat32 ||
|-
| 2 || 53,5MB || 7453MB || 7400MB || primary || ext4 ||
|-
| || '''7453MB''' || '''7453MB''' || '''278kB''' || || '''Free Space'''||
|-
| || 7453MB || 7965MB || 512MB || '''primary''' || Free Space ||
|}
disregard the 4th entry, the new resized partition is the last one.

resize filesystem
*resize2fs /dev/sdc2

create swap

*mkswap /dev/sdc3

[[Category:Documentation]]
[[Category:Operating system]]
[[Category:Software]]

Pandian

2014-03-22T11:07:08Z

Stackshadow: Fix Bug-Report-Link

[[File:Post-3032-0-90501200-1380479048.png|thumbnail|Logo]]

'''Pandian is an debian-based armhf desktop and CLI distro for your Pandora.'''
Ideas, Bugs, or feature-requests? Report to:
https://www.evilbrain.de/review/index.php?project=4

=== Main Features ===
* The debian way.
* Access to all packages from Debian software repositories.
* Pandian hosts its own Debian repo http://pandian.openpandora.org with up to date scripts, all settings and extra programs.
* armhf-build, which means '''f'''loat operations are relegated to special '''h'''ardware rather than taxing the main cpu with them (as with softfloat)

== '''Pandian''' - '''MARK 2''' The newest release ==
Second version of Pandian 
'''Full Debian GNU/Linux based on sid branch with LXDE desktop environment (normal) or CLI (minimal-) build.''' 
'''hardfloat armv7l''' yule release '''Date: 29.12.2013'''
[http://boards.openpandora.org/topic/15302-pandian-mark2/ forum link]

=== '''Installation''' requirements===
* '''Pandora''' ;) All versions fine?
* '''SD card''' minimum 2GB ( was tested with 4GB )
* '''PC''' Linux|GNU, BSD, Mac, or Windows for putting the install on the aforementioned SD-card.

==== '''Download''' a version of Pandian ====
There are two different versions of the "MARK2" release:
{| class="wikitable"
|-
! Version !! Description !! Includes !! Link !! Size !! Checksums (sha256)
|-
| '''base''' || pandian for advanced users, without any Desktop environment but with basic network-tools ( iw, ceni ) || ceni ( network-manager) network-manager MediaPlayer ( mpd ) iw (wireless-tools) || [http://www.filedropper.com/pandian-mark2-base-hf2014-01-05 filedropper: pandian-mark2-base-hf2014-01-05.7z] [http://pandian.openpandora.org/releases/pandian-mark2-base-hf_2014-01-05.7z pandian.openpandora.org: pandian-mark2-base-hf_2014-01-05.7z] || 161MB || pandian-mark2-base-hf_2014-01-05.'''7z'''↓ b11ffe9cc4fd6111775d0b48c133b1e1afcf6865de784b9865db0cea29674d85 pandian-mark2-base-hf_2014-01-05.'''img'''↓ c1903423a5b5e0d04563f14526e8161fbe77a102e64d5d571bcf3b87870fa211
|-
| '''normal''' || pandian for regular users, with full Desktop environment (LXDE) || network-manager MediaPlayer ( mpd with gurlp ) nub-support calibrator-application medit Text editor. mpd audio player backend, glurp as frontend || [http://www.filedropper.com/pandian-mark2-hf2014-01-02 filedropper: pandian-mark2-hf2014-01-02] [http://pandian.openpandora.org/releases/pandian-mark2-hf_2014-01-02.7z pandian.openpandora.org: pandian-mark2-hf_2014-01-02.7z] || 394MB || pandian-mark2-hf_2014-01-02.'''7z'''↓ 3731d70a4d8ec59e79a046f34f69c5c809be73e38cfc91a5b580478b8f8c222f pandian-mark2-hf_2014-01-02.'''img'''↓ 83b8d3fa5bd0588cfb8b11cfe6b827819e6311e98396a6e32c46c9692f072e96
|}
Notes:
* It is trivial to change from LXDE to [[Xfce]] (or any other desktop environment), adding a new user interface atop the minimal install is more advanced as manual setup of USB-Networking or wifi is needed to do so.
* All images have automount ( for USB-Sticks, external Hard-Drives etc. ) and ALSA sound support

==== '''Verify''' that your download is OK ====
* After you download the version you picked, verify its checksum to make sure the integrity of the downloaded file matches (in being an exact copy the one on the server)

#open up a terminal
# "'''sha256sum ~/downloads/pandian/<image.7Z>'''" (input where you have the file and the one you chose to download)
# make sure it matches the given md5sum, if not, try to download another copy. This step isnt mandatory, but its there to make sure everything is fine before we proceed.

==== '''Unzip''' the downloaded image ====
*Unzipping 7z archives
# Open up a terminal (or do it your way)
# Enter"'''7zr e <image.7z>'''"
# You now have an unzipped image

==== (Optional) '''Preparation''', find out where to install ====

This step helps you find out where the SD card is mounted. 

If you have an build in SD-Card-Reader this is normally /dev/mmcblk0p1 ( in Debian )
If you have an USB-Card-Reader this is something like /dev/sdc ( in Debian )
* Open an Terminal and input "'''lsblk'''"
* You will get a list with the actual Block-Devices
* The SD-Card should be of type 'disk'

You can also try gparted to see which devices you have and identify the SD-card from there

==== '''Install''' the image to the SD-Card ====
{{warning
| Warning, this will destroy everything on the device ! So please be very sure which device is you SD-Card !
}}
# Here it will be /dev/sd'''x'''

(note that the x after the sd is the drive letter, it could be ''sd'''b''''' sd'''c''''' or ''sd'''d''''' and so on, lets say its sd'''c'''. Which means c is the drive letter for the SD-card and that sd- a and -b are in use for other things. 
 
When writing to the device, make sure not to include the following number, which is the partition ''sdc'''1''''' ''sdc'''2''''' etc. since we are using the base card here) 
 
This means considerations for partitions and filesystem are taken care of, so no need to worry about that. Do ''not'' pick the wrong drive however, since dd will happily write the image to somewhere it isn't supposed to if you just give it root privileges and hit enter.) 
 
#Copy image to SD-Card with "'''dd if=<image.img> of=/dev/sdx'''"

You now have Pandian installed on your SD card and its ready to go. :) However after copying the image to the SD-Card resizing the partitionspartitions is needed to fully utilize the space, since by default the install is limited to 2GB. (If your card is bigger Pandian is still limited to those 2GB)

====(Optional) '''Resize''' SD-Card ====

* This can be done with gparted on linux|gnu
* start gparted

[[File:Gparted resize 001.png|800px|thumbnail|none|The actual partitions of the SD-CARD. Please select the correct device at the top right corner.]]
[[File:Gparted resize 002.png|800px|thumbnail|none|Rightclick to the second partition and select Resize/Move]]
[[File:Gparted resize 003.png|400px|thumbnail|none|You see the actual Size of this partition]]
[[File:Gparted resize 004.png|400px|thumbnail|none|Move the slider to the right, or set "Free space following" to 0]]
[[File:Gparted resize 005.png|800px|thumbnail|none|After you press the "Resize/Move" button, you get the preview of the new partition structure]]
[[File:Gparted resize 006.png|800px|thumbnail|none|When you press "Apply all operations", youve got a warning that you can loss your Data. THIS IS THE LAST CHANGE TO CHECK IF YOU SELECTED THE CORRECT DEVICE.

 Press Apply if everything is correct.]]

* After everything is fine, you have a fresh install of Pandian on you SD-Card
 

=== '''Startup''' wizard ===
* Upon first boot of Pandian, there is a first-start-wizard which guides you through some basic settings.
These are: Locale, timezone, time and date, password for admin and user setup and finally calibration of the touchscreen.
The script is located in /usr/sbin/pdSetup should you need to run it again.

==== Navigation ====
* Inside a dialog you can navigate with the cross/dpad
* Hit space to select a checkbox
* Moving between <Ok> and <Cancel> can be down with the use of TAB ( Tap Fn then tap Space )
* Acknowledge with Enter

*All done, enjoy :)

[[File:PandianDesktop.png|frameless]]

=== '''Network''' connection instructions:===

====normal ====
* Use network-manager

====minimal====
* Use ceni network manager

===(Optional) '''Update''' of Pandian system ===
* After you setup your Pandora, it is useful to update your system. It is a rolling release, which means since the image was made, the system is forever updated with new packages.
* open a terminal
* get root ( command is: "su" )
* enter "apt-get update" to download package information from the repositories
* enter "apt-get upgrade" to update all packages that are out of date
(pandian packages are also updated this way :)
* Note: to update only the pandian-packages enter "apt-get upgrade pandian*"

==== '''Upgrade Warnings''' ====
* if mpd is running, upgrade will fail. How to fix this:
** Open an terminal
** Login as root ( command "su" )
** Enter root password
** stop mpd with: /etc/init.d/mpd stop
** upgrade again: apt-get dist-upgrade

==== Upgrade from "minimal" to "normal" ====
It is possible to upgrade from the "minimal"-image to the "normal"-image.
This can simlpy be done by installing the pandian-lxde debian package
* get an connection to the internet(tm) with ceni
* open an terminal
* get root ( with command: "su" )
* update package list with: "apt-get update"
* install pandian-lxde with "apt-get install pandian-lxde"
* after everything is finished login with the user you setup before
* open an terminal
* get root ( with command: "su" )
* load keymap with "xmodmap /etc/skel/.pndXmodmap"
* the easiest way is to activate the first-start-wizard with "insserv firstuse"
* reboot and go through the wizard

===(Optional) '''Information''' ===

=== Additional Users/Groups ===
There are additional Users/Groups added to the standard debian-users
==== Groups ====
* admin
:This superuser privilege is used by sudo for admin task like shutdown etc.
* mpd
:This user/group has access to mpd-related files ( socket, pid-files )

==== Power-Modes ====
===== LID-Close =====
* If the lid is closed only the screen will be disabled
===== Low-Power-Mode / Shutdown =====
[[File:Lead Photo For Power modes0-2920264867079787.jpg|thumbnail|right|Switch]]
* Switch to left: Pandora will go to low power mode ( reduce CPU, Disable LID, Pause processes )
* Switch to right: Shutdown the pandora

==== pdcmd ====
* This script handles all system-related stuff, like lid, low-power, usb or wifi.
* This should run as root
 
Usage:
{| class="wikitable"
|-
! Command !! What's done
|-
| /usr/sbin/pdcmd LCDBright + || Increase the light of the lid
|-
| /usr/sbin/pdcmd LCDBright - || Decrease the light of the lid
|-
| /usr/sbin/pdcmd LCDBright 10 || Set the Brightness of the lid to 10
|-
| /usr/sbin/pdcmd LCDTrigger || Trigger the lid ( WARNING: THIS DISABLES THE LID ! )
|-
| /usr/sbin/pdcmd USBNetTrigger || Enable the USB-Networking (module g_ether). If usbnetworking is on, it will disable it
|-
| /usr/sbin/pdcmd USBHostTrigger || Enable the USB-Host (module ehci-hcd). If USB-Host is on, it will disable it
|-
| /usr/sbin/pdcmd WLANTrigger || Enable Wifi. If Wifi is enabled it will be disabled
|}

==== Several tweaks ====
===== Fixing broken keyboard layout =====
If your Pandian has a German keyboard layout, you might have some trouble because it does absolutely not fit US layout on the Pandora.
There is a work around this isse.

*Make sure, the file .pndXmodmap is read in on startup. Open the file ''.xsessionrc'' in your ''home'' directory and, if not existent, add following lines at the bottom of the file
setxkbmap en_US
xmodmap /home/yourUsername/.pndXmodmap
*There must be the absolute path (no "~/").

===== Making the Pandora Button work like the Windows key =====
Many users complained, their Pandora Button has no function in Pandian. This can be changed by mapping the button as ''"mod4"''.

*Insert in the last line of the .pndXmodmap from your ''home'' directory:
add mod4 = XF86MenuKB

===== Openbox =====
Pandian comes with an unconfigured Openbox as a possible session. Here are some config templates.

====== Use the Pandora key to start the menu ======
*If not existent,
cp /etc/xdg/openbox/rc.xml /home/yourUserName/.config/openbox/
* Open the rc.xml with a text editor and search for the section <keyboard>.
* Insert the new keybind:
<keybind key="XF86MenuKB">
<action name="ShowMenu">
<menu>root-menu</menu>
</action>
</keybind>

===== Intuitive Openbox configuration template =====
Prerequisites:
*mapped 'Pandora key' as 'Windows key'(see above)
*optional: use tint2 as panel

Features:
*Changing window by '''[Ctrl] + [up]/[down]'''
*Changing workspace by '''[Ctrl] + [left]/[right]'''
*Closing window by '''[Ctrl] + [Q]'''
*Screenshot (window): '''[Ctrl] + [Shift] + [Alt] + [F11]'''
*Screenshot (whole desktop): '''[Ctrl] + [Shift] + [Alt] + [F12]'''
*and some more

'''Download:'''
[https://www.dropbox.com/s/ud0muusrxq9g9va/rc.xml rc.xml]

===== Intuitive Openbox menu template =====
Features:
*Most important programms in root menu
*menu entries for WLAN, USB host and low power mode
'''Download:'''
[https://www.dropbox.com/s/fqjxg5xoymg5fep/menu.xml menu.xml]

== Mounting internal NAND to /mnt ==

Pandora internal NAND exposes a raw flash interfaces. For such devices, the
Linux kernel exposes a special MTD abstraction and "mtd aware" filesystems may
give a better performance. Pandora uses UBIFS, which needs UBI volume
management to work.

# Install mtd-utils
# Run the following commands

<syntaxhighlight lang="bash">
# Attach mtd device 4 to UBI volume management 0
ubiattach -m 4 -d 0
# Mount first partition of the UBI group 0 to /mnt
mount -t ubifs /dev/ubi0_0 /mnt
# Attach mtd device 3 to UBI volume management 1
ubiattach -m 3 -d 1
# Mount first partition of the UBI group 1 to /mnt
mount -t ubifs /dev/ubi1_0 /mnt/boot
</syntaxhighlight>

== Old releases ==

=== Mark2 minimal-hf2014-01-02 ===

{| class="wikitable"
|-
! Version !! Description !! Included !! Link !! Checksums (sha256)
|-
| minimal || pandian without any Desktop environment but with the basic pandian package || nano || [http://www.filedropper.com/pandian-mark2-minimal-hf2014-01-02 filedropper: pandian-mark2-minimal-hf2014-01-02] [http://pandian.openpandora.org/releases/pandian-mark2-minimal-hf_2014-01-02.7z pandian.openpandora.org: pandian-mark2-minimal-hf_2014-01-02.7z] || pandian-mark2-minimal-hf_2014-01-02.'''7z'''↓ a35106473e54c55d64c7eae2088d8c267b605baf17d5338b8e2938dbfe3c01ca pandian-mark2-minimal-hf_2014-01-02.'''img'''↓ c68a42c1aef0238c1dd6ff33b628a2c0dea812a7b5b2d906afb185f93f940f84
|-
| minimal-networking fix|| HotFix for pandian-mark2-minimal-hf_2014-01-02 [[#Network_Fix_for_pandian-minimal|Instructions]] || dhcp, network manager || [http://www.filedropper.com/pandian-mark2-minimal-networking2014-01-02tar filedropper: pandian-mark2-minimal-networking_2014-01-02.tar.gz] [http://pandian.openpandora.org/releases/pandian-mark2-minimal-networking_2014-01-02.tar.gz pandian.openpandora.org: pandian-mark2-minimal-networking_2014-01-02.tar.gz] ||pandian-mark2-minimal-networking_2014-01-02.'''tar.gz'''↓ 4cf802391360e5bf183e9d4b5fe8b6f407b3e476baec7b5b0aa7340796680ae6
|}

===== Network Fix for pandian-minimal =====
If you download the '''pandian-mark2-minimal-hf_2014-01-02''' image there is a lack of tools for setup wifi networking. 
'''Note: For the actual download of pandian-minimal, wifi-network-tools are included'''
* Therefore download the fix and place it on the SD-Card where pandian is installed. (you need to have local superuser privileges on your own system as the SD contents aren't owned by your user)
* Boot pandian-minimal
* login with user: "root"
* switch to root-directory: "cd /"
* untar the network-fix: "tar -xf /path-where-file-is-located/pandian-mark2-minimal-networking_2014-01-03.tar.gz"
* setup the fix with command "pdMinimalNetwork"

* after the script is finished, run "ceni" and setup your wifi-connection

=== 01 ===
'''Full debian GNU/Linux 7.2 codename Wheezy (stable) with LXDE desktop environment 
hardfloat armv7l released Date: 29.09.2013'''
[http://boards.openpandora.org/topic/14482-pandian-01/ forum link]
===Features===

* Hard-Float-ABI
* Ext4 Root for better performance
* Working Touch-Screen
* Working Nubs
* Screen-Off on LID-Close
* Low-Power-Mode
* WLAN
* Music ( with Sonata/MPD )
* Automount

=== Upcoming/Ideas ===

* Assistant for tzdata
* libpnd - PND-Support
* OpenGL not tested yet
* Aptitude
* Minimal-Network-Installation
* Pandian-Debian-Repository for special packages ( libpnd, touch-screen-calibrator )
* of course, in-system-documentation ( Documentation on the pandora )

Download [http://www.share-online.biz/dl/TPMFFXTM2AU here]

[http://boards.openpandora.org/topic/14482-pandian-01 Forum thread]

=== Installation ===

note: It is assumed here, that the card-reader load the card as /dev/sdc.
Please check before which device is your SD-card !
This can be checked with gparted. Minimum requirement 2GB SD-card.

# Download Image ( as 7z )
# Verify md5-checksum: pandian-stable-hf_2013-09-29.001.7z '''2a85bbb40bbe7c6e8f92f058e150951a''' pandian-stable-hf_2013-09-29.001.img '''e62d101dc708de49af1ca7743e2df2bd'''
# Unzip with 7z ( in Linux with 7zr e <image.7z> )
# Copy image to SD-Card ( dd if=<image.img> of=/dev/sdx ) Don't specify "bs="

Username: ''Pandian'' 
Root password: ''Root'' (change after intsallation as per instructions below)

#Open a terminal
#Type "su"
#Type "passwd"
#Enter your new root password when prompted, and then again to confirm.
#Dont forget your password

=== Resize ===
Default installation is limited to 2GB, if you want to expand it, you can, provided you have installed it on a bigger SD-card and want to make use of the space.

* Size will be changed with parted
* parted /dev/sdx
* show size with "print free"

# (parted) print free # Model: USB Mass Storage Device (scsi)
# Disk /dev/sdc: 7965MB# Sector size (logical/physical): 512B/512B# Partition Table: msdos

{| class="wikitable"
|-
| Number || Start || End || Size || Type || File system || Flags
|-
| || 32,3kB || 1049kB || 1016kB || || Free Space ||
|-
| 1 || 1049kB || 53,5MB || 52,4MB || primary || fat32 ||
|-
| 2 || 53,5MB || 1933MB || 1879MB || primary || ext4 ||
|-
| || 1933MB || 7965MB || 6032MB || || Free Space ||
|}

we would like to resize the second partition to the nearly end ( -512MB for swap )
# (parted) resizepart # Partition number? 2 # Warning: Partition /dev/sdc2 is being used. Are you sure you want to continue?# Yes/No? YES # End? [1933MB]? 7453MB this is how the partitions looks like after

(parted) print free * Model: USB Mass Storage Device (scsi)* Disk /dev/sdc: 7965MB* Sector size (logical/physical): 512B/512B* Partition Table: msdos

{| class="wikitable"
|-
| Number || Start || End || Size || Type || File system || Flags
|-
| || 32,3kB || 1049kB || 1016kB || || Free Space ||
|-
| 1 || 1049kB || 53,5MB || 52,4MB || primary || fat32 ||
|-
| 2 || 53,5MB || '''7453'''MB || '''7400'''MB || primary || ext4 ||
|-
| || '''7453'''MB || 7965MB || '''512'''MB || || Free Space ||
|}

create Swap (optional)

(parted) mkpart primary linux-swap
Start? 7453MB
End? 7965MB

this is how the partitions looks like after

(parted) print free * Model: USB Mass Storage Device (scsi)* Disk /dev/sdc: 7965MB* Sector size (logical/physical): 512B/512B* Partition Table: msdos

{| class="wikitable"
|-
| Number || Start || End || Size || Type || File system || Flags
|-
| || 32,3kB || 1049kB || 1016kB || || Free Space ||
|-
| 1 || 1049kB || 53,5MB || 52,4MB || primary || fat32 ||
|-
| 2 || 53,5MB || 7453MB || 7400MB || primary || ext4 ||
|-
| || '''7453MB''' || '''7453MB''' || '''278kB''' || || '''Free Space'''||
|-
| || 7453MB || 7965MB || 512MB || '''primary''' || Free Space ||
|}
disregard the 4th entry, the new resized partition is the last one.

resize filesystem
*resize2fs /dev/sdc2

create swap

*mkswap /dev/sdc3

[[Category:Documentation]]
[[Category:Operating system]]
[[Category:Software]]

Pandian

2014-03-22T11:05:05Z

Stackshadow: /* Upgrade Warnings */ Fix toc

[[File:Post-3032-0-90501200-1380479048.png|thumbnail|Logo]]

'''Pandian is an debian-based armhf desktop and CLI distro for your Pandora.'''
Ideas, Bugs, or feature-requests? Report to:
http://www.evilbrain.de/projects/pandian/issues

=== Main Features ===
* The debian way.
* Access to all packages from Debian software repositories.
* Pandian hosts its own Debian repo http://pandian.openpandora.org with up to date scripts, all settings and extra programs.
* armhf-build, which means '''f'''loat operations are relegated to special '''h'''ardware rather than taxing the main cpu with them (as with softfloat)

== '''Pandian''' - '''MARK 2''' The newest release ==
Second version of Pandian 
'''Full Debian GNU/Linux based on sid branch with LXDE desktop environment (normal) or CLI (minimal-) build.''' 
'''hardfloat armv7l''' yule release '''Date: 29.12.2013'''
[http://boards.openpandora.org/topic/15302-pandian-mark2/ forum link]

=== '''Installation''' requirements===
* '''Pandora''' ;) All versions fine?
* '''SD card''' minimum 2GB ( was tested with 4GB )
* '''PC''' Linux|GNU, BSD, Mac, or Windows for putting the install on the aforementioned SD-card.

==== '''Download''' a version of Pandian ====
There are two different versions of the "MARK2" release:
{| class="wikitable"
|-
! Version !! Description !! Includes !! Link !! Size !! Checksums (sha256)
|-
| '''base''' || pandian for advanced users, without any Desktop environment but with basic network-tools ( iw, ceni ) || ceni ( network-manager) network-manager MediaPlayer ( mpd ) iw (wireless-tools) || [http://www.filedropper.com/pandian-mark2-base-hf2014-01-05 filedropper: pandian-mark2-base-hf2014-01-05.7z] [http://pandian.openpandora.org/releases/pandian-mark2-base-hf_2014-01-05.7z pandian.openpandora.org: pandian-mark2-base-hf_2014-01-05.7z] || 161MB || pandian-mark2-base-hf_2014-01-05.'''7z'''↓ b11ffe9cc4fd6111775d0b48c133b1e1afcf6865de784b9865db0cea29674d85 pandian-mark2-base-hf_2014-01-05.'''img'''↓ c1903423a5b5e0d04563f14526e8161fbe77a102e64d5d571bcf3b87870fa211
|-
| '''normal''' || pandian for regular users, with full Desktop environment (LXDE) || network-manager MediaPlayer ( mpd with gurlp ) nub-support calibrator-application medit Text editor. mpd audio player backend, glurp as frontend || [http://www.filedropper.com/pandian-mark2-hf2014-01-02 filedropper: pandian-mark2-hf2014-01-02] [http://pandian.openpandora.org/releases/pandian-mark2-hf_2014-01-02.7z pandian.openpandora.org: pandian-mark2-hf_2014-01-02.7z] || 394MB || pandian-mark2-hf_2014-01-02.'''7z'''↓ 3731d70a4d8ec59e79a046f34f69c5c809be73e38cfc91a5b580478b8f8c222f pandian-mark2-hf_2014-01-02.'''img'''↓ 83b8d3fa5bd0588cfb8b11cfe6b827819e6311e98396a6e32c46c9692f072e96
|}
Notes:
* It is trivial to change from LXDE to [[Xfce]] (or any other desktop environment), adding a new user interface atop the minimal install is more advanced as manual setup of USB-Networking or wifi is needed to do so.
* All images have automount ( for USB-Sticks, external Hard-Drives etc. ) and ALSA sound support

==== '''Verify''' that your download is OK ====
* After you download the version you picked, verify its checksum to make sure the integrity of the downloaded file matches (in being an exact copy the one on the server)

#open up a terminal
# "'''sha256sum ~/downloads/pandian/<image.7Z>'''" (input where you have the file and the one you chose to download)
# make sure it matches the given md5sum, if not, try to download another copy. This step isnt mandatory, but its there to make sure everything is fine before we proceed.

==== '''Unzip''' the downloaded image ====
*Unzipping 7z archives
# Open up a terminal (or do it your way)
# Enter"'''7zr e <image.7z>'''"
# You now have an unzipped image

==== (Optional) '''Preparation''', find out where to install ====

This step helps you find out where the SD card is mounted. 

If you have an build in SD-Card-Reader this is normally /dev/mmcblk0p1 ( in Debian )
If you have an USB-Card-Reader this is something like /dev/sdc ( in Debian )
* Open an Terminal and input "'''lsblk'''"
* You will get a list with the actual Block-Devices
* The SD-Card should be of type 'disk'

You can also try gparted to see which devices you have and identify the SD-card from there

==== '''Install''' the image to the SD-Card ====
{{warning
| Warning, this will destroy everything on the device ! So please be very sure which device is you SD-Card !
}}
# Here it will be /dev/sd'''x'''

(note that the x after the sd is the drive letter, it could be ''sd'''b''''' sd'''c''''' or ''sd'''d''''' and so on, lets say its sd'''c'''. Which means c is the drive letter for the SD-card and that sd- a and -b are in use for other things. 
 
When writing to the device, make sure not to include the following number, which is the partition ''sdc'''1''''' ''sdc'''2''''' etc. since we are using the base card here) 
 
This means considerations for partitions and filesystem are taken care of, so no need to worry about that. Do ''not'' pick the wrong drive however, since dd will happily write the image to somewhere it isn't supposed to if you just give it root privileges and hit enter.) 
 
#Copy image to SD-Card with "'''dd if=<image.img> of=/dev/sdx'''"

You now have Pandian installed on your SD card and its ready to go. :) However after copying the image to the SD-Card resizing the partitionspartitions is needed to fully utilize the space, since by default the install is limited to 2GB. (If your card is bigger Pandian is still limited to those 2GB)

====(Optional) '''Resize''' SD-Card ====

* This can be done with gparted on linux|gnu
* start gparted

[[File:Gparted resize 001.png|800px|thumbnail|none|The actual partitions of the SD-CARD. Please select the correct device at the top right corner.]]
[[File:Gparted resize 002.png|800px|thumbnail|none|Rightclick to the second partition and select Resize/Move]]
[[File:Gparted resize 003.png|400px|thumbnail|none|You see the actual Size of this partition]]
[[File:Gparted resize 004.png|400px|thumbnail|none|Move the slider to the right, or set "Free space following" to 0]]
[[File:Gparted resize 005.png|800px|thumbnail|none|After you press the "Resize/Move" button, you get the preview of the new partition structure]]
[[File:Gparted resize 006.png|800px|thumbnail|none|When you press "Apply all operations", youve got a warning that you can loss your Data. THIS IS THE LAST CHANGE TO CHECK IF YOU SELECTED THE CORRECT DEVICE.

 Press Apply if everything is correct.]]

* After everything is fine, you have a fresh install of Pandian on you SD-Card
 

=== '''Startup''' wizard ===
* Upon first boot of Pandian, there is a first-start-wizard which guides you through some basic settings.
These are: Locale, timezone, time and date, password for admin and user setup and finally calibration of the touchscreen.
The script is located in /usr/sbin/pdSetup should you need to run it again.

==== Navigation ====
* Inside a dialog you can navigate with the cross/dpad
* Hit space to select a checkbox
* Moving between <Ok> and <Cancel> can be down with the use of TAB ( Tap Fn then tap Space )
* Acknowledge with Enter

*All done, enjoy :)

[[File:PandianDesktop.png|frameless]]

=== '''Network''' connection instructions:===

====normal ====
* Use network-manager

====minimal====
* Use ceni network manager

===(Optional) '''Update''' of Pandian system ===
* After you setup your Pandora, it is useful to update your system. It is a rolling release, which means since the image was made, the system is forever updated with new packages.
* open a terminal
* get root ( command is: "su" )
* enter "apt-get update" to download package information from the repositories
* enter "apt-get upgrade" to update all packages that are out of date
(pandian packages are also updated this way :)
* Note: to update only the pandian-packages enter "apt-get upgrade pandian*"

==== '''Upgrade Warnings''' ====
* if mpd is running, upgrade will fail. How to fix this:
** Open an terminal
** Login as root ( command "su" )
** Enter root password
** stop mpd with: /etc/init.d/mpd stop
** upgrade again: apt-get dist-upgrade

==== Upgrade from "minimal" to "normal" ====
It is possible to upgrade from the "minimal"-image to the "normal"-image.
This can simlpy be done by installing the pandian-lxde debian package
* get an connection to the internet(tm) with ceni
* open an terminal
* get root ( with command: "su" )
* update package list with: "apt-get update"
* install pandian-lxde with "apt-get install pandian-lxde"
* after everything is finished login with the user you setup before
* open an terminal
* get root ( with command: "su" )
* load keymap with "xmodmap /etc/skel/.pndXmodmap"
* the easiest way is to activate the first-start-wizard with "insserv firstuse"
* reboot and go through the wizard

===(Optional) '''Information''' ===

=== Additional Users/Groups ===
There are additional Users/Groups added to the standard debian-users
==== Groups ====
* admin
:This superuser privilege is used by sudo for admin task like shutdown etc.
* mpd
:This user/group has access to mpd-related files ( socket, pid-files )

==== Power-Modes ====
===== LID-Close =====
* If the lid is closed only the screen will be disabled
===== Low-Power-Mode / Shutdown =====
[[File:Lead Photo For Power modes0-2920264867079787.jpg|thumbnail|right|Switch]]
* Switch to left: Pandora will go to low power mode ( reduce CPU, Disable LID, Pause processes )
* Switch to right: Shutdown the pandora

==== pdcmd ====
* This script handles all system-related stuff, like lid, low-power, usb or wifi.
* This should run as root
 
Usage:
{| class="wikitable"
|-
! Command !! What's done
|-
| /usr/sbin/pdcmd LCDBright + || Increase the light of the lid
|-
| /usr/sbin/pdcmd LCDBright - || Decrease the light of the lid
|-
| /usr/sbin/pdcmd LCDBright 10 || Set the Brightness of the lid to 10
|-
| /usr/sbin/pdcmd LCDTrigger || Trigger the lid ( WARNING: THIS DISABLES THE LID ! )
|-
| /usr/sbin/pdcmd USBNetTrigger || Enable the USB-Networking (module g_ether). If usbnetworking is on, it will disable it
|-
| /usr/sbin/pdcmd USBHostTrigger || Enable the USB-Host (module ehci-hcd). If USB-Host is on, it will disable it
|-
| /usr/sbin/pdcmd WLANTrigger || Enable Wifi. If Wifi is enabled it will be disabled
|}

==== Several tweaks ====
===== Fixing broken keyboard layout =====
If your Pandian has a German keyboard layout, you might have some trouble because it does absolutely not fit US layout on the Pandora.
There is a work around this isse.

*Make sure, the file .pndXmodmap is read in on startup. Open the file ''.xsessionrc'' in your ''home'' directory and, if not existent, add following lines at the bottom of the file
setxkbmap en_US
xmodmap /home/yourUsername/.pndXmodmap
*There must be the absolute path (no "~/").

===== Making the Pandora Button work like the Windows key =====
Many users complained, their Pandora Button has no function in Pandian. This can be changed by mapping the button as ''"mod4"''.

*Insert in the last line of the .pndXmodmap from your ''home'' directory:
add mod4 = XF86MenuKB

===== Openbox =====
Pandian comes with an unconfigured Openbox as a possible session. Here are some config templates.

====== Use the Pandora key to start the menu ======
*If not existent,
cp /etc/xdg/openbox/rc.xml /home/yourUserName/.config/openbox/
* Open the rc.xml with a text editor and search for the section <keyboard>.
* Insert the new keybind:
<keybind key="XF86MenuKB">
<action name="ShowMenu">
<menu>root-menu</menu>
</action>
</keybind>

===== Intuitive Openbox configuration template =====
Prerequisites:
*mapped 'Pandora key' as 'Windows key'(see above)
*optional: use tint2 as panel

Features:
*Changing window by '''[Ctrl] + [up]/[down]'''
*Changing workspace by '''[Ctrl] + [left]/[right]'''
*Closing window by '''[Ctrl] + [Q]'''
*Screenshot (window): '''[Ctrl] + [Shift] + [Alt] + [F11]'''
*Screenshot (whole desktop): '''[Ctrl] + [Shift] + [Alt] + [F12]'''
*and some more

'''Download:'''
[https://www.dropbox.com/s/ud0muusrxq9g9va/rc.xml rc.xml]

===== Intuitive Openbox menu template =====
Features:
*Most important programms in root menu
*menu entries for WLAN, USB host and low power mode
'''Download:'''
[https://www.dropbox.com/s/fqjxg5xoymg5fep/menu.xml menu.xml]

== Mounting internal NAND to /mnt ==

Pandora internal NAND exposes a raw flash interfaces. For such devices, the
Linux kernel exposes a special MTD abstraction and "mtd aware" filesystems may
give a better performance. Pandora uses UBIFS, which needs UBI volume
management to work.

# Install mtd-utils
# Run the following commands

<syntaxhighlight lang="bash">
# Attach mtd device 4 to UBI volume management 0
ubiattach -m 4 -d 0
# Mount first partition of the UBI group 0 to /mnt
mount -t ubifs /dev/ubi0_0 /mnt
# Attach mtd device 3 to UBI volume management 1
ubiattach -m 3 -d 1
# Mount first partition of the UBI group 1 to /mnt
mount -t ubifs /dev/ubi1_0 /mnt/boot
</syntaxhighlight>

== Old releases ==

=== Mark2 minimal-hf2014-01-02 ===

{| class="wikitable"
|-
! Version !! Description !! Included !! Link !! Checksums (sha256)
|-
| minimal || pandian without any Desktop environment but with the basic pandian package || nano || [http://www.filedropper.com/pandian-mark2-minimal-hf2014-01-02 filedropper: pandian-mark2-minimal-hf2014-01-02] [http://pandian.openpandora.org/releases/pandian-mark2-minimal-hf_2014-01-02.7z pandian.openpandora.org: pandian-mark2-minimal-hf_2014-01-02.7z] || pandian-mark2-minimal-hf_2014-01-02.'''7z'''↓ a35106473e54c55d64c7eae2088d8c267b605baf17d5338b8e2938dbfe3c01ca pandian-mark2-minimal-hf_2014-01-02.'''img'''↓ c68a42c1aef0238c1dd6ff33b628a2c0dea812a7b5b2d906afb185f93f940f84
|-
| minimal-networking fix|| HotFix for pandian-mark2-minimal-hf_2014-01-02 [[#Network_Fix_for_pandian-minimal|Instructions]] || dhcp, network manager || [http://www.filedropper.com/pandian-mark2-minimal-networking2014-01-02tar filedropper: pandian-mark2-minimal-networking_2014-01-02.tar.gz] [http://pandian.openpandora.org/releases/pandian-mark2-minimal-networking_2014-01-02.tar.gz pandian.openpandora.org: pandian-mark2-minimal-networking_2014-01-02.tar.gz] ||pandian-mark2-minimal-networking_2014-01-02.'''tar.gz'''↓ 4cf802391360e5bf183e9d4b5fe8b6f407b3e476baec7b5b0aa7340796680ae6
|}

===== Network Fix for pandian-minimal =====
If you download the '''pandian-mark2-minimal-hf_2014-01-02''' image there is a lack of tools for setup wifi networking. 
'''Note: For the actual download of pandian-minimal, wifi-network-tools are included'''
* Therefore download the fix and place it on the SD-Card where pandian is installed. (you need to have local superuser privileges on your own system as the SD contents aren't owned by your user)
* Boot pandian-minimal
* login with user: "root"
* switch to root-directory: "cd /"
* untar the network-fix: "tar -xf /path-where-file-is-located/pandian-mark2-minimal-networking_2014-01-03.tar.gz"
* setup the fix with command "pdMinimalNetwork"

* after the script is finished, run "ceni" and setup your wifi-connection

=== 01 ===
'''Full debian GNU/Linux 7.2 codename Wheezy (stable) with LXDE desktop environment 
hardfloat armv7l released Date: 29.09.2013'''
[http://boards.openpandora.org/topic/14482-pandian-01/ forum link]
===Features===

* Hard-Float-ABI
* Ext4 Root for better performance
* Working Touch-Screen
* Working Nubs
* Screen-Off on LID-Close
* Low-Power-Mode
* WLAN
* Music ( with Sonata/MPD )
* Automount

=== Upcoming/Ideas ===

* Assistant for tzdata
* libpnd - PND-Support
* OpenGL not tested yet
* Aptitude
* Minimal-Network-Installation
* Pandian-Debian-Repository for special packages ( libpnd, touch-screen-calibrator )
* of course, in-system-documentation ( Documentation on the pandora )

Download [http://www.share-online.biz/dl/TPMFFXTM2AU here]

[http://boards.openpandora.org/topic/14482-pandian-01 Forum thread]

=== Installation ===

note: It is assumed here, that the card-reader load the card as /dev/sdc.
Please check before which device is your SD-card !
This can be checked with gparted. Minimum requirement 2GB SD-card.

# Download Image ( as 7z )
# Verify md5-checksum: pandian-stable-hf_2013-09-29.001.7z '''2a85bbb40bbe7c6e8f92f058e150951a''' pandian-stable-hf_2013-09-29.001.img '''e62d101dc708de49af1ca7743e2df2bd'''
# Unzip with 7z ( in Linux with 7zr e <image.7z> )
# Copy image to SD-Card ( dd if=<image.img> of=/dev/sdx ) Don't specify "bs="

Username: ''Pandian'' 
Root password: ''Root'' (change after intsallation as per instructions below)

#Open a terminal
#Type "su"
#Type "passwd"
#Enter your new root password when prompted, and then again to confirm.
#Dont forget your password

=== Resize ===
Default installation is limited to 2GB, if you want to expand it, you can, provided you have installed it on a bigger SD-card and want to make use of the space.

* Size will be changed with parted
* parted /dev/sdx
* show size with "print free"

# (parted) print free # Model: USB Mass Storage Device (scsi)
# Disk /dev/sdc: 7965MB# Sector size (logical/physical): 512B/512B# Partition Table: msdos

{| class="wikitable"
|-
| Number || Start || End || Size || Type || File system || Flags
|-
| || 32,3kB || 1049kB || 1016kB || || Free Space ||
|-
| 1 || 1049kB || 53,5MB || 52,4MB || primary || fat32 ||
|-
| 2 || 53,5MB || 1933MB || 1879MB || primary || ext4 ||
|-
| || 1933MB || 7965MB || 6032MB || || Free Space ||
|}

we would like to resize the second partition to the nearly end ( -512MB for swap )
# (parted) resizepart # Partition number? 2 # Warning: Partition /dev/sdc2 is being used. Are you sure you want to continue?# Yes/No? YES # End? [1933MB]? 7453MB this is how the partitions looks like after

(parted) print free * Model: USB Mass Storage Device (scsi)* Disk /dev/sdc: 7965MB* Sector size (logical/physical): 512B/512B* Partition Table: msdos

{| class="wikitable"
|-
| Number || Start || End || Size || Type || File system || Flags
|-
| || 32,3kB || 1049kB || 1016kB || || Free Space ||
|-
| 1 || 1049kB || 53,5MB || 52,4MB || primary || fat32 ||
|-
| 2 || 53,5MB || '''7453'''MB || '''7400'''MB || primary || ext4 ||
|-
| || '''7453'''MB || 7965MB || '''512'''MB || || Free Space ||
|}

create Swap (optional)

(parted) mkpart primary linux-swap
Start? 7453MB
End? 7965MB

this is how the partitions looks like after

(parted) print free * Model: USB Mass Storage Device (scsi)* Disk /dev/sdc: 7965MB* Sector size (logical/physical): 512B/512B* Partition Table: msdos

{| class="wikitable"
|-
| Number || Start || End || Size || Type || File system || Flags
|-
| || 32,3kB || 1049kB || 1016kB || || Free Space ||
|-
| 1 || 1049kB || 53,5MB || 52,4MB || primary || fat32 ||
|-
| 2 || 53,5MB || 7453MB || 7400MB || primary || ext4 ||
|-
| || '''7453MB''' || '''7453MB''' || '''278kB''' || || '''Free Space'''||
|-
| || 7453MB || 7965MB || 512MB || '''primary''' || Free Space ||
|}
disregard the 4th entry, the new resized partition is the last one.

resize filesystem
*resize2fs /dev/sdc2

create swap

*mkswap /dev/sdc3

[[Category:Documentation]]
[[Category:Operating system]]
[[Category:Software]]

Pandian

2014-03-22T11:04:17Z

Stackshadow: Add upgrade warning for mpd

[[File:Post-3032-0-90501200-1380479048.png|thumbnail|Logo]]

'''Pandian is an debian-based armhf desktop and CLI distro for your Pandora.'''
Ideas, Bugs, or feature-requests? Report to:
http://www.evilbrain.de/projects/pandian/issues

=== Main Features ===
* The debian way.
* Access to all packages from Debian software repositories.
* Pandian hosts its own Debian repo http://pandian.openpandora.org with up to date scripts, all settings and extra programs.
* armhf-build, which means '''f'''loat operations are relegated to special '''h'''ardware rather than taxing the main cpu with them (as with softfloat)

== '''Pandian''' - '''MARK 2''' The newest release ==
Second version of Pandian 
'''Full Debian GNU/Linux based on sid branch with LXDE desktop environment (normal) or CLI (minimal-) build.''' 
'''hardfloat armv7l''' yule release '''Date: 29.12.2013'''
[http://boards.openpandora.org/topic/15302-pandian-mark2/ forum link]

=== '''Installation''' requirements===
* '''Pandora''' ;) All versions fine?
* '''SD card''' minimum 2GB ( was tested with 4GB )
* '''PC''' Linux|GNU, BSD, Mac, or Windows for putting the install on the aforementioned SD-card.

==== '''Download''' a version of Pandian ====
There are two different versions of the "MARK2" release:
{| class="wikitable"
|-
! Version !! Description !! Includes !! Link !! Size !! Checksums (sha256)
|-
| '''base''' || pandian for advanced users, without any Desktop environment but with basic network-tools ( iw, ceni ) || ceni ( network-manager) network-manager MediaPlayer ( mpd ) iw (wireless-tools) || [http://www.filedropper.com/pandian-mark2-base-hf2014-01-05 filedropper: pandian-mark2-base-hf2014-01-05.7z] [http://pandian.openpandora.org/releases/pandian-mark2-base-hf_2014-01-05.7z pandian.openpandora.org: pandian-mark2-base-hf_2014-01-05.7z] || 161MB || pandian-mark2-base-hf_2014-01-05.'''7z'''↓ b11ffe9cc4fd6111775d0b48c133b1e1afcf6865de784b9865db0cea29674d85 pandian-mark2-base-hf_2014-01-05.'''img'''↓ c1903423a5b5e0d04563f14526e8161fbe77a102e64d5d571bcf3b87870fa211
|-
| '''normal''' || pandian for regular users, with full Desktop environment (LXDE) || network-manager MediaPlayer ( mpd with gurlp ) nub-support calibrator-application medit Text editor. mpd audio player backend, glurp as frontend || [http://www.filedropper.com/pandian-mark2-hf2014-01-02 filedropper: pandian-mark2-hf2014-01-02] [http://pandian.openpandora.org/releases/pandian-mark2-hf_2014-01-02.7z pandian.openpandora.org: pandian-mark2-hf_2014-01-02.7z] || 394MB || pandian-mark2-hf_2014-01-02.'''7z'''↓ 3731d70a4d8ec59e79a046f34f69c5c809be73e38cfc91a5b580478b8f8c222f pandian-mark2-hf_2014-01-02.'''img'''↓ 83b8d3fa5bd0588cfb8b11cfe6b827819e6311e98396a6e32c46c9692f072e96
|}
Notes:
* It is trivial to change from LXDE to [[Xfce]] (or any other desktop environment), adding a new user interface atop the minimal install is more advanced as manual setup of USB-Networking or wifi is needed to do so.
* All images have automount ( for USB-Sticks, external Hard-Drives etc. ) and ALSA sound support

==== '''Verify''' that your download is OK ====
* After you download the version you picked, verify its checksum to make sure the integrity of the downloaded file matches (in being an exact copy the one on the server)

#open up a terminal
# "'''sha256sum ~/downloads/pandian/<image.7Z>'''" (input where you have the file and the one you chose to download)
# make sure it matches the given md5sum, if not, try to download another copy. This step isnt mandatory, but its there to make sure everything is fine before we proceed.

==== '''Unzip''' the downloaded image ====
*Unzipping 7z archives
# Open up a terminal (or do it your way)
# Enter"'''7zr e <image.7z>'''"
# You now have an unzipped image

==== (Optional) '''Preparation''', find out where to install ====

This step helps you find out where the SD card is mounted. 

If you have an build in SD-Card-Reader this is normally /dev/mmcblk0p1 ( in Debian )
If you have an USB-Card-Reader this is something like /dev/sdc ( in Debian )
* Open an Terminal and input "'''lsblk'''"
* You will get a list with the actual Block-Devices
* The SD-Card should be of type 'disk'

You can also try gparted to see which devices you have and identify the SD-card from there

==== '''Install''' the image to the SD-Card ====
{{warning
| Warning, this will destroy everything on the device ! So please be very sure which device is you SD-Card !
}}
# Here it will be /dev/sd'''x'''

(note that the x after the sd is the drive letter, it could be ''sd'''b''''' sd'''c''''' or ''sd'''d''''' and so on, lets say its sd'''c'''. Which means c is the drive letter for the SD-card and that sd- a and -b are in use for other things. 
 
When writing to the device, make sure not to include the following number, which is the partition ''sdc'''1''''' ''sdc'''2''''' etc. since we are using the base card here) 
 
This means considerations for partitions and filesystem are taken care of, so no need to worry about that. Do ''not'' pick the wrong drive however, since dd will happily write the image to somewhere it isn't supposed to if you just give it root privileges and hit enter.) 
 
#Copy image to SD-Card with "'''dd if=<image.img> of=/dev/sdx'''"

You now have Pandian installed on your SD card and its ready to go. :) However after copying the image to the SD-Card resizing the partitionspartitions is needed to fully utilize the space, since by default the install is limited to 2GB. (If your card is bigger Pandian is still limited to those 2GB)

====(Optional) '''Resize''' SD-Card ====

* This can be done with gparted on linux|gnu
* start gparted

[[File:Gparted resize 001.png|800px|thumbnail|none|The actual partitions of the SD-CARD. Please select the correct device at the top right corner.]]
[[File:Gparted resize 002.png|800px|thumbnail|none|Rightclick to the second partition and select Resize/Move]]
[[File:Gparted resize 003.png|400px|thumbnail|none|You see the actual Size of this partition]]
[[File:Gparted resize 004.png|400px|thumbnail|none|Move the slider to the right, or set "Free space following" to 0]]
[[File:Gparted resize 005.png|800px|thumbnail|none|After you press the "Resize/Move" button, you get the preview of the new partition structure]]
[[File:Gparted resize 006.png|800px|thumbnail|none|When you press "Apply all operations", youve got a warning that you can loss your Data. THIS IS THE LAST CHANGE TO CHECK IF YOU SELECTED THE CORRECT DEVICE.

 Press Apply if everything is correct.]]

* After everything is fine, you have a fresh install of Pandian on you SD-Card
 

=== '''Startup''' wizard ===
* Upon first boot of Pandian, there is a first-start-wizard which guides you through some basic settings.
These are: Locale, timezone, time and date, password for admin and user setup and finally calibration of the touchscreen.
The script is located in /usr/sbin/pdSetup should you need to run it again.

==== Navigation ====
* Inside a dialog you can navigate with the cross/dpad
* Hit space to select a checkbox
* Moving between <Ok> and <Cancel> can be down with the use of TAB ( Tap Fn then tap Space )
* Acknowledge with Enter

*All done, enjoy :)

[[File:PandianDesktop.png|frameless]]

=== '''Network''' connection instructions:===

====normal ====
* Use network-manager

====minimal====
* Use ceni network manager

===(Optional) '''Update''' of Pandian system ===
* After you setup your Pandora, it is useful to update your system. It is a rolling release, which means since the image was made, the system is forever updated with new packages.
* open a terminal
* get root ( command is: "su" )
* enter "apt-get update" to download package information from the repositories
* enter "apt-get upgrade" to update all packages that are out of date
(pandian packages are also updated this way :)
* Note: to update only the pandian-packages enter "apt-get upgrade pandian*"

==== '''Upgrade Warnings''' ====
* if mpd is running, upgrade will fail. How to fix this:
** Open an terminal
** Login as root ( command "su" )
** Enter root password
** stop mpd with: /etc/init.d/mpd stop
** upgrade again: apt-get dist-upgrade

===== Upgrade from "minimal" to "normal" =====
It is possible to upgrade from the "minimal"-image to the "normal"-image.
This can simlpy be done by installing the pandian-lxde debian package
* get an connection to the internet(tm) with ceni
* open an terminal
* get root ( with command: "su" )
* update package list with: "apt-get update"
* install pandian-lxde with "apt-get install pandian-lxde"
* after everything is finished login with the user you setup before
* open an terminal
* get root ( with command: "su" )
* load keymap with "xmodmap /etc/skel/.pndXmodmap"
* the easiest way is to activate the first-start-wizard with "insserv firstuse"
* reboot and go through the wizard

===(Optional) '''Information''' ===

=== Additional Users/Groups ===
There are additional Users/Groups added to the standard debian-users
==== Groups ====
* admin
:This superuser privilege is used by sudo for admin task like shutdown etc.
* mpd
:This user/group has access to mpd-related files ( socket, pid-files )

==== Power-Modes ====
===== LID-Close =====
* If the lid is closed only the screen will be disabled
===== Low-Power-Mode / Shutdown =====
[[File:Lead Photo For Power modes0-2920264867079787.jpg|thumbnail|right|Switch]]
* Switch to left: Pandora will go to low power mode ( reduce CPU, Disable LID, Pause processes )
* Switch to right: Shutdown the pandora

==== pdcmd ====
* This script handles all system-related stuff, like lid, low-power, usb or wifi.
* This should run as root
 
Usage:
{| class="wikitable"
|-
! Command !! What's done
|-
| /usr/sbin/pdcmd LCDBright + || Increase the light of the lid
|-
| /usr/sbin/pdcmd LCDBright - || Decrease the light of the lid
|-
| /usr/sbin/pdcmd LCDBright 10 || Set the Brightness of the lid to 10
|-
| /usr/sbin/pdcmd LCDTrigger || Trigger the lid ( WARNING: THIS DISABLES THE LID ! )
|-
| /usr/sbin/pdcmd USBNetTrigger || Enable the USB-Networking (module g_ether). If usbnetworking is on, it will disable it
|-
| /usr/sbin/pdcmd USBHostTrigger || Enable the USB-Host (module ehci-hcd). If USB-Host is on, it will disable it
|-
| /usr/sbin/pdcmd WLANTrigger || Enable Wifi. If Wifi is enabled it will be disabled
|}

==== Several tweaks ====
===== Fixing broken keyboard layout =====
If your Pandian has a German keyboard layout, you might have some trouble because it does absolutely not fit US layout on the Pandora.
There is a work around this isse.

*Make sure, the file .pndXmodmap is read in on startup. Open the file ''.xsessionrc'' in your ''home'' directory and, if not existent, add following lines at the bottom of the file
setxkbmap en_US
xmodmap /home/yourUsername/.pndXmodmap
*There must be the absolute path (no "~/").

===== Making the Pandora Button work like the Windows key =====
Many users complained, their Pandora Button has no function in Pandian. This can be changed by mapping the button as ''"mod4"''.

*Insert in the last line of the .pndXmodmap from your ''home'' directory:
add mod4 = XF86MenuKB

===== Openbox =====
Pandian comes with an unconfigured Openbox as a possible session. Here are some config templates.

====== Use the Pandora key to start the menu ======
*If not existent,
cp /etc/xdg/openbox/rc.xml /home/yourUserName/.config/openbox/
* Open the rc.xml with a text editor and search for the section <keyboard>.
* Insert the new keybind:
<keybind key="XF86MenuKB">
<action name="ShowMenu">
<menu>root-menu</menu>
</action>
</keybind>

===== Intuitive Openbox configuration template =====
Prerequisites:
*mapped 'Pandora key' as 'Windows key'(see above)
*optional: use tint2 as panel

Features:
*Changing window by '''[Ctrl] + [up]/[down]'''
*Changing workspace by '''[Ctrl] + [left]/[right]'''
*Closing window by '''[Ctrl] + [Q]'''
*Screenshot (window): '''[Ctrl] + [Shift] + [Alt] + [F11]'''
*Screenshot (whole desktop): '''[Ctrl] + [Shift] + [Alt] + [F12]'''
*and some more

'''Download:'''
[https://www.dropbox.com/s/ud0muusrxq9g9va/rc.xml rc.xml]

===== Intuitive Openbox menu template =====
Features:
*Most important programms in root menu
*menu entries for WLAN, USB host and low power mode
'''Download:'''
[https://www.dropbox.com/s/fqjxg5xoymg5fep/menu.xml menu.xml]

== Mounting internal NAND to /mnt ==

Pandora internal NAND exposes a raw flash interfaces. For such devices, the
Linux kernel exposes a special MTD abstraction and "mtd aware" filesystems may
give a better performance. Pandora uses UBIFS, which needs UBI volume
management to work.

# Install mtd-utils
# Run the following commands

<syntaxhighlight lang="bash">
# Attach mtd device 4 to UBI volume management 0
ubiattach -m 4 -d 0
# Mount first partition of the UBI group 0 to /mnt
mount -t ubifs /dev/ubi0_0 /mnt
# Attach mtd device 3 to UBI volume management 1
ubiattach -m 3 -d 1
# Mount first partition of the UBI group 1 to /mnt
mount -t ubifs /dev/ubi1_0 /mnt/boot
</syntaxhighlight>

== Old releases ==

=== Mark2 minimal-hf2014-01-02 ===

{| class="wikitable"
|-
! Version !! Description !! Included !! Link !! Checksums (sha256)
|-
| minimal || pandian without any Desktop environment but with the basic pandian package || nano || [http://www.filedropper.com/pandian-mark2-minimal-hf2014-01-02 filedropper: pandian-mark2-minimal-hf2014-01-02] [http://pandian.openpandora.org/releases/pandian-mark2-minimal-hf_2014-01-02.7z pandian.openpandora.org: pandian-mark2-minimal-hf_2014-01-02.7z] || pandian-mark2-minimal-hf_2014-01-02.'''7z'''↓ a35106473e54c55d64c7eae2088d8c267b605baf17d5338b8e2938dbfe3c01ca pandian-mark2-minimal-hf_2014-01-02.'''img'''↓ c68a42c1aef0238c1dd6ff33b628a2c0dea812a7b5b2d906afb185f93f940f84
|-
| minimal-networking fix|| HotFix for pandian-mark2-minimal-hf_2014-01-02 [[#Network_Fix_for_pandian-minimal|Instructions]] || dhcp, network manager || [http://www.filedropper.com/pandian-mark2-minimal-networking2014-01-02tar filedropper: pandian-mark2-minimal-networking_2014-01-02.tar.gz] [http://pandian.openpandora.org/releases/pandian-mark2-minimal-networking_2014-01-02.tar.gz pandian.openpandora.org: pandian-mark2-minimal-networking_2014-01-02.tar.gz] ||pandian-mark2-minimal-networking_2014-01-02.'''tar.gz'''↓ 4cf802391360e5bf183e9d4b5fe8b6f407b3e476baec7b5b0aa7340796680ae6
|}

===== Network Fix for pandian-minimal =====
If you download the '''pandian-mark2-minimal-hf_2014-01-02''' image there is a lack of tools for setup wifi networking. 
'''Note: For the actual download of pandian-minimal, wifi-network-tools are included'''
* Therefore download the fix and place it on the SD-Card where pandian is installed. (you need to have local superuser privileges on your own system as the SD contents aren't owned by your user)
* Boot pandian-minimal
* login with user: "root"
* switch to root-directory: "cd /"
* untar the network-fix: "tar -xf /path-where-file-is-located/pandian-mark2-minimal-networking_2014-01-03.tar.gz"
* setup the fix with command "pdMinimalNetwork"

* after the script is finished, run "ceni" and setup your wifi-connection

=== 01 ===
'''Full debian GNU/Linux 7.2 codename Wheezy (stable) with LXDE desktop environment 
hardfloat armv7l released Date: 29.09.2013'''
[http://boards.openpandora.org/topic/14482-pandian-01/ forum link]
===Features===

* Hard-Float-ABI
* Ext4 Root for better performance
* Working Touch-Screen
* Working Nubs
* Screen-Off on LID-Close
* Low-Power-Mode
* WLAN
* Music ( with Sonata/MPD )
* Automount

=== Upcoming/Ideas ===

* Assistant for tzdata
* libpnd - PND-Support
* OpenGL not tested yet
* Aptitude
* Minimal-Network-Installation
* Pandian-Debian-Repository for special packages ( libpnd, touch-screen-calibrator )
* of course, in-system-documentation ( Documentation on the pandora )

Download [http://www.share-online.biz/dl/TPMFFXTM2AU here]

[http://boards.openpandora.org/topic/14482-pandian-01 Forum thread]

=== Installation ===

note: It is assumed here, that the card-reader load the card as /dev/sdc.
Please check before which device is your SD-card !
This can be checked with gparted. Minimum requirement 2GB SD-card.

# Download Image ( as 7z )
# Verify md5-checksum: pandian-stable-hf_2013-09-29.001.7z '''2a85bbb40bbe7c6e8f92f058e150951a''' pandian-stable-hf_2013-09-29.001.img '''e62d101dc708de49af1ca7743e2df2bd'''
# Unzip with 7z ( in Linux with 7zr e <image.7z> )
# Copy image to SD-Card ( dd if=<image.img> of=/dev/sdx ) Don't specify "bs="

Username: ''Pandian'' 
Root password: ''Root'' (change after intsallation as per instructions below)

#Open a terminal
#Type "su"
#Type "passwd"
#Enter your new root password when prompted, and then again to confirm.
#Dont forget your password

=== Resize ===
Default installation is limited to 2GB, if you want to expand it, you can, provided you have installed it on a bigger SD-card and want to make use of the space.

* Size will be changed with parted
* parted /dev/sdx
* show size with "print free"

# (parted) print free # Model: USB Mass Storage Device (scsi)
# Disk /dev/sdc: 7965MB# Sector size (logical/physical): 512B/512B# Partition Table: msdos

{| class="wikitable"
|-
| Number || Start || End || Size || Type || File system || Flags
|-
| || 32,3kB || 1049kB || 1016kB || || Free Space ||
|-
| 1 || 1049kB || 53,5MB || 52,4MB || primary || fat32 ||
|-
| 2 || 53,5MB || 1933MB || 1879MB || primary || ext4 ||
|-
| || 1933MB || 7965MB || 6032MB || || Free Space ||
|}

we would like to resize the second partition to the nearly end ( -512MB for swap )
# (parted) resizepart # Partition number? 2 # Warning: Partition /dev/sdc2 is being used. Are you sure you want to continue?# Yes/No? YES # End? [1933MB]? 7453MB this is how the partitions looks like after

(parted) print free * Model: USB Mass Storage Device (scsi)* Disk /dev/sdc: 7965MB* Sector size (logical/physical): 512B/512B* Partition Table: msdos

{| class="wikitable"
|-
| Number || Start || End || Size || Type || File system || Flags
|-
| || 32,3kB || 1049kB || 1016kB || || Free Space ||
|-
| 1 || 1049kB || 53,5MB || 52,4MB || primary || fat32 ||
|-
| 2 || 53,5MB || '''7453'''MB || '''7400'''MB || primary || ext4 ||
|-
| || '''7453'''MB || 7965MB || '''512'''MB || || Free Space ||
|}

create Swap (optional)

(parted) mkpart primary linux-swap
Start? 7453MB
End? 7965MB

this is how the partitions looks like after

(parted) print free * Model: USB Mass Storage Device (scsi)* Disk /dev/sdc: 7965MB* Sector size (logical/physical): 512B/512B* Partition Table: msdos

{| class="wikitable"
|-
| Number || Start || End || Size || Type || File system || Flags
|-
| || 32,3kB || 1049kB || 1016kB || || Free Space ||
|-
| 1 || 1049kB || 53,5MB || 52,4MB || primary || fat32 ||
|-
| 2 || 53,5MB || 7453MB || 7400MB || primary || ext4 ||
|-
| || '''7453MB''' || '''7453MB''' || '''278kB''' || || '''Free Space'''||
|-
| || 7453MB || 7965MB || 512MB || '''primary''' || Free Space ||
|}
disregard the 4th entry, the new resized partition is the last one.

resize filesystem
*resize2fs /dev/sdc2

create swap

*mkswap /dev/sdc3

[[Category:Documentation]]
[[Category:Operating system]]
[[Category:Software]]

Pandian

2014-01-05T22:23:29Z

Stackshadow: /* Download a version of Pandian */ Add download link for pandian-base from filedropper

[[File:Post-3032-0-90501200-1380479048.png|thumbnail|Logo]]

'''Pandian is an debian-based armhf desktop and CLI distro for your Pandora.'''
Ideas, Bugs, or feature-requests? Report to:
http://www.evilbrain.de/projects/pandian/issues

=== Main Features ===
* The debian way.
* Access to all packages from Debian software repositories.
* Pandian hosts its own Debian repo http://pandian.openpandora.org with up to date scripts, all settings and extra programs.
* armhf-build, which means '''f'''loat operations are relegated to special '''h'''ardware rather than taxing the main cpu with them (as with softfloat)

== '''Pandian''' - '''MARK 2''' The newest release ==
Second version of Pandian 
'''Full Debian GNU/Linux based on sid branch with LXDE desktop environment (normal) or CLI (minimal-) build.''' 
'''hardfloat armv7l''' yule release '''Date: 29.12.2013'''
[http://boards.openpandora.org/topic/15302-pandian-mark2/ forum link]

=== '''Installation''' requirements===
* '''Pandora''' ;) All versions fine?
* '''SD card''' minimum 2GB ( was tested with 4GB )
* '''PC''' Linux|GNU, BSD, Mac, or Windows for putting the install on the aforementioned SD-card.

==== '''Download''' a version of Pandian ====
There are two different versions of the "MARK2" release:
{| class="wikitable"
|-
! Version !! Description !! Includes !! Link !! Checksums (sha256)
|-
| '''base''' || pandian for advanced users, without any Desktop environment but with basic network-tools ( iw, ceni ) || ceni ( network-manager) network-manager MediaPlayer ( mpd ) iw (wireless-tools) || [http://www.filedropper.com/pandian-mark2-base-hf2014-01-05 filedropper: pandian-mark2-base-hf2014-01-05.7z] [http://pandian.openpandora.org/releases/pandian-mark2-base-hf_2014-01-05.7z pandian.openpandora.org: pandian-mark2-base-hf_2014-01-05.7z] || pandian-mark2-base-hf_2014-01-05.7z b11ffe9cc4fd6111775d0b48c133b1e1afcf6865de784b9865db0cea29674d85 pandian-mark2-base-hf_2014-01-05.img c1903423a5b5e0d04563f14526e8161fbe77a102e64d5d571bcf3b87870fa211
|-
| '''normal''' || pandian for regular users, with full Desktop environment ( LXDE ) || network-manager MediaPlayer ( mpd with gurlp ) nub-support calibrator-application medit Text editor. mpd audio player backend, glurp as frontend || [http://www.filedropper.com/pandian-mark2-hf2014-01-02 filedropper: pandian-mark2-hf2014-01-02] [http://pandian.openpandora.org/releases/pandian-mark2-hf_2014-01-02.7z pandian.openpandora.org: pandian-mark2-hf_2014-01-02.7z] || pandian-mark2-hf_2014-01-02.7z 3731d70a4d8ec59e79a046f34f69c5c809be73e38cfc91a5b580478b8f8c222f pandian-mark2-hf_2014-01-02.img 83b8d3fa5bd0588cfb8b11cfe6b827819e6311e98396a6e32c46c9692f072e96
|}
Notes:
* It is trivial to change from LXDE to [[Xfce]] (or any other desktop environment), adding a new user interface atop the minimal install is more advanced as manual setup of USB-Networking or wifi is needed to do so.
* All images have automount ( for USB-Sticks, external Hard-Drives etc. ) and ALSA sound support

==== '''Verify''' that your download is OK ====
* After you download the version you picked, verify its checksum to make sure the integrity of the downloaded file matches (in being an exact copy the one on the server)

#open up a terminal
# "'''sha256sum ~/downloads/pandian/<image.7Z>'''" (input where you have the file and the one you chose to download)
# make sure it matches the given md5sum, if not, try to download another copy. This step isnt mandatory, but its there to make sure everything is fine before we proceed.

==== '''Unzip''' the downloaded image ====
*Unzipping 7z archives
# Open up a terminal (or do it your way)
# Enter"'''7zr e <image.7z>'''"
# You now have an unzipped image

==== (Optional) '''Preparation''', find out where to install ====

This step helps you find out where the SD card is mounted. 

If you have an build in SD-Card-Reader this is normally /dev/mmcblk0p1 ( in Debian )
If you have an USB-Card-Reader this is something like /dev/sdc ( in Debian )
* Open an Terminal and input "'''lsblk'''"
* You will get a list with the actual Block-Devices
* The SD-Card should be of type 'disk'

You can also try gparted to see which devices you have and identify the SD-card from there

==== '''Install''' the image to the SD-Card ====
{{warning
| Warning, this will destroy everything on the device ! So please be very sure which device is you SD-Card !
}}
# Here it will be /dev/sd'''x'''

(note that the x after the sd is the drive letter, it could be ''sd'''b''''' sd'''c''''' or ''sd'''d''''' and so on, lets say its sd'''c'''. Which means c is the drive letter for the SD-card and that sd- a and -b are in use for other things. 
 
When writing to the device, make sure not to include the following number, which is the partition ''sdc'''1''''' ''sdc'''2''''' etc. since we are using the base card here) 
 
This means considerations for partitions and filesystem are taken care of, so no need to worry about that. Do ''not'' pick the wrong drive however, since dd will happily write the image to somewhere it isn't supposed to if you just give it root privileges and hit enter.) 
 
#Copy image to SD-Card with "'''dd if=<image.img> of=/dev/sdx'''"

You now have Pandian installed on your SD card and its ready to go. :) However after copying the image to the SD-Card resizing the partitionspartitions is needed to fully utilize the space, since by default the install is limited to 2GB. (If your card is bigger Pandian is still limited to those 2GB)

====(Optional) '''Resize''' SD-Card ====

* This can be done with gparted on linux|gnu
* start gparted

[[File:Gparted resize 001.png|800px|thumbnail|none|The actual partitions of the SD-CARD. Please select the correct device at the top right corner.]]
[[File:Gparted resize 002.png|800px|thumbnail|none|Rightclick to the second partition and select Resize/Move]]
[[File:Gparted resize 003.png|400px|thumbnail|none|You see the actual Size of this partition]]
[[File:Gparted resize 004.png|400px|thumbnail|none|Move the slider to the right, or set "Free space following" to 0]]
[[File:Gparted resize 005.png|800px|thumbnail|none|After you press the "Resize/Move" button, you get the preview of the new partition structure]]
[[File:Gparted resize 006.png|800px|thumbnail|none|When you press "Apply all operations", youve got a warning that you can loss your Data. THIS IS THE LAST CHANGE TO CHECK IF YOU SELECTED THE CORRECT DEVICE.

 Press Apply if everything is correct.]]

* After everything is fine, you have a fresh install of Pandian on you SD-Card
 

=== '''Startup''' wizard ===
* Upon first boot of Pandian, there is a first-start-wizard which guides you through some basic settings.
These are: Locale, timezone, time and date, password for admin and user setup and finally calibration of the touchscreen.
The script is located in /usr/sbin/pdSetup should you need to run it again.

==== Navigation ====
* Inside a dialog you can navigate with the cross/dpad
* Hit space to select a checkbox
* Moving between <Ok> and <Cancel> can be down with the use of TAB ( Tap Fn then tap Space )
* Acknowledge with Enter

=== '''Network''' connection instructions:===

====normal ====
* Use network-manager

====minimal====
* Use ceni network manager

===(Optional) '''Update''' of Pandian system ===
* After you setup your Pandora, it is useful to update your system. It is a rolling release, which means since the image was made, the system is forever updated with new packages.
* open a terminal
* get root ( command is: "su" )
* enter "apt-get update" to download package information from the repositories
* enter "apt-get upgrade" to update all packages that are out of date
(pandian packages are also updated this way :)
* Note: to update only the pandian-packages enter "apt-get upgrade pandian*"

===== Upgrade from "minimal" to "normal" =====
It is possible to upgrade from the "minimal"-image to the "normal"-image.
This can simlpy be done by installing the pandian-lxde debian package
* get an connection to the internet(tm) with ceni
* open an terminal
* get root ( with command: "su" )
* update package list with: "apt-get update"
* install pandian-lxde with "apt-get install pandian-lxde"
* after everything is finished login with the user you setup before
* open an terminal
* get root ( with command: "su" )
* load keymap with "xmodmap /etc/skel/.pndXmodmap"
* the easiest way is to activate the first-start-wizard with "insserv firstuse"
* reboot and go through the wizard

===(Optional) '''Information''' ===

=== Additional Users/Groups ===
There are additional Users/Groups added to the standard debian-users
==== Groups ====
* admin
:This superuser privilege is used by sudo for admin task like shutdown etc.
* mpd
:This user/group has access to mpd-related files ( socket, pid-files )

==== Power-Modes ====
===== LID-Close =====
* If the lid is closed only the screen will be disabled
===== Low-Power-Mode / Shutdown =====
[[File:Lead Photo For Power modes0-2920264867079787.jpg|thumbnail|right|Switch]]
* Switch to left: Pandora will go to low power mode ( reduce CPU, Disable LID, Pause processes )
* Switch to right: Shutdown the pandora

==== pdcmd ====
* This script handles all system-related stuff, like lid, low-power, usb or wifi.
* This should run as root
 
Usage:
{| class="wikitable"
|-
! Command !! What's done
|-
| /usr/sbin/pdcmd LCDBright + || Increase the light of the lid
|-
| /usr/sbin/pdcmd LCDBright - || Decrease the light of the lid
|-
| /usr/sbin/pdcmd LCDBright 10 || Set the Brightness of the lid to 10
|-
| /usr/sbin/pdcmd LCDTrigger || Trigger the lid ( WARNING: THIS DISABLES THE LID ! )
|-
| /usr/sbin/pdcmd USBNetTrigger || Enable the USB-Networking (module g_ether). If usbnetworking is on, it will disable it
|-
| /usr/sbin/pdcmd USBHostTrigger || Enable the USB-Host (module ehci-hcd). If USB-Host is on, it will disable it
|-
| /usr/sbin/pdcmd WLANTrigger || Enable Wifi. If Wifi is enabled it will be disabled
|}

== Old releases ==

=== Mark2 minimal-hf2014-01-02 ===

{| class="wikitable"
|-
! Version !! Description !! Included !! Link !! Checksums (sha256)
|-
| minimal || pandian without any Desktop environment but with the basic pandian package || nano || [http://www.filedropper.com/pandian-mark2-minimal-hf2014-01-02 filedropper: pandian-mark2-minimal-hf2014-01-02] [http://pandian.openpandora.org/releases/pandian-mark2-minimal-hf_2014-01-02.7z pandian.openpandora.org: pandian-mark2-minimal-hf_2014-01-02.7z] || pandian-mark2-minimal-hf_2014-01-02.7z a35106473e54c55d64c7eae2088d8c267b605baf17d5338b8e2938dbfe3c01ca pandian-mark2-minimal-hf_2014-01-02.img c68a42c1aef0238c1dd6ff33b628a2c0dea812a7b5b2d906afb185f93f940f84
|-
| minimal-networking fix|| HotFix for pandian-mark2-minimal-hf_2014-01-02 [[#Network_Fix_for_pandian-minimal|Instructions]] || dhcp, network manager || [http://www.filedropper.com/pandian-mark2-minimal-networking2014-01-02tar filedropper: pandian-mark2-minimal-networking_2014-01-02.tar.gz] [http://pandian.openpandora.org/releases/pandian-mark2-minimal-networking_2014-01-02.tar.gz pandian.openpandora.org: pandian-mark2-minimal-networking_2014-01-02.tar.gz] || 4cf802391360e5bf183e9d4b5fe8b6f407b3e476baec7b5b0aa7340796680ae6 pandian-mark2-minimal-networking_2014-01-02.tar.gz
|}

===== Network Fix for pandian-minimal =====
If you download the '''pandian-mark2-minimal-hf_2014-01-02''' image there is a lack of tools for setup wifi networking. 
'''Note: For the actual download of pandian-minimal, wifi-network-tools are included'''
* Therefore download the fix and place it on the SD-Card where pandian is installed. (you need to have local superuser privileges on your own system as the SD contents aren't owned by your user)
* Boot pandian-minimal
* login with user: "root"
* switch to root-directory: "cd /"
* untar the network-fix: "tar -xf /path-where-file-is-located/pandian-mark2-minimal-networking_2014-01-03.tar.gz"
* setup the fix with command "pdMinimalNetwork"

* after the script is finished, run "ceni" and setup your wifi-connection

=== 01 ===
'''Full debian GNU/Linux 7.2 codename Wheezy (stable) with LXDE desktop environment 
hardfloat armv7l released Date: 29.09.2013'''
[http://boards.openpandora.org/topic/14482-pandian-01/ forum link]
===Features===

* Hard-Float-ABI
* Ext4 Root for better performance
* Working Touch-Screen
* Working Nubs
* Screen-Off on LID-Close
* Low-Power-Mode
* WLAN
* Music ( with Sonata/MPD )
* Automount

=== Upcoming/Ideas ===

* Assistant for tzdata
* libpnd - PND-Support
* OpenGL not tested yet
* Aptitude
* Minimal-Network-Installation
* Pandian-Debian-Repository for special packages ( libpnd, touch-screen-calibrator )
* of course, in-system-documentation ( Documentation on the pandora )

Download [http://www.share-online.biz/dl/TPMFFXTM2AU here]

[http://boards.openpandora.org/topic/14482-pandian-01 Forum thread]

=== Installation ===

note: It is assumed here, that the card-reader load the card as /dev/sdc.
Please check before which device is your SD-card !
This can be checked with gparted. Minimum requirement 2GB SD-card.

# Download Image ( as 7z )
# Verify md5-checksum: pandian-stable-hf_2013-09-29.001.7z '''2a85bbb40bbe7c6e8f92f058e150951a''' pandian-stable-hf_2013-09-29.001.img '''e62d101dc708de49af1ca7743e2df2bd'''
# Unzip with 7z ( in Linux with 7zr e <image.7z> )
# Copy image to SD-Card ( dd if=<image.img> of=/dev/sdx ) Don't specify "bs="

Username: ''Pandian'' 
Root password: ''Root'' (change after intsallation as per instructions below)

#Open a terminal
#Type "su"
#Type "passwd"
#Enter your new root password when prompted, and then again to confirm.
#Dont forget your password

=== Resize ===
Default installation is limited to 2GB, if you want to expand it, you can, provided you have installed it on a bigger SD-card and want to make use of the space.

* Size will be changed with parted
* parted /dev/sdx
* show size with "print free"

# (parted) print free # Model: USB Mass Storage Device (scsi)
# Disk /dev/sdc: 7965MB# Sector size (logical/physical): 512B/512B# Partition Table: msdos

{| class="wikitable"
|-
| Number || Start || End || Size || Type || File system || Flags
|-
| || 32,3kB || 1049kB || 1016kB || || Free Space ||
|-
| 1 || 1049kB || 53,5MB || 52,4MB || primary || fat32 ||
|-
| 2 || 53,5MB || 1933MB || 1879MB || primary || ext4 ||
|-
| || 1933MB || 7965MB || 6032MB || || Free Space ||
|}

we would like to resize the second partition to the nearly end ( -512MB for swap )
# (parted) resizepart # Partition number? 2 # Warning: Partition /dev/sdc2 is being used. Are you sure you want to continue?# Yes/No? YES # End? [1933MB]? 7453MB this is how the partitions looks like after

(parted) print free * Model: USB Mass Storage Device (scsi)* Disk /dev/sdc: 7965MB* Sector size (logical/physical): 512B/512B* Partition Table: msdos

{| class="wikitable"
|-
| Number || Start || End || Size || Type || File system || Flags
|-
| || 32,3kB || 1049kB || 1016kB || || Free Space ||
|-
| 1 || 1049kB || 53,5MB || 52,4MB || primary || fat32 ||
|-
| 2 || 53,5MB || '''7453'''MB || '''7400'''MB || primary || ext4 ||
|-
| || '''7453'''MB || 7965MB || '''512'''MB || || Free Space ||
|}

create Swap (optional)

(parted) mkpart primary linux-swap
Start? 7453MB
End? 7965MB

this is how the partitions looks like after

(parted) print free * Model: USB Mass Storage Device (scsi)* Disk /dev/sdc: 7965MB* Sector size (logical/physical): 512B/512B* Partition Table: msdos

{| class="wikitable"
|-
| Number || Start || End || Size || Type || File system || Flags
|-
| || 32,3kB || 1049kB || 1016kB || || Free Space ||
|-
| 1 || 1049kB || 53,5MB || 52,4MB || primary || fat32 ||
|-
| 2 || 53,5MB || 7453MB || 7400MB || primary || ext4 ||
|-
| || '''7453MB''' || '''7453MB''' || '''278kB''' || || '''Free Space'''||
|-
| || 7453MB || 7965MB || 512MB || '''primary''' || Free Space ||
|}
disregard the 4th entry, the new resized partition is the last one.

resize filesystem
*resize2fs /dev/sdc2

create swap

*mkswap /dev/sdc3

[[Category:Documentation]]
[[Category:Operating system]]
[[Category:Software]]

Pandian

2014-01-05T22:09:02Z

Stackshadow: /* Upgrade from "minimal" to "normal" */ add upgrade instructions

[[File:Post-3032-0-90501200-1380479048.png|thumbnail|Logo]]

'''Pandian is an debian-based armhf desktop and CLI distro for your Pandora.'''
Ideas, Bugs, or feature-requests? Report to:
http://www.evilbrain.de/projects/pandian/issues

=== Main Features ===
* The debian way.
* Access to all packages from Debian software repositories.
* Pandian hosts its own Debian repo http://pandian.openpandora.org with up to date scripts, all settings and extra programs.
* armhf-build, which means '''f'''loat operations are relegated to special '''h'''ardware rather than taxing the main cpu with them (as with softfloat)

== '''Pandian''' - '''MARK 2''' The newest release ==
Second version of Pandian 
'''Full Debian GNU/Linux based on sid branch with LXDE desktop environment (normal) or CLI (minimal-) build.''' 
'''hardfloat armv7l''' yule release '''Date: 29.12.2013'''
[http://boards.openpandora.org/topic/15302-pandian-mark2/ forum link]

=== '''Installation''' requirements===
* '''Pandora''' ;) All versions fine?
* '''SD card''' minimum 2GB ( was tested with 4GB )
* '''PC''' Linux|GNU, BSD, Mac, or Windows for putting the install on the aforementioned SD-card.

==== '''Download''' a version of Pandian ====
There are two different versions of the "MARK2" release:
{| class="wikitable"
|-
! Version !! Description !! Includes !! Link !! Checksums (sha256)
|-
| '''base''' || pandian for advanced users, without any Desktop environment but with basic network-tools ( iw, ceni ) || ceni ( network-manager) network-manager MediaPlayer ( mpd ) iw (wireless-tools) || [http://pandian.openpandora.org/releases/pandian-mark2-base-hf_2014-01-05.7z pandian.openpandora.org: pandian-mark2-base-hf_2014-01-05.7z] || pandian-mark2-base-hf_2014-01-05.7z b11ffe9cc4fd6111775d0b48c133b1e1afcf6865de784b9865db0cea29674d85 pandian-mark2-base-hf_2014-01-05.img c1903423a5b5e0d04563f14526e8161fbe77a102e64d5d571bcf3b87870fa211
|-
| '''normal''' || pandian for regular users, with full Desktop environment ( LXDE ) || network-manager MediaPlayer ( mpd with gurlp ) nub-support calibrator-application medit Text editor. mpd audio player backend, glurp as frontend || [http://www.filedropper.com/pandian-mark2-hf2014-01-02 filedropper: pandian-mark2-hf2014-01-02] [http://pandian.openpandora.org/releases/pandian-mark2-hf_2014-01-02.7z pandian.openpandora.org: pandian-mark2-hf_2014-01-02.7z] || pandian-mark2-hf_2014-01-02.7z 3731d70a4d8ec59e79a046f34f69c5c809be73e38cfc91a5b580478b8f8c222f pandian-mark2-hf_2014-01-02.img 83b8d3fa5bd0588cfb8b11cfe6b827819e6311e98396a6e32c46c9692f072e96
|}
Notes:
* It is trivial to change from LXDE to [[Xfce]] (or any other desktop environment), adding a new user interface atop the minimal install is more advanced as manual setup of USB-Networking or wifi is needed to do so.
* All images have automount ( for USB-Sticks, external Hard-Drives etc. ) and ALSA sound support

==== '''Verify''' that your download is OK ====
* After you download the version you picked, verify its checksum to make sure the integrity of the downloaded file matches (in being an exact copy the one on the server)

#open up a terminal
# "'''sha256sum ~/downloads/pandian/<image.7Z>'''" (input where you have the file and the one you chose to download)
# make sure it matches the given md5sum, if not, try to download another copy. This step isnt mandatory, but its there to make sure everything is fine before we proceed.

==== '''Unzip''' the downloaded image ====
*Unzipping 7z archives
# Open up a terminal (or do it your way)
# Enter"'''7zr e <image.7z>'''"
# You now have an unzipped image

==== (Optional) '''Preparation''', find out where to install ====

This step helps you find out where the SD card is mounted. 

If you have an build in SD-Card-Reader this is normally /dev/mmcblk0p1 ( in Debian )
If you have an USB-Card-Reader this is something like /dev/sdc ( in Debian )
* Open an Terminal and input "'''lsblk'''"
* You will get a list with the actual Block-Devices
* The SD-Card should be of type 'disk'

You can also try gparted to see which devices you have and identify the SD-card from there

==== '''Install''' the image to the SD-Card ====
{{warning
| Warning, this will destroy everything on the device ! So please be very sure which device is you SD-Card !
}}
# Here it will be /dev/sd'''x'''

(note that the x after the sd is the drive letter, it could be ''sd'''b''''' sd'''c''''' or ''sd'''d''''' and so on, lets say its sd'''c'''. Which means c is the drive letter for the SD-card and that sd- a and -b are in use for other things. 
 
When writing to the device, make sure not to include the following number, which is the partition ''sdc'''1''''' ''sdc'''2''''' etc. since we are using the base card here) 
 
This means considerations for partitions and filesystem are taken care of, so no need to worry about that. Do ''not'' pick the wrong drive however, since dd will happily write the image to somewhere it isn't supposed to if you just give it root privileges and hit enter.) 
 
#Copy image to SD-Card with "'''dd if=<image.img> of=/dev/sdx'''"

You now have Pandian installed on your SD card and its ready to go. :) However after copying the image to the SD-Card resizing the partitionspartitions is needed to fully utilize the space, since by default the install is limited to 2GB. (If your card is bigger Pandian is still limited to those 2GB)

====(Optional) '''Resize''' SD-Card ====

* This can be done with gparted on linux|gnu
* start gparted

[[File:Gparted resize 001.png|800px|thumbnail|none|The actual partitions of the SD-CARD. Please select the correct device at the top right corner.]]
[[File:Gparted resize 002.png|800px|thumbnail|none|Rightclick to the second partition and select Resize/Move]]
[[File:Gparted resize 003.png|400px|thumbnail|none|You see the actual Size of this partition]]
[[File:Gparted resize 004.png|400px|thumbnail|none|Move the slider to the right, or set "Free space following" to 0]]
[[File:Gparted resize 005.png|800px|thumbnail|none|After you press the "Resize/Move" button, you get the preview of the new partition structure]]
[[File:Gparted resize 006.png|800px|thumbnail|none|When you press "Apply all operations", youve got a warning that you can loss your Data. THIS IS THE LAST CHANGE TO CHECK IF YOU SELECTED THE CORRECT DEVICE.

 Press Apply if everything is correct.]]

* After everything is fine, you have a fresh install of Pandian on you SD-Card
 

=== '''Startup''' wizard ===
* Upon first boot of Pandian, there is a first-start-wizard which guides you through some basic settings.
These are: Locale, timezone, time and date, password for admin and user setup and finally calibration of the touchscreen.
The script is located in /usr/sbin/pdSetup should you need to run it again.

==== Navigation ====
* Inside a dialog you can navigate with the cross/dpad
* Hit space to select a checkbox
* Moving between <Ok> and <Cancel> can be down with the use of TAB ( Tap Fn then tap Space )
* Acknowledge with Enter

=== '''Network''' connection instructions:===

====normal ====
* Use network-manager

====minimal====
* Use ceni network manager

===(Optional) '''Update''' of Pandian system ===
* After you setup your Pandora, it is useful to update your system. It is a rolling release, which means since the image was made, the system is forever updated with new packages.
* open a terminal
* get root ( command is: "su" )
* enter "apt-get update" to download package information from the repositories
* enter "apt-get upgrade" to update all packages that are out of date
(pandian packages are also updated this way :)
* Note: to update only the pandian-packages enter "apt-get upgrade pandian*"

===== Upgrade from "minimal" to "normal" =====
It is possible to upgrade from the "minimal"-image to the "normal"-image.
This can simlpy be done by installing the pandian-lxde debian package
* get an connection to the internet(tm) with ceni
* open an terminal
* get root ( with command: "su" )
* update package list with: "apt-get update"
* install pandian-lxde with "apt-get install pandian-lxde"
* after everything is finished login with the user you setup before
* open an terminal
* get root ( with command: "su" )
* load keymap with "xmodmap /etc/skel/.pndXmodmap"
* the easiest way is to activate the first-start-wizard with "insserv firstuse"
* reboot and go through the wizard

===(Optional) '''Information''' ===

=== Additional Users/Groups ===
There are additional Users/Groups added to the standard debian-users
==== Groups ====
* admin
:This superuser privilege is used by sudo for admin task like shutdown etc.
* mpd
:This user/group has access to mpd-related files ( socket, pid-files )

==== Power-Modes ====
===== LID-Close =====
* If the lid is closed only the screen will be disabled
===== Low-Power-Mode / Shutdown =====
[[File:Lead Photo For Power modes0-2920264867079787.jpg|thumbnail|right|Switch]]
* Switch to left: Pandora will go to low power mode ( reduce CPU, Disable LID, Pause processes )
* Switch to right: Shutdown the pandora

==== pdcmd ====
* This script handles all system-related stuff, like lid, low-power, usb or wifi.
* This should run as root
 
Usage:
{| class="wikitable"
|-
! Command !! What's done
|-
| /usr/sbin/pdcmd LCDBright + || Increase the light of the lid
|-
| /usr/sbin/pdcmd LCDBright - || Decrease the light of the lid
|-
| /usr/sbin/pdcmd LCDBright 10 || Set the Brightness of the lid to 10
|-
| /usr/sbin/pdcmd LCDTrigger || Trigger the lid ( WARNING: THIS DISABLES THE LID ! )
|-
| /usr/sbin/pdcmd USBNetTrigger || Enable the USB-Networking (module g_ether). If usbnetworking is on, it will disable it
|-
| /usr/sbin/pdcmd USBHostTrigger || Enable the USB-Host (module ehci-hcd). If USB-Host is on, it will disable it
|-
| /usr/sbin/pdcmd WLANTrigger || Enable Wifi. If Wifi is enabled it will be disabled
|}

== Old releases ==

=== Mark2 minimal-hf2014-01-02 ===

{| class="wikitable"
|-
! Version !! Description !! Included !! Link !! Checksums (sha256)
|-
| minimal || pandian without any Desktop environment but with the basic pandian package || nano || [http://www.filedropper.com/pandian-mark2-minimal-hf2014-01-02 filedropper: pandian-mark2-minimal-hf2014-01-02] [http://pandian.openpandora.org/releases/pandian-mark2-minimal-hf_2014-01-02.7z pandian.openpandora.org: pandian-mark2-minimal-hf_2014-01-02.7z] || pandian-mark2-minimal-hf_2014-01-02.7z a35106473e54c55d64c7eae2088d8c267b605baf17d5338b8e2938dbfe3c01ca pandian-mark2-minimal-hf_2014-01-02.img c68a42c1aef0238c1dd6ff33b628a2c0dea812a7b5b2d906afb185f93f940f84
|-
| minimal-networking fix|| HotFix for pandian-mark2-minimal-hf_2014-01-02 [[#Network_Fix_for_pandian-minimal|Instructions]] || dhcp, network manager || [http://www.filedropper.com/pandian-mark2-minimal-networking2014-01-02tar filedropper: pandian-mark2-minimal-networking_2014-01-02.tar.gz] [http://pandian.openpandora.org/releases/pandian-mark2-minimal-networking_2014-01-02.tar.gz pandian.openpandora.org: pandian-mark2-minimal-networking_2014-01-02.tar.gz] || 4cf802391360e5bf183e9d4b5fe8b6f407b3e476baec7b5b0aa7340796680ae6 pandian-mark2-minimal-networking_2014-01-02.tar.gz
|}

===== Network Fix for pandian-minimal =====
If you download the '''pandian-mark2-minimal-hf_2014-01-02''' image there is a lack of tools for setup wifi networking. 
'''Note: For the actual download of pandian-minimal, wifi-network-tools are included'''
* Therefore download the fix and place it on the SD-Card where pandian is installed. (you need to have local superuser privileges on your own system as the SD contents aren't owned by your user)
* Boot pandian-minimal
* login with user: "root"
* switch to root-directory: "cd /"
* untar the network-fix: "tar -xf /path-where-file-is-located/pandian-mark2-minimal-networking_2014-01-03.tar.gz"
* setup the fix with command "pdMinimalNetwork"

* after the script is finished, run "ceni" and setup your wifi-connection

=== 01 ===
'''Full debian GNU/Linux 7.2 codename Wheezy (stable) with LXDE desktop environment 
hardfloat armv7l released Date: 29.09.2013'''
[http://boards.openpandora.org/topic/14482-pandian-01/ forum link]
===Features===

* Hard-Float-ABI
* Ext4 Root for better performance
* Working Touch-Screen
* Working Nubs
* Screen-Off on LID-Close
* Low-Power-Mode
* WLAN
* Music ( with Sonata/MPD )
* Automount

=== Upcoming/Ideas ===

* Assistant for tzdata
* libpnd - PND-Support
* OpenGL not tested yet
* Aptitude
* Minimal-Network-Installation
* Pandian-Debian-Repository for special packages ( libpnd, touch-screen-calibrator )
* of course, in-system-documentation ( Documentation on the pandora )

Download [http://www.share-online.biz/dl/TPMFFXTM2AU here]

[http://boards.openpandora.org/topic/14482-pandian-01 Forum thread]

=== Installation ===

note: It is assumed here, that the card-reader load the card as /dev/sdc.
Please check before which device is your SD-card !
This can be checked with gparted. Minimum requirement 2GB SD-card.

# Download Image ( as 7z )
# Verify md5-checksum: pandian-stable-hf_2013-09-29.001.7z '''2a85bbb40bbe7c6e8f92f058e150951a''' pandian-stable-hf_2013-09-29.001.img '''e62d101dc708de49af1ca7743e2df2bd'''
# Unzip with 7z ( in Linux with 7zr e <image.7z> )
# Copy image to SD-Card ( dd if=<image.img> of=/dev/sdx ) Don't specify "bs="

Username: ''Pandian'' 
Root password: ''Root'' (change after intsallation as per instructions below)

#Open a terminal
#Type "su"
#Type "passwd"
#Enter your new root password when prompted, and then again to confirm.
#Dont forget your password

=== Resize ===
Default installation is limited to 2GB, if you want to expand it, you can, provided you have installed it on a bigger SD-card and want to make use of the space.

* Size will be changed with parted
* parted /dev/sdx
* show size with "print free"

# (parted) print free # Model: USB Mass Storage Device (scsi)
# Disk /dev/sdc: 7965MB# Sector size (logical/physical): 512B/512B# Partition Table: msdos

{| class="wikitable"
|-
| Number || Start || End || Size || Type || File system || Flags
|-
| || 32,3kB || 1049kB || 1016kB || || Free Space ||
|-
| 1 || 1049kB || 53,5MB || 52,4MB || primary || fat32 ||
|-
| 2 || 53,5MB || 1933MB || 1879MB || primary || ext4 ||
|-
| || 1933MB || 7965MB || 6032MB || || Free Space ||
|}

we would like to resize the second partition to the nearly end ( -512MB for swap )
# (parted) resizepart # Partition number? 2 # Warning: Partition /dev/sdc2 is being used. Are you sure you want to continue?# Yes/No? YES # End? [1933MB]? 7453MB this is how the partitions looks like after

(parted) print free * Model: USB Mass Storage Device (scsi)* Disk /dev/sdc: 7965MB* Sector size (logical/physical): 512B/512B* Partition Table: msdos

{| class="wikitable"
|-
| Number || Start || End || Size || Type || File system || Flags
|-
| || 32,3kB || 1049kB || 1016kB || || Free Space ||
|-
| 1 || 1049kB || 53,5MB || 52,4MB || primary || fat32 ||
|-
| 2 || 53,5MB || '''7453'''MB || '''7400'''MB || primary || ext4 ||
|-
| || '''7453'''MB || 7965MB || '''512'''MB || || Free Space ||
|}

create Swap (optional)

(parted) mkpart primary linux-swap
Start? 7453MB
End? 7965MB

this is how the partitions looks like after

(parted) print free * Model: USB Mass Storage Device (scsi)* Disk /dev/sdc: 7965MB* Sector size (logical/physical): 512B/512B* Partition Table: msdos

{| class="wikitable"
|-
| Number || Start || End || Size || Type || File system || Flags
|-
| || 32,3kB || 1049kB || 1016kB || || Free Space ||
|-
| 1 || 1049kB || 53,5MB || 52,4MB || primary || fat32 ||
|-
| 2 || 53,5MB || 7453MB || 7400MB || primary || ext4 ||
|-
| || '''7453MB''' || '''7453MB''' || '''278kB''' || || '''Free Space'''||
|-
| || 7453MB || 7965MB || 512MB || '''primary''' || Free Space ||
|}
disregard the 4th entry, the new resized partition is the last one.

resize filesystem
*resize2fs /dev/sdc2

create swap

*mkswap /dev/sdc3

[[Category:Documentation]]
[[Category:Operating system]]
[[Category:Software]]

Pandian

2014-01-05T21:52:21Z

Stackshadow: /* Download a version of Pandian */ Add download link for pandian-base

[[File:Post-3032-0-90501200-1380479048.png|thumbnail|Logo]]

'''Pandian is an debian-based armhf desktop and CLI distro for your Pandora.'''
Ideas, Bugs, or feature-requests? Report to:
http://www.evilbrain.de/projects/pandian/issues

=== Main Features ===
* The debian way.
* Access to all packages from Debian software repositories.
* Pandian hosts its own Debian repo http://pandian.openpandora.org with up to date scripts, all settings and extra programs.
* armhf-build, which means '''f'''loat operations are relegated to special '''h'''ardware rather than taxing the main cpu with them (as with softfloat)

== '''Pandian''' - '''MARK 2''' The newest release ==
Second version of Pandian 
'''Full Debian GNU/Linux based on sid branch with LXDE desktop environment (normal) or CLI (minimal-) build.''' 
'''hardfloat armv7l''' yule release '''Date: 29.12.2013'''
[http://boards.openpandora.org/topic/15302-pandian-mark2/ forum link]

=== '''Installation''' requirements===
* '''Pandora''' ;) All versions fine?
* '''SD card''' minimum 2GB ( was tested with 4GB )
* '''PC''' Linux|GNU, BSD, Mac, or Windows for putting the install on the aforementioned SD-card.

==== '''Download''' a version of Pandian ====
There are two different versions of the "MARK2" release:
{| class="wikitable"
|-
! Version !! Description !! Includes !! Link !! Checksums (sha256)
|-
| '''base''' || pandian for advanced users, without any Desktop environment but with basic network-tools ( iw, ceni ) || ceni ( network-manager) network-manager MediaPlayer ( mpd ) iw (wireless-tools) || [http://pandian.openpandora.org/releases/pandian-mark2-base-hf_2014-01-05.7z pandian.openpandora.org: pandian-mark2-base-hf_2014-01-05.7z] || pandian-mark2-base-hf_2014-01-05.7z b11ffe9cc4fd6111775d0b48c133b1e1afcf6865de784b9865db0cea29674d85 pandian-mark2-base-hf_2014-01-05.img c1903423a5b5e0d04563f14526e8161fbe77a102e64d5d571bcf3b87870fa211
|-
| '''normal''' || pandian for regular users, with full Desktop environment ( LXDE ) || network-manager MediaPlayer ( mpd with gurlp ) nub-support calibrator-application medit Text editor. mpd audio player backend, glurp as frontend || [http://www.filedropper.com/pandian-mark2-hf2014-01-02 filedropper: pandian-mark2-hf2014-01-02] [http://pandian.openpandora.org/releases/pandian-mark2-hf_2014-01-02.7z pandian.openpandora.org: pandian-mark2-hf_2014-01-02.7z] || pandian-mark2-hf_2014-01-02.7z 3731d70a4d8ec59e79a046f34f69c5c809be73e38cfc91a5b580478b8f8c222f pandian-mark2-hf_2014-01-02.img 83b8d3fa5bd0588cfb8b11cfe6b827819e6311e98396a6e32c46c9692f072e96
|}
Notes:
* It is trivial to change from LXDE to [[Xfce]] (or any other desktop environment), adding a new user interface atop the minimal install is more advanced as manual setup of USB-Networking or wifi is needed to do so.
* All images have automount ( for USB-Sticks, external Hard-Drives etc. ) and ALSA sound support

==== '''Verify''' that your download is OK ====
* After you download the version you picked, verify its checksum to make sure the integrity of the downloaded file matches (in being an exact copy the one on the server)

#open up a terminal
# "'''sha256sum ~/downloads/pandian/<image.7Z>'''" (input where you have the file and the one you chose to download)
# make sure it matches the given md5sum, if not, try to download another copy. This step isnt mandatory, but its there to make sure everything is fine before we proceed.

==== '''Unzip''' the downloaded image ====
*Unzipping 7z archives
# Open up a terminal (or do it your way)
# Enter"'''7zr e <image.7z>'''"
# You now have an unzipped image

==== (Optional) '''Preparation''', find out where to install ====

This step helps you find out where the SD card is mounted. 

If you have an build in SD-Card-Reader this is normally /dev/mmcblk0p1 ( in Debian )
If you have an USB-Card-Reader this is something like /dev/sdc ( in Debian )
* Open an Terminal and input "'''lsblk'''"
* You will get a list with the actual Block-Devices
* The SD-Card should be of type 'disk'

You can also try gparted to see which devices you have and identify the SD-card from there

==== '''Install''' the image to the SD-Card ====
{{warning
| Warning, this will destroy everything on the device ! So please be very sure which device is you SD-Card !
}}
# Here it will be /dev/sd'''x'''

(note that the x after the sd is the drive letter, it could be ''sd'''b''''' sd'''c''''' or ''sd'''d''''' and so on, lets say its sd'''c'''. Which means c is the drive letter for the SD-card and that sd- a and -b are in use for other things. 
 
When writing to the device, make sure not to include the following number, which is the partition ''sdc'''1''''' ''sdc'''2''''' etc. since we are using the base card here) 
 
This means considerations for partitions and filesystem are taken care of, so no need to worry about that. Do ''not'' pick the wrong drive however, since dd will happily write the image to somewhere it isn't supposed to if you just give it root privileges and hit enter.) 
 
#Copy image to SD-Card with "'''dd if=<image.img> of=/dev/sdx'''"

You now have Pandian installed on your SD card and its ready to go. :) However after copying the image to the SD-Card resizing the partitionspartitions is needed to fully utilize the space, since by default the install is limited to 2GB. (If your card is bigger Pandian is still limited to those 2GB)

====(Optional) '''Resize''' SD-Card ====

* This can be done with gparted on linux|gnu
* start gparted

[[File:Gparted resize 001.png|800px|thumbnail|none|The actual partitions of the SD-CARD. Please select the correct device at the top right corner.]]
[[File:Gparted resize 002.png|800px|thumbnail|none|Rightclick to the second partition and select Resize/Move]]
[[File:Gparted resize 003.png|400px|thumbnail|none|You see the actual Size of this partition]]
[[File:Gparted resize 004.png|400px|thumbnail|none|Move the slider to the right, or set "Free space following" to 0]]
[[File:Gparted resize 005.png|800px|thumbnail|none|After you press the "Resize/Move" button, you get the preview of the new partition structure]]
[[File:Gparted resize 006.png|800px|thumbnail|none|When you press "Apply all operations", youve got a warning that you can loss your Data. THIS IS THE LAST CHANGE TO CHECK IF YOU SELECTED THE CORRECT DEVICE.

 Press Apply if everything is correct.]]

* After everything is fine, you have a fresh install of Pandian on you SD-Card
 

=== '''Startup''' wizard ===
* Upon first boot of Pandian, there is a first-start-wizard which guides you through some basic settings.
These are: Locale, timezone, time and date, password for admin and user setup and finally calibration of the touchscreen.
The script is located in /usr/sbin/pdSetup should you need to run it again.

==== Navigation ====
* Inside a dialog you can navigate with the cross/dpad
* Hit space to select a checkbox
* Moving between <Ok> and <Cancel> can be down with the use of TAB ( Tap Fn then tap Space )
* Acknowledge with Enter

=== '''Network''' connection instructions:===

====normal ====
* Use network-manager

====minimal====
* Use ceni network manager

===(Optional) '''Update''' of Pandian system ===
* After you setup your Pandora, it is useful to update your system. It is a rolling release, which means since the image was made, the system is forever updated with new packages.
* open a terminal
* get root ( command is: "su" )
* enter "apt-get update" to download package information from the repositories
* enter "apt-get upgrade" to update all packages that are out of date
(pandian packages are also updated this way :)
* Note: to update only the pandian-packages enter "apt-get upgrade pandian*"

===== Upgrade from "minimal" to "normal" =====
It is possible to upgrade from the "minimal"-image to the "normal"-image.
This can simlpy be done by installing the pandian-lxde debian package
* get an connection to the internet(tm) with ceni
* open an terminal
* get root ( with command: "su" )
* update package list with: "apt-get update"
* install debian-lxde with "apt-get install debian-lxde"

===(Optional) '''Information''' ===

=== Additional Users/Groups ===
There are additional Users/Groups added to the standard debian-users
==== Groups ====
* admin
:This superuser privilege is used by sudo for admin task like shutdown etc.
* mpd
:This user/group has access to mpd-related files ( socket, pid-files )

==== Power-Modes ====
===== LID-Close =====
* If the lid is closed only the screen will be disabled
===== Low-Power-Mode / Shutdown =====
[[File:Lead Photo For Power modes0-2920264867079787.jpg|thumbnail|right|Switch]]
* Switch to left: Pandora will go to low power mode ( reduce CPU, Disable LID, Pause processes )
* Switch to right: Shutdown the pandora

==== pdcmd ====
* This script handles all system-related stuff, like lid, low-power, usb or wifi.
* This should run as root
 
Usage:
{| class="wikitable"
|-
! Command !! What's done
|-
| /usr/sbin/pdcmd LCDBright + || Increase the light of the lid
|-
| /usr/sbin/pdcmd LCDBright - || Decrease the light of the lid
|-
| /usr/sbin/pdcmd LCDBright 10 || Set the Brightness of the lid to 10
|-
| /usr/sbin/pdcmd LCDTrigger || Trigger the lid ( WARNING: THIS DISABLES THE LID ! )
|-
| /usr/sbin/pdcmd USBNetTrigger || Enable the USB-Networking (module g_ether). If usbnetworking is on, it will disable it
|-
| /usr/sbin/pdcmd USBHostTrigger || Enable the USB-Host (module ehci-hcd). If USB-Host is on, it will disable it
|-
| /usr/sbin/pdcmd WLANTrigger || Enable Wifi. If Wifi is enabled it will be disabled
|}

== Old releases ==

=== Mark2 minimal-hf2014-01-02 ===

{| class="wikitable"
|-
! Version !! Description !! Included !! Link !! Checksums (sha256)
|-
| minimal || pandian without any Desktop environment but with the basic pandian package || nano || [http://www.filedropper.com/pandian-mark2-minimal-hf2014-01-02 filedropper: pandian-mark2-minimal-hf2014-01-02] [http://pandian.openpandora.org/releases/pandian-mark2-minimal-hf_2014-01-02.7z pandian.openpandora.org: pandian-mark2-minimal-hf_2014-01-02.7z] || pandian-mark2-minimal-hf_2014-01-02.7z a35106473e54c55d64c7eae2088d8c267b605baf17d5338b8e2938dbfe3c01ca pandian-mark2-minimal-hf_2014-01-02.img c68a42c1aef0238c1dd6ff33b628a2c0dea812a7b5b2d906afb185f93f940f84
|-
| minimal-networking fix|| HotFix for pandian-mark2-minimal-hf_2014-01-02 [[#Network_Fix_for_pandian-minimal|Instructions]] || dhcp, network manager || [http://www.filedropper.com/pandian-mark2-minimal-networking2014-01-02tar filedropper: pandian-mark2-minimal-networking_2014-01-02.tar.gz] [http://pandian.openpandora.org/releases/pandian-mark2-minimal-networking_2014-01-02.tar.gz pandian.openpandora.org: pandian-mark2-minimal-networking_2014-01-02.tar.gz] || 4cf802391360e5bf183e9d4b5fe8b6f407b3e476baec7b5b0aa7340796680ae6 pandian-mark2-minimal-networking_2014-01-02.tar.gz
|}

===== Network Fix for pandian-minimal =====
If you download the '''pandian-mark2-minimal-hf_2014-01-02''' image there is a lack of tools for setup wifi networking. 
'''Note: For the actual download of pandian-minimal, wifi-network-tools are included'''
* Therefore download the fix and place it on the SD-Card where pandian is installed. (you need to have local superuser privileges on your own system as the SD contents aren't owned by your user)
* Boot pandian-minimal
* login with user: "root"
* switch to root-directory: "cd /"
* untar the network-fix: "tar -xf /path-where-file-is-located/pandian-mark2-minimal-networking_2014-01-03.tar.gz"
* setup the fix with command "pdMinimalNetwork"

* after the script is finished, run "ceni" and setup your wifi-connection

=== 01 ===
'''Full debian GNU/Linux 7.2 codename Wheezy (stable) with LXDE desktop environment 
hardfloat armv7l released Date: 29.09.2013'''
[http://boards.openpandora.org/topic/14482-pandian-01/ forum link]
===Features===

* Hard-Float-ABI
* Ext4 Root for better performance
* Working Touch-Screen
* Working Nubs
* Screen-Off on LID-Close
* Low-Power-Mode
* WLAN
* Music ( with Sonata/MPD )
* Automount

=== Upcoming/Ideas ===

* Assistant for tzdata
* libpnd - PND-Support
* OpenGL not tested yet
* Aptitude
* Minimal-Network-Installation
* Pandian-Debian-Repository for special packages ( libpnd, touch-screen-calibrator )
* of course, in-system-documentation ( Documentation on the pandora )

Download [http://www.share-online.biz/dl/TPMFFXTM2AU here]

[http://boards.openpandora.org/topic/14482-pandian-01 Forum thread]

=== Installation ===

note: It is assumed here, that the card-reader load the card as /dev/sdc.
Please check before which device is your SD-card !
This can be checked with gparted. Minimum requirement 2GB SD-card.

# Download Image ( as 7z )
# Verify md5-checksum: pandian-stable-hf_2013-09-29.001.7z '''2a85bbb40bbe7c6e8f92f058e150951a''' pandian-stable-hf_2013-09-29.001.img '''e62d101dc708de49af1ca7743e2df2bd'''
# Unzip with 7z ( in Linux with 7zr e <image.7z> )
# Copy image to SD-Card ( dd if=<image.img> of=/dev/sdx ) Don't specify "bs="

Username: ''Pandian'' 
Root password: ''Root'' (change after intsallation as per instructions below)

#Open a terminal
#Type "su"
#Type "passwd"
#Enter your new root password when prompted, and then again to confirm.
#Dont forget your password

=== Resize ===
Default installation is limited to 2GB, if you want to expand it, you can, provided you have installed it on a bigger SD-card and want to make use of the space.

* Size will be changed with parted
* parted /dev/sdx
* show size with "print free"

# (parted) print free # Model: USB Mass Storage Device (scsi)
# Disk /dev/sdc: 7965MB# Sector size (logical/physical): 512B/512B# Partition Table: msdos

{| class="wikitable"
|-
| Number || Start || End || Size || Type || File system || Flags
|-
| || 32,3kB || 1049kB || 1016kB || || Free Space ||
|-
| 1 || 1049kB || 53,5MB || 52,4MB || primary || fat32 ||
|-
| 2 || 53,5MB || 1933MB || 1879MB || primary || ext4 ||
|-
| || 1933MB || 7965MB || 6032MB || || Free Space ||
|}

we would like to resize the second partition to the nearly end ( -512MB for swap )
# (parted) resizepart # Partition number? 2 # Warning: Partition /dev/sdc2 is being used. Are you sure you want to continue?# Yes/No? YES # End? [1933MB]? 7453MB this is how the partitions looks like after

(parted) print free * Model: USB Mass Storage Device (scsi)* Disk /dev/sdc: 7965MB* Sector size (logical/physical): 512B/512B* Partition Table: msdos

{| class="wikitable"
|-
| Number || Start || End || Size || Type || File system || Flags
|-
| || 32,3kB || 1049kB || 1016kB || || Free Space ||
|-
| 1 || 1049kB || 53,5MB || 52,4MB || primary || fat32 ||
|-
| 2 || 53,5MB || '''7453'''MB || '''7400'''MB || primary || ext4 ||
|-
| || '''7453'''MB || 7965MB || '''512'''MB || || Free Space ||
|}

create Swap (optional)

(parted) mkpart primary linux-swap
Start? 7453MB
End? 7965MB

this is how the partitions looks like after

(parted) print free * Model: USB Mass Storage Device (scsi)* Disk /dev/sdc: 7965MB* Sector size (logical/physical): 512B/512B* Partition Table: msdos

{| class="wikitable"
|-
| Number || Start || End || Size || Type || File system || Flags
|-
| || 32,3kB || 1049kB || 1016kB || || Free Space ||
|-
| 1 || 1049kB || 53,5MB || 52,4MB || primary || fat32 ||
|-
| 2 || 53,5MB || 7453MB || 7400MB || primary || ext4 ||
|-
| || '''7453MB''' || '''7453MB''' || '''278kB''' || || '''Free Space'''||
|-
| || 7453MB || 7965MB || 512MB || '''primary''' || Free Space ||
|}
disregard the 4th entry, the new resized partition is the last one.

resize filesystem
*resize2fs /dev/sdc2

create swap

*mkswap /dev/sdc3

[[Category:Documentation]]
[[Category:Operating system]]
[[Category:Software]]

Pandian

2014-01-05T16:06:47Z

Stackshadow: /* Download a version of Pandian */ remove minimal version because its broken and will be replaced with "pandian-base"

[[File:Post-3032-0-90501200-1380479048.png|thumbnail|Logo]]

'''Pandian is an debian-based armhf desktop and CLI distro for your Pandora.'''
Ideas, Bugs, or feature-requests? Report to:
http://www.evilbrain.de/projects/pandian/issues

=== Main Features ===
* The debian way.
* Access to all packages from Debian software repositories.
* Pandian hosts its own Debian repo http://pandian.openpandora.org with up to date scripts, all settings and extra programs.
* armhf-build, which means '''f'''loat operations are relegated to special '''h'''ardware rather than taxing the main cpu with them (as with softfloat)

== '''Pandian''' - '''MARK 2''' The newest release ==
Second version of Pandian 
'''Full Debian GNU/Linux based on sid branch with LXDE desktop environment (normal) or CLI (minimal-) build.''' 
'''hardfloat armv7l''' yule release '''Date: 29.12.2013'''
[http://boards.openpandora.org/topic/15302-pandian-mark2/ forum link]

=== '''Installation''' requirements===
* '''Pandora''' ;) All versions fine?
* '''SD card''' minimum 2GB ( was tested with 4GB )
* '''PC''' Linux|GNU, BSD, Mac, or Windows for putting the install on the aforementioned SD-card.

==== '''Download''' a version of Pandian ====
There are two different versions of the "MARK2" release:
{| class="wikitable"
|-
! Version !! Description !! Includes !! Link !! Checksums (sha256)
|-
| '''normal''' || pandian for regular users, with full Desktop environment ( LXDE ) || network-manager MediaPlayer ( mpd with gurlp ) nub-support calibrator-application medit Text editor. mpd audio player backend, glurp as frontend || [http://www.filedropper.com/pandian-mark2-hf2014-01-02 filedropper: pandian-mark2-hf2014-01-02] [http://pandian.openpandora.org/releases/pandian-mark2-hf_2014-01-02.7z pandian.openpandora.org: pandian-mark2-hf_2014-01-02.7z] || pandian-mark2-hf_2014-01-02.7z 3731d70a4d8ec59e79a046f34f69c5c809be73e38cfc91a5b580478b8f8c222f pandian-mark2-hf_2014-01-02.img 83b8d3fa5bd0588cfb8b11cfe6b827819e6311e98396a6e32c46c9692f072e96
|}
Notes:
* It is trivial to change from LXDE to [[Xfce]] (or any other desktop environment), adding a new user interface atop the minimal install is more advanced as manual setup of USB-Networking or wifi is needed to do so.
* All images have automount ( for USB-Sticks, external Hard-Drives etc. ) and ALSA sound support

==== '''Verify''' that your download is OK ====
* After you download the version you picked, verify its checksum to make sure the integrity of the downloaded file matches (in being an exact copy the one on the server)

#open up a terminal
# "'''sha256sum ~/downloads/pandian/<image.7Z>'''" (input where you have the file and the one you chose to download)
# make sure it matches the given md5sum, if not, try to download another copy. This step isnt mandatory, but its there to make sure everything is fine before we proceed.

==== '''Unzip''' the downloaded image ====
*Unzipping 7z archives
# Open up a terminal (or do it your way)
# Enter"'''7zr e <image.7z>'''"
# You now have an unzipped image

==== (Optional) '''Preparation''', find out where to install ====

This step helps you find out where the SD card is mounted. 

If you have an build in SD-Card-Reader this is normally /dev/mmcblk0p1 ( in Debian )
If you have an USB-Card-Reader this is something like /dev/sdc ( in Debian )
* Open an Terminal and input "'''lsblk'''"
* You will get a list with the actual Block-Devices
* The SD-Card should be of type 'disk'

You can also try gparted to see which devices you have and identify the SD-card from there

==== '''Install''' the image to the SD-Card ====
{{warning
| Warning, this will destroy everything on the device ! So please be very sure which device is you SD-Card !
}}
# Here it will be /dev/sd'''x'''

(note that the x after the sd is the drive letter, it could be ''sd'''b''''' sd'''c''''' or ''sd'''d''''' and so on, lets say its sd'''c'''. Which means c is the drive letter for the SD-card and that sd- a and -b are in use for other things. 
 
When writing to the device, make sure not to include the following number, which is the partition ''sdc'''1''''' ''sdc'''2''''' etc. since we are using the base card here) 
 
This means considerations for partitions and filesystem are taken care of, so no need to worry about that. Do ''not'' pick the wrong drive however, since dd will happily write the image to somewhere it isn't supposed to if you just give it root privileges and hit enter.) 
 
#Copy image to SD-Card with "'''dd if=<image.img> of=/dev/sdx'''"

You now have Pandian installed on your SD card and its ready to go. :) However after copying the image to the SD-Card resizing the partitionspartitions is needed to fully utilize the space, since by default the install is limited to 2GB. (If your card is bigger Pandian is still limited to those 2GB)

====(Optional) '''Resize''' SD-Card ====

* This can be done with gparted on linux|gnu
* start gparted

[[File:Gparted resize 001.png|800px|thumbnail|none|The actual partitions of the SD-CARD. Please select the correct device at the top right corner.]]
[[File:Gparted resize 002.png|800px|thumbnail|none|Rightclick to the second partition and select Resize/Move]]
[[File:Gparted resize 003.png|400px|thumbnail|none|You see the actual Size of this partition]]
[[File:Gparted resize 004.png|400px|thumbnail|none|Move the slider to the right, or set "Free space following" to 0]]
[[File:Gparted resize 005.png|800px|thumbnail|none|After you press the "Resize/Move" button, you get the preview of the new partition structure]]
[[File:Gparted resize 006.png|800px|thumbnail|none|When you press "Apply all operations", youve got a warning that you can loss your Data. THIS IS THE LAST CHANGE TO CHECK IF YOU SELECTED THE CORRECT DEVICE.

 Press Apply if everything is correct.]]

* After everything is fine, you have a fresh install of Pandian on you SD-Card
 

=== '''Startup''' wizard ===
* Upon first boot of Pandian, there is a first-start-wizard which guides you through some basic settings.
These are: Locale, timezone, time and date, password for admin and user setup and finally calibration of the touchscreen.
The script is located in /usr/sbin/pdSetup should you need to run it again.

==== Navigation ====
* Inside a dialog you can navigate with the cross/dpad
* Hit space to select a checkbox
* Moving between <Ok> and <Cancel> can be down with the use of TAB ( Tap Fn then tap Space )
* Acknowledge with Enter

=== '''Network''' connection instructions:===

====normal ====
* Use network-manager

====minimal====
* Use ceni network manager

===(Optional) '''Update''' of Pandian system ===
* After you setup your Pandora, it is useful to update your system. It is a rolling release, which means since the image was made, the system is forever updated with new packages.
* open a terminal
* get root ( command is: "su" )
* enter "apt-get update" to download package information from the repositories
* enter "apt-get upgrade" to update all packages that are out of date
(pandian packages are also updated this way :)
* Note: to update only the pandian-packages enter "apt-get upgrade pandian*"

===== Upgrade from "minimal" to "normal" =====
It is possible to upgrade from the "minimal"-image to the "normal"-image.
This can simlpy be done by installing the pandian-lxde debian package
* get an connection to the internet(tm) with ceni
* open an terminal
* get root ( with command: "su" )
* update package list with: "apt-get update"
* install debian-lxde with "apt-get install debian-lxde"

===(Optional) '''Information''' ===

=== Additional Users/Groups ===
There are additional Users/Groups added to the standard debian-users
==== Groups ====
* admin
:This superuser privilege is used by sudo for admin task like shutdown etc.
* mpd
:This user/group has access to mpd-related files ( socket, pid-files )

==== Power-Modes ====
===== LID-Close =====
* If the lid is closed only the screen will be disabled
===== Low-Power-Mode / Shutdown =====
[[File:Lead Photo For Power modes0-2920264867079787.jpg|thumbnail|right|Switch]]
* Switch to left: Pandora will go to low power mode ( reduce CPU, Disable LID, Pause processes )
* Switch to right: Shutdown the pandora

==== pdcmd ====
* This script handles all system-related stuff, like lid, low-power, usb or wifi.
* This should run as root
 
Usage:
{| class="wikitable"
|-
! Command !! What's done
|-
| /usr/sbin/pdcmd LCDBright + || Increase the light of the lid
|-
| /usr/sbin/pdcmd LCDBright - || Decrease the light of the lid
|-
| /usr/sbin/pdcmd LCDBright 10 || Set the Brightness of the lid to 10
|-
| /usr/sbin/pdcmd LCDTrigger || Trigger the lid ( WARNING: THIS DISABLES THE LID ! )
|-
| /usr/sbin/pdcmd USBNetTrigger || Enable the USB-Networking (module g_ether). If usbnetworking is on, it will disable it
|-
| /usr/sbin/pdcmd USBHostTrigger || Enable the USB-Host (module ehci-hcd). If USB-Host is on, it will disable it
|-
| /usr/sbin/pdcmd WLANTrigger || Enable Wifi. If Wifi is enabled it will be disabled
|}

== Old releases ==

=== Mark2 minimal-hf2014-01-02 ===

{| class="wikitable"
|-
! Version !! Description !! Included !! Link !! Checksums (sha256)
|-
| minimal || pandian without any Desktop environment but with the basic pandian package || nano || [http://www.filedropper.com/pandian-mark2-minimal-hf2014-01-02 filedropper: pandian-mark2-minimal-hf2014-01-02] [http://pandian.openpandora.org/releases/pandian-mark2-minimal-hf_2014-01-02.7z pandian.openpandora.org: pandian-mark2-minimal-hf_2014-01-02.7z] || pandian-mark2-minimal-hf_2014-01-02.7z a35106473e54c55d64c7eae2088d8c267b605baf17d5338b8e2938dbfe3c01ca pandian-mark2-minimal-hf_2014-01-02.img c68a42c1aef0238c1dd6ff33b628a2c0dea812a7b5b2d906afb185f93f940f84
|-
| minimal-networking fix|| HotFix for pandian-mark2-minimal-hf_2014-01-02 [[#Network_Fix_for_pandian-minimal|Instructions]] || dhcp, network manager || [http://www.filedropper.com/pandian-mark2-minimal-networking2014-01-02tar filedropper: pandian-mark2-minimal-networking_2014-01-02.tar.gz] [http://pandian.openpandora.org/releases/pandian-mark2-minimal-networking_2014-01-02.tar.gz pandian.openpandora.org: pandian-mark2-minimal-networking_2014-01-02.tar.gz] || 4cf802391360e5bf183e9d4b5fe8b6f407b3e476baec7b5b0aa7340796680ae6 pandian-mark2-minimal-networking_2014-01-02.tar.gz
|}

===== Network Fix for pandian-minimal =====
If you download the '''pandian-mark2-minimal-hf_2014-01-02''' image there is a lack of tools for setup wifi networking. 
'''Note: For the actual download of pandian-minimal, wifi-network-tools are included'''
* Therefore download the fix and place it on the SD-Card where pandian is installed. (you need to have local superuser privileges on your own system as the SD contents aren't owned by your user)
* Boot pandian-minimal
* login with user: "root"
* switch to root-directory: "cd /"
* untar the network-fix: "tar -xf /path-where-file-is-located/pandian-mark2-minimal-networking_2014-01-03.tar.gz"
* setup the fix with command "pdMinimalNetwork"

* after the script is finished, run "ceni" and setup your wifi-connection

=== 01 ===
'''Full debian GNU/Linux 7.2 codename Wheezy (stable) with LXDE desktop environment 
hardfloat armv7l released Date: 29.09.2013'''
[http://boards.openpandora.org/topic/14482-pandian-01/ forum link]
===Features===

* Hard-Float-ABI
* Ext4 Root for better performance
* Working Touch-Screen
* Working Nubs
* Screen-Off on LID-Close
* Low-Power-Mode
* WLAN
* Music ( with Sonata/MPD )
* Automount

=== Upcoming/Ideas ===

* Assistant for tzdata
* libpnd - PND-Support
* OpenGL not tested yet
* Aptitude
* Minimal-Network-Installation
* Pandian-Debian-Repository for special packages ( libpnd, touch-screen-calibrator )
* of course, in-system-documentation ( Documentation on the pandora )

Download [http://www.share-online.biz/dl/TPMFFXTM2AU here]

[http://boards.openpandora.org/topic/14482-pandian-01 Forum thread]

=== Installation ===

note: It is assumed here, that the card-reader load the card as /dev/sdc.
Please check before which device is your SD-card !
This can be checked with gparted. Minimum requirement 2GB SD-card.

# Download Image ( as 7z )
# Verify md5-checksum: pandian-stable-hf_2013-09-29.001.7z '''2a85bbb40bbe7c6e8f92f058e150951a''' pandian-stable-hf_2013-09-29.001.img '''e62d101dc708de49af1ca7743e2df2bd'''
# Unzip with 7z ( in Linux with 7zr e <image.7z> )
# Copy image to SD-Card ( dd if=<image.img> of=/dev/sdx ) Don't specify "bs="

Username: ''Pandian'' 
Root password: ''Root'' (change after intsallation as per instructions below)

#Open a terminal
#Type "su"
#Type "passwd"
#Enter your new root password when prompted, and then again to confirm.
#Dont forget your password

=== Resize ===
Default installation is limited to 2GB, if you want to expand it, you can, provided you have installed it on a bigger SD-card and want to make use of the space.

* Size will be changed with parted
* parted /dev/sdx
* show size with "print free"

# (parted) print free # Model: USB Mass Storage Device (scsi)
# Disk /dev/sdc: 7965MB# Sector size (logical/physical): 512B/512B# Partition Table: msdos

{| class="wikitable"
|-
| Number || Start || End || Size || Type || File system || Flags
|-
| || 32,3kB || 1049kB || 1016kB || || Free Space ||
|-
| 1 || 1049kB || 53,5MB || 52,4MB || primary || fat32 ||
|-
| 2 || 53,5MB || 1933MB || 1879MB || primary || ext4 ||
|-
| || 1933MB || 7965MB || 6032MB || || Free Space ||
|}

we would like to resize the second partition to the nearly end ( -512MB for swap )
# (parted) resizepart # Partition number? 2 # Warning: Partition /dev/sdc2 is being used. Are you sure you want to continue?# Yes/No? YES # End? [1933MB]? 7453MB this is how the partitions looks like after

(parted) print free * Model: USB Mass Storage Device (scsi)* Disk /dev/sdc: 7965MB* Sector size (logical/physical): 512B/512B* Partition Table: msdos

{| class="wikitable"
|-
| Number || Start || End || Size || Type || File system || Flags
|-
| || 32,3kB || 1049kB || 1016kB || || Free Space ||
|-
| 1 || 1049kB || 53,5MB || 52,4MB || primary || fat32 ||
|-
| 2 || 53,5MB || '''7453'''MB || '''7400'''MB || primary || ext4 ||
|-
| || '''7453'''MB || 7965MB || '''512'''MB || || Free Space ||
|}

create Swap (optional)

(parted) mkpart primary linux-swap
Start? 7453MB
End? 7965MB

this is how the partitions looks like after

(parted) print free * Model: USB Mass Storage Device (scsi)* Disk /dev/sdc: 7965MB* Sector size (logical/physical): 512B/512B* Partition Table: msdos

{| class="wikitable"
|-
| Number || Start || End || Size || Type || File system || Flags
|-
| || 32,3kB || 1049kB || 1016kB || || Free Space ||
|-
| 1 || 1049kB || 53,5MB || 52,4MB || primary || fat32 ||
|-
| 2 || 53,5MB || 7453MB || 7400MB || primary || ext4 ||
|-
| || '''7453MB''' || '''7453MB''' || '''278kB''' || || '''Free Space'''||
|-
| || 7453MB || 7965MB || 512MB || '''primary''' || Free Space ||
|}
disregard the 4th entry, the new resized partition is the last one.

resize filesystem
*resize2fs /dev/sdc2

create swap

*mkswap /dev/sdc3

[[Category:Documentation]]
[[Category:Operating system]]
[[Category:Software]]

Pandian

2014-01-04T13:17:41Z

Stackshadow: /* (Optional) Update of Pandian system */ Update only pandian-related packages

[[File:Post-3032-0-90501200-1380479048.png|thumbnail|Logo]]

'''Pandian is an debian-based armhf desktop and CLI distro for your Pandora.'''
Ideas, Bugs, or feature-requests? Report to:
http://www.evilbrain.de/projects/pandian/issues

=== Main Features ===
* The debian way.
* Access to all packages from Debian software repositories.
* Pandian hosts its own Debian repo http://pandian.openpandora.org with up to date scripts, all settings and extra programs.
* armhf-build, which means '''f'''loat operations are relegated to special '''h'''ardware rather than taxing the main cpu with them (as with softfloat)

== '''Pandian''' - '''MARK 2''' The newest release ==
Second version of Pandian 
'''Full Debian GNU/Linux based on sid branch with LXDE desktop environment (normal) or CLI (minimal-) build.''' 
'''hardfloat armv7l''' yule release '''Date: 29.12.2013'''
[http://boards.openpandora.org/topic/15302-pandian-mark2/ forum link]

=== '''Installation''' requirements===
* '''Pandora''' ;) All versions fine?
* '''SD card''' minimum 2GB ( was tested with 4GB )
* '''PC''' Linux|GNU, BSD, Mac, or Windows for putting the install on the aforementioned SD-card.

==== '''Download''' a version of Pandian ====
There are two different versions of the "MARK2" release:
{| class="wikitable"
|-
! Version !! Description !! Includes !! Link !! Checksums (sha256)
|-
| '''normal''' || pandian for regular users, with full Desktop environment ( LXDE ) || network-manager MediaPlayer ( mpd with gurlp ) nub-support calibrator-application medit Text editor. mpd audio player backend, glurp as frontend || [http://www.filedropper.com/pandian-mark2-hf2014-01-02 filedropper: pandian-mark2-hf2014-01-02] [http://pandian.openpandora.org/releases/pandian-mark2-hf_2014-01-02.7z pandian.openpandora.org: pandian-mark2-hf_2014-01-02.7z] || pandian-mark2-hf_2014-01-02.7z 3731d70a4d8ec59e79a046f34f69c5c809be73e38cfc91a5b580478b8f8c222f pandian-mark2-hf_2014-01-02.img 83b8d3fa5bd0588cfb8b11cfe6b827819e6311e98396a6e32c46c9692f072e96
|-
| '''minimal''' || pandian without any Desktop environment but with the basic pandian package. Can be [[#Upgrade_from_.22minimal.22_to_.22normal.22| upgraded to "normal"]]|| ACPI support for brighter/darker-buttons, for lid and for low-power-mode. pdcmd nano, ceni network manager || [http://www.filedropper.com/pandian-mark2-minimal-hf2014-01-03 filedropper: pandian-mark2-minimal-hf_2014-01-03.7z] [http://pandian.openpandora.org/releases/pandian-mark2-minimal-hf_2014-01-03.7z pandian.openpandora.org: pandian-mark2-minimal-hf_2014-01-03.7z] || pandian-mark2-minimal-hf_2014-01-03.7z 9f5989d8fa4dec74c827b2f54a676edc61e83d2e913d5efbdd42c73ed2ad6165 pandian-mark2-minimal-hf_2014-01-03.img 2540eea88773342f1e6f68b7e4ff759ea8b36b9acee178c6c552a975621727d3
|}
Notes:
* It is trivial to change from LXDE to [[Xfce]] (or any other desktop environment), adding a new user interface atop the minimal install is more advanced as manual setup of USB-Networking or wifi is needed to do so.
* All images have automount ( for USB-Sticks, external Hard-Drives etc. ) and ALSA sound support

==== '''Verify''' that your download is OK ====
* After you download the version you picked, verify its checksum to make sure the integrity of the downloaded file matches (in being an exact copy the one on the server)

#open up a terminal
# "'''sha256sum ~/downloads/pandian/<image.7Z>'''" (input where you have the file and the one you chose to download)
# make sure it matches the given md5sum, if not, try to download another copy. This step isnt mandatory, but its there to make sure everything is fine before we proceed.

==== '''Unzip''' the downloaded image ====
*Unzipping 7z archives
# Open up a terminal (or do it your way)
# Enter"'''7zr e <image.7z>'''"
# You now have an unzipped image

==== (Optional) '''Preparation''', find out where to install ====

This step helps you find out where the SD card is mounted. 

If you have an build in SD-Card-Reader this is normally /dev/mmcblk0p1 ( in Debian )
If you have an USB-Card-Reader this is something like /dev/sdc ( in Debian )
* Open an Terminal and input "'''lsblk'''"
* You will get a list with the actual Block-Devices
* The SD-Card should be of type 'disk'

You can also try gparted to see which devices you have and identify the SD-card from there

==== '''Install''' the image to the SD-Card ====
{{warning
| Warning, this will destroy everything on the device ! So please be very sure which device is you SD-Card !
}}
# Here it will be /dev/sdx

(note that its sd and then a letter, could be ''sd'''b'''''''sd'''c''''' or ''sd'''d''''' and so on, lets say its sdc. This is the drive letter 
 
Make sure not to include the following number, which is the partition ''sdc'''1''''' ''sdc'''2''''' etc. since we are using the base card here) 
 
This means considerations for partitions and filesystem are taken care of, so no need to worry about that. Do not pick the wrong drive however, since dd will happily write the image to somewhere it isnt supposed to if you tell it to) 
 
# Copy image to SD-Card with "'''dd if=<image.img> of=/dev/sdx'''"

You now have Pandian installed on your SD card and its ready to go. :) However after copying the image to the SD-Card resizing the partitionspartitions is needed to fully utilize the space, since by default the install is limited to 2GB. (If your card is bigger Pandian is still limited to those 2GB)

====(Optional) '''Resize''' SD-Card ====

* This can be done with gparted on linux|gnu
* start gparted

[[File:Gparted resize 001.png|800px|thumbnail|none|The actual partitions of the SD-CARD. Please select the correct device at the top right corner.]]
[[File:Gparted resize 002.png|800px|thumbnail|none|Rightclick to the second partition and select Resize/Move]]
[[File:Gparted resize 003.png|400px|thumbnail|none|You see the actual Size of this partition]]
[[File:Gparted resize 004.png|400px|thumbnail|none|Move the slider to the right, or set "Free space following" to 0]]
[[File:Gparted resize 005.png|800px|thumbnail|none|After you press the "Resize/Move" button, you get the preview of the new partition structure]]
[[File:Gparted resize 006.png|800px|thumbnail|none|When you press "Apply all operations", youve got a warning that you can loss your Data. THIS IS THE LAST CHANGE TO CHECK IF YOU SELECTED THE CORRECT DEVICE.

 Press Apply if everything is correct.]]

* After everything is fine, you have your new fresh Pandian on you SD-Card
 

=== '''Startup''' wizard ===
* Upon first boot of Pandian, there is a first-start-wizard which guides you through some basic settings.
Locale, timezone, time and date, password for admin and user setup and calibration of touchscreen.
Located in /usr/sbin/pdSetup should you need to run it again

==== Navigation ====
* Inside a dialog you can navigate with the cross
* With space you select a checkbox
* Moving between <Ok> and <Cancel> can be down with the use of TAB ( Tap Fn then tap Space )
* Acknowledge with Enter

=== '''Network''' connection instructions:===

====normal ====
* Use network-manager

====minimal====
* Use ceni network manager

===(Optional) '''Update''' of Pandian system ===
* After you setup your Pandora, it is useful to update your system. It is a rolling release, which means since the image was made, the system is forever updated with new packages.
* open a terminal
* get root ( command is: "su" )
* enter "apt-get update" to download package information from the repositories
* enter "apt-get upgrade" to update all packages that are out of date
(pandian packages are also updated this way :)
* Note: to update only the pandian-packages enter "apt-get upgrade pandian*"

===== Upgrade from "minimal" to "normal" =====
It is possible to upgrade from the "minimal"-image to the "normal"-image.
This can simlpy be done by installing the pandian-lxde debian package
* get an connection to the internet(tm) with ceni
* open an terminal
* get root ( with command: "su" )
* update package list with: "apt-get update"
* install debian-lxde with "apt-get install debian-lxde"

===(Optional) '''Information''' ===

=== Additional Users/Groups ===
There are additional Users/Groups added to the standard debian-users
==== Groups ====
* admin
:This superuser privilege is used by sudo for admin task like shutdown etc.
* mpd
:This user/group has access to mpd-related files ( socket, pid-files )

==== Power-Modes ====
===== LID-Close =====
* If the lid is closed only the screen will be disabled
===== Low-Power-Mode / Shutdown =====
[[File:Lead Photo For Power modes0-2920264867079787.jpg|thumbnail|right|Switch]]
* Switch to left: Pandora will go to low power mode ( reduce CPU, Disable LID, Pause processes )
* Switch to right: Shutdown the pandora

==== pdcmd ====
* This script handles all system-related stuff, like lid, low-power, usb or wifi.
* This should run as root
 
Usage:
{| class="wikitable"
|-
! Command !! What's done
|-
| /usr/sbin/pdcmd LCDBright + || Increase the light of the lid
|-
| /usr/sbin/pdcmd LCDBright - || Decrease the light of the lid
|-
| /usr/sbin/pdcmd LCDBright 10 || Set the Brightness of the lid to 10
|-
| /usr/sbin/pdcmd LCDTrigger || Trigger the lid ( WARNING: THIS DISABLES THE LID ! )
|-
| /usr/sbin/pdcmd USBNetTrigger || Enable the USB-Networking (module g_ether). If usbnetworking is on, it will disable it
|-
| /usr/sbin/pdcmd USBHostTrigger || Enable the USB-Host (module ehci-hcd). If USB-Host is on, it will disable it
|-
| /usr/sbin/pdcmd WLANTrigger || Enable Wifi. If Wifi is enabled it will be disabled
|}

== Old releases ==

=== Mark2 minimal-hf2014-01-02 ===

{| class="wikitable"
|-
! Version !! Description !! Included !! Link !! Checksums (sha256)
|-
| minimal || pandian without any Desktop environment but with the basic pandian package || nano || [http://www.filedropper.com/pandian-mark2-minimal-hf2014-01-02 filedropper: pandian-mark2-minimal-hf2014-01-02] [http://pandian.openpandora.org/releases/pandian-mark2-minimal-hf_2014-01-02.7z pandian.openpandora.org: pandian-mark2-minimal-hf_2014-01-02.7z] || pandian-mark2-minimal-hf_2014-01-02.7z a35106473e54c55d64c7eae2088d8c267b605baf17d5338b8e2938dbfe3c01ca pandian-mark2-minimal-hf_2014-01-02.img c68a42c1aef0238c1dd6ff33b628a2c0dea812a7b5b2d906afb185f93f940f84
|-
| minimal-networking fix|| HotFix for pandian-mark2-minimal-hf_2014-01-02 [[#Network_Fix_for_pandian-minimal|Instructions]] || dhcp, network manager || [http://www.filedropper.com/pandian-mark2-minimal-networking2014-01-02tar filedropper: pandian-mark2-minimal-networking_2014-01-02.tar.gz] [http://pandian.openpandora.org/releases/pandian-mark2-minimal-networking_2014-01-02.tar.gz pandian.openpandora.org: pandian-mark2-minimal-networking_2014-01-02.tar.gz] || 4cf802391360e5bf183e9d4b5fe8b6f407b3e476baec7b5b0aa7340796680ae6 pandian-mark2-minimal-networking_2014-01-02.tar.gz
|}

===== Network Fix for pandian-minimal =====
If you download the '''pandian-mark2-minimal-hf_2014-01-02''' image there is a lack of tools for setup wifi networking. 
'''Note: For the actual download of pandian-minimal, wifi-network-tools are included'''
* Therefore download the fix and place it on the SD-Card where pandian is installed. (you need to have local superuser privileges on your own system as the SD contents aren't owned by your user)
* Boot pandian-minimal
* login with user: "root"
* switch to root-directory: "cd /"
* untar the network-fix: "tar -xf /path-where-file-is-located/pandian-mark2-minimal-networking_2014-01-03.tar.gz"
* setup the fix with command "pdMinimalNetwork"

* after the script is finished, run "ceni" and setup your wifi-connection

=== 01 ===
'''Full debian GNU/Linux 7.2 codename Wheezy (stable) with LXDE desktop environment 
hardfloat armv7l released Date: 29.09.2013'''
[http://boards.openpandora.org/topic/14482-pandian-01/ forum link]
===Features===

* Hard-Float-ABI
* Ext4 Root for better performance
* Working Touch-Screen
* Working Nubs
* Screen-Off on LID-Close
* Low-Power-Mode
* WLAN
* Music ( with Sonata/MPD )
* Automount

=== Upcoming/Ideas ===

* Assistant for tzdata
* libpnd - PND-Support
* OpenGL not tested yet
* Aptitude
* Minimal-Network-Installation
* Pandian-Debian-Repository for special packages ( libpnd, touch-screen-calibrator )
* of course, in-system-documentation ( Documentation on the pandora )

Download [http://www.share-online.biz/dl/TPMFFXTM2AU here]

[http://boards.openpandora.org/topic/14482-pandian-01 Forum thread]

=== Installation ===

note: It is assumed here, that the card-reader load the card as /dev/sdc.
Please check before which device is your SD-card !
This can be checked with gparted. Minimum requirement 2GB SD-card.

# Download Image ( as 7z )
# Verify md5-checksum: pandian-stable-hf_2013-09-29.001.7z '''2a85bbb40bbe7c6e8f92f058e150951a''' pandian-stable-hf_2013-09-29.001.img '''e62d101dc708de49af1ca7743e2df2bd'''
# Unzip with 7z ( in Linux with 7zr e <image.7z> )
# Copy image to SD-Card ( dd if=<image.img> of=/dev/sdx ) Don't specify "bs="

Username: ''Pandian'' 
Root password: ''Root'' (change after intsallation as per instructions below)

#Open a terminal
#Type "su"
#Type "passwd"
#Enter your new root password when prompted, and then again to confirm.
#Dont forget your password

=== Resize ===
Default installation is limited to 2GB, if you want to expand it, you can, provided you have installed it on a bigger SD-card and want to make use of the space.

* Size will be changed with parted
* parted /dev/sdx
* show size with "print free"

# (parted) print free # Model: USB Mass Storage Device (scsi)
# Disk /dev/sdc: 7965MB# Sector size (logical/physical): 512B/512B# Partition Table: msdos

{| class="wikitable"
|-
| Number || Start || End || Size || Type || File system || Flags
|-
| || 32,3kB || 1049kB || 1016kB || || Free Space ||
|-
| 1 || 1049kB || 53,5MB || 52,4MB || primary || fat32 ||
|-
| 2 || 53,5MB || 1933MB || 1879MB || primary || ext4 ||
|-
| || 1933MB || 7965MB || 6032MB || || Free Space ||
|}

we would like to resize the second partition to the nearly end ( -512MB for swap )
# (parted) resizepart # Partition number? 2 # Warning: Partition /dev/sdc2 is being used. Are you sure you want to continue?# Yes/No? YES # End? [1933MB]? 7453MB this is how the partitions looks like after

(parted) print free * Model: USB Mass Storage Device (scsi)* Disk /dev/sdc: 7965MB* Sector size (logical/physical): 512B/512B* Partition Table: msdos

{| class="wikitable"
|-
| Number || Start || End || Size || Type || File system || Flags
|-
| || 32,3kB || 1049kB || 1016kB || || Free Space ||
|-
| 1 || 1049kB || 53,5MB || 52,4MB || primary || fat32 ||
|-
| 2 || 53,5MB || '''7453'''MB || '''7400'''MB || primary || ext4 ||
|-
| || '''7453'''MB || 7965MB || '''512'''MB || || Free Space ||
|}

create Swap (optional)

(parted) mkpart primary linux-swap
Start? 7453MB
End? 7965MB

this is how the partitions looks like after

(parted) print free * Model: USB Mass Storage Device (scsi)* Disk /dev/sdc: 7965MB* Sector size (logical/physical): 512B/512B* Partition Table: msdos

{| class="wikitable"
|-
| Number || Start || End || Size || Type || File system || Flags
|-
| || 32,3kB || 1049kB || 1016kB || || Free Space ||
|-
| 1 || 1049kB || 53,5MB || 52,4MB || primary || fat32 ||
|-
| 2 || 53,5MB || 7453MB || 7400MB || primary || ext4 ||
|-
| || '''7453MB''' || '''7453MB''' || '''278kB''' || || '''Free Space'''||
|-
| || 7453MB || 7965MB || 512MB || '''primary''' || Free Space ||
|}
disregard the 4th entry, the new resized partition is the last one.

resize filesystem
*resize2fs /dev/sdc2

create swap

*mkswap /dev/sdc3

[[Category:Documentation]]
[[Category:Operating system]]
[[Category:Software]]

Pandian

2014-01-03T20:42:12Z

Stackshadow: /* MARK2 */ Add how to upgrade to "normal" from "minimal"

[[File:Post-3032-0-90501200-1380479048.png|thumbnail|Logo]]

'''Pandian is an debian-based armhf desktop and CLI distro for your Pandora.'''

== Help / Bugs / Features ==
Ideas, Bugs, or features-requests? Report to:
http://www.evilbrain.de/projects/pandian/issues

== MARK2 ==
Second version 
'''Full Debian GNU/Linux based on sid branch with LXDE desktop environment (normal) or CLI (minimal-) build.''' 
'''hardfloat armv7l''' yule release '''Date: 29.12.2013'''
[http://boards.openpandora.org/topic/15302-pandian-mark2/ forum link]
=== Main Features ===
* The debian way.
* Access to all packages from debian software repositories.
* Debian repository hosted on http://pandian.openpandora.org so keep pandian scripts up to date
* armhf means '''f'''loat operations are relegated to special '''h'''ardware for this rather than taxing the main cpu (as with softfloat)

=== Requirements ===
* Of course a Pandora ;) All versions fine?
* SD card minimum 2GB ( was tested with 4GB )
* A Linux or Windows PC for putting the install on the aforementioned SD-card.

=== Which version is right for you ? ===
There are two different versions of the "MARK2" release:
{| class="wikitable"
|-
! Version !! Description !! Link !! Checksums (sha256)
|-
| normal || pandian with fully Desktop environment ( LXDE ) || [http://www.filedropper.com/pandian-mark2-hf2014-01-02 filedropper: pandian-mark2-hf2014-01-02] [http://pandian.openpandora.org/releases/pandian-mark2-hf_2014-01-02.7z pandian.openpandora.org: pandian-mark2-hf_2014-01-02.7z] || pandian-mark2-hf_2014-01-02.7z 3731d70a4d8ec59e79a046f34f69c5c809be73e38cfc91a5b580478b8f8c222f pandian-mark2-hf_2014-01-02.img 83b8d3fa5bd0588cfb8b11cfe6b827819e6311e98396a6e32c46c9692f072e96
|-
| minimal || pandian without any Desktop environment but with the basic pandian package || [http://www.filedropper.com/pandian-mark2-minimal-hf2014-01-03 filedropper: pandian-mark2-minimal-hf_2014-01-03.7z] [http://pandian.openpandora.org/releases/pandian-mark2-minimal-hf_2014-01-03.7z pandian.openpandora.org: pandian-mark2-minimal-hf_2014-01-03.7z] || pandian-mark2-minimal-hf_2014-01-03.7z 9f5989d8fa4dec74c827b2f54a676edc61e83d2e913d5efbdd42c73ed2ad6165 pandian-mark2-minimal-hf_2014-01-03.img 2540eea88773342f1e6f68b7e4ff759ea8b36b9acee178c6c552a975621727d3
|-
| minimal-networking || Hot-Fix for pandian-mark2-minimal-hf_'''2014-01-02'''. [[#Network_Fix_for_pandian-minimal|See here]] || [http://www.filedropper.com/pandian-mark2-minimal-networking2014-01-02tar filedropper: pandian-mark2-minimal-networking_2014-01-02.tar.gz] [http://pandian.openpandora.org/releases/pandian-mark2-minimal-networking_2014-01-02.tar.gz pandian.openpandora.org: pandian-mark2-minimal-networking_2014-01-02.tar.gz] || 4cf802391360e5bf183e9d4b5fe8b6f407b3e476baec7b5b0aa7340796680ae6 pandian-mark2-minimal-networking_2014-01-02.tar.gz
|}

* "normal" is intended for regular users, who want a easy desktop that just works.
* If you don't like LXDE as Desktop you can change it, adding a user interface atop the minimal install is more advanced as setup of USB-Networking or interfaces for wifi is needed to do so.

* Every setting of MARK2 is split into debian packages which are hosted on http://pandian.openpandora.org

==== pandian package ( the basis of "minimal" ) ====
Core package which contains following features:
* ACPI support for brighter/darker-buttons, for lid and for low-power-mode
* first-use-wizard
* automount ( for USB-Stick, external Hard-Drives etc )
* alsa sound support
* pdcmd
* [[#Upgrade_from_.22minimal.22_to_.22normal.22|See here to upgrade from "minimal" to "normal"]]
==== pandian-lxde package ( what is added to make it "normal" ) ====
Meta package featuring
* full desktop environment (LXDE)
* Easy Wifi-Access trough network-manager
* MediaPlayer ( mpd with gurlp )
* nub-support
* calibrator-application

* After you download the files, verify the checksums to make sure the integrity of the file downloaded matches in being an exact copy of the file downloaded from the server

#open a terminal
# sha256sum ~/downloads/pandian - - -- .7Z (input where you have the file and the one you chose to download)
# make sure it matches the given md5sum, if not, try to download another copy.

=== Putting the downloaded image on SD-card ===

==== Linux ====
===== Verify your SD-Hardware =====
Check where your SD-Card is located.
If you have an build in SD-Card-Reader this is normally /dev/mmcblk0p1 ( in Debian )
If you have an USB-Card-Reader this is something like /dev/sdc ( in Debian )
* Open an Terminal and input "lsblk"
* You get an list with the actual Block-Devices
* The SD-Card should be as type disk

You can also try gparted to see which devices you have and identify the SD-card

===== Unzip =====
# Unzip with 7z ( in Linux with 7zr e <image.7z> )

===== Copy the image to the SD-Card =====
{{warning
| Warning, this will destroy everything on the device ! So please be very sure which device is you SD-Card !
}}
# Here it will be /dev/sdx

(note that its sd and then a letter, sdc for example not the following number, as that is the partition, we are using the base card here) This means considerations for partitions and filesystem are taken care of, so no need to worry about that. Do not pick the wrong drive however, since dd will happily write the image to somewhere it isnt supposed to if you tell it to)

# Copy image to SD-Card with "dd if=<image.img> of=/dev/sdx"

You now have Pandian installed on your SD card and its ready to go. :) However after copying the image to the SD-Card resizing the partitionspartitions is needed to fully utilize the space, since by default the install is limited to 2GB. (If your card is bigger Pandian is still limited to those 2GB)

===== Resize SD-Card =====

* This can be done with gparted on linux|gnu
* start gparted

[[File:Gparted resize 001.png|800px|thumbnail|none|The actual partitions of the SD-CARD. Please select the correct device at the top right corner.]]
[[File:Gparted resize 002.png|800px|thumbnail|none|Rightclick to the second partition and select Resize/Move]]
[[File:Gparted resize 003.png|400px|thumbnail|none|You see the actual Size of this partition]]
[[File:Gparted resize 004.png|400px|thumbnail|none|Move the slider to the right, or set "Free space following" to 0]]
[[File:Gparted resize 005.png|800px|thumbnail|none|After you press the "Resize/Move" button, you get the preview of the new partition structure]]
[[File:Gparted resize 006.png|800px|thumbnail|none|When you press "Apply all operations", youve got a warning that you can loss your Data. THIS IS THE LAST CHANGE TO CHECK IF YOU SELECTED THE CORRECT DEVICE.

 Press Apply if everything is correct.]]

* After everything is fine, you have your new fresh Pandian on you SD-Card
 
===== Upgrade from "minimal" to "normal" =====
It is possible to upgrade from the "minimal"-image to the "normal"-image.
This can simlpy be done by installing the debian package for pandian-lxde
* get an connection to the internet(tm) with ceni
* open an terminal
* get root ( with command: "su" )
* update package list with: "apt-get update"
* install debian-lxde with "apt-get install debian-lxde"

=== Network Fix for pandian-minimal ===
If you download the '''pandian-mark2-minimal-hf_2014-01-02''' image there is a lack of tools for setup wifi networking. 
'''Note: For the actual download of pandian-minimal, wifi-network-tools are included'''
* Therefore download the fix and place it on the SD-Card where pandian is installed.
* Boot pandian-minimal
* login with user: "root"
* switch to root-directory: "cd /"
* untar the network-fix: "tar -xf /path-where-file-is-located/pandian-mark2-minimal-networking_2014-01-03.tar.gz"
* setup the fix with command "pdMinimalNetwork"
* after the script is finished, run "ceni" and setup your wifi-connection

=== First-start ===
* Upon first boot of Pandian, there is a first-start-wizard which guides you through some basic settings.
Locale, timezone, time and date, password for admin and user setup and calibration of touchscreen.
Located in /usr/sbin/pdSetup should you need to run it again

==== Navigation ====
* Inside a dialog you can navigate with the cross
* With space you select a checkbox
* Moving between <Ok> and <Cancel> can be down with the use of TAB ( Tap Fn then tap Space )
* Acknowledge with Enter

==== Update ( Optional ) ====
* After you setup your Pandora, it is useful to update your system. It is a rolling release, which means since the image was made, the system is forever updated with new packages.
* open a terminal
* get root ( command is: "su" )
* enter "apt-get update" to download package information from the repositories
* enter "apt-get upgrade" to update all packages that are out of date
(pandian packages are also updated this way :)

=== Preinstalled packages ===
These are the packages which come with the different versions of MARK2:
==== minimal ====
==== LXDE ====
* of course LXDE
* Text-Editor: medit
* Audio: mpd als backend, glurp as frontend

=== Additional Users/Groups ===
There are additional Users/Groups added to the standard debian-users
==== Groups ====
* admin
:This superuser privilege is used by sudo for admin task like shutdown etc.
* mpd
:This user/group has access to mpd-related files ( socket, pid-files )

=== User-Guide Section===

==== Power-Modes ====
===== LID-Close =====
* If the lid is closed only the screen will be disabled
===== Low-Power-Mode / Shutdown =====
[[File:Lead Photo For Power modes0-2920264867079787.jpg|thumbnail|right|Switch]]
* Switch to left: Pandora will go to low power mode ( reduce CPU, Disable LID, Pause processes )
* Switch to right: Shutdown the pandora

==== pdcmd ====
* This script handles all system-related stuff, like lid, low-power, usb or wifi.
* This should run as root
 
Usage:
{| class="wikitable"
|-
! Command !! What's done
|-
| /usr/sbin/pdcmd LCDBright + || Increase the light of the lid
|-
| /usr/sbin/pdcmd LCDBright - || Decrease the light of the lid
|-
| /usr/sbin/pdcmd LCDBright 10 || Set the Brightness of the lid to 10
|-
| /usr/sbin/pdcmd LCDTrigger || Trigger the lid ( WARNING: THIS DISABLES THE LID ! )
|-
| /usr/sbin/pdcmd USBNetTrigger || Enable the USB-Networking (module g_ether). If usbnetworking is on, it will disable it
|-
| /usr/sbin/pdcmd USBHostTrigger || Enable the USB-Host (module ehci-hcd). If USB-Host is on, it will disable it
|-
| /usr/sbin/pdcmd WLANTrigger || Enable Wifi. If Wifi is enabled it will be disabled
|}

== Old releases ==

=== 01 ===
'''Full debian GNU/Linux 7.2 codename Wheezy (stable) with LXDE desktop environment 
hardfloat armv7l released Date: 29.09.2013'''
[http://boards.openpandora.org/topic/14482-pandian-01/ forum link]
===Features===

* Hard-Float-ABI
* Ext4 Root for better performance
* Working Touch-Screen
* Working Nubs
* Screen-Off on LID-Close
* Low-Power-Mode
* WLAN
* Music ( with Sonata/MPD )
* Automount

=== Upcoming/Ideas ===

* Assistant for tzdata
* libpnd - PND-Support
* OpenGL not tested yet
* Aptitude
* Minimal-Network-Installation
* Pandian-Debian-Repository for special packages ( libpnd, touch-screen-calibrator )
* of course, in-system-documentation ( Documentation on the pandora )

Download [http://www.share-online.biz/dl/TPMFFXTM2AU here]

[http://boards.openpandora.org/topic/14482-pandian-01 Forum thread]

=== Installation ===

note: It is assumed here, that the card-reader load the card as /dev/sdc.
Please check before which device is your SD-card !
This can be checked with gparted. Minimum requirement 2GB SD-card.

# Download Image ( as 7z )
# Verify md5-checksum: pandian-stable-hf_2013-09-29.001.7z '''2a85bbb40bbe7c6e8f92f058e150951a''' pandian-stable-hf_2013-09-29.001.img '''e62d101dc708de49af1ca7743e2df2bd'''
# Unzip with 7z ( in Linux with 7zr e <image.7z> )
# Copy image to SD-Card ( dd if=<image.img> of=/dev/sdx ) Don't specify "bs="

Username: ''Pandian'' 
Root password: ''Root'' (change after intsallation as per instructions below)

#Open a terminal
#Type "su"
#Type "passwd"
#Enter your new root password when prompted, and then again to confirm.
#Dont forget your password

=== Resize ===
Default installation is limited to 2GB, if you want to expand it, you can, provided you have installed it on a bigger SD-card and want to make use of the space.

* Size will be changed with parted
* parted /dev/sdx
* show size with "print free"

# (parted) print free # Model: USB Mass Storage Device (scsi)
# Disk /dev/sdc: 7965MB# Sector size (logical/physical): 512B/512B# Partition Table: msdos

{| class="wikitable"
|-
| Number || Start || End || Size || Type || File system || Flags
|-
| || 32,3kB || 1049kB || 1016kB || || Free Space ||
|-
| 1 || 1049kB || 53,5MB || 52,4MB || primary || fat32 ||
|-
| 2 || 53,5MB || 1933MB || 1879MB || primary || ext4 ||
|-
| || 1933MB || 7965MB || 6032MB || || Free Space ||
|}

we would like to resize the second partition to the nearly end ( -512MB for swap )
# (parted) resizepart # Partition number? 2 # Warning: Partition /dev/sdc2 is being used. Are you sure you want to continue?# Yes/No? YES # End? [1933MB]? 7453MB this is how the partitions looks like after

(parted) print free * Model: USB Mass Storage Device (scsi)* Disk /dev/sdc: 7965MB* Sector size (logical/physical): 512B/512B* Partition Table: msdos

{| class="wikitable"
|-
| Number || Start || End || Size || Type || File system || Flags
|-
| || 32,3kB || 1049kB || 1016kB || || Free Space ||
|-
| 1 || 1049kB || 53,5MB || 52,4MB || primary || fat32 ||
|-
| 2 || 53,5MB || '''7453'''MB || '''7400'''MB || primary || ext4 ||
|-
| || '''7453'''MB || 7965MB || '''512'''MB || || Free Space ||
|}

create Swap (optional)

(parted) mkpart primary linux-swap
Start? 7453MB
End? 7965MB

this is how the partitions looks like after

(parted) print free * Model: USB Mass Storage Device (scsi)* Disk /dev/sdc: 7965MB* Sector size (logical/physical): 512B/512B* Partition Table: msdos

{| class="wikitable"
|-
| Number || Start || End || Size || Type || File system || Flags
|-
| || 32,3kB || 1049kB || 1016kB || || Free Space ||
|-
| 1 || 1049kB || 53,5MB || 52,4MB || primary || fat32 ||
|-
| 2 || 53,5MB || 7453MB || 7400MB || primary || ext4 ||
|-
| || '''7453MB''' || '''7453MB''' || '''278kB''' || || '''Free Space'''||
|-
| || 7453MB || 7965MB || 512MB || '''primary''' || Free Space ||
|}
disregard the 4th entry, the new resized partition is the last one.

resize filesystem
*resize2fs /dev/sdc2

create swap

*mkswap /dev/sdc3

[[Category:Documentation]]
[[Category:Operating system]]
[[Category:Software]]

Pandian

2014-01-03T20:32:00Z

Stackshadow: /* Network Fix for pandian-minimal */

[[File:Post-3032-0-90501200-1380479048.png|thumbnail|Logo]]

'''Pandian is an debian-based armhf desktop and CLI distro for your Pandora.'''

== Help / Bugs / Features ==
Ideas, Bugs, or features-requests? Report to:
http://www.evilbrain.de/projects/pandian/issues

== MARK2 ==
Second version 
'''Full Debian GNU/Linux based on sid branch with LXDE desktop environment (normal) or CLI (minimal-) build.''' 
'''hardfloat armv7l''' yule release '''Date: 29.12.2013'''
[http://boards.openpandora.org/topic/15302-pandian-mark2/ forum link]
=== Main Features ===
* The debian way.
* Access to all packages from debian software repositories.
* Debian repository hosted on http://pandian.openpandora.org so keep pandian scripts up to date
* armhf means '''f'''loat operations are relegated to special '''h'''ardware for this rather than taxing the main cpu (as with softfloat)

=== Requirements ===
* Of course a Pandora ;) All versions fine?
* SD card minimum 2GB ( was tested with 4GB )
* A Linux or Windows PC for putting the install on the aforementioned SD-card.

=== Which version is right for you ? ===
There are two different versions of the "MARK2" release:
{| class="wikitable"
|-
! Version !! Description !! Link !! Checksums (sha256)
|-
| normal || pandian with fully Desktop environment ( LXDE ) || [http://www.filedropper.com/pandian-mark2-hf2014-01-02 filedropper: pandian-mark2-hf2014-01-02] [http://pandian.openpandora.org/releases/pandian-mark2-hf_2014-01-02.7z pandian.openpandora.org: pandian-mark2-hf_2014-01-02.7z] || pandian-mark2-hf_2014-01-02.7z 3731d70a4d8ec59e79a046f34f69c5c809be73e38cfc91a5b580478b8f8c222f pandian-mark2-hf_2014-01-02.img 83b8d3fa5bd0588cfb8b11cfe6b827819e6311e98396a6e32c46c9692f072e96
|-
| minimal || pandian without any Desktop environment but with the basic pandian package || [http://www.filedropper.com/pandian-mark2-minimal-hf2014-01-03 filedropper: pandian-mark2-minimal-hf_2014-01-03.7z] [http://pandian.openpandora.org/releases/pandian-mark2-minimal-hf_2014-01-03.7z pandian.openpandora.org: pandian-mark2-minimal-hf_2014-01-03.7z] || pandian-mark2-minimal-hf_2014-01-03.7z 9f5989d8fa4dec74c827b2f54a676edc61e83d2e913d5efbdd42c73ed2ad6165 pandian-mark2-minimal-hf_2014-01-03.img 2540eea88773342f1e6f68b7e4ff759ea8b36b9acee178c6c552a975621727d3
|-
| minimal-networking || Hot-Fix for pandian-mark2-minimal-hf_'''2014-01-02'''. [[#Network_Fix_for_pandian-minimal|See here]] || [http://www.filedropper.com/pandian-mark2-minimal-networking2014-01-02tar filedropper: pandian-mark2-minimal-networking_2014-01-02.tar.gz] [http://pandian.openpandora.org/releases/pandian-mark2-minimal-networking_2014-01-02.tar.gz pandian.openpandora.org: pandian-mark2-minimal-networking_2014-01-02.tar.gz] || 4cf802391360e5bf183e9d4b5fe8b6f407b3e476baec7b5b0aa7340796680ae6 pandian-mark2-minimal-networking_2014-01-02.tar.gz
|}

* "normal" is intended for regular users, who want a easy desktop that just works.
* If you don't like LXDE as Desktop you can change it, adding a user interface atop the minimal install is more advanced as setup of USB-Networking or interfaces for wifi is needed to do so.

* Every setting of MARK2 is split into debian packages which are hosted on http://pandian.openpandora.org

==== pandian package ( the basis of "minimal" ) ====
Core package which contains following features:
* ACPI support for brighter/darker-buttons, for lid and for low-power-mode
* first-use-wizard
* automount ( for USB-Stick, external Hard-Drives etc )
* alsa sound support
* pdcmd
==== pandian-lxde package ( what is added to make it "normal" ) ====
Meta package featuring
* full desktop environment (LXDE)
* Easy Wifi-Access trough network-manager
* MediaPlayer ( mpd with gurlp )
* nub-support
* calibrator-application

* After you download the files, verify the checksums to make sure the integrity of the file downloaded matches in being an exact copy of the file downloaded from the server

#open a terminal
# sha256sum ~/downloads/pandian - - -- .7Z (input where you have the file and the one you chose to download)
# make sure it matches the given md5sum, if not, try to download another copy.

=== Putting the downloaded image on SD-card ===

==== Linux ====
===== Verify your SD-Hardware =====
Check where your SD-Card is located.
If you have an build in SD-Card-Reader this is normally /dev/mmcblk0p1 ( in Debian )
If you have an USB-Card-Reader this is something like /dev/sdc ( in Debian )
* Open an Terminal and input "lsblk"
* You get an list with the actual Block-Devices
* The SD-Card should be as type disk

You can also try gparted to see which devices you have and identify the SD-card

===== Unzip =====
# Unzip with 7z ( in Linux with 7zr e <image.7z> )

===== Copy the image to the SD-Card =====
{{warning
| Warning, this will destroy everything on the device ! So please be very sure which device is you SD-Card !
}}
# Here it will be /dev/sdx

(note that its sd and then a letter, sdc for example not the following number, as that is the partition, we are using the base card here) This means considerations for partitions and filesystem are taken care of, so no need to worry about that. Do not pick the wrong drive however, since dd will happily write the image to somewhere it isnt supposed to if you tell it to)

# Copy image to SD-Card with "dd if=<image.img> of=/dev/sdx"

You now have Pandian installed on your SD card and its ready to go. :) However after copying the image to the SD-Card resizing the partitionspartitions is needed to fully utilize the space, since by default the install is limited to 2GB. (If your card is bigger Pandian is still limited to those 2GB)

===== Resize SD-Card =====

* This can be done with gparted on linux|gnu
* start gparted

[[File:Gparted resize 001.png|800px|thumbnail|none|The actual partitions of the SD-CARD. Please select the correct device at the top right corner.]]
[[File:Gparted resize 002.png|800px|thumbnail|none|Rightclick to the second partition and select Resize/Move]]
[[File:Gparted resize 003.png|400px|thumbnail|none|You see the actual Size of this partition]]
[[File:Gparted resize 004.png|400px|thumbnail|none|Move the slider to the right, or set "Free space following" to 0]]
[[File:Gparted resize 005.png|800px|thumbnail|none|After you press the "Resize/Move" button, you get the preview of the new partition structure]]
[[File:Gparted resize 006.png|800px|thumbnail|none|When you press "Apply all operations", youve got a warning that you can loss your Data. THIS IS THE LAST CHANGE TO CHECK IF YOU SELECTED THE CORRECT DEVICE.

 Press Apply if everything is correct.]]

* After everything is fine, you have your new fresh Pandian on you SD-Card
 

=== Network Fix for pandian-minimal ===
If you download the '''pandian-mark2-minimal-hf_2014-01-02''' image there is a lack of tools for setup wifi networking. 
'''Note: For the actual download of pandian-minimal, wifi-network-tools are included'''
* Therefore download the fix and place it on the SD-Card where pandian is installed.
* Boot pandian-minimal
* login with user: "root"
* switch to root-directory: "cd /"
* untar the network-fix: "tar -xf /path-where-file-is-located/pandian-mark2-minimal-networking_2014-01-03.tar.gz"
* setup the fix with command "pdMinimalNetwork"
* after the script is finished, run "ceni" and setup your wifi-connection

=== First-start ===
* Upon first boot of Pandian, there is a first-start-wizard which guides you through some basic settings.
Locale, timezone, time and date, password for admin and user setup and calibration of touchscreen.
Located in /usr/sbin/pdSetup should you need to run it again

==== Navigation ====
* Inside a dialog you can navigate with the cross
* With space you select a checkbox
* Moving between <Ok> and <Cancel> can be down with the use of TAB ( Tap Fn then tap Space )
* Acknowledge with Enter

==== Update ( Optional ) ====
* After you setup your Pandora, it is useful to update your system. It is a rolling release, which means since the image was made, the system is forever updated with new packages.
* open a terminal
* get root ( command is: "su" )
* enter "apt-get update" to download package information from the repositories
* enter "apt-get upgrade" to update all packages that are out of date
(pandian packages are also updated this way :)

=== Preinstalled packages ===
These are the packages which come with the different versions of MARK2:
==== minimal ====
==== LXDE ====
* of course LXDE
* Text-Editor: medit
* Audio: mpd als backend, glurp as frontend

=== Additional Users/Groups ===
There are additional Users/Groups added to the standard debian-users
==== Groups ====
* admin
:This superuser privilege is used by sudo for admin task like shutdown etc.
* mpd
:This user/group has access to mpd-related files ( socket, pid-files )

=== User-Guide Section===

==== Power-Modes ====
===== LID-Close =====
* If the lid is closed only the screen will be disabled
===== Low-Power-Mode / Shutdown =====
[[File:Lead Photo For Power modes0-2920264867079787.jpg|thumbnail|right|Switch]]
* Switch to left: Pandora will go to low power mode ( reduce CPU, Disable LID, Pause processes )
* Switch to right: Shutdown the pandora

==== pdcmd ====
* This script handles all system-related stuff, like lid, low-power, usb or wifi.
* This should run as root
 
Usage:
{| class="wikitable"
|-
! Command !! What's done
|-
| /usr/sbin/pdcmd LCDBright + || Increase the light of the lid
|-
| /usr/sbin/pdcmd LCDBright - || Decrease the light of the lid
|-
| /usr/sbin/pdcmd LCDBright 10 || Set the Brightness of the lid to 10
|-
| /usr/sbin/pdcmd LCDTrigger || Trigger the lid ( WARNING: THIS DISABLES THE LID ! )
|-
| /usr/sbin/pdcmd USBNetTrigger || Enable the USB-Networking (module g_ether). If usbnetworking is on, it will disable it
|-
| /usr/sbin/pdcmd USBHostTrigger || Enable the USB-Host (module ehci-hcd). If USB-Host is on, it will disable it
|-
| /usr/sbin/pdcmd WLANTrigger || Enable Wifi. If Wifi is enabled it will be disabled
|}

== Old releases ==

=== 01 ===
'''Full debian GNU/Linux 7.2 codename Wheezy (stable) with LXDE desktop environment 
hardfloat armv7l released Date: 29.09.2013'''
[http://boards.openpandora.org/topic/14482-pandian-01/ forum link]
===Features===

* Hard-Float-ABI
* Ext4 Root for better performance
* Working Touch-Screen
* Working Nubs
* Screen-Off on LID-Close
* Low-Power-Mode
* WLAN
* Music ( with Sonata/MPD )
* Automount

=== Upcoming/Ideas ===

* Assistant for tzdata
* libpnd - PND-Support
* OpenGL not tested yet
* Aptitude
* Minimal-Network-Installation
* Pandian-Debian-Repository for special packages ( libpnd, touch-screen-calibrator )
* of course, in-system-documentation ( Documentation on the pandora )

Download [http://www.share-online.biz/dl/TPMFFXTM2AU here]

[http://boards.openpandora.org/topic/14482-pandian-01 Forum thread]

=== Installation ===

note: It is assumed here, that the card-reader load the card as /dev/sdc.
Please check before which device is your SD-card !
This can be checked with gparted. Minimum requirement 2GB SD-card.

# Download Image ( as 7z )
# Verify md5-checksum: pandian-stable-hf_2013-09-29.001.7z '''2a85bbb40bbe7c6e8f92f058e150951a''' pandian-stable-hf_2013-09-29.001.img '''e62d101dc708de49af1ca7743e2df2bd'''
# Unzip with 7z ( in Linux with 7zr e <image.7z> )
# Copy image to SD-Card ( dd if=<image.img> of=/dev/sdx ) Don't specify "bs="

Username: ''Pandian'' 
Root password: ''Root'' (change after intsallation as per instructions below)

#Open a terminal
#Type "su"
#Type "passwd"
#Enter your new root password when prompted, and then again to confirm.
#Dont forget your password

=== Resize ===
Default installation is limited to 2GB, if you want to expand it, you can, provided you have installed it on a bigger SD-card and want to make use of the space.

* Size will be changed with parted
* parted /dev/sdx
* show size with "print free"

# (parted) print free # Model: USB Mass Storage Device (scsi)
# Disk /dev/sdc: 7965MB# Sector size (logical/physical): 512B/512B# Partition Table: msdos

{| class="wikitable"
|-
| Number || Start || End || Size || Type || File system || Flags
|-
| || 32,3kB || 1049kB || 1016kB || || Free Space ||
|-
| 1 || 1049kB || 53,5MB || 52,4MB || primary || fat32 ||
|-
| 2 || 53,5MB || 1933MB || 1879MB || primary || ext4 ||
|-
| || 1933MB || 7965MB || 6032MB || || Free Space ||
|}

we would like to resize the second partition to the nearly end ( -512MB for swap )
# (parted) resizepart # Partition number? 2 # Warning: Partition /dev/sdc2 is being used. Are you sure you want to continue?# Yes/No? YES # End? [1933MB]? 7453MB this is how the partitions looks like after

(parted) print free * Model: USB Mass Storage Device (scsi)* Disk /dev/sdc: 7965MB* Sector size (logical/physical): 512B/512B* Partition Table: msdos

{| class="wikitable"
|-
| Number || Start || End || Size || Type || File system || Flags
|-
| || 32,3kB || 1049kB || 1016kB || || Free Space ||
|-
| 1 || 1049kB || 53,5MB || 52,4MB || primary || fat32 ||
|-
| 2 || 53,5MB || '''7453'''MB || '''7400'''MB || primary || ext4 ||
|-
| || '''7453'''MB || 7965MB || '''512'''MB || || Free Space ||
|}

create Swap (optional)

(parted) mkpart primary linux-swap
Start? 7453MB
End? 7965MB

this is how the partitions looks like after

(parted) print free * Model: USB Mass Storage Device (scsi)* Disk /dev/sdc: 7965MB* Sector size (logical/physical): 512B/512B* Partition Table: msdos

{| class="wikitable"
|-
| Number || Start || End || Size || Type || File system || Flags
|-
| || 32,3kB || 1049kB || 1016kB || || Free Space ||
|-
| 1 || 1049kB || 53,5MB || 52,4MB || primary || fat32 ||
|-
| 2 || 53,5MB || 7453MB || 7400MB || primary || ext4 ||
|-
| || '''7453MB''' || '''7453MB''' || '''278kB''' || || '''Free Space'''||
|-
| || 7453MB || 7965MB || 512MB || '''primary''' || Free Space ||
|}
disregard the 4th entry, the new resized partition is the last one.

resize filesystem
*resize2fs /dev/sdc2

create swap

*mkswap /dev/sdc3

[[Category:Documentation]]
[[Category:Operating system]]
[[Category:Software]]

Pandian

2014-01-03T20:30:00Z

Stackshadow: /* Which version is right for you ? */ append new minimal image

[[File:Post-3032-0-90501200-1380479048.png|thumbnail|Logo]]

'''Pandian is an debian-based armhf desktop and CLI distro for your Pandora.'''

== Help / Bugs / Features ==
Ideas, Bugs, or features-requests? Report to:
http://www.evilbrain.de/projects/pandian/issues

== MARK2 ==
Second version 
'''Full Debian GNU/Linux based on sid branch with LXDE desktop environment (normal) or CLI (minimal-) build.''' 
'''hardfloat armv7l''' yule release '''Date: 29.12.2013'''
[http://boards.openpandora.org/topic/15302-pandian-mark2/ forum link]
=== Main Features ===
* The debian way.
* Access to all packages from debian software repositories.
* Debian repository hosted on http://pandian.openpandora.org so keep pandian scripts up to date
* armhf means '''f'''loat operations are relegated to special '''h'''ardware for this rather than taxing the main cpu (as with softfloat)

=== Requirements ===
* Of course a Pandora ;) All versions fine?
* SD card minimum 2GB ( was tested with 4GB )
* A Linux or Windows PC for putting the install on the aforementioned SD-card.

=== Which version is right for you ? ===
There are two different versions of the "MARK2" release:
{| class="wikitable"
|-
! Version !! Description !! Link !! Checksums (sha256)
|-
| normal || pandian with fully Desktop environment ( LXDE ) || [http://www.filedropper.com/pandian-mark2-hf2014-01-02 filedropper: pandian-mark2-hf2014-01-02] [http://pandian.openpandora.org/releases/pandian-mark2-hf_2014-01-02.7z pandian.openpandora.org: pandian-mark2-hf_2014-01-02.7z] || pandian-mark2-hf_2014-01-02.7z 3731d70a4d8ec59e79a046f34f69c5c809be73e38cfc91a5b580478b8f8c222f pandian-mark2-hf_2014-01-02.img 83b8d3fa5bd0588cfb8b11cfe6b827819e6311e98396a6e32c46c9692f072e96
|-
| minimal || pandian without any Desktop environment but with the basic pandian package || [http://www.filedropper.com/pandian-mark2-minimal-hf2014-01-03 filedropper: pandian-mark2-minimal-hf_2014-01-03.7z] [http://pandian.openpandora.org/releases/pandian-mark2-minimal-hf_2014-01-03.7z pandian.openpandora.org: pandian-mark2-minimal-hf_2014-01-03.7z] || pandian-mark2-minimal-hf_2014-01-03.7z 9f5989d8fa4dec74c827b2f54a676edc61e83d2e913d5efbdd42c73ed2ad6165 pandian-mark2-minimal-hf_2014-01-03.img 2540eea88773342f1e6f68b7e4ff759ea8b36b9acee178c6c552a975621727d3
|-
| minimal-networking || Hot-Fix for pandian-mark2-minimal-hf_'''2014-01-02'''. [[#Network_Fix_for_pandian-minimal|See here]] || [http://www.filedropper.com/pandian-mark2-minimal-networking2014-01-02tar filedropper: pandian-mark2-minimal-networking_2014-01-02.tar.gz] [http://pandian.openpandora.org/releases/pandian-mark2-minimal-networking_2014-01-02.tar.gz pandian.openpandora.org: pandian-mark2-minimal-networking_2014-01-02.tar.gz] || 4cf802391360e5bf183e9d4b5fe8b6f407b3e476baec7b5b0aa7340796680ae6 pandian-mark2-minimal-networking_2014-01-02.tar.gz
|}

* "normal" is intended for regular users, who want a easy desktop that just works.
* If you don't like LXDE as Desktop you can change it, adding a user interface atop the minimal install is more advanced as setup of USB-Networking or interfaces for wifi is needed to do so.

* Every setting of MARK2 is split into debian packages which are hosted on http://pandian.openpandora.org

==== pandian package ( the basis of "minimal" ) ====
Core package which contains following features:
* ACPI support for brighter/darker-buttons, for lid and for low-power-mode
* first-use-wizard
* automount ( for USB-Stick, external Hard-Drives etc )
* alsa sound support
* pdcmd
==== pandian-lxde package ( what is added to make it "normal" ) ====
Meta package featuring
* full desktop environment (LXDE)
* Easy Wifi-Access trough network-manager
* MediaPlayer ( mpd with gurlp )
* nub-support
* calibrator-application

* After you download the files, verify the checksums to make sure the integrity of the file downloaded matches in being an exact copy of the file downloaded from the server

#open a terminal
# sha256sum ~/downloads/pandian - - -- .7Z (input where you have the file and the one you chose to download)
# make sure it matches the given md5sum, if not, try to download another copy.

=== Putting the downloaded image on SD-card ===

==== Linux ====
===== Verify your SD-Hardware =====
Check where your SD-Card is located.
If you have an build in SD-Card-Reader this is normally /dev/mmcblk0p1 ( in Debian )
If you have an USB-Card-Reader this is something like /dev/sdc ( in Debian )
* Open an Terminal and input "lsblk"
* You get an list with the actual Block-Devices
* The SD-Card should be as type disk

You can also try gparted to see which devices you have and identify the SD-card

===== Unzip =====
# Unzip with 7z ( in Linux with 7zr e <image.7z> )

===== Copy the image to the SD-Card =====
{{warning
| Warning, this will destroy everything on the device ! So please be very sure which device is you SD-Card !
}}
# Here it will be /dev/sdx

(note that its sd and then a letter, sdc for example not the following number, as that is the partition, we are using the base card here) This means considerations for partitions and filesystem are taken care of, so no need to worry about that. Do not pick the wrong drive however, since dd will happily write the image to somewhere it isnt supposed to if you tell it to)

# Copy image to SD-Card with "dd if=<image.img> of=/dev/sdx"

You now have Pandian installed on your SD card and its ready to go. :) However after copying the image to the SD-Card resizing the partitionspartitions is needed to fully utilize the space, since by default the install is limited to 2GB. (If your card is bigger Pandian is still limited to those 2GB)

===== Resize SD-Card =====

* This can be done with gparted on linux|gnu
* start gparted

[[File:Gparted resize 001.png|800px|thumbnail|none|The actual partitions of the SD-CARD. Please select the correct device at the top right corner.]]
[[File:Gparted resize 002.png|800px|thumbnail|none|Rightclick to the second partition and select Resize/Move]]
[[File:Gparted resize 003.png|400px|thumbnail|none|You see the actual Size of this partition]]
[[File:Gparted resize 004.png|400px|thumbnail|none|Move the slider to the right, or set "Free space following" to 0]]
[[File:Gparted resize 005.png|800px|thumbnail|none|After you press the "Resize/Move" button, you get the preview of the new partition structure]]
[[File:Gparted resize 006.png|800px|thumbnail|none|When you press "Apply all operations", youve got a warning that you can loss your Data. THIS IS THE LAST CHANGE TO CHECK IF YOU SELECTED THE CORRECT DEVICE.

 Press Apply if everything is correct.]]

* After everything is fine, you have your new fresh Pandian on you SD-Card
 

=== Network Fix for pandian-minimal ===
If you download the pandian-mark2-minimal-hf_2014-01-02 image there is a lack of tools for setup wifi networking.
* Therefore download the fix and place it on the SD-Card where pandian is installed.
* Boot pandian-minimal
* login with user: "root"
* switch to root-directory: "cd /"
* untar the network-fix: "tar -xf /path-where-file-is-located/pandian-mark2-minimal-networking_2014-01-03.tar.gz"
* setup the fix with command "pdMinimalNetwork"
* after the script is finished, run "ceni" and setup your wifi-connection

=== First-start ===
* Upon first boot of Pandian, there is a first-start-wizard which guides you through some basic settings.
Locale, timezone, time and date, password for admin and user setup and calibration of touchscreen.
Located in /usr/sbin/pdSetup should you need to run it again

==== Navigation ====
* Inside a dialog you can navigate with the cross
* With space you select a checkbox
* Moving between <Ok> and <Cancel> can be down with the use of TAB ( Tap Fn then tap Space )
* Acknowledge with Enter

==== Update ( Optional ) ====
* After you setup your Pandora, it is useful to update your system. It is a rolling release, which means since the image was made, the system is forever updated with new packages.
* open a terminal
* get root ( command is: "su" )
* enter "apt-get update" to download package information from the repositories
* enter "apt-get upgrade" to update all packages that are out of date
(pandian packages are also updated this way :)

=== Preinstalled packages ===
These are the packages which come with the different versions of MARK2:
==== minimal ====
==== LXDE ====
* of course LXDE
* Text-Editor: medit
* Audio: mpd als backend, glurp as frontend

=== Additional Users/Groups ===
There are additional Users/Groups added to the standard debian-users
==== Groups ====
* admin
:This superuser privilege is used by sudo for admin task like shutdown etc.
* mpd
:This user/group has access to mpd-related files ( socket, pid-files )

=== User-Guide Section===

==== Power-Modes ====
===== LID-Close =====
* If the lid is closed only the screen will be disabled
===== Low-Power-Mode / Shutdown =====
[[File:Lead Photo For Power modes0-2920264867079787.jpg|thumbnail|right|Switch]]
* Switch to left: Pandora will go to low power mode ( reduce CPU, Disable LID, Pause processes )
* Switch to right: Shutdown the pandora

==== pdcmd ====
* This script handles all system-related stuff, like lid, low-power, usb or wifi.
* This should run as root
 
Usage:
{| class="wikitable"
|-
! Command !! What's done
|-
| /usr/sbin/pdcmd LCDBright + || Increase the light of the lid
|-
| /usr/sbin/pdcmd LCDBright - || Decrease the light of the lid
|-
| /usr/sbin/pdcmd LCDBright 10 || Set the Brightness of the lid to 10
|-
| /usr/sbin/pdcmd LCDTrigger || Trigger the lid ( WARNING: THIS DISABLES THE LID ! )
|-
| /usr/sbin/pdcmd USBNetTrigger || Enable the USB-Networking (module g_ether). If usbnetworking is on, it will disable it
|-
| /usr/sbin/pdcmd USBHostTrigger || Enable the USB-Host (module ehci-hcd). If USB-Host is on, it will disable it
|-
| /usr/sbin/pdcmd WLANTrigger || Enable Wifi. If Wifi is enabled it will be disabled
|}

== Old releases ==

=== 01 ===
'''Full debian GNU/Linux 7.2 codename Wheezy (stable) with LXDE desktop environment 
hardfloat armv7l released Date: 29.09.2013'''
[http://boards.openpandora.org/topic/14482-pandian-01/ forum link]
===Features===

* Hard-Float-ABI
* Ext4 Root for better performance
* Working Touch-Screen
* Working Nubs
* Screen-Off on LID-Close
* Low-Power-Mode
* WLAN
* Music ( with Sonata/MPD )
* Automount

=== Upcoming/Ideas ===

* Assistant for tzdata
* libpnd - PND-Support
* OpenGL not tested yet
* Aptitude
* Minimal-Network-Installation
* Pandian-Debian-Repository for special packages ( libpnd, touch-screen-calibrator )
* of course, in-system-documentation ( Documentation on the pandora )

Download [http://www.share-online.biz/dl/TPMFFXTM2AU here]

[http://boards.openpandora.org/topic/14482-pandian-01 Forum thread]

=== Installation ===

note: It is assumed here, that the card-reader load the card as /dev/sdc.
Please check before which device is your SD-card !
This can be checked with gparted. Minimum requirement 2GB SD-card.

# Download Image ( as 7z )
# Verify md5-checksum: pandian-stable-hf_2013-09-29.001.7z '''2a85bbb40bbe7c6e8f92f058e150951a''' pandian-stable-hf_2013-09-29.001.img '''e62d101dc708de49af1ca7743e2df2bd'''
# Unzip with 7z ( in Linux with 7zr e <image.7z> )
# Copy image to SD-Card ( dd if=<image.img> of=/dev/sdx ) Don't specify "bs="

Username: ''Pandian'' 
Root password: ''Root'' (change after intsallation as per instructions below)

#Open a terminal
#Type "su"
#Type "passwd"
#Enter your new root password when prompted, and then again to confirm.
#Dont forget your password

=== Resize ===
Default installation is limited to 2GB, if you want to expand it, you can, provided you have installed it on a bigger SD-card and want to make use of the space.

* Size will be changed with parted
* parted /dev/sdx
* show size with "print free"

# (parted) print free # Model: USB Mass Storage Device (scsi)
# Disk /dev/sdc: 7965MB# Sector size (logical/physical): 512B/512B# Partition Table: msdos

{| class="wikitable"
|-
| Number || Start || End || Size || Type || File system || Flags
|-
| || 32,3kB || 1049kB || 1016kB || || Free Space ||
|-
| 1 || 1049kB || 53,5MB || 52,4MB || primary || fat32 ||
|-
| 2 || 53,5MB || 1933MB || 1879MB || primary || ext4 ||
|-
| || 1933MB || 7965MB || 6032MB || || Free Space ||
|}

we would like to resize the second partition to the nearly end ( -512MB for swap )
# (parted) resizepart # Partition number? 2 # Warning: Partition /dev/sdc2 is being used. Are you sure you want to continue?# Yes/No? YES # End? [1933MB]? 7453MB this is how the partitions looks like after

(parted) print free * Model: USB Mass Storage Device (scsi)* Disk /dev/sdc: 7965MB* Sector size (logical/physical): 512B/512B* Partition Table: msdos

{| class="wikitable"
|-
| Number || Start || End || Size || Type || File system || Flags
|-
| || 32,3kB || 1049kB || 1016kB || || Free Space ||
|-
| 1 || 1049kB || 53,5MB || 52,4MB || primary || fat32 ||
|-
| 2 || 53,5MB || '''7453'''MB || '''7400'''MB || primary || ext4 ||
|-
| || '''7453'''MB || 7965MB || '''512'''MB || || Free Space ||
|}

create Swap (optional)

(parted) mkpart primary linux-swap
Start? 7453MB
End? 7965MB

this is how the partitions looks like after

(parted) print free * Model: USB Mass Storage Device (scsi)* Disk /dev/sdc: 7965MB* Sector size (logical/physical): 512B/512B* Partition Table: msdos

{| class="wikitable"
|-
| Number || Start || End || Size || Type || File system || Flags
|-
| || 32,3kB || 1049kB || 1016kB || || Free Space ||
|-
| 1 || 1049kB || 53,5MB || 52,4MB || primary || fat32 ||
|-
| 2 || 53,5MB || 7453MB || 7400MB || primary || ext4 ||
|-
| || '''7453MB''' || '''7453MB''' || '''278kB''' || || '''Free Space'''||
|-
| || 7453MB || 7965MB || 512MB || '''primary''' || Free Space ||
|}
disregard the 4th entry, the new resized partition is the last one.

resize filesystem
*resize2fs /dev/sdc2

create swap

*mkswap /dev/sdc3

[[Category:Documentation]]
[[Category:Operating system]]
[[Category:Software]]

Pandian

2014-01-03T17:20:17Z

Stackshadow: Fix link to "Network Fix for pandian-minimal"

[[File:Post-3032-0-90501200-1380479048.png|thumbnail|Logo]]

'''Pandian is an debian-based armhf desktop and CLI distro for your Pandora.'''

== Help / Bugs / Features ==
Ideas, Bugs, or features-requests? Report to:
http://www.evilbrain.de/projects/pandian/issues

== MARK2 ==
Second version 
'''Full Debian GNU/Linux based on sid branch with LXDE desktop environment (normal) or CLI (minimal-) build.''' 
'''hardfloat armv7l''' yule release '''Date: 29.12.2013'''
[http://boards.openpandora.org/topic/15302-pandian-mark2/ forum link]
=== Main Features ===
* The debian way.
* Access to all packages from debian software repositories.
* Debian repository hosted on http://pandian.openpandora.org so keep pandian scripts up to date
* armhf means '''f'''loat operations are relegated to special '''h'''ardware for this rather than taxing the main cpu (as with softfloat)

=== Requirements ===
* Of course a Pandora ;) All versions fine?
* SD card minimum 2GB ( was tested with 4GB )
* A Linux or Windows PC for putting the install on the aforementioned SD-card.

=== Which version is right for you ? ===
There are two different versions of the "MARK2" release:
{| class="wikitable"
|-
! Version !! Description !! Link !! Checksums
|-
| normal || pandian with fully Desktop environment ( LXDE ) || [http://www.filedropper.com/pandian-mark2-hf2014-01-02 filedropper: pandian-mark2-hf2014-01-02] [http://pandian.openpandora.org/releases/pandian-mark2-hf_2014-01-02.7z pandian.openpandora.org: pandian-mark2-hf_2014-01-02.7z] || pandian-mark2-hf_2014-01-02.7z 3731d70a4d8ec59e79a046f34f69c5c809be73e38cfc91a5b580478b8f8c222f pandian-mark2-hf_2014-01-02.img 83b8d3fa5bd0588cfb8b11cfe6b827819e6311e98396a6e32c46c9692f072e96
|-
| minimal || pandian without any Desktop environment but with the basic pandian package || [http://www.filedropper.com/pandian-mark2-minimal-hf2014-01-02 filedropper: pandian-mark2-minimal-hf2014-01-02] [http://pandian.openpandora.org/releases/pandian-mark2-minimal-hf_2014-01-02.7z pandian.openpandora.org: pandian-mark2-minimal-hf_2014-01-02.7z] || pandian-mark2-minimal-hf_2014-01-02.7z a35106473e54c55d64c7eae2088d8c267b605baf17d5338b8e2938dbfe3c01ca pandian-mark2-minimal-hf_2014-01-02.img c68a42c1aef0238c1dd6ff33b628a2c0dea812a7b5b2d906afb185f93f940f84
|-
| minimal-networking || Hot-Fix for pandian-mark2-minimal-hf_2014-01-02. [[#Network_Fix_for_pandian-minimal|See here]] || [http://www.filedropper.com/pandian-mark2-minimal-networking2014-01-02tar filedropper: pandian-mark2-minimal-networking_2014-01-02.tar.gz] [http://pandian.openpandora.org/releases/pandian-mark2-minimal-networking_2014-01-02.tar.gz pandian.openpandora.org: pandian-mark2-minimal-networking_2014-01-02.tar.gz] || 4cf802391360e5bf183e9d4b5fe8b6f407b3e476baec7b5b0aa7340796680ae6 pandian-mark2-minimal-networking_2014-01-02.tar.gz
|}

* "normal" is intended for regular users, who want a easy desktop that just works.
* If you don't like LXDE as Desktop you can change it, adding a user interface atop the minimal install is more advanced as setup of USB-Networking or interfaces for wifi is needed to do so.

* Every setting of MARK2 is split into debian packages which are hosted on http://pandian.openpandora.org

==== pandian package ( the basis of "minimal" ) ====
Core package which contains following features:
* ACPI support for brighter/darker-buttons, for lid and for low-power-mode
* first-use-wizard
* automount ( for USB-Stick, external Hard-Drives etc )
* alsa sound support
* pdcmd
==== pandian-lxde package ( what is added to make it "normal" ) ====
Meta package featuring
* full desktop environment (LXDE)
* Easy Wifi-Access trough network-manager
* MediaPlayer ( mpd with gurlp )
* nub-support
* calibrator-application

* After you download the files, verify the checksums to make sure the integrity of the file downloaded matches in being an exact copy of the file downloaded from the server

#open a terminal
# sha256sum ~/downloads/pandian - - -- .7Z (input where you have the file and the one you chose to download)
# make sure it matches the given md5sum, if not, try to download another copy.

=== Putting the downloaded image on SD-card ===

==== Linux ====
===== Verify your SD-Hardware =====
Check where your SD-Card is located.
If you have an build in SD-Card-Reader this is normally /dev/mmcblk0p1 ( in Debian )
If you have an USB-Card-Reader this is something like /dev/sdc ( in Debian )
* Open an Terminal and input "lsblk"
* You get an list with the actual Block-Devices
* The SD-Card should be as type disk

You can also try gparted to see which devices you have and identify the SD-card

===== Unzip =====
# Unzip with 7z ( in Linux with 7zr e <image.7z> )

===== Copy the image to the SD-Card =====
{{warning
| Warning, this will destroy everything on the device ! So please be very sure which device is you SD-Card !
}}
# Here it will be /dev/sdx

(note that its sd and then a letter, sdc for example not the following number, as that is the partition, we are using the base card here) This means considerations for partitions and filesystem are taken care of, so no need to worry about that. Do not pick the wrong drive however, since dd will happily write the image to somewhere it isnt supposed to if you tell it to)

# Copy image to SD-Card with "dd if=<image.img> of=/dev/sdx"

You now have Pandian installed on your SD card and its ready to go. :) However after copying the image to the SD-Card resizing the partitionspartitions is needed to fully utilize the space, since by default the install is limited to 2GB. (If your card is bigger Pandian is still limited to those 2GB)

===== Resize SD-Card =====

* This can be done with gparted on linux|gnu
* start gparted

[[File:Gparted resize 001.png|800px|thumbnail|none|The actual partitions of the SD-CARD. Please select the correct device at the top right corner.]]
[[File:Gparted resize 002.png|800px|thumbnail|none|Rightclick to the second partition and select Resize/Move]]
[[File:Gparted resize 003.png|400px|thumbnail|none|You see the actual Size of this partition]]
[[File:Gparted resize 004.png|400px|thumbnail|none|Move the slider to the right, or set "Free space following" to 0]]
[[File:Gparted resize 005.png|800px|thumbnail|none|After you press the "Resize/Move" button, you get the preview of the new partition structure]]
[[File:Gparted resize 006.png|800px|thumbnail|none|When you press "Apply all operations", youve got a warning that you can loss your Data. THIS IS THE LAST CHANGE TO CHECK IF YOU SELECTED THE CORRECT DEVICE.

 Press Apply if everything is correct.]]

* After everything is fine, you have your new fresh Pandian on you SD-Card
 

=== Network Fix for pandian-minimal ===
If you download the pandian-mark2-minimal-hf_2014-01-02 image there is a lack of tools for setup wifi networking.
* Therefore download the fix and place it on the SD-Card where pandian is installed.
* Boot pandian-minimal
* login with user: "root"
* switch to root-directory: "cd /"
* untar the network-fix: "tar -xf /path-where-file-is-located/pandian-mark2-minimal-networking_2014-01-03.tar.gz"
* setup the fix with command "pdMinimalNetwork"
* after the script is finished, run "ceni" and setup your wifi-connection

=== First-start ===
* Upon first boot of Pandian, there is a first-start-wizard which guides you through some basic settings.
Locale, timezone, time and date, password for admin and user setup and calibration of touchscreen.
Located in /usr/sbin/pdSetup should you need to run it again

==== Navigation ====
* Inside a dialog you can navigate with the cross
* With space you select a checkbox
* Moving between <Ok> and <Cancel> can be down with the use of TAB ( Tap Fn then tap Space )
* Acknowledge with Enter

==== Update ( Optional ) ====
* After you setup your Pandora, it is useful to update your system. It is a rolling release, which means since the image was made, the system is forever updated with new packages.
* open a terminal
* get root ( command is: "su" )
* enter "apt-get update" to download package information from the repositories
* enter "apt-get upgrade" to update all packages that are out of date
(pandian packages are also updated this way :)

=== Preinstalled packages ===
These are the packages which come with the different versions of MARK2:
==== minimal ====
==== LXDE ====
* of course LXDE
* Text-Editor: medit
* Audio: mpd als backend, glurp as frontend

=== Additional Users/Groups ===
There are additional Users/Groups added to the standard debian-users
==== Groups ====
* admin
:This superuser privilege is used by sudo for admin task like shutdown etc.
* mpd
:This user/group has access to mpd-related files ( socket, pid-files )

=== User-Guide Section===

==== Power-Modes ====
===== LID-Close =====
* If the lid is closed only the screen will be disabled
===== Low-Power-Mode / Shutdown =====
[[File:Lead Photo For Power modes0-2920264867079787.jpg|thumbnail|right|Switch]]
* Switch to left: Pandora will go to low power mode ( reduce CPU, Disable LID, Pause processes )
* Switch to right: Shutdown the pandora

==== pdcmd ====
* This script handles all system-related stuff, like lid, low-power, usb or wifi.
* This should run as root
 
Usage:
{| class="wikitable"
|-
! Command !! What's done
|-
| /usr/sbin/pdcmd LCDBright + || Increase the light of the lid
|-
| /usr/sbin/pdcmd LCDBright - || Decrease the light of the lid
|-
| /usr/sbin/pdcmd LCDBright 10 || Set the Brightness of the lid to 10
|-
| /usr/sbin/pdcmd LCDTrigger || Trigger the lid ( WARNING: THIS DISABLES THE LID ! )
|-
| /usr/sbin/pdcmd USBNetTrigger || Enable the USB-Networking (module g_ether). If usbnetworking is on, it will disable it
|-
| /usr/sbin/pdcmd USBHostTrigger || Enable the USB-Host (module ehci-hcd). If USB-Host is on, it will disable it
|-
| /usr/sbin/pdcmd WLANTrigger || Enable Wifi. If Wifi is enabled it will be disabled
|}

== Old releases ==

=== 01 ===
'''Full debian GNU/Linux 7.2 codename Wheezy (stable) with LXDE desktop environment 
hardfloat armv7l released Date: 29.09.2013'''
[http://boards.openpandora.org/topic/14482-pandian-01/ forum link]
===Features===

* Hard-Float-ABI
* Ext4 Root for better performance
* Working Touch-Screen
* Working Nubs
* Screen-Off on LID-Close
* Low-Power-Mode
* WLAN
* Music ( with Sonata/MPD )
* Automount

=== Upcoming/Ideas ===

* Assistant for tzdata
* libpnd - PND-Support
* OpenGL not tested yet
* Aptitude
* Minimal-Network-Installation
* Pandian-Debian-Repository for special packages ( libpnd, touch-screen-calibrator )
* of course, in-system-documentation ( Documentation on the pandora )

Download [http://www.share-online.biz/dl/TPMFFXTM2AU here]

[http://boards.openpandora.org/topic/14482-pandian-01 Forum thread]

=== Installation ===

note: It is assumed here, that the card-reader load the card as /dev/sdc.
Please check before which device is your SD-card !
This can be checked with gparted. Minimum requirement 2GB SD-card.

# Download Image ( as 7z )
# Verify md5-checksum: pandian-stable-hf_2013-09-29.001.7z '''2a85bbb40bbe7c6e8f92f058e150951a''' pandian-stable-hf_2013-09-29.001.img '''e62d101dc708de49af1ca7743e2df2bd'''
# Unzip with 7z ( in Linux with 7zr e <image.7z> )
# Copy image to SD-Card ( dd if=<image.img> of=/dev/sdx ) Don't specify "bs="

Username: ''Pandian'' 
Root password: ''Root'' (change after intsallation as per instructions below)

#Open a terminal
#Type "su"
#Type "passwd"
#Enter your new root password when prompted, and then again to confirm.
#Dont forget your password

=== Resize ===
Default installation is limited to 2GB, if you want to expand it, you can, provided you have installed it on a bigger SD-card and want to make use of the space.

* Size will be changed with parted
* parted /dev/sdx
* show size with "print free"

# (parted) print free # Model: USB Mass Storage Device (scsi)
# Disk /dev/sdc: 7965MB# Sector size (logical/physical): 512B/512B# Partition Table: msdos

{| class="wikitable"
|-
| Number || Start || End || Size || Type || File system || Flags
|-
| || 32,3kB || 1049kB || 1016kB || || Free Space ||
|-
| 1 || 1049kB || 53,5MB || 52,4MB || primary || fat32 ||
|-
| 2 || 53,5MB || 1933MB || 1879MB || primary || ext4 ||
|-
| || 1933MB || 7965MB || 6032MB || || Free Space ||
|}

we would like to resize the second partition to the nearly end ( -512MB for swap )
# (parted) resizepart # Partition number? 2 # Warning: Partition /dev/sdc2 is being used. Are you sure you want to continue?# Yes/No? YES # End? [1933MB]? 7453MB this is how the partitions looks like after

(parted) print free * Model: USB Mass Storage Device (scsi)* Disk /dev/sdc: 7965MB* Sector size (logical/physical): 512B/512B* Partition Table: msdos

{| class="wikitable"
|-
| Number || Start || End || Size || Type || File system || Flags
|-
| || 32,3kB || 1049kB || 1016kB || || Free Space ||
|-
| 1 || 1049kB || 53,5MB || 52,4MB || primary || fat32 ||
|-
| 2 || 53,5MB || '''7453'''MB || '''7400'''MB || primary || ext4 ||
|-
| || '''7453'''MB || 7965MB || '''512'''MB || || Free Space ||
|}

create Swap (optional)

(parted) mkpart primary linux-swap
Start? 7453MB
End? 7965MB

this is how the partitions looks like after

(parted) print free * Model: USB Mass Storage Device (scsi)* Disk /dev/sdc: 7965MB* Sector size (logical/physical): 512B/512B* Partition Table: msdos

{| class="wikitable"
|-
| Number || Start || End || Size || Type || File system || Flags
|-
| || 32,3kB || 1049kB || 1016kB || || Free Space ||
|-
| 1 || 1049kB || 53,5MB || 52,4MB || primary || fat32 ||
|-
| 2 || 53,5MB || 7453MB || 7400MB || primary || ext4 ||
|-
| || '''7453MB''' || '''7453MB''' || '''278kB''' || || '''Free Space'''||
|-
| || 7453MB || 7965MB || 512MB || '''primary''' || Free Space ||
|}
disregard the 4th entry, the new resized partition is the last one.

resize filesystem
*resize2fs /dev/sdc2

create swap

*mkswap /dev/sdc3

[[Category:Documentation]]
[[Category:Operating system]]
[[Category:Software]]

Pandian

2014-01-03T17:16:53Z

Stackshadow: /* MARK2 */ add pandian-minimal network-fix

[[File:Post-3032-0-90501200-1380479048.png|thumbnail|Logo]]

'''Pandian is an debian-based armhf desktop and CLI distro for your Pandora.'''

== Help / Bugs / Features ==
Ideas, Bugs, or features-requests? Report to:
http://www.evilbrain.de/projects/pandian/issues

== MARK2 ==
Second version 
'''Full Debian GNU/Linux based on sid branch with LXDE desktop environment (normal) or CLI (minimal-) build.''' 
'''hardfloat armv7l''' yule release '''Date: 29.12.2013'''
[http://boards.openpandora.org/topic/15302-pandian-mark2/ forum link]
=== Main Features ===
* The debian way.
* Access to all packages from debian software repositories.
* Debian repository hosted on http://pandian.openpandora.org so keep pandian scripts up to date
* armhf means '''f'''loat operations are relegated to special '''h'''ardware for this rather than taxing the main cpu (as with softfloat)

=== Requirements ===
* Of course a Pandora ;) All versions fine?
* SD card minimum 2GB ( was tested with 4GB )
* A Linux or Windows PC for putting the install on the aforementioned SD-card.

=== Which version is right for you ? ===
There are two different versions of the "MARK2" release:
{| class="wikitable"
|-
! Version !! Description !! Link !! Checksums
|-
| normal || pandian with fully Desktop environment ( LXDE ) || [http://www.filedropper.com/pandian-mark2-hf2014-01-02 filedropper: pandian-mark2-hf2014-01-02] [http://pandian.openpandora.org/releases/pandian-mark2-hf_2014-01-02.7z pandian.openpandora.org: pandian-mark2-hf_2014-01-02.7z] || pandian-mark2-hf_2014-01-02.7z 3731d70a4d8ec59e79a046f34f69c5c809be73e38cfc91a5b580478b8f8c222f pandian-mark2-hf_2014-01-02.img 83b8d3fa5bd0588cfb8b11cfe6b827819e6311e98396a6e32c46c9692f072e96
|-
| minimal || pandian without any Desktop environment but with the basic pandian package || [http://www.filedropper.com/pandian-mark2-minimal-hf2014-01-02 filedropper: pandian-mark2-minimal-hf2014-01-02] [http://pandian.openpandora.org/releases/pandian-mark2-minimal-hf_2014-01-02.7z pandian.openpandora.org: pandian-mark2-minimal-hf_2014-01-02.7z] || pandian-mark2-minimal-hf_2014-01-02.7z a35106473e54c55d64c7eae2088d8c267b605baf17d5338b8e2938dbfe3c01ca pandian-mark2-minimal-hf_2014-01-02.img c68a42c1aef0238c1dd6ff33b628a2c0dea812a7b5b2d906afb185f93f940f84
|-
| minimal-networking || Hot-Fix for pandian-mark2-minimal-hf_2014-01-02. see [[index.php?title=Pandian&action=submit#Network_Fix_for_pandian-minimal|See here]] || [http://www.filedropper.com/pandian-mark2-minimal-networking2014-01-02tar filedropper: pandian-mark2-minimal-networking_2014-01-02.tar.gz] [http://pandian.openpandora.org/releases/pandian-mark2-minimal-networking_2014-01-02.tar.gz pandian.openpandora.org: pandian-mark2-minimal-networking_2014-01-02.tar.gz] || 4cf802391360e5bf183e9d4b5fe8b6f407b3e476baec7b5b0aa7340796680ae6 pandian-mark2-minimal-networking_2014-01-02.tar.gz
|}

* "normal" is intended for regular users, who want a easy desktop that just works.
* If you don't like LXDE as Desktop you can change it, adding a user interface atop the minimal install is more advanced as setup of USB-Networking or interfaces for wifi is needed to do so.

* Every setting of MARK2 is split into debian packages which are hosted on http://pandian.openpandora.org

==== pandian package ( the basis of "minimal" ) ====
Core package which contains following features:
* ACPI support for brighter/darker-buttons, for lid and for low-power-mode
* first-use-wizard
* automount ( for USB-Stick, external Hard-Drives etc )
* alsa sound support
* pdcmd
==== pandian-lxde package ( what is added to make it "normal" ) ====
Meta package featuring
* full desktop environment (LXDE)
* Easy Wifi-Access trough network-manager
* MediaPlayer ( mpd with gurlp )
* nub-support
* calibrator-application

* After you download the files, verify the checksums to make sure the integrity of the file downloaded matches in being an exact copy of the file downloaded from the server

#open a terminal
# sha256sum ~/downloads/pandian - - -- .7Z (input where you have the file and the one you chose to download)
# make sure it matches the given md5sum, if not, try to download another copy.

=== Putting the downloaded image on SD-card ===

==== Linux ====
===== Verify your SD-Hardware =====
Check where your SD-Card is located.
If you have an build in SD-Card-Reader this is normally /dev/mmcblk0p1 ( in Debian )
If you have an USB-Card-Reader this is something like /dev/sdc ( in Debian )
* Open an Terminal and input "lsblk"
* You get an list with the actual Block-Devices
* The SD-Card should be as type disk

You can also try gparted to see which devices you have and identify the SD-card

===== Unzip =====
# Unzip with 7z ( in Linux with 7zr e <image.7z> )

===== Copy the image to the SD-Card =====
{{warning
| Warning, this will destroy everything on the device ! So please be very sure which device is you SD-Card !
}}
# Here it will be /dev/sdx

(note that its sd and then a letter, sdc for example not the following number, as that is the partition, we are using the base card here) This means considerations for partitions and filesystem are taken care of, so no need to worry about that. Do not pick the wrong drive however, since dd will happily write the image to somewhere it isnt supposed to if you tell it to)

# Copy image to SD-Card with "dd if=<image.img> of=/dev/sdx"

You now have Pandian installed on your SD card and its ready to go. :) However after copying the image to the SD-Card resizing the partitionspartitions is needed to fully utilize the space, since by default the install is limited to 2GB. (If your card is bigger Pandian is still limited to those 2GB)

===== Resize SD-Card =====

* This can be done with gparted on linux|gnu
* start gparted

[[File:Gparted resize 001.png|800px|thumbnail|none|The actual partitions of the SD-CARD. Please select the correct device at the top right corner.]]
[[File:Gparted resize 002.png|800px|thumbnail|none|Rightclick to the second partition and select Resize/Move]]
[[File:Gparted resize 003.png|400px|thumbnail|none|You see the actual Size of this partition]]
[[File:Gparted resize 004.png|400px|thumbnail|none|Move the slider to the right, or set "Free space following" to 0]]
[[File:Gparted resize 005.png|800px|thumbnail|none|After you press the "Resize/Move" button, you get the preview of the new partition structure]]
[[File:Gparted resize 006.png|800px|thumbnail|none|When you press "Apply all operations", youve got a warning that you can loss your Data. THIS IS THE LAST CHANGE TO CHECK IF YOU SELECTED THE CORRECT DEVICE.

 Press Apply if everything is correct.]]

* After everything is fine, you have your new fresh Pandian on you SD-Card
 

=== Network Fix for pandian-minimal ===
If you download the pandian-mark2-minimal-hf_2014-01-02 image there is a lack of tools for setup wifi networking.
* Therefore download the fix and place it on the SD-Card where pandian is installed.
* Boot pandian-minimal
* login with user: "root"
* switch to root-directory: "cd /"
* untar the network-fix: "tar -xf /path-where-file-is-located/pandian-mark2-minimal-networking_2014-01-03.tar.gz"
* setup the fix with command "pdMinimalNetwork"
* after the script is finished, run "ceni" and setup your wifi-connection

=== First-start ===
* Upon first boot of Pandian, there is a first-start-wizard which guides you through some basic settings.
Locale, timezone, time and date, password for admin and user setup and calibration of touchscreen.
Located in /usr/sbin/pdSetup should you need to run it again

==== Navigation ====
* Inside a dialog you can navigate with the cross
* With space you select a checkbox
* Moving between <Ok> and <Cancel> can be down with the use of TAB ( Tap Fn then tap Space )
* Acknowledge with Enter

==== Update ( Optional ) ====
* After you setup your Pandora, it is useful to update your system. It is a rolling release, which means since the image was made, the system is forever updated with new packages.
* open a terminal
* get root ( command is: "su" )
* enter "apt-get update" to download package information from the repositories
* enter "apt-get upgrade" to update all packages that are out of date
(pandian packages are also updated this way :)

=== Preinstalled packages ===
These are the packages which come with the different versions of MARK2:
==== minimal ====
==== LXDE ====
* of course LXDE
* Text-Editor: medit
* Audio: mpd als backend, glurp as frontend

=== Additional Users/Groups ===
There are additional Users/Groups added to the standard debian-users
==== Groups ====
* admin
:This superuser privilege is used by sudo for admin task like shutdown etc.
* mpd
:This user/group has access to mpd-related files ( socket, pid-files )

=== User-Guide Section===

==== Power-Modes ====
===== LID-Close =====
* If the lid is closed only the screen will be disabled
===== Low-Power-Mode / Shutdown =====
[[File:Lead Photo For Power modes0-2920264867079787.jpg|thumbnail|right|Switch]]
* Switch to left: Pandora will go to low power mode ( reduce CPU, Disable LID, Pause processes )
* Switch to right: Shutdown the pandora

==== pdcmd ====
* This script handles all system-related stuff, like lid, low-power, usb or wifi.
* This should run as root
 
Usage:
{| class="wikitable"
|-
! Command !! What's done
|-
| /usr/sbin/pdcmd LCDBright + || Increase the light of the lid
|-
| /usr/sbin/pdcmd LCDBright - || Decrease the light of the lid
|-
| /usr/sbin/pdcmd LCDBright 10 || Set the Brightness of the lid to 10
|-
| /usr/sbin/pdcmd LCDTrigger || Trigger the lid ( WARNING: THIS DISABLES THE LID ! )
|-
| /usr/sbin/pdcmd USBNetTrigger || Enable the USB-Networking (module g_ether). If usbnetworking is on, it will disable it
|-
| /usr/sbin/pdcmd USBHostTrigger || Enable the USB-Host (module ehci-hcd). If USB-Host is on, it will disable it
|-
| /usr/sbin/pdcmd WLANTrigger || Enable Wifi. If Wifi is enabled it will be disabled
|}

== Old releases ==

=== 01 ===
'''Full debian GNU/Linux 7.2 codename Wheezy (stable) with LXDE desktop environment 
hardfloat armv7l released Date: 29.09.2013'''
[http://boards.openpandora.org/topic/14482-pandian-01/ forum link]
===Features===

* Hard-Float-ABI
* Ext4 Root for better performance
* Working Touch-Screen
* Working Nubs
* Screen-Off on LID-Close
* Low-Power-Mode
* WLAN
* Music ( with Sonata/MPD )
* Automount

=== Upcoming/Ideas ===

* Assistant for tzdata
* libpnd - PND-Support
* OpenGL not tested yet
* Aptitude
* Minimal-Network-Installation
* Pandian-Debian-Repository for special packages ( libpnd, touch-screen-calibrator )
* of course, in-system-documentation ( Documentation on the pandora )

Download [http://www.share-online.biz/dl/TPMFFXTM2AU here]

[http://boards.openpandora.org/topic/14482-pandian-01 Forum thread]

=== Installation ===

note: It is assumed here, that the card-reader load the card as /dev/sdc.
Please check before which device is your SD-card !
This can be checked with gparted. Minimum requirement 2GB SD-card.

# Download Image ( as 7z )
# Verify md5-checksum: pandian-stable-hf_2013-09-29.001.7z '''2a85bbb40bbe7c6e8f92f058e150951a''' pandian-stable-hf_2013-09-29.001.img '''e62d101dc708de49af1ca7743e2df2bd'''
# Unzip with 7z ( in Linux with 7zr e <image.7z> )
# Copy image to SD-Card ( dd if=<image.img> of=/dev/sdx ) Don't specify "bs="

Username: ''Pandian'' 
Root password: ''Root'' (change after intsallation as per instructions below)

#Open a terminal
#Type "su"
#Type "passwd"
#Enter your new root password when prompted, and then again to confirm.
#Dont forget your password

=== Resize ===
Default installation is limited to 2GB, if you want to expand it, you can, provided you have installed it on a bigger SD-card and want to make use of the space.

* Size will be changed with parted
* parted /dev/sdx
* show size with "print free"

# (parted) print free # Model: USB Mass Storage Device (scsi)
# Disk /dev/sdc: 7965MB# Sector size (logical/physical): 512B/512B# Partition Table: msdos

{| class="wikitable"
|-
| Number || Start || End || Size || Type || File system || Flags
|-
| || 32,3kB || 1049kB || 1016kB || || Free Space ||
|-
| 1 || 1049kB || 53,5MB || 52,4MB || primary || fat32 ||
|-
| 2 || 53,5MB || 1933MB || 1879MB || primary || ext4 ||
|-
| || 1933MB || 7965MB || 6032MB || || Free Space ||
|}

we would like to resize the second partition to the nearly end ( -512MB for swap )
# (parted) resizepart # Partition number? 2 # Warning: Partition /dev/sdc2 is being used. Are you sure you want to continue?# Yes/No? YES # End? [1933MB]? 7453MB this is how the partitions looks like after

(parted) print free * Model: USB Mass Storage Device (scsi)* Disk /dev/sdc: 7965MB* Sector size (logical/physical): 512B/512B* Partition Table: msdos

{| class="wikitable"
|-
| Number || Start || End || Size || Type || File system || Flags
|-
| || 32,3kB || 1049kB || 1016kB || || Free Space ||
|-
| 1 || 1049kB || 53,5MB || 52,4MB || primary || fat32 ||
|-
| 2 || 53,5MB || '''7453'''MB || '''7400'''MB || primary || ext4 ||
|-
| || '''7453'''MB || 7965MB || '''512'''MB || || Free Space ||
|}

create Swap (optional)

(parted) mkpart primary linux-swap
Start? 7453MB
End? 7965MB

this is how the partitions looks like after

(parted) print free * Model: USB Mass Storage Device (scsi)* Disk /dev/sdc: 7965MB* Sector size (logical/physical): 512B/512B* Partition Table: msdos

{| class="wikitable"
|-
| Number || Start || End || Size || Type || File system || Flags
|-
| || 32,3kB || 1049kB || 1016kB || || Free Space ||
|-
| 1 || 1049kB || 53,5MB || 52,4MB || primary || fat32 ||
|-
| 2 || 53,5MB || 7453MB || 7400MB || primary || ext4 ||
|-
| || '''7453MB''' || '''7453MB''' || '''278kB''' || || '''Free Space'''||
|-
| || 7453MB || 7965MB || 512MB || '''primary''' || Free Space ||
|}
disregard the 4th entry, the new resized partition is the last one.

resize filesystem
*resize2fs /dev/sdc2

create swap

*mkswap /dev/sdc3

[[Category:Documentation]]
[[Category:Operating system]]
[[Category:Software]]

Pandian

2014-01-03T01:29:48Z

Stackshadow: /* User-Guide */ Add power modes

[[File:Post-3032-0-90501200-1380479048.png|thumbnail|Logo]]

== Pandian ==
Pandian is an debian-based armhf distro for you Pandora

=== Main Idea ===
Bring a fully desktop to the pandora with the flavor of debian :)

== Help / Bugs / Features ==
Ideas, Bugs, or features-requests take a look on:
http://www.evilbrain.de/projects/pandian/issues

== Releases ==

{| class="wikitable"
|-
! Release !! Version Name !! Description
|-
| 29.09.2013 || [[#01 ]] || The very first version of pandian
|-
| End of December || "[[#MARK2]]" || The next version
|}

== MARK2 ==

=== Main Features ===
* The flavor of thousands of debian packages
* Debian repository hosted on http://pandian.openpandora.org so keep pandian scripts up to date
* armhf-based
* Every settings of MARK2 are split into debian packages which are hosted on http://pandian.openpandora.org
==== pandian package ( in minimal and normal image ) ====
This is the core package which contains following features:
* ACPI support for brighter/darker-buttons, for lid and for low-power-mode
* first-use-wizzard
* automount ( for USB-Stick, external Hard-Drives etc )
* alsa sound support
* pdcmd
==== pandian-lxde package ( only in normal-image ) ====
This package features a fully desktop environment
* Easy Wifi-Access trough network-manager
* MediaPlayer ( mpd with gurlp )
* nub-support
* calibrator-application

=== Which Version i should choose ? ===
There are two different versions of the "MARK2" release:
* minimal
:The minimal-version is an text-only-version of pandian
* normal
:The lxde-version which additional graphical tools

* If you are an "normal" user and like to have an desktop, just choose the normal "MARK2" release
* If you don't like graphical user interface, or LXDE as Desktop use choose the minimal version
{{warning
| If you choose the minimal version, you need to setup USB-Networking to install additional packages, or you setup you interfaces for wifi
This is only recommended for advanced Linux-User
}}

=== Requirements ===
* Of course a Pandora ;)
* An SD-Card with minimum 2GB ( was tested with 4GB )
* An Linux or Windows PC

=== Downloads ===
{| class="wikitable"
|-
! Version !! Description !! Link !! Checksums
|-
| minimal || pandian without any Desktop environment but with the basic pandian package || [http://www.filedropper.com/pandian-mark2-minimal-hf2014-01-02 filedropper: pandian-mark2-minimal-hf2014-01-02] [http://pandian.openpandora.org/releases/pandian-mark2-minimal-hf_2014-01-02.7z pandian.openpandora.org: pandian-mark2-minimal-hf_2014-01-02.7z] || pandian-mark2-minimal-hf_2014-01-02.7z a35106473e54c55d64c7eae2088d8c267b605baf17d5338b8e2938dbfe3c01ca pandian-mark2-minimal-hf_2014-01-02.img c68a42c1aef0238c1dd6ff33b628a2c0dea812a7b5b2d906afb185f93f940f84
|-
| normal || pandian with fully Desktop environment ( LXDE ) || [http://www.filedropper.com/pandian-mark2-hf2014-01-02 filedropper: pandian-mark2-hf2014-01-02] [http://pandian.openpandora.org/releases/pandian-mark2-hf_2014-01-02.7z pandian.openpandora.org: pandian-mark2-hf_2014-01-02.7z] || pandian-mark2-hf_2014-01-02.7z 3731d70a4d8ec59e79a046f34f69c5c809be73e38cfc91a5b580478b8f8c222f pandian-mark2-hf_2014-01-02.img 83b8d3fa5bd0588cfb8b11cfe6b827819e6311e98396a6e32c46c9692f072e96
|}

* After you download the files, verify the checksums !
=== Install the image ===

==== Linux ====
===== Verify you SD-Hardware =====
Check where your SD-Card is located.
If you have an build in SD-Card-Reader this is normally /dev/mmcblk0p1 ( in Debian )
If you have an USB-Card-Reader this is something like /dev/sdc ( in Debian )
* Open an Terminal and input "lsblk"
* You get an list with the actual Block-Devices
* The SD-Card should be as type disk

You can also try gparted to see which devices you have and identify the sd-card

===== Unzip =====
# Unzip with 7z ( in Linux with 7zr e <image.7z> )

===== Copy the image to the SD-Card =====
{{warning
| Warning, this will destroy everything on the device ! So please be very sure which device is you SD-Card !
}}
# Here it will be /dev/sdx
# Copy image to SD-Card with "dd if=<image.img> of=/dev/sdx"

===== Resize SD-Card =====
* After copy the SD-IMAGE to the SD-Card you need to resize the partitions to get the fully size of your SD-Card

* This can be done with gparted on linux
* start gparted

[[File:Gparted resize 001.png|800px|thumbnail|none|The actual partitions of the SD-CARD. Please select the correct device at the top right corner.]]
[[File:Gparted resize 002.png|800px|thumbnail|none|Rightclick to the second partition and select Resize/Move]]
[[File:Gparted resize 003.png|400px|thumbnail|none|You see the actual Size of this partition]]
[[File:Gparted resize 004.png|400px|thumbnail|none|Move the slider to the right, or set "Free space following" to 0]]
[[File:Gparted resize 005.png|800px|thumbnail|none|After you press the "Resize/Move" button, you get the preview of the new partition structure]]
[[File:Gparted resize 006.png|800px|thumbnail|none|When you press "Apply all operations", youve got a warning that you can loss your Data. THIS IS THE LAST CHANGE TO CHECK IF YOU SELECTED THE CORRECT DEVICE.

 Press Apply if everything is correct.]]

* After everything is fine, you have your new fresh pandian on you SD-Card
 

=== First-start ===
* When you first start pandian, there is an first-start-wizard which guides you through some basic settings for Pandian

==== Navigation ====
* Inside an dialog you can navigate with the cross
* With space you select a checkbox
* <Ok> or to <Cancel> can be reached if you use TAB ( Tap Fn then tap Space )
* Acknowledge with Enter

==== Update ( Optional ) ====
* After you setup your Pandora, it is useful to update your system. This is caused depending on when you download the image, debian has already new packages ;)
* open an terminal
* get root ( command is: su )
* enter "apt-get update" to get the actual package informations
* enter "apt-get upgrade" to update all packages include the pandian-packages ;)

=== Preinstalled packages ===
This are the packages which comes with the different versions of MARK2:
==== minimal ====
==== LXDE ====
* of course LXDE
* Text-Editor: medit
* Audio: mpd als backend, glurp as frontend

=== Additional Users/Groups ===
There are additional Users/Groups added to the standard debian-users
==== Groups ====
* admin
:This user is used by sudo for admin task like shutdown etc.
* mpd
:This user/group has access to mpd-related files ( socket, pid-files )

=== Debian repository ===
Pandian features an own additional debian repository to keep the pandian-core scripts up to date
* just open an terminal
* get root ( command is: su )
* enter "apt-get update" to get the actual package informations
* enter "apt-get upgrade" to update all packages include the pandian-packages ;)

=== User-Guide ===

==== Power-Modes ====
===== LID-Close =====
* If the lid is closed only the screen will be disabled
===== Low-Power-Mode / Shutdown =====
[[File:Lead Photo For Power modes0-2920264867079787.jpg|200px|thumbnail|none|Switch]]
* Switch to left: Pandora will go to low power mode ( reduce CPU, Disable LID, Pause processes )
* Switch to right: Shutdown the pandora

==== pdcmd ====
* This script handles all system-related stuff, like lid, low-power, usb or wifi.
* This should run as root
 
Usage:
{| class="wikitable"
|-
! Command !! What's done
|-
| /usr/sbin/pdcmd LCDBright + || Increase the light of the lid
|-
| /usr/sbin/pdcmd LCDBright - || Decrease the light of the lid
|-
| /usr/sbin/pdcmd LCDBright 10 || Set the Brightness of the lid to 10
|-
| /usr/sbin/pdcmd LCDTrigger || Trigger the lid ( WARNING: THIS DISABLES THE LID ! )
|-
| /usr/sbin/pdcmd USBNetTrigger || Enable the USB-Networking (module g_ether). If usbnetworking is on, it will disable it
|-
| /usr/sbin/pdcmd USBHostTrigger || Enable the USB-Host (module ehci-hcd). If USB-Host is on, it will disable it
|-
| /usr/sbin/pdcmd WLANTrigger || Enable Wifi. If Wifi is enabled it will be disabled
|}

== 01 ==
'''Full debian GNU/Linux 7.2 codename Wheezy (stable) with LXDE desktop environment hardfloat armv7l released Date: 29.09.2013'''

===Features===

* Hard-Float-ABI
* Ext4 Root for better performance
* Working Touch-Screen
* Working Nubs
* Screen-Off on LID-Close
* Low-Power-Mode
* WLAN
* Music ( with Sonata/MPD )
* Automount

=== Upcoming/Ideas ===

* Assistant for tzdata
* libpnd - PND-Support
* OpenGL not tested yet
* Aptitude
* Minimal-Network-Installation
* Pandian-Debian-Repository for special packages ( libpnd, touch-screen-calibrator )
* of course, in-system-documentation ( Documentation on the pandora )

Download [http://www.share-online.biz/dl/TPMFFXTM2AU here]

[http://boards.openpandora.org/topic/14482-pandian-01 Forum thread]

=== Installation ===

note: It is assumed here, that the card-reader load the card as /dev/sdc.
Please check before which device is your SD-card !
This can be checked with gparted. Minimum requirement 2GB SD-card.

# Download Image ( as 7z )
# Verify md5-checksum: pandian-stable-hf_2013-09-29.001.7z '''2a85bbb40bbe7c6e8f92f058e150951a''' pandian-stable-hf_2013-09-29.001.img '''e62d101dc708de49af1ca7743e2df2bd'''
# Unzip with 7z ( in Linux with 7zr e <image.7z> )
# Copy image to SD-Card ( dd if=<image.img> of=/dev/sdx ) Don't specify "bs="

Username: ''Pandian'' 
Root password: ''Root'' (change after intsallation as per instructions below)

#Open a terminal
#Type "su"
#Type "passwd"
#Enter your new root password when prompted, and then again to confirm.
#Dont forget your password

=== Resize ===
Default installation is limited to 2GB, if you want to expand it, you can, provided you have installed it on a bigger SD-card and want to make use of the space.

* Size will be changed with parted
* parted /dev/sdx
* show size with "print free"

# (parted) print free # Model: USB Mass Storage Device (scsi)
# Disk /dev/sdc: 7965MB# Sector size (logical/physical): 512B/512B# Partition Table: msdos

{| class="wikitable"
|-
| Number || Start || End || Size || Type || File system || Flags
|-
| || 32,3kB || 1049kB || 1016kB || || Free Space ||
|-
| 1 || 1049kB || 53,5MB || 52,4MB || primary || fat32 ||
|-
| 2 || 53,5MB || 1933MB || 1879MB || primary || ext4 ||
|-
| || 1933MB || 7965MB || 6032MB || || Free Space ||
|}

we would like to resize the second partition to the nearly end ( -512MB for swap )
# (parted) resizepart # Partition number? 2 # Warning: Partition /dev/sdc2 is being used. Are you sure you want to continue?# Yes/No? YES # End? [1933MB]? 7453MB this is how the partitions looks like after

(parted) print free * Model: USB Mass Storage Device (scsi)* Disk /dev/sdc: 7965MB* Sector size (logical/physical): 512B/512B* Partition Table: msdos

{| class="wikitable"
|-
| Number || Start || End || Size || Type || File system || Flags
|-
| || 32,3kB || 1049kB || 1016kB || || Free Space ||
|-
| 1 || 1049kB || 53,5MB || 52,4MB || primary || fat32 ||
|-
| 2 || 53,5MB || '''7453'''MB || '''7400'''MB || primary || ext4 ||
|-
| || '''7453'''MB || 7965MB || '''512'''MB || || Free Space ||
|}

create Swap (optional)

(parted) mkpart primary linux-swap
Start? 7453MB
End? 7965MB

this is how the partitions looks like after

(parted) print free * Model: USB Mass Storage Device (scsi)* Disk /dev/sdc: 7965MB* Sector size (logical/physical): 512B/512B* Partition Table: msdos

{| class="wikitable"
|-
| Number || Start || End || Size || Type || File system || Flags
|-
| || 32,3kB || 1049kB || 1016kB || || Free Space ||
|-
| 1 || 1049kB || 53,5MB || 52,4MB || primary || fat32 ||
|-
| 2 || 53,5MB || 7453MB || 7400MB || primary || ext4 ||
|-
| || '''7453MB''' || '''7453MB''' || '''278kB''' || || '''Free Space'''||
|-
| || 7453MB || 7965MB || 512MB || '''primary''' || Free Space ||
|}
disregard the 4th entry, the new resized partition is the last one.

resize filesystem
*resize2fs /dev/sdc2

create swap

*mkswap /dev/sdc3

[[Category:Documentation]]
[[Category:Operating system]]
[[Category:Software]]

Pandian

2014-01-03T01:12:57Z

Stackshadow: /* Which Version i should choose ? */

[[File:Post-3032-0-90501200-1380479048.png|thumbnail|Logo]]

== Pandian ==
Pandian is an debian-based armhf distro for you Pandora

=== Main Idea ===
Bring a fully desktop to the pandora with the flavor of debian :)

== Help / Bugs / Features ==
Ideas, Bugs, or features-requests take a look on:
http://www.evilbrain.de/projects/pandian/issues

== Releases ==

{| class="wikitable"
|-
! Release !! Version Name !! Description
|-
| 29.09.2013 || [[#01 ]] || The very first version of pandian
|-
| End of December || "[[#MARK2]]" || The next version
|}

== MARK2 ==

=== Main Features ===
* The flavor of thousands of debian packages
* Debian repository hosted on http://pandian.openpandora.org so keep pandian scripts up to date
* armhf-based
* Every settings of MARK2 are split into debian packages which are hosted on http://pandian.openpandora.org
==== pandian package ( in minimal and normal image ) ====
This is the core package which contains following features:
* ACPI support for brighter/darker-buttons, for lid and for low-power-mode
* first-use-wizzard
* automount ( for USB-Stick, external Hard-Drives etc )
* alsa sound support
* pdcmd
==== pandian-lxde package ( only in normal-image ) ====
This package features a fully desktop environment
* Easy Wifi-Access trough network-manager
* MediaPlayer ( mpd with gurlp )
* nub-support
* calibrator-application

=== Which Version i should choose ? ===
There are two different versions of the "MARK2" release:
* minimal
:The minimal-version is an text-only-version of pandian
* normal
:The lxde-version which additional graphical tools

* If you are an "normal" user and like to have an desktop, just choose the normal "MARK2" release
* If you don't like graphical user interface, or LXDE as Desktop use choose the minimal version
{{warning
| If you choose the minimal version, you need to setup USB-Networking to install additional packages, or you setup you interfaces for wifi
This is only recommended for advanced Linux-User
}}

=== Requirements ===
* Of course a Pandora ;)
* An SD-Card with minimum 2GB ( was tested with 4GB )
* An Linux or Windows PC

=== Downloads ===
{| class="wikitable"
|-
! Version !! Description !! Link !! Checksums
|-
| minimal || pandian without any Desktop environment but with the basic pandian package || [http://www.filedropper.com/pandian-mark2-minimal-hf2014-01-02 filedropper: pandian-mark2-minimal-hf2014-01-02] [http://pandian.openpandora.org/releases/pandian-mark2-minimal-hf_2014-01-02.7z pandian.openpandora.org: pandian-mark2-minimal-hf_2014-01-02.7z] || pandian-mark2-minimal-hf_2014-01-02.7z a35106473e54c55d64c7eae2088d8c267b605baf17d5338b8e2938dbfe3c01ca pandian-mark2-minimal-hf_2014-01-02.img c68a42c1aef0238c1dd6ff33b628a2c0dea812a7b5b2d906afb185f93f940f84
|-
| normal || pandian with fully Desktop environment ( LXDE ) || [http://www.filedropper.com/pandian-mark2-hf2014-01-02 filedropper: pandian-mark2-hf2014-01-02] [http://pandian.openpandora.org/releases/pandian-mark2-hf_2014-01-02.7z pandian.openpandora.org: pandian-mark2-hf_2014-01-02.7z] || pandian-mark2-hf_2014-01-02.7z 3731d70a4d8ec59e79a046f34f69c5c809be73e38cfc91a5b580478b8f8c222f pandian-mark2-hf_2014-01-02.img 83b8d3fa5bd0588cfb8b11cfe6b827819e6311e98396a6e32c46c9692f072e96
|}

* After you download the files, verify the checksums !
=== Install the image ===

==== Linux ====
===== Verify you SD-Hardware =====
Check where your SD-Card is located.
If you have an build in SD-Card-Reader this is normally /dev/mmcblk0p1 ( in Debian )
If you have an USB-Card-Reader this is something like /dev/sdc ( in Debian )
* Open an Terminal and input "lsblk"
* You get an list with the actual Block-Devices
* The SD-Card should be as type disk

You can also try gparted to see which devices you have and identify the sd-card

===== Unzip =====
# Unzip with 7z ( in Linux with 7zr e <image.7z> )

===== Copy the image to the SD-Card =====
{{warning
| Warning, this will destroy everything on the device ! So please be very sure which device is you SD-Card !
}}
# Here it will be /dev/sdx
# Copy image to SD-Card with "dd if=<image.img> of=/dev/sdx"

===== Resize SD-Card =====
* After copy the SD-IMAGE to the SD-Card you need to resize the partitions to get the fully size of your SD-Card

* This can be done with gparted on linux
* start gparted

[[File:Gparted resize 001.png|800px|thumbnail|none|The actual partitions of the SD-CARD. Please select the correct device at the top right corner.]]
[[File:Gparted resize 002.png|800px|thumbnail|none|Rightclick to the second partition and select Resize/Move]]
[[File:Gparted resize 003.png|400px|thumbnail|none|You see the actual Size of this partition]]
[[File:Gparted resize 004.png|400px|thumbnail|none|Move the slider to the right, or set "Free space following" to 0]]
[[File:Gparted resize 005.png|800px|thumbnail|none|After you press the "Resize/Move" button, you get the preview of the new partition structure]]
[[File:Gparted resize 006.png|800px|thumbnail|none|When you press "Apply all operations", youve got a warning that you can loss your Data. THIS IS THE LAST CHANGE TO CHECK IF YOU SELECTED THE CORRECT DEVICE.

 Press Apply if everything is correct.]]

* After everything is fine, you have your new fresh pandian on you SD-Card
 

=== First-start ===
* When you first start pandian, there is an first-start-wizard which guides you through some basic settings for Pandian

==== Navigation ====
* Inside an dialog you can navigate with the cross
* With space you select a checkbox
* <Ok> or to <Cancel> can be reached if you use TAB ( Tap Fn then tap Space )
* Acknowledge with Enter

==== Update ( Optional ) ====
* After you setup your Pandora, it is useful to update your system. This is caused depending on when you download the image, debian has already new packages ;)
* open an terminal
* get root ( command is: su )
* enter "apt-get update" to get the actual package informations
* enter "apt-get upgrade" to update all packages include the pandian-packages ;)

=== Preinstalled packages ===
This are the packages which comes with the different versions of MARK2:
==== minimal ====
==== LXDE ====
* of course LXDE
* Text-Editor: medit
* Audio: mpd als backend, glurp as frontend

=== Additional Users/Groups ===
There are additional Users/Groups added to the standard debian-users
==== Groups ====
* admin
:This user is used by sudo for admin task like shutdown etc.
* mpd
:This user/group has access to mpd-related files ( socket, pid-files )

=== Debian repository ===
Pandian features an own additional debian repository to keep the pandian-core scripts up to date
* just open an terminal
* get root ( command is: su )
* enter "apt-get update" to get the actual package informations
* enter "apt-get upgrade" to update all packages include the pandian-packages ;)

=== User-Guide ===
==== pdcmd ====
* This script handles all system-related stuff, like lid, low-power, usb or wifi.
* This should run as root
 
Usage:
{| class="wikitable"
|-
! Command !! What's done
|-
| /usr/sbin/pdcmd LCDBright + || Increase the light of the lid
|-
| /usr/sbin/pdcmd LCDBright - || Decrease the light of the lid
|-
| /usr/sbin/pdcmd LCDBright 10 || Set the Brightness of the lid to 10
|-
| /usr/sbin/pdcmd LCDTrigger || Trigger the lid ( WARNING: THIS DISABLES THE LID ! )
|-
| /usr/sbin/pdcmd USBNetTrigger || Enable the USB-Networking (module g_ether). If usbnetworking is on, it will disable it
|-
| /usr/sbin/pdcmd USBHostTrigger || Enable the USB-Host (module ehci-hcd). If USB-Host is on, it will disable it
|-
| /usr/sbin/pdcmd WLANTrigger || Enable Wifi. If Wifi is enabled it will be disabled
|}

== 01 ==
'''Full debian GNU/Linux 7.2 codename Wheezy (stable) with LXDE desktop environment hardfloat armv7l released Date: 29.09.2013'''

===Features===

* Hard-Float-ABI
* Ext4 Root for better performance
* Working Touch-Screen
* Working Nubs
* Screen-Off on LID-Close
* Low-Power-Mode
* WLAN
* Music ( with Sonata/MPD )
* Automount

=== Upcoming/Ideas ===

* Assistant for tzdata
* libpnd - PND-Support
* OpenGL not tested yet
* Aptitude
* Minimal-Network-Installation
* Pandian-Debian-Repository for special packages ( libpnd, touch-screen-calibrator )
* of course, in-system-documentation ( Documentation on the pandora )

Download [http://www.share-online.biz/dl/TPMFFXTM2AU here]

[http://boards.openpandora.org/topic/14482-pandian-01 Forum thread]

=== Installation ===

note: It is assumed here, that the card-reader load the card as /dev/sdc.
Please check before which device is your SD-card !
This can be checked with gparted. Minimum requirement 2GB SD-card.

# Download Image ( as 7z )
# Verify md5-checksum: pandian-stable-hf_2013-09-29.001.7z '''2a85bbb40bbe7c6e8f92f058e150951a''' pandian-stable-hf_2013-09-29.001.img '''e62d101dc708de49af1ca7743e2df2bd'''
# Unzip with 7z ( in Linux with 7zr e <image.7z> )
# Copy image to SD-Card ( dd if=<image.img> of=/dev/sdx ) Don't specify "bs="

Username: ''Pandian'' 
Root password: ''Root'' (change after intsallation as per instructions below)

#Open a terminal
#Type "su"
#Type "passwd"
#Enter your new root password when prompted, and then again to confirm.
#Dont forget your password

=== Resize ===
Default installation is limited to 2GB, if you want to expand it, you can, provided you have installed it on a bigger SD-card and want to make use of the space.

* Size will be changed with parted
* parted /dev/sdx
* show size with "print free"

# (parted) print free # Model: USB Mass Storage Device (scsi)
# Disk /dev/sdc: 7965MB# Sector size (logical/physical): 512B/512B# Partition Table: msdos

{| class="wikitable"
|-
| Number || Start || End || Size || Type || File system || Flags
|-
| || 32,3kB || 1049kB || 1016kB || || Free Space ||
|-
| 1 || 1049kB || 53,5MB || 52,4MB || primary || fat32 ||
|-
| 2 || 53,5MB || 1933MB || 1879MB || primary || ext4 ||
|-
| || 1933MB || 7965MB || 6032MB || || Free Space ||
|}

we would like to resize the second partition to the nearly end ( -512MB for swap )
# (parted) resizepart # Partition number? 2 # Warning: Partition /dev/sdc2 is being used. Are you sure you want to continue?# Yes/No? YES # End? [1933MB]? 7453MB this is how the partitions looks like after

(parted) print free * Model: USB Mass Storage Device (scsi)* Disk /dev/sdc: 7965MB* Sector size (logical/physical): 512B/512B* Partition Table: msdos

{| class="wikitable"
|-
| Number || Start || End || Size || Type || File system || Flags
|-
| || 32,3kB || 1049kB || 1016kB || || Free Space ||
|-
| 1 || 1049kB || 53,5MB || 52,4MB || primary || fat32 ||
|-
| 2 || 53,5MB || '''7453'''MB || '''7400'''MB || primary || ext4 ||
|-
| || '''7453'''MB || 7965MB || '''512'''MB || || Free Space ||
|}

create Swap (optional)

(parted) mkpart primary linux-swap
Start? 7453MB
End? 7965MB

this is how the partitions looks like after

(parted) print free * Model: USB Mass Storage Device (scsi)* Disk /dev/sdc: 7965MB* Sector size (logical/physical): 512B/512B* Partition Table: msdos

{| class="wikitable"
|-
| Number || Start || End || Size || Type || File system || Flags
|-
| || 32,3kB || 1049kB || 1016kB || || Free Space ||
|-
| 1 || 1049kB || 53,5MB || 52,4MB || primary || fat32 ||
|-
| 2 || 53,5MB || 7453MB || 7400MB || primary || ext4 ||
|-
| || '''7453MB''' || '''7453MB''' || '''278kB''' || || '''Free Space'''||
|-
| || 7453MB || 7965MB || 512MB || '''primary''' || Free Space ||
|}
disregard the 4th entry, the new resized partition is the last one.

resize filesystem
*resize2fs /dev/sdc2

create swap

*mkswap /dev/sdc3

[[Category:Documentation]]
[[Category:Operating system]]
[[Category:Software]]

Pandian

2014-01-03T00:19:46Z

Stackshadow: Release-Dokumentation for pandian :D

[[File:Post-3032-0-90501200-1380479048.png|thumbnail|Logo]]

== Pandian ==
Pandian is an debian-based armhf distro for you Pandora

=== Main Idea ===
Bring a fully desktop to the pandora with the flavor of debian :)

== Help / Bugs / Features ==
Ideas, Bugs, or features-requests take a look on:
http://www.evilbrain.de/projects/pandian/issues

== Releases ==

{| class="wikitable"
|-
! Release !! Version Name !! Description
|-
| 29.09.2013 || [[#01 ]] || The very first version of pandian
|-
| End of December || "[[#MARK2]]" || The next version
|}

== MARK2 ==

=== Main Features ===
* The flavor of thousands of debian packages
* Debian repository hosted on http://pandian.openpandora.org so keep pandian scripts up to date
* armhf-based
* Every settings of MARK2 are split into debian packages which are hosted on http://pandian.openpandora.org
==== pandian package ( in minimal and normal image ) ====
This is the core package which contains following features:
* ACPI support for brighter/darker-buttons, for lid and for low-power-mode
* first-use-wizzard
* automount ( for USB-Stick, external Hard-Drives etc )
* alsa sound support
* pdcmd
==== pandian-lxde package ( only in normal-image ) ====
This package features a fully desktop environment
* Easy Wifi-Access trough network-manager
* MediaPlayer ( mpd with gurlp )
* nub-support
* calibrator-application

=== Which Version i should choose ? ===
There are two different versions of the "MARK2" release:
* minimal
:The minimal-version is an text-only-version of pandian but with wifi enabled and ceni for connecting to wifi-networks from command line
* normal
:The lxde-version which additional graphical tools

* If you are an "normal" user and like to have an desktop, just choose the normal "MARK2" release
* If you don't like graphical user interface, or LXDE as Desktop use choose the minimal version
{{warning
| If you choose the minimal version, you need to setup USB-Networking to install additional packages, or you setup you interfaces for wifi
This is only recommended for advanced Linux-User
}}

=== Requirements ===
* Of course a Pandora ;)
* An SD-Card with minimum 2GB ( was tested with 4GB )
* An Linux or Windows PC

=== Downloads ===
{| class="wikitable"
|-
! Version !! Description !! Link !! Checksums
|-
| minimal || pandian without any Desktop environment but with the basic pandian package || [http://www.filedropper.com/pandian-mark2-minimal-hf2014-01-02 filedropper: pandian-mark2-minimal-hf2014-01-02] [http://pandian.openpandora.org/releases/pandian-mark2-minimal-hf_2014-01-02.7z pandian.openpandora.org: pandian-mark2-minimal-hf_2014-01-02.7z] || pandian-mark2-minimal-hf_2014-01-02.7z a35106473e54c55d64c7eae2088d8c267b605baf17d5338b8e2938dbfe3c01ca pandian-mark2-minimal-hf_2014-01-02.img c68a42c1aef0238c1dd6ff33b628a2c0dea812a7b5b2d906afb185f93f940f84
|-
| normal || pandian with fully Desktop environment ( LXDE ) || [http://www.filedropper.com/pandian-mark2-hf2014-01-02 filedropper: pandian-mark2-hf2014-01-02] [http://pandian.openpandora.org/releases/pandian-mark2-hf_2014-01-02.7z pandian.openpandora.org: pandian-mark2-hf_2014-01-02.7z] || pandian-mark2-hf_2014-01-02.7z 3731d70a4d8ec59e79a046f34f69c5c809be73e38cfc91a5b580478b8f8c222f pandian-mark2-hf_2014-01-02.img 83b8d3fa5bd0588cfb8b11cfe6b827819e6311e98396a6e32c46c9692f072e96
|}

* After you download the files, verify the checksums !
=== Install the image ===

==== Linux ====
===== Verify you SD-Hardware =====
Check where your SD-Card is located.
If you have an build in SD-Card-Reader this is normally /dev/mmcblk0p1 ( in Debian )
If you have an USB-Card-Reader this is something like /dev/sdc ( in Debian )
* Open an Terminal and input "lsblk"
* You get an list with the actual Block-Devices
* The SD-Card should be as type disk

You can also try gparted to see which devices you have and identify the sd-card

===== Unzip =====
# Unzip with 7z ( in Linux with 7zr e <image.7z> )

===== Copy the image to the SD-Card =====
{{warning
| Warning, this will destroy everything on the device ! So please be very sure which device is you SD-Card !
}}
# Here it will be /dev/sdx
# Copy image to SD-Card with "dd if=<image.img> of=/dev/sdx"

===== Resize SD-Card =====
* After copy the SD-IMAGE to the SD-Card you need to resize the partitions to get the fully size of your SD-Card

* This can be done with gparted on linux
* start gparted

[[File:Gparted resize 001.png|800px|thumbnail|none|The actual partitions of the SD-CARD. Please select the correct device at the top right corner.]]
[[File:Gparted resize 002.png|800px|thumbnail|none|Rightclick to the second partition and select Resize/Move]]
[[File:Gparted resize 003.png|400px|thumbnail|none|You see the actual Size of this partition]]
[[File:Gparted resize 004.png|400px|thumbnail|none|Move the slider to the right, or set "Free space following" to 0]]
[[File:Gparted resize 005.png|800px|thumbnail|none|After you press the "Resize/Move" button, you get the preview of the new partition structure]]
[[File:Gparted resize 006.png|800px|thumbnail|none|When you press "Apply all operations", youve got a warning that you can loss your Data. THIS IS THE LAST CHANGE TO CHECK IF YOU SELECTED THE CORRECT DEVICE.

 Press Apply if everything is correct.]]

* After everything is fine, you have your new fresh pandian on you SD-Card
 

=== First-start ===
* When you first start pandian, there is an first-start-wizard which guides you through some basic settings for Pandian

==== Navigation ====
* Inside an dialog you can navigate with the cross
* With space you select a checkbox
* <Ok> or to <Cancel> can be reached if you use TAB ( Tap Fn then tap Space )
* Acknowledge with Enter

==== Update ( Optional ) ====
* After you setup your Pandora, it is useful to update your system. This is caused depending on when you download the image, debian has already new packages ;)
* open an terminal
* get root ( command is: su )
* enter "apt-get update" to get the actual package informations
* enter "apt-get upgrade" to update all packages include the pandian-packages ;)

=== Preinstalled packages ===
This are the packages which comes with the different versions of MARK2:
==== minimal ====
==== LXDE ====
* of course LXDE
* Text-Editor: medit
* Audio: mpd als backend, glurp as frontend

=== Additional Users/Groups ===
There are additional Users/Groups added to the standard debian-users
==== Groups ====
* admin
:This user is used by sudo for admin task like shutdown etc.
* mpd
:This user/group has access to mpd-related files ( socket, pid-files )

=== Debian repository ===
Pandian features an own additional debian repository to keep the pandian-core scripts up to date
* just open an terminal
* get root ( command is: su )
* enter "apt-get update" to get the actual package informations
* enter "apt-get upgrade" to update all packages include the pandian-packages ;)

=== User-Guide ===
==== pdcmd ====
* This script handles all system-related stuff, like lid, low-power, usb or wifi.
* This should run as root
 
Usage:
{| class="wikitable"
|-
! Command !! What's done
|-
| /usr/sbin/pdcmd LCDBright + || Increase the light of the lid
|-
| /usr/sbin/pdcmd LCDBright - || Decrease the light of the lid
|-
| /usr/sbin/pdcmd LCDBright 10 || Set the Brightness of the lid to 10
|-
| /usr/sbin/pdcmd LCDTrigger || Trigger the lid ( WARNING: THIS DISABLES THE LID ! )
|-
| /usr/sbin/pdcmd USBNetTrigger || Enable the USB-Networking (module g_ether). If usbnetworking is on, it will disable it
|-
| /usr/sbin/pdcmd USBHostTrigger || Enable the USB-Host (module ehci-hcd). If USB-Host is on, it will disable it
|-
| /usr/sbin/pdcmd WLANTrigger || Enable Wifi. If Wifi is enabled it will be disabled
|}

== 01 ==
'''Full debian GNU/Linux 7.2 codename Wheezy (stable) with LXDE desktop environment hardfloat armv7l released Date: 29.09.2013'''

===Features===

* Hard-Float-ABI
* Ext4 Root for better performance
* Working Touch-Screen
* Working Nubs
* Screen-Off on LID-Close
* Low-Power-Mode
* WLAN
* Music ( with Sonata/MPD )
* Automount

=== Upcoming/Ideas ===

* Assistant for tzdata
* libpnd - PND-Support
* OpenGL not tested yet
* Aptitude
* Minimal-Network-Installation
* Pandian-Debian-Repository for special packages ( libpnd, touch-screen-calibrator )
* of course, in-system-documentation ( Documentation on the pandora )

Download [http://www.share-online.biz/dl/TPMFFXTM2AU here]

[http://boards.openpandora.org/topic/14482-pandian-01 Forum thread]

=== Installation ===

note: It is assumed here, that the card-reader load the card as /dev/sdc.
Please check before which device is your SD-card !
This can be checked with gparted. Minimum requirement 2GB SD-card.

# Download Image ( as 7z )
# Verify md5-checksum: pandian-stable-hf_2013-09-29.001.7z '''2a85bbb40bbe7c6e8f92f058e150951a''' pandian-stable-hf_2013-09-29.001.img '''e62d101dc708de49af1ca7743e2df2bd'''
# Unzip with 7z ( in Linux with 7zr e <image.7z> )
# Copy image to SD-Card ( dd if=<image.img> of=/dev/sdx ) Don't specify "bs="

Username: ''Pandian'' 
Root password: ''Root'' (change after intsallation as per instructions below)

#Open a terminal
#Type "su"
#Type "passwd"
#Enter your new root password when prompted, and then again to confirm.
#Dont forget your password

=== Resize ===
Default installation is limited to 2GB, if you want to expand it, you can, provided you have installed it on a bigger SD-card and want to make use of the space.

* Size will be changed with parted
* parted /dev/sdx
* show size with "print free"

# (parted) print free # Model: USB Mass Storage Device (scsi)
# Disk /dev/sdc: 7965MB# Sector size (logical/physical): 512B/512B# Partition Table: msdos

{| class="wikitable"
|-
| Number || Start || End || Size || Type || File system || Flags
|-
| || 32,3kB || 1049kB || 1016kB || || Free Space ||
|-
| 1 || 1049kB || 53,5MB || 52,4MB || primary || fat32 ||
|-
| 2 || 53,5MB || 1933MB || 1879MB || primary || ext4 ||
|-
| || 1933MB || 7965MB || 6032MB || || Free Space ||
|}

we would like to resize the second partition to the nearly end ( -512MB for swap )
# (parted) resizepart # Partition number? 2 # Warning: Partition /dev/sdc2 is being used. Are you sure you want to continue?# Yes/No? YES # End? [1933MB]? 7453MB this is how the partitions looks like after

(parted) print free * Model: USB Mass Storage Device (scsi)* Disk /dev/sdc: 7965MB* Sector size (logical/physical): 512B/512B* Partition Table: msdos

{| class="wikitable"
|-
| Number || Start || End || Size || Type || File system || Flags
|-
| || 32,3kB || 1049kB || 1016kB || || Free Space ||
|-
| 1 || 1049kB || 53,5MB || 52,4MB || primary || fat32 ||
|-
| 2 || 53,5MB || '''7453'''MB || '''7400'''MB || primary || ext4 ||
|-
| || '''7453'''MB || 7965MB || '''512'''MB || || Free Space ||
|}

create Swap (optional)

(parted) mkpart primary linux-swap
Start? 7453MB
End? 7965MB

this is how the partitions looks like after

(parted) print free * Model: USB Mass Storage Device (scsi)* Disk /dev/sdc: 7965MB* Sector size (logical/physical): 512B/512B* Partition Table: msdos

{| class="wikitable"
|-
| Number || Start || End || Size || Type || File system || Flags
|-
| || 32,3kB || 1049kB || 1016kB || || Free Space ||
|-
| 1 || 1049kB || 53,5MB || 52,4MB || primary || fat32 ||
|-
| 2 || 53,5MB || 7453MB || 7400MB || primary || ext4 ||
|-
| || '''7453MB''' || '''7453MB''' || '''278kB''' || || '''Free Space'''||
|-
| || 7453MB || 7965MB || 512MB || '''primary''' || Free Space ||
|}
disregard the 4th entry, the new resized partition is the last one.

resize filesystem
*resize2fs /dev/sdc2

create swap

*mkswap /dev/sdc3

[[Category:Documentation]]
[[Category:Operating system]]
[[Category:Software]]

Pandian

2014-01-02T19:55:44Z

Stackshadow: /* First-start */ Add information about update after the installation

[[File:Post-3032-0-90501200-1380479048.png|thumbnail|Logo]]

= Pandian =
Pandian is an debian-based armhf distro for you Pandora

== Main Idea ==
Bring a fully desktop to the pandora with the flavor of debian :)

== Help / Bugs / Features ==
Ideas, Bugs, or features-requests take a look on:
http://www.evilbrain.de/projects/pandian/issues

== Versions ==

{| class="wikitable"
|-
! Release !! Version Name !! Description
|-
| 29.09.2013 || 02 || The very first version of pandian
|-
| End of December || "MARK 2" || The next version
|}

= 01 =
'''Full debian GNU/Linux 7.2 codename Wheezy (stable) with LXDE desktop environment hardfloat armv7l released Date: 29.09.2013'''

==Features==

* Hard-Float-ABI
* Ext4 Root for better performance
* Working Touch-Screen
* Working Nubs
* Screen-Off on LID-Close
* Low-Power-Mode
* WLAN
* Music ( with Sonata/MPD )
* Automount

== Upcoming/Ideas ==

* Assistant for tzdata
* libpnd - PND-Support
* OpenGL not tested yet
* Aptitude
* Minimal-Network-Installation
* Pandian-Debian-Repository for special packages ( libpnd, touch-screen-calibrator )
* of course, in-system-documentation ( Documentation on the pandora )

Download [http://www.share-online.biz/dl/TPMFFXTM2AU here]

[http://boards.openpandora.org/topic/14482-pandian-01 Forum thread]

== Installation ==

note: It is assumed here, that the card-reader load the card as /dev/sdc.
Please check before which device is your SD-card !
This can be checked with gparted. Minimum requirement 2GB SD-card.

# Download Image ( as 7z )
# Verify md5-checksum: pandian-stable-hf_2013-09-29.001.7z '''2a85bbb40bbe7c6e8f92f058e150951a''' pandian-stable-hf_2013-09-29.001.img '''e62d101dc708de49af1ca7743e2df2bd'''
# Unzip with 7z ( in Linux with 7zr e <image.7z> )
# Copy image to SD-Card ( dd if=<image.img> of=/dev/sdx ) Don't specify "bs="

Username: ''Pandian'' 
Passwd: ''Root'' (change this after installation)

== Resize ==
Default installation is limited to 2GB, if you want to expand it, you can, provided you have installed it on a bigger SD-card and want to make use of the space.

* Size will be changed with parted
* parted /dev/sdx
* show size with "print free"

# (parted) print free # Model: USB Mass Storage Device (scsi)
# Disk /dev/sdc: 7965MB# Sector size (logical/physical): 512B/512B# Partition Table: msdos

{| class="wikitable"
|-
| Number || Start || End || Size || Type || File system || Flags
|-
| || 32,3kB || 1049kB || 1016kB || || Free Space ||
|-
| 1 || 1049kB || 53,5MB || 52,4MB || primary || fat32 ||
|-
| 2 || 53,5MB || 1933MB || 1879MB || primary || ext4 ||
|-
| || 1933MB || 7965MB || 6032MB || || Free Space ||
|}

we would like to resize the second partition to the nearly end ( -512MB for swap )
# (parted) resizepart # Partition number? 2 # Warning: Partition /dev/sdc2 is being used. Are you sure you want to continue?# Yes/No? YES # End? [1933MB]? 7453MB this is how the partitions looks like after

(parted) print free * Model: USB Mass Storage Device (scsi)* Disk /dev/sdc: 7965MB* Sector size (logical/physical): 512B/512B* Partition Table: msdos

{| class="wikitable"
|-
| Number || Start || End || Size || Type || File system || Flags
|-
| || 32,3kB || 1049kB || 1016kB || || Free Space ||
|-
| 1 || 1049kB || 53,5MB || 52,4MB || primary || fat32 ||
|-
| 2 || 53,5MB || '''7453'''MB || '''7400'''MB || primary || ext4 ||
|-
| || '''7453'''MB || 7965MB || '''512'''MB || || Free Space ||
|}

create Swap (optional)

(parted) mkpart primary linux-swap
Start? 7453MB
End? 7965MB

this is how the partitions looks like after

(parted) print free * Model: USB Mass Storage Device (scsi)* Disk /dev/sdc: 7965MB* Sector size (logical/physical): 512B/512B* Partition Table: msdos

{| class="wikitable"
|-
| Number || Start || End || Size || Type || File system || Flags
|-
| || 32,3kB || 1049kB || 1016kB || || Free Space ||
|-
| 1 || 1049kB || 53,5MB || 52,4MB || primary || fat32 ||
|-
| 2 || 53,5MB || 7453MB || 7400MB || primary || ext4 ||
|-
| || '''7453MB''' || '''7453MB''' || '''278kB''' || || '''Free Space'''||
|-
| || 7453MB || 7965MB || 512MB || '''primary''' || Free Space ||
|}
disregard the 4th entry, the new resized partition is the last one.

resize filesystem
*resize2fs /dev/sdc2

create swap

*mkswap /dev/sdc3

[[Category:Documentation]]
[[Category:Operating system]]
[[Category:Software]]

= MARK2 =
{{warning
| '''<big>Pandian MARK2 is not released yet, so please do nothing which is mentioned below this chapter ! Its only for preliminary documentation purpose to dont forget anything :)
IT WILL NOT WORK WITH THE ACTUAL VERSION OF PANDIAN</big>'''
}}

== Versions ==
There are two different versions of the "MARK2" release:
* minimal
:The minimal-version is an text-only-version of pandian but with wifi enabled and ceni for connecting to wifi-networks from command line
* LXDE
:The lxde-version which additional graphical tools

=== Which Version i should choose ? ===
* If you are an "normal" user and like to have an desktop, just choose the normal "MARK2" release
* If you don't like graphical user interface, or LXDE as Desktop use choose the minimal version
{{warning
| If you choose the minimal version, you need to setup USB-Networking to install additional packages, or you setup you interfaces for wifi
This is only recommended for advanced Linux-User
}}

== Installation ==
=== Requirements ===
* Of course a Pandora ;)
* An SD-Card with minimum 2GB ( was tested with 4GB )
* An Linux or Windows PC

=== Downloads ===
Coming soon ;)

=== Install the image ===

==== Linux ====
===== Verify you SD-Hardware =====
Check where your SD-Card is located.
If you have an build in SD-Card-Reader this is normally /dev/mmcblk0p1 ( in Debian )
If you have an USB-Card-Reader this is something like /dev/sdc ( in Debian )
* Open an Terminal and input "lsblk"
* You get an list with the actual Block-Devices
* The SD-Card should be as type disk

You can also try gparted to see which devices you have and identify the sd-card

===== Unzip =====
# Unzip with 7z ( in Linux with 7zr e <image.7z> )

===== Copy the image to the SD-Card =====
{{warning
| Warning, this will destroy everything on the device ! So please be very sure which device is you SD-Card !
}}
# Here it will be /dev/sdx
# Copy image to SD-Card with "dd if=<image.img> of=/dev/sdx"

===== Resize SD-Card =====
* After copy the SD-IMAGE to the SD-Card you need to resize the partitions to get the fully size of your SD-Card

* This can be done with gparted on linux
* start gparted

[[File:Gparted resize 001.png|800px|thumbnail|none|The actual partitions of the SD-CARD. Please select the correct device at the top right corner.]]
[[File:Gparted resize 002.png|800px|thumbnail|none|Rightclick to the second partition and select Resize/Move]]
[[File:Gparted resize 003.png|400px|thumbnail|none|You see the actual Size of this partition]]
[[File:Gparted resize 004.png|400px|thumbnail|none|Move the slider to the right, or set "Free space following" to 0]]
[[File:Gparted resize 005.png|800px|thumbnail|none|After you press the "Resize/Move" button, you get the preview of the new partition structure]]
[[File:Gparted resize 006.png|800px|thumbnail|none|When you press "Apply all operations", youve got a warning that you can loss your Data. THIS IS THE LAST CHANGE TO CHECK IF YOU SELECTED THE CORRECT DEVICE.

 Press Apply if everything is correct.]]

* After everything is fine, you have your new fresh pandian on you SD-Card
 

== First-start ==
* When you first start pandian, there is an first-start-wizard which guides you through some basic settings for Pandian

=== Navigation ===
* Inside an dialog you can navigate with the cross
* With space you select a checkbox
* <Ok> or to <Cancel> can be reached if you use TAB ( Tap Fn then tap Space )
* Acknowledge with Enter

=== Update ( Optional ) ===
* After you setup your Pandora, it is useful to update your system. This is caused depending on when you download the image, debian has already new packages ;)
* open an terminal
* get root ( command is: su )
* enter "apt-get update" to get the actual package informations
* enter "apt-get upgrade" to update all packages include the pandian-packages ;)

== Preinstalled packages ==
This are the packages which comes with the different versions of MARK2:
=== minimal ===
=== LXDE ===
* of course LXDE
* Text-Editor: medit
* Audio: mpd als backend, glurp as frontend

== Additional Users/Groups ==
There are additional Users/Groups added to the standard debian-users
=== Groups ===
* admin
:This user is used by sudo for admin task like shutdown etc.
* mpd
:This user/group has access to mpd-related files ( socket, pid-files )

== Debian repository ==
Pandian features an own additional debian repository to keep the pandian-core scripts up to date
* just open an terminal
* get root ( command is: su )
* enter "apt-get update" to get the actual package informations
* enter "apt-get upgrade" to update all packages include the pandian-packages ;)

== User-Guide ==
=== pdcmd ===
* This script handles all system-related stuff, like lid, low-power, usb or wifi.
* This should run as root
 
Usage:
{| class="wikitable"
|-
! Command !! What's done
|-
| /usr/sbin/pdcmd LCDBright + || Increase the light of the lid
|-
| /usr/sbin/pdcmd LCDBright - || Decrease the light of the lid
|-
| /usr/sbin/pdcmd LCDBright 10 || Set the Brightness of the lid to 10
|-
| /usr/sbin/pdcmd LCDTrigger || Trigger the lid ( WARNING: THIS DISABLE THE LID ! )
|-
| /usr/sbin/pdcmd USBNetTrigger || Enable the USB-Networking (module g_ether). If usbnetworking is on, it will disable it
|-
| /usr/sbin/pdcmd USBHostTrigger || Enable the USB-Host (module ehci-hcd). If USB-Host is on, it will disable it
|-
| /usr/sbin/pdcmd WLANTrigger || Enable Wifi. If Wifi is enabled it will be disabled
|}

LCDBright +

Pandian

2014-01-02T19:43:03Z

Stackshadow: Add user-guide; Add pdcmd to user-guide

[[File:Post-3032-0-90501200-1380479048.png|thumbnail|Logo]]

= Pandian =
Pandian is an debian-based armhf distro for you Pandora

== Main Idea ==
Bring a fully desktop to the pandora with the flavor of debian :)

== Help / Bugs / Features ==
Ideas, Bugs, or features-requests take a look on:
http://www.evilbrain.de/projects/pandian/issues

== Versions ==

{| class="wikitable"
|-
! Release !! Version Name !! Description
|-
| 29.09.2013 || 02 || The very first version of pandian
|-
| End of December || "MARK 2" || The next version
|}

= 01 =
'''Full debian GNU/Linux 7.2 codename Wheezy (stable) with LXDE desktop environment hardfloat armv7l released Date: 29.09.2013'''

==Features==

* Hard-Float-ABI
* Ext4 Root for better performance
* Working Touch-Screen
* Working Nubs
* Screen-Off on LID-Close
* Low-Power-Mode
* WLAN
* Music ( with Sonata/MPD )
* Automount

== Upcoming/Ideas ==

* Assistant for tzdata
* libpnd - PND-Support
* OpenGL not tested yet
* Aptitude
* Minimal-Network-Installation
* Pandian-Debian-Repository for special packages ( libpnd, touch-screen-calibrator )
* of course, in-system-documentation ( Documentation on the pandora )

Download [http://www.share-online.biz/dl/TPMFFXTM2AU here]

[http://boards.openpandora.org/topic/14482-pandian-01 Forum thread]

== Installation ==

note: It is assumed here, that the card-reader load the card as /dev/sdc.
Please check before which device is your SD-card !
This can be checked with gparted. Minimum requirement 2GB SD-card.

# Download Image ( as 7z )
# Verify md5-checksum: pandian-stable-hf_2013-09-29.001.7z '''2a85bbb40bbe7c6e8f92f058e150951a''' pandian-stable-hf_2013-09-29.001.img '''e62d101dc708de49af1ca7743e2df2bd'''
# Unzip with 7z ( in Linux with 7zr e <image.7z> )
# Copy image to SD-Card ( dd if=<image.img> of=/dev/sdx ) Don't specify "bs="

Username: ''Pandian'' 
Passwd: ''Root'' (change this after installation)

== Resize ==
Default installation is limited to 2GB, if you want to expand it, you can, provided you have installed it on a bigger SD-card and want to make use of the space.

* Size will be changed with parted
* parted /dev/sdx
* show size with "print free"

# (parted) print free # Model: USB Mass Storage Device (scsi)
# Disk /dev/sdc: 7965MB# Sector size (logical/physical): 512B/512B# Partition Table: msdos

{| class="wikitable"
|-
| Number || Start || End || Size || Type || File system || Flags
|-
| || 32,3kB || 1049kB || 1016kB || || Free Space ||
|-
| 1 || 1049kB || 53,5MB || 52,4MB || primary || fat32 ||
|-
| 2 || 53,5MB || 1933MB || 1879MB || primary || ext4 ||
|-
| || 1933MB || 7965MB || 6032MB || || Free Space ||
|}

we would like to resize the second partition to the nearly end ( -512MB for swap )
# (parted) resizepart # Partition number? 2 # Warning: Partition /dev/sdc2 is being used. Are you sure you want to continue?# Yes/No? YES # End? [1933MB]? 7453MB this is how the partitions looks like after

(parted) print free * Model: USB Mass Storage Device (scsi)* Disk /dev/sdc: 7965MB* Sector size (logical/physical): 512B/512B* Partition Table: msdos

{| class="wikitable"
|-
| Number || Start || End || Size || Type || File system || Flags
|-
| || 32,3kB || 1049kB || 1016kB || || Free Space ||
|-
| 1 || 1049kB || 53,5MB || 52,4MB || primary || fat32 ||
|-
| 2 || 53,5MB || '''7453'''MB || '''7400'''MB || primary || ext4 ||
|-
| || '''7453'''MB || 7965MB || '''512'''MB || || Free Space ||
|}

create Swap (optional)

(parted) mkpart primary linux-swap
Start? 7453MB
End? 7965MB

this is how the partitions looks like after

(parted) print free * Model: USB Mass Storage Device (scsi)* Disk /dev/sdc: 7965MB* Sector size (logical/physical): 512B/512B* Partition Table: msdos

{| class="wikitable"
|-
| Number || Start || End || Size || Type || File system || Flags
|-
| || 32,3kB || 1049kB || 1016kB || || Free Space ||
|-
| 1 || 1049kB || 53,5MB || 52,4MB || primary || fat32 ||
|-
| 2 || 53,5MB || 7453MB || 7400MB || primary || ext4 ||
|-
| || '''7453MB''' || '''7453MB''' || '''278kB''' || || '''Free Space'''||
|-
| || 7453MB || 7965MB || 512MB || '''primary''' || Free Space ||
|}
disregard the 4th entry, the new resized partition is the last one.

resize filesystem
*resize2fs /dev/sdc2

create swap

*mkswap /dev/sdc3

[[Category:Documentation]]
[[Category:Operating system]]
[[Category:Software]]

= MARK2 =
{{warning
| '''<big>Pandian MARK2 is not released yet, so please do nothing which is mentioned below this chapter ! Its only for preliminary documentation purpose to dont forget anything :)
IT WILL NOT WORK WITH THE ACTUAL VERSION OF PANDIAN</big>'''
}}

== Versions ==
There are two different versions of the "MARK2" release:
* minimal
:The minimal-version is an text-only-version of pandian but with wifi enabled and ceni for connecting to wifi-networks from command line
* LXDE
:The lxde-version which additional graphical tools

=== Which Version i should choose ? ===
* If you are an "normal" user and like to have an desktop, just choose the normal "MARK2" release
* If you don't like graphical user interface, or LXDE as Desktop use choose the minimal version
{{warning
| If you choose the minimal version, you need to setup USB-Networking to install additional packages, or you setup you interfaces for wifi
This is only recommended for advanced Linux-User
}}

== Installation ==
=== Requirements ===
* Of course a Pandora ;)
* An SD-Card with minimum 2GB ( was tested with 4GB )
* An Linux or Windows PC

=== Downloads ===
Coming soon ;)

=== Install the image ===

==== Linux ====
===== Verify you SD-Hardware =====
Check where your SD-Card is located.
If you have an build in SD-Card-Reader this is normally /dev/mmcblk0p1 ( in Debian )
If you have an USB-Card-Reader this is something like /dev/sdc ( in Debian )
* Open an Terminal and input "lsblk"
* You get an list with the actual Block-Devices
* The SD-Card should be as type disk

You can also try gparted to see which devices you have and identify the sd-card

===== Unzip =====
# Unzip with 7z ( in Linux with 7zr e <image.7z> )

===== Copy the image to the SD-Card =====
{{warning
| Warning, this will destroy everything on the device ! So please be very sure which device is you SD-Card !
}}
# Here it will be /dev/sdx
# Copy image to SD-Card with "dd if=<image.img> of=/dev/sdx"

===== Resize SD-Card =====
* After copy the SD-IMAGE to the SD-Card you need to resize the partitions to get the fully size of your SD-Card

* This can be done with gparted on linux
* start gparted

[[File:Gparted resize 001.png|800px|thumbnail|none|The actual partitions of the SD-CARD. Please select the correct device at the top right corner.]]
[[File:Gparted resize 002.png|800px|thumbnail|none|Rightclick to the second partition and select Resize/Move]]
[[File:Gparted resize 003.png|400px|thumbnail|none|You see the actual Size of this partition]]
[[File:Gparted resize 004.png|400px|thumbnail|none|Move the slider to the right, or set "Free space following" to 0]]
[[File:Gparted resize 005.png|800px|thumbnail|none|After you press the "Resize/Move" button, you get the preview of the new partition structure]]
[[File:Gparted resize 006.png|800px|thumbnail|none|When you press "Apply all operations", youve got a warning that you can loss your Data. THIS IS THE LAST CHANGE TO CHECK IF YOU SELECTED THE CORRECT DEVICE.

 Press Apply if everything is correct.]]

* After everything is fine, you have your new fresh pandian on you SD-Card
 

== First-start ==
* When you first start pandian, there is an first-start-wizard which guides you through some basic settings for Pandian
=== Navigation ===
* Inside an dialog you can navigate with the cross
* With space you select a checkbox
* <Ok> or to <Cancel> can be reached if you use TAB ( Tap Fn then tap Space )
* Acknowledge with Enter

== Preinstalled packages ==
This are the packages which comes with the different versions of MARK2:
=== minimal ===
=== LXDE ===
* of course LXDE
* Text-Editor: medit
* Audio: mpd als backend, glurp as frontend

== Additional Users/Groups ==
There are additional Users/Groups added to the standard debian-users
=== Groups ===
* admin
:This user is used by sudo for admin task like shutdown etc.
* mpd
:This user/group has access to mpd-related files ( socket, pid-files )

== Debian repository ==
Pandian features an own additional debian repository to keep the pandian-core scripts up to date
* just open an terminal
* get root ( command is: su )
* enter "apt-get update" to get the actual package informations
* enter "apt-get upgrade" to update all packages include the pandian-packages ;)

== User-Guide ==
=== pdcmd ===
* This script handles all system-related stuff, like lid, low-power, usb or wifi.
* This should run as root
 
Usage:
{| class="wikitable"
|-
! Command !! What's done
|-
| /usr/sbin/pdcmd LCDBright + || Increase the light of the lid
|-
| /usr/sbin/pdcmd LCDBright - || Decrease the light of the lid
|-
| /usr/sbin/pdcmd LCDBright 10 || Set the Brightness of the lid to 10
|-
| /usr/sbin/pdcmd LCDTrigger || Trigger the lid ( WARNING: THIS DISABLE THE LID ! )
|-
| /usr/sbin/pdcmd USBNetTrigger || Enable the USB-Networking (module g_ether). If usbnetworking is on, it will disable it
|-
| /usr/sbin/pdcmd USBHostTrigger || Enable the USB-Host (module ehci-hcd). If USB-Host is on, it will disable it
|-
| /usr/sbin/pdcmd WLANTrigger || Enable Wifi. If Wifi is enabled it will be disabled
|}

LCDBright +

Pandian

2014-01-02T17:56:06Z

Stackshadow: /* MARK2 */ fix layout of gparted-images

[[File:Post-3032-0-90501200-1380479048.png|thumbnail|Logo]]

= Pandian =
Pandian is an debian-based armhf distro for you Pandora

== Main Idea ==
Bring a fully desktop to the pandora with the flavor of debian :)

== Help / Bugs / Features ==
Ideas, Bugs, or features-requests take a look on:
http://www.evilbrain.de/projects/pandian/issues

== Versions ==

{| class="wikitable"
|-
! Release !! Version Name !! Description
|-
| 29.09.2013 || 02 || The very first version of pandian
|-
| End of December || "MARK 2" || The next version
|}

= 01 =
'''Full debian GNU/Linux 7.2 codename Wheezy (stable) with LXDE desktop environment hardfloat armv7l released Date: 29.09.2013'''

==Features==

* Hard-Float-ABI
* Ext4 Root for better performance
* Working Touch-Screen
* Working Nubs
* Screen-Off on LID-Close
* Low-Power-Mode
* WLAN
* Music ( with Sonata/MPD )
* Automount

== Upcoming/Ideas ==

* Assistant for tzdata
* libpnd - PND-Support
* OpenGL not tested yet
* Aptitude
* Minimal-Network-Installation
* Pandian-Debian-Repository for special packages ( libpnd, touch-screen-calibrator )
* of course, in-system-documentation ( Documentation on the pandora )

Download [http://www.share-online.biz/dl/TPMFFXTM2AU here]

[http://boards.openpandora.org/topic/14482-pandian-01 Forum thread]

== Installation ==

note: It is assumed here, that the card-reader load the card as /dev/sdc.
Please check before which device is your SD-card !
This can be checked with gparted. Minimum requirement 2GB SD-card.

# Download Image ( as 7z )
# Verify md5-checksum: pandian-stable-hf_2013-09-29.001.7z '''2a85bbb40bbe7c6e8f92f058e150951a''' pandian-stable-hf_2013-09-29.001.img '''e62d101dc708de49af1ca7743e2df2bd'''
# Unzip with 7z ( in Linux with 7zr e <image.7z> )
# Copy image to SD-Card ( dd if=<image.img> of=/dev/sdx ) Don't specify "bs="

Username: ''Pandian'' 
Passwd: ''Root'' (change this after installation)

== Resize ==
Default installation is limited to 2GB, if you want to expand it, you can, provided you have installed it on a bigger SD-card and want to make use of the space.

* Size will be changed with parted
* parted /dev/sdx
* show size with "print free"

# (parted) print free # Model: USB Mass Storage Device (scsi)
# Disk /dev/sdc: 7965MB# Sector size (logical/physical): 512B/512B# Partition Table: msdos

{| class="wikitable"
|-
| Number || Start || End || Size || Type || File system || Flags
|-
| || 32,3kB || 1049kB || 1016kB || || Free Space ||
|-
| 1 || 1049kB || 53,5MB || 52,4MB || primary || fat32 ||
|-
| 2 || 53,5MB || 1933MB || 1879MB || primary || ext4 ||
|-
| || 1933MB || 7965MB || 6032MB || || Free Space ||
|}

we would like to resize the second partition to the nearly end ( -512MB for swap )
# (parted) resizepart # Partition number? 2 # Warning: Partition /dev/sdc2 is being used. Are you sure you want to continue?# Yes/No? YES # End? [1933MB]? 7453MB this is how the partitions looks like after

(parted) print free * Model: USB Mass Storage Device (scsi)* Disk /dev/sdc: 7965MB* Sector size (logical/physical): 512B/512B* Partition Table: msdos

{| class="wikitable"
|-
| Number || Start || End || Size || Type || File system || Flags
|-
| || 32,3kB || 1049kB || 1016kB || || Free Space ||
|-
| 1 || 1049kB || 53,5MB || 52,4MB || primary || fat32 ||
|-
| 2 || 53,5MB || '''7453'''MB || '''7400'''MB || primary || ext4 ||
|-
| || '''7453'''MB || 7965MB || '''512'''MB || || Free Space ||
|}

create Swap (optional)

(parted) mkpart primary linux-swap
Start? 7453MB
End? 7965MB

this is how the partitions looks like after

(parted) print free * Model: USB Mass Storage Device (scsi)* Disk /dev/sdc: 7965MB* Sector size (logical/physical): 512B/512B* Partition Table: msdos

{| class="wikitable"
|-
| Number || Start || End || Size || Type || File system || Flags
|-
| || 32,3kB || 1049kB || 1016kB || || Free Space ||
|-
| 1 || 1049kB || 53,5MB || 52,4MB || primary || fat32 ||
|-
| 2 || 53,5MB || 7453MB || 7400MB || primary || ext4 ||
|-
| || '''7453MB''' || '''7453MB''' || '''278kB''' || || '''Free Space'''||
|-
| || 7453MB || 7965MB || 512MB || '''primary''' || Free Space ||
|}
disregard the 4th entry, the new resized partition is the last one.

resize filesystem
*resize2fs /dev/sdc2

create swap

*mkswap /dev/sdc3

[[Category:Documentation]]
[[Category:Operating system]]
[[Category:Software]]

= MARK2 =
{{warning
| '''<big>Pandian MARK2 is not released yet, so please do nothing which is mentioned below this chapter ! Its only for preliminary documentation purpose to dont forget anything :)
IT WILL NOT WORK WITH THE ACTUAL VERSION OF PANDIAN</big>'''
}}

== Versions ==
There are two different versions of the "MARK2" release:
* minimal
:The minimal-version is an text-only-version of pandian but with wifi enabled and ceni for connecting to wifi-networks from command line
* LXDE
:The lxde-version which additional graphical tools

=== Which Version i should choose ? ===
* If you are an "normal" user and like to have an desktop, just choose the normal "MARK2" release
* If you don't like graphical user interface, or LXDE as Desktop use choose the minimal version
{{warning
| If you choose the minimal version, you need to setup USB-Networking to install additional packages, or you setup you interfaces for wifi
This is only recommended for advanced Linux-User
}}

== Installation ==
=== Requirements ===
* Of course a Pandora ;)
* An SD-Card with minimum 2GB ( was tested with 4GB )
* An Linux or Windows PC

=== Downloads ===
Coming soon ;)

=== Install the image ===

==== Linux ====
===== Verify you SD-Hardware =====
Check where your SD-Card is located.
If you have an build in SD-Card-Reader this is normally /dev/mmcblk0p1 ( in Debian )
If you have an USB-Card-Reader this is something like /dev/sdc ( in Debian )
* Open an Terminal and input "lsblk"
* You get an list with the actual Block-Devices
* The SD-Card should be as type disk

You can also try gparted to see which devices you have and identify the sd-card

===== Unzip =====
# Unzip with 7z ( in Linux with 7zr e <image.7z> )

===== Copy the image to the SD-Card =====
{{warning
| Warning, this will destroy everything on the device ! So please be very sure which device is you SD-Card !
}}
# Here it will be /dev/sdx
# Copy image to SD-Card with "dd if=<image.img> of=/dev/sdx"

===== Resize SD-Card =====
* After copy the SD-IMAGE to the SD-Card you need to resize the partitions to get the fully size of your SD-Card

* This can be done with gparted on linux
* start gparted

[[File:Gparted resize 001.png|800px|thumbnail|none|The actual partitions of the SD-CARD. Please select the correct device at the top right corner.]]
[[File:Gparted resize 002.png|800px|thumbnail|none|Rightclick to the second partition and select Resize/Move]]
[[File:Gparted resize 003.png|400px|thumbnail|none|You see the actual Size of this partition]]
[[File:Gparted resize 004.png|400px|thumbnail|none|Move the slider to the right, or set "Free space following" to 0]]
[[File:Gparted resize 005.png|800px|thumbnail|none|After you press the "Resize/Move" button, you get the preview of the new partition structure]]
[[File:Gparted resize 006.png|800px|thumbnail|none|When you press "Apply all operations", youve got a warning that you can loss your Data. THIS IS THE LAST CHANGE TO CHECK IF YOU SELECTED THE CORRECT DEVICE.

 Press Apply if everything is correct.]]

* After everything is fine, you have your new fresh pandian on you SD-Card
 

== First-start ==
* When you first start pandian, there is an first-start-wizard which guides you through some basic settings for Pandian
=== Navigation ===
* Inside an dialog you can navigate with the cross
* With space you select a checkbox
* <Ok> or to <Cancel> can be reached if you use TAB ( Tap Fn then tap Space )
* Acknowledge with Enter

== Preinstalled packages ==
This are the packages which comes with the different versions of MARK2:
=== minimal ===
=== LXDE ===
* of course LXDE
* Text-Editor: medit
* Audio: mpd als backend, glurp as frontend

== Additional Users/Groups ==
There are additional Users/Groups added to the standard debian-users
=== Groups ===
* admin
:This user is used by sudo for admin task like shutdown etc.
* mpd
:This user/group has access to mpd-related files ( socket, pid-files )

== Debian repository ==
Pandian features an own additional debian repository to keep the pandian-core scripts up to date
* just open an terminal
* get root ( command is: su )
* enter "apt-get update" to get the actual package informations
* enter "apt-get upgrade" to update all packages include the pandian-packages ;)

Pandian

2014-01-02T17:52:36Z

Stackshadow: /* Installation */ Add resize-how-to with gparted

[[File:Post-3032-0-90501200-1380479048.png|thumbnail|Logo]]

= Pandian =
Pandian is an debian-based armhf distro for you Pandora

== Main Idea ==
Bring a fully desktop to the pandora with the flavor of debian :)

== Help / Bugs / Features ==
Ideas, Bugs, or features-requests take a look on:
http://www.evilbrain.de/projects/pandian/issues

== Versions ==

{| class="wikitable"
|-
! Release !! Version Name !! Description
|-
| 29.09.2013 || 02 || The very first version of pandian
|-
| End of December || "MARK 2" || The next version
|}

= 01 =
'''Full debian GNU/Linux 7.2 codename Wheezy (stable) with LXDE desktop environment hardfloat armv7l released Date: 29.09.2013'''

==Features==

* Hard-Float-ABI
* Ext4 Root for better performance
* Working Touch-Screen
* Working Nubs
* Screen-Off on LID-Close
* Low-Power-Mode
* WLAN
* Music ( with Sonata/MPD )
* Automount

== Upcoming/Ideas ==

* Assistant for tzdata
* libpnd - PND-Support
* OpenGL not tested yet
* Aptitude
* Minimal-Network-Installation
* Pandian-Debian-Repository for special packages ( libpnd, touch-screen-calibrator )
* of course, in-system-documentation ( Documentation on the pandora )

Download [http://www.share-online.biz/dl/TPMFFXTM2AU here]

[http://boards.openpandora.org/topic/14482-pandian-01 Forum thread]

== Installation ==

note: It is assumed here, that the card-reader load the card as /dev/sdc.
Please check before which device is your SD-card !
This can be checked with gparted. Minimum requirement 2GB SD-card.

# Download Image ( as 7z )
# Verify md5-checksum: pandian-stable-hf_2013-09-29.001.7z '''2a85bbb40bbe7c6e8f92f058e150951a''' pandian-stable-hf_2013-09-29.001.img '''e62d101dc708de49af1ca7743e2df2bd'''
# Unzip with 7z ( in Linux with 7zr e <image.7z> )
# Copy image to SD-Card ( dd if=<image.img> of=/dev/sdx ) Don't specify "bs="

Username: ''Pandian'' 
Passwd: ''Root'' (change this after installation)

== Resize ==
Default installation is limited to 2GB, if you want to expand it, you can, provided you have installed it on a bigger SD-card and want to make use of the space.

* Size will be changed with parted
* parted /dev/sdx
* show size with "print free"

# (parted) print free # Model: USB Mass Storage Device (scsi)
# Disk /dev/sdc: 7965MB# Sector size (logical/physical): 512B/512B# Partition Table: msdos

{| class="wikitable"
|-
| Number || Start || End || Size || Type || File system || Flags
|-
| || 32,3kB || 1049kB || 1016kB || || Free Space ||
|-
| 1 || 1049kB || 53,5MB || 52,4MB || primary || fat32 ||
|-
| 2 || 53,5MB || 1933MB || 1879MB || primary || ext4 ||
|-
| || 1933MB || 7965MB || 6032MB || || Free Space ||
|}

we would like to resize the second partition to the nearly end ( -512MB for swap )
# (parted) resizepart # Partition number? 2 # Warning: Partition /dev/sdc2 is being used. Are you sure you want to continue?# Yes/No? YES # End? [1933MB]? 7453MB this is how the partitions looks like after

(parted) print free * Model: USB Mass Storage Device (scsi)* Disk /dev/sdc: 7965MB* Sector size (logical/physical): 512B/512B* Partition Table: msdos

{| class="wikitable"
|-
| Number || Start || End || Size || Type || File system || Flags
|-
| || 32,3kB || 1049kB || 1016kB || || Free Space ||
|-
| 1 || 1049kB || 53,5MB || 52,4MB || primary || fat32 ||
|-
| 2 || 53,5MB || '''7453'''MB || '''7400'''MB || primary || ext4 ||
|-
| || '''7453'''MB || 7965MB || '''512'''MB || || Free Space ||
|}

create Swap (optional)

(parted) mkpart primary linux-swap
Start? 7453MB
End? 7965MB

this is how the partitions looks like after

(parted) print free * Model: USB Mass Storage Device (scsi)* Disk /dev/sdc: 7965MB* Sector size (logical/physical): 512B/512B* Partition Table: msdos

{| class="wikitable"
|-
| Number || Start || End || Size || Type || File system || Flags
|-
| || 32,3kB || 1049kB || 1016kB || || Free Space ||
|-
| 1 || 1049kB || 53,5MB || 52,4MB || primary || fat32 ||
|-
| 2 || 53,5MB || 7453MB || 7400MB || primary || ext4 ||
|-
| || '''7453MB''' || '''7453MB''' || '''278kB''' || || '''Free Space'''||
|-
| || 7453MB || 7965MB || 512MB || '''primary''' || Free Space ||
|}
disregard the 4th entry, the new resized partition is the last one.

resize filesystem
*resize2fs /dev/sdc2

create swap

*mkswap /dev/sdc3

[[Category:Documentation]]
[[Category:Operating system]]
[[Category:Software]]

= MARK2 =
{{warning
| '''<big>Pandian MARK2 is not released yet, so please do nothing which is mentioned below this chapter ! Its only for preliminary documentation purpose to dont forget anything :)
IT WILL NOT WORK WITH THE ACTUAL VERSION OF PANDIAN</big>'''
}}

== Versions ==
There are two different versions of the "MARK2" release:
* minimal
:The minimal-version is an text-only-version of pandian but with wifi enabled and ceni for connecting to wifi-networks from command line
* LXDE
:The lxde-version which additional graphical tools

=== Which Version i should choose ? ===
* If you are an "normal" user and like to have an desktop, just choose the normal "MARK2" release
* If you don't like graphical user interface, or LXDE as Desktop use choose the minimal version
{{warning
| If you choose the minimal version, you need to setup USB-Networking to install additional packages, or you setup you interfaces for wifi
This is only recommended for advanced Linux-User
}}

== Installation ==
=== Requirements ===
* Of course a Pandora ;)
* An SD-Card with minimum 2GB ( was tested with 4GB )
* An Linux or Windows PC

=== Downloads ===
Coming soon ;)

=== Install the image ===

==== Linux ====
===== Verify you SD-Hardware =====
Check where your SD-Card is located.
If you have an build in SD-Card-Reader this is normally /dev/mmcblk0p1 ( in Debian )
If you have an USB-Card-Reader this is something like /dev/sdc ( in Debian )
* Open an Terminal and input "lsblk"
* You get an list with the actual Block-Devices
* The SD-Card should be as type disk

You can also try gparted to see which devices you have and identify the sd-card

===== Unzip =====
# Unzip with 7z ( in Linux with 7zr e <image.7z> )

===== Copy the image to the SD-Card =====
{{warning
| Warning, this will destroy everything on the device ! So please be very sure which device is you SD-Card !
}}
# Here it will be /dev/sdx
# Copy image to SD-Card with "dd if=<image.img> of=/dev/sdx"

===== Resize SD-Card =====
* After copy the SD-IMAGE to the SD-Card you need to resize the partitions to get the fully size of your SD-Card

* This can be done with gparted on linux
* start gparted

[[File:Gparted resize 001.png|800px|thumbnail|left|The actual partitions of the SD-CARD. Please select the correct device at the top right corner.]]
[[File:Gparted resize 002.png|800px|thumbnail|left|Rightclick to the second partition and select Resize/Move]]
[[File:Gparted resize 003.png|400px|thumbnail|left|You see the actual Size of this partition]]
[[File:Gparted resize 004.png|400px|thumbnail|left|Move the slider to the right, or set "Free space following" to 0]]
[[File:Gparted resize 005.png|800px|thumbnail|left|After you press the "Resize/Move" button, you get the preview of the new partition structure]]
[[File:Gparted resize 006.png|800px|thumbnail|left|When you press "Apply all operations", youve got a warning that you can loss your Data. THIS IS THE LAST CHANGE TO CHECK IF YOU SELECTED THE CORRECT DEVICE. Press Apply if everything is correct.]]

* After everything is fine, you have your new fresh pandian on you SD-Card

== First-start ==
* When you first start pandian, there is an first-start-wizard which guides you through some basic settings for Pandian
=== Navigation ===
* Inside an dialog you can navigate with the cross
* With space you select a checkbox
* <Ok> or to <Cancel> can be reached if you use TAB ( Tap Fn then tap Space )
* Acknowledge with Enter

== Preinstalled packages ==
This are the packages which comes with the different versions of MARK2:
=== minimal ===
=== LXDE ===
* of course LXDE
* Text-Editor: medit
* Audio: mpd als backend, glurp as frontend

== Additional Users/Groups ==
There are additional Users/Groups added to the standard debian-users
=== Groups ===
* admin
:This user is used by sudo for admin task like shutdown etc.
* mpd
:This user/group has access to mpd-related files ( socket, pid-files )

== Debian repository ==
Pandian features an own additional debian repository to keep the pandian-core scripts up to date
* just open an terminal
* get root ( command is: su )
* enter "apt-get update" to get the actual package informations
* enter "apt-get upgrade" to update all packages include the pandian-packages ;)

File:Gparted resize 006.png

2014-01-02T17:38:21Z