===== 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: 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 ==== 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. % 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 ==== 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: 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) ===== 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. # 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:~# ===== 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 / . # 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 ==== 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. # 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/ 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: ip link set can0 type can bitrate 1000000 ip link set up can0