SNA-LGTC is a small, ARM-based Linux-running computer that is capable of hosting microcontroller-based boards such as VESNA SNC and VESNA SNP. This repository contains various small software parts and documentarion related to SNA-LGTC:

• dts - Device tree source and compiled device tree blobs.
• docker - Configuration for Docker.
• figures - Photos and other figures related to the SNA-LGTC board.
• munin - Munin plugins.

It also contains sources for several Debian packages that need to be installed on SNA-LGTC boards:

• bb-wl18xx-firmware - Customized WL1837 firmware and related scripts.
• sna-lgtc-boot - First boot setup scripts for setting up hostname, machine ID, etc.
• vesna-snc-boot - Systemd service that boots the VESNA SNC guest board after the host boots.
• videk-client - Client for the Videk management system.

Related repositories and documents in other places:

• Schematic and PCB layout for the SNA-LGTC board.
• Patched OpenOCD for programming the guest VESNA SNC board.
• Instructions for compiling, uploading and debugging firmware for the guest VESNA SNC board using vesna-drivers from the host SNA-LGTC board.
• NodeSpectrumSensorLocal, application for controlling the SNE-ISMTV radio on the guest board using ALH protocol over the UART.
• VESNA management system, web application for remote access over ALH to the guest VESNA SNC.
• Boot scripts, customized BeagleBone boot scripts for SNA-LGTC.
• Logatec temperature monitor, a containerized temperature monitoring application for SNA-LGTC.

The board will boot when one of the connectors providing power supply is connected (230V AC, 12V DC or the 5V supply from the USB gadget).

To start, connect mini-USB cable to the USB gadget connector, bring up the USB network interface using DHCP and log in to 192.168.7.2 over ssh. In this case, no other power supply is needed.

It is also possible to log in and work over the serial console. In this case, connect a mini-USB cable to the USB console connector and also connect another power supply (either 230V AC, 12V DC or 5V to the USB gadget).

If you can connect only one antenna for Wi-Fi, use connector J4. If possible, connect both antennas.

In normal operation, green power LED should be lit and the blue heartbeat LED should be blinking periodically.

On its own, the board will boot from the SD card if it appears bootable (for example, if it contains a /boot/uEnv.txt file). If the SD card does not appear to be bootable, it will boot from the internal eMMC flash.

Pressing the Power button has the same effect as running shutdown -h now. In other words, it will gracefully stop the system and power off the board.

The Reset button however hard-reboots the board. It does not perform a graceful shutdown and hence using it carries the risk of filesystem corruption.

Get an SD card image. You can find it on the internal PUB_OE6 share, under tsolc/SNA-LGTC. Images files are named like bone-debian-8.6-sna-lgtc-2017-09-12.img.bz2.

You will need a computer running Linux and an SD card reader.

Download the image to your computer. Then decompress it. Adjust the name of the image if necessary in the following steps:

$ bzip2 -d bone-debian-8.6-sna-lgtc-2017-09-12.img.bz2

After that, insert an empty SD card into the reader and run. The card should be 4 GB or larger. Adjust the name of the SD card reader device as necessary (it might not be /dev/mmcblk0 on your computer):

$ sudo dd if=bone-debian-8.6-sna-lgtc-2017-09-12.img of=/dev/mmcblk0

Remove and re-insert the card. Then mount it on your computer:

$ sudo mount /dev/mmcblk0p1 /mnt

Check that the selected device tree matches the configuration of the SNA-LGTC board you are setting up (e. g. is it wired or wireless?). See the dts folder for details:

$ grep "^dtb=" /mnt/boot/uEnv.txt
dtb=am335x-lgtc-wired.dtb

Edit the uEnv.txt if necessary.

Now you have two choices:

• If you want to boot the SNA-LGTC board directly from the SD card, unmount the card from your computer and insert it into SNA-LGTC. When you power up SNA-LGTC, it should automatically boot from the SD card.

• If you want to flash the SD card image onto the on-board eMMC flash, edit the uEnv.txt file and uncomment the following line:

  cmdline=init=/opt/scripts/tools/eMMC/init-eMMC-flasher-v3.sh
  

  Now unmount the card from your computer and insert it into SNA-LGTC. When you power up SNA-LGTC, it should start the flashing process. It will program the eMMC and then turn itself off. After it has turned itself off (the power LED will be dark), remove the SD card from SNA-LGTC and replace it with a blank one (it will be used for storing Docker images). When you power up SNA-LGTC again, it should boot from eMMC.

  For more details, see BeagleBone Black instructions and the sna-lgtc-boot script in this repository.