= GW3089 GBlade Server Blade

== 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.

The GBlade should be powered via PoE.

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.

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}
}}}


== Ethernet

There are two ports, 1GbE and 10GbE.

 * (eth1) 1GbE RGMII port is on the left (PoE)
 * (eth0) 10GbE XFI port is on the right. 

* Orientation is with Ethernet LED's towards the top

===  PoE

Isolated 802.3at 1GbE active PoE is supported on the left port. 

For 10GbE PoE, 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.

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.

== 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]

== 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.