====== HDL Ubuntu 18.04 LTS Lab Demo ======

Configuration of the Ubuntu 18.04 LTS system needed to compile the data system and is the lab demo laptop.

===== Network Config =====

Modify the Netplan configuration to get a static IP from this page, this worked:  [[https://linuxize.com/post/how-to-configure-static-ip-address-on-ubuntu-18-04/]]

  * Modify this file:  **/etc/netplan/01-netcfg.yaml** <code>
network:
  version: 2
  renderer: networkd
  ethernets:
    ens3:
      dhcp4: no
      addresses:
        - 192.168.121.199/24
      gateway4: 192.168.121.1
      nameservers:
          addresses: [8.8.8.8, 1.1.1.1]
</code>
  * Restart netplan <code>
sudo netplan apply
</code>
===== User Setup =====

  - Add user **hdl** to the system
    - Add the user <code>
sudo adduser hdl
</code>
    - Set the password <code>
sudo passwd hdl

#password is
$h00tTh3M00n
</code>
    - Add the user to the **adq** group <code>
sudo usermod -a -G adq hdl
</code>
  - Get the code over to the **hdl** user account
    - Make a dir <code>
mkdir ~/src
mkdir ~/bin
# put the code into ~/src/hdl_lab_demo
</code>
    - Whatever you want to do to get the code there and then compile locally
    - Make and **chown** the **/opt/hdl** directory tree to the **hdl** user <code>
# need to do this as a sudo user 
sudo mkdir /opt/hdl
sudo chown -R hdl:hdl /opt/hdl
</code>

===== Directory =====

  - Create a directory to populate <code>
sudo mkdir /opt/hdl
sudo mkdir /opt/hdl/data
sudo chown -R hdl:hdl /opt/hdl
</code> 


===== Hardware Drivers =====

==== Advantech ARK-1550 GPIO Drivers ====

Looks like this is a package that allows us to do all kinds of things with this computer, but the GPIO is in here for sure.

  * Ubuntu drivers: {{ :hdl:systems:ubuntu18lts_laptop:mio-5271_susi4.1.14987_release_2018_07_16_ubuntu18.04_x64.tar.gz |}}

NOTE:  AH, John realized we have DIO ports on the [[hdl:systems:ubuntu18lts_laptop:start#measurement_computing_usb-ctr08
|USB timer board]], so no need to go down this road.
==== Measurement Computing USB-CTR08 ====

[[https://www.mccdaq.com/usb-data-acquisition/USB-CTR-Series.aspx|MC USB-CT08]] compile and install instructions

Using **lvis** since it has **sudo** capability

  - Download some required packages <code>
sudo apt-get install gcc g++ make
sudo apt-get install libusb-1.0-0-dev
</code>
  - Grab the latest version of the **ULDAQ** <code>
cd ~lvis/Downloads
wget -N https://github.com/mccdaq/uldaq/releases/download/v1.1.2/libuldaq-1.1.2.tar.bz2
</code>
  - Expand the compressed files <code>
mkdir ~/work
cd ~/work
tar -xvjf ~/Downloads/libuldaq-1.1.2.tar.bz2
</code>
  - Build the library and examples <code>
cd libuldaq-1.1.2
./configure && make
sudo make install
</code>

==== Serial Port Adapter ====

I had this same problem outlined here:  [[https://forum.manjaro.org/t/modemmanager-mobile-broadband-adapter-not-supported-anymore/45268]]

Trying to use a [[https://www.tripplite.com/keyspan-high-speed-usb-to-serial-adapter~USA19HS|Keyspan 19HS USB to Serial adapter]]

  - Create this file for the modem manager
    - Edit this file <code>
sudo nano /lib/udev/rules.d/78-mm-whitelist-internal-modem.rules
</code>
    - Put these contents in it <code>
ACTION!="add|change|move", GOTO="mm_whitelist_internal_modem_end"
    ATTRS{idVendor}=="06cd", ATTRS{idProduct}=="0121", ENV{ID_MM_DEVICE_PROCESS}="1"
    LABEL="mm_whitelist_internal_modem_end"
</code>
  - Restart the service <code>
sudo udevadm control --reload
sudo udevadm trigger
</code>
  - I ended up rebooting but probably wasn't nececssary

To talk to the javad <code>
sudo minicom /dev/ttyUSB0  # should not need sudo to do this if in correct group
</code>

I also added **hdl** user to the dialin group with the following command
<code>
sudo adduser hdl dialout
</code>

==== SP Devices Digitizer ====

=== Install Linux SDK Ubuntu 18.04 LTS ===

  - Install the latest SDK (untar in ~/src/)
  - Install the packages <code>
cd ~/src/ADQ_SDK_linux_r44222/packages/Ubuntu_18.04/amd64
sudo apt install dkms
sudo dpkg -i spd-adq-pci-dkms_1.17_all.deb
sudo dpkg -i libadq0_0.44222_amd64.deb
sudo dpkg -i adqtools_0.44222_amd64.deb
sudo apt install pkg-config
</code>
  - Add the **hdl** user to the **adq** group <code>
sudo usermod -a -G adq hdl
</code>
  - Reboot

===== Software Optional =====

  * **GDL** <code>
sudo apt install gnudatalanguage
</code>
  * **JED editor** <code>
sudo apt install jed
</code>
  * **KDE** (because I like it! (and kdevelop!)) [[https://vitux.com/how-to-install-the-kde-plasma-desktop-on-ubuntu-18-04-lts/]] <code>
sudo apt install tasksel
sudo tasksel install kubuntu-desktop
</code>
    * **kdevelop** <code>
sudo apt install kdevelop
</code>
  * **PlayOnLinux - POS/AV Viewer** <code>
sudo apt install playonlinux
# required since Ubuntu 24 LTS
sudo apt install python3-pyasyncore
</code>
  * Misc <code>
sudo apt install htop jed md5deep pigz minicom net-tools
</code>

==== Applanix Software ====

**POSView**
  - Run playonlinux
  - Install a program
  - Install a non-listed program (at the bottom)
  - Next, next, next
  - Install program in a new virtual drive
  - Name:  POSView
  - Do nothing before install (uncheck everything)
  - 32 bit windows install
  - Browse to exe installer
  - Use the name it gave it AV_POSView and icon for the EXE
  - Did not make a second shortcut
   
  * Repeat for **POSController**

Programs: 
  * {{ :code:work:hdl:2023:dds_config:posav2.3controller.zip |}}
  * {{ :code:work:hdl:2023:dds_config:posav_v6_firmware_9.13.zip |}}

===== Software Required =====

==== Third Party ====

  * Get Software from [[https://www.galil.com/sw/pub/all/doc/gdk/man/installation.html]]
  * IP address:  192.168.42.1

==== Linux OS ====

  * **cmake** <code>
sudo apt update
sudo apt install cmake
</code>
  * **libconfig** main webpage is [[http://hyperrealm.github.io/libconfig/]]
    * download (or get it from the **git** repository **tars** directory or use **libconfig-dev**)<code>
cd ~/Downloads
wget http://hyperrealm.github.io/libconfig/dist/libconfig-1.7.2.tar.gz
</code>
    * uncompress <code>
cd ~/src
tar -zxvf ~/Downloads/libconfig-1.7.2.tar.gz
</code>
    * compile and install <code>
cd ~/src/libconfig-1.7.2
./configure
make
sudo make install
sudo ldconfig
</code>
  * **libserialport** <code>
sudo apt update
sudo apt install libserialport-dev
</code>