--------------------- --- General Stuff --- --------------------- Welcome to our Nokia Development VM. Below are basic instructions for getting started with N95 or N800/N810 development. A few things to note first: 1) Your username and password are both n95dev 2) To test if the network is working, try "ping www.google.com" in a terminal. If one isn't open you can launch a terminal by clicking the terminal icon on the top bar. If the network doesn't seem to be up, try "sudo ifup eth0". You'll need to enter your password (n95dev). 3) To share a folder with the host machine, hunt through the VMWare menus. In VMWare Workstation, it's in VM->Settings->Options->Shared Folders. You want to make sure it's enabled, and point it somewhere sensible for your machine, like the C: drive. If working it should appear under this VM image in /mnt/hgfs/HostShare, which we have symlinked to ~/HostShare. If you're having trouble with the menus, remember that the .vmx file associated with your VM image is human readable. Look for "sharedFolder0" to edit things by hand. 4) To access the VM's folders from a windows host, type 'ifconfig eth0' inside the VM to get the IP address of the VM, the enter '\\\' into a windows explorer address bar (not internet explorer). It will ask you to log in. The username and password are again both n95dev. You should see two shared folders. 'home' is /home/n95dev, ie your home directory. 'scratchbox-home' is /scratchbox/user/n95dev/home/n95dev, which is your home directory under the N800 emulator environment. You can ignore this second one if you're only doing N95 development. You can change all this under System->Administration->Shared Folders in the VMware Workstation menus. ----------------------- --- N95 Development --- ----------------------- 1) Make sure vmware is aware of your bluetooth device and has connected it to your VM. If it's a USB bluetooth stick look in VM->Removable Devices->USB Devices 2) Make sure your phone is set to be visible in Tools->Bluetooth. Set Bluetooth to "on", set visibility to "Shown to all", and set the name to something simple you can remember. 3) Run the Mount Bluetooth device script on the desktop 3.1) It will ask you to select your phone by the name you've given your phone. 3.2) You will then be requested to enter a passcode on your phone. Enter anything simple (eg 1234). 3.3) A box will pop up on the PC asking you to enter a passcode. Enter the same passcode. 3.4) The phone and PC should now be paired. The script also automatically launches the file browser to show you the contents of your phone. The E drive on the phone is the external memory card, and the C drive is the internal memory. Keep in mind the phone will not let you see operating system files. The phone's drives are mounted at /mnt/n95. 3.5) If clicking on the bluetooth icon didn't result in the above steps happening, you probably don't have a bluetooth device enabled under your VM. 4) Look under Examples in your home directory. Here are some simple example programs for the N95. In each one you can type "make" to compile it, and "make push" to push it via bluetooth to your phone. You'll probably have to hit 'Refresh' in the box that pops up before you can see your phone. It will appear in your inbox on your phone. If you open the message it will install the sis file. Next navigate to your applications menu to run it. Two examples are simple C++ programs, and one is an example of a python module that processes images. If your host OS is windows, another way to install it on your phone is to navigate to the appropriate shared directory from the host and double click on the created .sis file. ------------------------ --- N8x0 Development --- ------------------------ 1) Get your N800 on your WiFi network. It must not be behind a NAT relative to your development computer, because you'll need to ssh from your development computer to the N800. For most users, it will be enough to click the little WiFi icon on the top right of the N800's main screen, choose the right network, then open a terminal window under Apps->Utilities->X Terminal (scroll down to the bottom of the list) and type "/sbin/ifconfig wlan0". Your ip address is listed as "inet addr". Make a note of it. 1) Get your N800 to a state where you can ssh in as root. There are a few ways to do this. Try http://maemo.org/community/wiki/installssh for more details. 2) Run n800env.sh. A window should pop up with an emulated N800 desktop. The shell should dump you in an emulated N800 environment running under qemu. Eventually, the command prompt should say 'sbox-CHINOOK_ARMEL'. Anything you compile (with gcc) under this environment in the regular way you can run on your N800! You are in a new home directory inside the emulator. To get there from outside the emulator, look in /scratchbox/users/n95dev/home/n95dev. 3) The emulated OS is a debian style OS. To install new packages, use 'fakeroot apt-get install '. You should be able to install anything you can install on the N800 itself. 4) Check out Examples/ for two small C example GUI programs. To test them out on your N800, scp them to your N800 "scp example root@:", ssh in as root "ssh root@", and run them "run-standalone.sh ./example". 5) If you don't have network access inside the emulator, but you do inside the VM, check /etc/resolv.conf from inside the emulator to make sure it has the right dns server address. The right address is usually whatever is in /etc/resolv.conf *outside* the emulator. 6) For more details, including how to install things 'the right way' (ie as packages instead of just copying over binaries), check out www.maemo.org, and in particular the tutorial at http://maemo.org/development/documentation/tutorials/maemo_4-0_tutorial.html 7) Hitting ctrl-c while nothing is running inside the emulator messes things up. If you need to restart the emulator, run "logout" (or hit ctrl-d), run "killall -9 Xephyr", and run "killall -9 maemo-launcher", to make sure it's all shut down. Then run n800env.sh again.