From Qi-Hardware
Jump to: navigation, search


[edit] User Documentation

Jlime Muffinman distribution is a Linux distribution aimed for the Ben_NanoNote machine. It was built using OpenEmbedded with Jlime look and feel. Main goals are : provide well configured applications and a complete OE built software repository.

Check some videos of Muffinman: Booting Wikireader

The Full images brings a X Environment, Matchbox Desktop, and several useful applications (video player, music player, image viewer, text editor, terminal, pdf viewer, dictionary, wikireader, games.. and more. The rootfs also brings a few CC multimedia files so we can test all the applications easily.

If you need details about how to get files and install Jlime then read The Downloads and Installation Instructions

[edit] root password

root password : root

[edit] Shortcuts to control the Desktop

ALT+F1 : Hide all windows and focus desktop
ALT+F2 : Move backwards between windows immediately
ALT+F3 : Move between windows immediately
ALT+F4 : Close a window

KEEP THIS LIST OF SHORTCUTS ON HAND! :) or you will have to reboot your system when some application runs fullscreen and you don't know what to press.

Number keys: fn key + number.
Vol keys react as Page up/down on X. But for video player and music player these work as Volume.


Your muffinman system have already configured its usb0 network interface (IP

Usually stock kernels already support usb networking, so if you are using for instance ubuntu/debian it should pop up directly. You can check by doing:

 ifconfig usb0
 usb0      Link encap:Ethernet  HWaddr 71:BF:F1:B2:8A:E8  
           inet addr:  Bcast:  Mask:
           RX packets:5998 errors:0 dropped:0 overruns:0 frame:0
           TX packets:7357 errors:0 dropped:0 overruns:0 carrier:0
           collisions:0 txqueuelen:1000 
           RX bytes:357275 (348.9 Kb)  TX bytes:9340199 (8.9 Mb)

Example to set your usb0 on your Linux PC :

 ifconfig usb0 <-- setting pc usb0 ip
 ssh -l root <-- logging into nanonote
 (password is root)

troubleshooting: If you cannot see your usb0 device then its most likely due to your kernel, especially if you have built it yourself. Make sure that modules for gadget ethernet and usbdnet is loaded. If you cant find them, then doublecheck inside your kernel menuconfig.


You should config your PC as router, for example with :

 echo "1" > /proc/sys/net/ipv4/ip_forward 
 /sbin/iptables -t nat -A POSTROUTING -o eth0 -j MASQUERADE (if eth0 is your internet connection)

Now, your Jlime system has internet connection. **You will most likely need to replace the /etc/resolv.conf** nameservers on your nanonote with the proper ones (just use the ones inside your pc's /etc/resolv.conf).


NEW!'. Now there is a new tool to install packages. It is a script to avoid the swap problems with opkg. The name is jlime-pkg. Also, the system is already configured to use Jlime repository at qi-hardware.com.

After you have gotten your internet connection going, its time to grab an list of available packages.

 jlime-pkg update <-- syncs package database

Examples of actions:

 jlime-pkg search <expr> <-- will search some package. Example:
 jlime-pkg search game
 jlime-pkg install bash  <--will download and install bash
 opkg remove bash <--will remove bash from your nanonote

So use jlime-pkg to update, search and install packages. Use opkg for removing packages.

[edit] SET DATE and TIME

Use date and hwclock commands.

For example (we are setting 31th of August 2010, at 20:00pm):

 date -s 20100831
 date -s 20:00
 hwclock -w


Use the power ON/OFF button to shutdown the device, always.


If you want seeing or playing your files easily:

 * Copy the video files under ~/videos/
 * Copy the music files under ~/music/
 * Copy the image files under ~/image/
 * For text files and other kind of formats use ~/documents/

[edit] Video Player

It is a theora video player. Just minimal control keys :

q or ESC : quit
space : pause

[edit] Music player

It is GMU. Their usage is pretty easy because there is a help at bottom. Main keys :

ALT+ENTER : quit
VOL UP/DOWN : Volume
TAB : move between playlist/file selector/etc

[edit] NightSky

F1 : help :)

[edit] GnuRobbo game

Alt + arrows to shoot.

[edit] Image Viewer

Image Viewer shows the image files under ~/images/ folder. You can browse them using arrows. "Q key" quits.

[edit] Dictionary and Wikireader

The Dict application has two plugins: english dictionary and english wikireader.

FIRST OF ALL: wikireader needs swap. If you do not have a bit of swap wikireader will not work. Also, you will need to install the proper wikipedia dump for it. The name of this dump is wiki-a317.tgz.

You can download the english wikireader dump from :


gunzip and untar under /usr/local/share/mydict/ . You should get the /usr/local/share/mydict/a317/ folder which contains the dump.

After that run Dict from desktop and enjoy the wikireader!

Keep in mind that the wikipedia dump uses around 1.1GB, so you need that free space before to untar.

IMPORTANT!: wikireader needs swap.

[edit] SDL on Framebuffer

If you want to run SDL games or applications on framebuffer set the next environments VARS :

  export SDL_VIDEODRIVER=fbcon
  export SDL_NOMOUSE=1

[edit] Extra applications

There are extra packages (manually built). You can check which ones here.

These are under jlime-pkg as well. So if you want to install, for example, fbterm, run: **jlime-pkg install fbterm**


Muffinman is fully theme-able, because it uses both, Matchbox Window Manager and Matchbox Desktop.

If you want to replace the WALLPAPER, just replace the /etc/muffinman-extras/wallpaper.png file with your wallpaper.png file.

To modify the theme, icons and folders just read the Matchbox Desktop and Window Manager documentation

It is easy, because Matchbox, like others Linux Desktop/Window Managers, uses freedesktop.org specifications.

[edit] Taking SCREENSHOTS

Install xwd package.

jlime-pkg install xwd

Take a screenshot with :

xwd -root -out /tmp/screenshot.dump

[edit] Getting Development Environment Going

Below are all the packages you will need to install to get GIT compiled nicely. It should therefore also provide basic packages for most development scenarios.

for i in gcc gcc-symlinks cpp g++ g++-symlinks binutils binutils-symlinks \
         linux-libc-headers-dev libc6-dev autoconf make libz-dev libz1 perl \
         perl-dev perl-modules tcl tcl-dev python-modules distcc coreutils ; do 
   jlime-pkg install $i
jlime-pkg install vim (<-- replace with your favourite editor)

Its quite possible that you will require more packages later on but this should do the trick for the basics. Anything else you might require will most likely be stated as an "missing /usr/blalala" and then you just install that.

[edit] System on microSD: How to mount the NAND partition for access

These steps are not needed if you have beta4, it is just here to document the manual process.

 # install the mtd-utils package
 mknod /dev/ubi_ctrl c 10 63
 ubiattach /dev/ubi_ctrl -m 2
 mkdir /media/nand
 mount -t ubifs ubi0:rootfs /media/nand
 cd /media/nand

[edit] How to RECORD and PLAY sound files (using mic/speaker)

You can use the "Audio Recorder" application on Desktop. But, if you need manual settings or work done folow the below instructions.

In order to record, the device's "capture" switch must be set. To do so, run alsamixer (Audio Settings), select your microphone (maybe you need to press TAB) and press space. Something like...

  L    R

should appear. Set the level of the Mic there with arrow keys :33% is okey for good quality.

Then we record a while using the mic with (CD quality, 8 seconds, wav) :

  arecord -d 8 -f cd -t wav test.wav 

Then listen your file with :

  aplay test.wav

[edit] Links

Go back Jlime main page

If you need details about how to get files and install Jlime then read The Downloads and Installation Instructions

If you need to get, manually, some Jlime file for some reason you will find everything at : http://downloads.qi-hardware.com/jlime/

Personal tools