Skip to content

Quickstart

Already set up your hardware? Skip to software setup.

Before you plug in the power

Opening the enclosure

For Ten64 desktop enclosure users, the rear panel is fastened with 4 x M2.5 hex/socket cap screws. A hex key is included in the accessories box.

Use the hex key to unscrew the rear panel, after which you can pull the top cover plate out for easy access.

Opening the rear panel

The rear panel is used to keep the motherboard tray in place, so we recommend re-installing the panel even if you are keeping the lid off.

Inserting the SODIMM

See article: DDR

RevB and later boards have a laptop-style SODIMM slot - the procedure to insert the SODIMM is:

  1. Lean the SODIMM at a 45 degree angle, towards the SoC SODIMM first step
  2. Push the SODIMM down into the slot
  3. Push the SODIMM backwards (away from the SoC) until it is captured by the slot latches and is fully upright. SODIMM fully inserted

If you can see the gold contacts on the SODIMM then it has not been fully pushed down into the slot.

To release the SODIMM, push both the latches away from the card edge.

ATX front panel pinout (for ATX/ITX users)

The ATX front panel pins follow the standard layout - on recent ATX/ITX cases the front panel connector will plug straight in: ATX Front Panel pins board photo ATX Front Panel pins schematic

Note: Pin 10 (NC) is a 'key' pin - it is not on the board or connector.

See article: Power Connector

For desktop/12V power supplies, we recommend plugging in the barrel connector on the Ten64 end first, and then inserting the AC cable into the power point.

This provides a smoother start-up (and vice-versa for power off), as the barrel connector has a mechanical 'bounce' effect during insertion.

DIP Switch and board LED

DIP switch and LEDs

DIP switch 1 (nearest LED) controls whether the board loads the boot firmware from the onboard QSPI flash or via SD card - the latter is useful when you need to "unbrick" from a bad TF/U-Boot version.

DIP switch 2 inhibits the RESET_REQ(uest) line from the SoC to the board controller, typically this is only used when doing low level board firmware development, e.g testing different RCW settings.

The LEDs below the DIP switch denotes the current board status - green for when the board is operational, red for failure or sleep/power off.

Reset button

Both the rear reset button (top button on I/O panel) and ATX reset need to be held down for at least five seconds before a reset is triggered. This is to prevent accidental resets.

The reset behaviour (e.g ignoring reset or increasing the required button duration) can be configured with the Ten64 microcontroller utility.

Serial console

Note

Serial console not responding to input? Ensure flow control is turned off in your terminal program.

A FTDI bridge on board provides a USB serial console on the USB-C port.

Settings are the typical 115200,8,N,1 with no flow control.

Tip: Every FTDI chip has a unique ID, under Linux you can add udev rules to provide a consistent name for each board you connect to.

The serial console UART is also available on the Control Header for raw, 3.3V level access.

Please note: the serial console may disconnect momentarily when the Ten64 when the 12V DC connector is inserted. This effect can generally be avoided by connecting/disconnecting power at the AC end rather than the DC end (see above).

SD/SIM tray

Note

Always remove power from the board when removing and inserting the SD/SIM tray.

There is protection circuitry on the board to ensure 'hotswaps' do not damage it, but to prevent any unintended side effects please power down first.

Ten64 has a 3-choose-2 SD/SIM tray, like some recent smartphones. You can have:

  • 1 SIM, 1 microSD card
  • 2 SIMs, 2nd SIM in microSD position

Support for two SIMs / the 2nd SIM position is dependent on the modem being used.

Getting started with software

Recovery environment

Boot Menu Options

On board the NAND flash is a "recovery" environment that provides tools necessary to partition disk drives, download disk images or chroot into an install. This can be accessed through the "Built-in recovery" menu option at boot or by typing run bootcmd_recovery in the U-Boot shell.

See the recovery firmware page for more details.

Realtime Clock (RTC)

Ten64 uses a supercapacitor to keep it's real time clock (RTC) - this avoids the waste associated with coin-cell batteries but the super capacitor will only hold time for 48-72 hours (given a Ten64 will typically be on 24/7/365 this is a worthwhile compromise).

Usually an NTP sync will be performed automatically when you first connect the recovery firmware (using the set-wan command).

Using the on-board OpenWrt

The on-board NAND flash contains an OpenWrt image which allows you to use your Ten64 as a router right away without having to install a SSD or flash drive.

At the boot menu you can select "Boot OpenWrt from NAND"

To make the on-bard OpenWrt NAND, you can modify the boot_targets variable in U-Boot to put openwrt_nand first:

=> print boot_targets
boot_targets=nvme0 mmc0 usb0 openwrt_nand backstop

=> setenv boot_targets 'openwrt_nand nvme0 mmc0 usb0 backstop'

=> print boot_targets
boot_targets=openwrt_nand nvme0 mmc0 usb0 backstop

=> saveenv
Saving Environment to SPI Flash... Erasing SPI flash...Writing to SPI flash...done

Loading a distribution onto a storage device (e.g SSD)

The bare metal appliance store provides a simple way to download a distribution image and write it to your storage device, while also installing any fixups or patches to ensure they run on the Ten64.

After booting into recovery and connecting an Ethernet cable:

set-wan ethX (where X is an Ethernet port connected to the internet)
appstore-list
baremetal-deploy debian-buster /dev/nvme0n1

Using distribution installer ISOs

It is also possible to use a standard distribution installer (e.g ISO image), by writing the ISO to a USB flash drive and booting from it.

As most distributions require tweaks or updated kernel versions to work, we recommend using the appliance store for now.