= GW3089 GBlade Server Blade
[[Image(GW3089.png,300px)]]

== Product Information

All product information and datasheets can be found here:
[https://www.gateworks.com/products/arm-server-blades/gblade-arm-server-blade/]

== Getting Started

The GBlade is pre-installed with Ubuntu Linux. To power the unit use an 802.3at PoE switch or inserter. The bottom 1GbE RJ45 is the PoE port by default. Contact factory for 10GbE PoE options. Typical power consumption is around 10-13W without any additional cards plugged into the NVME socket. 


=== Serial Console Access

Once the unit is powered, the GBlade serial console can be accessed through the type C USB port through a cable to a desktop/laptop PC. The serial console will show up as a /dev/ttyUSBx device in Linux and can be accessed through a terminal program with the baud rate of 115,200.

[[Image(GW3089serial.JPG,300px)]]

Example: 
{{{
sudo screen /dev/ttyUSB1 115200,cs8
}}}

Once connected via the USB cable, SSH can be enabled (it is disabled by default) with instructions here: [wiki:ubuntu#SSHServer Enable SSH]

Any server software (LAMP stack, etc) can then be installed with the package manager. 
{{{
apt-get update
apt-get install {your package}
}}}

=== JTAG & Firmware/OS Update

The GW3089 incorporates onboard a USB to JTAG FTDI chip to allow JTAG programming of the unit without the requirement for a separate JTAG dongle (GW16099) which is typically used on other Gateworks SBCs. 

The JTAG software is under development so for initial programming please see the following link on updating from a TFTP server. 
* [wiki:malibu/firmware#UpdateFirmwareviaSerialConsoleandEthernetfromBootloader] 




== Ethernet

There are two Ethernet ports, 1GbE (management) and 10GbE (high speed data).

 * (eth1) 1GbE RGMII port is on the bottom (PoE by default)
 * (eth0) 10GbE XFI port is on the top. 

[[Image(GW3089ethernet.JPG,300px)]]

===  PoE

Isolated 802.3at 1GbE active PoE is supported on the bottom port. The Gateworks GW10144 802.3at inserter can be used to power individual units and/or during development. See link here for info on GW10144:
[https://tsi.tyconsystems.com/doc/SpecSheets/TP-POE+10G__53V_30W_10GB_PoE_Inserter_Spec_Sheet.pdf Tycon Inserter]

A 802.3at PoE switch is recommended for rackmount applications. 

For 10GbE PoE options, please contact Gateworks Sales.

== NVME Drive

The GBlade needs to be opened up to install a 2280 M-Key NVME flash storage drive. 4 lanes of PCIe is supported.

== LED

A front panel LED is supported.

When power is applied, the LED will be a solid green. The LED will present a green heartbeat pattern is shown once the board is booted into Linux.

[[Image(GW3089led.JPG,300px)]]


=== LED Programming

To disable the heartbeat LED:
{{{
root@jammy-malibu:~# echo none > /sys/class/leds/green\:heartbeat/trigger #disable default green heartbeat
root@jammy-malibu:~# echo 255 > /sys/class/leds/red\:status/brightness #set LED to solid RED
}}}

To see more Linux LED examples, see here: [wiki:linux/led]

== Thermal & Cooling Fan

The fan runs at specific set points.
The trip points are set at 50C, 60C and 80C (as shown in the device tree [https://github.com/Gateworks/linux-malibu/blob/v6.1-malibu/arch/arm64/boot/dts/marvell/cn9130-malibu-gw8901.dts#L413 here])

Note also the processor will throttle down if the fan isn't able to achieve proper cooling with the fan.

The GW8901 uses standard Linux cooling-maps, thermal-zones and the pwm-fan driver.

There are several temperature sensors on the board, identified as 'thermal_zones'.
These are shown in Linux under /sys/class/thermal:
{{{
root@jammy-malibu:~# ls -la /sys/class/thermal/
total 0
drwxr-xr-x  2 root root 0 Jun 27 18:28 .
drwxr-xr-x 62 root root 0 Jun 27 18:28 ..
lrwxrwxrwx  1 root root 0 Jun 27 18:28 cooling_device0 -> ../../devices/virtual/thermal/cooling_device0
lrwxrwxrwx  1 root root 0 Jun 27 18:28 cooling_device1 -> ../../devices/virtual/thermal/cooling_device1
lrwxrwxrwx  1 root root 0 Jun 27 18:31 cooling_device2 -> ../../devices/virtual/thermal/cooling_device2
lrwxrwxrwx  1 root root 0 Jun 27 18:28 thermal_zone0 -> ../../devices/virtual/thermal/thermal_zone0
lrwxrwxrwx  1 root root 0 Jun 27 18:28 thermal_zone1 -> ../../devices/virtual/thermal/thermal_zone1
lrwxrwxrwx  1 root root 0 Jun 27 18:28 thermal_zone2 -> ../../devices/virtual/thermal/thermal_zone2
lrwxrwxrwx  1 root root 0 Jun 27 18:28 thermal_zone3 -> ../../devices/virtual/thermal/thermal_zone3
lrwxrwxrwx  1 root root 0 Jun 27 18:28 thermal_zone4 -> ../../devices/virtual/thermal/thermal_zone4
lrwxrwxrwx  1 root root 0 Jun 27 18:28 thermal_zone5 -> ../../devices/virtual/thermal/thermal_zone5

}}}

An example temperature for thermal_zone0 would be 60738, or 60738/1000=60.738 degrees Celsius:
{{{
root@jammy-malibu:~# cat /sys/class/thermal/thermal_zone0/temp 
60738
}}}

The zones are labeled below. The AP stands for application processor, or the main CPU, with a sensor for each core of the quad core CPU. The CP0 stands for 'co-processor'. 
{{{
root@jammy-malibu:~# cat /sys/class/thermal/thermal_zone*/type
ap-thermal-ic
ap-thermal-cpu0
ap-thermal-cpu1
ap-thermal-cpu2
ap-thermal-cpu3
cp0-thermal-ic

}}}



== 1U Rack Front Plate

A standard 1U rack front plate is available to install QTY 10 GBlade servers in a rack mount scenario. The 1U plate part number is GW3090. Contact sales@gateworks.com to purchase. 

== Gateworks System Controller

The Gateworks System Controller manages things like the real time clock, voltage rails, fan PWM, etc.

More information can be found here: [wiki:gsc]

== Software

The GW3089 is part of the Gateworks Malibu family of SBCs. 

Malibu Software is comprised of many pieces, including the following:
 * GSC (Gateworks System Controller) Firmware
 * Boot Firmware (ARM Trusted Firmware, DDR controller Firmware, U-Boot Bootloader)
 * Operating System (including kernel / rootfs)

An Ubuntu based OS is pre-installed on all Malibu boards before they ship.

Please view the following links for the appropriate software section:
 * [wiki:malibu Main Malibu Wiki Page]
 * [wiki:malibu/bsp#images Pre-built Software Images]
 * [wiki:malibu/bsp Building & Compiling BSP (Board Support Package) Images] - This includes all the boot firmware & operating System
 * [wiki:/malibu/firmware Malibu Software Installation page]
 * [wiki:malibu/boot Malibu Boot Firmware (up to and including the Bootloader)]
 * [wiki:gsc#GSCVersionHistory GSC Firmware]
 * [wiki:ubuntu Main Ubuntu Page]
 * [wiki:webui Webmin Installation Page]

=== Device Tree

The Linux device tree can often describe a lot about how the hardware is connected, etc.

Link to GW3089/GW8901 Device tree: [https://github.com/Gateworks/linux-malibu/blob/v6.1-malibu/arch/arm64/boot/dts/marvell/cn9130-malibu-gw8901.dts]

=== TPM / Crypto

On the board is a Microchip ATTPM20P-H6MA1-10

This is compliant to the Trusted Computing Group (TCG) Trusted Platform Module (TPM) Version 2.0,
r116 Trusted Platform Module Library

Cryptographic Support for:
 - HMAC
 - AES-128
 - SHA-1
 - SHA-256
 - ECC BN_P256, ECCNIST_P256
 -RSA 1024-2048 bit keys

== Wireless

Wireless was not intended for this ethernet connected blade server.