PND Cookbook - Revision history

Kingu: content moved to Introduction to PNDs

2013-10-29T00:21:48Z

content moved to Introduction to PNDs

T4b: Corrected tag

2011-04-23T17:13:25Z

Corrected <source> tag

← Older revision		Revision as of 17:13, 23 April 2011
Line 113:		Line 113:
	Save this output to a text file named ''bios.md5'' and put it in your PND root directory. The following commands can then be used in your start-up script to copy a file specified by the user, and check it's hash.		Save this output to a text file named ''bios.md5'' and put it in your PND root directory. The following commands can then be used in your start-up script to copy a file specified by the user, and check it's hash.

	<source>		<source lang=bash>
	BIOS=bios.img # The name of our BIOS file		BIOS=bios.img # The name of our BIOS file

ABC: formating

2011-04-23T06:18:27Z

formating

← Older revision		Revision as of 06:18, 23 April 2011
Line 1:		Line 1:
	=== Using a start-up script ===		=== Using a start-up script ===
	In an ideal world, your application will be completely self-contained and can be run directly without any kind of set-up. It is however often necessary to tweak settings or request input from the user before starting your application. This is easily achieved by having the PND specify a shell script as its executable, which then in turn runs the application. The general structure of such a script is:		In an ideal world, your application will be completely self-contained and can be run directly without any kind of set-up. It is however often necessary to tweak settings or request input from the user before starting your application. This is easily achieved by having the [[PND]] specify a shell script as its executable, which then in turn runs the application. The general structure of such a script is:
	<~~pre~~>		<source lang="bash">
	#!/bin/sh		#!/bin/sh

Line 9:		Line 9:

	# Clean-up		# Clean-up
	</~~pre~~>		</source>
	The first line identifies the file as a shell script, run using "/bin/sh" as the shell. The other lines beginning with a "#" are comments. Before the application is started, parameters can be gathered and/or set. The application itself then gets run by the "./my_app" line, which means "execute the file ''my_app'' in the current directory". When the application exits, it may be necessary to restore previous settings, delete temporary files, or perform some other kinds of cleaning up.		The first line identifies the file as a shell script, run using "/bin/sh" as the shell. The other lines beginning with a "#" are comments. Before the application is started, parameters can be gathered and/or set. The application itself then gets run by the "./my_app" line, which means "execute the file ''my_app'' in the current directory". When the application exits, it may be necessary to restore previous settings, delete temporary files, or perform some other kinds of cleaning up.

	=== Avoiding NAND writes by setting $HOME ===		=== Avoiding NAND writes by setting $HOME ===
	Many applications write configuration data to the user's home directory by default. This is not desirable on the Pandora as this directory resides on the NAND filesystem. It is however often possible to fool an application into writing to a different directory by setting the $HOME environment variable.		Many applications write configuration data to the user's home directory by default. This is not desirable on the Pandora as this directory resides on the [[NAND]] filesystem. It is however often possible to fool an application into writing to a different directory by setting the $HOME environment variable.
	<~~pre~~>		<source lang="bash">
	export HOME=`pwd`		export HOME=`pwd`
	export HOME=$(pwd)		export HOME=$(pwd)
	</~~pre~~>		</source>

	=== Providing a default configuration ===		=== Providing a default configuration ===
	If your application uses a configuration file, you'll usually want to include this in the PND. However, if you simply leave this file in the root of the PND, it will effectively be read-only, preventing the application or user from writing to it. A simple solution is to provide a default configuration file with a different name, and copy this the first time the application is run. The file will then be created under ''appdata'', and can therefore easily be edited.		If your application uses a configuration file, you'll usually want to include this in the PND. However, if you simply leave this file in the root of the PND, it will effectively be read-only, preventing the application or user from writing to it. A simple solution is to provide a default configuration file with a different name, and copy this the first time the application is run. The file will then be created under ''appdata'', and can therefore easily be edited.
	<~~pre~~>		<source lang="bash">
	# Method 1: check if file exists, otherwise copy default.		# Method 1: check if file exists, otherwise copy default.
	if [ ! -f app.conf ] ; then		if [ ! -f app.conf ] ; then
Line 32:		Line 32:
	# Method 3: using a non-destructive copy.		# Method 3: using a non-destructive copy.
	cp --no-clobber default.conf app.conf		cp --no-clobber default.conf app.conf
	</~~pre~~>		</source>

	==== Nub Configuration ====		==== Nub Configuration ====
Line 39:		Line 39:
	=== Making writable directories ===		=== Making writable directories ===
	If your application requires that directories be writable for the application, don't put them in the PND, but create them at run-time:		If your application requires that directories be writable for the application, don't put them in the PND, but create them at run-time:
	<~~pre~~>		<source lang="bash">
	# Bad! This will cause an error after the first run, as the directory will already exist.		# Bad! This will cause an error after the first run, as the directory will already exist.
	mkdir saved_data		mkdir saved_data
