Wiki

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== Beaglebone Black Setup & Configuration (3/5) ======
This set of instructions assumes you have already Setup and Configured the B@D Virtual Machine. If that is not the case please go back to the [[ciptestingboardatdesksingledevsetup|B@D Setup and Configuration wiki page]]. If you are using the 1.0 release rather than the latest version for git you need to read an [[https://wiki.linuxfoundation.org/civilinfrastructureplatform/beagleboneblackboard?rev=1508248464|older version]] of this page.

If you are using the Renesas IWG20M board see [[renesasboard|this page]].

===== Working with the Beaglebone Black =====

At this point in the process, things get very device-specific. The Beaglebone-Black is used as an example simply because it is the first device chosen by the CIP Members team and it is a well documented example in LAVA. The eLinux website has an excellent [[http://elinux.org/BeagleBone_Community|Beaglebone Black Reference]].

==== Cabling to the Beaglebone Black ====

   * The Beaglebone Black should be powered using the wall plug.
   * The USB cable that comes with the BBB //can// power the board, but this is not recommended when loading a kernel.
   * The USB-to-Serial FTDI cable provides a way to view the BBB console.
   * The Ethernet cable is used to connect the BBB to the LAN and allows the user to make an SSH connection to the BBB.

==== Connecting the FTDI (USB to Serial) Cable ====

1. Connect the cable to the Serial Port located on connector J1
There are a couple of different styles of FTDI cables. Some have a 6-socket connector and some have three leads with single sockets. Overall, this is not a big issue since the pinout is the same. You can use this link to determine which wires go where. [[http://elinux.org/Beagleboard:BeagleBone_Black_Serial]]

2. The Serial Header is on connector J1 which is located next to the long black female connector on the same side of the board that the 5VDC power supply plugs in. Pin 1 is closest to the 5VDC power supply connector.

The cable pinout is shown below. It has three separate leads that are Blue, Red & Green. Connect them as shown:

   Board     Wire     Function
   Pin 1.....Blue.....Ground
   
   Pin 4.....Red......Receive
   
   Pin 5.....Green....Transmit
   
// Note: The wire colors are manufacturer-dependent. Please check the documentation provided with your cable. //

3. The default serial port settings for the Beaglebone Black are as follows:

   * Baud Rate: **115,200**
   * Data Bits: **8**
   * Parity: **N**
   * Stop Bits: **1**
   * Handshake: **None**

4. The CIP Testing project uses the ''ser2net'' serial-to-network proxy program to allow communications with the BBB by assigning it an Ethernet port on the host machine. This way, a developer can communicate to the BBB over the serial port as if it had an IP Address. A typical use would be connecting to the BBB using the telnet program: ''telnet <Host's IP Address> <port#>''  

// Note that if you are using a Windows 10 host then you must use ser2net on the B@D Virtual machine. In **this** case follow steps 15/16 and **then** move back to step 9. //

5. Verify on your host machine (if necessary installing ser2net first) the ''ser2net.conf'' configuration file to ensure the serial port is correct for the CIP B@D Virtual Machine.

''user@host:~$ **tail /etc/ser2net.conf**''

The last line below shows that serial port ''/dev/ttyUSB0'' is routed to the host PC's IP Address, port 8020.

   # The original config file shipped with the upstream sources can be
   # found in /usr/share/doc/ser2net/examples
   
   BANNER:banner:\r\nser2net port \p device \d [\s] (Debian GNU/Linux)\r\n\r\n
   
   2000:telnet:600:/dev/ttyS0:9600 8DATABITS NONE 1STOPBIT banner
   2001:telnet:600:/dev/ttyS1:9600 8DATABITS NONE 1STOPBIT banner
   3000:telnet:600:/dev/ttyS0:19200 8DATABITS NONE 1STOPBIT banner
   3001:telnet:600:/dev/ttyS1:19200 8DATABITS NONE 1STOPBIT banner
   8020:telnet:0:/dev/ttyUSB0:115200 8DATABITS NONE 1STOPBIT banner

6. If your FTDI cable uses a different USB port, edit the ''ser2net.conf'' file on the host.

''user@host:~$  **sudo nano /etc/ser2net.conf**''

7. Restart the ''ser2net'' daemon.

''user@host: **sudo systemctl restart ser2net.service**''

8. B@D now uses a private network so that the host IP address no longer needs setting in the device dictionary. If your local IP address settings are such that a change is necessary from the default 192.168.22.1, 
 edit mybbb.dat appropriately  and then copy it into the device dictionary:

''vagrant@guest:$ **<nowiki>sudo cp mybbb.dat /etc/lava-server/dispatcher-config/devices/bbb01.jinja2</nowiki>**''

Note: If you have multiple IP addresses (e.g. due to WiFi and Ethernet both being active) then it is recommended that you disable all but one network interface.

// If you don't wish to change the root password of the board then edit the first line of mybbb.dat so that lavauser123 is replaced by your current board password.  Or you can change it when logged in via telnet (see next step) //


9. Connect to the BBB using the serial port.

'' vagrant@guest:~$ **telnet 192.168.22.1 8020** ''

   Trying ::1...
   Connected to localhost.
   Escape character is '^]'.
   
   ser2net port 8020 device /dev/ttyUSB0 [115200 N81] (Debian GNU/Linux)
   
   Debian GNU/Linux 7 beaglebone ttyO0
   
   default username:password is [debian:temppwd]
   
   Support/FAQ: http://elinux.org/Beagleboard:BeagleBoneBlack_Debian
   
   The IP Address for usb0 is: 192.168.7.2
   beaglebone login: 

// Note: To disconnect from this login session with the BBB simple press Ctrl-] and press q and Enter at the telnet> prompt //


==== Using an Ethernet Cable ====

10. Connect an Ethernet Cable from the Ethernet switch to the BBB's RJ-45 connector and connect to BBB using SSH.

''[host@user ~]$ **ssh debian@10.0.0.50**''

   Debian GNU/Linux 7 beaglebone ttyO0
   
   Support/FAQ: http://elinux.org/Beagleboard:BeagleBoneBlack_Debian
   
   default username:password is [debian:temppwd]
   
   debian@10.0.0.50's password: temppwd
   
   Last login: Fri Feb  3 22:05:01 2017 from 10.0.0.4
   debian@beaglebone:~$ exit


11. Exit the ''debian'' login and login as ''root''
   debian@beaglebone:~$ exit
   logout
   
   Debian GNU/Linux 7 beaglebone ttyO0
   
   default username:password is [debian:temppwd]
   
   The IP Address for usb0 is: 192.168.7.2
   beaglebone login: root
   
   root@beaglebone:~#

12. Change the root password to ''lavauser123''

''root@beaglebone:~# **passwd** ''

   Changing password for root.
   Enter new UNIX password: lavauser123
   Retype new UNIX password: lavauser123
   passwd: Authentication token updated  


13. Next, before you test the B@D Virtual Machine Setup with the Beaglebone Black and the CIP Linux Kernel, you will need to [[cipsystembuildhowto|create an initramfs with BusyBox for the Beaglebone Black]].

-------

14. **Next 2 steps are Windows 10 Only**
On the Windows host, run VirtualBox, select the VM  and enable the FTDI filter - see screenshot:{{:civilinfrastructureplatform:usb-subset.png?200|}}
   
15. On the VM change localhost to the VM's IP Address (use ''ip addr'' and the IP address associated with eth1):

''vagrant@guest: **sed -i 's/localhost/<vm_ip>/g' mybbb.dat** ''


   Now move back to step 9.

Back to the [[ciptestingboardatdesksingledevsetup|B@D Setup and Configuration wiki page]]
Wiki

User Tools

Site Tools

Page Tools
