User Tools

Site Tools


toh:turris_cz.nic:turris_cz.nic_omnia

Turris CZ.NIC Omnia

The Turris Omnia is an open-source router from CZ.NIC. Stock firmware TurrisOS is based on OpenWrt and features Foris with assistants to aid in basic configuration and TurrisOS related settings and Luci for advanced configuration. It features a dual-core CPU, 1 or 2 GB RAM, 8 GB flash, 6 Gbit ports, SFP connector, USB 3.0, 3 mini PCIe slots populated with 2.4Ghz and 5Ghz wifi cards and much more.

Supported Versions

Experimental Versions

None at this time.

Hardware Highlights

ModelVersionSoCCPU MHzFlash MBRAM MBWLAN HardwareWLAN2.4WLAN5.0100M portsGbit portsModemUSB
OmniaMarvell Armada 385 88F682016008192NAND1024Qualcomm Atheros QCA986x/988x mini-PCIe, Qualcomm Atheros AR9287 miniPCIeb/g/na/n/ac-6-2x 3.0

Installation

Reset U-boot if needed

If the U-Boot environment has been modified previously (likely manually via serial console), first use serial to reset the default environment. Connect serial console and interrupt U-Boot. To do so you need to get to U-Boot prompt by hitting enter several times early after powering up till you see '⇒' prompt. Once you get there, enter the following commands:
env default -a
saveenv

Note on OpenWrt

The original TurrisOS uses btrfs, standard OpenWrt only uses “normal” squasfs/jffs2 filesystem. This means that snapshots, rollbacks etc. do not work with OpenWrt.

Method 1 - USB 'medkit' image without serial

  1. Copy openwrt-mvebu-turris-omnia-sysupgrade.img.gz and omnia-medkit-openwrt-mvebu-turris-omnia-initramfs.tar.gz to the root of a USB flash drive formatted with FAT32 / ext2/3/4 / btrfs / XFS. Note that the medkit MUST be named omnia-medkit*.tar.gz
  2. Disconnect other USB devices from the Omnia and connect the flash drive to either USB port.
  3. Power on the Omnia and hold down the rear reset button until 4 LEDs are illuminated, then release.
  4. Wait approximately 2 minutes for the Turris Omnia to flash itself with the temporary image, during which LEDs will change multiple times.
  5. Connect a computer to a LAN port of the Turris Omnia with a DHCP client
  6. (if necessary) ssh-keygen -R 192.168.1.1
  7. ssh root@192.168.1.1; mount /dev/sda1 /mnt; sysupgrade /mnt/openwrt-mvebu-turris-omnia-sysupgrade.img.gz
  8. Wait another minute for the final OpenWrt image to be flashed. The Turris Omnia will reboot itself and you can remove the flash drive.

Method 2 - TFTP with serial

  1. Extract omnia-medkit-openwrt-mvebu-turris-omnia-initramfs.tar.gz and copy dtb + zImage to your TFTP server (rename if desired)
  2. Connect Turris Omnia WAN port to DHCP-enabled network with TFTP server
  3. Connect serial console and interrupt U-Boot. To do so you need to get to U-Boot prompt by hitting enter several times early after powering up till you see '⇒' prompt. Once you get there, enter the following commands:
  4. dhcp
  5. setenv serverip <tftp_server_ip_here>
  6. tftpboot 0x01000000 zImage
  7. tftpboot 0x02000000 dtb
  8. bootz 0x01000000 - 0x02000000
  9. OpenWrt will now boot from ramdisk, wait until yxou can connect to 192.168.1.1
  10. Download openwrt-mvebu-turris-omnia-sysupgrade.img.gz to /tmp/ (via scp, or wget if WAN connection is available)
  11. sysupgrade /tmp/openwrt-mvebu-turris-omnia-sysupgrade.img.gz
  12. Wait another minute for the final OpenWrt image to be flashed. The Turris Omnia will reboot itself.

Flash Layout

Layer0 NAND flash 8192 KiB
Layer1 mtd0 U-Boot 1024 KiB mtd1 Rescue system 7168 KiB

OEM easy installation

Download latest TurrisOS for Omnia from repo (see above). Save the file omnia-medkit-latest.tar.gz to USB flash to the root directory and put the USB flash to the front panel USB connector of the Turris Omnia router. The Turris Omnia router supports following filesystems: ext2/3/4, BtrFS, XFS and FAT. The Turris Omnia router has a reset button on its back panel. To enter re-flash mode press the reset button and wait for LEDs to indicate the number of the desired mode. Release the reset button when 4 LEDs light up. The Turris Omnia router will write the system image from the USB flash to the internal eMMC storage. During the course of the operation all LEDs are going to turn green. After a while the LEDs turn red. From this moment on the router must not be restarted or powered off. When the reflash operation is completed the router automatically restarts. Completion of the flashing process is indicated by turning all LEDs green for a moment during the boot. After that the LEDs transition to the standard operation indicator mode. When the process has completed the process you may remove the USB flash.

OEM installation using the TFTP method

Specific values needed for tftp

FIXME Enter values for “FILL-IN” below

Bootloader tftp server IPv4 address FILL-IN
Bootloader MAC address (special) FILL-IN
Firmware tftp image Latest OpenWrt release (NOTE: Name must contain “tftp”)
TFTP transfer window FILL-IN seconds
TFTP window start approximately FILL-IN seconds after power on
TFTP client required IP address FILL-IN

Upgrading OpenWrt

LuCI Web Upgrade Process

Terminal Upgrade Process

If you don't have a GUI (LuCI) available, you can alternatively upgrade via the command line. There are two command line methods for upgrading:

  • sysupgrade

Note: It is important that you put the firmware image into the ramdisk (/tmp) before you start flashing.