Line 48:		Line 48:
	# Added bonus: this allows you to create whole trees in one go.		# Added bonus: this allows you to create whole trees in one go.
	mkdir -p saved_data/foo saved_data/bar/with/deep/sub/dirs		mkdir -p saved_data/foo saved_data/bar/with/deep/sub/dirs
	</~~pre~~>		</source>

	=== Loading shared libraries ===		=== Loading shared libraries ===
	If your application requires shared libraries which aren't part of the standard firmware, they can be included in the PND along with the executable. In order for the system to be able to find the libraries, it must be told which directories to search. This can be done by setting the LD_LIBRARY_PATH environment variable. For example:		If your application requires shared libraries which aren't part of the standard firmware, they can be included in the PND along with the executable. In order for the system to be able to find the libraries, it must be told which directories to search. This can be done by setting the LD_LIBRARY_PATH environment variable. For example:
	<~~pre~~>		<source lang="bash">
	export LD_LIBRARY_PATH=`pwd` # Load libraries in the root directory of the PND.		export LD_LIBRARY_PATH=`pwd` # Load libraries in the root directory of the PND.
	export LD_LIBRARY_PATH=`pwd`/libs # Load libraries in the "libs" subdirectory of the PND.		export LD_LIBRARY_PATH=`pwd`/libs # Load libraries in the "libs" subdirectory of the PND.
	</~~pre~~>		</source>

	=== Getting a file/directory from the user ===		=== Getting a file/directory from the user ===
	Its often necessary to ask the user for the location of a file or directory. This may be because your application requires files which aren't included in the PND itself, or simply because you application doesn't have a built in file picker. The commands below will prompt the user for a file, then run "my_app" with that file as an argument. Note the use of different sorts of quotes which is important for proper operation and handling spaces in file names.		Its often necessary to ask the user for the location of a file or directory. This may be because your application requires files which aren't included in the PND itself, or simply because you application doesn't have a built in file picker. The commands below will prompt the user for a file, then run "my_app" with that file as an argument. Note the use of different sorts of quotes which is important for proper operation and handling spaces in file names.
	<~~pre~~>		<source lang="bash">
	FILE="`zenity --file-selection --title='Select a File'`"		FILE="`zenity --file-selection --title='Select a File'`"
	./my_app "$FILE"		./my_app "$FILE"
	</~~pre~~>		</source>

	=== Saving a file/directory name ===		=== Saving a file/directory name ===
	If your application always asks for a file at start-up, it's handy to remember the location for next time. This can be done by writing the name of the directory to a file in appdata, and reading it back next time the application is run.		If your application always asks for a file at start-up, it's handy to remember the location for next time. This can be done by writing the name of the directory to a file in appdata, and reading it back next time the application is run.
	<~~pre~~>		<source lang="bash">
	SAVEDIR=./dir.saved # Name of the file we'll save the directory name to		SAVEDIR=./dir.saved # Name of the file we'll save the directory name to

Line 100:		Line 100:
	# Run our app with the file as an argument.		# Run our app with the file as an argument.
	./my_app "$FILE"		./my_app "$FILE"
	</~~pre~~>		</source>

	=== Checking a file's contents ===		=== Checking a file's contents ===
Line 106:		Line 106:

	One way of doing this is to check the file's contents using a hash. A hash is a mathematical formula which can be used to create a "fingerprint" of a file. Two identical files will always generate the same hash value, so knowing this one value is enough to check if two files match. The MD5 hash is a popular choice, and can be easily generated for a given file like so:		One way of doing this is to check the file's contents using a hash. A hash is a mathematical formula which can be used to create a "fingerprint" of a file. Two identical files will always generate the same hash value, so knowing this one value is enough to check if two files match. The MD5 hash is a popular choice, and can be easily generated for a given file like so:
	<~~pre~~>		<source lang="bash">
	$ md5sum bios.img		$ md5sum bios.img
	cfcfd01f1b0dfa97f07cb286b2942dc2 bios.img		cfcfd01f1b0dfa97f07cb286b2942dc2 bios.img
	</~~pre~~>		</source>

	Save this output to a text file named ''bios.md5'' and put it in your PND root directory. The following commands can then be used in your start-up script to copy a file specified by the user, and check it's hash.		Save this output to a text file named ''bios.md5'' and put it in your PND root directory. The following commands can then be used in your start-up script to copy a file specified by the user, and check it's hash.

	<~~pre~~>		<source>
	BIOS=bios.img # The name of our BIOS file		BIOS=bios.img # The name of our BIOS file

Line 141:		Line 141:
	# Run our emulator with the BIOS file as an argument.		# Run our emulator with the BIOS file as an argument.
	./my_emu "$BIOS"		./my_emu "$BIOS"
	</~~pre~~>		</source>

	[[Category:PND]]		[[Category:PND]]
			[[Category:Development]]
	[[Category:Tutorial]]		[[Category:Tutorial]]

ABC: /* Checking a file's contents */ cat

