Kirale Technologies. Kirale® and Kirale Technologies logos are registered trademarks of Kirale Technologies S.L. Other trademarks are the property of their respective owners. Contact Information Kirale Technologies S.L.
KTBRN1 Quick Start Guide April 2020, v2.1 1. Required Components Before beginning with KTBRN1 installation, it is recommended to have the following list of components in place: A KTBRN1 device. A micro SD card, recommended class 10 A1-rated and at least 2 GB of capacity.
April 2020, v2.1 2. Installation Guide 2.1. Download required software Make sure you get the latest release of our Debian-based image for KTBRN1 that includes KiBRA software, which you will can find on our website, in the following URL. ...
5) Eject the SD card from the computer and place it in the KTBRN1 card holder. 2.3. First time installation Connect a USB cable to the KTBRN1 and to PC or USB hub. The first time you turn on the KTBRN1 device, it will take about a couple of minutes to be ready to accept connections.
Page 8
KTBRN1 Quick Start Guide April 2020, v2.1 2.3.1. Connecting via USB Serial port Pi USB to Serial A new serial device should be listed ( ) depending on your OS. It may be required to install the driver for the USB Serial port, so check if the device has been recognized by your PC.
Page 9
KTBRN1 Quick Start Guide April 2020, v2.1 Once you have got access to KTBRN1 via USB serial, launch MobaXterm and open a new Serial session with the new listed port and speed 115200, then a login console should appear after clicking enter. Login with user root, password kirale123.
Page 10
KTBRN1 Quick Start Guide April 2020, v2.1 The welcome screen will show you information about IP addresses configured in KTBRN1 and what KiBRA version is running. By default, the provided image comes configured with a static IPv4 address for Ethernet interface: IPv4 address: 192.168.75.84/24...
KTBRN1 Quick Start Guide April 2020, v2.1 3. Web Administration Panel The access to the Web Administration Panel is available in port 8000 of KTBRN1. Type http://192.168.75.84:8000 http://[IPv6]:8000 in your browser (preferably Chrome or Firefox for compatibility reasons) and the login page should be shown.
In the picture above, the new IPv4 address acquired by DHCP is 10.1.1.163. It is now possible to connect to KTBRN1 through SSH client to this IPv4 address or also to IPv6 link-local address if the PC is connected to the same network. Besides KiBRA will use this exterior IPv4 address for its NAT64 function.
This can be done by going to “KiBRA” menu and clicking the “Upgrade” icon which is located next to the KTBRN1 picture in “System” section. Then select the KiBRA-v2.x.x.zip file from the PC, click the “Install” bottom and follow the instructions that will appear on the screen.
KTBRN1 Quick Start Guide April 2020, v2.1 3.3. Configure Border Router Click the “Settings” sub-menu under the “KiBRA” menu to access the configuration page. If an input field is shown in red colour, a right value will be required to be set before saving changes.
Page 15
KTBRN1 Quick Start Guide April 2020, v2.1 • Autostart: if this option is checked, Border Router will try to automatically join to Thread network after the next reboot. • Out-of-band Commissioning: it allows selecting the kind of attaching that Border Router will make when it starts up.
KTBRN1 Quick Start Guide April 2020, v2.1 3.4. Start-up Border Router Go to “KiBRA” menu in order to start Border Router Engine. After clicking the start button, the device either will join the selected network or form a new one, depending on settings configured by the administrator.
Page 18
KTBRN1 Quick Start Guide April 2020, v2.1 If you go back to the “Settings” sub-menu, it is possible to see the rest of Thread network configuration parameters that have been configured either by the administrator or by the system itself on startup.
Page 19
KTBRN1 Quick Start Guide April 2020, v2.1 Here you can gather the information needed to attach other devices to the same network. There is a button below called “Export Settings” which allows copying commissioning information, required to provision a new device into the network, by means of KiNOS commands.
KTBRN1 Quick Start Guide April 2020, v2.1 3.5. Services The administrator can see what services are being provided by Border Router right now and their current state in “Services” sub-menu under the “KiBRA” menu. There are four sections which show different services that Border Router is able to provide to.
Page 22
KTBRN1 Quick Start Guide April 2020, v2.1 3.5.2 DHCP If DHCP option was selected at the time of configuring the network prefix, this page will show the list of nodes which have acquired its IPv6 address via DHCP and what it is.
Page 23
KTBRN1 Quick Start Guide April 2020, v2.1 3.5.4 Commissioner The Border Router can also act as Commissioner within the Thread network. Once this function is enabled, the administrator can set up the steering data in order to allow new devices to attach to the network.
KTBRN1 Quick Start Guide April 2020, v2.1 3.6. Visual Network The network topology map is a map that allows an administrator to see the physical layout of connected devices. Having the map of a network’s topology on hand is very useful for understanding how devices connect to each other and the best techniques for troubleshooting.
KTBRN1 Quick Start Guide April 2020, v2.1 4. A brief insight In order to gather a deeper knowledge of how KTBRN1 works, a detailed description of the system, what tools are available and a few tips for troubleshooting are provided. 4.1. Advanced filesystem KTBRN1 device is a Linux-based system which has the peculiarity that its filesystem is running from a SD card.
The administrator can manually start up “kibra” application by means of following commands: root@KTBRN1:~# service kibra stop root@KTBRN1:~# source /opt/kirale/py3env/bin/activate (py3env) root@KTBRN1:~# python -m kibra –-log debug In the case of “ajenti” application, the administrator should use the following commands: root@KTBRN1:~# service ajenti stop root@KTBRN1:~# source /opt/kirale/py2env/bin/activate (py2env) root@KTBRN1:~# ajenti-panel --dev 4.3.
Need help?
Do you have a question about the KTBRN1 and is the answer not in the manual?
Questions and answers