User Tools

Site Tools


connection_guide

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
connection_guide [2014/03/01 01:25]
cedric.eloy
connection_guide [2018/05/22 10:33] (current)
Line 1: Line 1:
  
 +===== 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>​
connection_guide.txt ยท Last modified: 2018/05/22 10:33 (external edit)