README. WHAT'S CAANOO USBNETWORK?
-----------------------------

Connect your Caanoo to your network using USB cable.
You will be able to ssh/telnet into the Caanoo, 
or even surf the Internet using Caanoo Web Browser and the USB cable provided with your Caanoo.

This has been tested on Caanoo firmware v-1.0.6b and firmware v-1.5.0.
This has been tested only with Linux as host PC OS, but it will work with Windows as soon as you know 
to configure the host side under this OS.

README. HOWTO INSTALL/USE
--------------------------

## Step 0: In your PC (linux)
## Insert the usb0 configuration in the network/interfaces
aiken@linuxpc:~$  sudo cat caanoousbnet/network_interfaces >> /etc/network/interfaces

## Step 1: In your PC (linux)
## Install usbnet
## If you have a modern distribution you probably have it installed as a module
aiken@linuxpc:~$ sudo locate usbnet.ko

## Step 2: Copy the caanoousbnet files to your Caanoo SD card
## Download and Unzip the caanoousbnet_v1.0.zip file.
## Copy the contents (canoousbnet folder and caanoousbnet.ini file) to your SD card (into the apps folder)

## Step 3: Install an ssh server in your Caanoo.
## Dropbear ssh server is ported to the Caanoo.
## You can download it from any of the usual Caanoo scene websites.
## Download and Unzip its contents into the apps folder in your SD.
## You can use telnetd if you preffer, it is already installed in your caanoo but you need to activate it.
## We recommend using dropbear instead of telnetd.

## Step 4: Connect your Caanoo to your PC.
## Use the usb cable that came with the Caanoo to connect to the PC as usual.
## Touch the close button to exit from the "Usb connected" screen in the Caanoo.
## Navigate to Apps menu and execute Caanoo USBNet v-1.0, the loading screen will appear for a moment and it will return to the main menu.
## At this point, probably a notification will appear in your PC (linux) saying that "Caanoo Ethernet" has been detected.
## Anyway you can check if the new network interface (usb0) has been created.
aiken@linuxpc:~$ sudo ifconfig -a
## Navigate to Apps menu again, and execute Dropbear, the loading screen will appear for a moment and it will return to the main menu.
## At this point your PC and your Caanoo are linked throught port usb0!

## Step 5: SSH/Telnet into your Caanoo.
## At this point you should be able to ping to/from your Caanoo.
## Your Caanoo IP should be 10.0.0.2
aiken@linuxpc:~$ sudo ping 10.0.0.2
## If you executed Dropbear server, by now you should be able to ssh into your Caanoo.
aiken@linuxpc:~$ sudo ssh root@10.0.0.2 (empty password)
## Some strange commands will appear in the ssh screen as soon as you enter. Hit Ctrl+C to stop them.
## It is the start.sh script that runs every time the Caanoo boots up, i dont know why the hell it is in the root login instead of being in the system boot.
## In addition to the strange commands in the ssh screen, the Caanoo screen will show strange too. Dont be alarmed! it will stop as soon as you hit Ctrl+C.
## Once your are in, maybe you want to check the Caanoo can reach the internet.
root@caanoo:# ping 212.81.134.34

## Step 6: Internet access from the Caanoo
## At this point you should be able to reach the Internet form the Caanoo.
## But probably you dont have DNS forwarding, so you can only ping IP addresses.
## If so, you need to install a dns forwarder in your PC (linux)
aiken@linuxpc:~$ sudo apt-get install dnsmasq
## At this point you should have complete access to the Internet from your Caanoo.
root@caanoo:# wget http://www.gp32spain.com
## Yes! Wget is already installed in the Caanoo!
## You can install Caanoo Web Browser if you want to surf the Internet from your Caanoo.


TODO LIST
------------------
- Scripts to close the usb connection. At this moment you need to reboot the Caanoo if you want to recover the used resources.
- Scripts so it can be configured to activate automatically at boot, or when usb cable plugged.
- Some kind of GUI to check status, activate, deactivate, configure, etc.
- DHCP support. At this moment static IPs 10.0.0.1 (pc)  and 10.0.0.2 (caanoo) are used.

THANKS & GREETINGS
------------------
- To the GPH team, not only for the Caanoo but for their support to the scene.
- To the people of GP32Spain, for sharing all their knowledge about videoconsoles, linux, programming, etc.
- To Sharek from GP32Spain, that worked hard to get the caanoo linux kernel compiled.
- To the people that ported Usbnetwork to the GP2X Wiz, and the original Usbnetwork team, their work was an inspiration for me.
- To all the people of all the websites that support the scene.