2011-04-19T15:14:35Z

Checking a file's contents: cat

← Older revision		Revision as of 15:14, 19 April 2011
Line 142:		Line 142:
	./my_emu "$BIOS"		./my_emu "$BIOS"
	</pre>		</pre>

	[[Category:PND]]		[[Category:PND]]
	[[Category:~~Documentation~~]]		[[Category:Tutorial]]

Vadsamoht at 05:00, 17 April 2011

2011-04-17T05:00:28Z

← Older revision		Revision as of 05:00, 17 April 2011
Line 33:		Line 33:
	cp --no-clobber default.conf app.conf		cp --no-clobber default.conf app.conf
	</pre>		</pre>

			==== Nub Configuration ====
			This is a little (but not much!) lengthier - see the page on [[PND nub modes]].

	=== Making writable directories ===		=== Making writable directories ===

Maplesugarlover at 17:55, 19 February 2011

2011-02-19T17:55:59Z

← Older revision		Revision as of 17:55, 19 February 2011
Line 139:		Line 139:
	./my_emu "$BIOS"		./my_emu "$BIOS"
	</pre>		</pre>
			[[Category:PND]]
			[[Category:Documentation]]

Myownlittlworld: Undo revision 3874 by Valera (Talk) Revert vandalism by Valera.

2010-11-12T20:50:38Z

Undo revision 3874 by Valera (Talk) Revert vandalism by Valera.

← Older revision		Revision as of 20:50, 12 November 2010
Line 107:		Line 107:
	cfcfd01f1b0dfa97f07cb286b2942dc2 bios.img		cfcfd01f1b0dfa97f07cb286b2942dc2 bios.img
	</pre>		</pre>

	~~[http://www.casino-virtuelle.com/la-roulette-en-ligne jeu de casino]~~

	Save this output to a text file named ''bios.md5'' and put it in your PND root directory. The following commands can then be used in your start-up script to copy a file specified by the user, and check it's hash.		Save this output to a text file named ''bios.md5'' and put it in your PND root directory. The following commands can then be used in your start-up script to copy a file specified by the user, and check it's hash.

Valera: /* Checking a file's contents */

2010-10-19T12:43:07Z

Checking a file's contents

← Older revision		Revision as of 12:43, 19 October 2010
Line 107:		Line 107:
	cfcfd01f1b0dfa97f07cb286b2942dc2 bios.img		cfcfd01f1b0dfa97f07cb286b2942dc2 bios.img
	</pre>		</pre>

			[http://www.casino-virtuelle.com/la-roulette-en-ligne jeu de casino]

	Save this output to a text file named ''bios.md5'' and put it in your PND root directory. The following commands can then be used in your start-up script to copy a file specified by the user, and check it's hash.		Save this output to a text file named ''bios.md5'' and put it in your PND root directory. The following commands can then be used in your start-up script to copy a file specified by the user, and check it's hash.

DawnOfTheRent: /* Providing a default configuration */

2010-09-12T07:22:36Z

Providing a default configuration

← Older revision		Revision as of 07:22, 12 September 2010
Line 20:		Line 20:

	=== Providing a default configuration ===		=== Providing a default configuration ===
	If your application uses a configuration file, you'll usually want to include this in the PND. However, if you simply leave this file ~~int he~~ root of the PND, it will effectively be read-only, preventing the application or user from writing to it. A simple solution is to provide a default configuration file with a different name, and copy this the first time the application is run. The file will then be created under ''appdata'', and can therefore easily be edited.		If your application uses a configuration file, you'll usually want to include this in the PND. However, if you simply leave this file in the root of the PND, it will effectively be read-only, preventing the application or user from writing to it. A simple solution is to provide a default configuration file with a different name, and copy this the first time the application is run. The file will then be created under ''appdata'', and can therefore easily be edited.
	<pre>		<pre>
	# Method 1: check if file exists, otherwise copy default.		# Method 1: check if file exists, otherwise copy default.

DawnOfTheRent: /* Providing a default configuration */

2010-09-12T07:22:02Z

Providing a default configuration

← Older revision		Revision as of 07:22, 12 September 2010
Line 20:		Line 20:

	=== Providing a default configuration ===		=== Providing a default configuration ===
	If your application uses a configuration file, you'll usually want to include this in the PND. However, if you simply leave this file int he root of the PND, it will effectively be read-only, preventing the application or user from writing to it. A simple solution is to provide a default configuration file with a different name, and copy this the first time the application is run. The file will then be created under ''appdata'', and can therefore easily be edited.		If your application uses a configuration file, you'll usually want to include this in the PND. However, if you simply leave this file int he root of the PND, it will effectively be read-only, preventing the application or user from writing to it. A simple solution is to provide a default configuration file with a different name, and copy this the first time the application is run. The file will then be created under ''appdata'', and can therefore easily be edited.
	<pre>		<pre>
	# Method 1: check if file exists, otherwise copy default.		# Method 1: check if file exists, otherwise copy default.