QuimWiki

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
===== Physical interfaces =====
==== Serial port ====

The QuimBox features multiple mini-USB ports to connect to the different modules of the box. They all integrate a serial-to-usb converter for easy connection with a development station. 

The serial port settings should be as follows:
  * Baudrate: 115200 bps
  * Data Bits: 8
  * Parity: None
  * Stop bits: 1
  * Flow control: None

Using Minicom on Linux, typical settings are:

<code>
A -    Serial Device      : /dev/ttyUSB0
B - Lockfile Location     : /var/lock
C -   Callin Program      : 
D -  Callout Program      : 
E -    Bps/Par/Bits       : 115200 8N1
F - Hardware Flow Control : No
G - Software Flow Control : No  
</code>

==== WiFi ====

By default, the QuimBox will generate an //ad-hoc// Wifi network with SSID ''**quimbox**''.
The QuimBox ''wlan0'' interface is configured with a static IP address:

  * IP address: 192.168.0.2
  * Mask: 255.255.255.0

In order to reach the box, you should configured your workstation with an IP address in the same subnet as the QuimBox (ie. 192.168.0.x ). Once connected to the //ad-hoc// network, you should be able to ping the box.

<code - Workstation>
% ifconfig wlan0
wlan0     Link encap:Ethernet  HWaddr 88:53:2e:1d:61:54  
          inet addr:192.168.0.1  Bcast:192.168.0.255  Mask:255.255.255.0
          UP BROADCAST RUNNING MULTICAST  MTU:1500  Metric:1
          RX packets:61613 errors:0 dropped:0 overruns:0 frame:0
          TX packets:61342 errors:0 dropped:0 overruns:0 carrier:0
          collisions:0 txqueuelen:1000 
          RX bytes:40267413 (40.2 MB)  TX bytes:12727401 (12.7 MB)

% ping 192.168.0.2
PING 192.168.0.2 (192.168.0.2) 56(84) bytes of data.
64 bytes from 192.168.0.2: icmp_seq=1 ttl=64 time=6.92 ms
64 bytes from 192.168.0.2: icmp_seq=2 ttl=64 time=2.10 ms
64 bytes from 192.168.0.2: icmp_seq=3 ttl=64 time=2.12 ms

</code>

==== RJ45 ====

If you want to use the USB-to-Ethernet dongle, you should plug it in one of the front USB ports before powering on the QuimBox. During startup, the dongle will be detected and a ''eth0'' interface will be created in Linux. 

By default, this interface is configured with a Dynamic IP, received from a DHCP server (typically your router).

You can check which IP@ it obtained from the Linux shell:

<code - QuimBox>
root@buildroot:~# ifconfig eth0
eth0      Link encap:Ethernet  HWaddr 00:80:8A:8E:BA:1E  
          inet addr:192.168.1.3  Bcast:192.168.1.255  Mask:255.255.255.0
          UP BROADCAST RUNNING MULTICAST  MTU:1500  Metric:1
          RX packets:1151 errors:0 dropped:0 overruns:0 frame:0
          TX packets:0 errors:0 dropped:0 overruns:0 carrier:0
          collisions:0 txqueuelen:1000 
          RX bytes:166980 (163.0 KiB)  TX bytes:15896 (15.5 KiB)
</code>


===== Linux shell =====

Two users are configured by default in the QuimBox linux environment:

  * the Linux superuser
    * Username: root
    * Password: admin
  * a default user
    * Username: default
    * No password

When you want to connect to the Linux shell, you have to login as one of these users. 

When you have IP connectivity to the QuimBox, we encourage to use ssh to login on the box.

<code - Workstation>
# say you are connected to the wifi
# the QuimBox static IP address is 192.168.0.2
% ssh root@192.168.0.2
root@192.168.0.2's password:  
root@buildroot:~# ls /
bin      etc      lib      linuxrc  mnt      proc     run      sys      usr
dev      home     lib32    media    opt      root     sbin     tmp      var
root@buildroot:~# 
</code>  

===== File transfers =====

Once you have IP connectivity with the QuimBox, standard file transfers protocols are available to load your executable or configuration files.

==== TFTP ====

TFTP is a very simple, still popular, file transfer protocol. 

On the QuimBox, the TFTP server root is / .

<code - Workstation>
# put my_file to /my_file on the QuimBox
~ % tftp 192.168.0.2
tftp> mode binary
tftp> put my_file.txt 
Sent 5 bytes in 0.0 seconds
tftp> quit
</code> 

==== NFS ====

The QuimBox has a built-in NFS server. That way, it can export its full filesystem to your workstation.

Make sure you have the required packages (nfs-common, ...) installed on your workstation before trying this, and root access to mount the filesystem.

<code - Workstation>
# create a mount point
~ % mkdir -p mnt/quimbox
# mount 
~ % sudo mount 192.168.0.2:/ mnt/quimbox
[sudo] password for cedric: 
~ % cd mnt/quimbox
~/mnt/quimbox % ls
bin/  etc/   lib/    linuxrc@  mnt/         opt/   root/  sbin/  tmp/  var/
dev/  home/  lib32@  media/    my_file.txt  proc/  run@   sys/   usr/
</code> 

If your workstation runs a NFS server, you can mount it in the QuimBox to access your workstation filesystem from the QuimBox embedded Linux.

==== CAN ====

The QuimBrain communicates with external boards via CAN.

The CAN interface can be enabled as follow:
<code>
ip link set can0 type can bitrate 1000000
ip link set up can0
</code>