sysupgrade

  • Login as root via SSH on 192.168.1.1, then enter the following commands:
cd /tmp
wget http://downloads.openwrt.org/path/to/sysupgradeimage
sysupgrade /tmp/xxx.abc

Debricking

Failsafe mode

Basic configuration

Basic configuration After flashing, proceed with this.
Set up your Internet connection, configure wireless, configure USB port, etc.

Specific Configuration

FIXME Please fill in real values for this device, then remove the EXAMPLEs

Network interfaces

The default network configuration is:

Interface Name Description Default configuration
br-lan EXAMPLE LAN & WiFi EXAMPLE 192.168.1.1/24
vlan0 (eth0.0) EXAMPLE LAN ports (1 to 4) EXAMPLE None
vlan1 (eth0.1) EXAMPLE WAN port EXAMPLE DHCP
wl0 EXAMPLE WiFi EXAMPLE Disabled

Switch Ports (for VLANs)

When setting VLAN on Turris Omnia, it is good to first have an understanding of the hardware setup and the interconnection of individual components. See the following schema:

The processor of the router Turris Omnia (SoC, Armada 385) has 3 network interfaces. In the system they are eth0, eth1 and eth2. Interface eth1 is connected directly to WAN on the back side of the router, the interfaces eth0 and eth2 are connected to the switch-chip, specifically to ports 5 and 6, and their assignment to the connectors LAN0 – LAN4 can be configured.

eth2 switch configuration is currently not supported in OpenWrt, only port 5 is the uplink to the switch. SFP is also not supported yet. See Forum post for progress.

Numbers 0-4 are Ports 0-4 as labeled on the unit, 5 and 6 are the internal connection to the router itself. vlan0 = eth0.0, vlan1 = eth0.1 and so on.

Port Switch port
LAN 0 Port 0
LAN 1 Port 1
LAN 2 Port 2
LAN 3 Port 3
LAN 4 Port 4

Buttons

hardware.button on howto use and configure the hardware button(s). Here, we merely name the buttons, so we can use them in the above Howto.

FIXME Please fill in real values for this device, then remove the EXAMPLEs

The Turris CZ.NIC Omnia has the following buttons:

BUTTON Event
EXAMPLE Reset reset
EXAMPLE Secure Easy Setup ses
EXAMPLE No buttons at all. -

Hardware

Info

General
Brand Turris CZ.NIC
Model Omnia
Versions
Device Type WiFi Router
Availability Available 2018
Comments - general Omnia uses an operating system based on OpenWrt, see https://github.com/CZ-NIC/turris-os; 2048MB RAM version was also available
OpenWrt Support
Supported Since Revision
Supported Since Release 18.06.0
Supported Current Release 18.06.1
Unsupported
Hardware
Instruction set ARM
Sub Instruction Set ARMv7
bootloader U-Boot
Target mvebu
System-On-Chip
CPU MHz 1600
Flash MB 8192NAND
RAM MB 1024
Network
Ethernet 100M ports -
Ethernet Gbit ports 6
switch Marvell 88E6176
Modem -
VLAN Yes
Comments - network ports 5x LAN, 1x SFP
Wireless
WLAN 2.4GHz b/g/n
WLAN 5.0GHz a/n/ac
WLAN Hardware Qualcomm Atheros QCA986x/988x mini-PCIe, Qualcomm Atheros AR9287 miniPCIe
Detachable Antennas 3
Comments - WLAN 2x2 802.11b/g/n (2.4GHz), 3x3 802.11ac (2.4 / 5GHz)
Interfaces
USB ports 2x 3.0
SATA ports 1
Serial Yes
JTAG Yes
Comments - USB & SATA ports mSATA
Misc
LED count 12
Button count 1
Power supply 12 VDC, 3.33 A
Links
Forum Topic URL
WikiDevi URL https://wikidevi.com/wiki/Turris_Omnia
OEM device homepage URL https://omnia.turris.cz/en/
Firmware OEM Stock URL https://repo.turris.cz/omnia-stable/
Firmware OpenWrt Install URL http://downloads.openwrt.org/releases/18.06.1/targets/mvebu/cortexa9/
Firmware OpenWrt Upgrade URL http://downloads.openwrt.org/releases/18.06.1/targets/mvebu/cortexa9/
Edit the underlying data View/Edit data

Photos

Front:
Insert photo of front of the casing

Back:
Insert photo of back of the casing

Backside label:
Insert photo of backside label

Opening the case

Note: This will not void your warranty.

Remove 3 screws each from left and right side. Gently open the case, take care not to damage the thermally conductive pad that connects the case to the CPU for the passive cooling.

Main PCB:

Serial

port.serial general information about the serial port, serial port cable, etc.

How to connect to the Serial Port of this specific device:

Serial connection parameters
for Turris CZ.NIC Omnia
115200, 8N1

JTAG

port.jtag general information about the JTAG port, JTAG cable, etc.

How to connect to the JTAG Port of this specific device:

GPIO

port.gpio general information about GPIO

GPIO voltage is 3.3V, maximum current ±5mA.

When the electrical parameters are violated, proper function of ports is not guaranteed and the router can get damaged permanently!

GPIO pinout:

Bootloader mods

Hardware mods

Not directly a hardware mod, just a possibility for an addon: Turrisduino

Bootlogs

OEM bootlog

COPY HERE THE BOOTLOG WITH THE ORIGINAL FIRMWARE


OpenWrt bootlog

COPY HERE THE BOOTLOG ONCE OPENWRT IS INSTALLED AND RUNNING


Notes

Tags

toh/turris_cz.nic/turris_cz.nic_omnia.txt · Last modified: 2018/11/09 22:14 by jamest42